Device Manager DMXC3 - Revision history

Jkuehn at 13:35, 2 March 2025

2025-03-02T13:35:28Z

← Older revision		Revision as of 15:35, 2 March 2025
Line 137:		Line 137:
	<!--[[en: The first fixtures_DMXC3]]-->		<!--[[en: The first fixtures_DMXC3]]-->
	<noinclude>		<noinclude>
	[[Category: Manual DMXControl 3]]		[[Category: Manual DMXControl 3]]
	~~[[Category: GUI en DMXC3]]~~
	</noinclude>		</noinclude>

	[[de: Device_Manager_DMXC3]]		[[de: Device_Manager_DMXC3]]

Jkuehn at 16:12, 1 March 2025

2025-03-01T16:12:04Z

← Older revision		Revision as of 18:12, 1 March 2025
Line 6:		Line 6:

	{\|		{\|
	\| style="min-width: 200px; line-height: 1.2em;" valign="top" \| ~~__TABLE OF CONTENTS__~~		\| style="min-width: 200px; line-height: 1.2em;" valign="top" \|__TOC__
	\| style="width: 25px;" \|		\| style="width: 25px;" \|
	\| valign="top" \| {{Picture_with_subtitle\|DMXC3_Manual Device_Manager_Add_device.png\|1\|View of the "Add Device" dialog.\|left\|600px}}		\| valign="top" \| {{Picture_with_subtitle\|DMXC3_Manual Device_Manager_Add_device.png\|1\|View of the "Add Device" dialog.\|left\|600px}}
Line 109:		Line 109:
	To add one or more devices, select the correct DDF or search for it using the search function. Once the desired device is selected, you can enter the quantity and adjust the name if needed. In the DMX settings area, define the start address (DMX start address) for the first device and whether a certain number of DMX channels should be left between devices (DMX space). The third part assigns the devices to a {{Manual Windowcaption\|[[Device_Group_DMXC3\|Device Group]]}}. If you want to add more than one device, this setting becomes active, and DMXControl suggests creating a new device group. You can change this name or select an existing device group from the dropdown to which the new devices should be added. By clicking the {{Manual Buttons\|Add}} button, DMXControl 3 applies the previously set information. Afterward, you can directly add more devices. Once all devices are selected, click on the {{Manual Buttons\|Close}} button.		To add one or more devices, select the correct DDF or search for it using the search function. Once the desired device is selected, you can enter the quantity and adjust the name if needed. In the DMX settings area, define the start address (DMX start address) for the first device and whether a certain number of DMX channels should be left between devices (DMX space). The third part assigns the devices to a {{Manual Windowcaption\|[[Device_Group_DMXC3\|Device Group]]}}. If you want to add more than one device, this setting becomes active, and DMXControl suggests creating a new device group. You can change this name or select an existing device group from the dropdown to which the new devices should be added. By clicking the {{Manual Buttons\|Add}} button, DMXControl 3 applies the previously set information. Afterward, you can directly add more devices. Once all devices are selected, click on the {{Manual Buttons\|Close}} button.

	== ~~Favoriten~~ ==		== Favorites ==
	~~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~~.		The folder {{Manual Objectcaption\|Favorites}} collects all devices that are regularly used for new projects. You can decide which devices are listed there. To add a specific device, search for it in the list and select {{Manual MenuText\|Add to favorites}} from the context menu. Devices that are already in the Favorites folder can be removed by selecting {{Manual MenuText\|Remove from favorites}} in the context menu.

	{\|		{\|
	\|{{Picture_with_subtitle\|DMXC3_Manual Device_Manager_Add_to_favorites.png\|5\|~~Hinzufügen eines Geräts zu den persönlichen Favoriten~~\|center}}		\|{{Picture_with_subtitle\|DMXC3_Manual Device_Manager_Add_to_favorites.png\|5\|Adding a device to personal favorites\|center}}
	\|{{Picture_with_subtitle\|DMXC3_Manual Device_Manager_Remove_from_favorites.png\|6\|~~Entfernen eines Geräts aus den Favoriten~~\|center}}		\|{{Picture_with_subtitle\|DMXC3_Manual Device_Manager_Remove_from_favorites.png\|6\|Removing a device from favorites\|center}}
	\|-		\|-
	\|}		\|}

	{{Manual Box \| en \| ~~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~~.}}		{{Manual Box \| en \| Hint \| It should be noted that the favorites list is stored locally on the PC, meaning it will vary when using a different PC.}}

	== ~~Fehlerhafte~~ DDFs ==		== Faulty DDFs ==
	~~Beim Hinzufügen von~~ DDFs ~~können zwei Arten von Fehlern auftreten~~:		Two types of errors may occur when adding DDFs:
	# ~~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~~.		# There is an error in the logic of the DDF. The affected part of the XML code in the DDF will be displayed in a separate window as soon as you click on {{Manual Buttons\|Add}} to add the device to the current project.
	# ~~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~~.		# A new entry titled {{Manual Fields\|Corrupted DDFs}} appears in the directory tree. Here, there is a serious error in the XML code, which needs to be checked externally, for example, with Notepad++<ref>Notepad++ is a free text and source code editor. For more information, visit the official website: https://notepad-plus-plus.org/</ref> and the XML-Tools plugin<ref> Installation guide for the XML-Tools plugin using the integrated plugin manager in Notepad++: https://community.notepad-plus-plus.org/topic/16983/xml-tools/2</ref>.

	= Links ~~und Referenzen~~ =		= Links and References =
	== Links ==		== Links ==
	<references/>		<references/>

	== ~~Videotutorials~~ ==		== Video Tutorials ==
	~~Auf unserem~~ {{DMXCWebLinks\|YouTube}} ~~findet ihr zu diesem Thema folgende Videos~~.		On our {{DMXCWebLinks\|YouTube}}, you can find the following videos on this topic.
	{\|		{\|
	{{DMXC3 Manual-Tableentry Videolink \| tG0TkBxdoRg \| ~~Geräteverwaltung und~~ Patching}}		{{DMXC3 Manual-Tableentry Videolink \| tG0TkBxdoRg \| Device Management and Patching}}
	\|}		\|}

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

	[[de: Device_Manager_DMXC3]]		[[de: Device_Manager_DMXC3]]

Jkuehn at 16:05, 1 March 2025

2025-03-01T16:05:00Z

← Older revision		Revision as of 18:05, 1 March 2025
Line 113:		Line 113:

	{\|		{\|
	\|{{~~Bild_mit_Unterschrift~~\|DMXC3_Manual Device_Manager_Add_to_favorites.png\|5\|Hinzufügen eines Geräts zu den persönlichen Favoriten\|center}}		\|{{Picture_with_subtitle\|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}}		\|{{Picture_with_subtitle\|DMXC3_Manual Device_Manager_Remove_from_favorites.png\|6\|Entfernen eines Geräts aus den Favoriten\|center}}
	\|-		\|-
	\|}		\|}

Jkuehn at 16:03, 1 March 2025

2025-03-01T16:03:53Z

← Older revision		Revision as of 18:03, 1 March 2025
Line 32:		Line 32:
	Whether modifying newly created DDFs or adding additional ones: the contents of the {{Manual Windowcaption\|Add Device}} dialog are updated with each reopening. Therefore, DMXControl 3 can remain open during this process.		Whether modifying newly created DDFs or adding additional ones: the contents of the {{Manual Windowcaption\|Add Device}} dialog are updated with each reopening. Therefore, DMXControl 3 can remain open during this process.
	\| style="width: 25px;" rowspan="2" \|		\| style="width: 25px;" rowspan="2" \|
	\| style="width: 480px;" \| {{~~Image_with_Caption~~\|DMXC3_Manual Device_Manager_Device_folder.png\|2\|Shortcut in the Start menu to access the folder for user-created DDFs.\|center\|480px}}		\| style="width: 480px;" \| {{Picture_with_subtitle\|DMXC3_Manual Device_Manager_Device_folder.png\|2\|Shortcut in the Start menu to access the folder for user-created DDFs.\|center\|480px}}
	\|-		\|-
	\| {{~~Image_with_Caption~~\|DMXC3_Manual Device_Manager_Windows_Explorer_UserDevices.png\|3\|User DDFs in the "UserDevices" directory.\|center\|480px}}		\| {{Picture_with_subtitle\|DMXC3_Manual Device_Manager_Windows_Explorer_UserDevices.png\|3\|User DDFs in the "UserDevices" directory.\|center\|480px}}
	\|}		\|}
	== Types of DDFs ==		== Types of DDFs ==
