This class wraps around a map to provide a concise interface for the editor to work with. More...

#include <map_context.hpp>

Inheritance diagram for editor::map_context:

Public Member Functions
	map_context (const map_context &)=delete

map_context &	operator= (const map_context &)=delete

	map_context (const editor_map &map, bool pure_map, const config &schedule)
	Create a map context from an existing map. More...

	map_context (const game_config_view &game_config, const std::string &filename)
	Create map_context from a map file. More...

virtual	~map_context ()
	Map context destructor. More...

bool	select_area (int index)
	Select the nth tod area. More...

void	new_side ()
	Adds a new side to the map. More...

void	remove_side ()
	removes the last side from the scenario More...

void	save_area (const std::set< map_location > &area)

void	new_area (const std::set< map_location > &area)

void	remove_area (int index)

map_labels &	get_labels ()

void	replace_schedule (const std::vector< time_of_day > &schedule)

virtual const unit_map &	units () const override
	Const units accessor. More...

unit_map &	units ()
	Local non-const overload of units. More...

virtual const std::vector< team > &	teams () const override
	Const teams accessor. More...

std::vector< team > &	teams ()
	Local non-const overload of teams. More...

virtual const editor_map &	map () const override
	Const map accessor. More...

editor_map &	map ()
	Local non-const overload of map. More...

virtual const std::vector< std::string > &	hidden_label_categories () const override

virtual std::vector< std::string > &	hidden_label_categories () override

void	replace_local_schedule (const std::vector< time_of_day > &schedule)
	Replace the [time]s of the currently active area. More...

void	set_starting_time (int time)
	TODO. More...

void	set_local_starting_time (int time)
	TODO. More...

const tod_manager *	get_time_manager () const

tod_manager *	get_time_manager ()

mp_game_settings &	get_mp_settings ()

game_classification &	get_classification ()

int	get_active_area () const

void	set_active_area (int index)

bool	is_in_playlist (std::string track_id)

void	add_to_playlist (const sound::music_track &track)

void	draw_terrain (const t_translation::terrain_code &terrain, const map_location &loc, bool one_layer_only=false)
	Draw a terrain on a single location on the map. More...

void	draw_terrain_actual (const t_translation::terrain_code &terrain, const map_location &loc, bool one_layer_only=false)
	Actual drawing function used by both overloaded variants of draw_terrain. More...

void	draw_terrain (const t_translation::terrain_code &terrain, const std::set< map_location > &locs, bool one_layer_only=false)
	Draw a terrain on a set of locations on the map. More...

bool	needs_reload () const
	Getter for the reload flag. More...

void	set_needs_reload (bool value=true)
	Setter for the reload flag. More...

bool	needs_terrain_rebuild () const
	Getter for the terrain rebuild flag. More...

void	set_needs_terrain_rebuild (bool value=true)
	Setter for the terrain rebuild flag. More...

void	set_scenario_setup (const std::string &id, const std::string &name, const std::string &description, int turns, int xp_mod, bool victory_defeated, bool random_time)
	TODO. More...

void	set_side_setup (editor_team_info &info)
	TODO. More...

bool	needs_labels_reset () const
	Getter for the labels reset flag. More...

void	set_needs_labels_reset (bool value=true)
	Setter for the labels reset flag. More...

const std::set< map_location >	changed_locations () const

void	clear_changed_locations ()

void	add_changed_location (const map_location &loc)

void	add_changed_location (const std::set< map_location > &locs)

void	set_everything_changed ()

bool	everything_changed () const

void	set_labels (display &disp)

void	clear_starting_position_labels (display &disp)

void	set_starting_position_labels (display &disp)

void	reset_starting_position_labels (display &disp)

const std::string &	get_filename () const

void	set_filename (const std::string &fn)

const std::string &	get_map_data_key () const

const std::string &	get_id () const

const std::string &	get_description () const

const std::string &	get_name () const

const t_string	get_default_context_name () const

std::optional< int >	get_xp_mod () const

bool	random_start_time () const

bool	victory_defeated () const

bool	is_embedded () const

bool	is_pure_map () const

void	set_embedded (bool v)

bool	save_map ()
	Saves the map under the current filename. More...

bool	save_scenario ()
	Saves the scenario under the current filename. More...

void	load_scenario ()

config	to_config ()

void	set_map (const editor_map &map)

void	perform_action (const editor_action &action)
	Performs an action (thus modifying the map). More...

void	perform_partial_action (const editor_action &action)
	Performs a partial action, assumes that the top undo action has been modified to maintain coherent state of the undo stacks, and so a new undo action is not created. More...

bool	modified () const

void	clear_modified ()
	Clear the modified state. More...

void	add_to_recent_files ()
	Adds the map to the editor's recent files list. More...

bool	can_undo () const

bool	can_redo () const

editor_action *	last_undo_action ()

editor_action *	last_redo_action ()

const editor_action *	last_undo_action () const
	const version of last_undo_action More...

const editor_action *	last_redo_action () const
	const version of last_redo_action More...

void	undo ()
	Un-does the last action, and puts it in the redo stack for a possible redo. More...

void	redo ()
	Re-does a previously undid action, and puts it back in the undo stack. More...

void	partial_undo ()
	Un-does a single step from a undo action chain. More...

void	clear_undo_redo ()
	Clear the undo and redo stacks. More...

overlay_map &	get_overlays ()

Public Member Functions inherited from display_context
const team &	get_team (int side) const

template<typename T = void>
bool	has_team (int side) const

bool	would_be_discovered (const map_location &loc, int side_num, bool see_all=true)
	Given a location and a side number, indicates whether an invisible unit of that side at that location would be revealed (perhaps ambushed), based on what team side_num can see. More...

const unit *	get_visible_unit (const map_location &loc, const team &current_team, bool see_all=false) const

