GDTF File Description

From GDTF Development
Jump to: navigation, search

GDTF Version 0.87


Contents

Definition

To describe the device type, use the uncompressed zip file with the extension "*.gdtf". The archive contains a description.xml file (with the description of the device type and all DMX modes and all firmware revisions of this device) and a resource file. Optionally, a checksum file can be provided for each resource file using the same name but this extension *.checksum.txt. Use UTF-8 to encode the xml file. Folder name should be specified as follows:

<ManufacturerName>@<FixtureTypeName>@<OptionalComment>

Example:

generic@led

Each xml file internally consists of xml nodes. Each node could have attributes and children. Each attribute has a value. If an attribute is not specified in xml, the default value of this attribute will be used. If the xml attribute value is specified as a string, the format of the string will depend on the attribute type. All attribute types are specified in Table 1.

Table 1. Attribute Types
Value Type Format Description
Uint Integer Unsigned integer
Int Integer Signed integer
Hex Integer Number in hexadecimal notation; Default value: 0
Float float Floating point numeric; Separator: “.”
String Literal Text
Name Literal Unique object names;

Valid symbols are: “ %=*+- <>_/:'`0123456789ABCDEFGHIJKLMNO PQRSTUVWXYZabcdefghijklmnopqrstuv wxyz@#()”;

Default value: object type with an index in parent.

Date dd.MM.yyyy

HH:mm::ss

Date and time:

dd – day, MM – month, yyyy – year, HH – hours (24 format), mm – minutes, ss – seconds.

Example: "21.6.2016 11:22:48"

Node Name.Name. Name... Link to an element: “Name” is the value of the attribute “Name” of a defined xml node. The starting point defines each attribute separately.
ColorCIE floatx, floaty, floatY CIE color representation xyY 1931
Matrix {float,float,float,float}

{float,float,float,float}

{float,float,float,float}

{float,float,float,float}

The transformation matrix consists 4 x 4 floats.

Stored in a row-major order. For example, each row of the matrix is stored as a 4- component vector. The mathematical definition of the matrix is in a column-major order. For example, the matrix rotation is stored in the first three columns, and the translation is stored in the 4th column. The metric system consists of the Right- handed Cartesian Coordinates XYZ:

X – from left (-X) to right (+X),

Y – from the outside of the monitor (-Y) to the inside of the monitor (+Y),

Z – from bottom (-Z) to top (+Z). 0,0,0 – center base.

Rotation {float, float, float}

{float, float, float}

{float, float, float}

Rotation matrix, consist of 3*3 floats. Stored as row-major matrix, i.e. each row of the matrix is stored as a 3-component vector.

Mathematical definition of the matrix is column-major, i.e. the matrix rotation is stored in the three columns. Metric system, right-handed Cartesian coordinates XYZ:

X – from left (-X) to right (+X),

Y – from the outside of the monitor (-Y) to the inside of the monitor (+Y),

Z – from the bottom (-Z) to the top (+Z).

Enum Literal Possible values are predefined.
DMXAddress Int,

Alternative format: Universe.Address

Absolute DMX address (size 4 bytes); Alternative format: Universe – integer universe number, starting with 1; Address: address within universe from 1 to 512. Format: integer
DMXValue Uint/n Special type to define DMX value where n is the byte count. The byte count can be individually specified without depending on the resolution of the DMX Channel.

For example: “128/1” – equals value of 32768 in case of a 2 bytes channel and a value of 128 in case of a 1 byte channel.

GUID XX XX XX XX

XX XX XX XX

XX XX XX XX

XX XX XX XX

Unique ID: XX – 2 digits in hexadecimal notation. Example: "70 8B CD 59 9E 14 00 00 C1 52 36 54 9A 84 55 B0".
Resource String Name of the resource file which is in the GDTF folder.

First node is always the xml description node:

<?xml version="1.0" encoding="UTF-8"?>


The second node is the GDTF node. The attribute of this node is the DataVersion:

<GDTF DataVersion="0.1">

DataVersion attribute defines the minimal version of compatibility. Version format is “Major.Minor”, where major and minor is Uint with size 1 byte.

Fixture Type Node

The FixtureType node is the starting point of the description of the fixture type in the xml file. The currently defined attributes of the fixture type are specified in table 2.


Table 2. Fixture Type Attributes
Attribute Name Value Type Description
Name Name Name of the fixture type.
ShortName String Name of the fixture type.
Manufacturer String Short name of the fixture type.
Description String Description of the fixture type.
FixtureTypeID GUID Unique number of the fixture type.
Thumbnail Resource Optional; PNG file name with extension containing thumbnail of fixture type. Maximum resolution of picture: 256 x 256. Default value: empty.
RefFT GUID GUID of the referenced fixture type

Fixture type node children are specified in table 3.


Table 3. Fixture Type Children
Child Node Allowed count Description
AttributeDefinitions 1 This section defines all attributes that are used in the fixture type.
Wheels 0 or 1 Is used to define the color wheel, gobo wheel etc.
PhysicalDescriptions 0 or 1 Contains additional physical descriptions.
Models 0 or 1 Contains models of physically separated parts of the devise.
Geometries 1 Is used to describe physically separated parts of the devise.
DMXModes 1 Contains descriptions of the DMX modes.
Revisions 0 or 1 Is used to describe the history of the fixture type.
FTPresets 0 or 1 Is used to transfer user-defined and fixture type specific presets to other show files.
Protocols 0 or 1 Is used to specify RDM information.

One or more sections could be empty or missing, but the order of section has to be as specified in table 3. Listing 1 shows an example of a simple dimmer fixture type.

<FixtureType Name="Dimmer" Manufacturer="Generic">
    <Geometries>
        <Geometry Name="Body" Model="Lamp"/>
    </Geometries>
    <DMXModes>
        <DMXMode Name="Default" Geometry="Body">
            <DMXChannels>
                <DMXChannel Coarse="1" Highlight="255/1" Geometry="Body">
                    <LogicalChannel Attribute="Dimmer" Master="Grand">
                        <ChannelFunction Attribute="Dimmer" DMXFrom="0/1" />
                    </LogicalChannel>
                </DMXChannel>
            </DMXChannels>
            <Relations />
        </DMXMode>
    </DMXModes>
</FixtureType>
Listing 1. Simple dimmer fixture type

Attribute Definitions

This section is used to define all attributes used by the fixture type. More information on the definitions of attributes can be found in Appendix A. Attribute definitions, describes all currently defined attributes which can be found in Appendix B. The current attribute definition node does not have any attributes (Xml node <AttributeDefinitions>). Children of the attribute definition are specified in table 4.


Table 4. Attribute Definition Children
Xml node Allowed count Description
ActivationGroups 0 or 1 Defines which attributes are to be activated together. For example, Pan and Tilt are in the same activation group.
FeatureGroups 1 This section describes the logical grouping of attributes. For example, Gobo1 and Gobo 2 are grouped in the feature Gobo of the feature group Gobo.
Attributes 1 List of attributes that are used.

Activation Groups

This section is used to define attribute groups which are to be used together. For example, Pan and Tilt attributes. If the device has these attributes in order to control the position, they have to be used together. Defining only one attribute group does not guarantee that the device is directed toward a specified position. The current activation groups node does not have any attributes (Xml node <ActivationGroups>). As children it can have a list of activation group.

Activation Group

This section defines the activation group (Xml node <ActivationGroup>). Currently defined xml attributes of the activation group are specified in table 5.

Table 5. Activation Group Attributes
Attribute Name Value Type Description
Name Name The unique name of the activation group.

The activation group does not have any children.

Feature Groups

This section is used to define the logical grouping of attributes. For example, Pan and Tilt attributes are to be grouped together in the feature PanTilt and in the feature group Position. The feature group Position also contains the feature XYZ. The attributes X, Y, and Z (Xml node <FeatureGroups>) are grouped here. As children the feature groups has a list of feature group.

Feature Group

This section defines the feature group (Xml node <FeatureGroup>). The currently defined xml attributes of the feature group are specified in table 6.

Table 6. Feature Group Attributes
Attribute Name Value Type Description
Name Name The unique name of the feature group.
Pretty String The pretty name of the feature group.

As children the feature group has a list of features.

Feature

This section defines the feature (Xml node <Feature>). The currently defined xml attributes of the feature are specified in table 7.

Table 7. Feature Attributes
Attribute Name Value Type Description
Name Name The unique name of the feature.

The feature does not have any children.

Attributes

This section defines attributes (Xml node <Attributes>). As children the attributes node has a list of attributes.

Attribute

This section defines the attribute (Xml node <Attribute>). The currently defined xml attributes of the attribute are specified in table 8.

Table 8. Xml Attributes of the Attribute Node
Attribute Name Value Type Description
Name Name The unique name of the attribute.
Pretty String The pretty name of the attribute .
ActivationGroup Node Optional link to the activation group. The starting point is the activation groups node.
Feature Node Link to the corresponding feature. The starting point is the feature groups node.
MainAttribute Node Optional link to the main attribute. The starting point is the attribute node.
PhysicalUnit Enum The currently defined unit values are:

“None”, “Percent”, “Length” (m), “Mass” (kg), “Time” (s), “Temperature” (K), “LuminousIntensity”(cd), “Angle” (degree), “Force” (N), “Frequency” (Hz), “Current” (A), “Voltage” (V), “Power” (W), “Energy” (J), “Area” (m2), “Volume” (m3), “Speed” (m/s), “Acceleration” (m/s2), “AngularSpeed” (degree/s), “AngularAccc” (degree/s2), “WaveLength” (nm), “ColorComponent”. Default: “None”.

Color ColorCIE For Color subattributes only.

The attribute does not have any children.

Wheel Collect

This section is used to describe all fixture wheels (color wheel, gobo wheel etc.). It currently does not have any attributes (Xml node <Wheels>). As children wheel collect can have a list of wheels.

Wheel

Each wheel describes a physical wheel of the fixture type. If the real device has wheels you can change, then all wheel configurations have to be described. Wheel has the following xml node: <Wheel>. The currently defined xml attributes of the wheel are specified in table 9.

Table 9. Wheel Attributes
Attribute Name Value Type Description
Name Name The unique name of the wheel

As children wheel have a list of wheel slots.

Wheel Slot

The wheel slot represents the slot on the wheel (Xml node <Slot>). The currently defined xml attributes of the wheel slot are specified in table 10.

Table 10. Wheel Slot Attributes
Attribute Name Value Type Description
Name Name The unique name of the wheel slot
Color ColorCIE Optional; Color of the wheel slot, Default value: {0.3127, 0.3290, 100.0 } (white)
MediaFileName Resource Optional; PNG file name containing image for specific gobos etc. Maximum resolution of picture: 1024 x 256. Default value: empty.

If the wheel slot has a prism, it has to have one or several children called prism facet. Listing 2 shows an example of a simple wheel collect described in xml.

<Wheels>
    <Wheel Name="C1 Select" >
        <Slot Name="open" Color="0.3127, 0.3290, 100.0" />
        <Slot Name="green" Color="0.3, 0.6, 71.52" />
        <Slot Name="red" Color="0.6400, 0.3299, 21.26" />
        <Slot Name="blue" Color="0.1500, 0.0600, 7.22" />
    </Wheel>
</Wheels>
Listing 2. Simple wheel collect
Prism Facet

This section can only be defined for the prism wheel slot and has a description for the prism facet (Xml node <Facet>). The currently defined xml attributes of the prism facet are specified in table 11.

Table 11. Wheel Slot Attributes
Attribute Name Value Type Description
Color ColorCIE Optional; Color of prism facet, Default value: {0.3127, 0.3290, 100.0 } (white)
Rotation Rotation Specify the rotation, translation and scaling for the facet.

The prism facet cannot have any children.

Here you found how the prism definition is working.

Physical Descriptions

This section describes the physical constitution of the device. It currently does not have any attributes (Xml node <PhysicalDescriptions>). Children of Physical Description are specified in table 12.

Table 12. Physical description children
Xml node Allowed count Description
Emitters 0 or 1 Describes device emitters
DMXProfiles 0 or 1 Describes nonlinear correlation between DMX input and physical output of a channel.
CRIs 0 or 1 Describes color rendering with IES TM-30-15 (99 color samples).

Emitter Collect

This section contains descriptions of the emitters. It currently does not have any attributes (Xml node <Emitters>). As children the emitter collect has list of emitters.

Emitter

This section contains the description of the emitter (Xml node <Emitter>). The currently defined xml attributes of the emitter are specified in table 13.

Table 13. Emitter Attributes
Attribute Name Value Type Description
Name Name Name of the emitter
Color ColorCIE Color of the emitter

As children the emitter has a list of measurement points.

Measurement Point

The measurement point is used to define the spectrum collect. The measurement resolution is 1 nm. Xml node for measurement point is <Measurement>. The currently defined xml attributes of the measurement point are specified in table 14.

Table 14. Measurement Point Attributes
Attribute Name Value Type Description
WaveLength Float Wave length (nm)
Energy Float Lighting energy (W/m2/nm)

The measurement point does not have any children.

DMX Profile Collect

This section contains DMX profile descriptions. Currently it does not have any attributes (Xml node <DMXProfiles>). As children DMX profile collect has a list of DMX profiles.

DMX Profile

This section contains DMX profile description (Xml node <DMXProfile>).

