Description

Proxy class that can be called by script functions.

Definition at line 41 of file GameScript.h.

Public Member Functions
General
void	log (const Ogre::String &msg)

float	getTime ()

void	backToMenu ()

void	quitGame ()

float	getFPS ()

float	getAvgFPS ()

float	rangeRandom (float from, float to)

int	useOnlineAPI (const Ogre::String &apiquery, const AngelScript::CScriptDictionary &dict, Ogre::String &result)

void	openUrlInDefaultBrowser (const std::string &url)

void	fetchUrlAsStringAsync (const std::string &url, const std::string &display_filename)

bool	pushMessage (MsgType type, AngelScript::CScriptDictionary *dict)

bool	checkResourceExists (const std::string &filename, const std::string &resource_group)

bool	deleteResource (const std::string &filename, const std::string &resource_group)

std::string	loadTextResourceAsString (const std::string &filename, const std::string &resource_group)

bool	createTextResourceFromString (const std::string &data, const std::string &filename, const std::string &resource_group, bool overwrite=false)

Ogre::SceneManager *	getSceneManager ()

AngelScript::CScriptArray *	findResourceFileInfo (const std::string &resource_group, const std::string &pattern, bool dirs=false)

Ogre::Image	loadImageResource (const std::string &filename, const std::string &resource_group)

bool	serializeMeshResource (const std::string &filename, const std::string &resource_group, const Ogre::MeshPtr &mesh)

GUI
void	flashMessage (Ogre::String &txt, float time, float charHeight)

void	message (Ogre::String &txt, Ogre::String &icon)

int	getChatFontSize ()

void	setChatFontSize (int size)

void	showMessageBox (Ogre::String &title, Ogre::String &text, bool use_btn1, Ogre::String &btn1_text, bool allow_close, bool use_btn2, Ogre::String &btn2_text)

void	showChooser (const Ogre::String &type, const Ogre::String &instance, const Ogre::String &box)

void	updateDirectionArrow (Ogre::String &text, Ogre::Vector3 &vec)

void	hideDirectionArrow ()

bool	getScreenPosFromWorldPos (Ogre::Vector3 const &world_pos, Ogre::Vector2 &out_screen_pos)

Ogre::Vector2	getDisplaySize ()

Ogre::Vector2	getMouseScreenPosition ()

Script management
void	registerForEvent (int eventValue)

void	unRegisterEvent (int eventValue)

BitMask_t	getRegisteredEventsMask (ScriptUnitID_t nid)

void	setRegisteredEventsMask (ScriptUnitID_t nid, BitMask_t eventMask)

ScriptRetCode_t	addScriptFunction (const Ogre::String &arg, ScriptUnitID_t nid)

ScriptRetCode_t	scriptFunctionExists (const Ogre::String &arg, ScriptUnitID_t nid)

ScriptRetCode_t	deleteScriptFunction (const Ogre::String &arg, ScriptUnitID_t nid)

ScriptRetCode_t	addScriptVariable (const Ogre::String &arg, ScriptUnitID_t nid)

ScriptRetCode_t	scriptVariableExists (const Ogre::String &arg, ScriptUnitID_t nid)

ScriptRetCode_t	deleteScriptVariable (const Ogre::String &arg, ScriptUnitID_t nid)

ScriptRetCode_t	getScriptVariable (const Ogre::String &varName, void *ref, int refTypeId, ScriptUnitID_t nid)

void	clearEventCache ()

int	sendGameCmd (const Ogre::String &message)

AngelScript::CScriptArray *	getRunningScripts ()

AngelScript::CScriptDictionary *	getScriptDetails (ScriptUnitID_t nid)

Terrain
void	loadTerrain (const Ogre::String &terrain)

int	getLoadedTerrain (Ogre::String &result)

bool	getCaelumAvailable ()

Ogre::String	getCaelumTime ()

void	setCaelumTime (float value)

float	getGravity ()

void	setGravity (float value)

float	getGroundHeight (Ogre::Vector3 &v)

float	getWaterHeight ()

void	setWaterHeight (float value)

void	spawnObject (const Ogre::String &objectName, const Ogre::String &instanceName, const Ogre::Vector3 &pos, const Ogre::Vector3 &rot, const Ogre::String &eventhandler, bool uniquifyMaterials)

void	moveObjectVisuals (const Ogre::String &instanceName, const Ogre::Vector3 &pos)

void	destroyObject (const Ogre::String &instanceName)

AngelScript::CScriptArray *	getEditorObjects ()

bool	getMousePositionOnTerrain (Ogre::Vector3 &out_pos)

AngelScript::CScriptArray *	getMousePointedMovableObjects ()

TerrainPtr	getTerrain ()

Character
Ogre::Vector3	getPersonPosition ()

void	setPersonPosition (const Ogre::Vector3 &vec)

void	movePerson (const Ogre::Vector3 &vec)

void	setPersonRotation (const Ogre::Radian &rot)

Ogre::Radian	getPersonRotation ()

Actors
void	activateAllVehicles ()

void	setTrucksForcedAwake (bool forceActive)

void	boostCurrentTruck (float factor)

ActorPtr	getCurrentTruck ()

ActorPtr	getTruckByNum (int num)

AngelScript::CScriptArray *	getAllTrucks ()

int	getCurrentTruckNumber ()

ActorPtr	spawnTruck (Ogre::String &truckName, Ogre::Vector3 &pos, Ogre::Vector3 &rot)

void	repairVehicle (const Ogre::String &instance, const Ogre::String &box, bool keepPosition)

void	removeVehicle (const Ogre::String &instance, const Ogre::String &box)

int	getNumTrucksByFlag (int flag)

ActorPtr	getTruckRemotelyReceivingCommands ()

ActorInstanceID_t	getActorNextInstanceId ()

