File Format Definition

File Format Definition

Node Definiftions#

The first XML node is always the XML description node: <?xml version="1.0" encoding="UTF-8"?>

GeneralSceneDescription Node#

The second XML node is the mandatory GeneralSceneDescription node. The attributes of this node are listed in Table 2, the children of this node are given in Table 3.

Table 2 — GeneralSceneDescription Node Attributes#

The current version of MVR reflected by this document is 1.6.

Table 3 — GeneralSceneDescription Node Children#

Node Definition: UserData#

General#

This node contains a collection of user data nodes defined and used by provider applications if required. User data should not be expected to be preserved in the workflow of multiple applications importing and exporting the data. The defined UserData Node Children are specified in Table 4.

Node name: UserData

Table 4 — UserData Node Children#

Node Definition: Data#

This node contains a collection of data specified by the provider application. The defined Data Node Attributes are specified in Table 5.

Node name: Data

Table 5 — Data Node Attributes#

Node Definition: Scene#

This node contains information about the scene. The defined Scene Node Children are specified in Table 6.

Node name: Scene

Table 6 — Scene Node Children#

Node Definition: AUXData#

General#

This node contains auxiliary data for the scene node. The defined AUXData Node Children are specified in Table 7.

Node name: AUXData

Table 7 — AUXData Node Children#

Node Definition: Symdef#

This node contains the graphics so the scene can refer to this, thus optimizing repetition of the geometry. The child objects are located within a local coordinate system. The defined Symdef Node Attributes are specified in Table 8.

Node name: Symdef

Table 8 — Symdef Node Attributes#

The Symdef node (Table 9) contains the following children.

Table 9 — Symdef Node Children#

The child list (Table 10) contains a list of the following nodes:

Table 10 — Symdef Childlist Node Children#

Node Definition: Position#

This node defines a logical grouping of lighting devices and trusses. The defined Position Node Attributes are specified in Table 11.

Node name: Position

Table 11 — Position Node Attributes#

Node Definition: MappingDefinition#

This node specifies an input source for fixture color mapping applications. The defined MappingDefinition Node Attributes are specified in Table 12.

Node name: MappingDefinition

Table 12 — MappingDefinition Node Attributes#

The child list (Table 13) contains a list of the following nodes:

Table 13 — MappingDefinition Node Children#

<MappingDefinition name="MappingStyle for View 1" uuid="BEF95EB8-98AC-4217-B10D-FB4B83381398">
    <SizeX>1920</SizeX>
    <SizeY>1080</SizeY>
   movie.mov
    
    <ScaleHandeling>UpScale</ScaleHandeling>
</MappingDefinition>

Node Definition: Class#

This node defines a logical grouping across different layers. Primarily used for controlling object visibility of objects across multiple Layers. The defined Class Node Attributes are specified in Table 14.

Node name: Class

Table 14 — Class Node Attributes#

Node Definition: Layers#

This node defines a list of layers inside the scene. The layer is a container of graphical objects defining a local coordinate system.

Node name: Layers

The child list (Table 15) contains a list of layer nodes:

Table 15 — Layers Node Childs#

Node Definition: Layer#

This node defines a layer. The layer is a spatial representation of a geometric container. The child objects are located inside a local coordinate system. The defined Layer Node Attributes are specified in Table 16.

Node name: Layer

Table 16 — Layer Node Attributes#

The child list (Table 17) contains a list of layer nodes:

Table 17 — Layer Node Childs#

Node Definition: ChildList#

This node defines a list of graphical objects.

Node name: ChildList

The child list (Table 18) contains a list of the following nodes:

Table 18 — ChildList Node Childs#

Node Definition for Parametric Objects#

Node Definition: SceneObject#

This node defines a generic graphical object. The defined SceneObject Node Attributes are specified in Table 19.

Node name: SceneObject

Table 19 — SceneObject Node Attributes#

The child list (Table 20) contains a list of one of the following nodes:

Table 20 — SceneObject Node Childs#

Node Definition: GroupObject#

This node defines logical group of objects. The child objects are located inside a local coordinate system. The defined GroupObject Node Attributes are specified in Table 21.

Node name: GroupObject

Table 21 — GroupObject Node Attributes#

The child list (Table 22) contains a list of one of the following nodes:

Table 22 — GroupObject Node Childs#

Node Definition: FocusPoint#

This node defines a focus point object. The defined FocusPoint Node Attributes are specified in Table 23.

Node name: FocusPoint

Table 23 — FocusPoint Node Attributes#

The child list (Table 24) contains a list of one of the following nodes:

Table 24 — FocusPoint Node Childs#

Node Definition: Fixture#

This node defines an entertainment fixture object. The defined FixtureNode Attributes are specified in Table 25.

