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

1. Definition

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

2. Functional Requirements

All data below are retrieved via the Metaverse API.

  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 per Metaverse API, defined in the Associations.
  4. Lighting commands for all light sources including:
    1. Light source location, orientation, and motion.
    2. Light source type, colour, and beam shape.
    3. Projected image selection.
    4. Sequencing, strobing, and audio reactivity.
  5. Additional Descriptors if accessible via Metaverse API

3. Syntax

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

4. Semantics

Label Description
Header Header
– Standard-VEOperatorDescriptors The characters “XRV-VOD-V”
– Version Major version – 1 or 2 characters
– Dot-separator The character “.”
– Subversion Minor version – 1 or 2 characters
MInstanceID Identifier of M-Instance.
VEOperatorDescriptorsID Identifier of VE Operator Descriptors
VEOperatorDescriptorsTime  Time info of VE Operator Descriptors.
VEOperatorDescriptors  Set of VE Operator Descriptors
– AudioVisualSceneDescriptors Descriptos of VE Operator’s AV Scene.
– AudioDJConsole[] Commands for all audio channels
  – TrackSelection Audio Track IDs
  – VolumeControl Volume level
  – AudioSourceID Destination ID
  – AudioEffects 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 VE Venue Specification.
    – Delay Measured in ms.
    – PitchShift Number of semitones: number.
    – Tremolo Volume and frequency: two numbers.
    – Vibrato Extent in cent – and frequency of oscillation: two numbers.
– VJConsoleCommands[] Commands for all video channels.
  – VideoSourceID Video clip ID.
  – CameraCommands 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.
    – Position Position of video effect.
    – Mapping
    – Warping ID specified by VE Venue Specification
    – ColourCycling (colour range and frequency) two numbers
    – Kaleidoscope ID specified by RE Venue Specification
    – PlaybackSpeed Number
  – ShowControlFXCommands Per Metaverse API, defined in Associations
  – Lighting commands For all light sources including
    – SpatialAttitude Light source location, orientation, and motion.
    – LightSource Light source type, colour, and beam shape
    -ProjectedImageSelection
    – Sequencing
    – Strobing
    – AudioReactivity
    – Additional Descriptors If accessible via Metaverse API