FreeForces - see <tt>game.pushMessage()</tt>
FreeForceID_t	getFreeForceNextId ()

FreeBeamGfxID_t	getFreeBeamGfxNextId ()

Waypoint AI for Actors; to understand these values, look in TopMenubar UI->VehicleAI tab.
ActorPtr	spawnTruckAI (Ogre::String &truckName, Ogre::Vector3 &pos, Ogre::String &truckSectionConfig, std::string &truckSkin, int x)

AngelScript::CScriptArray *	getWaypoints (int x)

AngelScript::CScriptArray *	getWaypointsSpeed ()

void	addWaypoint (const Ogre::Vector3 &pos)

void	clearWaypoints ()

int	getAIVehicleCount ()

int	getAIVehicleDistance ()

int	getAIVehiclePositionScheme ()

int	getAIVehicleSpeed ()

Ogre::String	getAIVehicleName (int x)

Ogre::String	getAIVehicleSectionConfig (int x)

std::string	getAIVehicleSkin (int x)

int	getAIRepeatTimes ()

int	getAIMode ()

VehicleAIPtr	getCurrentTruckAI ()

VehicleAIPtr	getTruckAIByNum (int num)

void	setAIVehicleCount (int count)

void	setAIVehicleDistance (int dist)

void	setAIVehiclePositionScheme (int scheme)

void	setAIVehicleSpeed (int speed)

void	setAIVehicleName (int x, std::string name)

void	setAIVehicleSectionConfig (int x, std::string config)

void	setAIVehicleSkin (int x, std::string skin)

void	setAIRepeatTimes (int times)

void	setAIMode (int mode)

Camera
void	setCameraPosition (const Ogre::Vector3 &pos)

void	setCameraDirection (const Ogre::Vector3 &vec)

void	setCameraOrientation (const Ogre::Quaternion &q)

void	setCameraRoll (float angle)

void	setCameraYaw (float angle)

void	setCameraPitch (float angle)

Ogre::Vector3	getCameraPosition ()

Ogre::Vector3	getCameraDirection ()

Ogre::Quaternion	getCameraOrientation ()

void	cameraLookAt (const Ogre::Vector3 &targetPoint)

Race system
void	stopTimer ()

void	startTimer (int id)

void	setTimeDiff (float diff)

void	setBestLapTime (float time)

Material helpers
int	setMaterialAmbient (const Ogre::String &materialName, float red, float green, float blue)

int	setMaterialDiffuse (const Ogre::String &materialName, float red, float green, float blue, float alpha)

int	setMaterialSpecular (const Ogre::String &materialName, float red, float green, float blue, float alpha)

int	setMaterialEmissive (const Ogre::String &materialName, float red, float green, float blue)

int	setMaterialTextureName (const Ogre::String &materialName, int techniqueNum, int passNum, int textureUnitNum, const Ogre::String &textureName)

int	setMaterialTextureRotate (const Ogre::String &materialName, int techniqueNum, int passNum, int textureUnitNum, float rotation)

int	setMaterialTextureScroll (const Ogre::String &materialName, int techniqueNum, int passNum, int textureUnitNum, float sx, float sy)

int	setMaterialTextureScale (const Ogre::String &materialName, int techniqueNum, int passNum, int textureUnitNum, float u, float v)

Audio
AngelScript::CScriptArray *	getAllSoundScriptTemplates ()

SoundScriptTemplatePtr	getSoundScriptTemplate (const std::string &name)

AngelScript::CScriptArray *	getAllSoundScriptInstances ()

SoundPtr	createSoundFromResource (const std::string &filename, const std::string &resource_group_name)

SoundScriptInstancePtr	createSoundScriptInstance (const std::string &template_name, int actor_instance_id)

Private Member Functions
bool	HaveSimTerrain (const char *func_name)

bool	HavePlayerAvatar (const char *func_name)

bool	HaveMainCamera (const char *func_name)

std::string	CheckFileAccess (const char *func_name, const std::string &filename, const std::string &resource_group)

int	getTextureUnitState (Ogre::TextureUnitState **tu, const Ogre::String materialName, int techniqueNum, int passNum, int textureUnitNum)

void	logFormat (const char *fmt,...)

Member Function Documentation

◆ activateAllVehicles()

void GameScript::activateAllVehicles ( )

Definition at line 100 of file GameScript.cpp.

◆ addScriptFunction()

int GameScript::addScriptFunction	(	const Ogre::String &	arg,
		ScriptUnitID_t	nid
	)

Adds a global function to the script (Wrapper for ScriptEngine::addFunction)

Parameters

arg	A declaration for the function.

Definition at line 979 of file GameScript.cpp.

◆ addScriptVariable()

int GameScript::addScriptVariable	(	const Ogre::String &	arg,
		ScriptUnitID_t	nid
	)

Adds a global variable to the script (Wrapper for ScriptEngine::addVariable)

Parameters

arg	A declaration for the variable.

Definition at line 994 of file GameScript.cpp.

◆ addWaypoint()

void GameScript::addWaypoint ( const Ogre::Vector3 & pos )

Definition at line 1212 of file GameScript.cpp.

◆ backToMenu()

void GameScript::backToMenu ( )

Definition at line 1415 of file GameScript.cpp.

◆ boostCurrentTruck()

void GameScript::boostCurrentTruck ( float factor )

Definition at line 968 of file GameScript.cpp.

◆ cameraLookAt()

void GameScript::cameraLookAt ( const Ogre::Vector3 & targetPoint )

Points the camera at a location in worldspace.

Remarks: This is a helper method to automatically generate the direction vector for the camera, based on it's current position and the supplied look-at point.

Parameters

targetPoint A vector specifying the look at point.

Definition at line 828 of file GameScript.cpp.

