Umbra DMXC3

	Artikel beschreibt DMXControl 3.3.0 Stand: 28.03.2025	Umbra DMXC3
Inhaltsverzeichnis A Autoprepare B Bedienoberfläche (GUI) Blackout Bühnenansicht (Stage View) C Chat D Dateien im Projekt (Project Files) DDFs im Projekt aktualisieren (Update Project DDFs) DMX-Schnittstellen (DMX-Interfaces) Device Manager (Add Device Dialog) DDF Library DMX-In DMX-Out-Zuordnung (DMX-In DMX-Out-Mapping) E Effekte und Filter (Effects and Filters) Effektvisualisierung (Effect Visualizer) Einfrieren (Freeze) Eingangszuweisung (Input Assignment) Executor Executor Seite (Executor Page) F Fanning Farbliste (Color List) G Gerät (Device) Gerätegruppe (Device Group) Gerätesteuerung (Device Control) Gobo-Ähnlichkeiten (Gobo Affinity) Goboliste (Gobo List) Group Handling H Hardware Abstraction Layer (HAL) Hauptschalter (Main Switch) Hervorheben (Highlight) HTP-, LTP- und LoTP-Mischung (HTP-, LTP- and LoTP-Mixing) K Kanalübersicht (Channel Overview) Kernel (Server) L Lastmanagement (Electricity) Launcher M Macroboard Master Matrix MIDI-Verwaltung (MIDI Manager) N Netzwerkfunktionalitäten O Ordnungsliste (Item List) P Panel-Konzept Patching Plugin-Verwaltung (Plugin Manager) Positionsliste (Position List) Preset Programm- und Projekteinstellungen (Application und Project Settings) Programmer Programmer Filter Projektverwaltung (Project Administration) Projektexplorer (Project Explorer) Projektaufgaben (Project ToDos) Protokolldateien (Log Files) R Radix Relative und absolute Werte (Absolute and Relative Values) S Softdesk Softdesk Designer Steuerungsfenster (Control Panel) Szenenliste (Cuelist) Szenenlistegruppe (Cuelist Group) Szenenzeitkonfiguration (Cue Timing Editor) T Timecode Player Tracking U Umbra

Der Umbra von DMXControl 3 der Teil der Software, welcher für die Kommunikation zwischen den verschiedenen Programmteilen im DMXControl-Netzwerk übernimmt.

Abbildung 1: Umbra von DMXControl 3 nach dem Start.

Überblick

Der Umbra ist wie der Kernel für den Anwender meist nicht sichtbar und arbeitet im Hintergrund. Man kann sich den Umbra aber auf Wunsch den Launcher anzeigen lassen, wenn man dort den Umschalter für « Umbra verstecken (Hode Umbra) » betätigt. Beendet man die Bedienoberfläche, wird der Umbra ebenfalls heruntergefahren.

Der Umbra darf zu keinen Zeitpunkt beendet werden, wenn eine Show läuft. Beendet man den Umbra vorzeitig, kann die GUI oder andere Teilnehmer nicht mehr mit dem Kernel kommunizieren.

Bedienelemente

Der Umbra ist als Konsolenfenster konzipiert und verfügt deswegen über keine grafischen Bedienelemente. Die Steuerung des Umbras funktioniert ausschließlich über Kommandozeilenparameter.

Komandozeilenparameter

Der Umbra kann über folgende Kommandozeilenbefehle um genauere Informationen angesprochen werden, um mehr über den Status des Umbra zu erfahren. Auch sind einfache Tests möglich. Die Anzeigesprache und Kommandos sind in englisch und wurden nicht übersetzt.

Abbildung 2: Kommandozeilenparameter des Umbras.

Befehl	Beschreibung	Beispiel
Gruppe 1: Hauptmenü
shutdown, quit closeoder Strg + C	Beendet den Kernel.
status	Zeigt Statusinformationen an.
statistic	Gibt Informationen zur Nachrichtenstatistik im Konsolenfenster aus.
busy
connections
kill {client}	Sendet eine Benachrichtigung {message} an alle Clients.	notification Bitte das Projekt sichern!
killf {client}	Sendet eine Benachrichtigung {message} an ausgewählte Clients {sessionNames}.	notify LICHT-PC1 Bitte das Projekt sichern!
clear	Leert die Konsole.
width {Zeichenzahl}	Legt die Breite der Konsole fest (Anzahl der Zeichen).
help	Hilfemenü aufrufen (auch über ? erreichbar).

Enthält ein eingegebener Pfad Leer- oder Sonderzeichen, so sind die Anführungszeichen zwingend notwendig.

