Connecting OSC Messages to Kyma Event Values
In Kyma, you can associate incoming OSC messages with Kyma Event Values in several ways:
- remap individual VCS widgets to respond to specific OSC messages
- use OSC Event Values in parameter fields of Sound
- program an external OSC device to send messages that are automatically recognized
Learn or Map to an OSC message in the VCS
In the Virtual Control Surface (VCS):
- right-click the widget
- choose Learn from the pop-up menu
- send OSC message from device
To map to any OSC message received in the past:
- in the VCS, right-click the widget
- choose Controller and then OSC from the pop-up menu
- select the desired OSC message
If the incoming message is a vector, Kyma will “learn” the first element of the Vector. (The same is true for learning in parameter fields).
Learn or Enter an OSC message in a Parameter field
To control a Kyma Sound parameter with an OSC message, use the learn function in the parameter field:
- click in the parameter field
- press the escape (ESC) key on your computer keyboard
- send the OSC message to Paca(rana)
If you “learn” an OSC message that is a vector, the first element of the vector will be captured.
You can also type the OSC Event Value name directly into the parameter field using a specially formatted OSC Event Value. To transform your OSC message into a Kyma OSC Event Value:
- replace each slash in the address with underscore
- use the prefix: !osc
Here are some examples of Kyma OSC Event Values and their corresponding OSC messages:
Event Value | OSC message |
---|---|
!osc_1_fader1 | /1/fader1 |
!osc_4_xy__1 | /4/xy//1 |
Program OSC Source to send specific messages to Kyma
Instead of re-mapping each individual Kyma widget or parameter with an OSC message one-by-one, you can, alternatively, program your OSC device or application to send specific messages to control Kyma using the message address format:
/vcs/name/channel
Where name is the name of the Kyma Event Value, and channel is the MIDI channel of the controller. Even though you are sending OSC (and not MIDI), the channel identifiers are retained as a convenient way to organize controllers (for example, by default each track of the Timeline is associated with its own controller channel).
If your Sound had Event Values !Vol, !Amp, !Density, for example, you could program your device to send the OSC messages:
/vcs/Vol/1
/vcs/Amp/1
/vcs/Density/1
This automatically maps to Kyma Event Values !Vol, !Amp, !Density. (Note that you can still, optionally, remap individual VCS widgets to different control sources.)