Difference between revisions of "StartAction"

From The Official Visionaire Studio: Adventure Game Engine Wiki
Line 13: Line 13:
 
startAction(action)
 
startAction(action)
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
  
 
Example 1: basic start action method
 
Example 1: basic start action method
 
<syntaxhighlight enclose="div">
 
<syntaxhighlight enclose="div">
 
--[[
 
--[[
!important: you must take care when using this method that you don't have multiple instances of actions with the same name!
+
!important: you must take care when using this method that you don't have multiple instances of actions with the same name otherwise it will not work correctly!
 
--]]
 
--]]
  

Revision as of 22:55, 6 March 2013

Command History

Available since v3.7


Allows you to start any "called by other action" you include!


Syntax:

startAction(action)


Example 1: basic start action method

--[[
!important: you must take care when using this method that you don't have multiple instances of actions with the same name otherwise it will not work correctly!
--]]

-- shortened get action method; !important: see comment above!
startAction([getObject("Actions[action_name]")])


-- full get action method; !recommended
getObject("Scenes[scene_name].SceneObjects[object_name].SceneActions[action_name]")

Example 2: start action via a variable <syntaxhighlight -- you can of course use variables with actions stored in them instead! local act = getObject("Actions[action_name]") startAction(act) </syntaxhighlight>


Arguments

action: link
The link to the action to be started! ("path|"object_id"|"action_name")

Flags: none

Return: visionaireObject
The visionaire object representing the active action!