Command Line DMXC3: Unterschied zwischen den Versionen

Aus Deutsches DMXC-Wiki
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(2 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 4: Zeile 4:


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.
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 =
= Nutzung =
== Fenster der Kommandozeile ==
== Fenster der Kommandozeile ==
Das Fenster für die Kommandozeile kann man über die Menüleiste mittels des Weges {{Manual MenuText | 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 {{Manual Buttons |Energie! (Engage!)}}, um den Befehl auszuführen.


== Fehlermeldungen ==
== Fehlermeldungen ==
Zeile 17: Zeile 21:
= Aufbau =
= Aufbau =
== Grundlegende Arbeitsweise ==
== Grundlegende Arbeitsweise ==
Die Grammatik der Kommandozeile in DMXControl 3 folgt üblicherweise:
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.
* Eine Auswahl von  Geräten oder Gerätegruppen soll für die Gerätefunktion ... den Wert ... erhalten.
* Das Objekt ... soll dem folgenden Element zugeordnet werden.
* Das Objekt ... soll dem nachfolgenden angegeben Element zugeordnet werden.


{{Manual Box | de | Important | Jedem Befehl (Command) und jedem Wert muss grundsätzlich ein Leerzeichen folgen, da sonst nicht zwischen den verschiedenen Befehlen unterschieden werden kann.}}
{{Manual Box | de | Important | Jedem Befehl (Command) und jedem Wert muss grundsätzlich ein Leerzeichen folgen, da sonst nicht zwischen den verschiedenen Befehlen unterschieden werden kann.}}
Zeile 50: Zeile 54:
{| class="wikitable toptextcells"
{| class="wikitable toptextcells"
|-
|-
! colspan="2" | Befehl !! rowspan="2" | Erläuterung !! rowspan="2" | Erwartete nachfolgende Befehle !! Beispiel
! colspan="2" | Befehl !! rowspan="2" | Tätigkeit / Aktion!! colspan="2" | Erwartete nachfolgende Befehle !! rowspan="2" | Beispiel
|-
! style="width: 75px" | normal !! style="width: 75px" | kurz !! Beschreibung !! Mögliche Werte
|-
| <code>select</code> || || Einzelnes Element auswählen || Elementtyp und Nummer bzw. Name || <code>device</code><br /> <code>group</code><br /> <code>cuelist</code><br /> <code>executor</code> ||<code>select group 1</code><br /><code>select device 5</code>
|-
|-
! style="width: 150px" | Normalform !! style="width: 150px" | Kurzform
| <code>thru</code> || || Die Auswahl eines Elements erweitern, sodass der angegebene Bereich ausgewählt wird || Obergrenze des gewünschten Wertebereichs || Nummer oder Name des Elements || <code>1 thru 4</code><br /> <code>"DMH (2)" thru "DMH (6)"</code>
|-
|-
| <code>select</code> || || Einzelne Element oder mehrere Elemente auswählen || Elementtyp und Nummer bzw. Name || <code>select group 1</code>
| <code>set</code> || || Ein Element direkt auswählen und einen bestimmten Wert setzen || Elementtyp, dessen Nummer bzw. Name sowie Gerätefunktion und Wert ||  || <code>set device 6 @ dimmer 80</code>
|-
|-
| <code>thru</code> || || Angabe eines Auswahlbereichs || Obergrenze des gewünschten Wertebereichs || <code>1 thru 4</code>
| <code>at</code> || <code>@</code> || Einen Wert für eine Gerätefunktion auf einen bestimmten Wert setzen || Gerätefunktion und Wert || <code>dimmer</code><br /> <code>color</code> || <code>dimmer 70</code>
|-
|-
| <code>set</code> ||  
| <code>assign</code> || || Ein Element dem angegeben Element zuordnen || Jeweils Element mit Nummer oder Name || <code>cuelistgroup</code><br /> <code>executor</code> || <code>assign cuelist 1 cuelistgroup 2</code>
|-
|-
| <code>at</code> || <code>@</code> || Wert für eine Gerätefunktion auf einen bestimmten Wert setzen || Gerätefunktion und Wert || <code>dimmer 70</code>
| <code>remove</code> || || Element entfernen ||
|}
|}



Aktuelle Version vom 3. April 2026, 19:30 Uhr

Books.png Artikel beschreibt
DMXControl 3.3.2
Stand: 03.04.2026
Command Line DMXC3
Inhaltsverzeichnis

A

B

C

D

E

F

G

H

K

L

M

N

O

P

R

S

T

U

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.


Wichtiger Hinweis 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 und Gerätegruppen

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 device
group
cuelist
executor
select group 1
select 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 dimmer
color
dimmer 70
assign Ein Element dem angegeben Element zuordnen Jeweils Element mit Nummer oder Name cuelistgroup
executor
assign cuelist 1 cuelistgroup 2
remove Element entfernen
SELECT
SET
ASSIGN
REMOVE
CLEAR
AT oder @
THRU

Steuerbefehle

TRUE
FALSE

Befehle für Objekte

WHEEL
TYPE
DURATION
ITEM
SHAKE
ANGLE
MEMBER

Programmfunktionen

AUDIOFILE
CUE
CUELIST
CUELISTGROUP
DEVICE
DEVICEGROUP oder GROUP
EXECUTOR
EXECUTORPAGE
BUTTON
FADER
MACRO
PRESET
TIMECODE

Gerätefunktionen

Hauptfunktionen

BLADES
COLOR
COLORTEMP
COOL
DIMMER
FAN
FOCUS
FOG
FROST
GOBO
HEAT
INDEX
IRIS
POSITION
PRISM
PTSPEED
RAW
ROTATION
WHEELROTATION
SHUTTER
STROBE
ZOOM

Kurzbefehle

LUMOS oder @@
NOX oder ..

Unterfunktionen

Farben

RED
GREEN
BLUE
CYAN
MAGENTA
YELLOW
HUE
VALUE
SATURATION
REDORANGE
LIME
MINT
INDIGO
AMBER
WHITE
COLDWHITE
NATURALWHITE
WARMWHITE
UV

Bewegungsachsen

PAN
TILT

Dimmer / Shutter

FULL
ZERO
OPEN
CLOSE

Blendenschieber

TOP
LEFT
RIGHT
BOTTOM
ALL