◆ CheckFileAccess()

std::string GameScript::CheckFileAccess	(	const char *	func_name,
		const std::string &	filename,
		const std::string &	resource_group
	)

private

Extract filename and extension from the input, because OGRE allows absolute paths in resource system.

Definition at line 2174 of file GameScript.cpp.

◆ checkResourceExists()

bool GameScript::checkResourceExists	(	const std::string &	filename,
		const std::string &	resource_group
	)

Checks if the resource file exists in the given group.

KNOWN LIMITATION: If existing file is deleted externally, this function will still report it exists until the resource group is reloaded.

See also: https://ogrecave.github.io/ogre/api/latest/_resource-_management.html

Definition at line 1959 of file GameScript.cpp.

◆ clearEventCache()

void GameScript::clearEventCache ( )

Definition at line 739 of file GameScript.cpp.

◆ clearWaypoints()

void GameScript::clearWaypoints ( )

Definition at line 1219 of file GameScript.cpp.

◆ createSoundFromResource()

SoundPtr GameScript::createSoundFromResource	(	const std::string &	filename,
		const std::string &	resource_group_name
	)

Parameters

filename	WAV file.
resource_group_name	Leave empty to auto-search all groups (classic behavior).

Definition at line 1949 of file GameScript.cpp.

◆ createSoundScriptInstance()

SoundScriptInstancePtr GameScript::createSoundScriptInstance	(	const std::string &	template_name,
		int	actor_instance_id = `SoundScriptInstance::ACTOR_ID_UNKNOWN`
	)

Definition at line 1954 of file GameScript.cpp.

◆ createTextResourceFromString()

bool GameScript::createTextResourceFromString	(	const std::string &	data,
		const std::string &	filename,
		const std::string &	resource_group,
		bool	overwrite = `false`
	)

Saves a string as a text file resource.

See also: https://ogrecave.github.io/ogre/api/latest/_resource-_management.html

Parameters

data	The file data.
filename	Resource name within the resource group, equivalent to filename without path.
resource_group	Name of resource group to save to. If the group has multiple locations, first writable location is used.
overwrite	By default existing resources are not overwriten.

Returns: True on successful write. False if file not writable or exists and overwrite is disabled.

Definition at line 2044 of file GameScript.cpp.

◆ deleteResource()

bool GameScript::deleteResource	(	const std::string &	filename,
		const std::string &	resource_group
	)

Deletes a resource from the given group.

See also: https://ogrecave.github.io/ogre/api/latest/_resource-_management.html

Definition at line 1977 of file GameScript.cpp.

◆ deleteScriptFunction()

int GameScript::deleteScriptFunction	(	const Ogre::String &	arg,
		ScriptUnitID_t	nid
	)

Deletes a global function from the script (Wrapper for ScriptEngine::deleteFunction)

Parameters

arg	A declaration for the function.

Definition at line 989 of file GameScript.cpp.

◆ deleteScriptVariable()

int GameScript::deleteScriptVariable	(	const Ogre::String &	arg,
		ScriptUnitID_t	nid
	)

Deletes a global variable from the script (Wrapper for ScriptEngine::deleteVariable)

Parameters

arg	A declaration for the variable.

Definition at line 1004 of file GameScript.cpp.

◆ destroyObject()

void GameScript::destroyObject ( const Ogre::String & instanceName )

This destroys an object.

Parameters

instanceName The unique name that you chose when spawning this object

See also: spawnObject

Definition at line 426 of file GameScript.cpp.

◆ fetchUrlAsStringAsync()

void GameScript::fetchUrlAsStringAsync	(	const std::string &	url,
		const std::string &	display_filename
	)

Invokes a background thread to fetch data using CURL; when finished, sends MSG_APP_SCRIPT_THREAD_STATUS + Payload = RoR::ScriptEventArgs* (owner) - see SE_ANGELSCRIPT_THREAD_STATUS for arguments.

Definition at line 952 of file GameScript.cpp.

◆ findResourceFileInfo()

AngelScript::CScriptArray * GameScript::findResourceFileInfo	(	const std::string &	resource_group,
		const std::string &	pattern,
		bool	dirs = `false`
	)

Proxy to Ogre::ResourceGroupManager::findResourceFileInfo(), see https://ogrecave.github.io/ogre/api/1.11/class_ogre_1_1_resource_group_manager.html#a662f68163310401718d3c3981a7baec4.

Definition at line 2072 of file GameScript.cpp.

◆ flashMessage()

void GameScript::flashMessage	(	Ogre::String &	txt,
		float	time,
		float	charHeight
	)

DEPRECATED: use message() shows a message to the user.

Definition at line 329 of file GameScript.cpp.

◆ getActorNextInstanceId()

ActorInstanceID_t GameScript::getActorNextInstanceId ( )

Returns an unused (not reused) ID to use with MSG_SIM_SPAWN_ACTOR_REQUESTED; see game.pushMessage().

Definition at line 1921 of file GameScript.cpp.

◆ getAIMode()

int GameScript::getAIMode ( )

Definition at line 1315 of file GameScript.cpp.

◆ getAIRepeatTimes()

int GameScript::getAIRepeatTimes ( )

Definition at line 1309 of file GameScript.cpp.

◆ getAIVehicleCount()

int GameScript::getAIVehicleCount ( )

Definition at line 1243 of file GameScript.cpp.

◆ getAIVehicleDistance()

int GameScript::getAIVehicleDistance ( )

Definition at line 1249 of file GameScript.cpp.

◆ getAIVehicleName()

Ogre::String GameScript::getAIVehicleName ( int x )

Definition at line 1267 of file GameScript.cpp.

◆ getAIVehiclePositionScheme()

int GameScript::getAIVehiclePositionScheme ( )

