Crate hrtf

source ·
Expand description

Head-Related Transfer Function (HRTF) renderer.

Overview

HRTF stands for Head-Related Transfer Function and can work only with spatial sounds. For each of such sound source after it was processed by HRTF you can definitely tell from which location sound came from. In other words HRTF improves perception of sound to the level of real life.

HRIR Spheres

This crate uses Head-Related Impulse Response (HRIR) spheres to create HRTF spheres. HRTF sphere is a set of points in 3D space which are connected into a mesh forming triangulated sphere. Each point contains spectrum for left and right ears which will be used to modify samples from each spatial sound source to create binaural sound. HRIR spheres can be found here. HRIR spheres from the base are recorded in 44100 Hz sample rate, this crate performs automatic resampling to your sample rate.

Performance

HRTF is heavy, this is essential because HRTF requires some heavy math (fast Fourier transform, convolution, etc.) and lots of memory copying.

Known problems

This renderer still suffers from small audible clicks in very fast moving sounds, clicks sounds more like “buzzing” - it is due the fact that hrtf is different from frame to frame which gives “bumps” in amplitude of signal because of phase shift each impulse response have. This can be fixed by short cross fade between small amount of samples from previous frame with same amount of frames of current as proposed in here

Clicks can be reproduced by using clean sine wave of 440 Hz on some source moving around listener.

Algorithm

This crate uses overlap-save convolution to perform operations in frequency domain. Check this link for more info.

Structs

  • Single point of HRIR sphere. See module docs for more info.
  • HRIR (Head-Related Impulse Response) spheres is a 3d mesh whose points contains impulse responses for left and right ears. It is used for interpolation of impulse responses.
  • Contains all input parameters for HRTF signal processing.
  • See module docs.
  • See module docs.
  • Simple 3d vector.

Enums

  • All possible error that can occur during HRIR sphere loading.

Traits

  • Provides unified way of extracting single channel (left) from any set of interleaved samples (LLLLL…, LRLRLRLR…, etc).