#include <synced_context.hpp>

Classes
class	server_choice

Public Types
enum	synced_state { UNSYNCED , SYNCED , LOCAL_CHOICE }

Static Public Member Functions
static bool	run (const std::string &commandname, const config &data, action_spectator &spectator=get_default_spectator())
	Sets the context to 'synced', initialises random context, and calls the given function. More...

static bool	run_and_store (const std::string &commandname, const config &data, action_spectator &spectator=get_default_spectator())

static bool	run_and_throw (const std::string &commandname, const config &data, action_spectator &spectator=get_default_spectator())

static bool	run_in_synced_context_if_not_already (const std::string &commandname, const config &data, action_spectator &spectator=get_default_spectator())
	Checks whether we are currently running in a synced context, and if not we enters it. More...

static synced_state	get_synced_state ()

static bool	is_synced ()

static bool	is_unsynced ()

static void	set_synced_state (synced_state newstate)
	Should only be called form set_scontext_synced, set_scontext_local_choice. More...

static std::string	generate_random_seed ()
	Generates a new seed for a synced event, by asking the 'server'. More...

static void	pull_remote_user_input ()
	called from get_user_choice while waiting for a remove user choice. More...

static void	send_user_choice ()
	called from get_user_choice to send a recently made choice to the other clients. More...

static action_spectator &	get_default_spectator ()
	An object to be passed to run_in_synced_context to assert false on error (the default). More...

static std::shared_ptr< randomness::rng >	get_rng_for_action ()

static void	block_undo (bool do_block=true, bool clear_undo=true)
	set this to false to prevent clearing the undo stack, this is important when we cannot change the gamestate becasue with dsu clearing the undo stack changes the gamestate, which we for example don't want during formula evaluation, when it used the dice operator. More...

static void	reset_block_undo ()

static bool	undo_blocked ()

static void	set_last_unit_id (int id)

static int	get_unit_id_diff ()

static config	ask_server_choice (const server_choice &)
	If we are in a mp game, ask the server, otherwise generate the answer ourselves. More...

static bool	ignore_undo ()

Static Private Attributes
static synced_state	state_ = synced_context::UNSYNCED
	Weather we are in a synced move, in a user_choice, or none of them. More...

static bool	is_undo_blocked_ = false
	As soon as get_user_choice is used with side != current_side (for example in generate_random_seed) other sides execute the command simultaneously and is_simultaneously is set to true. More...

static int	last_unit_id_ = 0
	Used to restore the unit id manager when undoing. More...

Detailed Description

Definition at line 29 of file synced_context.hpp.

Member Enumeration Documentation

◆ synced_state

enum synced_context::synced_state

Enumerator
UNSYNCED
SYNCED
LOCAL_CHOICE

Definition at line 32 of file synced_context.hpp.

Member Function Documentation

◆ ask_server_choice()

config synced_context::ask_server_choice ( const server_choice & sch )

static

If we are in a mp game, ask the server, otherwise generate the answer ourselves.

Definition at line 262 of file synced_context.cpp.

References replay::at_end(), block_undo(), resources::controller, DBG_REPLAY, config::debug(), do_replay_handle(), ERR_REPLAY, replay::get_next_action(), config::has_child(), play_controller::increase_server_request_number(), play_controller::is_networked_mp(), is_synced(), synced_context::server_choice::local_choice(), config::mandatory_child(), synced_context::server_choice::name(), controller_base::play_slice(), replay::process_error(), pull_remote_user_input(), resources::recorder, synced_context::server_choice::request_id(), replay::revert_action(), synced_context::server_choice::send_request(), replay::user_input(), and WRN_REPLAY.

Referenced by game_state::add_side_wml(), team::change_controller_by_wml(), and generate_random_seed().

◆ block_undo()

void synced_context::block_undo	(	bool	do_block = `true`,
		bool	clear_undo = `true`
	)

static

set this to false to prevent clearing the undo stack, this is important when we cannot change the gamestate becasue with dsu clearing the undo stack changes the gamestate, which we for example don't want during formula evaluation, when it used the dice operator.

TODO: consider removing this parameter when dsu is removed.

Definition at line 184 of file synced_context.cpp.

References actions::undo_list::clear(), resources::controller, is_undo_blocked_, play_controller::send_actions(), and resources::undo_stack.

Referenced by ask_server_choice(), play_controller::do_init_side(), play_controller::finish_side_turn_events(), get_rng_for_action(), actions::recall_unit(), actions::recruit_unit(), play_controller::start_game(), SYNCED_COMMAND_HANDLER_FUNCTION(), and user_choice_manager::user_choice_manager().

◆ generate_random_seed()

std::string synced_context::generate_random_seed ( )

static

Generates a new seed for a synced event, by asking the 'server'.

Definition at line 176 of file synced_context.cpp.

References ask_server_choice(), and config_attribute_value::str().

Referenced by get_rng_for_action().

