1. Definition 2. Functional Requirements 3. Syntax 4. Semantics

1. Definition

RE Operator Descriptors include data pertaining to all identified operator consoles or interfaces within the Real  Environment.

2. Functional Requirements

  1. Audio/DJ console commands for all audio channels:
    1. Track selection
    2. Volume control
    3. Audio routing
    4. Audio effects
      1. Spatial positions and directionality
      2. Filters (low-pass, band-pass, high-pass), Q Factor, Frequency.
      3. Reverb (enumeration of reverb types)
      4. Delay (ms)
      5. Pitch shift (number of semitones)
      6. Tremolo (volume and frequency)
      7. Vibrato (extent in cent and frequency of oscillation).
  2. VJ console commands for all video channels:
    1. Video clip or source selection.
    2. Camera commands for position/orientation, zoom, focus, and aperture.
    3. Tonality (brightness, contrast, colour, highlight, shadows, gamma) control.
    4. Video routing.
    5. Video effects
      1. spatial position,
      2. mapping,
      3. warping,
      4. colour cycling,
      5. kaleidoscope,
      6. playback speed, etc.
  3. Show Control/FX commands for all stage and theatre effects:
    1. Rigging for lighting trusses, backdrops, scrims, talent, etc.
    2. Stage automation including elevators, curtains, turntable, etc.
    3. Set pieces containing lights, motors, or other automatable features.
    4. Pyro including flash pots, flame projectors, air bursts, etc.
    5. Effects (FX) including fog, snow, haze, bubbles, confetti, cannons, etc.
    6. Robotic controls including position, orientation, joint motion, grip commands, etc.
  4. Lighting commands for all light fixtures including:
    1. Dimming
    2. Colour
    3. Gobo/prism selection, rotation direction and rate
    4. Fixture motion and orientation.
    5. Beam focus.
    6. Sequencing, strobing, audio reactivity, etc. of the above commands.

3. Syntax

4. Semantics

Label Size Description
Header N1 Bytes RE Operator DescriptorsHeader
– Standard-REOperatorDescriptors 9 Bytes The characters “CAE-ROD-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.
REOperatorDescriptorsID N5 Bytes Identifier of RE Operator Descriptors.
SpaceTime N6 Bytes  Space-Time info of RE Operator Descriptors.
REOperatorDescriptors N7 Bytes
– Audio/DJ console[] N8 Bytes Commands for all audio channels
  – Track selection N9 Bytes Audio Track IDs
  – Volume controls N10 Bytes Volume level
  – Audio routing N11 Bytes Destination ID
  – Audio effects N12 Bytes Collection of parameters related to Audio in Track ID.
    – Position N13 Bytes Position of Audio Track in 3d space.
    – Filters N14 Bytes (low-pass, band-pass, high-pass), Q Factor (number), Frequency (cut-off, center frequency, cut-off)
    – Reverb N15 Bytes 1 byte according to RE Venue Specification.
    – Delay N16 Bytes expressed in ms
    – Pitch shift 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
– VJ console[] N20 Bytes Commands for all video channels
  – VideoClipSourceSelection N21 Bytes Video clip ID
  – Camera commands 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.
    – spatial position N26 Bytes Position of video effect
    – scaling N27 Bytes 2 numbers (H-V)
    – warping N28 Bytes ID specified by RE Venue Specification
    – blend mode N29 Bytes ID specified by RE Venue Specification
    – transparency N30 Bytes % value 0-100
    – colour cycling N31 Bytes (colour range and frequency) two numbers
    – kaleidoscope N32 Bytes ID specified by RE Venue Specification
    – playback speed N33 Bytes number
    – playback controls N34 Bytes oneOf play, pause, stop
– Show Control/FX[] N35 Bytes commands for all stage and theatre effects
  – Rigging N36 Bytes for lighting trusses, backdrops, scrims, talent, etc.; Manufacturer ID and operation ID per RE Venue Specification.
  – Stage automation N37 Bytes including elevators, curtains, turntable. Manufacturer ID and operation ID per RE Venue Specification
  – Set pieces N38 Bytes containing lights, motors, or other automatable features per RE Venue Specification and DMX/MIDI
  – Pyro N39 Bytes including flash pots, flame projectors, air bursts, etc. Manufacturer ID and operation ID per RE Venue Specification
  – Effects (FX) N40 Bytes including fog, snow, haze, bubbles, confetti, cannons, etc. Manufacturer ID and operation ID per RE Venue Specification controlled by DMX.
  – Robotic controls N41 Bytes including position, orientation, joint motion, grip commands, etc. Manufacturer ID and operation ID per RE Venue Specification
– LightingCommands N42 Bytes commands for all light fixtures including
  – Dimming N43 Bytes Manufacturer ID and operation ID per RE Venue Specification controlled by DMX
  – Colour N44 Bytes Manufacturer ID and operation ID per RE Venue Specification controlled by DMX
  – Gobo/prism N45 Bytes selection, rotation direction and rate Manufacturer ID and operation ID per RE Venue Specification controlled by DMX
  – Fixture N46 Bytes motion and orientation Manufacturer ID and operation ID per RE Venue Specification controlled by DMX
  – Beam focus N47 Bytes Manufacturer ID and operation ID per RE Venue Specification controlled by DMX
  – Lighting cue N48 Bytes Programmed Cue defined in Associations.