Color Rendering Index Collect

This section contains TM-30-15 Fidelity Index (Rf) for 99 color samples. Currently it does not have any attributes (Xml node <CRIs>). As children CRIs has a list of CRI groups.

Color Rendering Index Group

This section contains CRIs for a single color temperature (Xml node <CRIGroup>). The currently defined xml attributes of the CRI group are specified in table 15.

Table 15. CRI Group Attributes
Attribute Name Value Type Description
ColorTemperature Float Color temperature; Default value: 6000; Unit: kelvin
Color Rendering Index

This section contains the CRI for one of the 99 color samples (Xml node <CRI>). The currently defined xml attributes of the measurement point are specified in table table 16.

Table 16. CRI Attributes
Attribute Name Value Type Description
CES Enum Color sample. The defined values are “CES01”, “CES02”, … “CES99”. Default Value “CES01"
ColorTemperature UInt The color rendering index for this sample. Size: 1 byte; Default value: 100

The color rendering index does not have any children.

Model Collect

Each device is to be divided into small parts: body, yoke, head etc. These are called geometries. Each geometry has a separate model description and a physical description. Model collect contains model descriptions of the fixture parts. The model collect currently does not have any attributes (Xml node <Models>). As children model collect has a list of models.

Model

Xml node <Model>. The currently defined xml attributes of the model are specified in table 17.

Table 17. Model Attributes
Attribute Name Value Type Description
Name Name The unique name of the wheel slot
Length Float Unit: meter; Default value: 0
Width Float Unit: meter; Default value: 0
Height Float Unit: meter; Default value: 0
PrimitiveType Enum Type of 3D model; The currently defined values are: “Undefined”, “Cube”, “Cylinder”, “Sphere”, “Base”, “Yoke”, “Head”, “Scanner”, “Conventional”, “Pigtail”;

Default value: “Undefined”

File Resource Option: File name without extension containing description of the model. Use the following as a resource file:
  • 3ds file to provide 3D model. File has to contain a maximum of 300 vertices;
  • STEP file to provide 3D model as a parametric model;
  • .svg file to provide the 2D symbol.

It is possible to add several files with the same name but different formats. Preferable format for the 3D model is 3ds.

If geometry has a connection panel, the position of the connection panel (pig tail position) has to be specified in the corresponding 2D or 3D resource file. The model currently does not have any children.