Definition at line 1255 of file GameScript.cpp.

◆ getAIVehicleSectionConfig()

Ogre::String GameScript::getAIVehicleSectionConfig ( int x )

Definition at line 1281 of file GameScript.cpp.

◆ getAIVehicleSkin()

std::string GameScript::getAIVehicleSkin ( int x )

Definition at line 1295 of file GameScript.cpp.

◆ getAIVehicleSpeed()

int GameScript::getAIVehicleSpeed ( )

Definition at line 1261 of file GameScript.cpp.

◆ getAllSoundScriptInstances()

AngelScript::CScriptArray * GameScript::getAllSoundScriptInstances ( )

Definition at line 1944 of file GameScript.cpp.

◆ getAllSoundScriptTemplates()

CScriptArray * GameScript::getAllSoundScriptTemplates ( )

Definition at line 1934 of file GameScript.cpp.

◆ getAllTrucks()

AngelScript::CScriptArray * GameScript::getAllTrucks ( )

returns an array of all currently existing actors.

Returns: array<BeamClass@>

Definition at line 1198 of file GameScript.cpp.

◆ getAvgFPS()

float GameScript::getAvgFPS ( )

Definition at line 1431 of file GameScript.cpp.

◆ getCaelumAvailable()

bool GameScript::getCaelumAvailable ( )

Definition at line 182 of file GameScript.cpp.

◆ getCaelumTime()

String GameScript::getCaelumTime ( )

gets the time of the day in seconds

Returns: string with HH::MM::SS format

Definition at line 160 of file GameScript.cpp.

◆ getCameraDirection()

Vector3 GameScript::getCameraDirection ( )

Gets the camera's direction.

Returns: A vector representing the direction of the camera

Definition at line 809 of file GameScript.cpp.

◆ getCameraOrientation()

Quaternion GameScript::getCameraOrientation ( )

Gets the camera's orientation.

Returns: A quaternion representing the orientation of the camera

Definition at line 820 of file GameScript.cpp.

◆ getCameraPosition()

Vector3 GameScript::getCameraPosition ( )

Retrieves the camera's position.

Returns: The current position of the camera

Definition at line 801 of file GameScript.cpp.

◆ getChatFontSize()

int GameScript::getChatFontSize ( )

OBSOLETE, returns 0;.

Definition at line 344 of file GameScript.cpp.

◆ getCurrentTruck()

ActorPtr GameScript::getCurrentTruck ( )

returns the current selected truck, 0 if in person mode

Returns: reference to Beam object that is currently in use

Definition at line 240 of file GameScript.cpp.

◆ getCurrentTruckAI()

VehicleAIPtr GameScript::getCurrentTruckAI ( )

Definition at line 1070 of file GameScript.cpp.

◆ getCurrentTruckNumber()

int GameScript::getCurrentTruckNumber ( )

returns the current truck number.

>=0 when using a truck, -1 when in person mode

Returns: integer truck number

Definition at line 279 of file GameScript.cpp.

◆ getDisplaySize()

Ogre::Vector2 GameScript::getDisplaySize ( )

Gets screen size in pixels.

Definition at line 525 of file GameScript.cpp.

◆ getEditorObjects()

AngelScript::CScriptArray * GameScript::getEditorObjects ( )

Returns array<TerrainEditorObjectClassPtr@> with all static objects on map (from any source).

Definition at line 402 of file GameScript.cpp.

◆ getFPS()

float GameScript::getFPS ( )

Definition at line 1426 of file GameScript.cpp.

◆ getFreeBeamGfxNextId()

FreeBeamGfxID_t GameScript::getFreeBeamGfxNextId ( )

Returns an unused (not reused) ID to use with MSG_SIM_ADD_FREEBEAMGFX_REQUESTED; see game.pushMessage().

Definition at line 1926 of file GameScript.cpp.

◆ getFreeForceNextId()

FreeForceID_t GameScript::getFreeForceNextId ( )

Returns an unused (not reused) ID to use with MSG_SIM_ADD_FREEFORCE_REQUESTED; see game.pushMessage().

Definition at line 1916 of file GameScript.cpp.

◆ getGravity()

float GameScript::getGravity ( )

returns the currently set upo gravity

Returns: float number describing gravity terrain wide.

Definition at line 245 of file GameScript.cpp.

◆ getGroundHeight()

float GameScript::getGroundHeight ( Ogre::Vector3 & v )

Gets terrain height at given coordinates.

Definition at line 224 of file GameScript.cpp.

◆ getLoadedTerrain()

int GameScript::getLoadedTerrain ( Ogre::String & result )

gets the name of current terrain.

Returns: 1 on success, 0 if terrain not loaded

Definition at line 721 of file GameScript.cpp.

◆ getMousePointedMovableObjects()

CScriptArray * GameScript::getMousePointedMovableObjects ( )

Returns array<Ogre::MovableObjects@> in no particular order.

Definition at line 1469 of file GameScript.cpp.

◆ getMousePositionOnTerrain()

bool GameScript::getMousePositionOnTerrain ( Ogre::Vector3 & out_pos )

Calculates mouse cursor position on terrain.

Parameters

out_pos Calculated position, in meters.

Returns: true if mouse points to the terrain and output coordinates are valid.

Definition at line 1436 of file GameScript.cpp.

◆ getMouseScreenPosition()

Ogre::Vector2 GameScript::getMouseScreenPosition ( )

Gets mouse position in pixels.

Definition at line 531 of file GameScript.cpp.

◆ getNumTrucksByFlag()

int GameScript::getNumTrucksByFlag ( int flag )

Definition at line 268 of file GameScript.cpp.

◆ getPersonPosition()

Vector3 GameScript::getPersonPosition ( )

Definition at line 128 of file GameScript.cpp.

◆ getPersonRotation()

