| 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
- Audio console data for all audio channels:
- Track selection
- Volume control
- Audio routing
- Audio effects
- Spatial positions and directionality
- Filters (low-pass, band-pass, high-pass), Q Factor, Frequency.
- Reverb (enumeration of reverb types)
- Delay (ms)
- Pitch shift (number of semitones)
- Tremolo (volume and frequency)
- Vibrato (extent in cent and frequency of oscillation).
- Video console data for all video channels:
- Video clip or source selection.
- Camera commands for position/orientation, zoom, focus, and aperture.
- Tonality (brightness, contrast, colour, highlight, shadows, gamma) control.
- Video routing.
- Video effects
- spatial position,
- mapping,
- warping,
- colour cycling,
- kaleidoscope,
- playback speed, etc.
- Show Control data for all stage and theatre effects:
- Rigging for lighting trusses, backdrops, scrims, talent, etc.
- Stage automation including elevators, curtains, turntable, etc.
- Set pieces containing lights, motors, or other automatable features.
- Pyro including flash pots, flame projectors, air bursts, etc.
- Effects (FX) including fog, snow, haze, bubbles, confetti, cannons, etc.
- Robotic controls including position, orientation, joint motion, grip commands, etc.
- Lighting Console data for all light fixtures including:
- Dimming
- Colour
- Gobo/prism selection, rotation direction and rate
- Fixture motion and orientation.
- Beam focus.
- 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. Shall have constant value “XRV-ROD-V1.0”. |
| MInstanceID | Identifier of M-Instance. |
| UEnvironmentID | Identifier of the U-Environment (Real Space) associated with this RE Operator Descriptors instance. |
| REOperatorDescriptorsID | Identifier of RE Operator Descriptors. |
| REOperatorDescriptorsTime | Time information of RE Operator Descriptors expressed using SimpleTime. |
| REOperatorDescriptors | Set of RE Operator Descriptors. |
| – AudioConsole | Commands for all audio channels |
| – VideoConsole | Commands for all video channels |
| – ShowConsole | Commands for all stage and theatre effects |
| – LightingConsole | Lighting Data |
| DataXMData | MPAI-PTF Data Exchange Metadata providing provenance, authorisation, legal, security, and confidence information associated with this RE Operator Descriptors instance in a trusted data exchange context. |
| DescrMetadata | Human-readable descriptive metadata of the RE Operator Descriptors instance (plain text, max 2048 characters). |