Node name: Fixture

Table 25 — Fixture Node Attributes#

The child list (Table 26) contains a list of one of the following nodes:

Table 26 — Fixture Node Childs#

Note: The fixture has no Geometries node as geometry is defined in a GDTF file.

CustomID Types

• 0 Undefined
• 1 Fixture
• 2 Channel
• 4 Houselights
• 5 NonDim
• 6 Media
• 7 Fog
• 8 Effect
• 9 Pyro
• 10 Marker

For further information about the difference between FixtureID and CustomID refer to Annex A.

EXAMPLE An example of a node definition is shown below:

<Fixture name="Robe Robin MMX WashBeam" uuid="8BF13DD7-CBF4-415B-99E4-625FE4D2DAF6">
    <Matrix>{0.158127,-0.987419,0.000000}{0.987419,0.158127,0.000000}{0.000000,0.000000,1.000000}{6020.939200,2838.588955,4978.134459}</Matrix>
    <GDTFSpec>Custom@Robe Robin MMX WashBeam</GDTFSpec>
    <GDTFMode>DMX Mode</GDTFMode>
    <Focus>4A B1 94 62 A6 E3 4C 3B B2 5A D8 09 9F 78 17 0C</Focus>
    <Position>77 BC DE 16 95 A6 47 25 9D 04 16 A0 BD 67 CD 1A</Position>
    <Addresses>
        <Address break="0">45</Address>
        <Network Interface="ethernet_1" IPv4="192.168.11.5" SubnetMask="255.255.0.0" />
        <Network Interface="ethernet_2" IPv6="2001:0db8:85a3:0000:0000:8a2e:0370:7344" />
        <Network Interface="wireless_1" DHCP="on" />
    </Addresses>
    <Protocols>
        <Protocol geometry="NetworkInOut_1" type="Art-Net" />
        <Protocol geometry="NetworkInOut_3" name="NDI 1" type="NDI"/>
    </Protocols>
    <Alignments>
        <Alignment geometry="Beam" up="0,0,1" direction="0,0,-1"/>
    </Alignments>
     <CustomCommands>
        <CustomCommand>Body_Pan,f 50</CustomCommand>
        <CustomCommand>Yoke_Tilt,f 50</CustomCommand>
    </CustomCommands>
    <Overwrites>
            <Overwrite universal="Universal Wheel 1.Universal Wheel Slot 1" target="Wheel 1.Wheel Slot"/>
            <Overwrite universal="Universal Emitter 1" target="Emitter 1" />
            <Overwrite universal="Universal Filter 1" target="Filter 1" />
            <Overwrite universal="Universal Wheel 1.Universal Wheel Slot 2"/>
    </Overwrites>
    <Mappings>
        <Mapping linkedDef="BEF95EB8-98AC-4217-B10D-FB4B83381398">
            <ux>10</ux>
            <uy>10</uy>
            <ox>5</ox>
            <oy>5</oy>
            <rz>45</rz>
        </Mapping>
    </Mappings>
    <Connections>    
      <Connection own="Input" toObject="8BF13DD7-CBF4-415B-99E4-625FE4D2DAF6" other="Output1"/>
      <Connection own="1" toObject="8BF13DD7-CBF4-415B-99E4-625FE4D2DAF6" other="IN"/>
      <Connection own="2" toObject="8BF13DD7-CBF4-415B-99E4-625FE4D2DAF6" other="IN"/>
    </Connections>
    <FixtureID></FixtureID>
    <UnitNumber>0</UnitNumber>
    <Function>Speaker 1</Function>
    <CustomId>0</CustomId>
    <CustomIdType>0</CustomIdType>
    <DMXInvertPan>true</DMXInvertPan>
    <DMXInvertTilt>true</DMXInvertTilt>
    <Color>2.533316,-5.175210,3.699302</Color>
    <Gobo rotation="32.5">image_file_forgobo</Gobo>
    <ChildList>
      <Fixture name="Fancy Attachment to the Beam" uuid="8BF13DD7-CBF4-415B-99E4-625FE4D2DAF5">
        <GDTFSpec>Fancy@Attachment</GDTFSpec>
        <GDTFMode>DMX Mode</GDTFMode>
        <!-->The parent GDTF here is the one from the Robe Robin MMX WashBeam</!-->
        <ChildPosition>Base.Yoke.Head</ChildPosition>
        <!-->The position is now defined based on the ECS from the geometry of parents GDTF including all applied Rotation via DMX or other protocols</!-->
        <Matrix>{0.158127,-0.987419,0.000000}{0.987419,0.158127,0.000000}{0.000000,0.000000,1.000000}{6020.939200,2838.588955,4978.134459}</Matrix>
      </Fixture>
    </ChildList>
