Pluginentwicklung - Versionsgeschichte

Admin am 15. Dezember 2015 um 06:18 Uhr

2015-12-15T06:18:12Z

Admin: /* Zu exportierende Funktionen */

2015-12-14T22:33:09Z

‎Zu exportierende Funktionen

Admin: /* Zu exportierende Funktionen */

2015-12-14T22:30:49Z

‎Zu exportierende Funktionen

Admin: /* Zu exportierende Funktionen */

2015-12-14T22:29:22Z

‎Zu exportierende Funktionen

Admin: /* Deutsch */

2012-06-24T11:26:33Z

‎Deutsch

Admin: /* Deutsch */

2012-06-24T11:10:57Z

‎Deutsch

Admin: /* Callback-Funktionen */

2012-06-22T13:07:03Z

‎Callback-Funktionen

Admin am 22. Juni 2012 um 13:06 Uhr

2012-06-22T13:06:18Z

Admin am 22. Juni 2012 um 11:04 Uhr

2012-06-22T11:04:19Z

Admin: Die Seite wurde neu angelegt: „=Deutsch= =English= Kategorie:Handbuch“

2012-06-21T22:44:43Z

Die Seite wurde neu angelegt: „=Deutsch= =English= Kategorie:Handbuch“

Neue Seite

=Deutsch=

=English=

[[Kategorie:Handbuch]]

← Nächstältere Version		Version vom 15. Dezember 2015, 06:18 Uhr
Zeile 110:		Zeile 110:

	Entsprechend dem Artikel zum [[Nachrichtensystem]] kann man eigene Nachrichten senden, um z.B. einen neuen Szenentyp zu erstellen, einen eigenen Befehl im PC_DIMMER zu installieren, eine Szene zu öffnen, ein neues Projekt zu erstellen, etc.		Entsprechend dem Artikel zum [[Nachrichtensystem]] kann man eigene Nachrichten senden, um z.B. einen neuen Szenentyp zu erstellen, einen eigenen Befehl im PC_DIMMER zu installieren, eine Szene zu öffnen, ein neues Projekt zu erstellen, etc.
		+
		+
		+	==Tipps und generelle Hinweise zu Plugins==
		+
		+	===Automatisches Anzeigen von Programmplugins===
		+
		+	Programm-Plugins können nach dem Start des PC_DIMMERs automatisch angezeigt werden lassen. Dies ist dann sinnvoll, wenn das Plugin beim Beenden des PC_DIMMERs noch geöffnet war und es somit beim nächsten Start wieder angezeigt werden soll:
		+
		+	In der Windows-Registry muss hierzu im Schlüssel HKCU/Software/PHOENIXstudios/PC_DIMMER/PLUGINDATEINAME.DLL/ ein Bool-Wert mit der Bezeichnung "Showing Plugin" platziert werden. Ist der Wert "True", wird das Plugin beim Start des PC_DIMMERs automatisch mit angezeigt - falls "False" dann nicht.
		+
		+	Im Event DLLDestroy() sollte hierfür vor dem automatischen Beenden der Oberfläche geprüft werden, ob diese angezeigt wird und der Wert entsprechend abgespeichert werden. Beim nächsten Laden des PC_DIMMERs wird der Rest vom Hauptprogramm übernommen.
		+

	=English=		=English=

← Nächstältere Version		Version vom 14. Dezember 2015, 22:33 Uhr
Zeile 54:		Zeile 54:

	Gibt die vom Hauptprogramm angeforderte Resource "ResName" über "Buffer" zurück. "Buffer" ist hierbei vom Hauptprogramm über die zuvor aufgerufene Funktion DLLGetResourceSize() entsprechend in der Größe dimensioniert. ''Diese Funktion ist OPTIONAL!''		Gibt die vom Hauptprogramm angeforderte Resource "ResName" über "Buffer" zurück. "Buffer" ist hierbei vom Hauptprogramm über die zuvor aufgerufene Funktion DLLGetResourceSize() entsprechend in der Größe dimensioniert. ''Diese Funktion ist OPTIONAL!''
		+	Derzeit wird die Funktion lediglich für das Übertragen eines PNG-Icons für Programm-Plugins verwendet. Die hierbei angeforderte Resource heißt "PNGICON". "Buffer" sollte somit mit einem PNG-Icon der zuvor übertragenen Länge sein.

