Expand description
§🎭 EmotivaHeart
EmotivaHeart is the central runtime of Emotiva.
It drives character animation, manages runtime state, and produces
drawable outputs for rendering backends.
This struct is responsible for giving life to every character rig, updating animation systems each frame, and generating the forms that are ultimately rendered on screen.
§Responsibilities
EmotivaHeart:
- Loads character rigs from
.ronfiles (sprites, layers, variants) - Holds runtime state for animation systems (tweens, motions, rotations, FX)
- Updates these systems every frame
- Outputs
EmotivaFormvalues ready for rendering backends
§Non-Responsibilities
EmotivaHeart does not:
- Perform rendering directly (handled by graphics backends)
- Expose all helper APIs itself (see the
apimodules for the public API)
§Why “Heart”?
Because this struct acts as the runtime engine that keeps characters alive. It continuously updates motion, expression, and animation state, allowing rendering backends to display the current character pose.
Designed to integrate smoothly with visual novel engines and other Rust game frameworks.
Re-exports§
pub use emotiva::Emotiva;
Modules§
- anim
- api
- 🎭 Emotiva API
- core
- 💠 Emotiva Core
- emotiva
- 🎭 Emotiva Runtime
- format
- 📦 Emotiva Rig Format
- macros
- snapshot
Macros§
- impl_
fns_ mut - 🎯 Implement multiple
&mut selftrait methods by forwarding to an inner field - impl_
fns_ ref - 🧰 Emotiva Macro Helpers
Structs§
- Emotiva
Form - A fully resolved visual form produced after a frame update. Contains absolute transform and visual state.
- Emotiva
Heart - EmotivaHeart – the main runtime struct managing all animation state.