Open Function (DDF-Syntax) DMXC3: Unterschied zwischen den Versionen

Aus Deutsches DMXC-Wiki
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(17 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Kapitelüberschrift|Version=DMXControl 3.1.2}} {{Inuse}}
{{Manual Header
| Type = DMXC3 DDFs
| Version = 3.3.0
| zurückLink = Stage_Effect_(DDF-Syntax)_DMXC3
| zurückText = Bühneneffekte
| vorLink =
| vorText =
}}




{{DMXC3_Manual-Navigation_DDF
Mit Hilfe der freien Funktionen (Open functions) werden in DMXControl 3 alle Funktionen eines Geräts abgebildet, welche sich (zur Zeit noch) nicht durch eine native Funktion wie zum Beispiel [[Dimmer (DDF-Syntax) DMXC3|Dimmer]], [[Strobe (DDF-Syntax) DMXC3|Strobe]], [[Farbrad (DDF-Syntax) DMXC3|Farbrad]] oder vergleichbar implementieren lassen. Sollte eine Funktion eines Geräts nicht nativ über eine der spezifischen Funktionen wie zum Beispiel <code>goborotation</code> für die Goborotation für ein Goborad oder <code>strobe</code> für das (einfach ausgedrückt) Blitzen des Geräts abzubilden sein, kann man im DDF so genannte allgemeine Funktionen oder vollständig freie Funktionen definieren.
|zurückLink = DDF-Syntax_Bühneneffekte_DMXC3
|zurückText = Bühneneffekte
|vorLink =
|vorText =
}}


=Allgemeine Funktionen=
==Index==
Diese Funktion kann verwendet werden, wenn sich beispielsweise die Linsen eines Strahleneffekt-Gerätes in einem bestimmten Winkel positionieren lassen. Für die Indizierung von Gobos sollte diese Funktion aber nicht verwendet werden.


{| class="wikitable toptextcells"
= Allgemeine Funktionen =
|-
== Index ==
! Tag !! Variante !! Code
Diese Funktion kann verwendet werden, wenn sich beispielsweise die Linsen eines Strahleneffekt-Gerätes in einem bestimmten Winkel positionieren lassen.
|-
{{Manual Box | de | Hint | Für die Indizierung von Gobos sollte die Funktion <code>index</code> nicht verwendet werden. Der Regler {{Manual Objectcaption|Goboindex}} im Fenster {{Manual Windowcaption |[[Control Panel DMXC3#Gobo|Gobo]]}} lässt sich nur über die Funktion <code>goboindex</code> nutzen.}}
|style="width: 10em"| <code>index</code>  
{{DMXC3 Manual-Tableheader DDF-Code examples | de }}
|style="width: 10em"| Standard
| Standard
|style="width: 60em"| <source lang="xml">
| <syntaxhighlight lang="xml">
<index dmxchannel="0">
<index dmxchannel="0">
   <range range="60" mindmx="0" maxdmx="127" minval="0" maxval="60" />
   <range range="60" mindmx="0" maxdmx="127" minval="0" maxval="60" />
</index>
</index>
</source>
</syntaxhighlight>
Index auf DMX-Kanal 1:
Index auf DMX-Kanal {{Manual Value | DMX channel| 1}}:
* Ausrichtung der Linse o. ä. in einem Winkel zwischen 0° bei DMX-Wert 0 und 60° bei DMX-Wert 127.
* Ausrichtung der Linse o. ä. in einem Winkel zwischen {{Manual Value || 0°}} bei DMX-Wert {{Manual Value | DMX value | 0}} und {{Manual Value || 60°}} bei DMX-Wert {{Manual Value | DMX value | 127}}.
|}
|}
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code attributes | de | range-range}}
! style="vertical-align:top" | Beschreibung
| Maximaler Drehwinkel für die Linse
| DMX-Wert für die Start-Position
| DMX-Wert für die End-Position
| Start-Position der Linse
| End-Position der Linse
|-
|-
! Attribut !! range !! mindmx !! maxdmx !! minval !! maxval
! style="vertical-align:top" | Zulässiger Attributwert  
|-
| <code>0°</code> bis <code>720°</code>
!style="width: 10em; vertical-align:top"| Beschreibung
| <code>0</code> bis <code>255</code>
|style="width: 10em"| Maximaler Drehwinkel für die Linse
| <code>0</code> bis <code>255</code>
|style="width: 10em"| DMX-Wert für die Start-Position
| <code>0°</code> bis <code>720°</code>
|style="width: 10em"| DMX-Wert für die End-Position
| <code>0°</code> bis <code>720°</code>
|style="width: 10em"| Start-Position der Linse
|style="width: 10em"| End-Position der Linse
|-
!style="vertical-align:top"| Zulässiger Attributwert  
| <code>0° bis 720°</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0° bis 720°</code>
| <code>0° bis 720°</code>
|}
|}


==Rotation==
== Rotation ==
Diese Funktion kann verwendet werden, wenn sich beispielsweise die Linsen eines Strahleneffekt-Gerätes drehen lassen oder um die Drehung eines Spiegelkugelmotors steuern zu können. Für die Rotation von Gobos sollte diese Funktion aber nicht verwendet werden.
Diese Funktion kann verwendet werden, wenn sich beispielsweise die Linsen eines Strahleneffekt-Gerätes drehen lassen oder um die Drehung eines Spiegelkugelmotors steuern zu können.
 
{{Manual Box | de | Hint | Für die Rotation von Gobos sollte die Funktion <code>rotation</code> nicht verwendet werden. Der Regler {{Manual Objectcaption|Goborotation}} im Fenster {{Manual Windowcaption |[[Control Panel DMXC3#Gobo|Gobo]]}} lässt sich nur über die Funktion <code>goborotation</code> nutzen.}}
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code examples | de }}
|-
| Standard
! Tag !! Variante !! Code
| <syntaxhighlight lang="xml">
|-
|style="width: 10em"| <code>rotation</code>  
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<rotation dmxchannel="0">
<rotation dmxchannel="0">
   <step type="stop" mindmx="191" maxdmx="192" />
   <step type="stop" mindmx="191" maxdmx="192" />
Zeile 61: Zeile 53:
   <range type="ccw" mindmx="193" maxdmx="255" minval="0.05" maxval="5" />
   <range type="ccw" mindmx="193" maxdmx="255" minval="0.05" maxval="5" />
</rotation>
</rotation>
</source>
</syntaxhighlight>
Rotation auf DMX-Kanal 1:
Rotation auf DMX-Kanal {{Manual Value | DMX channel | 1}}:
* Keine Rotation bei zwischen DMX-Wert 191 und DMX-Wert 192.
* Keine Rotation bei zwischen DMX-Wert {{Manual Value | DMX value | 191}} und DMX-Wert {{Manual Value | DMX value | 192}}.
* Rotation im Uhrzeigersinn mit 5 1/s bei DMX-Wert 128, abnehmend bis 0,05 1/s bei DMX-Wert 190.
* Rotation im Uhrzeigersinn mit {{Manual Value || 5 1/s}} bei DMX-Wert {{Manual Value | DMX value | 128}}, abnehmend bis {{Manual Value || 0,05 1/s}} bei DMX-Wert {{Manual Value | DMX value | 190}}.
* Rotation gegen den Uhrzeigersinn mit 0,05 1/s bei DMX-Wert 193, zunehmend bis 5 1/s bei DMX-Wert 255.
* Rotation gegen den Uhrzeigersinn mit {{Manual Value || 0,05 1/s}} bei DMX-Wert {{Manual Value | DMX value | 193}}, zunehmend bis {{Manual Value || 5 1/s}} bei DMX-Wert {{Manual Value | DMX value | 255}}.
|}
|}
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code attributes | de | range-generic}}
! style="vertical-align:top" | Beschreibung
|
| DMX-Wert für geringste Drehzahl
| DMX-Wert für die schnellste Drehzahl
| Minimale Drehzahl
| Maximale Drehzahl
|-
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
! style="vertical-align:top" | Zulässiger Attributwert  
|-
| <code>stop</code><br /> <code>cw</code><br /> <code>ccw</code>
!style="width: 10em; vertical-align:top"| Beschreibung
| <code>0</code> bis <code>255</code>
|style="width: 10em"|
| <code>0</code> bis <code>255</code>
|style="width: 10em"| DMX-Wert für geringste Drehzahl
| <code>0.01 1/s</code> bis <code>10 1/s</code>
|style="width: 10em"| DMX-Wert für die schnellste Drehzahl
| <code>0.01 1/s</code> bis <code>10 1/s</code>
|style="width: 10em"| Minimale Drehzahl
|style="width: 10em"| Maximale Drehzahl
|-
!style="vertical-align:top"| Zulässiger Attributwert  
| <code>stop</code><br />
<code>cw</code><br />
<code>ccw</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>0.01 1/s bis 10 1/s</code>
| <code>0.01 1/s bis 10 1/s</code>
|}
|}