Nutzung

Network ID

Der Umbra arbeitet mit der NetworkID. Standardmäßig wird bei der ersten Installation die NetworkID auf den PC Namen gesetzt. Haben alle Programme (GUI, Kernel, Umbra) die gleiche und befinden sich im gleichen Netzwerk, so verbinden sich die Programme automatisch. Sollen im gleichen Netzwerk mehrere DMXControl Instanzen laufen, müssen die Programme unterschiedliche NetworkIDs haben, sonst gibt es einen Konflikt zwischen den Porgrammen.

Verteilte Infrastruktur

Damit der getrennte Betrieb von Bedienoberfläche und Kernel auf unterschiedlichen PCs funktioniert, sind folgende Voraussetzungen zu erfüllen:

• Die Komponenten des DMXC3-Netzwerks müssen den Umbra über den Umbra TCP Port erreicht können. Mithilfe des Ping Test, kann eine Verbindung geprüft werden, gerade wenn ein komplexeres Setup aufgebaut werden soll. Voraussetzung ist, dass in der Firewall icmp freigegeben ist.
• Damit die Kommunikation zwischen den Komponenten im DMX3-Netzwerk aufgebaut werden kann, müssen in der Firewall die unten stehenden Ports freigegeben in der Firewall werden. Üblicherweise fragt die Firewall dies beim ersten Start ab und trägt diese dann automatisch ein.

Damit das Automatische verbinden (Auto Discovery) funktioniert, müssen die PCs sich im gleichen Subnet befinden, da Broadcast nicht über eine Firewall hinweg funktioniert.

Port	TCP	UDP	Beschreibung
17474		Inoffiziell	DMXControl 3 Network Discovery
17475	Inoffiziell		DMXControl 3 Network Broker

Weitere Informationen zum Arbeiten mit DMXControl 3 auf mehreren PCs sind im Artikel Netzwerk-Konzept beschrieben.

Startparameter

Startparameter gibt man in der Regel einer Verknüpfung mit, um eine Anwendung zu starten. Um dem Umbra einen Startparameter zu übergeben, legt wird eine neue Verknüpfung zur Anwendung angelegt und in den Eigenschaften das Feld für das Ziel angepasst. Standardmäßig steht in diesem Feld nur der vollständige Pfad zur Anwendung, wie zum Beispiel:

"C:\Program Files (x86)\DMXControl Projects\DMXControl 3.3.0\Umbra\Umbra.exe"

Wichtig hierbei ist, dass der gesamte Pfad in Anführungszeichen gesetzt ist. Die zugelassenen Startparameter hängt dann sukzessive hinter dem Pfad zur Anwendung an, wobei dem Schlüsselwort immer zwei Minus-Zeichen vorangestellt ist. Um daher beispielsweise beim Start des Kernels direkt ein bestimmtes Projekt zu laden, sieht der vollständige Eintrag wie folgt aus:

"C:\Program Files (x86)\DMXControl Projects\DMXControl 3.3.0\Umbra\Umbra.exe" --load "{Network-ID}""

Es sind pro Verknüpfung beliebig viele Startparameter zulässig, welche in der nachfolgenden Tabelle aufgeführt sind.

Parameter	Beschreibung	Beispiel
--hidden	Der Kernel wird versteckt im Hintergrund ausgeführt und ist nicht in der Taskleiste sichtbar.
--nonetwork	Die Netzwerkfunktionalität bleibt deaktiviert, wodurch später in der GUI der Eintrag « Connection » in der Menüleiste des Hauptfensters nicht angezeigt wird. Der nonetwork-Modus kann dann genutzt werden, wenn Kernel und GUI auf dem selben PC arbeiten.

Konfigurations-Verzeichnis

Im Windows Explorer existiert nach dem erstmaligen Start des Kernels ein Verzeichnis, in dem verschiedene Einstellungen abgelegt werden. Standardmäßig befindet sich das Verzeichnis unter "C:\Users\{BENUTZERNAME}\AppData\Roaming\DMXControl Projects e.V\DMXControl\Umbra\Config", wobei "{BENUTZERNAME}" durch den Namen des aktuellen Benutzers des PCs zu ersetzen ist. Alternativ kann man das Verzeichnis auch über "%AppData%\Roaming\DMXControl Projects e.V.\Umbra\Config" erreichen.

Datei	Beschreibung	Beispiel	Optional
UmbraSettings.xml	Beinhaltet die NetworkID des Umbras		Nein

Links und Referenzen