Log Files DMXC3

	Artikel beschreibt DMXControl 3.3.0 Stand: 04.03.2025	Log Files 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

In DMXControl 3 werden zahlreiche Aktionen von allen Programm-Komponenten wie dem Kernel, dem Umbra und der Bedienoberfläche (GUI) in Protokolldateien (Log Files) aufgezeichnet. Dies sind unter anderem:

• Start-Prozedere des Kernels und der Bedienoberfläche
• Herstellen und Trennen von Verbindungen zwischen den verschiedenen Programm-Komponenten
• Laden eines Projekts
• Anlegen und aktivieren der DMX-Ausgabe über verschiedene Interfaces
• Hinzufügen von neuen Geräten (Devices)
• Aktionen in der Bühnenansicht (Stage View)
• Starten und Stoppen von Szenenlisten (Cuelists) über Szenenlistengruppen (Cuelist Groups)
• Auslösen von Aktionen über das Input Assignment
• Speichern oder exportieren des Projekts
• Beenden von Bedienoberfläche, Umbra und Kernel

Während der Installation von DMXControl 3 protokolliert der Installer auch den Installationsprozess. Dies umfasst in erster Linie, ob die benötigten Zusatzmodule vorhanden oder noch installiert werden müssen sowie eine Auflistung aller Dateien, die vom Installer in das gewünschte Verzeichnis kopiert werden.

Die gesamte Protokollfunktion dient dem Entwickler-Team im Fehlerfall, die zuvor getätigten Aktionen nachvollziehen zu können, sollte der Fehler nicht explizit in den Protokolldateien notiert werden. Daher gibt es in DMXControl 3 unter « Hilfe (Help) »⇒ « Exportiere Protokolldateien (Export Logfiles) » die Funktion, um die gesamten Protokolldateien zu exportieren, um sie zum Beispiel einer Fehlerbeschreibung im Bugtracker beifügen zu können.

Abbildung 1: Exportfunktion für die Protokolldateien

Über diese Funktion wird automatisch ein Zip-Archiv erstellt, dass alle Protokolldateien zusammenfasst. Der Dateiname beinhaltet dabei das Datum und die Uhrzeit, wann der Export durchgeführt wurde.

DMXControl 3 speichert die Protokolldateien nur eine begrenzte Zeit. Es werden immer die letzten 10 Sitzungen pro Programmteil gesichert. Damit können die Protokolldateien bei einem Fehler auch ein bisschen später exportiert werden und nicht unbedingt beispielsweise während einer laufenden Veranstaltung.

Die Protokolldateien können vom Anwender auch selbst jederzeit mit einem beliebigen Textverarbeitungsprogramm wie zum Beispiel dem Editor oder Notepad++ eingesehen werden. Standardmäßig sind die Protokolldateien in folgenden Verzeichnissen abgelegt:

• Kernel: "C:\Users\[BENUTZERNAME]\AppData\Roaming\DMXControl Projects e.V\DMXControl\Kernel\Log\"
• Umbra: "C:\Users\[BENUTZERNAME]\AppData\Roaming\DMXControl Projects e.V\DMXControl\Umbra\Log\"
• GUI: "C:\Users\[BENUTZERNAME]\AppData\Roaming\DMXControl Projects e.V\DMXControl\GUI\Log\"
• Installer: Installationsverzeichnis von DMXControl 3, standardmäßig unter "C:\Program Files (x86)\DMXControl 3\"

Wurde im Rahmen einer benutzerspezifischen Systemkonfiguration für DMXControl 3 eine Umgebungsvariable eingerichtet, um das Arbeits- und Konfigurationsverzeichnis in ein eigenes Verzeichnis zu verschieben, ändern sich damit auch die Verzeichnisse, in dem die Protokolldateien abgelegt werden.