Inno.Animation
Section titled “Inno.Animation”
- 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.
Start with a task
Section titled “Start with a task”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.
Sampling model
Section titled “Sampling model”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.
Target and service contract
Section titled “Target and service contract”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.
Validation and reference
Section titled “Validation and reference”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.
Logical script references
Section titled “Logical script references”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.
Source project facts
Section titled “Source project facts”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. |