Matrix (DDF-Syntax) DMXC3: Unterschied zwischen den Versionen

Aus Deutsches DMXC-Wiki
(Links an neues Namensschema angepasst)
(Formatierung optimiert und Struktur verbessert)
Zeile 3: Zeile 3:
{{DMXC3_Manual-Navigation_DDF
{{DMXC3_Manual-Navigation_DDF
|zurückLink = Color_(DDF-Syntax)_DMXC3
|zurückLink = Color_(DDF-Syntax)_DMXC3
|zurückText = Farbe
|zurückText = Farbe (Color)
|vorLink = Radix_(DDF-Syntax)_DMXC3
|vorLink = Radix_(DDF-Syntax)_DMXC3
|vorText = Radix
|vorText = Radix
Zeile 10: Zeile 10:


= Matrix =
= Matrix =
== Einfache Matrizen ==
== Grundlegender Aufbau ==
{| class="wikitable toptextcells"
{| class="wikitable toptextcells"
|-
|-
! Variante !! Code
! Variante !! Code
|-
|-
| style="width: 10em" | RGB-Matrix mit zwei Zeilen und drei Spalten, manuell gepatcht
| style="width: 200px" | RGB-Matrix mit fünf Zeilen und fünf Spalten, automatisch gepatcht
| style="width: 60em" | <source lang="xml">
| 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:
* Erster Pixel auf DMX-Kanal 1 bis 3, angeordnet in der oberen linken Ecke.
|-
| RGB-Matrix mit zwei Zeilen und drei Spalten, manuell gepatcht
| <syntaxhighlight lang="xml">
<matrix rows="2" columns="3">
<matrix rows="2" columns="3">
   <rgb>
   <rgb>
Zeile 49: Zeile 56:
   </rgb>
   </rgb>
</matrix>
</matrix>
</source>
</syntaxhighlight>
Matrix mit zwei Zeilen und drei Spalten, wobei die Adressierung manuell von links oben zeilenweise nach rechts unten erfolgt:
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 links oben: DMX-Kanäle 1 bis 3.
Zeile 61: Zeile 68:
! Attribut !! rows !! colums
! Attribut !! rows !! colums
|-
|-
! style="width: 10em; vertical-align:top" | Beschreibung
! style="width: 200px; vertical-align:top" | Beschreibung
| style="width: 10em" | Anzahl der Zeilen der Matrix
| style="width: 175px" | Anzahl der Zeilen der Matrix
| style="width: 10em" | Anzahl der Spalten der Matrix
| style="width: 175px" | Anzahl der Spalten der Matrix
|-
|-
! style="vertical-align:top" | Zulässiger Attributwert  
! style="vertical-align:top" | Zulässiger Attributwert  
| <code>1 bis 256</code>
| <code>1</code> bis <code>256</code>
| <code>1 bis 256</code>
| <code>1</code> bis <code>256</code>
|}
|}


== Matrizen mit RGB+-Farben ==
== Zusätzliche Attribute ==
Die Matrix kann durch weitere Attribute weiter individuell angepasst werden:
* '''<code>matrix</code> (Haupttag)'''
** Farboffset: Angabe der DMX-Kanäle für die RGB+-Farben weiß, amber, etc.
** <code>monochrome</code>: Matrix als einfarbige (monochrome) Matrix
** <code>rowfirst</code>: Änderung der automatischen Patchreihenfolge
 
=== Matrizen mit RGB+-Farben ===
{| class="wikitable toptextcells"
{| class="wikitable toptextcells"
|-
|-
! Variante !! Code
! Variante !! Code
|-  
|-  
| style="width: 10em" | RGBW-Matrix mit zwei Zeilen und sechs Spalten, automatisch gepatcht
| style="width: 200px" | RGBW-Matrix mit zwei Zeilen und sechs Spalten, automatisch gepatcht
| style="width: 60em" | <source lang="xml">
| style="width: 1000px" | <syntaxhighlight lang="xml">
<matrix dmxchannel="0" rows="2" columns="6" whiteoffset="3" />
<matrix dmxchannel="0" rows="2" columns="6" whiteoffset="3" />
</source>
</syntaxhighlight>
Matrix mit zwei Zeilen und sechs Spalten, wobei die Adressierung automatisch von links oben zeilenweise nach rechts unten erfolgt:
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.
* 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 <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 <code>3</code>, da LED-Farbe an vierter Position in der Ansteuerungsreihenfolge (LED-Bauart RGBW).
<!--|-
<!--|-
| style="width: 10em" | RGBWA-Matrix mit fünf Zeilen und fünf Spalten, automatisch gepatcht
| style="width: 200px" | RGBWA-Matrix mit fünf Zeilen und fünf Spalten, automatisch gepatcht
| style="width: 60em" | <source lang="xml">
| style="width: 1000px" | <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" />
</source>
</syntaxhighlight>
Matrix mit fünf Zeilen und fünf Spalten, wobei die Adressierung automatisch von links oben zeilenweise nach rechts unten erfolgt:
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.
* Erster Pixel der RGBWA-Matrix auf DMX-Kanal 1, angeordnet in der oberen linken Ecke.
Zeile 96: Zeile 110:
! Attribut !! whiteoffset <!--!! amberoffset -->
! Attribut !! whiteoffset <!--!! amberoffset -->
|-
|-
! style="width: 10em; vertical-align:top"| Beschreibung
! style="width: 200px; vertical-align:top"| Beschreibung
| style="width: 10em" | Offset der weißen LED
| style="width: 175px" | Offset der weißen LED
<!--| style="width: 10em" | Offset der amberfarbenen LED-->
<!--| style="width: 175px" | Offset der amberfarbenen LED-->
|-
|-
! style="vertical-align:top" | Zulässiger Attributwert  
! style="vertical-align:top" | Zulässiger Attributwert  
Zeile 116: Zeile 130:
<!--{{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.}}-->
<!--{{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.}}-->


== Monochrome (einfarbige) Matrizen ==
=== Monochrome (einfarbige) Matrizen ===
{| class="wikitable toptextcells"
{| class="wikitable toptextcells"
|-
|-
! Variante !! Code
! Variante !! Code
|-
|-
|style="width: 10em"| Monochrome Matrix mit fünf Zeilen und fünf Spalten, automatisch gepatcht
| style="width: 200px" | Monochrome Matrix mit fünf Zeilen und fünf Spalten, automatisch gepatcht
|style="width: 60em"| <source lang="xml">
| style="width: 1000px" | <syntaxhighlight lang="xml">
<matrix dmxchannel="0" monochrome="true" rows="5" columns="5"/>
<matrix dmxchannel="0" monochrome="true" rows="5" columns="5"/>
</source>
</syntaxhighlight>
Matrix mit fünf Zeilen und fünf Spalten, wobei die Adressierung automatisch von links oben zeilenweise nach rechts unten erfolgt:
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.
* Erster Pixel auf DMX-Kanal 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 <code>monochrome</code> mit dem Wert <code>true</code> generiert eine Matrix mit nur einer Farbe.
|-
|-
|style="width: 10em"| Monochrome Matrix mit einer Zeile und vier Spalten, manuell gepatcht
| Monochrome Matrix mit einer Zeile und vier Spalten, manuell gepatcht
|style="width: 60em"| <source lang="xml">
| <syntaxhighlight lang="xml">
<matrix rows="1" columns="4" monochrome="true" >
<matrix rows="1" columns="4" monochrome="true" >
   <dimmer dmxchannel="0" />
   <dimmer dmxchannel="0" />
Zeile 137: Zeile 151:
   <dimmer dmxchannel="3" />
   <dimmer dmxchannel="3" />
</matrix>
</matrix>
</source>
</syntaxhighlight>
Matrix einer Zeile und vier Spalten, wobei die Adressierung manuell von links nach rechts erfolgt:
Matrix einer Zeile und 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 <code>monochrome</code> mit dem Wert <code>true</code> generiert eine Matrix mit nur einer Farbe.
Zeile 149: Zeile 163:
! Attribut !! monochrome
! Attribut !! monochrome
|-
|-
!style="width: 10em; vertical-align:top"| Beschreibung
! style="width: 200px; vertical-align:top" | Beschreibung
|style="width: 10em"| Generierung einer monochromen (einfarbigen) Matrix
| style="width: 175px" | Generierung einer monochromen (einfarbigen) Matrix
|-
|-
!style="vertical-align:top"| Zulässiger Attributwert  
! style="vertical-align:top" | Zulässiger Attributwert  
| <code>true</code>
| <code>true</code>
|}
|}

Version vom 27. Juli 2020, 08:56 Uhr

Books.png Matrix (DDF-Syntax) DMXC3 Artikel beschreibt
DMXControl 3.2.0


Inhaltsverzeichnis
Teil 1: Grundlagen
Teil 2: Funktionen
Teil 3: Procederes
Teil 4: Beispiele


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="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

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.