Radian GameScript::getPersonRotation ( )

gets the character rotation

Returns: character rotation

Definition at line 152 of file GameScript.cpp.

◆ getRegisteredEventsMask()

BitMask_t GameScript::getRegisteredEventsMask ( ScriptUnitID_t nid )

Gets event mask for a specific running script.

Intended for diagnostic and monitoring purposes.

Parameters

nid	ScriptUnitID, obtain one from global var `thisScript` or callback parameters.

Definition at line 315 of file GameScript.cpp.

◆ getRunningScripts()

AngelScript::CScriptArray * GameScript::getRunningScripts ( )

Returns array<int> with active ScriptUnitIDs; check agains global var thisScript or use getScriptDetails() to get name etc...

Definition at line 1032 of file GameScript.cpp.

◆ getSceneManager()

Ogre::SceneManager * GameScript::getSceneManager ( )

Definition at line 1485 of file GameScript.cpp.

◆ getScreenPosFromWorldPos()

bool GameScript::getScreenPosFromWorldPos	(	Ogre::Vector3 const &	world_pos,
		Ogre::Vector2 &	out_screen_pos
	)

Parameters

world_pos	The world position to be converted, in meters.
out_screen_pos	The resulting screen position, in pixels.

Returns: true if the world position is in front of the camera and the resulting screen position is valid.

Definition at line 510 of file GameScript.cpp.

◆ getScriptDetails()

AngelScript::CScriptDictionary * GameScript::getScriptDetails ( ScriptUnitID_t nid )

Returns all info about running script; obtain the NID from getRunningScripts(), global var thisScript or event callbacks:

"uniqueId" (int64)
"scriptName" (string)
"scriptCategory" (enum ScriptCategory)
"eventMask" (int64)
"scriptBuffer" (string)

Definition at line 1042 of file GameScript.cpp.

◆ getScriptVariable()

int GameScript::getScriptVariable	(	const Ogre::String &	varName,
		void *	ref,
		int	refTypeId,
		ScriptUnitID_t	nid
	)

Retrieves a memory address of a global variable in any script.

Parameters

nid	ScriptUnitID, ID of the running script, obtain one from global var `thisScript` or `game.getRunningScripts()`
varName	Name of the variable. Type must match the reference type.
ref	Pointer to the variable's memory address; To be registered as variable-type parameter `?&out`
refTypeId	Type of the reference; To be registered as variable-type parameter `?&out`

Returns: 0 on success, negative number on error.

Definition at line 1009 of file GameScript.cpp.

◆ getSoundScriptTemplate()

SoundScriptTemplatePtr GameScript::getSoundScriptTemplate ( const std::string & name )

Definition at line 1939 of file GameScript.cpp.

◆ getTerrain()

RoR::TerrainPtr GameScript::getTerrain ( )

Definition at line 734 of file GameScript.cpp.

◆ getTextureUnitState()

int GameScript::getTextureUnitState	(	Ogre::TextureUnitState **	tu,
		const Ogre::String	materialName,
		int	techniqueNum,
		int	passNum,
		int	textureUnitNum
	)

private

Definition at line 605 of file GameScript.cpp.

◆ getTime()

float GameScript::getTime ( )

returns the time in seconds since the game was started

Returns: time in seconds

Definition at line 110 of file GameScript.cpp.

◆ getTruckAIByNum()

VehicleAIPtr GameScript::getTruckAIByNum ( int num )

Definition at line 1080 of file GameScript.cpp.

◆ getTruckByNum()

ActorPtr GameScript::getTruckByNum ( int num )

returns a truck by index, get max index by calling getNumTrucks

Returns: reference to Beam object that the selected slot

Definition at line 263 of file GameScript.cpp.

◆ getTruckRemotelyReceivingCommands()

ActorPtr GameScript::getTruckRemotelyReceivingCommands ( )

Actors with 'importcommands' flag will remotely respond to command keys when the player is close enough (works both on foot and in vehicles).

Definition at line 285 of file GameScript.cpp.

◆ getWaterHeight()

float GameScript::getWaterHeight ( )

returns the current base water level (without waves)

Returns: water height in meters

Definition at line 232 of file GameScript.cpp.

◆ getWaypoints()

AngelScript::CScriptArray * GameScript::getWaypoints ( int x )

Definition at line 1175 of file GameScript.cpp.

◆ getWaypointsSpeed()

AngelScript::CScriptArray * GameScript::getWaypointsSpeed ( )

Definition at line 1224 of file GameScript.cpp.

◆ HaveMainCamera()

bool GameScript::HaveMainCamera ( const char * func_name )

private

Helper; Check if main camera exists, log warning if not.

Definition at line 2164 of file GameScript.cpp.

◆ HavePlayerAvatar()

bool GameScript::HavePlayerAvatar ( const char * func_name )

private

Helper; Check if local Character instance exists, log warning if not.

Definition at line 2154 of file GameScript.cpp.

◆ HaveSimTerrain()

bool GameScript::HaveSimTerrain ( const char * func_name )

private

Helper; Check if SimController instance exists, log warning if not.

Definition at line 2144 of file GameScript.cpp.

◆ hideDirectionArrow()

void GameScript::hideDirectionArrow ( )

Definition at line 505 of file GameScript.cpp.

◆ loadImageResource()

Ogre::Image GameScript::loadImageResource	(	const std::string &	filename,
		const std::string &	resource_group
	)

Loads an image in any format recognized by OGRE.

Definition at line 2103 of file GameScript.cpp.

◆ loadTerrain()

void GameScript::loadTerrain ( const Ogre::String & terrain )

Definition at line 123 of file GameScript.cpp.

◆ loadTextResourceAsString()

std::string GameScript::loadTextResourceAsString	(	const std::string &	filename,
		const std::string &	resource_group
	)