unit_const_ptr	get_visible_unit_shared_ptr (const map_location &loc, const team &current_team, bool see_all=false) const

can_move_result	unit_can_move (const unit &u) const
	Work out what u can do - this does not check which player's turn is currently active, the result is calculated assuming that the unit's owner is currently active. More...

orb_status	unit_orb_status (const unit &u) const
	Returns an enumurated summary of whether this unit can move and/or attack. More...

int	village_owner (const map_location &loc) const
	Given the location of a village, will return the 1-based number of the team that currently owns it, and 0 if it is unowned. More...

int	side_units (int side_num) const
	Returns the number of units of the side side_num. More...

int	side_units_cost (int side_num) const
	Returns the total cost of units of side side_num. More...

int	side_upkeep (int side_num) const

bool	is_observer () const
	Check if we are an observer in this game. More...

virtual	~display_context ()

Protected Member Functions
void	trim_stack (action_stack &stack)
	Checks if an action stack reached its capacity and removes the front element if so. More...

void	perform_action_between_stacks (action_stack &from, action_stack &to)
	Perform an action at the back of one stack, and then move it to the back of the other stack. More...

Protected Attributes
std::string	filename_
	The actual filename of this map. More...

std::string	map_data_key_
	When a scenario file is loaded, the referenced map is loaded instead. More...

bool	embedded_
	Whether the map context refers to a map embedded in a scenario file. More...

bool	pure_map_
	Whether the map context refers to a file containing only the pure map data. More...

editor_map	map_
	The map object of this map_context. More...

action_stack	undo_stack_
	The undo stack. More...

action_stack	redo_stack_
	The redo stack. More...

int	actions_since_save_
	Number of actions performed since the map was saved. More...

std::set< map_location >	starting_position_label_locs_
	Cache of set starting position labels. More...

bool	needs_reload_
	Refresh flag indicating the map in this context should be completely reloaded by the display. More...

bool	needs_terrain_rebuild_
	Refresh flag indicating the terrain in the map has changed and requires a rebuild. More...

bool	needs_labels_reset_
	Refresh flag indicating the labels in the map have changed. More...

std::set< map_location >	changed_locations_

bool	everything_changed_

