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.
- Open the Project Settings via menu Project -> Settings
- In the OSC pane
- Check the box: OSC Enabled
- Enter the network UDP port number that the OSC data is to be received on
- 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:
- Open the Connection Monitor pane with View -> Connection Monitor
- The pane will show you how many packets of data have been received on the listening OSC port in realtime
Using received OSC data
You can manipulate numeric and text string values in the nodegraph by utilising two nodes:
- OSC Modifier for numeric values
- 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()
Sending OSC
Setting up your project to send OSC
- Open the Project Settings via menu Project -> Settings
- In the OSC pane
- Check the box: OSC Enabled
- Enter the network UDP port number that the OSC data should be transmitted on
- Enter the Target IP address that OSC data should be transmitted to
- Click OK
Sending OSC data from Notch
You can send numeric values (as floats) over the network using the OSC Output node.
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
- Open the Project Settings via menu Project -> Settings
- In the OSC pane
- Check the box: OSC Enabled
- Check the box: Transport Enabled
- Enter the network UDP port number that the OSC data is to be received on
- Click OK
To check you are receiving data with this network configuration:
- Open the Connection Monitor pane with View -> Connection Monitor
- The pane will show you how many packets of data have been received on the listening OSC port in realtime
OSC Transport Commands
OSC Address | Value | Description |
---|---|---|
/notch/transport/play | bool | Play the scene |
/notch/transport/pause | bool | Pause the scene |
/notch/transport/reset | bool | Returns to time zero |
/notch/transport/time | float | Goes to time t in seconds |
/notch/transport/layer | int | Select layer by index, from 0 |