Matrix (DDF-Syntax) DMXC3

Artikel beschreibt
DMXControl 3.2.0

Teil 1: Grundlagen
Allgemeine Einführung (Wofür benötigt man ein DDFs in DMXC3?)	Grundaufbau eines DDFs (Struktur) Funktionselemente	Grundregeln (Welche Dinge sind bei der Erstellung zu beachten?)

Teil 2: Funktionen
Intensität Position Farbe Matrix	Radix Gobo Linse Blendenschieber	Effektrad Bühneneffekte Freie Funktionen

Teil 3: Procederes
Funktionen	Beispiele

Teil 4: Beispiele
LED-Scheinwerfer	4er-Bar	Moving Head

Matrix

Einfache Matrizen

Tag Variante Code

matrix

RGB-Matrix mit zwei Zeilen und drei Spalten, manuell gepatcht

<matrix rows="2" columns="3">
  <rgb>
    <red dmxchannel="01" />
    <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 mit zwei Zeilen und drei Spalten, wobei die Adressierung manuell von links oben zeilenweise nach rechts unten erfolgt:

RGB-Pixel links oben: DMX-Kanäle 1 bis 3.
RGB-Pixel mitte oben: DMX-Kanäle 4 bis 6.
...
RGB-Pixel rechts unten: DMX-Kanäle 16 bis 18.

Attribut	rows	colums
Beschreibung	Anzahl der Zeilen der Matrix	Anzahl der Spalten der Matrix
Zulässiger Attributwert	`1 bis 256`	`1 bis 256`

Matrizen mit RGB+-Farben

Tag	Variante	Code
`matrix`	RGBW-Matrix mit zwei Zeilen und sechs Spalten, automatisch gepatcht	<matrix dmxchannel="0" rows="2" columns="6" whiteoffset="3" /> Matrix mit zwei Zeilen und sechs Spalten, wobei die Adressierung automatisch von links oben zeilenweise nach rechts unten erfolgt: Erster Pixel der RGBW-Matrix auf DMX-Kanal 1, angeordnet in der oberen linken Ecke. Offset für Steuerkanal der weißen LED bei Wert `3`, da LED-Farbe an vierter Position in der Ansteuerungsreihenfolge (LED-Bauart RGBW).
`matrix`	RGBWA-Matrix mit fünf Zeilen und fünf Spalten, automatisch gepatcht	<matrix dmxchannel="0" rows="5" columns="5" whiteoffset="3" amberoffset="4" /> Matrix mit fünf Zeilen und fünf Spalten, wobei die Adressierung automatisch von links oben zeilenweise nach rechts unten erfolgt: Erster Pixel der RGBWA-Matrix auf DMX-Kanal 1, angeordnet in der oberen linken Ecke. Offset für Steuerkanal der weißen LED bei Wert `3`, da LED-Farbe an vierter Position in der Ansteuerungsreihenfolge (LED-Bauart RGBWA). Offset für Steuerkanal der amberfarbenen LED bei Wert `4`, da LED-Farbe an fünfter Position in der Ansteuerungsreihenfolge.

Attribut	whiteoffset	amberoffset
Beschreibung	Offset der weißen LED	Offset der amberfarbenen LED
Zulässiger Attributwert	größer `3`	größer `3`

Analog zu whiteoffset und amberoffset sind folgende Angaben für RGBx-Matrizen, das heißt für Matrizen mit mehr als drei Farben pro LED-Chip zulässig:

amberoffset
cyanoffset
indigooffset
limeoffset
uvoffset
whiteoffset

Für die zulässigen Werte der Attribute rows und columns siehe vorherigen Abschnitt einfache Matrix.

Der Offset für jede weitere Farbe über die drei Grundfarben rot, grün und blau hinaus darf innerhalb einer Matrix nur einmal vergeben werden. Bei der Definition sind die Farben aufsteigend anhand ihres jeweiligen Offset-Werts zu ordnen.

Monochrome (einfarbige) Matrizen

Tag	Variante	Code
`matrix`	Monochrome Matrix mit fünf Zeilen und fünf Spalten, automatisch gepatcht	<matrix dmxchannel="0" monochrome="true" rows="5" columns="5"/> Matrix mit fünf Zeilen und fünf Spalten, wobei die Adressierung automatisch von links oben zeilenweise nach rechts unten erfolgt: Erster Pixel auf DMX-Kanal 1, angeordnet in der oberen linken Ecke. Attribut `monochrome` mit dem Wert `true` generiert eine Matrix mit nur einer Farbe.
`matrix`	Monochrome Matrix mit einer Zeile und vier Spalten, manuell gepatcht	<matrix rows="1" columns="4" monochrome="true" > <dimmer dmxchannel="0" /> <dimmer dmxchannel="1" /> <dimmer dmxchannel="2" /> <dimmer dmxchannel="3" /> </matrix> Matrix einer Zeile und vier Spalten, wobei die Adressierung manuell von links nach rechts erfolgt: Attribut `monochrome` mit dem Wert `true` generiert eine Matrix mit nur einer Farbe. 1. Pixel (links): DMX-Kanal 1. 2. Pixel: DMX-Kanal 2. 3. Pixel: DMX-Kanal 3. 4. Pixel (rechts): DMX-Kanal 4.

Attribut	monochrome
Beschreibung	Generierung einer monochromen (einfarbigen) Matrix
Zulässiger Attributwert	`true`

Für die zulässigen Werte der Attribute rows und columns siehe vorherigen Abschnitt einfache Matrix.