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

Aus Deutsches DMXC-Wiki
KKeine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(12 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Kapitelüberschrift|Version=DMXControl 3.1.2}} {{Inuse}}
{{Manual Header
 
| Type = DMXC3 DDFs
 
| Version = 3.2.3
{{DMXC3_Manual-Navigation_DDF
| zurückLink = Einführung (DDF-Syntax) DMXC3
|zurückLink = DDF-Einführung_DMXC3
| zurückText = Allgemeine Einführung
|zurückText = Allgemeine Einführung
| vorLink = Funktionselemente (DDF-Syntax) DMXC3
|vorLink = DDF-Grundregeln_DMXC3
| vorText = Funktionselemente
|vorText = Grundregeln der DDF-Erstellung
}}
}}




=Grundaufbau der DDF=
= Grundaufbau der DDF =
Das DDF für DMXControl 3 besteht aus vier Teilen:
Das DDF für DMXControl 3 besteht aus vier Teilen:
* '''Basisangaben''' mit grundlegenden Angaben zum DDF selbst wie DDF-Version und Bild
* '''Basisangaben''' mit grundlegenden Angaben zum DDF selbst wie DDF-Version und Bild
Zeile 16: Zeile 15:
* '''Funktionen''' mit den Funktionen jedes DMX-Kanals und zugehörigen Wertebereichen
* '''Funktionen''' mit den Funktionen jedes DMX-Kanals und zugehörigen Wertebereichen
* '''Procedures''' für spezielle Geräte-Funktionen wie Reset oder Lampen ein- oder ausschalten
* '''Procedures''' für spezielle Geräte-Funktionen wie Reset oder Lampen ein- oder ausschalten
<br />
 
<source lang="xml">
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<?xml version="1.0" encoding="utf-8"?>
<device image="bild.png" type="DMXDevice" dmxaddresscount="1" dmxcversion="3" ddfversion="1" subdevice="no">
<device image="bild.png" type="DMXDevice" dmxaddresscount="1" dmxcversion="3.2.3" ddfversion="1.0.0" subdevice="no">
   <information>
   <information>
     ...
     ...
Zeile 30: Zeile 29:
   </procedures>
   </procedures>
</device>
</device>
</source>
</syntaxhighlight>
<br />
Insbesondere der zweite Teil ist wichtig für die Aufbereitung des DDFs durch die GUI, damit alle Steuerelemente wie das Device Control und die Controls richtig dargestellt werden. Des Weiteren greift die HAL auf diese Informationen zurück, um die eingestellten Lichtstimmungen in den Cues eines Projekts abzuspeichern.


=Funktionsteile=
Insbesondere der zweite Teil ist wichtig für die Aufbereitung des DDFs durch die {{Manual Windowcaption|[[GUI DMXC3|Bedienoberfläche (GUI)]]}}, damit alle Steuerelemente wie die {{Manual Windowcaption|[[Device Control DMXC3|Gerätesteuerung (Device Control)]]}} und die {{Manual Windowcaption|[[Control Panel DMXC3|Steuerungsfenster (Control Panel)]]}} richtig dargestellt werden. Des Weiteren greift der {{Manual Windowcaption|[[Hardware Abstraction Layer (HAL) DMXC3|Hardware Abstraction Layer (HAL)]]}} auf diese Informationen zurück, um die eingestellten Lichtstimmungen in den {{Manual Windowcaption|[[Cuelist DMXC3|Szenen (Cues)]]}} eines Projekts abzuspeichern.
==Basisinformationen==
 
= Funktionsteile =
== Basisinformationen ==
Im Basisteil des DDFs sind allgemeine Informationen zur Datei sowie das Element <code>device</code> enthalten. Der Tag <code>device</code> umfasst folgende Attribute:
Im Basisteil des DDFs sind allgemeine Informationen zur Datei sowie das Element <code>device</code> enthalten. Der Tag <code>device</code> umfasst folgende Attribute:


