The Battle for Wesnoth  1.19.0-dev
editor_controller.hpp
Go to the documentation of this file.
1 /*
2  Copyright (C) 2008 - 2024
3  by Tomasz Sniatowski <kailoran@gmail.com>
4  Part of the Battle for Wesnoth Project https://www.wesnoth.org/
5 
6  This program is free software; you can redistribute it and/or modify
7  it under the terms of the GNU General Public License as published by
8  the Free Software Foundation; either version 2 of the License, or
9  (at your option) any later version.
10  This program is distributed in the hope that it will be useful,
11  but WITHOUT ANY WARRANTY.
12 
13  See the COPYING file for more details.
14 */
15 
16 #pragma once
17 
19 #include "editor/editor_main.hpp"
22 
23 #include "controller_base.hpp"
24 #include "help/help.hpp"
26 #include "mouse_handler_base.hpp"
27 #include "tooltips.hpp"
28 
29 #include "sound_music_track.hpp"
30 
31 namespace font {
33 }
34 
35 namespace editor {
36 
37 
38 enum menu_type {
39  MAP,
51 };
52 
53 /**
54  * The editor_controller class contains the mouse and keyboard event handling
55  * routines for the editor. It also serves as the main editor class with the
56  * general logic.
57  */
62 {
63  public:
66 
67  /**
68  * The constructor. A initial map context can be specified here, the controller
69  * will assume ownership and delete the pointer during destruction, but changes
70  * to the map can be retrieved between the main loop's end and the controller's
71  * destruction.
72  */
73  editor_controller(bool clear_id);
74 
76 
77  /** Editor main loop */
79 
80  /** Takes a screenshot **/
81  void do_screenshot(const std::string& screenshot_filename = "map_screenshot.png");
82 
83  /** Show a quit confirmation dialog and returns true if the user pressed 'yes' */
84  bool quit_confirm();
85 
86  /** Display the settings dialog, used to control e.g. the lighting settings */
87  void custom_tods_dialog();
88 
89  /** Updates schedule and the map display */
90  void update_map_schedule(std::vector<time_of_day> schedule);
91 
92  /** Save the map, open dialog if not named yet. */
93  void save_map() override {context_manager_->save_map();}
94 
95  /** command_executor override */
96  bool can_execute_command(const hotkey::ui_command& command) const override;
97 
98  /** command_executor override */
99  hotkey::ACTION_STATE get_action_state(const hotkey::ui_command& command) const override;
100 
101  /** command_executor override */
102  bool do_execute_command(const hotkey::ui_command& command, bool press = true, bool release = false) override;
103 
104  /** controller_base override */
105  void show_menu(const std::vector<config>& items_arg, int xloc, int yloc, bool context_menu, display& disp) override;
106 
107  void show_help() override;
108  void status_table() override;
109 
110  /** Show the preferences dialog */
111  void preferences() override;
112 
113  /** Handle hotkeys to scroll map */
114  void scroll_up(bool on) override;
115  void scroll_down(bool on) override;
116  void scroll_left(bool on) override;
117  void scroll_right(bool on) override;
118 
119  /** Grid toggle */
120  void toggle_grid() override;
121 
122  void terrain_description() override;
123  void unit_description() override;
124  void change_unit_id();
125  void rename_unit() override;
126 
127  void unit_list() override;
128 
129  /** Copy the selection on the current map to the clipboard */
130  void copy_selection();
131 
132  /** Cut the selection from the current map to the clipboard */
133  void cut_selection();
134 
135  /** Export the WML-compatible list of selected tiles to the system clipboard */
137 
138  /** Save the current selection to the active area. */
139  void save_area();
140 
141  /** Add a new area to the current context, filled with the selection if any. */
142  void add_area();
143 
144  /* mouse_handler_base overrides */
145  void mouse_motion(int x, int y, const bool browse, bool update, map_location new_loc = map_location::null_location()) override;
146  void touch_motion(int x, int y, const bool browse, bool update=false, map_location new_loc = map_location::null_location()) override;
147  editor_display& gui() override { return *gui_; }
148  const editor_display& gui() const override { return *gui_; }
149  bool allow_mouse_wheel_scroll(int x, int y) override;
150  bool right_click_show_menu(int x, int y, const bool browse) override;
151  bool left_click(int x, int y, const bool browse) override;
152  void left_drag_end(int x, int y, const bool browse) override;
153  void left_mouse_up(int x, int y, const bool browse) override;
154  bool right_click(int x, int y, const bool browse) override;
155  void right_drag_end(int x, int y, const bool browse) override;
156  void right_mouse_up(int x, int y, const bool browse) override;
157 
159 
161  {
162  return context_manager_->get_map_context();
163  }
164 
165  protected:
166  /* controller_base overrides */
167  void process_keyup_event(const SDL_Event& event) override;
168  mouse_handler_base& get_mouse_handler_base() override { return *this; }
169  editor_display& get_display() override { return *gui_; }
170 
171  /** Get the current mouse action */
172  const mouse_action& get_mouse_action() const { return toolkit_->get_mouse_action(); }
173  /** Get the current mouse action */
174  mouse_action& get_mouse_action() { return toolkit_->get_mouse_action(); }
175 
176  /**
177  * Perform an action, then delete the action object.
178  * The pointer can be nullptr, in which case nothing will happen.
179  */
180  void perform_delete(std::unique_ptr<editor_action> action);
181 
182  /**
183  * Peform an action on the current map_context, then refresh the display
184  * and delete the pointer. The pointer can be nullptr, in which case nothing will happen.
185  */
186  void perform_refresh_delete(std::unique_ptr<editor_action> action, bool drag_part = false);
187 
188 
189  virtual std::vector<std::string> additional_actions_pressed() override;
190 
191  private:
192 
193  /** init the display object and general set-up */
194  void init_gui();
195 
196  /** init the available time-of-day settings */
198 
199  /** init background music for the editor */
201 
202  /** Reload images */
203  void refresh_image_cache();
204 
205  /**
206  * Callback function passed to display to be called on queue_rerender.
207  * Redraws toolbar, brush bar and related items.
208  */
210 
211  /**
212  * Undos an action in the current map context
213  */
214  void undo() override;
215 
216  /**
217  * Redos an action in the current map context
218  */
219  void redo() override;
220 
222 
223  /** Reports object. Must be initialized before the gui_ */
224  const std::unique_ptr<reports> reports_;
225 
226  /** The display object used and owned by the editor. */
227  const std::unique_ptr<editor_display> gui_;
228 
229  /** Pre-defined time of day lighting settings for the settings dialog */
230  typedef std::map<std::string, std::pair<std::string ,std::vector<time_of_day>>> tods_map;
232 
233  /* managers */
234  public:
235  const std::unique_ptr<context_manager> context_manager_;
236 
237  static std::string current_addon_id_;
238  private:
239  std::unique_ptr<editor_toolkit> toolkit_;
241  std::unique_ptr<font::floating_label_context> floating_label_manager_;
242 
243  std::unique_ptr<help::help_manager> help_manager_;
244 
245  /** Quit main loop flag */
246  bool do_quit_;
248 
249  std::vector<sound::music_track> music_tracks_;
250 };
251 
252 } //end namespace editor
Sort-of-Singleton that many classes, both GUI and non-GUI, use to access the game data.
Definition: display.hpp:81
The editor_controller class contains the mouse and keyboard event handling routines for the editor.
const std::unique_ptr< context_manager > context_manager_
void preferences() override
Show the preferences dialog.
void refresh_image_cache()
Reload images.
void right_drag_end(int x, int y, const bool browse) override
Called whenever the right mouse drag has "ended".
bool can_execute_command(const hotkey::ui_command &command) const override
command_executor override
bool quit_confirm()
Show a quit confirmation dialog and returns true if the user pressed 'yes'.
tooltips::manager tooltip_manager_
void scroll_up(bool on) override
Handle hotkeys to scroll map.
void cut_selection()
Cut the selection from the current map to the clipboard.
void display_redraw_callback(display &)
Callback function passed to display to be called on queue_rerender.
std::unique_ptr< font::floating_label_context > floating_label_manager_
void show_menu(const std::vector< config > &items_arg, int xloc, int yloc, bool context_menu, display &disp) override
controller_base override
void undo() override
Undos an action in the current map context.
void left_mouse_up(int x, int y, const bool browse) override
Called when the left mouse button is up.
bool left_click(int x, int y, const bool browse) override
Overridden in derived classes, called on a left click (mousedown).
mouse_handler_base & get_mouse_handler_base() override
Get a reference to a mouse handler member a derived class uses.
bool allow_mouse_wheel_scroll(int x, int y) override
Derived classes can override this to disable mousewheel scrolling under some circumstances,...
void touch_motion(int x, int y, const bool browse, bool update=false, map_location new_loc=map_location::null_location()) override
virtual std::vector< std::string > additional_actions_pressed() override
void perform_refresh_delete(std::unique_ptr< editor_action > action, bool drag_part=false)
Peform an action on the current map_context, then refresh the display and delete the pointer.
void init_tods(const game_config_view &game_config)
init the available time-of-day settings
const mouse_action & get_mouse_action() const
Get the current mouse action.
map_context & get_current_map_context() const
std::unique_ptr< editor_toolkit > toolkit_
void scroll_right(bool on) override
void init_music(const game_config_view &game_config)
init background music for the editor
editor_controller & operator=(const editor_controller &)=delete
const std::unique_ptr< editor_display > gui_
The display object used and owned by the editor.
bool do_execute_command(const hotkey::ui_command &command, bool press=true, bool release=false) override
command_executor override
void export_selection_coords()
Export the WML-compatible list of selected tiles to the system clipboard.
void redo() override
Redos an action in the current map context.
editor_display & gui() override
Reference to the used display objects.
void update_map_schedule(std::vector< time_of_day > schedule)
Updates schedule and the map display.
hotkey::ACTION_STATE get_action_state(const hotkey::ui_command &command) const override
command_executor override
void perform_delete(std::unique_ptr< editor_action > action)
Perform an action, then delete the action object.
void right_mouse_up(int x, int y, const bool browse) override
Called when the right mouse button is up.
virtual hotkey::command_executor * get_hotkey_command_executor() override
Optionally get a command executor to handle context menu events.
std::map< std::string, std::pair< std::string,std::vector< time_of_day > > > tods_map
Pre-defined time of day lighting settings for the settings dialog.
void mouse_motion(int x, int y, const bool browse, bool update, map_location new_loc=map_location::null_location()) override
Called when a mouse motion event takes place.
EXIT_STATUS main_loop()
Editor main loop.
editor_controller(const editor_controller &)=delete
void custom_tods_dialog()
Display the settings dialog, used to control e.g.
void do_screenshot(const std::string &screenshot_filename="map_screenshot.png")
Takes a screenshot.
void toggle_grid() override
Grid toggle.
void scroll_left(bool on) override
bool right_click(int x, int y, const bool browse) override
Overridden in derived classes, called on a right click (mousedown).
void save_area()
Save the current selection to the active area.
void process_keyup_event(const SDL_Event &event) override
Process keyup (always).
editor_display & get_display() override
Get a reference to a display member a derived class uses.
void copy_selection()
Copy the selection on the current map to the clipboard.
mouse_action & get_mouse_action()
Get the current mouse action.
void init_gui()
init the display object and general set-up
std::unique_ptr< help::help_manager > help_manager_
std::vector< sound::music_track > music_tracks_
bool right_click_show_menu(int x, int y, const bool browse) override
Called in the default right_click when the context menu is about to be shown, can be used for preproc...
static std::string current_addon_id_
void add_area()
Add a new area to the current context, filled with the selection if any.
const std::unique_ptr< reports > reports_
Reports object.
void scroll_down(bool on) override
void left_drag_end(int x, int y, const bool browse) override
Called whenever the left mouse drag has "ended".
bool do_quit_
Quit main loop flag.
const editor_display & gui() const override
Const version of gui.
void save_map() override
Save the map, open dialog if not named yet.
This class wraps around a map to provide a concise interface for the editor to work with.
Definition: map_context.hpp:63
A mouse action receives events from the controller, and responds to them by creating an appropriate e...
A class grating read only view to a vector of config objects, viewed as one config with all children ...
Implements a quit confirmation dialog.
controller_base framework: controller_base is roughly analogous to a "dialog" class in a GUI toolkit ...
static void update()
Manage the empty-palette in the editor.
Definition: action.cpp:31
Collection of helper functions relating to Pango formatting.
Game configuration data as global variables.
Definition: build_info.cpp:60
structure which will hide all current floating labels, and cause floating labels instantiated after i...
Used as the main paramneter for can_execute_command/do_execute_command These functions are used to ex...
Encapsulates the map of the game.
Definition: location.hpp:38
static const map_location & null_location()
Definition: location.hpp:81