Device Manager DMXC3: Unterschied zwischen den Versionen

Aus Deutsches DMXC-Wiki
Zur Navigation springen Zur Suche springen
(Neue Abschnitte "Weitere DDFs" und "Fehlerhafte DDFs" eingefügt)
Zeile 20: Zeile 20:
  
 
= Wichtige Merkmale =
 
= Wichtige Merkmale =
 +
== Weitere DDFs hinzufügen ==
 +
{|
 +
| valign="top" rowspan="2" | DMXControl 3 liefert nur eine kleine Palette von DDFs mit, sodass auf Grund der riesigen Anzahl an verfügbaren Geräten häufig DDFs für die eigenen Geräte fehlen. Damit man selbst erstelle DDFs oder manuell aus der {{Manual_Windowcaption|{{DMXCWebLinks|DDFLib}}}} heruntergeladene in DMXControl 3 nutzen kann, legt man diese in das Verzeichnis ab, welches über die Verknüpfung Eigene DDFs im Startmenü aufgerufen wird (siehe Abbildung 2).
 +
 +
Dieses Verzeichnis ist aber auch über den Windows Explorer unter dem Pfad {{Manual_Filepath|C:\Users\'''{BENUTZERNAME}'''\AppData\Roaming\DMXControl Projects e.V\DMXControl\}}, wobei {{Manual_Filepath|'''{BENUTZERNAME}'''}} für Namen des aktuellen Benutzers des PCs steht. Als Kurzbebefehl kann man das Verzeichnis ebenfalls erreichen, wenn man in die Adressleiste des Windows Explorers den Pfad {{Manual_Filepath|%AppData%\Roaming\DMXControl Projects e.V\DMXControl\}} eingibt.
 +
 +
In dieses Verzeichnis speichert man dann die <code>xml</code>-Datei des DDFs. Eventuell müssen bei der ersten Verwendung noch die Verzeichnisse {{Manual_Filepath|Images}} für die Gerätebilder und  {{Manual_Filepath|Icons}} für die Icons der Gobos angelegt werden, wie in Abbildung 3 dargestellt. DDFs, welche man manuell aus der {{Manual_Windowcaption|{{DMXCWebLinks|DDFLib}}}} als <code>zip</code>-Archiv herunterlädt, müssen in diesem Verzeichnis entpackt und die Bilddateien für Gerät und Icons in die zugehörigen Ordner verteilt werden. Letzteres übernimmt DMXControl 3 automatisch, wenn man ein DDF über direkt über den Dialog {{Manual_Windowcaption|[[DDF_Library_DMXC3|DDF Library]]}} heraussucht.
 +
 +
Das Verzeichnis {{Manual_Filepath|UserDevices}} kann auch genutzt werden, um dort DDFs abzuspeichern, welche man aktuell gerade erstellt und deren Funktionalität prüfen möchte.
 +
 +
Egal ob Änderung an neu erstellten DDFs oder Hinzufügen weiterer: der Inhalt des Dialogs {{Manual_Windowcaption|Geräte hinzufügen}} wird mit jedem erneuten Öffnen aktualisiert. DMXControl 3 kann also die gesamte Zeit geöffnet bleiben.
 +
| style="width: 25px;" rowspan="2" |
 +
| style="width: 480px;" | {{Bild_mit_Unterschrift|DMXC3_Manual_Device_Manager_Device_folder.png|2|Verknüpfung im Startmenü zum Aufrufen des Ordners für die selbst erstellen DDFs.|center|480px}}
 +
|-
 +
| {{Bild_mit_Unterschrift|DMXC3_Manual_Device_Manager_Windows_Explorer_UserDevices.png|3|Eigene DDFs im Verzeichnis ''UserDevices''.|center|480px}}
 +
|}
 +
== DDF-Arten ==
 
Über den Dialog {{Manual_Windowcaption|Geräte hinzufügen}} besteht Zugriff auf drei Arten von DDFs, welche je nach Art in verschiedenen Verzeichnissen abgelegt sind und insbesondere beim Hinzufügen weiterer Geräte zu einem bestehenden Projekt mit unterschiedlichen Prioritäten behandelt werden.
 
Über den Dialog {{Manual_Windowcaption|Geräte hinzufügen}} besteht Zugriff auf drei Arten von DDFs, welche je nach Art in verschiedenen Verzeichnissen abgelegt sind und insbesondere beim Hinzufügen weiterer Geräte zu einem bestehenden Projekt mit unterschiedlichen Prioritäten behandelt werden.
  
