DMX-Plugin - Versionsgeschichte

Admin: /* Verzahnung von Sequenzen */

2015-09-04T10:30:53Z

Verzahnung von Sequenzen

@@ Zeile 101: / Zeile 101: @@
 ==== Verzahnung von Sequenzen ====
-Dadurch, dass in der Planungsphase in einer Sequenz mehrere Auslösungen des gleichen Geräts hintereinander stattfinden können, besteht die Möglichkeit, dass sich die ''Prepare-'', ''TurnOn-'' und ''TurnOff''-Sequenzen mehrerer Auslösungen überschneiden können. Um in diesem Fall möglichst sinnvolle Effekt-Ergebnisse zu erzielen, gibt es die drei Kanalmodi ''Set_LTP'', ''Set_HTP'' und ''Set_Lock''. Über diese können
+Dadurch, dass in der Planungsphase in einer Sequenz mehrere Auslösungen des gleichen Geräts hintereinander stattfinden können, besteht die Möglichkeit, dass sich die ''Prepare-'', ''TurnOn-'' und ''TurnOff''-Sequenzen mehrerer Auslösungen überschneiden können. Um in diesem Fall möglichst sinnvolle Effekt-Ergebnisse zu erzielen, gibt es die drei Kanalmodi ''Set_LTP'', ''Set_HTP'' und ''Set_Lock''.
-So könnte z.B. der "Freischalt-Kanal" eines Effektes über Set_HTP in der ''Prepare''-Sektion gesetzt durch einen weiteren Set_HTP-Aufruf in der TurnOff-Sektion wieder gelöscht werden. Sollte sich ein zweiter Cue zeitlich so nah an der ersten Auslösung befinden würde aus jedem der Cues der höhere Wert benutzt und der Kanal so durchgehend "auf gezogen" bleiben. Eine ähnliche Situation wäre das Festlegen eines Winkels bei einem Flammenprojektor: Über Set_Lock würde in der ''Prepare''-Sektion der Schusswinkel angefahren so dass der Flammenprojektor genug Zeit hätte darauf zu reagieren. In ''TurnOn'' würde die Auslösung der Flamme erfolgen und in TurnOff sowohl die Flammen abgeschaltet als auch der Winkel-Kanal wieder für Fremdzugriffe freigegeben werden (hierzu wird Set_HTP oder Set_LTP verwendet - dieser Befehl gibt einen mittels Set_Lock gesperrten Kanal wieder für andere Cues frei).
+Der Freischalt-Kanal eines Flammenprojektors muss nur direkt vor dem Auslösen des Effekts gesetzt werden - daher soll er nicht in der Scharfschaltung des Systems sondern unmittelbar vor Auslösung des Effekts - nämlich in der ''Prepare''-Sektion gesetzt werden. Die Freischaltung erfolgt über Gerätekanal 1, die Auslösung der Flammen über Kanal 2. Die Flammen bleibt so lange an, wie beide Kanäle über dem Wert 250 sind. Durch die Benutzung des Befehls Set_HTP ist gewährleistet, dass für den Fall dass die ''Prepare''-Sektion einer nachfolgenden Auslösung ''vor'' der ''TurnOff''-Sektion der ersten Auslösung ausgeführt wird der Freigabe-Kanal nicht auf 0 steht (das wäre z.B. bei Set oder Set_LTP der Fall) sondern weiterhin auf 255 - da zu jedem Zeitpunkt der jeweils höchste Wert für den Kanal benutzt wird, der von einem Cue "angefordert" wurde:
 ==== Service-Sequenzen ====

Admin: /* DMX-Sequenzen */

2015-09-04T10:05:03Z

DMX-Sequenzen

