1. Definition | 2. Functional Requirements | 3. Syntax | 4. Semantics |
1. Definition
.Operator Descriptors are independent of the Venue Specification. They include data pertaining to all identified operators, consoles, or interfaces within the Real and Virtual Environment, including participants’ interactive controls.
2. Functional Requirements
- Audio/DJ console commands for all audio channels:
- Track selection and navigation.
- Volume control
- Audio routing
- Audio effects including spatial positions, directionality, filters, reverb, delay, pitch shift, tremolo.
- VJ console commands for all video channels:
- Video clip or source selection.
- Camera commands for position/orientation, zoom, focus, and aperture.
- Tonality (brightness, contrast, colour, highlight, shadows, gamma) control.
- Video routing.
- Video effects including spatial position, mapping, warping, colour cycling, kaleidoscope, playback speed, etc.
- Show Control/FX commands for all stage and theatre effects:
- From the Real Environment
- Rigging for lighting trusses, backdrops, scrims, talent, etc.
- Stage automation including elevators, curtains, turntable, etc.
- Set pieces containing lights, motors, or other automatable features.
- Pyro including flash pots, flame projectors, air bursts, etc.
- Effects (FX) including fog, snow, haze, bubbles, confetti, cannons, etc.
- Robotic controls including position, orientation, joint motion, grip commands, etc.
- From the Virtual Environment
- Background imagery including skyboxes.
- Scene animation including object motion, mesh deformation, etc.
- Materials including texture and surface properties.
- Fluid, particle, and physics effects including caustics, flames, gravity, collision, fog, snow, haze, bubbles, etc.
- Triggered animations and sequences including fireworks, character animation, scene changes, teleporting, etc.
- Avatar controls including position, orientation, joint motion, grip commands, etc.
- From the Real Environment
- Lighting commands for all light fixtures including:
- From the Real Environment
- Dimming
- Colour
- Gobo/prism selection, rotation direction and rate
- Fixture motion and orientation.
- Beam focus.
- Sequencing, strobing, audio reactivity, etc. of the above commands.
- From the Virtual Environment
- Light source location, orientation, and motion.
- Light source type, colour, and beam shape.
- Projected image selection.
- Sequencing, strobing, and audio reactivity.
- From the Real Environment
3. Syntax
4. Semantics
Label | Size | Description |
Header | N1 Bytes | Header |
– Standard- | 9 Bytes | The characters “CAE-VOD-V” |
– Version | N2 Bytes | Major version – 1 or 2 characters |
– Dot-separator | 1 Byte | The character “.” |
– Subversion | N3 Bytes | Minor version – 1 or 2 characters |
MInstanceID | N4 Bytes | Identifier of M-Instance. |
VEOperatorDescriptorsID | N5 Bytes | Identifier of VEOperatorDescriptors |
SpaceTime | N7 Bytes | Space-Time info of CogState. |
VEOperatorDescriptors | N8 Bytes | |
– AudioDJConsole[] | N9 Bytes | Commands for all audio channels |
– TrackSelection | N10 Bytes | Audio Track IDs |
– VolumeControl | N11 Bytes | Volume level |
– AudioSourceID | N12 Bytes | Destination ID |
– AudioEffects | N13 Bytes | Collection of parameters related to Audio in Track ID. |
– Position | N14 Bytes | Position of Audio Track in 3d space. |
– Filters | N15 Bytes | (low-pass, band-pass, high-pass), Q Factor (number), Frequency (cut-off, center frequency, cut-off) |
– Reverb | N16 Bytes | 1 byte according to RE Venue Specification. |
– Delay | expressed in ms | |
– PitchShift | N17 Bytes | (number of semitones) – number |
– Tremolo | N18 Bytes | (volume and frequency) – two numbers |
– Vibrato | N19 Bytes | (extent in cent – and frequency of oscillation) two numbers |
– VJConsoleCommands[] | N20 Bytes | Commands for all video channels |
– VideoSourceID | N21 Bytes | Video clip ID |
– CameraCommands | N22 Bytes | Position/orientation, zoom, focus, and aperture – 4 numbers |
– Tonality control | N23 Bytes | Brightness, contrast, colour, highlight, shadows, gamma – 6 numbers |
– Video routing | N24 Bytes | Destination ID |
– Video effects | N25 Bytes | Collection of parameters related to Video clip ID. |
– Position | N26 Bytes | Position of video effect |
– Zoom | N27 Bytes | |
– Focus | N28 Bytes | |
– Aperture | N29 Bytes | |
– Tonality | N30 Bytes | |
– Brightness | N31 Bytes | |
– Contrast | N32 Bytes | |
– Colour | N33 Bytes | |
– Highlight | N34 Bytes | |
– Shadows | N35 Bytes | |
– Gamma | N36 Bytes | |
– VideoSourceID | N37 Bytes | |
– VideoEffects | N38 Bytes | |
– Position | N39 Bytes | |
– Mapping | N40 Bytes | |
– Warping | N41 Bytes | |
– ColourCycling | N42 Bytes | |
– Kaleidoscope | N43 Bytes | |
– PlaybackSpeed | N44 Bytes | |
– ShowControlFXCommands | N45 Bytes | |
N46 Bytes | ||
N47 Bytes | ||
N48 Bytes |