Once I get that upgrade to 36-hour days, I will tackle that. – Mychaeel

UE3:AnimNodeSequence (UT3)

From Unreal Wiki, The Unreal Engine Documentation Site
Jump to: navigation, search
UT3 Object >> AnimNode >> AnimNodeSequence
Package: 
Engine
Direct subclasses:
AnimNodeSequenceBlendBase, UTAnimNodeFramePlayer, UTAnimNodeSequenceByBoneRotation, UTAnimNodeSequence
This class in other games:
UDK

Copyright 1998-2007 Epic Games, Inc. All Rights Reserved.

Properties[edit]

Property group 'AnimNodeSequence'[edit]

AnimSeqName[edit]

Type: name

Modifiers: const

This name will be looked for in all AnimSet's specified in the AnimSets array in the SkeletalMeshComponent.

bCauseActorAnimEnd[edit]

Type: bool

Should this node call the OnAnimEnd event on its parent Actor when it reaches the end and stops.

bCauseActorAnimPlay[edit]

Type: bool

Should this node call the OnAnimPlay event on its parent Actor when PlayAnim is called on it.

bForceRefposeWhenNotPlaying[edit]

Type: bool

Forces the skeletal mesh into the ref pose by setting bForceRespose on the skelmesh comp when not playing. (Optimization)

bLooping[edit]

Type: bool

If animation is looping. If false, animation will stop when it reaches end, otherwise will continue from beginning.

bNoNotifies[edit]

Type: bool

Whether any notifies in the animation sequence should be executed for this node.

bPlaying[edit]

Type: bool

Whether this animation is currently playing ie. if the CurrentTime will be advanced when Tick is called.

bZeroRootRotation[edit]

Type: bool

Always return a zero rotation (unit quaternion) for the root bone of this animation.

bZeroRootTranslation[edit]

Type: bool

Always return root bone translation at the origin.

CurrentTime[edit]

Type: float

Modifiers: const

Current position (in seconds)

NotifyWeightThreshold[edit]

Type: float

Total weight that this node must be at in the final blend for notifies to be executed. This is ignored when the node is part of a group.

Rate[edit]

Type: float

Speed at which the animation will be played back. Multiplied by the RateScale in the AnimSequence. Default is 1.0

Default value: 1.0

RootBoneOption[edit]

Type: ERootBoneAxis

Array size: 3

[X, Y, Z] axes

RootRotationOption[edit]

Type: ERootRotationOption

Array size: 3


Property group 'Display'[edit]

bShowTimeLineSlider[edit]

Type: bool

Display time line slider

Property group 'Group'[edit]

bForceAlwaysMaster[edit]

Type: bool

Any node with this flag set with global weight > 0.0 will be picked over any other node as master node.

bForceAlwaysSlave[edit]

Type: bool

If TRUE, this node can never be a synchronization master node, always slave.

bSynchronize[edit]

Type: bool

Modifiers: const

TRUE by default. This node can be synchronized with others, when part of a SynchGroup. Set to FALSE if node shouldn't be synchronized, but still part of notification group.

Default value: True

SynchGroupName[edit]

Type: name

Modifiers: const

name of group this node belongs to

SynchPosOffset[edit]

Type: float

Relative position offset

Internal variables[edit]

AnimLinkupIndex[edit]

Type: int

Modifiers: transient, const

Bone -> Track mapping info for this player node. Index into the LinkupCache array in the AnimSet. Found from AnimSet when you call SetAnim.

AnimSeq[edit]

Type: AnimSequence

Modifiers: transient, const

Pointer to actual AnimSequence. Found from SkeletalMeshComponent using AnimSeqName when you call SetAnim.

bIsIssuingNotifies[edit]

Type: bool

Flag that indicates if Notifies are currently being executed. Allows you to avoid doing dangerous things to this Node while this is going on.

DebugCarat[edit]

Type: Texture2D

For debugging. Small icon to show current position in animation.

Default value: Texture2D'EngineResources.AnimPlayerCarat'

DebugTrack[edit]

Type: Texture2D

For debugging. Track graphic used for showing animation position.

Default value: Texture2D'EngineResources.AnimPlayerTrack'

PreviousTime[edit]

Type: float

Modifiers: const, transient


Enums[edit]

ERootBoneAxis[edit]

This will actually call MoveActor to move the Actor owning this SkeletalMeshComponent. You can specify the behaviour for each axis (mesh space). Doing this for multiple skeletal meshes on the same Actor does not make much sense!

RBA_Default 
the default behaviour, leave root translation from animation and do no affect owning Actor movement.
RBA_Discard 
discard any root bone movement, locking it to the first frame's location.
RBA_Translate 
discard root movement on animation, and forward its velocity to the owning actor.

ERootRotationOption[edit]

Root Motion Rotation.

RRO_Default 
Default, leaves root rotation in the animation. Does not affect actor.
RRO_Discard 
Discards root rotation from the animation, locks to first frame rotation of animation. Does not affect actor's rotation.
RRO_Extract 
Discard root rotation from animation, and forwards it to the actor. (to be used by it or not).

Native functions[edit]

FindNormalizedPositionFromGroupRelativePosition[edit]

native function float FindNormalizedPositionFromGroupRelativePosition (float GroupRelativePosition)

Finds out normalized position of a synchronized node given a relative position of a group. Takes into account node's relative SynchPosOffset.

GetAnimPlaybackLength[edit]

native function float GetAnimPlaybackLength ()

Returns the duration (in seconds) of the current animation at the current play rate. Returns 0.0 if no animation.

GetGlobalPlayRate[edit]

native function float GetGlobalPlayRate ()

Returns the global play rate of this animation. Taking into account all Rate Scales

GetNormalizedPosition[edit]

native function float GetNormalizedPosition ()

Get normalized position, from 0.f to 1.f.

GetTimeLeft[edit]

native function float GetTimeLeft ()

Returns in seconds the time left until the animation is done playing. This is assuming the play rate is not going to change.

PlayAnim[edit]

native function PlayAnim (bool bLoop, float InRate, float StartTime)

Overrides: AnimNode.PlayAnim

Start the current animation playing with the supplied parameters.

SetAnim[edit]

native function SetAnim (name Sequence)

Change the animation this node is playing to the new name. Will be looked up in owning SkeletaMeshComponent's AnimSets array.

SetPosition[edit]

native function SetPosition (float NewTime, bool bFireNotifies)

Force the animation to a particular time. NewTime is in seconds.

StopAnim[edit]

native function StopAnim ()

Overrides: AnimNode.StopAnim

Stop the current animation playing. CurrentTime will stay where it was.