</Fixture>

Node Definition: Truss#

This node defines a truss object. The defined Truss Node Attributes are specified in Table 27.

Node name: Truss

Table 27 — Truss Node Attributes#

The child list (Table 28) contains a list of one of the following nodes:

Table 28 — Truss Node Childs#

Node Definition: Support#

This node defines a support object. The defined Support Node Attributes are specified in Table 29.

Node name: Support

Table 29 — Support Node Attributes#

The child list (Table 30) contains a list of one of the following nodes:

Table 30 — Support Node Childs#

Node Definition: VideoScreen#

This node defines a video screen object. The defined VideoScreen Node Attributes are specified in Table 31.

Node name: VideoScreen

Table 31 — VideoScreen Node Attributes#

The child list (Table 32) contains a list of one of the following nodes:

Table 32 — VideoScreen Node Childs#

EXAMPLE An example of a node definition is shown below:

<VideoScreen name="Television" uuid="BEF95EB8-98AC-4217-B10D-FB4B83381398">
    <Matrix>{0.158127,-0.987419,0.000000}{0.987419,0.158127,0.000000}{0.000000,0.000000,1.000000}{6020.939200,2838.588955,4978.134459}</Matrix>
    <GDTFSpec>Generic@TV</GDTFSpec>
    <GDTFMode>DisplayModeWideScreen</GDTFMode>
    <Addresses>
        <Address break="0">45</Address>
    </Addresses>
    <FixtureID>25</FixtureID>
    <UnitNumber>0</UnitNumber>
    <CustomId>0</CustomId>
    <Sources>
    movie.mov
   </Sources>
</Fixture>

Node Definition: Projector#

This node defines a video projector object. The defined Projector Node Attributes are specified in Table 33.

Node name: Projector

Table 33 — Projector Node Attributes#

The child list (Table 34) contains a list of one of the following nodes:

Table 34 — Projector Node Childs#

EXAMPLE An example of a node definition is shown below:

<Projector name="Projector" uuid="BEF95EB8-98AC-4217-B10D-FB4B83381398">
    <Matrix>{0.158127,-0.987419,0.000000}{0.987419,0.158127,0.000000}{0.000000,0.000000,1.000000}{6020.939200,2838.588955,4978.134459}</Matrix>
    <GDTFSpec>Generic@Projector</GDTFSpec>
    <GDTFMode>Projector@ThrowRatio1_7_to_2_2</GDTFMode>
    <Addresses>
        <Address break="0">45</Address>
    </Addresses>
    <FixtureID>25</FixtureID>
    <UnitNumber>0</UnitNumber>
    <CustomId>0</CustomId>
    <Projections>
        <Projection>movie.mov
            
            <ScaleHandeling>UpScale</ScaleHandeling>
        </Projection>
    </Projections>
</Projector> 

Other Node Definition#

Node Definition: Matrix#

This node contains a definition of a transformation matrix:

• Right-handed
• Z-Up
• 1 Distance Unit equals 1 mm

Node name: Matrix

The defined Matrix Node Value Types are specified in Table 35.

Table 35 — Matrix Node Value Types#

Node Definition: Gobo#

This node defines a Gobo. The defined Gobo Node Attributes are specified in Table 36.

Node name: Gobo

Table 36 — Gobo Node Attributes#

The node value is the Gobo used for the fixture. The image resource shall apply to the GDTF standard. Use a FileName to specify.

Node Definition: Sources#

This node defines a group of sources for VideoScreen.

Node name: Sources

The child list (Table 37) contains a list of the following nodes:

Table 37 — Sources Node Children#

The child list contains a list of the following nodes:

Node Definition: Source#

This node defines a Source. The defined Source Node Attributes are specified in Table 38. The defined Source Node Value Types are specified in Table 39.

Node name: Source

Table 38 — Source Node Attributes#

Table 39 — Source Node Value Types#

Node Definition: ScaleHandeling#

This node defines how the MappingDefinition will react if the video source has not the same resolution. The defined ScaleHandeling Node Attributes are specified in Table 40.

Node name: ScaleHandeling

Table 40 — ScaleHandeling Node Attributes#

Figure 1 shows how the scaling should look like.

Figure 1 — ScaleHandeling Node Attributes#

a) ScaleKeepRatio	b) ScaleIgnoreRatio	c) KeepSizeCenter

Node Definition: Geometries#

This node defines a group of graphical objects.

Node name: Geometries

The child list (Table 41) contains a list of the following nodes:

Table 41 — Geometries Node Childs#

Node Definition: Symbol#

This node specified a symbol instance (geometry insert) of the definition geometry defined by a Symdef node. The defined Symbol Node Attributes are specified in Table 42.

Node name: Symbol

Table 42 — Symbol Node Attributes#

