I am happy to finally release my cross-platform Ambisonic processors useable as VST/LV2 plug-ins or standalone application under Windows, Mac OSX and Linux. They can be used in flexible hosts like Reaper, Ardour, MaxMSP, Bidule or as standalone applications with Jack.
The plug-ins can be used to produce 3D Ambisonic content or do post production on recordings. (eg. Soundfield or Eigenmike® microphone recordings)
The Ambisonic order is variable and can be choosen at compile time. A practical limitation for Reaper is 7th order due to the 64 channel limit. The processors use the ambiX convention (full 3D, ACN channel ordering, SN3D normalization)
Prototype the Audio Plugin. Once you have defined an audio plugin, you can prototype it using the Audio Test Bench app. The Audio Test Bench app enables you to stream audio through the plugin while you tune parameters, perform listening tests, and visualize the original and processed audio. To open your StereoWidth plugin in the Audio Test Bench app, at the MATLAB® command prompt, enter. PC running a Windows operating system. VST compatible DAW or VST hosting software. This plugin is 32bit but can be run on 64bit systems using jBridge. This plugin also operates within the 64bit versions of Cubase, Nuendo, Bitwig Studio, Reaper, Tracktion, Renoise, FL Studio, Sonar, Mixcraft and Samplitude using their inbuilt bridging. When you load an external plugin using loadAudioPlugin, an object of that plugin is created having externalAudioPlugin or externalAudioPluginSource as a base class. The externalAudioPluginSource class is used when the external audio plugin is a source plugin. For a tutorial on hosting audio plugins, see Host External Audio Plugins. To learn more about audio plugins in general, see Audio Plugins in MATLAB. Default User Interface The equalizerV1 audio plugin enables you to tune the gains and center frequencies of a three-band equalizer, tune the overall volume, and toggle between enabled and disabled states. Stereo Convolution Reverb (VST audio plugin). Learn more about dsp, vst, audio plugin, convolution Audio Toolbox, DSP System Toolbox.
A short video clip showing the plug-ins in action: https://vimeo.com/81073470
You may want to use these plug-ins in combination with the mcfx multichannel effect plug-in suite: http://www.matthiaskronlachner.com/?p=1910
Source code repository: https://github.com/kronihias/ambix
Windows 32bit VST:
1st order: ambix_v0.2.10_win32_o1.exe
3rd order: ambix_v0.2.10_win32_o3.exe
5th order: ambix_v0.2.10_win32_o5.exe
7th order: ambix_v0.2.10_win32_o7.exe
Windows 64bit VST:
1st order: ambix_v0.2.10_win64_o1.exe
3rd order: ambix_v0.2.10_win64_o3.exe
5th order: ambix_v0.2.10_win64_o5.exe
7th order: ambix_v0.2.10_win64_o7.exe
Mac OS X (>= 10.7) VST Universal Binaries:
1st order: ambix_v0.2.10_osx_o1.zip
3rd order: ambix_v0.2.10_osx_o3.zip
5th order: ambix_v0.2.10_osx_o5.zip
7th order: ambix_v0.2.10_osx_o7.zip
You will also need the binaural decoder presets if you want to listen with headphones: ambix_binaural_presets_v0.1.5.zip
(download includes decoder matrices + binaural loudspeaker impulse responses)
Install the decoder presets to:
Windows 7/8: C:UsersusernameAppDataRoamingambixbinaural_presets
MacOS: ~/Library/ambix/binaural_presets/
Linux: ~/ambix/binaural_presets/
Currently there is no preset generator included, you have to generate your decoding matrix with other tools. For example with the Ambisonic Decoder Toolbox by Aaron Heller using Matlab/Octave: [Source repo] [LAC Article].
Readthis article from the AES Design competition for some informations regarding the plug-ins!
A slightly outdated paper about the plug-ins can be found here: http://lac.linuxaudio.org/2013/papers/51.pdf
Ambisonic transformations are described here ICSA2014_KronlachnerZotter_AmbisonicTransformations.pdf
This software was developed during the work on my master thesis at the Institute of Electronic Music and Acoustic Graz. [ IEM ]
ambiX Ambisonic plug-in suite
> cross-platform Ambisonic VST, LV2 plug-ins with variable order for use in Digital Audio Workstations like Reaper or Ardour or as Jack standalone applications.
> The plug-in suite use the ambiX *(1)* convention (ACN channel order, SN3D normalization, full periphony (3D)) except the sqrt(1/4pi) factor in equation 3.
> these plug-ins use a recursive implementation of the spherical harmonics, therefore the maximum Ambisonic order is defined at compile time. the practical maximum order is rather defined by the hosts maximum channel count (N+1)^2 or your CPU power
*(1) http://iem.kug.ac.at/fileadmin/media/iem/projects/2011/ambisonics11_nachbar_zotter_sontacchi_deleflie.pdf*
> This software uses the JUCE C++ framework, which is under GPL license.
More information: http://www.juce.com
> other libraries being used:
> Eigen (MPL2, http://eigen.tuxfamily.org),
> libsoxr (LGPL, http://soxr.sourceforge.net)
> fftw under Linux and Windows (GPL, http://www.fftw.org)
> libzita-convolver3 optional for Linux (GPL v3)
this software package goes well together with the mcfx – multichannel cross plattform audio plug-in suite: http://www.matthiaskronlachner.com/?p=1910
plug-in reference:
———-
> some information about the software can be found here: http://lac.linuxaudio.org/2013/papers/51.pdf, http://iaem.at/Members/zotter/publications/2014_KronlachnerZotter_AmbiTransformationEnhancement_ICSA.pdf
* ambix_binaural – binaural decoder with various loudspeaker setups in real world studios/venues /bass-vst-plug-in-free.html.
* ambix_decoder – same as binaural decoder but without the convolution, the loudspeaker signals are sent directly to the outputs (single band decoding)
* presets for ambix_binaural (including impulse responses) and ambix_decoder are located in the folder ambix_binaural/Presets (or available as separate download) and should be copied in following folders
* Windows 7,8: C:UsersusernameAppDataRoamingambixbinaural_presets
* MacOS: ~/Library/ambix/binaural_presets/
* Linux: ~/ambix/binaural_presets/
* ambix_converter – convert between different ambisonic standards on the fly (include different standards in one project), also between 2D/3D
* ambix_directional_loudness – amplify, attenuate or filter out certain parts of the spherical soundfielddf
* ambix_encoder – panning plug-in with different numbers of input channels – a width parameter spreads those channels equally along the azimuth
* ambix_maxre – apply or reciprocal apply spherical max_re weighting to suppress sidelobes according to Zotter, Frank – „All-Round Ambisonic Panning and Decoding“
* ambix_mirror – invert or mirror soundfield about x/y/z axis
* ambix_rotator_z – rotation around z axis
* ambix_rotator – rotation around xyz axis
* ambix_vmic – same principle as directional loudness but will not output ambisonics signal but the selected part of the soundfield – similar to the virtual microphone approach
* ambix_warp – warp soundfield towards equator, poles, front or back…*
* ambix_widening – frequency dependant rotation around the z-axis, use this for source widening or creating diffuse early reflections, article: http://dx.doi.org/10.14279/depositonce-12, Created with help of Franz Zotter and Matthias Frank
prerequisites for building
————–
– cmake, working build environment
– fftw3, Eigen 3
– Standalone applications: ASIO SDK if you want ASIO under Windows
Install LINUX dependencies (Debian, Ubuntu):
————–
*$ sudo apt-get install libasound-dev libfreetype6-dev libgl1-mesa-dev libx11-dev libxext-dev libxinerama-dev libxcursor-dev libxrandr-dev libeigen3-dev freeglut3-dev libxmu-dev libxi-dev libsoxr-dev libfftw3-dev libzita-convolver3 libzita-convolver-dev*
Fedora:
————–
*$ sudo dnf install alsa-lib-devel freetype-devel mesa-libGL-devel libX11-devel libXext-devel libXinerama-devel libXcursor-devel eigen3-devel freeglut-devel libXmu-devel libXi-devel soxr-devel fftw3-devel libXrandr-devel jack-audio-connection-kit-devel*
*$ sudo dnf groupinstall „Development Tools“*
*$ sudo dnf groupinstall „C Development Tools and Libraries“*
Install MacOSX dependencies (through MacPorts):
————–
*$ sudo port install eigen3-devel soxr*
Install Windows dependencies
————–
*getting the dependencies for Windows is a little bit more tricky. you have to get fftw3, libsoxr and Eigen.*
howto build ambix yourself:
————–
– use cmake gui or cmake/ccmake from terminal:
– adjusts the various parameters to your needs, make sure the libraries are found
**TERMINAL:**
– create a folder in the *ambix* folder eg. *BUILD*
*ambix/BUILD> $ ccmake .*
– adjust parameters
then
*ambix/BUILD> $ make*
*(if you have a multicore processor you can speed up the make process by using make -j #CPUCORESx1.5)*
– find the binaries in the *ambix/BUILD/_bin* folder and copy to system VST folder
**VST installation folders:**
– MacOSX: /Library/Audio/Plug-Ins/VST or ~/Library/Audio/Plug-Ins/VST
– Windows: eg. C:Programm FilesSteinbergVstPlugins
– Linux: /usr/lib/lxvst or /usr/local/lib/lxvst
LV2 plug-in
———–
– compile the plug-ins with the flag BUILD_LV2 ON
– go to the folder *lv2-ttl-generator* and **> make** for compiling the tool *lv2_ttl_generator*
– go to the _bin folder (eg. *ambix/BUILD/_bin* ) and execute the script *> ./././lv2-ttl-generator/generate-ttl.sh*
this will generate all needed .tll files, afterwards you can copy all .lv2 folders from *ambix/BUILD/_bin/lv2* to /usr/lib/lv2
known problems
———–
* documentation missing – for now you can check this:
http://lac.linuxaudio.org/2013/papers/51.pdf
http://iaem.at/Members/zotter/publications/2014_KronlachnerZotter_AmbiTransformationEnhancement_ICSA.pdf
http://www.matthiaskronlachner.com/wp-content/uploads/2013/01/Kronlachner_Master_Spatial_Transformations_Mobile.pdf
http://www.matthiaskronlachner.com/wp-content/uploads/2013/01/kronlachner_aes_studentdesigncompetition_2014.pdf
* GUI less plug-ins can not be used as standalone – therefore GUI for some more of the plug-ins would be nice…
* Linux: LV2 plug-ins don’t show the GUI, VST plug-ins GUI might crash – better just stick to the hosts‘ GUI or help me fix that. you can use the standalone version in any case and connect via Jack
* different orders require different plug-in instances: maybe VST 3 can fix that with it’s dynamic input/output ports. but we’ll have to wait for it beeing implemented in appropriate hosts.
changelog
———–
* v0.2.10 (2020-02-06) amibx_binaural: fix dropouts/artifacts for hosts that send incomplete block sizes (eg. Adobe, Steinberg); option to store preset within the project -> allows to exchange a DAW (eg. Reaper) project without need to provide the preset files extra, allow to export stored preset as .zip file for recovering it from the project
* v0.2.9 (2019-06-12)
amibx_warp: fixed crash
* v0.2.8 (2017-05-20) ambix_binaural: fftw threadsafty improved: fix crash during startup if other plugin uses fftw ambix_rotator: add quaternion input
* v0.2.7 (2017-03-22)
ambix_binaural: improved performance, various bugfixes
ambix_rotator: improved performance
ambix_encoder: adjustable custom id for remote control
* v0.2.6 (2016-04-08) converter: fixed scaling of „O“ channel when converting from/to FuMa; binaural: convolution engine fix, preset dir save fix; vmic: gui fix
* v0.2.5 (2015-12-06) liblo dependencies removed
encoder: improved gui performance
decoder: fixed binaural swap l-r impulse responses bug, added volume control, indicate loaded preset in menu
directional_loudness: gui and different solo/window behavior (multiple filters are now passed through if soloed), 8 filters by default
rotator: gui, osc rewrite
vmic: gui, 8 outputs by default
* v0.2.4 (2015-07-19) improved efficiency for binaural decoder
* v0.2.3 (2014-12-27) multichannel encoder display actual source positions, compatibility with audiomulch for saving settings
* v0.2.2 (2014-08-18) encoder flickering fix, added osc settings, new control modes for encoder display: right mouse click for relative source movement, press shift to freeze elevation while moving and ctrl to freeze azimuth
* v0.2.1 (2014-04-17) fixed vst identifier for Plogue Bidule compatibility
* v0.2.0 (2014-03-30) added ambix_widening, JUCE update, encoder GUI panning fix
* (2014-03-15) fixed binaural decoder crash during configuration unloading
* (2014-02-19) warping curve 2 changed slightly (icsa paper), warping pre-emphasis added, encoder abs(elevation) > 90° was wrong!
* (2014-02-13) ambix_maxre added
* v0.1.0 (2014-01-24) – first release
thanks to
———–
several people and institutions contributed to this software in one or another way, i would like to name them here without particular order: Institute of Electronic Music and Acoustics Graz, Franz Zotter, Winfried Ritsch, Martin Rumori, Florian Hollerweger, Peter Plessas, IOhannes Zmölnig, Thomas Musil, Gerriet K. Sharma, Matthias Frank, Fons Adriaensen, Jörn Nettingsmeier, Filipe Coelho (DISTRHO project), Music Innovation Studies Centre of the Lithuanian Academy of Music and Theatre, Ricardas Kabelis, Mantautas Krukauskas, Tadas Dailyda, Sebastian Grill, the surrsound and linux audio community – to be continued…
author
———–
2013-2016 Matthias Kronlachner
m.kronlachner@gmail.com
www.matthiaskronlachner.com
C. DeVane, and G. Bunkheila, 'Automatically Generating VST Plugins from MATLAB Code,' Engineering Brief 238, (2016 May.). doi: C. DeVane, and G. Bunkheila, 'Automatically Generating VST Plugins from MATLAB Code,' Engineering Brief 238, (2016 May.). doi:
Abstract: We describe the automatic generation of VST audio plugins from MATLAB code using the Audio System Toolbox from MathWorks. We provide MATLAB code for three complete example plugins, discuss problems that may be encountered, and describe a workflow to generate VST plugins as quickly and easily as possible.
@article{devane2016automatically,
author={devane, charlie and bunkheila, gabriele},
journal={journal of the audio engineering society},
title={automatically generating vst plugins from matlab code},
year={2016},
volume={},
number={},
pages={},
doi={},
month={may},} @article{devane2016automatically,
author={devane, charlie and bunkheila, gabriele},
journal={journal of the audio engineering society},
title={automatically generating vst plugins from matlab code},
year={2016},
volume={},
number={},
pages={},
doi={},
month={may},
abstract={we describe the automatic generation of vst audio plugins from matlab code using the audio system toolbox from mathworks. we provide matlab code for three complete example plugins, discuss problems that may be encountered, and describe a workflow to generate vst plugins as quickly and easily as possible.},}
TY - paper
TI - Automatically Generating VST Plugins from MATLAB Code
SP - EP -
AU - DeVane, Charlie
AU - Bunkheila, Gabriele
PY - 2016
JO - Journal of the Audio Engineering Society
IS -
VO -
VL -
Y1 - May 2016 TY - paper
TI - Automatically Generating VST Plugins from MATLAB Code
SP - EP -
AU - DeVane, Charlie
AU - Bunkheila, Gabriele
PY - 2016
JO - Journal of the Audio Engineering Society
IS -
VO -
VL -
Y1 - May 2016
AB - We describe the automatic generation of VST audio plugins from MATLAB code using the Audio System Toolbox from MathWorks. We provide MATLAB code for three complete example plugins, discuss problems that may be encountered, and describe a workflow to generate VST plugins as quickly and easily as possible.
We describe the automatic generation of VST audio plugins from MATLAB code using the Audio System Toolbox from MathWorks. We provide MATLAB code for three complete example plugins, discuss problems that may be encountered, and describe a workflow to generate VST plugins as quickly and easily as possible.
http://www.aes.org/e-lib/browse.cfm?elib=18142
Click to purchase paper as a non-member or login as an AES member. If your company or school subscribes to the E-Library then switch to the institutional version. If you are not an AES member and would like to subscribe to the E-Library then Join the AES!
This paper costs $33 for non-members and is free for AES members and E-Library subscribers.
The Engineering Briefs at this Convention were selected on the basis of a submitted synopsis, ensuring that they are of interest to AES members, and are not overly commercial. These briefs have been reproduced from the authors' advance manuscripts, without editing, corrections, or consideration by the Review Board. The AES takes no responsibility for their contents. Paper copies are not available, but any member can freely access these briefs. Members are encouraged to provide comments that enhance their usefulness.