Mit der Kommandozeile hat man in DMXControl 3 die Möglichkeit, eine Vielzahl von Programmfunktionen über die Eingabe von bestimmten Steuerbefehlen auszuführen. Diese Steuerbefehle und davon abhängige zusätzliche bzw. erwartete nachfolgende Angaben sind Bestandteil der so genannten Grammatik.
Im weitesten Sinne ist die Grammatik für die Kommandozeile etwas vergleichbares wie der Syntax für die DDF, wo ebenfalls durch die Kombination von Schlüsselwörtern und Werten verschiedene Aktionen umgesetzt werden.
Nutzung
Fenster der Kommandozeile
Das Fenster für die Kommandozeile kann man über die Menüleiste mittels des Weges « Fenster (Windows) »⇒ « Kommandozeile (Command Line) » aufrufen.
In diesem Fenster wird inhaltlich nicht viel angezeigt. Dies liegt daran, dass der große Bereich für die Protokollierung bei der der erstmaligen Verwendung der Kommandozeile in dem Projekt leer ist. Unter diesem Bereich befindet sich die Eingabezeile, wo man den Befehl entsprechend einträgt sowie der Button [Energie! (Engage!)], um den Befehl auszuführen.
Fehlermeldungen
Beim Ausführen der Befehle erhält man immer eine Rückmeldung am Beginn des jeweiligen Befehlt, inwieweit dieser umgesetzt werden konnte.
- rot: Befehl kann grundsätzlich nicht ausgeführt werden auf Grund falscher Eingaben
- gelb: Befehl ist richtig, jedoch außerhalb des des möglichen Bereichs
- grün: Befehl wurde ausgeführt
Aufbau
Grundlegende Arbeitsweise
Die Grammatik der Kommandozeile in DMXControl 3 folgt üblicherweise dem Schema:
- Eine Auswahl von Geräten oder Gerätegruppen soll für die Gerätefunktion ... den Wert ... erhalten.
- Das Objekt ... soll dem nachfolgenden angegeben Element zugeordnet werden.
|
Jedem Befehl (Command) und jedem Wert muss grundsätzlich ein Leerzeichen folgen, da sonst nicht zwischen den verschiedenen Befehlen unterschieden werden kann. |
Struktur
Auswahl von Geräten, Gerätegruppen etc.
Um Elemente wie Geräte, Gerätegruppen, Szenenlisten, Executoren etc. auszuwählen geschieht dies immer auf Basis von
| 1 | 2 |
|---|---|
| Steuerbefehl zum Auswählen | gewünschtes Element |
select |
device ...group ...cuelist ...executor ...
|
Die Auswahl kann dabei auch komplexer ausfallen, indem man nicht nur einen Bereich von Elementen auswählt
| 1 | 2 | 3 | 4 |
|---|---|---|---|
| Steuerbefehl zum Auswählen | erstes auszuwählenden Element | Steuerbefehl für Bereich | letztes auszuwählendes Element |
select |
device ...group ...cuelist ...executor ... |
thru |
device ...group ...cuelist ...executor ...
|
Es ist auch möglich, aus einer Auswahl einzelne Elemente wieder auszuschließen bzw. andere Elemente oder einen zweiten Bereich mit in die Auswahl aufzunehmen
Steuerbefehl zum Auswählen + erstes auszuwählenden Element + Steuerbefehl für Bereich + letztes auszuwählendes Element + Steuerbefehl zum Ausschließen / Abwählen eines Elements + abzuwählendes Element + Steuerbefehl zum Hinzufügen + hinzuzufügendes Element
Werte zu Gerätefunktionen setzen
Zuordnung zu Objekten
Beispiele
set device 6 @ dimmer 80
7 @ 100
select device 51 thru 54 + 41 thru 46 - 45
select device group 4
at color 1;1;0 at dimmer 50
select device group 5
at gobo wheel 2 item 4
@ gobo 1:5 @ gobo 2:6
@ color wheel 1 item 3
assign cuelist 1 cuelistgroup 2
Grammatik der Kommandozeile
Allgemeine Befehle
Auswahl und Aktionen
| Befehl | Tätigkeit / Aktion | Erwartete nachfolgende Befehle | Beispiel | ||
|---|---|---|---|---|---|
| normal | kurz | Beschreibung | Mögliche Werte | ||
select |
Einzelnes Element auswählen | Elementtyp und Nummer bzw. Name | devicegroupcuelistexecutor |
select group 1select device 5
| |
thru |
Die Auswahl eines Elements erweitern, sodass der angegebene Bereich ausgewählt wird | Obergrenze des gewünschten Wertebereichs | Nummer oder Name des Elements | 1 thru 4"DMH (2)" thru "DMH (6)"
| |
set |
Ein Element direkt auswählen und einen bestimmten Wert setzen | Elementtyp, dessen Nummer bzw. Name sowie Gerätefunktion und Wert | set device 6 @ dimmer 80
| ||
at |
@ |
Einen Wert für eine Gerätefunktion auf einen bestimmten Wert setzen | Gerätefunktion und Wert | dimmercolor |
dimmer 70
|
assign |
Ein Element dem angegeben Element zuordnen | Jeweils Element mit Nummer oder Name | cuelistgroupexecutor |
assign cuelist 1 cuelistgroup 2
| |
remove |
Element entfernen | Keine nachfolgende Befehle | |||
clear |
Auswahl enfernen / Programmer leeren | ||||
Angabe des auszuwählenden Elements
Grundsätzlich erfolgt in der Kommandozeile die Auswahl eines Elements, also eines Geräts, einer Gerätegruppe, einer Szenenliste etc. auf Basis der internen Nummer. Die internen Nummern sind je nach Element an unterschiedlichen Stellen zu finden:
- Gerät: Projekt-Explorer, Eigenschaften des Geräts, Dialog für Patching und CSV-Export
- Gerätegruppe: Projekt-Explorer, Eigenschaften der Gerätegruppe
- Szenenliste: Eigenschaften der Szenenliste
- Executor: Executor-Fenster, Eigenschaften des Executors
Üblicherweise sind die internen Nummern der Elemente aufsteigend in der Reihenfolge, in der sie angelegt bzw. dem Projekt hinzugefügt werden. Sie lassen sich aber im Nachgang noch anpassen. Dies kann zum Beispiel gerade bei den Geräten hilfreich sein, damit zum Beispiel alle gleichen Geräte in einem fortlaufenden Nummernkreis liegen. Wie viele Ziffern die interne Nummer nach der Anpassungen umfasst, ist egal.
Alternativ kann man ein Element auch auf Basis seines Namens auswählen. In diesem Fall muss der Name des Elements nach dem Steuerbefehl in Anführungszeichen gesetzt werden, damit Leerzeichen oder auch andere Sonderzeichnen im Namen auch dem Namen des Elements zugeordnet werden können. Folglich wäre die korrekte Auswahl auf Basis des Namens zum Beispiel "DMH (2)".
Steuerbefehle
TRUE
FALSE
Befehle für Objekte
WHEEL
TYPE
DURATION
ITEM
SHAKE
ANGLE
MEMBER
Gerätefunktionen
Kurzbefehle
LUMOS oder @@
NOX oder ..
Hauptfunktionen
BLADES
COLOR
COLORTEMP
COOL
DIMMER
FAN
FOCUS
FOG
FROST
GOBO
HEAT
INDEX
IRIS
POSITION
PRISM
PTSPEED
RAW
ROTATION
WHEELROTATION
SHUTTER
STROBE
ZOOM
Unterfunktionen
Dimmer / Shutter
FULL
ZERO
OPEN
CLOSE
Bewegungsachsen
PAN
TILT
Farben
RED
GREEN
BLUE
CYAN
MAGENTA
YELLOW
HUE
VALUE
SATURATION
REDORANGE
LIME
MINT
INDIGO
AMBER
WHITE
COLDWHITE
NATURALWHITE
WARMWHITE
UV
Blendenschieber
TOP
LEFT
RIGHT
BOTTOM
ALL
Programmfunktionen
AUDIOFILE
CUE
CUELIST
CUELISTGROUP
DEVICE
DEVICEGROUP oder GROUP
EXECUTOR
EXECUTORPAGE
BUTTON
FADER
MACRO
PRESET
TIMECODE