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 editor_map &map, const display &disp, bool pure_map, const config &schedule)
	Create a map context from an existing map. More...

	map_context (const config &game_config, const std::string &filename, const display &disp)
	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...

editor_map &	get_map ()
	Map accessor. More...

const editor_map &	get_map () const
	Map accessor - const version. 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)

std::vector< team > &	get_teams ()
	Get the team from the current map context object. More...

map_labels &	get_labels ()

unit_map &	get_units ()
	Get the unit map from the current map context object. More...

const unit_map &	get_units () const

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

virtual const unit_map &	units () const
	Const accessor names needed to implement "display_context" interface. More...

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

virtual const gamemap &	map () const

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

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...

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::t_terrain &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::t_terrain &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::t_terrain &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 (int side, const std::string &id, const std::string &name, int gold, int income, int village_gold, int village_support, bool fog, bool shroud, team::SHARE_VISION share_vision, team::CONTROLLER controller, bool hidden, bool no_leader)
	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

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 (const config &game_config)

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
std::vector< std::string > &	hidden_label_categories_ref ()

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

bool	unit_can_move (const unit &u) const
	Will return true iff the unit u has any possible moves it can do (including attacking etc). More...

int	village_owner (const map_location &loc) const
	Given the location of a village, will return the 0-based index of the team that currently owns it, and -1 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

team_data	calculate_team_data (const class team &tm, int side) const

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

virtual	~display_context ()

Protected Types
typedef std::deque < editor_action * >	action_stack
	Container type used to store actions in the undo and redo stacks. More...

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	clear_stack (action_stack &stack)
	Clears an action stack and deletes all its contents. 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 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::multimap < map_location, overlay >	overlay_map

Private Attributes
std::string	scenario_id_

std::string	scenario_name_

std::string	scenario_description_

int	xp_mod_

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_

boost::scoped_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 41 of file map_context.hpp.

Member Typedef Documentation

typedef std::deque<editor_action*> editor::map_context::action_stack

protected

Container type used to store actions in the undo and redo stacks.

Definition at line 408 of file map_context.hpp.

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

private

Definition at line 493 of file map_context.hpp.

typedef std::multimap<map_location, overlay> editor::map_context::overlay_map

private

Definition at line 496 of file map_context.hpp.

Constructor & Destructor Documentation

