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 21: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!