The child list (Table 43) contains a list of the following nodes:

Table 43 — Symbol Node Childs#

Node Definition: Geometry3D#

This node provides geometry from another file within the archive. The defined Geometry3D Node Attributes are specified in Table 44.

Node name: Geometry3D

Table 44 — Geometry3D Node Attributes#

The child list (Table 45) contains a list of the following nodes:

Table 45 — Geometry3D Node Childs#

Supported 3D file formats#

The supported 3D file formats are specified in Table 46.

Table 46 — Supported 3D file formats#

All referenced files (e.g. texture images, binary blobs) shall be present in the archive.

All file references (URIs etc) shall be relative to the root of the archive. Absolute URIs and file paths are not permitted.

Node Definition: Projections#

This node defines a group of Projections.

Node name: Projections

The child list (Table 47) contains a list of the following nodes:

Table 47 — Projections Node Children#

Node Definition: Projection#

This node defines a Projection.

Node name: Projection

The child list (Table 48) contains a list of the following nodes:

Table 48 — Projection Node Childs#

Node Definition: Addresses#

This node defines a group of Addresses.

Node name: Addresses

The child list (Table 49) contains a list of the following nodes:

Table 49 — Adresses Node Childs#

Node Definition: Address#

This node defines a DMX address. The defined Address Node Attributes are specified in Table 50.

Node name: Address

Table 50 — Address Node Attributes#

The child list (Table 51) contains a list of the following nodes:

Table 51 — Address Node Children#

Node Definition: Network#

This node defines a network IP-address according to the physical interface. The defined Network Node Attributes are specified in Table 52.

Node name: Network

Table 52 — Network Node Attributes#

Node Definition: Protocols#

This node defines the supported protocols and the used interface.

Node name: Protocols

The child list (Table 53) contains a list of the following nodes:

Table 53 — Protocols Node Childs#

Node Definition: Protocol#

This node defines the protocol used by the instance of this object. The defined Protocol Node Attributes are specified in Table 54.

Node name: Protocol

Table 54 — Protocol Node Attributes#

The following names for the type are predefined:

• RDMNet
• Art-Net
• sACN
• PosiStageNet
• OpenSoundControl
• CITP
• NDI

Any other protocol can be freely defined.

Node Definition: Alignments#

This node defines a group of Alignment.

Node name: Alignments

The child list (Table 55) contains a list of the following nodes:

Table 55 — Alignments Node Childs#

Node Definition: Alignment#

This node defines an alignment for a Beam Geometry inside the linked GDTF. The defined Alignment Node Attributes are specified in Table 56.

Node name: Alignment

Table 56 — Alignment Node Attributes#

Node Definition: CustomCommands#

This node defines a group of CustomCommands.

Node name: CustomCommands

The child list (Table 57) contains a list of the following nodes:

Table 57 — CustomCommands Node Childs#

Node Definition: CustomCommand#

This node defines a custom command for the linked GDTF.

Node name: CustomCommand

The Custom command contains the command that will be executed on the fixture. The definition from the syntax for the command aligns with the DIN SPEC 15800:2022-02, 11.2.1.2.3, Channel Functions, for command based control systems.

With this feature you can also control static properties for fixture that cannot be controlled via DMX.

Node Definition: Overwrites#

This node defines a group of Overwrite.

Node name: Overwrites

The child list (Table 58) contains a list of the following nodes:

Table 58 — Overwrites Node Childs#

Node Definition: Overwrite#

This node defines an overwrite with the Universal.gdtt GDTF template inside the MVR to overwrite Wheel Slots, Emitters and Filters for the fixture. The defined Overwrite Node Attributes are specified in Table 59.

Node name: Overwrite

Table 59 — Overwrtie Node Attributes#

Node Definition: Connections#

This node defines a group of Connection.

Node name: Connections

The child list (Table 60) contains a list of the following nodes:

Table 61 — Connections Node Childs#

Node Definition: Connection#

This nodes defines an connection of two scene object. The connection can be an electrical or data connection. The defined Connection Node Attributes are specified in Table 61.

Node name: Connection

Table 61 — Connection Node Attributes#

Node Definition: Mappings#

This node defines a group of Mappings.

Node name: Mappings

The child list (Table 62) contains a list of the following nodes:

Table 62 — Mappings Node Childs#

It is only allowed to have one Mapping linked to the same Mapping Definition once per Fixture

Node Definition: Mapping#

This node defines a Mapping. The defined Mapping Node Attributes are specified in Table 63.

Node name: Mapping

Table 63 — Mapping Node Attributes#

The child list (Table 64) contains a list of the following nodes:

Table 64 — Mapping Node Childs#

NOTE The transformation will be applied in the following order: – Translation – Rotation