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

https://schemas.mpai.community/XRV1/V1.0/data/REOperatorDescriptors.json

4. Semantics

Label Description
Header RE Operator Descriptors Header
– Standard-REOperatorDescriptors The characters “XRV-ROD-V”
– Version Major version – 1 or 2 characters
– Dot-separator The character “.”
– Subversion Minor version – 1 or 2 characters
MInstanceID Identifier of M-Instance.
REOperatorDescriptorsID Identifier of RE Operator Descriptors.
SpaceTime  Space-Time info of RE Operator Descriptors.
REOperatorDescriptors Set of RE Operator Descriptors.
– AudioVisualSceneDescriptors Of the scene including the operator.
– Audio/DJ console[] Commands for all audio channels
  – Track selection Audio Track IDs
  – Volume controls Volume level
  – Audio routing Destination ID
  – Audio effects Collection of parameters related to Audio in Track ID.
    – Position Position of Audio Track in 3d space.
    – Filters (low-pass, band-pass, high-pass), Q Factor (number), Frequency (cut-off, center frequency, cut-off)
    – Reverb 1 byte according to RE Venue Specification.
    – Delay expressed in ms
    – Pitch shift (number of semitones) – number
    – Tremolo (volume and frequency) – two numbers
    – Vibrato (extent in cent – and frequency of oscillation) two numbers
– VJ console[] Commands for all video channels
  – VideoClipSourceSelection Video clip ID
  – Camera commands Position/orientation, zoom, focus, and aperture – 4 numbers
  – Tonality control Brightness, contrast, colour, highlight, shadows, gamma – 6 numbers
  – Video routing Destination ID
  – Video effects Collection of parameters related to Video clip ID.
    – spatial position Position of video effect
    – scaling 2 numbers (H-V)
    – warping ID specified by RE Venue Specification
    – blend mode ID specified by RE Venue Specification
    – transparency % value 0-100
    – colour cycling (colour range and frequency) two numbers
    – kaleidoscope ID specified by RE Venue Specification
    – playback speed Number
    – playback controls oneOf play, pause, stop
– Show Control/FX[] commands for all stage and theatre effects
  – Rigging For lighting trusses, backdrops, scrims, talent, etc.; Manufacturer ID and operation ID per RE Venue Specification.
  – Stage automation Including elevators, curtains, turntable. Manufacturer ID and operation ID per RE Venue Specification
  – Set pieces Containing lights, motors, or other automatable features per RE Venue Specification and DMX/MIDI
  – Pyro Including flash pots, flame projectors, air bursts, etc. Manufacturer ID and operation ID per RE Venue Specification
  – Effects (FX) Including fog, snow, haze, bubbles, confetti, cannons, etc. Manufacturer ID and operation ID per RE Venue Specification controlled by DMX.
  – Robotic controls Including position, orientation, joint motion, grip commands, etc. Manufacturer ID and operation ID per RE Venue Specification
– LightingCommands Commands for all light fixtures including
  – Dimming Manufacturer ID and operation ID per RE Venue Specification controlled by DMX
  – Colour Manufacturer ID and operation ID per RE Venue Specification controlled by DMX
  – Gobo/prism Selection, rotation direction and rate Manufacturer ID and operation ID per RE Venue Specification controlled by DMX
  – Fixture Motion and orientation Manufacturer ID and operation ID per RE Venue Specification controlled by DMX
  – Beam focus Manufacturer ID and operation ID per RE Venue Specification controlled by DMX
  – Lighting cue Programmed Cue defined in Associations.