Inno.Animation.Runtime
Section titled “Inno.Animation.Runtime”
- Session playback, deterministic target-local blending, marker dispatch and binding generations.
AnimationRuntime owns playback, sampling, blending and marker dispatch for one session. The runtime factory declares its Scene-subsystem dependency and advances playback during session updates. Begin/end frame integration owns the active animation execution scope.
Compose the output boundary
Section titled “Compose the output boundary”Construction requires a session EventDispatcher and an IAnimationBindingSink. Sampling-only playback still supplies an explicit sink and target policy; a null sink is not a request to silently discard output.
Standard composition uses AnimationBindingRuntime(types, diagnostics). The shared type catalog owns provider generations. Candidate construction validates concrete public parameterless providers and rejects duplicate extension IDs or binding/value-kind protocols before publication. The binding owner borrows its diagnostic reporter and does not dispose it.
Playback and update contract
Section titled “Playback and update contract”The runtime validates the clip, explicit target and play options before accepting a playback. Its default capacity is 16,384 active playbacks and must be positive. Capacity exhaustion is an explicit failure before snapshot allocation; failed snapshot capture does not consume a slot. playbackCount and rejectedPlaybacks are host observations, not editable admission policy.
Playback freezes independent tracks, keyframes, markers and marker payloads. Stop or natural completion retires the slot. Reuse increments its generation, preventing an old handle from controlling the next occupant.
An update accepts finite non-negative scaled and unscaled delta times. Each playing clip advances on its selected clock. Paused clips retain their sampled contribution. For each target/binding pair, positive-weight samples from the highest contributing layer blend together; lower layers do not affect that pair. Quaternion output is normalized. The final sample batch is ordered deterministically by target persistent identity and binding before application.
Markers crossed by forward playback are enqueued on the session event dispatcher. They are control-thread events, not calls into a native real-time audio path. See clip playback for boundary timing and loops.
Binding lifetime and diagnostics
Section titled “Binding lifetime and diagnostics”AnimationBindingRuntime.Apply runs on its creating thread. Missing providers, missing/incompatible destinations and provider exceptions produce scoped animation.binding.unavailable diagnostics. Each batch replaces the current diagnostic set, so a later successful batch clears resolved issues. Sampling-only targets intentionally skip object application.
Disposal unregisters the binding registry, attempts to dispose its providers and clears its owned diagnostic set without owning the reporter. Current provider disposal is synchronous: the binding snapshot aggregates failures and clears its provider map. It is not an asynchronous retirement scheduler; providers must not assume that throwing a pending signal establishes deferred ownership here.
API reference
Section titled “API reference”Add an animation binding describes the supported extension shape. Concrete Transform, Sprite, skeleton and gameplay bindings remain explicit extensions rather than central runtime switches.
Browse animation runtime types.
Source project facts
Section titled “Source project facts”Project: Inno.Animation.Runtime
Source: src/content/animation/Inno.Animation.Runtime/Inno.Animation.Runtime.csproj
| Type | API | Description |
|---|---|---|
| AnimationBindingRuntime | engine | Resolves declared binding protocols through transactional, generation-owned extension snapshots. |
| AnimationRuntime | engine | Owns animation playback, sampling, blending, and marker dispatch for one runtime session. |
| AnimationRuntimeFactory | engine | Creates one animation runtime feature for each isolated session. |