◆ get_default_spectator()

action_spectator & synced_context::get_default_spectator ( )

static

An object to be passed to run_in_synced_context to assert false on error (the default).

Definition at line 137 of file synced_context.cpp.

References ERR_REPLAY.

◆ get_rng_for_action()

std::shared_ptr< randomness::rng > synced_context::get_rng_for_action ( )

static

Returns: A rng_deterministic if in determinsic mode otherwise a rng_synced.

Definition at line 232 of file synced_context.cpp.

References block_undo(), resources::classification, resources::gamedata, generate_random_seed(), randomness::mt_rng::get_next_random(), game_classification::random_mode, and game_data::rng().

◆ get_synced_state()

static synced_state synced_context::get_synced_state ( )

inlinestatic

Returns: Whether we are currently executing a synced action like recruit, start, recall, disband, movement, attack, init_side, end_turn, fire_event, lua_ai, auto_shroud or similar.

Definition at line 66 of file synced_context.hpp.

References state_.

Referenced by do_replay_handle(), events::console_handler::is_enabled(), is_synced(), is_unsynced(), leave_synced_context::leave_synced_context(), run_in_synced_context_if_not_already(), set_scontext_synced_base::set_scontext_synced_base(), game_lua_kernel::synced_state(), game_events::WML_HANDLER_FUNCTION(), leave_synced_context::~leave_synced_context(), and set_scontext_synced_base::~set_scontext_synced_base().

◆ get_unit_id_diff()

int synced_context::get_unit_id_diff ( )

static

Definition at line 213 of file synced_context.cpp.

References resources::gameboard, n_unit::id_manager::get_save_id(), is_synced(), last_unit_id_, and game_board::unit_id_manager().

Referenced by actions::undo_list::finish_action().

◆ ignore_undo()

bool synced_context::ignore_undo ( )

static

Definition at line 347 of file synced_context.cpp.

References resources::controller, play_controller::current_team(), and team::is_ai().

◆ is_synced()

static bool synced_context::is_synced ( )

inlinestatic

Returns: Whether we are currently executing a synced action like recruit, start, recall, disband, movement, attack, init_side, end_turn, fire_event, lua_ai, auto_shroud or similar.

Definition at line 75 of file synced_context.hpp.

References get_synced_state(), and SYNCED.

Referenced by actions::undo_list::apply_shroud_changes(), ask_server_choice(), game_display::display_unit_hex(), do_replay_handle(), get_unit_id_diff(), mp_sync::get_user_choice(), mp_sync::get_user_choice_multiple_sides(), game_display::highlight_hex(), game_lua_kernel::intf_has_achievement(), game_lua_kernel::intf_has_sub_achievement(), unit::mark_clone(), side_filter::match_internal(), and unit::set_underlying_id().

◆ is_unsynced()

static bool synced_context::is_unsynced ( )

inlinestatic

Returns: Whether we are not currently executing a synced action like recruit, start, recall, disband, movement, attack, init_side, end_turn, fire_event, lua_ai, auto_shroud or similar. and not doing a local choice.

Definition at line 84 of file synced_context.hpp.

References get_synced_state(), and UNSYNCED.

Referenced by wb::manager::can_modify_game_state(), playmp_controller::send_actions(), and undo_blocked().

◆ pull_remote_user_input()

void synced_context::pull_remote_user_input ( )

static

called from get_user_choice while waiting for a remove user choice.

Definition at line 220 of file synced_context.cpp.

References resources::controller, and play_controller::receive_actions().

Referenced by ask_server_choice(), and user_choice_manager::pull().

◆ reset_block_undo()

static void synced_context::reset_block_undo ( )

inlinestatic

Definition at line 119 of file synced_context.hpp.

References is_undo_blocked_.

Referenced by set_scontext_synced_base::set_scontext_synced_base().

◆ run()

bool synced_context::run	(	const std::string &	commandname,
		const config &	data,
		action_spectator &	spectator = `get_default_spectator()`
	)

static

Sets the context to 'synced', initialises random context, and calls the given function.

