| 1. Definition | 2. Functional Requirements | 3. Syntax | 4. Semantics |
1. Definition
Video Console contains the commands issued by an Operator on a video (e.g., VJ) console of the Real or Virtual Environment: the global volume and luminance and, for each video clip or source, its selection, volume, routing, camera commands, tonality control, and effects.
2. Functional Requirements
Video Console may include:
- Global Volume and Global Luminance
- Elements
- Clip selection
- Volume
- Video routing
- Video effects: Point of View, Filters, Video Clip ID, Video Device ID, Camera commands (zoom, focus, aperture), Tonality control (brightness, contrast, colour, highlight, shadows, gamma), Effects control (position, scaling, warping, blend mode, transparency, colour cycling, kaleidoscope, playback speed and control)
3. Syntax
https://schemas.mpai.community/XRV1/V1.0/data/VideoConsole.json
4. Semantics
| Label | Description |
| Header | Video Console Header. Shall have constant value “XRV-VIC-V1.0”. |
| MInstanceID | Identifier of the M-Instance (Virtual Space) associated with this Video Console instance. |
| UEnvironmentID | Identifier of the U-Environment (Real Space) associated with this Video Console instance. |
| VideoConsoleID | Identifier of Video Console. |
| VideoConsoleTime | Simple Time as defined in OSD V1.5. |
| VideoConsoleData | Container of Video Console Data. |
| – MetaverseObject | Metaverse Object as defined in XRV1 V1.0. |
| – GlobalVolume | Global Volume (number). Range: 0 to 100. |
| – GlobalLuminance | Global Luminance (number). Range: 0 to 100. |
| – Elements[] | Array of Elements. |
| – ClipSelection | Clip Selection. |
| – Volume | Volume. Range: 0 to 100. |
| – VideoRouting | Destination ID |
| – VideoEffects | Collection of parameters related to Video clip ID. |
| – PointOfView | Point Of View as defined in OSD V1.5. |
| – Filters | Filter Type (low-pass, band-pass, high-pass), Q Factor (number), Frequency (cut-off, center frequency, cut-off) |
| – VideoClipID | Identifier of Video Clip. |
| – VideoDeviceID | Identifier of Video Device. |
| – CameraCommands | Position/orientation, zoom, focus, and aperture – 4 numbers |
| – PointOfView | Point Of View as defined in OSD V1.5. |
| – Zoom | Zoom (number). Zoom factor. Range: not less than 1. |
| – Focus | Focus (number). Range: 0 to 100. |
| – Aperture | Aperture (number). f-number. Range: 0.7 to 32. |
| – TonalityControl | Brightness, Contrast, Colour, Highlight, Shadows, Gamma – 6 numbers |
| – Brightness | Brightness (number). Range: 0 to 100. |
| – Contrast | Contrast (number). Range: 0 to 100. |
| – Colour | Relative Brightness of each colour components. Range: 0 to 100. |
| – Highlight | Highlight (number). Range: 0 to 100. |
| – Shadows | Shadows (number). Range: 0 to 100. |
| – Gamma | Gamma (number). Range: 0.1 to 10. |
| – VidEffectsControl | Container of Vid Effects Control. |
| – Position | Position of Audio Track in 3d space. |
| – Scaling | 2 numbers (H-V) |
| – H | H (number). Scaling factor (1 = unchanged). Range: greater than 0. |
| – V | V (number). Scaling factor (1 = unchanged). Range: greater than 0. |
| – Warping | ID specified by RE Venue Specification |
| – BlendMode | ID specified by RE Venue Specification |
| – Transparency | % value 0-100 |
| – ColourCycling | (colour range and frequency) two numbers |
| – Range | Range (number). Unit: degrees. Range: 0 to 360. |
| – Frequency | Frequency (number). Unit: Hz. Range: not less than 0 Hz. |
| – Kaleidoscope | ID specified by RE Venue Specification |
| – PlayBackSpeed | Number Factor (1 = normal speed). Range: 0.1 to 10. |
| – PlayBackControl | Play Back Control. |
| DataXMData | MPAI-PTF Data Exchange Metadata providing provenance, authorisation, legal, security, and confidence information associated with this Video Console instance in a trusted data exchange context. |
| DescrMetadata | Human-readable descriptive metadata of the Video Console instance (plain text, max 2048 characters). |
