- Audio
- Other
OSC In
Purpose
Section titled “Purpose”OSC In listens on a UDP port and maps the OSC addresses you name to outputs. A fader message becomes a control lane. A cue button becomes a GO or a seek that an arrangement or transport can act on. Anything that speaks OSC can drive Voro this way: a grandMA, a stage-manager tablet, a TouchDesigner patch, a phone app.
Set Port to the port your sender targets, then describe the routing in Doc, one rule per line. Wire out to whatever should follow the incoming values: slot 0 is its channel 0, slot 1 its channel 1, and so on. Wire obs into Arrangement Source’s trigger input to release a held section, or into Transport In’s obs input to follow the messages as a clock.
Doc rules:
# fader 1 straight through, fader 2 rescaled to 0..1control 0 /fader/1control 1 /fader/2 0.5 0.5# an XY pad sends x and y in one messagecontrol 2 /pad/xy 1 0 arg 0control 3 /pad/xy 1 0 arg 1# GO button, and a seek to the beat in the first argumentgo /cue/goseek /cue/seek# same as go, but tagged with source id 30trigger /cue/next 30Inputs and outputs
Section titled “Inputs and outputs”- Inputs: none. OSC In is a source.
- Output
out: one control lane per slot, slot i on channel i. It is as wide as the highest slot the Doc maps, plus one, up to 64. - Outputs
out0toout7: slots 0 to 7, one lane each, kept for graphs made beforeout. - Output
obs: GO and seek events from thego,seek, andtriggerrules.
Controls
Section titled “Controls”- Enable: master on/off. While off, control lanes keep their last value and events are discarded.
- Port: UDP port to listen on, default
47312. Any number of OSC In nodes can listen on the same port, and each hears every message. - Doc: the routing rules, one per line.
#starts a comment. Changes apply live.
control <slot> <address> [scale] [offset] [arg <n>]sends an argument of matching messages to slotslot(0 to 63) asvalue * scale + offset. Scale defaults to 1, offset to 0, andargto 0, the first argument. Integer, float, and true/false arguments all work.- Several addresses can feed one slot, and one address can feed several slots, as the XY pad above does.
go <address> [source]andtrigger <address> [source]emit a GO. If the message carries an argument and it is zero, it is ignored, so a button that sends 1 on press and 0 on release fires once.seek <address> [source]emits a seek to the beat in the message’s first argument.- The optional source is a number that tags the event. It defaults to 21.
- Addresses match exactly. There is no wildcard matching.
- Up to 256 control rules and 64 event rules, addresses under 256 characters. Bundles are read one level deep. A rule the node cannot take, such as a slot past 63, is counted as refused in its status rather than dropped silently.
- A lane shows the last value until a new one arrives. It does not reset to zero.
Inputs
None
Outputs
-
out0..7row -
obsrow -
outrow
Parameters
Section titled “Parameters” Enable (Enable) Toggle
op('osc_in').par.Enable - Default:
On- Options:
- Off, On
Port (Port) Int
op('osc_in').par.Port - Default:
47312- Range:
- 1 to 65535
Doc (Doc) Str
op('osc_in').par.Doc - Default:
"" (Empty String)