DMX-Plugin:Scripted-Gerät - Versionsgeschichte

Admin: /* Datenübertragung in Cues */

2016-05-14T17:48:58Z

Datenübertragung in Cues

← Nächstältere Version		Version vom 14. Mai 2016, 17:48 Uhr
Zeile 216:		Zeile 216:
	Definition der Routine:		Definition der Routine:
	'''Sub AdjustCueData(DeviceType, Cue, DMXDevice)'''		'''Sub AdjustCueData(DeviceType, Cue, DMXDevice)'''
			; DeviceType
			: Typ ''String'', die in der AddDMXDevice angegebene ID. Dient zur Unterscheidung mehrerer von der Gerätedefinition unterstützter Gerätetypen
	; Cue		; Cue
	: Typ Cue - Der anzupassende Cue		: Typ Cue - Der anzupassende Cue

Admin: /* Datenübertragung in Cues */

2016-05-14T17:48:02Z

Datenübertragung in Cues

← Nächstältere Version		Version vom 14. Mai 2016, 17:48 Uhr
Zeile 215:		Zeile 215:

	Definition der Routine:		Definition der Routine:
	'''Sub AdjustCueData(Cue, DMXDevice)'''		'''Sub AdjustCueData(DeviceType, Cue, DMXDevice)'''
	; Cue		; Cue
	: Typ Cue - Der anzupassende Cue		: Typ Cue - Der anzupassende Cue
Zeile 226:		Zeile 226:
	End Sub		End Sub
	</pre>		</pre>


	== Verwaltung von Cue-Einstellungen ==		== Verwaltung von Cue-Einstellungen ==

Admin: /* Das Form-Objekt */

2015-09-09T13:25:12Z

Das Form-Objekt

