Pluginprogrammierung DMXC2 Tut - Versionsgeschichte

Jkuehn am 6. Januar 2020 um 20:44 Uhr

2020-01-06T20:44:06Z

← Nächstältere Version		Version vom 6. Januar 2020, 22:44 Uhr
Zeile 12:		Zeile 12:
	\| Lizenz =		\| Lizenz =
	\| Deutsch =		\| Deutsch =
	\| Email = info@dmxcontrol.de		\| Email = info@dmxcontrol-projects.org
	\| Homepage = ~~http~~://www.dmxcontrol.de		\| Homepage = https://www.dmxcontrol.de
	\| Download =		\| Download =
	}}		}}
Zeile 544:		Zeile 544:
	*'''Status:''' für DMXControl 2.10 (wird fortlaufend aktualisiert)		*'''Status:''' für DMXControl 2.10 (wird fortlaufend aktualisiert)
	*'''Dateien:'''		*'''Dateien:'''
	**Plugin: [~~http~~://www.dmxcontrol.de/files/plugins/PluginSchnittstellenTest/2.10/DMXCTest.dll DMXCTest.dll]		**Plugin: [https://www.dmxcontrol.de/files/DMXControl_2/plugins/PluginSchnittstellenTest/2.10/DMXCTest.dll DMXCTest.dll]
	**Sourcecode: [~~http~~://www.dmxcontrol.de/files/plugins/PluginSchnittstellenTest/2.10/DMXC-Plugin-Tutorial.zip DMXC-Plugin-Tutorial Source]		**Sourcecode: [https://www.dmxcontrol.de/files/DMXControl_2/plugins/PluginSchnittstellenTest/2.10/DMXC-Plugin-Tutorial.zip DMXC-Plugin-Tutorial Source]
	*'''Beschreibung:''' Dieses Plugin demonstriert alle Funktionen der Pluginschnittstelle		*'''Beschreibung:''' Dieses Plugin demonstriert alle Funktionen der Pluginschnittstelle


	[[Kategorie:Plugins_DMXControl_2]]		[[Kategorie:Plugins_DMXControl_2]]

Phaefele: Links repariert

2013-04-08T20:14:10Z

Links repariert

Phaefele: Tutorial 2 integriert, alles etwas anderst formatiert

2013-04-04T08:08:55Z

Tutorial 2 integriert, alles etwas anderst formatiert

Änderungen zeigen

Uprenner am 2. April 2013 um 17:26 Uhr

2013-04-02T17:26:48Z

Änderungen zeigen

Uprenner: Die Seite wurde neu angelegt: „'''Für die Benutzung dieser Plugins benötigen Sie DMXControl 2.9 oder 2.10''' Die Dll-Datei eines Plugins muß in das Unterverzeichnis "plugins" des DMXCon…“

2013-04-02T17:12:45Z

Die Seite wurde neu angelegt: „'''Für die Benutzung dieser Plugins benötigen Sie DMXControl 2.9 oder 2.10''' Die Dll-Datei eines Plugins muß in das Unterverzeichnis "plugins" des DMXCon…“

Neue Seite

'''Für die Benutzung dieser Plugins benötigen Sie DMXControl 2.9 oder 2.10'''

Die Dll-Datei eines Plugins muß in das Unterverzeichnis "plugins" des DMXControl-Installationsverzeichnisses kopiert werden. Hinweis: Neben den Plugins, die über eine definierte Schnittstelle mit DMXControl kommunizieren und aus technischer Sicht eine Zusatz-dll für DMXControl bilden, gibt es auch eine Reihe von [[Erweiterungstools]], die andere Interfaces zur Kommunikation mit DMXControl verwenden (z.B. MIDI oder IP-Schnittstelle).

<br>

= Tutorial-Plugins =

== Demo-Plugin 1 ==

[[Image:LauflichtDemoPluginMini.jpg]]

*'''Datum/Zeit:''' Dezember 2006
*'''Autor:''' DMXControl Team
*'''Status:''' -
*'''Dateien (ab DMXControl 2.9):'''
**Kompiliert: [[Media:TutorLL.2.9.0.zip|Demo_plugin.dll]]
**Sourcecode: [[Media:TutorLLSource.2.9.0.zip|DMXC_Demo_Plugin.zip]]
*'''Beschreibung:'''

Hier die ausführliche Beschreibung zum [[Plugin Tutorial 1|Demo-Tutorial]].

<br>

== DMXC Plugin Tutorial ==

[[Image:DMXC-Plugin-Tutorial.jpg]]

*'''Datum/Zeit:''' Oktober 2008
*'''Autor:''' Frank Brüggemann
*'''Status:''' für DMXControl 2.10 (wird fortlaufend aktualisiert)
*'''Dateien:'''
**Plugin: [http://www.dmxcontrol.de/files/plugins/PluginSchnittstellenTest/2.10/DMXCTest.dll DMXCTest.dll]
**Sourcecode: [http://www.dmxcontrol.de/files/plugins/PluginSchnittstellenTest/2.10/DMXC-Plugin-Tutorial.zip DMXC-Plugin-Tutorial Source]
*'''Beschreibung:'''

Dieses Plugin demonstriert alle Funktionen der Pluginschnittstelle. [[DMXC de Plugin Tutorial|Ausführliche Beschreibung...]]

← Nächstältere Version		Version vom 8. April 2013, 22:14 Uhr
Zeile 306:		Zeile 306:
	IDMXCPlugin_Term() wird immer aufgerufen, wenn DMXC beendet wird, hier können Sie z.B. geteilte Resourcen mit anderen Tools freigeben.		IDMXCPlugin_Term() wird immer aufgerufen, wenn DMXC beendet wird, hier können Sie z.B. geteilte Resourcen mit anderen Tools freigeben.

	Die Funktion IDMXCPlugin_MessageHandle legt fest, was das Plugin tut, wenn eine ([[DMXControl-Messages \| DMXControl-Nachricht]]) eintrifft, z.B. zur Übermittlung eines DMX-Signals, also dass irgendein Kanal seinen Wert geändert hat. Dies ist sozusagen die “call back”-Funktion von DMXControl, um dem Plugin die Wertänderung mitzuteilen. Man beachte, dass diverse Messagetypen existieren.		Die Funktion IDMXCPlugin_MessageHandle legt fest, was das Plugin tut, wenn eine ([[Pluginprogrammierung_DMXC2#DMXControl-Messages\| DMXControl-Nachricht]]) eintrifft, z.B. zur Übermittlung eines DMX-Signals, also dass irgendein Kanal seinen Wert geändert hat. Dies ist sozusagen die “call back”-Funktion von DMXControl, um dem Plugin die Wertänderung mitzuteilen. Man beachte, dass diverse Messagetypen existieren.

	In unserem Falle werden nur die "Message_Channel_Send"-Nachrichten ausgewertet (falls der Receivemode) aktiviert ist) und die Methode TutorLLGetDMXValue aus dem Logikmodul aufgerufen. Letztere Methode entscheidet dann, ob die Wertänderungen Auswirkung auf die GUI hat und initiiert gegebenenfalls entsprechende Aktivitäten.		In unserem Falle werden nur die "Message_Channel_Send"-Nachrichten ausgewertet (falls der Receivemode) aktiviert ist) und die Methode TutorLLGetDMXValue aus dem Logikmodul aufgerufen. Letztere Methode entscheidet dann, ob die Wertänderungen Auswirkung auf die GUI hat und initiiert gegebenenfalls entsprechende Aktivitäten.
Zeile 323:		Zeile 323:
	==Die Erzeugung der DLL==		==Die Erzeugung der DLL==

	Eine Übersicht über mögliche Entwicklungsumgebungen enthält der Artikel [[Plugin_Entwicklungsumgebung]]. In diesem Tutorial bleiben wir bei VB6.		Eine Übersicht über mögliche Entwicklungsumgebungen enthält der Artikel [[Pluginprogrammierung_DMXC2#In_welcher_Umgebung_kann_man_eine_Plugin-dll_entwickeln.3F\|Plugin_Entwicklungsumgebung]]. In diesem Tutorial bleiben wir bei VB6.

	Zu Beginn bietet es sich an, das PlugIn als normales Projekt in VB6 zu entwickeln und somit "offline (von DMXControl)" die GUI		Zu Beginn bietet es sich an, das PlugIn als normales Projekt in VB6 zu entwickeln und somit "offline (von DMXControl)" die GUI
Zeile 441:		Zeile 441:
	werden die Signale einfach ignoriert, ansonsten wird die Routine "TutorLLGetDMXValue" im Modul DMXCTutorLL aufgerufen, weil dort		werden die Signale einfach ignoriert, ansonsten wird die Routine "TutorLLGetDMXValue" im Modul DMXCTutorLL aufgerufen, weil dort
	die Logik implementiert ist, was mit dem empfangenen Signal zu geschehen hat. Natürlich können Sie in Ihrem Plugin die Signale		die Logik implementiert ist, was mit dem empfangenen Signal zu geschehen hat. Natürlich können Sie in Ihrem Plugin die Signale
	feiner filtern oder auch andere [[DMXControl-Messages\|Messages]] empfangen.		feiner filtern oder auch andere [[Pluginprogrammierung_DMXC2#DMXControl-Messages\|Messages]] empfangen.

	Private Function IDMXCPlugin_MessageHandle(Msg As DMXCTypeLib.MSGs, Arg1 As Long, Arg2 As Long) As Long		Private Function IDMXCPlugin_MessageHandle(Msg As DMXCTypeLib.MSGs, Arg1 As Long, Arg2 As Long) As Long
Zeile 530:		Zeile 530:
	==Integration in DMXControl==		==Integration in DMXControl==

	Da sich an der Modul-Struktur des Plugins nichts geändert hat, gilt hier alles, was im Kapitel 3.6 und 3.7 ([[Plugin Tutorial 1]]) beschrieben wurde. Vergessen Sie beim Ausprobieren nicht, die Startadresse des Dimmerpacks einzustellen und den "Receive"-Mode zu aktivieren.		Da sich an der Modul-Struktur des Plugins nichts geändert hat, gilt hier alles, was im Kapitel 3.6 und 3.7 ([[Pluginprogrammierung_DMXC2_Tut#Tutorial_Teil_1\|Plugin Tutorial Teil 1]]) beschrieben wurde. Vergessen Sie beim Ausprobieren nicht, die Startadresse des Dimmerpacks einzustellen und den "Receive"-Mode zu aktivieren.

	Mit Hilfe des Submasters können Sie die Änderung der DMX-Werte auf den Dimmerpack-Kanälen vornehmen und dann die visuelle Anzeige in unserem Plugin bestaunen. Es ergibt sich auch tatsächlich ein Lichtorgel-Effekt bei der Benutzung des [[Sound Analyzer]]s.		Mit Hilfe des Submasters können Sie die Änderung der DMX-Werte auf den Dimmerpack-Kanälen vornehmen und dann die visuelle Anzeige in unserem Plugin bestaunen. Es ergibt sich auch tatsächlich ein Lichtorgel-Effekt bei der Benutzung des [[Sound_Analyzer_DMXC2\|Sound Analyzer]]s.

	Wir wünschen Ihnen nun viel Spaß und Erfolg bei der Erstellung Ihres eigenen Plugins.		Wir wünschen Ihnen nun viel Spaß und Erfolg bei der Erstellung Ihres eigenen Plugins.