| 1. Definition | 2. Functional Requirements | 3. Syntax | 4. Semantics |
1. Definition
An input to the Environment Description and the Real Experience Generation AIMs defining protocols, data, metadata, and command structures for the specific Real Environment Venue. The RE Venue Specification consists of 3D Model Scene Descriptors that define the physical structure, position, and orientation of fixed objects plus an inventory of 3D Model Objects which do not have a specific position in the Venue. In addition, each object within the 3D Model Scene Descriptors and 3D Model Objects have an associated Annotation that specifies all the information necessary to characterise and send/receive data to/from that object. Annotations are typically application dependent. However, the XRV-LTP specification provides some Annotation examples for typical use including Biometric devices, Lighting Fixtures, MoCap devices, MIDI instruments.
2. Functional Requirements
This includes number, type, placement, and parameters of:
- DMX/RDM Universes and their associated Channel definitions for all Lighting fixtures, Special effects, DJ and VJ consoles, rigging, elevator stages, prop motions, pyro, and miscellaneous sensors.
- Audio sources (e.g., microphones, audio players) and formats.
- Visual sources (e.g., 2D/3D cameras, video servers, and all other video sources) and formats.
- Motion Capture devices (e.g., performer motion and object motion tracking).
- LiDAR sources (e.g. scans of performance and participant areas).
- Biometric sensors from performers and participants.
- Time Code Data formats.
- MIDI devices and their associated Channel definitions.
- App Data from performer and participant devices.
- Controller Data from performer and participant devices.
- Seating chart (Spatial distribution of individual seats).
3. Syntax
4. Semantics
Table 1 provides the semantics of the components of RE Venue Specification.
Table 1 – Semantics of RE Venue Specification
| Label | Description |
| Header | RE Venue Specification Header. Shall have constant value “XRV-RVS-V1.0”. |
| MInstanceID | Identifier of the M-Instance (Virtual Space) associated with this RE Venue Specification instance. |
| UEnvironmentID | Identifier of the U-Environment (Real Space) associated with this RE Venue Specification instance. |
| REVenueSpecificationID | Identifier of RE Venue Specification. |
| REVenueSpecificationTime | Time information of RE Venue Specification expressed using SimpleTime. |
| REVenueSpecificationModel | 3D Model Scene Descriptors as defined in OSD V1.5. |
| RealObjects[] | Array of 3D Model Objects as defined in OSD V1.5. |
| DMXUniverses[] | DMX/RDM Universes and their associated Channel definitions for lighting fixtures, special effects, DJ and VJ consoles, rigging, elevator stages, prop motions, pyro, and miscellaneous sensors. |
| – UniverseID | Identifier (number) of the Universe. |
| – Protocol | DMX or RDM. |
| – Channels[] | Channels of the Universe. |
| – ChannelNumber | Channel number (1 to 512). |
| – ChannelDefinition | What the Channel controls. |
| – FixtureID | Identifier of the fixture or device the Channel controls (optional). |
| MIDIDevices[] | MIDI devices and their associated Channel definitions. |
| – DeviceID | Identifier of the MIDI device. |
| – Channels[] | Channels of the MIDI device. |
| – ChannelNumber | MIDI channel number (1 to 16). |
| – ChannelDefinition | What the Channel controls. |
| SeatingChart[] | Seating chart: the spatial distribution of the individual seats, by Sector and Row. |
| – SectorID | Identifier of the Sector. |
| – Rows[] | Rows of the Sector. |
| – RowID | Identifier of the Row. |
| – Seats[] | Seats of the Row. |
| – SeatID | Identifier of the Seat. |
| – SpatialAttitude | Spatial Attitude of the Seat as defined in OSD V1.5. |
| DataXMData | MPAI-PTF Data Exchange Metadata providing provenance, authorisation, legal, security, and confidence information associated with this RE Venue Specification instance in a trusted data exchange context. |
| DescrMetadata | Human-readable descriptive metadata of the RE Venue Specification instance (plain text, max 2048 characters). |