← Nächstältere Version		Version vom 9. September 2015, 13:25 Uhr
Zeile 265:		Zeile 265:

	=== Das Form-Objekt ===		=== Das Form-Objekt ===
	Das Form-Objekt ermöglicht es, innerhalb einer ''EditCue''-Funktion eine grafische Eingabemöglichkeit zur Verfügung zu stellen. Es kann über das Container-Objekt abgerufen werden.		Das Form-Objekt ermöglicht es, innerhalb einer ''EditCue''-Funktion eine grafische Eingabemöglichkeit zur Verfügung zu stellen. Es kann über das Container-Objekt abgerufen werden. Die wichtigsten neuen Eigenschaften und Funktionen sind nachfolgende beschrieben, zusätzlich erbt das Objekt alle Eigenschaften und Methoden des VB6.Form-Objektes (Top, Left, Width, Height, Visible, Caption, ..).

			; Function AddButton(ControlName As String, Top As Single, Left As Single, Height As Single, Width As Single, Caption As String) As Object
			: Fügt einen neuen Button an der angegebenen Position hinzu. Alle Maße werden in Pixeln angegeben, ''Name'' gibt den internen Namen und ''Caption'' die Beschriftung des Buttons an. Zurückgegeben wird ein VB.CommandButton (VB6-Objekt). Bei einem Klick auf den Button wird die Funktion <''Name''>_Click() aufgerufen (wenn der Name z.B. cmdOK ist heißt die Eventfunktion cmdOK_Click).
			; Function AddLabel(ControlName As String, Top As Single, Left As Single, Height As Single, Width As Single, Caption As String) As Object
			: Fügt ein neues Label (Beschriftung) an der angegebenen Position hinzu. Alle Maße werden in Pixeln angegeben, ''Name'' gibt den internen Namen und ''Caption'' die Beschriftung des Labels an. Zurückgegeben wird ein VB.Label (VB6-Objekt).
			; Function AddTextbox(ControlName As String, Top As Single, Left As Single, Height As Single, Width As Single, Text As String) As Object
			: Fügt eine neue TextBox (Eingabefeld) an der angegebenen Position hinzu. Alle Maße werden in Pixeln angegeben, ''Name'' gibt den internen Namen und ''Text'' den Inhalt des Textfeldes an. Zurückgegeben wird eine VB.TextBox (VB6-Objekt). Wenn der Inhalt des Textfeldes geändert wird, wird die Funktion <''Name''>_Change() aufgerufen (wenn der Name z.B. txtOK ist heißt die Eventfunktion txtOK_Change). Dies passiert auch, wenn der Text initial festgelegt wird.
			; Function AddCheckbox(ControlName As String, Top As Single, Left As Single, Height As Single, Width As Single, Caption As String, Optional Value As Integer) As Object
			: Fügt eine neuen CheckBox an der angegebenen Position hinzu. Alle Maße werden in Pixeln angegeben, ''Name'' gibt den internen Namen, ''Caption'' die Beschriftung und ''Value'' optional den Zustand der CheckBox an. Zurückgegeben wird eine VB.CheckBox (VB6-Objekt). Bei einem Klick auf die CheckBox wird die Funktion <''Name''>_Click() aufgerufen (wenn der Name z.B. chkOK ist heißt die Eventfunktion chkOK_Click).
			; Function AddCombobox(ControlName As String, Top As Single, Left As Single, Height As Single, Width As Single, ParamArray Items() As Variant) As Object
			: Fügt eine neuen ComboBox an der angegebenen Position hinzu. Alle Maße werden in Pixeln angegeben, ''Name'' gibt den internen Namen an. Für das Parameter-Array (beliebig viele Parameter) können beliebig viele anzuzeigende Auswahlmöglichkeiten angegeben werden (bei sehr vielen Möglicheiten sollten diese jedoch nachträglich über .AddItem hinzugefügt werden). Zurückgegeben wird eine VB.ComboBox (VB6-Objekt). Bei der Auswahl eines anderen Eintrages wird die Funktion <''Name''>_Click() aufgerufen, wenn eine Freitexteingabe möglich ist und der Inhalt geändert wird die <''Name''>_Change()-Funktion. Wenn der Name z.B. cmbOK ist heißen die Eventfunktionen cmbOK_Click und cmbOK_Change).
			: ''Anmerkung:'' Die gleiche Funktion mit dem Namen AddComboboxEx erwartet abwechselnd einen Eintragnamen (Typ String) und die dafür vorgesehenen Eintrag ItemData (Typ Integer) wobei zuerst der Eintragname stehen muss.
			; Function AddColorPicker(ControlName As String, Top As Single, Left As Single, Height As Single, Width As Single, Color As Long) As Object
			: Fügt ein neuenes Farbauswahl-Feld an der angegebenen Position hinzu. Alle Maße werden in Pixeln angegeben, ''Name'' gibt den internen Namen und ''Color'' die initiale Farbe des Feldes an. Zurückgegeben wird ein Farbauswahlfeld mit den Eigenschaften ''Color'', ''Visible'', ''Top'', ''Left'', ''Height'' und ''Width''. Wenn die Farbe geändert wurde wird die Funktion <''Name''>_Change() aufgerufen (wenn der Name z.B. colOK ist heißt die Eventfunktion colOK_Change).
			; Function GetControl(Name As String) As Object
			: Ruft ein vorher per Add.... hinzugefügtes Objekt ab. Funktioniert jedoch z.Zt. nicht für ColorPicker.

Admin: /* Das Form-Objekt */

2015-09-08T15:43:01Z

Das Form-Objekt

← Nächstältere Version		Version vom 8. September 2015, 15:43 Uhr
Zeile 265:		Zeile 265:

	=== Das Form-Objekt ===		=== Das Form-Objekt ===
	Das Form-Objekt ermöglicht es, innerhalb einer ''EditCue''-Funktion eine grafische Eingabemöglichkeit zur Verfügung zu stellen.		Das Form-Objekt ermöglicht es, innerhalb einer ''EditCue''-Funktion eine grafische Eingabemöglichkeit zur Verfügung zu stellen. Es kann über das Container-Objekt abgerufen werden.

Admin: /* Datenübertragung in Cues */

2015-09-08T15:32:03Z

Datenübertragung in Cues

