Physical descriptions
This section describes the physical constitution of the device.
Physical Descriptions
General
This section describes the physical constitution of the device. It
currently does not have any XML Attributes (XML node
<PhysicalDescriptions>). Children of Physical Description are specified
in table 15.
Table 15. Physical Description Children
| XML node | Mandatory | Description |
|---|---|---|
| Emitters | No | Describes device emitters |
| Filters | No | Describes device filters |
| ColorSpace | No | Describes device default color space |
| AdditionalColorSpaces | No | Describes additional device color spaces |
| Gamuts | No | Describes device gamuts |
| DMXProfiles | No | Describes nonlinear correlation between DMX input and physical output of a channel. |
| CRIs | No | Describes color rendering with IES TM-30-15 (99 color samples). |
| Connectors | No | Obsolete now. See Geometry Collect, WiringObject. Describes physical connectors of the device. |
| Properties | No | Describes physical properties of the device. |
Emitter Collect
General
This section contains the description of the emitters. Emitter Collect
defines additive mixing of light sources, such as LEDs and tungsten
lamps with permanently fitted filters. It currently does not have any
XML Attributes (XML node <Emitters>). As children the emitter collect
has a list of a emitter.
Emitter
This section defines the description of the emitter (XML node
Table 16. Emitter Attributes
| XML Attribute Name | Value Type | Description |
|---|---|---|
| Name | Name | Unique Name of the emitter |
| Color | ColorCIE | Approximate absolute color point if applicable. Omit for non-visible emitters (eg., UV). For Y give relative value compared to overall output defined in property Luminous Flux of related Beam Geometry (transmissive case). |
| DominantWaveLength | Float | Required if color is omitted, otherwise it is optional. Dominant wavelength of the LED. |
| DiodePart | String | Optional. Manufacturer’s part number of the diode. |
As children, the Emitter has a list of measurements.
Filter Collect
General
This section contains the description of the filters. The Filter Collect
defines subtractive mixing of light sources by filters, such as
subtractive mixing flags and media used in physical or virtual Color
Wheels. It currently does not have any XML Attributes (XML node
<Filters>). As children the filter collect has a list of a
filters.
Filter
This section defines the description of the filter (XML node <Filter>).
The currently defined XML attributes of the filter are specified in
table 17.
Table 17. Filter Attributes
| XML Attribute Name | Value Type | Description |
|---|---|---|
| Name | Name | Unique Name of the filter. |
| Color | ColorCIE | Approximate absolute color point when this filter is the only item fully inserted into the beam and the fixture is at maximum intensity. For Y give relative value compared to overall output defined in property Luminous Flux of related Beam Geometry (transmissive case). |
As children the Filter has a list of measurements.
Measurement
General
The measurement defines the relation between the requested output by a
control channel and the physically achieved intensity. XML node for
measurement is <Measurement>. The currently defined XML attributes of
the measurement are specified in table 18.
Table 18. Measurement Attributes
| XML Attribute Name | Value Type | Description |
|---|---|---|
| Physical | Float | For additive color mixing: uniquely given emitter intensity DMX percentage. Value range between > 0 and <= 100. For subtractive color mixing: uniquely given flag insertion DMX percentage. Value range between 0 and 100. |
| LuminousIntensity | Float | Used for additive color mixing: overall candela value for the enclosed set of measurement. |
| Transmission | Float | Used for subtractive color mixing: total amount of lighting energy passed at this insertion percentage. |
| InterpolationTo | Enum | Interpolation scheme from the previous value. The currently defined values are: “Linear”, “Step”, “Log”; Default: Linear |
The order of the measurements corresponds to their ascending physical values.
Additional definition for additive color mixing: It is assumed that the physical value 0 exists and has zero output.
Additional definition for subtractive color mixing: The flag is removed with physical value 0 and it does not affect the beam. Physical value 100 is maximally inserted and affects the beam.
Note 1: Some fixtures may vary in color response. These fixtures define multiple measurement points and corresponding interpolations.
As children the Measurement Collect has an optional list of a measurement point.
Measurement Point
The measurement point defines the energy of a specific wavelength of a
spectrum. The XML node for measurement point is <MeasurementPoint>. The
defined XML attributes of the measurement points are specified in table
19.
It is recommended, but not required, that measurement points are evenly spaced. Regions with minimal light energy can be omitted, but the decisive range of spectrum must be included. Recommended measurement spacing is 1 nm. Measurement spacing should not exceed 4 nm.
Table 19. Measurement Point Attributes
| XML Attribute Name | Value Type | Description |
|---|---|---|
| WaveLength | Float | Center wavelength of measurement (nm). |
| Energy | Float | Lighting energy (W/m2/nm) |
The measurement point does not have any children.
Color Space Collect
General
This section defines color spaces. Currently it does not
have any XML attributes (XML node <AdditionalColorSpaces>). As children, color space collect has a list of a ColorSpace.
Color Space
This section defines the color space that is used for color mixing with
indirect RGB, Hue/Sat, xyY or CMY control input. (XML node
<ColorSpace>). The currently defined XML attributes of the color space
are specified in table 20.
Table 20. Color Space Attributes
| XML Attribute Name | Value Type | Description |
|---|---|---|
| Name | Name | Unique Name of the Color Space. Default Value: “Default”. Note that the name need to be unique for the default colorspace and all color spaces in the AdditionalColorSpaces node. |
| Mode | Enum | Definition of the Color Space that used for the indirect color mixing. The defined values are “Custom”, “sRGB”, “ProPhoto” and “ANSI”. Default Value: “sRGB” |
| Red | ColorCIE | Optional. CIE xyY of the Red Primary; this is used only if the ColorSpace is “Custom”. |
| Green | ColorCIE | Optional. CIE xyY of the Green Primary; this is used only if the ColorSpace is “Custom”. |
| Blue | ColorCIE | Optional. CIE xyY of the Blue Primary; this is used only if the ColorSpace is “Custom”. |
| WhitePoint | ColorCIE | Optional. CIE xyY of the White Point; this is used only if the ColorSpace is “Custom”. |
The predefined modes for the color space XML Attributes are are specified in table 21.
Table 21. Predefined Modes for Color Space Attribute Mode
| Mode | sRGB | ProPhoto | ANSI |
| Description | Adobe sRGB, HDTV IEC 61966-2-1:1999 | Kodak ProPhoto ROMM RGB ISO 22028-2:2013 | ANSI E1.54-2015 |
| Red | 0.6400, 0.3300, 0.2126 | 0.7347, 0.2653 | 0.7347, 0.2653 |
| Green | 0.3000, 0.6000, 0.7152 | 0.1596, 0.8404 | 0.1596, 0.8404 |
| Blue | 0.1500, 0.0600, 0.0722 | 0.0366, 0.0001 | 0.0366, 0.001 |
| WhitePoint | 0.3127, 0.3290, 1.0000 | 0.3457, 0.3585 | 0.4254, 0.4044 |
The color space does not have any children.
Gamut Collect
General
This section defines gamuts. Currently it does not
have any XML attributes (XML node <Gamuts>). As children, gamut collect has a list of a Gamut.
Gamut
This section defines the color gamut of the fixture (XML node <Gamut>), which is the set of attainable colors by the fixture. The currently defined XML attributes of a gamut
are specified in table 22.
Table 22. Gamut Attributes
| XML Attribute Name | Value Type | Description |
|---|---|---|
| Name | Name | Unique Name of the Gamut. |
| Points | Array of ColorCIE | Set of points defining the vertice of the gamut’s polygon. |
The gamut does not have any children.
DMX Profile Collect
General
This section defines DMX profile descriptions. Currently it does not
have any XML attributes (XML node <DMXProfiles>). As children DMX
profile collect has a list of DMX profiles.
DMX Profile
This section defines the DMX profile description (XML node
<DMXProfile>). The currently defined XML attributes of the DMX profile
are specified in table 23.
Table 23. DMX Profile Attributes
| XML Attribute Name | Value Type | Description |
|---|---|---|
| Name | Name | Unique name of the DMX profile |
As children a DMX Profile has a list of point.
Point
This section contains points to define the DMX profile (XML node <Point>). The currently defined XML attributes of a point
are specified in table 24.
Table 24. Point Attributes
| XML Attribute Name | Value Type | Description |
|---|---|---|
| DMXPercentage | Float | DMX percentage of the point; Unit: Percentage; Default value: 0 |
| CFC0 | Float | Cubic Function Coefficient for x⁰; Default value: 0 |
| CFC1 | Float | Cubic Function Coefficient for x; Default value: 0 |
| CFC2 | Float | Cubic Function Coefficient for x²; Default value: 0 |
| CFC3 | Float | Cubic Function Coefficient for x³; Default value: 0 |
Find the Point with the biggest DMXPercentage below or equal x. If there is none, the output is expected to be 0.
Output(x) = CFC3 * (x - DMXPercent)³ + CFC2 * (x - DMXPercent)² + CFC1 * (x - DMXPercent) + CFC0
Here is an example where the output follows a function f for 75% of the DMX Range and another function g for the last 25%. The Point attributes are given to illustrate how they are defined.
Figure 1. DMXProfile example
A Point does not have any children.
Color Rendering Index Collect
General
This section contains TM-30-15 Fidelity Index (Rf) for 99 color samples.
Currently it does not have any XML attributes (XML node <CRIs>). As
children, CRIs has a list of CRI groups.
Color Rendering Index Group
General
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 25.
Table 25. CRI Group Attributes
| XML Attribute Name | Value Type | Description |
|---|---|---|
| ColorTemperature | Float | Color temperature; Default value: 6000; Unit: Kelvin |
As children, the CRIGroup has an optional list of Color Rendering Index.
Color Rendering Index
This section defines 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 26.
Table 26. CRI Attributes
| XML Attribute Name | Value Type | Description |
|---|---|---|
| CES | Enum | Color sample. The defined values are “CES01”, “CES02”, … “CES99”. Default Value “CES01" |
| ColorRenderingIndex | UInt | The color rendering index for this sample. Size: 1 byte; Default value: 100 |
The color rendering index does not have any children.
Connector Collect
General
This section defined the physical connectors and is kept for backwards compatibility. From DIN SPEC 15800:2022 or GDTF v1.2 onwards physical connectors shall be decribed as WiringObjects in the Geometry Collect.
It currently does not have any XML attributes (XML node <Connectors>). As children, the Connector Collect has a list of a connectors.
Connector
See Geometry Collect WiringObject. For easier transition find below the equivalent of the WiringObject.
This section defines the connector (XML node <Connector>). The currently
defined XML attributes of the connector are specified in table
27.
Table 27. Connector Attributes
| XML Attribute Name | Value Type | Description |
|---|---|---|
| Name | Name | Unique Name of the connector. Now: Geometry Type WiringObject, XML Attribute: Name |
| Type | Name | The type of the connector. Find a list of predefined types in Annex D. Now: Geometry Type WiringObject, XML Attribute: ConnectorType. |
| DMXBreak | Uint | Optional. Defines to which DMX Break this connector belongs to. Obsolete now. |
| Gender | Int | Connectors where the addition of the Gender value equal 0, can be connected; Default value: 0; Male Connectors are -1, Female are +1, Universal are 0. Obsolete now. |
| Length | Float | Defines the length of the connector’s wire in meters. “0” means that there is no cable and the connector is build into the housing. Default value “0”. Obsolete now. |
The connector does not have any children.
Properties Collect
General
This section defines the general properties of the device type (XML node
<Properties>). The Properties Collect currently does not have any XML
attributes. The currently defined children nodes of properties collect
are specified in table 28.
Table 28. Properties Collect
| XML node | Amount | Description |
|---|---|---|
| OperatingTemperature | 0 or 1 | Temperature range in which the device can be operated. |
| Weight | 0 or 1 | Weight of the device including all accessories. |
| PowerConsumption | Any | Power information for a given connector. |
| LegHeight | 0 or 1 | Height of the legs. |
OperatingTemperature
This section defines the ambient operating temperature range (XML node
<OperatingTemperature>). The currently defined XML attributes of the
OperatingTemperature are specified in table 29.
Table 29. Operating Temperature Attributes
| XML Attribute Name | Value Type | Description |
|---|---|---|
| Low | Float | Lowest temperature the device can be operated. Unit: °C. Default value: 0 |
| High | Float | Highest temperature the device can be operated. Unit: °C. Default value: 40 |
The OperatingTemperature currently does not have any children.
Weight
This section defines the overall weight of the device (XML node
<Weight>). The currently defined XML attributes of the weight are
specified in table 30.
Table 30. Weight Attributes
| XML Attribute Name | Value Type | Description |
|---|---|---|
| Value | Float | Weight of the device including all accessories. Unit: kilogram. Default value: 0 |
The weight currently does not have any children.
LegHeight
This section defines the height of the legs (XML node <LegHeight>). The
currently defined XML attributes of the LegHeight are specified in
table 31.
Table 31. Leg Height Attributes
| XML Attribute Name | Value Type | Description |
|---|---|---|
| Value | Float | Defines height of the legs - distance between the floor and the bottom base plate. Unit: meter. Default value: 0 |
The LegHeight currently does not have any children.