Textbook Plugin DMXC3

Textbuch
Aktuelle Version	1.3
Status	beta
Funktioniert mit	3.2
Programmier­sprache	C#
Lizenz	GLP
Deutschsprachig	ja
Homepage	http://www.dmxcontrol.de
Download

Beschreibung

Beim Textbuch handelt es sich um ein Plugin für DMXControl 3, um die Textbuchfunktionalität aus DMXControl 2 in der Version 3 zur Verfügung zu stellen. Für Theater- und Musicalveranstaltungen ist es essentiell Stimmungen und Effekte passgenau auf Zeitpunkte oder Stichwörter einzutakten. Das Textbuch wurde entwickelt, um bei Veranstaltungen mit festem Ablauf auf basis eines Textbuches/Drehbuches oder ähnlichem die passenden Funktionen von DMXControl 3 auszulösen.

Installation

Das Textbuchplugin kann im DMXControl Forum unter folgendem Link heruntergeladen werden. Im Installationsverzeichnis von DMXControl muss die enthaltene Datei "Textbook.dll" in das Unterverzeichnis "GUI/Plugins" verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im "Plugin Management" der Eintrag "Textbook Plugin" vorhanden sein. Nach aktivieren des Eintrags stehen die Textbuchfunktionalitäten zur Verfügung. Sollte der Eintrag nicht vorhanden sein, ist die DLL Datei eventuell von Windows blockiert und muss gegebenenfalls noch freigegeben oder DMXControl als Administrator gestartet werden.

Bedienelemente

Nach öffnen des Textbuches sollte sich ein Fenster gemäß untenstehender Abbildung öffnen.

Abbildung 1: Textbuch mit Beispieltext.

Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:

1. Menüleiste
2. Texteditor
3. Drag and Drop Bereich
4. Textbuch Bedien- und Statusleiste
5. Befehlsliste

Menüleiste

Die Menüleiste beinhaltet allgemeine Funktionen zum Speichern und Bearbeiten des Textbuch-Verhaltens.

Abbildung 2: Menüleiste des Textbuch Plugins.

Icon	Bezeichnung	Beschreibung / Funktionsweise
	Save	Die änderungen im Textbuch werden in der Projektstruktur gespeichert.
	import File	Externe Textdateien (*.txt, *.rtf) werden in den Texteditor des Textbuches importiert.
	export File	Das aktuelle Textbuch wird inklusive der Formatierungen in Form eines *.rtf Dokumentes exportiert. Beim bearbeiten mit externen Programmen ist es notwendig, dass das \v Tag des RTF-Standards unterstützt wird (Textbuchkommandos werden großteils als versteckter Text gespeichert).
	show Drag-Drop panel	Blendet das Steuerelement zum erstellen von Textbuchbefehlen per Drag and Drop ein/aus.
	show Ruler	Blendet das Lineal im Texteditor ein/aus.
	show Commandbox	Blendet die Tabelle mit den vorhandenen Textbuchkommandos ein/aus.
	show Linenumbers	Blendet die Zeilennummerierung im Texteditor ein/aus.
	scroll to next Item after Go	Nach dem Ausführen eines Kommandos mit "Go" wird zum nächsten Element gescrollt.
	next Line after Go	Nach dem Ausführen eines Kommandos mit "Go" wird die nächsten Zeile im Textbuch selektiert.
	next Command after Go	Nach dem Ausführen eines Kommandos mit "Go" wird das nächste Textbuchkommando selektiert.
	Undo	Macht die letzte Änderung im Texteditor rückgängig.
	Redo	Stellt die letzte Änderung im Texteditor wieder her.
	Add	Öffnet einen Dialog zum einfügen neuer Textbuchkommandos.

Texteditor

Der Texteditor besitzt rudimentäre Funktionalitäten zum bearbeiten und formatieren von Texten im RTF-Format. Auf der linken Seite werden optional die Zeilennummern inklusive weiterer Informationen zu den Textbuchkommandos angezeigt. Ein roter Punkt signalisiert die aktuell selektierte Zeile. Für Cuelisten wird außerdem der Status (gestoppt - rotes Rechteck, pausiert - parallele blaue senkrechte Linien, läuft - grünes Dreieck) der Cuelist angezeigt. Durch doppelklick auf eine Zeilennummer wird die entsprechende Zeile für das Textbuch selektiert. Über einen Rechtsklick auf ein angelegtes Kommando im Texteditor kann über ein Kontextmenü eine schnelleditierung erfolgen.

Abbildung 3: Texteditor des Textbuch Plugins.

Drag 'n' Drop Bereich

Zum schnellen anlegen von Textbuchkommandos existiert auf der linken Fensterseite ein Drag 'n' Drop Bereich, in welchem eine Liste der Cuelists, eine Liste mit den Cues einer Cuelist, sowie einer Liste mit für das Textbuch angelegte Sources im Inputassignment untergebracht sind. Die Standardaktionen für die Kommandos sind:

* Cuelist -> Start
* Cue -> GoNext
* Inputassignment -> Quelle im Inputassignment auf "True" setzen

Bedien- und Statusleiste

Die Bedien- und Statusleiste umfasst eine Fortschrittsanzeige, Buttons für den Sprung zum nächsten beziehungsweise zum vorhergehenden Objekt sowie die Buttons "Go" und "Autoscroll". Zur einbindung des Textbuches in Softdesks oder zum anlegen von Shortcuts sind die Buttons der Bedienleiste auch über das Inputassignment ansteuerbar und können zum Beispiel mit externen Befehlsgebern oder Tasten verknüpft werden.

Abbildung 4: Status- und Bedienleiste des Textbuch Plugins

Je nach Einstellung wird mit "Go" zum nächsten Kommando oder zur nächsten Zeile gesprungen. Ebenso verhalten sich die Buttons "Back" und "Next", wobei hier die entsprechenden Kommandos nicht ausgeführt werden. Sind die Optionen "scroll to next Item after Go" und "next Command after Go" kann mit der Option "Autoscroll" sanft zwischen den entsprechenden Zeilen gescrollt werden. Die Zeit, zum überblenden zwischen den Zeilen wird über den Parameter "Delta-t" des nachfolgenden Kommandos eingestellt.

Befehlsliste

Abbildung 5: Liste der Textbuch Kommandos.

Nutzung

Textbuch anlegen

Die Textbücher werden komplett im Projektfile von DMXControl gespeichert. Da das Textbuch aktuell ein reines GUI-Plugin ist, werden die Textbücher rein von der GUI verarbeitet. Ein bearbeiten der Textbücher im betrieb mit mehreren Clients ist deshalb nicht möglich. Das zeitgleiche nutzen von Textbüchern ist jedoch möglich. Die Textbücher werden über den Projektexplorer verwaltet. Hier sollte eine neue Rubrik mit dem Namen "Textbook" vorhanden sein. Per Rechtsklick auf den Eintrag und "Create Textbook" kann ein neues Textbuch erstellt und mit doppelklick darauf geöffnet werden.

Externe Ansteuerung