Setting up communication with OSC device
Once opened a new score project, right-click in the Device explorer on the left of score window and choose
Add device from the Device explorer contextual menu. This brings score’s device setup window.
From the Protocols column, choose
OSC and setup IP address your device is running on as well in & out ports. You may also specify a name for your device. For the demo purpose here, we will use the default
OSCdevice name. When done, the Device explorer pane should display our device top node.
Note: Should you need to change settings of your OSC device, the setup panel can be brought back by choosing
Edit in the device contextual menu.
We can then setup our device’s OSC addresses we want to automate within score.
Setting up OSC addresses
Using OSC learn
In the Device explorer pane, choose
Learn in our device contextual menu. This opens up score’s OSC learning window. score will now monitor any OSC incoming value.
For demo purpose here, we will use Vidvox’s handy OSC Test application. As soon as we send values to score from our OSC Test application, addresses get learned and displayed in the
OSC learning window.
When done, the Device explorer pane should display all learned OSC addresses. You can browse your device namespace, fold/unfold any node in the namespace hierarchy by clicking the arrow prepending each node. You can also see a parameter current value in your OSC device by selecting this parameter in score Device explorer and check its bottom section.
Adding addresses manually
Should you need to setup your score project without having your OSC device opened, addresses can be added in the device explorer manually.
Once having created an OSC device as explained above, choose
Add child in the device contextual menu.
As of score 3.0.0, each level of your parameter’s OSC address is to be declared separately. Assuming we want to add the address
OSCdevice/track/1/volume, we first need to create the ‘track’ node. From the OSC editor window, type
track in the
Name text field and leave default type
container (that is: a node in the namespace above other nodes or parameters). Then from the freshly created
track node contextual menu, choose
Add child to create a
1 node, then from this node, choose
Add child again to create our
volume parameter, we want to set the type as something else than
container. For example, we will set up our parameter as a float value.
You may also edits some of the parameter’s attributes as detailed in next step.
Setting up parameters’ attributes
Once declared either using learn function or manually, parameter’s general behaviour can be further defined by setting up its various attributes.
When selecting a parameter in the Device explorer pane, its attributes can be displayed and edited in the bottom section of the pane. A dedicated window can also be opened by choose
Edit in the parameter contextual menu.
For each value type, a number of attributes can be defined, such as: value domain (min. and max. value), clip mode (parameter handling of value exceeding its domain), repetition filter, etc.
Saving OSC device for later use
When properly set up, your OSC device namespace can be exported and saved to disk for latter use. To do so, choose
Export device in the device contextual menu.