Matrix (DDF-Syntax) DMXC3: Difference between revisions

From English DMXC-Wiki
No edit summary
No edit summary
Line 10: Line 10:
= Matrix =
= Matrix =
== Basic structure ==
== Basic structure ==
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code examples | en}}
|-
| RGB matrix with five rows and five columns, automatically patched
! Variant !! Code
| <syntaxhighlight lang="xml">
|-
| style="width: 200px" | RGB matrix with five rows and five columns, automatically patched
| style="width: 1000px" | <syntaxhighlight lang="xml">
<matrix dmxchannel="0" rows="5" columns="5"/>
<matrix dmxchannel="0" rows="5" columns="5"/>
</syntaxhighlight>
</syntaxhighlight>
Line 86: Line 83:


=== Matrices with RGB+ colors ===
=== Matrices with RGB+ colors ===
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code examples | en}}
|-
| RGBW matrix with two rows and six columns, automatically patched
! Variant !! Code
| <syntaxhighlight lang="xml">
|-
| style="width: 200px" | RGBW matrix with two rows and six columns, automatically patched
| style="width: 1000px" | <syntaxhighlight lang="xml">
<matrix dmxchannel="0" rows="2" columns="6" whiteoffset="3" />
<matrix dmxchannel="0" rows="2" columns="6" whiteoffset="3" />
</syntaxhighlight>
</syntaxhighlight>
Line 98: Line 92:
* Offset for control channel of the white LED at value <code>3</code>, 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 <code>3</code>, since LED color is in the fourth position in the control sequence (RGBW LED type).
<!--|-
<!--|-
| style="width: 200px" | RGBWA matrix with five rows and five columns, automatically patched
| RGBWA matrix with five rows and five columns, automatically patched
| style="width: 1000px" | <syntaxhighlight lang="xml">
| <syntaxhighlight lang="xml">
<matrix dmxchannel="0" rows="5" columns="5" whiteoffset="3" amberoffset="4" />
<matrix dmxchannel="0" rows="5" columns="5" whiteoffset="3" amberoffset="4" />
</syntaxhighlight>
</syntaxhighlight>
Line 132: Line 126:


=== Monochrome matrices ===
=== Monochrome matrices ===
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code examples | en}}
|-
| Monochrome matrix with five rows and five columns, automatically patched
! Variant !! Code
| <syntaxhighlight lang="xml">
|-
| style="width: 200px" | Monochrome matrix with five rows and five columns, automatically patched
| style="width: 1000px" | <syntaxhighlight lang="xml">
<matrix dmxchannel="0" monochrome="true" rows="5" columns="5"/>
<matrix dmxchannel="0" monochrome="true" rows="5" columns="5"/>
</syntaxhighlight>
</syntaxhighlight>

Revision as of 16:37, 2 March 2025

Blockdevice.png Article describe
DMXControl 3.2.3
Stand: 02.03.2025		 Matrix (DDF-Syntax) DMXC3
Arrow back.png Color
Radix Arrow forw.png
Table of contents
Part 1: Basics
Part 2: Functions
Part 3: Procedures
Part 4: Examples

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


Important Hint 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.

Retrieved from "https://wiki-en.dmxcontrol-projects.org/index.php?title=Matrix_(DDF-Syntax)_DMXC3&oldid=4177"