OSC control

Configuration

Go to the Settngs menu and choose the Comm tab.

OSC Prefix:

Set this value to establish a message filter, so all incoming messages must have this first item in the address to be valid.

Example:

OSC Prefix = exaplay 
Messages = exaplay/a/b/c

OSC Listen

This field contains all the ip addresses and ports the OSC module will be listening to, each line represents an ethernet IP followed by a port, separated by a colon :.

Use an asterisk * as a wildcard to specify all Ips in the host.

Example:

  • Listen to adapter with IP 192.168.1.229 on port 8000: 192.168.1.229:8000

  • Listen to all local adapters on port 4500: *:4500

OSC Clients

Configure the destination IPs and ports to send OSC messages to.

OSC IN (Receive)

Each message address should have the first level as configured in Exaplay, by default this value is exaplay. The following value should be the address of the object inside Exaplay.

Example:

/exaplay/comp1

The last value should be a command, the parameters are the values in the OSC bundle, and vary depending on the context of the object.

For tmeline compositions:

CommandDescriptonParameters

play

Starts playback from last position

stop

Stops the playback

pause

Pauses the current playback

cuetime

Moves the play cue to a given time

f: Time in seconds

cue

Moves to a given Cue index

i: Cue index

For cuelist compositions

CommandDescriptonParameters

play

Starts playback from last position

stop

Stops the playback

pause

Pauses the current playback

cue

Moves the play cue to a given clip

i: Clip index (Starting from 1)

Examples

Start playback for timeline composition named ‘comp1’

/exaplay/comp1/play

Move to the second clip in cuelist composition named ‘comp3’

/exaplay/comp3/cue

i:2

Move to the time 3s in timeline composition named ‘comp1’

/exaplay/comp1/cuetime

f:2.0

OSC OUT (Send)

If configured, each Exaplay compositions will emit OSC bundles with their current status.

The output address will be similar to what is used for input, beginning with the default address prefix exaplay, followed by the address of the Exaplay’s object.

Example:

/exaplay/timeline1

The contents of the bundle are described as follows:

ParameterTypeDescriptionValues

status

i

Current playback status

0: stop 1: Play 2: Pause

cueframe

i

Current frame index

cuetime

f

Current time in seconds

Out scripted

It is possible to send arbitrary OSC messages at certain events, configured as cue commands in Exaplay. The format structure is as follows:

OSC

>

IP Address : Port

,

address

,

values

The value types can be integers i or floats f.

Example command to send a message with address ‘exaplay/test/’ with an integer value of 10 and a float of 0.5 to 192.68.50.10 listening at port 8000:

OSC>192.168.50.10:8000,exaplay/test/,i:10,f:0.5

Last updated