Skip to content
Project referenceDevelopmentEngine ccf7d03f
Authored
  • Neutral clip sampling, explicit targets, value bindings and generation-checked playback.

This project defines value sampling that different content systems can consume. It does not depend on Scene, Rendering, Audio, Editor or a concrete backend, and does not impose a Transform, Sprite, skeleton, timeline or visual-novel model.

Play a clip against an explicit target explains session setup, clocks, markers and handle lifetime. Add an animation binding connects sampled values to a host-owned destination.

An AnimationClipAsset contains a positive duration, ordered tracks and ordered event markers. Each track selects an open stable binding identity, a Step or Linear sampling policy and keyframes of one compatible value kind. Supported kinds are scalar, Vector2, Vector3, Vector4 and quaternion. The sampler normalizes quaternion output.

AnimationPlayOptions selects scaled/unscaled time, speed, looping, layer and weight. Runtime blending groups values by both target and binding, selects the highest contributing layer and combines its weighted samples. Identical binding names on different targets do not merge their values.

AnimationTarget captures a live identity’s original domain-qualified runtime destination without retaining the object. It is distinct from a detached persistent ID. A target does not automatically follow a new runtime slot after retirement. Pure sampling and markers use the explicit samplingOnly target rather than a missing sink or default target.

The static Animation facade borrows the active session’s IAnimationService through AnimationExecutionContext. Runtime scripts use the actual InnoEngine.Animation projection; host services and provider composition are separate surfaces. Playback handles are opaque generation-checked values and become stale after stop or natural completion.

Binding sinks receive final samples instead of writing reflected property names. Binding providers declare a stable ID and value kind and apply values on the owner thread. They are not native audio callbacks. A marker carries a stable event ID and neutral payload through the session’s event dispatcher.

Clips are validated before import/play, and playback captures independent track, keyframe and marker payload copies. Later editing of the authoring asset does not change a running snapshot. Exact constructor, validation, sampling and facade contracts are listed in the generated reference; use the task guides for complete workflows.

Browse animation types.

The compiler-selected script declarations are separate from this project’s host CLR surface. Read the script calling guide and the associated module contracts before using a projected member.

Project: Inno.Animation
Source: src/content/animation/Inno.Animation/Inno.Animation.csproj

Type API Description
Animation engine Provides script-friendly animation control through the current runtime context.
AnimationBindingId engine Identifies one backend-neutral value destination inside an animation binding scope.
AnimationBindingProvider engine Applies one declared binding protocol on the owner thread; implementations never run in native callbacks.
AnimationBindingProviderAttribute engine Declares a stable, automatically discovered animation destination protocol.
AnimationClipAsset engine Represents one imported backend-neutral collection of tracks and event markers.
AnimationClock engine Selects the session clock used to advance an animation playback.
AnimationEventMarker engine Stores one stable event marker embedded in an animation clip.
AnimationExecutionContext engine Binds one animation service to the current asynchronous execution context.
AnimationInterpolation engine Selects how values are sampled between adjacent keyframes.
AnimationKeyframe engine Stores one timestamped value inside an animation track.
AnimationMarkerEvent engine Publishes a stable marker reached by one animation playback on the main runtime thread.
AnimationPlayOptions engine Stores immutable options used to begin one animation playback.
AnimationPlaybackAllocator engine Owns opaque playback identity encoding without requiring a runtime to inherit a fake service base.
AnimationPlaybackHandle engine Identifies one generation-checked animation playback owned by a runtime service.
AnimationPlaybackState engine Describes the observable lifecycle of one animation playback.
AnimationSample engine Stores one final blended value emitted for a stable binding identifier.
AnimationSampling engine Provides backend-neutral interpolation and weighted composition used by animation runtimes.
AnimationTarget engine Identifies a transient animation destination without retaining the destination object.
AnimationTrack engine Stores one ordered value track targeting a stable binding.
AnimationValue engine Stores one backend-neutral scalar, vector, or quaternion animation value.
AnimationValueKind engine Describes the number and interpretation of components in an animation value.
IAnimationBindingSink engine Receives final backend-neutral samples after runtime blending has completed.
IAnimationService engine Defines backend-neutral animation playback and control for one isolated runtime session.
Animation Runtime Provides script-friendly animation control through the current runtime context.
AnimationBindingId Runtime Identifies one backend-neutral value destination inside an animation binding scope.
AnimationBindingProvider Runtime Applies one declared binding protocol on the owner thread; implementations never run in native callbacks.
AnimationBindingProviderAttribute Runtime Declares a stable, automatically discovered animation destination protocol.
AnimationClipAsset Runtime Represents one imported backend-neutral collection of tracks and event markers.
AnimationClock Runtime Selects the session clock used to advance an animation playback.
AnimationEventMarker Runtime Stores one stable event marker embedded in an animation clip.
AnimationInterpolation Runtime Selects how values are sampled between adjacent keyframes.
AnimationKeyframe Runtime Stores one timestamped value inside an animation track.
AnimationMarkerEvent Runtime Publishes a stable marker reached by one animation playback on the main runtime thread.
AnimationPlayOptions Runtime Stores immutable options used to begin one animation playback.
AnimationPlaybackHandle Runtime Identifies one generation-checked animation playback owned by a runtime service.
AnimationPlaybackState Runtime Describes the observable lifecycle of one animation playback.
AnimationSample Runtime Stores one final blended value emitted for a stable binding identifier.
AnimationTarget Runtime Identifies a transient animation destination without retaining the destination object.
AnimationTrack Runtime Stores one ordered value track targeting a stable binding.
AnimationValue Runtime Stores one backend-neutral scalar, vector, or quaternion animation value.
AnimationValueKind Runtime Describes the number and interpretation of components in an animation value.
IAnimationBindingSink Runtime Receives final backend-neutral samples after runtime blending has completed.