Skip to content

Documentation / scene / MorphTargetGroupTrack

Class: MorphTargetGroupTrack ​

Defined in: libs/scene/src/animation/morphtargetgrouptrack.ts:13

Animates a model-level morph target group by name.

Extends ​

Constructors ​

Constructor ​

new MorphTargetGroupTrack(groupName?, interpolator?, embedded?): MorphTargetGroupTrack

Defined in: libs/scene/src/animation/morphtargetgrouptrack.ts:23

Create a morph target group animation track.

Parameters ​

groupName? ​

string

Morph target group name

interpolator? ​

Interpolator

Scalar interpolator for the group weight

embedded? ​

boolean

Whether this track is embedded

Returns ​

MorphTargetGroupTrack

Overrides ​

AnimationTrack.constructor

Accessors ​

name ​

Get Signature ​

get name(): string

Defined in: libs/scene/src/animation/animationtrack.ts:45

Human-readable name of the track.

Returns ​

string

Set Signature ​

set name(val): void

Defined in: libs/scene/src/animation/animationtrack.ts:48

Parameters ​
val ​

string

Returns ​

void

Inherited from ​

AnimationTrack.name


embedded ​

Get Signature ​

get embedded(): boolean

Defined in: libs/scene/src/animation/animationtrack.ts:54

Whether this track is embedded (owned inline by a resource/container).

Returns ​

boolean

Inherited from ​

AnimationTrack.embedded


animation ​

Get Signature ​

get animation(): AnimationClip

Defined in: libs/scene/src/animation/animationtrack.ts:60

The AnimationClip that owns this track.

Returns ​

AnimationClip

Set Signature ​

set animation(ani): void

Defined in: libs/scene/src/animation/animationtrack.ts:63

Parameters ​
ani ​

AnimationClip

Returns ​

void

Inherited from ​

AnimationTrack.animation


target ​

Get Signature ​

get target(): string

Defined in: libs/scene/src/animation/animationtrack.ts:72

Logical target identifier for this track (optional metadata).

This does not affect application; it can be used by tooling or higher-level systems to label/group tracks.

Returns ​

string

Set Signature ​

set target(val): void

Defined in: libs/scene/src/animation/animationtrack.ts:75

Parameters ​
val ​

string

Returns ​

void

Inherited from ​

AnimationTrack.target


jointIndex ​

Get Signature ​

get jointIndex(): number

Defined in: libs/scene/src/animation/animationtrack.ts:81

Joint index if this track controls a joint, otherwise -1

Returns ​

number

Set Signature ​

set jointIndex(index): void

Defined in: libs/scene/src/animation/animationtrack.ts:84

Parameters ​
index ​

number

Returns ​

void

Inherited from ​

AnimationTrack.jointIndex


groupName ​

Get Signature ​

get groupName(): string

Defined in: libs/scene/src/animation/morphtargetgrouptrack.ts:31

Morph target group name controlled by this track.

Returns ​

string

Set Signature ​

set groupName(value): void

Defined in: libs/scene/src/animation/morphtargetgrouptrack.ts:34

Parameters ​
value ​

string

Returns ​

void


interpolator ​

Get Signature ​

get interpolator(): Interpolator

Defined in: libs/scene/src/animation/morphtargetgrouptrack.ts:38

Scalar interpolator for this track.

Returns ​

Interpolator

Set Signature ​

set interpolator(value): void

Defined in: libs/scene/src/animation/morphtargetgrouptrack.ts:41

Parameters ​
value ​

Interpolator

Returns ​

void

Methods ​

reset() ​

reset(_target): void

Defined in: libs/scene/src/animation/animationtrack.ts:98

Reset the track to its initial state for the given target.

Intended to stop playback and rewind the target to the first frame or default state.

Parameters ​

_target ​

object

The animated object to reset.

Returns ​

void

Inherited from ​

AnimationTrack.reset


clone() ​

clone(): this

Defined in: libs/scene/src/animation/morphtargetgrouptrack.ts:49

Clone this animation track

Returns ​

this

Overrides ​

AnimationTrack.clone


calculateState() ​

calculateState(target, currentTime): number

Defined in: libs/scene/src/animation/morphtargetgrouptrack.ts:53

Compute the animation state at the specified time.

Implementations should be pure with respect to inputs: given the same target and currentTime, return the same StateType.

Parameters ​

target ​

object

The animated object (used to resolve current baseline if needed).

currentTime ​

number

Time cursor in seconds within the track's timeline.

Returns ​

number

The computed state at currentTime.

Overrides ​

AnimationTrack.calculateState


applyState() ​

applyState(node, weight): void

Defined in: libs/scene/src/animation/morphtargetgrouptrack.ts:58

Apply a previously computed animation state to the target.

Parameters ​

node ​

SceneNode

The animated object to modify.

weight ​

number

The state to apply.

Returns ​

void

Overrides ​

AnimationTrack.applyState


mixState() ​

mixState(a, b, t): number

Defined in: libs/scene/src/animation/morphtargetgrouptrack.ts:64

Blend two states into a new state using a weight.

Parameters ​

a ​

number

First state.

b ​

number

Second state.

t ​

number

Blend weight in [0, 1], where 0 yields a and 1 yields b.

Returns ​

number

The blended state.

Overrides ​

AnimationTrack.mixState


getBlendId() ​

getBlendId(): string

Defined in: libs/scene/src/animation/morphtargetgrouptrack.ts:68

Get the blend identifier for this track.

Tracks with the same blend ID are considered compatible for blending on the same target channel/property.

Returns ​

string

An identifier used to group compatible tracks for blending.

Overrides ​

AnimationTrack.getBlendId


getDuration() ​

getDuration(): number

Defined in: libs/scene/src/animation/morphtargetgrouptrack.ts:72

Get the intrinsic duration of this track in seconds.

Used by clips to determine overall clip duration and looping behavior.

Returns ​

number

Track duration (seconds).

Overrides ​

AnimationTrack.getDuration

Released under the MIT License.