← Nächstältere Version		Version vom 4. September 2015, 10:05 Uhr
Zeile 46:		Zeile 46:

	=== DMX-Sequenzen ===		=== DMX-Sequenzen ===
	Für jede DMX-Sequenz welche einzeln ausgeführt wird, ~~wird~~ eine eigene, neue Sektion hinzugefügt.		Für jede DMX-Sequenz welche einzeln ausgeführt wird, muss in der Gerätedefinition eine eigene, neue Sektion hinzugefügt werden. Innerhalb einer Sequenz können teilweise Parameter (Format ''Name''=''Wert'') angegeben werden. Alle anderen Zeilen werden als Befehle einer Sequenz interpretiert und in der Reihenfolge wie sie aufgeführt werden abgearbeitet wenn die Sequenz gestartet wurde.

			Folgende Befehle stehen dabei zur Verfügung:
			* '''Set <x>, <y>''': Setzt Kanal x (1-512) auf den Wert y (0-255). Mischung von mehreren Kanalwerten erfolgt im LTP-Modus, d.H. alle vorherigen Werte werden überschrieben sofern der Kanal nicht von einem anderen Effekt gesperrt ist. Wenn der Kanal durch den gleichen Cue gesperrt wurde (Set_Lock), wird er durch diesen Befehl wieder freigegeben.
			* '''Set_HTP <x>, <y>''': Setzt Kanal x (1-512) auf den Wert y (0-255). Mischung von mehreren Kanalwerten erfolgt im HTP-Modus, d.H. der zu einer beliebigen Zeit höchste Wert hat Priorität. Wenn der Kanal durch den gleichen Cue gesperrt wurde (Set_Lock), wird er durch diesen Befehl wieder freigegeben.
			* '''Set_Lock <x>, <y>''': Setzt Kanal x (1-512) auf den Wert y (0-255). Der Kanal wird für andere Cues innerhalb der aktuellen Sequenz gesperrt, er muss im Laufe eines Sequenz wieder freigegeben werden (durch Set_LTP oder Set_HTP) damit andere Cues darauf wieder Zugriff haben. Während der Kanal gesperrt ist, werden weitere Zugriffe (LTP, HTP oder Lock) im Hintergrund beibehalten und werden erst angewendet wenn der Kanal freigegeben wurde.
			: ''Anmerkung: Die genaue Funktion der Set_LTP, Set_HTP und Set_Lock-Befehle wird im Bereich der Effektsequenzen genauer erklärt.''
			* '''Wait <Zeit>''': Pausiert die Sequenz für die angegebene Zeit (Angabe in Millisekunden)
			* '''WaitUntil <Zeit>''': Pausiert die Sequenz bis die angegebene ''absolute'' Zeit (in Millisekunden) erreicht ist. Absolute Zeit bedeutet, dass die Zeit ab dem Start der Sequenz gerechnet wird und nicht relativ zum letzten Wait oder WaitUntil-Befehl
			{{Achtung\|Die Angabe der Kanalnummer in allen oben genannten Befehlen bezieht sich immer auf den Gerätekanal. Die Angabe von Kanal 1 bezieht sich also bei einem Gerät welches die DMX-Kanäle 10-12 belegt auf den DMX-Kanal 10, die Angabe 3 würde sich auf DMX-Kanal 12 beziehen.}}
			Die Ansteuerung von globalen Kanälen (welche unabhängig von der Adressierung eines Gerätes sind) ist nicht möglich und würde das Konzept "ein Gerät hat mehrere aufeinander folgende DMX-Kanäle" verwischen. Hierfür muss bei Bedarf ein Pseudo-Gerät definiert werden welches dann auf die entsprechende Adresse in SkyConductor programmiert wird.

	==== Armed-Sequenz ====		==== Armed-Sequenz ====
			Scharfschalte-Sequenz. Diese Sequenz wird ausgeführt, wenn das DMX-Modul scharf geschaltet wird. Die Befehle für alle definierten Geräte werden in dieser Sequenz zusammengefasst. Bei der Definition eines Geräts muss dies jedoch nicht weiter berücksichtigt werden.
	<pre>		<pre>
	[Armed]		[Armed]
