Zernikalos/zernikalos.action/ZActionPlayer

ZActionPlayer

Allows playback of skeletal actions stored in ZSkeletalAction.

Playback is bound to a ZSkeleton: this class owns the clock (time, speed, loop, play state) and commits the sampled clip pose to that skeleton inside update each frame (wall clock or explicit update with elapsed seconds). Typical host integration: call update once per frame before skinning or render.

Constructors

ZActionPlayer

constructor()

Properties

currentTime

var currentTime: Float

Current playback time in seconds (writable only inside this player).

duration

val duration: Float

Total duration of the current action in seconds, or 0 if none.

isPlaying

var isPlaying: Boolean

Whether the action is currently playing (writable only inside this player).

Functions

getProgress

fun getProgress(): Float

pause

fun pause()

Pauses playback without resetting currentTime.

play

fun play(loop: Boolean = false)

Starts playing the current action.

resetTimer

fun resetTimer()

Resets the internal wall-clock baseline used by update.

seek

fun seek(time: Float)

Seeks to time (clamped to the clip range) and reapplies the pose at that time.

setAction

fun setAction(skeleton: ZSkeleton, action: ZSkeletalAction)

Sets the skeleton and clip to play, resets playback time to zero, and applies the pose at time 0 so the skeleton matches the start of the clip immediately.

setPlaybackSpeed

fun setPlaybackSpeed(speed: Float)

Sets the playback speed multiplier.

stop

fun stop()

Stops playback, resets time to the start of the clip, and reapplies the pose at time 0.

update

fun update()

Updates playback using elapsed wall time since the last call (seconds), then commits the sampled pose to skeleton.

fun update(deltaTimeSeconds: Float)

Advances playback by deltaTimeSeconds (scaled by playbackSpeed when playing), then commits the sampled pose to skeleton. Use for fixed-step or injected delta time instead of wall-clock update.