Draw the device in a hanging position displaying the front view. This means that the pan axis is Z aligned, and the tilt axis is X aligned (The metric system consists of the Right-handed Cartesian Coordinates XYZ: X – from left (-X) to right (+X), Y – from the outside of the monitor (-Y) to the inside of the monitor (+Y), Z – from bottom (-Z) to top (+Z). 0,0,0 – center base. See picture 1.


Models device hanging.png

Picture 1. Device in a hanging position – front view


Draw the mesh of each fixture part around its own suspension point. For example, the zero point of a device does not necessarily have to contain the offset related to the yoke, but it must be centered on its axis of rotation. The offset is defined by the geometry and has to be related to its parent geometry and not to the base. Note: In general, the offsets are mostly negative, because the device is displayed in a hanging position.


Models device offsets.png

Picture 2. Offsets of the parts


In picture 2 the green arrow displays the offset of the yoke related to the base. The magenta arrow displays the offset of the head related to the yoke. The offsets are to be defined by the position matrix of the according Geometry (table 19table 26). It is important that the axis of rotation of each fixture part is exactly where it should be (see picture 3).


Models device rotation.png

Picture 3. Positions of rotation axis


The dimension xml attributes of Model (see table 17) are always used, no matter the scaling and ratio of the 3ds file. The mesh is explicitly scaled to this dimension. The length defines the dimension of the model on the X axis, the width on the Y axis and the height on the Z axis.

The model currently does not have any children.

Geometry Collect

The physical description of the device parts is in the geometry collect. Geometry collect can contain a separate geometry or a tree of geometries. The geometry collect currently does not have any attributes (Xml node <Geometries>). The currently defined children nodes of geometry collect are specified in table 18.

Table 18. Geometry Children Types
Xml node Allowed count Description
Geometry Any General Geometry
Axis Any Geometry with axis
FilterBeam Any Geometry with a beam filter
FilterColor Any Geometry with color filter
FilterGobo Any Geometry with gobo
FilterShaper Any Geometry with shaper
Beam Any Geometry with a light source
GeometryReference Any Reference to already described geometries

General Geometry

It is a basic geometry type without specification (Xml node <Geometry>). The currently defined xml attributes of the geometry are specified in table 19.

Table 19. Geometry Attributes
Attribute Name Value Type Description
Name Name The unique name of geometry.

If geometry represents a conventional, call it Body.

If geometry represents the geometry housing of a moving head, call it Head. The Head of a moving head is usually mounted to the Yoke.

Model Node Link to the corresponding model. The starting point is Models Collect.
Position Matrix Relative position of geometry; Default value: 0

The geometry has the same children types as the geometry collect (see table 18).

Geometry Type Axis

This type of geometry is used to describe device parts which have a rotation axis. For example, yoke (Xml node <Axis>). The currently defined xml attributes of the axis are specified in table 20.

Table 20. Axis Attributes
Attribute Name Value Type Description
Name Name The unique name of the geometry. If axis is a pan axis and the first axis of a moving head, call it “Base”.

Call the following and additional axes “Yoke”.

Model Node Link to the corresponding model. Starting point is Models Collect.
Position Matrix Relative position of geometry; Default value: 0
From Float Starting angle of the rotation; Default value: 0; Unit: degree
To Float End angle of rotation; Default value: 0; Unit: degree
Speed Float Rotation speed; Default value: 0; Unit: degree/s

The axis has the same children types as the geometry collect (see table 18).

Geometry Type Beam Filter

This type of geometry is used to describe device parts which have a beam filter (Xml node <FilterBeam>). The currently defined xml attributes of the beam filter are specified in table 21.

Table 21. Beam Filter Attributes
Attribute Name Value Type Description
Name Name The unique name of geometry. If filter is used to limit the diffusion of light, call it BarnDoor. BarnDoor is usually mounted to a conventional.

If filter is used to describe a device that is used to adjust the diameter of the beam, call it Iris. Iris is usually mounted to a conventional.

Model Node Link to the corresponding model. The starting point is Models Collect.
Position Matrix Relative position of geometry; Default value: 0

The beam has the same children types as the geometry collect (see table 18).

Geometry Type Color Filter

This type of geometry is used to describe device parts which have a color filter (Xml node <FilterColor>). The currently defined xml attributes of the color filter are specified in table 22.

Table 22. Color Filter Attributes
Attribute Name Value Type Description
Name Name The unique name of geometry. If filter is used to describe the filter of a color or a mechanical color changer, call it FilterColor. FilterColor is usually mounted to a conventional.
Model Node Link to the corresponding model. The starting point is Models Collect.
Position Matrix Relative position of geometry; Default value: 0

The color has the same children types as the geometry collect (see table 18).

Geometry Type Gobo Filter

This type of geometry is used to describe device parts which have gobo wheel (Xml node <FilterGobo>). The currently defined xml attributes of the gobo filter are specified in table 23.

Table 23. Gobo Filter Attributes
Attribute Name Value Type Description
Name Name The unique name of geometry. If filter is used to display the filter of a gobo or a mechanical gobo changer, call it FilterGobo. FilterGobo is usually mounted to a conventional.
Model Node Link to the corresponding model. The starting point is Models Collect.
Position Matrix Relative position of geometry; Default value: 0

The color has the same children types as the geometry collect (see table 18).

Geometry Type Shaper Filter

This type of geometry is used to describe device parts which have a shaper (Xml node <FilterShaper>). The currently defined xml attributes of the shaper filter are specified in table 24.

Table 24. Shaper Filter Attributes
Attribute Name Value Type Description
Name Name The unique name of geometry; If filter is used to form the beam to a framed, triangular, or trapezoid shape, call it Shaper. Shaper is usually mounted to a conventional.
Model Node Link to the corresponding model. The starting point is Models Collect.
Position Matrix Relative position of geometry; Default value: 0


The color has the same children types as the geometry collect (see table 18).

Geometry Type Beam

This type of geometry is used to describe device parts which have a light source (Xml node <Beam>). The currently defined xml attributes of the lamp are specified in table 25.

Table 25. Beam Attributes
Attribute Name Value Type Description
Name Name The unique name of geometry.

If geometry represents a self-emitting single light source, call it Pixel. Pixel is usually mounted to the Head or Body.

If geometry represents a number of pixels that are controlled at the same time, call it Array. Array is usually mounted to the Head or Body.

If geometry represents the light source of a moving mirror, call it Mirror. Mirror is usually mounted to the Yoke.

Model Node Link to the corresponding model. The starting point is Models Collect.
Position Matrix Relative position of geometry; Default value: 0
LampType Enum Defines type of the lamp; The currently defined types are: Discharge, Tungsten, Halogen, LED; Default value “Discharge”
PowerConsumption Float Power consumption; Default value: 1000; Unit: watt
LuminousIntensity Float Intensity; Default value: 10000; Unit: lumen
ColorTemperature Float Color temperature; Default value: 6000; Unit: kelvin
BeamAngle Float Beam angle; Default value: 25.0; Unit: degree
FieldAngle Float Field angle; Default value: 25.0; Unit: degree
BeamRadius Float Beam radius on starting point. Default value: 0.05; Unit: meter.
BeamType Enum Beam Type; Specified values: “Wash”, “Spot”, “None”. Default value “Wash”
ColorRenderingIndex Uint The CRI (color rendering index) is a quantitative measure of the ability of the light source showing the object color naturally as it does as daylight reference. Size 1 byte. Default value 100.

The beam has the same children types as the geometry collect (see table 18).

Geometry Type Reference

If the device repeatedly has the same geometries, describe this geometry as the child of the geometry collect once and later use references to it. For example, LED panel with multiple pixels. (Xml node <GeometryReference>). The currently defined xml attributes of reference are specified in table 26.

Table 26. Reference Attributes
Attribute Name Value Type Description
Name Name The unique name of geometry; If filter is used to form the beam to a framed, triangular, or trapezoid shape, call it Shaper. Shaper is usually mounted to a conventional.
Position Matrix Relative position of geometry; Default value: 0
Geometry Node Link to the real geometry. The starting point is geometry collect.

The reference has a list of Breaks as children. The count of the children depends on the number of different breaks in the DMX channels of the referenced geometry. If the referenced geometry, for example, has DMX channels with DMX break 2 and 4, the geometry reference has to have 2 children. The first child with DMX offset for DMX break 2 and the second child for DMX break 4. If one or more of the DMX channels of the referenced geometry have the special value “Overwrite” as a DMX break, the DMX break for those channels and the DMX offsets are defined by the last child of the geometry reference.

Break

This xml node is used to specify the DMX offset for the DMX channel of the referenced geometry (Xml node <Break>). The currently defined xml attributes of the break are specified in table 27.

Table 27. Break Attributes
Attribute Name Value Type Description
DMXOffset DMXAddress DMX offset; Default value:1
DMXBreak Uint This attribute is only important for the last child of the geometry reference and only so if the referenced geometry has a channel with the special value “Overwrite” for the attribute DMXBreak. Size: 1 byte; Default value 1.

Listing 3 shows an example of a geometry collect and the corresponding DMX mode described in xml.

<Geometries>
    <Beam Name="Pixel" Model="Pixel" LampType="LED" PowerConsumption="1" LuminousIntensity=" 100" ColorTemperature="3000" BeamAngle="20" />
    <Geometry Name="Body" Model="Body">
        <GeometryReference Position="{1.000000,0.000000,0.000000,-0.475000}{0.000000,1.000000,0.000000,-0.475000}{0.000000,0.000000,1.000000,-0.040000}{0.000000,0.000000,0.000000,1.000000}" Geometry="Pixel">
            <Break DMXOffset="1" />
        </GeometryReference>
        <GeometryReference Position="{1.000000,0.000000,0.000000,-0.425000}{0.000000,1.000000,0.000000,-0.475000}{0.000000,0.000000,1.000000,-0.040000}{0.000000,0.000000,0.000000,1.000000}" Geometry="Pixel">
            <Break DMXOffset="4" />
        </GeometryReference>
        <GeometryReference Position="{1.000000,0.000000,0.000000,-0.425000}{0.000000,1.000000,0.000000,0.075000}{0.000000,0.000000,1.000000,-0.040000}{0.000000,0.000000,0.000000,1.000000}" Geometry="Pixel">
            <Break DMXBreak="2" DMXOffset="1" />
        </GeometryReference>
        <GeometryReference Position="{1.000000,0.000000,0.000000,-0.425000}{0.000000,1.000000,0.000000,-0.075000}{0.000000,0.000000,1.000000,-0.040000}{0.000000,0.000000,0.000000,1.000000}" Geometry="Pixel">
            <Break DMXBreak="2" DMXOffset="4" />
            </GeometryReference>
        <GeometryReference Position="{1.000000,0.000000,0.000000,-0.475000}{0.000000,1.000000,0.000000,0.325000}{0.000000,0.000000,1.000000,-0.040000}{0.000000,0.000000,0.000000,1.000000}" Geometry="Pixel">
            <Break DMXBreak="3" DMXOffset="1" />
        </GeometryReference>
        <GeometryReference Position="{1.000000,0.000000,0.000000,-0.425000}{0.000000,1.000000,0.000000,0.325000}{0.000000,0.000000,1.000000,-0.040000}{0.000000,0.000000,0.000000,1.000000}" Geometry="Pixel">
            <Break DMXBreak="3" DMXOffset="4" />
        </GeometryReference>
    </Geometry>
</Geometries>
<DMXModes>
    <DMXMode Name="Default" Geometry="Body">
        <DMXChannels>
            <DMXChannel Highlight="255/1" DMXChangeTimeLimit="0" Geometry="Pixel">
                <LogicalChannel Attribute="Dimmer" Master="Grand">
                    <ChannelFunction Attribute="Dimmer" DMXFrom="0/1">
                        <ChannelSet Name="open" DMXFrom="0/1" PhysicalTo="0" />
                        <ChannelSet DMXFrom="1/1" />
                        <ChannelSet Name="closed" DMXFrom="255/1" PhysicalFrom="100" PhysicalTo="100" />
                    </ChannelFunction>
                </LogicalChannel>
            </DMXChannel>
            <DMXChannel DMXBreak="Overwrite" Coarse="1" Default="255/1" Highlight="255/1" Geometry="Pixel">
                <LogicalChannel Attribute="ColorRGB1">
                    <ChannelFunction Attribute="ColorRGB1" DMXFrom="0/1" />
                </LogicalChannel>
            </DMXChannel>
            <DMXChannel DMXBreak="Overwrite" Coarse="2" Default="255/1" Highlight="255/1" Geometry="Pixel">
                <LogicalChannel Attribute="ColorRGB2">
                    <ChannelFunction Attribute="ColorRGB2" DMXFrom="0/1" />
                </LogicalChannel>
            </DMXChannel>
            <DMXChannel DMXBreak="Overwrite" Coarse="3" Default="255/1" Highlight="255/1" Geometry="Pixel">
                <LogicalChannel Attribute="ColorRGB3">
                    <ChannelFunction Attribute="ColorRGB3" DMXFrom="0/1" />
                </LogicalChannel>
            </DMXChannel>
        </DMXChannels>
        <Relations>
            <Relation Name="VirtualDimmer" Master="Pixel_Dimmer" Slave="Pixel_ColorRGB1.ColorRGB1.ColorRGB1 1" Type="Multiply" />
            <Relation Name="VirtualDimmer" Master="Pixel_Dimmer" Slave="Pixel_ColorRGB2.ColorRGB2.ColorRGB2 1" Type="Multiply" />
            <Relation Name="VirtualDimmer" Master="Pixel_Dimmer" Slave="Pixel_ColorRGB3.ColorRGB3.ColorRGB3 1" Type="Multiply" />
        </Relations>
    </DMXMode>
</DMXModes>
Listing 3. Geometry collect with DMX mode

DMX Mode Collect

This section is used to describe all DMX modes of the device. If firmware revisions change a DMX footprint, then such revisions should be specified as new DMX mode. The DMX mode collect currently does not have any attributes (Xml node <DMXModes>). As a child the fixture type DMX mode collect has DMX modes.

DMX Mode

Each DMX mode describes logical part of the device in a specific mode (Xml node <DMXMode>). The currently defined xml attributes of the DMX mode are specified in table 28.

Table 28. DMX Mode Attributes
Attribute Name Value Type Description
Name Name The unique name of the DMX mode
Geometry Node Link to the first geometry in the device; Example: the base. The starting point is Geometry Collect.

DMX mode children are specified in table 29.

Table 29. DMX Mode Children
Xml node Allowed count Description
DMXChannels 1 Description of all DMX channels used in the mode
Relations 0 or 1 Description of relations between channels
FTMacros 0 or 1 Is used to describe macros of the manufacturer.

DMX Channel Collect

This section describes the DMX patch of the device. The DMX channel collect currently does not have any attributes (Xml node <DMXChannels>). As children the DMX channel collect has a list of DMX channels.

DMX Channel

This section describes the DMX channel (Xml node <DMXChannel>). Name of DMX channel cannot be specified and consist of a geometry name and an attribute name with seperator "_". Currently defined xml attributes of the DMX channel are specified in table 30.

Table 30. DMX Channel Attributes
Attribute Name Value Type Description
DMXBreak Int Number of DMX address; Default value: 1; Special value: “Overwrite” – means that this number will be overwritten by Geometry Reference; Size: 4 bytes
Coarse Int Relative patch address of the first DMX slot for a current channel; Special value: “None” –does not have an address; Default value: “None”; Size: 4 bytes
Fine Int Relative patch address of the second DMX slot for a current channel. Special value: “None” – does not have an address. Default value: “None”; Size: 4 bytes
Ultra Int Relative patch address of the third DMX slot for a current channel. Special value: “None” –does not have an address; Default value: “None”; Size: 4 bytes
Uber Int Relative patch address of the fourth DMX slot for a current channel. Special value: “None” –does not have an address; Default value: “None”; Size: 4 bytes
Frequency Enum Frequency; V alues: “60”, “30”, “15”, “Slow1”, “Slow2”, “Slow3”; Default value: “30”; Unit: hertz
Default DMXValue Default value for current channel; Default value: 0
Highlight DMXValue Highlight value for current channel; Special value: “None”. Default value: “None”.
MibFade Float How fast does the device move in black? Default value: 0; Unit: second
DMXChangeTimeLimit Float How fast does the device react to a changing DMX input? Default value: 0; Unit: second
Geometry Node Link to the geometry the current channel has; Starting point: geometry collect

As children the DMX channel has a list of logical channels.

Logical Channel

This section is assigned to the attribute and it roughly defines the function of the channel. For example, the logical channel can be assigned to a Gobo function. As a child it has two channel functions: “select position” and “rotation speed”. All logical channels which are children of the same DMX channel are mutually exclusive. The name of the logical channel cannot be specified and is equal to the attribute name. The xml node of the logical channel is <LogicalChannel>. The currently defined xml attributes of the logical channel are specified in table 31.

Table 31. Logical Channel Attributes
Attribute Name Value Type Description
Attribute Node Link to the attribute; The starting point is the Attribute Collect (see Appendix A).
Snap Enum Is this channel a snap channel? Value: “Yes”, “No”, “On”, “Off”. Default value: “No”
Master Enum Does the current channel function react to the Master? Values: “None”, “Grand”, “Group”; Default value: “None”.

As a child the logical channel has a list of channel function.

Channel Function

This section is assigned to the attribute and it explains the function of the logical channel (Xml node <ChannelFunction>). The currently defined xml attributes of channel function are specified in table 32.

Table 32. Channel Function Attributes
Attribute Name Value Type Description
Name String Unique name; Default value: Name of attribute and number of channel function. Example “Pan 1”.
Attribute Node Link to attribute; Starting point is the attributes node. Default value: “NoFeature”.
OriginalAttribute String The manufacturer ́s original name of the attribute; Default: empty
DMXFrom DMXValue Start DMX value; The end DMX value is calculated as a DMXFrom of the next channel function – 1 or the maximum value of the current logical channel. Default value: "0/1".
PhysicalFrom Float Physical start value; Default value: 0
PhysicalTo Float Physical end value; Default value: 1
RealFade Float Mechanical time in seconds to move from min to max; Default value: 0
Wheel Node Optional link to wheel; Starting point: Wheel Collect
Emitter Node Optional link to emitter in the physical description; Starting point: Emitter Collect
DMXInvert Enum Inverts the DMX values for the range given. For example, DMX Invert can be used to invert the direction of pan or tilt movement or for conversion between subtractive and additive color mixing systems. Values: “Yes”, “No”; Default value “No”
EncoderInvert Enum Encoder invert is a control-specific option. It inverts the assignment between the values that are controlled and the control system. For example, Encoder Invert can be used to adjust the direction of rotation of pan of a moving light to the direction of rotation of an encoder of the control system. Values: “Yes”, “No”; Default value “No”

As children the channel function has list of channel sets.

Channel Set

This section describes the channel sets of the channel function (Xml node <ChannelSet>). The currently defined xml attributes of the channel set are specified in table 33.

Table 33. Channel Set Attributes
Attribute Name Value Type Description
Name String The unique name of the channel set
DMXFrom DMXValue Start DMX value, The end DMX value is calculated as a DMX From of the next channel set – 1 or the maximum value of the current logical channel.; Default value: 0.
PhysicalFrom Float Physical start value; Default value: 0
PhysicalTo Float Physical end value; Default value: 1
WheelSlot Index Int If the channel function has a link to the wheel, a corresponding slot index has to be specified. Size: 4 bytes

The channel set does not have any children.

Relation Collect

This section is used to describe the dependencies between DMX channels and channel functions, such as the mode dependencies, overwrite etc. The relation collect currently does not have any attributes (Xml node <Relations>). As children the relation collect has a list of relations.

Relation

This section describes the relation between the master DMX channel and the slave logical channel (Xml node <Relation>). The currently defined xml attributes of the relations are specified in table 34.

Table 34. Relation Attributes
Attribute Name Value Type Description
Name String The unique name of the relation
Master Node Link to the master DMX channel; Starting point: DMX mode
Slave Node Link to the slave channel function; Starting point: DMX mode
Type Enum Type of the relation; Values: “Mode”, “Multiply”, “Override”
DMXFrom DMXValue Used for the mode relation only; DMX start value; Default value: 0.
DMXTo DMXValue Used for the mode relation only; DMX end value; Default value: 0.

The relation does not have any children. Listing 4 shows an example of a simple DMX mode described in xml (description of the corresponding geometries are in listing 3).

<DMXMode Name="Default" Geometry="Body">
    <DMXChannels>
        <DMXChannel Highlight="255/1" Geometry="Pixel">
            <LogicalChannel Attribute="Dimmer" Master="Grand">
                <ChannelFunction Attribute="Dimmer" DMXFrom="0/1">
                    <ChannelSet Name="open" DMXFrom="0/1" PhysicalTo="0" />
                    <ChannelSet DMXFrom="1/1" />
                    <ChannelSet Name="closed" DMXFrom="255/1" PhysicalFrom="100" PhysicalTo="100" />
                </ChannelFunction>
            </LogicalChannel>
        </DMXChannel>
        <DMXChannel DMXBreak="All" Coarse="1" Highlight="255/1" Geometry="Pixel">
            <LogicalChannel Attribute="ColorRGB1">
                <ChannelFunction Attribute="ColorRGB1" DMXFrom="0/1"/>
            </LogicalChannel>
        </DMXChannel>
        <DMXChannel DMXBreak="All" Coarse="2" Highlight="255/1" Geometry="Pixel">
            <LogicalChannel Attribute="ColorRGB2">
                <ChannelFunction Attribute="ColorRGB2" DMXFrom="0/1"/>
            </LogicalChannel>
        </DMXChannel>
        <DMXChannel DMXBreak="All" Coarse="3" Highlight="255/1" Geometry="Pixel">
            <LogicalChannel Attribute="ColorRGB3">
                <ChannelFunction Attribute="ColorRGB3" DMXFrom="0/1"/>
            </LogicalChannel>
        </DMXChannel>
    </DMXChannels>
    <Relations>
        <Relation Name="VirtualDimmer" Master="Pixel_Dimmer" Slave="Pixel_ColorRGB1.ColorRGB1.ColorRGB1 1" Type="Multiply" />
        <Relation Name="VirtualDimmer" Master="Pixel_Dimmer" Slave="Pixel_ColorRGB2.ColorRGB2.ColorRGB2 1" Type="Multiply" />
        <Relation Name="VirtualDimmer" Master="Pixel_Dimmer" Slave="Pixel_ColorRGB3.ColorRGB3.ColorRGB3 1" Type="Multiply" />
    </Relations>
</DMXMode>
Listing 4. DMX mode with relations

Macro Collect

This section is used to describe macros of the fixture type that were preprogrammed by the manufacturer of the fixture. This information is used for the visualization of macros of the fixture type in the 3D view. It is also used for starting these macros on the lighting console. The macro collect currently does not have any attributes (Xml node <FTMacros>). As children the macro collect has a list of macros.

Macro

This section describes a preprogrammed macro or command (Xml node <FTMacro>). The currently defined xml attributes of the macro are specified in table 35.

Table 35. Macro Attributes
Attribute Name Value Type Description
Name Name The name of the macro.

Macro children are specified in table 36

Table 36. Macro Children
Xml node Allowed Count Description
MacroDMX 0 or 1 Describes DMX values required to start the macro.
MacroVisual 0 or 1 Describes visual effect of the macro.
Macro DMX

This section describes the controlling sequence of DMX values which are sent by a lighting console to start the macro (Xml node <MacroDMX>). As children the macro DMX has a list of DMX Steps.

Macro DMX Step

This section describes a DMX step (Xml node <MacroDMXStep>). The currently defined xml attributes of the macro DMX step are specified in table 37.

Table 37. Macro DMX Step Attributes
Attribute Name Value Type Description
Duration UInt Duration of a step; Default value: 1. Size 1 byte. Unit: DMX frame.

As children the macro DMX step has a list of DMX Value.

DMX Value

This section describes a value for DMX channel (Xml node <MacroDMXValue>). The currently defined xml attributes of the DMX Value are specified in table 38.

Table 38. DMX Value Attributes
Attribute Name Value Type Description
Value DMXValue Value
DMXChannel Node Link to a DMX channel. Starting node DMX Channel Collect.

The DMX value does not have any children.

Macro Visual

This section describes visual effect of the macro (Xml node <MacroVisual>). As children the macro visual has a list of Visual steps

Macro Visual Step

This section describes a visual step (Xml node <MacroVisualStep>). The currently defined xml attributes of the macro DMX step are specified in table 39.

Table 39. Macro Visual Step Attributes
Attribute Name Value Type Description
Duration UInt Duration of a step without the influence of a macro speed channel. Default value: 1; Size 1 byte; Unit: DMX frame.
Fade Float Fade time; Default value: 0.0. Unit: milliseconds.
Delay Float Delay time; Default value: 0.0. Unit: milliseconds.

As children the macro visual step has a list of Visual Value.

Visual Value

This section describes a value for the channel function (Xml node <MacroVisualValue>). The currently defined xml attributes of the Visual Value are specified in table 40.

Table 40. Visual Value Attributes
Attribute Name Value Type Description
Value DMXValue Value
ChannelFunction Node Link to a Channel Function which overwrites this value. Starting node DMX Channel Collect.

The Visual Value does not have any children.

Revision Collect

This section describes the a history of device type. Revision collect currently does not have any attributes (Xml node <Revisions>). As children the revision collect has a list of revisions.

Revision

This section describes one revision of a device type (Xml node Revision>). The currently defined attributes of the revision are specified in table 41.

Table 41. Revision Attributes
Attribute Name Value Type Description
Text String User-defined text for this revision; Default value: empty
Date Date Revision date and time

The revision does not have any children. Listing 5 shows an example of the revision collect described in xml.

<Revisions>
   <Revision Text="Created by Admin " Date="21.3.2018 11:22:48" />
</Revisions>
Listing 5. Simple revision collect

User Preset Collect

This section is used to save fixture type specific presets. It currently does not have any attributes (Xml node FTPresets>). As children the type preset collect has a list of presets.

User Preset

This section has not yet been defined (Xml node <FTPreset>).

Supported Protocol Collect

If the device supports several additional protocols, these protocol specific information have to be specified in this section. The supported protocol collect currently does not have any attributes (Xml node <Protocols>). Children of supported protocol collect are specified in table 42.

Table 42. Supported Protocol Collect Children
XML node Allowed Count Description
RDM 0 or 1 Describes RDM information
Art-Net 0 or 1 Describes Art-Net information
sACN 0 or 1 Describes sACN information
KiNET 0 or 1 Describes KiNET information
PosiStageNet 0 or 1 Describes PosiStageNet information
OpenSoundControl 0 or 1 Describes OpenSoundControl information
CITP 0 or 1 Describes CITP information

RDM Section

If the device supports RDM protocol, this section has to have the corresponding information (Xml node <FTRDM>). The currently defined attributes of the RDM are specified in table 43.

Table 43. RDM Attributes
Attribute Name Value Type Description
ManufacturerID Hex Manufacturer ESTA ID; Size: 2 bytes
DeviceModelID Hex Unique device model ID; Size: 2 bytes
SoftwareVersionIDs {Hex, Hex, ... Hex} Array of software versions IDs; Size of each version: 4 bytes

RDM section children are specified in table 44

Table 44. RDM Attributes
Xml node Allowed count Description
RDMParameters 0 or 1 Description of RDM parameters
RDMNotifications 0 or 1 Description of RDM notifications

Listing 6 shows a simple example of the RDM section with 2 sensors and notification.

        <FTRDM ManufacturedID="ESTA" DeviceModelID="0" SoftwareVersionID="{0}">
            <RDMParameters>
                <RDMParameter Name="SENSOR_DEFINITION" PID="SENSOR_DEFINITION" Type="FixtureType" DataType="DS_NOT_DEFINED" Command="CC_GET" SensorUnit="UNITS_NONE" SensorUnitPrefix="PREFIX_NONE" MinValue="0" MaxValue="0" PDLSize="0" Description="Retrieves the definition of a specific sensor." DescriptionWasRecieved="1">
                    <RDMValue_SENSOR_DEFINITION Type="SENS_POWER" Unit="UNITS_WATT" Prefix="PREFIX_NONE" RangeMinValue="50" RangeMaxValue="3000" NormalMinValue="500" NormalMaxValue="1000" LowesHighestDetectionSupported="False" RecordValueSupported="False" />
                    <RDMValue_SENSOR_DEFINITION Type="SENS_TEMPERATURE" Unit="UNITS_CENTIGRADE" Prefix="PREFIX_NONE" RangeMinValue="10" RangeMaxValue="80" NormalMinValue="20" NormalMaxValue="30" LowesHighestDetectionSupported="False" RecordValueSupported="True" />
                </RDMParameter>
            </RDMParameters>
            <RDMNotifications>
                <RDMAbsentNotification />
                <RDMSensorNotification Name="RDMSensorNotification" SensorOffset="0">
                    <RDMValueSensor ThresholdOperator="Greater" Value="750"/>
                </RDMSensorNotification>
                <RDMSensorNotification Name="RDMSensorNotification" SensorOffset="1">
                    <RDMValueSensor ThresholdOperator="Greater" Value="25"/>
                    <RDMValueSensor ThresholdOperator="Less" Value="15"/>
                </RDMSensorNotification>
            </RDMNotifications>
        </FTRDM>
Listing 6. Simple RDM Section

RDM Parameter Collect

This section contains the description of all parameters that the device provides in response to the “SUPPORTED_PARAMETERS” message. It currently does not have any attributes (Xml node <RDMParameters>). As children the RDM parameter collect has a list of RDM [[#RDM Parameter|parameter].

RDM Parameter

This section represents the RDM parameter (Xml node <RDMParameter>). The currently defined xml attributes of the fixture type RDM parameter are specified in table 45.

Table 45. RDM Parameter Attributes
Attribute Name Value Type Description
Name Name The unique name of the RDM parameter
PID Hex Parameter ID (see Table A-3 RDM specification); Default value: 0. Size: 2 bytes
Type Enum Type of the parameter; Predefined values: “RDM”, “FixtureType”, “Fixture”
DataType Enum Data type of parameter values; Predefined values: “DS_NOT_DEFINED”, “DS_BIT_FIELD”, ”DS_ASCII”, “DS_UNSIGNED_BYTE”, “DS_SIGNED_BYTE”, “DS_UNSIGNED_WORD”, “DS_SIGNED_WORD”, “DS_UNSIGNED_DWORD”, “DS_SIGNED_DWORD”, “DS_MS” (see table A-15 RDM specification ANSI E1.20 - 2010).
Command Enum Command class that supports this parameter; Predefined values: “None”, “CC_GET”, “CC_SET”, “CC_GET_SET” (see table A-16 RDM specification ANSI E1.20 - 2010).
SensorUnit Enum It defines the SI unit (International System of Units).

Predefined values: “UNITS_NONE”, “UNITS_CENTIGRADE”, “UNITS_VOLTS_DC”, "UNITS_VOLTS_AC_PEAK", "UNITS_VOLTS_AC_RMS", "UNITS_AMPERE_DC", "UNITS_AMPERE_AC_PEAK", "UNITS_AMPERE_AC_RMS", "UNITS_HERTZ", "UNITS_OHM", "UNITS_WATT", "UNITS_KILOGRAM", "UNITS_METERS", "UNITS_METERS_SQUARED", "UNITS_METERS_CUBED", "UNITS_KILOGRAMMES_PER_METER_CUBED", "UNITS_METERS_PER_SECOND", "UNITS_METERS_PER_SECOND_SQUARED", "UNITS_NEWTON", "UNITS_JOULE", "UNITS_PASCAL", "UNITS_SECOND", "UNITS_DEGREE", "UNITS_STERADIAN", "UNITS_CANDELA", "UNITS_LUMEN", "UNITS_LUX", "UNITS_IRE", "UNITS_BYTE", "UNITS_MS"(see Table A-13 RDM specification ANSI E1.20 - 2010).

SensorUnitPrefix Enum Defines the SI prefix and the multiplication factor of the units.

Predefined values: "PREFIX_NONE", "PREFIX_DECI", "PREFIX_CENTI", "PREFIX_MILLI", "PREFIX_MICRO", "PREFIX_NANO", "PREFIX_PICO", "PREFIX_FEMPTO", "PREFIX_ATTO", "PREFIX_ZEPTO", "PREFIX_YOCTO", "PREFIX_DECA", "PREFIX_HECTO", "PREFIX_KILO", "PREFIX_MEGA", "PREFIX_GIGA", "PREFIX_TERRA", "PREFIX_PETA", "PREFIX_EXA", "PREFIX_ZETTA", "PREFIX_YOTTA"(see Table A-14 RDM specification ANSI E 1.20 - 2010)

MinValue Uint Lowest value; Size: 4 bytes
MaxValue Uint Highest value; Size: 4 bytes
PDLSize Uint Defines the number used for the PDL field in all GET_RESPONSE and SET messages associated with this parameter. If the value is DS_ASCII, the PDL size represents the maximum length of a variably sized ASCII string.
Description String Parameter description.

As children the RDM parameter can have a list of RDM parameter values. The currently defined RDM parameter values are specified in table 46.

Table 46. RDM Parameter Values
Xml node Allowed count Description
RDMValueBool Any Bool value
RDMValue_UNSIGNED_BYTE Any Unsigned byte value
RDMValue_SIGNED_BYTE Any Signed byte value
RDMValue_UNSIGNED_WORD Any Unsigned word value
RDMValue_SIGNED_WORD Any Signed word value
RDMValue_UNSIGNED_DWORD Any Unsigned dword value
RDMValue_SIGNED_DWORD Any Signed dword value
RDMValue_ASCII Any String value
RDMValue_DMX_PERSONALITY_ DESCRIPTION Any Represents DMX personality description
RDMValue_SENSOR_DEFINITION Any Describes sensor
RDMValue_SLOT_INFO Any Describes DMX Slot
RDMValue_STATUS_ID_ DESCRIPTION Any Used for the description of the status
RDM Boolean Value

Xml node <RDMValueBool>. The currently defined xml attributes of the RDM Boolean value are specified in table 47.

Table 47. RDM Boolean Value Attributes
Attribute Name Value Type Description
Value Enum Predefined values: “Yes”, “No”.
ThresholdOperator Enum Used only for notification; Predefined values: “Is”, “IsNot”, “Greater”, “Less”

The RDM Boolean value does not have any children.

RDM Unsigned Byte Value

Xml node <RDMValue_UNSIGNED_BYTE>. The currently defined xml attributes of the RDM unsigned byte value are specified in table 48.

Table 48. RDM Unsigned Byte Value Attributes
Attribute Name Value Type Description
Value Uint Unsigned byte value; Size:1 byte
ThresholdOperator Enum Used only for notification; Predefined values: “Is”, “IsNot”, “Greater”, “Less”

The RDM unsigned byte value does not have any children.

RDM Signed Byte Value

Xml node <<RDMValue_SIGNED_BYTE>>. The currently defined xml attributes of the RDM signed byte value are specified in table 49.

Table 49. RDM Signed Byte Value Attributes
Attribute Name Value Type Description
Value Int Unsigned byte value; Size: 1 byte
ThresholdOperator Enum Used for notification only; Predefined values: “Is”, “IsNot”, “Greater”, “Less”

The RDM signed byte value does not have any children.

RDM Unsigned Word Value

Xml node <RDMValue_UNSIGNED_WORD>. The currently defined xml attributes of the RDM signed byte value are specified in table 50.

Table 50. RDM Unsigned Word Value Attributes
Attribute Name Value Type Description
Value Uint Unsigned 2 bytes value
ThresholdOperator Enum Used for notification only; Predefined values: “Is”, “IsNot”, “Greater”, “Less”

The RDM unsigned word value does not have any children.

RDM Signed Word Value

Xml node <RDMValue_SIGNED_WORD>. The currently defined xml attributes of the RDM signed byte value are specified in table 51.

Table 51. RDM Signed Word Value Attributes
Attribute Name Value Type Description
Value Int Signed 2 bytes value
ThresholdOperator Enum Used for notification only. Predefined values: “Is”, “IsNot”, “Greater”, “Less”

The RDM signed word value does not have any children.

RDM Unsigned Dword Value

Xml node <RDMValue_UNSIGNED_DWORD>. The currently defined xml attributes of the RDM signed dword value are specified in table 52.

Table 52. RDM Unsigned Dword Value Attributes
Attribute Name Value Type Description
Value Int Signed 2 bytes value
ThresholdOperator Enum Used for notification only. Predefined values: “Is”, “IsNot”, “Greater”, “Less”

The RDM unsigned dword value does not have any children.

RDM Signed Dword Value

Xml node <RDMValue_SIGNED_DWORD>. The currently defined xml attributes of the RDM signed dword value are specified in table 53.

Table 53. RDM Signed Dword Value Attributes
Attribute Name Value Type Description
Value Int Signed 4 bytes value.
ThresholdOperator Enum Used only for notification. Predefined values: “Is”, “IsNot”, “Greater”, “Less”

The RDM signed dword value does not have any children.

RDM String Value

Xml node <RDMValue_ASCII>. The currently defined xml attributes of the RDM string value are specified in table 54.

Table 54. RDM String Value Attributes
Attribute Name Value Type Description
Value Int Signed 4 bytes value.
ThresholdOperator Enum Used only for notification. Predefined values: “Is”, “IsNot”, “Greater”, “Less”

The RDM string value does not have any children.

RDM DMX Personality Description Value

Xml node <RDMValue_DMX_PERSONALITY_DESCRIPTION>. The currently defined xml attributes of the RDM DMX personality description value are specified in table 55.

Table 55. RDM DMX Personality Description Value Attributes
Attribute Name Value Type Description
FootPrint Uint DMX personality footprint; Size: 2 bytes
Description String Personality description

The RDM DMX personality description value does not have any children.

RDM Sensor Definition Value

Xml node <RDMValue_SENSOR_DEFINITION>. The currently defined xml attributes of the RDM sensor definition value are specified in table 56.

Table 56. RDM Sensor Definition Value Attributes
Attribute Name Value Type Description
Type Enum Defines the type of data that is measured by the sensor. Predefined values: “SENS_TEMPERATURE”,

“SENS_VOLTAGE”, “SENS_CURRENT”, “SENS_FREQUENCY”, “SENS_RESISTANCE”, “SENS_POWER”, “SENS_MASS”, “SENS_LENGTH”, “SENS_AREA”, “SENS_VOLUME”, “SENS_DENSITY”, “SENS_VELOCITY”, “SENS_ACCELERATION”, “SENS_FORCE”, “SENS_ENERGY”, “SENS_PRESSURE”, “SENS_TIME”, “SENS_ANGLE”, “SENS_POSITION_X”, “SENS_POSITION_Y”, “SENS_POSITION_Z”, “SENS_ANGULAR_VELOCITY”, “SENS_LUMINOUS_INTENSITY”, “SENS_LUMINOUS_FLUX”, “SENS_ILLUMINANCE”, “SENS_CHROMINANCE_RED”, “SENS_CHROMINANCE_GREEN”, “SENS_CHROMINANCE_BLUE”, “SENS_CONTACTS”, “SENS_MEMORY”, “SENS_ITEMS”, “SENS_HUMIDITY”, “SENS_COUNTER_16BIT”, “SENS_OTHER”, “SENS_MS” (see table A-12 RDM specification ANSI E1.20 - 2010)

Unit Enum Defines the SI unit of the sensor data. Predefined values are the same as for the SensorUnit attribute of the RDM parameter (see table 6).
Prefix Enum Defines the SI prefix and the multiplication factor of the units. Sensor unit prefix; The predefined values are the same as for SensorUnitPrefix attribute of the RDM parameter (see table 6).
RangeMinValue Int Defines the lowest value the sensor can report. Size: 2 bytes
RangeMaxValue Int Defines the highest value the sensor can report. Size: 2 bytes
NormalMinValue Int Defines the lowest value during which the device is in normal operation. Size: 2 bytes
NormalMaxValue Int Defines the highest value during which the device is in normal operation. Size: 2 bytes
LowesHighestDetectionSupported Enum Predefined values: “Yes”, “No”
RecordValueSupported Enum Predefined values: “Yes”, “No”
Description String Personality description

The RDM sensor definition value does not have any children.

RDM Slot Info Value

Xml node <RDMValue_SLOT_INFO>. The currently defined xml attributes of the RDM slot info value are specified in table 57.

Table 57. RDM Slot Info Value Attributes
Attribute Name Value Type Description
Offset Uint DMX offset for the described slot; Size: 2 bytes
Type Enum Slot type; Predefined values: “ST_PRIMARY”, ”ST_SEC_FINE”, ”ST_SEC_TIMING”, “ST_SEC_SPEED”, “ST_SEC_CONTROL”, “ST_SEC_INDEX”, “ST_SEC_ROTATION”, “ST_SEC_INDEX_ROTATE”, “ST_SEC_UNDEFINED” (see table C-1 RDM specification ANSI E1.20 - 2010).
SlotLabelID Enum The currently available slot IDs are:

“SD_INTENSITY”, “SD_INTENSITY_MASTER”, “SD_PAN”, “SD_TILT”, “SD_COLOR_WHEEL”, “SD_COLOR_SUB_CYAN”, “SD_COLOR_SUB_YELLOW”, “SD_COLOR_SUB_MAGENTA”, “SD_COLOR_ADD_RED”, “SD_COLOR_ADD_GREEN”, “SD_COLOR_ADD_BLUE”, “SD_COLOR_CORRECTION”, “SD_COLOR_SCROLL”, “SD_COLOR_SEMAPHORE”, “SD_COLOR_ADD_AMBER”, “SD_COLOR_ADD_WHITE”, “SD_COLOR_ADD_W ARM_WHITE”, “SD_COLOR_ADD_COOL_WHITE”, “SD_COLOR_SUB_UV”, “SD_COLOR_HUE”, “SD_COLOR_SATURATION”, “SD_STATIC_GOBO_WHEEL”, “SD_ROTO_GOBO_WHEEL”, “SD_PRISM_WHEEL”, “SD_EFFECTS_WHEEL”, “SD_BEAM_SIZE_IRIS”, “SD_EDGE”, “SD_FROST”, “SD_STROBE”, “SD_ZOOM”, “SD_FRAMING_SHUTTER”, “SD_SHUTTER_ROTATE”, “SD_DOUSER”, “SD_BARN_DOOR”, “SD_LAMP_CONTROL”, “SD_FIXTURE_CONTROL”, “SD_FIXTURE_SPEED”, “SD_MACRO”, “SD_POWER_CONTROL”, “SD_FAN_CONTROL”, “SD_HEATER_CONTROL”, “SD_FOUNTAIN_CONTROL”, “SD_UNDEFINED” (see table C-2 RDM specification ANSI E1.20 - 2010. For additional information on the slot go to: http://tsp.esta.org/tsp/working_groups/CP/RDMextras.html).

The RDM slot info value does not have any children.

RDM Status ID Description Value

Xml node <RDMValue_STATUS_ID_DESCRIPTION>. The currently defined xml attributes of RDM status ID description value are specified in table 58.

Table 58. RDM Status ID Description Value Attributes
Attribute Name Value Type Description
StatusID Uint Status ID; Size 2 bytes
Description String Status description

The RDM status ID description value does not have any children.

RDM Notification Collect

If the device supports RDM, this section specifies fixture specific RDM notification. The RDM notification collect currently does not have any attributes (Xml node <RDMNotifications>). RDM notification collect children are specified in table 59

Table 59. RDM Notification Collect Children
Xml node Allowed count Description
RDMAbsentNotification 0 or 1 Absent notification
RDMParameterNotification Any Notification created for specified parameter
RDMSensorNotification Any Notification created for specified sensor
RDM Absent Notification

This notification is used to check the presence of the device (Xml node <RDMNotification>). The RDM Absent notification currently does not have any attributes and does not have any children.

RDM Parameter Notification

This notification is used to check state of specified parameter of the device. Such notifications can only be created for parameters with the type “Fixture” (Xml node <RDMParameterNotification>). The currently defined xml attributes of the RDM parameter notification are specified in table 60.

Table 60. RDM Parameter Notification Attributes
Xml node Allowed count Description
PID Uint Parameter ID; Size: 2 bytes

Parameter DataType defines type of parameter notification value. RDM parameter notification can have one or several those values as children. All possible parameter values are specified in table 61.

Table 61. RDM Parameter Notification Values
Xml node Description
RDMValueBool Used for data type “DS_BIT_FIELD”.
RDMValue_UNSIGNED_BYTE Used for data type “DS_UNSIGNED_BYTE”.
RDMValue_SIGNED_BYTE Used for data type “DS_SIGNED_BYTE”.
RDMValue_UNSIGNED_WORD Used for data type “DS_UNSIGNED_WORD”.
RDMValue_SIGNED_WORD Used for data type “DS_SIGNED_WORD”.
RDMValue_UNSIGNED_DWORD Used for data type “DS_SIGNED_DWORD”.
RDMValue_SIGNED_DWORD Used for data type “DS_SIGNED_DWORD”.
RDMValue_ASCII Used for data type ”DS_ASCII”.
RDMValue_REAL_TIME_CLOCK Used for PID REAL_TIME_CLOCK
RDM Real Time Clock Value

This value is used for notification only and cannot be saved as a fixture type parameter value. Xml node <RDMValue_REAL_TIME_CLOCK>. The currently defined xml attributes of the RDM real time clock value are specified in table 62.

Table 62. RDM Real Time Clock Value Attributes
Attribute Name Value Type Description
Year Uint Size: 2 bytes
Month Uint Size: 1 byte
Day Uint Size: 1 byte
Hours Uint Size: 1 byte
Minute Uint Size: 1 byte
Second Uint Size: 1 byte
ThresholdOperator Enum Predefined values: “Is”, “IsNot”, “Greater”, “Less”

The RDM real time clock value does not have any children.

RDM Sensor Notification

This notification is used to control specific sensors of the device. The currently defined xml attributes of the RDM sensor notification are specified in table 63.

Table 63. RDM Parameter Notification Attributes
Attribute Name Value Type Description
SensorOffset Uint Device type must have an RDM parameter with the PID SENSOR_DEFINITION and this field has to reference to the corresponding sensor definition value. Size: 2 bytes

As children the RDM sensor notification has a list of RDM sensor values.

RDM Sensor Value

This value is used for notification only and cannot be saved as a fixture type parameter value. Xml node <RDMValueSensor>. The currently defined xml attributes of the RDM sensor value are specified in table 64.

Table 64. RDM Parameter Notification Attributes
Attribute Name Value Type Description
Value Uint Sensor value; Size: 2 bytes
Lowest Uint If the lowest sensor value is supported. Size: 2 bytes
Highest Uint If the highest sensor value is supported. Size: 2 bytes
Recorded Uint If the recorded sensor value is supported. Size: 2 bytes
ThresholdOperator Enum Predefined values: “Is”, “IsNot”, “Greater”, “Less”

The RDM sensor value does not have any children.

Art-Net Section

This section has not yet been defined (Xml node <Art-Net>).

Streaming ACN Section

This section has not yet been defined (Xml node <sACN>).

KiNET Section

This section has not yet been defined (Xml node <KiNET>).

Posi Stage Net Section

This section has not yet been defined (Xml node <PosiStageNet>).

Open Sound Control Section

This section has not yet been defined (Xml node <OpenSoundControl>).

CITP Section

This section has not yet been defined (Xml node <CITP>).

Appendix A. Attribute Definitions

To describe the fixture types, use attributes. Attributes define the function. The currently defined attributes are specified in table A1.

Table A1. Structure of Attribute and Subattribute
Description Attribute
Controls the intensity of a fixture. Dimmer
Controls the fixture's sideward movement (horizontal axis). Pan
Controls the fixture's upward and the downward movement (vertical axis). Tilt
Selects the predefined position effects that are built into the fixture. PositionEffect
Controls the speed of the predefined position effects that are built into the fixture. PositionEffectRate
Snaps or smooth fades with timing in running predefined position effects. PositionEffectFade
Defines a fixture’s x-coordinate within an XYZ coordinate system. XYZ_X
Defines a fixture’s y-coordinate within an XYZ coordinate system. XYZ_Y
Defines a fixture‘s z-coordinate within an XYZ coordinate system. XYZ_Z
Selects gobos in the fixture's gobo wheel 1. Gobo1
Controls the speed and direction of the continuous rotation of gobo wheel 1. Gobo1Spin
Control the frequency of the shake of gobo wheel 1. Gobo1Shake
Controls angle of indexed rotation of gobos in gobo wheel 1. Gobo1Pos
Controls the speed and direction of continuous rotation of gobos in gobo wheel 1. Gobo1PosRotation
Selects gobos in the fixture's gobo wheel 2. Gobo2
Controls the speed and direction of the continuous rotation of gobo wheel 2. Gobo2Spin
Control the frequency of the shake of gobo wheel 2. Gobo2Shake
Controls the angle of indexed rotation of gobos in gobo wheel 2. Gobo2Pos
Controls the speed and direction of continuous rotation of gobos in gobo wheel 2. Gobo2PosRotation
Selects gobos in the fixture's gobo wheel 3. Gobo3
Controls the speed and direction of the continuous rotation of gobo wheel 3. Gobo3Spin
Control the frequency of the shake of gobo wheel 3. Gobo3Shake
Controls the angle of indexed rotation of gobos in gobo wheel 3. Gobo3Pos
Controls the speed and direction of the continuous rotation of gobos in gobo wheel 3. Gobo3PosRotation
Inserts a gobo disk into the beam. The disk has the ability to continuously index and rotate. AnimationWheel
Controls the animation disk's index or its rotation speed. AnimationIndexRotate
Controls the animation disk's shaking. AnimationOffset
Selects predefined color effects built into the fixture. ColorEffects
Selects colors in the fixture's color wheel 1. Color1
Controls the speed and direction of the fixture's color wheel 1. Color1Spin
Selects colors in the fixture's color wheel 2. Color2
Controls the speed and direction of the fixture's color wheel 2. Color2Spin
Selects colors in the fixture's color wheel 3. Color3
Controls the speed and direction of the fixture's color wheel 3. Color3Spin
Selects colors in the fixture's color wheel 4. Color4
Controls the speed and direction of the fixture's color wheel 4. Color4Spin
Controls the intensity of the fixture's red emitters or its cyan CMY-mixing feature. ColorRGB1
Controls the intensity of the fixture's green emitters or its magenta CMY-mixing feature. ColorRGB2
Controls the intensity of the fixture's blue emitters or its yellow CMY-mixing feature. ColorRGB3
Controls the intensity of the fixture's amber emitters. ColorRGB4
Controls the intensity of the fixture's white emitters. ColorRGB5
Controls the intensity of the fixture's color emitters. ColorRGB6
Controls the intensity of the fixture's color emitters. ColorRGB7
Controls the intensity of the fixture's color emitters. ColorRGB8
Controls the intensity of the fixture's color emitters. ColorRGB9
Controls the intensity of the fixture's color emitters. ColorRGB10
Controls the intensity of the fixture's color emitters. ColorRGB11
Controls the intensity of the fixture's color emitters. ColorRGB12
Controls the intensity of the fixture's color emitters. ColorRGB13
Controls the intensity of the fixture's color emitters. ColorRGB14
Controls the intensity of the fixture's color emitters. ColorRGB15
Controls the intensity of the fixture's color emitters. ColorRGB16
Selects predefined colors that are programed in the fixture's firmware. ColorMacro
Selects predefined colors that are programed in the fixture's firmware (2). ColorMacro2
Controls the fixture's "Correct to orange" wheel or mixing system. CTO
Controls the fixture's "Correct to color" wheel or mixing system. CTC
Controls the fixture's "Correct to blue" wheel or mixing system. CTB
Controls the fixture's color attribute regarding the hue. HSB_Hue
Controls the fixture's color attribute regarding the saturation. HSB_Saturation
Controls the fixture's color attribute regarding the brightness. HSB_Brightness
Controls the fixture's color attribute regarding the quality. HSB_Quality
Controls the length of a strobe flash. StrobeDuration
Controls the time between strobe flashes. StrobeRate
Controls the fixture´s mechanical or electronical shutter feature. Shutter
Controls the frequency/speed of the fixture´s mechanical or electronical strobe shutter feature. ShutterStrobe
Controls the frequency/speed of the fixture´s mechanical or electronical pulse shutter feature. ShutterStrobePulse
Controls the frequency/speed of the fixture´s mechanical or electronical closing pulse shutter feature. ShutterStrobePulseClose
Controls the frequency/speed of the fixture´s mechanical or electronical opening pulse shutter feature. ShutterStrobePulseOpen
Controls the frequency/speed of the fixture´s mechanical or electronical random strobe shutter feature. ShutterStrobeRandom
Controls the frequency/speed of the fixture´s mechanical or electronical random pulse shutter feature. ShutterStrobeRandomPulse
Controls the frequency/speed of the fixture´s mechanical or electronical random closing pulse shutter feature. ShutterStrobeRandomPulseClose
Controls the frequency/speed of the fixture´s mechanical or electronical random opening pulse shutter feature. ShutterStrobeRandomPulseOpen
Controls the fixture´s mechanical or electronical shutter feature (2). Is used with foreground/background strobe. Shutter2
Controls the frequency/speed of the fixture ́s mechanical or electronical strobe shutter feature (2). Shutter2Strobe
Controls the frequency/speed of the fixture ́s mechanical or electronical pulse shutter feature (2). Shutter2StrobePulse
Controls the frequency/speed of the fixture ́s mechanical or electronical closing pulse shutter feature (2). Shutter2StrobePulse
Controls the frequency/speed of the fixture ́s mechanical or electronical closing pulse shutter feature (2). Shutter2StrobePulseClose
Controls the frequency/speed of the fixture ́s mechanical or electronical opening pulse shutter feature (2). Shutter2StrobePulseOpen
Controls the frequency/speed of the fixture ́s mechanical or electronical random strobe shutter feature (2). Shutter2StrobeRandom
Controls the frequency/speed of the fixture ́s mechanical or electronical random pulse shutter feature (2). Shutter2StrobeRandomPulse
Controls the frequency/speed of the fixture ́s mechanical or electronical random closing pulse shutter feature (2). Shutter2StrobeRandomPulseClose
Controls the frequency/speed of the fixture ́s mechanical or electronical random opening pulse shutter feature (2). Shutter2StrobeRandomPulseOpen
Controls the fixture ´s mechanical or electronical shutter feature (3). Is used with foreground/background strobe. Shutter3
Controls the frequency/speed of the fixture´s mechanical or electronical strobe shutter feature (3). Shutter3Strobe
Controls the frequency/speed of the fixture´s mechanical or electronical pulse shutter feature (3). Shutter3StrobePulse
Controls the frequency/speed of the fixture´s mechanical or electronical closing pulse shutter feature (3). Shutter3StrobePulseClose
Controls the frequency/speed of the fixture´s mechanical or electronical opening pulse shutter feature (3). Shutter3StrobePulseOpen
Controls the frequency/speed of the fixture´s mechanical or electronical random strobe shutter feature (3). Shutter3StrobeRandom
Controls the frequency/speed of the fixture´s mechanical or electronical random pulse shutter feature (3). Shutter3StrobeRandomPulse
Controls the frequency/speed of the fixture´s mechanical or electronical random closing pulse shutter feature (3). Shutter3StrobeRandomPulseClose
Controls the frequency/speed of the fixture´s mechanical or electronical random opening pulse shutter feature (3). Shutter3StrobeRandomPulseOpen
Controls the diameter of the fixture's beam. Iris
Sets speed of the iris’s strobe feature. IrisStrobe
Sets speed of iris‘s closing pulse. IrisPulseClose
Sets speed of iris‘s opening pulse. IrisPulseOpen
The ability to soften the fixture's spot light with a frosted lens. Frost
The ability to soften the fixture's spot light with a frosted lens (2). Frost2
Controls the insertion of fixture ́s prism wheel 1. Refracts the beam into multiple beams of light on wheel 1. Prism
Controls the indexed position of fixture‘s prism on prism wheel 1. PrismPos
Controls the speed and direction of the continuous rotation of the fixture’s prism on prism wheel 1. PrismPosRotation
Controls the insertion of fixture´s prism wheel 2. Refracts the beam into multiple beams of light on wheel 2. Prism2
Controls the indexed position of fixture‘s prism on prism wheel 2. Prism2Pos
Controls the speed and direction of the continuous rotation of the fixture’s prism on prism wheel 2. Prism2PosRotation
Generically predefined macros and effects of a fixture. Effects
Speed of running effects. EffectsRate
Snapping or smooth look of running effects. EffectsFade
Generically predefined macros and effects of a fixture (2). Effects2
Speed of running effects (2). Effects2Rate
Snapping or smooth look of running effects (2). Effects2Fade
Sets offset between running effects and effects 2. EffectsSync
Controls the sharpness of the fixture's spot light. Can blur or sharpen the edge of the spot. Focus
Controls the sharpness of the fixture's spot light. Can blur or sharpen the edge of the spot (2). Focus2
Autofocuses functionality using presets. FocusAdjust
Autofocuses functionality using distance. FocusDistance
Controls the channel of a fixture. Control
Selects different modes of intensity. DimmerMode
Selects different dimmer curves of the fixture. DimmerCurve
Selects fixture's pan mode. Selects between a limited pan range (e.g. -270 to 270) or a continuous pan range. PanMode
Selects fixture's pan mode. Selects between a limited tilt range (e.g. -130 to 130) or a continuous tilt range. TiltMode
Selects the fixture's position mode. PositionModes
Changes control between selecting, indexing, and rotating the gobos of gobowheel1. Gobo1WheelMode
Changes control between selecting, indexing, and rotating the gobos of gobowheel2. Gobo2WheelMode
Changes control between selecting, indexing, and rotating the gobos of gobowheel3. Gobo3WheelMode
Changes control between selecting, indexing, and rotating the animation wheel. AnimationIndexRotateMode
Defines whether the animation wheel takes the shortest distance between two positions. AnimationWheelShortcutMode
Changes control between selecting, continuous selection, half selection, random selection, color spinning, etc. in colors of color wheel 1. Color1Mode
Changes control between selecting, continuous selection, half selection, random selection, color spinning, etc. in colors of color wheel 2. Color2Mode
Changes control between selecting, continuous selection, half selection, random selection, color spinning, etc. in colors of color wheel 3. Color3Mode
Changes control between selecting, continuous selection, half selection, random selection, color spinning, etc. in colors of color wheel 4. Color4Mode
Defines whether the color wheel takes the shortest distance between two colors. ColorWheelShortcutMode
Controls how Cyan is used within the fixture's cyan CMY-mixing feature. CyanMode
Controls how Cyan is used within the fixture's magenta CMY-mixing. MagentaMode
Controls how Cyan is used within the fixture's yellow CMY-mixing feature. YellowMode
Changes control between selecting continuous selection, half selection, random selection, color spinning, etc. in color mixing. ColorMixMode
Changes strobe style - strobe, pulse, random strobe, etc. - of the shutter attribute. StrobeMode
Changes modes of the fixture’s focus - manual or auto- focus. FocusMode
Changes modes of the fixture’s iris - linear, strobe, pulse. IrisMode
Changes mode to control either index or rotation of the beam effects. BeamEffectIndexRotateMode
Movement speed of the fixture's intensity. IntensityMSpeed
Movement speed of the fixture's pan/tilt. PositionMSpeed
Movement speed of the fixture's ColorMix presets. ColorMixMSpeed
Movement speed of the fixture's color wheel. ColorWheelSelectMSpeed
Movement speed of the fixture's gobo wheel. GoboWheelMSpeed
Movement speed of the fixture's iris. IrisMSpeed
Movement speed of the fixture's focus. FocusMSpeed
Movement speed of the fixture's shapers. FrameMSpeed
General speed of fixture's features. GlobalMSpeed
Generally resets the entire fixture. FixtureGlobalReset
Resets the fixture's shutter. ShutterReset
Resets the fixture's beam features. BeamReset
Resets the fixture's color mixing system. ColorMixReset
Resets the fixture's color wheel. ColorWheelReset
Resets the fixture's focus. FocusReset
Resets the fixture's shapers. FrameReset
Resets the fixture's gobo wheel. GoboWheelReset
Resets the fixture's intensity. IntensityReset
Resets the fixture's iris. IrisReset
Resets the fixture's pan/tilt. PositionReset
Resets the fixture's pan. PanReset
Resets the fixture's tilt. TiltReset
Resets the fixture's zoom. ZoomReset
Resets the fixture's CTB. CTBReset
Resets the fixture's CTO. CTOReset
Resets the fixture's CTC. CTCReset
Resets the fixture's calibration. FixtureCalibrationReset
Generally controls features of the fixture. Function
Controls the fixture's lamp on/lamp off feature. LampControl
Ranges without a functionality. NoFeature
Fog or hazer‘s blower feature. Blower
Fog or hazer's Fan feature. Fan
Fog or hazer's Fog feature. Fog
Fog or hazer's haze feature. Haze
Controls the energy consumption of the lamp. LampPowerMode
Fancontrols a fixture or device. Fans
1 of 2 shutters that shape the top of the beam. Blade1A
2 of 2 shutters that shape the top of the beam. Blade1B
1 of 2 shutters that shape the right of the beam. Blade2A
2 of 2 shutters that shape the right of the beam. Blade2B
1 of 2 shutters that shape the bottom of the beam. Blade3A
2 of 2 shutters that shape the bottom of the beam. Blade3B
1 of 2 shutters that shape the left of the beam. Blade4A
2 of 2 shutters that shape the left of the beam. Blade4B
Rotates position of blade1. Blade1Rot
Rotates position of blade2. Blade2Rot
Rotates position of blade3. Blade3Rot
Rotates position of blade4. Blade4Rot
Rotates position of blade assembly. ShaperRot
Predefined presets for shaper positions. ShaperMacros
Controls video features. Video

Appendix B. Attribute Definition

    <AttributeDefinitions >
        <ActivationGroups >
            <ActivationGroup  Name="PanTilt" />
            <ActivationGroup  Name="XYZ" />
            <ActivationGroup  Name="ColorRGB" />
            <ActivationGroup  Name="ColorHSB" />
            <ActivationGroup  Name="Gobo" />
            <ActivationGroup  Name="Prism" />
            <ActivationGroup  Name="Shaper" />
        </ActivationGroups>
        <FeatureGroups >
            <FeatureGroup  Name="Dimmer">
                <Feature  Name="Dimmer" />
            </FeatureGroup>
            <FeatureGroup  Name="Position">
                <Feature  Name="PanTilt" />
                <Feature  Name="XYZ" />
            </FeatureGroup>
            <FeatureGroup  Name="Gobo">
                <Feature  Name="Gobo" />
            </FeatureGroup>
            <FeatureGroup  Name="Color">
                <Feature  Name="Color" />
                <Feature  Name="RGB" />
                <Feature  Name="HSB" />
            </FeatureGroup>
            <FeatureGroup  Name="Beam">
                <Feature  Name="Beam" />
            </FeatureGroup>
            <FeatureGroup  Name="Focus">
                <Feature  Name="Focus" />
            </FeatureGroup>
            <FeatureGroup  Name="Control">
                <Feature  Name="Control" />
            </FeatureGroup>
            <FeatureGroup  Name="Shapers">
                <Feature  Name="Shapers" />
            </FeatureGroup>
            <FeatureGroup  Name="Video">
                <Feature  Name="Video" />
            </FeatureGroup>
        </FeatureGroups>
        <Attributes >
            <Attribute Name="Dimmer" Pretty="Dim" Feature="Dimmer.Dimmer" PhysicalUnit="LuminousIntensity" />
            <Attribute Name="Pan" Pretty="P" ActivationGroup="PanTilt" Feature="Position.PanTilt" PhysicalUnit="Angle" />
            <Attribute Name="Tilt" Pretty="T" ActivationGroup="PanTilt" Feature="Position.PanTilt" PhysicalUnit="Angle" />
            <Attribute Name="PositionEffect" Pretty="Pos FX" Feature="Position.PanTilt" />
            <Attribute Name="PositionEffectRate" Pretty="Pos FX Rate" Feature="Position.PanTilt" />
            <Attribute Name="PositionEffectFade" Pretty="Pos FX Fade" Feature="Position.PanTilt" />
            <Attribute Name="XYZ_X" Pretty="X" ActivationGroup="XYZ" Feature="Position.XYZ" PhysicalUnit="Length" />
            <Attribute Name="XYZ_Y" Pretty="Y" ActivationGroup="XYZ" Feature="Position.XYZ" PhysicalUnit="Length" />
            <Attribute Name="XYZ_Z" Pretty="Z" ActivationGroup="XYZ" Feature="Position.XYZ" PhysicalUnit="Length" />
            <Attribute Name="Gobo1" Pretty="G1" ActivationGroup="Gobo" Feature="Gobo.Gobo" />
            <Attribute Name="Gobo1Spin" Pretty="Spin" MainAttribute="Gobo1" ActivationGroup="Gobo" Feature="Gobo.Gobo" PhysicalUnit="AngularSpeed" />
            <Attribute Name="Gobo1Shake" Pretty="Shake" MainAttribute="Gobo1" ActivationGroup="Gobo" Feature="Gobo.Gobo" PhysicalUnit="Frequency" />
            <Attribute Name="Gobo1Pos" Pretty="G1 &lt;&gt;" Feature="Gobo.Gobo" PhysicalUnit="Angle" />
            <Attribute Name="Gobo1PosRotation" Pretty="Rotate" MainAttribute="Gobo1Pos" Feature="Gobo.Gobo" PhysicalUnit="AngularSpeed" />
            <Attribute Name="Gobo2" Pretty="G2" ActivationGroup="Gobo" Feature="Gobo.Gobo" />
            <Attribute Name="Gobo2Spin" Pretty="Spin" MainAttribute="Gobo2" ActivationGroup="Gobo" Feature="Gobo.Gobo" PhysicalUnit="AngularSpeed" />
            <Attribute Name="Gobo2Shake" Pretty="Shake" MainAttribute="Gobo2" ActivationGroup="Gobo" Feature="Gobo.Gobo" PhysicalUnit="Frequency" />
            <Attribute Name="Gobo2Pos" Pretty="G2 &lt;&gt;" Feature="Gobo.Gobo" PhysicalUnit="Angle" />
            <Attribute Name="Gobo2PosRotation" Pretty="Rotate" MainAttribute="Gobo2Pos" Feature="Gobo.Gobo" PhysicalUnit="AngularSpeed" />
            <Attribute Name="Gobo3" Pretty="G3" ActivationGroup="Gobo" Feature="Gobo.Gobo" />
            <Attribute Name="Gobo3Spin" Pretty="Spin" MainAttribute="Gobo3" ActivationGroup="Gobo" Feature="Gobo.Gobo" PhysicalUnit="AngularSpeed" />
            <Attribute Name="Gobo3Shake" Pretty="Shake" MainAttribute="Gobo3" ActivationGroup="Gobo" Feature="Gobo.Gobo" PhysicalUnit="Frequency" />
            <Attribute Name="Gobo3Pos" Pretty="G3 &lt;&gt;" Feature="Gobo.Gobo" PhysicalUnit="Angle" />
            <Attribute Name="Gobo3PosRotation" Pretty="Rotate" MainAttribute="Gobo3Pos" Feature="Gobo.Gobo" PhysicalUnit="AngularSpeed" />
            <Attribute Name="AnimationWheel" Pretty="Anim" Feature="Gobo.Gobo" />
            <Attribute Name="AnimationIndexRotate" Pretty="Anim &lt;&gt;" Feature="Gobo.Gobo" />
            <Attribute Name="AnimationOffset" Pretty="Anim Offset" Feature="Gobo.Gobo" />
            <Attribute Name="ColorEffects" Pretty="Color FX" Feature="Color.Color" />
            <Attribute Name="Color1" Pretty="C1" ActivationGroup="ColorRGB" Feature="Color.Color" />
            <Attribute Name="Color1Spin" Pretty="Spin" MainAttribute="Color1" ActivationGroup="ColorRGB" Feature="Color.Color" PhysicalUnit="AngularSpeed" />
            <Attribute Name="Color2" Pretty="C2" ActivationGroup="ColorRGB" Feature="Color.Color" />
            <Attribute Name="Color2Spin" Pretty="Spin" MainAttribute="Color2" ActivationGroup="ColorRGB" Feature="Color.Color" PhysicalUnit="AngularSpeed" />
            <Attribute Name="Color3" Pretty="C3" ActivationGroup="ColorRGB" Feature="Color.Color" />
            <Attribute Name="Color3Spin" Pretty="Spin" MainAttribute="Color3" ActivationGroup="ColorRGB" Feature="Color.Color" PhysicalUnit="AngularSpeed" />
            <Attribute Name="Color4" Pretty="C4" ActivationGroup="ColorRGB" Feature="Color.Color" />
            <Attribute Name="Color4Spin" Pretty="Spin" MainAttribute="Color4" ActivationGroup="ColorRGB" Feature="Color.Color" PhysicalUnit="AngularSpeed" />
            <Attribute Name="ColorRGB1" Pretty="R" ActivationGroup="ColorRGB" Feature="Color.RGB" PhysicalUnit="ColorComponent" Color="0.6401,0.33,21.26" />
            <Attribute Name="ColorRGB2" Pretty="G" ActivationGroup="ColorRGB" Feature="Color.RGB" PhysicalUnit="ColorComponent" Color="0.3,0.6,71.52" />
            <Attribute Name="ColorRGB3" Pretty="B" ActivationGroup="ColorRGB" Feature="Color.RGB" PhysicalUnit="ColorComponent" Color="0.15,0.06,7.22" />
            <Attribute Name="ColorRGB4" Pretty="A" ActivationGroup="ColorRGB" Feature="Color.RGB" PhysicalUnit="ColorComponent" Color="0.4732,0.4625,58.5216" />
            <Attribute Name="ColorRGB5" Pretty="W" ActivationGroup="ColorRGB" Feature="Color.RGB" PhysicalUnit="ColorComponent" Color="0.3127,0.3290,100" />
            <Attribute Name="ColorRGB6" Pretty="ColorRGB6" ActivationGroup="ColorRGB" Feature="Color.RGB" PhysicalUnit="ColorComponent" />
            <Attribute Name="ColorRGB7" Pretty="ColorRGB7" ActivationGroup="ColorRGB" Feature="Color.RGB" PhysicalUnit="ColorComponent" />
            <Attribute Name="ColorRGB8" Pretty="ColorRGB8" ActivationGroup="ColorRGB" Feature="Color.RGB" PhysicalUnit="ColorComponent" />
            <Attribute Name="ColorRGB9" Pretty="ColorRGB9" ActivationGroup="ColorRGB" Feature="Color.RGB" PhysicalUnit="ColorComponent" />
            <Attribute Name="ColorRGB10" Pretty="ColorRGB10" ActivationGroup="ColorRGB" Feature="Color.RGB" PhysicalUnit="ColorComponent" />
            <Attribute Name="ColorRGB11" Pretty="ColorRGB11" ActivationGroup="ColorRGB" Feature="Color.RGB" PhysicalUnit="ColorComponent" />
            <Attribute Name="ColorRGB12" Pretty="ColorRGB12" ActivationGroup="ColorRGB" Feature="Color.RGB" PhysicalUnit="ColorComponent" />
            <Attribute Name="ColorRGB13" Pretty="ColorRGB13" ActivationGroup="ColorRGB" Feature="Color.RGB" PhysicalUnit="ColorComponent" />
            <Attribute Name="ColorRGB14" Pretty="ColorRGB14" ActivationGroup="ColorRGB" Feature="Color.RGB" PhysicalUnit="ColorComponent" />
            <Attribute Name="ColorRGB15" Pretty="ColorRGB15" ActivationGroup="ColorRGB" Feature="Color.RGB" PhysicalUnit="ColorComponent" />
            <Attribute Name="ColorRGB16" Pretty="ColorRGB16" ActivationGroup="ColorRGB" Feature="Color.RGB" PhysicalUnit="ColorComponent" />
            <Attribute Name="ColorMacro" Pretty="Color Macro" Feature="Color.RGB" />
            <Attribute Name="ColorMacro2" Pretty="Color Macro 2" Feature="Color.RGB" />
            <Attribute Name="CTO" Pretty="CTO" Feature="Color.Color" />
            <Attribute Name="CTC" Pretty="CTC" Feature="Color.Color" />
            <Attribute Name="CTB" Pretty="CTB" Feature="Color.Color" />
            <Attribute Name="HSB_Hue" Pretty="H" ActivationGroup="ColorHSB" Feature="Color.HSB" PhysicalUnit="Angle" />
            <Attribute Name="HSB_Saturation" Pretty="S" ActivationGroup="ColorHSB" Feature="Color.HSB" PhysicalUnit="Percent" />
            <Attribute Name="HSB_Brightness" Pretty="B" ActivationGroup="ColorHSB" Feature="Color.HSB" PhysicalUnit="Percent" />
            <Attribute Name="HSB_Quality" Pretty="Q" ActivationGroup="ColorHSB" Feature="Color.HSB" PhysicalUnit="Percent" />
            <Attribute Name="StrobeDuration" Pretty="Strobe Duration" Feature="Beam.Beam" PhysicalUnit="Time" />
            <Attribute Name="StrobeRate" Pretty="Strobe Rate" Feature="Beam.Beam" />
            <Attribute Name="Shutter" Pretty="Sh" Feature="Beam.Beam" />
            <Attribute Name="ShutterStrobe" Pretty="Strobe" MainAttribute="Shutter" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="ShutterStrobePulse" Pretty="Pulse" MainAttribute="Shutter" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="ShutterStrobePulseClose" Pretty="Pulse Close" MainAttribute="Shutter" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="ShutterStrobePulseOpen" Pretty="Pulse Open" MainAttribute="Shutter" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="ShutterStrobeRandom" Pretty="Random" MainAttribute="Shutter" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="ShutterStrobeRandomPulse" Pretty="Random Pulse" MainAttribute="Shutter" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="ShutterStrobeRandomPulseClose" Pretty="Random Pulse Close" MainAttribute="Shutter" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="ShutterStrobeRandomPulseOpen" Pretty="Random Pulse Open" MainAttribute="Shutter" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="Shutter2" Pretty="Sh2" Feature="Beam.Beam" />
            <Attribute Name="Shutter2Strobe" Pretty="Strobe" MainAttribute="Shutter2" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="Shutter2StrobePulse" Pretty="Pulse" MainAttribute="Shutter2" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="Shutter2StrobePulseClose" Pretty="Pulse Close" MainAttribute="Shutter2" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="Shutter2StrobePulseOpen" Pretty="Pulse Open" MainAttribute="Shutter2" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="Shutter2StrobeRandom" Pretty="Random" MainAttribute="Shutter2" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="Shutter2StrobeRandomPulse" Pretty="Random Pulse" MainAttribute="Shutter2" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="Shutter2StrobeRandomPulseClose" Pretty="Random Pulse Close" MainAttribute="Shutter2" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="Shutter2StrobeRandomPulseOpen" Pretty="Random Pulse Open" MainAttribute="Shutter2" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="Shutter3" Pretty="Sh3" Feature="Beam.Beam" />
            <Attribute Name="Shutter3Strobe" Pretty="Strobe" MainAttribute="Shutter3" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="Shutter3StrobePulse" Pretty="Pulse" MainAttribute="Shutter3" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="Shutter3StrobePulseClose" Pretty="Pulse Close" MainAttribute="Shutter3" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="Shutter3StrobePulseOpen" Pretty="Pulse Open" MainAttribute="Shutter3" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="Shutter3StrobeRandom" Pretty="Random" MainAttribute="Shutter3" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="Shutter3StrobeRandomPulseClose" Pretty="Random Pulse Open" MainAttribute="Shutter3" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="Shutter3StrobeRandomPulseOpen" Pretty="Random Pulse Close" MainAttribute="Shutter3" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="Iris" Pretty="Iris" Feature="Beam.Beam" />
            <Attribute Name="IrisStrobe" Pretty="Strobe" MainAttribute="Iris" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="IrisPulseClose" Pretty="Pulse Close" MainAttribute="Iris" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="IrisPulseOpen" Pretty="Pulse Open" MainAttribute="Iris" Feature="Beam.Beam" PhysicalUnit="Frequency" />
            <Attribute Name="Frost" Pretty="Frost" Feature="Beam.Beam" />
            <Attribute Name="Frost2" Pretty="Frost 2" Feature="Beam.Beam" />
            <Attribute Name="Prism" Pretty="Prism" ActivationGroup="Prism" Feature="Beam.Beam" />
            <Attribute Name="PrismPos" Pretty="Prism 1 Pos" Feature="Beam.Beam" PhysicalUnit="Angle" />
            <Attribute Name="PrismPosRotation" Pretty="Rotate" MainAttribute="PrismPos" Feature="Beam.Beam" PhysicalUnit="AngularSpeed" />
            <Attribute Name="Prism2" Pretty="Prism 2" ActivationGroup="Prism" Feature="Beam.Beam" />
            <Attribute Name="Prism2Pos" Pretty="Prism 2 Pos" Feature="Beam.Beam" PhysicalUnit="Angle" />
            <Attribute Name="Prism2PosRotation" Pretty="Rotate" MainAttribute="Prism2Pos" Feature="Beam.Beam" PhysicalUnit="AngularSpeed" />
            <Attribute Name="Effects" Pretty="FX" Feature="Beam.Beam" />
            <Attribute Name="EffectsRate" Pretty="FX Rate" Feature="Beam.Beam" PhysicalUnit="Speed" />
            <Attribute Name="EffectsFade" Pretty="FX Fade" Feature="Beam.Beam" />
            <Attribute Name="Effects2" Pretty="FX2" Feature="Beam.Beam" />
            <Attribute Name="Effects2Rate" Pretty="FX2 Rate" Feature="Beam.Beam" PhysicalUnit="Speed" />
            <Attribute Name="Effects2Fade" Pretty="FX2 Fade" Feature="Beam.Beam" />
            <Attribute Name="EffectsSync" Pretty="FX Sync" Feature="Beam.Beam" />
            <Attribute Name="Focus" Pretty="Focus" Feature="Focus.Focus" />
            <Attribute Name="Focus2" Pretty="Focus2" Feature="Focus.Focus" />
            <Attribute Name="Zoom" Pretty="Zoom" Feature="Focus.Focus" PhysicalUnit="Angle" />
            <Attribute Name="FocusAdjust" Pretty="Focus Adjust" Feature="Focus.Focus" />
            <Attribute Name="FocusDistance" Pretty="Focus Distance" Feature="Focus.Focus" PhysicalUnit="Length" />
            <Attribute Name="Control" Pretty="Ctrl" Feature="Control.Control" />
            <Attribute Name="DimmerMode" Pretty="Dim Mode" Feature="Control.Control" />
            <Attribute Name="DimmerCurve" Pretty="Dim Curve" Feature="Control.Control" />
            <Attribute Name="PanMode" Pretty="Pan Mode" Feature="Control.Control" />
            <Attribute Name="TiltMode" Pretty="Tilt Mode" Feature="Control.Control" />
            <Attribute Name="PositionModes" Pretty="Pos Modes" Feature="Control.Control" />
            <Attribute Name="Gobo1WheelMode" Pretty="G1 Mode" Feature="Control.Control" />
            <Attribute Name="Gobo2WheelMode" Pretty="G2 Mode" Feature="Control.Control" />
            <Attribute Name="Gobo3WheelMode" Pretty="G3 Mode" Feature="Control.Control" />
            <Attribute Name="AnimationIndexRotateMode" Pretty="Anim Index Rot Mode" Feature="Control.Control" />
            <Attribute Name="AnimationWheelShortcutMode" Pretty="Anim Shortcut Mode" Feature="Control.Control" />
            <Attribute Name="Color1Mode" Pretty="C1 Mode" Feature="Control.Control" />
            <Attribute Name="Color2Mode" Pretty="C2 Mode" Feature="Control.Control" />
            <Attribute Name="Color3Mode" Pretty="C3 Mode" Feature="Control.Control" />
            <Attribute Name="Color4Mode" Pretty="C4 Mode" Feature="Control.Control" />
            <Attribute Name="ColorWheelShortcutMode" Pretty="Color Wheel Shortcut Mode" Feature="Control.Control" />
            <Attribute Name="CyanMode" Pretty="Cyan Mode" Feature="Control.Control" />
            <Attribute Name="MagentaMode" Pretty="Magenta Mode" Feature="Control.Control" />
            <Attribute Name="YellowMode" Pretty="Yellow Mode" Feature="Control.Control" />
            <Attribute Name="ColorMixMode" Pretty="Color Mix Mode" Feature="Control.Control" />
            <Attribute Name="StrobeMode" Pretty="Strobe Mode" Feature="Control.Control" />
            <Attribute Name="FocusMode" Pretty="Focus Mode" Feature="Control.Control" />
            <Attribute Name="IrisMode" Pretty="Iris Mode" Feature="Control.Control" />
            <Attribute Name="BeamEffectIndexRotateMode" Pretty="Beam Effect Index Rotate Mode" Feature="Control.Control" />
            <Attribute Name="IntensityMSpeed" Pretty="Intensity MSpeed" Feature="Control.Control" />
            <Attribute Name="PositionMSpeed" Pretty="Pos MSpeed" Feature="Control.Control" />
            <Attribute Name="ColorMixMSpeed" Pretty="Color Mix MSpeed" Feature="Control.Control" />
            <Attribute Name="ColorWheelSelectMSpeed" Pretty="Color Wheel Select MSpeed" Feature="Control.Control" />
            <Attribute Name="GoboWheelMSpeed" Pretty="Gobo Wheel MSpeed" Feature="Control.Control" />
            <Attribute Name="IrisMSpeed" Pretty="Iris MSpeed" Feature="Control.Control" />
            <Attribute Name="FocusMSpeed" Pretty="Focus MSpeed" Feature="Control.Control" />
            <Attribute Name="FrameMSpeed" Pretty="Frame MSpeed" Feature="Control.Control" />
            <Attribute Name="GlobalMSpeed" Pretty="Global MSpeed" Feature="Control.Control" />
            <Attribute Name="FixtureGlobalReset" Pretty="Fixture Global Reset" Feature="Control.Control" />
            <Attribute Name="ShutterReset" Pretty="Shutter Reset" Feature="Control.Control" />
            <Attribute Name="BeamReset" Pretty="Beam Reset" Feature="Control.Control" />
            <Attribute Name="ColorMixReset" Pretty="Color Mix Reset" Feature="Control.Control" />
            <Attribute Name="ColorWheelReset" Pretty="Color Wheel Reset" Feature="Control.Control" />
            <Attribute Name="FocusReset" Pretty="Focus Reset" Feature="Control.Control" />
            <Attribute Name="FrameReset" Pretty="Frame Reset" Feature="Control.Control" />
            <Attribute Name="GoboWheelReset" Pretty="G Reset" Feature="Control.Control" />
            <Attribute Name="IntensityReset" Pretty="Intensity Reset" Feature="Control.Control" />
            <Attribute Name="IrisReset" Pretty="Iris Reset" Feature="Control.Control" />
            <Attribute Name="PositionReset" Pretty="Pos Reset" Feature="Control.Control" />
            <Attribute Name="PanReset" Pretty="Pan Reset" Feature="Control.Control" />
            <Attribute Name="TiltReset" Pretty="Tilt Reset" Feature="Control.Control" />
            <Attribute Name="ZoomReset" Pretty="Zoom Reset" Feature="Control.Control" />
            <Attribute Name="CTBReset" Pretty="CTB Reset" Feature="Control.Control" />
            <Attribute Name="CTOReset" Pretty="CTO Reset" Feature="Control.Control" />
            <Attribute Name="CTCReset" Pretty="CTC Reset" Feature="Control.Control" />
            <Attribute Name="FixtureCalibrationReset" Pretty="Fixture Calibration Reset" Feature="Control.Control" />
            <Attribute Name="Function" Pretty="Function" Feature="Control.Control" />
            <Attribute Name="LampControl" Pretty="Lamp Ctrl" Feature="Control.Control" />
            <Attribute Name="NoFeature" Pretty="NoFeature" Feature="Control.Control" />
            <Attribute Name="Dummy" Pretty="Dummy" Feature="Control.Control" />
            <Attribute Name="Blower" Pretty="Blower" Feature="Control.Control" />
            <Attribute Name="Fan" Pretty="Fan" Feature="Control.Control" />
            <Attribute Name="Fog" Pretty="Fog" Feature="Control.Control" />
            <Attribute Name="Haze" Pretty="Haze" Feature="Control.Control" />
            <Attribute Name="LampPowerMode" Pretty="Lamp Power Mode" Feature="Control.Control" />
            <Attribute Name="Fans" Pretty="Fans" Feature="Control.Control" />
            <Attribute Name="Blade1A" Pretty="Blade 1A" ActivationGroup="Shaper" Feature="Shapers.Shapers" />
            <Attribute Name="Blade1B" Pretty="Blade 1B" ActivationGroup="Shaper" Feature="Shapers.Shapers" />
            <Attribute Name="Blade2A" Pretty="Blade 2A" ActivationGroup="Shaper" Feature="Shapers.Shapers" />
            <Attribute Name="Blade2B" Pretty="Blade 2B" ActivationGroup="Shaper" Feature="Shapers.Shapers" />
            <Attribute Name="Blade3A" Pretty="Blade 3A" ActivationGroup="Shaper" Feature="Shapers.Shapers" />
            <Attribute Name="Blade3B" Pretty="Blade 3B" ActivationGroup="Shaper" Feature="Shapers.Shapers" />
            <Attribute Name="Blade4A" Pretty="Blade 4A" ActivationGroup="Shaper" Feature="Shapers.Shapers" />
            <Attribute Name="Blade4B" Pretty="Blade 4B" ActivationGroup="Shaper" Feature="Shapers.Shapers" />
            <Attribute Name="Blade1Rot" Pretty="Blade 1 Rot" ActivationGroup="Shaper" Feature="Shapers.Shapers" PhysicalUnit="Angle" />
            <Attribute Name="Blade2Rot" Pretty="Blade 2 Rot" ActivationGroup="Shaper" Feature="Shapers.Shapers" PhysicalUnit="Angle" />
            <Attribute Name="Blade3Rot" Pretty="Blade 3 Rot" ActivationGroup="Shaper" Feature="Shapers.Shapers" PhysicalUnit="Angle" />
            <Attribute Name="Blade4Rot" Pretty="Blade 4 Rot" ActivationGroup="Shaper" Feature="Shapers.Shapers" PhysicalUnit="Angle" />
            <Attribute Name="ShaperRot" Pretty="Shaper Rot" ActivationGroup="Shaper" Feature="Shapers.Shapers" PhysicalUnit="Angle" />
            <Attribute Name="ShaperMacros" Pretty="Shaper Macros" Feature="Shapers.Shapers" />
            <Attribute Name="Video" Pretty="Video" Feature="Video.Video" />
        </Attributes>
    </AttributeDefinitions>

Revision History

This section lists all the changes that are made to GDTF.

Version 0.87

  • Changing format of type Matrix and Rotation;
  • New xml attribute of DMX Channel - Uber;
  • Attribute has no more Special xml attribute;
  • Pigtail position should not be specified in 2D or 3D files anymore. Instead of it should be created a general geometry and linked to a model with primitive type “Pigtail”;
  • Measurement point does not have DMX and Color xml properties anymore;
  • Added specification to 3D mesh;
  • Added new part Color rendering index collect;
  • Added new part Supported protocol collect and moved RDM section to this part;
  • GDTF file should have extension “.gdtf”;
  • Subattributes are no more part of GDTF. Instead Attributes get a new xml attribute “MainAttribute”;
  • Macro Collect moved into DMX Mode and is defined;
  • Channel Set has no more xml attribute Real Fade;
  • Defined measurement resolution for Emitters;
  • Logical Channel and DMX Channel has an automatically generated name, which cannot be specified in xml.


Version 0.86

  • Changing xml tag for Emitter collect;
  • Xml node “Master” moved from Channel Function to Logical Channel;
  • New predefined values for primitive type of model;
  • Lamp geometry type is renamed to Beam;
  • New name suggestion of General Geometry;
  • Attribute has new xml attribute – “Special”;
  • Default SubAttribute for Channel Function is NoFeature;
  • Fixture Type has new xml attribute “RefFT”;
  • RealFade xml attribute has type float;
  • Renaming of xml Attribute MibFadeFrame to MibFade, type float;
  • Changing type of xml attribute DMXChangeTimeLimit to float;
  • Beam has new xml attribute FieldAngle;
  • Wheel no longer has the xml attribute “SubAttribute”;
  • Changing xml tags of EmitterCollect to Emitters; DMXProfileCollect to DMXProfiles;
  • New Type “DMXValue”, used to specify DMX values like Default or DMXFrom;
  • Adjusted names of predefined ActivationGroups, Attributes and Subattributes;
  • Removed predefined Attributes “MasterIntensity”, REDALL, GREENALL, BLUEALL, AMBERALL, WHITEALL;
  • Removed ActivationGroup “ColorRGBALL”.


Version 0.85

  • Internal xml file has a static name “description.xml”.
  • DMX mode collect should contain all modes and all firmware revisions.