Struct EmotionState 

pub struct EmotionState { /* private fields */ }

A creature’s emotional state in valence/arousal space.

This drives vocalization selection, call intent, and continuous parameter modulation (vocal effort, breathiness, pitch scale).

Implementations

impl EmotionState

pub fn new() -> Self

Creates a new emotion state at the neutral point (idle, calm).

pub fn with_values(valence: f32, arousal: f32) -> Self

Creates an emotion state with specific initial values.

pub fn with_smoothing(self, smoothing: f32) -> Self

Sets the smoothing factor (0.0 = instant transitions, 0.95 = very sluggish).

pub fn valence(&self) -> f32

Returns the current valence.

pub fn arousal(&self) -> f32

Returns the current arousal.

pub fn update(&mut self, target_valence: f32, target_arousal: f32)

Updates the emotional state toward a target, applying smoothing.

Call this once per frame or tick. The state exponentially decays toward (target_valence, target_arousal) at a rate controlled by smoothing.

pub fn set(&mut self, valence: f32, arousal: f32)

Sets the emotional state directly (no smoothing).

pub fn evaluate(&self) -> EmotionOutput

Evaluates the current emotional state into synthesis parameters.

This is the core mapping from the 2D emotion space to concrete vocalization choices and parameter values.

Trait Implementations

impl Clone for EmotionState

fn clone(&self) -> EmotionState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EmotionState

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

Formats the value using the given formatter.

impl Default for EmotionState

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for EmotionState

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for EmotionState

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.