Latest revision as of 22:10, 2 March 2025

Article describe
DMXControl 3.2.3
Stand: 02.03.2025

Matrix (DDF-Syntax) DMXC3

Part 1: Basics
General introduction	Basic structure	Basic rules

Part 2: Functions
Intensity Position Color Matrix	Radix Gobo Lens Blade Shifter	Effect wheel Stage effects Free Functions

Part 3: Procedures
Functions	Examples

Part 4: Examples
LED Spotlight	4-Spot-Bar	Moving Head

Matrix

Basic structure

Case

Code example

RGB matrix with five rows and five columns, automatically patched

<matrix dmxchannel="0" rows="5" columns="5"/>

Matrix with five rows and five columns, where addressing is automatic from top left to bottom right, row by row:

First pixel on DMX channels 1 to 3, arranged in the upper left corner.

RGB matrix with two rows and three columns, manually patched

<matrix rows="2" columns="3">
  <rgb>
    <red dmxchannel="0" />
    <green dmxchannel="1" />
    <blue dmxchannel="2" />
  </rgb>
  <rgb>
    <red dmxchannel="3" />
    <green dmxchannel="4" />
    <blue dmxchannel="5" />
  </rgb>
  <rgb>
    <red dmxchannel="6" />
    <green dmxchannel="7" />
    <blue dmxchannel="8" />
  </rgb>
  <rgb>
    <red dmxchannel="9" />
    <green dmxchannel="10" />
    <blue dmxchannel="11" />
  </rgb>
  <rgb>
    <red dmxchannel="12" />
    <green dmxchannel="13" />
    <blue dmxchannel="14" />
  </rgb>
  <rgb>
    <red dmxchannel="15" />
    <green dmxchannel="16" />
    <blue dmxchannel="17" />
  </rgb>
</matrix>

Matrix with two rows and three columns, where addressing is manual from top left to bottom right, row by row:

RGB pixel top left: DMX channels 1 to 3.
RGB pixel top middle: DMX channels 4 to 6.
...
RGB pixel bottom right: DMX channels 16 to 18.

Attribute	rows	columns
Description	Number of rows of the matrix	Number of columns of the matrix
Permissible Attribute Value	`1` to `256`	`1` to `256`

If the matrix is defined as an RGBW matrix, the "White Auto Mix" function of the Hardware Abstraction Layer (HAL) takes effect. However, in the Device Control, only entries for red, green, and blue continue to be generated.

Additional Attributes

The matrix can be further customized with additional attributes:

matrix (main tag)
- Color offset: Specifies the DMX channels for the RGB+-colors white, amber, etc.
- monochrome: Matrix as a monochrome matrix
- rowfirst: Changes the automatic patch order

Matrices with RGB+ colors

Case	Code example
RGBW matrix with two rows and six columns, automatically patched	<matrix dmxchannel="0" rows="2" columns="6" whiteoffset="3" /> Matrix with two rows and six columns, where addressing is automatic from top left to bottom right, row by row: First pixel of the RGBW matrix on DMX channel 1, arranged in the upper left corner. Offset for control channel of the white LED at value 3, since LED color is in the fourth position in the control sequence (RGBW LED type).

Attribute	whiteoffset
Description	Offset of the white LED
Permissible Attribute Value	Greater than `3`

For the permissible values of the attributes rows and columns, see the previous section simple matrix.

Monochrome matrices

Case	Code example
Monochrome matrix with five rows and five columns, automatically patched	<matrix dmxchannel="0" monochrome="true" rows="5" columns="5"/> Matrix with five rows and five columns, where addressing is automatic from top left to bottom right, row by row: First pixel on DMX channel 1, arranged in the upper left corner. Attribute monochrome with the value true generates a matrix with only one color.
Monochrome matrix with one row and four columns, manually patched	<matrix rows="1" columns="4" monochrome="true" > <dimmer dmxchannel="0" /> <dimmer dmxchannel="1" /> <dimmer dmxchannel="2" /> <dimmer dmxchannel="3" /> </matrix> Matrix with one row and four columns, where addressing is manual from left to right: Attribute monochrome with the value true generates a matrix with only one color. 1st pixel (left): DMX channel 1. 2nd pixel: DMX channel 2. 3rd pixel: DMX channel 3. 4th pixel (right): DMX channel 4.

Attribute	monochrome
Description	Generating a monochrome matrix
Permissible Attribute Value	`true`

For the permissible values of the attributes rows and columns, see the previous section simple matrix.

@@ Line 15: / Line 15: @@
 <matrix dmxchannel="0" rows="5" columns="5"/>
 </syntaxhighlight>
