Struct hrtf::HrtfContext

pub struct HrtfContext<'a, 'b, 'c, T: InterleavedSamples> {
    pub source: &'a [T],
    pub output: &'b mut [(f32, f32)],
    pub new_sample_vector: Vec3,
    pub prev_sample_vector: Vec3,
    pub prev_left_samples: &'c mut Vec<f32>,
    pub prev_right_samples: &'c mut Vec<f32>,
    pub new_distance_gain: f32,
    pub prev_distance_gain: f32,
}

Contains all input parameters for HRTF signal processing.

Fields

source: &'a [T]

Source of interleaved samples to be processed. HRTF works only with mono sources, so source must implement InterleavedSamples trait which must provide sample from left channel only. Source must have interpolation_steps * block_len length!

output: &'b mut [(f32, f32)]

An output buffer to write processed samples to. It must be stereo buffer, processed samples will be mixed with samples in output buffer.

new_sample_vector: Vec3

New sampling vector. It must be a vector from a sound source position to a listener. If your listener has orientation, then you should transform this vector into a listener space first.

prev_sample_vector: Vec3

Sampling vector from previous frame.

prev_left_samples: &'c mut Vec<f32>

Left channel samples from last frame. It is used for continuous convolution. It must point to unique buffer which associated with a single sound source.

prev_right_samples: &'c mut Vec<f32>

Right channel samples from last frame. It is used for continuous convolution. It must point to unique buffer which associated with a single sound source.

new_distance_gain: f32

New distance gain for given slice. It is used to interpolate gain so output signal will have smooth transition from frame to frame. It is very important for click-free processing.

prev_distance_gain: f32

Distance gain from previous frame. It is used to interpolate gain so output signal will have smooth transition from frame to frame. It is very important for click-free processing.