{| class="wikitable toptextcells"
{| class="wikitable toptextcells"
|-
|- class="hintergrundfarbe6"
! Attribut !! Beschreibung !! Standard-Wert !! Zulässige Werte !! Optional
! Attribut !! Beschreibung !! Standard-Wert !! Zulässige Werte !! Optional
|-
|-
|style="width: 10em"| <code>image</code>
| style="width: 10em"| <code>image</code>
|style="width: 30em"| Bild-Datei des DDFs
| style="width: 30em"| Bild-Datei des DDFs
|style="width: 10em"| Nicht vorhanden
| style="width: 10em"| Nicht vorhanden
|style="width: 20em"| Dateiname des Bilds als *.png-Datei
| style="width: 20em"| Dateiname des Bilds als *.png-Datei
|style="width: 10em"|  
| style="width: 10em"|  
|-
|-
| <code>type</code>
| <code>type</code>
Zeile 52: Zeile 51:
| <code>DMXDevice</code>
| <code>DMXDevice</code>
| DMXDevice
| DMXDevice
|  
 
|-
{{DMXC3 Manual-Tablesection | S1 | 5 | Allgemeine Informationen zum DDF}}
 
| <code>dmxaddresscount</code>
| <code>dmxaddresscount</code>
| Gesamtzahl der DMX-Kanäle des Geräts
| Gesamtzahl der DMX-Kanäle des Geräts
Zeile 62: Zeile 62:
| <code>dmxcversion</code>
| <code>dmxcversion</code>
| Erforderliche Programmversion zur Verwendung des DDFs
| Erforderliche Programmversion zur Verwendung des DDFs
| <code>3</code>
| <code>3.0.0</code>
| 3, 3.0.1, 3.0.2, 3.1, 3.1.1 und alle zukünftigen Programmversion
| <code>3.0.2</code>, <code>3.1.3</code>, <code>3.2.0</code> und alle zukünftigen Programmversion
|  
|  
|-
|-
Zeile 69: Zeile 69:
| Version des DDFs
| Version des DDFs
| Nicht vorhanden
| Nicht vorhanden
| 1, 1.1, 1.2 usw.
| <code>1.0.0</code>, <code>1.1.0</code>, <code>1.2.0</code> usw.
|  
|  
|-
|-
| <code>subdevice</code>
| <code>subdevice</code>
| Zusatzgerät für vorhandenes Gerät wie zum Beispiel Colorscroller für klassische PAR-Scheinwerfer
| Zusatzgerät für vorhandenes Gerät wie zum Beispiel Colorscroller für klassische PAR-Scheinwerfer
| <code>No</code>
| <code>no</code>
| No oder yes
| <code>no</code> oder <code>yes</code>
| X
| X
|-
 
{{DMXC3 Manual-Tablesection | S1 | 5 | Steuerung der Anzeige in der Bühnenansicht (Stage View)}}
 
| <code>defaultdisplaystyle</code>
| <code>defaultdisplaystyle</code>
| Standart Anzeige-Modus in der StageView
| Standart Anzeige-Modus in der Bühnenansicht
| <code>preview</code>
| <code>preview</code>
| custom, image ober preview
| <code>custom</code>, <code>image</code> ober <code>preview</code>
| X
| X
|-
|-
Zeile 87: Zeile 89:
| Ausgangspunkt der Lichtfarbe des Leuchtmittels des Gerätes
| Ausgangspunkt der Lichtfarbe des Leuchtmittels des Gerätes
| <code>#ffffff</code>
| <code>#ffffff</code>
| Jede HTML-Farbe (#000000 - #ffffff)
| Jede HTML-Farbe (<code>#000000</code> - <code>#ffffff</code>)
| X
 
{{DMXC3 Manual-Tablesection | S1 | 5 | Attribute zum Ansprechen der RGB+-Farben}}
 
| <code>whitechanneldefaultmode</code>
| Das Verhalten, wie der Weiß-Kanal (White channel) angesprochen wird
| <code>onlywhite</code>
| <code>none</code>, <code>addwhite</code> oder <code>onlywhite</code>
| X
| X
|-
|-
| <code>whitechanneldefaultmode</code>
| <code>amberchanneldefaultmode</code>
| Das Verhalten, wie der White-Kanal angesprochen wird
| Das Verhalten, wie der Amber-Kanal angesprochen wird
| <code>onlywhite</code>
| <code>onlywhite</code>
| none, addwhite oder onlywhite
| <code>none</code>, <code>add</code> oder <code>only</code>
| X
| X
|}
|}


Das Element <code>device</code> umklammert alle Informationen des DDFs. Angaben außerhalb des Tags führen zu Fehlern beim Einfügen des DDFs in ein Projekt.
Das Element <code>device</code> umklammert alle Informationen des DDFs. Angaben außerhalb des Tags führen zu Fehlern beim Einfügen des DDFs in ein Projekt.
Beim Eintragen des Dateinamens für Icon in der Stage View ist nur der Dateiname inkl. der Dateiendung einzusetzen. Die Angabe des Pfades ist nicht erforderlich.


==Geräteinformation==
Beim Eintragen des Dateinamens für Icon in der Bühnenansicht ist nur der Dateiname inkl. der Dateiendung einzusetzen. Die Angabe des Pfades ist nicht erforderlich.
Im Informationsteil werden alle grundlegenden Informationen zum Gerät hinterlegt, für dies das DDF erstellt wurde. Mit Hilfe dieser Informationen erfolgt auch die Einsortierung des neuen DDFs im Device Manager. Alle Angaben werden durch das Element <code><information> ... </information></code> eingeklammert.
 
=== Arbeitsweise der zusätzlichen LED-Farben ===
Alle zusätzlichen LED-Farben wie weiß, amber, uv etc., die neben den RGB-LEDs im Gerät verbaut sind, werden nach dem Hinzufügen des Geräts zu einem Projekt standardmäßig erst einmal nicht angesteuert. In den Eigenschaften des Geräts, aufzurufen zum Beispiel über die Bühnenansicht, kann unter dem Eintrag ''Automix Mode'' das Verhalten für jedes Gerät einzeln angepasst werden, hier am Beispiel der weißen LED:
* ''None'': Keine Ansteuerung der weißen LED (Standard-Einstellung)
* ''Add white'': Alle vier LEDs bei 100% für die Farbe weiß
* ''Only white'': Nur weiße LEDs bei 100% für die Farbe weiß
 
== Geräteinformation ==
Im Informationsteil werden alle grundlegenden Informationen zum Gerät hinterlegt, für dies das DDF erstellt wurde. Mit Hilfe dieser Informationen erfolgt auch die Einsortierung des neuen DDFs im Dialog {{Manual Windowcaption|[[Device Manager DMXC3|Geräte hinzufügen (Add Device)]]}}. Alle Angaben werden durch das Element <code><information> ... </information></code> eingeklammert.


{| class="wikitable toptextcells"
{| class="wikitable toptextcells"
Zeile 107: Zeile 124:
! Tag !! Beschreibung !! Optional
! Tag !! Beschreibung !! Optional
|-
|-
|style="width: 10em"| <code>model</code>
| style="width: 10em" | <code>model</code> || style="width: 30em" | Bezeichnung des Geräts gemäß Bedienungsanleitung || style="width: 10em" |  
|style="width: 30em"| Bezeichnung des Geräts gemäß Bedienungsanleitung
|style="width: 10em"|  
|-
|-
| <code>vendor</code>
| <code>vendor</code> || Hersteller des Geräts gemäß vorgegebener Herstellerliste ||
| Hersteller des Geräts gemäß vorgegebener Herstellerliste
|-
|  
| <code>author</code> || Autor des DDFs ||  
|-
|-
| <code>author</code>
| <code>mode</code> || DMX-Modus bzw. Kanalbelegung || X
| Autor des DDFs
|  
|-
|-
| <code>mode</code>
| <code>electrical</code> || Elektrische Leistungsaufnahme des Geräts || X
| DMX-Modus bzw. Kanalbelegung
| X
|-
|-
| <code>comment</code>
| <code>comment</code> || Kommentar zum DDF oder Gerät || X
| Kommentar zum DDF oder Gerät
| X
|}
|}


==Funktionen==
=== Elektrische Leistungsaufnahme ===
Im Funktionsteil werden die eigentlichen Funktionen des Geräts eingetragen, wie beispielsweise Pan und Tilt, Dimmer, Farbrad, Strobe etc. Welche Funktionen aktuell unterstützt werden, sind im Syntax: die möglichen Funktions-Bausteine im Detail inklusive Code-Beispielen aufgelistet. Alle Angaben werden durch das Element <code><functions> ... </functions></code> eingeklammert.
Der Tag <code>electrical</code> in dem Block <code><information></code> ermöglicht die optionale Angabe der elektrischen Leistungsaufnahme durch das Gerät. Diese Informationen verwendet DMXControl 3 für das {{Manual Windowcaption|[[Electricity_DMXC3|Lastmanagement]]}}, um die theoretische Gesamtleistung der am Veranstaltungsort verfügbaren Stromquellen zu berechnen. Es gibt zwei Arten der Leistungsaufnahme, mit denen DMXControl 3 arbeitet:
 
* Konstante (statische) Leistungsaufnahme
===Unterfunktionen eines DMX-Kanals===
* Dynamische Leistungsaufnahme
Jede einzelne Funktion eines DMX-Kanals kann durch eine Unterfunktion erweitert werden. Prominentestes Beispiel ist der Goboshake, welcher sich jeweils zu dem aktuell ausgewählten Gobo zusätzlich aktiviert lässt. Diese Funktion liegt meist auf dem gleichen DMX-Kanal wie die Funktion zum Auswählen des Gobos, in der Regel aber in einem anderen Wertebereich.


===Ergänzende Funktionen für einen DMX-Kanal===
Die konstante (statischen) Leistungsaufnahme ist über das Tag <code>static</code> definiert. Zu der konstanten Leistungsaufnahme zählen insbesondere Moving-Heads oder Scanner mit einer Entladungslampe als Leuchtmittel. Hier ändert sich die Leistungsaufnahme nämlich nicht, egal ob der Shutter und der Dimmer des Geräts geöffnet sind oder nicht. Zu der konstanten Leistungsaufnahme gehört aber auch der Stromverbrauch der Elektronik selbst, wenn das Gerät eingeschaltet und betriebsbereit ist.
Neben den Unterfunktionen gibt es noch ergänzende Funktionen Diese können entweder auf dem gleichen DMX-Kanal liegen, wie zum Beispiel das kontinuierliche Drehen des Farbrads in einem Moving-Head oder Scanner. Im Falle der Goborotation liegt die ergänzende Funktion auf einem getrennten DMX-Kanal. Hier wird über den ersten DMX-Kanal das Gobo ausgewählt und über den zweiten DMX-Kanal bestimmt, wie schnell sich das Gobo in welche Richtung drehen soll.


==Procedures==
Die dynamische Leistungsaufnahme korrespondiert mit dem Wert des Dimmers des Geräts. Diese Konstellation ist vor allem bei klassischen Halogenscheinwerfern anzutreffen, die an Dimmpacks angeschlossen sind. Darüber hinaus kann DMXControl 3 die theoretische Leistungsaufnahme beim Dimmen von LED-Scheinwerfern und Moving-Heads berechnen, wenn die Werte ebenfalls im Tag <code>dimmer</code> gepflegt sind.
Procedures werden nur eingesetzt, um selten benutzte Funktionen am Gerät zu aktivieren, die für den Live-Betrieb in der Regel nicht erforderlich sind. Üblicherweise verfügen insbesondere Moving-Heads oder Scanner über Funktionen zur Durchführung eines Resets oder zum Ein- bzw. Ausschalten des Leuchtmittels. Alle diese Funktionen werden ausgeführt, wenn ein bestimmter DMX-Wert auf dem zugehörigen DMX-Kanal für eine bestimmte Zeit gehalten wird. Procedures können nicht in Cues abgespeichert werden und lassen sich nur über die Stage View aufrufen.
 
=Gemeinsamkeiten der Funktionen=
==Genauigkeit bzw. Auflösung von Funktionen==
Auf jedem DMX-Kanal können insgesamt 256 verschiedene Werte übertragen werden und zwar im Bereich von DMX-Wert 0 bis DMX-Wert 255. Dies beschreibt die klassische Auflösung bzw. Genauigkeit eines DMX-Kanals von 8 bit.
Um bei bestimmten Funktionen wie zum Beispiel bei Pan, Tilt oder beim Dimmer feine Auflösungen zu erzielen, werden weitere DMX-Kanäle hinzugezogen, um die Auflösung zu erhöhen. In diesem Fall spricht man dann von einer Auflösung mit 16 bit oder der zweite DMX-Kanal für die Pan-Funktion wird mit Pan fine bezeichnet.
DMXControl 3 unterstützt aktuell Auflösungen von Funktionen bis 32 bit. Für hierfür werden dann vier DMX-Kanäle zusammengefasst, um die Funktion in dieser Auflösung darzustellen. In den DDFs kommen dabei folgende Bezeichnungen zum Einsatz:
* <code>dmxchannel</code> für 8-bit-Auflösung
* <code>finedmxchannel</code> für 16-bit-Auflösung
* <code>ultradmxchannel</code> für 24-bit-Auflösung
* <code>ultrafinedmxchannel</code> für 32-bit-Auflösung
Es ist dabei zu beachten, dass bei der 32-bit-Auflösung auch alle vier DMX-Kanäle anzugeben sind. Es ist mitunter nicht unüblich, dass die vier DMX-Kanäle in der Belegung nicht direkt hintereinander angeordnet sind. Die folgende Tabelle zeigt die Definition der aktuell möglichen Auflösungen anhand des Dimmers.


{| class="wikitable toptextcells"
{| class="wikitable toptextcells"
|-
|-
! Tag !! Variante !! Code
! Variante !! Code
|-
|-
| style="width: 10em" rowspan="4" | <code>dimmer</code>
| style="width: 10em" | PAR-Scheinwerfer mit einem 1.000 Watt Leuchtmittel
| style="width: 10em" | Dimmer mit 8-bit-Auflösung
| style="width: 60em" | <syntaxhighlight lang="xml">
| style="width: 60em" | <source lang="xml">
<electrical>
<dimmer dmxchannel="0" />
  <dimmer>1000</dimmer>
</source>
</electrical>
Dimmer auf DMX-Kanal 1
</syntaxhighlight>
Zunehmende Leistungsaufnahme des Geräts mit maximal 1.000 Watt bei voller Helligkeit (Dimmer 100%).
|-
|-
| Dimmer mit 16-bit-Auflösung
| Moving-Head mit Entladungslampe
| <source lang="xml">
| <syntaxhighlight lang="xml">
<dimmer dmxchannel="0" finedmxchannel="1" />
<electrical>
</source>
  <static>450</static>
Dimmer mit 16-bit-Auflösung auf DMX-Kanal 1 und 2
</electrical>
</syntaxhighlight>
Konstante Leistungsaufnahme des Geräts von 450 Watt.
|-
|-
| Dimmer mit 24-bit-Auflösung
| LED-Scheinwerfer
| <source lang="xml">
| <syntaxhighlight lang="xml">
<dimmer dmxchannel="0" finedmxchannel="1" ultradmxchannel="2" />
<electrical>
</source>
  <static>20</static>
Dimmer mit 24-bit-Auflösung auf DMX-Kanal 1, 2 und 3
  <dimmer>145</dimmer>
|-
</electrical>
| Dimmer mit 32-bit-Auflösung
</syntaxhighlight>
| <source lang="xml">
Nach dem Einschalten hat das Gerät eine konstante Leistungsaufnahme von 20 Watt. Die LEDs sind aus (Dimmer 0%).
<dimmer dmxchannel="0" finedmxchannel="1" ultradmxchannel="2" ultrafinedmxchannel="3" />
Die LEDs haben bei voller Helligkeit eine Leistungsaufnahme von 145 Watt. Insgesamt besitzt das Gerät eine Leistungsaufnahme von 165 Watt.
</source>
Dimmer mit 32-bit-Auflösung auf DMX-Kanal 1, 2, 3 und 4
|}
|}


==Aufbau einer Funktion auf einem DMX-Kanal==
== Funktionen ==
Liegen auf einem DMX-Kanal wie beispielsweise beim Strobe, Shutter oder Goborad mehrere Funktionen, so werden diese in zwei Kategorien unterteilt:
Im Funktionsteil werden die eigentlichen Funktionen des Geräts eingetragen, wie beispielsweise Pan und Tilt, Dimmer, Farbrad, Strobe etc. Welche Funktionen aktuell unterstützt werden, sind im Syntax: die möglichen Funktions-Bausteine im Detail inklusive Code-Beispielen aufgelistet. Alle Angaben werden durch das Element <code><functions> ... </functions></code> eingeklammert.
* <code>step</code> für Funktionen, die immer nur umgeschaltet werden, zum Beispiel das Wechseln der Farbe auf einem Farbrad
 
* <code>range</code> für Funktionen, die parallel zum Umschalten auch noch in bestimmten Bereichen variiert werden können, wie zum Beispiel die Richtung und die Geschwindigkeit der Goborotation
=== Unterfunktionen eines DMX-Kanals ===
Ein <code>step</code> besteht dabei immer aus dem eigentlichen Tag <code>step</code>, dem Attribut <code>type</code>, sowie den Attributen für den minimalen DMX-Wert <code>mindmx</code> und den maximalen DMX-Wert <code>maxdmx</code> für den <code>step</code>. Der Wert für das Attribut <code>type</code> ist immer abhängig von der Eigenschaft des DMX-Kanals, die abgebildet werden soll. Welche Werte zulässig sind, wird bei der Beschreibung der jeweiligen Eigenschaft angegeben.
Jede einzelne Funktion eines DMX-Kanals kann durch eine Unterfunktion erweitert werden. Prominentestes Beispiel ist der Goboshake, welcher sich jeweils zu dem aktuell ausgewählten Gobo zusätzlich aktiviert lässt. Diese Funktion liegt meist auf dem gleichen DMX-Kanal wie die Funktion zum Auswählen des Gobos, in der Regel aber in einem anderen Wertebereich.
<br />
 
<source lang="xml">
=== Ergänzende Funktionen für einen DMX-Kanal ===
<step type="open" mindmx="225" maxdmx="255" />
Neben den Unterfunktionen gibt es noch ergänzende Funktionen Diese können entweder auf dem gleichen DMX-Kanal liegen, wie zum Beispiel das kontinuierliche Drehen des Farbrads in einem Moving-Head oder Scanner. Im Falle der Goborotation liegt die ergänzende Funktion auf einem getrennten DMX-Kanal. Hier wird über den ersten DMX-Kanal das Gobo ausgewählt und über den zweiten DMX-Kanal bestimmt, wie schnell sich das Gobo in welche Richtung drehen soll.
</source>
<br />
Der Tag <code>range</code> ist ähnlich aufgebaut, wie der Tag <code>step</code>. Der wesentlichste Unterschied ist die Ergänzung der Attribute <code>minval</code> und <code>maxval</code>. Hier werden beispielsweise die minimale und maximale Drehzahl für die Goborotation angegeben.


Die Besonderheit ist an dieser Stelle, dass die DMX-Werte den Geschwindigkeiten zugeordnet werden. Das heißt, zur minimalen Drehzahl wird der DMX-Wert eingetragen, wo sich das Gobo am langsamsten dreht. Genauso verhält es sich mit der maximalen Drehzahl. Daher kann es vorkommen, dass die minimale Drehzahl nicht immer automatisch auch der niedrige DMX-Wert und die maximale Drehzahl beim größten DMX-Wert anliegt. Ein Code-Beispiel ist im Abschnitt Goborad zu finden.
== Procedures ==
<br />
Procedures werden nur eingesetzt, um selten benutzte Funktionen am Gerät zu aktivieren, die für den Live-Betrieb in der Regel nicht erforderlich sind. Üblicherweise verfügen insbesondere Moving-Heads oder Scanner über Funktionen zur Durchführung eines Resets oder zum Ein- bzw. Ausschalten des Leuchtmittels. Alle diese Funktionen werden ausgeführt, wenn ein bestimmter DMX-Wert auf dem zugehörigen DMX-Kanal für eine bestimmte Zeit gehalten wird. Procedures können nicht in Szenen abgespeichert werden und lassen sich entweder über
<source lang="xml">
* die {{Manual Windowcaption|[[Stage View DMXC3|Bühnenansicht (Stage View)]]}} oder
<range type="linear" mindmx="0" maxdmx="255" minval="0" maxval="15" />
* das {{Manual Objectcaption|[[Procedure (Input Assignment) DMXC3|Procedure]]}}-Node in der {{Manual Windowcaption|[[Input Assignment DMXC3|Eingangszuweisung (Input Assignment)]]}} aufrufen.
</source>
<br />


[[en: Basic structure (DDF-Syntax) DMXC3]]
[[Kategorie: DDF DMXControl 3]]
[[Kategorie: DDF DMXControl 3]]

Aktuelle Version vom 10. November 2024, 15:07 Uhr

Blockdevice.png Artikel beschreibt
DMXControl 3.2.3		 Grundaufbau (DDF-Syntax) DMXC3
Arrow back.png Allgemeine Einführung
Funktionselemente Arrow forw.png
Inhaltsverzeichnis
Teil 1: Grundlagen
Teil 2: Funktionen
Teil 3: Procederes
Teil 4: Beispiele


Grundaufbau der DDF

Das DDF für DMXControl 3 besteht aus vier Teilen:

  • Basisangaben mit grundlegenden Angaben zum DDF selbst wie DDF-Version und Bild
  • Informationen mit Angaben zum Gerät, Hersteller, Autor sowie DMX-Modus
  • Funktionen mit den Funktionen jedes DMX-Kanals und zugehörigen Wertebereichen
  • Procedures für spezielle Geräte-Funktionen wie Reset oder Lampen ein- oder ausschalten
<?xml version="1.0" encoding="utf-8"?>
<device image="bild.png" type="DMXDevice" dmxaddresscount="1" dmxcversion="3.2.3" ddfversion="1.0.0" subdevice="no">
  <information>
     ...
  </information>
  <functions>
     ...
  </functions>
  <procedures>
    ...
  </procedures>
</device>

Insbesondere der zweite Teil ist wichtig für die Aufbereitung des DDFs durch die Bedienoberfläche (GUI), damit alle Steuerelemente wie die Gerätesteuerung (Device Control) und die Steuerungsfenster (Control Panel) richtig dargestellt werden. Des Weiteren greift der Hardware Abstraction Layer (HAL) auf diese Informationen zurück, um die eingestellten Lichtstimmungen in den Szenen (Cues) eines Projekts abzuspeichern.

Funktionsteile

Basisinformationen

Im Basisteil des DDFs sind allgemeine Informationen zur Datei sowie das Element device enthalten. Der Tag device umfasst folgende Attribute:

Attribut Beschreibung Standard-Wert Zulässige Werte Optional
image Bild-Datei des DDFs Nicht vorhanden Dateiname des Bilds als *.png-Datei
type DMXDevice DMXDevice
Allgemeine Informationen zum DDF
dmxaddresscount Gesamtzahl der DMX-Kanäle des Geräts Nicht vorhanden Ganze Zahlen von 1 bis 512 X
dmxcversion Erforderliche Programmversion zur Verwendung des DDFs 3.0.0 3.0.2, 3.1.3, 3.2.0 und alle zukünftigen Programmversion
ddfversion Version des DDFs Nicht vorhanden 1.0.0, 1.1.0, 1.2.0 usw.
subdevice Zusatzgerät für vorhandenes Gerät wie zum Beispiel Colorscroller für klassische PAR-Scheinwerfer no no oder yes X
Steuerung der Anzeige in der Bühnenansicht (Stage View)
defaultdisplaystyle Standart Anzeige-Modus in der Bühnenansicht preview custom, image ober preview X
defaultdisplaycolor Ausgangspunkt der Lichtfarbe des Leuchtmittels des Gerätes #ffffff Jede HTML-Farbe (#000000 - #ffffff) X
Attribute zum Ansprechen der RGB+-Farben
whitechanneldefaultmode Das Verhalten, wie der Weiß-Kanal (White channel) angesprochen wird onlywhite none, addwhite oder onlywhite X
amberchanneldefaultmode Das Verhalten, wie der Amber-Kanal angesprochen wird onlywhite none, add oder only X

Das Element device umklammert alle Informationen des DDFs. Angaben außerhalb des Tags führen zu Fehlern beim Einfügen des DDFs in ein Projekt.

Beim Eintragen des Dateinamens für Icon in der Bühnenansicht ist nur der Dateiname inkl. der Dateiendung einzusetzen. Die Angabe des Pfades ist nicht erforderlich.

Arbeitsweise der zusätzlichen LED-Farben

Alle zusätzlichen LED-Farben wie weiß, amber, uv etc., die neben den RGB-LEDs im Gerät verbaut sind, werden nach dem Hinzufügen des Geräts zu einem Projekt standardmäßig erst einmal nicht angesteuert. In den Eigenschaften des Geräts, aufzurufen zum Beispiel über die Bühnenansicht, kann unter dem Eintrag Automix Mode das Verhalten für jedes Gerät einzeln angepasst werden, hier am Beispiel der weißen LED:

  • None: Keine Ansteuerung der weißen LED (Standard-Einstellung)
  • Add white: Alle vier LEDs bei 100% für die Farbe weiß
  • Only white: Nur weiße LEDs bei 100% für die Farbe weiß

Geräteinformation

Im Informationsteil werden alle grundlegenden Informationen zum Gerät hinterlegt, für dies das DDF erstellt wurde. Mit Hilfe dieser Informationen erfolgt auch die Einsortierung des neuen DDFs im Dialog Geräte hinzufügen (Add Device). Alle Angaben werden durch das Element <information> ... </information> eingeklammert.

Tag Beschreibung Optional
model Bezeichnung des Geräts gemäß Bedienungsanleitung
vendor Hersteller des Geräts gemäß vorgegebener Herstellerliste
author Autor des DDFs
mode DMX-Modus bzw. Kanalbelegung X
electrical Elektrische Leistungsaufnahme des Geräts X
comment Kommentar zum DDF oder Gerät X

Elektrische Leistungsaufnahme

Der Tag electrical in dem Block <information> ermöglicht die optionale Angabe der elektrischen Leistungsaufnahme durch das Gerät. Diese Informationen verwendet DMXControl 3 für das Lastmanagement, um die theoretische Gesamtleistung der am Veranstaltungsort verfügbaren Stromquellen zu berechnen. Es gibt zwei Arten der Leistungsaufnahme, mit denen DMXControl 3 arbeitet:

  • Konstante (statische) Leistungsaufnahme
  • Dynamische Leistungsaufnahme

Die konstante (statischen) Leistungsaufnahme ist über das Tag static definiert. Zu der konstanten Leistungsaufnahme zählen insbesondere Moving-Heads oder Scanner mit einer Entladungslampe als Leuchtmittel. Hier ändert sich die Leistungsaufnahme nämlich nicht, egal ob der Shutter und der Dimmer des Geräts geöffnet sind oder nicht. Zu der konstanten Leistungsaufnahme gehört aber auch der Stromverbrauch der Elektronik selbst, wenn das Gerät eingeschaltet und betriebsbereit ist.

Die dynamische Leistungsaufnahme korrespondiert mit dem Wert des Dimmers des Geräts. Diese Konstellation ist vor allem bei klassischen Halogenscheinwerfern anzutreffen, die an Dimmpacks angeschlossen sind. Darüber hinaus kann DMXControl 3 die theoretische Leistungsaufnahme beim Dimmen von LED-Scheinwerfern und Moving-Heads berechnen, wenn die Werte ebenfalls im Tag dimmer gepflegt sind.

Variante Code
PAR-Scheinwerfer mit einem 1.000 Watt Leuchtmittel 
<electrical>
  <dimmer>1000</dimmer>
</electrical>

Zunehmende Leistungsaufnahme des Geräts mit maximal 1.000 Watt bei voller Helligkeit (Dimmer 100%).

Moving-Head mit Entladungslampe 
<electrical>
  <static>450</static>
</electrical>

Konstante Leistungsaufnahme des Geräts von 450 Watt.

LED-Scheinwerfer 
<electrical>
  <static>20</static>
  <dimmer>145</dimmer>
</electrical>

Nach dem Einschalten hat das Gerät eine konstante Leistungsaufnahme von 20 Watt. Die LEDs sind aus (Dimmer 0%). Die LEDs haben bei voller Helligkeit eine Leistungsaufnahme von 145 Watt. Insgesamt besitzt das Gerät eine Leistungsaufnahme von 165 Watt.

Funktionen

Im Funktionsteil werden die eigentlichen Funktionen des Geräts eingetragen, wie beispielsweise Pan und Tilt, Dimmer, Farbrad, Strobe etc. Welche Funktionen aktuell unterstützt werden, sind im Syntax: die möglichen Funktions-Bausteine im Detail inklusive Code-Beispielen aufgelistet. Alle Angaben werden durch das Element <functions> ... </functions> eingeklammert.

Unterfunktionen eines DMX-Kanals

Jede einzelne Funktion eines DMX-Kanals kann durch eine Unterfunktion erweitert werden. Prominentestes Beispiel ist der Goboshake, welcher sich jeweils zu dem aktuell ausgewählten Gobo zusätzlich aktiviert lässt. Diese Funktion liegt meist auf dem gleichen DMX-Kanal wie die Funktion zum Auswählen des Gobos, in der Regel aber in einem anderen Wertebereich.

Ergänzende Funktionen für einen DMX-Kanal

Neben den Unterfunktionen gibt es noch ergänzende Funktionen Diese können entweder auf dem gleichen DMX-Kanal liegen, wie zum Beispiel das kontinuierliche Drehen des Farbrads in einem Moving-Head oder Scanner. Im Falle der Goborotation liegt die ergänzende Funktion auf einem getrennten DMX-Kanal. Hier wird über den ersten DMX-Kanal das Gobo ausgewählt und über den zweiten DMX-Kanal bestimmt, wie schnell sich das Gobo in welche Richtung drehen soll.

Procedures

Procedures werden nur eingesetzt, um selten benutzte Funktionen am Gerät zu aktivieren, die für den Live-Betrieb in der Regel nicht erforderlich sind. Üblicherweise verfügen insbesondere Moving-Heads oder Scanner über Funktionen zur Durchführung eines Resets oder zum Ein- bzw. Ausschalten des Leuchtmittels. Alle diese Funktionen werden ausgeführt, wenn ein bestimmter DMX-Wert auf dem zugehörigen DMX-Kanal für eine bestimmte Zeit gehalten wird. Procedures können nicht in Szenen abgespeichert werden und lassen sich entweder über

Abgerufen von „https://wiki-de.dmxcontrol-projects.org/index.php?title=Grundaufbau_(DDF-Syntax)_DMXC3&oldid=18409“