Loads a text file resource as string.

See also: https://ogrecave.github.io/ogre/api/latest/_resource-_management.html

Parameters

filename	Resource name within the resource group, equivalent to filename without path.
resource_group	Name of resource group to load from

Definition at line 1996 of file GameScript.cpp.

◆ log()

void GameScript::log ( const Ogre::String & msg )

writes a message to the games log (RoR.log)

Parameters

msg	string to log

Definition at line 81 of file GameScript.cpp.

◆ logFormat()

void GameScript::logFormat	(	const char *	fmt,
			...
	)

private

writes a message to the games log (RoR.log)

Parameters

msg	string to log

Definition at line 86 of file GameScript.cpp.

◆ message()

void GameScript::message	(	Ogre::String &	txt,
		Ogre::String &	icon
	)

shows a message to the user over the console system

Definition at line 334 of file GameScript.cpp.

◆ moveObjectVisuals()

void GameScript::moveObjectVisuals	(	const Ogre::String &	instanceName,
		const Ogre::Vector3 &	pos
	)

This moves an object to a new position.

Note: This doesn't update the collision box!

Parameters

instanceName	The unique name that you chose when spawning this object
pos	The position where the object should be moved to

Definition at line 437 of file GameScript.cpp.

◆ movePerson()

void GameScript::movePerson ( const Ogre::Vector3 & vec )

moves the person relative

Parameters

vec	translation vector

Definition at line 136 of file GameScript.cpp.

◆ openUrlInDefaultBrowser()

void GameScript::openUrlInDefaultBrowser ( const std::string & url )

Opens URL (must start with 'http://' or 'https://') in system's default web browser.

Definition at line 947 of file GameScript.cpp.

◆ pushMessage()

bool GameScript::pushMessage	(	MsgType	type,
		AngelScript::CScriptDictionary *	dict
	)

Pushes a message to internal message queue.

Parameters are listed in Script2Game::MsgType comments.

Returns: True if the message was pushed, false if it was rejected.

< Payload = RoR::LoadScriptRequest* (owner)

< Payload = RoR::ScriptUnitId_t* (owner)

< Payload = RoR::ActorSpawnRequest* (owner)

< Payload = RoR::ActorModifyRequest* (owner)

< Payload = RoR::ActorPtr* (owner)

< Payload = ActorPtr* (owner)

< Payload = RoR::ActorPtr (owner) | nullptr

< Payload = Ogre::Vector3* (owner)

< Payload = RoR::CacheEntryPtr* (owner)

< Payload = RoR::CreateProjectRequest* (owner)

Definition at line 1490 of file GameScript.cpp.

◆ quitGame()

void GameScript::quitGame ( )

Definition at line 1421 of file GameScript.cpp.

◆ rangeRandom()

float GameScript::rangeRandom	(	float	from,
		float	to
	)

Definition at line 716 of file GameScript.cpp.

◆ registerForEvent()

void GameScript::registerForEvent ( int eventValue )

registers for a new event to be received by the scripting system

Parameters

eventValue

See also: enum scriptEvents

Definition at line 291 of file GameScript.cpp.

◆ removeVehicle()

void GameScript::removeVehicle	(	const Ogre::String &	instance,
		const Ogre::String &	box
	)

Definition at line 393 of file GameScript.cpp.

◆ repairVehicle()

void GameScript::repairVehicle	(	const Ogre::String &	instance,
		const Ogre::String &	box,
		bool	keepPosition
	)

Definition at line 388 of file GameScript.cpp.

◆ scriptFunctionExists()

int GameScript::scriptFunctionExists	(	const Ogre::String &	arg,
		ScriptUnitID_t	nid
	)

Checks if a global function exists in the script (Wrapper for ScriptEngine::functionExists)

Parameters

arg	A declaration for the function.

Definition at line 984 of file GameScript.cpp.

◆ scriptVariableExists()

int GameScript::scriptVariableExists	(	const Ogre::String &	arg,
		ScriptUnitID_t	nid
	)

Adds a global variable to the script (Wrapper for ScriptEngine::variableExists)

Parameters

arg	A declaration for the variable.

Definition at line 999 of file GameScript.cpp.

◆ sendGameCmd()

int GameScript::sendGameCmd ( const Ogre::String & message )

Multiplayer only: sends AngelScript snippet to all players.

Definition at line 1014 of file GameScript.cpp.

◆ serializeMeshResource()

bool GameScript::serializeMeshResource	(	const std::string &	filename,
		const std::string &	resource_group,
		const Ogre::MeshPtr &	mesh
	)

Uses Ogre::MeshSerializer to save binary .mesh file (latest format, native endianness).

Definition at line 2121 of file GameScript.cpp.

◆ setAIMode()

void GameScript::setAIMode ( int mode )

Definition at line 1392 of file GameScript.cpp.

◆ setAIRepeatTimes()

void GameScript::setAIRepeatTimes ( int times )

Definition at line 1387 of file GameScript.cpp.

◆ setAIVehicleCount()

void GameScript::setAIVehicleCount ( int count )

Definition at line 1323 of file GameScript.cpp.

◆ setAIVehicleDistance()

void GameScript::setAIVehicleDistance ( int dist )

Definition at line 1328 of file GameScript.cpp.

◆ setAIVehicleName()

void GameScript::setAIVehicleName	(	int	x,
		std::string	name
	)

Definition at line 1343 of file GameScript.cpp.

◆ setAIVehiclePositionScheme()

void GameScript::setAIVehiclePositionScheme ( int scheme )

Definition at line 1333 of file GameScript.cpp.

◆ setAIVehicleSectionConfig()

void GameScript::setAIVehicleSectionConfig	(	int	x,
		std::string	config
	)