Zeile 57: Zeile 74:
 
= Nutzung =
 
= Nutzung =
 
== Device Manager aufrufen ==
 
== Device Manager aufrufen ==
{{Bild_mit_Unterschrift|DMXC3_Manual_TheFirstFixtures_Open Device Manager.png|2|Öffnen des Device Managers.|right|250px}}
+
{{Bild_mit_Unterschrift|DMXC3_Manual_TheFirstFixtures_Open Device Manager.png|4|Öffnen des Device Managers.|right|250px}}
 
Zum Hinzufügen von Geräten der Dialog {{Manual_Windowcaption|Geräte hinzufügen}} geöffnet werden. Dies ist auf drei Wegen möglich:
 
Zum Hinzufügen von Geräten der Dialog {{Manual_Windowcaption|Geräte hinzufügen}} geöffnet werden. Dies ist auf drei Wegen möglich:
 
* über den Eintrag {{Manual_MenuText|Geräte hinzufügen (Add device)}} im Kontextmenü zum Ordner {{Manual_Objectcaption|Gerät}} im {{Manual_Windowcaption|[[Project_Explorer_DMXC3|Projektexplorer (Project Explorer)]]}} oder
 
* über den Eintrag {{Manual_MenuText|Geräte hinzufügen (Add device)}} im Kontextmenü zum Ordner {{Manual_Objectcaption|Gerät}} im {{Manual_Windowcaption|[[Project_Explorer_DMXC3|Projektexplorer (Project Explorer)]]}} oder
* mit Hilfe des Buttons {{Manual_Buttons|Gerät hinzufügen}} in der Menüleiste des {{Manual_Windowcaption|Projektexplorers}} oder
+
* mit Hilfe des Buttons {{Manual_Buttons|Gerät hinzufügen (Add device)}} in der Menüleiste des {{Manual_Windowcaption|Projektexplorers}} oder
 
* über das Kontextmenü in der {{Manual_Windowcaption|[[Stage_View_DMXC3|Bühnenansicht (Stage View)]]}}
 
* über das Kontextmenü in der {{Manual_Windowcaption|[[Stage_View_DMXC3|Bühnenansicht (Stage View)]]}}
  
Zeile 67: Zeile 84:
  
 
== Favoriten ==
 
== Favoriten ==
Der Ordner {{Manual_Objectcaption|Favoriten}} sammelt alle Geräte, die regelmäßig für neue Projekte genutzt werden. Welche Geräte dort aufgeführt werden, kann man selbst bestimmen. Man sucht ein bestimmtes Gerät in der Liste und wählt im Kontextmenü den Eintrag {{Manual_MenuText|Add to favorite}}. Bereits im Favoriten-Ordner vorhandene Geräte lassen sich über den Eintrag {{Manual_MenuText|Remove from favorites}} entfernen.
+
Der Ordner {{Manual_Objectcaption|Favoriten}} sammelt alle Geräte, die regelmäßig für neue Projekte genutzt werden. Welche Geräte dort aufgeführt werden, kann man selbst bestimmen. Man sucht ein bestimmtes Gerät in der Liste und wählt im Kontextmenü den Eintrag {{Manual_MenuText|Zu Favoriten hinzufügen (Add to favorite)}}. Bereits im Favoriten-Ordner vorhandene Geräte lassen sich über den Eintrag {{Manual_MenuText|Aus Favoriten entfernen (Remove from favorites)}} entfernen.
  
 
{| width=100%
 
{| width=100%
|{{Bild_mit_Unterschrift|DMXC3_Manual_Device_Manager_Add_to_favorites.png|3|Hinzufügen eines Geräts zu den persönlichen Favoriten|center}}
+
|{{Bild_mit_Unterschrift|DMXC3_Manual_Device_Manager_Add_to_favorites.png|5|Hinzufügen eines Geräts zu den persönlichen Favoriten|center}}
|{{Bild_mit_Unterschrift|DMXC3_Manual_Device_Manager_Remove_from_favorites.png|4|Entfernen eines Geräts aus den Favoriten|center}}
+
|{{Bild_mit_Unterschrift|DMXC3_Manual_Device_Manager_Remove_from_favorites.png|6|Entfernen eines Geräts aus den Favoriten|center}}
 
|-
 
|-
 
|}
 
|}
  
 
{{BoxHinweis|Text=Es ist zu beachten, dass die Favoritenliste lokal auf dem PC gespeichert wird und somit bei der Nutzung eines anderen PCs einen anderen Umfang hat.}}
 