-Matrix with {{Manual Value || five}} rows and {{Manual Value || five}} columns, where addressing is automatic from top left to bottom right, row by row:
+Matrix with {{Manual Value | XML value | five}} rows and {{Manual Value | XML value | five}} columns, where addressing is automatic from top left to bottom right, row by row:
 * First pixel on DMX channels {{Manual Value | DMX channel | 1}} to {{Manual Value | DMX channel | 3}}, arranged in the upper left corner.
 |-
@@ Line 53: / Line 53: @@
 </matrix>
 </syntaxhighlight>
-Matrix with {{Manual Value || two}} rows and {{Manual Value || three}} columns, where addressing is manual from top left to bottom right, row by row:
+Matrix with {{Manual Value | XML value | two}} rows and {{Manual Value | XML value | three}} columns, where addressing is manual from top left to bottom right, row by row:
 * RGB pixel top left: DMX channels {{Manual Value | DMX channel | 1}} to {{Manual Value | DMX channel | 3}}.
 * RGB pixel top middle: DMX channels {{Manual Value | DMX channel | 4}} to {{Manual Value | DMX channel | 6}}.
@@ Line 88: / Line 88: @@
 <matrix dmxchannel="0" rows="2" columns="6" whiteoffset="3" />
 </syntaxhighlight>
-Matrix with {{Manual Value || two}} rows and {{Manual Value || six}} columns, where addressing is automatic from top left to bottom right, row by row:
+Matrix with {{Manual Value | XML value | two}} rows and {{Manual Value | XML value | six}} columns, where addressing is automatic from top left to bottom right, row by row:
 * First pixel of the RGBW matrix on DMX channel {{Manual Value | DMX channel | 1}}, arranged in the upper left corner.
-* Offset for control channel of the white LED at value {{Manual Value || 3}}, since LED color is in the fourth position in the control sequence (RGBW LED type).
+* Offset for control channel of the white LED at value {{Manual Value | XML value | 3}}, since LED color is in the fourth position in the control sequence (RGBW LED type).
 <!--|-
 | RGBWA matrix with five rows and five columns, automatically patched
@@ Line 96: / Line 96: @@
 <matrix dmxchannel="0" rows="5" columns="5" whiteoffset="3" amberoffset="4" />
 </syntaxhighlight>
-Matrix with {{Manual Value || five}} rows and {{Manual Value || five}} columns, where addressing is automatic from top left to bottom right, row by row:
+Matrix with {{Manual Value | XML value | five}} rows and {{Manual Value | XML value | five}} columns, where addressing is automatic from top left to bottom right, row by row:
 * First pixel of the RGBWA matrix on DMX channel {{Manual Value | DMX channel | 1}}, arranged in the upper left corner.
-* Offset for control channel of the white LED at value {{Manual Value || 3}}, since LED color is in the fourth position in the control sequence (RGBWA LED type).
+* Offset for control channel of the white LED at value {{Manual Value | XML value | 3}}, since LED color is in the fourth position in the control sequence (RGBWA LED type).
-* Offset for control channel of the amber LED at value {{Manual Value || 4}}, since LED color is in the fifth position in the control sequence.-->
+* Offset for control channel of the amber LED at value {{Manual Value | XML value | 4}}, since LED color is in the fifth position in the control sequence.-->
 |}
 {| class="wikitable toptextcells"
@@ Line 131: / Line 131: @@
 <matrix dmxchannel="0" monochrome="true" rows="5" columns="5"/>
 </syntaxhighlight>
-Matrix with {{Manual Value || five}} rows and {{Manual Value || five}} columns, where addressing is automatic from top left to bottom right, row by row:
+Matrix with {{Manual Value | XML value | five}} rows and {{Manual Value | XML value | five}} columns, where addressing is automatic from top left to bottom right, row by row:
 * First pixel on DMX channel {{Manual Value | DMX channel | 1}}, arranged in the upper left corner.
-* Attribute <code>monochrome</code> with the value <code>true</code> generates a matrix with only one color.
+* Attribute {{Manual Value | XML attribute | monochrome}} with the value {{Manual Value | XML value | true}} generates a matrix with only one color.
 |-
 | Monochrome matrix with one row and four columns, manually patched
@@ Line 144: / Line 144: @@
 </matrix>
 </syntaxhighlight>
-Matrix with {{Manual Value || one}} row and {{Manual Value || four}} columns, where addressing is manual from left to right:
+Matrix with {{Manual Value | XML value | one}} row and {{Manual Value | XML value | four}} columns, where addressing is manual from left to right:
-* Attribute <code>monochrome</code> with the value <code>true</code> generates a matrix with only one color.
+* Attribute {{Manual Value | XML attribute | monochrome}} with the value {{Manual Value | XML value | true}} generates a matrix with only one color.
 * 1st pixel (left): DMX channel {{Manual Value | DMX channel | 1}}.
 * 2nd pixel: DMX channel {{Manual Value | DMX channel | 2}}.