| 1. Definition | 2. Functional Requirements | 3. Syntax | 4. Semantics |
1. Definition
Lighting Console contains the commands issued by an Operator on a lighting console of the Real or Virtual Environment: the lighting cue number, the master dimmer and, for each light fixture, its settings.
2. Functional Requirements
Lighting Console may include:
- Lighting Cue Number
- Master Dimmer
- Lighting Commands for each fixture
- Manufacturer ID and Fixture ID
- Fixture Point of View
- Light source
- Dimming
- Colour
- Gobo
- Prism
- Pan and Tilt
- Beam focus
- Audio response
3. Syntax
https://schemas.mpai.community/XRV1/V1.0/data/LightingConsole.json
4. Semantics
| Label | Description |
| Header | Lighting Console Header. Shall have constant value “XRV-LTC-V1.0”. |
| MInstanceID | Identifier of the M-Instance (Virtual Space) associated with this Lighting Console instance. |
| UEnvironmentID | Identifier of the U-Environment (Real Space) associated with this Lighting Console instance. |
| LightingConsoleID | Identifier of Lighting Console. |
| LightingConsoleTime | Time information of Lighting Console expressed using SimpleTime. |
| LightingConsoleSpaceTime | Space-Time of the Lighting Console, as defined in OSD V1.5. |
| LightingCueNumber | Lighting Cue Number (number). Integer. Range: not less than 0. |
| MasterDimmer | Master Dimmer control for all fixtures. Range: 0 to 100 (percent). |
| LightingCommands[] | Commands for all light fixtures defined in Associations per RE Venue Specification controlled by DMX. |
| – MetaverseObject | Metaverse Object as defined in XRV1 V1.0. |
| – ManufacturerID | ID of Manufacturer of all Lighting Fixtures. |
| – FixtureID | ID of Fixture |
| – FixturePoV | Point Of View as defined in OSD V1.5. |
| – LightSource | Light source type, colour, and beam shape |
| – Dimming | Fixture Brightness Level |
| – Colour | Relative Brightness of each colour components. |
| – ComponentID | Identifier of Component. Type: string. |
| – ControlObject | Control Object as defined in XRV1 V1.0. |
| – Gobo | Selection, rotation direction and rotation rate |
| – GoboID | Identifier of Gobo. |
| – Rotation | Rotation. |
| – Direction | Direction (number). Range: -1 (counter-clockwise), 0 (no rotation) or 1 (clockwise). |
| – Rate | Rate (number). Unit: revolutions per minute. Range: not less than 0. |
| – ControlObject | Control Object as defined in XRV1 V1.0. |
| – Prism | Selection, rotation direction and rotation rate |
| – PrismID | Identifier of Gobo. |
| – Rotation | Rotation. |
| – Direction | Direction (number). Range: -1 (counter-clockwise), 0 (no rotation) or 1 (clockwise). |
| – Rate | Rate (number). Unit: revolutions per minute. Range: not less than 0. |
| – ControlObject | Control Object as defined in XRV1 V1.0. |
| – Pan | Value for Pan Unit: degrees. Range: -270 to 270. |
| – Tilt | Value for Tilt Unit: degrees. Range: -135 to 135. |
| – BeamFocus | Value for focus Range: 0 to 100. |
| – AudioResponse | Turn Audio Response on or off (boolean). |
| DataXMData | MPAI-PTF Data Exchange Metadata providing provenance, authorisation, legal, security, and confidence information associated with this Lighting Console instance in a trusted data exchange context. |
| DescrMetadata | Human-readable descriptive metadata of the Lighting Console instance (plain text, max 2048 characters). |