https://github.com/madskjeldgaard/binauraldecoders

Easy to use binaural stereo decoders for High Order Ambisonics in SuperCollider
https://github.com/madskjeldgaard/binauraldecoders

Last synced: about 1 month ago
JSON representation

Easy to use binaural stereo decoders for High Order Ambisonics in SuperCollider

• Host: GitHub
• URL: https://github.com/madskjeldgaard/binauraldecoders
• Owner: madskjeldgaard
• License: gpl-3.0
• Created: 2021-10-08T13:35:54.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2022-09-26T10:09:53.000Z (almost 2 years ago)
• Last Synced: 2024-02-15T02:32:10.657Z (5 months ago)
• Language: SuperCollider
• Homepage:
• Size: 22.5 KB
• Stars: 7
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Lists

• awesome-supercollider - BinauralDecoders - Persistent and easy to use binaural decoders for the ambisonic toolkit. (Quarks and extensions / Immersive audio)

README

        
# BinauralDecoders

This repository contains easy to use binaural stereo decoders for high order ambisonics using [the ambisonic toolkit for SuperCollider](https://www.ambisonictoolkit.net/) that are automatically set up as persistent main effects on the main outputs of SuperCollider. They are respawned when the user hard stops the sound.

This quark depends on the ambisonic toolkit and requires a full installation of it. See [these instructions](https://github.com/ambisonictoolkit/atk-sc3#installing) for more information. 

It also depends on [persistentmainfx](https://github.com/madskjeldgaard/persistentmainfx) which is installed automatically by the quark system.

If you want to use the IEM based binaural decoder, you need the [vstplugin extension](https://git.iem.at/pd/vstplugin/-/releases) and the [IEM Plugins](https://plugins.iem.at/docs/).

### Installation

Open up SuperCollider and evaluate the following line of code:

`Quarks.install("https://github.com/madskjeldgaard/binauraldecoders")`

## Example usage

```supercollider

// Setup decoder

(

~order = ~order ? 3;

BinauralDecoderCIPIC.new(hoaOrder: ~order);

)

// Inspect the node tree to see that it is in fact in action:

s.plotTree

// Play some high order ambisonics sound

(

// White Noise going round

Ndef(\hoa_testorientation, {|amp=0.125, freq=100, rotFreq=1, ele=0|

	// var sig = LFTri.ar(freq)*amp;

	var sig = WhiteNoise.ar(amp);

	var azi = LFSaw.kr(rotFreq, mul: pi);

	sig = HoaEncodeDirection.ar(

		sig,

		azi,

		ele,

		AtkHoa.refRadius,

		~order

	);

}).play

)

// Bypass the decoder to output raw ambisonics

BinauralDecoderCIPIC.set(\bypass, 1);

```