Struct VirtualHead 

pub struct VirtualHead {
    pub position: Position3D,
    pub orientation: Orientation3D,
    pub ear_spacing: f32,
    pub head_radius: f32,
}

Virtual head for binaural audio capture.

Fields

position: Position3D

Center position of the head (between ears)

orientation: Orientation3D

Head orientation (yaw, pitch, roll)

ear_spacing: f32

Distance between ears (default: 0.17m)

head_radius: f32

Head radius for shadowing calculations (default: 0.0875m)

Implementations

impl VirtualHead

pub fn new(position: Position3D) -> Self

Create a new virtual head at the given position.

pub fn with_ear_spacing(self, spacing: f32) -> Self

Create a virtual head with custom ear spacing.

pub fn with_orientation(self, orientation: Orientation3D) -> Self

Set head orientation.

pub fn set_position(&mut self, pos: Position3D)

Move the head to a new position.

pub fn set_orientation(&mut self, orientation: Orientation3D)

Rotate the head.

pub fn left_ear_position(&self) -> Position3D

Get the position of the left ear.

pub fn right_ear_position(&self) -> Position3D

Get the position of the right ear.

pub fn angle_to_source(&self, source: Position3D) -> (f32, f32)

Calculate the angle to a sound source relative to the head’s forward direction.

pub fn calculate_itd(&self, source: Position3D, speed_of_sound: f32) -> f32

Calculate ITD (Interaural Time Difference) for a source position.

Returns the time difference in seconds (positive = right ear leads).

pub fn calculate_ild(&self, source: Position3D) -> (f32, f32)

Calculate ILD (Interaural Level Difference) for a source.

Returns the amplitude ratio (left/right) based on head shadow.

Trait Implementations

impl Clone for VirtualHead

fn clone(&self) -> VirtualHead

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VirtualHead

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

Formats the value using the given formatter.

impl Default for VirtualHead

fn default() -> Self

Returns the “default value” for a type.