Skip to main content

Crate emotiva

Crate emotiva 

Source
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 .ron files (sprites, layers, variants)
  • Holds runtime state for animation systems (tweens, motions, rotations, FX)
  • Updates these systems every frame
  • Outputs EmotivaForm values ready for rendering backends

§Non-Responsibilities

EmotivaHeart does not:

  • Perform rendering directly (handled by graphics backends)
  • Expose all helper APIs itself (see the api modules 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 self trait methods by forwarding to an inner field
impl_fns_ref
🧰 Emotiva Macro Helpers

Structs§

EmotivaForm
A fully resolved visual form produced after a frame update. Contains absolute transform and visual state.
EmotivaHeart
EmotivaHeart – the main runtime struct managing all animation state.