== Cool ==


=Freie Funktionen=
== Heat ==
Da nicht alle Funktionen eines DMX-Gerätes exakt abgebildet werden können, gibt es Elemente, die sich frei definieren lassen. Diese werden dann aber nur im Device Control ausgegeben. Auch die Vorteile der HAL lassen sich auf diese frei definierten Funktionen anwenden.


= Freie Funktionen =
Da nicht alle Funktionen eines DMX-Gerätes exakt abgebildet werden können, gibt es Elemente, die sich frei definieren lassen. Diese werden dann aber nur in der {{Manual Windowcaption |[[Device Control DMXC3|Gerätesteuerung (Device Control)]]}} ausgegeben. Auch die Vorteile des {{Manual Windowcaption |[[Hardware Abstraction Layer (HAL) DMXC3|Hardware-Abstraktions-Layers (HAL)]]}} lassen sich auf diese frei definierten Funktionen anwenden.
Folgende Elemente sind aktuell verfügbar, um Funktionen eines DMX-Gerätes frei definieren zu können:
Folgende Elemente sind aktuell verfügbar, um Funktionen eines DMX-Gerätes frei definieren zu können:
* <code>rawstep</code>: Generiert eine Liste mit Auswahlmöglichkeiten für Funktionen.
* <code>rawstep</code>: Generiert eine Liste mit Auswahlmöglichkeiten für Funktionen.
* <code>raw</code>: Generiert einen einfachen Schieberegler.
* <code>raw</code>: Generiert einen einfachen Schieberegler.
* <code>const</code>: Sendt auf einem DMX-Kanal konstant einen bestimmten DMX-Wert.
* <code>const</code>: Sendt auf einem DMX-Kanal konstant einen bestimmten DMX-Wert.
{{Manual Box | de | Important | Alle oben genannten Elemente sind vollständig gerätespezifisch. Der HAL kann in {{Manual Windowcaption |[[Cuelist DMXC3|Szenenlisten (Cuelists)]]}} etc. hinterlegte Werte nach einem Austausch des Geräts nicht automatisch auf das neue Gerät anwenden. Diese Element sollte möglichst immer nur verwendet werden, wenn die Abbildung der Funktion nicht eine native Funktion möglich ist. }}


