Playback of an .anim asset, rooted at this entity.
typedef struct LDKKeyFrameAnimationSource{
LDKAssetKeyframeAnimation *animations;
u32 animation_count;
u32 animation_capacity;
i32 current_animation;
bool play_on_start;
bool loop;
float speed;
float time;
bool playing;
bool runtime_started;
bool restart_pending;
}LDKKeyFrameAnimationSource;Construct the default configuration for an animation source component.
LDK_API LDKKeyFrameAnimationSource ldk_keyframe_animation_source_make_default(void);Value with autoplay/loop enabled, speed one and no selected clip.
Append a live animation asset to an entity animation source.
LDK_API bool ldk_keyframe_animation_source_add(
LDKEntity root,
LDKAssetKeyframeAnimation animation
);LDKEntity rootLDKAssetKeyframeAnimation animationTrue if appended. Does not transfer ownership of the asset.
Detach an asset at the given index from an animation source.
LDK_API bool ldk_keyframe_animation_source_remove(
LDKEntity root,
u32 index
);LDKEntity rootu32 indexTrue if removed. Does not unload the asset.
Replace a source animation entry with another live animation asset.
LDK_API bool ldk_keyframe_animation_source_replace(
LDKEntity root,
u32 index,
LDKAssetKeyframeAnimation animation
);LDKEntity rootu32 indexLDKAssetKeyframeAnimation animationTrue on success. Replacing the active entry resets playback.
Select the animation index used for subsequent playback.
LDK_API bool ldk_keyframe_animation_source_set_current(
LDKEntity root,
i32 index
);LDKEntity rooti32 indexTrue for a valid index. Changing selection resets playback.
Start or resume the current animation and apply its current pose.
LDK_API bool ldk_keyframe_animation_source_play(LDKEntity root);LDKEntity rootTrue if a live clip is selected and the component is enabled.
Pause playback while retaining the current position.
LDK_API void ldk_keyframe_animation_source_pause(LDKEntity root);LDKEntity rootNothing.
Stop playback, seek to zero and apply the initial pose.
LDK_API void ldk_keyframe_animation_source_stop(LDKEntity root);LDKEntity rootNothing. Does not restore the pre-animation component values.
Set playback time and immediately evaluate the new pose without events.
LDK_API bool ldk_keyframe_animation_source_seek(
LDKEntity root,
float time
);LDKEntity rootfloat timeTrue if a live clip is selected. Time is clamped to its duration.
Set the synchronous global callback for keyframe animation events.
LDK_API void ldk_keyframe_animation_source_event_handler_set(
LDKKeyframeEventFn handler,
void *user
);LDKKeyframeEventFn handlervoid *userNothing. Passing NULL disables notifications. Note: Callbacks may mutate or destroy the source; do not keep event pointers.
Describe the keyframe animation source component to the ECS.
LDK_API LDKComponentDesc ldk_keyframe_animation_source_component_desc(u32 initial_capacity);u32 initial_capacityComponent description with Transform as a required component.
Advance enabled animation sources during the engine update.
LDK_API void ldk_keyframe_animation_source_update_all(float delta_time);float delta_timeNothing. Events are dispatched before the render phase.
Reset runtime playback state for every registered animation source.
LDK_API void ldk_keyframe_animation_source_reset_all(void);Nothing. Preserves assigned assets and playback configuration.