filament-compose/io.github.erkko68.filament.compose.scene/AnimationTrack

AnimationTrack

class AnimationTrack

One weighted clip in an AnimationMixer, created with AnimationMixer.addTrack (or rememberAnimationTrack). Mutate weight to blend it in or out, index to swap the clip, or speed/loop for playback. The read-only time, progress and isFinished update every frame.

Properties

Zero-based animation index this track samples.

val isFinished: Boolean

True once a non-looping track has reached the end of its clip. Always false while loop.

var loop: Boolean

Whether this track wraps at its end (true) or holds the final frame (false).

val progress: Float

Normalized progress (0..1) of this track. 0 when the clip has no duration.

var speed: Float

Playback rate multiplier (1 = real time, negative plays backwards).

val time: Float

Current playback time of this track in seconds. Read-only.

var weight: Float

Blend weight, relative to the other tracks. 0 mutes the track but keeps its clock running.

Functions

fun seek(time: Float)

Resets this track's clock to time seconds.