{{BoxWichtig|Text=Alle oben genannten Elemente sind vollständig gerätespezifisch. Die HAL kann in Cuelists etc. hinterlegte Werte nach einem Austausch des Geräts nicht automatisch auf das neue Gerät anwenden. Diese Element sollte möglichst immer nur verwendet werden, wenn die Abbildung der Funktion nicht eine native Funktion möglich ist. }}
== rawstep ==
 
==rawstep==
Über das Element <code>rawstep</code> wird im Device Control eine Liste erzeugt, um bestimmte Funktionen des DMX-Gerätes auswählen zu können. Typische Anwendungsfälle sind hierfür:
Über das Element <code>rawstep</code> wird im Device Control eine Liste erzeugt, um bestimmte Funktionen des DMX-Gerätes auswählen zu können. Typische Anwendungsfälle sind hierfür:
* Auswahl von verschiedenen Betriebsmodi eines DMX-Gerätes wie direkte DMX-Steuerung, Abspielen von Automatik-Programmen, Aktivierung der Musiksteuerung
* Auswahl von verschiedenen Betriebsmodi eines DMX-Gerätes wie direkte DMX-Steuerung, Abspielen von Automatik-Programmen, Aktivierung der Musiksteuerung
Zeile 105: Zeile 94:
* Umschalten des Modus für die Pan-Tilt-Bewegung vom normalen, „klassischen“ Ansteuerungsmodus zum Endlos-Bewegungsmodus
* Umschalten des Modus für die Pan-Tilt-Bewegung vom normalen, „klassischen“ Ansteuerungsmodus zum Endlos-Bewegungsmodus


Im Gegensatz zu den fest definierten Funktionen muss beim <code>rawstep</code> neben dem DMX-Kanal im Attribut <code>name</code> auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden. Die Beschreibung jedes <code>step</code> kann frei gewählt werden. Die gewählte Beschreibung hat keinen Einfluss auf die Arbeitsweise der HAL.
Im Gegensatz zu den fest definierten Funktionen muss beim <code>rawstep</code> neben dem DMX-Kanal im Attribut <code>name</code> auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden. Die Beschreibung jedes <code>step</code> kann frei gewählt werden. Die gewählte Beschreibung hat keinen Einfluss auf die Arbeitsweise des HAL.
 
{{DMXC3 Manual-Tableheader DDF-Code examples | de }}
{| class="wikitable toptextcells"
| Standard
|-
| <syntaxhighlight lang="xml">
! Tag !! Variante !! Code
|-
|style="width: 10em"| <code>rawstep</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<rawstep dmxchannel="0" name="Mode">
<rawstep dmxchannel="0" name="Mode">
   <step caption="DMX" mindmx="0" maxdmx="9" />
   <step caption="DMX" mindmx="0" maxdmx="9" />
Zeile 119: Zeile 103:
   <step caption="Music" mindmx="200" maxdmx="255" />
   <step caption="Music" mindmx="200" maxdmx="255" />
</rawstep>
</rawstep>
</source>
</syntaxhighlight>
Frei definierte Funktion mit dem Namen „Mode“ auf DMX-Kanal 1:
Frei definierte Funktion mit dem Namen „Mode“ auf DMX-Kanal {{Manual Value | DMX channel | 1}}:
* Aktivierung des DMX-Modus bei DMX-Wert zwischen 0 und 9.
* Aktivierung des DMX-Modus bei DMX-Wert zwischen {{Manual Value | DMX value | 0}} und {{Manual Value | DMX value | 9}}.
* Aktivierung der Automatik-Modus bei DMX-Wert zwischen 10 und 199.
* Aktivierung der Automatik-Modus bei DMX-Wert zwischen {{Manual Value | DMX value | 10}} und {{Manual Value | DMX value | 199}}.
* Aktivierung der Sound-to-Light-Steuerung bei DMX-Wert zwischen 200 und 255.
* Aktivierung der Sound-to-Light-Steuerung bei DMX-Wert zwischen {{Manual Value | DMX value | 200}} und {{Manual Value | DMX value | 255}}.
|}
|}
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code attributes | de | step-generic}}
! style="vertical-align:top" | Beschreibung
| Beschreibung der Funktion
| Minimaler DMX-Wert zur Aktivierung der der Funktion
| Maximaler DMX-Wert zur Aktivierung der der Funktion
|-
|-
! Attribut !! caption !! mindmx !! maxdmx
! style="vertical-align:top" | Zulässiger Attributwert  
|-
!style="width: 10em; vertical-align:top"| Beschreibung
|style="width: 10em"| Beschreibung der Funktion
|style="width: 10em"| Minimaler DMX-Wert zur Aktivierung der der Funktion
|style="width: 10em"| Maximaler DMX-Wert zur Aktivierung der der Funktion
|-
!style="vertical-align:top"| Zulässiger Attributwert  
| <code>Text</code>
| <code>Text</code>
| <code>0 bis 255</code>
| <code>0</code> bis <code>255</code>
| <code>0 bis 255</code>
| <code>0</code> bis <code>255</code>
|}
|}
{{Manual Box | de | Important| Der Text für die Beschreibung darf kein &-Zeichen enthalten. Ansonsten kann das DDF nicht geladen werden. }}


{{BoxWichtig|Text=Der Text für die Beschreibung darf kein &-Zeichen enthalten. Ansonsten kann das DDF nicht geladen werden. }}
== raw ==
 
