(Formatierung verbessert und verschiedene Querverweise eingefügt) |
Keine Bearbeitungszusammenfassung |
||
(2 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
{{ | {{Manual Header | ||
| Type = DMXC3 DDFs | |||
| Version = 3.3.0 | |||
|zurückLink = Stage_Effect_(DDF-Syntax)_DMXC3 | | zurückLink = Stage_Effect_(DDF-Syntax)_DMXC3 | ||
|zurückText = Bühneneffekte | | zurückText = Bühneneffekte | ||
|vorLink = | | vorLink = | ||
|vorText = | | vorText = | ||
}} | }} | ||
Zeile 16: | Zeile 16: | ||
Diese Funktion kann verwendet werden, wenn sich beispielsweise die Linsen eines Strahleneffekt-Gerätes in einem bestimmten Winkel positionieren lassen. | 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.}} | {{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.}} | ||
{{DMXC3 Manual-Tableheader DDF-Code examples | de }} | {{DMXC3 Manual-Tableheader DDF-Code examples | de }} | ||
| Standard | | Standard | ||
Zeile 28: | Zeile 26: | ||
* 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}}. | * 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}}. | ||
|} | |} | ||
{| | {{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 | |||
! style=" | | DMX-Wert für die End-Position | ||
| Start-Position der Linse | |||
| End-Position der Linse | |||
|- | |- | ||
! style="vertical-align:top" | Zulässiger Attributwert | ! style="vertical-align:top" | Zulässiger Attributwert | ||
Zeile 50: | Zeile 45: | ||
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. | 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.}} | {{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.}} | ||
{{DMXC3 Manual-Tableheader DDF-Code examples | de }} | {{DMXC3 Manual-Tableheader DDF-Code examples | de }} | ||
| Standard | | Standard | ||
Zeile 66: | Zeile 59: | ||
* 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}}. | * 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}}. | ||
|} | |} | ||
{| | {{DMXC3 Manual-Tableheader DDF-Code attributes | de | range-generic}} | ||
! style="vertical-align:top" | Beschreibung | |||
| | |||
|- | | DMX-Wert für geringste Drehzahl | ||
! style=" | | DMX-Wert für die schnellste Drehzahl | ||
| Minimale Drehzahl | |||
| Maximale Drehzahl | |||
|- | |- | ||
! style="vertical-align:top" | Zulässiger Attributwert | ! style="vertical-align:top" | Zulässiger Attributwert | ||
| <code>stop</code><br /> | | <code>stop</code><br /> <code>cw</code><br /> <code>ccw</code> | ||
<code>cw</code><br /> | |||
<code>ccw</code> | |||
| <code>0</code> bis <code>255</code> | | <code>0</code> bis <code>255</code> | ||
| <code>0</code> bis <code>255</code> | | <code>0</code> bis <code>255</code> | ||
Zeile 86: | Zeile 74: | ||
| <code>0.01 1/s</code> bis <code>10 1/s</code> | | <code>0.01 1/s</code> bis <code>10 1/s</code> | ||
|} | |} | ||
== Cool == | |||
== Heat == | |||
= Freie Funktionen = | = 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. | 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. }} | {{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. }} | ||
Zeile 105: | Zeile 95: | ||
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. | 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 }} | {{DMXC3 Manual-Tableheader DDF-Code examples | de }} | ||
| Standard | | Standard | ||
Zeile 121: | Zeile 109: | ||
* Aktivierung der Sound-to-Light-Steuerung bei DMX-Wert zwischen {{Manual Value | DMX value | 200}} und {{Manual Value | DMX value | 255}}. | * Aktivierung der Sound-to-Light-Steuerung bei DMX-Wert zwischen {{Manual Value | DMX value | 200}} und {{Manual Value | DMX value | 255}}. | ||
|} | |} | ||
{| | {{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 | ||
! style=" | | Maximaler DMX-Wert zur Aktivierung der der Funktion | ||
|- | |- | ||
! style="vertical-align:top" | Zulässiger Attributwert | ! style="vertical-align:top" | Zulässiger Attributwert | ||
Zeile 135: | Zeile 120: | ||
| <code>0</code> bis <code>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. }} | {{Manual Box | de | Important| Der Text für die Beschreibung darf kein &-Zeichen enthalten. Ansonsten kann das DDF nicht geladen werden. }} | ||
Zeile 146: | Zeile 130: | ||
* 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 | ||
{{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.}} | |||
{{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> | |||
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. | 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 }} | {{DMXC3 Manual-Tableheader DDF-Code examples | de }} | ||
| Geschwindigkeitsregler für Automatikprogramme in vereinfachter Version | | Geschwindigkeitsregler für Automatikprogramme in vereinfachter Version | ||
Zeile 182: | Zeile 163: | ||
* 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}}. | * 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}}. | ||
|} | |} | ||
{| | {{DMXC3 Manual-Tableheader DDF-Code attributes | de | range-generic}} | ||
! style="vertical-align:top" | Beschreibung | |||
| | |||
|- | | Minimaler DMX-Wert für die Funktion | ||
! style=" | | 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 /> | | <code>linear</code><br /> <code>stop</code><br /> <code>cw</code><br /> <code>ccw</code> | ||
<code>stop</code><br /> | |||
<code>cw</code><br /> | |||
<code>ccw</code> | |||
| <code>0</code> bis <code>255</code> | | <code>0</code> bis <code>255</code> | ||
| <code>0</code> bis <code>255</code> | | <code>0</code> bis <code>255</code> | ||
Zeile 209: | Zeile 184: | ||
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. | 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 }} | {{DMXC3 Manual-Tableheader DDF-Code examples | de }} | ||
| Auswahl und Abspielgeschwindigkeit für Automatikprogramme | | Auswahl und Abspielgeschwindigkeit für Automatikprogramme | ||
Zeile 229: | Zeile 202: | ||
* ... | * ... | ||
|} | |} | ||
{| | {{DMXC3 Manual-Tableheader DDF-Code attributes | de | range-generic}} | ||
! style="vertical-align:top" | Beschreibung | |||
| | |||
|- | | Minimaler DMX-Wert für die Funktion | ||
! style=" | | 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 | ||
Zeile 254: | Zeile 224: | ||
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 }} | {{DMXC3 Manual-Tableheader DDF-Code examples | de }} | ||
| Standard | | Standard | ||
Zeile 265: | Zeile 233: | ||
|} | |} | ||
[[en: Open Function (DDF-Syntax) DMXC3]] | |||
[[Kategorie: DDF DMXControl 3]] | [[Kategorie: DDF DMXControl 3]] |
Aktuelle Version vom 10. November 2024, 15:03 Uhr
Artikel beschreibt DMXControl 3.3.0 |
| |||||||||||||||||||||||||||||
|
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.
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:
|
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.
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:
|
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.
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:
|
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
|
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
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:
|
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:
|
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:
|
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:
|
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:
|