The plan is that in replays and in real game the same function is called. However, if you cannot call this function you can also use set_scontext_synced directly (use it like it's used in this method).

Parameters

commandname	The command to run.
data	The data to use with the command.
spectator	An error handler for the case that data contains invalid data.

Returns: True if the action was successful.

Definition at line 47 of file synced_context.cpp.

References play_controller::check_victory(), resources::controller, data, DBG_REPLAY, set_scontext_synced::do_final_checkup(), action_spectator::error(), utils::find(), actions::undo_list::finish_action(), actions::undo_list::init_action(), synced_command::registry(), send_user_choice(), undo_blocked(), and resources::undo_stack.

Referenced by do_replay_handle(), actions::undo_list::redo(), and run_and_store().

◆ run_and_store()

bool synced_context::run_and_store	(	const std::string &	commandname,
		const config &	data,
		action_spectator &	spectator = `get_default_spectator()`
	)

static

Definition at line 81 of file synced_context.cpp.

References replay::add_synced_command(), actions::undo_list::cleanup_action(), resources::controller, data, ERR_REPLAY, resources::recorder, run(), replay::undo(), and resources::undo_stack.

Referenced by playsingle_controller::play_ai_turn(), playmp_controller::play_human_turn(), and run_and_throw().

◆ run_and_throw()

bool synced_context::run_and_throw	(	const std::string &	commandname,
		const config &	data,
		action_spectator &	spectator = `get_default_spectator()`
	)

static

Definition at line 99 of file synced_context.cpp.

References resources::controller, data, play_controller::maybe_throw_return_to_play_side(), and run_and_store().

◆ run_in_synced_context_if_not_already()

bool synced_context::run_in_synced_context_if_not_already	(	const std::string &	commandname,
		const config &	data,
		action_spectator &	spectator = `get_default_spectator()`
	)

static

Checks whether we are currently running in a synced context, and if not we enters it.

This is never called from so_replay_handle.

Definition at line 109 of file synced_context.cpp.

References data, ERR_REPLAY, action_spectator::error(), get_synced_state(), LOCAL_CHOICE, synced_command::registry(), run_and_throw(), SYNCED, and UNSYNCED.

Referenced by ai::attack_result::do_execute(), ai::recall_result::do_execute(), ai::recruit_result::do_execute(), game_events::wml_menu_item::fire_event(), and game_events::WML_HANDLER_FUNCTION().

◆ send_user_choice()

void synced_context::send_user_choice ( )

static

called from get_user_choice to send a recently made choice to the other clients.

Does not receive any data from the network any sends data.

Definition at line 226 of file synced_context.cpp.

References resources::controller, play_controller::send_actions(), and undo_blocked().

Referenced by user_choice_manager::ask_local_choice(), and run().

◆ set_last_unit_id()

static void synced_context::set_last_unit_id ( int id )

inlinestatic

Definition at line 127 of file synced_context.hpp.

References id, and last_unit_id_.

Referenced by set_scontext_synced_base::set_scontext_synced_base().

◆ set_synced_state()

static void synced_context::set_synced_state ( synced_state newstate )

inlinestatic

Should only be called form set_scontext_synced, set_scontext_local_choice.

Definition at line 90 of file synced_context.hpp.

References state_.

Referenced by leave_synced_context::leave_synced_context(), set_scontext_synced_base::set_scontext_synced_base(), leave_synced_context::~leave_synced_context(), and set_scontext_synced_base::~set_scontext_synced_base().

◆ undo_blocked()

bool synced_context::undo_blocked ( )

static

Returns: Whether we tracked something that can never be undone.

Definition at line 198 of file synced_context.cpp.

References resources::controller, game_data::end_turn_forced(), resources::gamedata, play_controller::is_regular_game_end(), is_undo_blocked_, and is_unsynced().

Referenced by user_choice_manager::ask_local_choice(), run(), playmp_controller::send_actions(), and send_user_choice().

Member Data Documentation

◆ is_undo_blocked_

bool synced_context::is_undo_blocked_ = false

inlinestaticprivate

As soon as get_user_choice is used with side != current_side (for example in generate_random_seed) other sides execute the command simultaneously and is_simultaneously is set to true.

It's impossible to undo data that has been sent over the network.

false = we are on a local turn and haven't sent anything yet.

Definition at line 168 of file synced_context.hpp.

Referenced by block_undo(), reset_block_undo(), and undo_blocked().

◆ last_unit_id_

int synced_context::last_unit_id_ = 0

inlinestaticprivate

Used to restore the unit id manager when undoing.

Definition at line 171 of file synced_context.hpp.

Referenced by get_unit_id_diff(), and set_last_unit_id().

◆ state_

synced_state synced_context::state_ = synced_context::UNSYNCED

inlinestaticprivate

Weather we are in a synced move, in a user_choice, or none of them.

Definition at line 159 of file synced_context.hpp.

Referenced by get_synced_state(), and set_synced_state().

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

Classes

Public Types

Static Public Member Functions

Static Private Attributes

Detailed Description

Member Enumeration Documentation

◆ synced_state

Member Function Documentation

◆ ask_server_choice()

◆ block_undo()

◆ generate_random_seed()

◆ get_default_spectator()

◆ get_rng_for_action()

◆ get_synced_state()

◆ get_unit_id_diff()

◆ ignore_undo()

◆ is_synced()

◆ is_unsynced()

◆ pull_remote_user_input()

◆ reset_block_undo()

◆ run()

◆ run_and_store()

◆ run_and_throw()

◆ run_in_synced_context_if_not_already()

◆ send_user_choice()

◆ set_last_unit_id()

◆ set_synced_state()

◆ undo_blocked()

Member Data Documentation

◆ is_undo_blocked_

◆ last_unit_id_

◆ state_