Line 100:		Line 100:
	= Usage =		= Usage =
	== Open Device Manager ==		== Open Device Manager ==
	{{~~Image_with_Caption~~\|DMXC3_Manual TheFirstFixtures_Open Device Manager.png\|4\|Opening the Device Manager.\|right\|250px}}		{{Picture_with_subtitle\|DMXC3_Manual TheFirstFixtures_Open Device Manager.png\|4\|Opening the Device Manager.\|right\|250px}}
	To add devices, open the {{Manual Windowcaption\|Add Device}} dialog. This can be done in three ways:		To add devices, open the {{Manual Windowcaption\|Add Device}} dialog. This can be done in three ways:
	* via the menu entry {{Manual MenuText\|Add Device}} in the context menu of the {{Manual Objectcaption\|Device}} folder in the {{Manual Windowcaption\|[[Project_Explorer_DMXC3\|Project Explorer]]}}, or		* via the menu entry {{Manual MenuText\|Add Device}} in the context menu of the {{Manual Objectcaption\|Device}} folder in the {{Manual Windowcaption\|[[Project_Explorer_DMXC3\|Project Explorer]]}}, or

Jkuehn at 16:03, 1 March 2025

2025-03-01T16:03:22Z

← Older revision		Revision as of 18:03, 1 March 2025
Line 8:		Line 8:
	\| style="min-width: 200px; line-height: 1.2em;" valign="top" \| __TABLE OF CONTENTS__		\| style="min-width: 200px; line-height: 1.2em;" valign="top" \| __TABLE OF CONTENTS__
	\| style="width: 25px;" \|		\| style="width: 25px;" \|
	\| valign="top" \| {{~~Image_with_Caption~~\|DMXC3_Manual Device_Manager_Add_device.png\|1\|View of the "Add Device" dialog.\|left\|600px}}		\| valign="top" \| {{Picture_with_subtitle\|DMXC3_Manual Device_Manager_Add_device.png\|1\|View of the "Add Device" dialog.\|left\|600px}}
	\|-		\|-
	\|}		\|}
