PHP-Klasse - Versionsgeschichte

Jkuehn am 6. Januar 2020 um 20:34 Uhr

2020-01-06T20:34:55Z

← Nächstältere Version		Version vom 6. Januar 2020, 22:34 Uhr
Zeile 115:		Zeile 115:

	=Forums-Threads=		=Forums-Threads=
	[~~http~~://dmxcontrol.~~de/forum~~/~~thread~~.php?~~threadid=~~2181 Web-Interface für DMXC 2.10 (Download)]		[https://forum.dmxcontrol-projects.org/index.php?thread/2181-web-interface-f%C3%BCr-dmxc-2-10-download/ Web-Interface für DMXC 2.10 (Download)]

	[~~http~~://dmxcontrol.de/~~forum/thread~~.php?~~threadid=~~2109 (Beta-Forum, Nur für Betatester zugänglich) PHP-Klasse für DMXControl; iPhone-Kommandobox; vollständiges Web-Interface]		[https://forum.dmxcontrol-projects.org/index.php?thread/2109-php-klasse-f%C3%BCr-dmxcontrol-iphone-kommandobox-vollst%C3%A4ndiges-web-interface/ (Beta-Forum, Nur für Betatester zugänglich) PHP-Klasse für DMXControl; iPhone-Kommandobox; vollständiges Web-Interface]

	[[Kategorie: Plugins DMXControl 2‏‎]]		[[Kategorie: Plugins DMXControl 2‏‎]]

Phaefele am 17. September 2013 um 22:09 Uhr

2013-09-17T22:09:44Z

← Nächstältere Version		Version vom 18. September 2013, 00:09 Uhr
Zeile 24:		Zeile 24:
	Der User Weissbier entwickelt momentan, ebenfalls auf Basis dieser PHP-Klasse, eine Erweiterung des Web-Interfaces zur Benutzung von Kommandobuttons.		Der User Weissbier entwickelt momentan, ebenfalls auf Basis dieser PHP-Klasse, eine Erweiterung des Web-Interfaces zur Benutzung von Kommandobuttons.

	~~=PHP-Klasse=~~		=Server-Anforderungen=
	==Server-Anforderungen==
	Es wird serverseitig mindestens PHP5 benötigt, da PHP4 nur eingeschränkt Objektorientierung unterstützt.		Es wird serverseitig mindestens PHP5 benötigt, da PHP4 nur eingeschränkt Objektorientierung unterstützt.
	Die Benutzung von PHP 5.2.5 oder höher wird empfohlen.		Die Benutzung von PHP 5.2.5 oder höher wird empfohlen.

	==Syntax==		=Syntax=
	;setChannel ( int $channel, int $value )		;setChannel ( int $channel, int $value )
	:setzt Kanal $channel auf den Wert $value (0-255).		:setzt Kanal $channel auf den Wert $value (0-255).
Zeile 88:		Zeile 87:
	:führt den Befehl aus. Als $flags kann flagToggle (Umschaltmodus), flagOverride (Wert verwenden), flagAskValue (Wert abfragen) oder flagIgnoreZero (0 ignorieren) angegeben werden; um mehrere Flags zu verwenden, müssen diese mit + aneinandergereiht werden.		:führt den Befehl aus. Als $flags kann flagToggle (Umschaltmodus), flagOverride (Wert verwenden), flagAskValue (Wert abfragen) oder flagIgnoreZero (0 ignorieren) angegeben werden; um mehrere Flags zu verwenden, müssen diese mit + aneinandergereiht werden.

	==Codebeispiel==		=Codebeispiel=
	Dieses Code-Beispiel bindet die Klasse ein, instanziert sie und stellt eine Verbindung mit DMXControl auf localhost her und setzt Kanal 1 auf 100%.		Dieses Code-Beispiel bindet die Klasse ein, instanziert sie und stellt eine Verbindung mit DMXControl auf localhost her und setzt Kanal 1 auf 100%.
	<?php		<?php
Zeile 96:		Zeile 95:
	?>		?>

	==Changelog==		=Changelog=
	===Version 1.0===		==Version 1.0==
	*Erste Version		*Erste Version
	*Für DMXControl 2.10 Beta 2 programmiert.		*Für DMXControl 2.10 Beta 2 programmiert.
	===Version 1.1 (30.08.2008)===		==Version 1.1 (30.08.2008)==
	*Timeouts sind jetzt nicht mehr nötig, da mehrzeilige Ausgaben von DMXControl seit dem RC1 mit ".\n" abgeschlossen werden. Dies führt zu einem Geschwindigkeitszuwachs von ca. 1000000% (!).		*Timeouts sind jetzt nicht mehr nötig, da mehrzeilige Ausgaben von DMXControl seit dem RC1 mit ".\n" abgeschlossen werden. Dies führt zu einem Geschwindigkeitszuwachs von ca. 1000000% (!).
	===Version 1.1.1 (08.09.2009)===		==Version 1.1.1 (08.09.2009)==
	*RunCommand übergibt jetzt den Wert korrekt (die Schnittstelle erwartet z.B. 100000 statt 100.000)		*RunCommand übergibt jetzt den Wert korrekt (die Schnittstelle erwartet z.B. 100000 statt 100.000)

	== Known Bugs ==		= Known Bugs =

	*Die ChannelNotifications, die die Terminalschnittstelle bietet, sind nicht implementiert		*Die ChannelNotifications, die die Terminalschnittstelle bietet, sind nicht implementiert
Zeile 115:		Zeile 114:
	Die ersten beiden Beschränkungen löst Weissbier momentan - er programmiert einen Daemon, der bei ChannelNotifications Befehle ausführen kann und wohl auch mehrere parallele Verbindungen zulässt. Ersteres ist vorallem zur Programmierung von Effekten in PHP nützlich (wenngleich dafür eher die Plugin-Schnittstelle benutzt werden sollte); Letzeres erlaubt mehrere Benutzer gleichzeitig und würde auch eine [[Web-Interface#Known_Bugs_2\|Beschränkung des Web-Interfaces]] aufheben.		Die ersten beiden Beschränkungen löst Weissbier momentan - er programmiert einen Daemon, der bei ChannelNotifications Befehle ausführen kann und wohl auch mehrere parallele Verbindungen zulässt. Ersteres ist vorallem zur Programmierung von Effekten in PHP nützlich (wenngleich dafür eher die Plugin-Schnittstelle benutzt werden sollte); Letzeres erlaubt mehrere Benutzer gleichzeitig und würde auch eine [[Web-Interface#Known_Bugs_2\|Beschränkung des Web-Interfaces]] aufheben.

	==Forums-Threads==		=Forums-Threads=
	[http://dmxcontrol.de/forum/thread.php?threadid=2181 Web-Interface für DMXC 2.10 (Download)]		[http://dmxcontrol.de/forum/thread.php?threadid=2181 Web-Interface für DMXC 2.10 (Download)]

Phaefele am 17. September 2013 um 22:07 Uhr

2013-09-17T22:07:47Z

← Nächstältere Version		Version vom 18. September 2013, 00:07 Uhr
Zeile 114:		Zeile 114:

	Die ersten beiden Beschränkungen löst Weissbier momentan - er programmiert einen Daemon, der bei ChannelNotifications Befehle ausführen kann und wohl auch mehrere parallele Verbindungen zulässt. Ersteres ist vorallem zur Programmierung von Effekten in PHP nützlich (wenngleich dafür eher die Plugin-Schnittstelle benutzt werden sollte); Letzeres erlaubt mehrere Benutzer gleichzeitig und würde auch eine [[Web-Interface#Known_Bugs_2\|Beschränkung des Web-Interfaces]] aufheben.		Die ersten beiden Beschränkungen löst Weissbier momentan - er programmiert einen Daemon, der bei ChannelNotifications Befehle ausführen kann und wohl auch mehrere parallele Verbindungen zulässt. Ersteres ist vorallem zur Programmierung von Effekten in PHP nützlich (wenngleich dafür eher die Plugin-Schnittstelle benutzt werden sollte); Letzeres erlaubt mehrere Benutzer gleichzeitig und würde auch eine [[Web-Interface#Known_Bugs_2\|Beschränkung des Web-Interfaces]] aufheben.

			==Forums-Threads==
			[http://dmxcontrol.de/forum/thread.php?threadid=2181 Web-Interface für DMXC 2.10 (Download)]

			[http://dmxcontrol.de/forum/thread.php?threadid=2109 (Beta-Forum, Nur für Betatester zugänglich) PHP-Klasse für DMXControl; iPhone-Kommandobox; vollständiges Web-Interface]

	[[Kategorie: Plugins DMXControl 2‏‎]]		[[Kategorie: Plugins DMXControl 2‏‎]]

Phaefele: Die Seite wurde neu angelegt: „{{Infobox Plugin | Name = PHP-Klasse | Logo = | Screenshot = | Beschreibung = | Hersteller = Michael Kuron | AktuelleVersion = 1.1.1 | AktuelleVersionFreigab…“

2013-09-17T22:05:52Z

Die Seite wurde neu angelegt: „{{Infobox Plugin | Name = PHP-Klasse | Logo = | Screenshot = | Beschreibung = | Hersteller = Michael Kuron | AktuelleVersion = 1.1.1 | AktuelleVersionFreigab…“

Neue Seite

{{Infobox Plugin
| Name = PHP-Klasse
| Logo =
| Screenshot =
| Beschreibung =
| Hersteller = Michael Kuron
| AktuelleVersion = 1.1.1
| AktuelleVersionFreigabeDatum =
| Status =
| Funktioniertmit = 2.10
| Programmiersprache = php
| Kategorie =
| Lizenz =
| Deutsch =
| Email =
| Homepage =
| Download = http://michael.kuron-germany.de/dmxc/dmxc.inc.php
}}
= Beschreibung =
Seit Version 2.10 bietet DMXControl eine [[Terminal_Schnittstelle|Terminal-Schnittstelle]], über die externe Programme über das Netzwerk auf Funktionen von DMXControl zugreifen können.
Für den Zugriff auf die Terminal-Schnittstelle wurde von Michael Kuron eine PHP-Klasse erstellt, die die Kommunikation und den Aufruf der Befehle abwickelt.

Auf Basis dieser PHP-Klasse wurde von Michael Kuron ein Web-Interface entwickelt, das sich an den Funktionen der [[PDA-2-DMXC|PDA-Steuerung]] orientiert.
Der User Weissbier entwickelt momentan, ebenfalls auf Basis dieser PHP-Klasse, eine Erweiterung des Web-Interfaces zur Benutzung von Kommandobuttons.

=PHP-Klasse=
==Server-Anforderungen==
Es wird serverseitig mindestens PHP5 benötigt, da PHP4 nur eingeschränkt Objektorientierung unterstützt.
Die Benutzung von PHP 5.2.5 oder höher wird empfohlen.

==Syntax==
;setChannel ( int $channel, int $value )
:setzt Kanal $channel auf den Wert $value (0-255).
;int getChannel ( int $channel )
:gibt den aktuellen Wert von Kanal $channel zurück.

;array getAllDevices ( )
:gibt ein assoziatives Array mit allen Geräten zurück - die Keys sind die Geräte-IDs, die Werte die Geräte-Namen.
Array
(
[1] => PAR left (1)
[2] => PAR left (2)
[3] => PAR right (1)
[4] => PAR right (2)
[5] => Roboscan 518
)
;array getDeviceInfo_byname ( string $device )
:gibt Informationen über das Gerät mit dem Namen $device aus.
Array
(
[Name] => Roboscan 518
[StartAddress] => 9
[PanTilt] => Fine 5 7 6 8
[Channels] => 9
[Channel1] => Multifunktion
[Channel2] => Helligkeit
[Channel3] => Farbe
[Channel4] => Gobo
[Channel5] => Effekte
[Channel6] => Pan
[Channel7] => Pan (Fein)
[Channel8] => Tilt
[Channel9] => Tilt (Fein)
)

;array getCommandPossibilities_byname ( string $module, string $function, string $channel )
:gibt die Befehlsmöglichkeiten aus. Alle Parameter sind optional (wenn keiner angegeben wird, werden die verfügbaren Module ausgegeben; wenn nur $module angegeben wird, werden die Funktionen dieses Moduls ausgegeben; wenn $module und $function angegeben werden, werden die Kanäle dieser Funktion ausgegeben.
Array
(
[1] => Deaktiviert
[2] => Audiotrack
[3] => BeatTool
[4] => DMX-Ausgabe
[5] => DMXIn-Remote
[6] => Effekte
[7] => Geräte
[8] => Gruppenauswahl
[9] => Kommandozeile
[10] => Master
[11] => MIDI-Remote
[12] => Sound Analyzer
[13] => Submaster
[14] => Szenenbibliothek
[15] => Szenenliste
[16] => Textbuch

;runCommand_byname ( string $module, string $function, string $channel, int $flags, int $value )
:führt den Befehl aus. Als $flags kann flagToggle (Umschaltmodus), flagOverride (Wert verwenden), flagAskValue (Wert abfragen) oder flagIgnoreZero (0 ignorieren) angegeben werden; um mehrere Flags zu verwenden, müssen diese mit + aneinandergereiht werden.

==Codebeispiel==
Dieses Code-Beispiel bindet die Klasse ein, instanziert sie und stellt eine Verbindung mit DMXControl auf localhost her und setzt Kanal 1 auf 100%.
<?php
require_once "dmxc.inc.php";
$dmxc = new dmxc("127.0.0.1");
$dmxc->setChannel(1,255)
?>

==Changelog==
===Version 1.0===
*Erste Version
*Für DMXControl 2.10 Beta 2 programmiert.
===Version 1.1 (30.08.2008)===
*Timeouts sind jetzt nicht mehr nötig, da mehrzeilige Ausgaben von DMXControl seit dem RC1 mit ".\n" abgeschlossen werden. Dies führt zu einem Geschwindigkeitszuwachs von ca. 1000000% (!).
===Version 1.1.1 (08.09.2009)===
*RunCommand übergibt jetzt den Wert korrekt (die Schnittstelle erwartet z.B. 100000 statt 100.000)

== Known Bugs ==

*Die ChannelNotifications, die die Terminalschnittstelle bietet, sind nicht implementiert
**In einer single-threaded-Programmiersprache wie PHP sind sie recht nutzlos.
**Nach dem Durchlauf des PHP-Skriptes bleibt keine Verbindung zum Client bestehen, sodass die ChannelNotifications auch nicht dazu benutzt werden können, z.B. eine Kanalübersicht im Web-Interface laufend zu aktualisieren. Falls das aber in Kombination mit AJAX nützlich sein könnte, kann man das aber immer noch implementieren.
*Nur ein simultaner User
**Das ist aber eine Beschränkung der DMXControl-Terminalschnittstelle, die nur eine Verbindung gleichzeitig zulässt.

Die ersten beiden Beschränkungen löst Weissbier momentan - er programmiert einen Daemon, der bei ChannelNotifications Befehle ausführen kann und wohl auch mehrere parallele Verbindungen zulässt. Ersteres ist vorallem zur Programmierung von Effekten in PHP nützlich (wenngleich dafür eher die Plugin-Schnittstelle benutzt werden sollte); Letzeres erlaubt mehrere Benutzer gleichzeitig und würde auch eine [[Web-Interface#Known_Bugs_2|Beschränkung des Web-Interfaces]] aufheben.

[[Kategorie: Plugins DMXControl 2‏‎]]