Difference between revisions of "GetObject (CMS)"

From The Official Visionaire Studio: Adventure Game Engine Wiki
(Redirected page to Global Command: getObject)
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<div class="toccolours mw-collapsible mw-collapsed tbl-ds">
+
#REDIRECT [[Global Command: getObject]]
<span class="bold">Command History</span>
 
<div class="mw-collapsible-content">
 
<div class="alt-bg">Available since v3.0</div>
 
</div></div>
 
 
 
 
 
Allows you to access, read & manipulate the data tables for the linked object, item, character, condition, & value etc...
 
 
 
<div class="toccolours mw-collapsible mw-collapsed tbl-ds">
 
<span class="bold">Additional Info</span>
 
<div class="mw-collapsible-content">
 
<div>''!important'': The object names are case sensitive.</div>
 
</div></div>
 
 
 
 
 
Syntax:
 
<syntaxhighlight>
 
getObject("path[object]")
 
</syntaxhighlight>
 
 
 
 
 
Example 1: Quick getObject method; you must take care when using this method, that your project does not contain multiple objects with the same name.
 
<syntaxhighlight>
 
-- This method is unsafe because it accesses all the condition/value tables associated with the project
 
getObject("Conditions[condition_name]") -- get a condition
 
getObject("Values[value_name]") -- get a value
 
getObject("Actions[action_name]") -- get an action
 
getObject("Animations[animation_name]") -- get an animation
 
</syntaxhighlight>
 
 
 
Example 2: Full getObject method.
 
<syntaxhighlight>
 
-- * scenes * --
 
getObject("Scenes[scene_name].SceneConditions[condition_name]") -- get condition linked to a scene
 
getObject("Scenes[scene_name].SceneObjects[object_name].ObjectConditions[condition_name]") -- get condition linked to a scene object
 
getObject("Scenes[scene_name].SceneValues[value_name]") -- get value linked to a scene
 
getObject("Scenes[scene_name].SceneObjects[object_name].ObjectValues[value_name]") -- get value linked to a scene object
 
getObject("Scenes[scene_name].SceneActions[action_name]") --
 
getObject("scenes[scene_name].SceneObjects[object_name].ObjectAnimations[animation_name]") -- get animation linked to a scene object
 
-- * characters * --
 
getObject("Characters[character_name].CharacterConditions[condition_name]") -- get condition linked to a character
 
getObject("Characters[character_name].CharacterValues[value_name]") -- get value linked to a character
 
getObject("Characters[character_name].CharacterActions[action_name]") -- get action linked to a character
 
getObject("Characters[character_name].CharacterOutfits[outfit_name].OutfitCharacterAnimations[animation_name]") -- get animation linked to a character
 
-- etc...
 
</syntaxhighlight>
 
 
 
 
 
 
 
<span class="bold underline">Arguments</span>
 
 
 
'''Path''': "string" <br/>
 
The path to the required data structure object.
 
 
 
'''Object''': text<br/>
 
name of the object, character, condition etc; the name is case sensitive.
 
 
 
 
 
<span class="bold underline">Flags</span>
 
 
 
none
 
 
 
 
 
<span class="bold underline">Return</span>
 
 
 
'''object''' <br/>
 
Returns the data from the linked objects table.
 
{{i18n|GetObject_(CMS)}}
 

Latest revision as of 13:56, 19 May 2023