Diese Seite behandelt das (zukünftig verfügbare) neue Textbuch-Plugin. Das bis zur DMXC Version 3.2.2. funktionierende Plugin findet ihr hier.

Dieser Artikel oder Abschnitt wird gerade durch den User Mkohl bearbeitet. Um Bearbeitungskonflikte zu vermeiden, warte bitte mit Änderungen, bis diese Markierung entfernt ist, oder wende dich an den Bearbeiter.

Seite zuletzt bearbeitet von Mkohl vor: 211 Stunden

Textbuch
Aktuelle Version	0.9
Status	beta
Funktioniert mit	3.3.2
Programmiersprache	C#
Deutschsprachig	nein
Homepage	http://www.dmxcontrol.de

Beschreibung

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

Installation

Das Textbuch-Plugin kann im DMXControl-Forum heruntergeladen werden. Im Installationsverzeichnis von DMXControl 3 müssen die beiden Ordner Textbook und api-dlls in das Unterverzeichnis GUI / Plugins verschoben werden. Nach einem Neustart von DMXControl 3 im « Plugin Management » der Eintrag « Textbook Plugin » vorhanden sein. Nach dem 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 werden.

Bedienelemente

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

Abbildung 1: Das Textbuch-Plugin in der Übersicht

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

Menüleiste
Texteditor
Drag & Drop-Bereich
Go und Go-Back
Options-Fenster

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
	Import file	Externe Textdateien (.txt, .rtf) werden in den Texteditor des Textbuches importiert.
	Text Font	Auswahl der Schriftart für die aktuell selektierte Zeile.
	Bold	Ändert die Schrift der aktuell ausgewählten Zeile auf "Fett".
	Italic	Ändert die Schrift der aktuell ausgewählten Zeile auf "Kursiv"
	Textsize	Vergrößert/Verkleinert den Text der aktuell ausgewählten Zeile.
	Aligment	Ändert die Ausrichtung der aktuell ausgewählten Zeile.
	Textcolor	Auswahl der Text- und Zeilenfarbe für die aktuell ausgewählte Zeile.
	Styles	Auswahl eines von 8 vordefinierten Styles für die aktuell ausgewählte Zeile. Ein ausgewählter Style ist orange umrandet.
	Options	Öffnet das Fenster zur Einstellung der Styles und Settings.
	Reset Textbook	Setzt das Textbuch zurück, beim nächsten Go startet der Ablauf wieder in Zeile 1.

Texteditor

Der Texteditor besitzt rudimentäre Funktionalitäten zum Bearbeiten und Formatieren von Texten. Die Textformatierung ist immer nur für die ganze Zeile möglich, es können nicht nur einzelne Teile einer Zeile anders formatiert werden. Auf der linken Seite werden Zeilennummern inklusive weiterer Informationen zu der Zeile angezeigt. Ein roter Punkt signalisiert die aktuell selektierte Zeile, ein grüner Punkt signalisiert ein mit der Zeile verknüpftes Command. Für Zeilen mit Commands wird zusätzlich in der Spalte Wait eine Checkbox angezeigt. Ist diese selektiert, wird bei "GO" nach Ausführung dieser Zeile gewartet. Durch Doppelklick auf eine Zeile in diesem linken Bereich wird die entsprechende Zeile für das Textbuch selektiert und beim nächsten "GO" ab dieser Zeile ausgeführt.

Abbildung 3: Texteditor des Textbuch Plugins.

Über einen Klick auf « Import » kann ein vorhandenes Textdokument geladen werden. Es können sowohl reine Textdokumente (*.txt) als auch formatierte Dokumente (*.rtf, *.docx) importiert werden. Da das Textbuch-Plugin die Textformatierung nur zeilenweise unterstützt, wird jeweils die Formatierung des ersten Zeichens einer Zeile übernommen. Die weitere Textbearbeitung erfolgt ähnlich wie in gängigen Texteditoren. Allerdings kann Text nur zeilenweise markiert werden. Sollen ganze Zeilen per Copy & Paste bearbeitet werden so werden diese Zeilen im Bereich links des Textes markiert und anschließend über das Kontextmenü oder die gängigen Tastenkürzel kopiert/ausgeschnitten/eingefügt werden. Zusätzlich ist ein verschieben mittels Drag & Drop möglich.

Abbildung 3: Kontextmenü nach zeilenweiser Markierung.

Wird das Kontextmenü über einen Klick auf einen Text aufgerufen, ergeben sich weitere Optionen: Zum einen steht Copy & Paste für den markierten Text zur Verfügung, zum anderen kann, erfolgt der Klick auf eine Zeile mit hinterlegtem Command, ausgewählt werden, ob die verknüpfte Szenenliste/Szene mit « GO/GOTO », « GONEXT » oder « STOP » aufgerufen werden soll.

Abbildung 3: Kontextmenü nach zeilenweiser Markierung.

Drag & Drop-Bereich

Zum Anlegen von Textbuchkommandos existiert auf der linken Fensterseite ein Drag & Drop-Bereich, in welchem eine Liste der Szenenlisten, eine Liste mit den Szenen einer Szenenliste, eine Liste mit Pausen sowie einer Liste mit Favoriten untergebracht sind.

Abbildung 4: Drag&Drop Bereich des Textbuch Plugins.

Neben jeder Szenenliste/Szene gibt es zwei Schaltflächen, über diese kann die jeweils hinterlegte Szenenliste zu Testzwecken gestartet und gestoppt werden, zusätzlich kann der Eintrag auch über Doppelklick gestartet werden.

