Deutsches DMXC-Wiki - Benutzerbeiträge [de]

PDA-Fernsteuerung DMXC2

2013-07-22T11:55:04Z

Wdunczewski: /* GetCommandPossibilities und RunCommand */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Figureneditor_DMXC2
|zurückText = Figureneditor
|vorLink = Tastatursteuerung_DMXC2
|vorText = Tastatursteuerung
}}
{{Start-LaTeX}}
==Überblick==
Die PDA-Fernbedienung hat sich aus der Terminal-Schnittstelle von DMXControl über die Serielle-Fernbedienung weiterentwickelt. Durch die « PDA Fernbedienung » lässt sich DMXControl mit PDA und anderen seriellen Schnittstellen (Telnet, COM-Schnittstelle, Bluetooth oder über WLAN) steuern.

{{ BoxWichtig| Text=Das Fenster der PDA-Fernbedienung muss, wie bei allen anderen Fernbedienungen/Steuerungen in DMXControl, offen bleiben. Bei geschlossenen Fenster findet keine Kommunikation statt.}}

==Beschreibung==
Die « Serielle Fernbedienung » wurde in DMXControl implementiert, um den Zugriff über serielle Schnittstelle oder Netzwerk (Ethernet) auf das Programm zu ermöglichen. Im Netwerk erwartet DMXControl eine Verbindung auf Port 2145. Dieser Port kann im Fenster der « PDA-Fernsteuerung » geändert werden. Jedes Programm, das Zeichenketten (Strings) verschicken kann, ist damit in der Lage, DMXControl fernzusteuern.
Die « Serielle Fernbedienung » wird unter anderem von der PDA-Steuerung [[PDA-2-DMXC]] und vom Web-Interface bzw. der PHP-Klasse sowie verschiedener anderer Steuerungen (bspw für Android) verwendet.
Da das Protokoll der Schnittstelle offen ist, ist es für jeden möglich, über ein eigenes Programm auf DMXControl zuzugreifen.

Die Schnittstelle funktioniert bidirektional, d.h. es können Daten gesendet und angefragt werden. Eine Tabelle der möglichen Befehle ist weiter unten zu finden. Manche Befehle liefern nach dem Ausführen einen Wert als Bestätigung zurück, andere nicht.

Jeder Befehl der an DMXControl gesendet wird, muss mit einem Zeilenumbruch (in Java und C# "\n") abgeschlossen werden.

== Schnittstelle ==
In der folgende Tabelle ist eine Liste der Befehle und Antworten von DMXControl aufgeführt. Entwickler, die ein externes Programm zur Steuerung von DMXControl schreiben möchten, können erste Erfahrungen am besten mit einem Terminalprogramm wie Telnet oder Putty machen. Am lokalen Arbeitsplatz geht das mit dem Befehl: '''telnet 127.0.0.1 2145'''. Dann erkennt man sofort, wie die Antworten aussehen. Alle Befehle werden von DMXControl unabhängig von Groß / Kleinschreibung interpretiert.

{{ BoxHinweis
| Text=Anstelle von '''SetChannel''' kann also auch '''sEtChAnNeL''' geschrieben werden.
}}

Die Abkürzung '''CV''' steht für '''ChannelValue''' und '''CVC''' für '''ChannelValueChanged'''

{|cellpadding="5" cellspacing="0" border="1"
|'''Anfrage an DMXC'''
|'''Antwort von DMXC'''
|'''Beschreibung'''
|'''Beispiel'''
|- style="vertical-align:top;"
|SetChannel ''Channel Wert''
|CV ''Channel Wert''
|Setzt den Kanal '''''Channel''''' auf den Wert '''''Wert'''''.
|'''SetChannel 1 200''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|SC ''Channel Wert''
|CV ''Channel Wert''
|Kurzschreibweise für SetChannel.
|'''SC 1 200''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GetChannel ''Channel''
|CV ''Channel Wert''
|Fragt den Wert des Kanals '''''Channel''''' an.
|'''GetChannel 1''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GC ''Channel''
|CV ''Channel Wert''
|Kurzschreibweise für GetChannel.
|'''GC 1''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GetAllDevices
|''Liste der Geräte''
|Fragt alle in DMXControl vorhandenen Geräte ab.
|'''GetAllDevices''' ->
'''1. PAR-1'''
'''2. PAR-2'''
'''...'''
'''10. Botex SP-1500 Stroboskop'''
|- style="vertical-align:top;"
|GetDeviceInfo ''DeviceID''
|''Geräteinformationen''
|Fragt genauere Informationen zum Gerät mit der Nummer '''''DeviceID''''' ab. Dabei existieren für PanTilt drei Möglichkeiten: '''No, Coarse, Fine'''. Bei Coarse oder Fine folgen die Kanäle von Pan Tilt, bei einem Scanner also: '''''PanTilt: Coarse 0 1''''' bei einem 16 bit Scanner '''''PanTilt: Fine 0 1 14 15'''''. Die Reihenfolge ist dabei '''Pan Tilt PanFine TiltFine'''. Nach '''''Channels: Anzahl''''' wird eine Liste mit allen Namen der Kanäle angehängt, wie sie im DDF hinterlegt sind.
|'''GetDeviceInfo 10''' ->
'''Name: Botex SP-1500 Stroboskop'''
'''StartAddress: 257'''
'''PanTilt: No'''
'''Channels: 2'''
'''Channel1: Frequenz'''
'''Channel2: Helligkeit'''
|- style="vertical-align:top;"
|StartChannelNotification ''StartChannel EndChannel''
|Keine
|Aktiviert die Asynchrone Information über Kanaländerungen. Wenn sich in DMXControl ein Kanal zwischen '''''StartChannel''''' und '''''EndChannel''''' ändert, sendet DMXControl eine Nachricht mit dem neuen Wert. Ein weiteres senden von StartChannelNotification überschreibt den alten Bereich.
|'''StartChannelNotification 1 10'''. Nach Wertänderung von Kanal 5 auf 255: -> '''CVC 5 255'''
|- style="vertical-align:top;"
|StopChannelNotification
|Keine
|Deaktiviert die Benachrichtigung über Kanaländerungen.
|'''StopChannelNotification'''
|- style="vertical-align:top;"
|GetCommandPossibilities ''Dropdown-Index Vorgänger-Index''
|''Liste der Möglichkeiten''
|Ein Befehl setzt sich aus einzelnen Teilen zusammen. ''Modul'', ''Gerät/Funktion'', ''Kanal'', ''...''. Da die folgende Auswahl auf der vorhergehenden basiert, muss der Reihe nach von vorne abgefragt werden. Mit ''GetCommandPossibilities 1'' erhält man eine Liste der Modulmöglichkeiten. Jede Möglichkeit hat eine ID. Mit ''GetCommandPossibilities 2 3'' erhält man die Auswahl für Gerät/Funktion, auf Basis von Modul 3.
|'''GetCommandPossibilities 1''' ->
'''1. Deaktiviert'''
'''2. Audio'''
'''3. Audiotrack'''
'''...'''
|- style="vertical-align:top;"
|RunCommand ''Index1 Index2 Index3 Flags Value''
|Keine
|Mit diesem Command führt man den Befehl aus. '''''Index1, Index2''''' und '''''Index3''''' sind dabei die Indizes von GetCommandPossibilities.
'''''Flags''''' ist ein binär codierter Integer. Bit 0 steht für ''Umschalt-Modus'' und Bit 1 für ''Angegebenen Wert verwenden''. '''''Value''''' ist ein DMX-Wert in Prozent von 0.000 bis 100.000 (für zukünftige 16Bit Werte).
|'''RunCommand 2 5 3 0 0.000'''
|}
 

== GetCommandPossibilities und RunCommand ==
Um einen spezifischen Befehl mit '''RunCommand''' auszuführen, muss man wissen, welche ID der Befehl besitzt. Diese ID kann man mit dem Aufruf '''GetCommandPossibilities''' sehr einfach herausfinden. Man arbeitet sich dabei Schritt für Schritt von der obersten Ebene (1) bis zur benötigten Ebene (z.B. 3) herab. Die erste Ziffer hinter dem Aufruf stellt die Ebene dar, auf der man sich gerade befindet. Die folgenden Ziffern stehen für die IDs der Ergebnisse der Abfragen der vorherigen Ebenen. Daher ist es sehr wichtig, dass die Ebenen der Reihe nach durchlaufen werden.
 
Um z.B. einen Effekt auf diese Weise zu starten, könnte dies wie folgt aussehen: Ein Aufruf des Befehls '''GetCommandPossibilities 1''' liefert die folgende Tabelle, wobei es hier keine zweite Ziffer gibt, da wir uns auf der höchsten Ebene (Ebene 1) befinden.
Installierte Plugins reihen sich in die Liste ein, wenn vorhanden.

1. Deaktiviert
2. Audio
3. Audiotrack
4. BeatTool
5. DMX-Ausgabe
6. DMXIn-Remote
'''7. Effekte'''
8. External Action (Plugin)
9. Geräte
10. Gruppenauswahl
11. Joystick
12. KommandoBox
13. Kommandozeile
14. Master
15. MIDI-Remote
16. OSC-Receiver (PLugin)
17. Sound Analyzer
18. Submaster
19. Szenenbibliothek
20. Szenenliste
21. Textbuch

Nun fragen wir die Optionen für die '''ID 7 Effekte''' für die Ebene '''2''' ab: '''GetCommandPossibilities 2 7''' liefert uns die ID, der Optionen, auf die zugegriffen werden kann. Auswahl und Sprünge der Effekte wäre in diesem Fall über die IDs 1-4 möglich. Die selbst programmieten Effekte haben die IDs ab 6:

1. Alle
2. Ausgewählter
3. Nächster
4. Vorheriger
5. ----
'''6. [EFFEKT 1]'''
7. [EFFEKT 2]
8. [EFFEKT 3]
9. ...

Der nun folgende Aufruf für die 3. Ebene '''GetCommandPossibilities 3 6''' zeigt in unserem Beispiel ''[Effekt 1]'' die für diesen Effekt möglichen Funktionen. DMXControl gibt folgende Liste zurück:

1. Auswählen
2. Start/Stop
'''3. Start'''
4. Stop
5. Beschl. setzen
6. Intens. setzen
7. Nächster Schritt
8. Wiederh. ein/aus

Mit '''RunCommand 7 6 3''' lässt sich der Effekt 1 starten oder mit '''RunCommand 7 6 4''' stoppen. Für den Effekt 3 wären das die Aufrufe '''RunCommand 7 8 3''' und '''RunCommand 7 8 4'''. Wenn noch Werte mit übertragen werden müssen, werden diese hinten angehängt: '''RunCommand 7 6 3 0 0.000'''. Andere Aufrufe funktionieren nach dem selben Prinzip.

{{ BoxHinweis
| Text=Evtl. hilft es beim Verständnis sich die Programmierung der Kommandobox anzusehen. Die Spalten bei der Buttonprogrammierung '''Modul''', '''Gerät/Funktion''', '''Kanal''', '''Flags''' und '''Wert''' entsprechen den Ebenen, IDs und Werten des '''RunCommand'''-Befehls.
}}

== Links und Referenzen==
Links
#PDA-Fernbedienung Software: http://www.dmxcontrol.de/files/pda-2-dmxc/PDA-2-DMXC_1.0_Setup.exe

Tutorials
#[[PDA-2-DMXC|PDA-2-DMXC Tutorial]]
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Figureneditor_DMXC2
|zurückText = Figureneditor
|vorLink = Tastatursteuerung_DMXC2
|vorText = Tastatursteuerung
}}

[[Kategorie: DMXControl 2]]

PDA-Fernsteuerung DMXC2

2013-07-22T11:53:50Z

Wdunczewski: /* GetCommandPossibilities und RunCommand */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Figureneditor_DMXC2
|zurückText = Figureneditor
|vorLink = Tastatursteuerung_DMXC2
|vorText = Tastatursteuerung
}}
{{Start-LaTeX}}
==Überblick==
Die PDA-Fernbedienung hat sich aus der Terminal-Schnittstelle von DMXControl über die Serielle-Fernbedienung weiterentwickelt. Durch die « PDA Fernbedienung » lässt sich DMXControl mit PDA und anderen seriellen Schnittstellen (Telnet, COM-Schnittstelle, Bluetooth oder über WLAN) steuern.

{{ BoxWichtig| Text=Das Fenster der PDA-Fernbedienung muss, wie bei allen anderen Fernbedienungen/Steuerungen in DMXControl, offen bleiben. Bei geschlossenen Fenster findet keine Kommunikation statt.}}

==Beschreibung==
Die « Serielle Fernbedienung » wurde in DMXControl implementiert, um den Zugriff über serielle Schnittstelle oder Netzwerk (Ethernet) auf das Programm zu ermöglichen. Im Netwerk erwartet DMXControl eine Verbindung auf Port 2145. Dieser Port kann im Fenster der « PDA-Fernsteuerung » geändert werden. Jedes Programm, das Zeichenketten (Strings) verschicken kann, ist damit in der Lage, DMXControl fernzusteuern.
Die « Serielle Fernbedienung » wird unter anderem von der PDA-Steuerung [[PDA-2-DMXC]] und vom Web-Interface bzw. der PHP-Klasse sowie verschiedener anderer Steuerungen (bspw für Android) verwendet.
Da das Protokoll der Schnittstelle offen ist, ist es für jeden möglich, über ein eigenes Programm auf DMXControl zuzugreifen.

Die Schnittstelle funktioniert bidirektional, d.h. es können Daten gesendet und angefragt werden. Eine Tabelle der möglichen Befehle ist weiter unten zu finden. Manche Befehle liefern nach dem Ausführen einen Wert als Bestätigung zurück, andere nicht.

Jeder Befehl der an DMXControl gesendet wird, muss mit einem Zeilenumbruch (in Java und C# "\n") abgeschlossen werden.

== Schnittstelle ==
In der folgende Tabelle ist eine Liste der Befehle und Antworten von DMXControl aufgeführt. Entwickler, die ein externes Programm zur Steuerung von DMXControl schreiben möchten, können erste Erfahrungen am besten mit einem Terminalprogramm wie Telnet oder Putty machen. Am lokalen Arbeitsplatz geht das mit dem Befehl: '''telnet 127.0.0.1 2145'''. Dann erkennt man sofort, wie die Antworten aussehen. Alle Befehle werden von DMXControl unabhängig von Groß / Kleinschreibung interpretiert.

{{ BoxHinweis
| Text=Anstelle von '''SetChannel''' kann also auch '''sEtChAnNeL''' geschrieben werden.
}}

Die Abkürzung '''CV''' steht für '''ChannelValue''' und '''CVC''' für '''ChannelValueChanged'''

{|cellpadding="5" cellspacing="0" border="1"
|'''Anfrage an DMXC'''
|'''Antwort von DMXC'''
|'''Beschreibung'''
|'''Beispiel'''
|- style="vertical-align:top;"
|SetChannel ''Channel Wert''
|CV ''Channel Wert''
|Setzt den Kanal '''''Channel''''' auf den Wert '''''Wert'''''.
|'''SetChannel 1 200''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|SC ''Channel Wert''
|CV ''Channel Wert''
|Kurzschreibweise für SetChannel.
|'''SC 1 200''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GetChannel ''Channel''
|CV ''Channel Wert''
|Fragt den Wert des Kanals '''''Channel''''' an.
|'''GetChannel 1''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GC ''Channel''
|CV ''Channel Wert''
|Kurzschreibweise für GetChannel.
|'''GC 1''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GetAllDevices
|''Liste der Geräte''
|Fragt alle in DMXControl vorhandenen Geräte ab.
|'''GetAllDevices''' ->
'''1. PAR-1'''
'''2. PAR-2'''
'''...'''
'''10. Botex SP-1500 Stroboskop'''
|- style="vertical-align:top;"
|GetDeviceInfo ''DeviceID''
|''Geräteinformationen''
|Fragt genauere Informationen zum Gerät mit der Nummer '''''DeviceID''''' ab. Dabei existieren für PanTilt drei Möglichkeiten: '''No, Coarse, Fine'''. Bei Coarse oder Fine folgen die Kanäle von Pan Tilt, bei einem Scanner also: '''''PanTilt: Coarse 0 1''''' bei einem 16 bit Scanner '''''PanTilt: Fine 0 1 14 15'''''. Die Reihenfolge ist dabei '''Pan Tilt PanFine TiltFine'''. Nach '''''Channels: Anzahl''''' wird eine Liste mit allen Namen der Kanäle angehängt, wie sie im DDF hinterlegt sind.
|'''GetDeviceInfo 10''' ->
'''Name: Botex SP-1500 Stroboskop'''
'''StartAddress: 257'''
'''PanTilt: No'''
'''Channels: 2'''
'''Channel1: Frequenz'''
'''Channel2: Helligkeit'''
|- style="vertical-align:top;"
|StartChannelNotification ''StartChannel EndChannel''
|Keine
|Aktiviert die Asynchrone Information über Kanaländerungen. Wenn sich in DMXControl ein Kanal zwischen '''''StartChannel''''' und '''''EndChannel''''' ändert, sendet DMXControl eine Nachricht mit dem neuen Wert. Ein weiteres senden von StartChannelNotification überschreibt den alten Bereich.
|'''StartChannelNotification 1 10'''. Nach Wertänderung von Kanal 5 auf 255: -> '''CVC 5 255'''
|- style="vertical-align:top;"
|StopChannelNotification
|Keine
|Deaktiviert die Benachrichtigung über Kanaländerungen.
|'''StopChannelNotification'''
|- style="vertical-align:top;"
|GetCommandPossibilities ''Dropdown-Index Vorgänger-Index''
|''Liste der Möglichkeiten''
|Ein Befehl setzt sich aus einzelnen Teilen zusammen. ''Modul'', ''Gerät/Funktion'', ''Kanal'', ''...''. Da die folgende Auswahl auf der vorhergehenden basiert, muss der Reihe nach von vorne abgefragt werden. Mit ''GetCommandPossibilities 1'' erhält man eine Liste der Modulmöglichkeiten. Jede Möglichkeit hat eine ID. Mit ''GetCommandPossibilities 2 3'' erhält man die Auswahl für Gerät/Funktion, auf Basis von Modul 3.
|'''GetCommandPossibilities 1''' ->
'''1. Deaktiviert'''
'''2. Audio'''
'''3. Audiotrack'''
'''...'''
|- style="vertical-align:top;"
|RunCommand ''Index1 Index2 Index3 Flags Value''
|Keine
|Mit diesem Command führt man den Befehl aus. '''''Index1, Index2''''' und '''''Index3''''' sind dabei die Indizes von GetCommandPossibilities.
'''''Flags''''' ist ein binär codierter Integer. Bit 0 steht für ''Umschalt-Modus'' und Bit 1 für ''Angegebenen Wert verwenden''. '''''Value''''' ist ein DMX-Wert in Prozent von 0.000 bis 100.000 (für zukünftige 16Bit Werte).
|'''RunCommand 2 5 3 0 0.000'''
|}
 

== GetCommandPossibilities und RunCommand ==
Um einen spezifischen Befehl mit '''RunCommand''' auszuführen, muss man wissen, welche ID der Befehl besitzt. Diese ID kann man mit dem Aufruf '''GetCommandPossibilities''' sehr einfach herausfinden. Man arbeitet sich dabei Schritt für Schritt von der obersten Ebene (1) bis zur benötigten Ebene (z.B. 3) herab. Die erste Ziffer hinter dem Aufruf stellt die Ebene dar, auf der man sich gerade befindet. Die folgenden Ziffern stehen für die IDs der Ergebnisse der Abfragen der vorherigen Ebenen. Daher ist es sehr wichtig, dass die Ebenen der Reihe nach durchlaufen werden.
 
Um z.B. einen Effekt auf diese Weise zu starten, könnte dies wie folgt aussehen: Ein Aufruf des Befehls '''GetCommandPossibilities 1''' liefert die folgende Tabelle, wobei es hier keine zweite Ziffer gibt, da wir uns auf der höchsten Ebene (Ebene 1) befinden.
Installierte Plugins reihen sich in die Liste ein, wenn vorhanden.

1. Deaktiviert
2. Audio
3. Audiotrack
4. BeatTool
5. DMX-Ausgabe
6. DMXIn-Remote
'''7. Effekte'''
8. External Action (Plugin)
9. Geräte
10. Gruppenauswahl
11. Joystick
12. KommandoBox
13. Kommandozeile
14. Master
15. MIDI-Remote
16. OSC-Receiver (PLugin)
17. Sound Analyzer
18. Submaster
19. Szenenbibliothek
20. Szenenliste
21. Textbuch

Nun fragen wir die Optionen für die '''ID 7 Effekte''' für die Ebene '''2''' ab: '''GetCommandPossibilities 2 7''' liefert uns die ID, der Optionen, auf die zugegriffen werden kann. Auswahl und Sprünge der Effekte wäre in diesem Fall über die IDs 1-4 möglich. Die selbst programmieten Effekte haben die IDs ab 6:

1. Alle
2. Ausgewählter
3. Nächster
4. Vorheriger
5. ----
'''6. [EFFEKT 1]'''
7. [EFFEKT 2]
8. [EFFEKT 3]
9. ...

Der nun folgende Aufruf für die 3. Ebene '''GetCommandPossibilities 3 6''' zeigt in unserem Beispiel ''[Effekt 1]'' die für diesen Effekt möglichen Funktionen. DMXControl gibt folgende Liste zurück:

1. Auswählen
2. Start/Stop
'''3. Start'''
4. Stop
5. Beschl. setzen
6. Intens. setzen
7. Nächster Schritt
8. Wiederh. ein/aus

Mit '''RunCommand 7 6 3''' lässt sich der Effekt 1 starten oder mit '''RunCommand 7 6 4''' stoppen. Für den Effekt 3 wären das die Aufrufe '''RunCommand 7 8 3''' und '''RunCommand 7 8 4'''. Wenn noch Werte mit übertragen werden müssen, werden diese hinten angehängt: '''RunCommand 7 6 3 0 0.000'''. Andere Aufrufe funktionieren nach dem selben Prinzip.

{{ BoxHinweis
| Text=Evtl. hilft es beim Verständnis sich die Programmierung der Kommandobox anzusehen. Die Spalten bei der Buttonprogrammierung '''Modul''', '''Gerät/Funktion''', '''Kanal''', '''Flags''' und '''Wert' entsprechen den Ebenen, IDs und Werten des '''RunCommand'''-Befehls.
}}

== Links und Referenzen==
Links
#PDA-Fernbedienung Software: http://www.dmxcontrol.de/files/pda-2-dmxc/PDA-2-DMXC_1.0_Setup.exe

Tutorials
#[[PDA-2-DMXC|PDA-2-DMXC Tutorial]]
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Figureneditor_DMXC2
|zurückText = Figureneditor
|vorLink = Tastatursteuerung_DMXC2
|vorText = Tastatursteuerung
}}

[[Kategorie: DMXControl 2]]

PDA-Fernsteuerung DMXC2

2013-07-22T11:52:36Z

Wdunczewski: /* GetCommandPossibilities und RunCommand */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Figureneditor_DMXC2
|zurückText = Figureneditor
|vorLink = Tastatursteuerung_DMXC2
|vorText = Tastatursteuerung
}}
{{Start-LaTeX}}
==Überblick==
Die PDA-Fernbedienung hat sich aus der Terminal-Schnittstelle von DMXControl über die Serielle-Fernbedienung weiterentwickelt. Durch die « PDA Fernbedienung » lässt sich DMXControl mit PDA und anderen seriellen Schnittstellen (Telnet, COM-Schnittstelle, Bluetooth oder über WLAN) steuern.

{{ BoxWichtig| Text=Das Fenster der PDA-Fernbedienung muss, wie bei allen anderen Fernbedienungen/Steuerungen in DMXControl, offen bleiben. Bei geschlossenen Fenster findet keine Kommunikation statt.}}

==Beschreibung==
Die « Serielle Fernbedienung » wurde in DMXControl implementiert, um den Zugriff über serielle Schnittstelle oder Netzwerk (Ethernet) auf das Programm zu ermöglichen. Im Netwerk erwartet DMXControl eine Verbindung auf Port 2145. Dieser Port kann im Fenster der « PDA-Fernsteuerung » geändert werden. Jedes Programm, das Zeichenketten (Strings) verschicken kann, ist damit in der Lage, DMXControl fernzusteuern.
Die « Serielle Fernbedienung » wird unter anderem von der PDA-Steuerung [[PDA-2-DMXC]] und vom Web-Interface bzw. der PHP-Klasse sowie verschiedener anderer Steuerungen (bspw für Android) verwendet.
Da das Protokoll der Schnittstelle offen ist, ist es für jeden möglich, über ein eigenes Programm auf DMXControl zuzugreifen.

Die Schnittstelle funktioniert bidirektional, d.h. es können Daten gesendet und angefragt werden. Eine Tabelle der möglichen Befehle ist weiter unten zu finden. Manche Befehle liefern nach dem Ausführen einen Wert als Bestätigung zurück, andere nicht.

Jeder Befehl der an DMXControl gesendet wird, muss mit einem Zeilenumbruch (in Java und C# "\n") abgeschlossen werden.

== Schnittstelle ==
In der folgende Tabelle ist eine Liste der Befehle und Antworten von DMXControl aufgeführt. Entwickler, die ein externes Programm zur Steuerung von DMXControl schreiben möchten, können erste Erfahrungen am besten mit einem Terminalprogramm wie Telnet oder Putty machen. Am lokalen Arbeitsplatz geht das mit dem Befehl: '''telnet 127.0.0.1 2145'''. Dann erkennt man sofort, wie die Antworten aussehen. Alle Befehle werden von DMXControl unabhängig von Groß / Kleinschreibung interpretiert.

{{ BoxHinweis
| Text=Anstelle von '''SetChannel''' kann also auch '''sEtChAnNeL''' geschrieben werden.
}}

Die Abkürzung '''CV''' steht für '''ChannelValue''' und '''CVC''' für '''ChannelValueChanged'''

{|cellpadding="5" cellspacing="0" border="1"
|'''Anfrage an DMXC'''
|'''Antwort von DMXC'''
|'''Beschreibung'''
|'''Beispiel'''
|- style="vertical-align:top;"
|SetChannel ''Channel Wert''
|CV ''Channel Wert''
|Setzt den Kanal '''''Channel''''' auf den Wert '''''Wert'''''.
|'''SetChannel 1 200''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|SC ''Channel Wert''
|CV ''Channel Wert''
|Kurzschreibweise für SetChannel.
|'''SC 1 200''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GetChannel ''Channel''
|CV ''Channel Wert''
|Fragt den Wert des Kanals '''''Channel''''' an.
|'''GetChannel 1''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GC ''Channel''
|CV ''Channel Wert''
|Kurzschreibweise für GetChannel.
|'''GC 1''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GetAllDevices
|''Liste der Geräte''
|Fragt alle in DMXControl vorhandenen Geräte ab.
|'''GetAllDevices''' ->
'''1. PAR-1'''
'''2. PAR-2'''
'''...'''
'''10. Botex SP-1500 Stroboskop'''
|- style="vertical-align:top;"
|GetDeviceInfo ''DeviceID''
|''Geräteinformationen''
|Fragt genauere Informationen zum Gerät mit der Nummer '''''DeviceID''''' ab. Dabei existieren für PanTilt drei Möglichkeiten: '''No, Coarse, Fine'''. Bei Coarse oder Fine folgen die Kanäle von Pan Tilt, bei einem Scanner also: '''''PanTilt: Coarse 0 1''''' bei einem 16 bit Scanner '''''PanTilt: Fine 0 1 14 15'''''. Die Reihenfolge ist dabei '''Pan Tilt PanFine TiltFine'''. Nach '''''Channels: Anzahl''''' wird eine Liste mit allen Namen der Kanäle angehängt, wie sie im DDF hinterlegt sind.
|'''GetDeviceInfo 10''' ->
'''Name: Botex SP-1500 Stroboskop'''
'''StartAddress: 257'''
'''PanTilt: No'''
'''Channels: 2'''
'''Channel1: Frequenz'''
'''Channel2: Helligkeit'''
|- style="vertical-align:top;"
|StartChannelNotification ''StartChannel EndChannel''
|Keine
|Aktiviert die Asynchrone Information über Kanaländerungen. Wenn sich in DMXControl ein Kanal zwischen '''''StartChannel''''' und '''''EndChannel''''' ändert, sendet DMXControl eine Nachricht mit dem neuen Wert. Ein weiteres senden von StartChannelNotification überschreibt den alten Bereich.
|'''StartChannelNotification 1 10'''. Nach Wertänderung von Kanal 5 auf 255: -> '''CVC 5 255'''
|- style="vertical-align:top;"
|StopChannelNotification
|Keine
|Deaktiviert die Benachrichtigung über Kanaländerungen.
|'''StopChannelNotification'''
|- style="vertical-align:top;"
|GetCommandPossibilities ''Dropdown-Index Vorgänger-Index''
|''Liste der Möglichkeiten''
|Ein Befehl setzt sich aus einzelnen Teilen zusammen. ''Modul'', ''Gerät/Funktion'', ''Kanal'', ''...''. Da die folgende Auswahl auf der vorhergehenden basiert, muss der Reihe nach von vorne abgefragt werden. Mit ''GetCommandPossibilities 1'' erhält man eine Liste der Modulmöglichkeiten. Jede Möglichkeit hat eine ID. Mit ''GetCommandPossibilities 2 3'' erhält man die Auswahl für Gerät/Funktion, auf Basis von Modul 3.
|'''GetCommandPossibilities 1''' ->
'''1. Deaktiviert'''
'''2. Audio'''
'''3. Audiotrack'''
'''...'''
|- style="vertical-align:top;"
|RunCommand ''Index1 Index2 Index3 Flags Value''
|Keine
|Mit diesem Command führt man den Befehl aus. '''''Index1, Index2''''' und '''''Index3''''' sind dabei die Indizes von GetCommandPossibilities.
'''''Flags''''' ist ein binär codierter Integer. Bit 0 steht für ''Umschalt-Modus'' und Bit 1 für ''Angegebenen Wert verwenden''. '''''Value''''' ist ein DMX-Wert in Prozent von 0.000 bis 100.000 (für zukünftige 16Bit Werte).
|'''RunCommand 2 5 3 0 0.000'''
|}
 

== GetCommandPossibilities und RunCommand ==
Um einen spezifischen Befehl mit '''RunCommand''' auszuführen, muss man wissen, welche ID der Befehl besitzt. Diese ID kann man mit dem Aufruf '''GetCommandPossibilities''' sehr einfach herausfinden. Man arbeitet sich dabei Schritt für Schritt von der obersten Ebene (1) bis zur benötigten Ebene (z.B. 3) herab. Die erste Ziffer hinter dem Aufruf stellt die Ebene dar, auf der man sich gerade befindet. Die folgenden Ziffern stehen für die IDs der Ergebnisse der Abfragen der vorherigen Ebenen. Daher ist es sehr wichtig, dass die Ebenen der Reihe nach durchlaufen werden.
 
Um z.B. einen Effekt auf diese Weise zu starten, könnte dies wie folgt aussehen: Ein Aufruf des Befehls '''GetCommandPossibilities 1''' liefert die folgende Tabelle, wobei es hier keine zweite Ziffer gibt, da wir uns auf der höchsten Ebene (Ebene 1) befinden.
Installierte Plugins reihen sich in die Liste ein, wenn vorhanden.

1. Deaktiviert
2. Audio
3. Audiotrack
4. BeatTool
5. DMX-Ausgabe
6. DMXIn-Remote
'''7. Effekte'''
8. External Action (Plugin)
9. Geräte
10. Gruppenauswahl
11. Joystick
12. KommandoBox
13. Kommandozeile
14. Master
15. MIDI-Remote
16. OSC-Receiver (PLugin)
17. Sound Analyzer
18. Submaster
19. Szenenbibliothek
20. Szenenliste
21. Textbuch

Nun fragen wir die Optionen für die '''ID 7 Effekte''' für die Ebene '''2''' ab: '''GetCommandPossibilities 2 7''' liefert uns die ID, der Optionen, auf die zugegriffen werden kann. Auswahl und Sprünge der Effekte wäre in diesem Fall über die IDs 1-4 möglich. Die selbst programmieten Effekte haben die IDs ab 6:

1. Alle
2. Ausgewählter
3. Nächster
4. Vorheriger
5. ----
'''6. [EFFEKT 1]'''
7. [EFFEKT 2]
8. [EFFEKT 3]
9. ...

Der nun folgende Aufruf für die 3. Ebene '''GetCommandPossibilities 3 6''' zeigt in unserem Beispiel ''[Effekt 1]'' die für diesen Effekt möglichen Funktionen. DMXControl gibt folgende Liste zurück:

1. Auswählen
2. Start/Stop
'''3. Start'''
4. Stop
5. Beschl. setzen
6. Intens. setzen
7. Nächster Schritt
8. Wiederh. ein/aus

Mit '''RunCommand 7 6 3''' lässt sich der Effekt 1 starten oder mit '''RunCommand 7 6 4''' stoppen. Für den Effekt 3 wären das die Aufrufe '''RunCommand 7 8 3''' und '''RunCommand 7 8 4'''. Wenn noch Werte mit übertragen werden müssen, werden diese hinten angehängt '''RunCommand 7 6 3 0 0.000'''. Andere Aufrufe funktionieren nach dem selben Prinzip.

{{ BoxHinweis
| Text=Evtl. hilft es beim Verständnis sich die Programmierung der Kommandobox anzusehen. Die Spalten bei der Buttonprogrammierung '''Modul''', '''Gerät/Funktion''', '''Kanal''', '''Flags''' und '''Wert' entsprechen den Ebenen, IDs und Werten des '''RunCommand'''-Befehls.
}}

== Links und Referenzen==
Links
#PDA-Fernbedienung Software: http://www.dmxcontrol.de/files/pda-2-dmxc/PDA-2-DMXC_1.0_Setup.exe

Tutorials
#[[PDA-2-DMXC|PDA-2-DMXC Tutorial]]
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Figureneditor_DMXC2
|zurückText = Figureneditor
|vorLink = Tastatursteuerung_DMXC2
|vorText = Tastatursteuerung
}}

[[Kategorie: DMXControl 2]]

PDA-Fernsteuerung DMXC2

2013-07-22T11:45:15Z

Wdunczewski: /* GetCommandPossibilities und RunCommand */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Figureneditor_DMXC2
|zurückText = Figureneditor
|vorLink = Tastatursteuerung_DMXC2
|vorText = Tastatursteuerung
}}
{{Start-LaTeX}}
==Überblick==
Die PDA-Fernbedienung hat sich aus der Terminal-Schnittstelle von DMXControl über die Serielle-Fernbedienung weiterentwickelt. Durch die « PDA Fernbedienung » lässt sich DMXControl mit PDA und anderen seriellen Schnittstellen (Telnet, COM-Schnittstelle, Bluetooth oder über WLAN) steuern.

{{ BoxWichtig| Text=Das Fenster der PDA-Fernbedienung muss, wie bei allen anderen Fernbedienungen/Steuerungen in DMXControl, offen bleiben. Bei geschlossenen Fenster findet keine Kommunikation statt.}}

==Beschreibung==
Die « Serielle Fernbedienung » wurde in DMXControl implementiert, um den Zugriff über serielle Schnittstelle oder Netzwerk (Ethernet) auf das Programm zu ermöglichen. Im Netwerk erwartet DMXControl eine Verbindung auf Port 2145. Dieser Port kann im Fenster der « PDA-Fernsteuerung » geändert werden. Jedes Programm, das Zeichenketten (Strings) verschicken kann, ist damit in der Lage, DMXControl fernzusteuern.
Die « Serielle Fernbedienung » wird unter anderem von der PDA-Steuerung [[PDA-2-DMXC]] und vom Web-Interface bzw. der PHP-Klasse sowie verschiedener anderer Steuerungen (bspw für Android) verwendet.
Da das Protokoll der Schnittstelle offen ist, ist es für jeden möglich, über ein eigenes Programm auf DMXControl zuzugreifen.

Die Schnittstelle funktioniert bidirektional, d.h. es können Daten gesendet und angefragt werden. Eine Tabelle der möglichen Befehle ist weiter unten zu finden. Manche Befehle liefern nach dem Ausführen einen Wert als Bestätigung zurück, andere nicht.

Jeder Befehl der an DMXControl gesendet wird, muss mit einem Zeilenumbruch (in Java und C# "\n") abgeschlossen werden.

== Schnittstelle ==
In der folgende Tabelle ist eine Liste der Befehle und Antworten von DMXControl aufgeführt. Entwickler, die ein externes Programm zur Steuerung von DMXControl schreiben möchten, können erste Erfahrungen am besten mit einem Terminalprogramm wie Telnet oder Putty machen. Am lokalen Arbeitsplatz geht das mit dem Befehl: '''telnet 127.0.0.1 2145'''. Dann erkennt man sofort, wie die Antworten aussehen. Alle Befehle werden von DMXControl unabhängig von Groß / Kleinschreibung interpretiert.

{{ BoxHinweis
| Text=Anstelle von '''SetChannel''' kann also auch '''sEtChAnNeL''' geschrieben werden.
}}

Die Abkürzung '''CV''' steht für '''ChannelValue''' und '''CVC''' für '''ChannelValueChanged'''

{|cellpadding="5" cellspacing="0" border="1"
|'''Anfrage an DMXC'''
|'''Antwort von DMXC'''
|'''Beschreibung'''
|'''Beispiel'''
|- style="vertical-align:top;"
|SetChannel ''Channel Wert''
|CV ''Channel Wert''
|Setzt den Kanal '''''Channel''''' auf den Wert '''''Wert'''''.
|'''SetChannel 1 200''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|SC ''Channel Wert''
|CV ''Channel Wert''
|Kurzschreibweise für SetChannel.
|'''SC 1 200''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GetChannel ''Channel''
|CV ''Channel Wert''
|Fragt den Wert des Kanals '''''Channel''''' an.
|'''GetChannel 1''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GC ''Channel''
|CV ''Channel Wert''
|Kurzschreibweise für GetChannel.
|'''GC 1''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GetAllDevices
|''Liste der Geräte''
|Fragt alle in DMXControl vorhandenen Geräte ab.
|'''GetAllDevices''' ->
'''1. PAR-1'''
'''2. PAR-2'''
'''...'''
'''10. Botex SP-1500 Stroboskop'''
|- style="vertical-align:top;"
|GetDeviceInfo ''DeviceID''
|''Geräteinformationen''
|Fragt genauere Informationen zum Gerät mit der Nummer '''''DeviceID''''' ab. Dabei existieren für PanTilt drei Möglichkeiten: '''No, Coarse, Fine'''. Bei Coarse oder Fine folgen die Kanäle von Pan Tilt, bei einem Scanner also: '''''PanTilt: Coarse 0 1''''' bei einem 16 bit Scanner '''''PanTilt: Fine 0 1 14 15'''''. Die Reihenfolge ist dabei '''Pan Tilt PanFine TiltFine'''. Nach '''''Channels: Anzahl''''' wird eine Liste mit allen Namen der Kanäle angehängt, wie sie im DDF hinterlegt sind.
|'''GetDeviceInfo 10''' ->
'''Name: Botex SP-1500 Stroboskop'''
'''StartAddress: 257'''
'''PanTilt: No'''
'''Channels: 2'''
'''Channel1: Frequenz'''
'''Channel2: Helligkeit'''
|- style="vertical-align:top;"
|StartChannelNotification ''StartChannel EndChannel''
|Keine
|Aktiviert die Asynchrone Information über Kanaländerungen. Wenn sich in DMXControl ein Kanal zwischen '''''StartChannel''''' und '''''EndChannel''''' ändert, sendet DMXControl eine Nachricht mit dem neuen Wert. Ein weiteres senden von StartChannelNotification überschreibt den alten Bereich.
|'''StartChannelNotification 1 10'''. Nach Wertänderung von Kanal 5 auf 255: -> '''CVC 5 255'''
|- style="vertical-align:top;"
|StopChannelNotification
|Keine
|Deaktiviert die Benachrichtigung über Kanaländerungen.
|'''StopChannelNotification'''
|- style="vertical-align:top;"
|GetCommandPossibilities ''Dropdown-Index Vorgänger-Index''
|''Liste der Möglichkeiten''
|Ein Befehl setzt sich aus einzelnen Teilen zusammen. ''Modul'', ''Gerät/Funktion'', ''Kanal'', ''...''. Da die folgende Auswahl auf der vorhergehenden basiert, muss der Reihe nach von vorne abgefragt werden. Mit ''GetCommandPossibilities 1'' erhält man eine Liste der Modulmöglichkeiten. Jede Möglichkeit hat eine ID. Mit ''GetCommandPossibilities 2 3'' erhält man die Auswahl für Gerät/Funktion, auf Basis von Modul 3.
|'''GetCommandPossibilities 1''' ->
'''1. Deaktiviert'''
'''2. Audio'''
'''3. Audiotrack'''
'''...'''
|- style="vertical-align:top;"
|RunCommand ''Index1 Index2 Index3 Flags Value''
|Keine
|Mit diesem Command führt man den Befehl aus. '''''Index1, Index2''''' und '''''Index3''''' sind dabei die Indizes von GetCommandPossibilities.
'''''Flags''''' ist ein binär codierter Integer. Bit 0 steht für ''Umschalt-Modus'' und Bit 1 für ''Angegebenen Wert verwenden''. '''''Value''''' ist ein DMX-Wert in Prozent von 0.000 bis 100.000 (für zukünftige 16Bit Werte).
|'''RunCommand 2 5 3 0 0.000'''
|}
 

== GetCommandPossibilities und RunCommand ==
Um einen spezifischen Befehl mit '''RunCommand''' auszuführen, muss man wissen, welche ID der Befehl besitzt. Diese ID kann man mit dem Aufruf '''GetCommandPossibilities''' sehr einfach herausfinden. Man arbeitet sich dabei Schritt für Schritt von der obersten Ebene (1) bis zur benötigten Ebene (z.B. 3) herab. Die erste Ziffer hinter dem Aufruf stellt die Ebene dar, auf der man sich gerade befindet. Die folgenden Ziffern stehen für die IDs der Ergebnisse der Abfragen der vorherigen Ebenen. Daher ist es sehr wichtig, dass die Ebenen der Reihe nach durchlaufen werden.
 
Um z.B. einen Effekt auf diese Weise zu starten, könnte dies wie folgt aussehen: Ein Aufruf des Befehls '''GetCommandPossibilities 1''' liefert die folgende Tabelle, wobei es hier keine zweite Ziffer gibt, da wir uns auf der höchsten Ebene (Ebene 1) befinden.
Installierte Plugins reihen sich in die Liste ein, wenn vorhanden.

1. Deaktiviert
2. Audio
3. Audiotrack
4. BeatTool
5. DMX-Ausgabe
6. DMXIn-Remote
'''7. Effekte'''
8. External Action (Plugin)
9. Geräte
10. Gruppenauswahl
11. Joystick
12. KommandoBox
13. Kommandozeile
14. Master
15. MIDI-Remote
16. OSC-Receiver (PLugin)
17. Sound Analyzer
18. Submaster
19. Szenenbibliothek
20. Szenenliste
21. Textbuch

Nun fragen wir die Optionen für die '''ID 7 Effekte''' für die Ebene '''2''' ab: '''GetCommandPossibilities 2 7''' liefert uns die ID, der Optionen, auf die zugegriffen werden kann. Auswahl und Sprünge der Effekte wäre in diesem Fall über die IDs 1-4 möglich. Die selbst programmieten Effekte haben die IDs ab 6:

1. Alle
2. Ausgewählter
3. Nächster
4. Vorheriger
5. ----
6. [EFFEKT 1]
7. [EFFEKT 2]
8. [EFFEKT 3]
9. ...

Der nun folgende Aufruf für die 3. Ebene '''GetCommandPossibilities 3 6''' zeigt in unserem Beispiel ''[Effekt 1]'' die für diesen Effekt möglichen Funktionen. DMXControl gibt folgende Liste zurück:

1. Auswählen
2. Start/Stop
3. Start
4. Stop
5. Beschl. setzen
6. Intens. setzen
7. Nächster Schritt
8. Wiederh. ein/aus

Mit '''RunCommand 7 6 3''' lässt sich der Effekt 1 starten oder mit '''RunCommand 7 6 4''' stoppen. Für den Effekt 3 wären das die Aufrufe '''RunCommand 7 8 3''' und '''RunCommand 7 8 4'''. Wenn noch Werte mit übertragen werden müssen, werden diese hinten angehängt '''RunCommand 7 6 3 0 0.000'''. Andere Aufrufe funktionieren nach dem selben Prinzip.

== Links und Referenzen==
Links
#PDA-Fernbedienung Software: http://www.dmxcontrol.de/files/pda-2-dmxc/PDA-2-DMXC_1.0_Setup.exe

Tutorials
#[[PDA-2-DMXC|PDA-2-DMXC Tutorial]]
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Figureneditor_DMXC2
|zurückText = Figureneditor
|vorLink = Tastatursteuerung_DMXC2
|vorText = Tastatursteuerung
}}

[[Kategorie: DMXControl 2]]

PDA-Fernsteuerung DMXC2

2013-07-22T11:20:44Z

Wdunczewski: /* Schnittstelle */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Figureneditor_DMXC2
|zurückText = Figureneditor
|vorLink = Tastatursteuerung_DMXC2
|vorText = Tastatursteuerung
}}
{{Start-LaTeX}}
==Überblick==
Die PDA-Fernbedienung hat sich aus der Terminal-Schnittstelle von DMXControl über die Serielle-Fernbedienung weiterentwickelt. Durch die « PDA Fernbedienung » lässt sich DMXControl mit PDA und anderen seriellen Schnittstellen (Telnet, COM-Schnittstelle, Bluetooth oder über WLAN) steuern.

{{ BoxWichtig| Text=Das Fenster der PDA-Fernbedienung muss, wie bei allen anderen Fernbedienungen/Steuerungen in DMXControl, offen bleiben. Bei geschlossenen Fenster findet keine Kommunikation statt.}}

==Beschreibung==
Die « Serielle Fernbedienung » wurde in DMXControl implementiert, um den Zugriff über serielle Schnittstelle oder Netzwerk (Ethernet) auf das Programm zu ermöglichen. Im Netwerk erwartet DMXControl eine Verbindung auf Port 2145. Dieser Port kann im Fenster der « PDA-Fernsteuerung » geändert werden. Jedes Programm, das Zeichenketten (Strings) verschicken kann, ist damit in der Lage, DMXControl fernzusteuern.
Die « Serielle Fernbedienung » wird unter anderem von der PDA-Steuerung [[PDA-2-DMXC]] und vom Web-Interface bzw. der PHP-Klasse sowie verschiedener anderer Steuerungen (bspw für Android) verwendet.
Da das Protokoll der Schnittstelle offen ist, ist es für jeden möglich, über ein eigenes Programm auf DMXControl zuzugreifen.

Die Schnittstelle funktioniert bidirektional, d.h. es können Daten gesendet und angefragt werden. Eine Tabelle der möglichen Befehle ist weiter unten zu finden. Manche Befehle liefern nach dem Ausführen einen Wert als Bestätigung zurück, andere nicht.

Jeder Befehl der an DMXControl gesendet wird, muss mit einem Zeilenumbruch (in Java und C# "\n") abgeschlossen werden.

== Schnittstelle ==
In der folgende Tabelle ist eine Liste der Befehle und Antworten von DMXControl aufgeführt. Entwickler, die ein externes Programm zur Steuerung von DMXControl schreiben möchten, können erste Erfahrungen am besten mit einem Terminalprogramm wie Telnet oder Putty machen. Am lokalen Arbeitsplatz geht das mit dem Befehl: '''telnet 127.0.0.1 2145'''. Dann erkennt man sofort, wie die Antworten aussehen. Alle Befehle werden von DMXControl unabhängig von Groß / Kleinschreibung interpretiert.

{{ BoxHinweis
| Text=Anstelle von '''SetChannel''' kann also auch '''sEtChAnNeL''' geschrieben werden.
}}

Die Abkürzung '''CV''' steht für '''ChannelValue''' und '''CVC''' für '''ChannelValueChanged'''

{|cellpadding="5" cellspacing="0" border="1"
|'''Anfrage an DMXC'''
|'''Antwort von DMXC'''
|'''Beschreibung'''
|'''Beispiel'''
|- style="vertical-align:top;"
|SetChannel ''Channel Wert''
|CV ''Channel Wert''
|Setzt den Kanal '''''Channel''''' auf den Wert '''''Wert'''''.
|'''SetChannel 1 200''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|SC ''Channel Wert''
|CV ''Channel Wert''
|Kurzschreibweise für SetChannel.
|'''SC 1 200''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GetChannel ''Channel''
|CV ''Channel Wert''
|Fragt den Wert des Kanals '''''Channel''''' an.
|'''GetChannel 1''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GC ''Channel''
|CV ''Channel Wert''
|Kurzschreibweise für GetChannel.
|'''GC 1''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GetAllDevices
|''Liste der Geräte''
|Fragt alle in DMXControl vorhandenen Geräte ab.
|'''GetAllDevices''' ->
'''1. PAR-1'''
'''2. PAR-2'''
'''...'''
'''10. Botex SP-1500 Stroboskop'''
|- style="vertical-align:top;"
|GetDeviceInfo ''DeviceID''
|''Geräteinformationen''
|Fragt genauere Informationen zum Gerät mit der Nummer '''''DeviceID''''' ab. Dabei existieren für PanTilt drei Möglichkeiten: '''No, Coarse, Fine'''. Bei Coarse oder Fine folgen die Kanäle von Pan Tilt, bei einem Scanner also: '''''PanTilt: Coarse 0 1''''' bei einem 16 bit Scanner '''''PanTilt: Fine 0 1 14 15'''''. Die Reihenfolge ist dabei '''Pan Tilt PanFine TiltFine'''. Nach '''''Channels: Anzahl''''' wird eine Liste mit allen Namen der Kanäle angehängt, wie sie im DDF hinterlegt sind.
|'''GetDeviceInfo 10''' ->
'''Name: Botex SP-1500 Stroboskop'''
'''StartAddress: 257'''
'''PanTilt: No'''
'''Channels: 2'''
'''Channel1: Frequenz'''
'''Channel2: Helligkeit'''
|- style="vertical-align:top;"
|StartChannelNotification ''StartChannel EndChannel''
|Keine
|Aktiviert die Asynchrone Information über Kanaländerungen. Wenn sich in DMXControl ein Kanal zwischen '''''StartChannel''''' und '''''EndChannel''''' ändert, sendet DMXControl eine Nachricht mit dem neuen Wert. Ein weiteres senden von StartChannelNotification überschreibt den alten Bereich.
|'''StartChannelNotification 1 10'''. Nach Wertänderung von Kanal 5 auf 255: -> '''CVC 5 255'''
|- style="vertical-align:top;"
|StopChannelNotification
|Keine
|Deaktiviert die Benachrichtigung über Kanaländerungen.
|'''StopChannelNotification'''
|- style="vertical-align:top;"
|GetCommandPossibilities ''Dropdown-Index Vorgänger-Index''
|''Liste der Möglichkeiten''
|Ein Befehl setzt sich aus einzelnen Teilen zusammen. ''Modul'', ''Gerät/Funktion'', ''Kanal'', ''...''. Da die folgende Auswahl auf der vorhergehenden basiert, muss der Reihe nach von vorne abgefragt werden. Mit ''GetCommandPossibilities 1'' erhält man eine Liste der Modulmöglichkeiten. Jede Möglichkeit hat eine ID. Mit ''GetCommandPossibilities 2 3'' erhält man die Auswahl für Gerät/Funktion, auf Basis von Modul 3.
|'''GetCommandPossibilities 1''' ->
'''1. Deaktiviert'''
'''2. Audio'''
'''3. Audiotrack'''
'''...'''
|- style="vertical-align:top;"
|RunCommand ''Index1 Index2 Index3 Flags Value''
|Keine
|Mit diesem Command führt man den Befehl aus. '''''Index1, Index2''''' und '''''Index3''''' sind dabei die Indizes von GetCommandPossibilities.
'''''Flags''''' ist ein binär codierter Integer. Bit 0 steht für ''Umschalt-Modus'' und Bit 1 für ''Angegebenen Wert verwenden''. '''''Value''''' ist ein DMX-Wert in Prozent von 0.000 bis 100.000 (für zukünftige 16Bit Werte).
|'''RunCommand 2 5 3 0 0.000'''
|}
 

== GetCommandPossibilities und RunCommand ==
Um einen spezifischen Befehl mit '''RunCommand''' auszuführen, muss man wissen, welche ID der Befehl besitzt. Diese ID kann man mit dem Aufruf '''GetCommandPossibilities''' sehr einfach herausfinden. Man arbeitet sich dabei Schritt für Schritt die Befehlsstufen herab. Die erste Ziffer hinter dem Aufruf stellt die Stufe dar, auf der man sich gerade befindet. Die zweite Ziffer steht für die Auswahl des Tabelleneintrags in der Tabelle eine Ebene höher. Daher ist es sehr wichtig, dass die Stufen der Reihe nach durchlaufen werden.
 
Dies könnte wie folgt aussehen: Ein Aufruf des Befehls '''GetCommandPossibilities 1''' liefert die folgende Tabelle, wobei es hier keine zweite Ziffer gibt, da wir uns auf der höchsten Ebene (Ebene 1) befinden.
Installierte Plugins reihen sich in die Liste ein, wenn vorhanden.

1. Deaktiviert
2. Audio
3. Audiotrack
4. BeatTool
5. DMX-Ausgabe
6. DMXIn-Remote
7. Effekte
8. External Action (Plugin)
9. Geräte
10. Gruppenauswahl
11. Joystick
12. KommandoBox
13. Kommandozeile
14. Master
15. MIDI-Remote
16. OSC-Receiver (PLugin)
17. Sound Analyzer
18. Submaster
19. Szenenbibliothek
20. Szenenliste
21. Textbuch

Nun lässt sich die Auswahl verfeinern. Um nun z.B. einen Effekt zu starten, ruft man als nächstes '''GetCommandPossibilities 2 6''' auf, also Ebene 2, mit Auswahl des Listenelementes 6 der Stufe 1-Tabelle. Darauf hin gibt DMXC folgende Liste aus:

1. Alle
2. Ausgewählter
3. Nächster
4. Vorheriger
5. ----
6. [EFFEKT 1]
7. [EFFEKT 2]
8. [EFFEKT 3]
9. ...

Der nun folgende Aufruf '''GetCommandPossibilities 3 6''' wählt in unserem Beispiel ''[Effekt 1]'' aus. Darauf gibt DMXControl folgende Liste zurück:

1. Auswählen
2. Start/Stop
3. Start
4. Stop
5. Beschl. setzen
6. Intens. setzen
7. Nächster Schritt
8. Wiederh. ein/aus

Nun ist die Befehlskette durchlaufen und man kann abschließend z.B. mit dem Aufuf '''RunCommand 6 6 3 0 0.000''' den ''Effekt 1''' starten oder ihn mit '''RunCommand 6 6 4 0 0.000''' stoppen. Andere Aufrufe funktionieren nach dm selben Prinzip.

== Links und Referenzen==
Links
#PDA-Fernbedienung Software: http://www.dmxcontrol.de/files/pda-2-dmxc/PDA-2-DMXC_1.0_Setup.exe

Tutorials
#[[PDA-2-DMXC|PDA-2-DMXC Tutorial]]
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Figureneditor_DMXC2
|zurückText = Figureneditor
|vorLink = Tastatursteuerung_DMXC2
|vorText = Tastatursteuerung
}}

[[Kategorie: DMXControl 2]]

PDA-Fernsteuerung DMXC2

2013-07-22T11:15:46Z

Wdunczewski: /* Schnittstelle */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Figureneditor_DMXC2
|zurückText = Figureneditor
|vorLink = Tastatursteuerung_DMXC2
|vorText = Tastatursteuerung
}}
{{Start-LaTeX}}
==Überblick==
Die PDA-Fernbedienung hat sich aus der Terminal-Schnittstelle von DMXControl über die Serielle-Fernbedienung weiterentwickelt. Durch die « PDA Fernbedienung » lässt sich DMXControl mit PDA und anderen seriellen Schnittstellen (Telnet, COM-Schnittstelle, Bluetooth oder über WLAN) steuern.

{{ BoxWichtig| Text=Das Fenster der PDA-Fernbedienung muss, wie bei allen anderen Fernbedienungen/Steuerungen in DMXControl, offen bleiben. Bei geschlossenen Fenster findet keine Kommunikation statt.}}

==Beschreibung==
Die « Serielle Fernbedienung » wurde in DMXControl implementiert, um den Zugriff über serielle Schnittstelle oder Netzwerk (Ethernet) auf das Programm zu ermöglichen. Im Netwerk erwartet DMXControl eine Verbindung auf Port 2145. Dieser Port kann im Fenster der « PDA-Fernsteuerung » geändert werden. Jedes Programm, das Zeichenketten (Strings) verschicken kann, ist damit in der Lage, DMXControl fernzusteuern.
Die « Serielle Fernbedienung » wird unter anderem von der PDA-Steuerung [[PDA-2-DMXC]] und vom Web-Interface bzw. der PHP-Klasse sowie verschiedener anderer Steuerungen (bspw für Android) verwendet.
Da das Protokoll der Schnittstelle offen ist, ist es für jeden möglich, über ein eigenes Programm auf DMXControl zuzugreifen.

Die Schnittstelle funktioniert bidirektional, d.h. es können Daten gesendet und angefragt werden. Eine Tabelle der möglichen Befehle ist weiter unten zu finden. Manche Befehle liefern nach dem Ausführen einen Wert als Bestätigung zurück, andere nicht.

Jeder Befehl der an DMXControl gesendet wird, muss mit einem Zeilenumbruch (in Java und C# "\n") abgeschlossen werden.

== Schnittstelle ==
In der folgende Tabelle ist eine Liste der Befehle und Antworten von DMXControl aufgeführt. Entwickler, die ein externes Programm zur Steuerung von DMXControl schreiben möchten, können erste Erfahrungen am besten mit einem Terminalprogramm wie Telnet oder Putty machen. Am lokalen Arbeitsplatz geht das mit dem Befehl: '''telnet 127.0.0.1 2145'''. Dann erkennt man sofort, wie die Antworten aussehen. Alle Befehle werden von DMXControl unabhängig von Groß / Kleinschreibung interpretiert.

{{ BoxHinweis
| Text=Anstelle von '''SetChannel''' kann also auch '''sEtChAnNeL''' geschrieben werden.
}}

Die Abkürzung '''CV''' steht für '''ChannelValue''' und '''CVC''' für '''ChannelValueChanged'''

{|cellpadding="5" cellspacing="0" border="1"
|'''Anfrage an DMXC'''
|'''Antwort von DMXC'''
|'''Beschreibung'''
|'''Beispiel'''
|- style="vertical-align:top;"
|SetChannel ''Channel Wert''
|CV ''Channel Wert''
|Setzt den Kanal '''''Channel''''' auf den Wert '''''Wert'''''.
|'''SetChannel 1 200''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|SC ''Channel Wert''
|CV ''Channel Wert''
|Kurzschreibweise für SetChannel.
|'''SC 1 200''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GetChannel ''Channel''
|CV ''Channel Wert''
|Fragt den Wert des Kanals '''''Channel''''' an.
|'''GetChannel 1''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GC ''Channel''
|CV ''Channel Wert''
|Kurzschreibweise für GetChannel.
|'''GC 1''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GetAllDevices
|''Liste der Geräte''
|Fragt alle in DMXControl vorhandenen Geräte ab.
|'''GetAllDevices''' ->
'''1. PAR-1'''
'''2. PAR-2'''
'''...'''
'''10. Botex SP-1500 Stroboskop'''
|- style="vertical-align:top;"
|GetDeviceInfo ''DeviceID''
|''Geräteinformationen''
|Fragt genauere Informationen zum Gerät mit der Nummer '''''DeviceID''''' ab. Dabei existieren für PanTilt drei Möglichkeiten: '''No, Coarse, Fine'''. Bei Coarse oder Fine folgen die Kanäle von Pan Tilt, bei einem Scanner also: '''''PanTilt: Coarse 0 1''''' bei einem 16 bit Scanner '''''PanTilt: Fine 0 1 14 15'''''. Die Reihenfolge ist dabei '''Pan Tilt PanFine TiltFine'''. Nach '''''Channels: Anzahl''''' wird eine Liste mit allen Namen der Kanäle angehängt, wie sie im DDF hinterlegt sind.
|'''GetDeviceInfo 10''' ->
'''Name: Botex SP-1500 Stroboskop'''
'''StartAddress: 257'''
'''PanTilt: No'''
'''Channels: 2'''
'''Channel1: Frequenz'''
'''Channel2: Helligkeit'''
|- style="vertical-align:top;"
|StartChannelNotification ''StartChannel EndChannel''
|Keine
|Aktiviert die Asynchrone Information über Kanaländerungen. Wenn sich in DMXControl ein Kanal zwischen '''''StartChannel''''' und '''''EndChannel''''' ändert, sendet DMXControl eine Nachricht mit dem neuen Wert. Ein weiteres senden von StartChannelNotification überschreibt den alten Bereich.
|'''StartChannelNotification 1 10'''. Nach Wertänderung von Kanal 5 auf 255: -> '''CVC 5 255'''
|- style="vertical-align:top;"
|StopChannelNotification
|Keine
|Deaktiviert die Benachrichtigung über Kanaländerungen.
|'''StopChannelNotification'''
|- style="vertical-align:top;"
|GetCommandPossibilities ''Dropdown-Index Vorgänger-Index''
|''Liste der Möglichkeiten''
|Ein Befehl setzt sich aus einzelnen Teilen zusammen. ''Modul'', ''Gerät/Funktion'', ''Kanal'', ''...''. Da die folgende Auswahl auf der vorhergehenden basiert muss der reihe nach von vorne abgefragt werden. Mit ''GetCommandPossibilities 1'' erhält man eine Liste der Modulmöglichkeiten. Jede Möglichkeit hat eine ID. Mit ''GetCommandPossibilities 2 2'' erhält man die Auswahl für Gerät/Funktion, auf Basis von Modul 2.
|'''GetCommandPossibilities 1''' ->
'''1. Geräte'''
'''2. Audiotrack'''
'''...'''
|- style="vertical-align:top;"
|RunCommand ''Index1 Index2 Index3 Flags Value''
|Keine
|Mit diesem Command führt man den Befehl aus. '''''Index1, Index2''''' und '''''Index3''''' sind dabei die Indizes von GetCommandPossibilities.
'''''Flags''''' ist ein binär codierter Integer. Bit 0 steht für ''Umschalt-Modus'' und Bit 1 für ''Angegebenen Wert verwenden''. '''''Value''''' ist ein DMX-Wert in Prozent von 0.000 bis 100.000 (für zukünftige 16Bit Werte).
|'''RunCommand 2 5 3 0 0.000'''
|}
 

== GetCommandPossibilities und RunCommand ==
Um einen spezifischen Befehl mit '''RunCommand''' auszuführen, muss man wissen, welche ID der Befehl besitzt. Diese ID kann man mit dem Aufruf '''GetCommandPossibilities''' sehr einfach herausfinden. Man arbeitet sich dabei Schritt für Schritt die Befehlsstufen herab. Die erste Ziffer hinter dem Aufruf stellt die Stufe dar, auf der man sich gerade befindet. Die zweite Ziffer steht für die Auswahl des Tabelleneintrags in der Tabelle eine Ebene höher. Daher ist es sehr wichtig, dass die Stufen der Reihe nach durchlaufen werden.
 
Dies könnte wie folgt aussehen: Ein Aufruf des Befehls '''GetCommandPossibilities 1''' liefert die folgende Tabelle, wobei es hier keine zweite Ziffer gibt, da wir uns auf der höchsten Ebene (Ebene 1) befinden.
Installierte Plugins reihen sich in die Liste ein, wenn vorhanden.

1. Deaktiviert
2. Audio
3. Audiotrack
4. BeatTool
5. DMX-Ausgabe
6. DMXIn-Remote
7. Effekte
8. External Action (Plugin)
9. Geräte
10. Gruppenauswahl
11. Joystick
12. KommandoBox
13. Kommandozeile
14. Master
15. MIDI-Remote
16. OSC-Receiver (PLugin)
17. Sound Analyzer
18. Submaster
19. Szenenbibliothek
20. Szenenliste
21. Textbuch

Nun lässt sich die Auswahl verfeinern. Um nun z.B. einen Effekt zu starten, ruft man als nächstes '''GetCommandPossibilities 2 6''' auf, also Ebene 2, mit Auswahl des Listenelementes 6 der Stufe 1-Tabelle. Darauf hin gibt DMXC folgende Liste aus:

1. Alle
2. Ausgewählter
3. Nächster
4. Vorheriger
5. ----
6. [EFFEKT 1]
7. [EFFEKT 2]
8. [EFFEKT 3]
9. ...

Der nun folgende Aufruf '''GetCommandPossibilities 3 6''' wählt in unserem Beispiel ''[Effekt 1]'' aus. Darauf gibt DMXControl folgende Liste zurück:

1. Auswählen
2. Start/Stop
3. Start
4. Stop
5. Beschl. setzen
6. Intens. setzen
7. Nächster Schritt
8. Wiederh. ein/aus

Nun ist die Befehlskette durchlaufen und man kann abschließend z.B. mit dem Aufuf '''RunCommand 6 6 3 0 0.000''' den ''Effekt 1''' starten oder ihn mit '''RunCommand 6 6 4 0 0.000''' stoppen. Andere Aufrufe funktionieren nach dm selben Prinzip.

== Links und Referenzen==
Links
#PDA-Fernbedienung Software: http://www.dmxcontrol.de/files/pda-2-dmxc/PDA-2-DMXC_1.0_Setup.exe

Tutorials
#[[PDA-2-DMXC|PDA-2-DMXC Tutorial]]
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Figureneditor_DMXC2
|zurückText = Figureneditor
|vorLink = Tastatursteuerung_DMXC2
|vorText = Tastatursteuerung
}}

[[Kategorie: DMXControl 2]]

PDA-Fernsteuerung DMXC2

2013-07-22T11:10:28Z

Wdunczewski: /* Beschreibung */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Figureneditor_DMXC2
|zurückText = Figureneditor
|vorLink = Tastatursteuerung_DMXC2
|vorText = Tastatursteuerung
}}
{{Start-LaTeX}}
==Überblick==
Die PDA-Fernbedienung hat sich aus der Terminal-Schnittstelle von DMXControl über die Serielle-Fernbedienung weiterentwickelt. Durch die « PDA Fernbedienung » lässt sich DMXControl mit PDA und anderen seriellen Schnittstellen (Telnet, COM-Schnittstelle, Bluetooth oder über WLAN) steuern.

{{ BoxWichtig| Text=Das Fenster der PDA-Fernbedienung muss, wie bei allen anderen Fernbedienungen/Steuerungen in DMXControl, offen bleiben. Bei geschlossenen Fenster findet keine Kommunikation statt.}}

==Beschreibung==
Die « Serielle Fernbedienung » wurde in DMXControl implementiert, um den Zugriff über serielle Schnittstelle oder Netzwerk (Ethernet) auf das Programm zu ermöglichen. Im Netwerk erwartet DMXControl eine Verbindung auf Port 2145. Dieser Port kann im Fenster der « PDA-Fernsteuerung » geändert werden. Jedes Programm, das Zeichenketten (Strings) verschicken kann, ist damit in der Lage, DMXControl fernzusteuern.
Die « Serielle Fernbedienung » wird unter anderem von der PDA-Steuerung [[PDA-2-DMXC]] und vom Web-Interface bzw. der PHP-Klasse sowie verschiedener anderer Steuerungen (bspw für Android) verwendet.
Da das Protokoll der Schnittstelle offen ist, ist es für jeden möglich, über ein eigenes Programm auf DMXControl zuzugreifen.

Die Schnittstelle funktioniert bidirektional, d.h. es können Daten gesendet und angefragt werden. Eine Tabelle der möglichen Befehle ist weiter unten zu finden. Manche Befehle liefern nach dem Ausführen einen Wert als Bestätigung zurück, andere nicht.

Jeder Befehl der an DMXControl gesendet wird, muss mit einem Zeilenumbruch (in Java und C# "\n") abgeschlossen werden.

== Schnittstelle ==
In der folgende Tabelle ist eine Liste der Befehle und Antworten von DMXControl aufgeführt. Entwickler, die ein Externes Programm zur Steuerung von DMXControl schreiben möchten, können erste Erfahrungen am besten mit einem Terminalprogramm wie Putty machen. Dann erkennt man sofort, wie die Antworten aussehen. Alle Befehle werden von DMXControl unabhängig von Groß / Kleinschreibung interpretiert.

{{ BoxHinweis
| Text=Anstelle von '''SetChannel''' kann also auch '''sEtChAnNeL''' geschrieben werden.
}}

Die Abkürzung '''CV''' steht für '''ChannelValue''' und '''CVC''' für '''ChannelValueChanged'''

{|cellpadding="5" cellspacing="0" border="1"
|'''Anfrage an DMXC'''
|'''Antwort von DMXC'''
|'''Beschreibung'''
|'''Beispiel'''
|- style="vertical-align:top;"
|SetChannel ''Channel Wert''
|CV ''Channel Wert''
|Setzt den Kanal '''''Channel''''' auf den Wert '''''Wert'''''.
|'''SetChannel 1 200''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|SC ''Channel Wert''
|CV ''Channel Wert''
|Kurzschreibweise für SetChannel.
|'''SC 1 200''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GetChannel ''Channel''
|CV ''Channel Wert''
|Fragt den Wert des Kanals '''''Channel''''' an.
|'''GetChannel 1''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GC ''Channel''
|CV ''Channel Wert''
|Kurzschreibweise für GetChannel.
|'''GC 1''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GetAllDevices
|''Liste der Geräte''
|Fragt alle in DMXControl vorhandenen Geräte ab.
|'''GetAllDevices''' ->
'''1. PAR-1'''
'''2. PAR-2'''
'''...'''
'''10. Botex SP-1500 Stroboskop'''
|- style="vertical-align:top;"
|GetDeviceInfo ''DeviceID''
|''Geräteinformationen''
|Fragt genauere Informationen zum Gerät mit der Nummer '''''DeviceID''''' ab. Dabei existieren für PanTilt drei Möglichkeiten: '''No, Coarse, Fine'''. Bei Coarse oder Fine folgen die Kanäle von Pan Tilt, bei einem Scanner also: '''''PanTilt: Coarse 0 1''''' bei einem 16 bit Scanner '''''PanTilt: Fine 0 1 14 15'''''. Die Reihenfolge ist dabei '''Pan Tilt PanFine TiltFine'''. Nach '''''Channels: Anzahl''''' wird eine Liste mit allen Namen der Kanäle angehängt, wie sie im DDF hinterlegt sind.
|'''GetDeviceInfo 10''' ->
'''Name: Botex SP-1500 Stroboskop'''
'''StartAddress: 257'''
'''PanTilt: No'''
'''Channels: 2'''
'''Channel1: Frequenz'''
'''Channel2: Helligkeit'''
|- style="vertical-align:top;"
|StartChannelNotification ''StartChannel EndChannel''
|Keine
|Aktiviert die Asynchrone Information über Kanaländerungen. Wenn sich in DMXControl ein Kanal zwischen '''''StartChannel''''' und '''''EndChannel''''' ändert, sendet DMXControl eine Nachricht mit dem neuen Wert. Ein weiteres senden von StartChannelNotification überschreibt den alten Bereich.
|'''StartChannelNotification 1 10'''. Nach Wertänderung von Kanal 5 auf 255: -> '''CVC 5 255'''
|- style="vertical-align:top;"
|StopChannelNotification
|Keine
|Deaktiviert die Benachrichtigung über Kanaländerungen.
|'''StopChannelNotification'''
|- style="vertical-align:top;"
|GetCommandPossibilities ''Dropdown-Index Vorgänger-Index''
|''Liste der Möglichkeiten''
|Ein Befehl setzt sich aus einzelnen Teilen zusammen. ''Modul'', ''Gerät/Funktion'', ''Kanal'', ''...''. Da die folgende Auswahl auf der vorhergehenden basiert muss der reihe nach von vorne abgefragt werden. Mit ''GetCommandPossibilities 1'' erhält man eine Liste der Modulmöglichkeiten. Jede Möglichkeit hat eine ID. Mit ''GetCommandPossibilities 2 2'' erhält man die Auswahl für Gerät/Funktion, auf Basis von Modul 2.
|'''GetCommandPossibilities 1''' ->
'''1. Geräte'''
'''2. Audiotrack'''
'''...'''
|- style="vertical-align:top;"
|RunCommand ''Index1 Index2 Index3 Flags Value''
|Keine
|Mit diesem Command führt man den Befehl aus. '''''Index1, Index2''''' und '''''Index3''''' sind dabei die Indizes von GetCommandPossibilities.
'''''Flags''''' ist ein binär codierter Integer. Bit 0 steht für ''Umschalt-Modus'' und Bit 1 für ''Angegebenen Wert verwenden''. '''''Value''''' ist ein DMX-Wert in Prozent von 0.000 bis 100.000 (für zukünftige 16Bit Werte).
|'''RunCommand 2 5 3 0 0.000'''
|}
 
== GetCommandPossibilities und RunCommand ==
Um einen spezifischen Befehl mit '''RunCommand''' auszuführen, muss man wissen, welche ID der Befehl besitzt. Diese ID kann man mit dem Aufruf '''GetCommandPossibilities''' sehr einfach herausfinden. Man arbeitet sich dabei Schritt für Schritt die Befehlsstufen herab. Die erste Ziffer hinter dem Aufruf stellt die Stufe dar, auf der man sich gerade befindet. Die zweite Ziffer steht für die Auswahl des Tabelleneintrags in der Tabelle eine Ebene höher. Daher ist es sehr wichtig, dass die Stufen der Reihe nach durchlaufen werden.
 
Dies könnte wie folgt aussehen: Ein Aufruf des Befehls '''GetCommandPossibilities 1''' liefert die folgende Tabelle, wobei es hier keine zweite Ziffer gibt, da wir uns auf der höchsten Ebene (Ebene 1) befinden.
Installierte Plugins reihen sich in die Liste ein, wenn vorhanden.

1. Deaktiviert
2. Audio
3. Audiotrack
4. BeatTool
5. DMX-Ausgabe
6. DMXIn-Remote
7. Effekte
8. External Action (Plugin)
9. Geräte
10. Gruppenauswahl
11. Joystick
12. KommandoBox
13. Kommandozeile
14. Master
15. MIDI-Remote
16. OSC-Receiver (PLugin)
17. Sound Analyzer
18. Submaster
19. Szenenbibliothek
20. Szenenliste
21. Textbuch

Nun lässt sich die Auswahl verfeinern. Um nun z.B. einen Effekt zu starten, ruft man als nächstes '''GetCommandPossibilities 2 6''' auf, also Ebene 2, mit Auswahl des Listenelementes 6 der Stufe 1-Tabelle. Darauf hin gibt DMXC folgende Liste aus:

1. Alle
2. Ausgewählter
3. Nächster
4. Vorheriger
5. ----
6. [EFFEKT 1]
7. [EFFEKT 2]
8. [EFFEKT 3]
9. ...

Der nun folgende Aufruf '''GetCommandPossibilities 3 6''' wählt in unserem Beispiel ''[Effekt 1]'' aus. Darauf gibt DMXControl folgende Liste zurück:

1. Auswählen
2. Start/Stop
3. Start
4. Stop
5. Beschl. setzen
6. Intens. setzen
7. Nächster Schritt
8. Wiederh. ein/aus

Nun ist die Befehlskette durchlaufen und man kann abschließend z.B. mit dem Aufuf '''RunCommand 6 6 3 0 0.000''' den ''Effekt 1''' starten oder ihn mit '''RunCommand 6 6 4 0 0.000''' stoppen. Andere Aufrufe funktionieren nach dm selben Prinzip.

== Links und Referenzen==
Links
#PDA-Fernbedienung Software: http://www.dmxcontrol.de/files/pda-2-dmxc/PDA-2-DMXC_1.0_Setup.exe

Tutorials
#[[PDA-2-DMXC|PDA-2-DMXC Tutorial]]
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Figureneditor_DMXC2
|zurückText = Figureneditor
|vorLink = Tastatursteuerung_DMXC2
|vorText = Tastatursteuerung
}}

[[Kategorie: DMXControl 2]]

PDA-Fernsteuerung DMXC2

2013-07-22T10:57:09Z

Wdunczewski: /* Überblick */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Figureneditor_DMXC2
|zurückText = Figureneditor
|vorLink = Tastatursteuerung_DMXC2
|vorText = Tastatursteuerung
}}
{{Start-LaTeX}}
==Überblick==
Die PDA-Fernbedienung hat sich aus der Terminal-Schnittstelle von DMXControl über die Serielle-Fernbedienung weiterentwickelt. Durch die « PDA Fernbedienung » lässt sich DMXControl mit PDA und anderen seriellen Schnittstellen (Telnet, COM-Schnittstelle, Bluetooth oder über WLAN) steuern.

{{ BoxWichtig| Text=Das Fenster der PDA-Fernbedienung muss, wie bei allen anderen Fernbedienungen/Steuerungen in DMXControl, offen bleiben. Bei geschlossenen Fenster findet keine Kommunikation statt.}}

==Beschreibung==
Die « Serielle Fernbedienung » wurde in DMXControl implementiert, um den Zugriff über Ethernet auf das Programm zu ermöglichen. DMXControl erwartet die Verbindung auf Port 2145. Jedes Programm, welches Zeichenketten (Strings) verschicken kann ist damit in der lage DMXControl fernzusteuern.
Die « Serielle Fernbedienung » wird unter anderem von der PDA-Steuerung [[PDA-2-DMXC]] und vom Web-Interface bzw. der PHP-Klasse sowie verschiedener anderer Steuerungen (bspw für Android) verwendet.
Die Schnittstelle ist öffentlich, deshalb ist es auch für jeden möglich über ein beliebiges Programm auf DMXControl zuzugreifen.

Die Schnittstelle funktioniert bidirektional, es können also Daten gesendet und angefragt werden. Eine Tabelle der möglichen Befehle ist weiter unten zu finden. Manche Befehle liefern nach dem Ausführen einen Wert als Bestätigung zurück, andere nicht.

Jeder Befehl der an DMXControl gesendet wird, muss mit einem Zeilenumbruch (in Java und C# "\n") abgeschlossen werden.

== Schnittstelle ==
In der folgende Tabelle ist eine Liste der Befehle und Antworten von DMXControl aufgeführt. Entwickler, die ein Externes Programm zur Steuerung von DMXControl schreiben möchten, können erste Erfahrungen am besten mit einem Terminalprogramm wie Putty machen. Dann erkennt man sofort, wie die Antworten aussehen. Alle Befehle werden von DMXControl unabhängig von Groß / Kleinschreibung interpretiert.

{{ BoxHinweis
| Text=Anstelle von '''SetChannel''' kann also auch '''sEtChAnNeL''' geschrieben werden.
}}

Die Abkürzung '''CV''' steht für '''ChannelValue''' und '''CVC''' für '''ChannelValueChanged'''

{|cellpadding="5" cellspacing="0" border="1"
|'''Anfrage an DMXC'''
|'''Antwort von DMXC'''
|'''Beschreibung'''
|'''Beispiel'''
|- style="vertical-align:top;"
|SetChannel ''Channel Wert''
|CV ''Channel Wert''
|Setzt den Kanal '''''Channel''''' auf den Wert '''''Wert'''''.
|'''SetChannel 1 200''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|SC ''Channel Wert''
|CV ''Channel Wert''
|Kurzschreibweise für SetChannel.
|'''SC 1 200''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GetChannel ''Channel''
|CV ''Channel Wert''
|Fragt den Wert des Kanals '''''Channel''''' an.
|'''GetChannel 1''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GC ''Channel''
|CV ''Channel Wert''
|Kurzschreibweise für GetChannel.
|'''GC 1''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GetAllDevices
|''Liste der Geräte''
|Fragt alle in DMXControl vorhandenen Geräte ab.
|'''GetAllDevices''' ->
'''1. PAR-1'''
'''2. PAR-2'''
'''...'''
'''10. Botex SP-1500 Stroboskop'''
|- style="vertical-align:top;"
|GetDeviceInfo ''DeviceID''
|''Geräteinformationen''
|Fragt genauere Informationen zum Gerät mit der Nummer '''''DeviceID''''' ab. Dabei existieren für PanTilt drei Möglichkeiten: '''No, Coarse, Fine'''. Bei Coarse oder Fine folgen die Kanäle von Pan Tilt, bei einem Scanner also: '''''PanTilt: Coarse 0 1''''' bei einem 16 bit Scanner '''''PanTilt: Fine 0 1 14 15'''''. Die Reihenfolge ist dabei '''Pan Tilt PanFine TiltFine'''. Nach '''''Channels: Anzahl''''' wird eine Liste mit allen Namen der Kanäle angehängt, wie sie im DDF hinterlegt sind.
|'''GetDeviceInfo 10''' ->
'''Name: Botex SP-1500 Stroboskop'''
'''StartAddress: 257'''
'''PanTilt: No'''
'''Channels: 2'''
'''Channel1: Frequenz'''
'''Channel2: Helligkeit'''
|- style="vertical-align:top;"
|StartChannelNotification ''StartChannel EndChannel''
|Keine
|Aktiviert die Asynchrone Information über Kanaländerungen. Wenn sich in DMXControl ein Kanal zwischen '''''StartChannel''''' und '''''EndChannel''''' ändert, sendet DMXControl eine Nachricht mit dem neuen Wert. Ein weiteres senden von StartChannelNotification überschreibt den alten Bereich.
|'''StartChannelNotification 1 10'''. Nach Wertänderung von Kanal 5 auf 255: -> '''CVC 5 255'''
|- style="vertical-align:top;"
|StopChannelNotification
|Keine
|Deaktiviert die Benachrichtigung über Kanaländerungen.
|'''StopChannelNotification'''
|- style="vertical-align:top;"
|GetCommandPossibilities ''Dropdown-Index Vorgänger-Index''
|''Liste der Möglichkeiten''
|Ein Befehl setzt sich aus einzelnen Teilen zusammen. ''Modul'', ''Gerät/Funktion'', ''Kanal'', ''...''. Da die folgende Auswahl auf der vorhergehenden basiert muss der reihe nach von vorne abgefragt werden. Mit ''GetCommandPossibilities 1'' erhält man eine Liste der Modulmöglichkeiten. Jede Möglichkeit hat eine ID. Mit ''GetCommandPossibilities 2 2'' erhält man die Auswahl für Gerät/Funktion, auf Basis von Modul 2.
|'''GetCommandPossibilities 1''' ->
'''1. Geräte'''
'''2. Audiotrack'''
'''...'''
|- style="vertical-align:top;"
|RunCommand ''Index1 Index2 Index3 Flags Value''
|Keine
|Mit diesem Command führt man den Befehl aus. '''''Index1, Index2''''' und '''''Index3''''' sind dabei die Indizes von GetCommandPossibilities.
'''''Flags''''' ist ein binär codierter Integer. Bit 0 steht für ''Umschalt-Modus'' und Bit 1 für ''Angegebenen Wert verwenden''. '''''Value''''' ist ein DMX-Wert in Prozent von 0.000 bis 100.000 (für zukünftige 16Bit Werte).
|'''RunCommand 2 5 3 0 0.000'''
|}
 
== GetCommandPossibilities und RunCommand ==
Um einen spezifischen Befehl mit '''RunCommand''' auszuführen, muss man wissen, welche ID der Befehl besitzt. Diese ID kann man mit dem Aufruf '''GetCommandPossibilities''' sehr einfach herausfinden. Man arbeitet sich dabei Schritt für Schritt die Befehlsstufen herab. Die erste Ziffer hinter dem Aufruf stellt die Stufe dar, auf der man sich gerade befindet. Die zweite Ziffer steht für die Auswahl des Tabelleneintrags in der Tabelle eine Ebene höher. Daher ist es sehr wichtig, dass die Stufen der Reihe nach durchlaufen werden.
 
Dies könnte wie folgt aussehen: Ein Aufruf des Befehls '''GetCommandPossibilities 1''' liefert die folgende Tabelle, wobei es hier keine zweite Ziffer gibt, da wir uns auf der höchsten Ebene (Ebene 1) befinden.
Installierte Plugins reihen sich in die Liste ein, wenn vorhanden.

1. Deaktiviert
2. Audio
3. Audiotrack
4. BeatTool
5. DMX-Ausgabe
6. DMXIn-Remote
7. Effekte
8. External Action (Plugin)
9. Geräte
10. Gruppenauswahl
11. Joystick
12. KommandoBox
13. Kommandozeile
14. Master
15. MIDI-Remote
16. OSC-Receiver (PLugin)
17. Sound Analyzer
18. Submaster
19. Szenenbibliothek
20. Szenenliste
21. Textbuch

Nun lässt sich die Auswahl verfeinern. Um nun z.B. einen Effekt zu starten, ruft man als nächstes '''GetCommandPossibilities 2 6''' auf, also Ebene 2, mit Auswahl des Listenelementes 6 der Stufe 1-Tabelle. Darauf hin gibt DMXC folgende Liste aus:

1. Alle
2. Ausgewählter
3. Nächster
4. Vorheriger
5. ----
6. [EFFEKT 1]
7. [EFFEKT 2]
8. [EFFEKT 3]
9. ...

Der nun folgende Aufruf '''GetCommandPossibilities 3 6''' wählt in unserem Beispiel ''[Effekt 1]'' aus. Darauf gibt DMXControl folgende Liste zurück:

1. Auswählen
2. Start/Stop
3. Start
4. Stop
5. Beschl. setzen
6. Intens. setzen
7. Nächster Schritt
8. Wiederh. ein/aus

Nun ist die Befehlskette durchlaufen und man kann abschließend z.B. mit dem Aufuf '''RunCommand 6 6 3 0 0.000''' den ''Effekt 1''' starten oder ihn mit '''RunCommand 6 6 4 0 0.000''' stoppen. Andere Aufrufe funktionieren nach dm selben Prinzip.

== Links und Referenzen==
Links
#PDA-Fernbedienung Software: http://www.dmxcontrol.de/files/pda-2-dmxc/PDA-2-DMXC_1.0_Setup.exe

Tutorials
#[[PDA-2-DMXC|PDA-2-DMXC Tutorial]]
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Figureneditor_DMXC2
|zurückText = Figureneditor
|vorLink = Tastatursteuerung_DMXC2
|vorText = Tastatursteuerung
}}

[[Kategorie: DMXControl 2]]

PDA-Fernsteuerung DMXC2

2013-07-22T10:56:31Z

Wdunczewski: /* Überblick */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Figureneditor_DMXC2
|zurückText = Figureneditor
|vorLink = Tastatursteuerung_DMXC2
|vorText = Tastatursteuerung
}}
{{Start-LaTeX}}
==Überblick==
Die PDA-Fernbedienung hat sich aus der Terminal-Schnittstelle von DMXControl über die Serielle-Fernbedienung weiterentwickelt. Durch die « PDA Fernbedienung » lässt sich DMXControl mit PDA und anderen seriellen Schnittstellen (Telnet, COM-Schnittstelle, Bluetooth oder über WLAN) steuern.

{{ BoxWichtig| Text=Das Fenster der PDA-Fernbedienung muss, wie bei allen anderen Fernbedienungen/Steuerungen, in DMXControl offen bleiben. Bei geschlossenen Fenster findet keine Kommunikation statt.}}

==Beschreibung==
Die « Serielle Fernbedienung » wurde in DMXControl implementiert, um den Zugriff über Ethernet auf das Programm zu ermöglichen. DMXControl erwartet die Verbindung auf Port 2145. Jedes Programm, welches Zeichenketten (Strings) verschicken kann ist damit in der lage DMXControl fernzusteuern.
Die « Serielle Fernbedienung » wird unter anderem von der PDA-Steuerung [[PDA-2-DMXC]] und vom Web-Interface bzw. der PHP-Klasse sowie verschiedener anderer Steuerungen (bspw für Android) verwendet.
Die Schnittstelle ist öffentlich, deshalb ist es auch für jeden möglich über ein beliebiges Programm auf DMXControl zuzugreifen.

Die Schnittstelle funktioniert bidirektional, es können also Daten gesendet und angefragt werden. Eine Tabelle der möglichen Befehle ist weiter unten zu finden. Manche Befehle liefern nach dem Ausführen einen Wert als Bestätigung zurück, andere nicht.

Jeder Befehl der an DMXControl gesendet wird, muss mit einem Zeilenumbruch (in Java und C# "\n") abgeschlossen werden.

== Schnittstelle ==
In der folgende Tabelle ist eine Liste der Befehle und Antworten von DMXControl aufgeführt. Entwickler, die ein Externes Programm zur Steuerung von DMXControl schreiben möchten, können erste Erfahrungen am besten mit einem Terminalprogramm wie Putty machen. Dann erkennt man sofort, wie die Antworten aussehen. Alle Befehle werden von DMXControl unabhängig von Groß / Kleinschreibung interpretiert.

{{ BoxHinweis
| Text=Anstelle von '''SetChannel''' kann also auch '''sEtChAnNeL''' geschrieben werden.
}}

Die Abkürzung '''CV''' steht für '''ChannelValue''' und '''CVC''' für '''ChannelValueChanged'''

{|cellpadding="5" cellspacing="0" border="1"
|'''Anfrage an DMXC'''
|'''Antwort von DMXC'''
|'''Beschreibung'''
|'''Beispiel'''
|- style="vertical-align:top;"
|SetChannel ''Channel Wert''
|CV ''Channel Wert''
|Setzt den Kanal '''''Channel''''' auf den Wert '''''Wert'''''.
|'''SetChannel 1 200''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|SC ''Channel Wert''
|CV ''Channel Wert''
|Kurzschreibweise für SetChannel.
|'''SC 1 200''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GetChannel ''Channel''
|CV ''Channel Wert''
|Fragt den Wert des Kanals '''''Channel''''' an.
|'''GetChannel 1''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GC ''Channel''
|CV ''Channel Wert''
|Kurzschreibweise für GetChannel.
|'''GC 1''' -> '''CV 1 200'''
|- style="vertical-align:top;"
|GetAllDevices
|''Liste der Geräte''
|Fragt alle in DMXControl vorhandenen Geräte ab.
|'''GetAllDevices''' ->
'''1. PAR-1'''
'''2. PAR-2'''
'''...'''
'''10. Botex SP-1500 Stroboskop'''
|- style="vertical-align:top;"
|GetDeviceInfo ''DeviceID''
|''Geräteinformationen''
|Fragt genauere Informationen zum Gerät mit der Nummer '''''DeviceID''''' ab. Dabei existieren für PanTilt drei Möglichkeiten: '''No, Coarse, Fine'''. Bei Coarse oder Fine folgen die Kanäle von Pan Tilt, bei einem Scanner also: '''''PanTilt: Coarse 0 1''''' bei einem 16 bit Scanner '''''PanTilt: Fine 0 1 14 15'''''. Die Reihenfolge ist dabei '''Pan Tilt PanFine TiltFine'''. Nach '''''Channels: Anzahl''''' wird eine Liste mit allen Namen der Kanäle angehängt, wie sie im DDF hinterlegt sind.
|'''GetDeviceInfo 10''' ->
'''Name: Botex SP-1500 Stroboskop'''
'''StartAddress: 257'''
'''PanTilt: No'''
'''Channels: 2'''
'''Channel1: Frequenz'''
'''Channel2: Helligkeit'''
|- style="vertical-align:top;"
|StartChannelNotification ''StartChannel EndChannel''
|Keine
|Aktiviert die Asynchrone Information über Kanaländerungen. Wenn sich in DMXControl ein Kanal zwischen '''''StartChannel''''' und '''''EndChannel''''' ändert, sendet DMXControl eine Nachricht mit dem neuen Wert. Ein weiteres senden von StartChannelNotification überschreibt den alten Bereich.
|'''StartChannelNotification 1 10'''. Nach Wertänderung von Kanal 5 auf 255: -> '''CVC 5 255'''
|- style="vertical-align:top;"
|StopChannelNotification
|Keine
|Deaktiviert die Benachrichtigung über Kanaländerungen.
|'''StopChannelNotification'''
|- style="vertical-align:top;"
|GetCommandPossibilities ''Dropdown-Index Vorgänger-Index''
|''Liste der Möglichkeiten''
|Ein Befehl setzt sich aus einzelnen Teilen zusammen. ''Modul'', ''Gerät/Funktion'', ''Kanal'', ''...''. Da die folgende Auswahl auf der vorhergehenden basiert muss der reihe nach von vorne abgefragt werden. Mit ''GetCommandPossibilities 1'' erhält man eine Liste der Modulmöglichkeiten. Jede Möglichkeit hat eine ID. Mit ''GetCommandPossibilities 2 2'' erhält man die Auswahl für Gerät/Funktion, auf Basis von Modul 2.
|'''GetCommandPossibilities 1''' ->
'''1. Geräte'''
'''2. Audiotrack'''
'''...'''
|- style="vertical-align:top;"
|RunCommand ''Index1 Index2 Index3 Flags Value''
|Keine
|Mit diesem Command führt man den Befehl aus. '''''Index1, Index2''''' und '''''Index3''''' sind dabei die Indizes von GetCommandPossibilities.
'''''Flags''''' ist ein binär codierter Integer. Bit 0 steht für ''Umschalt-Modus'' und Bit 1 für ''Angegebenen Wert verwenden''. '''''Value''''' ist ein DMX-Wert in Prozent von 0.000 bis 100.000 (für zukünftige 16Bit Werte).
|'''RunCommand 2 5 3 0 0.000'''
|}
 
== GetCommandPossibilities und RunCommand ==
Um einen spezifischen Befehl mit '''RunCommand''' auszuführen, muss man wissen, welche ID der Befehl besitzt. Diese ID kann man mit dem Aufruf '''GetCommandPossibilities''' sehr einfach herausfinden. Man arbeitet sich dabei Schritt für Schritt die Befehlsstufen herab. Die erste Ziffer hinter dem Aufruf stellt die Stufe dar, auf der man sich gerade befindet. Die zweite Ziffer steht für die Auswahl des Tabelleneintrags in der Tabelle eine Ebene höher. Daher ist es sehr wichtig, dass die Stufen der Reihe nach durchlaufen werden.
 
Dies könnte wie folgt aussehen: Ein Aufruf des Befehls '''GetCommandPossibilities 1''' liefert die folgende Tabelle, wobei es hier keine zweite Ziffer gibt, da wir uns auf der höchsten Ebene (Ebene 1) befinden.
Installierte Plugins reihen sich in die Liste ein, wenn vorhanden.

1. Deaktiviert
2. Audio
3. Audiotrack
4. BeatTool
5. DMX-Ausgabe
6. DMXIn-Remote
7. Effekte
8. External Action (Plugin)
9. Geräte
10. Gruppenauswahl
11. Joystick
12. KommandoBox
13. Kommandozeile
14. Master
15. MIDI-Remote
16. OSC-Receiver (PLugin)
17. Sound Analyzer
18. Submaster
19. Szenenbibliothek
20. Szenenliste
21. Textbuch

Nun lässt sich die Auswahl verfeinern. Um nun z.B. einen Effekt zu starten, ruft man als nächstes '''GetCommandPossibilities 2 6''' auf, also Ebene 2, mit Auswahl des Listenelementes 6 der Stufe 1-Tabelle. Darauf hin gibt DMXC folgende Liste aus:

1. Alle
2. Ausgewählter
3. Nächster
4. Vorheriger
5. ----
6. [EFFEKT 1]
7. [EFFEKT 2]
8. [EFFEKT 3]
9. ...

Der nun folgende Aufruf '''GetCommandPossibilities 3 6''' wählt in unserem Beispiel ''[Effekt 1]'' aus. Darauf gibt DMXControl folgende Liste zurück:

1. Auswählen
2. Start/Stop
3. Start
4. Stop
5. Beschl. setzen
6. Intens. setzen
7. Nächster Schritt
8. Wiederh. ein/aus

Nun ist die Befehlskette durchlaufen und man kann abschließend z.B. mit dem Aufuf '''RunCommand 6 6 3 0 0.000''' den ''Effekt 1''' starten oder ihn mit '''RunCommand 6 6 4 0 0.000''' stoppen. Andere Aufrufe funktionieren nach dm selben Prinzip.

== Links und Referenzen==
Links
#PDA-Fernbedienung Software: http://www.dmxcontrol.de/files/pda-2-dmxc/PDA-2-DMXC_1.0_Setup.exe

Tutorials
#[[PDA-2-DMXC|PDA-2-DMXC Tutorial]]
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Figureneditor_DMXC2
|zurückText = Figureneditor
|vorLink = Tastatursteuerung_DMXC2
|vorText = Tastatursteuerung
}}

[[Kategorie: DMXControl 2]]

Handbuch DMXControl 2

2012-11-06T17:54:27Z

Wdunczewski:

__NOTITLE__
{{Hauptüberschrift
| logo = Books.png
| ueberschrift = Handbuch DMXControl 2
}}

{{Hinweis
|Text = Eine Artikelvorlage für Handbuchkapitel ist [[Hilfe:Vorlage Handbuchartikel|hier]] zu finden. 
Konventionen zu den Bilddateien befinden sich [[Hilfe:Bilder Konventionen|hier]]. 
Eine aktuelle Liste der nötigen Änderungen befindet sich [https://docs.google.com/spreadsheet/ccc?key=0AgS2IFq3SYsjdENtTW5RTVpzRVk1cjFsWk9PaVFQZEE#gid=1 hier]
}}

= Inhaltsverzeichnis =
{{Stages}}
{| width=100%
| width="50%" valign=top |
{{Stage short|100%|04.10.2012}} {{Pictures short|31.7.2012}} {{Spell check|01.11.2012}} {{Changed short}} [[Vorwort_DMXC2|Vorwort]] 
{{Stage short|100%|04.10.2012}} {{Pictures short|31.7.2012}} {{Spell check|01.11.2012}} {{Changed short}} [[Einleitung_DMXC2|Kapitel 1: Einleitung ]] 
{{Stage short|100%|04.10.2012}} {{Pictures short|31.7.2012}} {{Spell check|01.11.2012}} {{Changed short}} [[Installation_DMXC2|Kapitel 2: Installation]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|31.7.2012}} {{Spell check|01.11.2012}} {{Changed short}} [[Steuerzentrum_DMXC2|Kapitel 3: Das Steuerzentrum]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|26.10.2012}} {{Spell check|01.11.2012}} {{Changed short}}
[[Grafische Bühnenansicht_DMXC2|Kapitel 4: Grafische Bühnenansicht]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|10.8.2012}} {{Spell check|02.11.2012}} {{Changed short}} [[Geräte_DMXC2|Kapitel 5: Geräteliste]] 
{{Stage short|100%|04.10.2012}} {{Pictures short|15.8.2012}} {{Spell check|02.11.2012}} {{Changed short}} [[Ausgabeplugins_DMXC2|Kapitel 6: Ausgabe-Plugins]] 
{{Stage short|100%|04.10.2012}} {{Pictures short|2.8.2012}} {{Spell check|02.11.2012}} {{Changed short}} [[Kanalübersicht_DMXC2|Kapitel 7: Kanalübersicht]] 
{{Stage short|25%|05.10.2012}} {{Pictures short|}} {{Spell check|}} {{Changed short|05.10.2012}} [[Szenen_DMXC2|Kapitel 8: Szenen]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|6.8.2012}} {{Spell check|03.11.2012}} {{Changed short}} [[Szenenliste_DMXC2|Kapitel 9: Szenenliste]] 
{{Stage short|75%|15.07.2012}} {{Pictures short|}} {{Spell check|}} {{Changed short|05.10.2012}} [[Effektsequencer_DMXC2|Kapitel 10: Effektsequencer]] 
{{Stage short|75%|12.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short|05.10.2012}} [[Submaster_DMXC2|Kapitel 11: Submaster]] 
{{Stage short|100%|05.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|02.11.2012}} {{Changed short}} [[Master_DMXC2|Kapitel 12: Master]] 
{{Stage short|100%|05.10.2012}} {{Pictures short|12.9.2012}} {{Spell check|05.11.2012}} {{Changed short}}
[[Sound Analyzer_DMXC2|Kapitel 13: Sound Analyzer]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|09.07.2012}} {{Spell check|05.11.2012}} {{Changed short}} [[BeatTool_DMXC2|Kapitel 14: BeatTool]] 
{{Stage short|100%|05.10.2012}} {{Pictures short|6.8.2012}} {{Spell check|05.11.2012}} {{Changed short}} [[Kommandobox_DMXC2|Kapitel 15: Kommandobox]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|13.9.2012}} {{Spell check|06.11.2012}} {{Changed short|06.11.2012}} [[Audioplayer_DMXC2|Kapitel 16: Audioplayer]] 
{{Stage short|100%|05.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|06.11.2012}} {{Changed short|06.11.2012}} [[Timecode-Player_DMXC2|Kapitel 17: Timecode-Player]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|06.11.2012}} {{Changed short|06.11.2012}} [[Textbuch_DMXC2|Kapitel 18: Textbuch]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|05.11.2012}} {{Changed short}} [[Kommandozeile_DMXC2|Kapitel 19: Kommandozeile]] 
|valign=top |
 
{{Stage short|100%|05.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Zeitplaner_DMXC2|Kapitel 20: Zeitplaner]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Bewegungsszene_DMXC2|Kapitel 21: Bewegungsszenen Editor]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Figureneditor_DMXC2|Kapitel 22: Figureneditor]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[PDA-Fernsteuerung_DMXC2|Kapitel 23: PDA-Fernsteuerung]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|26.10.2012}} {{Spell check|}} {{Changed short}} [[Tastatursteuerung_DMXC2|Kapitel 24: Tastatursteuerung]] 
{{Stage short|100%|09.10.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}}
[[Joysticksteuerung_DMXC2|Kapitel 25: Joysticksteuerung]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}}
[[MIDI-Fernsteuerung_DMXC2|Kapitel 26: MIDI-Fernsteuerung]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|6.8.2012}} {{Spell check|}} {{Changed short}}
[[DMXIn-Fernsteuerung_DMXC2|Kapitel 27: DMXIn-Fernsteuerung]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|18.9.2012}} {{Spell check|}} {{Changed short}} [[Programmkonfiguration_DMXC2|Kapitel 28: Programmkonfiguration]] 
{{Stage short|100%|06.10.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}}
[[Plugins_DMXC2|Kapitel 29: Plugin-Verwaltung]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Pack And Go_DMXC2|Kapitel 30: Pack And Go Funktion]] 
{{Stage short|100%|06.10.2012}} {{Pictures short}} {{Spell check|}} {{Changed short|06.10.2012}} [[DDF_DMXC2|Kapitel 31: DDF Grundlagen]] 
{{Stage short|75%|06.10.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[DDF Creator_DMXC2|Kapitel 32: Der DDFCreator]] 
{{Stage short|100%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Plugin:Beamertool_DMXC2|Kapitel 33: Plugin: Beamertool]] 
{{Stage short|100%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Plugin:MadMaxOne_DMXC2|Kapitel 34: Plugin: MadMaxOne]] 
{{Stage short|75%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Plugin:OSC Receiver_DMXC2|Kapitel 35: Plugin: OSC Receiver Modul]] 
{{Stage short|00%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Addon:Visualizer Magic EasyView_DMXC2|Kapitel 36: Addon: Magic EasyView Visualizer]] 
{{Stage short|50%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Glossar_DMXC2|Anhang1: Glossar]] 
{{Stage short|75%|31.10.2012}} {{Pictures short|18.9.2012}} {{Spell check|}} {{Changed short|31.10.2012}} [[Befehlsübersicht_DMXC2|Anhang2: Befehlsübersicht]] 
|}

[[Bild: DMXC2_Manual_Hauptseite_By-nc-nd.eu.png |150px| By-nc-nd.eu-Lizenz]]

Das Handbuch DMXControl 2.12 von DMXControl Projects e.V. steht unter einer [http://creativecommons.org/licenses/by-nc-nd/3.0/de/ Creative Commons Namensnennung-NichtKommerziell-KeineBearbeitung 3.0 Deutschland Lizenz].

[[de:Handbuch DMXControl 2]]
[[en:Manual DMXControl 2]]

Audioplayer DMXC2

2012-11-06T17:53:39Z

Wdunczewski:

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

{{Hinweis
|Text = 16.09. Review Uwe: O.K. 
05.10.2012 Jens-Peter und Uwe Review: Überprüfen ob Laufzeitbalken" im Audioplayer sollen sich dem Speedmaster anpassen FS#629
im Artikel enthalten. 
Uhr-Button beschreiben, Hints in Audiospur beschreiben 
Audioplayer: Bar graphs representing scene length now take speedmaster into account (FS#629) 
01.11.2012 Uwe: Artikel ist fertig und kann nach Review auf 100% gesetzt werden. Falls was fehlt bitte Kommentar hier. 
06.11.2012 Wolfgang Dunczewski: Rechtschreibkorrekturen 
}}
{{Start-LaTeX}}
==Überblick==

Mit dem Audioplayer können Audiotitel mit Szenen, Effekten und Befehlen unterlegt werden. Im Prinzip bietet der Audioplayer eine andere Oberfläche für eine [[Szenenliste_DMXC2|Szenenliste]], ähnlich dem Textbuch und dem Timecode-Player, nur dass hier die Möglichkeit besteht, die Szenen punktgenau zum Verlauf des Songs zu verankern. Hierdurch lassen sich für einzelne Songs individuelle Lightshows erstellen.

==Beschreibung==

Ein auffälliges Merkmal des Audioplayers sind die beiden Audiospuren, welche die Stereospuren eines Musiktitels präsentieren (linker Kanal: grün, rechter Kanal: rot). In diesem Fensterbereich wird der zeitliche Verlauf mit den entsprechenden Amplituden des Songs und die gesetzten Szenen angezeigt. Bei leistungsschwachen Computern empfiehlt es sich, mit der Checkbox "Grafik nicht laden" die Anzeige des Amplitudenverlaufs zu unterdrücken, wodurch CPU-Leistung eingespart wird.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_Fenster.png|1|Der Audioplayer|center|600px}}
<br\>
{{BoxWichtig
|Text = Der Audioplayer dient der Verlichtung von Audiodateien. Wenn es lediglich um das Abspielen von Audiodateien geht, ist die Audioszene zu bevorzugen. Dort können auch mehrere Audiokanäle (bis zu 16 Stück) parallel abspielen.
}}

==Bedienelemente==
{| class="wikitable centered"
|- style="vertical-align:top;"
! Icon
! Bezeichnung
! Beschreibung
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_DMXControl.png]]
|style="width: 170px; vertical-align:middle"| DMXControl
|style="width: 380px"| Mit dem Button DMXControl im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über DMXControl gestartet und abgespielt werden.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_WinAmp.png]]
|style="width: 170px; vertical-align:middle"| WinAmp
|style="width: 380px"| Mit dem Button WinAmp im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über das externe Programm WinAmp gestartet und abgespielt werden. (Synchronisation mit WinAmp)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Play.png]]
|style="width: 170px; vertical-align:middle"| Play
|style="width: 380px"| Der Play-Button startet das Soundfile und die Audio-Szeneliste, wenn der DMXControl-Button betätigt ist.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Rewind.png]]
|style="width: 170px; vertical-align:middle"| Rewind
|style="width: 380px"| Mit diesem Button wird der Audio-Cursor wieder auf den Anfang des Songs positioniert. (Dies funktioniert auch beim Abspielen des Soundfiles)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Repeat.png]]
|style="width: 170px; vertical-align:middle"| Repeat
|style="width: 380px"| Ist dieser Button betätigt, dann wird das Soundfile nach dem Beenden wieder von vorne abgespielt.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Vorhören.png]]
|style="width: 170px; vertical-align:middle"| Vorhören
|style="width: 380px"| Mit dem Vorhören-Button wird das Soundfile ab der aktuellen Audio-Cursor Position abgespielt. Bei einem erneuten Klick auf den Button stoppt der Player und der Audio-Cursor kehrt in seine Ausgangsposition zurück.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Zoom.png]]
|style="width: 170px; vertical-align:middle"| Zoom
|style="width: 380px"| Mit dem Zoom Dropdown lässt sich die Audiospur vergrößern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Grafik_nicht_laden.png]]
|style="width: 170px; vertical-align:middle"| Grafik nicht laden
|style="width: 380px"| Wenn die Checkbox markiert ist, wird die Audiospur-Grafik nicht geladen. Dadurch lässt sich bei langsamen Computern die Performance steigern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Uhr.png]]
|style="width: 170px; vertical-align:middle"| Uhr
|style="width: 380px"| Mit dem Uhr-Button wird die gerade markierte Szene in der Audio-Szenenliste auf die aktuelle Audio-Cursor-Position verschoben.
|}

Die restlichen Buttons sind Standard-Buttons bzw. selbsterklärend.

===Audiospur===
*Ein '''gelber''' senkrechter Strich in der Audiospur stellt die aktuelle Positionsmarkierung des Audio-Cursors dar.
*Ein '''weißer''' senkrechter Strich in der Audiospur zeigt die Szenen-Markierung mit bereits zugeordneten Positionen an.
*Die '''blauer''' senkrechter Strich in der Audiospur wird angezeigt, wenn der Audio-Cursor auf einer zugeordneten Szene-Markierung steht.

Wenn man mit dem Maus-Cursor auf einer Szenen-Markierung ist, verwandelt sich der Mauszeiger in einen Doppel-Pfeil. Außerdem wird ein Tooltip mit dem Namen der Szene angezeigt. Durch Klicken und festhalten der linken Maustaste, kann die Szenen-Markierung positioniert werden.

{{BoxHinweis
| Text=Befindet sich der Mauszeiger auf der Audiospur und nicht auf einer Szenen-Markierung, dann wird ein ToolTip angezeigt, der lediglich einen Bindestrich enthält. Dieser ToolTip ist ohne weitere Bedeutung.
}}

===Audioprojekt Verwalten===
*'''Hinzufügen-Button:''' Durch diesen Button lässt sich ein neues Audiotrack-Projekt erstellen.
*'''Öffnen-Button:''' Mit diesem Button weist man dem Audiotrack-Projekt ein Audiofile zu. Mögliche Audiofiles müssen vom Typ mp3, mp2, mp1, wav oder ogg sein.
*'''Verwalten-Button''' Hinter diesem Button verbergen sich die Menüpunkte '''Hinzufügen''', '''Kopieren''', '''Umbenennen''', '''Löschen''' und '''Verwalten'''. Mit ihnen können die Audiolisten verwaltet werden.

{{BoxWichtig
| Text = Bei Audiodateien mit variabler Bitrate (VBR) gibt es Probleme mit einem gewissen "Zeitversatz". 
Daher ist es am besten, Audiodateien mit konstanter Bitrate (z.b. 128kBit oder 320kBit) zu verwenden.
}}

===Bedienung===
Beim Klick mit der Maustaste in das Audiofenster erscheint an dieser Stelle der Audio-Cursor (gelber Strich). Damit lässt sich z.B. im '''Play'''-Mode (Drücken des Play-Buttons) an eine beliebige Stelle springen, um diese zu hören.
Ein Doppel-Klick ins Audiofenster startet den '''Play'''-Mode an der entsprechenden Stelle. Ein erneuter Doppel-Klick stoppt den '''Play'''-Mode.

Neue Szenen können folgendermaßen zugewiesen werden:

*Hören Sie den Titel und achten Sie in der Grafik auf markante Stellen im Song, wo Sie Szenen, Effekte oder Befehle positionieren wollen. Diese Aktion erfolgt genau wie in anderen DMXControl-Tools durch Drücken des grünen '''Plus'''-Buttons.
*Besonders fixe Nutzer schaffen das sogar im Play-Mode. Normalerweise stoppt man aber den Titel und positioniert den Cursor exakt an der gewünschten Stelle. Um das ganz genau hinzubekommen, gibt es zwei Möglichkeiten:
**Man vergrößert das Audioplayer-Fenster über die Breite des gesamten Bildschirms oder
**man kann einen Zoom-Faktor für die grafische Darstellung der Amplituden einstellen.
*Erstellen Sie eine neue Szene, wählen Sie eine aus der Szenenbibliothek oder definieren Sie einen Befehl.
*Sie können übrigens die Position eines Befehls im Audiotrack verändern, indem Sie den zugeordneten blauen Balken mit der Maus verschieben (Doppelpfeilcursor). Die neue Position wird in der Befehlsliste aktualisiert. Durch einen Klick auf den Listenkopf "Position" werden die Befehle aufsteigend oder absteigend sortiert.
*Die Fade-In-Zeit kann durch Anklicken der entsprechenden Zelle in der Tabelle angepasst werden.
*Wenn Sie die Häkchen vor den Befehlsnamen ausschalten, wird der entsprechende Befehl deaktiviert, verbleibt aber in der Trackdefinition. Dies kann man in der Erstellungsphase nutzen, um die Wechselwirkung einzelner Effekte zu testen, bis man die richtige Kombination gefunden hat.

==Modulbezogene Befehle==

* Modul: '''Audiotrack'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 105px"| Gerät/Funktion
!style="width: 195px"| Beschreibung
!style="width: 105px"| Kanal
!style="width: 195px"| Beschreibung
|- style="vertical-align:top;"
|rowspan="4"| Ausgewählte
|rowspan="4"| Der weitere Befehl wird auf den aktuell ausgewählten Audiotrack angewendet. (Der Befehl Auswählen macht bei dieser Funktion keinen Sinn)
| Start/Stopp
| Der Befehl ''Start/Stopp'' startet und stoppt den ausgewählten Audiotrack zur Wiedergabe. (Der Befehl sollte im Zusammenhang mit dem T-Flag eingesetzt werden.)
|- style="vertical-align:top;"
| Start
| Der Befehl ''Start'' startet den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| Stopp
| Der Befehl ''Stopp'' stoppt den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| zurück Spulen
| Durch den Befehl ''zurück spulen'' Springt der Audio-Cursor wieder an den Anfang des Soundfiles.
|- style="vertical-align:top;"
|rowspan="2"| Nächste Vorherige Sonstige Einträge
|rowspan="2"| Der weitere Befehl wird auf den nächsten, vorherigen oder im Dropdown benannten Audiotrack angewendet.
| Auswählen
| Wählt den nächsten, vorherigen bzw. den im Dropdown ''Gerät/Funktion'' benannten Audiotrack aus.
|- style="vertical-align:top;"
| Start/Stopp Start Stopp zurück spulen
| siehe oben
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabefenster öffnet, in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt, um eine korrekte Funktion zu gewährleisten.
|}

==Tipps==

====Synchronisation des Audioplayers mit Winamp====

Der Audioplayer kann auch mit einer Playlist des Wimamp-Players synchronisiert werden:

*Der '''DMXControl'''-Button stellt den normalen Audioplayer-Mode ein.
*Der Audioplayer kann sich mit der Playliste des Winamp-Players synchronisieren, wenn Sie den '''Winamp'''-Button aktivieren. In diesem Fall sucht der Audioplayer, ob der gerade in der Playlist gespielte Song auch ein Audioplayer-Track ist und startet dann die entsprechenden Szenen und Effekte. Die Musiksteuerung (z.B. auch das Springen zu bestimmten Stellen) obliegt dann Winamp.

Der Vorteil dieses Betriebskonzeptes liegt darin, dass man dann natürlich synchrone Beats vom Beattrigger erhält, die musikgesteuerte Effekte triggern können. Dazu muss das Winamp AVS-Plugin installiert sein. Die Trackliste und die Winamp-Playlist synchronisieren sich über den in Winamp angezeigten Titel, meist dem mp3-ID3-tag des Songs. Diesen kann man z.B. in Winamp im Menü "File->View file.info ..." einsehen und auch verändern (siehe folgendes Bild). Natürlich geht das auch mit anderen mp3-Editoren. Der angezeigte Titel ist in Winamp bei "Einstellungen /Titel/Erweiterte Titelformatierung" veränderbar.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_TrackInformation.png|2|Trackinformationen in Winamp|center|400px}}

Um diesen Modus zu starten, muss der '''Winamp-Button''' aktiviert sein (siehe Punkt 1 im folgenden Bild). Ganz '''wichtig''' ist, dass der Trackname mit dem angezeigten Titel des Songs übereinstimmt (siehe Punkt2 im Bild). Ob die Synchronisation erfolgreich ist, erkennt man daran, ob im Feld Audiodatei (wo der Songdateiname angegeben ist) ein "(X)" für erfolgreich oder ein "(-)" für nicht gefunden erscheint (siehe Punkt 3 im Bild).
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_WinampSteuerung.png|3|Synchronisisation des Audioplayers mit Winamp|center|750px}}
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

[[Kategorie:DMXControl 2]]

Audioplayer DMXC2

2012-11-06T17:52:55Z

Wdunczewski: /* Synchronisation des Audioplayers mit Winamp */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

{{Hinweis
|Text = 16.09. Review Uwe: O.K. 
05.10.2012 Jens-Peter und Uwe Review: Überprüfen ob Laufzeitbalken" im Audioplayer sollen sich dem Speedmaster anpassen FS#629
im Artikel enthalten. 
Uhr-Button beschreiben, Hints in Audiospur beschreiben 
Audioplayer: Bar graphs representing scene length now take speedmaster into account (FS#629) 
01.11.2012 Uwe: Artikel ist fertig und kann nach Review auf 100% gesetzt werden. Falls was fehlt bitte Kommentar hier. 
}}
{{Start-LaTeX}}
==Überblick==

Mit dem Audioplayer können Audiotitel mit Szenen, Effekten und Befehlen unterlegt werden. Im Prinzip bietet der Audioplayer eine andere Oberfläche für eine [[Szenenliste_DMXC2|Szenenliste]], ähnlich dem Textbuch und dem Timecode-Player, nur dass hier die Möglichkeit besteht, die Szenen punktgenau zum Verlauf des Songs zu verankern. Hierdurch lassen sich für einzelne Songs individuelle Lightshows erstellen.

==Beschreibung==

Ein auffälliges Merkmal des Audioplayers sind die beiden Audiospuren, welche die Stereospuren eines Musiktitels präsentieren (linker Kanal: grün, rechter Kanal: rot). In diesem Fensterbereich wird der zeitliche Verlauf mit den entsprechenden Amplituden des Songs und die gesetzten Szenen angezeigt. Bei leistungsschwachen Computern empfiehlt es sich, mit der Checkbox "Grafik nicht laden" die Anzeige des Amplitudenverlaufs zu unterdrücken, wodurch CPU-Leistung eingespart wird.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_Fenster.png|1|Der Audioplayer|center|600px}}
<br\>
{{BoxWichtig
|Text = Der Audioplayer dient der Verlichtung von Audiodateien. Wenn es lediglich um das Abspielen von Audiodateien geht, ist die Audioszene zu bevorzugen. Dort können auch mehrere Audiokanäle (bis zu 16 Stück) parallel abspielen.
}}

==Bedienelemente==
{| class="wikitable centered"
|- style="vertical-align:top;"
! Icon
! Bezeichnung
! Beschreibung
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_DMXControl.png]]
|style="width: 170px; vertical-align:middle"| DMXControl
|style="width: 380px"| Mit dem Button DMXControl im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über DMXControl gestartet und abgespielt werden.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_WinAmp.png]]
|style="width: 170px; vertical-align:middle"| WinAmp
|style="width: 380px"| Mit dem Button WinAmp im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über das externe Programm WinAmp gestartet und abgespielt werden. (Synchronisation mit WinAmp)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Play.png]]
|style="width: 170px; vertical-align:middle"| Play
|style="width: 380px"| Der Play-Button startet das Soundfile und die Audio-Szeneliste, wenn der DMXControl-Button betätigt ist.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Rewind.png]]
|style="width: 170px; vertical-align:middle"| Rewind
|style="width: 380px"| Mit diesem Button wird der Audio-Cursor wieder auf den Anfang des Songs positioniert. (Dies funktioniert auch beim Abspielen des Soundfiles)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Repeat.png]]
|style="width: 170px; vertical-align:middle"| Repeat
|style="width: 380px"| Ist dieser Button betätigt, dann wird das Soundfile nach dem Beenden wieder von vorne abgespielt.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Vorhören.png]]
|style="width: 170px; vertical-align:middle"| Vorhören
|style="width: 380px"| Mit dem Vorhören-Button wird das Soundfile ab der aktuellen Audio-Cursor Position abgespielt. Bei einem erneuten Klick auf den Button stoppt der Player und der Audio-Cursor kehrt in seine Ausgangsposition zurück.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Zoom.png]]
|style="width: 170px; vertical-align:middle"| Zoom
|style="width: 380px"| Mit dem Zoom Dropdown lässt sich die Audiospur vergrößern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Grafik_nicht_laden.png]]
|style="width: 170px; vertical-align:middle"| Grafik nicht laden
|style="width: 380px"| Wenn die Checkbox markiert ist, wird die Audiospur-Grafik nicht geladen. Dadurch lässt sich bei langsamen Computern die Performance steigern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Uhr.png]]
|style="width: 170px; vertical-align:middle"| Uhr
|style="width: 380px"| Mit dem Uhr-Button wird die gerade markierte Szene in der Audio-Szenenliste auf die aktuelle Audio-Cursor-Position verschoben.
|}

Die restlichen Buttons sind Standard-Buttons bzw. selbsterklärend.

===Audiospur===
*Ein '''gelber''' senkrechter Strich in der Audiospur stellt die aktuelle Positionsmarkierung des Audio-Cursors dar.
*Ein '''weißer''' senkrechter Strich in der Audiospur zeigt die Szenen-Markierung mit bereits zugeordneten Positionen an.
*Die '''blauer''' senkrechter Strich in der Audiospur wird angezeigt, wenn der Audio-Cursor auf einer zugeordneten Szene-Markierung steht.

Wenn man mit dem Maus-Cursor auf einer Szenen-Markierung ist, verwandelt sich der Mauszeiger in einen Doppel-Pfeil. Außerdem wird ein Tooltip mit dem Namen der Szene angezeigt. Durch Klicken und festhalten der linken Maustaste, kann die Szenen-Markierung positioniert werden.

{{BoxHinweis
| Text=Befindet sich der Mauszeiger auf der Audiospur und nicht auf einer Szenen-Markierung, dann wird ein ToolTip angezeigt, der lediglich einen Bindestrich enthält. Dieser ToolTip ist ohne weitere Bedeutung.
}}

===Audioprojekt Verwalten===
*'''Hinzufügen-Button:''' Durch diesen Button lässt sich ein neues Audiotrack-Projekt erstellen.
*'''Öffnen-Button:''' Mit diesem Button weist man dem Audiotrack-Projekt ein Audiofile zu. Mögliche Audiofiles müssen vom Typ mp3, mp2, mp1, wav oder ogg sein.
*'''Verwalten-Button''' Hinter diesem Button verbergen sich die Menüpunkte '''Hinzufügen''', '''Kopieren''', '''Umbenennen''', '''Löschen''' und '''Verwalten'''. Mit ihnen können die Audiolisten verwaltet werden.

{{BoxWichtig
| Text = Bei Audiodateien mit variabler Bitrate (VBR) gibt es Probleme mit einem gewissen "Zeitversatz". 
Daher ist es am besten, Audiodateien mit konstanter Bitrate (z.b. 128kBit oder 320kBit) zu verwenden.
}}

===Bedienung===
Beim Klick mit der Maustaste in das Audiofenster erscheint an dieser Stelle der Audio-Cursor (gelber Strich). Damit lässt sich z.B. im '''Play'''-Mode (Drücken des Play-Buttons) an eine beliebige Stelle springen, um diese zu hören.
Ein Doppel-Klick ins Audiofenster startet den '''Play'''-Mode an der entsprechenden Stelle. Ein erneuter Doppel-Klick stoppt den '''Play'''-Mode.

Neue Szenen können folgendermaßen zugewiesen werden:

*Hören Sie den Titel und achten Sie in der Grafik auf markante Stellen im Song, wo Sie Szenen, Effekte oder Befehle positionieren wollen. Diese Aktion erfolgt genau wie in anderen DMXControl-Tools durch Drücken des grünen '''Plus'''-Buttons.
*Besonders fixe Nutzer schaffen das sogar im Play-Mode. Normalerweise stoppt man aber den Titel und positioniert den Cursor exakt an der gewünschten Stelle. Um das ganz genau hinzubekommen, gibt es zwei Möglichkeiten:
**Man vergrößert das Audioplayer-Fenster über die Breite des gesamten Bildschirms oder
**man kann einen Zoom-Faktor für die grafische Darstellung der Amplituden einstellen.
*Erstellen Sie eine neue Szene, wählen Sie eine aus der Szenenbibliothek oder definieren Sie einen Befehl.
*Sie können übrigens die Position eines Befehls im Audiotrack verändern, indem Sie den zugeordneten blauen Balken mit der Maus verschieben (Doppelpfeilcursor). Die neue Position wird in der Befehlsliste aktualisiert. Durch einen Klick auf den Listenkopf "Position" werden die Befehle aufsteigend oder absteigend sortiert.
*Die Fade-In-Zeit kann durch Anklicken der entsprechenden Zelle in der Tabelle angepasst werden.
*Wenn Sie die Häkchen vor den Befehlsnamen ausschalten, wird der entsprechende Befehl deaktiviert, verbleibt aber in der Trackdefinition. Dies kann man in der Erstellungsphase nutzen, um die Wechselwirkung einzelner Effekte zu testen, bis man die richtige Kombination gefunden hat.

==Modulbezogene Befehle==

* Modul: '''Audiotrack'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 105px"| Gerät/Funktion
!style="width: 195px"| Beschreibung
!style="width: 105px"| Kanal
!style="width: 195px"| Beschreibung
|- style="vertical-align:top;"
|rowspan="4"| Ausgewählte
|rowspan="4"| Der weitere Befehl wird auf den aktuell ausgewählten Audiotrack angewendet. (Der Befehl Auswählen macht bei dieser Funktion keinen Sinn)
| Start/Stopp
| Der Befehl ''Start/Stopp'' startet und stoppt den ausgewählten Audiotrack zur Wiedergabe. (Der Befehl sollte im Zusammenhang mit dem T-Flag eingesetzt werden.)
|- style="vertical-align:top;"
| Start
| Der Befehl ''Start'' startet den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| Stopp
| Der Befehl ''Stopp'' stoppt den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| zurück Spulen
| Durch den Befehl ''zurück spulen'' Springt der Audio-Cursor wieder an den Anfang des Soundfiles.
|- style="vertical-align:top;"
|rowspan="2"| Nächste Vorherige Sonstige Einträge
|rowspan="2"| Der weitere Befehl wird auf den nächsten, vorherigen oder im Dropdown benannten Audiotrack angewendet.
| Auswählen
| Wählt den nächsten, vorherigen bzw. den im Dropdown ''Gerät/Funktion'' benannten Audiotrack aus.
|- style="vertical-align:top;"
| Start/Stopp Start Stopp zurück spulen
| siehe oben
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabefenster öffnet, in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt, um eine korrekte Funktion zu gewährleisten.
|}

==Tipps==

====Synchronisation des Audioplayers mit Winamp====

Der Audioplayer kann auch mit einer Playlist des Wimamp-Players synchronisiert werden:

*Der '''DMXControl'''-Button stellt den normalen Audioplayer-Mode ein.
*Der Audioplayer kann sich mit der Playliste des Winamp-Players synchronisieren, wenn Sie den '''Winamp'''-Button aktivieren. In diesem Fall sucht der Audioplayer, ob der gerade in der Playlist gespielte Song auch ein Audioplayer-Track ist und startet dann die entsprechenden Szenen und Effekte. Die Musiksteuerung (z.B. auch das Springen zu bestimmten Stellen) obliegt dann Winamp.

Der Vorteil dieses Betriebskonzeptes liegt darin, dass man dann natürlich synchrone Beats vom Beattrigger erhält, die musikgesteuerte Effekte triggern können. Dazu muss das Winamp AVS-Plugin installiert sein. Die Trackliste und die Winamp-Playlist synchronisieren sich über den in Winamp angezeigten Titel, meist dem mp3-ID3-tag des Songs. Diesen kann man z.B. in Winamp im Menü "File->View file.info ..." einsehen und auch verändern (siehe folgendes Bild). Natürlich geht das auch mit anderen mp3-Editoren. Der angezeigte Titel ist in Winamp bei "Einstellungen /Titel/Erweiterte Titelformatierung" veränderbar.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_TrackInformation.png|2|Trackinformationen in Winamp|center|400px}}

Um diesen Modus zu starten, muss der '''Winamp-Button''' aktiviert sein (siehe Punkt 1 im folgenden Bild). Ganz '''wichtig''' ist, dass der Trackname mit dem angezeigten Titel des Songs übereinstimmt (siehe Punkt2 im Bild). Ob die Synchronisation erfolgreich ist, erkennt man daran, ob im Feld Audiodatei (wo der Songdateiname angegeben ist) ein "(X)" für erfolgreich oder ein "(-)" für nicht gefunden erscheint (siehe Punkt 3 im Bild).
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_WinampSteuerung.png|3|Synchronisisation des Audioplayers mit Winamp|center|750px}}
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

[[Kategorie:DMXControl 2]]

Audioplayer DMXC2

2012-11-06T17:48:39Z

Wdunczewski: /* Modulbezogene Befehle */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

{{Hinweis
|Text = 16.09. Review Uwe: O.K. 
05.10.2012 Jens-Peter und Uwe Review: Überprüfen ob Laufzeitbalken" im Audioplayer sollen sich dem Speedmaster anpassen FS#629
im Artikel enthalten. 
Uhr-Button beschreiben, Hints in Audiospur beschreiben 
Audioplayer: Bar graphs representing scene length now take speedmaster into account (FS#629) 
01.11.2012 Uwe: Artikel ist fertig und kann nach Review auf 100% gesetzt werden. Falls was fehlt bitte Kommentar hier. 
}}
{{Start-LaTeX}}
==Überblick==

Mit dem Audioplayer können Audiotitel mit Szenen, Effekten und Befehlen unterlegt werden. Im Prinzip bietet der Audioplayer eine andere Oberfläche für eine [[Szenenliste_DMXC2|Szenenliste]], ähnlich dem Textbuch und dem Timecode-Player, nur dass hier die Möglichkeit besteht, die Szenen punktgenau zum Verlauf des Songs zu verankern. Hierdurch lassen sich für einzelne Songs individuelle Lightshows erstellen.

==Beschreibung==

Ein auffälliges Merkmal des Audioplayers sind die beiden Audiospuren, welche die Stereospuren eines Musiktitels präsentieren (linker Kanal: grün, rechter Kanal: rot). In diesem Fensterbereich wird der zeitliche Verlauf mit den entsprechenden Amplituden des Songs und die gesetzten Szenen angezeigt. Bei leistungsschwachen Computern empfiehlt es sich, mit der Checkbox "Grafik nicht laden" die Anzeige des Amplitudenverlaufs zu unterdrücken, wodurch CPU-Leistung eingespart wird.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_Fenster.png|1|Der Audioplayer|center|600px}}
<br\>
{{BoxWichtig
|Text = Der Audioplayer dient der Verlichtung von Audiodateien. Wenn es lediglich um das Abspielen von Audiodateien geht, ist die Audioszene zu bevorzugen. Dort können auch mehrere Audiokanäle (bis zu 16 Stück) parallel abspielen.
}}

==Bedienelemente==
{| class="wikitable centered"
|- style="vertical-align:top;"
! Icon
! Bezeichnung
! Beschreibung
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_DMXControl.png]]
|style="width: 170px; vertical-align:middle"| DMXControl
|style="width: 380px"| Mit dem Button DMXControl im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über DMXControl gestartet und abgespielt werden.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_WinAmp.png]]
|style="width: 170px; vertical-align:middle"| WinAmp
|style="width: 380px"| Mit dem Button WinAmp im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über das externe Programm WinAmp gestartet und abgespielt werden. (Synchronisation mit WinAmp)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Play.png]]
|style="width: 170px; vertical-align:middle"| Play
|style="width: 380px"| Der Play-Button startet das Soundfile und die Audio-Szeneliste, wenn der DMXControl-Button betätigt ist.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Rewind.png]]
|style="width: 170px; vertical-align:middle"| Rewind
|style="width: 380px"| Mit diesem Button wird der Audio-Cursor wieder auf den Anfang des Songs positioniert. (Dies funktioniert auch beim Abspielen des Soundfiles)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Repeat.png]]
|style="width: 170px; vertical-align:middle"| Repeat
|style="width: 380px"| Ist dieser Button betätigt, dann wird das Soundfile nach dem Beenden wieder von vorne abgespielt.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Vorhören.png]]
|style="width: 170px; vertical-align:middle"| Vorhören
|style="width: 380px"| Mit dem Vorhören-Button wird das Soundfile ab der aktuellen Audio-Cursor Position abgespielt. Bei einem erneuten Klick auf den Button stoppt der Player und der Audio-Cursor kehrt in seine Ausgangsposition zurück.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Zoom.png]]
|style="width: 170px; vertical-align:middle"| Zoom
|style="width: 380px"| Mit dem Zoom Dropdown lässt sich die Audiospur vergrößern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Grafik_nicht_laden.png]]
|style="width: 170px; vertical-align:middle"| Grafik nicht laden
|style="width: 380px"| Wenn die Checkbox markiert ist, wird die Audiospur-Grafik nicht geladen. Dadurch lässt sich bei langsamen Computern die Performance steigern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Uhr.png]]
|style="width: 170px; vertical-align:middle"| Uhr
|style="width: 380px"| Mit dem Uhr-Button wird die gerade markierte Szene in der Audio-Szenenliste auf die aktuelle Audio-Cursor-Position verschoben.
|}

Die restlichen Buttons sind Standard-Buttons bzw. selbsterklärend.

===Audiospur===
*Ein '''gelber''' senkrechter Strich in der Audiospur stellt die aktuelle Positionsmarkierung des Audio-Cursors dar.
*Ein '''weißer''' senkrechter Strich in der Audiospur zeigt die Szenen-Markierung mit bereits zugeordneten Positionen an.
*Die '''blauer''' senkrechter Strich in der Audiospur wird angezeigt, wenn der Audio-Cursor auf einer zugeordneten Szene-Markierung steht.

Wenn man mit dem Maus-Cursor auf einer Szenen-Markierung ist, verwandelt sich der Mauszeiger in einen Doppel-Pfeil. Außerdem wird ein Tooltip mit dem Namen der Szene angezeigt. Durch Klicken und festhalten der linken Maustaste, kann die Szenen-Markierung positioniert werden.

{{BoxHinweis
| Text=Befindet sich der Mauszeiger auf der Audiospur und nicht auf einer Szenen-Markierung, dann wird ein ToolTip angezeigt, der lediglich einen Bindestrich enthält. Dieser ToolTip ist ohne weitere Bedeutung.
}}

===Audioprojekt Verwalten===
*'''Hinzufügen-Button:''' Durch diesen Button lässt sich ein neues Audiotrack-Projekt erstellen.
*'''Öffnen-Button:''' Mit diesem Button weist man dem Audiotrack-Projekt ein Audiofile zu. Mögliche Audiofiles müssen vom Typ mp3, mp2, mp1, wav oder ogg sein.
*'''Verwalten-Button''' Hinter diesem Button verbergen sich die Menüpunkte '''Hinzufügen''', '''Kopieren''', '''Umbenennen''', '''Löschen''' und '''Verwalten'''. Mit ihnen können die Audiolisten verwaltet werden.

{{BoxWichtig
| Text = Bei Audiodateien mit variabler Bitrate (VBR) gibt es Probleme mit einem gewissen "Zeitversatz". 
Daher ist es am besten, Audiodateien mit konstanter Bitrate (z.b. 128kBit oder 320kBit) zu verwenden.
}}

===Bedienung===
Beim Klick mit der Maustaste in das Audiofenster erscheint an dieser Stelle der Audio-Cursor (gelber Strich). Damit lässt sich z.B. im '''Play'''-Mode (Drücken des Play-Buttons) an eine beliebige Stelle springen, um diese zu hören.
Ein Doppel-Klick ins Audiofenster startet den '''Play'''-Mode an der entsprechenden Stelle. Ein erneuter Doppel-Klick stoppt den '''Play'''-Mode.

Neue Szenen können folgendermaßen zugewiesen werden:

*Hören Sie den Titel und achten Sie in der Grafik auf markante Stellen im Song, wo Sie Szenen, Effekte oder Befehle positionieren wollen. Diese Aktion erfolgt genau wie in anderen DMXControl-Tools durch Drücken des grünen '''Plus'''-Buttons.
*Besonders fixe Nutzer schaffen das sogar im Play-Mode. Normalerweise stoppt man aber den Titel und positioniert den Cursor exakt an der gewünschten Stelle. Um das ganz genau hinzubekommen, gibt es zwei Möglichkeiten:
**Man vergrößert das Audioplayer-Fenster über die Breite des gesamten Bildschirms oder
**man kann einen Zoom-Faktor für die grafische Darstellung der Amplituden einstellen.
*Erstellen Sie eine neue Szene, wählen Sie eine aus der Szenenbibliothek oder definieren Sie einen Befehl.
*Sie können übrigens die Position eines Befehls im Audiotrack verändern, indem Sie den zugeordneten blauen Balken mit der Maus verschieben (Doppelpfeilcursor). Die neue Position wird in der Befehlsliste aktualisiert. Durch einen Klick auf den Listenkopf "Position" werden die Befehle aufsteigend oder absteigend sortiert.
*Die Fade-In-Zeit kann durch Anklicken der entsprechenden Zelle in der Tabelle angepasst werden.
*Wenn Sie die Häkchen vor den Befehlsnamen ausschalten, wird der entsprechende Befehl deaktiviert, verbleibt aber in der Trackdefinition. Dies kann man in der Erstellungsphase nutzen, um die Wechselwirkung einzelner Effekte zu testen, bis man die richtige Kombination gefunden hat.

==Modulbezogene Befehle==

* Modul: '''Audiotrack'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 105px"| Gerät/Funktion
!style="width: 195px"| Beschreibung
!style="width: 105px"| Kanal
!style="width: 195px"| Beschreibung
|- style="vertical-align:top;"
|rowspan="4"| Ausgewählte
|rowspan="4"| Der weitere Befehl wird auf den aktuell ausgewählten Audiotrack angewendet. (Der Befehl Auswählen macht bei dieser Funktion keinen Sinn)
| Start/Stopp
| Der Befehl ''Start/Stopp'' startet und stoppt den ausgewählten Audiotrack zur Wiedergabe. (Der Befehl sollte im Zusammenhang mit dem T-Flag eingesetzt werden.)
|- style="vertical-align:top;"
| Start
| Der Befehl ''Start'' startet den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| Stopp
| Der Befehl ''Stopp'' stoppt den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| zurück Spulen
| Durch den Befehl ''zurück spulen'' Springt der Audio-Cursor wieder an den Anfang des Soundfiles.
|- style="vertical-align:top;"
|rowspan="2"| Nächste Vorherige Sonstige Einträge
|rowspan="2"| Der weitere Befehl wird auf den nächsten, vorherigen oder im Dropdown benannten Audiotrack angewendet.
| Auswählen
| Wählt den nächsten, vorherigen bzw. den im Dropdown ''Gerät/Funktion'' benannten Audiotrack aus.
|- style="vertical-align:top;"
| Start/Stopp Start Stopp zurück spulen
| siehe oben
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabefenster öffnet, in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt, um eine korrekte Funktion zu gewährleisten.
|}

==Tipps==

====Synchronisation des Audioplayers mit Winamp====

Der Audioplayer kann auch mit einer Playlist des Wimamp-Players synchronisiert werden:

*Der '''DMXControl'''-Button stellt den normalen Audioplayer-Mode ein.
*Der Audioplayer kann sich mit der Playliste des Winamp-Players synchronisieren, wenn Sie den '''Winamp'''-Button aktivieren. In diesem Fall sucht der Audioplayer, ob der gerade in der Playlist gespielte Song auch ein Audioplayer-Track ist und startet dann die entsprechenden Szenen und Effekte. Die Musiksteuerung (z.B. auch das Springen zu bestimmten Stellen) obliegt dann Winamp.

Der Vorteil dieses Betriebskonzeptes liegt darin, dass man dann natürlich synchrone Beats vom Beattrigger erhält, die musikgesteuerte Effekte triggern können. Dazu muß muß das Winamp AVS-Plugin installiert sein. Die Trackliste und die Winamp-Playlist synchronisieren sich über den in Winamp angezeigten Titel, meist der mp3-ID3-tag der Songs. Diesen kann man z.B. in Winamp im Menü "File->View file.info ..." einsehen und auch verändern (siehe folgendes Bild), natürlich geht das auch mit anderen mp3-Editoren. Der angezeigte Titel ist in Winamp bei "Einstellungen /Titel/Erweiterte Titelformatierung" veränderbar.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_TrackInformation.png|2|Trackinformationen in Winamp|center|400px}}

Um diesen Modus zu starten muß der '''Winamp-Button''' aktiviert sein (siehe Punkt 1 im folgenden Bild). Ganz '''wichtig''' ist, dass der Trackname mit dem angezeigten Titel des Songs übereinstimmt (siehe Punkt2 im Bild). Ob die Synchronisation erfolgreich ist, erkennt man daran, ob im Feld Audiodatei (wo der Songdateiname angegeben ist) ein "(X)" für erfolgreich oder ein "(-)" für nicht gefunden erscheint (siehe Punkt 3 im Bild).
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_WinampSteuerung.png|3|Synchronisisation des Audioplayers mit Winamp|center|750px}}
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

[[Kategorie:DMXControl 2]]

Audioplayer DMXC2

2012-11-06T17:48:11Z

Wdunczewski: /* Modulbezogene Befehle */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

{{Hinweis
|Text = 16.09. Review Uwe: O.K. 
05.10.2012 Jens-Peter und Uwe Review: Überprüfen ob Laufzeitbalken" im Audioplayer sollen sich dem Speedmaster anpassen FS#629
im Artikel enthalten. 
Uhr-Button beschreiben, Hints in Audiospur beschreiben 
Audioplayer: Bar graphs representing scene length now take speedmaster into account (FS#629) 
01.11.2012 Uwe: Artikel ist fertig und kann nach Review auf 100% gesetzt werden. Falls was fehlt bitte Kommentar hier. 
}}
{{Start-LaTeX}}
==Überblick==

Mit dem Audioplayer können Audiotitel mit Szenen, Effekten und Befehlen unterlegt werden. Im Prinzip bietet der Audioplayer eine andere Oberfläche für eine [[Szenenliste_DMXC2|Szenenliste]], ähnlich dem Textbuch und dem Timecode-Player, nur dass hier die Möglichkeit besteht, die Szenen punktgenau zum Verlauf des Songs zu verankern. Hierdurch lassen sich für einzelne Songs individuelle Lightshows erstellen.

==Beschreibung==

Ein auffälliges Merkmal des Audioplayers sind die beiden Audiospuren, welche die Stereospuren eines Musiktitels präsentieren (linker Kanal: grün, rechter Kanal: rot). In diesem Fensterbereich wird der zeitliche Verlauf mit den entsprechenden Amplituden des Songs und die gesetzten Szenen angezeigt. Bei leistungsschwachen Computern empfiehlt es sich, mit der Checkbox "Grafik nicht laden" die Anzeige des Amplitudenverlaufs zu unterdrücken, wodurch CPU-Leistung eingespart wird.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_Fenster.png|1|Der Audioplayer|center|600px}}
<br\>
{{BoxWichtig
|Text = Der Audioplayer dient der Verlichtung von Audiodateien. Wenn es lediglich um das Abspielen von Audiodateien geht, ist die Audioszene zu bevorzugen. Dort können auch mehrere Audiokanäle (bis zu 16 Stück) parallel abspielen.
}}

==Bedienelemente==
{| class="wikitable centered"
|- style="vertical-align:top;"
! Icon
! Bezeichnung
! Beschreibung
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_DMXControl.png]]
|style="width: 170px; vertical-align:middle"| DMXControl
|style="width: 380px"| Mit dem Button DMXControl im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über DMXControl gestartet und abgespielt werden.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_WinAmp.png]]
|style="width: 170px; vertical-align:middle"| WinAmp
|style="width: 380px"| Mit dem Button WinAmp im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über das externe Programm WinAmp gestartet und abgespielt werden. (Synchronisation mit WinAmp)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Play.png]]
|style="width: 170px; vertical-align:middle"| Play
|style="width: 380px"| Der Play-Button startet das Soundfile und die Audio-Szeneliste, wenn der DMXControl-Button betätigt ist.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Rewind.png]]
|style="width: 170px; vertical-align:middle"| Rewind
|style="width: 380px"| Mit diesem Button wird der Audio-Cursor wieder auf den Anfang des Songs positioniert. (Dies funktioniert auch beim Abspielen des Soundfiles)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Repeat.png]]
|style="width: 170px; vertical-align:middle"| Repeat
|style="width: 380px"| Ist dieser Button betätigt, dann wird das Soundfile nach dem Beenden wieder von vorne abgespielt.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Vorhören.png]]
|style="width: 170px; vertical-align:middle"| Vorhören
|style="width: 380px"| Mit dem Vorhören-Button wird das Soundfile ab der aktuellen Audio-Cursor Position abgespielt. Bei einem erneuten Klick auf den Button stoppt der Player und der Audio-Cursor kehrt in seine Ausgangsposition zurück.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Zoom.png]]
|style="width: 170px; vertical-align:middle"| Zoom
|style="width: 380px"| Mit dem Zoom Dropdown lässt sich die Audiospur vergrößern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Grafik_nicht_laden.png]]
|style="width: 170px; vertical-align:middle"| Grafik nicht laden
|style="width: 380px"| Wenn die Checkbox markiert ist, wird die Audiospur-Grafik nicht geladen. Dadurch lässt sich bei langsamen Computern die Performance steigern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Uhr.png]]
|style="width: 170px; vertical-align:middle"| Uhr
|style="width: 380px"| Mit dem Uhr-Button wird die gerade markierte Szene in der Audio-Szenenliste auf die aktuelle Audio-Cursor-Position verschoben.
|}

Die restlichen Buttons sind Standard-Buttons bzw. selbsterklärend.

===Audiospur===
*Ein '''gelber''' senkrechter Strich in der Audiospur stellt die aktuelle Positionsmarkierung des Audio-Cursors dar.
*Ein '''weißer''' senkrechter Strich in der Audiospur zeigt die Szenen-Markierung mit bereits zugeordneten Positionen an.
*Die '''blauer''' senkrechter Strich in der Audiospur wird angezeigt, wenn der Audio-Cursor auf einer zugeordneten Szene-Markierung steht.

Wenn man mit dem Maus-Cursor auf einer Szenen-Markierung ist, verwandelt sich der Mauszeiger in einen Doppel-Pfeil. Außerdem wird ein Tooltip mit dem Namen der Szene angezeigt. Durch Klicken und festhalten der linken Maustaste, kann die Szenen-Markierung positioniert werden.

{{BoxHinweis
| Text=Befindet sich der Mauszeiger auf der Audiospur und nicht auf einer Szenen-Markierung, dann wird ein ToolTip angezeigt, der lediglich einen Bindestrich enthält. Dieser ToolTip ist ohne weitere Bedeutung.
}}

===Audioprojekt Verwalten===
*'''Hinzufügen-Button:''' Durch diesen Button lässt sich ein neues Audiotrack-Projekt erstellen.
*'''Öffnen-Button:''' Mit diesem Button weist man dem Audiotrack-Projekt ein Audiofile zu. Mögliche Audiofiles müssen vom Typ mp3, mp2, mp1, wav oder ogg sein.
*'''Verwalten-Button''' Hinter diesem Button verbergen sich die Menüpunkte '''Hinzufügen''', '''Kopieren''', '''Umbenennen''', '''Löschen''' und '''Verwalten'''. Mit ihnen können die Audiolisten verwaltet werden.

{{BoxWichtig
| Text = Bei Audiodateien mit variabler Bitrate (VBR) gibt es Probleme mit einem gewissen "Zeitversatz". 
Daher ist es am besten, Audiodateien mit konstanter Bitrate (z.b. 128kBit oder 320kBit) zu verwenden.
}}

===Bedienung===
Beim Klick mit der Maustaste in das Audiofenster erscheint an dieser Stelle der Audio-Cursor (gelber Strich). Damit lässt sich z.B. im '''Play'''-Mode (Drücken des Play-Buttons) an eine beliebige Stelle springen, um diese zu hören.
Ein Doppel-Klick ins Audiofenster startet den '''Play'''-Mode an der entsprechenden Stelle. Ein erneuter Doppel-Klick stoppt den '''Play'''-Mode.

Neue Szenen können folgendermaßen zugewiesen werden:

*Hören Sie den Titel und achten Sie in der Grafik auf markante Stellen im Song, wo Sie Szenen, Effekte oder Befehle positionieren wollen. Diese Aktion erfolgt genau wie in anderen DMXControl-Tools durch Drücken des grünen '''Plus'''-Buttons.
*Besonders fixe Nutzer schaffen das sogar im Play-Mode. Normalerweise stoppt man aber den Titel und positioniert den Cursor exakt an der gewünschten Stelle. Um das ganz genau hinzubekommen, gibt es zwei Möglichkeiten:
**Man vergrößert das Audioplayer-Fenster über die Breite des gesamten Bildschirms oder
**man kann einen Zoom-Faktor für die grafische Darstellung der Amplituden einstellen.
*Erstellen Sie eine neue Szene, wählen Sie eine aus der Szenenbibliothek oder definieren Sie einen Befehl.
*Sie können übrigens die Position eines Befehls im Audiotrack verändern, indem Sie den zugeordneten blauen Balken mit der Maus verschieben (Doppelpfeilcursor). Die neue Position wird in der Befehlsliste aktualisiert. Durch einen Klick auf den Listenkopf "Position" werden die Befehle aufsteigend oder absteigend sortiert.
*Die Fade-In-Zeit kann durch Anklicken der entsprechenden Zelle in der Tabelle angepasst werden.
*Wenn Sie die Häkchen vor den Befehlsnamen ausschalten, wird der entsprechende Befehl deaktiviert, verbleibt aber in der Trackdefinition. Dies kann man in der Erstellungsphase nutzen, um die Wechselwirkung einzelner Effekte zu testen, bis man die richtige Kombination gefunden hat.

==Modulbezogene Befehle==

* Modul: '''Audiotrack'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 105px"| Gerät/Funktion
!style="width: 195px"| Beschreibung
!style="width: 105px"| Kanal
!style="width: 195px"| Beschreibung
|- style="vertical-align:top;"
|rowspan="4"| Ausgewählte
|rowspan="4"| Der weitere Befehl wird auf den aktuell ausgewählten Audiotrack angewendet. (Der Befehl Auswählen macht bei dieser Funktion keinen Sinn)
| Start/Stop
| Der Befehl ''Start/Stopp'' startet und stoppt den ausgewählten Audiotrack zur Wiedergabe. (Der Befehl sollte im Zusammenhang mit dem T-Flag eingesetzt werden.)
|- style="vertical-align:top;"
| Start
| Der Befehl ''Start'' startet den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| Stop
| Der Befehl ''Stopp'' stoppt den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| zurück Spulen
| Durch den Befehl ''zurück spulen'' Springt der Audio-Cursor wieder an den Anfang des Soundfiles.
|- style="vertical-align:top;"
|rowspan="2"| Nächste Vorherige Sonstige Einträge
|rowspan="2"| Der weitere Befehl wird auf den nächsten, vorherigen oder im Dropdown benannten Audiotrack angewendet.
| Auswählen
| Wählt den nächsten, vorherigen bzw. den im Dropdown ''Gerät/Funktion'' benannten Audiotrack aus.
|- style="vertical-align:top;"
| Start/Stopp Start Stopp zurück spulen
| siehe oben
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabefenster öffnet, in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt, um eine korrekte Funktion zu gewährleisten.
|}

==Tipps==

====Synchronisation des Audioplayers mit Winamp====

Der Audioplayer kann auch mit einer Playlist des Wimamp-Players synchronisiert werden:

*Der '''DMXControl'''-Button stellt den normalen Audioplayer-Mode ein.
*Der Audioplayer kann sich mit der Playliste des Winamp-Players synchronisieren, wenn Sie den '''Winamp'''-Button aktivieren. In diesem Fall sucht der Audioplayer, ob der gerade in der Playlist gespielte Song auch ein Audioplayer-Track ist und startet dann die entsprechenden Szenen und Effekte. Die Musiksteuerung (z.B. auch das Springen zu bestimmten Stellen) obliegt dann Winamp.

Der Vorteil dieses Betriebskonzeptes liegt darin, dass man dann natürlich synchrone Beats vom Beattrigger erhält, die musikgesteuerte Effekte triggern können. Dazu muß muß das Winamp AVS-Plugin installiert sein. Die Trackliste und die Winamp-Playlist synchronisieren sich über den in Winamp angezeigten Titel, meist der mp3-ID3-tag der Songs. Diesen kann man z.B. in Winamp im Menü "File->View file.info ..." einsehen und auch verändern (siehe folgendes Bild), natürlich geht das auch mit anderen mp3-Editoren. Der angezeigte Titel ist in Winamp bei "Einstellungen /Titel/Erweiterte Titelformatierung" veränderbar.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_TrackInformation.png|2|Trackinformationen in Winamp|center|400px}}

Um diesen Modus zu starten muß der '''Winamp-Button''' aktiviert sein (siehe Punkt 1 im folgenden Bild). Ganz '''wichtig''' ist, dass der Trackname mit dem angezeigten Titel des Songs übereinstimmt (siehe Punkt2 im Bild). Ob die Synchronisation erfolgreich ist, erkennt man daran, ob im Feld Audiodatei (wo der Songdateiname angegeben ist) ein "(X)" für erfolgreich oder ein "(-)" für nicht gefunden erscheint (siehe Punkt 3 im Bild).
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_WinampSteuerung.png|3|Synchronisisation des Audioplayers mit Winamp|center|750px}}
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

[[Kategorie:DMXControl 2]]

Audioplayer DMXC2

2012-11-06T17:47:36Z

Wdunczewski: /* Modulbezogene Befehle */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

{{Hinweis
|Text = 16.09. Review Uwe: O.K. 
05.10.2012 Jens-Peter und Uwe Review: Überprüfen ob Laufzeitbalken" im Audioplayer sollen sich dem Speedmaster anpassen FS#629
im Artikel enthalten. 
Uhr-Button beschreiben, Hints in Audiospur beschreiben 
Audioplayer: Bar graphs representing scene length now take speedmaster into account (FS#629) 
01.11.2012 Uwe: Artikel ist fertig und kann nach Review auf 100% gesetzt werden. Falls was fehlt bitte Kommentar hier. 
}}
{{Start-LaTeX}}
==Überblick==

Mit dem Audioplayer können Audiotitel mit Szenen, Effekten und Befehlen unterlegt werden. Im Prinzip bietet der Audioplayer eine andere Oberfläche für eine [[Szenenliste_DMXC2|Szenenliste]], ähnlich dem Textbuch und dem Timecode-Player, nur dass hier die Möglichkeit besteht, die Szenen punktgenau zum Verlauf des Songs zu verankern. Hierdurch lassen sich für einzelne Songs individuelle Lightshows erstellen.

==Beschreibung==

Ein auffälliges Merkmal des Audioplayers sind die beiden Audiospuren, welche die Stereospuren eines Musiktitels präsentieren (linker Kanal: grün, rechter Kanal: rot). In diesem Fensterbereich wird der zeitliche Verlauf mit den entsprechenden Amplituden des Songs und die gesetzten Szenen angezeigt. Bei leistungsschwachen Computern empfiehlt es sich, mit der Checkbox "Grafik nicht laden" die Anzeige des Amplitudenverlaufs zu unterdrücken, wodurch CPU-Leistung eingespart wird.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_Fenster.png|1|Der Audioplayer|center|600px}}
<br\>
{{BoxWichtig
|Text = Der Audioplayer dient der Verlichtung von Audiodateien. Wenn es lediglich um das Abspielen von Audiodateien geht, ist die Audioszene zu bevorzugen. Dort können auch mehrere Audiokanäle (bis zu 16 Stück) parallel abspielen.
}}

==Bedienelemente==
{| class="wikitable centered"
|- style="vertical-align:top;"
! Icon
! Bezeichnung
! Beschreibung
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_DMXControl.png]]
|style="width: 170px; vertical-align:middle"| DMXControl
|style="width: 380px"| Mit dem Button DMXControl im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über DMXControl gestartet und abgespielt werden.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_WinAmp.png]]
|style="width: 170px; vertical-align:middle"| WinAmp
|style="width: 380px"| Mit dem Button WinAmp im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über das externe Programm WinAmp gestartet und abgespielt werden. (Synchronisation mit WinAmp)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Play.png]]
|style="width: 170px; vertical-align:middle"| Play
|style="width: 380px"| Der Play-Button startet das Soundfile und die Audio-Szeneliste, wenn der DMXControl-Button betätigt ist.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Rewind.png]]
|style="width: 170px; vertical-align:middle"| Rewind
|style="width: 380px"| Mit diesem Button wird der Audio-Cursor wieder auf den Anfang des Songs positioniert. (Dies funktioniert auch beim Abspielen des Soundfiles)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Repeat.png]]
|style="width: 170px; vertical-align:middle"| Repeat
|style="width: 380px"| Ist dieser Button betätigt, dann wird das Soundfile nach dem Beenden wieder von vorne abgespielt.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Vorhören.png]]
|style="width: 170px; vertical-align:middle"| Vorhören
|style="width: 380px"| Mit dem Vorhören-Button wird das Soundfile ab der aktuellen Audio-Cursor Position abgespielt. Bei einem erneuten Klick auf den Button stoppt der Player und der Audio-Cursor kehrt in seine Ausgangsposition zurück.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Zoom.png]]
|style="width: 170px; vertical-align:middle"| Zoom
|style="width: 380px"| Mit dem Zoom Dropdown lässt sich die Audiospur vergrößern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Grafik_nicht_laden.png]]
|style="width: 170px; vertical-align:middle"| Grafik nicht laden
|style="width: 380px"| Wenn die Checkbox markiert ist, wird die Audiospur-Grafik nicht geladen. Dadurch lässt sich bei langsamen Computern die Performance steigern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Uhr.png]]
|style="width: 170px; vertical-align:middle"| Uhr
|style="width: 380px"| Mit dem Uhr-Button wird die gerade markierte Szene in der Audio-Szenenliste auf die aktuelle Audio-Cursor-Position verschoben.
|}

Die restlichen Buttons sind Standard-Buttons bzw. selbsterklärend.

===Audiospur===
*Ein '''gelber''' senkrechter Strich in der Audiospur stellt die aktuelle Positionsmarkierung des Audio-Cursors dar.
*Ein '''weißer''' senkrechter Strich in der Audiospur zeigt die Szenen-Markierung mit bereits zugeordneten Positionen an.
*Die '''blauer''' senkrechter Strich in der Audiospur wird angezeigt, wenn der Audio-Cursor auf einer zugeordneten Szene-Markierung steht.

Wenn man mit dem Maus-Cursor auf einer Szenen-Markierung ist, verwandelt sich der Mauszeiger in einen Doppel-Pfeil. Außerdem wird ein Tooltip mit dem Namen der Szene angezeigt. Durch Klicken und festhalten der linken Maustaste, kann die Szenen-Markierung positioniert werden.

{{BoxHinweis
| Text=Befindet sich der Mauszeiger auf der Audiospur und nicht auf einer Szenen-Markierung, dann wird ein ToolTip angezeigt, der lediglich einen Bindestrich enthält. Dieser ToolTip ist ohne weitere Bedeutung.
}}

===Audioprojekt Verwalten===
*'''Hinzufügen-Button:''' Durch diesen Button lässt sich ein neues Audiotrack-Projekt erstellen.
*'''Öffnen-Button:''' Mit diesem Button weist man dem Audiotrack-Projekt ein Audiofile zu. Mögliche Audiofiles müssen vom Typ mp3, mp2, mp1, wav oder ogg sein.
*'''Verwalten-Button''' Hinter diesem Button verbergen sich die Menüpunkte '''Hinzufügen''', '''Kopieren''', '''Umbenennen''', '''Löschen''' und '''Verwalten'''. Mit ihnen können die Audiolisten verwaltet werden.

{{BoxWichtig
| Text = Bei Audiodateien mit variabler Bitrate (VBR) gibt es Probleme mit einem gewissen "Zeitversatz". 
Daher ist es am besten, Audiodateien mit konstanter Bitrate (z.b. 128kBit oder 320kBit) zu verwenden.
}}

===Bedienung===
Beim Klick mit der Maustaste in das Audiofenster erscheint an dieser Stelle der Audio-Cursor (gelber Strich). Damit lässt sich z.B. im '''Play'''-Mode (Drücken des Play-Buttons) an eine beliebige Stelle springen, um diese zu hören.
Ein Doppel-Klick ins Audiofenster startet den '''Play'''-Mode an der entsprechenden Stelle. Ein erneuter Doppel-Klick stoppt den '''Play'''-Mode.

Neue Szenen können folgendermaßen zugewiesen werden:

*Hören Sie den Titel und achten Sie in der Grafik auf markante Stellen im Song, wo Sie Szenen, Effekte oder Befehle positionieren wollen. Diese Aktion erfolgt genau wie in anderen DMXControl-Tools durch Drücken des grünen '''Plus'''-Buttons.
*Besonders fixe Nutzer schaffen das sogar im Play-Mode. Normalerweise stoppt man aber den Titel und positioniert den Cursor exakt an der gewünschten Stelle. Um das ganz genau hinzubekommen, gibt es zwei Möglichkeiten:
**Man vergrößert das Audioplayer-Fenster über die Breite des gesamten Bildschirms oder
**man kann einen Zoom-Faktor für die grafische Darstellung der Amplituden einstellen.
*Erstellen Sie eine neue Szene, wählen Sie eine aus der Szenenbibliothek oder definieren Sie einen Befehl.
*Sie können übrigens die Position eines Befehls im Audiotrack verändern, indem Sie den zugeordneten blauen Balken mit der Maus verschieben (Doppelpfeilcursor). Die neue Position wird in der Befehlsliste aktualisiert. Durch einen Klick auf den Listenkopf "Position" werden die Befehle aufsteigend oder absteigend sortiert.
*Die Fade-In-Zeit kann durch Anklicken der entsprechenden Zelle in der Tabelle angepasst werden.
*Wenn Sie die Häkchen vor den Befehlsnamen ausschalten, wird der entsprechende Befehl deaktiviert, verbleibt aber in der Trackdefinition. Dies kann man in der Erstellungsphase nutzen, um die Wechselwirkung einzelner Effekte zu testen, bis man die richtige Kombination gefunden hat.

==Modulbezogene Befehle==

* Modul: '''Audiotrack'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 105px"| Gerät/Funktion
!style="width: 195px"| Beschreibung
!style="width: 105px"| Kanal
!style="width: 195px"| Beschreibung
|- style="vertical-align:top;"
|rowspan="4"| Ausgewählte
|rowspan="4"| Der weitere Befehl wird auf den aktuell ausgewählten Audiotrack angewendet. (Der Befehl Auswählen macht bei dieser Funktion keinen Sinn)
| Start/Stop
| Der Befehl ''Start/Stopp'' startet und stoppt den ausgewählten Audiotrack zur Wiedergabe. (Der Befehl sollte im Zusammenhang mit dem T-Flag eingesetzt werden.)
|- style="vertical-align:top;"
| Start
| Der Befehl ''Start'' startet den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| Stop
| Der Befehl ''Stopp'' stoppt den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| zurück Spulen
| Durch den Befehl ''zurück spulen'' Springt der Audio-Cursor wieder an den Anfang des Soundfiles.
|- style="vertical-align:top;"
|rowspan="2"| Nächste Vorherige Sonstige Einträge
|rowspan="2"| Der weitere Befehl wird auf den nächsten, vorherigen oder im Dropdown benannten Audiotrack angewendet.
| Auswählen
| Wählt den nächsten, vorherigen bzw. den im Dropdown ''Gerät/Funktion'' benannten Audiotrack aus.
|- style="vertical-align:top;"
| Start/Stop Start Stop zurück spulen
| siehe oben
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabefenster öffnet, in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt, um eine korrekte Funktion zu gewährleisten.
|}

==Tipps==

====Synchronisation des Audioplayers mit Winamp====

Der Audioplayer kann auch mit einer Playlist des Wimamp-Players synchronisiert werden:

*Der '''DMXControl'''-Button stellt den normalen Audioplayer-Mode ein.
*Der Audioplayer kann sich mit der Playliste des Winamp-Players synchronisieren, wenn Sie den '''Winamp'''-Button aktivieren. In diesem Fall sucht der Audioplayer, ob der gerade in der Playlist gespielte Song auch ein Audioplayer-Track ist und startet dann die entsprechenden Szenen und Effekte. Die Musiksteuerung (z.B. auch das Springen zu bestimmten Stellen) obliegt dann Winamp.

Der Vorteil dieses Betriebskonzeptes liegt darin, dass man dann natürlich synchrone Beats vom Beattrigger erhält, die musikgesteuerte Effekte triggern können. Dazu muß muß das Winamp AVS-Plugin installiert sein. Die Trackliste und die Winamp-Playlist synchronisieren sich über den in Winamp angezeigten Titel, meist der mp3-ID3-tag der Songs. Diesen kann man z.B. in Winamp im Menü "File->View file.info ..." einsehen und auch verändern (siehe folgendes Bild), natürlich geht das auch mit anderen mp3-Editoren. Der angezeigte Titel ist in Winamp bei "Einstellungen /Titel/Erweiterte Titelformatierung" veränderbar.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_TrackInformation.png|2|Trackinformationen in Winamp|center|400px}}

Um diesen Modus zu starten muß der '''Winamp-Button''' aktiviert sein (siehe Punkt 1 im folgenden Bild). Ganz '''wichtig''' ist, dass der Trackname mit dem angezeigten Titel des Songs übereinstimmt (siehe Punkt2 im Bild). Ob die Synchronisation erfolgreich ist, erkennt man daran, ob im Feld Audiodatei (wo der Songdateiname angegeben ist) ein "(X)" für erfolgreich oder ein "(-)" für nicht gefunden erscheint (siehe Punkt 3 im Bild).
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_WinampSteuerung.png|3|Synchronisisation des Audioplayers mit Winamp|center|750px}}
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

[[Kategorie:DMXControl 2]]

Audioplayer DMXC2

2012-11-06T17:44:45Z

Wdunczewski: /* Modulbezogene Befehle */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

{{Hinweis
|Text = 16.09. Review Uwe: O.K. 
05.10.2012 Jens-Peter und Uwe Review: Überprüfen ob Laufzeitbalken" im Audioplayer sollen sich dem Speedmaster anpassen FS#629
im Artikel enthalten. 
Uhr-Button beschreiben, Hints in Audiospur beschreiben 
Audioplayer: Bar graphs representing scene length now take speedmaster into account (FS#629) 
01.11.2012 Uwe: Artikel ist fertig und kann nach Review auf 100% gesetzt werden. Falls was fehlt bitte Kommentar hier. 
}}
{{Start-LaTeX}}
==Überblick==

Mit dem Audioplayer können Audiotitel mit Szenen, Effekten und Befehlen unterlegt werden. Im Prinzip bietet der Audioplayer eine andere Oberfläche für eine [[Szenenliste_DMXC2|Szenenliste]], ähnlich dem Textbuch und dem Timecode-Player, nur dass hier die Möglichkeit besteht, die Szenen punktgenau zum Verlauf des Songs zu verankern. Hierdurch lassen sich für einzelne Songs individuelle Lightshows erstellen.

==Beschreibung==

Ein auffälliges Merkmal des Audioplayers sind die beiden Audiospuren, welche die Stereospuren eines Musiktitels präsentieren (linker Kanal: grün, rechter Kanal: rot). In diesem Fensterbereich wird der zeitliche Verlauf mit den entsprechenden Amplituden des Songs und die gesetzten Szenen angezeigt. Bei leistungsschwachen Computern empfiehlt es sich, mit der Checkbox "Grafik nicht laden" die Anzeige des Amplitudenverlaufs zu unterdrücken, wodurch CPU-Leistung eingespart wird.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_Fenster.png|1|Der Audioplayer|center|600px}}
<br\>
{{BoxWichtig
|Text = Der Audioplayer dient der Verlichtung von Audiodateien. Wenn es lediglich um das Abspielen von Audiodateien geht, ist die Audioszene zu bevorzugen. Dort können auch mehrere Audiokanäle (bis zu 16 Stück) parallel abspielen.
}}

==Bedienelemente==
{| class="wikitable centered"
|- style="vertical-align:top;"
! Icon
! Bezeichnung
! Beschreibung
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_DMXControl.png]]
|style="width: 170px; vertical-align:middle"| DMXControl
|style="width: 380px"| Mit dem Button DMXControl im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über DMXControl gestartet und abgespielt werden.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_WinAmp.png]]
|style="width: 170px; vertical-align:middle"| WinAmp
|style="width: 380px"| Mit dem Button WinAmp im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über das externe Programm WinAmp gestartet und abgespielt werden. (Synchronisation mit WinAmp)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Play.png]]
|style="width: 170px; vertical-align:middle"| Play
|style="width: 380px"| Der Play-Button startet das Soundfile und die Audio-Szeneliste, wenn der DMXControl-Button betätigt ist.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Rewind.png]]
|style="width: 170px; vertical-align:middle"| Rewind
|style="width: 380px"| Mit diesem Button wird der Audio-Cursor wieder auf den Anfang des Songs positioniert. (Dies funktioniert auch beim Abspielen des Soundfiles)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Repeat.png]]
|style="width: 170px; vertical-align:middle"| Repeat
|style="width: 380px"| Ist dieser Button betätigt, dann wird das Soundfile nach dem Beenden wieder von vorne abgespielt.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Vorhören.png]]
|style="width: 170px; vertical-align:middle"| Vorhören
|style="width: 380px"| Mit dem Vorhören-Button wird das Soundfile ab der aktuellen Audio-Cursor Position abgespielt. Bei einem erneuten Klick auf den Button stoppt der Player und der Audio-Cursor kehrt in seine Ausgangsposition zurück.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Zoom.png]]
|style="width: 170px; vertical-align:middle"| Zoom
|style="width: 380px"| Mit dem Zoom Dropdown lässt sich die Audiospur vergrößern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Grafik_nicht_laden.png]]
|style="width: 170px; vertical-align:middle"| Grafik nicht laden
|style="width: 380px"| Wenn die Checkbox markiert ist, wird die Audiospur-Grafik nicht geladen. Dadurch lässt sich bei langsamen Computern die Performance steigern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Uhr.png]]
|style="width: 170px; vertical-align:middle"| Uhr
|style="width: 380px"| Mit dem Uhr-Button wird die gerade markierte Szene in der Audio-Szenenliste auf die aktuelle Audio-Cursor-Position verschoben.
|}

Die restlichen Buttons sind Standard-Buttons bzw. selbsterklärend.

===Audiospur===
*Ein '''gelber''' senkrechter Strich in der Audiospur stellt die aktuelle Positionsmarkierung des Audio-Cursors dar.
*Ein '''weißer''' senkrechter Strich in der Audiospur zeigt die Szenen-Markierung mit bereits zugeordneten Positionen an.
*Die '''blauer''' senkrechter Strich in der Audiospur wird angezeigt, wenn der Audio-Cursor auf einer zugeordneten Szene-Markierung steht.

Wenn man mit dem Maus-Cursor auf einer Szenen-Markierung ist, verwandelt sich der Mauszeiger in einen Doppel-Pfeil. Außerdem wird ein Tooltip mit dem Namen der Szene angezeigt. Durch Klicken und festhalten der linken Maustaste, kann die Szenen-Markierung positioniert werden.

{{BoxHinweis
| Text=Befindet sich der Mauszeiger auf der Audiospur und nicht auf einer Szenen-Markierung, dann wird ein ToolTip angezeigt, der lediglich einen Bindestrich enthält. Dieser ToolTip ist ohne weitere Bedeutung.
}}

===Audioprojekt Verwalten===
*'''Hinzufügen-Button:''' Durch diesen Button lässt sich ein neues Audiotrack-Projekt erstellen.
*'''Öffnen-Button:''' Mit diesem Button weist man dem Audiotrack-Projekt ein Audiofile zu. Mögliche Audiofiles müssen vom Typ mp3, mp2, mp1, wav oder ogg sein.
*'''Verwalten-Button''' Hinter diesem Button verbergen sich die Menüpunkte '''Hinzufügen''', '''Kopieren''', '''Umbenennen''', '''Löschen''' und '''Verwalten'''. Mit ihnen können die Audiolisten verwaltet werden.

{{BoxWichtig
| Text = Bei Audiodateien mit variabler Bitrate (VBR) gibt es Probleme mit einem gewissen "Zeitversatz". 
Daher ist es am besten, Audiodateien mit konstanter Bitrate (z.b. 128kBit oder 320kBit) zu verwenden.
}}

===Bedienung===
Beim Klick mit der Maustaste in das Audiofenster erscheint an dieser Stelle der Audio-Cursor (gelber Strich). Damit lässt sich z.B. im '''Play'''-Mode (Drücken des Play-Buttons) an eine beliebige Stelle springen, um diese zu hören.
Ein Doppel-Klick ins Audiofenster startet den '''Play'''-Mode an der entsprechenden Stelle. Ein erneuter Doppel-Klick stoppt den '''Play'''-Mode.

Neue Szenen können folgendermaßen zugewiesen werden:

*Hören Sie den Titel und achten Sie in der Grafik auf markante Stellen im Song, wo Sie Szenen, Effekte oder Befehle positionieren wollen. Diese Aktion erfolgt genau wie in anderen DMXControl-Tools durch Drücken des grünen '''Plus'''-Buttons.
*Besonders fixe Nutzer schaffen das sogar im Play-Mode. Normalerweise stoppt man aber den Titel und positioniert den Cursor exakt an der gewünschten Stelle. Um das ganz genau hinzubekommen, gibt es zwei Möglichkeiten:
**Man vergrößert das Audioplayer-Fenster über die Breite des gesamten Bildschirms oder
**man kann einen Zoom-Faktor für die grafische Darstellung der Amplituden einstellen.
*Erstellen Sie eine neue Szene, wählen Sie eine aus der Szenenbibliothek oder definieren Sie einen Befehl.
*Sie können übrigens die Position eines Befehls im Audiotrack verändern, indem Sie den zugeordneten blauen Balken mit der Maus verschieben (Doppelpfeilcursor). Die neue Position wird in der Befehlsliste aktualisiert. Durch einen Klick auf den Listenkopf "Position" werden die Befehle aufsteigend oder absteigend sortiert.
*Die Fade-In-Zeit kann durch Anklicken der entsprechenden Zelle in der Tabelle angepasst werden.
*Wenn Sie die Häkchen vor den Befehlsnamen ausschalten, wird der entsprechende Befehl deaktiviert, verbleibt aber in der Trackdefinition. Dies kann man in der Erstellungsphase nutzen, um die Wechselwirkung einzelner Effekte zu testen, bis man die richtige Kombination gefunden hat.

==Modulbezogene Befehle==

* Modul: '''Audiotrack'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 105px"| Gerät/Funktion
!style="width: 195px"| Beschreibung
!style="width: 105px"| Kanal
!style="width: 195px"| Beschreibung
|- style="vertical-align:top;"
|rowspan="4"| Ausgewählte
|rowspan="4"| Der weitere Befehl wird auf den aktuell ausgewählten Audiotrack angewendet. (Der Befehl Auswählen macht bei dieser Funktion keinen Sinn)
| Start/Stop
| Der Befehl ''Start/Stopp'' startet und stoppt den ausgewählten Audiotrack zur Wiedergabe. (Der Befehl sollte im Zusammenhang mit dem T-Flag eingesetzt werden.)
|- style="vertical-align:top;"
| Start
| Der Befehl ''Start'' startet den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| Stop
| Der Befehl ''Stopp'' stoppt den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| zurück Spulen
| Durch den Befehl ''zurück spulen'' Springt der Audio-Cursor wieder an den Anfang des Soundfiles.
|- style="vertical-align:top;"
|rowspan="2"| Nächste Vorherige Sonstige Einträge
|rowspan="2"| Der weitere Befehl wird auf die aktuell nächste, vorherige oder im Dropdown benannten Audiotrack angewendet.
| Auswählen
| Wählt die nächste, vorherige bzw. die im Dropdown ''Gerät/Funktion'' benannten Audiotrack aus.
|- style="vertical-align:top;"
| Start/Stop Start Stop zurück spulen
| siehe oben
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabe Fenster öffnet in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt um eine korrekte Funktion zu gewährleisten.
|}

==Tipps==

====Synchronisation des Audioplayers mit Winamp====

Der Audioplayer kann auch mit einer Playlist des Wimamp-Players synchronisiert werden:

*Der '''DMXControl'''-Button stellt den normalen Audioplayer-Mode ein.
*Der Audioplayer kann sich mit der Playliste des Winamp-Players synchronisieren, wenn Sie den '''Winamp'''-Button aktivieren. In diesem Fall sucht der Audioplayer, ob der gerade in der Playlist gespielte Song auch ein Audioplayer-Track ist und startet dann die entsprechenden Szenen und Effekte. Die Musiksteuerung (z.B. auch das Springen zu bestimmten Stellen) obliegt dann Winamp.

Der Vorteil dieses Betriebskonzeptes liegt darin, dass man dann natürlich synchrone Beats vom Beattrigger erhält, die musikgesteuerte Effekte triggern können. Dazu muß muß das Winamp AVS-Plugin installiert sein. Die Trackliste und die Winamp-Playlist synchronisieren sich über den in Winamp angezeigten Titel, meist der mp3-ID3-tag der Songs. Diesen kann man z.B. in Winamp im Menü "File->View file.info ..." einsehen und auch verändern (siehe folgendes Bild), natürlich geht das auch mit anderen mp3-Editoren. Der angezeigte Titel ist in Winamp bei "Einstellungen /Titel/Erweiterte Titelformatierung" veränderbar.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_TrackInformation.png|2|Trackinformationen in Winamp|center|400px}}

Um diesen Modus zu starten muß der '''Winamp-Button''' aktiviert sein (siehe Punkt 1 im folgenden Bild). Ganz '''wichtig''' ist, dass der Trackname mit dem angezeigten Titel des Songs übereinstimmt (siehe Punkt2 im Bild). Ob die Synchronisation erfolgreich ist, erkennt man daran, ob im Feld Audiodatei (wo der Songdateiname angegeben ist) ein "(X)" für erfolgreich oder ein "(-)" für nicht gefunden erscheint (siehe Punkt 3 im Bild).
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_WinampSteuerung.png|3|Synchronisisation des Audioplayers mit Winamp|center|750px}}
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

[[Kategorie:DMXControl 2]]

Audioplayer DMXC2

2012-11-06T17:42:24Z

Wdunczewski: /* Bedienelemente */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

{{Hinweis
|Text = 16.09. Review Uwe: O.K. 
05.10.2012 Jens-Peter und Uwe Review: Überprüfen ob Laufzeitbalken" im Audioplayer sollen sich dem Speedmaster anpassen FS#629
im Artikel enthalten. 
Uhr-Button beschreiben, Hints in Audiospur beschreiben 
Audioplayer: Bar graphs representing scene length now take speedmaster into account (FS#629) 
01.11.2012 Uwe: Artikel ist fertig und kann nach Review auf 100% gesetzt werden. Falls was fehlt bitte Kommentar hier. 
}}
{{Start-LaTeX}}
==Überblick==

Mit dem Audioplayer können Audiotitel mit Szenen, Effekten und Befehlen unterlegt werden. Im Prinzip bietet der Audioplayer eine andere Oberfläche für eine [[Szenenliste_DMXC2|Szenenliste]], ähnlich dem Textbuch und dem Timecode-Player, nur dass hier die Möglichkeit besteht, die Szenen punktgenau zum Verlauf des Songs zu verankern. Hierdurch lassen sich für einzelne Songs individuelle Lightshows erstellen.

==Beschreibung==

Ein auffälliges Merkmal des Audioplayers sind die beiden Audiospuren, welche die Stereospuren eines Musiktitels präsentieren (linker Kanal: grün, rechter Kanal: rot). In diesem Fensterbereich wird der zeitliche Verlauf mit den entsprechenden Amplituden des Songs und die gesetzten Szenen angezeigt. Bei leistungsschwachen Computern empfiehlt es sich, mit der Checkbox "Grafik nicht laden" die Anzeige des Amplitudenverlaufs zu unterdrücken, wodurch CPU-Leistung eingespart wird.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_Fenster.png|1|Der Audioplayer|center|600px}}
<br\>
{{BoxWichtig
|Text = Der Audioplayer dient der Verlichtung von Audiodateien. Wenn es lediglich um das Abspielen von Audiodateien geht, ist die Audioszene zu bevorzugen. Dort können auch mehrere Audiokanäle (bis zu 16 Stück) parallel abspielen.
}}

==Bedienelemente==
{| class="wikitable centered"
|- style="vertical-align:top;"
! Icon
! Bezeichnung
! Beschreibung
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_DMXControl.png]]
|style="width: 170px; vertical-align:middle"| DMXControl
|style="width: 380px"| Mit dem Button DMXControl im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über DMXControl gestartet und abgespielt werden.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_WinAmp.png]]
|style="width: 170px; vertical-align:middle"| WinAmp
|style="width: 380px"| Mit dem Button WinAmp im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über das externe Programm WinAmp gestartet und abgespielt werden. (Synchronisation mit WinAmp)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Play.png]]
|style="width: 170px; vertical-align:middle"| Play
|style="width: 380px"| Der Play-Button startet das Soundfile und die Audio-Szeneliste, wenn der DMXControl-Button betätigt ist.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Rewind.png]]
|style="width: 170px; vertical-align:middle"| Rewind
|style="width: 380px"| Mit diesem Button wird der Audio-Cursor wieder auf den Anfang des Songs positioniert. (Dies funktioniert auch beim Abspielen des Soundfiles)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Repeat.png]]
|style="width: 170px; vertical-align:middle"| Repeat
|style="width: 380px"| Ist dieser Button betätigt, dann wird das Soundfile nach dem Beenden wieder von vorne abgespielt.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Vorhören.png]]
|style="width: 170px; vertical-align:middle"| Vorhören
|style="width: 380px"| Mit dem Vorhören-Button wird das Soundfile ab der aktuellen Audio-Cursor Position abgespielt. Bei einem erneuten Klick auf den Button stoppt der Player und der Audio-Cursor kehrt in seine Ausgangsposition zurück.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Zoom.png]]
|style="width: 170px; vertical-align:middle"| Zoom
|style="width: 380px"| Mit dem Zoom Dropdown lässt sich die Audiospur vergrößern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Grafik_nicht_laden.png]]
|style="width: 170px; vertical-align:middle"| Grafik nicht laden
|style="width: 380px"| Wenn die Checkbox markiert ist, wird die Audiospur-Grafik nicht geladen. Dadurch lässt sich bei langsamen Computern die Performance steigern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Uhr.png]]
|style="width: 170px; vertical-align:middle"| Uhr
|style="width: 380px"| Mit dem Uhr-Button wird die gerade markierte Szene in der Audio-Szenenliste auf die aktuelle Audio-Cursor-Position verschoben.
|}

Die restlichen Buttons sind Standard-Buttons bzw. selbsterklärend.

===Audiospur===
*Ein '''gelber''' senkrechter Strich in der Audiospur stellt die aktuelle Positionsmarkierung des Audio-Cursors dar.
*Ein '''weißer''' senkrechter Strich in der Audiospur zeigt die Szenen-Markierung mit bereits zugeordneten Positionen an.
*Die '''blauer''' senkrechter Strich in der Audiospur wird angezeigt, wenn der Audio-Cursor auf einer zugeordneten Szene-Markierung steht.

Wenn man mit dem Maus-Cursor auf einer Szenen-Markierung ist, verwandelt sich der Mauszeiger in einen Doppel-Pfeil. Außerdem wird ein Tooltip mit dem Namen der Szene angezeigt. Durch Klicken und festhalten der linken Maustaste, kann die Szenen-Markierung positioniert werden.

{{BoxHinweis
| Text=Befindet sich der Mauszeiger auf der Audiospur und nicht auf einer Szenen-Markierung, dann wird ein ToolTip angezeigt, der lediglich einen Bindestrich enthält. Dieser ToolTip ist ohne weitere Bedeutung.
}}

===Audioprojekt Verwalten===
*'''Hinzufügen-Button:''' Durch diesen Button lässt sich ein neues Audiotrack-Projekt erstellen.
*'''Öffnen-Button:''' Mit diesem Button weist man dem Audiotrack-Projekt ein Audiofile zu. Mögliche Audiofiles müssen vom Typ mp3, mp2, mp1, wav oder ogg sein.
*'''Verwalten-Button''' Hinter diesem Button verbergen sich die Menüpunkte '''Hinzufügen''', '''Kopieren''', '''Umbenennen''', '''Löschen''' und '''Verwalten'''. Mit ihnen können die Audiolisten verwaltet werden.

{{BoxWichtig
| Text = Bei Audiodateien mit variabler Bitrate (VBR) gibt es Probleme mit einem gewissen "Zeitversatz". 
Daher ist es am besten, Audiodateien mit konstanter Bitrate (z.b. 128kBit oder 320kBit) zu verwenden.
}}

===Bedienung===
Beim Klick mit der Maustaste in das Audiofenster erscheint an dieser Stelle der Audio-Cursor (gelber Strich). Damit lässt sich z.B. im '''Play'''-Mode (Drücken des Play-Buttons) an eine beliebige Stelle springen, um diese zu hören.
Ein Doppel-Klick ins Audiofenster startet den '''Play'''-Mode an der entsprechenden Stelle. Ein erneuter Doppel-Klick stoppt den '''Play'''-Mode.

Neue Szenen können folgendermaßen zugewiesen werden:

*Hören Sie den Titel und achten Sie in der Grafik auf markante Stellen im Song, wo Sie Szenen, Effekte oder Befehle positionieren wollen. Diese Aktion erfolgt genau wie in anderen DMXControl-Tools durch Drücken des grünen '''Plus'''-Buttons.
*Besonders fixe Nutzer schaffen das sogar im Play-Mode. Normalerweise stoppt man aber den Titel und positioniert den Cursor exakt an der gewünschten Stelle. Um das ganz genau hinzubekommen, gibt es zwei Möglichkeiten:
**Man vergrößert das Audioplayer-Fenster über die Breite des gesamten Bildschirms oder
**man kann einen Zoom-Faktor für die grafische Darstellung der Amplituden einstellen.
*Erstellen Sie eine neue Szene, wählen Sie eine aus der Szenenbibliothek oder definieren Sie einen Befehl.
*Sie können übrigens die Position eines Befehls im Audiotrack verändern, indem Sie den zugeordneten blauen Balken mit der Maus verschieben (Doppelpfeilcursor). Die neue Position wird in der Befehlsliste aktualisiert. Durch einen Klick auf den Listenkopf "Position" werden die Befehle aufsteigend oder absteigend sortiert.
*Die Fade-In-Zeit kann durch Anklicken der entsprechenden Zelle in der Tabelle angepasst werden.
*Wenn Sie die Häkchen vor den Befehlsnamen ausschalten, wird der entsprechende Befehl deaktiviert, verbleibt aber in der Trackdefinition. Dies kann man in der Erstellungsphase nutzen, um die Wechselwirkung einzelner Effekte zu testen, bis man die richtige Kombination gefunden hat.

==Modulbezogene Befehle==

* Modul: '''Audiotrack'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 105px"| Gerät/Funktion
!style="width: 195px"| Beschreibung
!style="width: 105px"| Kanal
!style="width: 195px"| Beschreibung
|- style="vertical-align:top;"
|rowspan="4"| Ausgewählte
|rowspan="4"| Der weitere Befehl wird auf den aktuell ausgewählten Audiotrack angewendet. (Der Befehl Auswählen macht bei dieser Funktion keinen Sinn)
| Start/Stop
| Der Befehl ''Start/Stop'' startet und stopt den ausgewählten Audiotrack zur Wiedergabe. (Der Befehl sollte im Zusammenhang mit dem T-Flag eingesetzt werden.)
|- style="vertical-align:top;"
| Start
| Der Befehl ''Start'' startet den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| Stop
| Der Befehl ''Stop'' stopt den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| zurück Spulen
| Durch den Befehl ''zurück Spulen'' Springt der Audio-Cursor wieder an de Anfand des Soundfiles.
|- style="vertical-align:top;"
|rowspan="2"| Nächste Vorherige Sonstige Einträge
|rowspan="2"| Der weitere Befehl wird auf die aktuell nächste, vorherige oder im Dropdown benannten Audiotrack angewendet.
| Auswählen
| Wählt die nächste, vorherige bzw. die im Dropdown ''Gerät/Funktion'' benannten Audiotrack aus.
|- style="vertical-align:top;"
| Start/Stop Start Stop zurück Spulen
| siehe oben
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabe Fenster öffnet in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt um eine korrekte Funktion zu gewährleisten.
|}

==Tipps==

====Synchronisation des Audioplayers mit Winamp====

Der Audioplayer kann auch mit einer Playlist des Wimamp-Players synchronisiert werden:

*Der '''DMXControl'''-Button stellt den normalen Audioplayer-Mode ein.
*Der Audioplayer kann sich mit der Playliste des Winamp-Players synchronisieren, wenn Sie den '''Winamp'''-Button aktivieren. In diesem Fall sucht der Audioplayer, ob der gerade in der Playlist gespielte Song auch ein Audioplayer-Track ist und startet dann die entsprechenden Szenen und Effekte. Die Musiksteuerung (z.B. auch das Springen zu bestimmten Stellen) obliegt dann Winamp.

Der Vorteil dieses Betriebskonzeptes liegt darin, dass man dann natürlich synchrone Beats vom Beattrigger erhält, die musikgesteuerte Effekte triggern können. Dazu muß muß das Winamp AVS-Plugin installiert sein. Die Trackliste und die Winamp-Playlist synchronisieren sich über den in Winamp angezeigten Titel, meist der mp3-ID3-tag der Songs. Diesen kann man z.B. in Winamp im Menü "File->View file.info ..." einsehen und auch verändern (siehe folgendes Bild), natürlich geht das auch mit anderen mp3-Editoren. Der angezeigte Titel ist in Winamp bei "Einstellungen /Titel/Erweiterte Titelformatierung" veränderbar.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_TrackInformation.png|2|Trackinformationen in Winamp|center|400px}}

Um diesen Modus zu starten muß der '''Winamp-Button''' aktiviert sein (siehe Punkt 1 im folgenden Bild). Ganz '''wichtig''' ist, dass der Trackname mit dem angezeigten Titel des Songs übereinstimmt (siehe Punkt2 im Bild). Ob die Synchronisation erfolgreich ist, erkennt man daran, ob im Feld Audiodatei (wo der Songdateiname angegeben ist) ein "(X)" für erfolgreich oder ein "(-)" für nicht gefunden erscheint (siehe Punkt 3 im Bild).
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_WinampSteuerung.png|3|Synchronisisation des Audioplayers mit Winamp|center|750px}}
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

[[Kategorie:DMXControl 2]]

Audioplayer DMXC2

2012-11-06T17:31:58Z

Wdunczewski: /* Bedienelemente */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

{{Hinweis
|Text = 16.09. Review Uwe: O.K. 
05.10.2012 Jens-Peter und Uwe Review: Überprüfen ob Laufzeitbalken" im Audioplayer sollen sich dem Speedmaster anpassen FS#629
im Artikel enthalten. 
Uhr-Button beschreiben, Hints in Audiospur beschreiben 
Audioplayer: Bar graphs representing scene length now take speedmaster into account (FS#629) 
01.11.2012 Uwe: Artikel ist fertig und kann nach Review auf 100% gesetzt werden. Falls was fehlt bitte Kommentar hier. 
}}
{{Start-LaTeX}}
==Überblick==

Mit dem Audioplayer können Audiotitel mit Szenen, Effekten und Befehlen unterlegt werden. Im Prinzip bietet der Audioplayer eine andere Oberfläche für eine [[Szenenliste_DMXC2|Szenenliste]], ähnlich dem Textbuch und dem Timecode-Player, nur dass hier die Möglichkeit besteht, die Szenen punktgenau zum Verlauf des Songs zu verankern. Hierdurch lassen sich für einzelne Songs individuelle Lightshows erstellen.

==Beschreibung==

Ein auffälliges Merkmal des Audioplayers sind die beiden Audiospuren, welche die Stereospuren eines Musiktitels präsentieren (linker Kanal: grün, rechter Kanal: rot). In diesem Fensterbereich wird der zeitliche Verlauf mit den entsprechenden Amplituden des Songs und die gesetzten Szenen angezeigt. Bei leistungsschwachen Computern empfiehlt es sich, mit der Checkbox "Grafik nicht laden" die Anzeige des Amplitudenverlaufs zu unterdrücken, wodurch CPU-Leistung eingespart wird.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_Fenster.png|1|Der Audioplayer|center|600px}}
<br\>
{{BoxWichtig
|Text = Der Audioplayer dient der Verlichtung von Audiodateien. Wenn es lediglich um das Abspielen von Audiodateien geht, ist die Audioszene zu bevorzugen. Dort können auch mehrere Audiokanäle (bis zu 16 Stück) parallel abspielen.
}}

==Bedienelemente==
{| class="wikitable centered"
|- style="vertical-align:top;"
! Icon
! Bezeichnung
! Beschreibung
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_DMXControl.png]]
|style="width: 170px; vertical-align:middle"| DMXControl
|style="width: 380px"| Mit dem Button DMXControl im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über DMXControl gestartet und abgespielt werden.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_WinAmp.png]]
|style="width: 170px; vertical-align:middle"| WinAmp
|style="width: 380px"| Mit dem Button WinAmp im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über das externe Programm WinAmp gestartet und abgespielt werden. (Synchronisation mit WinAmp)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Play.png]]
|style="width: 170px; vertical-align:middle"| Play
|style="width: 380px"| Der Play-Button startet das Soundfile und die Audio-Szeneliste, wenn der DMXControl-Button betätigt ist.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Rewind.png]]
|style="width: 170px; vertical-align:middle"| Rewind
|style="width: 380px"| Mit diesem Button wird der Audio-Cursor wieder auf den Anfang des Songs positioniert. (Dies funktioniert auch beim Abspielen des Soundfiles)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Repeat.png]]
|style="width: 170px; vertical-align:middle"| Repeat
|style="width: 380px"| Ist dieser Button betätigt, dann wird das Soundfile nach dem Beenden wieder von vorne abgespielt.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Vorhören.png]]
|style="width: 170px; vertical-align:middle"| Vorhören
|style="width: 380px"| Mit dem Vorhören-Button wird das Soundfile ab der aktuellen Audio-Cursor Position abgespielt. Bei einem erneuten Klick auf den Button stoppt der Player und der Audio-Cursor kehrt in seine Ausgangsposition zurück.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Zoom.png]]
|style="width: 170px; vertical-align:middle"| Zoom
|style="width: 380px"| Mit dem Zoom Dropdown lässt sich die Audiospur vergrößern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Grafik_nicht_laden.png]]
|style="width: 170px; vertical-align:middle"| Grafik nicht laden
|style="width: 380px"| Wenn die Checkbox markiert ist, wird die Audiospur-Grafik nicht geladen. Dadurch lässt sich bei langsamen Computern die Performance steigern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Uhr.png]]
|style="width: 170px; vertical-align:middle"| Uhr
|style="width: 380px"| Mit dem Uhr-Button des wird die gerade markierte Szene in der Audio-Szenenliste auf die aktuelle Audio-Cursor-Position verschoben.
|}

Die restlichen Buttons sind Standard-Buttons bzw. selbsterklärend.

===Audiospur===
*Ein '''gelber''' senkrechter Strich, in der Audiospur, stellt die aktuelle Positionsmarkierung des Audio-Cursor dar.
*Ein '''weißer''' senkrechter Strich, in der Audiospur, zeigt die Szenen-Markierung mit bereits zugeordnete Positionen an.
*Die '''blauer''' senkrechter Strich, in der Audiospur, wird angezeigt wenn der Audio-Cursor auf einer zugeordneten Szene-Markierung steht.

Wenn man mit dem Maus-Cursor auf einer Szenen-Markierung ist verwandelt sich der Mauszeiger in einen Doppel-Pfeil, ausserdem wird ein Tooltip mit dem Namen der Szene angezeigt. Durch Klicken und festhalten der linken Maustaste, kann die Szenen-Markierung positioniert werden.

{{BoxHinweis
| Text=Befindet sich der Mauszeiger auf der Audiospur und nicht auf einer Szenen-Markierung, dann wird ein ToolTip angezeigt der lediglich einen Bindestrich enthält. Dieser ToolTip ist ohne weitere Bedeutung.
}}

===Audioprojekt Verwalten===
*'''Hinzufügen-Button:''' Durch diesen Button läßt sich ein neues Audiotrack-Projekt erstellen.
*'''Öffnen-Button:''' Mit diesem Button weist man dem Audiotrack-Projekt ein Audiofile zu. Mögliche Audiofiles müssen vom Typ mp3, mp2, mp1, wav oder ogg sein.
*'''Verwalten-Button''' Hinter diesem Button verbergen sich die Menüpunkte '''Hinzufügen''', '''Kopieren''', '''Umbenennen''', '''Löschen''' und '''Verwalten'''. Mit ihnen kann die Audiolisten verwaltet werden.

{{BoxWichtig
| Text = Bei Audiodateien mit variabler Bitrate (VBR) gibt es Probleme mit einem gewissen "Zeitversatz". 
Daher am besten Audiodateien mit konstanter Bitrate (z.b. 128kBit oder 320kBit) verwenden.
}}

===Bedienung===
Beim Klick mit der Maustaste in das Audiofenster, erscheint an der Stelle der Audio-Cursor (gelber Strich) an der entsprechenden Stelle. Damit lsst sich z.B. im '''Play'''-Mode (Drücken des Play-Buttons) an eine beliebige Stelle springen, um diese zu hören.
Ein Doppel-Klick ins Audiofenster startet den '''Play'''-Mode an der entsprechenden Stelle, ein erneuter Doppel-Klick stopt den '''Play'''-Mode dann wieder.

Neue Szenen können folgendermaßen zugewiesen werden:

*Hören Sie den Titel und achten Sie in der Grafik auf markante Stellen im Song, wo Sie Szenen, Effekte oder Befehle positionieren wollen. Diese Aktion erfolgt genau wie in anderen DMXControl-Tools durch Drücken des grünen '''Plus'''-Buttons.
*Besonders fixe Nutzer schaffen das sogar im Play-Mode, normalerweise stoppt man aber den Titel und positioniert den Cursor exakt an der gewünschten Stelle. Um das ganz genau hinzubekommen, gibt es zwei Möglichkeiten:
**Man vergrößert das Audioplayer-Fenster über die Breite des gesamten Bildschirms oder
**man kann einen Zoom-Faktor für die grafische Darstellung der Amplituden einstellen.
*Erstellen Sie eine neue Szene, wählen Sie eine aus der Szenenbibliothek oder definieren Sie einen Befehl.
*Sie können übrigens die Position eines Befehls im Audiotrack verändern, indem Sie den zugeordneten blauen Balken mit der Maus verschieben (Doppelpfeilcursor). Die neue Position wird in der Befehlsliste aktualisiert. Durch einen Klick auf den Listenkopf "Position" werden die Befehle aufsteigend oder absteigend sortiert.
*Die Fadein-Zeit kann durch Anklicken der entsprechenden Zelle in der Tabelle angepasst werden.
*Wenn Sie die Häkchen vor den Befehlsnamen ausschalten wird der entsprechende Befehl deaktiviert, verbleibt aber in der Trackdefinition. Dies kann man in der Erstellungsphase nutzen, um die Wechselwirkung einzelner Effekte zu testen bis man die richtige Kombination gefumden hat.

==Modulbezogene Befehle==

* Modul: '''Audiotrack'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 105px"| Gerät/Funktion
!style="width: 195px"| Beschreibung
!style="width: 105px"| Kanal
!style="width: 195px"| Beschreibung
|- style="vertical-align:top;"
|rowspan="4"| Ausgewählte
|rowspan="4"| Der weitere Befehl wird auf den aktuell ausgewählten Audiotrack angewendet. (Der Befehl Auswählen macht bei dieser Funktion keinen Sinn)
| Start/Stop
| Der Befehl ''Start/Stop'' startet und stopt den ausgewählten Audiotrack zur Wiedergabe. (Der Befehl sollte im Zusammenhang mit dem T-Flag eingesetzt werden.)
|- style="vertical-align:top;"
| Start
| Der Befehl ''Start'' startet den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| Stop
| Der Befehl ''Stop'' stopt den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| zurück Spulen
| Durch den Befehl ''zurück Spulen'' Springt der Audio-Cursor wieder an de Anfand des Soundfiles.
|- style="vertical-align:top;"
|rowspan="2"| Nächste Vorherige Sonstige Einträge
|rowspan="2"| Der weitere Befehl wird auf die aktuell nächste, vorherige oder im Dropdown benannten Audiotrack angewendet.
| Auswählen
| Wählt die nächste, vorherige bzw. die im Dropdown ''Gerät/Funktion'' benannten Audiotrack aus.
|- style="vertical-align:top;"
| Start/Stop Start Stop zurück Spulen
| siehe oben
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabe Fenster öffnet in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt um eine korrekte Funktion zu gewährleisten.
|}

==Tipps==

====Synchronisation des Audioplayers mit Winamp====

Der Audioplayer kann auch mit einer Playlist des Wimamp-Players synchronisiert werden:

*Der '''DMXControl'''-Button stellt den normalen Audioplayer-Mode ein.
*Der Audioplayer kann sich mit der Playliste des Winamp-Players synchronisieren, wenn Sie den '''Winamp'''-Button aktivieren. In diesem Fall sucht der Audioplayer, ob der gerade in der Playlist gespielte Song auch ein Audioplayer-Track ist und startet dann die entsprechenden Szenen und Effekte. Die Musiksteuerung (z.B. auch das Springen zu bestimmten Stellen) obliegt dann Winamp.

Der Vorteil dieses Betriebskonzeptes liegt darin, dass man dann natürlich synchrone Beats vom Beattrigger erhält, die musikgesteuerte Effekte triggern können. Dazu muß muß das Winamp AVS-Plugin installiert sein. Die Trackliste und die Winamp-Playlist synchronisieren sich über den in Winamp angezeigten Titel, meist der mp3-ID3-tag der Songs. Diesen kann man z.B. in Winamp im Menü "File->View file.info ..." einsehen und auch verändern (siehe folgendes Bild), natürlich geht das auch mit anderen mp3-Editoren. Der angezeigte Titel ist in Winamp bei "Einstellungen /Titel/Erweiterte Titelformatierung" veränderbar.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_TrackInformation.png|2|Trackinformationen in Winamp|center|400px}}

Um diesen Modus zu starten muß der '''Winamp-Button''' aktiviert sein (siehe Punkt 1 im folgenden Bild). Ganz '''wichtig''' ist, dass der Trackname mit dem angezeigten Titel des Songs übereinstimmt (siehe Punkt2 im Bild). Ob die Synchronisation erfolgreich ist, erkennt man daran, ob im Feld Audiodatei (wo der Songdateiname angegeben ist) ein "(X)" für erfolgreich oder ein "(-)" für nicht gefunden erscheint (siehe Punkt 3 im Bild).
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_WinampSteuerung.png|3|Synchronisisation des Audioplayers mit Winamp|center|750px}}
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

[[Kategorie:DMXControl 2]]

Audioplayer DMXC2

2012-11-06T17:29:05Z

Wdunczewski: /* Beschreibung */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

{{Hinweis
|Text = 16.09. Review Uwe: O.K. 
05.10.2012 Jens-Peter und Uwe Review: Überprüfen ob Laufzeitbalken" im Audioplayer sollen sich dem Speedmaster anpassen FS#629
im Artikel enthalten. 
Uhr-Button beschreiben, Hints in Audiospur beschreiben 
Audioplayer: Bar graphs representing scene length now take speedmaster into account (FS#629) 
01.11.2012 Uwe: Artikel ist fertig und kann nach Review auf 100% gesetzt werden. Falls was fehlt bitte Kommentar hier. 
}}
{{Start-LaTeX}}
==Überblick==

Mit dem Audioplayer können Audiotitel mit Szenen, Effekten und Befehlen unterlegt werden. Im Prinzip bietet der Audioplayer eine andere Oberfläche für eine [[Szenenliste_DMXC2|Szenenliste]], ähnlich dem Textbuch und dem Timecode-Player, nur dass hier die Möglichkeit besteht, die Szenen punktgenau zum Verlauf des Songs zu verankern. Hierdurch lassen sich für einzelne Songs individuelle Lightshows erstellen.

==Beschreibung==

Ein auffälliges Merkmal des Audioplayers sind die beiden Audiospuren, welche die Stereospuren eines Musiktitels präsentieren (linker Kanal: grün, rechter Kanal: rot). In diesem Fensterbereich wird der zeitliche Verlauf mit den entsprechenden Amplituden des Songs und die gesetzten Szenen angezeigt. Bei leistungsschwachen Computern empfiehlt es sich, mit der Checkbox "Grafik nicht laden" die Anzeige des Amplitudenverlaufs zu unterdrücken, wodurch CPU-Leistung eingespart wird.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_Fenster.png|1|Der Audioplayer|center|600px}}
<br\>
{{BoxWichtig
|Text = Der Audioplayer dient der Verlichtung von Audiodateien. Wenn es lediglich um das Abspielen von Audiodateien geht, ist die Audioszene zu bevorzugen. Dort können auch mehrere Audiokanäle (bis zu 16 Stück) parallel abspielen.
}}

==Bedienelemente==
{| class="wikitable centered"
|- style="vertical-align:top;"
! Icon
! Bezeichnung
! Beschreibung
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_DMXControl.png]]
|style="width: 170px; vertical-align:middle"| DMXControl
|style="width: 380px"| Mit dem Button DMXControl im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über DMXControl gestartet und abgespielt wird.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_WinAmp.png]]
|style="width: 170px; vertical-align:middle"| WinAmp
|style="width: 380px"| Mit dem Button WinAmp im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über das externe Programm WinAmp gestartet und abgespielt wird. (Syncronisation mit WinAmp)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Play.png]]
|style="width: 170px; vertical-align:middle"| Play
|style="width: 380px"| Der Play-Button startet das Soundfile und die Audio-Szeneliste, wenn der DMXControl-Button betätigt ist.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Rewind.png]]
|style="width: 170px; vertical-align:middle"| Rewind
|style="width: 380px"| Mit diesem Button wird der Audio-Cursor wieder auf den Anfang des Songs positioniert. (Dies funktioniert auch beim abspielen des Soundfiles)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Repeat.png]]
|style="width: 170px; vertical-align:middle"| Repeat
|style="width: 380px"| Ist dieser Button betätigt, dann wird das Soundfile nach dem Beenden wieder von vorne abgespielt.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Vorhören.png]]
|style="width: 170px; vertical-align:middle"| Vorhören
|style="width: 380px"| Mit dem Vorhören-Button wird das Soundfile ab der aktuellen Audio-Cursor Position abgespielt, bei einem erneuten Klick auf den Button stopt der Player und der Audio-Cursor kehrt in seine Ausgangsposition zurück.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Zoom.png]]
|style="width: 170px; vertical-align:middle"| Zoom
|style="width: 380px"| Mit dem Zoom Dropdown lässt sich die Audiospur vergrößern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Grafik_nicht_laden.png]]
|style="width: 170px; vertical-align:middle"| Grafik nicht laden
|style="width: 380px"| Wenn die Checkbox markiert ist wird die Audiospur-Grafik nicht geladen, dadurch lässt sich bei langsamen Computern die Performance steigern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Uhr.png]]
|style="width: 170px; vertical-align:middle"| Uhr
|style="width: 380px"| Mit dem Uhr-Button des wird die gerade markierte Szene in der Audio-Szenenliste auf die aktuelle Audio-Cursor-Position verschoben.
|}

Die restlichen Buttons sind Standard-Buttons bzw. selbsterklärend.

===Audiospur===
*Ein '''gelber''' senkrechter Strich, in der Audiospur, stellt die aktuelle Positionsmarkierung des Audio-Cursor dar.
*Ein '''weißer''' senkrechter Strich, in der Audiospur, zeigt die Szenen-Markierung mit bereits zugeordnete Positionen an.
*Die '''blauer''' senkrechter Strich, in der Audiospur, wird angezeigt wenn der Audio-Cursor auf einer zugeordneten Szene-Markierung steht.

Wenn man mit dem Maus-Cursor auf einer Szenen-Markierung ist verwandelt sich der Mauszeiger in einen Doppel-Pfeil, ausserdem wird ein Tooltip mit dem Namen der Szene angezeigt. Durch Klicken und festhalten der linken Maustaste, kann die Szenen-Markierung positioniert werden.

{{BoxHinweis
| Text=Befindet sich der Mauszeiger auf der Audiospur und nicht auf einer Szenen-Markierung, dann wird ein ToolTip angezeigt der lediglich einen Bindestrich enthält. Dieser ToolTip ist ohne weitere Bedeutung.
}}

===Audioprojekt Verwalten===
*'''Hinzufügen-Button:''' Durch diesen Button läßt sich ein neues Audiotrack-Projekt erstellen.
*'''Öffnen-Button:''' Mit diesem Button weist man dem Audiotrack-Projekt ein Audiofile zu. Mögliche Audiofiles müssen vom Typ mp3, mp2, mp1, wav oder ogg sein.
*'''Verwalten-Button''' Hinter diesem Button verbergen sich die Menüpunkte '''Hinzufügen''', '''Kopieren''', '''Umbenennen''', '''Löschen''' und '''Verwalten'''. Mit ihnen kann die Audiolisten verwaltet werden.

{{BoxWichtig
| Text = Bei Audiodateien mit variabler Bitrate (VBR) gibt es Probleme mit einem gewissen "Zeitversatz". 
Daher am besten Audiodateien mit konstanter Bitrate (z.b. 128kBit oder 320kBit) verwenden.
}}

===Bedienung===
Beim Klick mit der Maustaste in das Audiofenster, erscheint an der Stelle der Audio-Cursor (gelber Strich) an der entsprechenden Stelle. Damit lsst sich z.B. im '''Play'''-Mode (Drücken des Play-Buttons) an eine beliebige Stelle springen, um diese zu hören.
Ein Doppel-Klick ins Audiofenster startet den '''Play'''-Mode an der entsprechenden Stelle, ein erneuter Doppel-Klick stopt den '''Play'''-Mode dann wieder.

Neue Szenen können folgendermaßen zugewiesen werden:

*Hören Sie den Titel und achten Sie in der Grafik auf markante Stellen im Song, wo Sie Szenen, Effekte oder Befehle positionieren wollen. Diese Aktion erfolgt genau wie in anderen DMXControl-Tools durch Drücken des grünen '''Plus'''-Buttons.
*Besonders fixe Nutzer schaffen das sogar im Play-Mode, normalerweise stoppt man aber den Titel und positioniert den Cursor exakt an der gewünschten Stelle. Um das ganz genau hinzubekommen, gibt es zwei Möglichkeiten:
**Man vergrößert das Audioplayer-Fenster über die Breite des gesamten Bildschirms oder
**man kann einen Zoom-Faktor für die grafische Darstellung der Amplituden einstellen.
*Erstellen Sie eine neue Szene, wählen Sie eine aus der Szenenbibliothek oder definieren Sie einen Befehl.
*Sie können übrigens die Position eines Befehls im Audiotrack verändern, indem Sie den zugeordneten blauen Balken mit der Maus verschieben (Doppelpfeilcursor). Die neue Position wird in der Befehlsliste aktualisiert. Durch einen Klick auf den Listenkopf "Position" werden die Befehle aufsteigend oder absteigend sortiert.
*Die Fadein-Zeit kann durch Anklicken der entsprechenden Zelle in der Tabelle angepasst werden.
*Wenn Sie die Häkchen vor den Befehlsnamen ausschalten wird der entsprechende Befehl deaktiviert, verbleibt aber in der Trackdefinition. Dies kann man in der Erstellungsphase nutzen, um die Wechselwirkung einzelner Effekte zu testen bis man die richtige Kombination gefumden hat.

==Modulbezogene Befehle==

* Modul: '''Audiotrack'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 105px"| Gerät/Funktion
!style="width: 195px"| Beschreibung
!style="width: 105px"| Kanal
!style="width: 195px"| Beschreibung
|- style="vertical-align:top;"
|rowspan="4"| Ausgewählte
|rowspan="4"| Der weitere Befehl wird auf den aktuell ausgewählten Audiotrack angewendet. (Der Befehl Auswählen macht bei dieser Funktion keinen Sinn)
| Start/Stop
| Der Befehl ''Start/Stop'' startet und stopt den ausgewählten Audiotrack zur Wiedergabe. (Der Befehl sollte im Zusammenhang mit dem T-Flag eingesetzt werden.)
|- style="vertical-align:top;"
| Start
| Der Befehl ''Start'' startet den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| Stop
| Der Befehl ''Stop'' stopt den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| zurück Spulen
| Durch den Befehl ''zurück Spulen'' Springt der Audio-Cursor wieder an de Anfand des Soundfiles.
|- style="vertical-align:top;"
|rowspan="2"| Nächste Vorherige Sonstige Einträge
|rowspan="2"| Der weitere Befehl wird auf die aktuell nächste, vorherige oder im Dropdown benannten Audiotrack angewendet.
| Auswählen
| Wählt die nächste, vorherige bzw. die im Dropdown ''Gerät/Funktion'' benannten Audiotrack aus.
|- style="vertical-align:top;"
| Start/Stop Start Stop zurück Spulen
| siehe oben
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabe Fenster öffnet in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt um eine korrekte Funktion zu gewährleisten.
|}

==Tipps==

====Synchronisation des Audioplayers mit Winamp====

Der Audioplayer kann auch mit einer Playlist des Wimamp-Players synchronisiert werden:

*Der '''DMXControl'''-Button stellt den normalen Audioplayer-Mode ein.
*Der Audioplayer kann sich mit der Playliste des Winamp-Players synchronisieren, wenn Sie den '''Winamp'''-Button aktivieren. In diesem Fall sucht der Audioplayer, ob der gerade in der Playlist gespielte Song auch ein Audioplayer-Track ist und startet dann die entsprechenden Szenen und Effekte. Die Musiksteuerung (z.B. auch das Springen zu bestimmten Stellen) obliegt dann Winamp.

Der Vorteil dieses Betriebskonzeptes liegt darin, dass man dann natürlich synchrone Beats vom Beattrigger erhält, die musikgesteuerte Effekte triggern können. Dazu muß muß das Winamp AVS-Plugin installiert sein. Die Trackliste und die Winamp-Playlist synchronisieren sich über den in Winamp angezeigten Titel, meist der mp3-ID3-tag der Songs. Diesen kann man z.B. in Winamp im Menü "File->View file.info ..." einsehen und auch verändern (siehe folgendes Bild), natürlich geht das auch mit anderen mp3-Editoren. Der angezeigte Titel ist in Winamp bei "Einstellungen /Titel/Erweiterte Titelformatierung" veränderbar.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_TrackInformation.png|2|Trackinformationen in Winamp|center|400px}}

Um diesen Modus zu starten muß der '''Winamp-Button''' aktiviert sein (siehe Punkt 1 im folgenden Bild). Ganz '''wichtig''' ist, dass der Trackname mit dem angezeigten Titel des Songs übereinstimmt (siehe Punkt2 im Bild). Ob die Synchronisation erfolgreich ist, erkennt man daran, ob im Feld Audiodatei (wo der Songdateiname angegeben ist) ein "(X)" für erfolgreich oder ein "(-)" für nicht gefunden erscheint (siehe Punkt 3 im Bild).
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_WinampSteuerung.png|3|Synchronisisation des Audioplayers mit Winamp|center|750px}}
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

[[Kategorie:DMXControl 2]]

Audioplayer DMXC2

2012-11-06T17:26:33Z

Wdunczewski: /* Überblick */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

{{Hinweis
|Text = 16.09. Review Uwe: O.K. 
05.10.2012 Jens-Peter und Uwe Review: Überprüfen ob Laufzeitbalken" im Audioplayer sollen sich dem Speedmaster anpassen FS#629
im Artikel enthalten. 
Uhr-Button beschreiben, Hints in Audiospur beschreiben 
Audioplayer: Bar graphs representing scene length now take speedmaster into account (FS#629) 
01.11.2012 Uwe: Artikel ist fertig und kann nach Review auf 100% gesetzt werden. Falls was fehlt bitte Kommentar hier. 
}}
{{Start-LaTeX}}
==Überblick==

Mit dem Audioplayer können Audiotitel mit Szenen, Effekten und Befehlen unterlegt werden. Im Prinzip bietet der Audioplayer eine andere Oberfläche für eine [[Szenenliste_DMXC2|Szenenliste]], ähnlich dem Textbuch und dem Timecode-Player, nur dass hier die Möglichkeit besteht, die Szenen punktgenau zum Verlauf des Songs zu verankern. Hierdurch lassen sich für einzelne Songs individuelle Lightshows erstellen.

==Beschreibung==

Ein auffälliges Merkmal des Audioplayers sind die beiden Audiospuren, welche die Stereospuren eines Musiktitels präsentieren (linker Kanal: grün, rechter Kanal: rot). In diesem Fensterbereich wird der Frequenzverlauf mit den entsprechenden Amplituden des Songs und die gesetzten Szenen angezeigt. Bei leistungsschwachen Computern empfiehlt es sich, mit der Checkbox "Grafik nicht laden" die Anzeige des Amplitudenverlaufs zu unterdrücken, hierdurch wird CPU-Leistung eingespart.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_Fenster.png|1|Der Audioplayer|center|600px}}
<br\>
{{BoxWichtig
|Text = Der Audioplayer dient der Verlichtung von Audiodateien. Wenn es lediglich um das Abspielen von Audiodateien geht, ist die Audioszene zu bevorzugen. Dort können auch mehrere Audiokanäle (bis zu 16 Stück) parallel abspielen.
}}

==Bedienelemente==
{| class="wikitable centered"
|- style="vertical-align:top;"
! Icon
! Bezeichnung
! Beschreibung
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_DMXControl.png]]
|style="width: 170px; vertical-align:middle"| DMXControl
|style="width: 380px"| Mit dem Button DMXControl im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über DMXControl gestartet und abgespielt wird.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_WinAmp.png]]
|style="width: 170px; vertical-align:middle"| WinAmp
|style="width: 380px"| Mit dem Button WinAmp im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über das externe Programm WinAmp gestartet und abgespielt wird. (Syncronisation mit WinAmp)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Play.png]]
|style="width: 170px; vertical-align:middle"| Play
|style="width: 380px"| Der Play-Button startet das Soundfile und die Audio-Szeneliste, wenn der DMXControl-Button betätigt ist.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Rewind.png]]
|style="width: 170px; vertical-align:middle"| Rewind
|style="width: 380px"| Mit diesem Button wird der Audio-Cursor wieder auf den Anfang des Songs positioniert. (Dies funktioniert auch beim abspielen des Soundfiles)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Repeat.png]]
|style="width: 170px; vertical-align:middle"| Repeat
|style="width: 380px"| Ist dieser Button betätigt, dann wird das Soundfile nach dem Beenden wieder von vorne abgespielt.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Vorhören.png]]
|style="width: 170px; vertical-align:middle"| Vorhören
|style="width: 380px"| Mit dem Vorhören-Button wird das Soundfile ab der aktuellen Audio-Cursor Position abgespielt, bei einem erneuten Klick auf den Button stopt der Player und der Audio-Cursor kehrt in seine Ausgangsposition zurück.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Zoom.png]]
|style="width: 170px; vertical-align:middle"| Zoom
|style="width: 380px"| Mit dem Zoom Dropdown lässt sich die Audiospur vergrößern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Grafik_nicht_laden.png]]
|style="width: 170px; vertical-align:middle"| Grafik nicht laden
|style="width: 380px"| Wenn die Checkbox markiert ist wird die Audiospur-Grafik nicht geladen, dadurch lässt sich bei langsamen Computern die Performance steigern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Uhr.png]]
|style="width: 170px; vertical-align:middle"| Uhr
|style="width: 380px"| Mit dem Uhr-Button des wird die gerade markierte Szene in der Audio-Szenenliste auf die aktuelle Audio-Cursor-Position verschoben.
|}

Die restlichen Buttons sind Standard-Buttons bzw. selbsterklärend.

===Audiospur===
*Ein '''gelber''' senkrechter Strich, in der Audiospur, stellt die aktuelle Positionsmarkierung des Audio-Cursor dar.
*Ein '''weißer''' senkrechter Strich, in der Audiospur, zeigt die Szenen-Markierung mit bereits zugeordnete Positionen an.
*Die '''blauer''' senkrechter Strich, in der Audiospur, wird angezeigt wenn der Audio-Cursor auf einer zugeordneten Szene-Markierung steht.

Wenn man mit dem Maus-Cursor auf einer Szenen-Markierung ist verwandelt sich der Mauszeiger in einen Doppel-Pfeil, ausserdem wird ein Tooltip mit dem Namen der Szene angezeigt. Durch Klicken und festhalten der linken Maustaste, kann die Szenen-Markierung positioniert werden.

{{BoxHinweis
| Text=Befindet sich der Mauszeiger auf der Audiospur und nicht auf einer Szenen-Markierung, dann wird ein ToolTip angezeigt der lediglich einen Bindestrich enthält. Dieser ToolTip ist ohne weitere Bedeutung.
}}

===Audioprojekt Verwalten===
*'''Hinzufügen-Button:''' Durch diesen Button läßt sich ein neues Audiotrack-Projekt erstellen.
*'''Öffnen-Button:''' Mit diesem Button weist man dem Audiotrack-Projekt ein Audiofile zu. Mögliche Audiofiles müssen vom Typ mp3, mp2, mp1, wav oder ogg sein.
*'''Verwalten-Button''' Hinter diesem Button verbergen sich die Menüpunkte '''Hinzufügen''', '''Kopieren''', '''Umbenennen''', '''Löschen''' und '''Verwalten'''. Mit ihnen kann die Audiolisten verwaltet werden.

{{BoxWichtig
| Text = Bei Audiodateien mit variabler Bitrate (VBR) gibt es Probleme mit einem gewissen "Zeitversatz". 
Daher am besten Audiodateien mit konstanter Bitrate (z.b. 128kBit oder 320kBit) verwenden.
}}

===Bedienung===
Beim Klick mit der Maustaste in das Audiofenster, erscheint an der Stelle der Audio-Cursor (gelber Strich) an der entsprechenden Stelle. Damit lsst sich z.B. im '''Play'''-Mode (Drücken des Play-Buttons) an eine beliebige Stelle springen, um diese zu hören.
Ein Doppel-Klick ins Audiofenster startet den '''Play'''-Mode an der entsprechenden Stelle, ein erneuter Doppel-Klick stopt den '''Play'''-Mode dann wieder.

Neue Szenen können folgendermaßen zugewiesen werden:

*Hören Sie den Titel und achten Sie in der Grafik auf markante Stellen im Song, wo Sie Szenen, Effekte oder Befehle positionieren wollen. Diese Aktion erfolgt genau wie in anderen DMXControl-Tools durch Drücken des grünen '''Plus'''-Buttons.
*Besonders fixe Nutzer schaffen das sogar im Play-Mode, normalerweise stoppt man aber den Titel und positioniert den Cursor exakt an der gewünschten Stelle. Um das ganz genau hinzubekommen, gibt es zwei Möglichkeiten:
**Man vergrößert das Audioplayer-Fenster über die Breite des gesamten Bildschirms oder
**man kann einen Zoom-Faktor für die grafische Darstellung der Amplituden einstellen.
*Erstellen Sie eine neue Szene, wählen Sie eine aus der Szenenbibliothek oder definieren Sie einen Befehl.
*Sie können übrigens die Position eines Befehls im Audiotrack verändern, indem Sie den zugeordneten blauen Balken mit der Maus verschieben (Doppelpfeilcursor). Die neue Position wird in der Befehlsliste aktualisiert. Durch einen Klick auf den Listenkopf "Position" werden die Befehle aufsteigend oder absteigend sortiert.
*Die Fadein-Zeit kann durch Anklicken der entsprechenden Zelle in der Tabelle angepasst werden.
*Wenn Sie die Häkchen vor den Befehlsnamen ausschalten wird der entsprechende Befehl deaktiviert, verbleibt aber in der Trackdefinition. Dies kann man in der Erstellungsphase nutzen, um die Wechselwirkung einzelner Effekte zu testen bis man die richtige Kombination gefumden hat.

==Modulbezogene Befehle==

* Modul: '''Audiotrack'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 105px"| Gerät/Funktion
!style="width: 195px"| Beschreibung
!style="width: 105px"| Kanal
!style="width: 195px"| Beschreibung
|- style="vertical-align:top;"
|rowspan="4"| Ausgewählte
|rowspan="4"| Der weitere Befehl wird auf den aktuell ausgewählten Audiotrack angewendet. (Der Befehl Auswählen macht bei dieser Funktion keinen Sinn)
| Start/Stop
| Der Befehl ''Start/Stop'' startet und stopt den ausgewählten Audiotrack zur Wiedergabe. (Der Befehl sollte im Zusammenhang mit dem T-Flag eingesetzt werden.)
|- style="vertical-align:top;"
| Start
| Der Befehl ''Start'' startet den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| Stop
| Der Befehl ''Stop'' stopt den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| zurück Spulen
| Durch den Befehl ''zurück Spulen'' Springt der Audio-Cursor wieder an de Anfand des Soundfiles.
|- style="vertical-align:top;"
|rowspan="2"| Nächste Vorherige Sonstige Einträge
|rowspan="2"| Der weitere Befehl wird auf die aktuell nächste, vorherige oder im Dropdown benannten Audiotrack angewendet.
| Auswählen
| Wählt die nächste, vorherige bzw. die im Dropdown ''Gerät/Funktion'' benannten Audiotrack aus.
|- style="vertical-align:top;"
| Start/Stop Start Stop zurück Spulen
| siehe oben
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabe Fenster öffnet in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt um eine korrekte Funktion zu gewährleisten.
|}

==Tipps==

====Synchronisation des Audioplayers mit Winamp====

Der Audioplayer kann auch mit einer Playlist des Wimamp-Players synchronisiert werden:

*Der '''DMXControl'''-Button stellt den normalen Audioplayer-Mode ein.
*Der Audioplayer kann sich mit der Playliste des Winamp-Players synchronisieren, wenn Sie den '''Winamp'''-Button aktivieren. In diesem Fall sucht der Audioplayer, ob der gerade in der Playlist gespielte Song auch ein Audioplayer-Track ist und startet dann die entsprechenden Szenen und Effekte. Die Musiksteuerung (z.B. auch das Springen zu bestimmten Stellen) obliegt dann Winamp.

Der Vorteil dieses Betriebskonzeptes liegt darin, dass man dann natürlich synchrone Beats vom Beattrigger erhält, die musikgesteuerte Effekte triggern können. Dazu muß muß das Winamp AVS-Plugin installiert sein. Die Trackliste und die Winamp-Playlist synchronisieren sich über den in Winamp angezeigten Titel, meist der mp3-ID3-tag der Songs. Diesen kann man z.B. in Winamp im Menü "File->View file.info ..." einsehen und auch verändern (siehe folgendes Bild), natürlich geht das auch mit anderen mp3-Editoren. Der angezeigte Titel ist in Winamp bei "Einstellungen /Titel/Erweiterte Titelformatierung" veränderbar.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_TrackInformation.png|2|Trackinformationen in Winamp|center|400px}}

Um diesen Modus zu starten muß der '''Winamp-Button''' aktiviert sein (siehe Punkt 1 im folgenden Bild). Ganz '''wichtig''' ist, dass der Trackname mit dem angezeigten Titel des Songs übereinstimmt (siehe Punkt2 im Bild). Ob die Synchronisation erfolgreich ist, erkennt man daran, ob im Feld Audiodatei (wo der Songdateiname angegeben ist) ein "(X)" für erfolgreich oder ein "(-)" für nicht gefunden erscheint (siehe Punkt 3 im Bild).
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_WinampSteuerung.png|3|Synchronisisation des Audioplayers mit Winamp|center|750px}}
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

[[Kategorie:DMXControl 2]]

Audioplayer DMXC2

2012-11-06T17:25:07Z

Wdunczewski: /* Überblick */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

{{Hinweis
|Text = 16.09. Review Uwe: O.K. 
05.10.2012 Jens-Peter und Uwe Review: Überprüfen ob Laufzeitbalken" im Audioplayer sollen sich dem Speedmaster anpassen FS#629
im Artikel enthalten. 
Uhr-Button beschreiben, Hints in Audiospur beschreiben 
Audioplayer: Bar graphs representing scene length now take speedmaster into account (FS#629) 
01.11.2012 Uwe: Artikel ist fertig und kann nach Review auf 100% gesetzt werden. Falls was fehlt bitte Kommentar hier. 
}}
{{Start-LaTeX}}
==Überblick==

Mit dem Audioplayer können Audiotitel mit Szenen, Effekten und Befehlen unterlegt werden. Im Prinzip bietet der Audioplayer eine andere Oberfläche für eine [[Szenenliste_DMXC2|Szenenliste]], ähnlich des Textbuches und des Timecode-Players, nur dass hier die Möglichkeit besteht, die Szenen punktgenau im Verlauf des Songs zu verankern. Hierdurch lassen sich für einzelne Songs individuelle Lightshows ertellen.

==Beschreibung==

Ein auffälliges Merkmal des Audioplayers sind die beiden Audiospuren, welche die Stereospuren eines Musiktitels präsentieren (linker Kanal: grün, rechter Kanal: rot). In diesem Fensterbereich wird der Frequenzverlauf mit den entsprechenden Amplituden des Songs und die gesetzten Szenen angezeigt. Bei leistungsschwachen Computern empfiehlt es sich, mit der Checkbox "Grafik nicht laden" die Anzeige des Amplitudenverlaufs zu unterdrücken, hierdurch wird CPU-Leistung eingespart.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_Fenster.png|1|Der Audioplayer|center|600px}}
<br\>
{{BoxWichtig
|Text = Der Audioplayer dient der Verlichtung von Audiodateien. Wenn es lediglich um das Abspielen von Audiodateien geht, ist die Audioszene zu bevorzugen. Dort können auch mehrere Audiokanäle (bis zu 16 Stück) parallel abspielen.
}}

==Bedienelemente==
{| class="wikitable centered"
|- style="vertical-align:top;"
! Icon
! Bezeichnung
! Beschreibung
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_DMXControl.png]]
|style="width: 170px; vertical-align:middle"| DMXControl
|style="width: 380px"| Mit dem Button DMXControl im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über DMXControl gestartet und abgespielt wird.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_WinAmp.png]]
|style="width: 170px; vertical-align:middle"| WinAmp
|style="width: 380px"| Mit dem Button WinAmp im Audioplayer wird eingestellt, dass das Soundfile und die Audio-Szenenliste über das externe Programm WinAmp gestartet und abgespielt wird. (Syncronisation mit WinAmp)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Play.png]]
|style="width: 170px; vertical-align:middle"| Play
|style="width: 380px"| Der Play-Button startet das Soundfile und die Audio-Szeneliste, wenn der DMXControl-Button betätigt ist.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Rewind.png]]
|style="width: 170px; vertical-align:middle"| Rewind
|style="width: 380px"| Mit diesem Button wird der Audio-Cursor wieder auf den Anfang des Songs positioniert. (Dies funktioniert auch beim abspielen des Soundfiles)
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Repeat.png]]
|style="width: 170px; vertical-align:middle"| Repeat
|style="width: 380px"| Ist dieser Button betätigt, dann wird das Soundfile nach dem Beenden wieder von vorne abgespielt.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Button_Vorhören.png]]
|style="width: 170px; vertical-align:middle"| Vorhören
|style="width: 380px"| Mit dem Vorhören-Button wird das Soundfile ab der aktuellen Audio-Cursor Position abgespielt, bei einem erneuten Klick auf den Button stopt der Player und der Audio-Cursor kehrt in seine Ausgangsposition zurück.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Zoom.png]]
|style="width: 170px; vertical-align:middle"| Zoom
|style="width: 380px"| Mit dem Zoom Dropdown lässt sich die Audiospur vergrößern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Grafik_nicht_laden.png]]
|style="width: 170px; vertical-align:middle"| Grafik nicht laden
|style="width: 380px"| Wenn die Checkbox markiert ist wird die Audiospur-Grafik nicht geladen, dadurch lässt sich bei langsamen Computern die Performance steigern.
|- style="vertical-align:top;"
|style="width: 50px; text-align:center; vertical-align:middle"| [[Bild:DMXC2_Manual_Audioplayer_Uhr.png]]
|style="width: 170px; vertical-align:middle"| Uhr
|style="width: 380px"| Mit dem Uhr-Button des wird die gerade markierte Szene in der Audio-Szenenliste auf die aktuelle Audio-Cursor-Position verschoben.
|}

Die restlichen Buttons sind Standard-Buttons bzw. selbsterklärend.

===Audiospur===
*Ein '''gelber''' senkrechter Strich, in der Audiospur, stellt die aktuelle Positionsmarkierung des Audio-Cursor dar.
*Ein '''weißer''' senkrechter Strich, in der Audiospur, zeigt die Szenen-Markierung mit bereits zugeordnete Positionen an.
*Die '''blauer''' senkrechter Strich, in der Audiospur, wird angezeigt wenn der Audio-Cursor auf einer zugeordneten Szene-Markierung steht.

Wenn man mit dem Maus-Cursor auf einer Szenen-Markierung ist verwandelt sich der Mauszeiger in einen Doppel-Pfeil, ausserdem wird ein Tooltip mit dem Namen der Szene angezeigt. Durch Klicken und festhalten der linken Maustaste, kann die Szenen-Markierung positioniert werden.

{{BoxHinweis
| Text=Befindet sich der Mauszeiger auf der Audiospur und nicht auf einer Szenen-Markierung, dann wird ein ToolTip angezeigt der lediglich einen Bindestrich enthält. Dieser ToolTip ist ohne weitere Bedeutung.
}}

===Audioprojekt Verwalten===
*'''Hinzufügen-Button:''' Durch diesen Button läßt sich ein neues Audiotrack-Projekt erstellen.
*'''Öffnen-Button:''' Mit diesem Button weist man dem Audiotrack-Projekt ein Audiofile zu. Mögliche Audiofiles müssen vom Typ mp3, mp2, mp1, wav oder ogg sein.
*'''Verwalten-Button''' Hinter diesem Button verbergen sich die Menüpunkte '''Hinzufügen''', '''Kopieren''', '''Umbenennen''', '''Löschen''' und '''Verwalten'''. Mit ihnen kann die Audiolisten verwaltet werden.

{{BoxWichtig
| Text = Bei Audiodateien mit variabler Bitrate (VBR) gibt es Probleme mit einem gewissen "Zeitversatz". 
Daher am besten Audiodateien mit konstanter Bitrate (z.b. 128kBit oder 320kBit) verwenden.
}}

===Bedienung===
Beim Klick mit der Maustaste in das Audiofenster, erscheint an der Stelle der Audio-Cursor (gelber Strich) an der entsprechenden Stelle. Damit lsst sich z.B. im '''Play'''-Mode (Drücken des Play-Buttons) an eine beliebige Stelle springen, um diese zu hören.
Ein Doppel-Klick ins Audiofenster startet den '''Play'''-Mode an der entsprechenden Stelle, ein erneuter Doppel-Klick stopt den '''Play'''-Mode dann wieder.

Neue Szenen können folgendermaßen zugewiesen werden:

*Hören Sie den Titel und achten Sie in der Grafik auf markante Stellen im Song, wo Sie Szenen, Effekte oder Befehle positionieren wollen. Diese Aktion erfolgt genau wie in anderen DMXControl-Tools durch Drücken des grünen '''Plus'''-Buttons.
*Besonders fixe Nutzer schaffen das sogar im Play-Mode, normalerweise stoppt man aber den Titel und positioniert den Cursor exakt an der gewünschten Stelle. Um das ganz genau hinzubekommen, gibt es zwei Möglichkeiten:
**Man vergrößert das Audioplayer-Fenster über die Breite des gesamten Bildschirms oder
**man kann einen Zoom-Faktor für die grafische Darstellung der Amplituden einstellen.
*Erstellen Sie eine neue Szene, wählen Sie eine aus der Szenenbibliothek oder definieren Sie einen Befehl.
*Sie können übrigens die Position eines Befehls im Audiotrack verändern, indem Sie den zugeordneten blauen Balken mit der Maus verschieben (Doppelpfeilcursor). Die neue Position wird in der Befehlsliste aktualisiert. Durch einen Klick auf den Listenkopf "Position" werden die Befehle aufsteigend oder absteigend sortiert.
*Die Fadein-Zeit kann durch Anklicken der entsprechenden Zelle in der Tabelle angepasst werden.
*Wenn Sie die Häkchen vor den Befehlsnamen ausschalten wird der entsprechende Befehl deaktiviert, verbleibt aber in der Trackdefinition. Dies kann man in der Erstellungsphase nutzen, um die Wechselwirkung einzelner Effekte zu testen bis man die richtige Kombination gefumden hat.

==Modulbezogene Befehle==

* Modul: '''Audiotrack'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 105px"| Gerät/Funktion
!style="width: 195px"| Beschreibung
!style="width: 105px"| Kanal
!style="width: 195px"| Beschreibung
|- style="vertical-align:top;"
|rowspan="4"| Ausgewählte
|rowspan="4"| Der weitere Befehl wird auf den aktuell ausgewählten Audiotrack angewendet. (Der Befehl Auswählen macht bei dieser Funktion keinen Sinn)
| Start/Stop
| Der Befehl ''Start/Stop'' startet und stopt den ausgewählten Audiotrack zur Wiedergabe. (Der Befehl sollte im Zusammenhang mit dem T-Flag eingesetzt werden.)
|- style="vertical-align:top;"
| Start
| Der Befehl ''Start'' startet den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| Stop
| Der Befehl ''Stop'' stopt den ausgewählten Audiotrack zur Wiedergabe.
|- style="vertical-align:top;"
| zurück Spulen
| Durch den Befehl ''zurück Spulen'' Springt der Audio-Cursor wieder an de Anfand des Soundfiles.
|- style="vertical-align:top;"
|rowspan="2"| Nächste Vorherige Sonstige Einträge
|rowspan="2"| Der weitere Befehl wird auf die aktuell nächste, vorherige oder im Dropdown benannten Audiotrack angewendet.
| Auswählen
| Wählt die nächste, vorherige bzw. die im Dropdown ''Gerät/Funktion'' benannten Audiotrack aus.
|- style="vertical-align:top;"
| Start/Stop Start Stop zurück Spulen
| siehe oben
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabe Fenster öffnet in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt um eine korrekte Funktion zu gewährleisten.
|}

==Tipps==

====Synchronisation des Audioplayers mit Winamp====

Der Audioplayer kann auch mit einer Playlist des Wimamp-Players synchronisiert werden:

*Der '''DMXControl'''-Button stellt den normalen Audioplayer-Mode ein.
*Der Audioplayer kann sich mit der Playliste des Winamp-Players synchronisieren, wenn Sie den '''Winamp'''-Button aktivieren. In diesem Fall sucht der Audioplayer, ob der gerade in der Playlist gespielte Song auch ein Audioplayer-Track ist und startet dann die entsprechenden Szenen und Effekte. Die Musiksteuerung (z.B. auch das Springen zu bestimmten Stellen) obliegt dann Winamp.

Der Vorteil dieses Betriebskonzeptes liegt darin, dass man dann natürlich synchrone Beats vom Beattrigger erhält, die musikgesteuerte Effekte triggern können. Dazu muß muß das Winamp AVS-Plugin installiert sein. Die Trackliste und die Winamp-Playlist synchronisieren sich über den in Winamp angezeigten Titel, meist der mp3-ID3-tag der Songs. Diesen kann man z.B. in Winamp im Menü "File->View file.info ..." einsehen und auch verändern (siehe folgendes Bild), natürlich geht das auch mit anderen mp3-Editoren. Der angezeigte Titel ist in Winamp bei "Einstellungen /Titel/Erweiterte Titelformatierung" veränderbar.
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_TrackInformation.png|2|Trackinformationen in Winamp|center|400px}}

Um diesen Modus zu starten muß der '''Winamp-Button''' aktiviert sein (siehe Punkt 1 im folgenden Bild). Ganz '''wichtig''' ist, dass der Trackname mit dem angezeigten Titel des Songs übereinstimmt (siehe Punkt2 im Bild). Ob die Synchronisation erfolgreich ist, erkennt man daran, ob im Feld Audiodatei (wo der Songdateiname angegeben ist) ein "(X)" für erfolgreich oder ein "(-)" für nicht gefunden erscheint (siehe Punkt 3 im Bild).
{{Bild_mit_Unterschrift |DMXC2_Manual_Audioplayer_WinampSteuerung.png|3|Synchronisisation des Audioplayers mit Winamp|center|750px}}
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Kommandobox_DMXC2
|zurückText = Kommandobox
|vorLink = Timecode-Player_DMXC2
|vorText = Timecode-Player
}}

[[Kategorie:DMXControl 2]]

Handbuch DMXControl 2

2012-11-06T17:00:17Z

Wdunczewski:

__NOTITLE__
{{Hauptüberschrift
| logo = Books.png
| ueberschrift = Handbuch DMXControl 2
}}

{{Hinweis
|Text = Eine Artikelvorlage für Handbuchkapitel ist [[Hilfe:Vorlage Handbuchartikel|hier]] zu finden. 
Konventionen zu den Bilddateien befinden sich [[Hilfe:Bilder Konventionen|hier]]. 
Eine aktuelle Liste der nötigen Änderungen befindet sich [https://docs.google.com/spreadsheet/ccc?key=0AgS2IFq3SYsjdENtTW5RTVpzRVk1cjFsWk9PaVFQZEE#gid=1 hier]
}}

= Inhaltsverzeichnis =
{{Stages}}
{| width=100%
| width="50%" valign=top |
{{Stage short|100%|04.10.2012}} {{Pictures short|31.7.2012}} {{Spell check|01.11.2012}} {{Changed short}} [[Vorwort_DMXC2|Vorwort]] 
{{Stage short|100%|04.10.2012}} {{Pictures short|31.7.2012}} {{Spell check|01.11.2012}} {{Changed short}} [[Einleitung_DMXC2|Kapitel 1: Einleitung ]] 
{{Stage short|100%|04.10.2012}} {{Pictures short|31.7.2012}} {{Spell check|01.11.2012}} {{Changed short}} [[Installation_DMXC2|Kapitel 2: Installation]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|31.7.2012}} {{Spell check|01.11.2012}} {{Changed short}} [[Steuerzentrum_DMXC2|Kapitel 3: Das Steuerzentrum]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|26.10.2012}} {{Spell check|01.11.2012}} {{Changed short}}
[[Grafische Bühnenansicht_DMXC2|Kapitel 4: Grafische Bühnenansicht]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|10.8.2012}} {{Spell check|02.11.2012}} {{Changed short}} [[Geräte_DMXC2|Kapitel 5: Geräteliste]] 
{{Stage short|100%|04.10.2012}} {{Pictures short|15.8.2012}} {{Spell check|02.11.2012}} {{Changed short}} [[Ausgabeplugins_DMXC2|Kapitel 6: Ausgabe-Plugins]] 
{{Stage short|100%|04.10.2012}} {{Pictures short|2.8.2012}} {{Spell check|02.11.2012}} {{Changed short}} [[Kanalübersicht_DMXC2|Kapitel 7: Kanalübersicht]] 
{{Stage short|25%|05.10.2012}} {{Pictures short|}} {{Spell check|}} {{Changed short|05.10.2012}} [[Szenen_DMXC2|Kapitel 8: Szenen]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|6.8.2012}} {{Spell check|03.11.2012}} {{Changed short}} [[Szenenliste_DMXC2|Kapitel 9: Szenenliste]] 
{{Stage short|75%|15.07.2012}} {{Pictures short|}} {{Spell check|}} {{Changed short|05.10.2012}} [[Effektsequencer_DMXC2|Kapitel 10: Effektsequencer]] 
{{Stage short|75%|12.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short|05.10.2012}} [[Submaster_DMXC2|Kapitel 11: Submaster]] 
{{Stage short|100%|05.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|02.11.2012}} {{Changed short}} [[Master_DMXC2|Kapitel 12: Master]] 
{{Stage short|100%|05.10.2012}} {{Pictures short|12.9.2012}} {{Spell check|05.11.2012}} {{Changed short}}
[[Sound Analyzer_DMXC2|Kapitel 13: Sound Analyzer]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|09.07.2012}} {{Spell check|05.11.2012}} {{Changed short}} [[BeatTool_DMXC2|Kapitel 14: BeatTool]] 
{{Stage short|100%|05.10.2012}} {{Pictures short|6.8.2012}} {{Spell check|05.11.2012}} {{Changed short}} [[Kommandobox_DMXC2|Kapitel 15: Kommandobox]] 
{{Stage short|75%|31.10.2012}} {{Pictures short|13.9.2012}} {{Spell check|}} {{Changed short|31.10.2012}} [[Audioplayer_DMXC2|Kapitel 16: Audioplayer]] 
{{Stage short|100%|05.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|06.11.2012}} {{Changed short|06.11.2012}} [[Timecode-Player_DMXC2|Kapitel 17: Timecode-Player]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|06.11.2012}} {{Changed short|06.11.2012}} [[Textbuch_DMXC2|Kapitel 18: Textbuch]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|05.11.2012}} {{Changed short}} [[Kommandozeile_DMXC2|Kapitel 19: Kommandozeile]] 
|valign=top |
 
{{Stage short|100%|05.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Zeitplaner_DMXC2|Kapitel 20: Zeitplaner]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Bewegungsszene_DMXC2|Kapitel 21: Bewegungsszenen Editor]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Figureneditor_DMXC2|Kapitel 22: Figureneditor]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[PDA-Fernsteuerung_DMXC2|Kapitel 23: PDA-Fernsteuerung]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|26.10.2012}} {{Spell check|}} {{Changed short}} [[Tastatursteuerung_DMXC2|Kapitel 24: Tastatursteuerung]] 
{{Stage short|100%|09.10.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}}
[[Joysticksteuerung_DMXC2|Kapitel 25: Joysticksteuerung]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}}
[[MIDI-Fernsteuerung_DMXC2|Kapitel 26: MIDI-Fernsteuerung]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|6.8.2012}} {{Spell check|}} {{Changed short}}
[[DMXIn-Fernsteuerung_DMXC2|Kapitel 27: DMXIn-Fernsteuerung]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|18.9.2012}} {{Spell check|}} {{Changed short}} [[Programmkonfiguration_DMXC2|Kapitel 28: Programmkonfiguration]] 
{{Stage short|100%|06.10.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}}
[[Plugins_DMXC2|Kapitel 29: Plugin-Verwaltung]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Pack And Go_DMXC2|Kapitel 30: Pack And Go Funktion]] 
{{Stage short|100%|06.10.2012}} {{Pictures short}} {{Spell check|}} {{Changed short|06.10.2012}} [[DDF_DMXC2|Kapitel 31: DDF Grundlagen]] 
{{Stage short|75%|06.10.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[DDF Creator_DMXC2|Kapitel 32: Der DDFCreator]] 
{{Stage short|100%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Plugin:Beamertool_DMXC2|Kapitel 33: Plugin: Beamertool]] 
{{Stage short|100%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Plugin:MadMaxOne_DMXC2|Kapitel 34: Plugin: MadMaxOne]] 
{{Stage short|75%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Plugin:OSC Receiver_DMXC2|Kapitel 35: Plugin: OSC Receiver Modul]] 
{{Stage short|00%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Addon:Visualizer Magic EasyView_DMXC2|Kapitel 36: Addon: Magic EasyView Visualizer]] 
{{Stage short|50%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Glossar_DMXC2|Anhang1: Glossar]] 
{{Stage short|75%|31.10.2012}} {{Pictures short|18.9.2012}} {{Spell check|}} {{Changed short|31.10.2012}} [[Befehlsübersicht_DMXC2|Anhang2: Befehlsübersicht]] 
|}

[[Bild: DMXC2_Manual_Hauptseite_By-nc-nd.eu.png |150px| By-nc-nd.eu-Lizenz]]

Das Handbuch DMXControl 2.12 von DMXControl Projects e.V. steht unter einer [http://creativecommons.org/licenses/by-nc-nd/3.0/de/ Creative Commons Namensnennung-NichtKommerziell-KeineBearbeitung 3.0 Deutschland Lizenz].

[[de:Handbuch DMXControl 2]]
[[en:Manual DMXControl 2]]

Timecode-Player DMXC2

2012-11-06T16:59:37Z

Wdunczewski:

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Audioplayer_DMXC2
|zurückText = Audioplayer
|vorLink = Textbuch_DMXC2
|vorText = Textbuch
}}

{{Hinweis
|Text =
75% bearbeitet von Frank 
16.09. Review Uwe: O.K 
05.10.2012 Uwe und Jens-Peter: Review OK 
06.11.2012 Wolfgang Dunczewski: Rechtschreibkorrekturen
}}
{{Start-LaTeX}}
==Überblick==

Der Timecode-Player ähnelt in Funktion und grafischer Oberfläche dem Audioplayer. Mit diesem Tool kann man Szenen, Effekte und Befehle in zeitlicher Abhängigkeit eines Timecodes starten.

==Beschreibung==

Der Timecode-Player ist eher für Spezialanwendungen mit Timecode, wie z.B. Multimedia-Shows, Videos oder Feuerwerks-Synchronisation konzipiert. Ziel ist es, Szenen und Effekte synchron zum Timecode eines externen Gerätes auszulösen. Das Timecode-Signal wird dabei durch einen externen Master erzeugt und über den MIDI-In Port (als MTC-Signal) angekoppelt. Somit können Sie bestimmten externen Zeitsignalen individuelle Befehle zuordnen. Der Timecode kann von geeigneten MIDI-Keyboards oder von MIDI-Sequenzern wie Logic oder Cubase eingespielt werden. In diesem Fall wird die DMXControl Szenen- oder Effektfolge immer synchron zum gespielten Musiktitel ablaufen. Zur Anbindung der MIDI-Sequencer bietet sich die Software "MidiOx" an.

{{Bild_mit_Unterschrift |DMXC2_Manual_TimecodePlayer_Fenster.png|1|Der Timecode-Player|center}}

===Definition===

Für die Synchronisierung digitaler und analoger Audio-Komponenten wird auf analoger Seite typischerweise SMPTE benutzt (übrigens eine hörbares Signal). MIDI-Sequencer bedienen sich des MIDI-Timecodes (MTC), der in einen SMPTE-Timecode übersetzt werden kann und umgekehrt. Mit Hilfe entsprechender Geräte (Synchronizer) kann aus dem digitalen MTC ein analoges SMPTE Signal generiert und in Form eines Audio-Signals auf eine Spur einer (logischen) Mehrspurbandmaschine aufgezeichnet werden. Somit kann SMPTE auch als Trigger für eine zeitsensitive Lichtshow auf Basis eines Audio- oder Videosignals verwendet werden. SMPTE Timecodes können mit einer Genauigkeit von 1/1000 einer Sekunde aufgezeichnet werden.

====Einstellung====

*'''MIDI-In Port''': Hier wählen Sie den MIDI-Eingang, über den das MTC-Signal eingespielt wird.
*'''Erlaubter Offset-Bereich''': Genauigkeitsgrenze bei Verschiebungen in der Synchronisation. Hier wird die maximal akzeptierte Verzögerung angegeben. Falls durch hohe Auslastung des DMXControl-PCs ein größerer Nachlauf entsteht, werden die Effekte ignoriert.

====Sequenz====

Um eine Sequenz zu laden, geht man wie beim Audioplayer vor:

*Mit dem '''Add'''-Button richtet man eine neue Sequenz ein.
*Die Buttons '''Umbenennen''', '''Löschen''' und '''Kopieren''' beziehen sich auf Sequenzen und machen tatsächlich, was sie besagen. Man kann neue Befehle über den grünen '''Plus'''-Button zuweisen. Wählen Sie aus dem Befehlskontextmenü den gewünschten Befehlstyp aus und gehen Sie weiter wie unter "Befehl auswählen" beschrieben vor.
*Mit dem '''Change'''-Button (gelber Stift) können Sie einen Schritt der Sequenz ändern. Dieser muss dazu markiert sein.
*Mit dem '''Delete'''-Button (rotes Kreuz) wird der selektierte Befehl gelöscht.
*Man kann die Zeiten eines Befehls über die entsprechende Zeit-Einstellung in der Liste verändern.
*Mit der Checkbox '''Aktiv''' stellen Sie ein, ob überhaupt DMX-Signale an den Mixer gesendet werden sollen.

==Tipps==

*Wenn man die Häkchen vor den Befehlsnamen ausschaltet, wird der entsprechende Befehl deaktiviert, verbleibt aber in der Sequenzdefinition. Dies kann man in der Erstellungsphase nutzen, um die Wechselwirkung einzelner Effekte zu testen, bis man die richtige Kombination gefunden hat.
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Audioplayer_DMXC2
|zurückText = Audioplayer
|vorLink = Textbuch_DMXC2
|vorText = Textbuch
}}

[[Kategorie:DMXControl 2]]

Timecode-Player DMXC2

2012-11-06T16:59:10Z

Wdunczewski: /* Tipps */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Audioplayer_DMXC2
|zurückText = Audioplayer
|vorLink = Textbuch_DMXC2
|vorText = Textbuch
}}

{{Hinweis
|Text =
75% bearbeitet von Frank 
16.09. Review Uwe: O.K 
05.10.2012 Uwe und Jens-Peter: Review OK
}}
{{Start-LaTeX}}
==Überblick==

Der Timecode-Player ähnelt in Funktion und grafischer Oberfläche dem Audioplayer. Mit diesem Tool kann man Szenen, Effekte und Befehle in zeitlicher Abhängigkeit eines Timecodes starten.

==Beschreibung==

Der Timecode-Player ist eher für Spezialanwendungen mit Timecode, wie z.B. Multimedia-Shows, Videos oder Feuerwerks-Synchronisation konzipiert. Ziel ist es, Szenen und Effekte synchron zum Timecode eines externen Gerätes auszulösen. Das Timecode-Signal wird dabei durch einen externen Master erzeugt und über den MIDI-In Port (als MTC-Signal) angekoppelt. Somit können Sie bestimmten externen Zeitsignalen individuelle Befehle zuordnen. Der Timecode kann von geeigneten MIDI-Keyboards oder von MIDI-Sequenzern wie Logic oder Cubase eingespielt werden. In diesem Fall wird die DMXControl Szenen- oder Effektfolge immer synchron zum gespielten Musiktitel ablaufen. Zur Anbindung der MIDI-Sequencer bietet sich die Software "MidiOx" an.

{{Bild_mit_Unterschrift |DMXC2_Manual_TimecodePlayer_Fenster.png|1|Der Timecode-Player|center}}

===Definition===

Für die Synchronisierung digitaler und analoger Audio-Komponenten wird auf analoger Seite typischerweise SMPTE benutzt (übrigens eine hörbares Signal). MIDI-Sequencer bedienen sich des MIDI-Timecodes (MTC), der in einen SMPTE-Timecode übersetzt werden kann und umgekehrt. Mit Hilfe entsprechender Geräte (Synchronizer) kann aus dem digitalen MTC ein analoges SMPTE Signal generiert und in Form eines Audio-Signals auf eine Spur einer (logischen) Mehrspurbandmaschine aufgezeichnet werden. Somit kann SMPTE auch als Trigger für eine zeitsensitive Lichtshow auf Basis eines Audio- oder Videosignals verwendet werden. SMPTE Timecodes können mit einer Genauigkeit von 1/1000 einer Sekunde aufgezeichnet werden.

====Einstellung====

*'''MIDI-In Port''': Hier wählen Sie den MIDI-Eingang, über den das MTC-Signal eingespielt wird.
*'''Erlaubter Offset-Bereich''': Genauigkeitsgrenze bei Verschiebungen in der Synchronisation. Hier wird die maximal akzeptierte Verzögerung angegeben. Falls durch hohe Auslastung des DMXControl-PCs ein größerer Nachlauf entsteht, werden die Effekte ignoriert.

====Sequenz====

Um eine Sequenz zu laden, geht man wie beim Audioplayer vor:

*Mit dem '''Add'''-Button richtet man eine neue Sequenz ein.
*Die Buttons '''Umbenennen''', '''Löschen''' und '''Kopieren''' beziehen sich auf Sequenzen und machen tatsächlich, was sie besagen. Man kann neue Befehle über den grünen '''Plus'''-Button zuweisen. Wählen Sie aus dem Befehlskontextmenü den gewünschten Befehlstyp aus und gehen Sie weiter wie unter "Befehl auswählen" beschrieben vor.
*Mit dem '''Change'''-Button (gelber Stift) können Sie einen Schritt der Sequenz ändern. Dieser muss dazu markiert sein.
*Mit dem '''Delete'''-Button (rotes Kreuz) wird der selektierte Befehl gelöscht.
*Man kann die Zeiten eines Befehls über die entsprechende Zeit-Einstellung in der Liste verändern.
*Mit der Checkbox '''Aktiv''' stellen Sie ein, ob überhaupt DMX-Signale an den Mixer gesendet werden sollen.

==Tipps==

*Wenn man die Häkchen vor den Befehlsnamen ausschaltet, wird der entsprechende Befehl deaktiviert, verbleibt aber in der Sequenzdefinition. Dies kann man in der Erstellungsphase nutzen, um die Wechselwirkung einzelner Effekte zu testen, bis man die richtige Kombination gefunden hat.
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Audioplayer_DMXC2
|zurückText = Audioplayer
|vorLink = Textbuch_DMXC2
|vorText = Textbuch
}}

[[Kategorie:DMXControl 2]]

Timecode-Player DMXC2

2012-11-06T16:58:09Z

Wdunczewski: /* Sequenz */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Audioplayer_DMXC2
|zurückText = Audioplayer
|vorLink = Textbuch_DMXC2
|vorText = Textbuch
}}

{{Hinweis
|Text =
75% bearbeitet von Frank 
16.09. Review Uwe: O.K 
05.10.2012 Uwe und Jens-Peter: Review OK
}}
{{Start-LaTeX}}
==Überblick==

Der Timecode-Player ähnelt in Funktion und grafischer Oberfläche dem Audioplayer. Mit diesem Tool kann man Szenen, Effekte und Befehle in zeitlicher Abhängigkeit eines Timecodes starten.

==Beschreibung==

Der Timecode-Player ist eher für Spezialanwendungen mit Timecode, wie z.B. Multimedia-Shows, Videos oder Feuerwerks-Synchronisation konzipiert. Ziel ist es, Szenen und Effekte synchron zum Timecode eines externen Gerätes auszulösen. Das Timecode-Signal wird dabei durch einen externen Master erzeugt und über den MIDI-In Port (als MTC-Signal) angekoppelt. Somit können Sie bestimmten externen Zeitsignalen individuelle Befehle zuordnen. Der Timecode kann von geeigneten MIDI-Keyboards oder von MIDI-Sequenzern wie Logic oder Cubase eingespielt werden. In diesem Fall wird die DMXControl Szenen- oder Effektfolge immer synchron zum gespielten Musiktitel ablaufen. Zur Anbindung der MIDI-Sequencer bietet sich die Software "MidiOx" an.

{{Bild_mit_Unterschrift |DMXC2_Manual_TimecodePlayer_Fenster.png|1|Der Timecode-Player|center}}

===Definition===

Für die Synchronisierung digitaler und analoger Audio-Komponenten wird auf analoger Seite typischerweise SMPTE benutzt (übrigens eine hörbares Signal). MIDI-Sequencer bedienen sich des MIDI-Timecodes (MTC), der in einen SMPTE-Timecode übersetzt werden kann und umgekehrt. Mit Hilfe entsprechender Geräte (Synchronizer) kann aus dem digitalen MTC ein analoges SMPTE Signal generiert und in Form eines Audio-Signals auf eine Spur einer (logischen) Mehrspurbandmaschine aufgezeichnet werden. Somit kann SMPTE auch als Trigger für eine zeitsensitive Lichtshow auf Basis eines Audio- oder Videosignals verwendet werden. SMPTE Timecodes können mit einer Genauigkeit von 1/1000 einer Sekunde aufgezeichnet werden.

====Einstellung====

*'''MIDI-In Port''': Hier wählen Sie den MIDI-Eingang, über den das MTC-Signal eingespielt wird.
*'''Erlaubter Offset-Bereich''': Genauigkeitsgrenze bei Verschiebungen in der Synchronisation. Hier wird die maximal akzeptierte Verzögerung angegeben. Falls durch hohe Auslastung des DMXControl-PCs ein größerer Nachlauf entsteht, werden die Effekte ignoriert.

====Sequenz====

Um eine Sequenz zu laden, geht man wie beim Audioplayer vor:

*Mit dem '''Add'''-Button richtet man eine neue Sequenz ein.
*Die Buttons '''Umbenennen''', '''Löschen''' und '''Kopieren''' beziehen sich auf Sequenzen und machen tatsächlich, was sie besagen. Man kann neue Befehle über den grünen '''Plus'''-Button zuweisen. Wählen Sie aus dem Befehlskontextmenü den gewünschten Befehlstyp aus und gehen Sie weiter wie unter "Befehl auswählen" beschrieben vor.
*Mit dem '''Change'''-Button (gelber Stift) können Sie einen Schritt der Sequenz ändern. Dieser muss dazu markiert sein.
*Mit dem '''Delete'''-Button (rotes Kreuz) wird der selektierte Befehl gelöscht.
*Man kann die Zeiten eines Befehls über die entsprechende Zeit-Einstellung in der Liste verändern.
*Mit der Checkbox '''Aktiv''' stellen Sie ein, ob überhaupt DMX-Signale an den Mixer gesendet werden sollen.

==Tipps==

*Wenn man die Häkchen vor den Befehlsnamen ausschaltet, wird der entsprechende Befehl deaktiviert, verbleibt aber in der Sequenzdefinition. Dies kann man in der Erstellungsphase nutzen, um die Wechselwirkung einzelner Effekte zu testen bis man die richtige Kombination gefumden hat.
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Audioplayer_DMXC2
|zurückText = Audioplayer
|vorLink = Textbuch_DMXC2
|vorText = Textbuch
}}

[[Kategorie:DMXControl 2]]

Timecode-Player DMXC2

2012-11-06T16:48:33Z

Wdunczewski: /* Beschreibung */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Audioplayer_DMXC2
|zurückText = Audioplayer
|vorLink = Textbuch_DMXC2
|vorText = Textbuch
}}

{{Hinweis
|Text =
75% bearbeitet von Frank 
16.09. Review Uwe: O.K 
05.10.2012 Uwe und Jens-Peter: Review OK
}}
{{Start-LaTeX}}
==Überblick==

Der Timecode-Player ähnelt in Funktion und grafischer Oberfläche dem Audioplayer. Mit diesem Tool kann man Szenen, Effekte und Befehle in zeitlicher Abhängigkeit eines Timecodes starten.

==Beschreibung==

Der Timecode-Player ist eher für Spezialanwendungen mit Timecode, wie z.B. Multimedia-Shows, Videos oder Feuerwerks-Synchronisation konzipiert. Ziel ist es, Szenen und Effekte synchron zum Timecode eines externen Gerätes auszulösen. Das Timecode-Signal wird dabei durch einen externen Master erzeugt und über den MIDI-In Port (als MTC-Signal) angekoppelt. Somit können Sie bestimmten externen Zeitsignalen individuelle Befehle zuordnen. Der Timecode kann von geeigneten MIDI-Keyboards oder von MIDI-Sequenzern wie Logic oder Cubase eingespielt werden. In diesem Fall wird die DMXControl Szenen- oder Effektfolge immer synchron zum gespielten Musiktitel ablaufen. Zur Anbindung der MIDI-Sequencer bietet sich die Software "MidiOx" an.

{{Bild_mit_Unterschrift |DMXC2_Manual_TimecodePlayer_Fenster.png|1|Der Timecode-Player|center}}

===Definition===

Für die Synchronisierung digitaler und analoger Audio-Komponenten wird auf analoger Seite typischerweise SMPTE benutzt (übrigens eine hörbares Signal). MIDI-Sequencer bedienen sich des MIDI-Timecodes (MTC), der in einen SMPTE-Timecode übersetzt werden kann und umgekehrt. Mit Hilfe entsprechender Geräte (Synchronizer) kann aus dem digitalen MTC ein analoges SMPTE Signal generiert und in Form eines Audio-Signals auf eine Spur einer (logischen) Mehrspurbandmaschine aufgezeichnet werden. Somit kann SMPTE auch als Trigger für eine zeitsensitive Lichtshow auf Basis eines Audio- oder Videosignals verwendet werden. SMPTE Timecodes können mit einer Genauigkeit von 1/1000 einer Sekunde aufgezeichnet werden.

====Einstellung====

*'''MIDI-In Port''': Hier wählen Sie den MIDI-Eingang, über den das MTC-Signal eingespielt wird.
*'''Erlaubter Offset-Bereich''': Genauigkeitsgrenze bei Verschiebungen in der Synchronisation. Hier wird die maximal akzeptierte Verzögerung angegeben. Falls durch hohe Auslastung des DMXControl-PCs ein größerer Nachlauf entsteht, werden die Effekte ignoriert.

====Sequenz====

Um eine Sequenz zu laden, geht man wie beim Audioplayer vor:

*Mit dem '''Add'''-Button richtet man eine neue Sequenz ein.
*Die Buttons '''Umbenennen''', '''Löschen''' und '''Kopieren''' beziehen sich auf Sequenzen und machen tatsächlich, was sie besagen. Man kann neue Befehle über den grünen '''Plus'''-Button zuweisen. Wählen Sie aus dem Befehlskontextmenü den gewünschten Befehlstyp aus und gehen Sie weiter wie unter "Befehl auswählen" beschrieben vor.
*Mit dem '''Change'''-Button (gelber Stift) können Sie (neu definierte Szenen) ändern. Diese muss dazu markiert sein.
*Mit dem '''Delete'''-Button (rotes Kreuz) wird der selektierte Befehl gelöscht.
*Man kann die Zeitstempel eines Befehls über das entsprechende Zeit-Control in der Liste verändern.
*Mit der Checkbox '''Aktiv''' stellen Sie ein, ob überhaupt DMX-Signale an den Mixer gesendet werden sollen.

==Tipps==

*Wenn man die Häkchen vor den Befehlsnamen ausschaltet, wird der entsprechende Befehl deaktiviert, verbleibt aber in der Sequenzdefinition. Dies kann man in der Erstellungsphase nutzen, um die Wechselwirkung einzelner Effekte zu testen bis man die richtige Kombination gefumden hat.
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Audioplayer_DMXC2
|zurückText = Audioplayer
|vorLink = Textbuch_DMXC2
|vorText = Textbuch
}}

[[Kategorie:DMXControl 2]]

Timecode-Player DMXC2

2012-11-06T16:40:15Z

Wdunczewski: /* Überblick */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Audioplayer_DMXC2
|zurückText = Audioplayer
|vorLink = Textbuch_DMXC2
|vorText = Textbuch
}}

{{Hinweis
|Text =
75% bearbeitet von Frank 
16.09. Review Uwe: O.K 
05.10.2012 Uwe und Jens-Peter: Review OK
}}
{{Start-LaTeX}}
==Überblick==

Der Timecode-Player ähnelt in Funktion und grafischer Oberfläche dem Audioplayer. Mit diesem Tool kann man Szenen, Effekte und Befehle in zeitlicher Abhängigkeit eines Timecodes starten.

==Beschreibung==

Der Timecode-Player ist eher für Spezialanwendungen mit Timecode wie z.B. Multimedia-Shows, Video oder Feuerwerks-Synchonisation konzipiert. Ziel ist es, Szenen und Effekte synchron zum Timecode eines externen Gerätes auszulösen. Das Timecode-Signal wird dabei durch einen externen Master erzeugt und über den MIDI-In Port (als MTC-Signal) angekoppelt. Somit können Sie bestimmten externen Zeitsignalen individuelle Befehle zuordnen. Der Timecode kann von geeigneten MIDI-Keyboards oder von MIDI-Sequenzern wie Logic oder Cubase eingespielt werden. In diesem Falle wird die DMXControl Szenen-oder Effektfolge immer synchron zum gespielten Musiktitel ablaufen. Zur Anbindung der MIDI-Sequencer bietet sich die Software "MidiOx" an.

{{Bild_mit_Unterschrift |DMXC2_Manual_TimecodePlayer_Fenster.png|1|Der Timecode-Player|center}}

===Definition===

Für die Synchronisierung digitaler und analoger Audio-Komponenten wird auf analoger Seite typischerweise SMPTE benutzt (übrigens eine hörbare Spur). MIDI-Sequencer bedienen sich des MIDI-Timecodes (MTC), der in einen SMPTE-Timecode übersetzt werden kann und umgekehrt. Mit Hilfe entsprechender Geräte (Synchronizer) kann aus dem digitalen MTC ein analoges SMPTE Signal generiert und in Form eines Audio-Signals auf eine Spur einer (logischen) Mehrspurbandmaschine aufgezeichnet werden. Somit kann SMPTE auch als Trigger für eine zeitsensitive Lichtshow auf Basis eines Audio- oder Videosignals verwendet werden. SMPTE timecodes können mit einer Genauigkeit von 1/1000 einer Sekunde aufgezeichnet werden.

====Einstellung====

*'''MIDI-In Port''': Hier wählen sie den MIDI-Eingang, über den das MTC-Signal eingespielt wird.
*'''Erlaubter Offset-Bereich''': Genauigkeitsgrenze bei Verschiebungen in der Synchronisation. Hier wird die maximal akzeptierte Verzögerung angegeben. Falls durch hohe Auslastung des DMXControl-PCs ein größerer Nachlauf entsteht, werden die Effekte ignoriert.

====Sequenz====

Um eine Sequenz zu laden geht man wie beim Audioplayer vor:

*Mit dem '''Add'''-Button richtet man eine neue Sequenz ein.
*Die Buttons '''Umbenennen''', '''Löschen''' und '''Kopieren''' beziehen sich auf Sequenzen und machen tatsächlich, was sie besagen. Man kann neue Befehle über den grünen '''Plus'''-Button zuweisen. Wählen Sie aus dem Befehlskontextmenü den gewünschten Befehlstyp aus und gehen Sie weiter wie unter "Befehl auswählen" beschrieben vor.
*Mit dem '''Change'''-Button (gelber Stift) können Sie (neu definierte Szenen) ändern. Diese muss dazu markiert sein.
*Mit dem '''Delete'''-Button (rotes Kreuz) wird der selektierte Befehl gelöscht.
*Man kann die Zeitstempel eines Befehls über das entsprechende Zeit-Control in der Liste verändern.
*Mit der Checkbox '''Aktiv''' stellen Sie ein, ob überhaupt DMX-Signale an den Mixer gesendet werden sollen.

==Tipps==

*Wenn man die Häkchen vor den Befehlsnamen ausschaltet, wird der entsprechende Befehl deaktiviert, verbleibt aber in der Sequenzdefinition. Dies kann man in der Erstellungsphase nutzen, um die Wechselwirkung einzelner Effekte zu testen bis man die richtige Kombination gefumden hat.
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Audioplayer_DMXC2
|zurückText = Audioplayer
|vorLink = Textbuch_DMXC2
|vorText = Textbuch
}}

[[Kategorie:DMXControl 2]]

Handbuch DMXControl 2

2012-11-06T16:37:29Z

Wdunczewski:

__NOTITLE__
{{Hauptüberschrift
| logo = Books.png
| ueberschrift = Handbuch DMXControl 2
}}

{{Hinweis
|Text = Eine Artikelvorlage für Handbuchkapitel ist [[Hilfe:Vorlage Handbuchartikel|hier]] zu finden. 
Konventionen zu den Bilddateien befinden sich [[Hilfe:Bilder Konventionen|hier]]. 
Eine aktuelle Liste der nötigen Änderungen befindet sich [https://docs.google.com/spreadsheet/ccc?key=0AgS2IFq3SYsjdENtTW5RTVpzRVk1cjFsWk9PaVFQZEE#gid=1 hier]
}}

= Inhaltsverzeichnis =
{{Stages}}
{| width=100%
| width="50%" valign=top |
{{Stage short|100%|04.10.2012}} {{Pictures short|31.7.2012}} {{Spell check|01.11.2012}} {{Changed short}} [[Vorwort_DMXC2|Vorwort]] 
{{Stage short|100%|04.10.2012}} {{Pictures short|31.7.2012}} {{Spell check|01.11.2012}} {{Changed short}} [[Einleitung_DMXC2|Kapitel 1: Einleitung ]] 
{{Stage short|100%|04.10.2012}} {{Pictures short|31.7.2012}} {{Spell check|01.11.2012}} {{Changed short}} [[Installation_DMXC2|Kapitel 2: Installation]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|31.7.2012}} {{Spell check|01.11.2012}} {{Changed short}} [[Steuerzentrum_DMXC2|Kapitel 3: Das Steuerzentrum]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|26.10.2012}} {{Spell check|01.11.2012}} {{Changed short}}
[[Grafische Bühnenansicht_DMXC2|Kapitel 4: Grafische Bühnenansicht]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|10.8.2012}} {{Spell check|02.11.2012}} {{Changed short}} [[Geräte_DMXC2|Kapitel 5: Geräteliste]] 
{{Stage short|100%|04.10.2012}} {{Pictures short|15.8.2012}} {{Spell check|02.11.2012}} {{Changed short}} [[Ausgabeplugins_DMXC2|Kapitel 6: Ausgabe-Plugins]] 
{{Stage short|100%|04.10.2012}} {{Pictures short|2.8.2012}} {{Spell check|02.11.2012}} {{Changed short}} [[Kanalübersicht_DMXC2|Kapitel 7: Kanalübersicht]] 
{{Stage short|25%|05.10.2012}} {{Pictures short|}} {{Spell check|}} {{Changed short|05.10.2012}} [[Szenen_DMXC2|Kapitel 8: Szenen]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|6.8.2012}} {{Spell check|03.11.2012}} {{Changed short}} [[Szenenliste_DMXC2|Kapitel 9: Szenenliste]] 
{{Stage short|75%|15.07.2012}} {{Pictures short|}} {{Spell check|}} {{Changed short|05.10.2012}} [[Effektsequencer_DMXC2|Kapitel 10: Effektsequencer]] 
{{Stage short|75%|12.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short|05.10.2012}} [[Submaster_DMXC2|Kapitel 11: Submaster]] 
{{Stage short|100%|05.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|02.11.2012}} {{Changed short}} [[Master_DMXC2|Kapitel 12: Master]] 
{{Stage short|100%|05.10.2012}} {{Pictures short|12.9.2012}} {{Spell check|05.11.2012}} {{Changed short}}
[[Sound Analyzer_DMXC2|Kapitel 13: Sound Analyzer]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|09.07.2012}} {{Spell check|05.11.2012}} {{Changed short}} [[BeatTool_DMXC2|Kapitel 14: BeatTool]] 
{{Stage short|100%|05.10.2012}} {{Pictures short|6.8.2012}} {{Spell check|05.11.2012}} {{Changed short}} [[Kommandobox_DMXC2|Kapitel 15: Kommandobox]] 
{{Stage short|75%|31.10.2012}} {{Pictures short|13.9.2012}} {{Spell check|}} {{Changed short|31.10.2012}} [[Audioplayer_DMXC2|Kapitel 16: Audioplayer]] 
{{Stage short|100%|05.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Timecode-Player_DMXC2|Kapitel 17: Timecode-Player]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|06.11.2012}} {{Changed short|06.11.2012}} [[Textbuch_DMXC2|Kapitel 18: Textbuch]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|05.11.2012}} {{Changed short}} [[Kommandozeile_DMXC2|Kapitel 19: Kommandozeile]] 
|valign=top |
 
{{Stage short|100%|05.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Zeitplaner_DMXC2|Kapitel 20: Zeitplaner]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Bewegungsszene_DMXC2|Kapitel 21: Bewegungsszenen Editor]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Figureneditor_DMXC2|Kapitel 22: Figureneditor]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[PDA-Fernsteuerung_DMXC2|Kapitel 23: PDA-Fernsteuerung]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|26.10.2012}} {{Spell check|}} {{Changed short}} [[Tastatursteuerung_DMXC2|Kapitel 24: Tastatursteuerung]] 
{{Stage short|100%|09.10.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}}
[[Joysticksteuerung_DMXC2|Kapitel 25: Joysticksteuerung]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}}
[[MIDI-Fernsteuerung_DMXC2|Kapitel 26: MIDI-Fernsteuerung]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|6.8.2012}} {{Spell check|}} {{Changed short}}
[[DMXIn-Fernsteuerung_DMXC2|Kapitel 27: DMXIn-Fernsteuerung]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|18.9.2012}} {{Spell check|}} {{Changed short}} [[Programmkonfiguration_DMXC2|Kapitel 28: Programmkonfiguration]] 
{{Stage short|100%|06.10.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}}
[[Plugins_DMXC2|Kapitel 29: Plugin-Verwaltung]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Pack And Go_DMXC2|Kapitel 30: Pack And Go Funktion]] 
{{Stage short|100%|06.10.2012}} {{Pictures short}} {{Spell check|}} {{Changed short|06.10.2012}} [[DDF_DMXC2|Kapitel 31: DDF Grundlagen]] 
{{Stage short|75%|06.10.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[DDF Creator_DMXC2|Kapitel 32: Der DDFCreator]] 
{{Stage short|100%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Plugin:Beamertool_DMXC2|Kapitel 33: Plugin: Beamertool]] 
{{Stage short|100%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Plugin:MadMaxOne_DMXC2|Kapitel 34: Plugin: MadMaxOne]] 
{{Stage short|75%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Plugin:OSC Receiver_DMXC2|Kapitel 35: Plugin: OSC Receiver Modul]] 
{{Stage short|00%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Addon:Visualizer Magic EasyView_DMXC2|Kapitel 36: Addon: Magic EasyView Visualizer]] 
{{Stage short|50%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Glossar_DMXC2|Anhang1: Glossar]] 
{{Stage short|75%|31.10.2012}} {{Pictures short|18.9.2012}} {{Spell check|}} {{Changed short|31.10.2012}} [[Befehlsübersicht_DMXC2|Anhang2: Befehlsübersicht]] 
|}

[[Bild: DMXC2_Manual_Hauptseite_By-nc-nd.eu.png |150px| By-nc-nd.eu-Lizenz]]

Das Handbuch DMXControl 2.12 von DMXControl Projects e.V. steht unter einer [http://creativecommons.org/licenses/by-nc-nd/3.0/de/ Creative Commons Namensnennung-NichtKommerziell-KeineBearbeitung 3.0 Deutschland Lizenz].

[[de:Handbuch DMXControl 2]]
[[en:Manual DMXControl 2]]

Textbuch DMXC2

2012-11-06T16:36:34Z

Wdunczewski:

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Timecode-Player_DMXC2
|zurückText = Timecode-Player
|vorLink = Kommandozeile_DMXC2
|vorText = Kommandozeile
}}

{{Hinweis
|Text = Jens-Peter (JPK) [3.08.2012, 1:15Uhr]: Artikel fertig gestellt und kann gegengelesen werden 
07.08.: Review Frank: OK, sehr gut 
11.09. Review Uwe: O.K. super Artikel 
05.10.2012: Uwe und Jens-Peter: Review OK 
06.11.2012 Wolfgang Dunczewski: Rechtschreibkorrekturen
}}
{{Start-LaTeX}}
==Überblick==
Gerade bei Theater- und Musicalveranstaltungen ist es entscheidend, dass Lichtstimmungen und Effekte auf ein Stichwort genau zum Einsatz kommen. Dafür ist das Textbuch-Modul in DMXControl integriert. Mit diesem können Sie Licht- oder Bewegungsszenen, aber auch Soundeffekte (wie Donner, Hundegebell oder ähnliches) sowie Befehle zu gewissen Textstellen in einem Theater- oder Musicalstück starten. Dabei bleibt der Einsatzbereich des Textbuch-Moduls nicht auf Theater und Musical beschränkt, denn auch für andere Veranstaltungen mit festem Ablauf wie Chor- oder Karnevalsveranstaltungen ist dieses Modul geeignet.

{{Bild_mit_Unterschrift |DMXC2_Manual_Textbuch_Fenster.png|1|Das Textbuch-Modul|center}}

==Beschreibung==

Das Fenster des Textbuch-Moduls ist in drei Bereiche geteilt:

* der Textfeldbereich mit Texteditorfunktionen im oberen Teil des Moduls
* der Steuerungsbereich mit Buttons zur Steuerung der Aufführung im mittleren Teil des Moduls
* der Regiebereich mit einer Szenenübersicht und Szenenbearbeitungsfunktionen im unteren Teil des Moduls
 

===Textfeldbereich===

Der Textfeldbereich umfasst einen Texteditor, mit dem Sie im Textbuch (im folgenden als Skript bezeichnet) scrollen können, ohne den Szenenablauf zu beeinflussen. Außerdem können Sie mit dem Editor einfache Anpassungen, wie die Änderung der Farbe oder der Größe des Skripttextes vornehmen. Das genügt, um z.B. Stichworte zu unterstreichen oder eigene Regieeinträge aufgabenbezogen in unterschiedlichen Farben einzufärben. Der Editor des Moduls ist aber nicht darauf ausgelegt, das Skript z.B. in diesem Editor zu schreiben oder umfassende Anpassungen vorzunehmen. Dafür ist ein handelsüblicher Texteditor besser geeignet.
 

Um Skript-Dateien in DMXControl öffnen zu können, müssen diese im "'''Rich Text Format'''"<ref>Wikipedia: http://de.wikipedia.org/wiki/Rich_Text_Format</ref> (Dateiendung "'''.rtf'''") vorliegen. Damit der Text im Textfeld nicht zu umfangreich wird, sollte das Skript in mehrere Teile aufgeteilt werden, vorzugsweise zu jeder Pause eine Unterteilung. Die so entstandenen Teilskripte können in den Pausen entsprechend über ein, weiter unten im Artikel noch genauer erklärtes, Auswahlfeld separat geladen werden. Außerdem ist die Textstruktur des Skriptes im Textbuch-Modul nicht vorgegeben. Das heißt, Sie können das Skript individuell an ihre Anforderungen anpassen und müssen sich nicht auf eine DMXControl-spezifische Textstruktur einstellen.

Unter dem Textfeld befindet sich ein kleiner Fortschrittsbalken. Dieser zeigt den aktuellen Fortschitt im Skript, anhand dessen man ungefähr abschätzen kann, wie lange das aktuelle Stück schon läuft und wieviel Text noch bis zur nächsten Pause bzw. dem Ende des Stückes folgt.

Damit DMXControl erkennt, an welchen Stellen im Skript entsprechende Szenen stehen, werden Szenenreferenzen mit Verweisen auf die entsprecheden Szenen erstellt. Diese Verweise werden von DMXControl immer zu Begin einer neuen Zeile in den Skripttext eingefügt. Am besten lässt man je eine Zeile oberhalb und unterhalb der Referenz frei, damit das Skript so übersichtlich wie möglich bleibt.

{{BoxWichtig |Text = Die Zeichenfolge '''###''' darf im normalen Text des Skriptes nicht vorkommen, da DMXControl diese Zeichenkette als Markierung für die erstellten Referenzeinträge benutzt. Wird diese Zeichenkette verwendet, kann es zu schweren Fehlern kommen!}}

===Szenenreferenzen===
Szenenreferenzen werden von DMXControl hervorgehoben, damit diese besser lesbar sind. Sie haben stets folgendes Format:

### <Szenen-ID> - <Szenenname> ### <Regiekommentar>

Die Szenen-ID ist eine von DMXControl automatisch erzeugte vierstellige Referenznummer. Diese Nummer wird benötigt, damit DMXControl in der internen Datenbank die richtige Szene zu der Szenenreferenz findet. Der Szenenname entspricht dem in DMXControl vergebenen Szenennamen und kann bei der Erstellung der Szene individuell gewählt werden. Hier sollte darauf geachtet werden, treffende Namen zu verwenden, damit bei einer Suche die entsprechenden Szenen schnell wieder gefunden werden können. Zusätzliche Informationen, wie die Art der Lichtstimmung, können als Regiekommentar am Ende einer Szenenreferenz stehen. Eine Szenenreferenz kann z.B. wie folgt aussehen:

###0002 – Gewitter### Donner(Audio)

Es können alle von DMXControl unterstützten Szenenarten wie "Einfache Szene" oder "Audioszene" im Textbuch verwendet werden. Da die erstellten Szenenreferenzen auch nur Zeichenketten sind, können diese, genau wie der restliche Text des Skriptes, mit einem externen Editor bearbeitet werden. Daher führt DMXControl bei jedem Start eine Konsistenzprüfung durch, ob alle im Textbuch angegebenen Szenen in der internen Datenbank vorhanden sind. Wurde eine Szene in der Datenbank gefunden, dann wird im Regiebereich ein grüner Rhombus neben dem Namen der entsprechenden Szene angezeigt. Verweist ein Szeneneintrag auf keine existierende Szene, dann ist der Rhombus neben dem Namen rot gefärbt.

{{BoxAchtung |Text = Es sollte unbedingt darauf geachtet werden, dass die Szenenreferenzen beim Bearbeiten mit einem externen Texteditor nicht verändert werden, da hierdurch Szenenreferenzen verloren gehen können und es zu Inkonsistenzen kommen kann}}

==Bedienelemente==

===Steuerungsbereich===

[[Datei: DMXC2_Manual_Textbuch_SteuerungsbereichNormal.png | miniatur | 600px | zentriert | Bild 2: Der Steuerbereich]]
Im Steuerungsbereich befinden sich vier Buttons. Der größte von ihnen ist der '''GO-Button'''. Er startet die ausgewählte Szene und selektiert automatisch die nachfolgende Szene. So werden durch mehrmaliges Klicken auf den '''GO-Button''' der Reihe nach alle Szenen im Skript gestartet.

Links daneben befinden sich zwei Navigationsbuttons, '''Zurück''' und '''Vor'''. Mit ihnen kann man zwischen den Szenen navigieren, ohne sie auszuführen. So kann man einzelne Szenenreferenzen überspringen, falls mal ein Stichwort verpasst wurde und nun die nächste Szene ausgewählt werden soll.

Rechts neben dem GO-Button befindet sich der '''AutoScroll-Button'''. Mit diesem kann die AutoScroll-Funktion des Textbuches aktiviert bzw. deaktiviert werden. Bei der AutoScroll-Funktion wird eine rote Leselinie angezeigt und das Textbuch scrollt die Leselinie und das Skript immer bis zur nächsten Szenenreferenz. Die Scrollgeschwindigkeit wird aus der angegebenen Delta-Zeit zur nächsten Szene im Regiebereich abgeleitet, wodurch in der Regel eine manuelle Anpassung erforderlich ist.

[[Datei: DMXC2_Manual_Textbuch_SteuerungsbereichSuche.png | miniatur | 600px | zentriert | Bild 3: Der Steuerbereich im Such-Modus]]

Der Steuerbereich beinhaltet seit der Version 2.11 von DMXControl auch eine kleine Suchfunktion. Mit Hilfe der Tastenkombination '''Strg''' + '''F''' wird die Suchfunktion aktiviert. Sie durchsucht das Skript bei einem Klick auf '''Nächster Treffer''' ab der aktuellen Cursor-Position nach dem eingegebenen Suchtext. Wird der Suchtext im Skript gefunden, so springt das Textbuch an diese Position und markiert die entsprechende Textstelle. Der linke Button in der Suchansicht schließt die Suchfunktion und zeigt wieder die Steueransicht an.

===Regiebereich===

Der Regiebereich beinhaltet im oberen Teilbereich eine Textbuchverwaltung. Mit dem Dropdown-Menü lassen sich die unterschiedlichen Teilskripte auswählen und können mit dem Button '''Verwalten''' angelegt, kopiert, umbenannt oder gelöscht werden. Mit '''Öffnen''' kann zu jedem Teilskript die passende Textdatei geöffnet werden.

Im unteren Teil befindet sich eine Liste mit allen im Skript enthaltenen Szenen, welche nach ihrem Erscheinen im Skript sortiert sind. In dieser Liste werden verschiedene Parameter jeder einzelnen Szene angezeigt, die teilweise durch langsames, doppeltes Klicken (kein Doppelklick) bearbeitet werden können:

[[Datei: DMXC2_Manual_Textbuch_Szenenliste.png | miniatur | zentriert | 800px | Bild 4: Auschnitt aus der Szenenenliste des Textbuches]]

{| class="wikitable centered"
|- style="vertical-align:top;"
!
! Funktion
! Beschreibung
! Bearbeitbar
|- style="vertical-align:top;"
|style="width: 10px"| 1
|style="width: 100px"| Szene aktiv
|style="width: 500px"| Hier kann ausgewählt werden, ob die Szene im Ablauf berücksichtigt oder ausgelassen wird
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 2
|style="width: 100px"| grüner / roter Rhombus
|style="width: 500px"| Stimmen Szenenreferenz und Szene in der Datenbank überein, ist der Rhombus grün, andernfalls rot
|style="width: 100px"| Nein
|- style="vertical-align:top;"
|style="width: 10px"| 3
|style="width: 100px"| Name
|style="width: 500px"| Name des entsprechenden Szeneneintrags
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 4
|style="width: 100px"| Zeile
|style="width: 500px"| Hier wird die Zeilennummer der Szenenreferenz angezeigt
|style="width: 100px"| Nein
|- style="vertical-align:top;"
|style="width: 10px"| 5
|style="width: 100px"| Delta-T
|style="width: 500px"| Zeit zwischen der letzten und der aktuellen Szene. Der hier angegebene Wert hat Einfluss auf die Scrollgeschwindigkeit der AutoScroll-Funktion
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 6
|style="width: 100px"| Stichwort
|style="width: 500px"| Als kleine Hilfe kann hier eine Textstelle angegeben werden, an der die Szene gestartet werden soll
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 7
|style="width: 100px"| Kommentar
|style="width: 500px"| Hier kann eine Notiz mit zusätzlichen Informationen zur Szene angegeben werden, die am Ende der entsprechenden Szenenreferenz im Skript erscheint
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 8
|style="width: 100px"| Einblendzeit
|style="width: 500px"| Die Einblendzeit bestimmt, wie lange die Überblendung von der letzten Szene zur aktuellen Szene dauern soll
|style="width: 100px"| Ja
|}

 

Links von der Szenenliste sind die aus anderen Modulen bekannten Button zum Erstellen, Bearbeiten und Löschen einzelner Szeneneinträge. Näheres zu ihrer Bedienung finden Sie im Artikel Szenen-Modul.
Unterhalb der Szenenliste befindet sich der Szenenfortschrittsbalken. Dieser zeigt grafisch an, wie lange die aktuelle Szene im Verhältnis zu ihrer Einblenddauer schon eingeblendet wird.

{{BoxWichtig |Text = Werden mehrere Szenen gleichzeitig gestartet, die die gleichen Geräte beinhalten, so beginnt die DMX-Ausgabe zu springen und das Licht fängt an zu flackern. Außerdem können Szeneneinblendungen nicht abgebrochen werden. Daher muss darauf geachtet werden, dass die Einblendzeiten nicht zu groß gewählt werden!}}

==Modulbezogene Befehle==

* Modul: '''Textbuch'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 100px"| Gerät/Funktion
!style="width: 200px"| Beschreibung
!style="width: 100px"| Kanal
!style="width: 200px"| Beschreibung
|- style="vertical-align:top;"
|style="width: 100px"| Go-Button
|style="width: 200px"| Auf den Go-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px"| Zurück-Button
|style="width: 200px"| Auf den Zurück-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px"| Vor-Button
|style="width: 200px"| Auf den Vor-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px" rowspan="3"| Textbuch auswählen
|style="width: 200px" rowspan="3"| Der weitere Befehl wählt das entsprechende Textbuch aus.
|style="width: 100px"| Nächstes
|style="width: 200px"| Wählt das nächste Textbuch aus.
|- style="vertical-align:top;"
|style="width: 100px"| Vorheriges
|style="width: 200px"| Wählt das vorherige Textbuch aus.
|- style="vertical-align:top;"
|style="width: 100px"| Textbuch-Name
|style="width: 200px"| Wählt das Textbuch mit dem Namen aus der Dropdown-Liste.
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabefenster öffnet, in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt, um eine korrekte Funktion zu gewährleisten.
|}

== Links und Referenzen==
<references/>
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Timecode-Player_DMXC2
|zurückText = Timecode-Player
|vorLink = Kommandozeile_DMXC2
|vorText = Kommandozeile
}}

[[Kategorie: DMXControl 2]]

Textbuch DMXC2

2012-11-06T16:36:02Z

Wdunczewski: /* Modulbezogene Befehle */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Timecode-Player_DMXC2
|zurückText = Timecode-Player
|vorLink = Kommandozeile_DMXC2
|vorText = Kommandozeile
}}

{{Hinweis
|Text = Jens-Peter (JPK) [3.08.2012, 1:15Uhr]: Artikel fertig gestellt und kann gegengelesen werden 
07.08.: Review Frank: OK, sehr gut 
11.09. Review Uwe: O.K. super Artikel 
05.10.2012: Uwe und Jens-Peter: Review OK
}}
{{Start-LaTeX}}
==Überblick==
Gerade bei Theater- und Musicalveranstaltungen ist es entscheidend, dass Lichtstimmungen und Effekte auf ein Stichwort genau zum Einsatz kommen. Dafür ist das Textbuch-Modul in DMXControl integriert. Mit diesem können Sie Licht- oder Bewegungsszenen, aber auch Soundeffekte (wie Donner, Hundegebell oder ähnliches) sowie Befehle zu gewissen Textstellen in einem Theater- oder Musicalstück starten. Dabei bleibt der Einsatzbereich des Textbuch-Moduls nicht auf Theater und Musical beschränkt, denn auch für andere Veranstaltungen mit festem Ablauf wie Chor- oder Karnevalsveranstaltungen ist dieses Modul geeignet.

{{Bild_mit_Unterschrift |DMXC2_Manual_Textbuch_Fenster.png|1|Das Textbuch-Modul|center}}

==Beschreibung==

Das Fenster des Textbuch-Moduls ist in drei Bereiche geteilt:

* der Textfeldbereich mit Texteditorfunktionen im oberen Teil des Moduls
* der Steuerungsbereich mit Buttons zur Steuerung der Aufführung im mittleren Teil des Moduls
* der Regiebereich mit einer Szenenübersicht und Szenenbearbeitungsfunktionen im unteren Teil des Moduls
 

===Textfeldbereich===

Der Textfeldbereich umfasst einen Texteditor, mit dem Sie im Textbuch (im folgenden als Skript bezeichnet) scrollen können, ohne den Szenenablauf zu beeinflussen. Außerdem können Sie mit dem Editor einfache Anpassungen, wie die Änderung der Farbe oder der Größe des Skripttextes vornehmen. Das genügt, um z.B. Stichworte zu unterstreichen oder eigene Regieeinträge aufgabenbezogen in unterschiedlichen Farben einzufärben. Der Editor des Moduls ist aber nicht darauf ausgelegt, das Skript z.B. in diesem Editor zu schreiben oder umfassende Anpassungen vorzunehmen. Dafür ist ein handelsüblicher Texteditor besser geeignet.
 

Um Skript-Dateien in DMXControl öffnen zu können, müssen diese im "'''Rich Text Format'''"<ref>Wikipedia: http://de.wikipedia.org/wiki/Rich_Text_Format</ref> (Dateiendung "'''.rtf'''") vorliegen. Damit der Text im Textfeld nicht zu umfangreich wird, sollte das Skript in mehrere Teile aufgeteilt werden, vorzugsweise zu jeder Pause eine Unterteilung. Die so entstandenen Teilskripte können in den Pausen entsprechend über ein, weiter unten im Artikel noch genauer erklärtes, Auswahlfeld separat geladen werden. Außerdem ist die Textstruktur des Skriptes im Textbuch-Modul nicht vorgegeben. Das heißt, Sie können das Skript individuell an ihre Anforderungen anpassen und müssen sich nicht auf eine DMXControl-spezifische Textstruktur einstellen.

Unter dem Textfeld befindet sich ein kleiner Fortschrittsbalken. Dieser zeigt den aktuellen Fortschitt im Skript, anhand dessen man ungefähr abschätzen kann, wie lange das aktuelle Stück schon läuft und wieviel Text noch bis zur nächsten Pause bzw. dem Ende des Stückes folgt.

Damit DMXControl erkennt, an welchen Stellen im Skript entsprechende Szenen stehen, werden Szenenreferenzen mit Verweisen auf die entsprecheden Szenen erstellt. Diese Verweise werden von DMXControl immer zu Begin einer neuen Zeile in den Skripttext eingefügt. Am besten lässt man je eine Zeile oberhalb und unterhalb der Referenz frei, damit das Skript so übersichtlich wie möglich bleibt.

{{BoxWichtig |Text = Die Zeichenfolge '''###''' darf im normalen Text des Skriptes nicht vorkommen, da DMXControl diese Zeichenkette als Markierung für die erstellten Referenzeinträge benutzt. Wird diese Zeichenkette verwendet, kann es zu schweren Fehlern kommen!}}

===Szenenreferenzen===
Szenenreferenzen werden von DMXControl hervorgehoben, damit diese besser lesbar sind. Sie haben stets folgendes Format:

### <Szenen-ID> - <Szenenname> ### <Regiekommentar>

Die Szenen-ID ist eine von DMXControl automatisch erzeugte vierstellige Referenznummer. Diese Nummer wird benötigt, damit DMXControl in der internen Datenbank die richtige Szene zu der Szenenreferenz findet. Der Szenenname entspricht dem in DMXControl vergebenen Szenennamen und kann bei der Erstellung der Szene individuell gewählt werden. Hier sollte darauf geachtet werden, treffende Namen zu verwenden, damit bei einer Suche die entsprechenden Szenen schnell wieder gefunden werden können. Zusätzliche Informationen, wie die Art der Lichtstimmung, können als Regiekommentar am Ende einer Szenenreferenz stehen. Eine Szenenreferenz kann z.B. wie folgt aussehen:

###0002 – Gewitter### Donner(Audio)

Es können alle von DMXControl unterstützten Szenenarten wie "Einfache Szene" oder "Audioszene" im Textbuch verwendet werden. Da die erstellten Szenenreferenzen auch nur Zeichenketten sind, können diese, genau wie der restliche Text des Skriptes, mit einem externen Editor bearbeitet werden. Daher führt DMXControl bei jedem Start eine Konsistenzprüfung durch, ob alle im Textbuch angegebenen Szenen in der internen Datenbank vorhanden sind. Wurde eine Szene in der Datenbank gefunden, dann wird im Regiebereich ein grüner Rhombus neben dem Namen der entsprechenden Szene angezeigt. Verweist ein Szeneneintrag auf keine existierende Szene, dann ist der Rhombus neben dem Namen rot gefärbt.

{{BoxAchtung |Text = Es sollte unbedingt darauf geachtet werden, dass die Szenenreferenzen beim Bearbeiten mit einem externen Texteditor nicht verändert werden, da hierdurch Szenenreferenzen verloren gehen können und es zu Inkonsistenzen kommen kann}}

==Bedienelemente==

===Steuerungsbereich===

[[Datei: DMXC2_Manual_Textbuch_SteuerungsbereichNormal.png | miniatur | 600px | zentriert | Bild 2: Der Steuerbereich]]
Im Steuerungsbereich befinden sich vier Buttons. Der größte von ihnen ist der '''GO-Button'''. Er startet die ausgewählte Szene und selektiert automatisch die nachfolgende Szene. So werden durch mehrmaliges Klicken auf den '''GO-Button''' der Reihe nach alle Szenen im Skript gestartet.

Links daneben befinden sich zwei Navigationsbuttons, '''Zurück''' und '''Vor'''. Mit ihnen kann man zwischen den Szenen navigieren, ohne sie auszuführen. So kann man einzelne Szenenreferenzen überspringen, falls mal ein Stichwort verpasst wurde und nun die nächste Szene ausgewählt werden soll.

Rechts neben dem GO-Button befindet sich der '''AutoScroll-Button'''. Mit diesem kann die AutoScroll-Funktion des Textbuches aktiviert bzw. deaktiviert werden. Bei der AutoScroll-Funktion wird eine rote Leselinie angezeigt und das Textbuch scrollt die Leselinie und das Skript immer bis zur nächsten Szenenreferenz. Die Scrollgeschwindigkeit wird aus der angegebenen Delta-Zeit zur nächsten Szene im Regiebereich abgeleitet, wodurch in der Regel eine manuelle Anpassung erforderlich ist.

[[Datei: DMXC2_Manual_Textbuch_SteuerungsbereichSuche.png | miniatur | 600px | zentriert | Bild 3: Der Steuerbereich im Such-Modus]]

Der Steuerbereich beinhaltet seit der Version 2.11 von DMXControl auch eine kleine Suchfunktion. Mit Hilfe der Tastenkombination '''Strg''' + '''F''' wird die Suchfunktion aktiviert. Sie durchsucht das Skript bei einem Klick auf '''Nächster Treffer''' ab der aktuellen Cursor-Position nach dem eingegebenen Suchtext. Wird der Suchtext im Skript gefunden, so springt das Textbuch an diese Position und markiert die entsprechende Textstelle. Der linke Button in der Suchansicht schließt die Suchfunktion und zeigt wieder die Steueransicht an.

===Regiebereich===

Der Regiebereich beinhaltet im oberen Teilbereich eine Textbuchverwaltung. Mit dem Dropdown-Menü lassen sich die unterschiedlichen Teilskripte auswählen und können mit dem Button '''Verwalten''' angelegt, kopiert, umbenannt oder gelöscht werden. Mit '''Öffnen''' kann zu jedem Teilskript die passende Textdatei geöffnet werden.

Im unteren Teil befindet sich eine Liste mit allen im Skript enthaltenen Szenen, welche nach ihrem Erscheinen im Skript sortiert sind. In dieser Liste werden verschiedene Parameter jeder einzelnen Szene angezeigt, die teilweise durch langsames, doppeltes Klicken (kein Doppelklick) bearbeitet werden können:

[[Datei: DMXC2_Manual_Textbuch_Szenenliste.png | miniatur | zentriert | 800px | Bild 4: Auschnitt aus der Szenenenliste des Textbuches]]

{| class="wikitable centered"
|- style="vertical-align:top;"
!
! Funktion
! Beschreibung
! Bearbeitbar
|- style="vertical-align:top;"
|style="width: 10px"| 1
|style="width: 100px"| Szene aktiv
|style="width: 500px"| Hier kann ausgewählt werden, ob die Szene im Ablauf berücksichtigt oder ausgelassen wird
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 2
|style="width: 100px"| grüner / roter Rhombus
|style="width: 500px"| Stimmen Szenenreferenz und Szene in der Datenbank überein, ist der Rhombus grün, andernfalls rot
|style="width: 100px"| Nein
|- style="vertical-align:top;"
|style="width: 10px"| 3
|style="width: 100px"| Name
|style="width: 500px"| Name des entsprechenden Szeneneintrags
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 4
|style="width: 100px"| Zeile
|style="width: 500px"| Hier wird die Zeilennummer der Szenenreferenz angezeigt
|style="width: 100px"| Nein
|- style="vertical-align:top;"
|style="width: 10px"| 5
|style="width: 100px"| Delta-T
|style="width: 500px"| Zeit zwischen der letzten und der aktuellen Szene. Der hier angegebene Wert hat Einfluss auf die Scrollgeschwindigkeit der AutoScroll-Funktion
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 6
|style="width: 100px"| Stichwort
|style="width: 500px"| Als kleine Hilfe kann hier eine Textstelle angegeben werden, an der die Szene gestartet werden soll
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 7
|style="width: 100px"| Kommentar
|style="width: 500px"| Hier kann eine Notiz mit zusätzlichen Informationen zur Szene angegeben werden, die am Ende der entsprechenden Szenenreferenz im Skript erscheint
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 8
|style="width: 100px"| Einblendzeit
|style="width: 500px"| Die Einblendzeit bestimmt, wie lange die Überblendung von der letzten Szene zur aktuellen Szene dauern soll
|style="width: 100px"| Ja
|}

 

Links von der Szenenliste sind die aus anderen Modulen bekannten Button zum Erstellen, Bearbeiten und Löschen einzelner Szeneneinträge. Näheres zu ihrer Bedienung finden Sie im Artikel Szenen-Modul.
Unterhalb der Szenenliste befindet sich der Szenenfortschrittsbalken. Dieser zeigt grafisch an, wie lange die aktuelle Szene im Verhältnis zu ihrer Einblenddauer schon eingeblendet wird.

{{BoxWichtig |Text = Werden mehrere Szenen gleichzeitig gestartet, die die gleichen Geräte beinhalten, so beginnt die DMX-Ausgabe zu springen und das Licht fängt an zu flackern. Außerdem können Szeneneinblendungen nicht abgebrochen werden. Daher muss darauf geachtet werden, dass die Einblendzeiten nicht zu groß gewählt werden!}}

==Modulbezogene Befehle==

* Modul: '''Textbuch'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 100px"| Gerät/Funktion
!style="width: 200px"| Beschreibung
!style="width: 100px"| Kanal
!style="width: 200px"| Beschreibung
|- style="vertical-align:top;"
|style="width: 100px"| Go-Button
|style="width: 200px"| Auf den Go-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px"| Zurück-Button
|style="width: 200px"| Auf den Zurück-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px"| Vor-Button
|style="width: 200px"| Auf den Vor-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px" rowspan="3"| Textbuch auswählen
|style="width: 200px" rowspan="3"| Der weitere Befehl wählt das entsprechende Textbuch aus.
|style="width: 100px"| Nächstes
|style="width: 200px"| Wählt das nächste Textbuch aus.
|- style="vertical-align:top;"
|style="width: 100px"| Vorheriges
|style="width: 200px"| Wählt das vorherige Textbuch aus.
|- style="vertical-align:top;"
|style="width: 100px"| Textbuch-Name
|style="width: 200px"| Wählt das Textbuch mit dem Namen aus der Dropdown-Liste.
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabefenster öffnet, in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt, um eine korrekte Funktion zu gewährleisten.
|}

== Links und Referenzen==
<references/>
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Timecode-Player_DMXC2
|zurückText = Timecode-Player
|vorLink = Kommandozeile_DMXC2
|vorText = Kommandozeile
}}

[[Kategorie: DMXControl 2]]

Textbuch DMXC2

2012-11-06T16:34:45Z

Wdunczewski: /* Regiebereich */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Timecode-Player_DMXC2
|zurückText = Timecode-Player
|vorLink = Kommandozeile_DMXC2
|vorText = Kommandozeile
}}

{{Hinweis
|Text = Jens-Peter (JPK) [3.08.2012, 1:15Uhr]: Artikel fertig gestellt und kann gegengelesen werden 
07.08.: Review Frank: OK, sehr gut 
11.09. Review Uwe: O.K. super Artikel 
05.10.2012: Uwe und Jens-Peter: Review OK
}}
{{Start-LaTeX}}
==Überblick==
Gerade bei Theater- und Musicalveranstaltungen ist es entscheidend, dass Lichtstimmungen und Effekte auf ein Stichwort genau zum Einsatz kommen. Dafür ist das Textbuch-Modul in DMXControl integriert. Mit diesem können Sie Licht- oder Bewegungsszenen, aber auch Soundeffekte (wie Donner, Hundegebell oder ähnliches) sowie Befehle zu gewissen Textstellen in einem Theater- oder Musicalstück starten. Dabei bleibt der Einsatzbereich des Textbuch-Moduls nicht auf Theater und Musical beschränkt, denn auch für andere Veranstaltungen mit festem Ablauf wie Chor- oder Karnevalsveranstaltungen ist dieses Modul geeignet.

{{Bild_mit_Unterschrift |DMXC2_Manual_Textbuch_Fenster.png|1|Das Textbuch-Modul|center}}

==Beschreibung==

Das Fenster des Textbuch-Moduls ist in drei Bereiche geteilt:

* der Textfeldbereich mit Texteditorfunktionen im oberen Teil des Moduls
* der Steuerungsbereich mit Buttons zur Steuerung der Aufführung im mittleren Teil des Moduls
* der Regiebereich mit einer Szenenübersicht und Szenenbearbeitungsfunktionen im unteren Teil des Moduls
 

===Textfeldbereich===

Der Textfeldbereich umfasst einen Texteditor, mit dem Sie im Textbuch (im folgenden als Skript bezeichnet) scrollen können, ohne den Szenenablauf zu beeinflussen. Außerdem können Sie mit dem Editor einfache Anpassungen, wie die Änderung der Farbe oder der Größe des Skripttextes vornehmen. Das genügt, um z.B. Stichworte zu unterstreichen oder eigene Regieeinträge aufgabenbezogen in unterschiedlichen Farben einzufärben. Der Editor des Moduls ist aber nicht darauf ausgelegt, das Skript z.B. in diesem Editor zu schreiben oder umfassende Anpassungen vorzunehmen. Dafür ist ein handelsüblicher Texteditor besser geeignet.
 

Um Skript-Dateien in DMXControl öffnen zu können, müssen diese im "'''Rich Text Format'''"<ref>Wikipedia: http://de.wikipedia.org/wiki/Rich_Text_Format</ref> (Dateiendung "'''.rtf'''") vorliegen. Damit der Text im Textfeld nicht zu umfangreich wird, sollte das Skript in mehrere Teile aufgeteilt werden, vorzugsweise zu jeder Pause eine Unterteilung. Die so entstandenen Teilskripte können in den Pausen entsprechend über ein, weiter unten im Artikel noch genauer erklärtes, Auswahlfeld separat geladen werden. Außerdem ist die Textstruktur des Skriptes im Textbuch-Modul nicht vorgegeben. Das heißt, Sie können das Skript individuell an ihre Anforderungen anpassen und müssen sich nicht auf eine DMXControl-spezifische Textstruktur einstellen.

Unter dem Textfeld befindet sich ein kleiner Fortschrittsbalken. Dieser zeigt den aktuellen Fortschitt im Skript, anhand dessen man ungefähr abschätzen kann, wie lange das aktuelle Stück schon läuft und wieviel Text noch bis zur nächsten Pause bzw. dem Ende des Stückes folgt.

Damit DMXControl erkennt, an welchen Stellen im Skript entsprechende Szenen stehen, werden Szenenreferenzen mit Verweisen auf die entsprecheden Szenen erstellt. Diese Verweise werden von DMXControl immer zu Begin einer neuen Zeile in den Skripttext eingefügt. Am besten lässt man je eine Zeile oberhalb und unterhalb der Referenz frei, damit das Skript so übersichtlich wie möglich bleibt.

{{BoxWichtig |Text = Die Zeichenfolge '''###''' darf im normalen Text des Skriptes nicht vorkommen, da DMXControl diese Zeichenkette als Markierung für die erstellten Referenzeinträge benutzt. Wird diese Zeichenkette verwendet, kann es zu schweren Fehlern kommen!}}

===Szenenreferenzen===
Szenenreferenzen werden von DMXControl hervorgehoben, damit diese besser lesbar sind. Sie haben stets folgendes Format:

### <Szenen-ID> - <Szenenname> ### <Regiekommentar>

Die Szenen-ID ist eine von DMXControl automatisch erzeugte vierstellige Referenznummer. Diese Nummer wird benötigt, damit DMXControl in der internen Datenbank die richtige Szene zu der Szenenreferenz findet. Der Szenenname entspricht dem in DMXControl vergebenen Szenennamen und kann bei der Erstellung der Szene individuell gewählt werden. Hier sollte darauf geachtet werden, treffende Namen zu verwenden, damit bei einer Suche die entsprechenden Szenen schnell wieder gefunden werden können. Zusätzliche Informationen, wie die Art der Lichtstimmung, können als Regiekommentar am Ende einer Szenenreferenz stehen. Eine Szenenreferenz kann z.B. wie folgt aussehen:

###0002 – Gewitter### Donner(Audio)

Es können alle von DMXControl unterstützten Szenenarten wie "Einfache Szene" oder "Audioszene" im Textbuch verwendet werden. Da die erstellten Szenenreferenzen auch nur Zeichenketten sind, können diese, genau wie der restliche Text des Skriptes, mit einem externen Editor bearbeitet werden. Daher führt DMXControl bei jedem Start eine Konsistenzprüfung durch, ob alle im Textbuch angegebenen Szenen in der internen Datenbank vorhanden sind. Wurde eine Szene in der Datenbank gefunden, dann wird im Regiebereich ein grüner Rhombus neben dem Namen der entsprechenden Szene angezeigt. Verweist ein Szeneneintrag auf keine existierende Szene, dann ist der Rhombus neben dem Namen rot gefärbt.

{{BoxAchtung |Text = Es sollte unbedingt darauf geachtet werden, dass die Szenenreferenzen beim Bearbeiten mit einem externen Texteditor nicht verändert werden, da hierdurch Szenenreferenzen verloren gehen können und es zu Inkonsistenzen kommen kann}}

==Bedienelemente==

===Steuerungsbereich===

[[Datei: DMXC2_Manual_Textbuch_SteuerungsbereichNormal.png | miniatur | 600px | zentriert | Bild 2: Der Steuerbereich]]
Im Steuerungsbereich befinden sich vier Buttons. Der größte von ihnen ist der '''GO-Button'''. Er startet die ausgewählte Szene und selektiert automatisch die nachfolgende Szene. So werden durch mehrmaliges Klicken auf den '''GO-Button''' der Reihe nach alle Szenen im Skript gestartet.

Links daneben befinden sich zwei Navigationsbuttons, '''Zurück''' und '''Vor'''. Mit ihnen kann man zwischen den Szenen navigieren, ohne sie auszuführen. So kann man einzelne Szenenreferenzen überspringen, falls mal ein Stichwort verpasst wurde und nun die nächste Szene ausgewählt werden soll.

Rechts neben dem GO-Button befindet sich der '''AutoScroll-Button'''. Mit diesem kann die AutoScroll-Funktion des Textbuches aktiviert bzw. deaktiviert werden. Bei der AutoScroll-Funktion wird eine rote Leselinie angezeigt und das Textbuch scrollt die Leselinie und das Skript immer bis zur nächsten Szenenreferenz. Die Scrollgeschwindigkeit wird aus der angegebenen Delta-Zeit zur nächsten Szene im Regiebereich abgeleitet, wodurch in der Regel eine manuelle Anpassung erforderlich ist.

[[Datei: DMXC2_Manual_Textbuch_SteuerungsbereichSuche.png | miniatur | 600px | zentriert | Bild 3: Der Steuerbereich im Such-Modus]]

Der Steuerbereich beinhaltet seit der Version 2.11 von DMXControl auch eine kleine Suchfunktion. Mit Hilfe der Tastenkombination '''Strg''' + '''F''' wird die Suchfunktion aktiviert. Sie durchsucht das Skript bei einem Klick auf '''Nächster Treffer''' ab der aktuellen Cursor-Position nach dem eingegebenen Suchtext. Wird der Suchtext im Skript gefunden, so springt das Textbuch an diese Position und markiert die entsprechende Textstelle. Der linke Button in der Suchansicht schließt die Suchfunktion und zeigt wieder die Steueransicht an.

===Regiebereich===

Der Regiebereich beinhaltet im oberen Teilbereich eine Textbuchverwaltung. Mit dem Dropdown-Menü lassen sich die unterschiedlichen Teilskripte auswählen und können mit dem Button '''Verwalten''' angelegt, kopiert, umbenannt oder gelöscht werden. Mit '''Öffnen''' kann zu jedem Teilskript die passende Textdatei geöffnet werden.

Im unteren Teil befindet sich eine Liste mit allen im Skript enthaltenen Szenen, welche nach ihrem Erscheinen im Skript sortiert sind. In dieser Liste werden verschiedene Parameter jeder einzelnen Szene angezeigt, die teilweise durch langsames, doppeltes Klicken (kein Doppelklick) bearbeitet werden können:

[[Datei: DMXC2_Manual_Textbuch_Szenenliste.png | miniatur | zentriert | 800px | Bild 4: Auschnitt aus der Szenenenliste des Textbuches]]

{| class="wikitable centered"
|- style="vertical-align:top;"
!
! Funktion
! Beschreibung
! Bearbeitbar
|- style="vertical-align:top;"
|style="width: 10px"| 1
|style="width: 100px"| Szene aktiv
|style="width: 500px"| Hier kann ausgewählt werden, ob die Szene im Ablauf berücksichtigt oder ausgelassen wird
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 2
|style="width: 100px"| grüner / roter Rhombus
|style="width: 500px"| Stimmen Szenenreferenz und Szene in der Datenbank überein, ist der Rhombus grün, andernfalls rot
|style="width: 100px"| Nein
|- style="vertical-align:top;"
|style="width: 10px"| 3
|style="width: 100px"| Name
|style="width: 500px"| Name des entsprechenden Szeneneintrags
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 4
|style="width: 100px"| Zeile
|style="width: 500px"| Hier wird die Zeilennummer der Szenenreferenz angezeigt
|style="width: 100px"| Nein
|- style="vertical-align:top;"
|style="width: 10px"| 5
|style="width: 100px"| Delta-T
|style="width: 500px"| Zeit zwischen der letzten und der aktuellen Szene. Der hier angegebene Wert hat Einfluss auf die Scrollgeschwindigkeit der AutoScroll-Funktion
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 6
|style="width: 100px"| Stichwort
|style="width: 500px"| Als kleine Hilfe kann hier eine Textstelle angegeben werden, an der die Szene gestartet werden soll
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 7
|style="width: 100px"| Kommentar
|style="width: 500px"| Hier kann eine Notiz mit zusätzlichen Informationen zur Szene angegeben werden, die am Ende der entsprechenden Szenenreferenz im Skript erscheint
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 8
|style="width: 100px"| Einblendzeit
|style="width: 500px"| Die Einblendzeit bestimmt, wie lange die Überblendung von der letzten Szene zur aktuellen Szene dauern soll
|style="width: 100px"| Ja
|}

 

Links von der Szenenliste sind die aus anderen Modulen bekannten Button zum Erstellen, Bearbeiten und Löschen einzelner Szeneneinträge. Näheres zu ihrer Bedienung finden Sie im Artikel Szenen-Modul.
Unterhalb der Szenenliste befindet sich der Szenenfortschrittsbalken. Dieser zeigt grafisch an, wie lange die aktuelle Szene im Verhältnis zu ihrer Einblenddauer schon eingeblendet wird.

{{BoxWichtig |Text = Werden mehrere Szenen gleichzeitig gestartet, die die gleichen Geräte beinhalten, so beginnt die DMX-Ausgabe zu springen und das Licht fängt an zu flackern. Außerdem können Szeneneinblendungen nicht abgebrochen werden. Daher muss darauf geachtet werden, dass die Einblendzeiten nicht zu groß gewählt werden!}}

==Modulbezogene Befehle==

* Modul: '''Textbuch'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 100px"| Gerät/Funktion
!style="width: 200px"| Beschreibung
!style="width: 100px"| Kanal
!style="width: 200px"| Beschreibung
|- style="vertical-align:top;"
|style="width: 100px"| Go-Button
|style="width: 200px"| Auf den Go-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px"| Zurück-Button
|style="width: 200px"| Auf den Zurück-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px"| Vor-Button
|style="width: 200px"| Auf den Vor-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px" rowspan="3"| Textbuch auswählen
|style="width: 200px" rowspan="3"| Der weitere Befehl wählt das entsprechende Textbuch aus.
|style="width: 100px"| Nächstes
|style="width: 200px"| Wählt das nächste Textbuch aus.
|- style="vertical-align:top;"
|style="width: 100px"| Vorheriges
|style="width: 200px"| Wählt das vorherige Textbuch aus.
|- style="vertical-align:top;"
|style="width: 100px"| Textbuch-Name
|style="width: 200px"| Wählt das Textbuch mit dem Namen aus der Dropdown-Liste.
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabe Fenster öffnet in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt um eine korrekte Funktion zu gewährleisten.
|}

== Links und Referenzen==
<references/>
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Timecode-Player_DMXC2
|zurückText = Timecode-Player
|vorLink = Kommandozeile_DMXC2
|vorText = Kommandozeile
}}

[[Kategorie: DMXControl 2]]

Textbuch DMXC2

2012-11-06T16:31:14Z

Wdunczewski: /* Regiebereich */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Timecode-Player_DMXC2
|zurückText = Timecode-Player
|vorLink = Kommandozeile_DMXC2
|vorText = Kommandozeile
}}

{{Hinweis
|Text = Jens-Peter (JPK) [3.08.2012, 1:15Uhr]: Artikel fertig gestellt und kann gegengelesen werden 
07.08.: Review Frank: OK, sehr gut 
11.09. Review Uwe: O.K. super Artikel 
05.10.2012: Uwe und Jens-Peter: Review OK
}}
{{Start-LaTeX}}
==Überblick==
Gerade bei Theater- und Musicalveranstaltungen ist es entscheidend, dass Lichtstimmungen und Effekte auf ein Stichwort genau zum Einsatz kommen. Dafür ist das Textbuch-Modul in DMXControl integriert. Mit diesem können Sie Licht- oder Bewegungsszenen, aber auch Soundeffekte (wie Donner, Hundegebell oder ähnliches) sowie Befehle zu gewissen Textstellen in einem Theater- oder Musicalstück starten. Dabei bleibt der Einsatzbereich des Textbuch-Moduls nicht auf Theater und Musical beschränkt, denn auch für andere Veranstaltungen mit festem Ablauf wie Chor- oder Karnevalsveranstaltungen ist dieses Modul geeignet.

{{Bild_mit_Unterschrift |DMXC2_Manual_Textbuch_Fenster.png|1|Das Textbuch-Modul|center}}

==Beschreibung==

Das Fenster des Textbuch-Moduls ist in drei Bereiche geteilt:

* der Textfeldbereich mit Texteditorfunktionen im oberen Teil des Moduls
* der Steuerungsbereich mit Buttons zur Steuerung der Aufführung im mittleren Teil des Moduls
* der Regiebereich mit einer Szenenübersicht und Szenenbearbeitungsfunktionen im unteren Teil des Moduls
 

===Textfeldbereich===

Der Textfeldbereich umfasst einen Texteditor, mit dem Sie im Textbuch (im folgenden als Skript bezeichnet) scrollen können, ohne den Szenenablauf zu beeinflussen. Außerdem können Sie mit dem Editor einfache Anpassungen, wie die Änderung der Farbe oder der Größe des Skripttextes vornehmen. Das genügt, um z.B. Stichworte zu unterstreichen oder eigene Regieeinträge aufgabenbezogen in unterschiedlichen Farben einzufärben. Der Editor des Moduls ist aber nicht darauf ausgelegt, das Skript z.B. in diesem Editor zu schreiben oder umfassende Anpassungen vorzunehmen. Dafür ist ein handelsüblicher Texteditor besser geeignet.
 

Um Skript-Dateien in DMXControl öffnen zu können, müssen diese im "'''Rich Text Format'''"<ref>Wikipedia: http://de.wikipedia.org/wiki/Rich_Text_Format</ref> (Dateiendung "'''.rtf'''") vorliegen. Damit der Text im Textfeld nicht zu umfangreich wird, sollte das Skript in mehrere Teile aufgeteilt werden, vorzugsweise zu jeder Pause eine Unterteilung. Die so entstandenen Teilskripte können in den Pausen entsprechend über ein, weiter unten im Artikel noch genauer erklärtes, Auswahlfeld separat geladen werden. Außerdem ist die Textstruktur des Skriptes im Textbuch-Modul nicht vorgegeben. Das heißt, Sie können das Skript individuell an ihre Anforderungen anpassen und müssen sich nicht auf eine DMXControl-spezifische Textstruktur einstellen.

Unter dem Textfeld befindet sich ein kleiner Fortschrittsbalken. Dieser zeigt den aktuellen Fortschitt im Skript, anhand dessen man ungefähr abschätzen kann, wie lange das aktuelle Stück schon läuft und wieviel Text noch bis zur nächsten Pause bzw. dem Ende des Stückes folgt.

Damit DMXControl erkennt, an welchen Stellen im Skript entsprechende Szenen stehen, werden Szenenreferenzen mit Verweisen auf die entsprecheden Szenen erstellt. Diese Verweise werden von DMXControl immer zu Begin einer neuen Zeile in den Skripttext eingefügt. Am besten lässt man je eine Zeile oberhalb und unterhalb der Referenz frei, damit das Skript so übersichtlich wie möglich bleibt.

{{BoxWichtig |Text = Die Zeichenfolge '''###''' darf im normalen Text des Skriptes nicht vorkommen, da DMXControl diese Zeichenkette als Markierung für die erstellten Referenzeinträge benutzt. Wird diese Zeichenkette verwendet, kann es zu schweren Fehlern kommen!}}

===Szenenreferenzen===
Szenenreferenzen werden von DMXControl hervorgehoben, damit diese besser lesbar sind. Sie haben stets folgendes Format:

### <Szenen-ID> - <Szenenname> ### <Regiekommentar>

Die Szenen-ID ist eine von DMXControl automatisch erzeugte vierstellige Referenznummer. Diese Nummer wird benötigt, damit DMXControl in der internen Datenbank die richtige Szene zu der Szenenreferenz findet. Der Szenenname entspricht dem in DMXControl vergebenen Szenennamen und kann bei der Erstellung der Szene individuell gewählt werden. Hier sollte darauf geachtet werden, treffende Namen zu verwenden, damit bei einer Suche die entsprechenden Szenen schnell wieder gefunden werden können. Zusätzliche Informationen, wie die Art der Lichtstimmung, können als Regiekommentar am Ende einer Szenenreferenz stehen. Eine Szenenreferenz kann z.B. wie folgt aussehen:

###0002 – Gewitter### Donner(Audio)

Es können alle von DMXControl unterstützten Szenenarten wie "Einfache Szene" oder "Audioszene" im Textbuch verwendet werden. Da die erstellten Szenenreferenzen auch nur Zeichenketten sind, können diese, genau wie der restliche Text des Skriptes, mit einem externen Editor bearbeitet werden. Daher führt DMXControl bei jedem Start eine Konsistenzprüfung durch, ob alle im Textbuch angegebenen Szenen in der internen Datenbank vorhanden sind. Wurde eine Szene in der Datenbank gefunden, dann wird im Regiebereich ein grüner Rhombus neben dem Namen der entsprechenden Szene angezeigt. Verweist ein Szeneneintrag auf keine existierende Szene, dann ist der Rhombus neben dem Namen rot gefärbt.

{{BoxAchtung |Text = Es sollte unbedingt darauf geachtet werden, dass die Szenenreferenzen beim Bearbeiten mit einem externen Texteditor nicht verändert werden, da hierdurch Szenenreferenzen verloren gehen können und es zu Inkonsistenzen kommen kann}}

==Bedienelemente==

===Steuerungsbereich===

[[Datei: DMXC2_Manual_Textbuch_SteuerungsbereichNormal.png | miniatur | 600px | zentriert | Bild 2: Der Steuerbereich]]
Im Steuerungsbereich befinden sich vier Buttons. Der größte von ihnen ist der '''GO-Button'''. Er startet die ausgewählte Szene und selektiert automatisch die nachfolgende Szene. So werden durch mehrmaliges Klicken auf den '''GO-Button''' der Reihe nach alle Szenen im Skript gestartet.

Links daneben befinden sich zwei Navigationsbuttons, '''Zurück''' und '''Vor'''. Mit ihnen kann man zwischen den Szenen navigieren, ohne sie auszuführen. So kann man einzelne Szenenreferenzen überspringen, falls mal ein Stichwort verpasst wurde und nun die nächste Szene ausgewählt werden soll.

Rechts neben dem GO-Button befindet sich der '''AutoScroll-Button'''. Mit diesem kann die AutoScroll-Funktion des Textbuches aktiviert bzw. deaktiviert werden. Bei der AutoScroll-Funktion wird eine rote Leselinie angezeigt und das Textbuch scrollt die Leselinie und das Skript immer bis zur nächsten Szenenreferenz. Die Scrollgeschwindigkeit wird aus der angegebenen Delta-Zeit zur nächsten Szene im Regiebereich abgeleitet, wodurch in der Regel eine manuelle Anpassung erforderlich ist.

[[Datei: DMXC2_Manual_Textbuch_SteuerungsbereichSuche.png | miniatur | 600px | zentriert | Bild 3: Der Steuerbereich im Such-Modus]]

Der Steuerbereich beinhaltet seit der Version 2.11 von DMXControl auch eine kleine Suchfunktion. Mit Hilfe der Tastenkombination '''Strg''' + '''F''' wird die Suchfunktion aktiviert. Sie durchsucht das Skript bei einem Klick auf '''Nächster Treffer''' ab der aktuellen Cursor-Position nach dem eingegebenen Suchtext. Wird der Suchtext im Skript gefunden, so springt das Textbuch an diese Position und markiert die entsprechende Textstelle. Der linke Button in der Suchansicht schließt die Suchfunktion und zeigt wieder die Steueransicht an.

===Regiebereich===

Der Regiebereich beinhaltet im oberen Teilbereich eine Textbuchverwaltung. Mit dem Dropdown-Menü lassen sich die unterschiedlichen Teilskripte auswählen und können mit dem Button '''Verwalten''' angelegt, kopiert, umbenannt oder gelöscht werden. Mit '''Öffnen''' kann zu jedem Teilskript die passende Textdatei geöffnet werden.

Im unteren Teil befindet sich eine Liste mit allen im Skript enthaltenen Szenen, welche nach ihrem Erscheinen im Skript sortiert sind. In dieser Liste werden verschiedene Parameter jeder einzelnen Szene angezeigt, die teilweise durch langsames, doppeltes Klicken (kein Doppelklick) bearbeitet werden können:

[[Datei: DMXC2_Manual_Textbuch_Szenenliste.png | miniatur | zentriert | 800px | Bild 4: Auschnitt aus der Szenenenliste des Textbuches]]

{| class="wikitable centered"
|- style="vertical-align:top;"
!
! Funktion
! Beschreibung
! Bearbeitbar
|- style="vertical-align:top;"
|style="width: 10px"| 1
|style="width: 100px"| Szene aktiv
|style="width: 500px"| Hier kann ausgewählt werden, ob die Szene im Ablauf berücksichtigt oder ausgelassen wird
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 2
|style="width: 100px"| grüner / roter Rhombus
|style="width: 500px"| Stimmen Szenenreferenz und Szene in der Datenbank überein, ist der Rhombus grün, andernfalls rot
|style="width: 100px"| Nein
|- style="vertical-align:top;"
|style="width: 10px"| 3
|style="width: 100px"| Name
|style="width: 500px"| Name des entsprechenden Szeneneintrags
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 4
|style="width: 100px"| Zeile
|style="width: 500px"| Hier wird die Zeilennummer der Szenenreferenz angezeigt
|style="width: 100px"| Nein
|- style="vertical-align:top;"
|style="width: 10px"| 5
|style="width: 100px"| Delta-T
|style="width: 500px"| Zeit zwischen der letzten und der aktuellen Szene. Der hier angegebene Wert hat Einfluss auf die Scrollgeschwindigkeit der AutoScroll-Funktion
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 6
|style="width: 100px"| Stichwort
|style="width: 500px"| Als kleine Hilfe kann hier eine Textstelle angegeben werden, an der die Szene gestartet werden soll
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 7
|style="width: 100px"| Kommentar
|style="width: 500px"| Hier kann eine Notiz mit zusätzlichen Informationen zur Szene angegeben werden, die am Ende der entsprechenden Szenenreferenz im Skript erscheint
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 8
|style="width: 100px"| Einblendzeit
|style="width: 500px"| Die Einblendzeit bestimmt, wielange die Überblendung von der letzten Szene zur aktuellen Szene dauern soll
|style="width: 100px"| Ja
|}

 

Links von der Szenenliste sind die aus anderen Modulen bekannten Button zum Erstellen, Bearbeiiten und Löschen einzelner Szeneneinträge. Näheres zu ihrer Bedienung finden sie im Artikel Szenen-Modul.
Unterhalb der Szenenliste befindet sich der Szenenfortschrittsbalken. Dieser zeigt grafisch an, wie lange die aktuelle Szene im Verhältnis zu ihrer Einblenddauer schon eingeblendet wird.

{{BoxWichtig |Text = Werden mehrere Szenen gleichzeitig gestartet, die die gleichen Geräte beinhalten, so beginnt die DMX-Ausgabe zu springen und das Licht fängt an zu flackern. Außerdem können Szeneneinblendungen nicht abgebrochen werden. Daher muss darauf geachtet werden, dass die Einblendzeiten nicht zu groß gewählt werden!}}

==Modulbezogene Befehle==

* Modul: '''Textbuch'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 100px"| Gerät/Funktion
!style="width: 200px"| Beschreibung
!style="width: 100px"| Kanal
!style="width: 200px"| Beschreibung
|- style="vertical-align:top;"
|style="width: 100px"| Go-Button
|style="width: 200px"| Auf den Go-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px"| Zurück-Button
|style="width: 200px"| Auf den Zurück-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px"| Vor-Button
|style="width: 200px"| Auf den Vor-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px" rowspan="3"| Textbuch auswählen
|style="width: 200px" rowspan="3"| Der weitere Befehl wählt das entsprechende Textbuch aus.
|style="width: 100px"| Nächstes
|style="width: 200px"| Wählt das nächste Textbuch aus.
|- style="vertical-align:top;"
|style="width: 100px"| Vorheriges
|style="width: 200px"| Wählt das vorherige Textbuch aus.
|- style="vertical-align:top;"
|style="width: 100px"| Textbuch-Name
|style="width: 200px"| Wählt das Textbuch mit dem Namen aus der Dropdown-Liste.
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabe Fenster öffnet in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt um eine korrekte Funktion zu gewährleisten.
|}

== Links und Referenzen==
<references/>
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Timecode-Player_DMXC2
|zurückText = Timecode-Player
|vorLink = Kommandozeile_DMXC2
|vorText = Kommandozeile
}}

[[Kategorie: DMXControl 2]]

Textbuch DMXC2

2012-11-06T16:29:17Z

Wdunczewski: /* Steuerungsbereich */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Timecode-Player_DMXC2
|zurückText = Timecode-Player
|vorLink = Kommandozeile_DMXC2
|vorText = Kommandozeile
}}

{{Hinweis
|Text = Jens-Peter (JPK) [3.08.2012, 1:15Uhr]: Artikel fertig gestellt und kann gegengelesen werden 
07.08.: Review Frank: OK, sehr gut 
11.09. Review Uwe: O.K. super Artikel 
05.10.2012: Uwe und Jens-Peter: Review OK
}}
{{Start-LaTeX}}
==Überblick==
Gerade bei Theater- und Musicalveranstaltungen ist es entscheidend, dass Lichtstimmungen und Effekte auf ein Stichwort genau zum Einsatz kommen. Dafür ist das Textbuch-Modul in DMXControl integriert. Mit diesem können Sie Licht- oder Bewegungsszenen, aber auch Soundeffekte (wie Donner, Hundegebell oder ähnliches) sowie Befehle zu gewissen Textstellen in einem Theater- oder Musicalstück starten. Dabei bleibt der Einsatzbereich des Textbuch-Moduls nicht auf Theater und Musical beschränkt, denn auch für andere Veranstaltungen mit festem Ablauf wie Chor- oder Karnevalsveranstaltungen ist dieses Modul geeignet.

{{Bild_mit_Unterschrift |DMXC2_Manual_Textbuch_Fenster.png|1|Das Textbuch-Modul|center}}

==Beschreibung==

Das Fenster des Textbuch-Moduls ist in drei Bereiche geteilt:

* der Textfeldbereich mit Texteditorfunktionen im oberen Teil des Moduls
* der Steuerungsbereich mit Buttons zur Steuerung der Aufführung im mittleren Teil des Moduls
* der Regiebereich mit einer Szenenübersicht und Szenenbearbeitungsfunktionen im unteren Teil des Moduls
 

===Textfeldbereich===

Der Textfeldbereich umfasst einen Texteditor, mit dem Sie im Textbuch (im folgenden als Skript bezeichnet) scrollen können, ohne den Szenenablauf zu beeinflussen. Außerdem können Sie mit dem Editor einfache Anpassungen, wie die Änderung der Farbe oder der Größe des Skripttextes vornehmen. Das genügt, um z.B. Stichworte zu unterstreichen oder eigene Regieeinträge aufgabenbezogen in unterschiedlichen Farben einzufärben. Der Editor des Moduls ist aber nicht darauf ausgelegt, das Skript z.B. in diesem Editor zu schreiben oder umfassende Anpassungen vorzunehmen. Dafür ist ein handelsüblicher Texteditor besser geeignet.
 

Um Skript-Dateien in DMXControl öffnen zu können, müssen diese im "'''Rich Text Format'''"<ref>Wikipedia: http://de.wikipedia.org/wiki/Rich_Text_Format</ref> (Dateiendung "'''.rtf'''") vorliegen. Damit der Text im Textfeld nicht zu umfangreich wird, sollte das Skript in mehrere Teile aufgeteilt werden, vorzugsweise zu jeder Pause eine Unterteilung. Die so entstandenen Teilskripte können in den Pausen entsprechend über ein, weiter unten im Artikel noch genauer erklärtes, Auswahlfeld separat geladen werden. Außerdem ist die Textstruktur des Skriptes im Textbuch-Modul nicht vorgegeben. Das heißt, Sie können das Skript individuell an ihre Anforderungen anpassen und müssen sich nicht auf eine DMXControl-spezifische Textstruktur einstellen.

Unter dem Textfeld befindet sich ein kleiner Fortschrittsbalken. Dieser zeigt den aktuellen Fortschitt im Skript, anhand dessen man ungefähr abschätzen kann, wie lange das aktuelle Stück schon läuft und wieviel Text noch bis zur nächsten Pause bzw. dem Ende des Stückes folgt.

Damit DMXControl erkennt, an welchen Stellen im Skript entsprechende Szenen stehen, werden Szenenreferenzen mit Verweisen auf die entsprecheden Szenen erstellt. Diese Verweise werden von DMXControl immer zu Begin einer neuen Zeile in den Skripttext eingefügt. Am besten lässt man je eine Zeile oberhalb und unterhalb der Referenz frei, damit das Skript so übersichtlich wie möglich bleibt.

{{BoxWichtig |Text = Die Zeichenfolge '''###''' darf im normalen Text des Skriptes nicht vorkommen, da DMXControl diese Zeichenkette als Markierung für die erstellten Referenzeinträge benutzt. Wird diese Zeichenkette verwendet, kann es zu schweren Fehlern kommen!}}

===Szenenreferenzen===
Szenenreferenzen werden von DMXControl hervorgehoben, damit diese besser lesbar sind. Sie haben stets folgendes Format:

### <Szenen-ID> - <Szenenname> ### <Regiekommentar>

Die Szenen-ID ist eine von DMXControl automatisch erzeugte vierstellige Referenznummer. Diese Nummer wird benötigt, damit DMXControl in der internen Datenbank die richtige Szene zu der Szenenreferenz findet. Der Szenenname entspricht dem in DMXControl vergebenen Szenennamen und kann bei der Erstellung der Szene individuell gewählt werden. Hier sollte darauf geachtet werden, treffende Namen zu verwenden, damit bei einer Suche die entsprechenden Szenen schnell wieder gefunden werden können. Zusätzliche Informationen, wie die Art der Lichtstimmung, können als Regiekommentar am Ende einer Szenenreferenz stehen. Eine Szenenreferenz kann z.B. wie folgt aussehen:

###0002 – Gewitter### Donner(Audio)

Es können alle von DMXControl unterstützten Szenenarten wie "Einfache Szene" oder "Audioszene" im Textbuch verwendet werden. Da die erstellten Szenenreferenzen auch nur Zeichenketten sind, können diese, genau wie der restliche Text des Skriptes, mit einem externen Editor bearbeitet werden. Daher führt DMXControl bei jedem Start eine Konsistenzprüfung durch, ob alle im Textbuch angegebenen Szenen in der internen Datenbank vorhanden sind. Wurde eine Szene in der Datenbank gefunden, dann wird im Regiebereich ein grüner Rhombus neben dem Namen der entsprechenden Szene angezeigt. Verweist ein Szeneneintrag auf keine existierende Szene, dann ist der Rhombus neben dem Namen rot gefärbt.

{{BoxAchtung |Text = Es sollte unbedingt darauf geachtet werden, dass die Szenenreferenzen beim Bearbeiten mit einem externen Texteditor nicht verändert werden, da hierdurch Szenenreferenzen verloren gehen können und es zu Inkonsistenzen kommen kann}}

==Bedienelemente==

===Steuerungsbereich===

[[Datei: DMXC2_Manual_Textbuch_SteuerungsbereichNormal.png | miniatur | 600px | zentriert | Bild 2: Der Steuerbereich]]
Im Steuerungsbereich befinden sich vier Buttons. Der größte von ihnen ist der '''GO-Button'''. Er startet die ausgewählte Szene und selektiert automatisch die nachfolgende Szene. So werden durch mehrmaliges Klicken auf den '''GO-Button''' der Reihe nach alle Szenen im Skript gestartet.

Links daneben befinden sich zwei Navigationsbuttons, '''Zurück''' und '''Vor'''. Mit ihnen kann man zwischen den Szenen navigieren, ohne sie auszuführen. So kann man einzelne Szenenreferenzen überspringen, falls mal ein Stichwort verpasst wurde und nun die nächste Szene ausgewählt werden soll.

Rechts neben dem GO-Button befindet sich der '''AutoScroll-Button'''. Mit diesem kann die AutoScroll-Funktion des Textbuches aktiviert bzw. deaktiviert werden. Bei der AutoScroll-Funktion wird eine rote Leselinie angezeigt und das Textbuch scrollt die Leselinie und das Skript immer bis zur nächsten Szenenreferenz. Die Scrollgeschwindigkeit wird aus der angegebenen Delta-Zeit zur nächsten Szene im Regiebereich abgeleitet, wodurch in der Regel eine manuelle Anpassung erforderlich ist.

[[Datei: DMXC2_Manual_Textbuch_SteuerungsbereichSuche.png | miniatur | 600px | zentriert | Bild 3: Der Steuerbereich im Such-Modus]]

Der Steuerbereich beinhaltet seit der Version 2.11 von DMXControl auch eine kleine Suchfunktion. Mit Hilfe der Tastenkombination '''Strg''' + '''F''' wird die Suchfunktion aktiviert. Sie durchsucht das Skript bei einem Klick auf '''Nächster Treffer''' ab der aktuellen Cursor-Position nach dem eingegebenen Suchtext. Wird der Suchtext im Skript gefunden, so springt das Textbuch an diese Position und markiert die entsprechende Textstelle. Der linke Button in der Suchansicht schließt die Suchfunktion und zeigt wieder die Steueransicht an.

===Regiebereich===

Der Regiebereich beinhaltet im oberen Teilbereich eine Textbuchverwaltung. Mit dem Dropdown-Menü lassen sich die unterschiedlichen Teilskripte auswählen und können mit dem Button '''Verwalten''' angelegt, kopiert, umbenannt oder gelöscht werden. Mit '''Öffnen''' kann zu jedem Teilskript die passende Textdatei geöffnet werden.

Im unteren Teil befindet sich eine Liste mit allen im Skript enthaltenen Szenen, welche nach ihrem Erscheinen im Skript sortiert sind. In dieser Liste werden verschiedene Parameter jeder einzelnen Szene angezeigt, die teilweise durch langsames doppeltes Klicken (kein Doppelklick) bearbeitet werden können:

[[Datei: DMXC2_Manual_Textbuch_Szenenliste.png | miniatur | zentriert | 800px | Bild 4: Auschnitt aus der Szenenenliste des Textbuches]]

{| class="wikitable centered"
|- style="vertical-align:top;"
!
! Funktion
! Beschreibung
! Bearbeitbar
|- style="vertical-align:top;"
|style="width: 10px"| 1
|style="width: 100px"| Szene aktiv
|style="width: 500px"| Hier kann ausgewählt werden, ob die Szene im Ablauf berücksichtigt oder ausgelassen wird
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 2
|style="width: 100px"| grüner / roter Rhombus
|style="width: 500px"| Stimmen Szenenreferenz und Szene in der Datenbank überein, ist der Rhombus grün, andernfalls rot
|style="width: 100px"| Nein
|- style="vertical-align:top;"
|style="width: 10px"| 3
|style="width: 100px"| Name
|style="width: 500px"| Name des entsprechenden Szeneneintrags
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 4
|style="width: 100px"| Zeile
|style="width: 500px"| Hier wird die Zeilennummer der Szenenreferenz angezeigt
|style="width: 100px"| Nein
|- style="vertical-align:top;"
|style="width: 10px"| 5
|style="width: 100px"| Delta-T
|style="width: 500px"| Zeit zwischen der letzten und der aktuellen Szene. Der hier angegebene Wert hat Einfluss auf die Scrollgeschwindigkeit der AutoScroll-Funktion
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 6
|style="width: 100px"| Stichwort
|style="width: 500px"| Als kleine Hilfe kann hier eine Textstelle angegeben werden, an der die Szene gestartet werden soll
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 7
|style="width: 100px"| Kommentar
|style="width: 500px"| Hier kann eine Notiz mit zusätzlichen Informationen zur Szene angegeben werden, die am Ende der entsprechenden Szenenreferenz im Skript erscheint
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 8
|style="width: 100px"| Einblendzeit
|style="width: 500px"| Die Einblendzeit bestimmt, wielange die Überblendung von der letzten Szene zur aktuellen Szene dauern soll
|style="width: 100px"| Ja
|}

 

Links von der Szenenliste sind die aus anderen Modulen bekannten Button zum Erstellen, Bearbeiiten und Löschen einzelner Szeneneinträge. Näheres zu ihrer Bedienung finden sie im Artikel Szenen-Modul.
Unterhalb der Szenenliste befindet sich der Szenenfortschrittsbalken. Dieser zeigt grafisch an, wie lange die aktuelle Szene im Verhältnis zu ihrer Einblenddauer schon eingeblendet wird.

{{BoxWichtig |Text = Werden mehrere Szenen gleichzeitig gestartet, die die gleichen Geräte beinhalten, so beginnt die DMX-Ausgabe zu springen und das Licht fängt an zu flackern. Außerdem können Szeneneinblendungen nicht abgebrochen werden. Daher muss darauf geachtet werden, dass die Einblendzeiten nicht zu groß gewählt werden!}}

==Modulbezogene Befehle==

* Modul: '''Textbuch'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 100px"| Gerät/Funktion
!style="width: 200px"| Beschreibung
!style="width: 100px"| Kanal
!style="width: 200px"| Beschreibung
|- style="vertical-align:top;"
|style="width: 100px"| Go-Button
|style="width: 200px"| Auf den Go-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px"| Zurück-Button
|style="width: 200px"| Auf den Zurück-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px"| Vor-Button
|style="width: 200px"| Auf den Vor-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px" rowspan="3"| Textbuch auswählen
|style="width: 200px" rowspan="3"| Der weitere Befehl wählt das entsprechende Textbuch aus.
|style="width: 100px"| Nächstes
|style="width: 200px"| Wählt das nächste Textbuch aus.
|- style="vertical-align:top;"
|style="width: 100px"| Vorheriges
|style="width: 200px"| Wählt das vorherige Textbuch aus.
|- style="vertical-align:top;"
|style="width: 100px"| Textbuch-Name
|style="width: 200px"| Wählt das Textbuch mit dem Namen aus der Dropdown-Liste.
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabe Fenster öffnet in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt um eine korrekte Funktion zu gewährleisten.
|}

== Links und Referenzen==
<references/>
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Timecode-Player_DMXC2
|zurückText = Timecode-Player
|vorLink = Kommandozeile_DMXC2
|vorText = Kommandozeile
}}

[[Kategorie: DMXControl 2]]

Textbuch DMXC2

2012-11-06T16:23:46Z

Wdunczewski: /* Szenenreferenzen */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Timecode-Player_DMXC2
|zurückText = Timecode-Player
|vorLink = Kommandozeile_DMXC2
|vorText = Kommandozeile
}}

{{Hinweis
|Text = Jens-Peter (JPK) [3.08.2012, 1:15Uhr]: Artikel fertig gestellt und kann gegengelesen werden 
07.08.: Review Frank: OK, sehr gut 
11.09. Review Uwe: O.K. super Artikel 
05.10.2012: Uwe und Jens-Peter: Review OK
}}
{{Start-LaTeX}}
==Überblick==
Gerade bei Theater- und Musicalveranstaltungen ist es entscheidend, dass Lichtstimmungen und Effekte auf ein Stichwort genau zum Einsatz kommen. Dafür ist das Textbuch-Modul in DMXControl integriert. Mit diesem können Sie Licht- oder Bewegungsszenen, aber auch Soundeffekte (wie Donner, Hundegebell oder ähnliches) sowie Befehle zu gewissen Textstellen in einem Theater- oder Musicalstück starten. Dabei bleibt der Einsatzbereich des Textbuch-Moduls nicht auf Theater und Musical beschränkt, denn auch für andere Veranstaltungen mit festem Ablauf wie Chor- oder Karnevalsveranstaltungen ist dieses Modul geeignet.

{{Bild_mit_Unterschrift |DMXC2_Manual_Textbuch_Fenster.png|1|Das Textbuch-Modul|center}}

==Beschreibung==

Das Fenster des Textbuch-Moduls ist in drei Bereiche geteilt:

* der Textfeldbereich mit Texteditorfunktionen im oberen Teil des Moduls
* der Steuerungsbereich mit Buttons zur Steuerung der Aufführung im mittleren Teil des Moduls
* der Regiebereich mit einer Szenenübersicht und Szenenbearbeitungsfunktionen im unteren Teil des Moduls
 

===Textfeldbereich===

Der Textfeldbereich umfasst einen Texteditor, mit dem Sie im Textbuch (im folgenden als Skript bezeichnet) scrollen können, ohne den Szenenablauf zu beeinflussen. Außerdem können Sie mit dem Editor einfache Anpassungen, wie die Änderung der Farbe oder der Größe des Skripttextes vornehmen. Das genügt, um z.B. Stichworte zu unterstreichen oder eigene Regieeinträge aufgabenbezogen in unterschiedlichen Farben einzufärben. Der Editor des Moduls ist aber nicht darauf ausgelegt, das Skript z.B. in diesem Editor zu schreiben oder umfassende Anpassungen vorzunehmen. Dafür ist ein handelsüblicher Texteditor besser geeignet.
 

Um Skript-Dateien in DMXControl öffnen zu können, müssen diese im "'''Rich Text Format'''"<ref>Wikipedia: http://de.wikipedia.org/wiki/Rich_Text_Format</ref> (Dateiendung "'''.rtf'''") vorliegen. Damit der Text im Textfeld nicht zu umfangreich wird, sollte das Skript in mehrere Teile aufgeteilt werden, vorzugsweise zu jeder Pause eine Unterteilung. Die so entstandenen Teilskripte können in den Pausen entsprechend über ein, weiter unten im Artikel noch genauer erklärtes, Auswahlfeld separat geladen werden. Außerdem ist die Textstruktur des Skriptes im Textbuch-Modul nicht vorgegeben. Das heißt, Sie können das Skript individuell an ihre Anforderungen anpassen und müssen sich nicht auf eine DMXControl-spezifische Textstruktur einstellen.

Unter dem Textfeld befindet sich ein kleiner Fortschrittsbalken. Dieser zeigt den aktuellen Fortschitt im Skript, anhand dessen man ungefähr abschätzen kann, wie lange das aktuelle Stück schon läuft und wieviel Text noch bis zur nächsten Pause bzw. dem Ende des Stückes folgt.

Damit DMXControl erkennt, an welchen Stellen im Skript entsprechende Szenen stehen, werden Szenenreferenzen mit Verweisen auf die entsprecheden Szenen erstellt. Diese Verweise werden von DMXControl immer zu Begin einer neuen Zeile in den Skripttext eingefügt. Am besten lässt man je eine Zeile oberhalb und unterhalb der Referenz frei, damit das Skript so übersichtlich wie möglich bleibt.

{{BoxWichtig |Text = Die Zeichenfolge '''###''' darf im normalen Text des Skriptes nicht vorkommen, da DMXControl diese Zeichenkette als Markierung für die erstellten Referenzeinträge benutzt. Wird diese Zeichenkette verwendet, kann es zu schweren Fehlern kommen!}}

===Szenenreferenzen===
Szenenreferenzen werden von DMXControl hervorgehoben, damit diese besser lesbar sind. Sie haben stets folgendes Format:

### <Szenen-ID> - <Szenenname> ### <Regiekommentar>

Die Szenen-ID ist eine von DMXControl automatisch erzeugte vierstellige Referenznummer. Diese Nummer wird benötigt, damit DMXControl in der internen Datenbank die richtige Szene zu der Szenenreferenz findet. Der Szenenname entspricht dem in DMXControl vergebenen Szenennamen und kann bei der Erstellung der Szene individuell gewählt werden. Hier sollte darauf geachtet werden, treffende Namen zu verwenden, damit bei einer Suche die entsprechenden Szenen schnell wieder gefunden werden können. Zusätzliche Informationen, wie die Art der Lichtstimmung, können als Regiekommentar am Ende einer Szenenreferenz stehen. Eine Szenenreferenz kann z.B. wie folgt aussehen:

###0002 – Gewitter### Donner(Audio)

Es können alle von DMXControl unterstützten Szenenarten wie "Einfache Szene" oder "Audioszene" im Textbuch verwendet werden. Da die erstellten Szenenreferenzen auch nur Zeichenketten sind, können diese, genau wie der restliche Text des Skriptes, mit einem externen Editor bearbeitet werden. Daher führt DMXControl bei jedem Start eine Konsistenzprüfung durch, ob alle im Textbuch angegebenen Szenen in der internen Datenbank vorhanden sind. Wurde eine Szene in der Datenbank gefunden, dann wird im Regiebereich ein grüner Rhombus neben dem Namen der entsprechenden Szene angezeigt. Verweist ein Szeneneintrag auf keine existierende Szene, dann ist der Rhombus neben dem Namen rot gefärbt.

{{BoxAchtung |Text = Es sollte unbedingt darauf geachtet werden, dass die Szenenreferenzen beim Bearbeiten mit einem externen Texteditor nicht verändert werden, da hierdurch Szenenreferenzen verloren gehen können und es zu Inkonsistenzen kommen kann}}

==Bedienelemente==

===Steuerungsbereich===

[[Datei: DMXC2_Manual_Textbuch_SteuerungsbereichNormal.png | miniatur | 600px | zentriert | Bild 2: Der Steuerbereich]]
Im Steuerungsbereich befinden sich vier Buttons. Der Größte von ihnen ist der '''GO-Button'''. Er startet die ausgewählte Szene und selektiert automatisch die nachfolgende Szene. So werden durch mehrmaliges Klicken auf den '''GO-Button''' der Reihe nach alle Szenen im Skript gestartet.

Links daneben befinden sich zwei Navigationsbuttons, '''Zurück''' und '''Vor'''. Mit ihnen kann man zwischen den Szenen navigieren, ohne sie auszuführen. So kann man einzelne Szenenreferenzen überspringen, falls mal ein Stichwort verpasst wurde und nun die nächste Szene ausgewählt werden soll.

Rechts neben dem GO-Button befindet sich der '''AutoScroll-Button'''. Mit diesem kann die AutoScroll-Funktion des Textbuches aktiviert bzw. deaktiviert werden. Bei der AutoScroll-Funktion wird eine rote Leselinie angezeigt und das Textbuch scrollt die Leselinie und das Skript immer bis zur nächsten Szenenreferenz. Die Scrollgeschwindigkeit wird aus der angegebenen Delta-Zeit zur nächsten Szene im Regiebereich abgeleitet, daher ist natürlich in der Regel eine manuelle Anpassung erforderlich.

[[Datei: DMXC2_Manual_Textbuch_SteuerungsbereichSuche.png | miniatur | 600px | zentriert | Bild 3: Der Steuerbereich im Such-Modus]]

Der Steuerbereich beinhaltet seit der Version 2.11 von DMXControl auch eine kleine Suchfunktion. Mit Hilfe der Tastenkombination '''Strg''' + '''F''' wird die Suchfunktion aktiviert. Sie durchsucht das Skript bei einem Klick auf '''Nächster Treffer''' ab der aktuellen Cursor-Position nach den eingegebenen Suchtext. Wird der Suchtext im Skript gefunden, so springt das Textbuch an diese Position und markiert die entsprechende Textstelle. Der linke Button in der Such-Ansicht schließt die Suchfunktion und zeigt wieder die Steueransicht an.

===Regiebereich===

Der Regiebereich beinhaltet im oberen Teilbereich eine Textbuchverwaltung. Mit dem Dropdown-Menü lassen sich die unterschiedlichen Teilskripte auswählen und können mit dem Button '''Verwalten''' angelegt, kopiert, umbenannt oder gelöscht werden. Mit '''Öffnen''' kann zu jedem Teilskript die passende Textdatei geöffnet werden.

Im unteren Teil befindet sich eine Liste mit allen im Skript enthaltenen Szenen, welche nach ihrem Erscheinen im Skript sortiert sind. In dieser Liste werden verschiedene Parameter jeder einzelnen Szene angezeigt, die teilweise durch langsames doppeltes Klicken (kein Doppelklick) bearbeitet werden können:

[[Datei: DMXC2_Manual_Textbuch_Szenenliste.png | miniatur | zentriert | 800px | Bild 4: Auschnitt aus der Szenenenliste des Textbuches]]

{| class="wikitable centered"
|- style="vertical-align:top;"
!
! Funktion
! Beschreibung
! Bearbeitbar
|- style="vertical-align:top;"
|style="width: 10px"| 1
|style="width: 100px"| Szene aktiv
|style="width: 500px"| Hier kann ausgewählt werden, ob die Szene im Ablauf berücksichtigt oder ausgelassen wird
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 2
|style="width: 100px"| grüner / roter Rhombus
|style="width: 500px"| Stimmen Szenenreferenz und Szene in der Datenbank überein, ist der Rhombus grün, andernfalls rot
|style="width: 100px"| Nein
|- style="vertical-align:top;"
|style="width: 10px"| 3
|style="width: 100px"| Name
|style="width: 500px"| Name des entsprechenden Szeneneintrags
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 4
|style="width: 100px"| Zeile
|style="width: 500px"| Hier wird die Zeilennummer der Szenenreferenz angezeigt
|style="width: 100px"| Nein
|- style="vertical-align:top;"
|style="width: 10px"| 5
|style="width: 100px"| Delta-T
|style="width: 500px"| Zeit zwischen der letzten und der aktuellen Szene. Der hier angegebene Wert hat Einfluss auf die Scrollgeschwindigkeit der AutoScroll-Funktion
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 6
|style="width: 100px"| Stichwort
|style="width: 500px"| Als kleine Hilfe kann hier eine Textstelle angegeben werden, an der die Szene gestartet werden soll
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 7
|style="width: 100px"| Kommentar
|style="width: 500px"| Hier kann eine Notiz mit zusätzlichen Informationen zur Szene angegeben werden, die am Ende der entsprechenden Szenenreferenz im Skript erscheint
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 8
|style="width: 100px"| Einblendzeit
|style="width: 500px"| Die Einblendzeit bestimmt, wielange die Überblendung von der letzten Szene zur aktuellen Szene dauern soll
|style="width: 100px"| Ja
|}

 

Links von der Szenenliste sind die aus anderen Modulen bekannten Button zum Erstellen, Bearbeiiten und Löschen einzelner Szeneneinträge. Näheres zu ihrer Bedienung finden sie im Artikel Szenen-Modul.
Unterhalb der Szenenliste befindet sich der Szenenfortschrittsbalken. Dieser zeigt grafisch an, wie lange die aktuelle Szene im Verhältnis zu ihrer Einblenddauer schon eingeblendet wird.

{{BoxWichtig |Text = Werden mehrere Szenen gleichzeitig gestartet, die die gleichen Geräte beinhalten, so beginnt die DMX-Ausgabe zu springen und das Licht fängt an zu flackern. Außerdem können Szeneneinblendungen nicht abgebrochen werden. Daher muss darauf geachtet werden, dass die Einblendzeiten nicht zu groß gewählt werden!}}

==Modulbezogene Befehle==

* Modul: '''Textbuch'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 100px"| Gerät/Funktion
!style="width: 200px"| Beschreibung
!style="width: 100px"| Kanal
!style="width: 200px"| Beschreibung
|- style="vertical-align:top;"
|style="width: 100px"| Go-Button
|style="width: 200px"| Auf den Go-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px"| Zurück-Button
|style="width: 200px"| Auf den Zurück-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px"| Vor-Button
|style="width: 200px"| Auf den Vor-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px" rowspan="3"| Textbuch auswählen
|style="width: 200px" rowspan="3"| Der weitere Befehl wählt das entsprechende Textbuch aus.
|style="width: 100px"| Nächstes
|style="width: 200px"| Wählt das nächste Textbuch aus.
|- style="vertical-align:top;"
|style="width: 100px"| Vorheriges
|style="width: 200px"| Wählt das vorherige Textbuch aus.
|- style="vertical-align:top;"
|style="width: 100px"| Textbuch-Name
|style="width: 200px"| Wählt das Textbuch mit dem Namen aus der Dropdown-Liste.
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabe Fenster öffnet in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt um eine korrekte Funktion zu gewährleisten.
|}

== Links und Referenzen==
<references/>
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Timecode-Player_DMXC2
|zurückText = Timecode-Player
|vorLink = Kommandozeile_DMXC2
|vorText = Kommandozeile
}}

[[Kategorie: DMXControl 2]]

Textbuch DMXC2

2012-11-06T16:19:36Z

Wdunczewski: /* Textfeldbereich */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Timecode-Player_DMXC2
|zurückText = Timecode-Player
|vorLink = Kommandozeile_DMXC2
|vorText = Kommandozeile
}}

{{Hinweis
|Text = Jens-Peter (JPK) [3.08.2012, 1:15Uhr]: Artikel fertig gestellt und kann gegengelesen werden 
07.08.: Review Frank: OK, sehr gut 
11.09. Review Uwe: O.K. super Artikel 
05.10.2012: Uwe und Jens-Peter: Review OK
}}
{{Start-LaTeX}}
==Überblick==
Gerade bei Theater- und Musicalveranstaltungen ist es entscheidend, dass Lichtstimmungen und Effekte auf ein Stichwort genau zum Einsatz kommen. Dafür ist das Textbuch-Modul in DMXControl integriert. Mit diesem können Sie Licht- oder Bewegungsszenen, aber auch Soundeffekte (wie Donner, Hundegebell oder ähnliches) sowie Befehle zu gewissen Textstellen in einem Theater- oder Musicalstück starten. Dabei bleibt der Einsatzbereich des Textbuch-Moduls nicht auf Theater und Musical beschränkt, denn auch für andere Veranstaltungen mit festem Ablauf wie Chor- oder Karnevalsveranstaltungen ist dieses Modul geeignet.

{{Bild_mit_Unterschrift |DMXC2_Manual_Textbuch_Fenster.png|1|Das Textbuch-Modul|center}}

==Beschreibung==

Das Fenster des Textbuch-Moduls ist in drei Bereiche geteilt:

* der Textfeldbereich mit Texteditorfunktionen im oberen Teil des Moduls
* der Steuerungsbereich mit Buttons zur Steuerung der Aufführung im mittleren Teil des Moduls
* der Regiebereich mit einer Szenenübersicht und Szenenbearbeitungsfunktionen im unteren Teil des Moduls
 

===Textfeldbereich===

Der Textfeldbereich umfasst einen Texteditor, mit dem Sie im Textbuch (im folgenden als Skript bezeichnet) scrollen können, ohne den Szenenablauf zu beeinflussen. Außerdem können Sie mit dem Editor einfache Anpassungen, wie die Änderung der Farbe oder der Größe des Skripttextes vornehmen. Das genügt, um z.B. Stichworte zu unterstreichen oder eigene Regieeinträge aufgabenbezogen in unterschiedlichen Farben einzufärben. Der Editor des Moduls ist aber nicht darauf ausgelegt, das Skript z.B. in diesem Editor zu schreiben oder umfassende Anpassungen vorzunehmen. Dafür ist ein handelsüblicher Texteditor besser geeignet.
 

Um Skript-Dateien in DMXControl öffnen zu können, müssen diese im "'''Rich Text Format'''"<ref>Wikipedia: http://de.wikipedia.org/wiki/Rich_Text_Format</ref> (Dateiendung "'''.rtf'''") vorliegen. Damit der Text im Textfeld nicht zu umfangreich wird, sollte das Skript in mehrere Teile aufgeteilt werden, vorzugsweise zu jeder Pause eine Unterteilung. Die so entstandenen Teilskripte können in den Pausen entsprechend über ein, weiter unten im Artikel noch genauer erklärtes, Auswahlfeld separat geladen werden. Außerdem ist die Textstruktur des Skriptes im Textbuch-Modul nicht vorgegeben. Das heißt, Sie können das Skript individuell an ihre Anforderungen anpassen und müssen sich nicht auf eine DMXControl-spezifische Textstruktur einstellen.

Unter dem Textfeld befindet sich ein kleiner Fortschrittsbalken. Dieser zeigt den aktuellen Fortschitt im Skript, anhand dessen man ungefähr abschätzen kann, wie lange das aktuelle Stück schon läuft und wieviel Text noch bis zur nächsten Pause bzw. dem Ende des Stückes folgt.

Damit DMXControl erkennt, an welchen Stellen im Skript entsprechende Szenen stehen, werden Szenenreferenzen mit Verweisen auf die entsprecheden Szenen erstellt. Diese Verweise werden von DMXControl immer zu Begin einer neuen Zeile in den Skripttext eingefügt. Am besten lässt man je eine Zeile oberhalb und unterhalb der Referenz frei, damit das Skript so übersichtlich wie möglich bleibt.

{{BoxWichtig |Text = Die Zeichenfolge '''###''' darf im normalen Text des Skriptes nicht vorkommen, da DMXControl diese Zeichenkette als Markierung für die erstellten Referenzeinträge benutzt. Wird diese Zeichenkette verwendet, kann es zu schweren Fehlern kommen!}}

===Szenenreferenzen===
Szenenreferenzen werden von DMXControl hervorgehoben, damit diese besser lesbar sind. Sie haben stets folgendes Format:

### <Szenen-ID> - <Szenenname> ### <Regiekommentar>

Die Szenen-ID ist eine von DMXControl automatisch erzeugte vierstellige Referenznummer. Diese Nummer wird benötigt, damit DMXControl in der internen Datenbank die richtige Szene zu der Szenenreferenz findet. Der Szenenname entspricht dem in DMXControl vergebenen Szenennamen und kann bei der Erstellung der Szene individuell gewählt werden. Hier sollte darauf geachtet werden, treffende Namen zu verwenden, damit bei einer Suche die entsprechenden Szenen schnell wieder gefunden werden können. Zusätzliche Informationen wie die Art der Lichtstimmung können als Regiekommentar am Ende einer Szenenreferenz stehen. Eine Szenenreferenz kann z.B. wie folgt aussehen:

###0002 – Gewitter### Donner(Audio)

Es können alle von DMXControl unterstützten Szenenarten wie "Einfache Szene" oder "Audioszene" im Textbuch verwendet werden. Da die erstellten Szenenreferenzen auch nur Zeichenketten sind, können diese, genau wie der restliche Text des Skriptes, mit einem externen Editor bearbeitet werden. Daher führt DMXControl bei jedem Start eine Konsistenzprüfung durch, ob alle im Textbuch angegebenen Szenen in der internen Datenbank vorhanden sind. Wurde eine Szene in der Datenbank gefunden, dann wird im Regiebereich ein grüner Rhombus neben dem Namen der entsprechenden Szene angezeigt. Verweist ein Szeneneintrag auf keine existierende Szene, dann ist der Rhombus neben dem Namen rot gefärbt.

{{BoxAchtung |Text = Es sollte unbedingt darauf geachtet werden, dass die Szenenreferenzen beim Bearbeiten mit einem externen Texteditor nicht verändert werden, da hierdurch Szenenreferenzen verloren gehen können und es zu Inkonsistenzen kommen kann}}

==Bedienelemente==

===Steuerungsbereich===

[[Datei: DMXC2_Manual_Textbuch_SteuerungsbereichNormal.png | miniatur | 600px | zentriert | Bild 2: Der Steuerbereich]]
Im Steuerungsbereich befinden sich vier Buttons. Der Größte von ihnen ist der '''GO-Button'''. Er startet die ausgewählte Szene und selektiert automatisch die nachfolgende Szene. So werden durch mehrmaliges Klicken auf den '''GO-Button''' der Reihe nach alle Szenen im Skript gestartet.

Links daneben befinden sich zwei Navigationsbuttons, '''Zurück''' und '''Vor'''. Mit ihnen kann man zwischen den Szenen navigieren, ohne sie auszuführen. So kann man einzelne Szenenreferenzen überspringen, falls mal ein Stichwort verpasst wurde und nun die nächste Szene ausgewählt werden soll.

Rechts neben dem GO-Button befindet sich der '''AutoScroll-Button'''. Mit diesem kann die AutoScroll-Funktion des Textbuches aktiviert bzw. deaktiviert werden. Bei der AutoScroll-Funktion wird eine rote Leselinie angezeigt und das Textbuch scrollt die Leselinie und das Skript immer bis zur nächsten Szenenreferenz. Die Scrollgeschwindigkeit wird aus der angegebenen Delta-Zeit zur nächsten Szene im Regiebereich abgeleitet, daher ist natürlich in der Regel eine manuelle Anpassung erforderlich.

[[Datei: DMXC2_Manual_Textbuch_SteuerungsbereichSuche.png | miniatur | 600px | zentriert | Bild 3: Der Steuerbereich im Such-Modus]]

Der Steuerbereich beinhaltet seit der Version 2.11 von DMXControl auch eine kleine Suchfunktion. Mit Hilfe der Tastenkombination '''Strg''' + '''F''' wird die Suchfunktion aktiviert. Sie durchsucht das Skript bei einem Klick auf '''Nächster Treffer''' ab der aktuellen Cursor-Position nach den eingegebenen Suchtext. Wird der Suchtext im Skript gefunden, so springt das Textbuch an diese Position und markiert die entsprechende Textstelle. Der linke Button in der Such-Ansicht schließt die Suchfunktion und zeigt wieder die Steueransicht an.

===Regiebereich===

Der Regiebereich beinhaltet im oberen Teilbereich eine Textbuchverwaltung. Mit dem Dropdown-Menü lassen sich die unterschiedlichen Teilskripte auswählen und können mit dem Button '''Verwalten''' angelegt, kopiert, umbenannt oder gelöscht werden. Mit '''Öffnen''' kann zu jedem Teilskript die passende Textdatei geöffnet werden.

Im unteren Teil befindet sich eine Liste mit allen im Skript enthaltenen Szenen, welche nach ihrem Erscheinen im Skript sortiert sind. In dieser Liste werden verschiedene Parameter jeder einzelnen Szene angezeigt, die teilweise durch langsames doppeltes Klicken (kein Doppelklick) bearbeitet werden können:

[[Datei: DMXC2_Manual_Textbuch_Szenenliste.png | miniatur | zentriert | 800px | Bild 4: Auschnitt aus der Szenenenliste des Textbuches]]

{| class="wikitable centered"
|- style="vertical-align:top;"
!
! Funktion
! Beschreibung
! Bearbeitbar
|- style="vertical-align:top;"
|style="width: 10px"| 1
|style="width: 100px"| Szene aktiv
|style="width: 500px"| Hier kann ausgewählt werden, ob die Szene im Ablauf berücksichtigt oder ausgelassen wird
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 2
|style="width: 100px"| grüner / roter Rhombus
|style="width: 500px"| Stimmen Szenenreferenz und Szene in der Datenbank überein, ist der Rhombus grün, andernfalls rot
|style="width: 100px"| Nein
|- style="vertical-align:top;"
|style="width: 10px"| 3
|style="width: 100px"| Name
|style="width: 500px"| Name des entsprechenden Szeneneintrags
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 4
|style="width: 100px"| Zeile
|style="width: 500px"| Hier wird die Zeilennummer der Szenenreferenz angezeigt
|style="width: 100px"| Nein
|- style="vertical-align:top;"
|style="width: 10px"| 5
|style="width: 100px"| Delta-T
|style="width: 500px"| Zeit zwischen der letzten und der aktuellen Szene. Der hier angegebene Wert hat Einfluss auf die Scrollgeschwindigkeit der AutoScroll-Funktion
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 6
|style="width: 100px"| Stichwort
|style="width: 500px"| Als kleine Hilfe kann hier eine Textstelle angegeben werden, an der die Szene gestartet werden soll
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 7
|style="width: 100px"| Kommentar
|style="width: 500px"| Hier kann eine Notiz mit zusätzlichen Informationen zur Szene angegeben werden, die am Ende der entsprechenden Szenenreferenz im Skript erscheint
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 8
|style="width: 100px"| Einblendzeit
|style="width: 500px"| Die Einblendzeit bestimmt, wielange die Überblendung von der letzten Szene zur aktuellen Szene dauern soll
|style="width: 100px"| Ja
|}

 

Links von der Szenenliste sind die aus anderen Modulen bekannten Button zum Erstellen, Bearbeiiten und Löschen einzelner Szeneneinträge. Näheres zu ihrer Bedienung finden sie im Artikel Szenen-Modul.
Unterhalb der Szenenliste befindet sich der Szenenfortschrittsbalken. Dieser zeigt grafisch an, wie lange die aktuelle Szene im Verhältnis zu ihrer Einblenddauer schon eingeblendet wird.

{{BoxWichtig |Text = Werden mehrere Szenen gleichzeitig gestartet, die die gleichen Geräte beinhalten, so beginnt die DMX-Ausgabe zu springen und das Licht fängt an zu flackern. Außerdem können Szeneneinblendungen nicht abgebrochen werden. Daher muss darauf geachtet werden, dass die Einblendzeiten nicht zu groß gewählt werden!}}

==Modulbezogene Befehle==

* Modul: '''Textbuch'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 100px"| Gerät/Funktion
!style="width: 200px"| Beschreibung
!style="width: 100px"| Kanal
!style="width: 200px"| Beschreibung
|- style="vertical-align:top;"
|style="width: 100px"| Go-Button
|style="width: 200px"| Auf den Go-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px"| Zurück-Button
|style="width: 200px"| Auf den Zurück-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px"| Vor-Button
|style="width: 200px"| Auf den Vor-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px" rowspan="3"| Textbuch auswählen
|style="width: 200px" rowspan="3"| Der weitere Befehl wählt das entsprechende Textbuch aus.
|style="width: 100px"| Nächstes
|style="width: 200px"| Wählt das nächste Textbuch aus.
|- style="vertical-align:top;"
|style="width: 100px"| Vorheriges
|style="width: 200px"| Wählt das vorherige Textbuch aus.
|- style="vertical-align:top;"
|style="width: 100px"| Textbuch-Name
|style="width: 200px"| Wählt das Textbuch mit dem Namen aus der Dropdown-Liste.
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabe Fenster öffnet in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt um eine korrekte Funktion zu gewährleisten.
|}

== Links und Referenzen==
<references/>
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Timecode-Player_DMXC2
|zurückText = Timecode-Player
|vorLink = Kommandozeile_DMXC2
|vorText = Kommandozeile
}}

[[Kategorie: DMXControl 2]]

Textbuch DMXC2

2012-11-06T16:19:17Z

Wdunczewski: /* Textfeldbereich */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Timecode-Player_DMXC2
|zurückText = Timecode-Player
|vorLink = Kommandozeile_DMXC2
|vorText = Kommandozeile
}}

{{Hinweis
|Text = Jens-Peter (JPK) [3.08.2012, 1:15Uhr]: Artikel fertig gestellt und kann gegengelesen werden 
07.08.: Review Frank: OK, sehr gut 
11.09. Review Uwe: O.K. super Artikel 
05.10.2012: Uwe und Jens-Peter: Review OK
}}
{{Start-LaTeX}}
==Überblick==
Gerade bei Theater- und Musicalveranstaltungen ist es entscheidend, dass Lichtstimmungen und Effekte auf ein Stichwort genau zum Einsatz kommen. Dafür ist das Textbuch-Modul in DMXControl integriert. Mit diesem können Sie Licht- oder Bewegungsszenen, aber auch Soundeffekte (wie Donner, Hundegebell oder ähnliches) sowie Befehle zu gewissen Textstellen in einem Theater- oder Musicalstück starten. Dabei bleibt der Einsatzbereich des Textbuch-Moduls nicht auf Theater und Musical beschränkt, denn auch für andere Veranstaltungen mit festem Ablauf wie Chor- oder Karnevalsveranstaltungen ist dieses Modul geeignet.

{{Bild_mit_Unterschrift |DMXC2_Manual_Textbuch_Fenster.png|1|Das Textbuch-Modul|center}}

==Beschreibung==

Das Fenster des Textbuch-Moduls ist in drei Bereiche geteilt:

* der Textfeldbereich mit Texteditorfunktionen im oberen Teil des Moduls
* der Steuerungsbereich mit Buttons zur Steuerung der Aufführung im mittleren Teil des Moduls
* der Regiebereich mit einer Szenenübersicht und Szenenbearbeitungsfunktionen im unteren Teil des Moduls
 

===Textfeldbereich===

Der Textfeldbereich umfasst einen Texteditor, mit dem Sie im Textbuch (im folgenden als Skript bezeichnet) scrollen können, ohne den Szenenablauf zu beeinflussen. Außerdem können Sie mit dem Editor einfache Anpassungen, wie die Änderung der Farbe oder der Größe des Skripttextes vornehmen. Das genügt, um z.B. Stichworte zu unterstreichen oder eigene Regieeinträge aufgabenbezogen in unterschiedlichen Farben einzufärben. Der Editor des Moduls ist aber nicht darauf ausgelegt, das Skript z.B. in diesem Editor zu schreiben oder umfassende Anpassungen vorzunehmen. Dafür ist ein handelsüblicher Texteditor besser geeignet.
 

Um Skript-Dateien in DMXControl öffnen zu können, müssen diese im "'''Rich Text Format'''"<ref>Wikipedia: http://de.wikipedia.org/wiki/Rich_Text_Format</ref> (Dateiendung "'''.rtf'''") vorliegen. Damit der Text im Textfeld nicht zu umfangreich wird, sollte das Skript in mehrere Teile aufgeteilt werden, vorzugsweise zu jeder Pause eine Unterteilung. Die so entstandenen Teilskripte können in den Pausen entsprechend über ein, weiter unten im Artikel noch genauer erklärtes, Auswahlfeld separat geladen werden. Außerdem ist die Textstruktur des Skriptes im Textbuch-Modul nicht vorgegeben. Das heißt, Sie können das Skript individuell an ihre Anforderungen anpassen und müssen sich nicht auf eine DMXControl-spezifische Textstruktur einstellen.

Unter dem Textfeld befindet sich ein kleiner Fortschrittsbalken. Dieser zeigt den aktuellen Fortschitt im Skript, anhand dessen man ungefähr abschätzen kann, wie lange das aktuelle Stück schon läuft und wieviel Text noch bis zur nächsten Pause bzw. dem Ende des Stückes folgt.

Damit DMXControl erkennt, an welchen Stellen im Skript entsprechende Szenen stehen, werden Szenenreferenzen mit Verweisen auf die entsprecheden Szenen erstellt. Diese Verweise werden von DMXControl immer zu Begin einer neuen Zeile in den Skripttext eingefügt. Am besten lässt man je eine Zeile oberhalb und unterhalb der Referenz frei, damit das Skript so übersichtlich wie möglich bleibt.

{{BoxWichtig |Text = Die Zeichenfolge '''###''' darf im normalen Text des Skriptes nicht vorkommen, da DMXControl diese Zeichenkette als Markierung für die erstellten Referenzeinträge benutzt. Wird diese Zeichenkette verwendet kann es zu schweren Fehlern kommen!}}

===Szenenreferenzen===
Szenenreferenzen werden von DMXControl hervorgehoben, damit diese besser lesbar sind. Sie haben stets folgendes Format:

### <Szenen-ID> - <Szenenname> ### <Regiekommentar>

Die Szenen-ID ist eine von DMXControl automatisch erzeugte vierstellige Referenznummer. Diese Nummer wird benötigt, damit DMXControl in der internen Datenbank die richtige Szene zu der Szenenreferenz findet. Der Szenenname entspricht dem in DMXControl vergebenen Szenennamen und kann bei der Erstellung der Szene individuell gewählt werden. Hier sollte darauf geachtet werden, treffende Namen zu verwenden, damit bei einer Suche die entsprechenden Szenen schnell wieder gefunden werden können. Zusätzliche Informationen wie die Art der Lichtstimmung können als Regiekommentar am Ende einer Szenenreferenz stehen. Eine Szenenreferenz kann z.B. wie folgt aussehen:

###0002 – Gewitter### Donner(Audio)

Es können alle von DMXControl unterstützten Szenenarten wie "Einfache Szene" oder "Audioszene" im Textbuch verwendet werden. Da die erstellten Szenenreferenzen auch nur Zeichenketten sind, können diese, genau wie der restliche Text des Skriptes, mit einem externen Editor bearbeitet werden. Daher führt DMXControl bei jedem Start eine Konsistenzprüfung durch, ob alle im Textbuch angegebenen Szenen in der internen Datenbank vorhanden sind. Wurde eine Szene in der Datenbank gefunden, dann wird im Regiebereich ein grüner Rhombus neben dem Namen der entsprechenden Szene angezeigt. Verweist ein Szeneneintrag auf keine existierende Szene, dann ist der Rhombus neben dem Namen rot gefärbt.

{{BoxAchtung |Text = Es sollte unbedingt darauf geachtet werden, dass die Szenenreferenzen beim Bearbeiten mit einem externen Texteditor nicht verändert werden, da hierdurch Szenenreferenzen verloren gehen können und es zu Inkonsistenzen kommen kann}}

==Bedienelemente==

===Steuerungsbereich===

[[Datei: DMXC2_Manual_Textbuch_SteuerungsbereichNormal.png | miniatur | 600px | zentriert | Bild 2: Der Steuerbereich]]
Im Steuerungsbereich befinden sich vier Buttons. Der Größte von ihnen ist der '''GO-Button'''. Er startet die ausgewählte Szene und selektiert automatisch die nachfolgende Szene. So werden durch mehrmaliges Klicken auf den '''GO-Button''' der Reihe nach alle Szenen im Skript gestartet.

Links daneben befinden sich zwei Navigationsbuttons, '''Zurück''' und '''Vor'''. Mit ihnen kann man zwischen den Szenen navigieren, ohne sie auszuführen. So kann man einzelne Szenenreferenzen überspringen, falls mal ein Stichwort verpasst wurde und nun die nächste Szene ausgewählt werden soll.

Rechts neben dem GO-Button befindet sich der '''AutoScroll-Button'''. Mit diesem kann die AutoScroll-Funktion des Textbuches aktiviert bzw. deaktiviert werden. Bei der AutoScroll-Funktion wird eine rote Leselinie angezeigt und das Textbuch scrollt die Leselinie und das Skript immer bis zur nächsten Szenenreferenz. Die Scrollgeschwindigkeit wird aus der angegebenen Delta-Zeit zur nächsten Szene im Regiebereich abgeleitet, daher ist natürlich in der Regel eine manuelle Anpassung erforderlich.

[[Datei: DMXC2_Manual_Textbuch_SteuerungsbereichSuche.png | miniatur | 600px | zentriert | Bild 3: Der Steuerbereich im Such-Modus]]

Der Steuerbereich beinhaltet seit der Version 2.11 von DMXControl auch eine kleine Suchfunktion. Mit Hilfe der Tastenkombination '''Strg''' + '''F''' wird die Suchfunktion aktiviert. Sie durchsucht das Skript bei einem Klick auf '''Nächster Treffer''' ab der aktuellen Cursor-Position nach den eingegebenen Suchtext. Wird der Suchtext im Skript gefunden, so springt das Textbuch an diese Position und markiert die entsprechende Textstelle. Der linke Button in der Such-Ansicht schließt die Suchfunktion und zeigt wieder die Steueransicht an.

===Regiebereich===

Der Regiebereich beinhaltet im oberen Teilbereich eine Textbuchverwaltung. Mit dem Dropdown-Menü lassen sich die unterschiedlichen Teilskripte auswählen und können mit dem Button '''Verwalten''' angelegt, kopiert, umbenannt oder gelöscht werden. Mit '''Öffnen''' kann zu jedem Teilskript die passende Textdatei geöffnet werden.

Im unteren Teil befindet sich eine Liste mit allen im Skript enthaltenen Szenen, welche nach ihrem Erscheinen im Skript sortiert sind. In dieser Liste werden verschiedene Parameter jeder einzelnen Szene angezeigt, die teilweise durch langsames doppeltes Klicken (kein Doppelklick) bearbeitet werden können:

[[Datei: DMXC2_Manual_Textbuch_Szenenliste.png | miniatur | zentriert | 800px | Bild 4: Auschnitt aus der Szenenenliste des Textbuches]]

{| class="wikitable centered"
|- style="vertical-align:top;"
!
! Funktion
! Beschreibung
! Bearbeitbar
|- style="vertical-align:top;"
|style="width: 10px"| 1
|style="width: 100px"| Szene aktiv
|style="width: 500px"| Hier kann ausgewählt werden, ob die Szene im Ablauf berücksichtigt oder ausgelassen wird
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 2
|style="width: 100px"| grüner / roter Rhombus
|style="width: 500px"| Stimmen Szenenreferenz und Szene in der Datenbank überein, ist der Rhombus grün, andernfalls rot
|style="width: 100px"| Nein
|- style="vertical-align:top;"
|style="width: 10px"| 3
|style="width: 100px"| Name
|style="width: 500px"| Name des entsprechenden Szeneneintrags
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 4
|style="width: 100px"| Zeile
|style="width: 500px"| Hier wird die Zeilennummer der Szenenreferenz angezeigt
|style="width: 100px"| Nein
|- style="vertical-align:top;"
|style="width: 10px"| 5
|style="width: 100px"| Delta-T
|style="width: 500px"| Zeit zwischen der letzten und der aktuellen Szene. Der hier angegebene Wert hat Einfluss auf die Scrollgeschwindigkeit der AutoScroll-Funktion
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 6
|style="width: 100px"| Stichwort
|style="width: 500px"| Als kleine Hilfe kann hier eine Textstelle angegeben werden, an der die Szene gestartet werden soll
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 7
|style="width: 100px"| Kommentar
|style="width: 500px"| Hier kann eine Notiz mit zusätzlichen Informationen zur Szene angegeben werden, die am Ende der entsprechenden Szenenreferenz im Skript erscheint
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 8
|style="width: 100px"| Einblendzeit
|style="width: 500px"| Die Einblendzeit bestimmt, wielange die Überblendung von der letzten Szene zur aktuellen Szene dauern soll
|style="width: 100px"| Ja
|}

 

Links von der Szenenliste sind die aus anderen Modulen bekannten Button zum Erstellen, Bearbeiiten und Löschen einzelner Szeneneinträge. Näheres zu ihrer Bedienung finden sie im Artikel Szenen-Modul.
Unterhalb der Szenenliste befindet sich der Szenenfortschrittsbalken. Dieser zeigt grafisch an, wie lange die aktuelle Szene im Verhältnis zu ihrer Einblenddauer schon eingeblendet wird.

{{BoxWichtig |Text = Werden mehrere Szenen gleichzeitig gestartet, die die gleichen Geräte beinhalten, so beginnt die DMX-Ausgabe zu springen und das Licht fängt an zu flackern. Außerdem können Szeneneinblendungen nicht abgebrochen werden. Daher muss darauf geachtet werden, dass die Einblendzeiten nicht zu groß gewählt werden!}}

==Modulbezogene Befehle==

* Modul: '''Textbuch'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 100px"| Gerät/Funktion
!style="width: 200px"| Beschreibung
!style="width: 100px"| Kanal
!style="width: 200px"| Beschreibung
|- style="vertical-align:top;"
|style="width: 100px"| Go-Button
|style="width: 200px"| Auf den Go-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px"| Zurück-Button
|style="width: 200px"| Auf den Zurück-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px"| Vor-Button
|style="width: 200px"| Auf den Vor-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px" rowspan="3"| Textbuch auswählen
|style="width: 200px" rowspan="3"| Der weitere Befehl wählt das entsprechende Textbuch aus.
|style="width: 100px"| Nächstes
|style="width: 200px"| Wählt das nächste Textbuch aus.
|- style="vertical-align:top;"
|style="width: 100px"| Vorheriges
|style="width: 200px"| Wählt das vorherige Textbuch aus.
|- style="vertical-align:top;"
|style="width: 100px"| Textbuch-Name
|style="width: 200px"| Wählt das Textbuch mit dem Namen aus der Dropdown-Liste.
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabe Fenster öffnet in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt um eine korrekte Funktion zu gewährleisten.
|}

== Links und Referenzen==
<references/>
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Timecode-Player_DMXC2
|zurückText = Timecode-Player
|vorLink = Kommandozeile_DMXC2
|vorText = Kommandozeile
}}

[[Kategorie: DMXControl 2]]

Textbuch DMXC2

2012-11-06T16:14:19Z

Wdunczewski: /* Überblick */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Timecode-Player_DMXC2
|zurückText = Timecode-Player
|vorLink = Kommandozeile_DMXC2
|vorText = Kommandozeile
}}

{{Hinweis
|Text = Jens-Peter (JPK) [3.08.2012, 1:15Uhr]: Artikel fertig gestellt und kann gegengelesen werden 
07.08.: Review Frank: OK, sehr gut 
11.09. Review Uwe: O.K. super Artikel 
05.10.2012: Uwe und Jens-Peter: Review OK
}}
{{Start-LaTeX}}
==Überblick==
Gerade bei Theater- und Musicalveranstaltungen ist es entscheidend, dass Lichtstimmungen und Effekte auf ein Stichwort genau zum Einsatz kommen. Dafür ist das Textbuch-Modul in DMXControl integriert. Mit diesem können Sie Licht- oder Bewegungsszenen, aber auch Soundeffekte (wie Donner, Hundegebell oder ähnliches) sowie Befehle zu gewissen Textstellen in einem Theater- oder Musicalstück starten. Dabei bleibt der Einsatzbereich des Textbuch-Moduls nicht auf Theater und Musical beschränkt, denn auch für andere Veranstaltungen mit festem Ablauf wie Chor- oder Karnevalsveranstaltungen ist dieses Modul geeignet.

{{Bild_mit_Unterschrift |DMXC2_Manual_Textbuch_Fenster.png|1|Das Textbuch-Modul|center}}

==Beschreibung==

Das Fenster des Textbuch-Moduls ist in drei Bereiche geteilt:

* der Textfeldbereich mit Texteditorfunktionen im oberen Teil des Moduls
* der Steuerungsbereich mit Buttons zur Steuerung der Aufführung im mittleren Teil des Moduls
* der Regiebereich mit einer Szenenübersicht und Szenenbearbeitungsfunktionen im unteren Teil des Moduls
 

===Textfeldbereich===

Der Textfeldbereich umfasst einen Texteditor, mit dem Sie im Textbuch (im folgenden als Skript bezeichnet) scrollen können, ohne den Szenenablauf zu beeinflussen. Außerdem können Sie mit dem Editor einfache Anpassungen, wie die Änderung der Farbe oder der Größe des Skripttextes vornehmen. Das genügt, um z.B. Stichworte zu unterstreichen oder eigene Regieeinträge aufgabenbezogen in unterschiedlichen Farben einzufärben. Der Editor des Moduls ist aber nicht darauf ausgelegt, das Skript z.B. in diesem Editor zu schreiben oder umfassende Anpassungen vorzunehmen. Dafür ist ein handelsüblicher Texteditor besser geeignet.
 

Um Skript-Dateien in DMXControl öffnen zu können, müssen diese im "'''Rich Text Format'''"<ref>Wikipedia: http://de.wikipedia.org/wiki/Rich_Text_Format</ref> (Dateiendung "'''.rtf'''") vorliegen. Damit der Text im Textfeld nicht zu umfangreich wird, sollte das Skript in mehrere Teile aufgeteilt werden, vorzugsweise zu jeder Pause eine Unterteilung. Die so entstandenen Teilskripte können in den Pausen entsprechend über ein weiter unten im Artikel noch genauer erklärtes Auswahlfeld separat geladen werden. Außerdem ist die Textstruktur des Skriptes im Textbuch-Modul nicht vorgegeben, das heißt Sie können das Skript individuell an ihre Anforderungen anpassen und müssen sich nicht auf eine DMXControl-spezifische Textstruktur einstellen.

Unter dem Textfeld befindet sich ein kleiner Fortschrittsbalken. Dieser zeigt den aktuellen Fortschitt im Skript, anhand dessen man ungefähr abschätzen kann, wie lange das aktuelle Stück schon läuft und wieviel Text noch bis zur nächsten Pause bzw. dem Ende des Stückes folgt.

Damit DMXControl erkennt, an welchen Stellen im Skript entsprechende Szenen stehen, werden Szenenreferenzen mit Verweisen auf die entsprecheden Szenen erstellt. Diese Verweise werden von DMXControl immer zu Begin einer neuen Zeile in den Skripttext eingefügt. Am besten lässt man je eine Zeile oberhalb und unterhalb der Referenz frei, damit das Skript so übersichtlich wie möglich bleibt.

{{BoxWichtig |Text = Die Zeichenfolge '''###''' darf im normalen Text des Skriptes nicht vorkommen, da DMXControl diese Zeichenkette als Markierung für die erstellten Referenzeinträge benutzt. Wird diese Zeichenkette verwendet kann es zu schweren Fehlern kommen!}}

===Szenenreferenzen===
Szenenreferenzen werden von DMXControl hervorgehoben, damit diese besser lesbar sind. Sie haben stets folgendes Format:

### <Szenen-ID> - <Szenenname> ### <Regiekommentar>

Die Szenen-ID ist eine von DMXControl automatisch erzeugte vierstellige Referenznummer. Diese Nummer wird benötigt, damit DMXControl in der internen Datenbank die richtige Szene zu der Szenenreferenz findet. Der Szenenname entspricht dem in DMXControl vergebenen Szenennamen und kann bei der Erstellung der Szene individuell gewählt werden. Hier sollte darauf geachtet werden, treffende Namen zu verwenden, damit bei einer Suche die entsprechenden Szenen schnell wieder gefunden werden können. Zusätzliche Informationen wie die Art der Lichtstimmung können als Regiekommentar am Ende einer Szenenreferenz stehen. Eine Szenenreferenz kann z.B. wie folgt aussehen:

###0002 – Gewitter### Donner(Audio)

Es können alle von DMXControl unterstützten Szenenarten wie "Einfache Szene" oder "Audioszene" im Textbuch verwendet werden. Da die erstellten Szenenreferenzen auch nur Zeichenketten sind, können diese, genau wie der restliche Text des Skriptes, mit einem externen Editor bearbeitet werden. Daher führt DMXControl bei jedem Start eine Konsistenzprüfung durch, ob alle im Textbuch angegebenen Szenen in der internen Datenbank vorhanden sind. Wurde eine Szene in der Datenbank gefunden, dann wird im Regiebereich ein grüner Rhombus neben dem Namen der entsprechenden Szene angezeigt. Verweist ein Szeneneintrag auf keine existierende Szene, dann ist der Rhombus neben dem Namen rot gefärbt.

{{BoxAchtung |Text = Es sollte unbedingt darauf geachtet werden, dass die Szenenreferenzen beim Bearbeiten mit einem externen Texteditor nicht verändert werden, da hierdurch Szenenreferenzen verloren gehen können und es zu Inkonsistenzen kommen kann}}

==Bedienelemente==

===Steuerungsbereich===

[[Datei: DMXC2_Manual_Textbuch_SteuerungsbereichNormal.png | miniatur | 600px | zentriert | Bild 2: Der Steuerbereich]]
Im Steuerungsbereich befinden sich vier Buttons. Der Größte von ihnen ist der '''GO-Button'''. Er startet die ausgewählte Szene und selektiert automatisch die nachfolgende Szene. So werden durch mehrmaliges Klicken auf den '''GO-Button''' der Reihe nach alle Szenen im Skript gestartet.

Links daneben befinden sich zwei Navigationsbuttons, '''Zurück''' und '''Vor'''. Mit ihnen kann man zwischen den Szenen navigieren, ohne sie auszuführen. So kann man einzelne Szenenreferenzen überspringen, falls mal ein Stichwort verpasst wurde und nun die nächste Szene ausgewählt werden soll.

Rechts neben dem GO-Button befindet sich der '''AutoScroll-Button'''. Mit diesem kann die AutoScroll-Funktion des Textbuches aktiviert bzw. deaktiviert werden. Bei der AutoScroll-Funktion wird eine rote Leselinie angezeigt und das Textbuch scrollt die Leselinie und das Skript immer bis zur nächsten Szenenreferenz. Die Scrollgeschwindigkeit wird aus der angegebenen Delta-Zeit zur nächsten Szene im Regiebereich abgeleitet, daher ist natürlich in der Regel eine manuelle Anpassung erforderlich.

[[Datei: DMXC2_Manual_Textbuch_SteuerungsbereichSuche.png | miniatur | 600px | zentriert | Bild 3: Der Steuerbereich im Such-Modus]]

Der Steuerbereich beinhaltet seit der Version 2.11 von DMXControl auch eine kleine Suchfunktion. Mit Hilfe der Tastenkombination '''Strg''' + '''F''' wird die Suchfunktion aktiviert. Sie durchsucht das Skript bei einem Klick auf '''Nächster Treffer''' ab der aktuellen Cursor-Position nach den eingegebenen Suchtext. Wird der Suchtext im Skript gefunden, so springt das Textbuch an diese Position und markiert die entsprechende Textstelle. Der linke Button in der Such-Ansicht schließt die Suchfunktion und zeigt wieder die Steueransicht an.

===Regiebereich===

Der Regiebereich beinhaltet im oberen Teilbereich eine Textbuchverwaltung. Mit dem Dropdown-Menü lassen sich die unterschiedlichen Teilskripte auswählen und können mit dem Button '''Verwalten''' angelegt, kopiert, umbenannt oder gelöscht werden. Mit '''Öffnen''' kann zu jedem Teilskript die passende Textdatei geöffnet werden.

Im unteren Teil befindet sich eine Liste mit allen im Skript enthaltenen Szenen, welche nach ihrem Erscheinen im Skript sortiert sind. In dieser Liste werden verschiedene Parameter jeder einzelnen Szene angezeigt, die teilweise durch langsames doppeltes Klicken (kein Doppelklick) bearbeitet werden können:

[[Datei: DMXC2_Manual_Textbuch_Szenenliste.png | miniatur | zentriert | 800px | Bild 4: Auschnitt aus der Szenenenliste des Textbuches]]

{| class="wikitable centered"
|- style="vertical-align:top;"
!
! Funktion
! Beschreibung
! Bearbeitbar
|- style="vertical-align:top;"
|style="width: 10px"| 1
|style="width: 100px"| Szene aktiv
|style="width: 500px"| Hier kann ausgewählt werden, ob die Szene im Ablauf berücksichtigt oder ausgelassen wird
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 2
|style="width: 100px"| grüner / roter Rhombus
|style="width: 500px"| Stimmen Szenenreferenz und Szene in der Datenbank überein, ist der Rhombus grün, andernfalls rot
|style="width: 100px"| Nein
|- style="vertical-align:top;"
|style="width: 10px"| 3
|style="width: 100px"| Name
|style="width: 500px"| Name des entsprechenden Szeneneintrags
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 4
|style="width: 100px"| Zeile
|style="width: 500px"| Hier wird die Zeilennummer der Szenenreferenz angezeigt
|style="width: 100px"| Nein
|- style="vertical-align:top;"
|style="width: 10px"| 5
|style="width: 100px"| Delta-T
|style="width: 500px"| Zeit zwischen der letzten und der aktuellen Szene. Der hier angegebene Wert hat Einfluss auf die Scrollgeschwindigkeit der AutoScroll-Funktion
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 6
|style="width: 100px"| Stichwort
|style="width: 500px"| Als kleine Hilfe kann hier eine Textstelle angegeben werden, an der die Szene gestartet werden soll
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 7
|style="width: 100px"| Kommentar
|style="width: 500px"| Hier kann eine Notiz mit zusätzlichen Informationen zur Szene angegeben werden, die am Ende der entsprechenden Szenenreferenz im Skript erscheint
|style="width: 100px"| Ja
|- style="vertical-align:top;"
|style="width: 10px"| 8
|style="width: 100px"| Einblendzeit
|style="width: 500px"| Die Einblendzeit bestimmt, wielange die Überblendung von der letzten Szene zur aktuellen Szene dauern soll
|style="width: 100px"| Ja
|}

 

Links von der Szenenliste sind die aus anderen Modulen bekannten Button zum Erstellen, Bearbeiiten und Löschen einzelner Szeneneinträge. Näheres zu ihrer Bedienung finden sie im Artikel Szenen-Modul.
Unterhalb der Szenenliste befindet sich der Szenenfortschrittsbalken. Dieser zeigt grafisch an, wie lange die aktuelle Szene im Verhältnis zu ihrer Einblenddauer schon eingeblendet wird.

{{BoxWichtig |Text = Werden mehrere Szenen gleichzeitig gestartet, die die gleichen Geräte beinhalten, so beginnt die DMX-Ausgabe zu springen und das Licht fängt an zu flackern. Außerdem können Szeneneinblendungen nicht abgebrochen werden. Daher muss darauf geachtet werden, dass die Einblendzeiten nicht zu groß gewählt werden!}}

==Modulbezogene Befehle==

* Modul: '''Textbuch'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 100px"| Gerät/Funktion
!style="width: 200px"| Beschreibung
!style="width: 100px"| Kanal
!style="width: 200px"| Beschreibung
|- style="vertical-align:top;"
|style="width: 100px"| Go-Button
|style="width: 200px"| Auf den Go-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px"| Zurück-Button
|style="width: 200px"| Auf den Zurück-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px"| Vor-Button
|style="width: 200px"| Auf den Vor-Button wird der weitere Befehl angewendet.
|style="width: 100px"| Auswählen
|style="width: 200px"| Der Button wird bei Ausführen des Befehls betätigt.
|- style="vertical-align:top;"
|style="width: 100px" rowspan="3"| Textbuch auswählen
|style="width: 200px" rowspan="3"| Der weitere Befehl wählt das entsprechende Textbuch aus.
|style="width: 100px"| Nächstes
|style="width: 200px"| Wählt das nächste Textbuch aus.
|- style="vertical-align:top;"
|style="width: 100px"| Vorheriges
|style="width: 200px"| Wählt das vorherige Textbuch aus.
|- style="vertical-align:top;"
|style="width: 100px"| Textbuch-Name
|style="width: 200px"| Wählt das Textbuch mit dem Namen aus der Dropdown-Liste.
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabe Fenster öffnet in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt um eine korrekte Funktion zu gewährleisten.
|}

== Links und Referenzen==
<references/>
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Timecode-Player_DMXC2
|zurückText = Timecode-Player
|vorLink = Kommandozeile_DMXC2
|vorText = Kommandozeile
}}

[[Kategorie: DMXControl 2]]

Handbuch DMXControl 2

2012-11-05T21:04:17Z

Wdunczewski:

__NOTITLE__
{{Hauptüberschrift
| logo = Books.png
| ueberschrift = Handbuch DMXControl 2
}}

{{Hinweis
|Text = Eine Artikelvorlage für Handbuchkapitel ist [[Hilfe:Vorlage Handbuchartikel|hier]] zu finden. 
Konventionen zu den Bilddateien befinden sich [[Hilfe:Bilder Konventionen|hier]]. 
Eine aktuelle Liste der nötigen Änderungen befindet sich [https://docs.google.com/spreadsheet/ccc?key=0AgS2IFq3SYsjdENtTW5RTVpzRVk1cjFsWk9PaVFQZEE#gid=1 hier]
}}

= Inhaltsverzeichnis =
{{Stages}}
{| width=100%
| width="50%" valign=top |
{{Stage short|100%|04.10.2012}} {{Pictures short|31.7.2012}} {{Spell check|01.11.2012}} {{Changed short}} [[Vorwort_DMXC2|Vorwort]] 
{{Stage short|100%|04.10.2012}} {{Pictures short|31.7.2012}} {{Spell check|01.11.2012}} {{Changed short}} [[Einleitung_DMXC2|Kapitel 1: Einleitung ]] 
{{Stage short|100%|04.10.2012}} {{Pictures short|31.7.2012}} {{Spell check|01.11.2012}} {{Changed short}} [[Installation_DMXC2|Kapitel 2: Installation]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|31.7.2012}} {{Spell check|01.11.2012}} {{Changed short}} [[Steuerzentrum_DMXC2|Kapitel 3: Das Steuerzentrum]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|26.10.2012}} {{Spell check|01.11.2012}} {{Changed short}}
[[Grafische Bühnenansicht_DMXC2|Kapitel 4: Grafische Bühnenansicht]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|10.8.2012}} {{Spell check|02.11.2012}} {{Changed short}} [[Geräte_DMXC2|Kapitel 5: Geräteliste]] 
{{Stage short|100%|04.10.2012}} {{Pictures short|15.8.2012}} {{Spell check|02.11.2012}} {{Changed short}} [[Ausgabeplugins_DMXC2|Kapitel 6: Ausgabe-Plugins]] 
{{Stage short|100%|04.10.2012}} {{Pictures short|2.8.2012}} {{Spell check|02.11.2012}} {{Changed short}} [[Kanalübersicht_DMXC2|Kapitel 7: Kanalübersicht]] 
{{Stage short|25%|05.10.2012}} {{Pictures short|}} {{Spell check|}} {{Changed short|05.10.2012}} [[Szenen_DMXC2|Kapitel 8: Szenen]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|6.8.2012}} {{Spell check|03.11.2012}} {{Changed short}} [[Szenenliste_DMXC2|Kapitel 9: Szenenliste]] 
{{Stage short|75%|15.07.2012}} {{Pictures short|}} {{Spell check|}} {{Changed short|05.10.2012}} [[Effektsequencer_DMXC2|Kapitel 10: Effektsequencer]] 
{{Stage short|75%|12.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short|05.10.2012}} [[Submaster_DMXC2|Kapitel 11: Submaster]] 
{{Stage short|100%|05.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|02.11.2012}} {{Changed short}} [[Master_DMXC2|Kapitel 12: Master]] 
{{Stage short|100%|05.10.2012}} {{Pictures short|12.9.2012}} {{Spell check|05.11.2012}} {{Changed short|05.11.2012}} [[Sound Analyzer_DMXC2|Kapitel 13: Sound Analyzer]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|09.07.2012}} {{Spell check|05.11.2012}} {{Changed short|05.11.2012}} [[BeatTool_DMXC2|Kapitel 14: BeatTool]] 
{{Stage short|100%|05.10.2012}} {{Pictures short|6.8.2012}} {{Spell check|05.11.2012}} {{Changed short}} [[Kommandobox_DMXC2|Kapitel 15: Kommandobox]] 
{{Stage short|75%|31.10.2012}} {{Pictures short|13.9.2012}} {{Spell check|}} {{Changed short|31.10.2012}} [[Audioplayer_DMXC2|Kapitel 16: Audioplayer]] 
{{Stage short|100%|05.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Timecode-Player_DMXC2|Kapitel 17: Timecode-Player]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short|31.10.2012}} [[Textbuch_DMXC2|Kapitel 18: Textbuch]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|05.11.2012}} {{Changed short|05.11.2012}} [[Kommandozeile_DMXC2|Kapitel 19: Kommandozeile]] 
|valign=top |
 
{{Stage short|100%|05.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Zeitplaner_DMXC2|Kapitel 20: Zeitplaner]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Bewegungsszene_DMXC2|Kapitel 21: Bewegungsszenen Editor]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Figureneditor_DMXC2|Kapitel 22: Figureneditor]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[PDA-Fernsteuerung_DMXC2|Kapitel 23: PDA-Fernsteuerung]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|26.10.2012}} {{Spell check|}} {{Changed short}} [[Tastatursteuerung_DMXC2|Kapitel 24: Tastatursteuerung]] 
{{Stage short|100%|09.10.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}}
[[Joysticksteuerung_DMXC2|Kapitel 25: Joysticksteuerung]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}}
[[MIDI-Fernsteuerung_DMXC2|Kapitel 26: MIDI-Fernsteuerung]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|6.8.2012}} {{Spell check|}} {{Changed short}}
[[DMXIn-Fernsteuerung_DMXC2|Kapitel 27: DMXIn-Fernsteuerung]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|18.9.2012}} {{Spell check|}} {{Changed short}} [[Programmkonfiguration_DMXC2|Kapitel 28: Programmkonfiguration]] 
{{Stage short|100%|06.10.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}}
[[Plugins_DMXC2|Kapitel 29: Plugin-Verwaltung]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Pack And Go_DMXC2|Kapitel 30: Pack And Go Funktion]] 
{{Stage short|100%|06.10.2012}} {{Pictures short}} {{Spell check|}} {{Changed short|06.10.2012}} [[DDF_DMXC2|Kapitel 31: DDF Grundlagen]] 
{{Stage short|75%|06.10.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[DDF Creator_DMXC2|Kapitel 32: Der DDFCreator]] 
{{Stage short|100%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Plugin:Beamertool_DMXC2|Kapitel 33: Plugin: Beamertool]] 
{{Stage short|100%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Plugin:MadMaxOne_DMXC2|Kapitel 34: Plugin: MadMaxOne]] 
{{Stage short|75%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Plugin:OSC Receiver_DMXC2|Kapitel 35: Plugin: OSC Receiver Modul]] 
{{Stage short|00%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Addon:Visualizer Magic EasyView_DMXC2|Kapitel 36: Addon: Magic EasyView Visualizer]] 
{{Stage short|50%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Glossar_DMXC2|Anhang1: Glossar]] 
{{Stage short|75%|31.10.2012}} {{Pictures short|18.9.2012}} {{Spell check|}} {{Changed short|31.10.2012}} [[Befehlsübersicht_DMXC2|Anhang2: Befehlsübersicht]] 
|}

[[Bild: DMXC2_Manual_Hauptseite_By-nc-nd.eu.png |150px| By-nc-nd.eu-Lizenz]]

Das Handbuch DMXControl 2.12 von DMXControl Projects e.V. steht unter einer [http://creativecommons.org/licenses/by-nc-nd/3.0/de/ Creative Commons Namensnennung-NichtKommerziell-KeineBearbeitung 3.0 Deutschland Lizenz].

[[de:Handbuch DMXControl 2]]
[[en:Manual DMXControl 2]]

Kommandozeile DMXC2

2012-11-05T21:03:31Z

Wdunczewski:

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Textbuch_DMXC2
|zurückText = Textbuch
|vorLink = Zeitplaner_DMXC2
|vorText = Zeitplaner
}}
{{Hinweis
|Text = 16.09. Review Uwe: O.K. 
05.10.2012 Uwe und Jens-Peter: Review OK 
05.11.2012 Wolfgang Dunczewski: Rechtschreibkorrekturen
}}
{{Start-LaTeX}}
==Überblick==
{{Bild_mit_Unterschrift |DMXC2_Manual_Kommandozeile_Fenster.png|1|Die Kommandozeile|right}}
Das Komandozeilen-Modul ist ein nützliches kleines Tool zum schnellen Setzen von DMX-Werten einzelner oder auch mehrerer DMX-Kanäle. Diese Eigenschaft macht es besonders zum Einleuchten attraktiv, wenn einzelne Lampen bzw. ganze Lichtgruppen an- oder ausgeschaltet werden müssen. Auch bei der Programmierung von Lichtstimmungen ist das Modul sehr nützlich, denn hiermit ist es recht einfach möglich, mehrere Lampen auf den selben Helligkeitswert zu setzen, was z.B. mit mehreren Fadern viel mehr Zeit in Anspruch nehmen würde.
 

==Beschreibung==

Mit den Buttons werden einfache Befehle in die untere Eingabezeile des Moduls eingetragen. Dabei kann der DMX-Wert jedes Kanals mittels spezieller Befehlsketten gesetzt werden. Zur Zeit können jedoch nur DMX-Werte gesetzt werden. Komplexere Befehle, wie zeitabhängiges Einblenden auf einen vorher definierten DMX-Wert oder die Steuerung anderer Programmmodule, sind mit der aktuellen Version von DMXControl nicht möglich.
 

==Bedienelemente==

Den größten Teil des Fensters nehmen die Befehlsbuttons in Anspruch. Die genaue Bedeutung jedes Buttons ist in der nachfolgenden Tabelle aufgeführt:

{| class="wikitable centered"
|- style="vertical-align:top;"
! Button
! Beschreibung
! Beispiel
|-
|style="text-align:center; vertical-align:middle"|
Digit
| Eingabe einer Zahl. Diese kann sowohl eine Kanalnummer als auch ein Kanalwert sein, je nachdem, an welcher Stelle sie in der Befehlskette steht.
| 27 <Enter>
|-
|style="text-align:center; vertical-align:middle"| THRU
| Wählt einen zusammenhängenden Bereich von Kanälen.
| 1 THRU 5 entspricht der Eingabe 1+2+3+4+5
|-
|style="text-align:center; vertical-align:middle"| + / -
| Hinzufügen oder Entfernen von Kanälen, etc.
| 1 THRU 50 - 20
|-
|style="text-align:center; vertical-align:middle"| @
| Dieses Zeichen steht vor dem Kanalwert-Befehl.
| 20+21+25@128 (Setzt die Kanalwerte der Kanäle 20, 21 und 25 auf 128)
|-
|style="text-align:center; vertical-align:middle"| DEL
| Löscht die letzte Eingabe.
|
|-
|style="text-align:center; vertical-align:middle"| FULL
| Setzt die Kanalwerte der angegebenen Kanäle auf ihren Maximalwert.
| 255 (oder wie im DDF spezifiziert)
|-
|style="text-align:center; vertical-align:middle"| Enter
| Absenden der Befehlskette, wodurch das Eingabefeld geleert wird.
| Die aktuelle Befehlskette wird im grauen Bereich über der Eingabezeile angezeigt.
|-
|}

 

Im unteren Bereich des Fensters befindet sich das Eingabefeld. Es besteht wiederum aus zwei Teilen, dem eigentlichen Eingabefeld (weiß hinterlegt) und einer Anzeige des letzten Befehls (grau hinterlegt).

Rechts neben den Buttons befindet sich ein Fader. Mit diesem kann man den Kanalwert der entsprechenden Kanale, ähnlich wie im [[Submaster_DMXC2|Submaster]], anpassen. Sobald die Nummern von einem oder mehreren Kanälen in das Eingabefeld eingetragen wurden und die Befehlskette mit <Enter> bestätigt wurde, kann man mit diesem Fader den Kanalwert der Kanäle beliebig anpassen.

 

Gültige Befehlsketten können wie folgt aussehen:

{| class="wikitable centered"
|- style="vertical-align:top;"
! Befehl
! Beschreibung
|- style="text-align: left;"
| 2 @ 134 <Enter>
| Setzt den Kanalwert des 2. DMX-Kanals auf den Wert 134
|- style="text-align: left;"
| 2 + 3 FULL
| Setzt die Kanalwerte der Kanäle 2 und 3 auf ihren Maximalwert
|- style="text-align: left;"
| 3 THRU 8 - 6 @ 57 <Enter>
| Setzt alle Kanalwerte der Kanäle 3 bis 8 ohne den Kanal 6 auf den Wert 57
|-
| 1 + 4 <Enter> @ 82 <Enter>
| Auch eine Eingabe in zwei Schritten ist möglich: 1. Wählt die Kanäle 1 und 4 aus 2. Setzt die Kanalwerte der zuvor ausgewählten Kanäle (hier 1 und 4) auf den Wert 82
|}

==Modulbezogene Befehle==

* Modul: '''Kommandozeile'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 100px"| Gerät/Funktion
!style="width: 200px"| Beschreibung
!style="width: 100px"| Kanal
!style="width: 200px"| Beschreibung
|- style="vertical-align:top;"
|style="width: 100px"| 0-9,.,+,-,Thru @,Full,Enter, Del,/,Slider
|style="width: 200px"| Auf die einzelnen Bedienelemente der Kommandozeile incl. des Sliders wird der nachfolgende Befehl angewendet.
|style="width: 100px"| setzen
|style="width: 200px"| Wählt das entsprechende Bedienelement aus, bzw. setzt den Slider auf einen Wert.
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabefenster öffnet, in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt, um eine korrekte Funktion zu gewährleisten.
|}

==Tipps==

{{BoxHinweis
| Text = Die Bedienung des Kommandozeilen-Moduls ist noch einfacher, wenn man sich die einzelnen Tasten mit Hilfe der [[Tastatursteuerung_DMXC2|Tastatursteuerung]] auf den Nummern-Block der Tastatur legt ("'''THRU'''" kann man z.B. auf "'''/'''" und "'''@'''" auf "'''*'''" legen). Dadurch können die Befehlsketten noch deutlich schneller und einfacher eingegeben werden.
}}
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Textbuch_DMXC2
|zurückText = Textbuch
|vorLink = Zeitplaner_DMXC2
|vorText = Zeitplaner
}}

[[Kategorie: DMXControl 2]]

Kommandozeile DMXC2

2012-11-05T21:03:05Z

Wdunczewski: /* Tipps */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Textbuch_DMXC2
|zurückText = Textbuch
|vorLink = Zeitplaner_DMXC2
|vorText = Zeitplaner
}}
{{Hinweis
|Text = 16.09. Review Uwe: O.K. 
05.10.2012 Uwe und Jens-Peter: Review OK
}}
{{Start-LaTeX}}
==Überblick==
{{Bild_mit_Unterschrift |DMXC2_Manual_Kommandozeile_Fenster.png|1|Die Kommandozeile|right}}
Das Komandozeilen-Modul ist ein nützliches kleines Tool zum schnellen Setzen von DMX-Werten einzelner oder auch mehrerer DMX-Kanäle. Diese Eigenschaft macht es besonders zum Einleuchten attraktiv, wenn einzelne Lampen bzw. ganze Lichtgruppen an- oder ausgeschaltet werden müssen. Auch bei der Programmierung von Lichtstimmungen ist das Modul sehr nützlich, denn hiermit ist es recht einfach möglich, mehrere Lampen auf den selben Helligkeitswert zu setzen, was z.B. mit mehreren Fadern viel mehr Zeit in Anspruch nehmen würde.
 

==Beschreibung==

Mit den Buttons werden einfache Befehle in die untere Eingabezeile des Moduls eingetragen. Dabei kann der DMX-Wert jedes Kanals mittels spezieller Befehlsketten gesetzt werden. Zur Zeit können jedoch nur DMX-Werte gesetzt werden. Komplexere Befehle, wie zeitabhängiges Einblenden auf einen vorher definierten DMX-Wert oder die Steuerung anderer Programmmodule, sind mit der aktuellen Version von DMXControl nicht möglich.
 

==Bedienelemente==

Den größten Teil des Fensters nehmen die Befehlsbuttons in Anspruch. Die genaue Bedeutung jedes Buttons ist in der nachfolgenden Tabelle aufgeführt:

{| class="wikitable centered"
|- style="vertical-align:top;"
! Button
! Beschreibung
! Beispiel
|-
|style="text-align:center; vertical-align:middle"|
Digit
| Eingabe einer Zahl. Diese kann sowohl eine Kanalnummer als auch ein Kanalwert sein, je nachdem, an welcher Stelle sie in der Befehlskette steht.
| 27 <Enter>
|-
|style="text-align:center; vertical-align:middle"| THRU
| Wählt einen zusammenhängenden Bereich von Kanälen.
| 1 THRU 5 entspricht der Eingabe 1+2+3+4+5
|-
|style="text-align:center; vertical-align:middle"| + / -
| Hinzufügen oder Entfernen von Kanälen, etc.
| 1 THRU 50 - 20
|-
|style="text-align:center; vertical-align:middle"| @
| Dieses Zeichen steht vor dem Kanalwert-Befehl.
| 20+21+25@128 (Setzt die Kanalwerte der Kanäle 20, 21 und 25 auf 128)
|-
|style="text-align:center; vertical-align:middle"| DEL
| Löscht die letzte Eingabe.
|
|-
|style="text-align:center; vertical-align:middle"| FULL
| Setzt die Kanalwerte der angegebenen Kanäle auf ihren Maximalwert.
| 255 (oder wie im DDF spezifiziert)
|-
|style="text-align:center; vertical-align:middle"| Enter
| Absenden der Befehlskette, wodurch das Eingabefeld geleert wird.
| Die aktuelle Befehlskette wird im grauen Bereich über der Eingabezeile angezeigt.
|-
|}

 

Im unteren Bereich des Fensters befindet sich das Eingabefeld. Es besteht wiederum aus zwei Teilen, dem eigentlichen Eingabefeld (weiß hinterlegt) und einer Anzeige des letzten Befehls (grau hinterlegt).

Rechts neben den Buttons befindet sich ein Fader. Mit diesem kann man den Kanalwert der entsprechenden Kanale, ähnlich wie im [[Submaster_DMXC2|Submaster]], anpassen. Sobald die Nummern von einem oder mehreren Kanälen in das Eingabefeld eingetragen wurden und die Befehlskette mit <Enter> bestätigt wurde, kann man mit diesem Fader den Kanalwert der Kanäle beliebig anpassen.

 

Gültige Befehlsketten können wie folgt aussehen:

{| class="wikitable centered"
|- style="vertical-align:top;"
! Befehl
! Beschreibung
|- style="text-align: left;"
| 2 @ 134 <Enter>
| Setzt den Kanalwert des 2. DMX-Kanals auf den Wert 134
|- style="text-align: left;"
| 2 + 3 FULL
| Setzt die Kanalwerte der Kanäle 2 und 3 auf ihren Maximalwert
|- style="text-align: left;"
| 3 THRU 8 - 6 @ 57 <Enter>
| Setzt alle Kanalwerte der Kanäle 3 bis 8 ohne den Kanal 6 auf den Wert 57
|-
| 1 + 4 <Enter> @ 82 <Enter>
| Auch eine Eingabe in zwei Schritten ist möglich: 1. Wählt die Kanäle 1 und 4 aus 2. Setzt die Kanalwerte der zuvor ausgewählten Kanäle (hier 1 und 4) auf den Wert 82
|}

==Modulbezogene Befehle==

* Modul: '''Kommandozeile'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 100px"| Gerät/Funktion
!style="width: 200px"| Beschreibung
!style="width: 100px"| Kanal
!style="width: 200px"| Beschreibung
|- style="vertical-align:top;"
|style="width: 100px"| 0-9,.,+,-,Thru @,Full,Enter, Del,/,Slider
|style="width: 200px"| Auf die einzelnen Bedienelemente der Kommandozeile incl. des Sliders wird der nachfolgende Befehl angewendet.
|style="width: 100px"| setzen
|style="width: 200px"| Wählt das entsprechende Bedienelement aus, bzw. setzt den Slider auf einen Wert.
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabefenster öffnet, in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt, um eine korrekte Funktion zu gewährleisten.
|}

==Tipps==

{{BoxHinweis
| Text = Die Bedienung des Kommandozeilen-Moduls ist noch einfacher, wenn man sich die einzelnen Tasten mit Hilfe der [[Tastatursteuerung_DMXC2|Tastatursteuerung]] auf den Nummern-Block der Tastatur legt ("'''THRU'''" kann man z.B. auf "'''/'''" und "'''@'''" auf "'''*'''" legen). Dadurch können die Befehlsketten noch deutlich schneller und einfacher eingegeben werden.
}}
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Textbuch_DMXC2
|zurückText = Textbuch
|vorLink = Zeitplaner_DMXC2
|vorText = Zeitplaner
}}

[[Kategorie: DMXControl 2]]

Kommandozeile DMXC2

2012-11-05T21:02:15Z

Wdunczewski: /* Modulbezogene Befehle */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Textbuch_DMXC2
|zurückText = Textbuch
|vorLink = Zeitplaner_DMXC2
|vorText = Zeitplaner
}}
{{Hinweis
|Text = 16.09. Review Uwe: O.K. 
05.10.2012 Uwe und Jens-Peter: Review OK
}}
{{Start-LaTeX}}
==Überblick==
{{Bild_mit_Unterschrift |DMXC2_Manual_Kommandozeile_Fenster.png|1|Die Kommandozeile|right}}
Das Komandozeilen-Modul ist ein nützliches kleines Tool zum schnellen Setzen von DMX-Werten einzelner oder auch mehrerer DMX-Kanäle. Diese Eigenschaft macht es besonders zum Einleuchten attraktiv, wenn einzelne Lampen bzw. ganze Lichtgruppen an- oder ausgeschaltet werden müssen. Auch bei der Programmierung von Lichtstimmungen ist das Modul sehr nützlich, denn hiermit ist es recht einfach möglich, mehrere Lampen auf den selben Helligkeitswert zu setzen, was z.B. mit mehreren Fadern viel mehr Zeit in Anspruch nehmen würde.
 

==Beschreibung==

Mit den Buttons werden einfache Befehle in die untere Eingabezeile des Moduls eingetragen. Dabei kann der DMX-Wert jedes Kanals mittels spezieller Befehlsketten gesetzt werden. Zur Zeit können jedoch nur DMX-Werte gesetzt werden. Komplexere Befehle, wie zeitabhängiges Einblenden auf einen vorher definierten DMX-Wert oder die Steuerung anderer Programmmodule, sind mit der aktuellen Version von DMXControl nicht möglich.
 

==Bedienelemente==

Den größten Teil des Fensters nehmen die Befehlsbuttons in Anspruch. Die genaue Bedeutung jedes Buttons ist in der nachfolgenden Tabelle aufgeführt:

{| class="wikitable centered"
|- style="vertical-align:top;"
! Button
! Beschreibung
! Beispiel
|-
|style="text-align:center; vertical-align:middle"|
Digit
| Eingabe einer Zahl. Diese kann sowohl eine Kanalnummer als auch ein Kanalwert sein, je nachdem, an welcher Stelle sie in der Befehlskette steht.
| 27 <Enter>
|-
|style="text-align:center; vertical-align:middle"| THRU
| Wählt einen zusammenhängenden Bereich von Kanälen.
| 1 THRU 5 entspricht der Eingabe 1+2+3+4+5
|-
|style="text-align:center; vertical-align:middle"| + / -
| Hinzufügen oder Entfernen von Kanälen, etc.
| 1 THRU 50 - 20
|-
|style="text-align:center; vertical-align:middle"| @
| Dieses Zeichen steht vor dem Kanalwert-Befehl.
| 20+21+25@128 (Setzt die Kanalwerte der Kanäle 20, 21 und 25 auf 128)
|-
|style="text-align:center; vertical-align:middle"| DEL
| Löscht die letzte Eingabe.
|
|-
|style="text-align:center; vertical-align:middle"| FULL
| Setzt die Kanalwerte der angegebenen Kanäle auf ihren Maximalwert.
| 255 (oder wie im DDF spezifiziert)
|-
|style="text-align:center; vertical-align:middle"| Enter
| Absenden der Befehlskette, wodurch das Eingabefeld geleert wird.
| Die aktuelle Befehlskette wird im grauen Bereich über der Eingabezeile angezeigt.
|-
|}

 

Im unteren Bereich des Fensters befindet sich das Eingabefeld. Es besteht wiederum aus zwei Teilen, dem eigentlichen Eingabefeld (weiß hinterlegt) und einer Anzeige des letzten Befehls (grau hinterlegt).

Rechts neben den Buttons befindet sich ein Fader. Mit diesem kann man den Kanalwert der entsprechenden Kanale, ähnlich wie im [[Submaster_DMXC2|Submaster]], anpassen. Sobald die Nummern von einem oder mehreren Kanälen in das Eingabefeld eingetragen wurden und die Befehlskette mit <Enter> bestätigt wurde, kann man mit diesem Fader den Kanalwert der Kanäle beliebig anpassen.

 

Gültige Befehlsketten können wie folgt aussehen:

{| class="wikitable centered"
|- style="vertical-align:top;"
! Befehl
! Beschreibung
|- style="text-align: left;"
| 2 @ 134 <Enter>
| Setzt den Kanalwert des 2. DMX-Kanals auf den Wert 134
|- style="text-align: left;"
| 2 + 3 FULL
| Setzt die Kanalwerte der Kanäle 2 und 3 auf ihren Maximalwert
|- style="text-align: left;"
| 3 THRU 8 - 6 @ 57 <Enter>
| Setzt alle Kanalwerte der Kanäle 3 bis 8 ohne den Kanal 6 auf den Wert 57
|-
| 1 + 4 <Enter> @ 82 <Enter>
| Auch eine Eingabe in zwei Schritten ist möglich: 1. Wählt die Kanäle 1 und 4 aus 2. Setzt die Kanalwerte der zuvor ausgewählten Kanäle (hier 1 und 4) auf den Wert 82
|}

==Modulbezogene Befehle==

* Modul: '''Kommandozeile'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 100px"| Gerät/Funktion
!style="width: 200px"| Beschreibung
!style="width: 100px"| Kanal
!style="width: 200px"| Beschreibung
|- style="vertical-align:top;"
|style="width: 100px"| 0-9,.,+,-,Thru @,Full,Enter, Del,/,Slider
|style="width: 200px"| Auf die einzelnen Bedienelemente der Kommandozeile incl. des Sliders wird der nachfolgende Befehl angewendet.
|style="width: 100px"| setzen
|style="width: 200px"| Wählt das entsprechende Bedienelement aus, bzw. setzt den Slider auf einen Wert.
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabefenster öffnet, in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt, um eine korrekte Funktion zu gewährleisten.
|}

==Tipps==

{{BoxHinweis
| Text = Die Bedienung des Komandozeilen-Moduls ist noch einfacher, wenn man sich die einzelnen Tasten mit Hilfe der [[Tastatursteuerung_DMXC2|Tastatursteuerung]] auf den Nummern-Block der Tastatur legt ("'''THRU'''" kann man z.B. auf "'''/'''" und "'''@'''" auf "'''*'''" legen). Dadurch können die Befehlsketten noch deutlich schneller und einfacher eingegeben werden.
}}
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Textbuch_DMXC2
|zurückText = Textbuch
|vorLink = Zeitplaner_DMXC2
|vorText = Zeitplaner
}}

[[Kategorie: DMXControl 2]]

Kommandozeile DMXC2

2012-11-05T21:01:32Z

Wdunczewski: /* Bedienelemente */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Textbuch_DMXC2
|zurückText = Textbuch
|vorLink = Zeitplaner_DMXC2
|vorText = Zeitplaner
}}
{{Hinweis
|Text = 16.09. Review Uwe: O.K. 
05.10.2012 Uwe und Jens-Peter: Review OK
}}
{{Start-LaTeX}}
==Überblick==
{{Bild_mit_Unterschrift |DMXC2_Manual_Kommandozeile_Fenster.png|1|Die Kommandozeile|right}}
Das Komandozeilen-Modul ist ein nützliches kleines Tool zum schnellen Setzen von DMX-Werten einzelner oder auch mehrerer DMX-Kanäle. Diese Eigenschaft macht es besonders zum Einleuchten attraktiv, wenn einzelne Lampen bzw. ganze Lichtgruppen an- oder ausgeschaltet werden müssen. Auch bei der Programmierung von Lichtstimmungen ist das Modul sehr nützlich, denn hiermit ist es recht einfach möglich, mehrere Lampen auf den selben Helligkeitswert zu setzen, was z.B. mit mehreren Fadern viel mehr Zeit in Anspruch nehmen würde.
 

==Beschreibung==

Mit den Buttons werden einfache Befehle in die untere Eingabezeile des Moduls eingetragen. Dabei kann der DMX-Wert jedes Kanals mittels spezieller Befehlsketten gesetzt werden. Zur Zeit können jedoch nur DMX-Werte gesetzt werden. Komplexere Befehle, wie zeitabhängiges Einblenden auf einen vorher definierten DMX-Wert oder die Steuerung anderer Programmmodule, sind mit der aktuellen Version von DMXControl nicht möglich.
 

==Bedienelemente==

Den größten Teil des Fensters nehmen die Befehlsbuttons in Anspruch. Die genaue Bedeutung jedes Buttons ist in der nachfolgenden Tabelle aufgeführt:

{| class="wikitable centered"
|- style="vertical-align:top;"
! Button
! Beschreibung
! Beispiel
|-
|style="text-align:center; vertical-align:middle"|
Digit
| Eingabe einer Zahl. Diese kann sowohl eine Kanalnummer als auch ein Kanalwert sein, je nachdem, an welcher Stelle sie in der Befehlskette steht.
| 27 <Enter>
|-
|style="text-align:center; vertical-align:middle"| THRU
| Wählt einen zusammenhängenden Bereich von Kanälen.
| 1 THRU 5 entspricht der Eingabe 1+2+3+4+5
|-
|style="text-align:center; vertical-align:middle"| + / -
| Hinzufügen oder Entfernen von Kanälen, etc.
| 1 THRU 50 - 20
|-
|style="text-align:center; vertical-align:middle"| @
| Dieses Zeichen steht vor dem Kanalwert-Befehl.
| 20+21+25@128 (Setzt die Kanalwerte der Kanäle 20, 21 und 25 auf 128)
|-
|style="text-align:center; vertical-align:middle"| DEL
| Löscht die letzte Eingabe.
|
|-
|style="text-align:center; vertical-align:middle"| FULL
| Setzt die Kanalwerte der angegebenen Kanäle auf ihren Maximalwert.
| 255 (oder wie im DDF spezifiziert)
|-
|style="text-align:center; vertical-align:middle"| Enter
| Absenden der Befehlskette, wodurch das Eingabefeld geleert wird.
| Die aktuelle Befehlskette wird im grauen Bereich über der Eingabezeile angezeigt.
|-
|}

 

Im unteren Bereich des Fensters befindet sich das Eingabefeld. Es besteht wiederum aus zwei Teilen, dem eigentlichen Eingabefeld (weiß hinterlegt) und einer Anzeige des letzten Befehls (grau hinterlegt).

Rechts neben den Buttons befindet sich ein Fader. Mit diesem kann man den Kanalwert der entsprechenden Kanale, ähnlich wie im [[Submaster_DMXC2|Submaster]], anpassen. Sobald die Nummern von einem oder mehreren Kanälen in das Eingabefeld eingetragen wurden und die Befehlskette mit <Enter> bestätigt wurde, kann man mit diesem Fader den Kanalwert der Kanäle beliebig anpassen.

 

Gültige Befehlsketten können wie folgt aussehen:

{| class="wikitable centered"
|- style="vertical-align:top;"
! Befehl
! Beschreibung
|- style="text-align: left;"
| 2 @ 134 <Enter>
| Setzt den Kanalwert des 2. DMX-Kanals auf den Wert 134
|- style="text-align: left;"
| 2 + 3 FULL
| Setzt die Kanalwerte der Kanäle 2 und 3 auf ihren Maximalwert
|- style="text-align: left;"
| 3 THRU 8 - 6 @ 57 <Enter>
| Setzt alle Kanalwerte der Kanäle 3 bis 8 ohne den Kanal 6 auf den Wert 57
|-
| 1 + 4 <Enter> @ 82 <Enter>
| Auch eine Eingabe in zwei Schritten ist möglich: 1. Wählt die Kanäle 1 und 4 aus 2. Setzt die Kanalwerte der zuvor ausgewählten Kanäle (hier 1 und 4) auf den Wert 82
|}

==Modulbezogene Befehle==

* Modul: '''Kommandozeile'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 100px"| Gerät/Funktion
!style="width: 200px"| Beschreibung
!style="width: 100px"| Kanal
!style="width: 200px"| Beschreibung
|- style="vertical-align:top;"
|style="width: 100px"| 0-9,.,+,-,Thru @,Full,Enter, Del,/,Slider
|style="width: 200px"| Auf die einzelnen Bedienelemente der Kommandozeile incl. des Sliders wird der nachfolgende Befehl angewendet.
|style="width: 100px"| setzen
|style="width: 200px"| Wählt das entsprechende Bedienelement aus, bzw. setzt den Slider auf einen Wert.
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabe Fenster öffnet in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt um eine korrekte Funktion zu gewährleisten.
|}

==Tipps==

{{BoxHinweis
| Text = Die Bedienung des Komandozeilen-Moduls ist noch einfacher, wenn man sich die einzelnen Tasten mit Hilfe der [[Tastatursteuerung_DMXC2|Tastatursteuerung]] auf den Nummern-Block der Tastatur legt ("'''THRU'''" kann man z.B. auf "'''/'''" und "'''@'''" auf "'''*'''" legen). Dadurch können die Befehlsketten noch deutlich schneller und einfacher eingegeben werden.
}}
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Textbuch_DMXC2
|zurückText = Textbuch
|vorLink = Zeitplaner_DMXC2
|vorText = Zeitplaner
}}

[[Kategorie: DMXControl 2]]

Kommandozeile DMXC2

2012-11-05T20:58:41Z

Wdunczewski: /* Bedienelemente */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Textbuch_DMXC2
|zurückText = Textbuch
|vorLink = Zeitplaner_DMXC2
|vorText = Zeitplaner
}}
{{Hinweis
|Text = 16.09. Review Uwe: O.K. 
05.10.2012 Uwe und Jens-Peter: Review OK
}}
{{Start-LaTeX}}
==Überblick==
{{Bild_mit_Unterschrift |DMXC2_Manual_Kommandozeile_Fenster.png|1|Die Kommandozeile|right}}
Das Komandozeilen-Modul ist ein nützliches kleines Tool zum schnellen Setzen von DMX-Werten einzelner oder auch mehrerer DMX-Kanäle. Diese Eigenschaft macht es besonders zum Einleuchten attraktiv, wenn einzelne Lampen bzw. ganze Lichtgruppen an- oder ausgeschaltet werden müssen. Auch bei der Programmierung von Lichtstimmungen ist das Modul sehr nützlich, denn hiermit ist es recht einfach möglich, mehrere Lampen auf den selben Helligkeitswert zu setzen, was z.B. mit mehreren Fadern viel mehr Zeit in Anspruch nehmen würde.
 

==Beschreibung==

Mit den Buttons werden einfache Befehle in die untere Eingabezeile des Moduls eingetragen. Dabei kann der DMX-Wert jedes Kanals mittels spezieller Befehlsketten gesetzt werden. Zur Zeit können jedoch nur DMX-Werte gesetzt werden. Komplexere Befehle, wie zeitabhängiges Einblenden auf einen vorher definierten DMX-Wert oder die Steuerung anderer Programmmodule, sind mit der aktuellen Version von DMXControl nicht möglich.
 

==Bedienelemente==

Den größten Teil des Fensters nehmen die Befehlsbutton in Anspruch. Die genaue Bedeutung jedes Buttons ist in der nachfolgenden Tabelle aufgeführt:

{| class="wikitable centered"
|- style="vertical-align:top;"
! Button
! Beschreibung
! Beispiel
|-
|style="text-align:center; vertical-align:middle"|
Digit
| Eingabe einer Zahl. Diese kann sowohl eine Kanalnummer als auch ein Kanalwert sein, je nachdem, an welcher Stelle sie in der Befehlskette steht.
| 27 <Enter>
|-
|style="text-align:center; vertical-align:middle"| THRU
| Wählt einen zusammenhängenden Bereich von Kanälen.
| 1 THRU 5 entspricht der Eingabe 1+2+3+4+5
|-
|style="text-align:center; vertical-align:middle"| + / -
| Hinzufügen oder Entfernen von Kanälen, etc.
| 1 THRU 50 - 20
|-
|style="text-align:center; vertical-align:middle"| @
| Dieses Zeichen steht vor dem Kanalwert-Befehl.
| 20+21+25@128 (Setzt die Kanalwerte der Kanäle 20, 21 und 25 auf 128)
|-
|style="text-align:center; vertical-align:middle"| DEL
| Löscht die letzte Eingabe.
|
|-
|style="text-align:center; vertical-align:middle"| FULL
| Setzt die Kanalwerte der angegebenen Kanäle auf ihren Maximalwert.
| 255 (oder wie im DDF spezifiziert)
|-
|style="text-align:center; vertical-align:middle"| Enter
| Absenden der Befehlskette, wodurch das Eingabefeld geleert wird.
| Die aktuelle Befehlskette wird im grauen Bereich über der Eingabezeile angezeigt.
|-
|}

 

Im unteren Bereich des Fensters befindet sich das Eingabefeld. Es besteht wiederum aus zwei Teilen, dem eigentlichen Eingabefeld (weis hinterlegt) und einer Anzeige des letzten Befehls (grau hinterlegt).

Rechts neben den Buttons befindet sich ein Fader. Mit diesem kann man den Kanalwert der entsprechenden Kanale ähnlich wie im [[Submaster_DMXC2|Submaster]] anpassen. Sobald die Nummern von einem oder mehreren Kanälen in das Eingabefeld eingetragen wurden und die Befehlskette mit <Enter> bestätigt wurde, kann man mit diesem Fader den Kanalwert der Kanäle beliebig anpassen.

 

Gültige Befehlsketten können wie folgt aussehen:

{| class="wikitable centered"
|- style="vertical-align:top;"
! Befehl
! Beschreibung
|- style="text-align: left;"
| 2 @ 134 <Enter>
| Setzt den Kanalwert des 2. DMX-Kanals auf den Wert 134
|- style="text-align: left;"
| 2 + 3 FULL
| Setzt die Kanalwerte der Kanäle 2 und 3 auf ihren Maximalwert
|- style="text-align: left;"
| 3 THRU 8 - 6 @ 57 <Enter>
| Setzt alle Kanalwerte der Kanäle 3 bis 8 ohne den Kanal 6 auf den Wert 57
|-
| 1 + 4 <Enter> @ 82 <Enter>
| Auch eine Eingabe in zwei Schritten ist möglich: 1. Wählt die Kanäle 1 und 4 aus 2. Setzt die Kanalwerte der zuvor ausgewählten Kanäle (hier 1 und 4) auf den Wert 82
|}

==Modulbezogene Befehle==

* Modul: '''Kommandozeile'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 100px"| Gerät/Funktion
!style="width: 200px"| Beschreibung
!style="width: 100px"| Kanal
!style="width: 200px"| Beschreibung
|- style="vertical-align:top;"
|style="width: 100px"| 0-9,.,+,-,Thru @,Full,Enter, Del,/,Slider
|style="width: 200px"| Auf die einzelnen Bedienelemente der Kommandozeile incl. des Sliders wird der nachfolgende Befehl angewendet.
|style="width: 100px"| setzen
|style="width: 200px"| Wählt das entsprechende Bedienelement aus, bzw. setzt den Slider auf einen Wert.
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabe Fenster öffnet in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt um eine korrekte Funktion zu gewährleisten.
|}

==Tipps==

{{BoxHinweis
| Text = Die Bedienung des Komandozeilen-Moduls ist noch einfacher, wenn man sich die einzelnen Tasten mit Hilfe der [[Tastatursteuerung_DMXC2|Tastatursteuerung]] auf den Nummern-Block der Tastatur legt ("'''THRU'''" kann man z.B. auf "'''/'''" und "'''@'''" auf "'''*'''" legen). Dadurch können die Befehlsketten noch deutlich schneller und einfacher eingegeben werden.
}}
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Textbuch_DMXC2
|zurückText = Textbuch
|vorLink = Zeitplaner_DMXC2
|vorText = Zeitplaner
}}

[[Kategorie: DMXControl 2]]

Kommandozeile DMXC2

2012-11-05T20:57:30Z

Wdunczewski: /* Bedienelemente */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Textbuch_DMXC2
|zurückText = Textbuch
|vorLink = Zeitplaner_DMXC2
|vorText = Zeitplaner
}}
{{Hinweis
|Text = 16.09. Review Uwe: O.K. 
05.10.2012 Uwe und Jens-Peter: Review OK
}}
{{Start-LaTeX}}
==Überblick==
{{Bild_mit_Unterschrift |DMXC2_Manual_Kommandozeile_Fenster.png|1|Die Kommandozeile|right}}
Das Komandozeilen-Modul ist ein nützliches kleines Tool zum schnellen Setzen von DMX-Werten einzelner oder auch mehrerer DMX-Kanäle. Diese Eigenschaft macht es besonders zum Einleuchten attraktiv, wenn einzelne Lampen bzw. ganze Lichtgruppen an- oder ausgeschaltet werden müssen. Auch bei der Programmierung von Lichtstimmungen ist das Modul sehr nützlich, denn hiermit ist es recht einfach möglich, mehrere Lampen auf den selben Helligkeitswert zu setzen, was z.B. mit mehreren Fadern viel mehr Zeit in Anspruch nehmen würde.
 

==Beschreibung==

Mit den Buttons werden einfache Befehle in die untere Eingabezeile des Moduls eingetragen. Dabei kann der DMX-Wert jedes Kanals mittels spezieller Befehlsketten gesetzt werden. Zur Zeit können jedoch nur DMX-Werte gesetzt werden. Komplexere Befehle, wie zeitabhängiges Einblenden auf einen vorher definierten DMX-Wert oder die Steuerung anderer Programmmodule, sind mit der aktuellen Version von DMXControl nicht möglich.
 

==Bedienelemente==

Den größten Teil des Fensters nehmen die Befehlsbutton in Anspruch. Die genaue Bedeutung jedes Buttons ist in der nachfolgenden Tabelle aufgeführt:

{| class="wikitable centered"
|- style="vertical-align:top;"
! Button
! Beschreibung
! Beispiel
|-
|style="text-align:center; vertical-align:middle"|
Digit
| Eingabe einer Zahl. Diese kann sowohl eine Kanalnummer als auch ein Kanalwert sein, je nach dem, an welcher Stelle sie in der Befehlskette steht.
| 27 <Enter>
|-
|style="text-align:center; vertical-align:middle"| THRU
| Wählt einen zusammenhängenden Bereich von Kanälen.
| 1 THRU 5 entspricht der Eingabe 1+2+3+4+5
|-
|style="text-align:center; vertical-align:middle"| + / -
| Hinzufügen oder Entfernen von Kanälen, etc.
| 1 THRU 50 - 20
|-
|style="text-align:center; vertical-align:middle"| @
| Dieses Zeichen steht vor dem Kanalwert-Befehl.
| 20+21+25@128 (Setzt die Kanalwerte der Kanäle 20, 21 und 25 auf 128)
|-
|style="text-align:center; vertical-align:middle"| DEL
| Löscht die letzte Eingabe.
|
|-
|style="text-align:center; vertical-align:middle"| FULL
| Setzt die Kanalwerte der angegebenen Kanäle auf ihren Maximalwert.
| 255 (oder wie im DDF spezifiziert)
|-
|style="text-align:center; vertical-align:middle"| Enter
| Absenden der Befehlskette, wodurch das Eingabefeld geleert wird.
| Die aktuelle Befehlskette wird im grauen Bereich über der Eingabezeile angezeigt.
|-
|}

 

Im unteren Bereich des Fensters befindet sich das Eingabefeld. Es besteht wiederum aus zwei Teilen, dem eigentlichen Eingabefeld (weis hinterlegt) und einer Anzeige des letzten Befehls (grau hinterlegt).

Rechts neben den Buttons befindet sich ein Fader. Mit diesem kann man den Kanalwert der entsprechenden Kanale ähnlich wie im [[Submaster_DMXC2|Submaster]] anpassen. Sobald die Nummern von einem oder mehreren Kanälen in das Eingabefeld eingetragen wurden und die Befehlskette mit <Enter> bestätigt wurde, kann man mit diesem Fader den Kanalwert der Kanäle beliebig anpassen.

 

Gültige Befehlsketten können wie folgt aussehen:

{| class="wikitable centered"
|- style="vertical-align:top;"
! Befehl
! Beschreibung
|- style="text-align: left;"
| 2 @ 134 <Enter>
| Setzt den Kanalwert des 2. DMX-Kanals auf den Wert 134
|- style="text-align: left;"
| 2 + 3 FULL
| Setzt die Kanalwerte der Kanäle 2 und 3 auf ihren Maximalwert
|- style="text-align: left;"
| 3 THRU 8 - 6 @ 57 <Enter>
| Setzt alle Kanalwerte der Kanäle 3 bis 8 ohne den Kanal 6 auf den Wert 57
|-
| 1 + 4 <Enter> @ 82 <Enter>
| Auch eine Eingabe in zwei Schritten ist möglich: 1. Wählt die Kanäle 1 und 4 aus 2. Setzt die Kanalwerte der zuvor ausgewählten Kanäle (hier 1 und 4) auf den Wert 82
|}

==Modulbezogene Befehle==

* Modul: '''Kommandozeile'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 100px"| Gerät/Funktion
!style="width: 200px"| Beschreibung
!style="width: 100px"| Kanal
!style="width: 200px"| Beschreibung
|- style="vertical-align:top;"
|style="width: 100px"| 0-9,.,+,-,Thru @,Full,Enter, Del,/,Slider
|style="width: 200px"| Auf die einzelnen Bedienelemente der Kommandozeile incl. des Sliders wird der nachfolgende Befehl angewendet.
|style="width: 100px"| setzen
|style="width: 200px"| Wählt das entsprechende Bedienelement aus, bzw. setzt den Slider auf einen Wert.
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabe Fenster öffnet in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt um eine korrekte Funktion zu gewährleisten.
|}

==Tipps==

{{BoxHinweis
| Text = Die Bedienung des Komandozeilen-Moduls ist noch einfacher, wenn man sich die einzelnen Tasten mit Hilfe der [[Tastatursteuerung_DMXC2|Tastatursteuerung]] auf den Nummern-Block der Tastatur legt ("'''THRU'''" kann man z.B. auf "'''/'''" und "'''@'''" auf "'''*'''" legen). Dadurch können die Befehlsketten noch deutlich schneller und einfacher eingegeben werden.
}}
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Textbuch_DMXC2
|zurückText = Textbuch
|vorLink = Zeitplaner_DMXC2
|vorText = Zeitplaner
}}

[[Kategorie: DMXControl 2]]

Kommandozeile DMXC2

2012-11-05T20:56:45Z

Wdunczewski: /* Beschreibung */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Textbuch_DMXC2
|zurückText = Textbuch
|vorLink = Zeitplaner_DMXC2
|vorText = Zeitplaner
}}
{{Hinweis
|Text = 16.09. Review Uwe: O.K. 
05.10.2012 Uwe und Jens-Peter: Review OK
}}
{{Start-LaTeX}}
==Überblick==
{{Bild_mit_Unterschrift |DMXC2_Manual_Kommandozeile_Fenster.png|1|Die Kommandozeile|right}}
Das Komandozeilen-Modul ist ein nützliches kleines Tool zum schnellen Setzen von DMX-Werten einzelner oder auch mehrerer DMX-Kanäle. Diese Eigenschaft macht es besonders zum Einleuchten attraktiv, wenn einzelne Lampen bzw. ganze Lichtgruppen an- oder ausgeschaltet werden müssen. Auch bei der Programmierung von Lichtstimmungen ist das Modul sehr nützlich, denn hiermit ist es recht einfach möglich, mehrere Lampen auf den selben Helligkeitswert zu setzen, was z.B. mit mehreren Fadern viel mehr Zeit in Anspruch nehmen würde.
 

==Beschreibung==

Mit den Buttons werden einfache Befehle in die untere Eingabezeile des Moduls eingetragen. Dabei kann der DMX-Wert jedes Kanals mittels spezieller Befehlsketten gesetzt werden. Zur Zeit können jedoch nur DMX-Werte gesetzt werden. Komplexere Befehle, wie zeitabhängiges Einblenden auf einen vorher definierten DMX-Wert oder die Steuerung anderer Programmmodule, sind mit der aktuellen Version von DMXControl nicht möglich.
 

==Bedienelemente==

Den größten Teil des Fensters nehmen die Befehlsbutton in anspruch. Die genaue Bedeutung jedes Button ist in der nachfolgenden Tabelle aufgeführt:

{| class="wikitable centered"
|- style="vertical-align:top;"
! Button
! Beschreibung
! Beispiel
|-
|style="text-align:center; vertical-align:middle"|
Digit
| Eingabe einer Zahl. Diese kann sowohl eine Kanalnummer als auch ein Kanalwert sein, je nach dem, an welcher Stelle sie in der Befehlskette steht.
| 27 <Enter>
|-
|style="text-align:center; vertical-align:middle"| THRU
| Wählt einen zusammenhängenden Bereich von Kanälen.
| 1 THRU 5 entspricht der Eingabe 1+2+3+4+5
|-
|style="text-align:center; vertical-align:middle"| + / -
| Hinzufügen oder Entfernen von Kanälen, etc.
| 1 THRU 50 - 20
|-
|style="text-align:center; vertical-align:middle"| @
| Dieses Zeichen steht vor dem Kanalwert-Befehl.
| 20+21+25@128 (Setzt die Kanalwerte der Kanäle 20, 21 und 25 auf 128)
|-
|style="text-align:center; vertical-align:middle"| DEL
| Löscht die letzte Eingabe.
|
|-
|style="text-align:center; vertical-align:middle"| FULL
| Setzt die Kanalwerte der angegebenen Kanäle auf ihren Maximalwert.
| 255 (oder wie im DDF spezifiziert)
|-
|style="text-align:center; vertical-align:middle"| Enter
| Absenden der Befehlskette, wodurch das Eingabefeld geleert wird.
| Die aktuelle Befehlskette wird im grauen Bereich über der Eingabezeile angezeigt.
|-
|}

 

Im unteren Bereich des Fensters befindet sich das Eingabefeld. Es besteht wiederum aus zwei Teilen, dem eigentlichen Eingabefeld (weis hinterlegt) und einer Anzeige des letzten Befehls (grau hinterlegt).

Rechts neben den Buttons befindet sich ein Fader. Mit diesem kann man den Kanalwert der entsprechenden Kanale ähnlich wie im [[Submaster_DMXC2|Submaster]] anpassen. Sobald die Nummern von einem oder mehreren Kanälen in das Eingabefeld eingetragen wurden und die Befehlskette mit <Enter> bestätigt wurde, kann man mit diesem Fader den Kanalwert der Kanäle beliebig anpassen.

 

Gültige Befehlsketten können wie folgt aussehen:

{| class="wikitable centered"
|- style="vertical-align:top;"
! Befehl
! Beschreibung
|- style="text-align: left;"
| 2 @ 134 <Enter>
| Setzt den Kanalwert des 2. DMX-Kanals auf den Wert 134
|- style="text-align: left;"
| 2 + 3 FULL
| Setzt die Kanalwerte der Kanäle 2 und 3 auf ihren Maximalwert
|- style="text-align: left;"
| 3 THRU 8 - 6 @ 57 <Enter>
| Setzt alle Kanalwerte der Kanäle 3 bis 8 ohne den Kanal 6 auf den Wert 57
|-
| 1 + 4 <Enter> @ 82 <Enter>
| Auch eine Eingabe in zwei Schritten ist möglich: 1. Wählt die Kanäle 1 und 4 aus 2. Setzt die Kanalwerte der zuvor ausgewählten Kanäle (hier 1 und 4) auf den Wert 82
|}

==Modulbezogene Befehle==

* Modul: '''Kommandozeile'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 100px"| Gerät/Funktion
!style="width: 200px"| Beschreibung
!style="width: 100px"| Kanal
!style="width: 200px"| Beschreibung
|- style="vertical-align:top;"
|style="width: 100px"| 0-9,.,+,-,Thru @,Full,Enter, Del,/,Slider
|style="width: 200px"| Auf die einzelnen Bedienelemente der Kommandozeile incl. des Sliders wird der nachfolgende Befehl angewendet.
|style="width: 100px"| setzen
|style="width: 200px"| Wählt das entsprechende Bedienelement aus, bzw. setzt den Slider auf einen Wert.
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabe Fenster öffnet in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt um eine korrekte Funktion zu gewährleisten.
|}

==Tipps==

{{BoxHinweis
| Text = Die Bedienung des Komandozeilen-Moduls ist noch einfacher, wenn man sich die einzelnen Tasten mit Hilfe der [[Tastatursteuerung_DMXC2|Tastatursteuerung]] auf den Nummern-Block der Tastatur legt ("'''THRU'''" kann man z.B. auf "'''/'''" und "'''@'''" auf "'''*'''" legen). Dadurch können die Befehlsketten noch deutlich schneller und einfacher eingegeben werden.
}}
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Textbuch_DMXC2
|zurückText = Textbuch
|vorLink = Zeitplaner_DMXC2
|vorText = Zeitplaner
}}

[[Kategorie: DMXControl 2]]

Kommandozeile DMXC2

2012-11-05T20:55:33Z

Wdunczewski: /* Überblick */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Textbuch_DMXC2
|zurückText = Textbuch
|vorLink = Zeitplaner_DMXC2
|vorText = Zeitplaner
}}
{{Hinweis
|Text = 16.09. Review Uwe: O.K. 
05.10.2012 Uwe und Jens-Peter: Review OK
}}
{{Start-LaTeX}}
==Überblick==
{{Bild_mit_Unterschrift |DMXC2_Manual_Kommandozeile_Fenster.png|1|Die Kommandozeile|right}}
Das Komandozeilen-Modul ist ein nützliches kleines Tool zum schnellen Setzen von DMX-Werten einzelner oder auch mehrerer DMX-Kanäle. Diese Eigenschaft macht es besonders zum Einleuchten attraktiv, wenn einzelne Lampen bzw. ganze Lichtgruppen an- oder ausgeschaltet werden müssen. Auch bei der Programmierung von Lichtstimmungen ist das Modul sehr nützlich, denn hiermit ist es recht einfach möglich, mehrere Lampen auf den selben Helligkeitswert zu setzen, was z.B. mit mehreren Fadern viel mehr Zeit in Anspruch nehmen würde.
 

==Beschreibung==

Mit den Buttons werden einfache Befehle in die untere Eingabezeile des Moduls eingetragen. Dabei kann der DMX-Wert jedes Kanals mittels spezieller Befehlsketten gesetzt werden. Zur Zeit können jedoch nur DMX-Werte gesetzt werden. Komplexere Befehle wie zeitabhängiges Einblenden auf einen vorher definierten DMX-Wert oder die Steuerung anderer Programmmodule sind mit der aktuellen Version von DMXControl nicht möglich.
 
==Bedienelemente==

Den größten Teil des Fensters nehmen die Befehlsbutton in anspruch. Die genaue Bedeutung jedes Button ist in der nachfolgenden Tabelle aufgeführt:

{| class="wikitable centered"
|- style="vertical-align:top;"
! Button
! Beschreibung
! Beispiel
|-
|style="text-align:center; vertical-align:middle"|
Digit
| Eingabe einer Zahl. Diese kann sowohl eine Kanalnummer als auch ein Kanalwert sein, je nach dem, an welcher Stelle sie in der Befehlskette steht.
| 27 <Enter>
|-
|style="text-align:center; vertical-align:middle"| THRU
| Wählt einen zusammenhängenden Bereich von Kanälen.
| 1 THRU 5 entspricht der Eingabe 1+2+3+4+5
|-
|style="text-align:center; vertical-align:middle"| + / -
| Hinzufügen oder Entfernen von Kanälen, etc.
| 1 THRU 50 - 20
|-
|style="text-align:center; vertical-align:middle"| @
| Dieses Zeichen steht vor dem Kanalwert-Befehl.
| 20+21+25@128 (Setzt die Kanalwerte der Kanäle 20, 21 und 25 auf 128)
|-
|style="text-align:center; vertical-align:middle"| DEL
| Löscht die letzte Eingabe.
|
|-
|style="text-align:center; vertical-align:middle"| FULL
| Setzt die Kanalwerte der angegebenen Kanäle auf ihren Maximalwert.
| 255 (oder wie im DDF spezifiziert)
|-
|style="text-align:center; vertical-align:middle"| Enter
| Absenden der Befehlskette, wodurch das Eingabefeld geleert wird.
| Die aktuelle Befehlskette wird im grauen Bereich über der Eingabezeile angezeigt.
|-
|}

 

Im unteren Bereich des Fensters befindet sich das Eingabefeld. Es besteht wiederum aus zwei Teilen, dem eigentlichen Eingabefeld (weis hinterlegt) und einer Anzeige des letzten Befehls (grau hinterlegt).

Rechts neben den Buttons befindet sich ein Fader. Mit diesem kann man den Kanalwert der entsprechenden Kanale ähnlich wie im [[Submaster_DMXC2|Submaster]] anpassen. Sobald die Nummern von einem oder mehreren Kanälen in das Eingabefeld eingetragen wurden und die Befehlskette mit <Enter> bestätigt wurde, kann man mit diesem Fader den Kanalwert der Kanäle beliebig anpassen.

 

Gültige Befehlsketten können wie folgt aussehen:

{| class="wikitable centered"
|- style="vertical-align:top;"
! Befehl
! Beschreibung
|- style="text-align: left;"
| 2 @ 134 <Enter>
| Setzt den Kanalwert des 2. DMX-Kanals auf den Wert 134
|- style="text-align: left;"
| 2 + 3 FULL
| Setzt die Kanalwerte der Kanäle 2 und 3 auf ihren Maximalwert
|- style="text-align: left;"
| 3 THRU 8 - 6 @ 57 <Enter>
| Setzt alle Kanalwerte der Kanäle 3 bis 8 ohne den Kanal 6 auf den Wert 57
|-
| 1 + 4 <Enter> @ 82 <Enter>
| Auch eine Eingabe in zwei Schritten ist möglich: 1. Wählt die Kanäle 1 und 4 aus 2. Setzt die Kanalwerte der zuvor ausgewählten Kanäle (hier 1 und 4) auf den Wert 82
|}

==Modulbezogene Befehle==

* Modul: '''Kommandozeile'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 100px"| Gerät/Funktion
!style="width: 200px"| Beschreibung
!style="width: 100px"| Kanal
!style="width: 200px"| Beschreibung
|- style="vertical-align:top;"
|style="width: 100px"| 0-9,.,+,-,Thru @,Full,Enter, Del,/,Slider
|style="width: 200px"| Auf die einzelnen Bedienelemente der Kommandozeile incl. des Sliders wird der nachfolgende Befehl angewendet.
|style="width: 100px"| setzen
|style="width: 200px"| Wählt das entsprechende Bedienelement aus, bzw. setzt den Slider auf einen Wert.
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabe Fenster öffnet in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt um eine korrekte Funktion zu gewährleisten.
|}

==Tipps==

{{BoxHinweis
| Text = Die Bedienung des Komandozeilen-Moduls ist noch einfacher, wenn man sich die einzelnen Tasten mit Hilfe der [[Tastatursteuerung_DMXC2|Tastatursteuerung]] auf den Nummern-Block der Tastatur legt ("'''THRU'''" kann man z.B. auf "'''/'''" und "'''@'''" auf "'''*'''" legen). Dadurch können die Befehlsketten noch deutlich schneller und einfacher eingegeben werden.
}}
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Textbuch_DMXC2
|zurückText = Textbuch
|vorLink = Zeitplaner_DMXC2
|vorText = Zeitplaner
}}

[[Kategorie: DMXControl 2]]

Kommandozeile DMXC2

2012-11-05T20:53:25Z

Wdunczewski: /* Überblick */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Textbuch_DMXC2
|zurückText = Textbuch
|vorLink = Zeitplaner_DMXC2
|vorText = Zeitplaner
}}
{{Hinweis
|Text = 16.09. Review Uwe: O.K. 
05.10.2012 Uwe und Jens-Peter: Review OK
}}
{{Start-LaTeX}}
==Überblick==
{{Bild_mit_Unterschrift |DMXC2_Manual_Kommandozeile_Fenster.png|1|Die Kommandozeile|right}}
Das Komandozeilen-Modul ist ein nützliches kleines Tool zum schnellen Setzen von DMX-Werten einzelner oder auch mehrerer DMX-Kanäle. Diese Eigenschaft macht es besonders zum Einleuchten atraktiv, wenn einzelne Lampen bzw. ganze Lichtgruppen an- oder ausgeschalten werden müssen. Auch bei der Programmierung von Lichtstimmungen ist das Modul sehr nützlich, denn hiermit ist es recht einfach möglich, mehrere Lampen auf den selben Helligkeitswert zu setzen, was z.B. mit mehreren Fadern viel mehr Zeit benötigen würde.
 

==Beschreibung==

Mit den Buttons werden einfache Befehle in die untere Eingabezeile des Moduls eingetragen. Dabei kann der DMX-Wert jedes Kanals mittels spezieller Befehlsketten gesetzt werden. Zur Zeit können jedoch nur DMX-Werte gesetzt werden. Komplexere Befehle wie zeitabhängiges Einblenden auf einen vorher definierten DMX-Wert oder die Steuerung anderer Programmmodule sind mit der aktuellen Version von DMXControl nicht möglich.
 
==Bedienelemente==

Den größten Teil des Fensters nehmen die Befehlsbutton in anspruch. Die genaue Bedeutung jedes Button ist in der nachfolgenden Tabelle aufgeführt:

{| class="wikitable centered"
|- style="vertical-align:top;"
! Button
! Beschreibung
! Beispiel
|-
|style="text-align:center; vertical-align:middle"|
Digit
| Eingabe einer Zahl. Diese kann sowohl eine Kanalnummer als auch ein Kanalwert sein, je nach dem, an welcher Stelle sie in der Befehlskette steht.
| 27 <Enter>
|-
|style="text-align:center; vertical-align:middle"| THRU
| Wählt einen zusammenhängenden Bereich von Kanälen.
| 1 THRU 5 entspricht der Eingabe 1+2+3+4+5
|-
|style="text-align:center; vertical-align:middle"| + / -
| Hinzufügen oder Entfernen von Kanälen, etc.
| 1 THRU 50 - 20
|-
|style="text-align:center; vertical-align:middle"| @
| Dieses Zeichen steht vor dem Kanalwert-Befehl.
| 20+21+25@128 (Setzt die Kanalwerte der Kanäle 20, 21 und 25 auf 128)
|-
|style="text-align:center; vertical-align:middle"| DEL
| Löscht die letzte Eingabe.
|
|-
|style="text-align:center; vertical-align:middle"| FULL
| Setzt die Kanalwerte der angegebenen Kanäle auf ihren Maximalwert.
| 255 (oder wie im DDF spezifiziert)
|-
|style="text-align:center; vertical-align:middle"| Enter
| Absenden der Befehlskette, wodurch das Eingabefeld geleert wird.
| Die aktuelle Befehlskette wird im grauen Bereich über der Eingabezeile angezeigt.
|-
|}

 

Im unteren Bereich des Fensters befindet sich das Eingabefeld. Es besteht wiederum aus zwei Teilen, dem eigentlichen Eingabefeld (weis hinterlegt) und einer Anzeige des letzten Befehls (grau hinterlegt).

Rechts neben den Buttons befindet sich ein Fader. Mit diesem kann man den Kanalwert der entsprechenden Kanale ähnlich wie im [[Submaster_DMXC2|Submaster]] anpassen. Sobald die Nummern von einem oder mehreren Kanälen in das Eingabefeld eingetragen wurden und die Befehlskette mit <Enter> bestätigt wurde, kann man mit diesem Fader den Kanalwert der Kanäle beliebig anpassen.

 

Gültige Befehlsketten können wie folgt aussehen:

{| class="wikitable centered"
|- style="vertical-align:top;"
! Befehl
! Beschreibung
|- style="text-align: left;"
| 2 @ 134 <Enter>
| Setzt den Kanalwert des 2. DMX-Kanals auf den Wert 134
|- style="text-align: left;"
| 2 + 3 FULL
| Setzt die Kanalwerte der Kanäle 2 und 3 auf ihren Maximalwert
|- style="text-align: left;"
| 3 THRU 8 - 6 @ 57 <Enter>
| Setzt alle Kanalwerte der Kanäle 3 bis 8 ohne den Kanal 6 auf den Wert 57
|-
| 1 + 4 <Enter> @ 82 <Enter>
| Auch eine Eingabe in zwei Schritten ist möglich: 1. Wählt die Kanäle 1 und 4 aus 2. Setzt die Kanalwerte der zuvor ausgewählten Kanäle (hier 1 und 4) auf den Wert 82
|}

==Modulbezogene Befehle==

* Modul: '''Kommandozeile'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 100px"| Gerät/Funktion
!style="width: 200px"| Beschreibung
!style="width: 100px"| Kanal
!style="width: 200px"| Beschreibung
|- style="vertical-align:top;"
|style="width: 100px"| 0-9,.,+,-,Thru @,Full,Enter, Del,/,Slider
|style="width: 200px"| Auf die einzelnen Bedienelemente der Kommandozeile incl. des Sliders wird der nachfolgende Befehl angewendet.
|style="width: 100px"| setzen
|style="width: 200px"| Wählt das entsprechende Bedienelement aus, bzw. setzt den Slider auf einen Wert.
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert Abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehl ein Eingabe Fenster öffnet in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt um eine korrekte Funktion zu gewährleisten.
|}

==Tipps==

{{BoxHinweis
| Text = Die Bedienung des Komandozeilen-Moduls ist noch einfacher, wenn man sich die einzelnen Tasten mit Hilfe der [[Tastatursteuerung_DMXC2|Tastatursteuerung]] auf den Nummern-Block der Tastatur legt ("'''THRU'''" kann man z.B. auf "'''/'''" und "'''@'''" auf "'''*'''" legen). Dadurch können die Befehlsketten noch deutlich schneller und einfacher eingegeben werden.
}}
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Textbuch_DMXC2
|zurückText = Textbuch
|vorLink = Zeitplaner_DMXC2
|vorText = Zeitplaner
}}

[[Kategorie: DMXControl 2]]

Handbuch DMXControl 2

2012-11-05T20:52:42Z

Wdunczewski:

__NOTITLE__
{{Hauptüberschrift
| logo = Books.png
| ueberschrift = Handbuch DMXControl 2
}}

{{Hinweis
|Text = Eine Artikelvorlage für Handbuchkapitel ist [[Hilfe:Vorlage Handbuchartikel|hier]] zu finden. 
Konventionen zu den Bilddateien befinden sich [[Hilfe:Bilder Konventionen|hier]]. 
Eine aktuelle Liste der nötigen Änderungen befindet sich [https://docs.google.com/spreadsheet/ccc?key=0AgS2IFq3SYsjdENtTW5RTVpzRVk1cjFsWk9PaVFQZEE#gid=1 hier]
}}

= Inhaltsverzeichnis =
{{Stages}}
{| width=100%
| width="50%" valign=top |
{{Stage short|100%|04.10.2012}} {{Pictures short|31.7.2012}} {{Spell check|01.11.2012}} {{Changed short}} [[Vorwort_DMXC2|Vorwort]] 
{{Stage short|100%|04.10.2012}} {{Pictures short|31.7.2012}} {{Spell check|01.11.2012}} {{Changed short}} [[Einleitung_DMXC2|Kapitel 1: Einleitung ]] 
{{Stage short|100%|04.10.2012}} {{Pictures short|31.7.2012}} {{Spell check|01.11.2012}} {{Changed short}} [[Installation_DMXC2|Kapitel 2: Installation]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|31.7.2012}} {{Spell check|01.11.2012}} {{Changed short}} [[Steuerzentrum_DMXC2|Kapitel 3: Das Steuerzentrum]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|26.10.2012}} {{Spell check|01.11.2012}} {{Changed short}}
[[Grafische Bühnenansicht_DMXC2|Kapitel 4: Grafische Bühnenansicht]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|10.8.2012}} {{Spell check|02.11.2012}} {{Changed short}} [[Geräte_DMXC2|Kapitel 5: Geräteliste]] 
{{Stage short|100%|04.10.2012}} {{Pictures short|15.8.2012}} {{Spell check|02.11.2012}} {{Changed short}} [[Ausgabeplugins_DMXC2|Kapitel 6: Ausgabe-Plugins]] 
{{Stage short|100%|04.10.2012}} {{Pictures short|2.8.2012}} {{Spell check|02.11.2012}} {{Changed short}} [[Kanalübersicht_DMXC2|Kapitel 7: Kanalübersicht]] 
{{Stage short|25%|05.10.2012}} {{Pictures short|}} {{Spell check|}} {{Changed short|05.10.2012}} [[Szenen_DMXC2|Kapitel 8: Szenen]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|6.8.2012}} {{Spell check|03.11.2012}} {{Changed short}} [[Szenenliste_DMXC2|Kapitel 9: Szenenliste]] 
{{Stage short|75%|15.07.2012}} {{Pictures short|}} {{Spell check|}} {{Changed short|05.10.2012}} [[Effektsequencer_DMXC2|Kapitel 10: Effektsequencer]] 
{{Stage short|75%|12.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short|05.10.2012}} [[Submaster_DMXC2|Kapitel 11: Submaster]] 
{{Stage short|100%|05.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|02.11.2012}} {{Changed short}} [[Master_DMXC2|Kapitel 12: Master]] 
{{Stage short|100%|05.10.2012}} {{Pictures short|12.9.2012}} {{Spell check|05.11.2012}} {{Changed short|05.11.2012}} [[Sound Analyzer_DMXC2|Kapitel 13: Sound Analyzer]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|09.07.2012}} {{Spell check|05.11.2012}} {{Changed short|05.11.2012}} [[BeatTool_DMXC2|Kapitel 14: BeatTool]] 
{{Stage short|100%|05.10.2012}} {{Pictures short|6.8.2012}} {{Spell check|05.11.2012}} {{Changed short}} [[Kommandobox_DMXC2|Kapitel 15: Kommandobox]] 
{{Stage short|75%|31.10.2012}} {{Pictures short|13.9.2012}} {{Spell check|}} {{Changed short|31.10.2012}} [[Audioplayer_DMXC2|Kapitel 16: Audioplayer]] 
{{Stage short|100%|05.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Timecode-Player_DMXC2|Kapitel 17: Timecode-Player]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short|31.10.2012}} [[Textbuch_DMXC2|Kapitel 18: Textbuch]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short|31.10.2012}} [[Kommandozeile_DMXC2|Kapitel 19: Kommandozeile]] 
|valign=top |
 
{{Stage short|100%|05.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Zeitplaner_DMXC2|Kapitel 20: Zeitplaner]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Bewegungsszene_DMXC2|Kapitel 21: Bewegungsszenen Editor]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Figureneditor_DMXC2|Kapitel 22: Figureneditor]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[PDA-Fernsteuerung_DMXC2|Kapitel 23: PDA-Fernsteuerung]] 
{{Stage short|100%|09.10.2012}} {{Pictures short|26.10.2012}} {{Spell check|}} {{Changed short}} [[Tastatursteuerung_DMXC2|Kapitel 24: Tastatursteuerung]] 
{{Stage short|100%|09.10.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}}
[[Joysticksteuerung_DMXC2|Kapitel 25: Joysticksteuerung]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}}
[[MIDI-Fernsteuerung_DMXC2|Kapitel 26: MIDI-Fernsteuerung]] 
{{Stage short|100%|31.10.2012}} {{Pictures short|6.8.2012}} {{Spell check|}} {{Changed short|31.10.2012}}
[[DMXIn-Fernsteuerung_DMXC2|Kapitel 27: DMXIn-Fernsteuerung]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|18.9.2012}} {{Spell check|}} {{Changed short}} [[Programmkonfiguration_DMXC2|Kapitel 28: Programmkonfiguration]] 
{{Stage short|75%|06.10.2012}} {{Pictures short}} {{Spell check|}} {{Changed short|12.10.2012}} [[Plugins_DMXC2|Kapitel 29: Plugin-Verwaltung]] 
{{Stage short|100%|06.10.2012}} {{Pictures short|3.8.2012}} {{Spell check|}} {{Changed short}} [[Pack And Go_DMXC2|Kapitel 30: Pack And Go Funktion]] 
{{Stage short|100%|06.10.2012}} {{Pictures short}} {{Spell check|}} {{Changed short|06.10.2012}} [[DDF_DMXC2|Kapitel 31: DDF Grundlagen]] 
{{Stage short|75%|06.10.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[DDF Creator_DMXC2|Kapitel 32: Der DDFCreator]] 
{{Stage short|100%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Plugin:Beamertool_DMXC2|Kapitel 33: Plugin: Beamertool]] 
{{Stage short|100%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Plugin:MadMaxOne_DMXC2|Kapitel 34: Plugin: MadMaxOne]] 
{{Stage short|75%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Plugin:OSC Receiver_DMXC2|Kapitel 35: Plugin: OSC Receiver Modul]] 
{{Stage short|00%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Addon:Visualizer Magic EasyView_DMXC2|Kapitel 36: Addon: Magic EasyView Visualizer]] 
{{Stage short|50%|15.07.2012}} {{Pictures short}} {{Spell check|}} {{Changed short}} [[Glossar_DMXC2|Anhang1: Glossar]] 
{{Stage short|75%|31.10.2012}} {{Pictures short|18.9.2012}} {{Spell check|}} {{Changed short|31.10.2012}} [[Befehlsübersicht_DMXC2|Anhang2: Befehlsübersicht]] 
|}

[[Bild: DMXC2_Manual_Hauptseite_By-nc-nd.eu.png |150px| By-nc-nd.eu-Lizenz]]

Das Handbuch DMXControl 2.12 von DMXControl Projects e.V. steht unter einer [http://creativecommons.org/licenses/by-nc-nd/3.0/de/ Creative Commons Namensnennung-NichtKommerziell-KeineBearbeitung 3.0 Deutschland Lizenz].

[[de:Handbuch DMXControl 2]]
[[en:Manual DMXControl 2]]

Sound Analyzer DMXC2

2012-11-05T20:52:05Z

Wdunczewski:

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Master_DMXC2
|zurückText = Master
|vorLink = BeatTool_DMXC2
|vorText = BeatTool
}}

{{Hinweis
|Text = Artikel fertig! von David (Oekel) 
05.08. Review Frank: OK 
17.08. Review Uwe: O.K. 
05.10.2012: Uwe und Jens-Peter: Text konsequent farblich markieren 
05.11.2012 Wolfgang Dunczewski: Rechtschreibkorrekturen
}}
{{Start-LaTeX}}
==Überblick==
{{Bild_mit_Unterschrift |DMXC2_Manual_SoundAnalyzer_Fenster.png|1|Der Sound Analyzer|left|190px}}
Der Soundanalyzer ermöglicht es, dass sich die Lichtsteuerung automatisch an den Takt und den Pegel der Musik anpasst. Dies kann sehr gut für einen nahezu bedienerlosen Partybetrieb verwendet werden.

Dieses Modul bietet eine detaillierte Spektrum Analyse, wobei die 24 Detailstufen manipuliert und direkt einem Kanal zugeordnet werden können. Neben dem Beat-Modul wird hier eine weitere Möglichkeit geboten, Beats aus externer Musikquelle zu extrahieren.

==Beschreibung==
Damit der '''Sound Analyzer''' seine Aufgaben erfüllen kann, muss das Fenster ständig geöffnet bleiben. Es ist unter dem Menüpunkt ''Fenster'' zu finden sowie direkt über das Symbol. {{Bild_mit_Unterschrift |DMXC2_Manual_SoundAnalyzer_ModulIcon.png|2|Modulicon|right}} 
Beim Sound Analyzer gilt es generell drei Konzepte zu verstehen, die ineinander greifen und das gesamte Modul ausmachen:

* Die Quelle und dessen Manipulation
* Die Beat Generierung
* Die Sound2Light Funktion und deren Einschränkungen

{{BoxHinweis
| Text =Die Quelle ist in BLAU , die Beats in ROT und Sound2Light in GRÜN gehalten.
}}

===Die Quellen===
Bislang können für den Sound Analyzer ausschließlich die beiden Winamp-Quellen (VbVis bzw. AVS) ausgewählt werden (siehe auch Programmkonfiguration, Reiter Tools).

<gallery>
Datei:DMXC2_Manual_SoundAnalyzer_Konfiguration.png|Bild 3: Tools
Datei:DMXC2_Manual_SoundAnalyzer_WinampKonfiguration.png|Bild 4: Winamp-Plug-In
Datei:DMXC2_Manual_SoundAnalyzer_VBLink.png|Bild 5: VBlink
Datei:DMXC2_Manual_SoundAnalyzer_AVSAuswahl.png|Bild 6: AVS
</gallery>

Beide befinden sich in der Programmkonfiguration und ersteres ist per Vorgabe aktiviert. Dank der Möglichkeit, mit Winamp auch "linein://" abzuspielen, ist es durch zusätzliche Audiotreiber oder ein simples Verbindungskabel zwischen der Soundquelle (zur Not auch der gleichen Soundkarte=LineOut) und dem LineIn der Soundkarte möglich, jeden anderen Player zu nutzen.
Es ist darauf zu achten, dass sowohl VbVis als auch AVS die Änderungen am Winamp-Equalizer mit ausgeben, jedoch die Lautstärkereglung von Winamp selbst keinen Einfluss auf die Ausgabe hat.
Überprüfen Sie bei der Wahl von "linein://" die Eingangspegel ihrer Soundkarte / des Windows-Mixers.

Sobald Sie eine ordentliche Quelle eingerichtet haben, sollten Sie, sich ständig verändernde Balken in '''BLAU''', sehen können.

===Der Beat===
Der Beat wird durch das rote Kästchen symbolisiert, welches regelmäßig aufblitzen sollte. Alle (zwei) Einstellungen für den Beat werden ebenfalls durch Grenzen in '''ROT''' dargestellt.
Die Ausgabe des Beats ist immer aktiv. Lediglich falsche Schwellenwerte können dazu führen, dass das Feld für den Beat dunkel bleibt. Ist eine Steuerung von Effekten oder Sequenzen geplant, so muss entsprechend bei den Modulen Szenen-Modul oder Effekt-Modul das Häkchen für beat-getriggert (musikgesteuert) aktiviert werden.

===Sound2Light===
Wird hier in der entsprechenden Box das Häkchen gesetzt, wird die S2L-Steuerung aktiviert. Jedoch sieht man bei der allerersten Nutzung nicht sofort einen Effekt, da mindestens einem der 24 Spektrumbalken ein Kanal (eines Geräts) zugeordnet sein muss. Um dies einstellen zu können, bedarf es jedoch, neben der Existenz von mindestens einem Gerät (siehe Geräteliste), einer "Bank",

{{Bild_mit_Unterschrift |DMXC2_Manual_SoundAnalyzer_BankAuswahl.png|7|Auswahl der richtigen Bank}}

in der die Einstellungen gespeichert werden. Es können so mehrere Konfigurationen pro Projekt abgespeichert werden. Jedoch werden nur die Kanäle der Spektrumbalken gespeichert und nicht die Werte der anderen Regler im Sound Analyzer. Ist ein Kanal zugeordnet, verfärbt sich der Balken '''GRÜN''' genau wie die Schaltschwelle, falls diese aktiviert ist.
Die Werte der Pegel werden direkt auf DMX-Werte von 0-255 umgerechnet und ausgegeben, womit sich klassische "Lichtorgel-Effekte" mit 24 Detailstufen 1:1 nachbauen lassen.

==Bedienelemente==
Mit dem Element ''Spektrumanhebung'' kann man direkt die '''Quelle''' manipulieren und somit sowohl Beat als auch S2L beeinflussen. Der Wert kann zwischen 0 und 255 variiert werden, wobei in der Mitte bei etwa 128 keine Änderung erfolgt. Etwas feiner kann diese Einstellung über das Element ''Kanaleinstellungen bearbeiten'' eingestellt werden.
{{Bild_mit_Unterschrift |DMXC2_Manual_SoundAnalyzer_Korrekturkurve.png|8|Die Korrekturkurve des Sound Analyzers|center|300px}}

===Beat Einstellungen===
Der Beat kann aus einer Quelle auf zwei verschiedenen Wegen ermittelt werden. Zum Ersten über den Spectrum-Analyzer (kurz '''''Analyzer''''') und zum Zweiten über das VU-Meter (kurz '''''VU''''').
Der Analyzer kann mit dem '''roten''' Rechteck (im oberen Bereich) konfiguriert werden. Immer wenn einer der Spektrumsbalken in dieses Rechteck ragt, wird ein Beat erkannt. Das Rechteck wird durch die 4 Regler um die Spektrumsanzeige herum eingestellt.
Die VU-Meter Methode ist eine vereinfachte Methode der Pegelanalyse <ref> Wikipedia http://de.wikipedia.org/wiki/VU_Meter </ref>. Die '''rote''' Markierung in den Balken unterhalb der Spektrumsanzeige stellt einen Schwellwert da, der mit der Maus verändert werden kann. Ein Beat wird erkannt, wenn die VU-Anzeige den Schwellenwert überschreitet.
''AutoGain'' kann hier mit einem Klick aktiviert/deaktiviert (-) werden und zeigt den automatisch ermittelten Multiplikator an.
{{Bild_mit_Unterschrift |DMXC2_Manual_SoundAnalyzer_AutoGain.png|9|Die AudioGain Anzeige}}

===Sound2Light Einstellungen===
Ist einer der 24 Spektrumsbalken einem oder mehreren Kanälen zugeordnet (klick auf einen der Balken), so wird dieser '''GRÜN''' und kann in einer Bank abgespeichert werden.
Nun kann die S2L-Funktion über das entsprechende Häkchen aktiviert/deaktiviert werden.

Es gibt vier weitere Einstellungen, die NUR das S2L betreffen:
* Schaltschwelle bei X%:
* Schaltschwelle ignorieren (bei ''Kanaleinstellungen bearbeiten'')
* Bei Überschreitung Kanal auf X setzen:
* VU-Meter

Die Schaltschwelle ist der untere Wert, der überschritten werden muss, damit eine S2L-Ausgabe erfolgt. Die Werte oberhalb des Schaltwertes werden NICHT neu auf alle 255 Werte verteilt, sondern lediglich alle Werte unterhalb der Schwelle auf 0 gesetzt. Ist die Schwelle also z.B. bei 10% kommen am DMX-Gerät somit nur Werte von 26-255 an (>25,5).
Diese globale Einstellung kann mit einem Häkchen unter ''Kanaleinstellungen bearbeiten'' für einzelne Spektren wieder aufgehoben werden ('''Schaltschwelle ignorieren''').

Möchte man zusätzlich noch eine binäre Ausgabe erhalten (also nur 0 oder Wert auf X), so kann unter '''Bei Überschreitung Kanal auf X setzen''' ein DMX-Wert eingestellt werden, der immer an die Ausgabe übergeben wird, sobald der Schwellwert überschritten wurde. Diese Einstellung hat keinen Effekt, sobald ''Schaltschwelle bei X%'' deaktiviert wurde.

Das '''VU-Meter''' ist am einfachsten zu verstehen, wenn man es selber sieht. Daher sollte zu Testzwecken einem Spektrumbalken, anstatt einem Gerät, die Dimmerkanäle von 4-8 Geräten zugeordnet werden.
Ist die Auswahl "Alle gleich" gesetzt, ist das Verhalten bei allen "Lampen" gleich. Lautet die Wahl allerdings '''VU-Meter''' (seit 2.11 möglich), so teilt sich der Ausschlag auf alle 4-8 Balken auf. (Ideal in der grafischen Bühnenansicht zu beobachten bei Positionierung von Generic-Dimmern nebeneinander.)

==Modulbezogene Befehle==

* Modul: '''Sound Analyzer'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 100px"| Gerät/Funktion
!style="width: 200px"| Beschreibung
!style="width: 100px"| Kanal
!style="width: 200px"| Beschreibung
|- style="vertical-align:top;"
|style="width: 100px" rowspan="3"| Sound2Light
|style="width: 200px" rowspan="3"| Die weiteren Befehle (Kanal) werden nur auf die Sound2Light Funktion angewendet.
|style="width: 100px"| Ein/Aus
|style="width: 200px"| Unter Benutzung des T-Flags kann die Funktion ein- und ausgeschaltet werden.
|- style="vertical-align:top;"
|style="width: 100px"| Aktivieren
|style="width: 200px"| Mit dem Befehl wird die Sound2Light Funktion aktiviert.
|- style="vertical-align:top;"
|style="width: 100px"| Deaktivieren
|style="width: 200px"| Mit dem Befehl wird die Sound2Light Funktion deaktiviert.
|- style="vertical-align:top;"
|style="width: 100px"| Bank
|style="width: 200px"| Mit der Funktion Bank kann die Entsprechende Bank aus dem Dropdown im Sound Analyzer ausgewählt werden.
|style="width: 100px"| Bankname
|style="width: 200px"| Unter Kanal stehen die entsprechend angelegten Banknamen aus dem Dropdown im Sound Analyzer.
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehls ein Eingabefenster öffnet, in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt, um eine korrekte Funktion zu gewährleisten.
|}

== Links und Referenzen==
<references/>
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Master_DMXC2
|zurückText = Master
|vorLink = BeatTool_DMXC2
|vorText = BeatTool
}}

[[Kategorie: DMXControl 2]]

Sound Analyzer DMXC2

2012-11-05T20:51:37Z

Wdunczewski: /* Bedienelemente */

{{Kapitelüberschrift}}
{{NavigationTop-Man2
|zurückLink = Master_DMXC2
|zurückText = Master
|vorLink = BeatTool_DMXC2
|vorText = BeatTool
}}

{{Hinweis
|Text = Artikel fertig! von David (Oekel) 
05.08. Review Frank: OK 
17.08. Review Uwe: O.K. 
05.10.2012: Uwe und Jens-Peter: Text konsequent farblich markieren
}}
{{Start-LaTeX}}
==Überblick==
{{Bild_mit_Unterschrift |DMXC2_Manual_SoundAnalyzer_Fenster.png|1|Der Sound Analyzer|left|190px}}
Der Soundanalyzer ermöglicht es, dass sich die Lichtsteuerung automatisch an den Takt und den Pegel der Musik anpasst. Dies kann sehr gut für einen nahezu bedienerlosen Partybetrieb verwendet werden.

Dieses Modul bietet eine detaillierte Spektrum Analyse, wobei die 24 Detailstufen manipuliert und direkt einem Kanal zugeordnet werden können. Neben dem Beat-Modul wird hier eine weitere Möglichkeit geboten, Beats aus externer Musikquelle zu extrahieren.

==Beschreibung==
Damit der '''Sound Analyzer''' seine Aufgaben erfüllen kann, muss das Fenster ständig geöffnet bleiben. Es ist unter dem Menüpunkt ''Fenster'' zu finden sowie direkt über das Symbol. {{Bild_mit_Unterschrift |DMXC2_Manual_SoundAnalyzer_ModulIcon.png|2|Modulicon|right}} 
Beim Sound Analyzer gilt es generell drei Konzepte zu verstehen, die ineinander greifen und das gesamte Modul ausmachen:

* Die Quelle und dessen Manipulation
* Die Beat Generierung
* Die Sound2Light Funktion und deren Einschränkungen

{{BoxHinweis
| Text =Die Quelle ist in BLAU , die Beats in ROT und Sound2Light in GRÜN gehalten.
}}

===Die Quellen===
Bislang können für den Sound Analyzer ausschließlich die beiden Winamp-Quellen (VbVis bzw. AVS) ausgewählt werden (siehe auch Programmkonfiguration, Reiter Tools).

<gallery>
Datei:DMXC2_Manual_SoundAnalyzer_Konfiguration.png|Bild 3: Tools
Datei:DMXC2_Manual_SoundAnalyzer_WinampKonfiguration.png|Bild 4: Winamp-Plug-In
Datei:DMXC2_Manual_SoundAnalyzer_VBLink.png|Bild 5: VBlink
Datei:DMXC2_Manual_SoundAnalyzer_AVSAuswahl.png|Bild 6: AVS
</gallery>

Beide befinden sich in der Programmkonfiguration und ersteres ist per Vorgabe aktiviert. Dank der Möglichkeit, mit Winamp auch "linein://" abzuspielen, ist es durch zusätzliche Audiotreiber oder ein simples Verbindungskabel zwischen der Soundquelle (zur Not auch der gleichen Soundkarte=LineOut) und dem LineIn der Soundkarte möglich, jeden anderen Player zu nutzen.
Es ist darauf zu achten, dass sowohl VbVis als auch AVS die Änderungen am Winamp-Equalizer mit ausgeben, jedoch die Lautstärkereglung von Winamp selbst keinen Einfluss auf die Ausgabe hat.
Überprüfen Sie bei der Wahl von "linein://" die Eingangspegel ihrer Soundkarte / des Windows-Mixers.

Sobald Sie eine ordentliche Quelle eingerichtet haben, sollten Sie, sich ständig verändernde Balken in '''BLAU''', sehen können.

===Der Beat===
Der Beat wird durch das rote Kästchen symbolisiert, welches regelmäßig aufblitzen sollte. Alle (zwei) Einstellungen für den Beat werden ebenfalls durch Grenzen in '''ROT''' dargestellt.
Die Ausgabe des Beats ist immer aktiv. Lediglich falsche Schwellenwerte können dazu führen, dass das Feld für den Beat dunkel bleibt. Ist eine Steuerung von Effekten oder Sequenzen geplant, so muss entsprechend bei den Modulen Szenen-Modul oder Effekt-Modul das Häkchen für beat-getriggert (musikgesteuert) aktiviert werden.

===Sound2Light===
Wird hier in der entsprechenden Box das Häkchen gesetzt, wird die S2L-Steuerung aktiviert. Jedoch sieht man bei der allerersten Nutzung nicht sofort einen Effekt, da mindestens einem der 24 Spektrumbalken ein Kanal (eines Geräts) zugeordnet sein muss. Um dies einstellen zu können, bedarf es jedoch, neben der Existenz von mindestens einem Gerät (siehe Geräteliste), einer "Bank",

{{Bild_mit_Unterschrift |DMXC2_Manual_SoundAnalyzer_BankAuswahl.png|7|Auswahl der richtigen Bank}}

in der die Einstellungen gespeichert werden. Es können so mehrere Konfigurationen pro Projekt abgespeichert werden. Jedoch werden nur die Kanäle der Spektrumbalken gespeichert und nicht die Werte der anderen Regler im Sound Analyzer. Ist ein Kanal zugeordnet, verfärbt sich der Balken '''GRÜN''' genau wie die Schaltschwelle, falls diese aktiviert ist.
Die Werte der Pegel werden direkt auf DMX-Werte von 0-255 umgerechnet und ausgegeben, womit sich klassische "Lichtorgel-Effekte" mit 24 Detailstufen 1:1 nachbauen lassen.

==Bedienelemente==
Mit dem Element ''Spektrumanhebung'' kann man direkt die '''Quelle''' manipulieren und somit sowohl Beat als auch S2L beeinflussen. Der Wert kann zwischen 0 und 255 variiert werden, wobei in der Mitte bei etwa 128 keine Änderung erfolgt. Etwas feiner kann diese Einstellung über das Element ''Kanaleinstellungen bearbeiten'' eingestellt werden.
{{Bild_mit_Unterschrift |DMXC2_Manual_SoundAnalyzer_Korrekturkurve.png|8|Die Korrekturkurve des Sound Analyzers|center|300px}}

===Beat Einstellungen===
Der Beat kann aus einer Quelle auf zwei verschiedenen Wegen ermittelt werden. Zum Ersten über den Spectrum-Analyzer (kurz '''''Analyzer''''') und zum Zweiten über das VU-Meter (kurz '''''VU''''').
Der Analyzer kann mit dem '''roten''' Rechteck (im oberen Bereich) konfiguriert werden. Immer wenn einer der Spektrumsbalken in dieses Rechteck ragt, wird ein Beat erkannt. Das Rechteck wird durch die 4 Regler um die Spektrumsanzeige herum eingestellt.
Die VU-Meter Methode ist eine vereinfachte Methode der Pegelanalyse <ref> Wikipedia http://de.wikipedia.org/wiki/VU_Meter </ref>. Die '''rote''' Markierung in den Balken unterhalb der Spektrumsanzeige stellt einen Schwellwert da, der mit der Maus verändert werden kann. Ein Beat wird erkannt, wenn die VU-Anzeige den Schwellenwert überschreitet.
''AutoGain'' kann hier mit einem Klick aktiviert/deaktiviert (-) werden und zeigt den automatisch ermittelten Multiplikator an.
{{Bild_mit_Unterschrift |DMXC2_Manual_SoundAnalyzer_AutoGain.png|9|Die AudioGain Anzeige}}

===Sound2Light Einstellungen===
Ist einer der 24 Spektrumsbalken einem oder mehreren Kanälen zugeordnet (klick auf einen der Balken), so wird dieser '''GRÜN''' und kann in einer Bank abgespeichert werden.
Nun kann die S2L-Funktion über das entsprechende Häkchen aktiviert/deaktiviert werden.

Es gibt vier weitere Einstellungen, die NUR das S2L betreffen:
* Schaltschwelle bei X%:
* Schaltschwelle ignorieren (bei ''Kanaleinstellungen bearbeiten'')
* Bei Überschreitung Kanal auf X setzen:
* VU-Meter

Die Schaltschwelle ist der untere Wert, der überschritten werden muss, damit eine S2L-Ausgabe erfolgt. Die Werte oberhalb des Schaltwertes werden NICHT neu auf alle 255 Werte verteilt, sondern lediglich alle Werte unterhalb der Schwelle auf 0 gesetzt. Ist die Schwelle also z.B. bei 10% kommen am DMX-Gerät somit nur Werte von 26-255 an (>25,5).
Diese globale Einstellung kann mit einem Häkchen unter ''Kanaleinstellungen bearbeiten'' für einzelne Spektren wieder aufgehoben werden ('''Schaltschwelle ignorieren''').

Möchte man zusätzlich noch eine binäre Ausgabe erhalten (also nur 0 oder Wert auf X), so kann unter '''Bei Überschreitung Kanal auf X setzen''' ein DMX-Wert eingestellt werden, der immer an die Ausgabe übergeben wird, sobald der Schwellwert überschritten wurde. Diese Einstellung hat keinen Effekt, sobald ''Schaltschwelle bei X%'' deaktiviert wurde.

Das '''VU-Meter''' ist am einfachsten zu verstehen, wenn man es selber sieht. Daher sollte zu Testzwecken einem Spektrumbalken, anstatt einem Gerät, die Dimmerkanäle von 4-8 Geräten zugeordnet werden.
Ist die Auswahl "Alle gleich" gesetzt, ist das Verhalten bei allen "Lampen" gleich. Lautet die Wahl allerdings '''VU-Meter''' (seit 2.11 möglich), so teilt sich der Ausschlag auf alle 4-8 Balken auf. (Ideal in der grafischen Bühnenansicht zu beobachten bei Positionierung von Generic-Dimmern nebeneinander.)

==Modulbezogene Befehle==

* Modul: '''Sound Analyzer'''

* Bedeutung von ''Gerät/Funktion'' und ''Kanal''
{| class="wikitable centered"
|- style="vertical-align:top;"
!style="width: 100px"| Gerät/Funktion
!style="width: 200px"| Beschreibung
!style="width: 100px"| Kanal
!style="width: 200px"| Beschreibung
|- style="vertical-align:top;"
|style="width: 100px" rowspan="3"| Sound2Light
|style="width: 200px" rowspan="3"| Die weiteren Befehle (Kanal) werden nur auf die Sound2Light Funktion angewendet.
|style="width: 100px"| Ein/Aus
|style="width: 200px"| Unter Benutzung des T-Flags kann die Funktion ein- und ausgeschaltet werden.
|- style="vertical-align:top;"
|style="width: 100px"| Aktivieren
|style="width: 200px"| Mit dem Befehl wird die Sound2Light Funktion aktiviert.
|- style="vertical-align:top;"
|style="width: 100px"| Deaktivieren
|style="width: 200px"| Mit dem Befehl wird die Sound2Light Funktion deaktiviert.
|- style="vertical-align:top;"
|style="width: 100px"| Bank
|style="width: 200px"| Mit der Funktion Bank kann die Entsprechende Bank aus dem Dropdown im Sound Analyzer ausgewählt werden.
|style="width: 100px"| Bankname
|style="width: 200px"| Unter Kanal stehen die entsprechend angelegten Banknamen aus dem Dropdown im Sound Analyzer.
|}

Bedeutung der ''Flags'':
{| class="wikitable centered"
|- style="vertical-align:top;"
! style="width: 35px"| Flag
! style="width: 105px"| Bedeutung
! style="width: 460px"| Beschreibung
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | T
| style="width: 105px"| Umschalt-Modus
| style="width: 460px"| Das ''Umschalt-Modus'' Flag bewirkt, dass die Funktion beim ersten Aufruf ausgeführt wird und beim zweiten Aufruf zurückgesetzt wird.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | O
| style="width: 105px"| Angegebenen Wert verwenden
| style="width: 460px"| Das ''Angegebenen Wert verwenden'' Flag bewirkt, dass der Wert in der Spalte Wert dem entsprechenden Kanal zugeordnet wird. Dieser Wert ist kein DMX-Wert 0 bis 255, sondern ein Prozentwert 0,000 bis 100,000%
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | A
| style="width: 105px"| Wert Abfragen
| style="width: 460px"| Das ''Wert abfragen'' Flag bewirkt, dass sich bei Aufruf des Befehls ein Eingabefenster öffnet, in dem der Prozentwert eingegeben werden kann.
|- style="vertical-align:top;"
| style="width: 35px text-align:center" | I
| style="width: 105px"| Wert 0 ignorieren
| style="width: 460px"| Das ''Wert 0 ignorieren'' Flag bewirkt, dass ein Wert von Null ignoriert wird. Wird bei einigen Befehlen benötigt, um eine korrekte Funktion zu gewährleisten.
|}

== Links und Referenzen==
<references/>
{{End-LaTeX}}
{{NavigationTop-Man2
|zurückLink = Master_DMXC2
|zurückText = Master
|vorLink = BeatTool_DMXC2
|vorText = BeatTool
}}

[[Kategorie: DMXControl 2]]