Zeile 55:		Zeile 66:
	Set 1, 255		Set 1, 255
	</pre>		</pre>
	~~Scharfschalte-Sequenz. Diese Sequenz wird ausgeführt, wenn das DMX-Modul scharf geschaltet wird. Erlaubt sind alle Befehle die in einer Sequenz gültig sind:~~
	* '''Set <x>, <y>''': Setzt Kanal x (1-512) auf den Wert y (0-255). Mischung von mehreren Kanalwerten erfolgt im LTP-Modus, d.H. alle vorherigen Werte werden überschrieben sofern der Kanal nicht von einem anderen Effekt gesperrt ist.
	* '''Set_HTP <x>, <y>''': Setzt Kanal x (1-512) auf den Wert y (0-255). Mischung von mehreren Kanalwerten erfolgt im HTP-Modus, d.H. der zu einer beliebigen Zeit höchste Wert hat Priorität.
	* '''Set_Lock <x>, <y>''': Setzt Kanal x (1-512) auf den Wert y (0-255). Der Kanal wird für andere Cues innerhalb dieses Scripts gesperrt, er muss im Laufe eines Scripts wieder freigegeben werden (durch Set_LTP oder Set_HTP) damit andere Cues wieder Zugriff haben. Während der Kanal gesperrt ist, werden weitere Zugriffe (LTP, HTP oder Lock) im Hintergrund beibehalten und werden erst angewendet wenn der Kanal freigegeben wurde.
	* '''Wait <Zeit>''': Pausiert die Sequenz für die angegebene Zeit (Angabe in Millisekunden)
	* '''WaitUntil <Zeit>''': Pausiert die Sequenz bis die angegebene ''absolute'' Zeit (in Millisekunden) erreicht ist. Absolute Zeit bedeutet, dass die Zeit ab dem Start der Sequenz gerechnet wird und nicht relativ zum letzten Wait oder WaitUntil-Befehl

	==== ~~Pause~~-Sequenz ====		==== Paused-Sequenz ====
			Die Paused-Sequenz wird ausgeführt, wenn eine Show pausiert wird. Einige Geräte müssen in einem solchen Fall abgeschaltet werden, zum Beispiel Flammenprojektoren. Es sollte darauf geachtet werden, dass es keine "Unpausiert"-Sequenz gibt, die erneute Auslösung muss also mit den normalen "Prepare"- und "TurnOn"-Sequenzen möglich sein. Vor allem sollte die Scharfschaltung (Armed-Sequenze) durch die Pause-Sequenz nicht aufgehoben werden. Wie auch die Armed-Sequenz werden die Befehle alle Paused-Sequenzen in einer einzigen Sequenz zusammengefasst.
	<pre>		<pre>
	[Paused]		[Paused]
	~~SequenceFlags=may_run_disarmed~~
	Set 2, 0		Set 2, 0
	</pre>		</pre>
	Sequenz welche beim Pausieren einer Show ausgeführt wird um z.B. Flammenprojektoren abzuschalten welche sonst eine konstante Flamme auslösen würden. Der Eintrag SequenceFlags legt Eigenschaften der Sequenz fest. Die z.Zt. einzig mögliche Angabe ist ''may_run_disarmed'', was dazu führt dass die Sequenz auch bei unscharf geschaltetem DMX-Modul ausgeführt werden darf.

	==== Prepare-Sequenz =~~===~~		==== Effektsequenzen ====
			Die Sequenzen ''Prepare'', ''TurnOn'' und ''TurnOff'' dürfen nur gemeinsam betrachtet werden. Die in ihnen enthaltenen Steuerbefehle werden in einer einzelnen, nämlich der entsprechenden Effektsequenz, miteinander kombiniert. Hinzu kommt, dass mehrere Cues innerhalb einer Sequenz sich zeitlich überlagern können was entsprechend berücksichtigt werden muss. Insofern sind hier auch die Sequenzbefehle Set_LTP, Set_HTP und Set_Lock von besonderer Bedeutung, da sich hierdurch das Zusammenspielen mehrerer gleichzeitiger/nacheinander stattfindender Auslösungen miteinander kombinieren lässt. Beispiele für diese Techniken finden sich weiter unten.

			Die ''Prepare''-Sequenz wird ausgeführt, wenn ein Cue gezündet würde. Die entsprechenden Befehle werden also zeitlich so einsortiert, dass ihre Ausführung mit der Vorlaufzeit beginnt. Über den ''MinDuration=<Wert>''-Parameter lässt sich festlegen dass die Vorlaufzeit mindestens die angegebene Zeit in Millisekunden betragen muss.
	<pre>		<pre>
	[Prepare]		[Prepare]
Zeile 77:		Zeile 84:
	Set 3, 255		Set 3, 255
	</pre>		</pre>
	Wird immer dann ausgeführt, wenn ein Cue gezündet wird, d.H. die Vorlaufzeit bis zum eigentlichen Effekt beginnt. Bei einem pyrotechnischen Effekt mit entsprechender Steigzeit wäre dies die Auslösung der Zündung.

	~~====~~ TurnOn-Sequenz ~~====~~		Die ''TurnOn''-Sequenz wird zur Effektzeit des Cues gestartet:
	<pre>		<pre>
	[TurnOn]		[TurnOn]
Zeile 86:		Zeile 92:
	Wird immer im Moment der Effektzeit eines Cues ausgeführt. Dient z.B. dazu, die Flamme eines Flammenprojektors auszulösen.		Wird immer im Moment der Effektzeit eines Cues ausgeführt. Dient z.B. dazu, die Flamme eines Flammenprojektors auszulösen.

	~~==== TurnOff-Sequenz ====~~		Die ''TurnOff''-Sequenz wird ausgeführt, wenn ein Effekt nicht mehr sichtbar sein soll - dieser Zeitpunkt entspricht dem Ende eines Cues.
	Die "TurnOff"-Sequenz wird ausgeführt, wenn ein Effekt nicht mehr sichtbar sein soll~~. Der genaue~~ Zeitpunkt ~~wird aus~~ dem ~~in der Show vorhandenen Cue ermittelt~~.
	<pre>		<pre>
	[TurnOff]		[TurnOff]