Über die Schaltflächen "Cuelists", "Cues" und "Pause" kann zwischen den verschiedenen Arten der Commands ausgewählt werden. Im Bereich "Cues" werden, nach der Auswahl einer Szenenliste im Dropdown, alle Szenen in ihrer Reihenfolge dargestellt, die Szenenlisten sind alphabetisch sortiert. Über das Suchfeld können die angezeigten Einträge eingegrenzt werden.

Um eine Szenenliste, Szene oder Pause zu den Favoriten hinzuzufügen, kann das entsprechende Element entweder per Drag & Drop oder per Rechtsklick zu den Favoriten hinzugefügt werden.

Abbildung 5: Kontextmenü einer Szenenliste.

Favoriten können innerhalb der Liste ebenfalls per Drag & Drop sortiert werden. Ein Favorit kann per "Entfernen"-Tastendruck oder das Kontextmenü wieder entfernt werden. Ebenfalls über das Kontextmenü können Favoriten für die Benennung innerhalb des Textbuchs umbenannt werden. Wird ein umbenannter Favorit in das Textbuch hinzugefügt werden sowohl der Original als auch der neue Display-Name im Command angezeigt. Es können auch mehrere Favoriten gleichzeitig in das Textbuch gezogen werden, Entscheidend für die Reihenfolge des Hinzufügens ist die Reihenfolge der Auswahl. Diese wird mit kleinen Zahlen links neben dem Namen des Favoriten dargestellt.

Abbildung 6: Kontextmenü eines Favoriten.

Abbildung 7: Command, erstellt aus umbenanntem Favoritem.

Mit Hilfe der Pfeile am rechten Rand des Drag & Drop-Bereichs kann dieser ein- und ausgeklappt werden, ist der Bereich ausgeblendet ist auch die gesamte Bearbeitung im Texteditor gesperrt. Dies eignet sich besonders dazu, um das Textbuch im Showbetrieb gegen ungewollte Änderungen abzusichern.

Options-Fenster

Das Fenster unterteilt sich in die Einstellungen der Text-Styles und die Optionen.

Für die 8 Styles können individuell die Ausrichtung, Schriftart, Textgröße, Textschnitt sowie Text- und Hintergrundfarbe vorgewählt werden. Die ersten 2 Styles sind fest benannt, alle anderen Styles können frei benannt werden. Der "Command" Style wird automatisch jedem per Drag & Drop hinzugefügtem Command zugewiesen, der "Default" Style hingegen wird jeder neu hinzugefügten Textzeile zugewiesen.

Des Weiteren gibt es 2 Optionen:

"Scroll Offset" legt fest wie viele Textzeilen, nach dem Ausführen eines "GO", oberhalb der aktuell aktiven Zeile dargestellt werden sollen.

Über "Default Cue Behavior" wird eingestellt, ob beim Hinzufügen eines neuen Commands automatisch ein Haken bei "Wait" gesetzt werden soll.

Schließlich kann über "Run Test" geprüft werden, ob alle im Textbuch verknüpften Szenenlisten und Szenen im Projekt vorhanden sind, diese werden allerdings auch im Texteditor mit einer rot-hinterlegten Zeilennummer dargestellt.

Abbildung 5: Options-Fenster des Textbuch Plugins.

Nutzung

Im Folgenden soll die Nutzung des Textbuches erläutert werden.

Textbuch anlegen

Die Textbücher werden komplett in der Projektdatei von DMXControl 3 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. Die gleichzeitige Nutzung mehrerer Textbücher ist jedoch möglich. Die Textbücher werden über den Projektexplorer (Project Explorer) verwaltet. Hier sollte eine neue Rubrik mit dem Namen Textbook vorhanden sein. Per Rechtsklick auf den Eintrag und « Textbuch erstellen (Create textbook) » kann ein neues Textbuch erstellt und mit Doppelklick darauf geöffnet werden. Das Sortieren in Ordnern ist auf Grund eines Bugs derzeit nicht möglich bzw in Ordnern gespeicherte Textbücher sind beim nächsten Laden des Projektes wieder im Stammordner.

Szenenlisten und Szenen

Für die Einblendzeit wird die in DMXControl 3 definierte Zeit zum Einblenden der Aktion aufgeführt. Werden Szenenlisten gestartet bzw. gestoppt, wird die Einblendzeit (Fade time) bzw. Freigabezeit (Release time) einer Szenenliste als Einblendzeit angezeigt. Wird Gehe zu (Go to) verwendet, wird die "Go to Time" der Szenenlisten angezeigt. Für einzelne Szenen kann zwischen GoTo und GoNext gewählt werden. GoTo löst nur die ausgewählte Szene aus, bei GoNext läuft die Szenenliste ab der gestarteten Szene mit den definierten Triggern weiter.

Soll die Einblendzeit der entsprechenden Szene als Einblendzeit genutzt werden, wenn man diese direkt aufruft (zum Beispiel weil bestimmte Szenen spontan übersprungen werden) , so muss in der Szenenliste die Option "Use Cue Time as GoTo Time" auf "True" gesetzt werden.

Eingangszuweisung

In der Eingangszuweisung können, für alle Textbücher gemeinsam, die Funktionen Go, GoBack, Stop, das Scrollen und alle Styles zugewiesen werden.

Bekannte Bugs / Features

Ein Betätigen der Leertaste kann bei Selektion der Befehlsliste zum Absturz der GUI führen
Buttons in der Befehlsliste werden nicht angezeigt
Sortieren von Textbüchern in Ordner ist nicht möglich (wird nicht gespeichert)
Commandstatus rechts neben den Zeilennummern werden nicht immer aktualisiert