Definition at line 1355 of file GameScript.cpp.

◆ setAIVehicleSkin()

void GameScript::setAIVehicleSkin	(	int	x,
		std::string	skin
	)

Definition at line 1371 of file GameScript.cpp.

◆ setAIVehicleSpeed()

void GameScript::setAIVehicleSpeed ( int speed )

Definition at line 1338 of file GameScript.cpp.

◆ setBestLapTime()

void GameScript::setBestLapTime ( float time )

Definition at line 207 of file GameScript.cpp.

◆ setCaelumTime()

void GameScript::setCaelumTime ( float value )

sets the time of the day in seconds

Parameters

value day time in seconds

Definition at line 172 of file GameScript.cpp.

◆ setCameraDirection()

void GameScript::setCameraDirection ( const Ogre::Vector3 & vec )

Sets the camera's direction vector.

Parameters

vec	A vector representing the direction of the vector.

Definition at line 761 of file GameScript.cpp.

◆ setCameraOrientation()

void GameScript::setCameraOrientation ( const Ogre::Quaternion & q )

Sets the camera's orientation.

Parameters

vec	A vector representing the direction of the vector.

Definition at line 769 of file GameScript.cpp.

◆ setCameraPitch()

void GameScript::setCameraPitch ( float angle )

Pitches the camera up/down anticlockwise around it's local z axis.

Parameters

angle The pitch-angle

Definition at line 785 of file GameScript.cpp.

◆ setCameraPosition()

void GameScript::setCameraPosition ( const Ogre::Vector3 & pos )

Sets the camera's position.

Parameters

pos	The new position of the camera.

Definition at line 753 of file GameScript.cpp.

◆ setCameraRoll()

void GameScript::setCameraRoll ( float angle )

Rolls the camera anticlockwise, around its local z axis.

Parameters

angle The roll-angle

Definition at line 793 of file GameScript.cpp.

◆ setCameraYaw()

void GameScript::setCameraYaw ( float angle )

Rotates the camera anticlockwise around it's local y axis.

Parameters

angle The yaw-angle

Definition at line 777 of file GameScript.cpp.

◆ setChatFontSize()

void GameScript::setChatFontSize ( int size )

OBSOLETE, does nothing.

Definition at line 349 of file GameScript.cpp.

◆ setGravity()

void GameScript::setGravity ( float value )

sets the gravity terrain wide.

This is an expensive call, since the masses of all trucks are recalculated.

Parameters

value new gravity terrain wide (default is -9.81)

Definition at line 255 of file GameScript.cpp.

◆ setMaterialAmbient()

int GameScript::setMaterialAmbient	(	const Ogre::String &	materialName,
		float	red,
		float	green,
		float	blue
	)

Definition at line 537 of file GameScript.cpp.

◆ setMaterialDiffuse()

int GameScript::setMaterialDiffuse	(	const Ogre::String &	materialName,
		float	red,
		float	green,
		float	blue,
		float	alpha
	)

Definition at line 554 of file GameScript.cpp.

◆ setMaterialEmissive()

int GameScript::setMaterialEmissive	(	const Ogre::String &	materialName,
		float	red,
		float	green,
		float	blue
	)

Definition at line 588 of file GameScript.cpp.

◆ setMaterialSpecular()

int GameScript::setMaterialSpecular	(	const Ogre::String &	materialName,
		float	red,
		float	green,
		float	blue,
		float	alpha
	)

Definition at line 571 of file GameScript.cpp.

◆ setMaterialTextureName()

int GameScript::setMaterialTextureName	(	const Ogre::String &	materialName,
		int	techniqueNum,
		int	passNum,
		int	textureUnitNum,
		const Ogre::String &	textureName
	)

Definition at line 639 of file GameScript.cpp.

◆ setMaterialTextureRotate()

int GameScript::setMaterialTextureRotate	(	const Ogre::String &	materialName,
		int	techniqueNum,
		int	passNum,
		int	textureUnitNum,
		float	rotation
	)

Definition at line 659 of file GameScript.cpp.

◆ setMaterialTextureScale()

int GameScript::setMaterialTextureScale	(	const Ogre::String &	materialName,
		int	techniqueNum,
		int	passNum,
		int	textureUnitNum,
		float	u,
		float	v
	)

Definition at line 697 of file GameScript.cpp.

◆ setMaterialTextureScroll()

int GameScript::setMaterialTextureScroll	(	const Ogre::String &	materialName,
		int	techniqueNum,
		int	passNum,
		int	textureUnitNum,
		float	sx,
		float	sy
	)

Definition at line 678 of file GameScript.cpp.

◆ setPersonPosition()

void GameScript::setPersonPosition ( const Ogre::Vector3 & vec )

sets the character position

Parameters

vec	position vector on the terrain

Definition at line 115 of file GameScript.cpp.

◆ setPersonRotation()

void GameScript::setPersonRotation ( const Ogre::Radian & rot )

sets the character rotation

Parameters

rot	the character rotation

Definition at line 144 of file GameScript.cpp.

◆ setRegisteredEventsMask()

void GameScript::setRegisteredEventsMask	(	ScriptUnitID_t	nid,
		BitMask_t	eventMask
	)

Overwrites event mask for a specific running script.

Intended for debugging tools - use with caution.

Parameters

nid	ScriptUnitID, obtain one from global var `thisScript` or callback parameters.
eventMask

See also: enum scriptEvents

Definition at line 323 of file GameScript.cpp.

◆ setTimeDiff()

void GameScript::setTimeDiff ( float diff )

Definition at line 202 of file GameScript.cpp.

◆ setTrucksForcedAwake()

void GameScript::setTrucksForcedAwake ( bool forceActive )

Definition at line 105 of file GameScript.cpp.

◆ setWaterHeight()