Zeile 94:		Zeile 99:
	Set 3, 0		Set 3, 0
	</pre>		</pre>

			==== Verzahnung von Sequenzen ====
			Dadurch, dass in der Planungsphase in einer Sequenz mehrere Auslösungen des gleichen Geräts hintereinander stattfinden können, besteht die Möglichkeit, dass sich die ''Prepare-'', ''TurnOn-'' und ''TurnOff''-Sequenzen mehrerer Auslösungen überschneiden können. Um in diesem Fall möglichst sinnvolle Effekt-Ergebnisse zu erzielen, gibt es die drei Kanalmodi ''Set_LTP'', ''Set_HTP'' und ''Set_Lock''. Über diese können


			So könnte z.B. der "Freischalt-Kanal" eines Effektes über Set_HTP in der ''Prepare''-Sektion gesetzt durch einen weiteren Set_HTP-Aufruf in der TurnOff-Sektion wieder gelöscht werden. Sollte sich ein zweiter Cue zeitlich so nah an der ersten Auslösung befinden würde aus jedem der Cues der höhere Wert benutzt und der Kanal so durchgehend "auf gezogen" bleiben. Eine ähnliche Situation wäre das Festlegen eines Winkels bei einem Flammenprojektor: Über Set_Lock würde in der ''Prepare''-Sektion der Schusswinkel angefahren so dass der Flammenprojektor genug Zeit hätte darauf zu reagieren. In ''TurnOn'' würde die Auslösung der Flamme erfolgen und in TurnOff sowohl die Flammen abgeschaltet als auch der Winkel-Kanal wieder für Fremdzugriffe freigegeben werden (hierzu wird Set_HTP oder Set_LTP verwendet - dieser Befehl gibt einen mittels Set_Lock gesperrten Kanal wieder für andere Cues frei).



	==== Service-Sequenzen ====		==== Service-Sequenzen ====
	Servicesequenzen werden im Menü des DMX-Moduls angezeigt und können von dort vom Benutzer aufgerufen werden. Es lassen sich (fast) beliebig viele Servicesequenzen definieren wobei beachtet werden sollte, dass die Übersichtlichkeit bei vielen Sequenzen natürlich leiden kann. Servicesequenzen werden pro Gerätedefinition genau einmal angelegt. Wenn also von einem Flammenprojektor 10 Stück in einer Show aufgebaut werden und in der Gerätedefinition für den Projektor 2 Servicesequenzen (z.B. zum Testen und Entlüften des Geräts) angelegt sind, so werden später im Gerät stattliche 20 Servicesequenzen angezeigt. Da dies in Form einer Liste erfolgt ist es wichtig, nur Servicesequenzen anzulegen die wirklich für den Betrieb benötigt werden.		Servicesequenzen werden im Menü des DMX-Moduls angezeigt und können von dort vom Benutzer aufgerufen werden. Es lassen sich (fast) beliebig viele Servicesequenzen definieren wobei beachtet werden sollte, dass die Übersichtlichkeit bei vielen Sequenzen natürlich leiden kann. Servicesequenzen werden pro Gerätedefinition genau einmal angelegt. Wenn also von einem Flammenprojektor 10 Stück in einer Show aufgebaut werden und in der Gerätedefinition für den Projektor 2 Servicesequenzen (z.B. zum Testen und Entlüften des Geräts) angelegt sind, so werden später im Gerät stattliche 20 Servicesequenzen angezeigt. Da dies in Form einer Liste erfolgt ist es wichtig, nur Servicesequenzen anzulegen die wirklich für den Betrieb benötigt werden.
			Innerhalb von Service-Sequenzen können mit dem Parameter ''SequenceFlags=<Werte>'' folgende Eigenschaften festgelegt werden:
			* '''may_run_disarmed''': Diese Sequenz darf auch ausgeführt werden, wenn das DMX-Modul nicht scharf geschaltet ist.

	<pre>		<pre>

Admin: /* Einfache Gerätedefinition */

2015-09-04T09:10:47Z

Einfache Gerätedefinition

← Nächstältere Version		Version vom 4. September 2015, 09:10 Uhr
Zeile 16:		Zeile 16:
	Im Folgenden findet sich ein Beispiel für eine entsprechende Gerätedefinition. Die einzelnen Bereiche sind einzeln angegeben um eine übersichtlichere Beschreibung zu ermöglichen:		Im Folgenden findet sich ein Beispiel für eine entsprechende Gerätedefinition. Die einzelnen Bereiche sind einzeln angegeben um eine übersichtlichere Beschreibung zu ermöglichen:

			=== General-Sektion ===
	<pre>		<pre>
	[General]		[General]
Zeile 44:		Zeile 45:
	* '''copy_armed_value''': Behält den letzten Wert eines Kanals beim Unscharf schalten bei, fällt also nicht auf den Zustand vor der Scharfschaltung zurück. "Clear" hat Priorität über "Set".		* '''copy_armed_value''': Behält den letzten Wert eines Kanals beim Unscharf schalten bei, fällt also nicht auf den Zustand vor der Scharfschaltung zurück. "Clear" hat Priorität über "Set".

			=== DMX-Sequenzen ===
			Für jede DMX-Sequenz welche einzeln ausgeführt wird, wird eine eigene, neue Sektion hinzugefügt.

			==== Armed-Sequenz ====
	<pre>		<pre>
	[Armed]		[Armed]