{{BoxHinweis|Text=Es ist zu beachten, dass die Favoritenliste lokal auf dem PC gespeichert wird und somit bei der Nutzung eines anderen PCs einen anderen Umfang hat.}}
 +
 +
== Fehlerhafte DDFs ==
 +
Beim Hinzufügen von DDFs können zwei Arten von Fehlern auftreten:
 +
# In der Logik des DDFs ist ein Fehler. Die betroffene Stelle im XML-Code des DDFs wird in einem weiteren Fenster anzeigt, sobald man mit dem Klick auf {{Manual_Buttons|Hinzufügen}} das Gerät zum aktuellen Projekt hinzufügen möchte.
 +
# Im Verzeichnisbaum erscheint ein weiterer Eintrag {{Manual_Fields|Corrupted DDFs}}. Hier liegt ein schwerer Fehler im XML-Code vor, den man extern zum Beispiel mit Notepad++<ref>Notepad++ ist ein freier Text- und Quellcodeeditor. Weitere Informationen  auf der Herstellerseite: https://notepad-plus-plus.org/</ref> und dem dort verfügbaren Plugin XML-Tools<ref>Installtionsanleitung für das Plugin XML-Tools mit Hilfe des integrierten Plugin- dministartor von Notepad++: https://community.notepad-plus-plus.org/topic/16983/xml-tools/2</ref> prüfen muss.
 +
 +
= Links und Referenzen =
 +
<references/>
  
 
<!--[[en: The first fixtures_DMXC3]]-->
 
<!--[[en: The first fixtures_DMXC3]]-->
 
[[Kategorie: Handbuch DMXControl 3]]
 
[[Kategorie: Handbuch DMXControl 3]]

Version vom 12. Mai 2020, 19:46 Uhr

Books.png Device Manager DMXC3 Artikel beschreibt
DMXControl 3.2.0
Inhaltsverzeichnis

A

B

C

D

E

F

G

H

K

L

M

N

O

P

R

S


Mit Hilfe des Dialogs Geräte hinzufügen (Add Device) können einem Projekt so genannte Device Definition Files (kurz DDFs) hinzugefügt werden, damit die Hardware Abstraction Layer (HAL) in DMXControl 3 weiß, welche Geräte (Devices) auf welchen DMX-Kanälen adressiert sind und welche Funktionen sie bereitstellen. Ohne passende DDFs für die anzusteuernden Geräte kann DMXControl 3 nur sehr eingeschränkt arbeiten.

Abbildung 1:Ansicht des Dialogs Geräte hinzufügen.
Abbildung 1: Ansicht des Dialogs Geräte hinzufügen.

Überblick

Der Geräte hinzufügen Dialog wird immer dann benötigt, wenn bei einem neuen, leeren Projekt erstmals Geräte hinzugefügt oder bei einem bestehenden Projekt weitere Geräte in die Show mit aufgenommen werden sollen. Hier erfolgt direkt der erste Patch der benötigten Geräte auf die jeweiligen DMX-Adressen.

Durch die verschiedenen Icos vor einem DDF ist direkt ersichtlich, aus welcher Quelle das jeweilige DDF stammt. Darüber hinaus werden alle im aktuellen Projekt verwendeten DDFs in einem gemeinsamen Ordner zusammengefasst, sollte man weitere Geräte des gleichen Typs im gleichen DMX-Mode benötigen. Für häufig genutzte Geräte steht der Favoriten-Ordner zur Verfügung.


 Wichtiger Hinweis Änderungen der DMX-Adressen bei Geräten, die bereits im Projekt integriert sind, werden nicht im Dialogs Geräte hinzufügen, sondern entweder über die Eigenschaften (Properties) des jeweiligen Gerätes oder über den Patching-Dialog vorgenommen.


Wichtige Merkmale

Weitere DDFs hinzufügen

DMXControl 3 liefert nur eine kleine Palette von DDFs mit, sodass auf Grund der riesigen Anzahl an verfügbaren Geräten häufig DDFs für die eigenen Geräte fehlen. Damit man selbst erstelle DDFs oder manuell aus der DDFLibrary heruntergeladene in DMXControl 3 nutzen kann, legt man diese in das Verzeichnis ab, welches über die Verknüpfung Eigene DDFs im Startmenü aufgerufen wird (siehe Abbildung 2).

