Device Manager DMXC3: Unterschied zwischen den Versionen

Aus Deutsches DMXC-Wiki
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(19 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Kapitelüberschrift|Version=DMXControl 3.0.0}}
{{Manual Header
{{DMXC3_Manual-Navigation_Hauptprogramm}}
| Type = DMXC3 Main-Software
| Version = 3.2.2}}




Mit Hilfe des {{Manual_Windowcaption|Add Device}} Dialogs fügt man einem Projekt so genannte [Glossar_DMXC2#DDF|Device Definition Files]] (kurz DDFs) hinzu, damit die {{Manual_Windowcaption|[[Hardware_Abstraction_Layer_(HAL)_DMXC3|HAL]]}} in DMXControl 3 weiß, welche Geräte 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.
Mit Hilfe des Dialogs {{Manual Windowcaption|Geräte hinzufügen (Add Device)}} können einem Projekt so genannte [[Glossar_DMXC2#DDF|Device Definition Files]] (kurz DDFs) hinzugefügt werden, damit die {{Manual Windowcaption|[[Hardware_Abstraction_Layer_(HAL)_DMXC3|Hardware Abstraction Layer (HAL)]]}} in DMXControl 3 weiß, welche {{Manual Windowcaption|[[Device_DMXC3|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.
 
{|
| style="min-width: 200px; line-height: 1.2em;" valign="top" | __INHALTSVERZEICHNIS__
| style="width: 25px;" |
| valign="top" | {{Bild_mit_Unterschrift|DMXC3_Manual Device_Manager_Add_device.png|1|Ansicht des Dialogs Geräte hinzufügen.|left|600px}}
|-
|}


= Überblick =
= Überblick =
Der {{Manual_Windowcaption|Add Device}} Dialogswird immer dann benötigt, wenn bei einem neuen, leeren Projekt erstmals Devices (Geräte) hinzugefügt oder bei einem bestehenden Projekt weitere Devices in die Show mit aufgenommen werden sollen. Hier erfolgt direkt der Patch der benötigten Geräte auf die jeweiligen DMX-Adressen.
Der {{Manual Windowcaption|Geräte hinzufügen}} Dialog wird immer dann benötigt, wenn bei einem neuen, leeren Projekt erstmals {{Manual Windowcaption|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.
 
{{Manual Box | de | Hint | Änderungen der DMX-Adressen bei Geräten, die bereits im Projekt integriert sind, werden nicht im Dialogs {{Manual Windowcaption|Geräte hinzufügen}}, sondern entweder über die Eigenschaften (Properties) des jeweiligen Gerätes oder über den {{Manual Windowcaption|[[Patching_DMXC3|Patching]]}}-Dialog vorgenommen.}}


= Wichtige Merkmale =
= Wichtige Merkmale =
Über den Add Device Doalog 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.
== 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.


{| class="wikitable toptextcells"
{| class="wikitable toptextcells"
Zeile 16: Zeile 45:
|-
|-
! style="width: 10em"| Projekt-DDF
! style="width: 10em"| Projekt-DDF
| style="width: 5em; text-align: center" | [[Datei:Icon_Project-DDF.png]]
| style="width: 5em; text-align: center" | [[Datei:DMXC3_Icon_V-Collection_suitcase2.png]]
| style="width: 20em" | Hierzu gehören alle DDFs, die für das korrekte Arbeiten des aktuellen Projekts benötigt werden
| style="width: 20em" | Hierzu gehören alle DDFs, die für das korrekte Arbeiten des aktuellen Projekts benötigt werden
| style="width: 35em" | {{Manual_Filepath|[PROJEKT-ZIP]\LibDevices}}
| style="width: 35em" | {{Manual Filepath|'''{PROJEKT-ZIP}'''\LibDevices}}
{{Manual_Filepath|[PROJEKT-ZIP]\UserDevices}}
{{Manual Filepath|'''{PROJEKT-ZIP}'''\UserDevices}}
| style="width: 20em" | Höchste Priorität im aktuellen Projekt,
| style="width: 20em" | Höchste Priorität im aktuellen Projekt,<br /> bei neuen Projekten nicht vorhanden
bei neuen Projekten nicht vorhanden
|-
|-
! User-DDFs
! User-DDFs
| style="text-align: center" | [[Datei:Icon_User-DDF.png]]
| style="text-align: center" | [[Datei:DMXC3_Icon_V-Collection_pawn_blue.png]]
| Eigene, vom Benutzer selbst erstelle DDFs
| Eigene, vom Benutzer selbst erstelle DDFs
| {{Manual_Filepath|[APPDATA]\DMXControl Projects e.V\DMXControl\Kernel\UserDevices\}}
| {{Manual Filepath|'''{APPDATA}'''\DMXControl Projects e.V\DMXControl\Kernel\UserDevices\}}
| Mittlere Priorität im aktuellen Projekt,
| Mittlere Priorität im aktuellen Projekt,<br /> bei neuen Projekten höchste Priorität
bei neuen Projekten höchste Priorität
|-
|-
! rowspan="2" | Lib-DDFs
! rowspan="2" | Lib-DDFs
| rowspan="2" style="text-align: center" | [[Datei:Icon_Lib-DDF.png]]
| rowspan="2" style="text-align: center" | [[Datei:DMXC3_Icon_V-Collection_earth.png]]
| Vom Installer mitgelieferte Standard-DDFs
| Vom Installer mitgelieferte Standard-DDFs
| {{Manual_Filepath|[PROGRAMMVERZEICHNIS]\Kernel\LibDevices\}}
| {{Manual Filepath|'''{PROGRAMMVERZEICHNIS}'''\Kernel\LibDevices\}}
| rowspan="2" |Niedrigste Priorität im aktuellen Projekt,
| rowspan="2" | Niedrigste Priorität im aktuellen Projekt,<br /> bei neuen Projekten mittlere Priorität
bei neuen Projekten mittlere Priorität
|-
|-
| Über die DDF Libary nachträglich heruntergeladene DDFs
| Über die DDF Libary nachträglich heruntergeladene DDFs
| {{Manual_Filepath|[APPDATA]\DMXControl Projects e.V\DMXControl\Kernel\LibDevices\}}
| {{Manual Filepath|'''{APPDATA}'''\DMXControl Projects e.V\DMXControl\Kernel\LibDevices\}}
|}
|}


{{BoxAchtung|Text=Alle vom Installer ausgelieferten und im Verzeichnis {{Manual_Filepath|[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 {{Manual_Filepath|UserDevices}}, welches ihr über die Verknüpfung {{Manual_MenuText|Eigene DDFs}} im Startmenü von Windows erreicht. }}
{{Manual Box | de | Reference | Welche Bedeutung die Verzeichnisse '''{PROGRAMMVERZEICHNIS}''', '''{APPDATA}''' und '''{PROJEKT-ZIP}''' im Kontext von DMXControl 3 haben, ist in dem Artikel [[Einführung (DDF-Syntax) DMXC3|DDF-Einführung]] beschrieben.}}
 
{{Manual Box | de | Attention | Alle vom Installer ausgelieferten und im Verzeichnis {{Manual Filepath|'''{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 {{Manual Filepath|UserDevices}}, welches ihr über die Verknüpfung {{Manual MenuText|Eigene DDFs}} im Startmenü von Windows erreicht.}}
 
= Bedienelemente =
Der Dialog {{Manual Windowcaption|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.
 
== Umfang und Strukturierung der Liste ==
In DMXControl 3 werden drei Bereiche von DDFs unterschieden:
# DDFs für ein bestimmtes Gerät von einem bestimmten Hersteller mit einem bestimmten DDF-Modus
# DDFs für ein bestimmtes Gerät, welches sich aber keinem bestimmten Hersteller zuordnen lässt
# Generische, allgemeine DDFs ohne Bezug zu einem Gerät oder Hersteller
 
=== Gerätespezifische DDFs ===
DDFs, welche für ein bestimmtes Gerät mit einem bestimmten DMX-Modus eines bestimmten Herstellers erstellt wurden, sind in der Liste anhand dieser Kriterien einsortiert und auch exakt unter diesen Suchbegriffen zu finden. In der Regel beinhaltet das jeweilige DDF dabei alle Funktionen des Geräts, welche sich zum Zeitpunkt der Erstellung sinnvoll mit DMXControl 3 ansteuern ließen.
 
=== DDFs ohne spezifischen Hersteller ===
Am Markt sind zahlreiche Geräte verfügbar, bei denen der Hersteller nicht eindeutig zu bestimmen ist. Damit die Liste der verfügbaren DDFs dennoch strukturiert bleibt, werden diese DDFs in einem gemeinsamen Ordner gesammelt.
 
{{Manual Box | de | Hint | DDFs für Geräte, deren Hersteller sich nicht exakt bestimmen lässt, sind in der Liste unter dem Ordner {{Manual Objectcaption|Various}} zu finden.}}
 
 
=== Allgemeine DDFs ===
DMXControl 3 bringt auch eine Reihe von allgemeinen / generischen DDFs mit, welche nicht spezifisch für ein bestimmtes Gerät erstellt wurden. Dazu zählen:
* Einfache Dimmer
* Schalter (Switches)
* DDFs für LEDs in verschiedenen Ausführungen wie RGB, RGBW sowie mit oder ohne Dimmer, Strobe-Kanal etc.
Typische Anwendungsbeispiele sind Dimmerpacks oder LED-Stripes. Für jeden steuerbaren Ausgang fügt man das passende DDF einmal dem Projekt hinzu, also
* 4 Mal den einfachen Dimmer (zum Beispiel in der 8-Bit-Aufllösung) bei einem 4-Kanal-Dimmerpack
* 170 Mal das RGB-DDF für einen LED-Stripe, wo sich die 170 Pixel einzeln ansteuern lassen
 
{{Manual Box | de | Hint | Alle verfügbaren allgemeinen / generischen DDFs sind in der Liste unter dem Ordner {{Manual Objectcaption|Generic}} zu finden.}}


= Nutzung =
= Nutzung =
== Device Manager aufrufen ==
{{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:
* ü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 (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)]]}}
== Geräte hinzufügen ==
== Geräte hinzufügen ==
{{Bild_mit_Unterschrift|DMXC3_Manual_TheFirstFixtures_Open Device Manager.png|2.2.1|Öffnen des Device Managers |right|250px}}
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 {{Manual Windowcaption|[[Device_Group_DMXC3|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 {{Manual Buttons|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 {{Manual Buttons|Schließen (Close)}}.
Zum Hinzufügen von Geräten musst Du erst einmal den {{Manual_Windowcaption|Device Manager}} öffnen. Dazu gehst du im {{Manual_Windowcaption|Project Explorer}} auf den Menüpunkt {{Manual_Windowcaption|Device Manager}} (siehe Abbildung 2.2.1).
 
== 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|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%
|{{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|6|Entfernen eines Geräts aus den Favoriten|center}}
|-
|}


{{Bild_mit_Unterschrift|DMXC3_Manual_TheFirstFixtures_Device Manager.png|2.2.2|Ansicht des Device Managers|center|600px}}
{{Manual Box | de | Hint | 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.}}
Das sich nun öffnende Fenster ist dreigeteilt (siehe Abbildung 2.2.2). Auf der linken Seite befindet sich eine Liste mit allen DDFs, die DMXControl 3 im Devices-Ordner des Kernelverzeichnisses erkannt hat. Alle DDFs werden nach den jeweiligen Herstellern sortiert dargestellt. Wird ein DDF ausgewählt, so werden im unteren Bereich einige Geräteeigenschaften angezeigt.


Um nun ein oder mehrere Geräte hinzuzufügen, wählst Du das richtige DDF aus und klickst auf den Button in der Fenstermitte. Wir wollen zu Beginn erst einmal vier Dimmer hinzufügen. Suche dazu in der Liste nach der Gruppe {{Manual_Fields|Generic}} und klappe diese auf. Wähle dann {{Manual_Fields|Generic Dimmer}} aus und klicke auf den mittleren Button mit dem Pfeil nach rechts.
== Fehlerhafte DDFs ==
{{Bild_mit_Unterschrift|DMXC3_Manual_TheFirstFixtures_Add new device.png|2.2.3|Hinzufügen von Generic Dimmern |center|300px}}
Beim Hinzufügen von DDFs können zwei Arten von Fehlern auftreten:
Dadurch öffnet sich ein weiteres Fenster. Hierin stellst du oben die Anzahl auf {{Manual_Fields|4}}. Durch diese Auswahl aktiviert sich automatisch {{Manual_Buttons|Autogenerate Group}}. Das ist gut so, denn das benötigen wir später. Lass also die Gruppen-Einstellungen so, wie sie sind. Auch die {{Manual_Fields|DMX Start Address}} lässt Du bei {{Manual_Fields|1}} und den {{Manual_Fields|DMX Space}} bei {{Manual_Fields|0}}. Nun klickst Du auf {{Manual_Buttons|OK}} um die Einstellungen zu bestätigen und das Fenster zu schließen. Nun tauchen, wie in Abbildung 2.2.4 gezeigt, die vier Generic Dimmer im {{Manual_Windowcaption|Device Manager}} auf der rechten Seite auf. Mit einem Klick auf {{Manual_Buttons|OK}} bestätigst Du diese Gerätekonfiguration und fügst die Geräte in das Projekt ein.
# 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.
{{Bild_mit_Unterschrift|DMXC3_Manual_TheFirstFixtures_Dimmer in Device Manager.png|2.2.4|Device Manager mit vier Dimmern |center|600px}}
# 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> Installationsanleitung für das Plugin XML-Tools mit Hilfe des integrierten Pluginadministrator von Notepad++: https://community.notepad-plus-plus.org/topic/16983/xml-tools/2</ref> prüfen muss.
Sie tauchen nun im {{Manual_Windowcaption|Project Explorer}} unter {{Manual_Windowcaption|Devices}} auf. In diesem Bereich werden generell alle im Projekt enthaltenen Geräte angezeigt.


== Dimmer aktivieren ==
= Links und Referenzen =
{{Bild_mit_Unterschrift|DMXC3_Manual_TheFirstFixtures_Fixtures in Project Explorer.png|2.2.5|Die vier Dimmer im Project Explorer und im Stage View|center|700px}}
== Links ==
Außerdem werden diese Geräte wie auch die erstellte Geräte-Gruppe dem {{Manual_Windowcaption|Stage View}} hinzugefügt. Wenn wir hier jetzt die Geräte-Gruppe anklicken und dann im {{Manual_Windowcaption|Intensity}}-Panel auf {{Manual_Buttons|Lumos}} klicken, beginnen alle vier Dimmer der Geräte-Gruppe zu leuchten. Herzlichen Glückwunsch, du hast gerade deine ersten Lampen mit DMXControl 3 gesteuert (allerdings vorerst noch virtuell).
<references/>
{{Bild_mit_Unterschrift|DMXC3_Manual_TheFirstFixtures_Activate Fixtures.png|2.2.6|Die vier Dimmer leuchten|center|400px}}


== Videotutorials ==
Auf unserem {{DMXCWebLinks|YouTube}} findet ihr zu diesem Thema folgende Videos.
{|
{{DMXC3 Manual-Tableentry Videolink | tG0TkBxdoRg | Geräteverwaltung und Patching}}
|}


[[en: The first fixtures_DMXC3]]
<!--[[en: The first fixtures_DMXC3]]-->
<noinclude>
[[Kategorie: Handbuch DMXControl 3]]
[[Kategorie: GUI en DMXC3]]
</noinclude>

Aktuelle Version vom 10. November 2024, 17:31 Uhr

Books.png Artikel beschreibt
DMXControl 3.2.2
Device Manager DMXC3
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.

Umfang und Strukturierung der Liste

In DMXControl 3 werden drei Bereiche von DDFs unterschieden:

  1. DDFs für ein bestimmtes Gerät von einem bestimmten Hersteller mit einem bestimmten DDF-Modus
  2. DDFs für ein bestimmtes Gerät, welches sich aber keinem bestimmten Hersteller zuordnen lässt
  3. Generische, allgemeine DDFs ohne Bezug zu einem Gerät oder Hersteller

Gerätespezifische DDFs

DDFs, welche für ein bestimmtes Gerät mit einem bestimmten DMX-Modus eines bestimmten Herstellers erstellt wurden, sind in der Liste anhand dieser Kriterien einsortiert und auch exakt unter diesen Suchbegriffen zu finden. In der Regel beinhaltet das jeweilige DDF dabei alle Funktionen des Geräts, welche sich zum Zeitpunkt der Erstellung sinnvoll mit DMXControl 3 ansteuern ließen.

DDFs ohne spezifischen Hersteller

Am Markt sind zahlreiche Geräte verfügbar, bei denen der Hersteller nicht eindeutig zu bestimmen ist. Damit die Liste der verfügbaren DDFs dennoch strukturiert bleibt, werden diese DDFs in einem gemeinsamen Ordner gesammelt.


Wichtiger Hinweis DDFs für Geräte, deren Hersteller sich nicht exakt bestimmen lässt, sind in der Liste unter dem Ordner Various zu finden.


Allgemeine DDFs

DMXControl 3 bringt auch eine Reihe von allgemeinen / generischen DDFs mit, welche nicht spezifisch für ein bestimmtes Gerät erstellt wurden. Dazu zählen:

  • Einfache Dimmer
  • Schalter (Switches)
  • DDFs für LEDs in verschiedenen Ausführungen wie RGB, RGBW sowie mit oder ohne Dimmer, Strobe-Kanal etc.

Typische Anwendungsbeispiele sind Dimmerpacks oder LED-Stripes. Für jeden steuerbaren Ausgang fügt man das passende DDF einmal dem Projekt hinzu, also

  • 4 Mal den einfachen Dimmer (zum Beispiel in der 8-Bit-Aufllösung) bei einem 4-Kanal-Dimmerpack
  • 170 Mal das RGB-DDF für einen LED-Stripe, wo sich die 170 Pixel einzeln ansteuern lassen


Wichtiger Hinweis Alle verfügbaren allgemeinen / generischen DDFs sind in der Liste unter dem Ordner Generic zu finden.

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

Links

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

Videotutorials

Auf unserem YouTube-Kanal findet ihr zu diesem Thema folgende Videos.

Geräteverwaltung und Patching