Matrix (DDF-Syntax) DMXC3

	Artikel beschreibt DMXControl 3.2.0 Stand: 02.03.2025	Matrix (DDF-Syntax) DMXC3
	Farbe (Color) Radix
Inhaltsverzeichnis 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-Beispiel
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-Beispiel

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-Beispiel
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.