← Nächstältere Version		Version vom 8. September 2015, 15:32 Uhr
Zeile 226:		Zeile 226:
	End Sub		End Sub
	</pre>		</pre>


			== Verwaltung von Cue-Einstellungen ==
			Je nach DMX-Gerät können pro Auslösung unterschiedlichste Einstellungen möglich sein. Diese Einstellungen können in den seltensten Fällen über das Showscript direkt gemacht werden weil die entsprechenden Eingabeelemente dort nicht grundsätzlich vorhanden sind. Es besteht deshalb die Möglichkeit der GUI-Programmierung für die Eingabe dieser gerätespezifischen Daten.
			Um diese Eingabe zu ermöglichen wird bei einem Doppelklick auf den Cue die ''EditCue''-Funktion aufgerufen. Innerhalb dieser Funktion können die Daten des Cue bearbeitet werden, so dass individuell programmierbare Effekte möglich sind.
			Die Funktion besitzt die folgende Signatur:

			'''Function EditCue(DeviceType, Cue, ClickedLine, DMXDevice)'''
			Die Parameter haben die folgende Bedeutung:
			; DeviceType
			: Typ String - Typ des angesprochenen Geräts
			; Cue
			: Typ Cue - Der entsprechende Cue für welchen der Effekt bearbeitet werden soll
			; ClickedLine
			: Typ Integer - Der Index der Zeile bzw. der Position des Cues welche bearbeitet werden soll
			; DMXDevice
			: Typ DMXDevice - Das DMX-Gerät für welches die Einstellung vorgenommen werden soll

			{{Achtung\|Hier fehlen Informationen zur GUI-Programmierung}}

			== Das Container-Objekt ==
			Das Container-Objekt steht dem Gerätescript global zur Verfügung um diverse Funktionen direkt anzusprechen. Hierzu gehören Funktionen zum Speichern von Cue-Daten und auch Funktionen um Eingabeformulare etc anzeigen zu können. Folgende Funktionen sind hier definiert:

			; Sub SetGlobalSetting(ItemName As String, Value As String)
			: Über diese Funktion können globale Einstellungen für das Gerätescript abgelegt werden. Der Speicher fungiert als Key-Value-Speicher für Strings. Über den Parameter ItemName wird der Schlüssel festgelegt unter welchem der als Value bezeichnete Parameter abgelegt wird.
			; Function GetGlobalSetting(ItemName As String, Optional DefaultValue As String)
			: Diese Funktion ruft einen vorher per SetGlobalSetting gespeicherten Wert ab. Optional kann ein zweiter Parameter angegeben werden welcher zurückgegeben wird wenn die Einstellung vorher nie gespeichert wurde. In einem solchen Fall wird, sofern der ''DefaultValue''-Parameter nicht angegeben wurde, ein leerer String zurück gegeben.
			; Sub SetCueSetting(ItemName As String, Value As String, Optional Index As Integer = 0)
			: Speichert eine Eigenschaft für den aktuellen Cue sofern sie aus einer Funktion mit "Cue"-Parameter aufgerufen wurde. Der Speicher fungiert als Key-Value-Speicher für Strings. Über den Parameter ItemName wird der Schlüssel festgelegt unter welchem der als Value bezeichnete Parameter abgelegt wird. Der Parameter Index kann optional verwendet werden wenn pro Zeile/Position (Funktionsparameter Index) unterschiedliche Informationen abgelegt werden sollen.
			; Function GetCueSetting(ItemName As String, Optional DefaultValue As String, Optional Index As Integer = 0)
			: Diese Funktion ruft einen vorher per SetCueSetting gespeicherten Wert ab. Sie kann aus einer Funktion aufgerufen werden welche einen Cue-Parameter besitzt. Optional kann ein zweiter Parameter angegeben werden welcher zurückgegeben wird wenn die Einstellung vorher nie gespeichert wurde. In einem solchen Fall wird, sofern der ''DefaultValue''-Parameter nicht angegeben wurde, ein leerer String zurück gegeben. Der dritte, optionale Parameter Index kann verwendet werden wenn unterschiedliche Einstellungen für jede Position des Cues abgelegt werden sollen.
			; Function IsCueAngleSet(LeftAngle As Integer, RightAngle As Integer, Optional Index As Integer = 0) As Boolean
			: Diese Funktion prüft ob ein Cue an einer bestimmten Position für einen bestimmten Winkel eingetragen ist. Sie kann aus einer Funktion aufgerufen werden welche einen Cue-Parameter besitzt. Die Angaben '''LeftAngle''' und '''RightAngle''' geben als Abweichung von der Senkrechten den Suchbereich an (nach links: negativ, nach recht: positiv). Die Funktion gibt ''True'' zurück, wenn im angegebenen Bereich ein Winkel gesetzt ist. Der optionale Parameter ''Index'' gibt an welche Position des Cues durchsucht werden soll.
			; Function GetNewForm(Optional Caption As String = "Window") As Form
			: Diese Funktion gibt ein neues GUI-Fenster mit dem angegeben Titel zurück. Das zurückgegebene Fenster-Objekt kann benutzt werden, um dem Benutzer eine grafische Konfigurationsmöglichkeit für den Effekt anzubieten (siehe unten).
			; Sub CloseAllWindows()
			: Schließt alle noch offenen vom Script geöffneten Fenster

			=== Das Form-Objekt ===
			Das Form-Objekt ermöglicht es, innerhalb einer ''EditCue''-Funktion eine grafische Eingabemöglichkeit zur Verfügung zu stellen.

