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

Aus Deutsches DMXC-Wiki
KKeine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(9 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
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 = DDF-Syntax_Farbe_DMXC3
| zurückLink = Color (DDF-Syntax)_DMXC3
|zurückText = Farbe
| zurückText = Farbe (Color)
|vorLink = DDF-Syntax_Radix_DMXC3
| vorLink = Radix (DDF-Syntax)_DMXC3
|vorText = Radix
| vorText = Radix
}}
}}




=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>
     <red dmxchannel="01" />
     <red dmxchannel="0" />
     <green dmxchannel="1" />
     <green dmxchannel="1" />
     <blue dmxchannel="2" />
     <blue dmxchannel="2" />
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==
{{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 ==
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.
* 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 <code>3</code>, 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 <code>4</code>, da LED-Farbe an fünfter Position in der Ansteuerungsreihenfolge.-->
|}
|}
{| class="wikitable toptextcells"
{| class="wikitable toptextcells"
|-
|-
! 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  
| größer <code>3</code>
| größer <code>3</code>
| größer <code>3</code>
<!--| größer <code>3</code>-->
|}
|}
Analog zu <code>whiteoffset</code> und <code>amberoffset</code> sind folgende Angaben für RGBx-Matrizen, das heißt für Matrizen mit mehr als drei Farben pro LED-Chip zulässig:
<!--Analog zu <code>whiteoffset</code> und <code>amberoffset</code> sind folgende Angaben für RGBx-Matrizen, das heißt für Matrizen mit mehr als drei Farben pro LED-Chip zulässig:
* <code>amberoffset</code>
* <code>amberoffset</code>
* <code>cyanoffset</code>
* <code>cyanoffset</code>
Zeile 110: Zeile 126:
* <code>limeoffset</code>
* <code>limeoffset</code>
* <code>uvoffset</code>
* <code>uvoffset</code>
* <code>whiteoffset</code>
* <code>whiteoffset</code>-->


''Für die zulässigen Werte der Attribute <code>rows</code> und <code>columns</code> siehe vorherigen Abschnitt einfache Matrix.''
''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==
=== 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 153:
   <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 165:
! 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>
|}
|}
''Für die zulässigen Werte der Attribute <code>rows</code> und <code>columns</code> siehe vorherigen Abschnitt einfache Matrix.''
''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]]
[[Kategorie: DDF DMXControl 3]]

Aktuelle Version vom 10. November 2024, 14:59 Uhr

Blockdevice.png Artikel beschreibt
DMXControl 3.2.0
Matrix (DDF-Syntax) DMXC3
Arrow back.png Farbe (Color)
Radix Arrow forw.png
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="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


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