--------------------------------------------------------------------------------------- Ovation - OSC Dictionary --------------------------------------------------------------------------------------- Notes: 1) Address Patterns are case insensitive. /Server/Cue/Fire can be sent as /server/cue/fire 2) Some parameters are optionals. They must be provided if following parameters are present. --------------------------------------------------------------------------------------- /Server: --------------------------------------------------------------------------------------- /Server/Show: /Server/Show/Init No arguments Action: Init the Show /Server/Show/Start No arguments Action: Start the Show /Server/Show/Pause No arguments Action: Pause the Show /Server/Show/Stop No arguments Action: Stop the Show --------------------------------------------------------------------------------------- /Server/Cue: /Server/Cue/AddAudio Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList, must be set if following arguments present) Argument 2: 'i/s': Cue number (can be a string if referencing a nested Cue, like 9.2.5) (optional, -1 meaning currently selected Cue, must be set if following arguments present) Argument 3: 's': Pathname of an Audio File Argument 4: 'i': Length of the Cue in millisecond (-1 meaning cue length is the length of the audio file) Argument 5: 'i': Offset in the file in millisecond (-1 meaning cue starts at the begining of the audio file) Argument 6: 'i': Fade In Time in millisecond (optional, -1 meaning no Fade In) Argument 7: 'i': Fade Out Time in millisecond (optional, -1 meaning no Fade Out) Action: Create an Audio Cue /Server/Cue/MakeReady Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList, must be set if following arguments present) Argument 2: 'i/s': Cue number (can be a string if referencing a nested Cue, like 9.2.5) (optional, -1 meaning currently selected Cue, must be set if following arguments present) Action: Ready a Cue /Server/Cue/Fire Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList, must be set if following arguments present) Argument 2: 'i/s': Cue number (can be a string if referencing a nested Cue, like 9.2.5) (optional, -1 meaning currently selected Cue, must be set if following arguments present) Argument 3: 'i': Absolute Time of start in millisecond (counted in Show Time scale) (optional, -1 meaning immediately, must be set if following arguments present) Argument 4: 'i': Relative Time Offset of start in millisecond (counted from time of receiving the message) (optional, -1 meaning immediately, must be set if following arguments present) Argument 5: 'i': Progress Time Offset in millisecond (start time in the cue) (optional, -1 meaning from start of Cue) Argument 6: 'i': Fade In Time in millisecond (optional, -1 meaning no Fade) Action: Fire a Cue /Server/Cue/FireSequenced Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList, must be set if following arguments present) Argument 2: 'i/s': Cue number (can be a string if referencing a nested Cue, like 9.2.5) (optional, -1 meaning currently selected Cue) Action: Fire a Cue and select next in the CueList /Server/Cue/Pause Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList, must be set if following arguments present) Argument 2: 'i/s': Cue number (can be a string if referencing a nested Cue, like 9.2.5) (optional, -1 meaning currently selected Cue, must be set if following arguments present) Argument 3: 'i': Absolute Time of Pause in millisecond (counted in Show Time scale) (optional, -1 meaning immediately, must be set if following arguments present) Argument 4: 'i': Relative Time Offset of Pause in millisecond (counted from time of receiving the message) (optional, -1 meaning immediately, must be set if following arguments present) Argument 5: 'i': Fade Out Time in millisecond (optional, -1 meaning no Fade) Action: Pause a Cue /Server/Cue/Stop Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList, must be set if following arguments present) Argument 2: 'i/s': Cue number (can be a string if referencing a nested Cue, like 9.2.5) (optional, -1 meaning currently selected Cue, must be set if following arguments present) Argument 3: 'i': Absolute Time of Stop in millisecond (counted in Show Time scale) (optional, -1 meaning immediately, must be set if following arguments present) Argument 4: 'i': Relative Time Offset of Stop in millisecond (counted from time of receiving the message) (optional, -1 meaning immediately, must be set if following arguments present) Argument 5: 'i': Fade Out Time in millisecond (optional, -1 meaning no Fade) Action: Stop a Cue /Server/Cue/StopAll No arguments Action: Stop all playing Cues /Server/Cue/Dim Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList, must be set if following arguments present) Argument 2: 'i/s': Cue number (can be a string if referencing a nested Cue, like 9.2.5) (optional, -1 meaning currently selected Cue, must be set if following arguments present) Argument 3: 'i': Absolute Time of Dim in millisecond (counted in Show Time scale) (-1 meaning immediately, must be set if following arguments present) Argument 4: 'i': Relative Time Offset of Dim in millisecond (counted from time of receiving the message) (-1 meaning immediately, must be set if following arguments present) Argument 5: 'i': Fade Out Time in millisecond (-1 meaning no Fade) Argument 6: 'f': Dim Gain in dB Action: Dim a Cue /Server/Cue/UnDim Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList, must be set if following arguments present) Argument 2: 'i/s': Cue number (can be a string if referencing a nested Cue, like 9.2.5) (optional, -1 meaning currently selected Cue, must be set if following arguments present) Argument 3: 'i': Absolute Time of UnDim in millisecond (counted in Show Time scale) (-1 meaning immediately, must be set if following arguments present) Argument 4: 'i': Relative Time Offset of UnDim in millisecond (counted from time of receiving the message) (-1 meaning immediately, must be set if following arguments present) Argument 5: 'i': Fade In Time in millisecond (-1 meaning no Fade) Action: UnDim a Cue /Server/Cue/HotPress Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList, must be set if following arguments present) Argument 2: 'i/s': Cue number (can be a string if referencing a nested Cue, like 9.2.5) (optional, -1 meaning currently selected Cue, must be set if following arguments present) Argument 3: 'i': 1 means Press, 0 means Release Action: Simulate the pressing of a HotKey in a HotKey or Custom Cue List /Server/Cue/Audition Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList, must be set if following arguments present) Argument 2: 'i/s': Cue number (can be a string if referencing a nested Cue, like 9.2.5) (optional, -1 meaning currently selected Cue) Action: Audition a Cue /Server/Cue/Select Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList, must be set if following arguments present) Argument 2: 'i/s': Cue number (can be a string if referencing a nested Cue, like 9.2.5) Action: Select a Cue /Server/Cue/SelectNext Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList) Action: Select Next Cue in a given CueList /Server/Cue/SelectPrev Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList) Action: Select Previous Cue in a given CueList /Server/Cue/SelectNextScene Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList) Action: Select Next Scene (top parent) Cue in a given CueList /Server/Cue/SelectPrevScene Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList) Action: Select Previous Scene (top parent) Cue in a given CueList --------------------------------------------------------------------------------------- /Server/CueList: /Server/CueList/Select Argument 1: 'i': CueList number Action: Select a CueList /Server/CueList/SelectNext No arguments Action: Select Next CueList /Server/CueList/SelectPrev No arguments Action: Select Previous CueList /Server/CueList/FireStart Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList, must be set if following arguments present) Argument 2: 'i/s': Cue number (can be a string if referencing a nested Cue, like 9.2.5) (optional, -1 meaning currently selected Cue) Action: Start the time of a Timed CueList and Fire the first Cue /Server/CueList/Start Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList, must be set if following arguments present) Argument 2: 'i/s': Absolute Time of Starting the CueList in millisecond (counted in Show Time scale) (-1 meaning immediately) Argument 3: 'i': Relative Time Offset of Starting the CueList in millisecond (counted from time of receiving the message) (-1 meaning immediately) Action: Start the time of a Timed CueList /Server/CueList/Pause Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList) Action: Pause the time of a Timed CueList /Server/CueList/Stop Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList) Action: Stop the time of a Timed CueList /Server/CueList/Chase Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList, must be set if following arguments present) Argument 2: 'i': 1 = Chase, 0 = No Chase Action: Set a Timed CueList to Chase its incoming TimeCode /Server/CueList/ChaseToggle Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList) Action: Toggle Chase On/Off of a Timed CueList incoming TimeCode /Server/CueList/SetTime Argument 1: 'i': CueList number (optional, -1 meaning currently selected CueList, must be set if following arguments present) Argument 2: 'i/s': Time in millisecond Action: Set the time of a Timed CueList --------------------------------------------------------------------------------------- /Server/HotCueList: /Server/HotCueList/Select Argument 1: 'i': CueList number Action: Select a HotCueList /Server/HotCueList/SelectNext No arguments Action: Select Next HotCueList /Server/HotCueList/SelectPrev No arguments Action: Select Prev HotCueList --------------------------------------------------------------------------------------- Server Status: /Server/Cue/Status Argument 1: 'i': CueList number Argument 2: 'i': Cue number as a (1 based) index in the cue list Argument 3: 's': Cue number as a a string, including nested cues, like '9.2.5' Argument 4: 's': Cue name Argument 5: 'i': Cue status (see below) Argument 6: 'i': Cue progress time in millisecond Cue Status code: 0 = Unknown 1 = Asleep 2 = Ready 3 = Stopped 4 = Preparing to Stop 5 = Paused 6 = Preparing to Pause 7 = Playing 8 = Preparing to play 9 = Dimmed 10 = Preparing to Dim 11 = Unloaded --------------------------------------------------------------------------------------- /Mixer: --------------------------------------------------------------------------------------- /Mixer/Strip: /Mixer/Strip/Name Argument 1: 'i': Strip number (optional, -1 meaning currently selected Strip, must be set if following arguments present) Argument 2: 's': Strip Name Action: Rename a Strip /Mixer/Strip/Hide Argument 1: 'i': Strip number (optional, -1 meaning currently selected Strip, must be set if following arguments present) Argument 2: 'i': 1 = Hide, 0 = Show, -1 = Toggle current state (optional, missing means Toggle current state) Action: Show/Hide a Strip /Mixer/Strip/Collapse Argument 1: 'i': Strip number (optional, -1 meaning currently selected Strip, must be set if following arguments present) Argument 2: 'i': 1 = Collapse, 0 = Expand, -1 = Toggle current state (optional, missing means Toggle current state) Action: Collapse/Expand a Strip /Mixer/Strip/Solo Argument 1: 'i': Strip number (optional, -1 meaning currently selected Strip, must be set if following arguments present) Argument 2: 'i': 1 = Solo, 0 = Unsolo, -1 = Toggle current state (optional, missing means Toggle current state) Action: Solo/Unsolo a Strip /Mixer/Strip/Mute Argument 1: 'i': Strip number (optional, -1 meaning currently selected Strip, must be set if following arguments present) Argument 2: 'i': 1 = Mute, 0 = Unmute, -1 = Toggle current state (optional, missing means Toggle current state) Action: Mute/Unmute a Strip /Mixer/Strip/Phase Argument 1: 'i': Strip number (optional, -1 meaning currently selected Strip, must be set if following arguments present) Argument 2: 'i': 1 = Phase Invert, 0 = Phase Normal, -1 = Toggle current state (optional, missing means Toggle current state) Action: Phase Invert a Strip /Mixer/Strip/Phase2 Argument 1: 'i': Strip number (optional, -1 meaning currently selected Strip, must be set if following arguments present) Argument 2: 'i': 1 = Phase Invert, 0 = Phase Normal, -1 = Toggle current state (optional, missing means Toggle current state) Action: Phase Invert right channel of a stereo Strip /Mixer/Strip/Gain Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'f': Fader Gain in dB Action: Set a Strip Fader Gain --------------------------------------------------------------------------------------- /Mixer/Strip/Panning: /Mixer/Strip/Panning/xyz Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'f': X (panner mapping and values range defined in Ovation Settings) Argument 3: 'f': Y (panner mapping and values range defined in Ovation Settings) Argument 4: 'f': Z (panner mapping and values range defined in Ovation Settings) Argument 5: 'i': Panner number (optional, -1 meaning first or only panner) Action: Set a Strip Panner position in XYZ coordinates /Mixer/Strip/Panning/x Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'f': X (panner mapping and values range defined in Ovation Settings) Argument 5: 'i': Panner number (optional, -1 meaning first or only panner) Action: Set a Strip Panner position in X coordinates /Mixer/Strip/Panning/y Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 3: 'f': Y (panner mapping and values range defined in Ovation Settings) Argument 5: 'i': Panner number (optional, -1 meaning first or only panner) Action: Set a Strip Panner position in Y coordinates /Mixer/Strip/Panning/z Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 4: 'f': Z (panner mapping and values range defined in Ovation Settings) Argument 5: 'i': Panner number (optional, -1 meaning first or only panner) Action: Set a Strip Panner position in Z coordinates /Mixer/Strip/Panning/aed (not implemented yet) Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'f': Azimuth (panner mapping and values range defined in Ovation Settings) Argument 3: 'f': Elevation (panner mapping and values range defined in Ovation Settings) Argument 4: 'f': Distance (panner mapping and values range defined in Ovation Settings) Argument 5: 'i': Panner number (optional, -1 meaning first or only panner) Action: Set a Strip Panner position in AED coordinates /Mixer/Strip/Panning/div Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'f': Divergence between [0..1] Argument 3: 'i': Panner number (optional, -1 meaning first or only panner) Action: Set a Strip Panner Divergence /Mixer/Strip/Panning/lfe Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'f': LFE Gain in dB Argument 3: 'i': Panner number (optional, -1 meaning first or only panner) Action: Set a Strip Panner LFE /Mixer/Strip/Panning/lfe2 Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'f': LFE2 Gain in dB Argument 3: 'i': Panner number (optional, -1 meaning first or only panner) Action: Set a Strip Panner LFE2 --------------------------------------------------------------------------------------- /Mixer/Strip/Panning (only for stereo strips in dual pan mode): /Mixer/Strip/Panning/xyz2 Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'f': X (panner mapping and values range defined in Ovation Settings) Argument 3: 'f': Y (panner mapping and values range defined in Ovation Settings) Argument 4: 'f': Z (panner mapping and values range defined in Ovation Settings) Argument 5: 'i': Panner number (optional, -1 meaning first or only panner) Action: Set a Strip Panner position for the Right Channel in XYZ coordinates /Mixer/Strip/Panning/x2 Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'f': X (panner mapping and values range defined in Ovation Settings) Argument 5: 'i': Panner number (optional, -1 meaning first or only panner) Action: Set a Strip Panner position in X coordinates /Mixer/Strip/Panning/y2 Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 3: 'f': Y (panner mapping and values range defined in Ovation Settings) Argument 5: 'i': Panner number (optional, -1 meaning first or only panner) Action: Set a Strip Panner position in Y coordinates /Mixer/Strip/Panning/z2 Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 4: 'f': Z (panner mapping and values range defined in Ovation Settings) Argument 5: 'i': Panner number (optional, -1 meaning first or only panner) Action: Set a Strip Panner position in Z coordinates /Mixer/Strip/Panning/aed2 (not implemented yet) Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'f': Azimuth (panner mapping and values range defined in Ovation Settings) Argument 3: 'f': Elevation (panner mapping and values range defined in Ovation Settings) Argument 4: 'f': Distance (panner mapping and values range defined in Ovation Settings) Argument 5: 'i': Panner number (optional, -1 meaning first or only panner) Action: Set a Strip Panner position for the Right Channel in AED coordinates /Mixer/Strip/Panning/div2 Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'f': Divergence between [0..1] Argument 3: 'i': Panner number (optional, -1 meaning first or only panner) Action: Set a Strip Panner Divergence for the Right Channel --------------------------------------------------------------------------------------- /Mixer/Strip/Panning (only for stereo strips in single pan mode): /Mixer/Strip/Panning/yaw Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'f': Yaw (panner mapping and values range defined in Ovation Settings) Argument 3: 'i': Panner number (optional, -1 meaning first or only panner) Action: Set a Strip Panner Yaw /Mixer/Strip/Panning/pitch Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'f': Pitch (panner mapping and values range defined in Ovation Settings) Argument 3: 'i': Panner number (optional, -1 meaning first or only panner) Action: Set a Strip Panner Pitch /Mixer/Strip/Panning/roll Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'f': Roll (panner mapping and values range defined in Ovation Settings) Argument 3: 'i': Panner number (optional, -1 meaning first or only panner) Action: Set a Strip Panner Roll /Mixer/Strip/Panning/size Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'f': Size (panner mapping and values range defined in Ovation Settings) Argument 3: 'i': Panner number (optional, -1 meaning first or only panner) Action: Set a Strip Panner Source Size --------------------------------------------------------------------------------------- /Mixer/Strip/FX: /Mixer/Strip/FX/On Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'i': Effect number Argument 3: 'i': 1 = On, 0 = Off, -1 = Toggle current state (optional, missing means Toggle current state) Action: Enable/Disable a VS3 Effect /Mixer/Strip/FX/Bypass Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'i': Effect number Argument 3: 'i': 1 = Bypass, 0 = No Bypass, -1 = Toggle current state (optional, missing means Toggle current state) Action: Bypass a VS3 Effect --------------------------------------------------------------------------------------- /Mixer/Strip/VST: /Mixer/Strip/VST/On Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'i': Effect number Argument 3: 'i': 1 = On, 0 = Off, -1 = Toggle current state (optional, missing means Toggle current state) Action: Enable/Disable a VST Effect /Mixer/Strip/VST/Bypass Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'i': Effect number Argument 3: 'i': 1 = Bypass, 0 = No Bypass, -1 = Toggle current state (optional, missing means Toggle current state) Action: Bypass a VST Effect --------------------------------------------------------------------------------------- /Mixer/Strip/Send: /Mixer/Strip/Send/On Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'i': Bus number (-1 meaning currently selected Bus) Argument 3: 'i': 1 = On, 0 = Off, -1 = Toggle current state (optional, missing means Toggle current state) Action: Send a Strip to a Bus or Group --------------------------------------------------------------------------------------- /Mixer/Strip/Send (only for Aux Bus and Aux Groups): /Mixer/Strip/Send/Gain Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'i': Bus number (-1 meaning currently selected Bus) Argument 3: 'f': Send Gain in dB Action: Set a Strip's Send Gain to an Aux Bus or Group /Mixer/Strip/Send/PF Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'i': Bus number (-1 meaning currently selected Bus) Argument 3: 'i': 1 = Pre Fader, 0 = Post Fader, -1 = Toggle current state (optional, missing means Toggle current state) Action: Set a Strip's Send to an Aux Bus or Group to Pre Fader --------------------------------------------------------------------------------------- /Mixer/Strip/Automation: /Mixer/Strip/Automation/Mode Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'i': 0 = Touch, 1 = Latch, 2 = Trim Touch, 3 = Trim Latch, 4 = Record, 5 = Read, 6 = Isolate Action: Set Strip Automation Mode /Mixer/Strip/Automation/ReleaseMode Argument 1: 'i': Strip number (-1 meaning currently selected Strip) Argument 2: 'i': 0 = Release, 1 = Sanp, 2 = Write to Next, 3 = Write to End Action: Set Strip Automation Release Mode --------------------------------------------------------------------------------------- /Mixer/Bus: /Mixer/Bus/Hide Argument 1: 'i': Bus number (optional, -1 meaning currently selected Bus, must be set if following arguments present) Argument 2: 'i': 1 = Hide, 0 = Show, -1 = Toggle current state (optional, missing means Toggle current state) Action: Show/Hide a Bus /Mixer/Bus/Collapse Argument 1: 'i': Bus number (optional, -1 meaning currently selected Bus, must be set if following arguments present) Argument 2: 'i': 1 = Collapse, 0 = Expand, -1 = Toggle current state (optional, missing means Toggle current state) Action: Collapse/Expand a Bus --------------------------------------------------------------------------------------- Mixer Status: Same /Mixer/... messages as decribed above will be sent as Mixer status --------------------------------------------------------------------------------------- /CueMapping: /CueMapping/ /CueMapping/ prefix must be present in the field No arguments (Any arguments sent along with the OSC message are ignored)