Aktuelle Version vom 17. Mai 2026, 18:25 Uhr

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: 20 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 essentiell 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 unter folgendem heruntergeladen werden. Im Installationsverzeichnis von DMXControl 3 müssen die beiden Ordner Textbook und api-dlls 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.

Bedienelemente

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

Abbildung 2: 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.
	Sytles	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 ein 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. Über einen Rechtsklick auf ein angelegtes Command im Texteditor kann über ein Kontextmenü zwischen "GO", "GOTO" und "GONEXT" ausgewählt werden.

Abbildung 3: Texteditor des Textbuch Plugins.

Drag & Drop-Bereich

Zum schnellen 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 Szenelisten sind alphabetisch sortiert. Über das Suchfeld können die angezeigten Einträge eingegrenzt werden.

Options-Fenster

Das Fenster teilt sich auf 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ügter Textzeile zugewiesen.

Desweiterem 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 werden, 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. Das zeitgleiche Nutzen von Textbüchern 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.

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.

Soll die Einblendzeit der entsprechenden Szene als Einblendzeit genutzt werden, wenn man diese direkt aufgeruft (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. Da das Go-To-Kommando des Textbuches eigentlich auf dem "Go next" Kommando von DMXControl 3 beruht, sollten in der Szenenliste im Bereich der "Go next behaviour" die Optionen "Start cuelist" auf "True" und "Always use next index" auf "False" stehen.

Eingangszuweisung

Je verwendetem Textbuch in einem Projekt kann eine beliebige Anzahl von Eingangsquellen angelegt werden. Diese erscheinen in der Eingangszuweisung unter dem Verzeichnis Textbuch sowie einem dem Namen des Textbuches entsprechenden Unterordner. Die Quellen sind immer vom Typ "Bool" und liefern somit den Wert "True" oder "False" zurück. Für jedes Eingangszuweisungs-Kommando im Textbuch ist einstellbar, ob die entsprechende Variable bei Betätigung auf "True" oder "False" gesetzt werden soll. Eine Einblendzeit wird für Eingangszuweisung-Kommandos nicht angezeigt, da die Aktion unmittelbar erfolgt.

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

@@ Zeile 28: / Zeile 28: @@
 = Bedienelemente =
 Nach öffnen des Textbuches sollte sich ein Fenster gemäß untenstehender Abbildung öffnen.
-{{Bild mit Unterschrift|Textbook Übersicht.jpg|2|Das Textbuch-Plugin in der Übersicht|800px}}
+{{Bild mit Unterschrift|Textbook Übersicht.jpg|2|Das Textbuch-Plugin in der Übersicht|center|800px}}
 Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
 # Menüleiste
@@ Zeile 34: / Zeile 34: @@
 # {{DnD}}-Bereich
 # Go und Go-Back
+# Options-Fenster
 == Menüleiste ==
 Die Menüleiste beinhaltet allgemeine Funktionen zum Speichern und Bearbeiten des Textbuch-Verhaltens.
-{{Bild_mit_Unterschrift|Textbuch - Menüleiste.png|2|Menüleiste des Textbuch Plugins.|center|400px}}
+{{Bild_mit_Unterschrift|Textbook Menüleiste.jpg|2|Menüleiste des Textbuch Plugins.|center|800px}}
 {| class="wikitable"
@@ Zeile 44: / Zeile 44: @@
 ! style="width: 75px;" | Icon !! style="width: 175px;" | Bezeichnung !! Beschreibung / Funktionsweise
 |-
-| style="text-align:center;" | [[Bild:DMXC3_Icon_V-Collection_save_as.png]] || Save|| Die Änderungen im Textbuch werden in der Projektstruktur gespeichert.
+| style="text-align:center;" | [[Bild:Tectbook_Import.jpg]] || Import file|| Externe Textdateien (*.txt, *.rtf) werden in den Texteditor des Textbuches importiert.
 |-
-| style="text-align:center;" | || Import file || Externe Textdateien (*.txt, *.rtf) werden in den Texteditor des Textbuches importiert.
+| style="text-align:center;" | [[Bild:Textbook_Font.jpg]] || Text Font || Auswahl der Schriftart für die aktuell selektierte Zeile.
 |-
-| style="text-align:center;" | || 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ßenteils als versteckter Text gespeichert).
+| style="text-align:center;" | [[Bild:Textbook_Bold.jpg]] || Bold || Ändert die Schrift der aktuell ausgewählten Zeile auf "Fett".
 |-
-| style="text-align:center;" | || Show drag-drop panel || Blendet das Steuerelement zum erstellen von Textbuchbefehlen per Drag and Drop ein/aus.
+| style="text-align:center;" | [[Bild:Textbook_Italic.jpg]] || Italic || Ändert die Schrift der aktuell ausgewählten Zeile auf "Kursiv"
 |-
-| style="text-align:center;" | || Show ruler || Blendet das Lineal im Texteditor ein/aus.
+| style="text-align:center;" | [[Bild:Textbook_Textsize.jpg]] || Textsize || Vergrößert/Verkleinert den Text der aktuell ausgewählten Zeile.
 |-
-| style="text-align:center;" | || Show commandbox || Blendet die Tabelle mit den vorhandenen Textbuchkommandos ein/aus.
+| style="text-align:center;" | [[Bild:Textbook_Aligment.jpg]] || Aligment || Ändert die Ausrichtung der aktuell ausgewählten Zeile.
 |-
-| style="text-align:center;" | || Show linenumbers || Blendet die Zeilennummerierung im Texteditor ein/aus.
+| style="text-align:center;" | [[Bild:Textbook_Textcolor.jpg]]|| Textcolor || Auswahl der Text- und Zeilenfarbe für die aktuell ausgewählte Zeile.
 |-
-| style="text-align:center;" | || Scroll to next item after go || Nach dem Ausführen eines Kommandos mit "Go" wird zum nächsten Element gescrollt.
+| style="text-align:center;" | [[Bild:Textbook_Styles.jpg]] || Sytles || Auswahl eines von 8 vordefinierten Styles für die aktuell ausgewählte Zeile. Ein ausgewählter Style ist orange umrandet.
 |-
-| style="text-align:center;" | || Next line after go || Nach dem Ausführen eines Kommandos mit "Go" wird die nächsten Zeile im Textbuch selektiert.
+| style="text-align:center;" | [[Bild:Textbook_Options.jpg]] || Options || Öffnet das Fenster zur Einstellung der Styles und Settings.
 |-
-| style="text-align:center;" | || Next command after go || Nach dem Ausführen eines Kommandos mit "Go" wird das nächste Textbuchkommando selektiert.
+| style="text-align:center;" | [[Bild:Textbook_Resetbuttonactive.jpg]] || Reset Textbook || Setzt das Textbuch zurück, beim nächsten Go startet der Ablauf wieder in Zeile 1.
-|-
-| style="text-align:center;" | [[Bild:DMXC3_Icon_V-Collection_undo.png]] || Undo || Macht die letzte Änderung im Texteditor rückgängig.
-|-
-| style="text-align:center;" | [[Bild:DMXC3_Icon_V-Collection_redo.png]] || Redo || Stellt die letzte Änderung im Texteditor wieder her.
-|-
-| style="text-align:center;" | [[Bild:DMXC3_Icon_V-Collection_add.png]] || 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 {{Manual Windowcaption|[[Cuelist DMXC3|Szenenlisten (Cuelists)]]}} wird außerdem der Status (gestoppt - rotes Rechteck, pausiert - parallele blaue senkrechte Linien, läuft - grünes Dreieck) der Szenenliste 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.
+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.
-{{Bild_mit_Unterschrift|Textbuch - Texteditor.png|3|Texteditor des Textbuch Plugins.|center|800px}}
+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 ein 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. Über einen Rechtsklick auf ein angelegtes Command im Texteditor kann über ein Kontextmenü zwischen "GO", "GOTO" und "GONEXT" ausgewählt werden.
+{{Bild_mit_Unterschrift|Textbook_Texteditor.jpg|3|Texteditor des Textbuch Plugins.|center|800px}}
 == {{DnD}}-Bereich ==
-Zum schnellen anlegen von Textbuchkommandos existiert auf der linken Fensterseite ein {{DnD}}-Bereich, in welchem eine Liste der Szenenlisten, eine Liste mit den Szenen (Cues) einer Szenenliste, sowie einer Liste mit für das Textbuch angelegte Sources in der {{Manual Windowcaption|[[Input Assignment DMXC3|Eingangszuweisung (Input Assignment)]]}} untergebracht sind.
+Zum schnellen anlegen von Textbuchkommandos existiert auf der linken Fensterseite ein {{DnD}}-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.
-Die Standardaktionen für die Kommandos sind:
-* Szenenliste-> Start
+{{Bild_mit_Unterschrift|Textbook_DaD.jpg|4|Drag&Drop Bereich des Textbuch Plugins.|center}}
-* Szene -> GoNext
-* Eingangszuweisung -> Quelle im Eingangszuweisung auf "True" setzen
+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 Szenelisten sind alphabetisch sortiert. Über das Suchfeld können die angezeigten Einträge eingegrenzt werden.
+== Options-Fenster ==
+Das Fenster teilt sich auf 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 {{DnD}} hinzugefügtem Command zugewiesen, der "Default" Style hingegen wird jeder neu hinzugefügter Textzeile zugewiesen.
+Desweiterem gibt es 2 Optionen:
-== Bedien- und Statusleiste ==
+"Scroll Offset" legt fest wie viele Textzeilen, nach dem Ausführen eines "GO", oberhalb der aktuell aktiven Zeile dargestellt werden sollen.
-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 {{Manual Windowcaption|[[Softdesk DMXC3|Softdesks]]}} oder zum Anlegen von Shortcuts sind die Buttons der Bedienleiste auch über die Eingangszuweisung ansteuerbar und können zum Beispiel mit externen Befehlsgebern oder Tasten verknüpft werden.
-{{Bild_mit_Unterschrift|Textbuch - Status und Bedienleiste.png|4|Status- und Bedienleiste des Textbuch Plugins|center|800px}}
-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.
+Über "Default Cue Behavior" wird eingestellt ob beim hinzufügen eines neuen Commands automatisch ein Haken bei "Wait" gesetzt werden soll.
-== Befehlsliste ==
+Schließlich kann über "Run Test" geprüft werden ob alle im Textbuch verknüpften Szenenlisten und Szenen im Projekt vorhanden werden, diese werden allerdings auch im Texteditor mit einer rot-hinterlegten Zeilennummer dargestellt.
-In der Befehlsliste werden die Kommandos mit weiteren Informationen zusammengefasst und können editiert werden.
-{{Bild_mit_Unterschrift|Textbuch - Commandlist.png|5|Liste der Textbuch Kommandos.|center|800px}}
+{{Bild_mit_Unterschrift|Textbook_Optionswindow.jpg|5|Options-Fenster des Textbuch Plugins.|center|800px}}
-Die Spalten haben folgende Bedeutung:
-* En - (Enable) das entsprechende Kommando ist aktiviert / deaktiviert
-* Title - Frei konfigurierbarer Name für das Kommando, dieser wird auch im Texteditor angezeigt
-* Run - Button zum ausführen des Befehls, ohne die entsprechende Zeile selektieren (Button funktioniert, ist jedoch in aktueller Version nicht sichtbar)
-* Typ - Typ des Kommandos (aktuell nur Szenenliste oder Eingangszuweisung)
-* Edit - Button zum aufrufen eines Kommandoeditors (Button funktioniert, ist jedoch in aktueller Version nicht sichtbar)
-* Line - Gibt die Zeile an, in welchem das entsprechende Kommando zu finden ist
-* Delta-t - Zeitspanne zum Scrollen zwischen zwei Kommandos im Modus "Autoscroll" (in Millisekunden)
-* Stichwort - Möglichkeit zum Hinterlegen von Stichwörtern als Info für den Operator
-* Kommentar - Ermöglicht verschiedene Kommentare zu hinterlegen
-* Einblendzeit - Besitzt die Aktion eine Einblendzeit, wird diese hier angezeigt. Durch Doppelklick wird in ein Fenster gesprungen, in welchem diese bearbeitet werden kann, mehr dazu in den entsprechenden Kapiteln der Kommandos.
 = Nutzung =