Admin: /* Datenübertragung in Cues */

2015-09-08T13:41:08Z

Datenübertragung in Cues

← Nächstältere Version		Version vom 8. September 2015, 13:41 Uhr
Zeile 213:		Zeile 213:
	== Datenübertragung in Cues ==		== Datenübertragung in Cues ==
	Um die Benutzungsfreundlichkeit zu steigern, sollten einige Basisdaten bereits auf einen Cue übertragen werden wenn das entsprechende DMX-Gerät ausgewählt wird. Hierfür sollten Standarddaten verwendet werden, die ohne eine weitere Bearbeitung des Cues zur Anwendung kommen würden. Im nachfolgenden Beispiel wird zumindest die Länge der Vorbereitungsphase angegeben (entsprechend der Aufstiegzeit bei einem pyrotechnischen Effekt) welche in jedem Fall und grundsätzlich '''vor''' einem Export von DMX-Daten korrekt angegeben sein muss.		Um die Benutzungsfreundlichkeit zu steigern, sollten einige Basisdaten bereits auf einen Cue übertragen werden wenn das entsprechende DMX-Gerät ausgewählt wird. Hierfür sollten Standarddaten verwendet werden, die ohne eine weitere Bearbeitung des Cues zur Anwendung kommen würden. Im nachfolgenden Beispiel wird zumindest die Länge der Vorbereitungsphase angegeben (entsprechend der Aufstiegzeit bei einem pyrotechnischen Effekt) welche in jedem Fall und grundsätzlich '''vor''' einem Export von DMX-Daten korrekt angegeben sein muss.

			Definition der Routine:
			'''Sub AdjustCueData(Cue, DMXDevice)'''
			; Cue
			: Typ Cue - Der anzupassende Cue
			; DMXDevice
			: Typ DMXDevice - Die Gerätedefinition des DMX-Geräts

	<pre>		<pre>

Admin: /* Datenübertragung in Cues */

2015-09-08T13:39:57Z

Datenübertragung in Cues

← Nächstältere Version		Version vom 8. September 2015, 13:39 Uhr
Zeile 214:		Zeile 214:
	Um die Benutzungsfreundlichkeit zu steigern, sollten einige Basisdaten bereits auf einen Cue übertragen werden wenn das entsprechende DMX-Gerät ausgewählt wird. Hierfür sollten Standarddaten verwendet werden, die ohne eine weitere Bearbeitung des Cues zur Anwendung kommen würden. Im nachfolgenden Beispiel wird zumindest die Länge der Vorbereitungsphase angegeben (entsprechend der Aufstiegzeit bei einem pyrotechnischen Effekt) welche in jedem Fall und grundsätzlich '''vor''' einem Export von DMX-Daten korrekt angegeben sein muss.		Um die Benutzungsfreundlichkeit zu steigern, sollten einige Basisdaten bereits auf einen Cue übertragen werden wenn das entsprechende DMX-Gerät ausgewählt wird. Hierfür sollten Standarddaten verwendet werden, die ohne eine weitere Bearbeitung des Cues zur Anwendung kommen würden. Im nachfolgenden Beispiel wird zumindest die Länge der Vorbereitungsphase angegeben (entsprechend der Aufstiegzeit bei einem pyrotechnischen Effekt) welche in jedem Fall und grundsätzlich '''vor''' einem Export von DMX-Daten korrekt angegeben sein muss.

			<pre>
	Sub AdjustCueData(Cue, DMXDevice)		Sub AdjustCueData(Cue, DMXDevice)
	Cue.DelayTimeMs = 300		Cue.DelayTimeMs = 300
	End Sub		End Sub
			</pre>

Admin: /* Erzeugung von Cue-Sequenzen */

2015-09-08T13:37:56Z

Erzeugung von Cue-Sequenzen

