Sapien::Scenario Namespace Reference

Namespace containing functions for interacting with a scenario. More...

Functions
SAPIEN_LIB_API BlamProject *	GetActiveProject ()
	Retrieves the currently active project. More...
SAPIEN_LIB_API BlamTag *	GetActiveScenarioTag ()
	Retrieves the currently active scenario tag. More...
SAPIEN_LIB_API bool	LoadScenario (std::string project_name, std::string tag_path)
	Loads a scenario tag. More...
SAPIEN_LIB_API bool	LoadScenario_Stage1 (std::string project_name, std::string tag_path)
	Performs stage 1 of loading a scenario tag. More...
SAPIEN_LIB_API bool	LoadScenario_Stage2 (std::string project_name, std::string tag_path)
	Performs stage 2 of loading a scenario tag. More...
SAPIEN_LIB_API bool	LoadScenario_Stage3 (std::string project_name, std::string tag_path)
	Performs stage 3 of loading a scenario tag. More...
SAPIEN_LIB_API bool	LoadScenario_Stage4 (std::string project_name, std::string tag_path)
	Performs stage 4 of loading a scenario tag. More...
SAPIEN_LIB_API bool	LoadScenario_Stage5 (std::string project_name, std::string tag_path)
	Performs stage 5 of loading a scenario tag. More...
SAPIEN_LIB_API void	SaveScenario ()
	Attempts to save any changes back to the scenario tag. More...

Detailed Description

Namespace containing functions for interacting with a scenario.

A scenario can be thought of as a self-contained "level" (or "scene" if you're familiar with other game engines). It will generally reference all data required for the level to load and operate.

Function Documentation

GetActiveProject()

BlamProject * Sapien::Scenario::GetActiveProject

(

)

Retrieves the currently active project.

Returns

Pointer to the currently active project.

GetActiveScenarioTag()

BlamTag * Sapien::Scenario::GetActiveScenarioTag

(

)

Retrieves the currently active scenario tag.

Returns

Pointer to the currently active scenario tag.

Here is the caller graph for this function:

LoadScenario()

bool Sapien::Scenario::LoadScenario	(	std::string	project_name,
		std::string	tag_path
	)

Loads a scenario tag.

Parameters

project_name	- The name of the project the scenario belongs to.
tag_path	- The tag path of the desired scenario tag.

Returns

true if the scenario was loaded successfuly, otherwise returns false.

Here is the call graph for this function:

LoadScenario_Stage1()

bool Sapien::Scenario::LoadScenario_Stage1	(	std::string	project_name,
		std::string	tag_path
	)

Performs stage 1 of loading a scenario tag.

This stage is responsible for locating the desired project and loading its data.

Parameters

project_name	- The name of the project the scenario belongs to.
tag_path	- The tag path of the desired scenario tag.

Returns

true if the stage completed successfuly, otherwise returns false.

Here is the caller graph for this function:

LoadScenario_Stage2()

bool Sapien::Scenario::LoadScenario_Stage2	(	std::string	project_name,
		std::string	tag_path
	)

Performs stage 2 of loading a scenario tag.

This stage is responsible for loading the desired scenario tag data. It will first try to load a decompiled tag if available, but will fall back to a compiled tag if needed. When loading a compiled tag, its version must exactly match - or else the load will be aborted.

Parameters

project_name	- The name of the project the scenario belongs to.
tag_path	- The tag path of the desired scenario tag.

Returns

true if the stage completed successfuly, otherwise returns false.

Here is the caller graph for this function:

LoadScenario_Stage3()

bool Sapien::Scenario::LoadScenario_Stage3	(	std::string	project_name,
		std::string	tag_path
	)

Performs stage 3 of loading a scenario tag.

This stage is responsible for recompiling a decompiled scenario tag. This ensures that there aren't any changes made to the decompiled tag that have not yet been compiled.

Parameters

project_name	- The name of the project the scenario belongs to.
tag_path	- The tag path of the desired scenario tag.

Returns

true if the stage completed successfuly, otherwise returns false.

Here is the caller graph for this function:

LoadScenario_Stage4()

bool Sapien::Scenario::LoadScenario_Stage4	(	std::string	project_name,
		std::string	tag_path
	)

Performs stage 4 of loading a scenario tag.

This stage is responsible for reading the loaded scenario tag data into the game engine. This will also load any other tags referenced within the scenario as well.

Parameters

project_name	- The name of the project the scenario belongs to.
tag_path	- The tag path of the desired scenario tag.

Returns

true if the stage completed successfuly, otherwise returns false.

Here is the caller graph for this function:

LoadScenario_Stage5()

bool Sapien::Scenario::LoadScenario_Stage5	(	std::string	project_name,
		std::string	tag_path
	)

Performs stage 5 of loading a scenario tag.

This stage is responsible for building the scenario hierarchy from the scenario tag.

Parameters

project_name	- The name of the project the scenario belongs to.
tag_path	- The tag path of the desired scenario tag.

Returns

true if the stage completed successfuly, otherwise returns false.

Here is the call graph for this function:

Here is the caller graph for this function:

SaveScenario()

void Sapien::Scenario::SaveScenario

(

)

Attempts to save any changes back to the scenario tag.

Here is the call graph for this function: