Open Sound Control (OSC)

How to use the OSC protocol with LevelMagic(TM)

The OSC protocol

The OSC protocol is a way of controlling devices via the network. Here we present a way of taking control of the LevelMagic(TM) plug-in using this protocol.

Using the Bonjour protocol, Zero Conf

If your control device uses bonjour or Zero conf protocol configuration will be quick and simple. Just select Flux::OSC in the ZeroConf device of your controller. Then, write the output port and IP address of your device in the labels of the plug-in. Remember that in the output port label of the plug-in you should write the input port of your controller and in the output address of the plug-in you should write the IP address of your device.

Configuring OSC parameters manually.

The following parameters are used to configure OSC manually in LevelMagic(TM)

The image below presents the different OSC parameters used for configuration.

Feedback from the plug-in to the controller

The Flux:: OSC manager will send feedback to your controller. These are the different situations when you will receive feedback:

Using multiple controllers and advanced configurations

Flux :: OSC gives you the possibility to use multiple controllers for one instance of a plug-in and have a particular feedback for each one. If you want to use multiple controllers refer to the use of the /TalkToMeOnPort Command found under “Commands”.


How to use the commands

At first you have to know what an OSC message is composed of. Mainly, these two parts: The Address Pattern and the Argument.

For controlling parameters Flux:: only supports arguments of float type so make sure that the arguments you are sending via your controller are Floats. Float arguments must always be from 0 to 1 for controlling a parameter so you don’t have to deal with scale conversion.

The LevelMagic(TM) OSC commands

When OSC is enabled in the Plug-in Settings (2) the file “OSC_Dict.xml” is automatically created in:

This is a properties dictionary with each parameter that can be controlled and mapped using OSC. The commands in the dictionary includes a ”Translation” attribute that can be used in order translate the OSC name into the Flux:: internal parameter name in both directions.

Global Commands

Global commands allow you to access to some additional information. These commands don’t need an instance number. These are the available additional commands: