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 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. Video 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 Console 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.
– AudioConsole[] 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 Filter Type (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
– VideoConsole[] 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
– ShowControl[] 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 For elevators, curtains, turntable. Manufacturer ID and operation ID per RE Venue Specification
  – Set pieces Containing lights and motors per RE Venue Specification and DMX/MIDI
  – Pyro Including flash pots, flame projectors, air bursts. Manufacturer ID and operation ID per RE Venue Specification
  – Effects (FX) Including fog, snow, haze, bubbles, confetti, cannons. Manufacturer ID and operation ID per RE Venue Specification controlled by DMX.
  – Robotic controls Including position, orientation, joint motion, grip commands. Manufacturer ID and operation ID per RE Venue Specification
  – LightingCue Programmed Cue (set of Positions) defined in Associations per RE Venue Specification controlled by DMX.
– LightingConsole Lighting Data
  – ManufacturerID ID of Manufacturer of all Lighting Fixtures.
  – LightingCommands[] Commands for all light fixtures defined in Associations per RE Venue Specification controlled by DMX.
    – FixtureID ID of Fixture
    – Dimming Fixture Brightness Level
    – Colour Relative Brightness of each colour components.
    – Gobo Selection, rotation direction and rotation rate
    – Prism Selection, rotation direction and rotation rate
    – Pan Value for Pan
    – Tilt Value for Tilt
    – Beam focus Value for focus
    – AudioResponse Turn Audio Response on or off (boolean).