← Nächstältere Version		Version vom 8. September 2015, 13:37 Uhr
Zeile 210:		Zeile 210:
	End Function		End Function
	</pre>		</pre>

			== Datenübertragung in Cues ==
			Um die Benutzungsfreundlichkeit zu steigern, sollten einige Basisdaten bereits auf einen Cue übertragen werden wenn das entsprechende DMX-Gerät ausgewählt wird. Hierfür sollten Standarddaten verwendet werden, die ohne eine weitere Bearbeitung des Cues zur Anwendung kommen würden. Im nachfolgenden Beispiel wird zumindest die Länge der Vorbereitungsphase angegeben (entsprechend der Aufstiegzeit bei einem pyrotechnischen Effekt) welche in jedem Fall und grundsätzlich '''vor''' einem Export von DMX-Daten korrekt angegeben sein muss.

			Sub AdjustCueData(Cue, DMXDevice)
			Cue.DelayTimeMs = 300
			End Sub

Admin: /* Erzeugung von Cue-Sequenzen */

2015-09-08T10:41:42Z

Erzeugung von Cue-Sequenzen

← Nächstältere Version		Version vom 8. September 2015, 10:41 Uhr
Zeile 189:		Zeile 189:
	; EndOfRange		; EndOfRange
	: Typ Long ('''nur lesbar''') - Ende der Effektzeit (zu diesem Zeitpunkt wird der Effekt für den Zuschauer unsichtbar)		: Typ Long ('''nur lesbar''') - Ende der Effektzeit (zu diesem Zeitpunkt wird der Effekt für den Zuschauer unsichtbar)

			Beispiel für die Verwendung innerhalb einer ''CompileCueChannelSequence''-Funktion:
			<pre>
			Function CompileCueChannelSequence(BaseTime, DeviceType, SequenceNumber, DMXSequences, UID, Cue, Index, DMXDevice)
			With DMXSequences.GetOrAdd(SequenceNumber) 'Korrekte DMX-Sequenz holen
			Select Case LCase(DeviceType) 'Je nachdem für welches Gerät wir laufen
			Case "id" 'Wir haben nur das Gerät "id" in dieser Datei eingebaut
			If BaseTime + Cue.StartOfRange >= 0 Then 'Prüfen ob so eine Auslösung überhaupt zeitlich funktioniert
			.AddDMXEvent BaseTime + Cue.StartOfRange, DMXDevice.StartAddress + 3, 255, MODE_HTP, UID 'Sicherheitskanal 50ms vorher ansteuern
			.AddDMXEvent BaseTime + Cue.ExplodeTimeMs, DMXDevice.StartAddress + 1, 255, MODE_HTP, UID 'Zündkanal genau zur Zündzeit ansteuern
			.AddDMXEvent BaseTime + Cue.EndOfRange, DMXDevice.StartAddress + 1, 0, MODE_LTP, UID 'Zündkanal genau zum Ende der Effektzeit wieder auf 0 fahren
			.AddDMXEvent BaseTime + Cue.EndOfRange, DMXDevice.StartAddress + 3, 0, MODE_LTP, UID 'Sicherheitskanal zur gleichen Zeit schließen
			CompileCueChannelSequence = True 'Erfolg vermelden
			Else
			CompileCueChannelSequence = False 'So ist leider keine Zündung möglich..
			Exit Function
			End If
			End Select
			End With
			End Function
			</pre>

Admin: /* Erzeugung von Cue-Sequenzen */

2015-09-08T10:31:32Z

Erzeugung von Cue-Sequenzen

← Nächstältere Version		Version vom 8. September 2015, 10:31 Uhr
Zeile 141:		Zeile 141:
	Die eigentlichen Effekte werden mithilfe der Funktion ''CompileCueChannelSequence'' aufgerufen, welche die folgende Definition hat:		Die eigentlichen Effekte werden mithilfe der Funktion ''CompileCueChannelSequence'' aufgerufen, welche die folgende Definition hat:

	'''Function CompileCueChannelSequence(DeviceType, SequenceNumber, DMXSequences, UID, Cue, Index, DMXDevice)'''		'''Function CompileCueChannelSequence(BaseTime, DeviceType, SequenceNumber, DMXSequences, UID, Cue, Index, DMXDevice)'''
			; BaseTime
			: Typ Long - Die Basiszeit der Sequenz. Diese Zeit muss zu allen Effektzeiten addiert werden und gibt einen eventuellen Offset einer Sequenz an.
	; DeviceType		; DeviceType
	: Typ String - Der Typ des DMX-Geräts mit dem wir arbeiten		: Typ String - Der Typ des DMX-Geräts mit dem wir arbeiten