1. Message Formats
This is what you need to know in order to send and receive OSC.
Input: receive one or multiple values.
/lj/osc/start_address value1 value2 ... valueN
start address: The address of the first value from 0 to 511. This lets you update only a certain portion of the values.
values: Float numbers between 0 and 1. You can send one or multiple values at once. The values will appear in percent in Lightjams.
Since Lightjams lets you easily map input values to any of its control, there is no need to have specific address for each feature like blackout or pause. It is up to you to do the mapping.
Output: send OSC bundle containing one message per fixture.
/prefix/start_address value1 value2 ... valueN
prefix: This is user configurable. The default is lj/osc.
start address: Start address of the fixture as configured in the patch window.
values: Float numbers between 0 and 1. There is one value per fixture attribute. For example, a simple generic dimmer fixture will send only one value and a RGB fixture will send three.
The output message for a RGB fixture patched at address 0 with full red would be:
/lj/osc/0 1.0 0.0 0.0
On a technical note, Lightjams supports type tags. The output frequency is about 40 frames per second.
2. Global Configuration
Access the OSC configuration by going to View/Configuration.
Input:
Network: You can change the default UDP OSC port, which is 9001 and the network adapter if you have multiple.
Monitor: Show all incoming OSC messages with indicators telling whether a message is valid or not.
Output:
Network: You can change the default UDP OSC port, which is 9002 and the network adapter if you have multiple. If you want to send OSC messages to another application running on the same computer, you can use the special loop-back adapter (127.0.0.1).
Destination: You can either broadcast by checking the box or send to a unique IP address. You can specify a broadcast address in the IP box if you want.
Format: The prefix is added to all OSC messages. This lets you identify which messages are coming from Lightjams.
Monitor: Show all outgoing OSC messages.
2. Patch OSC Universe
To enable the OSC output, you select the OSC universe when patching your fixtures. The 8 or 16 bits mode doesn't make any difference when using OSC except when a mode adds more attributes.
The start address will be used to create the OSC message for the fixture.
3. Link to any slider
Select any slider and click on the OSC icon. Then you'll be able to play with all OSC settings.
4. Play
OSC Input Values: The viewer lets you see OSC values in realtime and easily choose the value you want. Just click a value to select it.
To enable OSC output, add your fixture attributes on the grid and enjoy! Just remember that the attribute values are sent over OSC and not the DMX values. This means no precision is lost in translation.