Zeile 57:		Zeile 62:
	* '''WaitUntil <Zeit>''': Pausiert die Sequenz bis die angegebene ''absolute'' Zeit (in Millisekunden) erreicht ist. Absolute Zeit bedeutet, dass die Zeit ab dem Start der Sequenz gerechnet wird und nicht relativ zum letzten Wait oder WaitUntil-Befehl		* '''WaitUntil <Zeit>''': Pausiert die Sequenz bis die angegebene ''absolute'' Zeit (in Millisekunden) erreicht ist. Absolute Zeit bedeutet, dass die Zeit ab dem Start der Sequenz gerechnet wird und nicht relativ zum letzten Wait oder WaitUntil-Befehl

			==== Pause-Sequenz ====
	<pre>		<pre>
	[Paused]		[Paused]
Zeile 64:		Zeile 70:
	Sequenz welche beim Pausieren einer Show ausgeführt wird um z.B. Flammenprojektoren abzuschalten welche sonst eine konstante Flamme auslösen würden. Der Eintrag SequenceFlags legt Eigenschaften der Sequenz fest. Die z.Zt. einzig mögliche Angabe ist ''may_run_disarmed'', was dazu führt dass die Sequenz auch bei unscharf geschaltetem DMX-Modul ausgeführt werden darf.		Sequenz welche beim Pausieren einer Show ausgeführt wird um z.B. Flammenprojektoren abzuschalten welche sonst eine konstante Flamme auslösen würden. Der Eintrag SequenceFlags legt Eigenschaften der Sequenz fest. Die z.Zt. einzig mögliche Angabe ist ''may_run_disarmed'', was dazu führt dass die Sequenz auch bei unscharf geschaltetem DMX-Modul ausgeführt werden darf.

			==== Prepare-Sequenz ====
	<pre>		<pre>
	[Prepare]		[Prepare]
Zeile 72:		Zeile 79:
	Wird immer dann ausgeführt, wenn ein Cue gezündet wird, d.H. die Vorlaufzeit bis zum eigentlichen Effekt beginnt. Bei einem pyrotechnischen Effekt mit entsprechender Steigzeit wäre dies die Auslösung der Zündung.		Wird immer dann ausgeführt, wenn ein Cue gezündet wird, d.H. die Vorlaufzeit bis zum eigentlichen Effekt beginnt. Bei einem pyrotechnischen Effekt mit entsprechender Steigzeit wäre dies die Auslösung der Zündung.

			==== TurnOn-Sequenz ====
	<pre>		<pre>
	[TurnOn]		[TurnOn]
Zeile 78:		Zeile 86:
	Wird immer im Moment der Effektzeit eines Cues ausgeführt. Dient z.B. dazu, die Flamme eines Flammenprojektors auszulösen.		Wird immer im Moment der Effektzeit eines Cues ausgeführt. Dient z.B. dazu, die Flamme eines Flammenprojektors auszulösen.

			==== TurnOff-Sequenz ====
			Die "TurnOff"-Sequenz wird ausgeführt, wenn ein Effekt nicht mehr sichtbar sein soll. Der genaue Zeitpunkt wird aus dem in der Show vorhandenen Cue ermittelt.
	<pre>		<pre>
	[TurnOff]		[TurnOff]
Zeile 84:		Zeile 94:
	Set 3, 0		Set 3, 0
	</pre>		</pre>
	~~Wird immer dann ausgeführt~~, ~~wenn ein Effekt nicht mehr sichtbar ist~~. ~~Hier sollte~~ z.B. die ~~Flamme eines Flammenprojektors aus geschaltet~~ werden.
			==== Service-Sequenzen ====
			Servicesequenzen werden im Menü des DMX-Moduls angezeigt und können von dort vom Benutzer aufgerufen werden. Es lassen sich (fast) beliebig viele Servicesequenzen definieren wobei beachtet werden sollte, dass die Übersichtlichkeit bei vielen Sequenzen natürlich leiden kann. Servicesequenzen werden pro Gerätedefinition genau einmal angelegt. Wenn also von einem Flammenprojektor 10 Stück in einer Show aufgebaut werden und in der Gerätedefinition für den Projektor 2 Servicesequenzen (z.B. zum Testen und Entlüften des Geräts) angelegt sind, so werden später im Gerät stattliche 20 Servicesequenzen angezeigt. Da dies in Form einer Liste erfolgt ist es wichtig, nur Servicesequenzen anzulegen die wirklich für den Betrieb benötigt werden.

	<pre>		<pre>