void GameScript::setWaterHeight ( float value )

sets the base water height

Parameters

value base height in meters

Definition at line 212 of file GameScript.cpp.

◆ showChooser()

void GameScript::showChooser	(	const Ogre::String &	type,
		const Ogre::String &	instance,
		const Ogre::String &	box
	)

Definition at line 354 of file GameScript.cpp.

◆ showMessageBox()

void GameScript::showMessageBox	(	Ogre::String &	title,
		Ogre::String &	text,
		bool	use_btn1,
		Ogre::String &	btn1_text,
		bool	allow_close,
		bool	use_btn2,
		Ogre::String &	btn2_text
	)

Definition at line 1397 of file GameScript.cpp.

◆ spawnObject()

void GameScript::spawnObject	(	const Ogre::String &	objectName,
		const Ogre::String &	instanceName,
		const Ogre::Vector3 &	pos,
		const Ogre::Vector3 &	rot,
		const Ogre::String &	eventhandler,
		bool	uniquifyMaterials
	)

This spawns a static terrain object (.ODEF file)

Parameters

objectName	The name of the object (~the name of the odef file, but without the .odef extension)
instanceName	A unique name for this object (you can choose one, but make sure that you don't use the same name twice)
pos	The position where the object should be spawned
rot	The rotation in which the object should be spawned
eventhandler	A name of a function that should be called when an event happens (events, as defined in the object definition file)
uniquifyMaterials	Set this to true if you need to uniquify the materials

Definition at line 448 of file GameScript.cpp.

◆ spawnTruck()

ActorPtr GameScript::spawnTruck	(	Ogre::String &	truckName,
		Ogre::Vector3 &	pos,
		Ogre::Vector3 &	rot
	)

Definition at line 1091 of file GameScript.cpp.

◆ spawnTruckAI()

ActorPtr GameScript::spawnTruckAI	(	Ogre::String &	truckName,
		Ogre::Vector3 &	pos,
		Ogre::String &	truckSectionConfig,
		std::string &	truckSkin,
		int	x
	)

Definition at line 1125 of file GameScript.cpp.

◆ startTimer()

void GameScript::startTimer ( int id )

Definition at line 197 of file GameScript.cpp.

◆ stopTimer()

void GameScript::stopTimer ( )

Definition at line 192 of file GameScript.cpp.

◆ unRegisterEvent()

void GameScript::unRegisterEvent ( int eventValue )

unregisters from receiving event.

Parameters

eventValue

See also: enum scriptEvents

Definition at line 303 of file GameScript.cpp.

◆ updateDirectionArrow()

void GameScript::updateDirectionArrow	(	Ogre::String &	text,
		Ogre::Vector3 &	vec
	)

set direction arrow

Parameters

text	text to be displayed. "" to hide the text

Definition at line 339 of file GameScript.cpp.

◆ useOnlineAPI()

int GameScript::useOnlineAPI	(	const Ogre::String &	apiquery,
		const AngelScript::CScriptDictionary &	dict,
		Ogre::String &	result
	)

Definition at line 836 of file GameScript.cpp.

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

source/main/scripting/GameScript.h
source/main/scripting/GameScript.cpp

Description

Public Member Functions

Private Member Functions

Member Function Documentation

◆ activateAllVehicles()

◆ addScriptFunction()

◆ addScriptVariable()

◆ addWaypoint()

◆ backToMenu()

◆ boostCurrentTruck()

◆ cameraLookAt()

◆ CheckFileAccess()

◆ checkResourceExists()

◆ clearEventCache()

◆ clearWaypoints()

◆ createSoundFromResource()

◆ createSoundScriptInstance()

◆ createTextResourceFromString()

◆ deleteResource()

◆ deleteScriptFunction()

◆ deleteScriptVariable()

◆ destroyObject()

◆ fetchUrlAsStringAsync()

◆ findResourceFileInfo()

◆ flashMessage()

◆ getActorNextInstanceId()

◆ getAIMode()

◆ getAIRepeatTimes()

◆ getAIVehicleCount()

◆ getAIVehicleDistance()

◆ getAIVehicleName()

◆ getAIVehiclePositionScheme()

◆ getAIVehicleSectionConfig()

◆ getAIVehicleSkin()

◆ getAIVehicleSpeed()

◆ getAllSoundScriptInstances()

◆ getAllSoundScriptTemplates()

◆ getAllTrucks()

◆ getAvgFPS()

◆ getCaelumAvailable()

◆ getCaelumTime()

◆ getCameraDirection()

◆ getCameraOrientation()

◆ getCameraPosition()

◆ getChatFontSize()

◆ getCurrentTruck()

◆ getCurrentTruckAI()

◆ getCurrentTruckNumber()

◆ getDisplaySize()

◆ getEditorObjects()

◆ getFPS()

◆ getFreeBeamGfxNextId()

◆ getFreeForceNextId()

◆ getGravity()

◆ getGroundHeight()

◆ getLoadedTerrain()

◆ getMousePointedMovableObjects()

◆ getMousePositionOnTerrain()

◆ getMouseScreenPosition()

◆ getNumTrucksByFlag()

◆ getPersonPosition()

◆ getPersonRotation()

◆ getRegisteredEventsMask()

◆ getRunningScripts()

◆ getSceneManager()

◆ getScreenPosFromWorldPos()

◆ getScriptDetails()

◆ getScriptVariable()

◆ getSoundScriptTemplate()

◆ getTerrain()

◆ getTextureUnitState()

◆ getTime()

◆ getTruckAIByNum()

◆ getTruckByNum()

◆ getTruckRemotelyReceivingCommands()

◆ getWaterHeight()

◆ getWaypoints()

◆ getWaypointsSpeed()

◆ HaveMainCamera()

◆ HavePlayerAvatar()