Das Element <code>raw</code> erzeugt im Device Control einen einzigen Schieberegler. Typische Anwendungsfälle sind hierfür:
==raw==
Das Element <code>raw</code> erzeugt im Device Control einen Schieberegler. Typische Anwendungsfälle sind hierfür:
* Steuerung der Abspielgeschwindigkeit von Automatik-Programmen
* Steuerung der Abspielgeschwindigkeit von Automatik-Programmen
* Einstellung der Mikrofon-Empfindlichkeit für die Sound-To-Light-Steuerung
* Einstellung der Mikrofon-Empfindlichkeit für die Sound-to-Light-Steuerung
* Geschwindigkeit und Drehrichtung für Endlos-Bewegungen von Moving-Heads
* Geschwindigkeit und Drehrichtung für Endlos-Bewegungen von Moving-Heads
* Drehrichtung und Drehgeschwindigkeit für Animationsscheiben
* Drehrichtung und Drehgeschwindigkeit für Animationsscheiben
* Nutzung für weitere Bewegungsachsen
* Nutzung für weitere Bewegungsachsen
* Einstellung für Effektgeschwindigkeiten für Farb- und Goborädern
* Einstellung für Effektgeschwindigkeiten für Farb- und Goborädern
* Motorisierte Schieberblenden
{{Manual Box | de | Hint | Können über einen DMX-Kanal des vorliegenden Geräts zum Beispiel mehrere interne Programme ausgewählt und in ihrer Ablaufgeschwindigkeit verändert werden, sollten diese mit Hilfe des Elements <code>rawranges</code> implementiert werden.}}


Im Gegensatz zu den fest definierten Funktionen muss beim <code>raw</code> neben dem DMX-Kanal im Attribut <code>nam</code>e auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden.
Im Gegensatz zu den fest definierten Funktionen muss beim <code>raw</code> neben dem DMX-Kanal im Attribut <code>name</code> auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden.
 
{{DMXC3 Manual-Tableheader DDF-Code examples | de }}
{| class="wikitable toptextcells"
| Geschwindigkeitsregler für Automatikprogramme in vereinfachter Version
| <syntaxhighlight lang="xml">
<raw dmxchannel="0" name="Macro speed" />
</syntaxhighlight>
Frei definierte Funktion mit dem Namen "Geschwindigkeit" auf DMX-Kanal {{Manual Value | DMX channel | 1}}:
* Geschwindigkeit der Automatikprogramme zunehmend vom Wert {{Manual Value || 0}} (geringste Geschwindigkeit) bei DMX-Wert {{Manual Value | DMX value | 0}} bis zum Wert {{Manual Value || 255}} (maximale Geschwindigkeit) DMX-Wert {{Manual Value | DMX value | 255}}.
|-
|-
! Tag !! Variante !! Code
| Geschwindigkeitsregler für Automatikprogramme mit eigenem Wertebereich
|-
| <syntaxhighlight lang="xml">
|style="width: 10em" rowspan="2" | <code>raw</code>
|style="width: 10em"| Geschwindigkeitsregler für Automatikprogramme
|style="width: 60em"| <source lang="xml">
<raw dmxchannel="0" name="Macro speed" >
<raw dmxchannel="0" name="Macro speed" >
   <range type="linear" mindmx="0" maxdmx="255" minval="0" maxval="100" />
   <range type="linear" mindmx="0" maxdmx="255" minval="0" maxval="100" />
</raw>
</raw>
</source>
</syntaxhighlight>
Frei definierte Funktion mit dem Namen "Geschwindigkeit" auf DMX-Kanal 1:
Frei definierte Funktion mit dem Namen "Geschwindigkeit" auf DMX-Kanal {{Manual Value | DMX channel | 1}}:
* Geschwindigkeit der Automatikprogramme zunehmend von DMX-Wert bis DMX-Wert 255.
* Geschwindigkeit der Automatikprogramme zunehmend von {{Manual Value || 0%}} (geringste Geschwindigkeit) bei DMX-Wert {{Manual Value | DMX value | 0}} bis {{Manual Value || 100%}} (maximale Geschwindigkeit) DMX-Wert {{Manual Value | DMX value | 255}}.
|-
|-
| Vorlage für Animationsscheibe
| Vorlage für Animationsscheibe
| <source lang="xml">
| <syntaxhighlight lang="xml">
<raw dmxchannel="0" name="Animation disk rotation" >
<raw dmxchannel="0" name="Animation disk rotation" >
   <step type="stop" mindmx="125" maxdmx="130" minval="0" maxval=""/>
   <step type="stop" mindmx="125" maxdmx="130" />
   <range type="cw" mindmx="131" maxdmx="255" minval="0.05" maxval="2" />
   <range type="cw" mindmx="131" maxdmx="255" minval="0.05" maxval="2" />
   <range type="ccw" mindmx="124" maxdmx="0" maxval="-0.05" minval="-2" />
   <range type="ccw" mindmx="124" maxdmx="0" minval="-2" maxval="-0.05" />
</raw >
</raw >
</source>
</syntaxhighlight>
Frei definierte Funktion mit dem Namen "Rotation Animationsscheibe" auf DMX-Kanal 1:
Frei definierte Funktion mit dem Namen "Rotation Animationsscheibe" auf DMX-Kanal {{Manual Value | DMX channel | 1}}:
* Animationsscheibe statisch bei DMX-Wert zwischen 125 und 130.
* Animationsscheibe statisch bei DMX-Wert zwischen {{Manual Value | DMX value | 125}} und {{Manual Value | DMX value | 130}}.
* Rotation der Animationsscheibe im Uhrzeigersinn mit 0,05 1/s bei DMX-Wert 131, schneller werdend bis 2 1/s bei DMX-Wert 255.
* Rotation der Animationsscheibe im Uhrzeigersinn mit {{Manual Value || 0,05 1/s}} bei DMX-Wert {{Manual Value | DMX value | 131}}, schneller werdend bis {{Manual Value || 2 1/s}} bei DMX-Wert {{Manual Value | DMX value | 255}}.
* Rotation der Animationsscheibe gegen den Uhrzeigersinn mit -2 1/s bei DMX-Wert 124, abnehmend bis -0,05 1/s bei DMX-Wert 0.
* Rotation der Animationsscheibe gegen den Uhrzeigersinn mit {{Manual Value || -2 1/s}} bei DMX-Wert {{Manual Value | DMX value | 124}}, abnehmend bis {{Manual Value || -0,05 1/s}} bei DMX-Wert {{Manual Value | DMX value | 0}}.
|}
|}
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader DDF-Code attributes | de | range-generic}}
! style="vertical-align:top" | Beschreibung
|
| Minimaler DMX-Wert für die Funktion
| Maximaler DMX-Wert für die Funktion
| Kleinster Wert
| Größter Wert
|-
|-
! Attribut !! type !! mindmx !! maxdmx !! minval !! maxval
! style="vertical-align:top" | Zulässiger Attributwert
|-
| <code>linear</code><br /> <code>stop</code><br /> <code>cw</code><br /> <code>ccw</code>
!style="width: 10em; vertical-align:top"| Beschreibung
| <code>0</code> bis <code>255</code>
|style="width: 10em"|
| <code>0</code> bis <code>255</code>
|style="width: 10em"| Minimaler DMX-Wert für die Funktion
| <code>Keine Einschränkung</code>
|style="width: 10em"| Maximaler DMX-Wert für die Funktion
| <code>Keine Einschränkung</code>
|style="width: 10em"| Kleinster Wert
|}
|style="width: 10em"| Größter Wert
 
