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 Size Description
Header N1 Bytes Header
– Standard-VEOperatorDescriptors 9 Bytes The characters “XRV-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 VE Operator Descriptors
SpaceTime N7 Bytes  Space-Time info of VE Operator Descriptors.
VEOperatorDescriptors N8 Bytes  Set of VE Operator Descriptors
– 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 N17 Bytes Measured in ms.
    – PitchShift N18 Bytes Number of semitones: number.
    – Tremolo N19 Bytes Volume and frequency: two numbers.
    – Vibrato N20 Bytes Extent in cent – and frequency of oscillation: two numbers.
– VJConsoleCommands[] N21 Bytes Commands for all video channels.
  – VideoSourceID N22 Bytes Video clip ID.
  – CameraCommands N23 Bytes Position/orientation, zoom, focus, and aperture: 4 numbers.
  – Tonality control N24 Bytes Brightness, contrast, colour, highlight, shadows, gamma: 6 numbers.
  – Video routing N25 Bytes Destination ID.
  – Video effects N26 Bytes Collection of parameters related to Video clip ID.
    – Position N27 Bytes Position of video effect.
    – Mapping N28 Bytes
    – Warping N29 Bytes ID specified by VE Venue Specification
    – ColourCycling N30 Bytes (colour range and frequency) two numbers
    – Kaleidoscope N31 Bytes ID specified by RE Venue Specification
    – PlaybackSpeed N33 Bytes Number
  – ShowControlFXCommands N34 Bytes Per Metaverse API, defined in Associations
  – Lighting commands N35 Bytes For all light sources including
    – SpatialAttitude N36 Bytes Light source location, orientation, and motion.
    – LightSource N37 Bytes Light source type, colour, and beam shape
    -ProjectedImageSelection N38 Bytes
    – Sequencing N39 Bytes
    – Strobing N40 Bytes
    – AudioReactivity N41 Bytes
    – Additional Descriptors N33 Bytes If accessible via Metaverse API