Artikel beschreibt
DMXControl 3.2.0

Matrix (DDF-Syntax) DMXC3

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

Grundlegender Aufbau

Variante	Code
RGB-Matrix mit fünf Zeilen und fünf Spalten, automatisch gepatcht	<matrix dmxchannel="0" 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 bis 3, angeordnet in der oberen linken Ecke.
RGB-Matrix mit zwei Zeilen und drei Spalten, manuell gepatcht	<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 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`

Wird die Matrix als RGBW-Matrix definiert, greift die Funktion "White Auto Mix" der Hardware Abstraction Layer (HAL). In der Gerätesteuerung (Device Control) werden aber nur weiterhin Einträge für rot, grün und blau generiert.

Zusätzliche Attribute

Die Matrix kann durch weitere Attribute weiter individuell angepasst werden:

matrix (Haupttag)
- Farboffset: Angabe der DMX-Kanäle für die RGB+-Farben weiß, amber, etc.
- monochrome: Matrix als einfarbige (monochrome) Matrix
- rowfirst: Änderung der automatischen Patchreihenfolge

Matrizen mit RGB+-Farben

Variante	Code
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).

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

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

Monochrome (einfarbige) Matrizen

Variante	Code
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.
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.