@@ Zeile 53: / Zeile 53: @@
    function DLLGetResourceData(const ResName: PChar; Buffer: Pointer; var Length: Integer):boolean;stdcall;
-Gibt die vom Hauptprogramm angeforderte Resource "ResName" über "Buffer" zurück. "Buffer" ist hierbei vom Hauptprogramm über die zuvor aufgerufene Funktion DLLGetResourceSize() entsprechend in der Größe dimensioniert.
+Gibt die vom Hauptprogramm angeforderte Resource "ResName" über "Buffer" zurück. "Buffer" ist hierbei vom Hauptprogramm über die zuvor aufgerufene Funktion DLLGetResourceSize() entsprechend in der Größe dimensioniert. ''Diese Funktion ist OPTIONAL!''
    function DLLGetResourceSize(const ResName: PChar): Integer; stdcall;
-Gibt dem Hauptprogramm die Größe der Resource zurück, damit "Buffer" in der Funktion DLLGetResourceData() entsprechend dimensioniert werden kann.
+Gibt dem Hauptprogramm die Größe der Resource zurück, damit "Buffer" in der Funktion DLLGetResourceData() entsprechend dimensioniert werden kann. ''Diese Funktion ist OPTIONAL!''
    procedure DLLConfigure;stdcall;

@@ Zeile 50: / Zeile 50: @@
 Hier wird die Version des Plugins übergeben - wird aber nicht wirklich ausgewertet
    procedure DLLConfigure;stdcall;
@@ Zeile 74: / Zeile 83: @@
 Wird z.B. bei jeder Kanalwertänderung aufgerufen. Zusätzlich wird die Funktion aufgerufen, wenn z.B. ein neues Projekt angelegt wird und viele andere Ereignisse. MSG gibt die Art der Nachricht an (siehe [[Nachrichtensystem]]). Data1 und Data2 beinhalten Daten, wie z.B. Kanaladresse und Kanalwert.
 ==Callback-Funktionen==