Zeile 93:		Zeile 105:
	Set 3, 0		Set 3, 0
	</pre>		</pre>
	Private Sequenzen werden im Menü für Service-Sequenzen des DMX-Moduls angezeigt und lassen sich vom Benutzer über das Menü auslösen. Diese Sequenzen können Sonderfunktionen abbilden wie in diesem Beispiel das Entlüften eines Flammenprojektors. Der Name sollte kurz und prägnant sein, da er insgesamt in eine Zeile mit max. 20 Zeichen passen muss (darüber hinaus gehende Zeichen werden abgeschnitten). Um hier verschiedene Geräte ansprechen zu können, sollte über das Kürzel %id% der Name unter welchem das Gerät läuft und welcher bei der Showplanung vergeben wird mit eingebaut werden. ~~Private Sequenzen~~ können ebenfalls (wie im nächsten Abschnitt ersichtlich) mit Eigenschaften gekennzeichnet werden (''ManualSequenceFlags=..''). Die zur Zeit einzige Eigenschaft ist '''arm_to_run''', welches dem DMX-Modul mitteilt dass diese Sequenz nur korrekt funktioniert wenn das DMX-Modul dafür scharf geschaltet ist und damit alle Kanäle freigegeben werden die nur im scharf geschalteten Zustand auf gezogen werden dürfen.		Der angegebene Name sollte kurz und prägnant sein, da er insgesamt in eine Zeile mit max. 20 Zeichen passen muss (darüber hinaus gehende Zeichen werden abgeschnitten). Um hier verschiedene Geräte ansprechen zu können, sollte über das Kürzel %id% der Name unter welchem das Gerät läuft und welcher bei der Showplanung vergeben wird mit eingebaut werden, da sonst die Servicesequenz eventuell nicht von anderen Servicesequenzen unterscheidbar ist. Servicesequenzen können ebenfalls (wie im nächsten Abschnitt ersichtlich) mit Eigenschaften gekennzeichnet werden (''ManualSequenceFlags=..''). Die zur Zeit einzige Eigenschaft ist '''arm_to_run''', welches dem DMX-Modul mitteilt dass diese Sequenz nur korrekt funktioniert wenn das DMX-Modul dafür scharf geschaltet ist und damit alle Kanäle freigegeben werden die nur im scharf geschalteten Zustand auf gezogen werden dürfen.

	<pre>		<pre>

Admin am 3. September 2015 um 21:27 Uhr

2015-09-03T21:27:01Z