== rawranges ==
Das Element <code>rawranges</code> erzeugt im Device Control einen Schieberegler für mehrere verschiedene Funktionen mit einem variablen Wertebereich. Die Funktionen können über das zugehörige, automatisch generierte Dropdown-Menü ausgewählt werden. Typische Anwendungsfälle sind hierfür:
* Ändern der Abspielgeschwindigkeit von internen Programmen
 
Für eine eindeutige Zuordnung im Device Control muss beim Element neben dem <code>dmxchannel</code> ebenfalls im Attribut <code>name</code> auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden. Die grundlegende Definition unterscheidet sich vom Element <code>raw</code> nicht, sondern wird nur um das Attribut <code>type</code> ergänzt, in dem die Beschreibung der jeweiligen Funktion auf dem DMX-Kanal erfolgt.
{{DMXC3 Manual-Tableheader DDF-Code examples | de }}
| Auswahl und Abspielgeschwindigkeit für Automatikprogramme
| <syntaxhighlight lang="xml">
<rawranges dmxchannel="0" name="Auto show" >
  <step type="Off" mindmx="0" maxdmx="31" />
  <range type="Show 1" mindmx="32" maxdmx="63" minval="0" maxval="100" />
  <range type="Show 2" mindmx="64" maxdmx="95" minval="0" maxval="100" />
  <range type="Show 3" mindmx="96" maxdmx="127" minval="0" maxval="100" />
  <range type="Show 4" mindmx="128" maxdmx="191" minval="0" maxval="100" />
  <range type="Show 5" mindmx="192" maxdmx="255" minval="0" maxval="100" />
</rawranges>
</syntaxhighlight>
Frei definierte Funktion mit dem Namen "Auto show" auf DMX-Kanal {{Manual Value | DMX channel | 1}}:
* Interne Show-Programme {{Manual Value | Caption | abgeschaltet}} zwischen DMX-Wert {{Manual Value | DMX value | 0}} und {{Manual Value | DMX value | 31}}.
* Aktivierung der {{Manual Value | Caption | Show 1}} und Festlegung der Geschwindigkeit von {{Manual Value || 0%}} bei DMX-Wert {{Manual Value | DMX value | 32}} bis {{Manual Value || 100%}} bei DMX-Wert {{Manual Value | DMX value | 63}}.
* Aktivierung der {{Manual Value | Caption | Show 2}} und Festlegung der Geschwindigkeit von {{Manual Value || 0%}} bei DMX-Wert {{Manual Value | DMX value | 64}} bis {{Manual Value || 100%}} bei DMX-Wert {{Manual Value | DMX value | 95}}.
* ...
|}
{{DMXC3 Manual-Tableheader DDF-Code attributes | de | range-generic}}
! style="vertical-align:top" | Beschreibung
|
| Minimaler DMX-Wert für die Funktion
| Maximaler DMX-Wert für die Funktion
| Kleinster Wert
| Größter Wert
|-
|-
!style="vertical-align:top"| Zulässiger Attributwert  
!style="vertical-align:top"| Zulässiger Attributwert  
| <code>linear</code><br />
| Kurz-Beschreibung der Funktion
<code>stop</code><br />
| <code>0</code> bis <code>255</code>
<code>cw</code><br />
| <code>0</code> bis <code>255</code>
<code>ccw</code>
| <code>0 bis 255</code>
| <code>0 bis 255</code>
| <code>Keine Einschränkung</code>
| <code>Keine Einschränkung</code>
| <code>Keine Einschränkung</code>
| <code>Keine Einschränkung</code>
|}
|}


