Difference between revisions of "StopAnimation"

From The Official Visionaire Studio: Adventure Game Engine Wiki
Line 1: Line 1:
<div class="toccolours mw-collapsible mw-collapsed" style="background: #f0f0f0; border: 1px dashed darkgrey" width="100%">
+
<div class="toccolours mw-collapsible mw-collapsed tbl-ds">
<b>Command History</b>
+
<span class="bold">Command History</span>
 
<div class="mw-collapsible-content">
 
<div class="mw-collapsible-content">
<div style="background:#ebebeb" width="100%">Available since <span style="color:orange">v3.7</span></div>
+
<div class="alt-bg">Available since v3.7</div>
 
</div></div>
 
</div></div>
  
Line 38: Line 38:
  
  
<b><u>Arguments</u></b>
+
<span class="bold underline">Arguments</span>
  
<b>animation</b>: path <br/>
+
<span class="bold">animation</span>: path <br/>
 
The path to the animation to be stopped! ("path"."object"."animation")
 
The path to the animation to be stopped! ("path"."object"."animation")
  
  
<b><u>Flags</u></b>
+
<span class="bold underline">Flags</span>
  
 
none
 
none
  
  
<b><u>Return</u></b>
+
<span>Return</span>
  
 
none
 
none
 
{{i18n|StopAnimation}} <br/>
 
{{i18n|StopAnimation}} <br/>
{| style="background: #f0f0f0; border: 1px dashed darkgrey" width="100%"
+
{| class="tbl-ds"
 
|-
 
|-
|<b>Relevant Pages</b>: [[StartAnimation|startAnimation]]
+
|<span class="bold">Relevant Pages</span>: [[StartAnimation|startAnimation]]
 
|}
 
|}

Revision as of 12:52, 5 April 2013

Command History

Available since v3.7


Allows you to stop any active animation; if the animation is not active then nothing happens!


Syntax:

stopAnimation(animation)


Example 1: basic stop animation method

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

-- shortened get animation method; !important: see comment above!
stopAnimation("Animations[animation_name]")


-- full get animation method; !recommended
stopAnimation("Scenes[scene_name].SceneObjects[object_name].ObjectAnimations[animation_name]")

Example 2: stop animation via a variable

-- you can of course use variables with animations stored in them instead!
local anim = getObject("Animations[animation_name]")
stopAnimation(anim)


Arguments

animation: path
The path to the animation to be stopped! ("path"."object"."animation")


Flags

none


Return

none


Relevant Pages: startAnimation