← Nächstältere Version		Version vom 3. September 2015, 21:27 Uhr
Zeile 12:		Zeile 12:
	== Einfache Gerätedefinition ==		== Einfache Gerätedefinition ==

	Die einfache Gerätedefinition ermöglicht es für ein benutzerdefiniertes Gerät abhängig vom Geräte-Startkanal bei verschiedenen Aktionen (Scharfschaltung, Pause einer Show, Servicesequenzen) oder innerhalb von musiksynchronen Shows oder manuellen Sequenzen diverse vorgefertigte Aktionen auszuführen. Dazu wird eine entsprechende Geräte-Definitionsdatei angelegt, über welche die entsprechenden Steuerungsaufgaben für das DMX-Universum programmiert werden können. Parameter lassen sich mit dieser Art der Ansteuerung nicht verwenden, es wird also nur eine reine "ein/aus"-Steuerung realisiert.		Die einfache Gerätedefinition ermöglicht es für ein benutzerdefiniertes Gerät abhängig vom Geräte-Startkanal bei verschiedenen Aktionen (Scharfschaltung, Pause einer Show, Servicesequenzen) oder innerhalb von musiksynchronen Shows oder manuellen Sequenzen diverse vorgefertigte Aktionen auszuführen. Dazu wird eine entsprechende Geräte-Definitionsdatei angelegt, über welche die entsprechenden Steuerungsaufgaben für das DMX-Universum programmiert werden können. Parameter lassen sich mit dieser Art der Ansteuerung nicht verwenden, es wird also nur eine reine "ein/aus"-Steuerung realisiert. Dafür ist diese Art der Ansteuerung sehr einfach zu verwenden.

			Im Folgenden findet sich ein Beispiel für eine entsprechende Gerätedefinition. Die einzelnen Bereiche sind einzeln angegeben um eine übersichtlichere Beschreibung zu ermöglichen:

			<pre>
			[General]
			Identity=Test DMX Device
			Manufacturer=HSE Productions
			DeviceName=Test device
			ChannelCount=5
			SetChannelFlag1=arming_lock,always_internal
			ClearChannelFlag1=copy_armed_value
			</pre>

			In der General-Sektion werden generelle Eigenschaften der Gerätedefinition festgelegt:
			; Identity
			: Der Identity-Eintrag legt die Identität des Gerätes fest. Der hier angegebene Name muss global eindeutig sein.
			; Manufacturer
			: Der Hersteller des Geräts. Dieser Name wird zur Einsortierung im Geräteauswahl-Dialog benutzt. Alle Geräte eines Herstellers werden dabei zusammen ausklappbar gruppiert.
			; DeviceName
			: Der Name des Geräts. Der Name sollte so kurz wie möglich aber so aussagekräftig wie nötig angegeben werden. Abkürzungen sollten jedoch vermieden werden wenn sie nicht absolut eindeutig sind.
			; ChannelCount
			: Die Anzahl DMX-Kanäle die das Gerät benötigt.
			; SetChannelFlag1 .. SetChannelFlag<n>
			: Die Angabe der Kanaleigenschaften, welche für diesen DMX-Kanal des Geräts unbedingt gesetzt sein sollten.
			; ClearChannelFlag1 .. ClearChannelFlag<n>
			: Die Angabe der Kanaleigenschaften, welche für diesen DMX-Kanal des Geräts auf keinen Fall gesetzt sein sollten.
			Je nachdem welche Kanaleigenschaft betroffen ist, hat entweder die Angabe von SetChannelFlag oder ClearChannelFlag Priorität. Folgende Eigenschaften sind zur Zeit möglich:
			* '''arming_lock''': Verhindert, dass ein Kanal auf gezogen werden kann während das DMX-Modul unscharf ist. "Set" hat Priorität über "Clear".
			* '''always_internal''': Verhindert, dass eine Zusamenmischung mit den Daten eines externen Lichtpults erfolgt. "Set" hat Priorität über "Clear".
			* '''copy_armed_value''': Behält den letzten Wert eines Kanals beim Unscharf schalten bei, fällt also nicht auf den Zustand vor der Scharfschaltung zurück. "Clear" hat Priorität über "Set".

			<pre>
			[Armed]
			Set 2, 0
			Wait 100
			Set 1, 255
			</pre>
			Scharfschalte-Sequenz. Diese Sequenz wird ausgeführt, wenn das DMX-Modul scharf geschaltet wird. Erlaubt sind alle Befehle die in einer Sequenz gültig sind:
			* '''Set <x>, <y>''': Setzt Kanal x (1-512) auf den Wert y (0-255). Mischung von mehreren Kanalwerten erfolgt im LTP-Modus, d.H. alle vorherigen Werte werden überschrieben sofern der Kanal nicht von einem anderen Effekt gesperrt ist.
			* '''Set_HTP <x>, <y>''': Setzt Kanal x (1-512) auf den Wert y (0-255). Mischung von mehreren Kanalwerten erfolgt im HTP-Modus, d.H. der zu einer beliebigen Zeit höchste Wert hat Priorität.
			* '''Set_Lock <x>, <y>''': Setzt Kanal x (1-512) auf den Wert y (0-255). Der Kanal wird für andere Cues innerhalb dieses Scripts gesperrt, er muss im Laufe eines Scripts wieder freigegeben werden (durch Set_LTP oder Set_HTP) damit andere Cues wieder Zugriff haben. Während der Kanal gesperrt ist, werden weitere Zugriffe (LTP, HTP oder Lock) im Hintergrund beibehalten und werden erst angewendet wenn der Kanal freigegeben wurde.
			* '''Wait <Zeit>''': Pausiert die Sequenz für die angegebene Zeit (Angabe in Millisekunden)
			* '''WaitUntil <Zeit>''': Pausiert die Sequenz bis die angegebene ''absolute'' Zeit (in Millisekunden) erreicht ist. Absolute Zeit bedeutet, dass die Zeit ab dem Start der Sequenz gerechnet wird und nicht relativ zum letzten Wait oder WaitUntil-Befehl

			<pre>
			[Paused]
			SequenceFlags=may_run_disarmed
			Set 2, 0
			</pre>
			Sequenz welche beim Pausieren einer Show ausgeführt wird um z.B. Flammenprojektoren abzuschalten welche sonst eine konstante Flamme auslösen würden. Der Eintrag SequenceFlags legt Eigenschaften der Sequenz fest. Die z.Zt. einzig mögliche Angabe ist ''may_run_disarmed'', was dazu führt dass die Sequenz auch bei unscharf geschaltetem DMX-Modul ausgeführt werden darf.

			<pre>
			[Prepare]
			;Noch nicht berücksichtigt!
			MinDuration=100
			Set 3, 255
			</pre>
			Wird immer dann ausgeführt, wenn ein Cue gezündet wird, d.H. die Vorlaufzeit bis zum eigentlichen Effekt beginnt. Bei einem pyrotechnischen Effekt mit entsprechender Steigzeit wäre dies die Auslösung der Zündung.

			<pre>
			[TurnOn]
			Set 2, 255
			</pre>
			Wird immer im Moment der Effektzeit eines Cues ausgeführt. Dient z.B. dazu, die Flamme eines Flammenprojektors auszulösen.

			<pre>
			[TurnOff]
			Set 2, 0
			Wait 30
			Set 3, 0
			</pre>
			Wird immer dann ausgeführt, wenn ein Effekt nicht mehr sichtbar ist. Hier sollte z.B. die Flamme eines Flammenprojektors aus geschaltet werden.

			<pre>
			[PrivateSequence1]
			Name=%id%: Vent
			Set 3, 255
			Wait 2500
			Set 3, 0
			</pre>
			Private Sequenzen werden im Menü für Service-Sequenzen des DMX-Moduls angezeigt und lassen sich vom Benutzer über das Menü auslösen. Diese Sequenzen können Sonderfunktionen abbilden wie in diesem Beispiel das Entlüften eines Flammenprojektors. Der Name sollte kurz und prägnant sein, da er insgesamt in eine Zeile mit max. 20 Zeichen passen muss (darüber hinaus gehende Zeichen werden abgeschnitten). Um hier verschiedene Geräte ansprechen zu können, sollte über das Kürzel %id% der Name unter welchem das Gerät läuft und welcher bei der Showplanung vergeben wird mit eingebaut werden. Private Sequenzen können ebenfalls (wie im nächsten Abschnitt ersichtlich) mit Eigenschaften gekennzeichnet werden (''ManualSequenceFlags=..''). Die zur Zeit einzige Eigenschaft ist '''arm_to_run''', welches dem DMX-Modul mitteilt dass diese Sequenz nur korrekt funktioniert wenn das DMX-Modul dafür scharf geschaltet ist und damit alle Kanäle freigegeben werden die nur im scharf geschalteten Zustand auf gezogen werden dürfen.

			<pre>
			[PrivateSequence2]
			Name=%id%: Fire!
			ManualSequenceFlags=arm_to_run
			Set 2, 0
			Wait 30
			Set 1, 255
			Wait 60
			Set 4, 255
			Wait 100
			Set 3, 255
			Wait 1000
			Set 3, 0
			Wait 30
			Set 4, 0
			Wait 30
			Set 2, 0
			</pre>
			Beispiel für eine Service-Sequenz welche die Scharfschaltung des DMX-Moduls erfordert.

