M4L || 4DSource | 4DSpace | 4DGlobal

4D M4L - 4Dglobal

version 1.5 Beta

Panning

Global parameters operate on a global level and therefore affect all sources (if global is enabled on that particular source). Using global functions you can transform the entire constellation of sources by for instance moving or rotating them all together.

GLOBAL

Note: the below only affects global enabled sources (ref. 4Dsource1.5 > panning tab > global)

position: adds a position offset.
dimensions: stretches the dimensions of the entire space.
rotation: rotates the entire space.
plode: explode or implode the constellation of sources.
plode scale: scale the plode offset to affect all the dimensions at once.
center: the reference point of global transforms (e.g. the center point for rotation).
reset values: set all parameters on this tab to their default values.


Groups

Similarly to the global panning function, groups function allows you to transform several constellations of sources by, for instance, moving or rotating them all together.


Binaural

Binaural tab provides basic controls over the position of the virtual listener for the binaural playback


Scripts

Allows to load script file to the engine.


Grids

The grid tab can be used to adjust the grids in the engine.


Instant

Here you create a new, or load an existing instant preset file in a 4DSOUND Live set. The files that are stated here are associated throughout the Live set and all 4Dsource and 4Dspace devices read and write from this preset files. One for each type of device separately.

4Dglobal1.5 Instant tab

SOURCES

preset file path: shows the folder path and file name of the instant preset file that is currently active. Or states 'no preset file loaded'. The preset file name associated with 4Dsources is also showed at the bottom of the instant tab at each 4D source device.

Instant Midi Mapper

new: create a new preset file by opening a save dialog. A prest file can be stored anywhere you want, but it's advised to save it in the project folder of the Live set.
load: load an existing preset file.
backup: backup the current preset file in the same folder as the original. It opens a dialog to enter the name of the backup (it will overwrite the original when the same name is used, so that won't create a backup). Note that the original preset file remains the active one.
midi mapper: (experimental) opens a window where you can associate midi notes with presets. This feature enables to trigger instants in arrangement view. Type the name of a preset next to a note to connect them.

Note: the midi mapper is still considered experimental. A known issue is that sometimes the mappings are not restored after loading the Live set. Therefore, you can export and load them as an external file to not lose your settings.

SPACES

The functionalities of new, load, and backup are similar to those for sources except that they relate to 4Dspace devices.


OSC

This tab hosts a collection of settings regarding OSC, network, and sync.

OSC

enable: enable/disable all OSC traffic in the Live set (developers option).
data rate: set the rate at which OSC is sent out.
output all values: outputs all the values of 4D parameters in the Live set, usually used to initialise the 4D Engine with the current settings after a Live set has been loaded.

4D M4L version : shows the version of the current 4D M4L.

ENGINE

IP : set the IP address of the computer that runs the 4D Engine. When it runs locally you can either use '127.0.0.1' or 'localhost'.

SECONDARY

If you want to use the output data for another (custom) application, you can enable a secondary OSC out port and target, which mirrors the messages to the 4D Engine.

enable: enable/disable secondary OSC output.
IP: set the IP target.
Port: set the port number (2000, 2001, 2002, and 8000 are already in use).

MONITOR

IP: set the IP address of the computer that runs the 4D Monitor. When it runs locally you can either use '127.0.0.1' or 'localhost'.

PAD

remote labels: set the names for the 4D PAD midi remote tab (ref. 4D PAD). Note that this remote only functions as an external midi controller and that given names are for usability only, in other words the names have no effect in themselves.

— PAD Remote Labels —

upload to Pad: upload names to 4D PAD.
index: set all names to indexes.
empty: set all names to 'empty'.
load file: load an existing file.
export file: export the current names as an extternal file.

— / PAD Remote Labels —

IP: set the IP of the iPad that runs 4D PAD (you can find the IP in Lemur > Settings > More settings > OSC target : Lemur IP).
ping: if you click to Pad and from Pad as a reaction blinks, then that means the connection is established.
source count: set the amount of sources that 4D PAD hosts (this does not need to be the same as the amount of sources in the Live set).

MASTER PHASE

The 4D Engine needs te receive a Master Phase in order to sync movements like Modulations. input mode means the user can manually control the phase with the number box, or with automation, more usual is sync mode to create a signal that syncs the 4D Engine with the Bpm of Live.

speedlim: sets the rate at which the Master Phase is sent (developers option).

OSC OUT

Shows the outgoing OSC data of this device.