Grundregeln (DDF-Syntax) DMXC3: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
K |
|||
(8 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
− | {{Kapitelüberschrift|Version=DMXControl 3. | + | {{Kapitelüberschrift|Version=DMXControl 3.2.0}} |
− | |||
{{DMXC3_Manual-Navigation_DDF | {{DMXC3_Manual-Navigation_DDF | ||
− | |zurückLink = DDF- | + | |zurückLink = Funktionselemente (DDF-Syntax) DMXC3 |
− | |zurückText = | + | |zurückText = Funktionselemente |
− | |vorLink = DDF- | + | |vorLink = Intensity (DDF-Syntax) DMXC3 |
|vorText = Intensität | |vorText = Intensität | ||
}} | }} | ||
− | =Grundregeln bei der Erstellung eines DDFs= | + | = Grundregeln bei der Erstellung eines DDFs = |
+ | == Allgemeine Regeln == | ||
Bei den DDFs sind folgende grundlegenden Regeln zu beachten: | Bei den DDFs sind folgende grundlegenden Regeln zu beachten: | ||
− | * Die DMX-Kanäle werden in den DDFs immer bei 0 beginnend gezählt. Deswegen sind für einen LED-PAR mit 5 DMX-Kanälen im DDF auch die DMX-Kanäle 0 bis 4 angegeben, während die Funktionen in der Bedienungsanleitung von DMX-Kanal 1 bis 5 beschriftet sind. | + | * Die DMX-Kanäle werden in den DDFs immer bei {{Manual Value | DMX channel | 0}} beginnend gezählt. Deswegen sind für einen LED-PAR mit {{Manual Value || 5}} DMX-Kanälen im DDF auch die DMX-Kanäle {{Manual Value | DMX channel | 0}} bis {{Manual Value | DMX channel | 4}} angegeben, während die Funktionen in der Bedienungsanleitung von DMX-Kanal {{Manual Value | DMX channel | 1}} bis {{Manual Value | DMX channel | 5}} beschriftet sind. |
* Die Bezeichnung der Geräte beschränkt sich nur auf die Bezeichnung selbst, wie sie auf dem Deckblatt des Handbuchs steht. Zusätzliche Angaben wie beispielsweise der DMX-Modus / Kanalbelegung oder sonstige Kommentare sind dort nicht zu hinterlegen. | * Die Bezeichnung der Geräte beschränkt sich nur auf die Bezeichnung selbst, wie sie auf dem Deckblatt des Handbuchs steht. Zusätzliche Angaben wie beispielsweise der DMX-Modus / Kanalbelegung oder sonstige Kommentare sind dort nicht zu hinterlegen. | ||
* Die Eintragung der Werte für Strobe-Frequenz, Schwenk-Bereiche für Pan und Tilt, Drehzahl für Goborotation etc. erfolgt ohne Einheiten. Die üblichen Einheiten für diese Werte sind in der nachfolgenden Tabelle aufgelistet. | * Die Eintragung der Werte für Strobe-Frequenz, Schwenk-Bereiche für Pan und Tilt, Drehzahl für Goborotation etc. erfolgt ohne Einheiten. Die üblichen Einheiten für diese Werte sind in der nachfolgenden Tabelle aufgelistet. | ||
* Die zugehörigen DMX-Werte zum Beispiel für die Drehzahl der Goborotation sind so einzutragen, dass von dem Punkt Goborotation stopp aus die Drehzahlen vor und entgegen des Uhrzeigersinns zunehmen. | * Die zugehörigen DMX-Werte zum Beispiel für die Drehzahl der Goborotation sind so einzutragen, dass von dem Punkt Goborotation stopp aus die Drehzahlen vor und entgegen des Uhrzeigersinns zunehmen. | ||
* Bilder für das Geräte-Icon sowie für die Gobos sollen in einer Auslösung von 128 x 128 Pixeln und als *.png-Datei im DDF hinterlegt werden. | * Bilder für das Geräte-Icon sowie für die Gobos sollen in einer Auslösung von 128 x 128 Pixeln und als *.png-Datei im DDF hinterlegt werden. | ||
− | * | + | * Die DDFs werden üblicherweise in englischer Sprache verfasst, damit diese allgemeingültig bleiben und für alle Sprachversionen von DMXControl 3 genutzt werden können. Darüber hinaus ist die Standardsprache von DMXControl 3 englisch. |
− | |||
+ | == Erwartete Einheiten für Werte == | ||
+ | Die folgende Tabelle gibt einen allgemeinen Überblick über die Einheiten, in welchen die HAL bei den aufgeführten Funktionen erwartet. Dabei handelt es sich jeweils um die Werte für die Attribute <code>minval</code> und <code>maxval</code>, wenn in einer Funktion (Goborad, Strobe, Zoom, etc.) ein <code>range</code>-Element verwendet wird, um den Wertebereich der Funktion auf dem angegeben Teilbereich des DMX-Kanals zu beschreiben. Welche Werte für die Attribute <code>minval</code> und <code>maxval</code> zulässig sind, kann bei jeder Beschreibung der Funktion nachgelesen werden. | ||
{| class="wikitable toptextcells" | {| class="wikitable toptextcells" | ||
|- | |- | ||
Zeile 50: | Zeile 51: | ||
|} | |} | ||
− | =Fehlerbehebung= | + | = Fehlerbehebung = |
Dies sind häufige Fehler, die verhindern, dass ein DDF zu einem Projekt hinzugefügt werden kann: | Dies sind häufige Fehler, die verhindern, dass ein DDF zu einem Projekt hinzugefügt werden kann: | ||
* Bei Pan- und Tilt wurde im Attribut <code>range</code> kein Schwenkbereich angegeben. | * Bei Pan- und Tilt wurde im Attribut <code>range</code> kein Schwenkbereich angegeben. | ||
− | * Für Strobe ist kein Wert für <code>minval</code> und <code>maxval</code> hinterlegt. | + | * Für Strobe ist kein Wert für <code>minval</code> und <code>maxval</code> hinterlegt oder liegt nicht im vorgesehenen Wertebereich. |
* Der Tag <code>model</code> ist noch falsch geschrieben. | * Der Tag <code>model</code> ist noch falsch geschrieben. | ||
+ | {{Manual Box | de | Important | Kann insbesondere ein älteres Projekt nicht geladen werden, dann lässt sich dies auch immer wieder auf DDFs zurückführen. Beim Laden eines Projekts erfolgt jedes Mal eine automatische Prüfung von DDFs hinsichtlich eventueller Logikfehler. Wird diese nicht erfolgreich absolviert, wird das Laden des Projekts abgebrochen. Hier kann es helfen, die DDFs aus diesem Projekt einmal separat in einem leeren Projekt zu laden und bei Bedarf zu korrigieren.}} | ||
+ | [[en: Basic rules (DDF-Syntax) DMXC3]] | ||
[[Kategorie: DDF DMXControl 3]] | [[Kategorie: DDF DMXControl 3]] |
Aktuelle Version vom 10. Februar 2024, 14:43 Uhr
Grundregeln (DDF-Syntax) DMXC3 | Artikel beschreibt DMXControl 3.2.0 |
|
Inhaltsverzeichnis
Grundregeln bei der Erstellung eines DDFs
Allgemeine Regeln
Bei den DDFs sind folgende grundlegenden Regeln zu beachten:
- Die DMX-Kanäle werden in den DDFs immer bei 0 beginnend gezählt. Deswegen sind für einen LED-PAR mit 5 DMX-Kanälen im DDF auch die DMX-Kanäle 0 bis 4 angegeben, während die Funktionen in der Bedienungsanleitung von DMX-Kanal 1 bis 5 beschriftet sind.
- Die Bezeichnung der Geräte beschränkt sich nur auf die Bezeichnung selbst, wie sie auf dem Deckblatt des Handbuchs steht. Zusätzliche Angaben wie beispielsweise der DMX-Modus / Kanalbelegung oder sonstige Kommentare sind dort nicht zu hinterlegen.
- Die Eintragung der Werte für Strobe-Frequenz, Schwenk-Bereiche für Pan und Tilt, Drehzahl für Goborotation etc. erfolgt ohne Einheiten. Die üblichen Einheiten für diese Werte sind in der nachfolgenden Tabelle aufgelistet.
- Die zugehörigen DMX-Werte zum Beispiel für die Drehzahl der Goborotation sind so einzutragen, dass von dem Punkt Goborotation stopp aus die Drehzahlen vor und entgegen des Uhrzeigersinns zunehmen.
- Bilder für das Geräte-Icon sowie für die Gobos sollen in einer Auslösung von 128 x 128 Pixeln und als *.png-Datei im DDF hinterlegt werden.
- Die DDFs werden üblicherweise in englischer Sprache verfasst, damit diese allgemeingültig bleiben und für alle Sprachversionen von DMXControl 3 genutzt werden können. Darüber hinaus ist die Standardsprache von DMXControl 3 englisch.
Erwartete Einheiten für Werte
Die folgende Tabelle gibt einen allgemeinen Überblick über die Einheiten, in welchen die HAL bei den aufgeführten Funktionen erwartet. Dabei handelt es sich jeweils um die Werte für die Attribute minval
und maxval
, wenn in einer Funktion (Goborad, Strobe, Zoom, etc.) ein range
-Element verwendet wird, um den Wertebereich der Funktion auf dem angegeben Teilbereich des DMX-Kanals zu beschreiben. Welche Werte für die Attribute minval
und maxval
zulässig sind, kann bei jeder Beschreibung der Funktion nachgelesen werden.
Wert | Einheit | Verwendung |
---|---|---|
Drehzahl | 1/s (Umdrehung pro Sekunde) |
Goborotation, Prismenrotation, kontinuierliche Drehung des Farbrads, kontinuierliche Drehung des Goborads |
Farbtemperatur | K (Kelvin) |
Farbtemperatur |
Frequenz | Hz (Hertz) |
Strobe-Frequenz, Goboshake-Geschwindigkeit |
Winkel | ° (Grad) |
Pan- und Tilt-Schwenkbereich, Goboindizierung, Prismenindizierung, Zoom |
Einheitslos | % (Prozent) |
Dimmer, Iris |
Fehlerbehebung
Dies sind häufige Fehler, die verhindern, dass ein DDF zu einem Projekt hinzugefügt werden kann:
- Bei Pan- und Tilt wurde im Attribut
range
kein Schwenkbereich angegeben. - Für Strobe ist kein Wert für
minval
undmaxval
hinterlegt oder liegt nicht im vorgesehenen Wertebereich. - Der Tag
model
ist noch falsch geschrieben.
Kann insbesondere ein älteres Projekt nicht geladen werden, dann lässt sich dies auch immer wieder auf DDFs zurückführen. Beim Laden eines Projekts erfolgt jedes Mal eine automatische Prüfung von DDFs hinsichtlich eventueller Logikfehler. Wird diese nicht erfolgreich absolviert, wird das Laden des Projekts abgebrochen. Hier kann es helfen, die DDFs aus diesem Projekt einmal separat in einem leeren Projekt zu laden und bei Bedarf zu korrigieren. |