Static Protected Attributes
static const std::size_t	max_action_stack_size_ = 100
	Action stack (i.e. More...

Private Types
typedef std::map< std::string, sound::music_track >	music_map

typedef std::map< map_location, std::vector< overlay > >	overlay_map

Private Attributes
std::string	scenario_id_

std::string	scenario_name_

std::string	scenario_description_

std::optional< int >	xp_mod_

std::optional< bool >	victory_defeated_

bool	random_time_

int	active_area_

map_labels	labels_

unit_map	units_

std::vector< team >	teams_

std::vector< std::string >	lbl_categories_

std::unique_ptr< tod_manager >	tod_manager_

mp_game_settings	mp_settings_

game_classification	game_classification_

music_map	music_tracks_

overlay_map	overlays_

Detailed Description

This class wraps around a map to provide a concise interface for the editor to work with.

The actual map object can change rapidly (be assigned to), the map context persists data (like the undo stacks) in this case. The functionality is here, not in editor_controller as e.g. the undo stack is part of the map, not the editor as a whole. This might allow many maps to be open at the same time.

Definition at line 59 of file map_context.hpp.

Member Typedef Documentation

◆ music_map

typedef std::map<std::string, sound::music_track> editor::map_context::music_map

private

Definition at line 511 of file map_context.hpp.

◆ overlay_map

typedef std::map<map_location, std::vector<overlay> > editor::map_context::overlay_map

private

Definition at line 514 of file map_context.hpp.

Constructor & Destructor Documentation

◆ map_context() [1/3]

editor::map_context::map_context ( const map_context & )

delete

◆ map_context() [2/3]

editor::map_context::map_context	(	const editor_map &	map,
		bool	pure_map,
		const config &	schedule
	)

explicit

Create a map context from an existing map.

The filename is set to be empty, indicating a new map. Marked "explicit" to avoid automatic conversions.

Definition at line 56 of file map_context.cpp.

◆ map_context() [3/3]

editor::map_context::map_context	(	const game_config_view &	game_config,
		const std::string &	filename
	)

Create map_context from a map file.

If the map cannot be loaded, an exception will be thrown and the object will not be constructed. If the map file is a scenario, the map specified in its map_data key will be loaded, and the stored filename updated accordingly. Maps embedded inside scenarios do not change the filename, but set the "embedded" flag instead.

Definition at line 88 of file map_context.cpp.

References _(), add_to_recent_files(), filesystem::directory_name(), e, embedded_, filesystem::file_exists(), filename_, editor::editor_map::from_string(), filesystem::get_short_wml_path(), filesystem::get_wml_location(), filesystem::is_directory(), load_scenario(), LOG_ED, log_editor, log_scope2, map_, game::error::message, pure_map_, and filesystem::read_file().

◆ ~map_context()

editor::map_context::~map_context ( )

virtual

Map context destructor.

Definition at line 224 of file map_context.cpp.

References redo_stack_, and undo_stack_.

Member Function Documentation

◆ add_changed_location() [1/2]

void editor::map_context::add_changed_location ( const map_location & loc )

Definition at line 428 of file map_context.cpp.

References changed_locations_, and everything_changed().

◆ add_changed_location() [2/2]

void editor::map_context::add_changed_location ( const std::set< map_location > & locs )

Definition at line 435 of file map_context.cpp.

References changed_locations_, and everything_changed().

◆ add_to_playlist()

void editor::map_context::add_to_playlist ( const sound::music_track & track )

inline

Definition at line 220 of file map_context.hpp.

References sound::music_track::id().

Referenced by editor::editor_controller::do_execute_command().

◆ add_to_recent_files()

void editor::map_context::add_to_recent_files ( )

Adds the map to the editor's recent files list.

Definition at line 734 of file map_context.cpp.

References preferences::editor::add_recent_files_entry(), and get_filename().

Referenced by map_context(), and save_map().

◆ can_redo()

bool editor::map_context::can_redo ( ) const

Returns: true when redo can be performed, false otherwise

Definition at line 744 of file map_context.cpp.

References redo_stack_.

Referenced by editor::editor_controller::can_execute_command(), and redo().

◆ can_undo()

bool editor::map_context::can_undo ( ) const

Returns: true when undo can be performed, false otherwise

Definition at line 739 of file map_context.cpp.

References undo_stack_.

Referenced by editor::editor_controller::can_execute_command(), partial_undo(), perform_partial_action(), and undo().

◆ changed_locations()

const std::set<map_location> editor::map_context::changed_locations ( ) const

inline

Definition at line 289 of file map_context.hpp.

Referenced by editor::context_manager::refresh_after_action().

◆ clear_changed_locations()

void editor::map_context::clear_changed_locations ( )

Definition at line 422 of file map_context.cpp.

References changed_locations_, and everything_changed_.

Referenced by editor::context_manager::refresh_after_action(), and editor::context_manager::refresh_all().

◆ clear_modified()

void editor::map_context::clear_modified ( )

Clear the modified state.

Definition at line 729 of file map_context.cpp.

References actions_since_save_.

Referenced by save_map(), and save_scenario().

◆ clear_starting_position_labels()

void editor::map_context::clear_starting_position_labels ( display & disp )

Definition at line 452 of file map_context.cpp.

References map_labels::clear_all(), display::labels(), and starting_position_label_locs_.

Referenced by reset_starting_position_labels().

◆ clear_undo_redo()

void editor::map_context::clear_undo_redo ( )

Clear the undo and redo stacks.

Definition at line 821 of file map_context.cpp.

References redo_stack_, and undo_stack_.

◆ draw_terrain() [1/2]

void editor::map_context::draw_terrain	(	const t_translation::terrain_code &	terrain,
		const map_location &	loc,
		bool	one_layer_only = `false`
	)

Draw a terrain on a single location on the map.

Sets the refresh flags accordingly.

Definition at line 376 of file map_context.cpp.

References draw_terrain_actual(), gamemap::get_terrain_info(), map_, and terrain_type::terrain_with_default_base().

Referenced by editor::editor_action_paint_area::perform_without_undo(), editor::editor_action_fill::perform_without_undo(), and editor::editor_action_shuffle_area::perform_without_undo().

◆ draw_terrain() [2/2]

void editor::map_context::draw_terrain	(	const t_translation::terrain_code &	terrain,
		const std::set< map_location > &	locs,
		bool	one_layer_only = `false`
	)

Draw a terrain on a set of locations on the map.

Sets the refresh flags accordingly.

Definition at line 410 of file map_context.cpp.

References draw_terrain_actual(), gamemap::get_terrain_info(), map_, and terrain_type::terrain_with_default_base().

◆ draw_terrain_actual()

void editor::map_context::draw_terrain_actual	(	const t_translation::terrain_code &	terrain,
		const map_location &	loc,
		bool	one_layer_only = `false`
	)

Actual drawing function used by both overloaded variants of draw_terrain.

Definition at line 385 of file map_context.cpp.

References add_changed_location(), t_translation::terrain_code::base, terrain_type_data::BASE, gamemap_base::get_terrain(), LOG_ED, map_, t_translation::NO_LAYER, gamemap_base::on_board_with_border(), terrain_type_data::OVERLAY, and gamemap::set_terrain().

Referenced by draw_terrain().

◆ everything_changed()

bool editor::map_context::everything_changed ( ) const

Definition at line 447 of file map_context.cpp.

References everything_changed_.

Referenced by add_changed_location().

◆ get_active_area()

int editor::map_context::get_active_area ( ) const

inline

Returns: the index of the currently active area.

Definition at line 208 of file map_context.hpp.

Referenced by editor::context_manager::expand_areas_menu(), editor::editor_controller::get_action_state(), and editor::context_manager::rename_area_dialog().

◆ get_classification()

game_classification& editor::map_context::get_classification ( )

inline

Definition at line 200 of file map_context.hpp.

Referenced by editor::context_manager::refresh_on_context_change().

◆ get_default_context_name()

const t_string editor::map_context::get_default_context_name ( ) const

Definition at line 849 of file map_context.cpp.

References _(), and is_pure_map().

Referenced by editor::context_manager::expand_open_maps_menu(), and editor::context_manager::set_window_title().

◆ get_description()

const std::string& editor::map_context::get_description ( ) const

inline

Definition at line 311 of file map_context.hpp.

Referenced by editor::context_manager::edit_scenario_dialog().

◆ get_filename()

const std::string& editor::map_context::get_filename ( ) const

inline

Definition at line 304 of file map_context.hpp.

References filename_.

◆ get_id()

const std::string& editor::map_context::get_id ( ) const

inline

Definition at line 310 of file map_context.hpp.

Referenced by editor::context_manager::edit_scenario_dialog().

◆ get_labels()

map_labels& editor::map_context::get_labels ( )

inline

Definition at line 114 of file map_context.hpp.

References display_context::map(), display_context::teams(), and display_context::units().

Referenced by editor::editor_controller::display_redraw_callback(), editor::editor_controller::do_execute_command(), editor::mouse_action_map_label::drag_end_left(), editor::editor_action_label::perform_without_undo(), editor::editor_action_label_delete::perform_without_undo(), editor::context_manager::refresh_on_context_change(), editor::context_manager::switch_context(), and editor::mouse_action_map_label::up_left().

◆ get_map_data_key()

const std::string& editor::map_context::get_map_data_key ( ) const

inline

Definition at line 308 of file map_context.hpp.

Referenced by editor::context_manager::load_map().

◆ get_mp_settings()

mp_game_settings& editor::map_context::get_mp_settings ( )

inline

Definition at line 197 of file map_context.hpp.

◆ get_name()

const std::string& editor::map_context::get_name ( ) const

inline

Definition at line 312 of file map_context.hpp.

Referenced by editor::context_manager::edit_scenario_dialog(), editor::context_manager::expand_open_maps_menu(), and editor::context_manager::set_window_title().

◆ get_overlays()

overlay_map& editor::map_context::get_overlays ( )

inline

Definition at line 519 of file map_context.hpp.

Referenced by editor::editor_display::get_overlays().

◆ get_time_manager() [1/2]

const tod_manager* editor::map_context::get_time_manager ( ) const

inline

Definition at line 189 of file map_context.hpp.

Referenced by editor::editor_controller::can_execute_command(), editor::editor_controller::custom_tods_dialog(), editor::editor_controller::do_execute_command(), editor::context_manager::edit_scenario_dialog(), editor::context_manager::expand_areas_menu(), editor::context_manager::expand_local_time_menu(), editor::context_manager::expand_time_menu(), editor::editor_controller::get_action_state(), editor::editor_display::get_time_of_day(), editor::context_manager::get_tod_man(), editor::context_manager::refresh_on_context_change(), and editor::context_manager::rename_area_dialog().

◆ get_time_manager() [2/2]

tod_manager* editor::map_context::get_time_manager ( )

inline

Definition at line 193 of file map_context.hpp.

◆ get_xp_mod()

std::optional<int> editor::map_context::get_xp_mod ( ) const

inline

Definition at line 316 of file map_context.hpp.

Referenced by editor::context_manager::edit_scenario_dialog().

◆ hidden_label_categories() [1/2]

virtual const std::vector<std::string>& editor::map_context::hidden_label_categories ( ) const

inlineoverridevirtual

Implements display_context.

Definition at line 161 of file map_context.hpp.

◆ hidden_label_categories() [2/2]

virtual std::vector<std::string>& editor::map_context::hidden_label_categories ( )

inlineoverridevirtual

Implements display_context.

Definition at line 166 of file map_context.hpp.

◆ is_embedded()

bool editor::map_context::is_embedded ( ) const

inline

Definition at line 321 of file map_context.hpp.

Referenced by editor::context_manager::expand_open_maps_menu(), save_map(), editor::context_manager::save_map_as(), save_scenario(), and editor::context_manager::save_scenario_as().

◆ is_in_playlist()

bool editor::map_context::is_in_playlist ( std::string track_id )

inline

Definition at line 216 of file map_context.hpp.

Referenced by editor::editor_controller::get_action_state().

◆ is_pure_map()

bool editor::map_context::is_pure_map ( ) const

inline

Definition at line 323 of file map_context.hpp.

Referenced by editor::editor_controller::can_execute_command(), editor::context_manager::expand_open_maps_menu(), get_default_context_name(), and editor::context_manager::save_map().

◆ last_redo_action() [1/2]

editor_action * editor::map_context::last_redo_action ( )

Returns: a pointer to the last redo action or nullptr if the undo stack is empty

Definition at line 754 of file map_context.cpp.

References redo_stack_.

◆ last_redo_action() [2/2]

const editor_action * editor::map_context::last_redo_action ( ) const

const version of last_redo_action

Definition at line 764 of file map_context.cpp.

References redo_stack_.

◆ last_undo_action() [1/2]

editor_action * editor::map_context::last_undo_action ( )

Returns: a pointer to the last undo action or nullptr if the undo stack is empty

Definition at line 749 of file map_context.cpp.

References undo_stack_.

Referenced by editor::editor_controller::mouse_motion(), partial_undo(), and perform_partial_action().

◆ last_undo_action() [2/2]

const editor_action * editor::map_context::last_undo_action ( ) const

const version of last_undo_action

Definition at line 759 of file map_context.cpp.

References undo_stack_.

◆ load_scenario()

void editor::map_context::load_scenario ( )

Definition at line 315 of file map_context.cpp.

References config::child_range(), unit::create(), e, filename_, editor::editor_map::from_string(), config::get(), i, unit_map::insert(), labels_, LOG_ED, map_, game::error::message, music_tracks_, overlays_, preprocess_file(), random_time_, map_labels::read(), read(), scenario_description_, scenario_id_, scenario_name_, teams_, resources::tod_manager, tod_manager_, units_, victory_defeated_, and xp_mod_.

Referenced by map_context().

◆ map() [1/2]

virtual const editor_map& editor::map_context::map ( ) const

inlineoverridevirtual

Const map accessor.

Implements display_context.

Definition at line 150 of file map_context.hpp.

◆ map() [2/2]

editor_map& editor::map_context::map ( )

inline

Local non-const overload of map.

Definition at line 156 of file map_context.hpp.

◆ modified()

bool editor::map_context::modified ( ) const

Returns: whether the map was modified since the last save

Definition at line 724 of file map_context.cpp.

References actions_since_save_.

Referenced by editor::editor_controller::can_execute_command(), and editor::context_manager::expand_open_maps_menu().

◆ needs_labels_reset()

bool editor::map_context::needs_labels_reset ( ) const

inline

Getter for the labels reset flag.

Set when the labels need to be refreshed.

Definition at line 282 of file map_context.hpp.

◆ needs_reload()

bool editor::map_context::needs_reload ( ) const

inline

Getter for the reload flag.

Reload is the highest level of required refreshing, set when the map size has changed or the map was reassigned.

Definition at line 251 of file map_context.hpp.

◆ needs_terrain_rebuild()

bool editor::map_context::needs_terrain_rebuild ( ) const

inline

Getter for the terrain rebuild flag.

Set whenever any terrain has changed.

Definition at line 261 of file map_context.hpp.

◆ new_area()

void editor::map_context::new_area ( const std::set< map_location > & area )

inline

Definition at line 106 of file map_context.hpp.

Referenced by editor::editor_controller::add_area().

◆ new_side()

void editor::map_context::new_side ( )

Adds a new side to the map.

Definition at line 230 of file map_context.cpp.

References actions_since_save_, map(), and teams_.

Referenced by editor::editor_controller::do_execute_command(), and editor::context_manager::new_scenario().

◆ operator=()

map_context& editor::map_context::operator= ( const map_context & )

delete

◆ partial_undo()

void editor::map_context::partial_undo ( )

Un-does a single step from a undo action chain.

The action is separated from the chain and it's undo (the redo) is added as a stand-alone action to the redo stack. Precondition: the last undo action has to actually be an action chain.

Definition at line 797 of file map_context.cpp.

References actions_since_save_, can_undo(), editor::editor_action_chain::empty(), last_undo_action(), editor::editor_action_chain::pop_first_action(), redo_stack_, and undo_stack_.

Referenced by editor::editor_controller::do_execute_command().

◆ perform_action()

void editor::map_context::perform_action ( const editor_action & action )

Performs an action (thus modifying the map).

An appropriate undo action is added to the undo stack. The redo stack is cleared. Note that this may throw, use caution when calling this with a dereferenced pointer that you own (i.e. use a smart pointer).

Definition at line 683 of file map_context.cpp.

References actions_since_save_, editor::editor_action::get_id(), editor::editor_action::get_instance_count(), editor::editor_action::get_name(), LOG_ED, editor::editor_action::perform(), redo_stack_, trim_stack(), undo(), and undo_stack_.

Referenced by editor::editor_controller::mouse_motion(), editor::editor_controller::perform_delete(), and editor::context_manager::perform_refresh().

◆ perform_action_between_stacks()

void editor::map_context::perform_action_between_stacks	(	action_stack &	from,
		action_stack &	to
	)

protected

Perform an action at the back of one stack, and then move it to the back of the other stack.

This is the implementation of both undo and redo which only differ in the direction.

Definition at line 834 of file map_context.cpp.

References trim_stack().

Referenced by redo(), and undo().

◆ perform_partial_action()

void editor::map_context::perform_partial_action ( const editor_action & action )

Performs a partial action, assumes that the top undo action has been modified to maintain coherent state of the undo stacks, and so a new undo action is not created.

Definition at line 703 of file map_context.cpp.

References can_undo(), editor::editor_action::get_id(), editor::editor_action::get_instance_count(), editor::editor_action::get_name(), last_undo_action(), LOG_ED, editor::editor_action::perform(), editor::editor_action_chain::prepend_action(), redo_stack_, and undo().

Referenced by editor::editor_controller::mouse_motion().

◆ random_start_time()

bool editor::map_context::random_start_time ( ) const

inline

Definition at line 318 of file map_context.hpp.

Referenced by editor::context_manager::edit_scenario_dialog().

◆ redo()

void editor::map_context::redo ( )

Re-does a previously undid action, and puts it back in the undo stack.

Definition at line 783 of file map_context.cpp.

References actions_since_save_, can_redo(), LOG_ED, perform_action_between_stacks(), redo_stack_, undo_stack_, and WRN_ED.

Referenced by editor::editor_controller::redo().

◆ remove_area()

void editor::map_context::remove_area ( int index )

Definition at line 292 of file map_context.cpp.

References actions_since_save_, active_area_, and tod_manager_.

Referenced by editor::editor_controller::do_execute_command().

◆ remove_side()

void editor::map_context::remove_side ( )

inline

removes the last side from the scenario

Definition at line 97 of file map_context.hpp.

Referenced by editor::editor_controller::do_execute_command().

◆ replace_local_schedule()

void editor::map_context::replace_local_schedule ( const std::vector< time_of_day > & schedule )

Replace the [time]s of the currently active area.

Definition at line 307 of file map_context.cpp.

References actions_since_save_, active_area_, pure_map_, and tod_manager_.

Referenced by editor::editor_controller::do_execute_command().

◆ replace_schedule()

void editor::map_context::replace_schedule ( const std::vector< time_of_day > & schedule )

Definition at line 299 of file map_context.cpp.

References actions_since_save_, pure_map_, and tod_manager_.

Referenced by editor::editor_controller::do_execute_command().

◆ reset_starting_position_labels()

void editor::map_context::reset_starting_position_labels ( display & disp )

Definition at line 464 of file map_context.cpp.

References clear_starting_position_labels(), set_needs_labels_reset(), and set_starting_position_labels().

Referenced by editor::context_manager::refresh_after_action(), and editor::context_manager::reload_map().

◆ save_area()

void editor::map_context::save_area ( const std::set< map_location > & area )

inline

Definition at line 102 of file map_context.hpp.

Referenced by editor::editor_controller::save_area().

◆ save_map()

bool editor::map_context::save_map ( )

Saves the map under the current filename.

Filename must be valid. May throw an exception on failure.

Definition at line 630 of file map_context.cpp.

References _(), add_to_recent_files(), clear_modified(), e, get_filename(), is_embedded(), map_, wfl::msg(), filesystem::read_file(), VGETTEXT, game::error::what(), gamemap::write(), and filesystem::write_file().

Referenced by editor::context_manager::write_map().

◆ save_scenario()

bool editor::map_context::save_scenario ( )

Saves the scenario under the current filename.

Filename must be valid. May throw an exception on failure.

Definition at line 582 of file map_context.cpp.

References filesystem::base_name(), clear_modified(), e, filename_, get_filename(), is_embedded(), wfl::msg(), pure_map_, scenario_id_, scenario_name_, to_config(), VGETTEXT, game::error::what(), config_writer::write(), and filesystem::write_file().

Referenced by editor::context_manager::write_scenario().

◆ select_area()

bool editor::map_context::select_area ( int index )

Select the nth tod area.

Parameters

index of the tod area to select.

Definition at line 371 of file map_context.cpp.

References map_, editor::editor_map::set_selection(), and tod_manager_.

Referenced by editor::editor_controller::do_execute_command().

◆ set_active_area()

void editor::map_context::set_active_area ( int index )

inline

Definition at line 212 of file map_context.hpp.

References utf8::index().

Referenced by editor::editor_controller::do_execute_command().

◆ set_embedded()

void editor::map_context::set_embedded ( bool v )

inline

Definition at line 325 of file map_context.hpp.

Referenced by editor::context_manager::save_map_as(), and editor::context_manager::save_scenario_as().

◆ set_everything_changed()

void editor::map_context::set_everything_changed ( )

Definition at line 442 of file map_context.cpp.

References everything_changed_.

Referenced by editor::editor_action_select_all::perform_without_undo(), editor::editor_action_select_none::perform_without_undo(), and editor::editor_action_select_inverse::perform_without_undo().

◆ set_filename()

void editor::map_context::set_filename ( const std::string & fn )

inline

Definition at line 306 of file map_context.hpp.

References filename_.

Referenced by editor::context_manager::save_all_maps(), editor::context_manager::save_map_as(), and editor::context_manager::save_scenario_as().

◆ set_labels()

void editor::map_context::set_labels ( display & disp )

◆ set_local_starting_time()

void editor::map_context::set_local_starting_time ( int time )

inline

TODO.

Definition at line 184 of file map_context.hpp.

Referenced by editor::editor_controller::do_execute_command().

◆ set_map()

void editor::map_context::set_map ( const editor_map & map )

Definition at line 672 of file map_context.cpp.

References gamemap_base::h(), map(), map_, set_needs_reload(), set_needs_terrain_rebuild(), and gamemap_base::w().

◆ set_needs_labels_reset()

void editor::map_context::set_needs_labels_reset ( bool value = true )

inline

Setter for the labels reset flag.

Definition at line 287 of file map_context.hpp.

Referenced by editor::context_manager::generate_map_dialog(), editor::editor_action_starting_position::perform_without_undo(), and reset_starting_position_labels().

◆ set_needs_reload()

void editor::map_context::set_needs_reload ( bool value = true )

inline

Setter for the reload flag.

Definition at line 256 of file map_context.hpp.

Referenced by editor::context_manager::reload_map(), and set_map().

◆ set_needs_terrain_rebuild()

void editor::map_context::set_needs_terrain_rebuild ( bool value = true )

inline

Setter for the terrain rebuild flag.

Definition at line 266 of file map_context.hpp.

References lg::info(), editor::editor_team_info::name, and preferences::turns().

Referenced by editor::editor_action_paste::perform_without_undo(), editor::editor_action_paint_area::perform_without_undo(), editor::editor_action_fill::perform_without_undo(), editor::editor_action_shuffle_area::perform_without_undo(), editor::context_manager::refresh_after_action(), editor::context_manager::refresh_all(), and set_map().

◆ set_scenario_setup()

void editor::map_context::set_scenario_setup	(	const std::string &	id,
		const std::string &	name,
		const std::string &	description,
		int	turns,
		int	xp_mod,
		bool	victory_defeated,
		bool	random_time
	)

TODO.

Definition at line 266 of file map_context.cpp.

References actions_since_save_, random_time_, scenario_description_, scenario_id_, scenario_name_, tod_manager_, victory_defeated(), victory_defeated_, and xp_mod_.

Referenced by editor::context_manager::edit_scenario_dialog().

◆ set_side_setup()

void editor::map_context::set_side_setup ( editor_team_info & info )

TODO.

Definition at line 244 of file map_context.cpp.

Referenced by editor::context_manager::edit_side_dialog().

◆ set_starting_position_labels()

void editor::map_context::set_starting_position_labels ( display & disp )

Definition at line 458 of file map_context.cpp.

References map_, editor::editor_map::set_starting_position_labels(), and starting_position_label_locs_.

Referenced by editor::editor_controller::editor_controller(), and reset_starting_position_labels().

◆ set_starting_time()

void editor::map_context::set_starting_time ( int time )

TODO.

Definition at line 284 of file map_context.cpp.

References actions_since_save_, pure_map_, and tod_manager_.

Referenced by editor::editor_controller::do_execute_command().

◆ teams() [1/2]

virtual const std::vector<team>& editor::map_context::teams ( ) const

inlineoverridevirtual

Const teams accessor.

Implements display_context.

Definition at line 138 of file map_context.hpp.

Referenced by editor::editor_controller::can_execute_command(), editor::editor_controller::do_execute_command(), editor::context_manager::edit_side_dialog(), editor::context_manager::expand_sides_menu(), editor::editor_action_village::perform_without_undo(), editor::editor_action_village_delete::perform_without_undo(), and editor::context_manager::refresh_all().

◆ teams() [2/2]

std::vector<team>& editor::map_context::teams ( )

inline

Local non-const overload of teams.

Definition at line 144 of file map_context.hpp.

◆ to_config()

config editor::map_context::to_config ( )

Definition at line 471 of file map_context.cpp.

References config::add_child(), config::append(), unit_map::begin(), unit_map::end(), overlay::halo, i, overlay::id, overlay::image, utils::join(), labels_, map_, music_tracks_, overlay::name, overlays_, random_time_, config::remove_attribute(), scenario_description_, scenario_id_, scenario_name_, t, overlay::team_name, teams_, tod_manager_, units_, victory_defeated_, overlay::visible_in_fog, map_labels::write(), gamemap::write(), map_location::write_direction(), and xp_mod_.

Referenced by save_scenario().

◆ trim_stack()

void editor::map_context::trim_stack ( action_stack & stack )

protected

Checks if an action stack reached its capacity and removes the front element if so.

Definition at line 827 of file map_context.cpp.

References max_action_stack_size_.

Referenced by perform_action(), and perform_action_between_stacks().

◆ undo()

void editor::map_context::undo ( )

Un-does the last action, and puts it in the redo stack for a possible redo.

Definition at line 769 of file map_context.cpp.

References actions_since_save_, can_undo(), LOG_ED, perform_action_between_stacks(), redo_stack_, undo_stack_, and WRN_ED.

Referenced by perform_action(), perform_partial_action(), and editor::editor_controller::undo().

◆ units() [1/2]

virtual const unit_map& editor::map_context::units ( ) const

inlineoverridevirtual

Const units accessor.

Implements display_context.

Definition at line 126 of file map_context.hpp.

Referenced by editor::editor_controller::can_execute_command(), editor::editor_controller::change_unit_id(), editor::editor_controller::do_execute_command(), editor::editor_controller::get_action_state(), editor::editor_action_unit::perform_without_undo(), editor::editor_action_unit_delete::perform_without_undo(), editor::editor_action_unit_replace::perform_without_undo(), editor::editor_action_unit_facing::perform_without_undo(), editor::editor_controller::rename_unit(), and editor::editor_controller::unit_description().

◆ units() [2/2]

unit_map& editor::map_context::units ( )

inline

Local non-const overload of units.

Definition at line 132 of file map_context.hpp.

◆ victory_defeated()

bool editor::map_context::victory_defeated ( ) const

inline

Definition at line 319 of file map_context.hpp.

Referenced by editor::context_manager::edit_scenario_dialog(), and set_scenario_setup().

Member Data Documentation

◆ actions_since_save_

int editor::map_context::actions_since_save_

protected

Number of actions performed since the map was saved.

Zero means the map was not modified.

Definition at line 468 of file map_context.hpp.

Referenced by clear_modified(), modified(), new_side(), partial_undo(), perform_action(), redo(), remove_area(), replace_local_schedule(), replace_schedule(), set_scenario_setup(), set_side_setup(), set_starting_time(), and undo().

◆ active_area_

int editor::map_context::active_area_

private

Definition at line 501 of file map_context.hpp.

Referenced by remove_area(), and replace_local_schedule().

◆ changed_locations_

std::set<map_location> editor::map_context::changed_locations_

protected

Definition at line 490 of file map_context.hpp.

Referenced by add_changed_location(), and clear_changed_locations().

◆ embedded_

bool editor::map_context::embedded_

protected

Whether the map context refers to a map embedded in a scenario file.

This distinction is important in order to avoid overwriting the scenario.

Definition at line 421 of file map_context.hpp.

Referenced by map_context().

◆ everything_changed_

bool editor::map_context::everything_changed_

protected

Definition at line 491 of file map_context.hpp.

Referenced by clear_changed_locations(), everything_changed(), and set_everything_changed().

◆ filename_

std::string editor::map_context::filename_

protected

The actual filename of this map.

An empty string indicates a new map.

Definition at line 409 of file map_context.hpp.

Referenced by load_scenario(), map_context(), and save_scenario().

◆ game_classification_

game_classification editor::map_context::game_classification_

private

Definition at line 509 of file map_context.hpp.

◆ labels_

map_labels editor::map_context::labels_

private

Definition at line 503 of file map_context.hpp.

Referenced by load_scenario(), and to_config().

◆ lbl_categories_

std::vector<std::string> editor::map_context::lbl_categories_

private

Definition at line 506 of file map_context.hpp.

◆ map_

editor_map editor::map_context::map_

protected

The map object of this map_context.

Definition at line 431 of file map_context.hpp.

Referenced by draw_terrain(), draw_terrain_actual(), load_scenario(), map_context(), save_map(), select_area(), set_map(), set_starting_position_labels(), and to_config().

◆ map_data_key_

std::string editor::map_context::map_data_key_

protected

When a scenario file is loaded, the referenced map is loaded instead.

The verbatim form of the reference is kept here.

Definition at line 415 of file map_context.hpp.

◆ max_action_stack_size_

const std::size_t editor::map_context::max_action_stack_size_ = 100

staticprotected

Action stack (i.e.

undo and redo) maximum size

Definition at line 463 of file map_context.hpp.

Referenced by editor::editor_team_info::editor_team_info(), and trim_stack().

◆ mp_settings_

mp_game_settings editor::map_context::mp_settings_

private

Definition at line 508 of file map_context.hpp.

◆ music_tracks_

music_map editor::map_context::music_tracks_

private

Definition at line 512 of file map_context.hpp.

Referenced by load_scenario(), and to_config().

◆ needs_labels_reset_

bool editor::map_context::needs_labels_reset_

protected

Refresh flag indicating the labels in the map have changed.

Definition at line 488 of file map_context.hpp.

◆ needs_reload_

bool editor::map_context::needs_reload_

protected

Refresh flag indicating the map in this context should be completely reloaded by the display.

Definition at line 478 of file map_context.hpp.

◆ needs_terrain_rebuild_

bool editor::map_context::needs_terrain_rebuild_

protected

Refresh flag indicating the terrain in the map has changed and requires a rebuild.

Definition at line 483 of file map_context.hpp.

◆ overlays_

overlay_map editor::map_context::overlays_

private

Definition at line 515 of file map_context.hpp.

Referenced by load_scenario(), and to_config().

◆ pure_map_

bool editor::map_context::pure_map_

protected

Whether the map context refers to a file containing only the pure map data.

Definition at line 426 of file map_context.hpp.

Referenced by map_context(), replace_local_schedule(), replace_schedule(), save_scenario(), and set_starting_time().

◆ random_time_

bool editor::map_context::random_time_

private

Definition at line 499 of file map_context.hpp.

Referenced by load_scenario(), set_scenario_setup(), and to_config().

◆ redo_stack_

action_stack editor::map_context::redo_stack_

protected

The redo stack.

See also: undo_stack_

Definition at line 458 of file map_context.hpp.

Referenced by can_redo(), clear_undo_redo(), last_redo_action(), partial_undo(), perform_action(), perform_partial_action(), redo(), undo(), and ~map_context().

◆ scenario_description_

std::string editor::map_context::scenario_description_

private

Definition at line 495 of file map_context.hpp.

Referenced by load_scenario(), set_scenario_setup(), and to_config().

◆ scenario_id_

std::string editor::map_context::scenario_id_

private

Definition at line 495 of file map_context.hpp.

Referenced by load_scenario(), save_scenario(), set_scenario_setup(), and to_config().

◆ scenario_name_

std::string editor::map_context::scenario_name_

private

Definition at line 495 of file map_context.hpp.

Referenced by load_scenario(), save_scenario(), set_scenario_setup(), and to_config().

◆ starting_position_label_locs_

std::set<map_location> editor::map_context::starting_position_label_locs_

protected

Cache of set starting position labels.

Necessary for removing them.

Definition at line 473 of file map_context.hpp.

Referenced by clear_starting_position_labels(), and set_starting_position_labels().

◆ teams_

std::vector<team> editor::map_context::teams_

private

Definition at line 505 of file map_context.hpp.

Referenced by load_scenario(), new_side(), set_side_setup(), and to_config().

◆ tod_manager_

std::unique_ptr<tod_manager> editor::map_context::tod_manager_

private

Definition at line 507 of file map_context.hpp.

Referenced by load_scenario(), remove_area(), replace_local_schedule(), replace_schedule(), select_area(), set_scenario_setup(), set_starting_time(), and to_config().

◆ undo_stack_

action_stack editor::map_context::undo_stack_

protected

The undo stack.

A double-ended queues due to the need to add items to one end, and remove from both when performing the undo or when trimming the size. This container owns all contents, i.e. no action in the stack shall be deleted, and unless otherwise noted the contents could be deleted at an time during normal operation of the stack. To work on an action, either remove it from the container or make a copy. Actions are inserted at the back of the container and disappear from the front when the capacity is exceeded.

Todo:: Use boost's pointer-owning container?

Definition at line 453 of file map_context.hpp.

Referenced by can_undo(), clear_undo_redo(), last_undo_action(), partial_undo(), perform_action(), redo(), undo(), and ~map_context().

◆ units_

unit_map editor::map_context::units_

private

Definition at line 504 of file map_context.hpp.

Referenced by load_scenario(), and to_config().

◆ victory_defeated_

std::optional<bool> editor::map_context::victory_defeated_

private

Definition at line 498 of file map_context.hpp.

Referenced by load_scenario(), set_scenario_setup(), and to_config().

◆ xp_mod_

std::optional<int> editor::map_context::xp_mod_

private

Definition at line 497 of file map_context.hpp.

Referenced by load_scenario(), set_scenario_setup(), and to_config().

The documentation for this class was generated from the following files:

editor/map/map_context.hpp
editor/map/map_context.cpp

Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Private Types

Private Attributes

Detailed Description

Member Typedef Documentation

◆ music_map

◆ overlay_map

Constructor & Destructor Documentation

◆ map_context() [1/3]

◆ map_context() [2/3]

◆ map_context() [3/3]

◆ ~map_context()

Member Function Documentation

◆ add_changed_location() [1/2]

◆ add_changed_location() [2/2]

◆ add_to_playlist()

◆ add_to_recent_files()

◆ can_redo()

◆ can_undo()

◆ changed_locations()

◆ clear_changed_locations()

◆ clear_modified()

◆ clear_starting_position_labels()

◆ clear_undo_redo()

◆ draw_terrain() [1/2]

◆ draw_terrain() [2/2]

◆ draw_terrain_actual()

◆ everything_changed()

◆ get_active_area()

◆ get_classification()

◆ get_default_context_name()

◆ get_description()

◆ get_filename()

◆ get_id()

◆ get_labels()

◆ get_map_data_key()

◆ get_mp_settings()

◆ get_name()

◆ get_overlays()

◆ get_time_manager() [1/2]

◆ get_time_manager() [2/2]

◆ get_xp_mod()

◆ hidden_label_categories() [1/2]

◆ hidden_label_categories() [2/2]

◆ is_embedded()

◆ is_in_playlist()

◆ is_pure_map()

◆ last_redo_action() [1/2]

◆ last_redo_action() [2/2]

◆ last_undo_action() [1/2]

◆ last_undo_action() [2/2]

◆ load_scenario()

◆ map() [1/2]

◆ map() [2/2]

◆ modified()

◆ needs_labels_reset()

◆ needs_reload()

◆ needs_terrain_rebuild()

◆ new_area()

◆ new_side()

◆ operator=()

◆ partial_undo()

◆ perform_action()

◆ perform_action_between_stacks()

◆ perform_partial_action()

◆ random_start_time()

◆ redo()

◆ remove_area()

◆ remove_side()

◆ replace_local_schedule()

◆ replace_schedule()

◆ reset_starting_position_labels()

◆ save_area()

◆ save_map()

◆ save_scenario()

◆ select_area()

◆ set_active_area()