|
|
| Line 1: |
Line 1: |
| − | =Members=
| + | This page has moved to: https://docs.sine.space/v/scripting/client-scripting/components/sanimation |
| − | | + | |
| − | {{ScriptFunction|void|Blend|(string animation, float targetWeight 1.0F, float fadeLength 0.3F)|Blends the animation named animation towards targetWeight over the next time seconds. Playback of other animations will not be affected.|5=<pre>Space.Host.ExecutingObject.Animation.Blend("animationname",1.0,0.3)</pre>}}
| + | |
| − | | + | |
| − | {{ScriptFunction|void|CrossFade|(string animation, float fadeLength 0.3)|Fades the animation with name animation in over a period of time seconds and fades other animations out.
| + | |
| − | | + | |
| − | If mode is PlayMode.StopSameLayer, animations in the same layer as animation will be faded out while animation is faded in. if mode is PlayMode.StopAll, all animations will be faded out while animation is faded in.
| + | |
| − | | + | |
| − | If the animation is not set to be looping it will be stopped and rewound after playing.|5=<pre>Space.Host.ExecutingObject.Animation.CrossFade("animationname", 0.3)</pre>}}
| + | |
| − | | + | |
| − | {{ScriptFunction|SAnimationState|CrossFadeQueued|(string animation, float fadeLength 0.3, bool playNow false)|Returns a duplicated SAnimationState. This duplicate will self-destruct after it is finished playing. Referencing it after it has completed will result in an error.|5=<pre>NewSAnimationState = Space.Host.ExecutingObject.Animation.CrossFadeQueued("animationname", 0.3, false)</pre>}}
| + | |
| − | | + | |
| − | {{ScriptFunction|int|GetClipCount|()|Get the number of clips currently assigned to this animation.|5=<pre>NumberOfClips = Space.Host.ExecutingObject.Animation.GetClipCount() </pre>}}
| + | |
| − | | + | |
| − | {{ScriptFunction|SAnimationState|GetState|()|Returns the SAnimationState for the default animation clip.|5=<pre>State = Space.Host.ExecutingObject.Animation.GetState()</pre>}}
| + | |
| − | | + | |
| − | {{ScriptFunction|SAnimationState|GetState|(string state)|Returns the SAnimationState for the named animation clip.|5=<pre>State = Space.Host.ExecutingObject.Animation.GetState("statename")</pre>}}
| + | |
| − | | + | |
| − | {{ScriptFunction|bool|IsPlaying|(string animation)|Is the animation named name playing?
| + | |
| − | |5=<pre>IsPlaying = Space.Host.ExecutingObject.Animation.IsPlaying("animationname")</pre>}}
| + | |
| − | | + | |
| − | {{ScriptFunction|bool|Play|()|Plays an animation without any blending.
| + | |
| − | | + | |
| − | If no name is supplied then the default animation will be played. In cases where the animation can't be played (ie, there is no default animation or no animation with the specified name), the function will return false.
| + | |
| − | | + | |
| − | The optional playMode lets you choose how this animation will affect others already playing.
| + | |
| − | | + | |
| − | If the specified animation is already playing then other animations will be stopped but the animation will not rewind to the beginning.
| + | |
| − | | + | |
| − | When the end of the animation is reached it will automatically be stopped and rewound to the start unless the PlayMode is set to Loop.
| + | |
| − | | + | |
| − | Note that if you call Animation.Play on an object during a frame update where the object is also deactivated then the call will effectively be cancelled; the animation will not start playing when the object is later reactivated. However, if you make the call on a subsequent frame (ie, while the object is still inactive) then the animation will start playing after reactivation.|5=<pre>Space.Host.ExecutingObject.Animation.Play()</pre>|6=<pre></pre>}}
| + | |
| − | | + | |
| − | {{ScriptFunction|bool|Play|(string animation)|Plays an animation without any blending.
| + | |
| − | | + | |
| − | If no name is supplied then the default animation will be played. In cases where the animation can't be played (ie, there is no default animation or no animation with the specified name), the function will return false.
| + | |
| − | | + | |
| − | The optional playMode lets you choose how this animation will affect others already playing.
| + | |
| − | | + | |
| − | If the specified animation is already playing then other animations will be stopped but the animation will not rewind to the beginning.
| + | |
| − | | + | |
| − | When the end of the animation is reached it will automatically be stopped and rewound to the start unless the PlayMode is set to Loop.
| + | |
| − | | + | |
| − | Note that if you call Animation.Play on an object during a frame update where the object is also deactivated then the call will effectively be cancelled; the animation will not start playing when the object is later reactivated. However, if you make the call on a subsequent frame (ie, while the object is still inactive) then the animation will start playing after reactivation.|5=<pre>Space.Host.ExecutingObject.Animation.Play("animationname")</pre>}}
| + | |
| − | | + | |
| − | {{ScriptFunction|SAnimationState|PlayQueued|(string animation,
| + | |
| − | bool playNow false)|Returns a duplicated SAnimationState. This duplicate will self-destruct after it is finished playing. Referencing it after it has completed will result in an error.|5=<pre>Space.Host.ExecutingObject.Animation.PlayQueued("animationname","false")</pre>}}
| + | |
| − | | + | |
| − | {{ScriptFunction|void|Rewind|(string animation)|Rewinds the animation named name.|5=<pre>Space.Host.ExecutingObject.Animation.Rewind()</pre>}}
| + | |
| − | | + | |
| − | {{ScriptFunction|void|Sample|()|Samples animations at the current state.
| + | |
| − | | + | |
| − | This is useful when you explicitly want to set up some animation state, and sample it once.|5=<pre>Space.Host.ExecutingObject.Animation.Sample()</pre>}}
| + | |
| − | | + | |
| − | {{ScriptFunction|void|Stop|()|Stops all playing animations that were started with this Animation.
| + | |
| − | | + | |
| − | Stopping an animation also Rewinds it to the Start.|5=<pre>Space.Host.ExecutingObject.Animation.Stop()</pre>}}
| + | |
| − | | + | |
| − | {{ScriptFunction|void|Stop|(string animation)|Stops an animation named name.
| + | |
| − | | + | |
| − | Stopping an animation also Rewinds it to the Start.|5=<pre>Space.Host.ExecutingObject.Animation.Stop("animationname")</pre>}}
| + | |
| − | | + | |
| − | | + | |
| − | | + | |
| − | | + | |
| − | | + | |
| − | | + | |
| − | =Properties=
| + | |
| − | | + | |
| − | {{ScriptFunction|bool|Enabled|{ get; set; }|Enabled Behaviours are Updated, disabled Behaviours are not.
| + | |
| − | | + | |
| − | This is shown as the small checkbox in the inspector of the behaviour.|5= <pre>Space.Host.ExecutingObject.Animation.Enabled = false</pre> |6=<pre>--clicking this object will Enable/Disable it's Animation component
| + | |
| − | thisGameObject = Space.Host.ExecutingObject
| + | |
| − | animation = thisGameObject.Animation
| + | |
| − | | + | |
| − | | + | |
| − | OnClick = function()
| + | |
| − | animation.Enabled = not animation.Enabled
| + | |
| − | end
| + | |
| − | | + | |
| − | | + | |
| − | thisGameObject.AddClickable()
| + | |
| − | thisGameObject.Clickable.OnClick(OnClick)</pre>}}
| + | |
| − | | + | |
| − | {{ScriptFunction|IDictionary<string, SAnimationState>|States|{ get; }|Returns a table of SAnimationState names and references|5= <pre>States = Space.Host.ExecutingObject.Animation.States</pre>}}
| + | |
| − | | + | |
| − | | + | |
| − | | + | |
| − | | + | |
| − | | + | |
| − | | + | |
| − | | + | |
| − | | + | |
| − | | + | |
| − | {{Scripting Navbox}}
| + | |