Line 17:		Line 17:
	The different icons before a DDF clearly show where the respective DDF comes from. Furthermore, all DDFs used in the current project are grouped into a common folder, should you need additional devices of the same type in the same DMX mode. For frequently used devices, the Favorites folder is available.		The different icons before a DDF clearly show where the respective DDF comes from. Furthermore, all DDFs used in the current project are grouped into a common folder, should you need additional devices of the same type in the same DMX mode. For frequently used devices, the Favorites folder is available.

	{{Manual Box \| de \| Hint \| Changes to DMX addresses for devices that are already integrated into the project should not be made in the {{Manual Windowcaption\|Add Device}} dialog but rather through the properties of the respective device or via the {{Manual Windowcaption\|[[Patching_DMXC3\|Patching]]}} dialog.}}		{{Manual Box \| en \| Hint \| Changes to DMX addresses for devices that are already integrated into the project should not be made in the {{Manual Windowcaption\|Add Device}} dialog but rather through the properties of the respective device or via the {{Manual Windowcaption\|[[Patching_DMXC3\|Patching]]}} dialog.}}

	= Important Features =		= Important Features =
Line 66:		Line 66:
	\|}		\|}

	{{Manual Box \| de \| Reference \| The meaning of the directories '''{PROGRAM_DIRECTORY}''', '''{APPDATA}''' and '''{PROJECT-ZIP}''' in the context of DMXControl 3 is described in the article [[Introduction (DDF Syntax) DMXC3\|DDF Introduction]].}}		{{Manual Box \| en \| Reference \| The meaning of the directories '''{PROGRAM_DIRECTORY}''', '''{APPDATA}''' and '''{PROJECT-ZIP}''' in the context of DMXControl 3 is described in the article [[Introduction (DDF Syntax) DMXC3\|DDF Introduction]].}}

	{{Manual Box \| de \| Attention \| All DDFs delivered by the installer and placed in the directory {{Manual Filepath\|'''{PROGRAM_DIRECTORY}'''\Kernel\LibDevices\}} are completely overwritten with each update or reinstallation. Please use the {{Manual Filepath\|UserDevices}} directory for your own DDFs, which can be accessed via the "Own DDFs" link in the Start menu of Windows.}}		{{Manual Box \| en \| Attention \| All DDFs delivered by the installer and placed in the directory {{Manual Filepath\|'''{PROGRAM_DIRECTORY}'''\Kernel\LibDevices\}} are completely overwritten with each update or reinstallation. Please use the {{Manual Filepath\|UserDevices}} directory for your own DDFs, which can be accessed via the "Own DDFs" link in the Start menu of Windows.}}

	= Controls =		= Controls =