Dieses Verzeichnis ist aber auch über den Windows Explorer unter dem Pfad "C:\Users\{BENUTZERNAME}\AppData\Roaming\DMXControl Projects e.V\DMXControl\", wobei "{BENUTZERNAME}" für Namen des aktuellen Benutzers des PCs steht. Als Kurzbebefehl kann man das Verzeichnis ebenfalls erreichen, wenn man in die Adressleiste des Windows Explorers den Pfad "%AppData%\Roaming\DMXControl Projects e.V\DMXControl\" eingibt.

In dieses Verzeichnis speichert man dann die xml-Datei des DDFs. Eventuell müssen bei der ersten Verwendung noch die Verzeichnisse "Images" für die Gerätebilder und "Icons" für die Icons der Gobos angelegt werden, wie in Abbildung 3 dargestellt. DDFs, welche man manuell aus der DDFLibrary als zip-Archiv herunterlädt, müssen in diesem Verzeichnis entpackt und die Bilddateien für Gerät und Icons in die zugehörigen Ordner verteilt werden. Letzteres übernimmt DMXControl 3 automatisch, wenn man ein DDF über direkt über den Dialog DDF Library heraussucht.

Das Verzeichnis "UserDevices" kann auch genutzt werden, um dort DDFs abzuspeichern, welche man aktuell gerade erstellt und deren Funktionalität prüfen möchte.

Egal ob Änderung an neu erstellten DDFs oder Hinzufügen weiterer: der Inhalt des Dialogs Geräte hinzufügen wird mit jedem erneuten Öffnen aktualisiert. DMXControl 3 kann also die gesamte Zeit geöffnet bleiben.

Abbildung 2:Verknüpfung im Startmenü zum Aufrufen des Ordners für die selbst erstellen DDFs.
Abbildung 2: Verknüpfung im Startmenü zum Aufrufen des Ordners für die selbst erstellen DDFs.
Abbildung 3:Eigene DDFs im Verzeichnis UserDevices.
Abbildung 3: Eigene DDFs im Verzeichnis UserDevices.

DDF-Arten

Über den Dialog Geräte hinzufügen besteht Zugriff auf drei Arten von DDFs, welche je nach Art in verschiedenen Verzeichnissen abgelegt sind und insbesondere beim Hinzufügen weiterer Geräte zu einem bestehenden Projekt mit unterschiedlichen Prioritäten behandelt werden.

Kategorie Icon Beschreibung Speicherort Priorität
Projekt-DDF DMXC3 Icon V-Collection suitcase2.png Hierzu gehören alle DDFs, die für das korrekte Arbeiten des aktuellen Projekts benötigt werden "{PROJEKT-ZIP}\LibDevices"

"{PROJEKT-ZIP}\UserDevices"

Höchste Priorität im aktuellen Projekt,
bei neuen Projekten nicht vorhanden
User-DDFs DMXC3 Icon V-Collection pawn blue.png Eigene, vom Benutzer selbst erstelle DDFs "{APPDATA}\DMXControl Projects e.V\DMXControl\Kernel\UserDevices\" Mittlere Priorität im aktuellen Projekt,
bei neuen Projekten höchste Priorität
Lib-DDFs DMXC3 Icon V-Collection earth.png Vom Installer mitgelieferte Standard-DDFs "{PROGRAMMVERZEICHNIS}\Kernel\LibDevices\" Niedrigste Priorität im aktuellen Projekt,
bei neuen Projekten mittlere Priorität
Über die DDF Libary nachträglich heruntergeladene DDFs "{APPDATA}\DMXControl Projects e.V\DMXControl\Kernel\LibDevices\"


 Wichtige Referenz Welche Bedeutung die Verzeichnisse {PROGRAMMVERZEICHNIS}, {APPDATA} und {PROJEKT-ZIP} im Kontext von DMXControl 3 haben, ist in dem Artikel DDF-Einführung beschrieben.


Achtung wichtiger Hinweis Alle vom Installer ausgelieferten und im Verzeichnis "{PROGRAMMVERZEICHNIS}\Kernel\LibDevices\" abgelegten DDFs werden bei jedem Update oder bei jeder Neuinstallation vollständig überschrieben. Für eure eigenen DDFs nutzt bitte das Verzeichnis "UserDevices", welches ihr über die Verknüpfung « Eigene DDFs » im Startmenü von Windows erreicht.


Bedienelemente