Admin: Die Seite wurde neu angelegt: „Das DMX-Plugin für SkyConductor erweitert die Software bei einer bestehenden DMX-Freischaltung um diverse SkyDirector-spezifische DMX-Funktionen des DMX-Modul…“

2015-09-03T15:27:22Z

Die Seite wurde neu angelegt: „Das DMX-Plugin für SkyConductor erweitert die Software bei einer bestehenden DMX-Freischaltung um diverse SkyDirector-spezifische DMX-Funktionen des DMX-Modul…“

Neue Seite

Das DMX-Plugin für SkyConductor erweitert die Software bei einer bestehenden DMX-Freischaltung um diverse PyroNeo-spezifische DMX-Funktionen des DMX-Moduls. Unter anderem erlaubt es das DMX-Plugin, eigene Geräte zu definieren und in Shows zu verwenden. Das DMX-Plugin besteht aus mehreren Komponenten, welche weiter unten einzeln beschrieben sind.

= Installation des DMX-Plugins =
Das DMX-Plugin wird über ein eigenständiges Setup-Programm installiert. Nach der Installation bietet das DMX-Plugin keine eigenständige Oberfläche sondern wird direkt über SkyConductor bedient und angesprochen. Es erweitert die Software um diverse Gerätedefinitionen (vorwiegend Flammenprojektoren) und die Möglichkeit, eigene Geräte über entsprechende Gerätedefinitionsdateien zu erstellen.

= Anlegen neuer Geräte =
Das DMX-Plugin bietet die Möglichkeit, neue Geräte auf zwei Arten hinzuzufügen: eine einfache dafür weniger flexible Methode und eine vollständig programmierbare Variante.

== Einfache Gerätedefinition ==

Die einfache Gerätedefinition ermöglicht es für ein benutzerdefiniertes Gerät abhängig vom Geräte-Startkanal bei verschiedenen Aktionen (Scharfschaltung, Pause einer Show, Servicesequenzen) oder innerhalb von musiksynchronen Shows oder manuellen Sequenzen diverse vorgefertigte Aktionen auszuführen. Dazu wird eine entsprechende Geräte-Definitionsdatei angelegt, über welche die entsprechenden Steuerungsaufgaben für das DMX-Universum programmiert werden können. Parameter lassen sich mit dieser Art der Ansteuerung nicht verwenden, es wird also nur eine reine "ein/aus"-Steuerung realisiert.