Line 85:		Line 85:
	Many devices on the market have an unclear or no defined manufacturer. To keep the list of available DDFs structured, these DDFs are collected in a common folder.		Many devices on the market have an unclear or no defined manufacturer. To keep the list of available DDFs structured, these DDFs are collected in a common folder.

	{{Manual Box \| de \| Hint \| DDFs for devices without a clearly identifiable manufacturer can be found in the list under the folder {{Manual Objectcaption\|Various}}.}}		{{Manual Box \| en \| Hint \| DDFs for devices without a clearly identifiable manufacturer can be found in the list under the folder {{Manual Objectcaption\|Various}}.}}

	=== General DDFs ===		=== General DDFs ===
Line 96:		Line 96:
	* 170 times the RGB DDF for an LED strip, where the 170 pixels can be individually controlled		* 170 times the RGB DDF for an LED strip, where the 170 pixels can be individually controlled

	{{Manual Box \| de \| Hint \| All available general/generic DDFs can be found in the list under the folder {{Manual Objectcaption\|Generic}}.}}		{{Manual Box \| en \| Hint \| All available general/generic DDFs can be found in the list under the folder {{Manual Objectcaption\|Generic}}.}}

	= Usage =		= Usage =
Line 118:		Line 118:
	\|}		\|}

	{{Manual Box \| de \| 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.}}		{{Manual Box \| en \| 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 ==		== Fehlerhafte DDFs ==

Jkuehn: Created page with "{{Manual Header | Type = DMXC3 Main-Software | Version = 3.2.2}} With the help of the dialog {{Manual Windowcaption|Add Device}}, so-called Device Definition Files (DDFs) can be added to a project, allowing the {{Manual Windowcaption|Hardware Abstraction Layer (HAL)}} in DMXControl 3 to know which {{Manual Windowcaption|Devices}} are addressed on which DMX channels and which functions the..."

2025-03-01T16:00:47Z

Created page with "{{Manual Header | Type = DMXC3 Main-Software | Version = 3.2.2}} With the help of the dialog {{Manual Windowcaption|Add Device}}, so-called Device Definition Files (DDFs) can be added to a project, allowing the {{Manual Windowcaption|Hardware Abstraction Layer (HAL)}} in DMXControl 3 to know which {{Manual Windowcaption|Devices}} are addressed on which DMX channels and which functions the..."

New page

{{Manual Header
| Type = DMXC3 Main-Software
| Version = 3.2.2}}

With the help of the dialog {{Manual Windowcaption|Add Device}}, so-called [[Glossary_DMXC2#DDF|Device Definition Files]] (DDFs) can be added to a project, allowing the {{Manual Windowcaption|[[Hardware_Abstraction_Layer_(HAL)_DMXC3|Hardware Abstraction Layer (HAL)]]}} in DMXControl 3 to know which {{Manual Windowcaption|[[Device_DMXC3|Devices]]}} are addressed on which DMX channels and which functions they provide. Without the appropriate DDFs for the devices to be controlled, DMXControl 3 can only operate with limited functionality.

{|
| style="min-width: 200px; line-height: 1.2em;" valign="top" | __TABLE OF CONTENTS__
| style="width: 25px;" |
| valign="top" | {{Image_with_Caption|DMXC3_Manual Device_Manager_Add_device.png|1|View of the "Add Device" dialog.|left|600px}}
|-
|}

= Overview =
The {{Manual Windowcaption|Add Device}} dialog is always required when devices need to be added for the first time in a new, empty project, or when additional devices need to be included in an existing project. This is where the initial patch of required devices to their respective DMX addresses takes place.

The different icons before a DDF clearly show where the respective DDF comes from. Furthermore, all DDFs used in the current project are grouped into a common folder, should you need additional devices of the same type in the same DMX mode. For frequently used devices, the Favorites folder is available.

{{Manual Box | de | Hint | Changes to DMX addresses for devices that are already integrated into the project should not be made in the {{Manual Windowcaption|Add Device}} dialog but rather through the properties of the respective device or via the {{Manual Windowcaption|[[Patching_DMXC3|Patching]]}} dialog.}}

= Important Features =
== Add Additional DDFs ==
{|
| valign="top" rowspan="2" | DMXControl 3 comes with only a small selection of DDFs, meaning that due to the large number of available devices, DDFs for your own devices are often missing. To use custom-created DDFs or DDFs manually downloaded from the {{Manual Windowcaption|{{DMXCWebLinks|DDFLib}}}} in DMXControl 3, you need to place them in the directory accessed via the "Own DDFs" link in the Start menu (see Figure 2).

However, this directory can also be accessed via the Windows Explorer at the path {{Manual Filepath|C:\Users\'''{USERNAME}'''\AppData\Roaming\DMXControl Projects e.V\DMXControl\}}, where {{Manual Filepath|'''{USERNAME}'''}} refers to the name of the current user of the PC. As a shortcut, you can also reach this directory by entering {{Manual Filepath|%AppData%\Roaming\DMXControl Projects e.V\DMXControl\}} in the address bar of Windows Explorer.

You then save the <code>xml</code> file of the DDF in this directory. When using it for the first time, you may need to create the directories {{Manual Filepath|Images}} for the device images and {{Manual Filepath|Icons}} for the Gobos' icons, as shown in Figure 3. DDFs downloaded manually as a <code>zip</code> archive from the {{Manual Windowcaption|{{DMXCWebLinks|DDFLib}}}} need to be unpacked in this directory, and the image files for devices and icons must be placed in their respective folders. DMXControl 3 automatically handles the latter when you select a DDF directly from the {{Manual Windowcaption|[[DDF_Library_DMXC3|DDF Library]]}} dialog.

The directory {{Manual Filepath|UserDevices}} can also be used to store DDFs that you are currently creating and testing their functionality.

Whether modifying newly created DDFs or adding additional ones: the contents of the {{Manual Windowcaption|Add Device}} dialog are updated with each reopening. Therefore, DMXControl 3 can remain open during this process.
| style="width: 25px;" rowspan="2" |
| style="width: 480px;" | {{Image_with_Caption|DMXC3_Manual Device_Manager_Device_folder.png|2|Shortcut in the Start menu to access the folder for user-created DDFs.|center|480px}}
|-
| {{Image_with_Caption|DMXC3_Manual Device_Manager_Windows_Explorer_UserDevices.png|3|User DDFs in the "UserDevices" directory.|center|480px}}
|}
== Types of DDFs ==
The {{Manual Windowcaption|Add Device}} dialog gives access to three types of DDFs, which are stored in different directories and treated with different priorities when adding additional devices to an existing project.

{| class="wikitable toptextcells"
|-
! Category !! Icon !! Description !! Location !! Priority
|-
! style="width: 10em"| Project-DDF
| style="width: 5em; text-align: center" | [[File:DMXC3_Icon_V-Collection_suitcase2.png]]
| style="width: 20em" | Includes all DDFs required for the proper functioning of the current project
| style="width: 35em" | {{Manual Filepath|'''{PROJECT-ZIP}'''\LibDevices}}
{{Manual Filepath|'''{PROJECT-ZIP}'''\UserDevices}}
| style="width: 20em" | Highest priority in the current project,<br /> not present in new projects
|-
! User-DDFs
| style="text-align: center" | [[File:DMXC3_Icon_V-Collection_pawn_blue.png]]
| User-created DDFs
| {{Manual Filepath|'''{APPDATA}'''\DMXControl Projects e.V\DMXControl\Kernel\UserDevices\}}
| Medium priority in the current project,<br /> highest priority in new projects
|-
! rowspan="2" | Lib-DDFs
| rowspan="2" style="text-align: center" | [[File:DMXC3_Icon_V-Collection_earth.png]]
| Standard DDFs delivered by the installer
| {{Manual Filepath|'''{PROGRAM_DIRECTORY}'''\Kernel\LibDevices\}}
| rowspan="2" | Lowest priority in the current project,<br /> medium priority in new projects
|-
| DDFs downloaded via the DDF Library
| {{Manual Filepath|'''{APPDATA}'''\DMXControl Projects e.V\DMXControl\Kernel\LibDevices\}}
|}

{{Manual Box | de | Reference | The meaning of the directories '''{PROGRAM_DIRECTORY}''', '''{APPDATA}''' and '''{PROJECT-ZIP}''' in the context of DMXControl 3 is described in the article [[Introduction (DDF Syntax) DMXC3|DDF Introduction]].}}

{{Manual Box | de | Attention | All DDFs delivered by the installer and placed in the directory {{Manual Filepath|'''{PROGRAM_DIRECTORY}'''\Kernel\LibDevices\}} are completely overwritten with each update or reinstallation. Please use the {{Manual Filepath|UserDevices}} directory for your own DDFs, which can be accessed via the "Own DDFs" link in the Start menu of Windows.}}

= Controls =
The {{Manual Windowcaption|Add Device}} dialog is split into two parts. On the left side, there is a list of all DDFs, grouped by Favorites, Project-DDFs (for an existing project), and all available DDFs. All DDFs are listed according to their respective manufacturers and, if available, the corresponding DMX modes. When a DDF is selected, some device properties are displayed at the bottom. On the right side of the window, you define the name, number, and start address for the new device.

== Scope and Structure of the List ==
DMXControl 3 distinguishes between three types of DDFs:
# DDFs for a specific device from a specific manufacturer with a specific DDF mode
# DDFs for a specific device, but without a clear manufacturer association
# Generic DDFs without reference to a specific device or manufacturer

=== Device-Specific DDFs ===
DDFs created for a specific device with a specific DMX mode from a specific manufacturer are categorized accordingly and can be found by those search terms. Generally, the respective DDF includes all the functions of the device that could be controlled by DMXControl 3 at the time of creation.

=== DDFs Without Specific Manufacturer ===
Many devices on the market have an unclear or no defined manufacturer. To keep the list of available DDFs structured, these DDFs are collected in a common folder.

{{Manual Box | de | Hint | DDFs for devices without a clearly identifiable manufacturer can be found in the list under the folder {{Manual Objectcaption|Various}}.}}

=== General DDFs ===
DMXControl 3 also includes a number of general or generic DDFs that are not created for a specific device. These include:
* Simple dimmers
* Switches
* DDFs for LEDs in various forms such as RGB, RGBW, with or without dimmer, strobe channel, etc.
Typical examples include dimmer packs or LED strips. For each controllable output, you add the corresponding DDF to the project, such as
* 4 times the simple dimmer (for example, in 8-bit resolution) for a 4-channel dimmer pack
* 170 times the RGB DDF for an LED strip, where the 170 pixels can be individually controlled

{{Manual Box | de | Hint | All available general/generic DDFs can be found in the list under the folder {{Manual Objectcaption|Generic}}.}}

= Usage =
== Open Device Manager ==
{{Image_with_Caption|DMXC3_Manual TheFirstFixtures_Open Device Manager.png|4|Opening the Device Manager.|right|250px}}
To add devices, open the {{Manual Windowcaption|Add Device}} dialog. This can be done in three ways:
* via the menu entry {{Manual MenuText|Add Device}} in the context menu of the {{Manual Objectcaption|Device}} folder in the {{Manual Windowcaption|[[Project_Explorer_DMXC3|Project Explorer]]}}, or
* using the {{Manual Buttons|Add Device}} button in the Project Explorer menu bar, or
* via the context menu in the {{Manual Windowcaption|[[Stage_View_DMXC3|Stage View]]}}

== Add Devices ==
To add one or more devices, select the correct DDF or search for it using the search function. Once the desired device is selected, you can enter the quantity and adjust the name if needed. In the DMX settings area, define the start address (DMX start address) for the first device and whether a certain number of DMX channels should be left between devices (DMX space). The third part assigns the devices to a {{Manual Windowcaption|[[Device_Group_DMXC3|Device Group]]}}. If you want to add more than one device, this setting becomes active, and DMXControl suggests creating a new device group. You can change this name or select an existing device group from the dropdown to which the new devices should be added. By clicking the {{Manual Buttons|Add}} button, DMXControl 3 applies the previously set information. Afterward, you can directly add more devices. Once all devices are selected, click on the {{Manual Buttons|Close}} button.

== 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.

{|
|{{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}}
|-
|}

{{Manual Box | de | 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:
# 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> 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.

= Links und Referenzen =
== Links ==
<references/>

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


<noinclude>
[[Kategorie: Handbuch DMXControl 3]]
</noinclude>

[[de: Device_Manager_DMXC3]]