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

Aus Deutsches DMXC-Wiki
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(16 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Kapitelüberschrift|Version=DMXControl 3.1.2}} {{Inuse}}
{{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_Gobo_DMXC3
| vorLink = Radix (DDF-Syntax)_DMXC3
|vorText = Gobo
| vorText = Radix
}}
}}




==Matrix==
= Matrix =
== Grundlegender Aufbau ==
{| class="wikitable toptextcells"
{| class="wikitable toptextcells"
|-
|-
! Tag !! Variante !! Code
! Variante !! Code
|-
|-
|style="width: 10em"| <code>matrix</code>  
| style="width: 200px" | RGB-Matrix mit fünf Zeilen und fünf Spalten, automatisch gepatcht
|style="width: 10em"| RGB-Matrix mit zwei Zeilen und drei Spalten
| style="width: 1000px" | <syntaxhighlight lang="xml">
|style="width: 60em"| <source 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="1" />
     <red dmxchannel="0" />
     <green dmxchannel="2" />
     <green dmxchannel="1" />
     <blue dmxchannel="3" />
     <blue dmxchannel="2" />
   </rgb>
   </rgb>
   <rgb>
   <rgb>
     <red dmxchannel="4" />
     <red dmxchannel="3" />
     <green dmxchannel="5" />
     <green dmxchannel="4" />
     <blue dmxchannel="6" />
     <blue dmxchannel="5" />
   </rgb>
   </rgb>
   <rgb>
   <rgb>
     <red dmxchannel="7" />
     <red dmxchannel="6" />
     <green dmxchannel="8" />
     <green dmxchannel="7" />
     <blue dmxchannel="9" />
     <blue dmxchannel="8" />
   </rgb>
   </rgb>
   <rgb>
   <rgb>
     <red dmxchannel="10" />
     <red dmxchannel="9" />
     <green dmxchannel="11" />
     <green dmxchannel="10" />
     <blue dmxchannel="12" />
     <blue dmxchannel="11" />
   </rgb>
   </rgb>
   <rgb>
   <rgb>
     <red dmxchannel="13" />
     <red dmxchannel="12" />
     <green dmxchannel="14" />
     <green dmxchannel="13" />
     <blue dmxchannel="15" />
     <blue dmxchannel="14" />
   </rgb>
   </rgb>
   <rgb>
   <rgb>
     <red dmxchannel="16" />
     <red dmxchannel="15" />
     <green dmxchannel="17" />
     <green dmxchannel="16" />
     <blue dmxchannel="18" />
     <blue dmxchannel="17" />
   </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:
* 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.
|}
 
{| class="wikitable toptextcells"
|-
! Attribut !! rows !! colums
|-
! style="width: 200px; vertical-align:top" | Beschreibung
| style="width: 175px" | Anzahl der Zeilen der Matrix
| style="width: 175px" | Anzahl der Spalten der Matrix
|-
! style="vertical-align:top" | Zulässiger Attributwert
| <code>1</code> bis <code>256</code>
| <code>1</code> bis <code>256</code>
|}
 
{{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"
|-
! Variante !! Code
|-
| 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:
* 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).
<!--|-
| style="width: 200px" | RGBWA-Matrix mit fünf Zeilen und fünf Spalten, automatisch gepatcht
| style="width: 1000px" | <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:
* 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 amberfarbenen LED bei Wert <code>4</code>, da LED-Farbe an fünfter Position in der Ansteuerungsreihenfolge.-->
|}
{| class="wikitable toptextcells"
|-
! Attribut !! whiteoffset <!--!! amberoffset -->
|-
! style="width: 200px; vertical-align:top"| Beschreibung
| style="width: 175px" | Offset der weißen LED
<!--| style="width: 175px" | Offset der amberfarbenen LED-->
|-
! style="vertical-align:top" | Zulässiger Attributwert
| 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:
* <code>amberoffset</code>
* <code>cyanoffset</code>
* <code>indigooffset</code>
* <code>limeoffset</code>
* <code>uvoffset</code>
* <code>whiteoffset</code>-->
 
''Für die zulässigen Werte der Attribute <code>rows</code> und <code>columns</code> siehe vorherigen Abschnitt einfache Matrix.''
 
<!--{{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"
|-
! Variante !! Code
|-
| 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:
* 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.
|-
| Monochrome Matrix mit einer Zeile und vier Spalten, manuell gepatcht
| <syntaxhighlight lang="xml">
<matrix rows="1" columns="4" monochrome="true" >
  <dimmer dmxchannel="0" />
  <dimmer dmxchannel="1" />
  <dimmer dmxchannel="2" />
  <dimmer dmxchannel="3" />
</matrix>
</syntaxhighlight>
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.
* 1. Pixel (links): DMX-Kanal 1.
* 2. Pixel: DMX-Kanal 2.
* 3. Pixel: DMX-Kanal 3.
* 4. Pixel (rechts): DMX-Kanal 4.
|}
{| class="wikitable toptextcells"
|-
! Attribut !! monochrome
|-
! style="width: 200px; vertical-align:top" | Beschreibung
| style="width: 175px" | Generierung einer monochromen (einfarbigen) Matrix
|-
! style="vertical-align:top" | Zulässiger Attributwert
| <code>true</code>
|}
|}
''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]]

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.