GetObject

getObject

Available since: v3.0

Lua Syntax:

getObject(path_or_tuple [, logWarning])

Arguments

path_or_tuple

"string" - Path to a Visionaire Object. The path has to start with a table name, then follows the object name in brackets ('[',']') - only the game table does not have an object name. Optionally a field name (field type must either be t_link or t_links) can follow after a dot '.'. For t_links fields you must specify an object name in brackets ('[',']'). For t_link fields there are no brackets. Alternatively you can also pass in a tuple with the table id and the object id, e.g. "(0,3)".

logWarning

true|false - If true (default) a warning will be printed to the log file if the object could not be found.

Return Values

visionaireObject

The found visionaire object or an empty object if no object was found.

Examples

Example 1: Access object by scanning whole object table (object name must be unique for whole table)

getObject("Conditions[door_open?]") -- get condition with name 'door open?'

Example 2: Specific object access

getObject("Scenes[office].SceneConditions[door_open?]") -- get condition 'door open?' linked to scene 'office'