OSC

Introduction

Notch allows you to send and receive simple OSC data over the network for interacting with your project. When running as standalone, you can also control the play head remotely.

Receiving OSC

Setting up your project to receive OSC.

1. Open the Project Settings via menu Project -> Settings
2. In the OSC pane
   1. Check the box: OSC Enabled
   2. Enter the network UDP port number that the OSC data is to be received on
3. Click OK

Notch will listen to network traffic on all network adapters, using the specified port number.

To check you are receiving data with this network configuration:

1. Open the Connection Monitor pane with View -> Connection Monitor
2. The pane will show you how many packets of data have been received on the listening OSC port in realtime

!Only one process/Block can use a specific port number at a time. Either consolidate your effects into a single Block OR use different port numbers for each Block.

Using received OSC data

You can manipulate numeric and text string values in the nodegraph by utilising two nodes:

1. OSC Modifier for numeric values
2. OSC Text String for text string values

If you wish to use OSC values in your Javascript scripts, then setup a receiving node (as above) and read the value from the node using GetFloat()

!The incoming OSC values will only be processed when the play head is playing

Sending OSC

Setting up your project to send OSC

1. Open the Project Settings via menu Project -> Settings
2. In the OSC pane
   1. Check the box: OSC Enabled
   2. Enter the network UDP port number that the OSC data should be transmitted on
   3. Enter the Target IP address that OSC data should be transmitted to
3. Click OK

!The receiving and transmitting OSC port is the same

Sending OSC data from Notch

You can send numeric values (as floats) over the network using the OSC Output node.

!The outgoing OSC values will only be sent when the play head is playing

OSC Transport Control

When running as standalone you can remotely control the play head via OSC.

Setting up your project to receive OSC Transport Commands

1. Open the Project Settings via menu Project -> Settings
2. In the OSC pane
   1. Check the box: OSC Enabled
   2. Check the box: Transport Enabled
   3. Enter the network UDP port number that the OSC data is to be received on
3. Click OK

To check you are receiving data with this network configuration:

1. Open the Connection Monitor pane with View -> Connection Monitor
2. The pane will show you how many packets of data have been received on the listening OSC port in realtime

!OSC Transport commands have no effect in Builder. They only work in an exported Standalone.

OSC Transport Commands

/notch/transport/play
/notch/transport/pause
/notch/transport/reset   <-- Returns to time zero
/notch/transport/time <float>    <-- Goes to time t in seconds
/notch/transport/layer <int>     <-- select layer by index, from 0