@@ Zeile 3: / Zeile 3: @@
 Um den PC_DIMMER mit Funktionen zu erweitern kann man eigene Plugins entwickeln. Man kann folgende Beispielprojekte mit Sourcecode verwenden, um eigene Plugins zu entwickeln:
 * [http://www.pcdimmer.de/downloads/Software/SDK/PC_DIMMER_SDK_Ausgabeplugin_Delphi7.zip Delphi7 Beispiel für Ausgabeplugin] (aktualisiert am 24.06.2012)
 * [http://www.pcdimmer.de/downloads/Software/SDK/PC_DIMMER_SDK_Programmplugin_Delphi7.zip Delphi7 Beispiel für Programmplugin] (aktualisiert am 24.06.2012)

@@ Zeile 104: / Zeile 104: @@
    CallbackSendMessage= procedure(MSG: Byte; Data1, Data2:Variant);stdcall;
-Entsprechend der messagesystem.pas kann man eigene Nachrichten senden, um z.B. einen neuen Szenentyp zu erstellen, eine Szene zu öffnen, ein neues Projekt zu erstellen, etc.
+Entsprechend dem Artikel zum [[Nachrichtensystem]] kann man eigene Nachrichten senden, um z.B. einen neuen Szenentyp zu erstellen, einen eigenen Befehl im PC_DIMMER zu installieren, eine Szene zu öffnen, ein neues Projekt zu erstellen, etc.
 =English=

← Nächstältere Version		Version vom 22. Juni 2012, 13:06 Uhr
Zeile 72:		Zeile 72:
	procedure DLLSendMessage(MSG:Byte; Data1, Data2:Variant);stdcall;		procedure DLLSendMessage(MSG:Byte; Data1, Data2:Variant);stdcall;

−	Wird z.B. bei jeder Kanalwertänderung aufgerufen. Zusätzlich wird die Funktion aufgerufen, wenn z.B. ein neues Projekt angelegt wird und viele andere Ereignisse. MSG gibt die Art der Nachricht an (siehe ~~messagesystem.pas~~). Data1 und Data2 beinhalten Daten, wie z.B. Kanaladresse und Kanalwert.	+	Wird z.B. bei jeder Kanalwertänderung aufgerufen. Zusätzlich wird die Funktion aufgerufen, wenn z.B. ein neues Projekt angelegt wird und viele andere Ereignisse. MSG gibt die Art der Nachricht an (siehe [[Nachrichtensystem]]). Data1 und Data2 beinhalten Daten, wie z.B. Kanaladresse und Kanalwert.

← Nächstältere Version		Version vom 22. Juni 2012, 11:04 Uhr
Zeile 1:		Zeile 1:
	=Deutsch=		=Deutsch=
		+
		+	Um den PC_DIMMER mit Funktionen zu erweitern kann man eigene Plugins entwickeln. Man kann folgende Beispielprojekte mit Sourcecode verwenden, um eigene Plugins zu entwickeln:
		+
		+	* [http://www.pcdimmer.de/downloads/Software/SDK/PC_DIMMER_SDK_Ausgabeplugin_C++.zip C++ Beispiel für Ausgabeplugin (VisualStudio2005)]
		+	* [http://www.pcdimmer.de/downloads/Software/SDK/PC_DIMMER_SDK_Ausgabeplugin_Delphi7.zip Delphi7 Beispiel für Ausgabeplugin]
		+	* [http://www.pcdimmer.de/downloads/Software/SDK/PC_DIMMER_SDK_Programmplugin_Delphi7.zip Delphi7 Beispiel für Programmplugin]
		+
		+
		+	Ausgabe- und Programmplugins besitzen im Prinzip die gleiche Pluginsstruktur, werden jedoch in der Oberfläche anders dargestellt. Es genügt in der Funktion "DLLIdentify" zwischen "Output" und "Input" zu wechseln, um das Plugin entweder in der Interfacelist oder dem Pluginmenü im Hauptmenü des Programmes anzuzeigen.
		+
		+	Die Funktionen DLLAbout und DLLConfigure werden zudem nur bei Ausgabeplugins unterstützt. Statt DLLConfigure muss bei Programmplugins die Funktion DLLShow verwendet werden, um das Plugin bei einem Klick auf den Menüpunkt anzuzeigen.
		+
		+
		+
		+	Zum einfachen Testen von eigenen Plugins wird mit dem PC_DIMMER im Installationsverzeichnis ein Plugintester mitgeliefert. Man kann seine eigenen DLLs einfach auf die EXE-Datei per Drag&Drop ziehen und das Plugin wird entsprechend ausgeführt.
		+
		+
		+
		+	==Zu exportierende Funktionen==
		+
		+	procedure DLLCreate(CallbackSetDLLValues,CallbackSetDLLValueEvent,CallbackSetDLLNames, CallbackGetDLLValue,CallbackSendMessage:Pointer);stdcall;
		+
		+	Diese Funktion wird beim Aktivieren des Plugins aufgerufen. Dabei werden Pointer für Callbackfunktionen mitgeliefert. Möchte man diese Funktionen verwenden, um Daten zum PC_DIMMER zu senden (z.B. DMX-In Daten) dann kann man sich die Pointer auf seine Funktionsprototypen zuweisen. Die Callbackfunktionen sind weiter unten beschrieben.
		+
		+
		+	procedure DLLStart;stdcall;
		+
		+	Diese Funktion wird nach dem DLLCreate(...) aufgerufen. Man kann hier Timer starten oder sonstige Aktionen beginnen. Erzeugen und Starten von Objekten/Ereignissen ist somit getrennt.
		+
		+
		+	function DLLDestroy:boolean;stdcall;
		+
		+	Wird beim Deaktiveren des Plugins aufgerufen. Es sollten alle Objekte und Instanzen beendet werden, die bei DLLCreate(...) erzeugt wurden.
		+
		+
		+	function DLLIdentify:PChar;stdcall;
		+
		+	Hier wird dem PC_DIMMER lediglich mitgeteilt, ob das Plugin ein Ausgabeplugin (result='Output'), oder ein Programmplugin (result='Input') ist. Ist ein wenig Umständlich, aber so konnte ich damals nur programmieren :)
		+
		+
		+	function DLLGetName:PChar;stdcall;
		+
		+	Hier wird der Name des Plugins übergeben
		+
		+
		+	function DLLGetVersion:PChar;stdcall;
		+
		+	Hier wird die Version des Plugins übergeben - wird aber nicht wirklich ausgewertet
		+
		+
		+	procedure DLLConfigure;stdcall;
		+
		+	Wird aufgerufen, wenn man in den erweiterten Einstellungen auf "Konfigurieren" klickt
		+
		+
		+	procedure DLLAbout;stdcall;
		+
		+	Wird aufgerufen, wenn man in den erweiterten Einstellungen auf "Infos" klickt
		+
		+
		+	procedure DLLSendData(address, startvalue, endvalue, fadetime:integer;name:PChar);stdcall;
		+
		+	Wird z.B. beim Start einer Szene aufgerufen
		+
		+
		+	function DLLIsSending:boolean;stdcall;
		+
		+	Um Feedbackschleifen zwischen DMX-In und DMX-Out zu verhindern, muss das Plugin ein IsSending=true senden, bevor es einen Wert an das Hauptprogramm schickt.
		+
		+
		+	procedure DLLSendMessage(MSG:Byte; Data1, Data2:Variant);stdcall;
		+
		+	Wird z.B. bei jeder Kanalwertänderung aufgerufen. Zusätzlich wird die Funktion aufgerufen, wenn z.B. ein neues Projekt angelegt wird und viele andere Ereignisse. MSG gibt die Art der Nachricht an (siehe messagesystem.pas). Data1 und Data2 beinhalten Daten, wie z.B. Kanaladresse und Kanalwert.
		+
		+
		+
		+
		+
		+
		+
		+	==Callback-Funktionen==
		+
		+	CallbackSetDLLValues= procedure(address,startvalue,endvalue,fadetime,delay:integer);stdcall;
		+
		+	Hiermit kann man einen Wert an den PC_DIMMER senden. BEi Fadezeit>0 wird entsprechend eingeblendet, bei Delay>0 der Befehl entsprechend später ausgeführt.
		+
		+
		+	CallbackSetDLLValueEvent= procedure(address,endvalue:integer);stdcall;
		+
		+	Hiermit kann man einen Wert in die Data-In-Steuerung senden. Vor allem für DMX-In-Daten gedacht.
		+
		+
		+	CallbackSetDLLNames= procedure(address:integer;channelname:PChar);stdcall;
		+
		+	Hier kann man einen Kanalnamen ändern. Diese Funktion hat keinen größeren Sinn mehr in neueren PC_DIMMER-Versionen
		+
		+
		+	CallbackGetDLLValue= function(address:integer):integer;stdcall;
		+
		+	Hier kann man einen Kanalwert des PC_DIMMERs abfragen.
		+
		+
		+	CallbackSendMessage= procedure(MSG: Byte; Data1, Data2:Variant);stdcall;
		+
		+	Entsprechend der messagesystem.pas kann man eigene Nachrichten senden, um z.B. einen neuen Szenentyp zu erstellen, eine Szene zu öffnen, ein neues Projekt zu erstellen, etc.
		+