Max-for-Live implementation for interfacing the SoundScapeRenderer network adaptor. Allows the user to place a source in 2D space and let the SSR renderer (http://spatialaudio.net/ssr/) deal with the reproduction setup. It implements following playback modes:
- Wave Field Synthesis (WFS)
- Vector Base Amplitude Panning (VBAP)
- Ambisonics Amplitude Panning
- Near-field-corrected Higher-Order Ambisonics (NFC-HOA)
- (Dynamic) Binaural Synthesis
- (Dynamic) Binaural Room Synthesis (BRS)
To easily access the m4l devices from Live, add both files m4l_ssr_remote_master.amxd and m4l_ssr_remote_object.amxd to the Live user library. The default location is ~/Music/Ableton/User Library/Presets/Audio Effects/Max Audio Effect.
UPDATE In newer versions of SSR (compiled after commit d664f4c6df0c5aa6bd69208c02d909ddf73cab3b) it is enough to start SSR with the parameter --end-of-message-character=10 in order to interface with Max MSP. You may skip the following paragraphs.
To satisfy SSR's line ending (binary zero, \0), the default has to be changed in the mxj net.tcp.send object. This has to be done only once.
You can either do this yourself by inserting a single line and recompiling or simply using the files provided in the modified mxj net.tcp.send folder (recommended). Read the provided README.txt for correct file locations and please back up your original files!
If you don't want to use the modified java class, follow the step-by-step instructions below to do it yourself.
- Open
m4l_ssr_remote_master.amxd, disable presentation mode, double click thep tcpClientMXJobject, and hit theviewsourcemessage box. - Inside the
send(Atom args[]) {}declaration, you need to add the following line:
System.setProperty("line.separator", "\0");- Go to
Java > Open Compile Window...and hitCompile. - Ideally you should receive no errors and can safely close all windows.
Below a snippet of the modified mxj net.tcp.send java source:
send(Atom args[]) {
// Force binary 0 linebreak for SSR's TCP interface
System.setProperty("line.separator", "\0");
// Unmodified code below
declareIO(1, 3);
setInletAssist(0, "(anything) message to send to group");
setOutletAssist(0, "(anything) successfully sent data");
setOutletAssist(1, "(anything) data unsuccessfully sent");
setOutletAssist(2, "(int) number of active packets");
declareAttribute("address", "getAddress", "setAddress");
declareAttribute("port", "getPort", "setPort");
ts = new TcpSender();
ts.setDebugString("net.tcp.send");
ts.setSuccessCallback(this, "success");
ts.setFailureCallback(this, "failure");
}Please be aware that this does change the default behaviour of net.tcp.send. This may cause unexpected behaviour when using it in other patches.
To reverse the line ending to the systems default, simply remove the pre-compiled files and restore the original files or remove the inserted line and recompile. A restart of Max might be required.
To route audio from Live to SSR, you need to add live input sources to SSR. A possible source declaration may look like this:
<source name="Source 1" model="point">
<port>1</port>
<position x="1" y="1"/>
</source>You can then use Jack (see http://jackaudio.org or http://brewformulas.org/Jack) to easily send audio through virtual connections from Ableton Live into the virtual sources in SSR. Please note that SSR automatically enumerates the sources with increasing IDs, starting from 1.
- Place the master plugin (
m4l_ssr_remote_master.amxd) on any channel - master channel is a solid choice. - Set the IP and port of SSR, as well as the number of sources (may be changed later).
- Use the remote object plugin (
m4l_ssr_remote_object.amxd) on any channel you want to control. Set the ID to the corresponding SSR object and start automating!
You can use both automation in the timeline as well as m4l devices such as the LFO to modulate the source position.