==const==
== const ==
Das Element <code>const</code> wird immer dann eingesetzt, wenn auf einem DMX-Kanal dauerhalt ein bestimmter DMX-Wert gesetzt werden muss, ansonsten mit diesem DMX-Kanal aber nicht anderweitig gearbeitet wird. Als Beispiel können zum Beispiel DMX-Kanäle aufgeführt werden, auf denen verschiedene interne Programme des DMX-Gerätes hinterlegt sind, welche aber nicht verwendet werden sollen.
Das Element <code>const</code> wird immer dann eingesetzt, wenn auf einem DMX-Kanal dauerhalt ein bestimmter DMX-Wert gesetzt werden muss, ansonsten mit diesem DMX-Kanal aber nicht anderweitig gearbeitet wird. Als Beispiel können zum Beispiel DMX-Kanäle aufgeführt werden, auf denen verschiedene interne Programme des DMX-Gerätes hinterlegt sind, welche aber nicht verwendet werden sollen.


Für das Element const ist keine graphische Benutzeroberfläche vorgesehen. Eine Anpassung des gesetzten DMX-Wertes ist nicht möglich.
Für das Element <code>const</code> ist keine graphische Benutzeroberfläche vorgesehen. Eine Anpassung des gesetzten DMX-Wertes ist nicht möglich.


Im Gegensatz zu den fest definierten Funktionen muss beim <code>const</code> neben dem DMX-Kanal im Attribut <code>name</code> auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden. Im Attribut <code>val</code> wird der DMX-Wert angegeben, der dauerhaft auf diesem DMX-Kanal gesetzt werden soll.
Im Gegensatz zu den fest definierten Funktionen muss beim <code>const</code> neben dem DMX-Kanal im Attribut <code>name</code> auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden. Im Attribut <code>val</code> wird der DMX-Wert angegeben, der dauerhaft auf diesem DMX-Kanal gesetzt werden soll.
 
{{DMXC3 Manual-Tableheader DDF-Code examples | de }}
{| class="wikitable toptextcells"
| Standard
|-
| <syntaxhighlight lang="xml">
! Tag !! Variante !! Code
|-
|style="width: 10em" rowspan="2" | <code>const</code>
|style="width: 10em"| Standard
|style="width: 60em"| <source lang="xml">
<const dmxchannel="0" name="Macro Effects" val="0" />
<const dmxchannel="0" name="Macro Effects" val="0" />
</source>
</syntaxhighlight>
Makroeffekte auf DMX-Kanal 1:
Makroeffekte auf DMX-Kanal {{Manual Value | DMX channel | 1}}:
* Dauerhaft gesetzter DMX-Wert 0.
* Dauerhaft gesetzter DMX-Wert {{Manual Value | DMX value | 0}}.
|}
|}
[[en: Open Function (DDF-Syntax) DMXC3]]
[[Kategorie: DDF DMXControl 3]]

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

Blockdevice.png Artikel beschreibt
DMXControl 3.3.0		 Open Function (DDF-Syntax) DMXC3
Arrow back.png Bühneneffekte
Inhaltsverzeichnis
Teil 1: Grundlagen
Teil 2: Funktionen
Teil 3: Procederes
Teil 4: Beispiele


Mit Hilfe der freien Funktionen (Open functions) werden in DMXControl 3 alle Funktionen eines Geräts abgebildet, welche sich (zur Zeit noch) nicht durch eine native Funktion wie zum Beispiel Dimmer, Strobe, Farbrad oder vergleichbar implementieren lassen. Sollte eine Funktion eines Geräts nicht nativ über eine der spezifischen Funktionen wie zum Beispiel goborotation für die Goborotation für ein Goborad oder strobe für das (einfach ausgedrückt) Blitzen des Geräts abzubilden sein, kann man im DDF so genannte allgemeine Funktionen oder vollständig freie Funktionen definieren.


Allgemeine Funktionen

Index

Diese Funktion kann verwendet werden, wenn sich beispielsweise die Linsen eines Strahleneffekt-Gerätes in einem bestimmten Winkel positionieren lassen.

Wichtiger Hinweis Für die Indizierung von Gobos sollte die Funktion index nicht verwendet werden. Der Regler Goboindex im Fenster Gobo lässt sich nur über die Funktion goboindex nutzen.
Variante Code-Beispiel
Standard 
<index dmxchannel="0">
  <range range="60" mindmx="0" maxdmx="127" minval="0" maxval="60" />
</index>

Index auf DMX-Kanal 1:

  • Ausrichtung der Linse o. ä. in einem Winkel zwischen 0° bei DMX-Wert 0 und 60° bei DMX-Wert 127.
Attribut range mindmx maxdmx minval maxval
Beschreibung Maximaler Drehwinkel für die Linse DMX-Wert für die Start-Position DMX-Wert für die End-Position Start-Position der Linse End-Position der Linse
Zulässiger Attributwert 0° bis 720° 0 bis 255 0 bis 255 0° bis 720° 0° bis 720°

Rotation

Diese Funktion kann verwendet werden, wenn sich beispielsweise die Linsen eines Strahleneffekt-Gerätes drehen lassen oder um die Drehung eines Spiegelkugelmotors steuern zu können.

Wichtiger Hinweis Für die Rotation von Gobos sollte die Funktion rotation nicht verwendet werden. Der Regler Goborotation im Fenster Gobo lässt sich nur über die Funktion goborotation nutzen.
Variante Code-Beispiel
Standard 
<rotation dmxchannel="0">
  <step type="stop" mindmx="191" maxdmx="192" />
  <range type="cw" mindmx="190" maxdmx="128" minval="0.05" maxval="5" />
  <range type="ccw" mindmx="193" maxdmx="255" minval="0.05" maxval="5" />
