Aktuelle Version vom 2. März 2025, 22:10 Uhr

Artikel beschreibt
DMXControl 3.2.0
Stand: 02.03.2025

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

@@ Zeile 1: / Zeile 1: @@
-{{Kapitelüberschrift|Version=DMXControl 3.2.0}}
+{{Manual Header
+| Type = DMXC3 DDFs
-{{DMXC3_Manual-Navigation_DDF
+| Version = 3.2.0
-|zurückLink = Color_(DDF-Syntax)_DMXC3
+| zurückLink = Color (DDF-Syntax)_DMXC3
-|zurückText = Farbe (Color)
+| zurückText = Farbe (Color)
-|vorLink = Radix_(DDF-Syntax)_DMXC3
+| vorLink = Radix (DDF-Syntax)_DMXC3
-|vorText = Radix
+| vorText = Radix
 }}
 = Matrix =
 == Grundlegender Aufbau ==
-{| class="wikitable toptextcells"
+{{DMXC3 Manual-Tableheader DDF-Code examples | de}}
-|-
+| RGB-Matrix mit fünf Zeilen und fünf Spalten, automatisch gepatcht
-! Variante !! Code
+| <syntaxhighlight lang="xml">
-|-
-| style="width: 200px" | RGB-Matrix mit fünf Zeilen und fünf Spalten, automatisch gepatcht
-| style="width: 1000px" | <syntaxhighlight lang="xml">
 <matrix dmxchannel="0" rows="5" columns="5"/>
 </syntaxhighlight>
-Matrix mit fünf Zeilen und fünf Spalten, wobei die Adressierung automatisch von links oben zeilenweise nach rechts unten erfolgt:
+Matrix mit {{Manual Value | XML value | fünf}} Zeilen und {{Manual Value | XML value | 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.
+* Erster Pixel auf DMX-Kanal {{Manual Value | DMX channel | 1}} bis {{Manual Value | DMX channel | 3}}, angeordnet in der oberen linken Ecke.
 |-
 | RGB-Matrix mit zwei Zeilen und drei Spalten, manuell gepatcht
@@ Zeile 57: / Zeile 53: @@
 </matrix>
 </syntaxhighlight>
-Matrix mit zwei Zeilen und drei Spalten, wobei die Adressierung manuell von links oben zeilenweise nach rechts unten erfolgt:
+Matrix mit {{Manual Value | XML value | zwei}} Zeilen und {{Manual Value | XML value | 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 links oben: DMX-Kanäle {{Manual Value | DMX channel | 1}} bis {{Manual Value | DMX channel | 3}}.
-* RGB-Pixel mitte oben: DMX-Kanäle 4 bis 6.
+* RGB-Pixel mitte oben: DMX-Kanäle {{Manual Value | DMX channel | 4}} bis {{Manual Value | DMX channel | 6}}.
 * ...
-* RGB-Pixel rechts unten: DMX-Kanäle 16 bis 18.
+* RGB-Pixel rechts unten: DMX-Kanäle {{Manual Value | DMX channel | 16}} bis {{Manual Value | DMX channel | 18}}.
 |}
@@ Zeile 77: / Zeile 73: @@
 |}
-{{Manual Box | de | Hint | Wird die Matrix als RGBW-Matrix definiert, greift die Funktion "White Auto Mix" der {{Manual Windowcaption|[[Hardware Abstraction Layer (HAL) DMXC3| Hardware Abstraction Layer (HAL)]]}}. In der {{Manual Windowcaption|[[Device Control DMXC3|Gerätesteuerung (Device Control)]]}} werden aber nur weiterhin Einträge für rot, grün und blau generiert.}}
+{{Manual Box | de | Hint | Wird die Matrix als RGBW-Matrix definiert, greift die Funktion "White Auto Mix" der {{Manual Windowcaption|[[Hardware Abstraction Layer (HAL) DMXC3|Hardware Abstraction Layer (HAL)]]}}. In der {{Manual Windowcaption|[[Device Control DMXC3|Gerätesteuerung (Device Control)]]}} werden aber nur weiterhin Einträge für rot, grün und blau generiert.}}
 == Zusätzliche Attribute ==
@@ Zeile 87: / Zeile 83: @@
 === Matrizen mit RGB+-Farben ===
-{| class="wikitable toptextcells"
+{{DMXC3 Manual-Tableheader DDF-Code examples | de}}
-|-
+| RGBW-Matrix mit zwei Zeilen und sechs Spalten, automatisch gepatcht
-! Variante !! Code
+| <syntaxhighlight lang="xml">
-|-
-| style="width: 200px" | RGBW-Matrix mit zwei Zeilen und sechs Spalten, automatisch gepatcht
-| style="width: 1000px" | <syntaxhighlight lang="xml">
 <matrix dmxchannel="0" rows="2" columns="6" whiteoffset="3" />
 </syntaxhighlight>
-Matrix mit zwei Zeilen und sechs Spalten, wobei die Adressierung automatisch von links oben zeilenweise nach rechts unten erfolgt:
+Matrix mit {{Manual Value | XML value | zwei}} Zeilen und {{Manual Value | XML value | 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.
+* Erster Pixel der RGBW-Matrix auf DMX-Kanal {{Manual Value | DMX channel | 1}}, angeordnet in der oberen linken Ecke.
-* Offset für Steuerkanal der weißen LED bei Wert <code>3</code>, da LED-Farbe an vierter Position in der Ansteuerungsreihenfolge (LED-Bauart RGBW).
+* Offset für Steuerkanal der weißen LED bei Wert {{Manual Value | XML value | 3}}</code>, da LED-Farbe an vierter Position in der Ansteuerungsreihenfolge (LED-Bauart RGBW).
 <!--|-
-| style="width: 200px" | RGBWA-Matrix mit fünf Zeilen und fünf Spalten, automatisch gepatcht
+| RGBWA-Matrix mit fünf Zeilen und fünf Spalten, automatisch gepatcht
-| style="width: 1000px" | <syntaxhighlight lang="xml">
+| <syntaxhighlight lang="xml">
 <matrix dmxchannel="0" rows="5" columns="5" whiteoffset="3" amberoffset="4" />
 </syntaxhighlight>
-Matrix mit fünf Zeilen und fünf Spalten, wobei die Adressierung automatisch von links oben zeilenweise nach rechts unten erfolgt:
+Matrix mit {{Manual Value | XML value | fünf}} Zeilen und {{Manual Value | XML value | 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.
+* Erster Pixel der RGBWA-Matrix auf DMX-Kanal {{Manual Value | DMX channel | 1}}, angeordnet in der oberen linken Ecke.
-* Offset für Steuerkanal der weißen LED bei Wert <code>3</code>, da LED-Farbe an vierter Position in der Ansteuerungsreihenfolge (LED-Bauart RGBWA).
+* Offset für Steuerkanal der weißen LED bei Wert {{Manual Value | XML value | 3}}, da LED-Farbe an vierter Position in der Ansteuerungsreihenfolge (LED-Bauart RGBWA).
-* Offset für Steuerkanal der amberfarbenen LED bei Wert <code>4</code>, da LED-Farbe an fünfter Position in der Ansteuerungsreihenfolge.-->
+* Offset für Steuerkanal der amberfarbenen LED bei Wert {{Manual Value | XML value | 4}}, da LED-Farbe an fünfter Position in der Ansteuerungsreihenfolge.-->
 |}
 {| class="wikitable toptextcells"
@@ Zeile 130: / Zeile 123: @@
 ''Für die zulässigen Werte der Attribute <code>rows</code> und <code>columns</code> siehe vorherigen Abschnitt einfache Matrix.''
-<!--{{BoxWichtig|Text=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.}}-->
+<!--{{Manual Box | de | Important | 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 ===
-{| class="wikitable toptextcells"
+{{DMXC3 Manual-Tableheader DDF-Code examples | de}}
-|-
+| Monochrome Matrix mit fünf Zeilen und fünf Spalten, automatisch gepatcht
-! Variante !! Code
+| <syntaxhighlight lang="xml">
-|-
-| style="width: 200px" | Monochrome Matrix mit fünf Zeilen und fünf Spalten, automatisch gepatcht
-| style="width: 1000px" | <syntaxhighlight lang="xml">
 <matrix dmxchannel="0" monochrome="true" rows="5" columns="5"/>
 </syntaxhighlight>
-Matrix mit fünf Zeilen und fünf Spalten, wobei die Adressierung automatisch von links oben zeilenweise nach rechts unten erfolgt:
+Matrix mit {{Manual Value | XML value | fünf}} Zeilen und {{Manual Value | XML value | 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.
+* Erster Pixel auf DMX-Kanal {{Manual Value | DMX channel | 1}}, angeordnet in der oberen linken Ecke.
-* Attribut <code>monochrome</code> mit dem Wert <code>true</code> generiert eine Matrix mit nur einer Farbe.
+* Attribut {{Manual Value | XML attribute | monochrome}} mit dem Wert {{Manual Value | XML value | true}} generiert eine Matrix mit nur einer Farbe.
 |-
 | Monochrome Matrix mit einer Zeile und vier Spalten, manuell gepatcht
@@ Zeile 154: / Zeile 144: @@
 </matrix>
 </syntaxhighlight>
-Matrix einer Zeile und vier Spalten, wobei die Adressierung manuell von links nach rechts erfolgt:
+Matrix {{Manual Value | XML value | einer}} Zeile und {{Manual Value | XML value| vier}} Spalten, wobei die Adressierung manuell von links nach rechts erfolgt:
-* Attribut <code>monochrome</code> mit dem Wert <code>true</code> generiert eine Matrix mit nur einer Farbe.
+* Attribut {{Manual Value | XML attribute | monochrome}} mit dem Wert {{Manual Value | XML value | true}} generiert eine Matrix mit nur einer Farbe.
-* 1. Pixel (links): DMX-Kanal 1.
+* 1. Pixel (links): DMX-Kanal {{Manual Value | DMX channel | 1}}.
-* 2. Pixel: DMX-Kanal 2.
+* 2. Pixel: DMX-Kanal {{Manual Value | DMX channel | 2}}.
-* 3. Pixel: DMX-Kanal 3.
+* 3. Pixel: DMX-Kanal {{Manual Value | DMX channel | 3}}.
-* 4. Pixel (rechts): DMX-Kanal 4.
+* 4. Pixel (rechts): DMX-Kanal {{Manual Value | DMX channel | 4}}.
 |}
 {| class="wikitable toptextcells"
@@ Zeile 173: / Zeile 163: @@
 ''Für die zulässigen Werte der Attribute <code>rows</code> und <code>columns</code> siehe vorherigen Abschnitt einfache Matrix.''
+[[en: Matrix (DDF-Syntax) DMXC3]]
 [[Kategorie: DDF DMXControl 3]]