Der Dialog Geräte hinzufügen ist zweigeteilt. Auf der linken Seite befindet sich eine Liste mit allen DDFs, gruppiert nach den Favoriten, Project-DDFs (bei einem bestehenden Projekt) und die insgesamt verfügbaren DDFs. Alle DDFs werden dabei nach den jeweiligen Herstellern und - sofern vorhanden - nach den verfügbaren DMX-Modi sortiert dargestellt. Wählt man ein DDF aus, so werden im unteren Bereich einige Geräteeigenschaften angezeigt. Im rechten Teil des Fensters erfolgt dann die Festlegung von Name, Anzahl und Startadresse für das neue Gerät.

Nutzung

Device Manager aufrufen

Abbildung 4:Öffnen des Device Managers.
Abbildung 4: Öffnen des Device Managers.

Zum Hinzufügen von Geräten der Dialog Geräte hinzufügen geöffnet werden. Dies ist auf drei Wegen möglich:

Geräte hinzufügen

Um nun ein oder mehrere Geräte hinzuzufügen, wählt man das richtige DDF aus oder sucht es mit Hilfe der Suchfunktion. Sobald das gewünschte Gerät gewählt ist, kann man im rechten Teil des Fensters die Anzahl eingeben und den Namen bei Bedarf anpassen. Im Bereich DMX-Einstellungen (DMX-Settings) wird die Startadresse (DMX start address) des ersten Gerät festgelegt und ob zwischen den einzelnen Geräten eine bestimmte Anzahl an DMX-Kanälen freigelassen werden sollen (DMX space). Der dritte Teil dient der Zuordnung zu einer Gerätegruppe (Device Group). Möchte man mehr als ein Gerät dem Projekt hinzufügen, wird diese Einstellung automatisch aktiv und DMXControl schlägt vor, eine neue Gerätegruppe zu erstellen. Diesen Namen kann man ebenfalls ändern oder man wählt über das Dropdown-Menü eine vorhandene Gerätegruppe aus, zu der die neuen Geräte hinzugefügt werden sollen. Bei einem Klick auf den [Hinzufügen (Add)] setzt DMXControl 3 die zuvor eingestellten Angaben um. Hiernach kann man direkt weitere Geräte hinzufügen. Sind alle Geräte ausgewählt, schließt man den Dialog mit dem Button [Schließen (Close)].

Favoriten

Der Ordner Favoriten sammelt alle Geräte, die regelmäßig für neue Projekte genutzt werden. Welche Geräte dort aufgeführt werden, kann man selbst bestimmen. Man sucht ein bestimmtes Gerät in der Liste und wählt im Kontextmenü den Eintrag « Zu Favoriten hinzufügen (Add to favorite) ». Bereits im Favoriten-Ordner vorhandene Geräte lassen sich über den Eintrag « Aus Favoriten entfernen (Remove from favorites) » entfernen.

Abbildung 5:Hinzufügen eines Geräts zu den persönlichen Favoriten
Abbildung 5: Hinzufügen eines Geräts zu den persönlichen Favoriten
Abbildung 6:Entfernen eines Geräts aus den Favoriten
Abbildung 6: Entfernen eines Geräts aus den Favoriten


 Wichtiger Hinweis Es ist zu beachten, dass die Favoritenliste lokal auf dem PC gespeichert wird und somit bei der Nutzung eines anderen PCs einen anderen Umfang hat.


Fehlerhafte DDFs

Beim Hinzufügen von DDFs können zwei Arten von Fehlern auftreten:

  1. In der Logik des DDFs ist ein Fehler. Die betroffene Stelle im XML-Code des DDFs wird in einem weiteren Fenster anzeigt, sobald man mit dem Klick auf [Hinzufügen] das Gerät zum aktuellen Projekt hinzufügen möchte.
  2. Im Verzeichnisbaum erscheint ein weiterer Eintrag "Corrupted DDFs". Hier liegt ein schwerer Fehler im XML-Code vor, den man extern zum Beispiel mit Notepad++[1] und dem dort verfügbaren Plugin XML-Tools[2] prüfen muss.

Links und Referenzen

  1. Notepad++ ist ein freier Text- und Quellcodeeditor. Weitere Informationen auf der Herstellerseite: https://notepad-plus-plus.org/
  2. Installtionsanleitung für das Plugin XML-Tools mit Hilfe des integrierten Plugin- dministartor von Notepad++: https://community.notepad-plus-plus.org/topic/16983/xml-tools/2