</rotation>

Rotation auf DMX-Kanal 1:

  • Keine Rotation bei zwischen DMX-Wert 191 und DMX-Wert 192.
  • Rotation im Uhrzeigersinn mit 5 1/s bei DMX-Wert 128, abnehmend bis 0,05 1/s bei DMX-Wert 190.
  • Rotation gegen den Uhrzeigersinn mit 0,05 1/s bei DMX-Wert 193, zunehmend bis 5 1/s bei DMX-Wert 255.
Attribut type mindmx maxdmx minval maxval
Beschreibung DMX-Wert für geringste Drehzahl DMX-Wert für die schnellste Drehzahl Minimale Drehzahl Maximale Drehzahl
Zulässiger Attributwert stop
cw
ccw 		0 bis 255 0 bis 255 0.01 1/s bis 10 1/s 0.01 1/s bis 10 1/s

Cool

Heat

Freie Funktionen

Da nicht alle Funktionen eines DMX-Gerätes exakt abgebildet werden können, gibt es Elemente, die sich frei definieren lassen. Diese werden dann aber nur in der Gerätesteuerung (Device Control) ausgegeben. Auch die Vorteile des Hardware-Abstraktions-Layers (HAL) lassen sich auf diese frei definierten Funktionen anwenden. Folgende Elemente sind aktuell verfügbar, um Funktionen eines DMX-Gerätes frei definieren zu können:

  • rawstep: Generiert eine Liste mit Auswahlmöglichkeiten für Funktionen.
  • raw: Generiert einen einfachen Schieberegler.
  • const: Sendt auf einem DMX-Kanal konstant einen bestimmten DMX-Wert.
Wichtiger Hinweis Alle oben genannten Elemente sind vollständig gerätespezifisch. Der HAL kann in Szenenlisten (Cuelists) etc. hinterlegte Werte nach einem Austausch des Geräts nicht automatisch auf das neue Gerät anwenden. Diese Element sollte möglichst immer nur verwendet werden, wenn die Abbildung der Funktion nicht eine native Funktion möglich ist.

rawstep

Über das Element rawstep wird im Device Control eine Liste erzeugt, um bestimmte Funktionen des DMX-Gerätes auswählen zu können. Typische Anwendungsfälle sind hierfür:

  • Auswahl von verschiedenen Betriebsmodi eines DMX-Gerätes wie direkte DMX-Steuerung, Abspielen von Automatik-Programmen, Aktivierung der Musiksteuerung
  • Einfügen und Entfernen einer Animationsscheibe in einem Moving-Head
  • Umschalten des Modus für die Pan-Tilt-Bewegung vom normalen, „klassischen“ Ansteuerungsmodus zum Endlos-Bewegungsmodus

Im Gegensatz zu den fest definierten Funktionen muss beim rawstep neben dem DMX-Kanal im Attribut name auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden. Die Beschreibung jedes step kann frei gewählt werden. Die gewählte Beschreibung hat keinen Einfluss auf die Arbeitsweise des HAL.

Variante Code-Beispiel
Standard 
<rawstep dmxchannel="0" name="Mode">
  <step caption="DMX" mindmx="0" maxdmx="9" />
  <step caption="Auto" mindmx="10" maxdmx="199" />
  <step caption="Music" mindmx="200" maxdmx="255" />
</rawstep>

Frei definierte Funktion mit dem Namen „Mode“ auf DMX-Kanal 1:

  • Aktivierung des DMX-Modus bei DMX-Wert zwischen 0 und 9.
  • Aktivierung der Automatik-Modus bei DMX-Wert zwischen 10 und 199.
  • Aktivierung der Sound-to-Light-Steuerung bei DMX-Wert zwischen 200 und 255.
Attribut type mindmx maxdmx
Beschreibung Beschreibung der Funktion Minimaler DMX-Wert zur Aktivierung der der Funktion Maximaler DMX-Wert zur Aktivierung der der Funktion
Zulässiger Attributwert Text 0 bis 255 0 bis 255
Wichtiger Hinweis Der Text für die Beschreibung darf kein &-Zeichen enthalten. Ansonsten kann das DDF nicht geladen werden.

raw

Das Element raw erzeugt im Device Control einen einzigen Schieberegler. Typische Anwendungsfälle sind hierfür:

  • Steuerung der Abspielgeschwindigkeit von Automatik-Programmen
  • Einstellung der Mikrofon-Empfindlichkeit für die Sound-to-Light-Steuerung
  • Geschwindigkeit und Drehrichtung für Endlos-Bewegungen von Moving-Heads
  • Drehrichtung und Drehgeschwindigkeit für Animationsscheiben
  • Nutzung für weitere Bewegungsachsen
  • Einstellung für Effektgeschwindigkeiten für Farb- und Goborädern
Wichtiger Hinweis Können über einen DMX-Kanal des vorliegenden Geräts zum Beispiel mehrere interne Programme ausgewählt und in ihrer Ablaufgeschwindigkeit verändert werden, sollten diese mit Hilfe des Elements rawranges implementiert werden.

Im Gegensatz zu den fest definierten Funktionen muss beim raw neben dem DMX-Kanal im Attribut name auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden.

Variante Code-Beispiel
Geschwindigkeitsregler für Automatikprogramme in vereinfachter Version 
<raw dmxchannel="0" name="Macro speed" />

Frei definierte Funktion mit dem Namen "Geschwindigkeit" auf DMX-Kanal 1:

  • Geschwindigkeit der Automatikprogramme zunehmend vom Wert 0 (geringste Geschwindigkeit) bei DMX-Wert 0 bis zum Wert 255 (maximale Geschwindigkeit) DMX-Wert 255.
