C++ Audio Unit Generator library
C++ Pure Data CMake
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
builds/MacOs
dm-audioengine @ c6b4712
dm-audiomidi @ 6d6e04a
dm-cmake @ 2615526
dm-dsp @ 9da6bb9
dm-log @ 7c01066
dm-utils @ 76115b4
extra/algorithmicReverb
samples/openframeworks
.gitignore
.gitmodules
CMakeLists.txt
LICENSE
README.md

README.md

nodal - C++ Audio Unit Generator library

NODAL is a Unit Generator audio framework. It has been developed at Dinahmoe in 2012 to realize native applications using the interface of the Web Audio API (Javascript), that felt comfortable and had already been used in the other company’s projects.

Supported platforms

The library has been successfully used for the following platforms:

  • Mac OS
  • Linux
  • iOs
  • Android (NDK)

For all these platforms, the library is able to be used online or as an audio file rendering tool.

Binary download

The binary for the chosen platform are in the releases section. Please note that builds are not made for each commit, so for the latest updates it’s better to build from source.

Structure of the repository

The main GIT repo uses submodules to download other libraries for dinahmoe. This arrangement has been kept because it allows to keep the same directory structure as in Dinahmoe’s private projects. These repos, that can be used independently, are:

  • dm-audioengine: the bare audioengine itself
  • dm-audiomidi: classes to read-write audio files
  • dm-utils: a collection of C++ utility classes, used by mostly all other libraries
  • dm-cmake: a collection of CMake scripts
  • dm-dsp: digital signal processing building blocks, used by the audio engine
  • dm-log: a simple logging facility

Download

After having cloned this repository, and cd’ed into the repo’s directory, update the submodules, issuing

git submodule init

git submodule update

This will download the dependencies mentioned above.

Building

You must have cmake installed. From the main directory, you can issue the following commands in the terminal

mkdir build && cd build

cmake -DNODAL_INSTALL_PATH=../nodalCompiled ..

make install

This will compile and build the static library, merging all the single libraries into one, libnodal.a. The library and the headers will be found at the install path.

Examples

The examples directory contains a few examples of using the library with Openframeworks, JUCE, PortAudio, and libsndfile for offline bounce.

Extras

The directory “Extras” contains instruments and effects built using the basic “vanilla” building blocks provided by the audio engine. It can be compared to the objects contained in the “Extended” version of pure data.

The API

The interface to the librarier resembles the one of the WebAudio API. The AudioContext is the main class on which the user operates on: it holds the current status of the node graph,