https://github.com/mrdimas/hrtf

Head-Related Transfer Function (HRTF) audio signal processor.
https://github.com/mrdimas/hrtf

Last synced: 17 days ago
JSON representation

Head-Related Transfer Function (HRTF) audio signal processor.

• Host: GitHub
• URL: https://github.com/mrdimas/hrtf
• Owner: mrDIMAS
• License: mit
• Created: 2020-10-12T12:33:18.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2023-10-17T12:04:11.000Z (about 1 year ago)
• Last Synced: 2024-04-23T22:09:35.238Z (7 months ago)
• Language: Rust
• Size: 58.6 KB
• Stars: 71
• Watchers: 5
• Forks: 7
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Head-Related Transfer Function (HRTF) audio signal processor.

# Overview

HRTF stands for [Head-Related Transfer Function](https://en.wikipedia.org/wiki/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](https://github.com/mrDIMAS/hrir_sphere_builder/tree/master/hrtf_base/IRCAM).

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](http://csoundjournal.com/issue9/newHRTFOpcodes.html)

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](https://en.wikipedia.org/wiki/Overlap%E2%80%93save_method) for more info.