Geschwindigkeitsregler für Automatikprogramme mit eigenem Wertebereich 
<raw dmxchannel="0" name="Macro speed" >
  <range type="linear" mindmx="0" maxdmx="255" minval="0" maxval="100" />
</raw>

Frei definierte Funktion mit dem Namen "Geschwindigkeit" auf DMX-Kanal 1:

  • Geschwindigkeit der Automatikprogramme zunehmend von 0% (geringste Geschwindigkeit) bei DMX-Wert 0 bis 100% (maximale Geschwindigkeit) DMX-Wert 255.
Vorlage für Animationsscheibe 
<raw dmxchannel="0" name="Animation disk rotation" >
  <step type="stop" mindmx="125" maxdmx="130" />
  <range type="cw" mindmx="131" maxdmx="255" minval="0.05" maxval="2" />
  <range type="ccw" mindmx="124" maxdmx="0" minval="-2" maxval="-0.05" />
</raw >

Frei definierte Funktion mit dem Namen "Rotation Animationsscheibe" auf DMX-Kanal 1:

  • Animationsscheibe statisch bei DMX-Wert zwischen 125 und 130.
  • Rotation der Animationsscheibe im Uhrzeigersinn mit 0,05 1/s bei DMX-Wert 131, schneller werdend bis 2 1/s bei DMX-Wert 255.
  • Rotation der Animationsscheibe gegen den Uhrzeigersinn mit -2 1/s bei DMX-Wert 124, abnehmend bis -0,05 1/s bei DMX-Wert 0.
Attribut type mindmx maxdmx minval maxval
Beschreibung Minimaler DMX-Wert für die Funktion Maximaler DMX-Wert für die Funktion Kleinster Wert Größter Wert
Zulässiger Attributwert linear
stop
cw
ccw 		0 bis 255 0 bis 255 Keine Einschränkung Keine Einschränkung

rawranges

Das Element rawranges erzeugt im Device Control einen Schieberegler für mehrere verschiedene Funktionen mit einem variablen Wertebereich. Die Funktionen können über das zugehörige, automatisch generierte Dropdown-Menü ausgewählt werden. Typische Anwendungsfälle sind hierfür:

  • Ändern der Abspielgeschwindigkeit von internen Programmen

Für eine eindeutige Zuordnung im Device Control muss beim Element neben dem dmxchannel ebenfalls im Attribut name auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden. Die grundlegende Definition unterscheidet sich vom Element raw nicht, sondern wird nur um das Attribut type ergänzt, in dem die Beschreibung der jeweiligen Funktion auf dem DMX-Kanal erfolgt.

Variante Code-Beispiel
Auswahl und Abspielgeschwindigkeit für Automatikprogramme 
<rawranges dmxchannel="0" name="Auto show" >
  <step type="Off" mindmx="0" maxdmx="31" />
  <range type="Show 1" mindmx="32" maxdmx="63" minval="0" maxval="100" />
  <range type="Show 2" mindmx="64" maxdmx="95" minval="0" maxval="100" />
  <range type="Show 3" mindmx="96" maxdmx="127" minval="0" maxval="100" />
  <range type="Show 4" mindmx="128" maxdmx="191" minval="0" maxval="100" />
  <range type="Show 5" mindmx="192" maxdmx="255" minval="0" maxval="100" />
</rawranges>

Frei definierte Funktion mit dem Namen "Auto show" auf DMX-Kanal 1:

  • Interne Show-Programme abgeschaltet zwischen DMX-Wert 0 und 31.
  • Aktivierung der Show 1 und Festlegung der Geschwindigkeit von 0% bei DMX-Wert 32 bis 100% bei DMX-Wert 63.
  • Aktivierung der Show 2 und Festlegung der Geschwindigkeit von 0% bei DMX-Wert 64 bis 100% bei DMX-Wert 95.
  • ...
Attribut type mindmx maxdmx minval maxval
Beschreibung Minimaler DMX-Wert für die Funktion Maximaler DMX-Wert für die Funktion Kleinster Wert Größter Wert
Zulässiger Attributwert Kurz-Beschreibung der Funktion 0 bis 255 0 bis 255 Keine Einschränkung Keine Einschränkung

const

Das Element const wird immer dann eingesetzt, wenn auf einem DMX-Kanal dauerhalt ein bestimmter DMX-Wert gesetzt werden muss, ansonsten mit diesem DMX-Kanal aber nicht anderweitig gearbeitet wird. Als Beispiel können zum Beispiel DMX-Kanäle aufgeführt werden, auf denen verschiedene interne Programme des DMX-Gerätes hinterlegt sind, welche aber nicht verwendet werden sollen.

Für das Element const ist keine graphische Benutzeroberfläche vorgesehen. Eine Anpassung des gesetzten DMX-Wertes ist nicht möglich.

Im Gegensatz zu den fest definierten Funktionen muss beim const neben dem DMX-Kanal im Attribut name auch ein Name bzw. eine kurze Beschreibung des DMX-Kanals angegeben werden. Im Attribut val wird der DMX-Wert angegeben, der dauerhaft auf diesem DMX-Kanal gesetzt werden soll.

Variante Code-Beispiel
Standard 
<const dmxchannel="0" name="Macro Effects" val="0" />

Makroeffekte auf DMX-Kanal 1:

  • Dauerhaft gesetzter DMX-Wert 0.
Abgerufen von „https://wiki-de.dmxcontrol-projects.org/index.php?title=Open_Function_(DDF-Syntax)_DMXC3&oldid=18401“