editor::map_context::map_context	(	const editor_map &	map,
		const display &	disp,
		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 44 of file map_context.cpp.

editor::map_context::map_context	(	const config &	game_config,
		const std::string &	filename,
		const display &	disp
	)

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 76 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_wml_location(), filesystem::is_directory(), load_scenario(), LOG_ED, log_editor, log_scope2, map_, game::error::message, pure_map_, and filesystem::read_file().

editor::map_context::~map_context ( )

virtual

Map context destructor.

Definition at line 324 of file map_context.cpp.

References clear_stack(), redo_stack_, and undo_stack_.

Member Function Documentation

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

Definition at line 383 of file map_context.cpp.

References changed_locations_, and everything_changed().

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

Definition at line 389 of file map_context.cpp.

References changed_locations_, and everything_changed().

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

inline

Definition at line 189 of file map_context.hpp.

References sound::music_track::id(), and music_tracks_.

void editor::map_context::add_to_recent_files ( )

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

Definition at line 624 of file map_context.cpp.

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

Referenced by map_context(), and save_map().

bool editor::map_context::can_redo ( ) const

Returns: true when redo can be performed, false otherwise

Definition at line 634 of file map_context.cpp.

References redo_stack_.

Referenced by redo().

bool editor::map_context::can_undo ( ) const

Returns: true when undo can be performed, false otherwise

Definition at line 629 of file map_context.cpp.

References undo_stack_.

Referenced by partial_undo(), perform_partial_action(), and undo().

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

inline

Definition at line 261 of file map_context.hpp.

References changed_locations_.

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

void editor::map_context::clear_changed_locations ( )

Definition at line 377 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().

void editor::map_context::clear_modified ( )

Clear the modified state.

Definition at line 619 of file map_context.cpp.

References actions_since_save_.

Referenced by save_map(), and save_scenario().

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

protected

Clears an action stack and deletes all its contents.

Helper function used when the undo or redo stack needs to be cleared

Definition at line 719 of file map_context.cpp.

Referenced by clear_undo_redo(), perform_action(), perform_partial_action(), and ~map_context().

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

Definition at line 405 of file map_context.cpp.

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

Referenced by reset_starting_position_labels().

void editor::map_context::clear_undo_redo ( )

Clear the undo and redo stacks.

Definition at line 705 of file map_context.cpp.

References clear_stack(), redo_stack_, and undo_stack_.

void editor::map_context::draw_terrain	(	const t_translation::t_terrain &	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 335 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_fill::perform(), editor::editor_action_paint_area::perform_without_undo(), editor::editor_action_fill::perform_without_undo(), and editor::editor_action_shuffle_area::perform_without_undo().

void editor::map_context::draw_terrain	(	const t_translation::t_terrain &	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 366 of file map_context.cpp.

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

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

Actual drawing function used by both overloaded variants of draw_terrain.

Definition at line 344 of file map_context.cpp.

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

Referenced by draw_terrain().

bool editor::map_context::everything_changed ( ) const

Definition at line 400 of file map_context.cpp.

References everything_changed_.

Referenced by add_changed_location().

int editor::map_context::get_active_area ( ) const

inline

Returns: the index of the currently active area.

Definition at line 177 of file map_context.hpp.

References active_area_.

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

game_classification& editor::map_context::get_classification ( )

inline

Definition at line 169 of file map_context.hpp.

References game_classification_.

Referenced by editor::map_context_refresher::refresh().

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

inline

Definition at line 283 of file map_context.hpp.

References scenario_description_.

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

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

inline

Definition at line 276 of file map_context.hpp.

References filename_.

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

inline

Definition at line 282 of file map_context.hpp.

References scenario_id_.

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

map_labels& editor::map_context::get_labels ( )

inline

Definition at line 113 of file map_context.hpp.

References labels_.

Referenced by editor::editor_action_label::perform(), editor::editor_action_label_delete::perform(), editor::editor_action_label::perform_without_undo(), editor::editor_action_label_delete::perform_without_undo(), editor::map_context_refresher::refresh(), and editor::context_manager::switch_context().

editor_map& editor::map_context::get_map ( )

inline

Map accessor.

Definition at line 75 of file map_context.hpp.

References map_.

const editor_map& editor::map_context::get_map ( ) const

inline

Map accessor - const version.

Definition at line 80 of file map_context.hpp.

References map_.

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

inline

Definition at line 280 of file map_context.hpp.

References map_data_key_.

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

mp_game_settings& editor::map_context::get_mp_settings ( )

inline

Definition at line 166 of file map_context.hpp.

References mp_settings_.

Referenced by editor::map_context_refresher::refresh().

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

inline

Definition at line 284 of file map_context.hpp.

References scenario_name_.

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

overlay_map& editor::map_context::get_overlays ( )

inline

Definition at line 501 of file map_context.hpp.

References overlays_.

Referenced by editor::map_context_refresher::refresh().

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

inline

Get the team from the current map context object.

Definition at line 109 of file map_context.hpp.

References teams_.

Referenced by editor::context_manager::edit_side_dialog(), editor::context_manager::expand_sides_menu(), editor::editor_action_village::perform(), editor::editor_action_village_delete::perform(), editor::editor_action_village::perform_without_undo(), editor::editor_action_village_delete::perform_without_undo(), and editor::map_context_refresher::refresh().

tod_manager* editor::map_context::get_time_manager ( )

inline

Definition at line 162 of file map_context.hpp.

References tod_manager_.

Referenced by 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::map_context_refresher::refresh(), and editor::context_manager::rename_area_dialog().

unit_map& editor::map_context::get_units ( )

inline

Get the unit map from the current map context object.

Definition at line 118 of file map_context.hpp.

References units_.

Referenced by editor::editor_action_unit_delete::perform(), 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(), and editor::map_context_refresher::refresh().

const unit_map& editor::map_context::get_units ( ) const

inline

Definition at line 122 of file map_context.hpp.

References units_.

int editor::map_context::get_xp_mod ( ) const

inline

Definition at line 286 of file map_context.hpp.

References xp_mod_.

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

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

inlinevirtual

Implements display_context.

Definition at line 140 of file map_context.hpp.

References lbl_categories_.

bool editor::map_context::is_embedded ( ) const

inline

Definition at line 291 of file map_context.hpp.

References embedded_.

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

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

inline

Definition at line 185 of file map_context.hpp.

References music_tracks_.

bool editor::map_context::is_pure_map ( ) const

inline

Definition at line 293 of file map_context.hpp.

References pure_map_.

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

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 644 of file map_context.cpp.

References redo_stack_.

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

const version of last_redo_action

Definition at line 654 of file map_context.cpp.

References redo_stack_.

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 639 of file map_context.cpp.

References undo_stack_.

Referenced by partial_undo(), and perform_partial_action().

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

const version of last_undo_action

Definition at line 649 of file map_context.cpp.

References undo_stack_.

void editor::map_context::load_scenario ( const config & game_config )

Definition at line 266 of file map_context.cpp.

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

Referenced by map_context().

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

inlinevirtual

Implements display_context.

Definition at line 137 of file map_context.hpp.

References map_.

Referenced by set_map().

bool editor::map_context::modified ( ) const

Returns: whether the map was modified since the last save

Definition at line 614 of file map_context.cpp.

References actions_since_save_.

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 254 of file map_context.hpp.

References needs_labels_reset_.

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 220 of file map_context.hpp.

References needs_reload_.

bool editor::map_context::needs_terrain_rebuild ( ) const

inline

Getter for the terrain rebuild flag.

Set whenever any terrain has changed.

Definition at line 230 of file map_context.hpp.

References needs_terrain_rebuild_.

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

inline

Definition at line 100 of file map_context.hpp.

References actions_since_save_, active_area_, and tod_manager_.

void editor::map_context::new_side ( )

inline

Adds a new side to the map.

Definition at line 83 of file map_context.hpp.

References actions_since_save_, team::set_hidden(), and teams_.

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 683 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_.

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 581 of file map_context.cpp.

References actions_since_save_, clear_stack(), 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::context_manager::perform_refresh().

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 727 of file map_context.cpp.

References editor::editor_action::perform(), and trim_stack().

Referenced by redo(), and undo().

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 597 of file map_context.cpp.

References can_undo(), clear_stack(), 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().

bool editor::map_context::random_start_time ( ) const

inline

Definition at line 288 of file map_context.hpp.

References random_time_.

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

void editor::map_context::redo ( )

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

Definition at line 671 of file map_context.cpp.

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

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

Definition at line 245 of file map_context.cpp.

References actions_since_save_, active_area_, and tod_manager_.

void editor::map_context::remove_side ( )

inline

removes the last side from the scenario

Definition at line 91 of file map_context.hpp.

References actions_since_save_, and teams_.

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 259 of file map_context.cpp.

References actions_since_save_, active_area_, pure_map_, and tod_manager_.

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

Definition at line 252 of file map_context.cpp.

References actions_since_save_, pure_map_, and tod_manager_.

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

Definition at line 417 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().

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

inline

Definition at line 96 of file map_context.hpp.

References active_area_, and tod_manager_.

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 536 of file map_context.cpp.

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

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

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 507 of file map_context.cpp.

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

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

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

Select the nth tod area.

Parameters

index of the tod area to select.

Definition at line 330 of file map_context.cpp.

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

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

inline

Definition at line 181 of file map_context.hpp.

References active_area_.

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

inline

Definition at line 295 of file map_context.hpp.

References embedded_.

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

void editor::map_context::set_everything_changed ( )

Definition at line 395 of file map_context.cpp.

References everything_changed_.

Referenced by editor::editor_action_select_all::perform(), editor::editor_action_select_none::perform(), 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().

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

inline

Definition at line 278 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().

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

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

inline

TODO.

Definition at line 157 of file map_context.hpp.

References actions_since_save_, active_area_, and tod_manager_.

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

Definition at line 571 of file map_context.cpp.

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

Referenced by editor::editor_action_whole_map::perform_without_undo(), and editor::editor_action_create_mask::perform_without_undo().

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

inline

Setter for the labels reset flag.

Definition at line 259 of file map_context.hpp.

References needs_labels_reset_.

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

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

inline

Setter for the reload flag.

Definition at line 225 of file map_context.hpp.

References needs_reload_.

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

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

inline

Setter for the terrain rebuild flag.

Definition at line 235 of file map_context.hpp.

References needs_terrain_rebuild_.

Referenced by editor::editor_action_fill::perform(), 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_apply_mask::perform_without_undo(), editor::editor_action_create_mask::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().

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 225 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().

void editor::map_context::set_side_setup	(	int	side,
		const std::string &	id,
		const std::string &	name,
		int	gold,
		int	income,
		int	village_gold,
		int	village_support,
		bool	fog,
		bool	shroud,
		team::SHARE_VISION	share_vision,
		team::CONTROLLER	controller,
		bool	hidden,
		bool	no_leader
	)

TODO.

Definition at line 202 of file map_context.cpp.

References actions_since_save_, team::change_controller(), team::change_team(), team::have_leader(), team::set_base_income(), team::set_fog(), team::set_gold(), team::set_hidden(), team::set_share_vision(), team::set_shroud(), team::set_village_gold(), team::set_village_support(), and teams_.

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

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

Definition at line 411 of file map_context.cpp.

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

Referenced by reset_starting_position_labels().

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

TODO.

Definition at line 238 of file map_context.cpp.

References actions_since_save_, pure_map_, and tod_manager_.

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

inlinevirtual

Implements display_context.

Definition at line 134 of file map_context.hpp.

References teams_.

config editor::map_context::to_config ( )

Definition at line 424 of file map_context.cpp.

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

Referenced by save_scenario().

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 711 of file map_context.cpp.

References max_action_stack_size_.

Referenced by perform_action(), and perform_action_between_stacks().

void editor::map_context::undo ( )

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

Definition at line 659 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(), and perform_partial_action().

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

inlinevirtual

Const accessor names needed to implement "display_context" interface.

Implements display_context.

Definition at line 131 of file map_context.hpp.

References units_.

bool editor::map_context::victory_defeated ( ) const

inline

Definition at line 289 of file map_context.hpp.

References victory_defeated_.

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

Member Data Documentation

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 451 of file map_context.hpp.

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

int editor::map_context::active_area_

private

Definition at line 483 of file map_context.hpp.

Referenced by get_active_area(), new_area(), remove_area(), replace_local_schedule(), save_area(), set_active_area(), and set_local_starting_time().

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

protected

Definition at line 473 of file map_context.hpp.

Referenced by add_changed_location(), changed_locations(), and clear_changed_locations().

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 392 of file map_context.hpp.

Referenced by is_embedded(), map_context(), and set_embedded().

bool editor::map_context::everything_changed_

protected

Definition at line 474 of file map_context.hpp.

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

std::string editor::map_context::filename_

protected

The actual filename of this map.

An empty string indicates a new map.

Definition at line 380 of file map_context.hpp.

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

game_classification editor::map_context::game_classification_

private

Definition at line 491 of file map_context.hpp.

Referenced by get_classification().

map_labels editor::map_context::labels_

private

Definition at line 485 of file map_context.hpp.

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

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

private

Definition at line 488 of file map_context.hpp.

Referenced by hidden_label_categories().

editor_map editor::map_context::map_

protected

The map object of this map_context.

Definition at line 402 of file map_context.hpp.

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

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 386 of file map_context.hpp.

Referenced by get_map_data_key().

const size_t editor::map_context::max_action_stack_size_ = 100

staticprotected

Action stack (i.e.

undo and redo) maximum size

Definition at line 446 of file map_context.hpp.

Referenced by trim_stack().

mp_game_settings editor::map_context::mp_settings_

private

Definition at line 490 of file map_context.hpp.

Referenced by get_mp_settings().

music_map editor::map_context::music_tracks_

private

Definition at line 494 of file map_context.hpp.

Referenced by add_to_playlist(), is_in_playlist(), load_scenario(), and to_config().

bool editor::map_context::needs_labels_reset_

protected

Refresh flag indicating the labels in the map have changed.

Definition at line 471 of file map_context.hpp.

Referenced by needs_labels_reset(), and set_needs_labels_reset().

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 461 of file map_context.hpp.

Referenced by needs_reload(), and set_needs_reload().

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 466 of file map_context.hpp.

Referenced by needs_terrain_rebuild(), and set_needs_terrain_rebuild().

overlay_map editor::map_context::overlays_

private

Definition at line 497 of file map_context.hpp.

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

bool editor::map_context::pure_map_

protected

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

Definition at line 397 of file map_context.hpp.

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

bool editor::map_context::random_time_

private

Definition at line 481 of file map_context.hpp.

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

action_stack editor::map_context::redo_stack_

protected

The redo stack.

See also: undo_stack_

Definition at line 441 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().

std::string editor::map_context::scenario_description_

private

Definition at line 478 of file map_context.hpp.

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

std::string editor::map_context::scenario_id_

private

Definition at line 478 of file map_context.hpp.

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

std::string editor::map_context::scenario_name_

private

Definition at line 478 of file map_context.hpp.

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

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 456 of file map_context.hpp.

Referenced by clear_starting_position_labels(), and set_starting_position_labels().

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

private

Definition at line 487 of file map_context.hpp.

Referenced by get_teams(), load_scenario(), new_side(), remove_side(), set_side_setup(), teams(), and to_config().

boost::scoped_ptr<tod_manager> editor::map_context::tod_manager_

private

Definition at line 489 of file map_context.hpp.

Referenced by get_time_manager(), load_scenario(), new_area(), remove_area(), replace_local_schedule(), replace_schedule(), save_area(), select_area(), set_local_starting_time(), set_scenario_setup(), set_starting_time(), and to_config().

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.