Struct ExprBlender 

pub struct ExprBlender { /* private fields */ }

Manages a library of ExpressionDefs and resolves them to morph-target weight maps at runtime.

Implementations

impl ExpressionBlender

pub fn new() -> Self

Create an empty blender with no pre-loaded expressions.

pub fn with_defaults() -> Self

Create a blender pre-loaded with the default expression library (default_expression_defs).

pub fn add(&mut self, def: ExpressionDef)

Add an expression definition to the library. If an expression with the same name already exists it is replaced.

pub fn get(&self, name: &str) -> Option<&ExpressionDef>

Look up an expression definition by name (case-insensitive).

pub fn list_names(&self) -> Vec<&str>

Return a sorted list of all expression names (original casing).

pub fn len(&self) -> usize

Number of expressions in the library.

pub fn is_empty(&self) -> bool

Return true if the library is empty.

pub fn blend_to_weights( &self, expr: &str, intensity: f64, ) -> Option<HashMap<String, f64>>

Map a single expression at intensity to a HashMap<target, weight>.

Each per-target base weight is multiplied by intensity, then clamped to [0.0, 1.0]. Returns None if the expression name is not found.

pub fn blend_multi(&self, exprs: &[(String, f64)]) -> HashMap<String, f64>

Additively blend multiple expressions.

exprs is a slice of (expression_name, intensity) pairs. For each pair the expression is resolved at the given intensity and its weights are added into the accumulator. The final map is clamped per-target to [0.0, 1.0]. Unknown expression names are silently skipped.

pub fn lerp_expression( &self, from: &str, to: &str, t: f64, ) -> HashMap<String, f64>

Linearly interpolate between two expressions at parameter t ∈ [0, 1].

At t = 0.0 the result equals blend_to_weights(from, 1.0). At t = 1.0 the result equals blend_to_weights(to, 1.0). Intermediate values are computed per-target as w_from * (1-t) + w_to * t.

Targets that appear in only one expression are treated as having weight 0.0 in the other. Returns an empty map if both expressions are unknown.

pub fn au_to_expression(au_code: u32, intensity: f64) -> HashMap<String, f64>

Map a FACS Action Unit code + intensity to morph-target weights.

This implements an approximate mapping from the standard FACS AU numbers (as used by Paul Ekman et al.) to OxiHuman morph-target names.

The mapping is intentionally broad: each AU drives one or more targets. intensity is in [0.0, 1.0]; the return value is a weight map with all values clamped to [0.0, 1.0].

Unknown AU codes return an empty map rather than erroring.

Trait Implementations

impl Clone for ExpressionBlender

fn clone(&self) -> ExpressionBlender

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ExpressionBlender

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ExpressionBlender

fn default() -> Self

Returns the “default value” for a type.