Deutsches DMXC-Wiki - Benutzerbeiträge [de]

Textbook Plugin DMXC3

2026-06-16T17:37:53Z

Mkohl: /* Bekannte Bugs / Features */

{{Manual Header
| Type = DMXC3 Plugins
| Version = 3.3.2}}

{{Manual Box | de | Important | Diese Seite behandelt das im Jahr 2025 / 2026 neu entwickelte Textbuch-Plugin. Die Vorgängerversion, die bis einschließlich DMXControl 3.2.2 genutzt werden kann, ist im Artikel {{Manual Windowcaption|[[Textbook Plugin DMXC3 Alt|Textbook Plugin DMXC3 Alt]]}} zu finden.}}

{{Infobox Plugin
| Name = Textbuch
| Logo =
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 1.0.0
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz =
| Deutsch = nein
| Email =
| Homepage = http://www.dmxcontrol.de
| Download =
}}

Beim Textbuch handelt um eine Funktion in DMXControl 3, welche speziell für (nahezu) feste Programmabläufe bei einer Veranstaltung jeglicher Art konzipiert ist. Dies können sein:
* Theateraufführungen
* Musicalveranstaltungen
* Konzerte
* Tagungen
* Multimediale Vorträge

Allen Veranstaltungen liegt dabei ein Skript, Drehbuch, detaillierter Programmablauf oder eben das so genannte Textbuch zu Grunde. Verfolgt man während der Show das zugehörige Textbuch, können so die gewünschten Lichtstimmungen und Effekte in DMXControl 3 passgenau auf Zeitpunkte oder Stichwörter eingetaktet werden. Dies ist vor allem dann hilfreich, wenn die exakte Zeitabfolge nicht genau sichergestellt werden kann.

= Installation =
Das Textbuch-Plugin kann im DMXControl-Forum heruntergeladen werden. Der Inhalt des Zip-Archivs muss entpackt und die Verwendung der DLLs auf dem PC zugelassen werden. Anschließend werden beide Ordner in das folgende Verzeichnis verschoben:

{{Manual Filepath|'''{INSTALLATIONSVERZEICHNIS}'''\GUI\Plugins\}}

Nach einem Neustart von DMXControl 3 steht im {{Manual MenuText|Plugin Management}} der Eintrag {{Manual MenuText|Textbook Plugin}} zur Verfügung. Nach dem Aktivieren des Eintrags erscheint das Textbuch unter anderem im Projekt-Explorer.

= Bedienelemente =
Nach öffnen des Textbuches öffnet sich ein Fenster gemäß untenstehender Abbildung.
{{Bild mit Unterschrift|Textbook Übersicht.jpg|1|Das Textbuch-Plugin in der Übersicht|center|800px}}
Das Fenster gliedert sich dabei in folgende Bereiche:
# Menüleiste
# Texteditor
# {{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|Textbook Menüleiste.jpg|2|Menüleiste des Textbuch Plugins.|center|800px}}

{| class="wikitable"
|- class="hintergrundfarbe6"
! style="width: 75px;" | Icon !! style="width: 175px;" | Bezeichnung !! Beschreibung / Funktionsweise
|-
| style="text-align:center;" | [[Bild:Tectbook_Import.jpg]] || Import file|| Externe Textdateien (*.txt, *.rtf, *.docx) 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;" | [[Bild:Textbook_Bold.jpg]] || Bold || Ändert die Schrift der aktuell ausgewählten Zeile auf "Fett".
|-
| style="text-align:center;" | [[Bild:Textbook_Italic.jpg]] || Italic || Ändert die Schrift der aktuell ausgewählten Zeile auf "Kursiv"
|-
| style="text-align:center;" | [[Bild:Textbook_Textsize.jpg]] || Textsize || Vergrößert/Verkleinert den Text der aktuell ausgewählten Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Aligment.jpg]] || Aligment || Ändert die Ausrichtung der aktuell ausgewählten Zeile.
|-
| 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;" | [[Bild:Textbook_Styles.jpg]] || Styles || Auswahl eines von 8 vordefinierten Styles für die aktuell ausgewählte Zeile. Ein ausgewählter Style ist orange umrandet.
|-
| style="text-align:center;" | [[Bild:Textbook_Options.jpg]] || Options || Öffnet das Fenster zur Einstellung der Styles und Settings.
|-
| 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.
|}

== 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, zusammen mit einer roten Umrandung der Zeile, signalisiert die aktuell selektierte Zeile, ein grüner Punkt signalisiert ein mit der Zeile verknüpftes Befehls (Command). Für Zeilen mit einem Befehl 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 den linken Bereich einer Zeile wird diese für das Textbuch selektiert und beim nächsten "GO" ab dieser Position ausgeführt.
{{Bild_mit_Unterschrift|Textbook_Texteditor.jpg|3|Texteditor des Textbuch Plugins.|center|800px}}

Über einen Klick auf {{Manual MenuText |Import}} kann ein vorhandenes Textdokument geladen werden. Es können sowohl reine Textdokumente (*.txt) als auch formatierte Dokumente (*.rtf, *.docx) importiert werden. Der Import der drei Dateiformate unterscheidet sich deutlich.
*.txt: Es wird nur der reine Text eingelesen, das Dokument enthält keine Formatierung. Jede importierte Zeile wird dem Textbuch-Style "default" zugeordnet.
*.rtf: RTF-Dokumente enthalten eine Formatierung, diese wird beim Import übernommen. Da das Textbuch-Plugin die Textformatierung nur zeilenweise unterstützt, wird jeweils die Formatierung des ersten Zeichens einer Zeile übernommen. Die importierten Zeilen werden keinem Textbuch-Style zugeordnet.
*.docx: docx-Dokumente unterstützen eine umfangreiche Formatierung. Es gibt einen Standard-Style, dieser kann beim Import dem Textbuch-Style "Default" zugeordnet werden. Alle Zeilen des Dokuments, die diese Formatierung nutzen, werden automatisch dem Textbuch-Style "Default" zugeordnet. Nutzt das Dokument auch Formatvorlagen so können diese, so lange es noch nicht zugewiesene Textbuch-Styles gibt, einem solchen zugeordnet werden. Wurde zum Beispiel die Formatvorlage "Überschrift 1" bereits einem Textbuch-Style zugeordnet, so wird diese Zuordnung auch für folgende Importe im gleichen Projekt genutzt. Textzeilen, die weder auf einer Formatvorlage noch auf der Standard-Formatierung des Dokumentes basieren werden ohne Textbuch-Style importiert.

Zusätzlich besteht die Möglichkeit einer Zeile explizit einen Textbuch-Style zuzuweisen, dazu muss in der entsprechenden Zeile "[SX]", wobei X für den gewünschten Style steht, vor den Text geschrieben werden. Die Zählung beginnt bei 0, so steht z.B. [S1] für den "Default"-Style.

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 bzw. ausgeschnitten und wieder eingefügt werden. Zusätzlich ist ein verschieben mittels {{DnD}} möglich. Den Zeilen kann auch nachträglich einer der Styles zugewiesen werden. Dazu werden entweder mehrere Zeilen markiert oder eine Zeile editiert und dann in der Menüleiste der entsprechende Style ausgewählt. Der aktuell zugewiesen Style einer Zeile ist Orange umrandet.

{{Bild_mit_Unterschrift|Textbook_KontextmenüZeile.jpg|3|Kontextmenü nach zeilenweiser Markierung.|center|600px}}

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 bei Klick auf eine Zeile mit hinterlegtem Befehl ausgewählt werden, ob die verknüpfte Szenenliste / Szene mit {{Manual Fields |Go / Go to}}, {{Manual Fields |Go next}} oder {{Manual Fields |Stop}} aufgerufen werden soll.

{{Bild_mit_Unterschrift|Textbook_KontextmenüTextCommand.jpg|3|Kontextmenü nach zeilenweiser Markierung.|center|400px}}

== {{DnD}}-Bereich ==
Zum 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.

{{Bild_mit_Unterschrift|Textbook_DaD.jpg|4|Drag&Drop Bereich des Textbuch Plugins.|center}}

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 {{Manual Buttons |Cuelists}}, {{Manual Buttons |Cues}} und {{Manual Buttons |Pause}} kann zwischen den verschiedenen Arten der Befehle 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.

Eine Szenenliste, Szene oder Pause kann per {{DnD}} oder per Rechtsklick zu den Favoriten hinzugefügt werden.

{{Bild_mit_Unterschrift|Textbook_KontextAddFavorite.jpg|5|Kontextmenü einer Szenenliste.|center}}

Favoriten können innerhalb der Liste ebenfalls per {{DnD}} sortiert werden. Ein Favorit kann per {{Manual Keyboard |Entf}}-Taste 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 Befehl 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.

{{Bild_mit_Unterschrift|Textbook_KontextRemoveFavorite.jpg|6|Kontextmenü eines Favoriten.|center}}

{{Bild_mit_Unterschrift|Textbook_FavoriteUmbenannt.jpg|7|Command, erstellt aus umbenanntem Favoriten.|center}}

Mit Hilfe der Pfeile am rechten Rand des {{DnD}}-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 acht Styles können individuell die Ausrichtung, Schriftart, Textgröße, Textschnitt sowie Text- und Hintergrundfarbe vorgewählt werden. Die ersten zwei Styles sind fest benannt, alle anderen Styles können frei benannt werden. Der "Command" Style wird automatisch jedem per {{DnD}} hinzugefügtem Befehl zugewiesen, der "Default" Style hingegen wird jeder neu hinzugefügten Textzeile zugewiesen. Über den Button in der letzten Spalte kann ein Style wieder auf die Ursprungswerte gesetzt werden.

Des Weiteren gibt es zwei 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 Befehl 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.

{{Bild_mit_Unterschrift|Textbook_Optionswindow.jpg|5|Options-Fenster des Textbuch Plugins.|center|800px}}

= 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 allein 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 {{Manual Windowcaption|[[Project Explorer DMXC3|Projektexplorer (Project Explorer)]]}} verwaltet. Hier ist eine neue Rubrik mit dem Namen {{Manual Objectcaption|Textbook}} vorhanden. Per Rechtsklick auf den Eintrag und {{Manual MenuText|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 Go to und Go next gewählt werden:
* Go to löst nur die ausgewählte Szene aus
* Bei Go next 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 Go to time" auf {{Manual Fields|True}} gesetzt werden.

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

= Bekannte Bugs / Features =
* Sortieren von Textbüchern in Ordner ist nicht möglich (wird nicht gespeichert)
* Beim DocX Import werden die Schriftarten nicht immer richtig gesetzt

[[Kategorie: Plugins_DMXControl_3]]

2026-06-09T19:14:32Z

Mkohl: /* Installation */

{{Manual Box | de | Important | Diese Seite behandelt das (zukünftig verfügbare) neue Textbuch-Plugin. Das bis zur DMXC Version 3.2.2. funktionierende Plugin findet ihr {{Manual Windowcaption|[[Textbook_Plugin_DMXC3_Alt|hier]]}}.}}
{{Inuse}}

{{Infobox Plugin
| Name = Textbuch
| Logo =
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 0.9
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz =
| Deutsch = nein
| Email =
| Homepage = http://www.dmxcontrol.de
| Download =
}}

= 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 <Code> Textbook </code> und <Code> api-dlls </code>in das Unterverzeichnis <code>GUI / Plugins</code> verschoben werden. Nach einem Neustart von DMXControl 3 steht im {{Manual MenuText|Plugin Management}} der Eintrag {{Manual MenuText|Textbook Plugin}} zur Verfügung. 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.
{{Bild mit Unterschrift|Textbook Übersicht.jpg|1|Das Textbuch-Plugin in der Übersicht|center|800px}}
Das Fenster gliedert sich dabei in folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# {{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|Textbook Menüleiste.jpg|2|Menüleiste des Textbuch Plugins.|center|800px}}

{| class="wikitable"
|- class="hintergrundfarbe6"
! style="width: 75px;" | Icon !! style="width: 175px;" | Bezeichnung !! Beschreibung / Funktionsweise
|-
| 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;" | [[Bild:Textbook_Font.jpg]] || Text Font || Auswahl der Schriftart für die aktuell selektierte Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Bold.jpg]] || Bold || Ändert die Schrift der aktuell ausgewählten Zeile auf "Fett".
|-
| style="text-align:center;" | [[Bild:Textbook_Italic.jpg]] || Italic || Ändert die Schrift der aktuell ausgewählten Zeile auf "Kursiv"
|-
| style="text-align:center;" | [[Bild:Textbook_Textsize.jpg]] || Textsize || Vergrößert/Verkleinert den Text der aktuell ausgewählten Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Aligment.jpg]] || Aligment || Ändert die Ausrichtung der aktuell ausgewählten Zeile.
|-
| 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;" | [[Bild:Textbook_Styles.jpg]] || Styles || Auswahl eines von 8 vordefinierten Styles für die aktuell ausgewählte Zeile. Ein ausgewählter Style ist orange umrandet.
|-
| style="text-align:center;" | [[Bild:Textbook_Options.jpg]] || Options || Öffnet das Fenster zur Einstellung der Styles und Settings.
|-
| 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.
|}

== 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.
{{Bild_mit_Unterschrift|Textbook_Texteditor.jpg|3|Texteditor des Textbuch Plugins.|center|800px}}

Über einen Klick auf {{Manual MenuText |Import}} kann ein vorhandenes Textdokument geladen werden. Es können sowohl reine Textdokumente (*.txt) als auch formatierte Dokumente (*.rtf, *.docx) importiert werden. Der Import der 3 Dateiformate unterscheidet sich deutlich.
*.txt: Es wird nur der reine Text eingelesen, das Dokument enthält keine Formatierung. Jede importierte Zeile wird dem Textbuch-Style "default" zugeordnet.
*.rtf: RTF-Dokumente enthalten eine Formatierung, diese wird beim Import übernommen. Da das Textbuch-Plugin die Textformatierung nur zeilenweise unterstützt, wird jeweils die Formatierung des ersten Zeichens einer Zeile übernommen. Die importierten Zeilen werden keinem Textbuch-Style zugeordnet.
*.docx: Docx Dokumente unterstützen eine umfangreiche Formatierung. Es gibt einen Standard-Style, dieser kann beim Import dem Textbuch-Style "Default" zugeordnet werden. Alle Zeilen des Dokuments die diese Formatierung nutzen werden automatisch dem Textbuch-Style "Default" zugeordnet. Nutzt das Dokument auch Formatvorlagen so können diese, so lange es noch nicht zugewiesene Textbuch-Styles gibt, einem solchen zugeordnet werden. Wurde zB die Formatvorlage "Überschrift 1" bereits einem Textbuch-Style zugeordnet, so wird diese Zuordnung auch für folgende Importe im gleichen Projekt genutzt. Textzeilen die weder auf einer Formatvorlage noch auf der Standard-Formatierung des Dokumentes basieren werden ohne Textbuch-Style importiert.
Zusätzlich besteht die Möglichkeit einer Zeile explizit einen Textbuch-Style zuzuweisen, dazu muss in der entsprechenden Zeile "[SX]", wobei X für den gewünschten Style steht, vor den Text geschrieben werden. Die Zählung beginnt bei 0, so steht z.B. [S1] für den "Default"-Style.

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 {{DnD}} möglich. Den Zeilen kann auch nachträglich einer der Sytles zugewiesen werden. Dazu werden entweder mehrere Zeilen markiert oder eine Zeile editiert und dann in der Menüleiste der entsprechende Style ausgewählt. Der aktuell zugewiesen Style einer Zeile ist Orange umrandet.

{{Bild_mit_Unterschrift|Textbook_KontextmenüZeile.jpg|3|Kontextmenü nach zeilenweiser Markierung.|center|600px}}

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 {{Manual MenuText |GO/GOTO}}, {{Manual MenuText |GONEXT}} oder {{Manual MenuText |STOP}} aufgerufen werden soll.

{{Bild_mit_Unterschrift|Textbook_KontextmenüTextCommand.jpg|3|Kontextmenü nach zeilenweiser Markierung.|center|400px}}

== {{DnD}}-Bereich ==
Zum 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.

{{Bild_mit_Unterschrift|Textbook_DaD.jpg|4|Drag&Drop Bereich des Textbuch Plugins.|center}}

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 {{DnD}} oder per Rechtsklick zu den Favoriten hinzugefügt werden.

{{Bild_mit_Unterschrift|Textbook_KontextAddFavorite.jpg|5|Kontextmenü einer Szenenliste.|center}}

Favoriten können innerhalb der Liste ebenfalls per {{DnD}} 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.

{{Bild_mit_Unterschrift|Textbook_KontextRemoveFavorite.jpg|6|Kontextmenü eines Favoriten.|center}}

{{Bild_mit_Unterschrift|Textbook_FavoriteUmbenannt.jpg|7|Command, erstellt aus umbenanntem Favoritem.|center}}

Mit Hilfe der Pfeile am rechten Rand des {{DnD}}-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 {{DnD}} hinzugefügtem Command zugewiesen, der "Default" Style hingegen wird jeder neu hinzugefügten Textzeile zugewiesen. Über den Button in der letzten Spalte kann ein Style wieder auf die Ursprungswerte gesetzt werden.

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.

{{Bild_mit_Unterschrift|Textbook_Optionswindow.jpg|5|Options-Fenster des Textbuch Plugins.|center|800px}}

= 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 {{Manual Windowcaption|[[Project Explorer DMXC3|Projektexplorer (Project Explorer)]]}} verwaltet. Hier sollte eine neue Rubrik mit dem Namen {{Manual Objectcaption|Textbook}} vorhanden sein. Per Rechtsklick auf den Eintrag und {{Manual MenuText|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 =
* Sortieren von Textbüchern in Ordner ist nicht möglich (wird nicht gespeichert)

[[Kategorie: Plugins_DMXControl_3]]

2026-05-19T19:46:59Z

Mkohl:

Textbook Plugin DMXC3

2026-05-19T19:44:08Z

Mkohl: /* Texteditor */

{{Manual Box | de | Important | Diese Seite behandelt das (zukünftig verfügbare) neue Textbuch-Plugin. Das bis zur DMXC Version 3.2.2. funktionierende Plugin findet ihr {{Manual Windowcaption|[[Textbook_Plugin_DMXC3_Alt|hier]]}}.}}
{{Inuse}}

{{Infobox Plugin
| Name = Textbuch
| Logo =
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 0.9
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz =
| Deutsch = nein
| Email =
| Homepage = http://www.dmxcontrol.de
| Download =
}}

= 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 <Code> Textbook </code> und <Code> api-dlls </code>in das Unterverzeichnis <code>GUI / Plugins</code> verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im {{Manual MenuText|Plugin Management}} der Eintrag {{Manual MenuText|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.
{{Bild mit Unterschrift|Textbook Übersicht.jpg|1|Das Textbuch-Plugin in der Übersicht|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# {{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|Textbook Menüleiste.jpg|2|Menüleiste des Textbuch Plugins.|center|800px}}

{| class="wikitable"
|- class="hintergrundfarbe6"
! style="width: 75px;" | Icon !! style="width: 175px;" | Bezeichnung !! Beschreibung / Funktionsweise
|-
| 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;" | [[Bild:Textbook_Font.jpg]] || Text Font || Auswahl der Schriftart für die aktuell selektierte Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Bold.jpg]] || Bold || Ändert die Schrift der aktuell ausgewählten Zeile auf "Fett".
|-
| style="text-align:center;" | [[Bild:Textbook_Italic.jpg]] || Italic || Ändert die Schrift der aktuell ausgewählten Zeile auf "Kursiv"
|-
| style="text-align:center;" | [[Bild:Textbook_Textsize.jpg]] || Textsize || Vergrößert/Verkleinert den Text der aktuell ausgewählten Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Aligment.jpg]] || Aligment || Ändert die Ausrichtung der aktuell ausgewählten Zeile.
|-
| 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;" | [[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;" | [[Bild:Textbook_Options.jpg]] || Options || Öffnet das Fenster zur Einstellung der Styles und Settings.
|-
| 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.
|}

== 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.
{{Bild_mit_Unterschrift|Textbook_Texteditor.jpg|3|Texteditor des Textbuch Plugins.|center|800px}}

Über einen Klick auf {{Manual MenuText |Import}} kann ein vorhandenes Textdokument geladen werden. Es können sowohl reine Textdokumente (*.txt) als auch formatierte Dokumente (*.rtf, *.docx) importiert werden. Da das Textbuchplugin die Textformatierung nur zeilenweise beherrscht 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 Zeile 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 {{DnD}} möglich.

{{Bild_mit_Unterschrift|Textbook_KontextmenüZeile.jpg|3|Kontextmenü nach zeilenweiser Markierung.|center|600px}}

Wird das Kontextmenü über einen Klick auf einen Text aufgerufen ergeben sich weitere Optionen: Zum einen steht Copy&Paste für dem 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 {{Manual MenuText |GO/GOTO}}, {{Manual MenuText |GONEXT}} oder {{Manual MenuText |STOP}} aufgerufen werden soll.

== {{DnD}}-Bereich ==
Zum 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.

{{Bild_mit_Unterschrift|Textbook_DaD.jpg|4|Drag&Drop Bereich des Textbuch Plugins.|center}}

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 {{DnD}} oder per Rechtsklick zu den Favoriten hinzugefügt werden.

{{Bild_mit_Unterschrift|Textbook_KontextAddFavorite.jpg|5|Kontextmenü einer Szenenliste.|center}}

Favoriten können innerhalb der Liste ebenfalls per {{DnD}} 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.

{{Bild_mit_Unterschrift|Textbook_KontextRemoveFavorite.jpg|6|Kontextmenü eines Favoriten.|center}}

{{Bild_mit_Unterschrift|Textbook_FavoriteUmbenannt.jpg|7|Command, erstellt aus umbenanntem Favoritem.|center}}

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

== 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:

"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.

{{Bild_mit_Unterschrift|Textbook_Optionswindow.jpg|5|Options-Fenster des Textbuch Plugins.|center|800px}}

= 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 {{Manual Windowcaption|[[Project Explorer DMXC3|Projektexplorer (Project Explorer)]]}} verwaltet. Hier sollte eine neue Rubrik mit dem Namen {{Manual Objectcaption|Textbook}} vorhanden sein. Per Rechtsklick auf den Eintrag und {{Manual MenuText|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

[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2026-05-19T19:43:03Z

Mkohl: /* Texteditor */

{{Manual Box | de | Important | Diese Seite behandelt das (zukünftig verfügbare) neue Textbuch-Plugin. Das bis zur DMXC Version 3.2.2. funktionierende Plugin findet ihr {{Manual Windowcaption|[[Textbook_Plugin_DMXC3_Alt|hier]]}}.}}
{{Inuse}}

{{Infobox Plugin
| Name = Textbuch
| Logo =
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 0.9
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz =
| Deutsch = nein
| Email =
| Homepage = http://www.dmxcontrol.de
| Download =
}}

= 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 <Code> Textbook </code> und <Code> api-dlls </code>in das Unterverzeichnis <code>GUI / Plugins</code> verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im {{Manual MenuText|Plugin Management}} der Eintrag {{Manual MenuText|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.
{{Bild mit Unterschrift|Textbook Übersicht.jpg|1|Das Textbuch-Plugin in der Übersicht|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# {{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|Textbook Menüleiste.jpg|2|Menüleiste des Textbuch Plugins.|center|800px}}

{| class="wikitable"
|- class="hintergrundfarbe6"
! style="width: 75px;" | Icon !! style="width: 175px;" | Bezeichnung !! Beschreibung / Funktionsweise
|-
| 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;" | [[Bild:Textbook_Font.jpg]] || Text Font || Auswahl der Schriftart für die aktuell selektierte Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Bold.jpg]] || Bold || Ändert die Schrift der aktuell ausgewählten Zeile auf "Fett".
|-
| style="text-align:center;" | [[Bild:Textbook_Italic.jpg]] || Italic || Ändert die Schrift der aktuell ausgewählten Zeile auf "Kursiv"
|-
| style="text-align:center;" | [[Bild:Textbook_Textsize.jpg]] || Textsize || Vergrößert/Verkleinert den Text der aktuell ausgewählten Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Aligment.jpg]] || Aligment || Ändert die Ausrichtung der aktuell ausgewählten Zeile.
|-
| 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;" | [[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;" | [[Bild:Textbook_Options.jpg]] || Options || Öffnet das Fenster zur Einstellung der Styles und Settings.
|-
| 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.
|}

== 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.
{{Bild_mit_Unterschrift|Textbook_Texteditor.jpg|3|Texteditor des Textbuch Plugins.|center|800px}}

Über einen Klick auf {{Manual MenuText |Import}} kann ein vorhandenes Textdokument geladen werden. Es können sowohl reine Textdokumente (*.txt) als auch formatierte Dokumente (*.rtf, *.docx) importiert werden. Da das Textbuchplugin die Textformatierung nur zeilenweise beherrscht 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 Zeile 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 {{DnD}} möglich.

{{Bild_mit_Unterschrift|Textbook_KontextmenüZeile.jpg|3|Kontextmenü nach zeilenweiser Markierung.|center|600px}}

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

== {{DnD}}-Bereich ==
Zum 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.

{{Bild_mit_Unterschrift|Textbook_DaD.jpg|4|Drag&Drop Bereich des Textbuch Plugins.|center}}

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 {{DnD}} oder per Rechtsklick zu den Favoriten hinzugefügt werden.

{{Bild_mit_Unterschrift|Textbook_KontextAddFavorite.jpg|5|Kontextmenü einer Szenenliste.|center}}

Favoriten können innerhalb der Liste ebenfalls per {{DnD}} 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.

{{Bild_mit_Unterschrift|Textbook_KontextRemoveFavorite.jpg|6|Kontextmenü eines Favoriten.|center}}

{{Bild_mit_Unterschrift|Textbook_FavoriteUmbenannt.jpg|7|Command, erstellt aus umbenanntem Favoritem.|center}}

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

== 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:

"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.

{{Bild_mit_Unterschrift|Textbook_Optionswindow.jpg|5|Options-Fenster des Textbuch Plugins.|center|800px}}

= 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 {{Manual Windowcaption|[[Project Explorer DMXC3|Projektexplorer (Project Explorer)]]}} verwaltet. Hier sollte eine neue Rubrik mit dem Namen {{Manual Objectcaption|Textbook}} vorhanden sein. Per Rechtsklick auf den Eintrag und {{Manual MenuText|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

[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2026-05-19T19:39:11Z

Mkohl: /* Texteditor */

{{Manual Box | de | Important | Diese Seite behandelt das (zukünftig verfügbare) neue Textbuch-Plugin. Das bis zur DMXC Version 3.2.2. funktionierende Plugin findet ihr {{Manual Windowcaption|[[Textbook_Plugin_DMXC3_Alt|hier]]}}.}}
{{Inuse}}

{{Infobox Plugin
| Name = Textbuch
| Logo =
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 0.9
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz =
| Deutsch = nein
| Email =
| Homepage = http://www.dmxcontrol.de
| Download =
}}

= 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 <Code> Textbook </code> und <Code> api-dlls </code>in das Unterverzeichnis <code>GUI / Plugins</code> verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im {{Manual MenuText|Plugin Management}} der Eintrag {{Manual MenuText|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.
{{Bild mit Unterschrift|Textbook Übersicht.jpg|1|Das Textbuch-Plugin in der Übersicht|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# {{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|Textbook Menüleiste.jpg|2|Menüleiste des Textbuch Plugins.|center|800px}}

{| class="wikitable"
|- class="hintergrundfarbe6"
! style="width: 75px;" | Icon !! style="width: 175px;" | Bezeichnung !! Beschreibung / Funktionsweise
|-
| 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;" | [[Bild:Textbook_Font.jpg]] || Text Font || Auswahl der Schriftart für die aktuell selektierte Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Bold.jpg]] || Bold || Ändert die Schrift der aktuell ausgewählten Zeile auf "Fett".
|-
| style="text-align:center;" | [[Bild:Textbook_Italic.jpg]] || Italic || Ändert die Schrift der aktuell ausgewählten Zeile auf "Kursiv"
|-
| style="text-align:center;" | [[Bild:Textbook_Textsize.jpg]] || Textsize || Vergrößert/Verkleinert den Text der aktuell ausgewählten Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Aligment.jpg]] || Aligment || Ändert die Ausrichtung der aktuell ausgewählten Zeile.
|-
| 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;" | [[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;" | [[Bild:Textbook_Options.jpg]] || Options || Öffnet das Fenster zur Einstellung der Styles und Settings.
|-
| 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.
|}

== 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.
{{Bild_mit_Unterschrift|Textbook_Texteditor.jpg|3|Texteditor des Textbuch Plugins.|center|800px}}

Über einen Klick auf {{Manual MenuText |Import}} kann ein vorhandenes Textdokument geladen werden. Es können sowohl reine Textdokumente (*.txt) als auch formatierte Dokumente (*.rtf, *.docx) importiert werden. Da das Textbuchplugin die Textformatierung nur zeilenweise beherrscht 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 Zeile 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 {{DnD}} möglich.

{{Bild_mit_Unterschrift|Textbook_KontextmenüZeile.jpg|3|Kontextmenü nach zeilenweiser Markierung.|center|600px}}

== {{DnD}}-Bereich ==
Zum 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.

{{Bild_mit_Unterschrift|Textbook_DaD.jpg|4|Drag&Drop Bereich des Textbuch Plugins.|center}}

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 {{DnD}} oder per Rechtsklick zu den Favoriten hinzugefügt werden.

{{Bild_mit_Unterschrift|Textbook_KontextAddFavorite.jpg|5|Kontextmenü einer Szenenliste.|center}}

Favoriten können innerhalb der Liste ebenfalls per {{DnD}} 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.

{{Bild_mit_Unterschrift|Textbook_KontextRemoveFavorite.jpg|6|Kontextmenü eines Favoriten.|center}}

{{Bild_mit_Unterschrift|Textbook_FavoriteUmbenannt.jpg|7|Command, erstellt aus umbenanntem Favoritem.|center}}

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

== 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:

"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.

{{Bild_mit_Unterschrift|Textbook_Optionswindow.jpg|5|Options-Fenster des Textbuch Plugins.|center|800px}}

= 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 {{Manual Windowcaption|[[Project Explorer DMXC3|Projektexplorer (Project Explorer)]]}} verwaltet. Hier sollte eine neue Rubrik mit dem Namen {{Manual Objectcaption|Textbook}} vorhanden sein. Per Rechtsklick auf den Eintrag und {{Manual MenuText|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

[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2026-05-19T19:37:58Z

Mkohl: /* Texteditor */

{{Manual Box | de | Important | Diese Seite behandelt das (zukünftig verfügbare) neue Textbuch-Plugin. Das bis zur DMXC Version 3.2.2. funktionierende Plugin findet ihr {{Manual Windowcaption|[[Textbook_Plugin_DMXC3_Alt|hier]]}}.}}
{{Inuse}}

{{Infobox Plugin
| Name = Textbuch
| Logo =
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 0.9
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz =
| Deutsch = nein
| Email =
| Homepage = http://www.dmxcontrol.de
| Download =
}}

= 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 <Code> Textbook </code> und <Code> api-dlls </code>in das Unterverzeichnis <code>GUI / Plugins</code> verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im {{Manual MenuText|Plugin Management}} der Eintrag {{Manual MenuText|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.
{{Bild mit Unterschrift|Textbook Übersicht.jpg|1|Das Textbuch-Plugin in der Übersicht|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# {{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|Textbook Menüleiste.jpg|2|Menüleiste des Textbuch Plugins.|center|800px}}

{| class="wikitable"
|- class="hintergrundfarbe6"
! style="width: 75px;" | Icon !! style="width: 175px;" | Bezeichnung !! Beschreibung / Funktionsweise
|-
| 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;" | [[Bild:Textbook_Font.jpg]] || Text Font || Auswahl der Schriftart für die aktuell selektierte Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Bold.jpg]] || Bold || Ändert die Schrift der aktuell ausgewählten Zeile auf "Fett".
|-
| style="text-align:center;" | [[Bild:Textbook_Italic.jpg]] || Italic || Ändert die Schrift der aktuell ausgewählten Zeile auf "Kursiv"
|-
| style="text-align:center;" | [[Bild:Textbook_Textsize.jpg]] || Textsize || Vergrößert/Verkleinert den Text der aktuell ausgewählten Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Aligment.jpg]] || Aligment || Ändert die Ausrichtung der aktuell ausgewählten Zeile.
|-
| 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;" | [[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;" | [[Bild:Textbook_Options.jpg]] || Options || Öffnet das Fenster zur Einstellung der Styles und Settings.
|-
| 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.
|}

== 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.
{{Bild_mit_Unterschrift|Textbook_Texteditor.jpg|3|Texteditor des Textbuch Plugins.|center|800px}}

Über einen Klick auf {{Manual MenuText |Import}} kann ein vorhandenes Textdokument geladen werden. Es können sowohl reine Textdokumente (*.txt) als auch formatierte Dokumente (*.rtf, *.docx) importiert werden. Da das Textbuchplugin die Textformatierung nur zeilenweise beherrscht 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 Zeile 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 {{DnD}} möglich.

{{Bild_mit_Unterschrift|Textbook_KontextmenüZeile.jpg|3|Kontextmenü nach zeilenweiser Markierung.|center|800px}}

== {{DnD}}-Bereich ==
Zum 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.

{{Bild_mit_Unterschrift|Textbook_DaD.jpg|4|Drag&Drop Bereich des Textbuch Plugins.|center}}

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 {{DnD}} oder per Rechtsklick zu den Favoriten hinzugefügt werden.

{{Bild_mit_Unterschrift|Textbook_KontextAddFavorite.jpg|5|Kontextmenü einer Szenenliste.|center}}

Favoriten können innerhalb der Liste ebenfalls per {{DnD}} 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.

{{Bild_mit_Unterschrift|Textbook_KontextRemoveFavorite.jpg|6|Kontextmenü eines Favoriten.|center}}

{{Bild_mit_Unterschrift|Textbook_FavoriteUmbenannt.jpg|7|Command, erstellt aus umbenanntem Favoritem.|center}}

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

== 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:

"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.

{{Bild_mit_Unterschrift|Textbook_Optionswindow.jpg|5|Options-Fenster des Textbuch Plugins.|center|800px}}

= 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 {{Manual Windowcaption|[[Project Explorer DMXC3|Projektexplorer (Project Explorer)]]}} verwaltet. Hier sollte eine neue Rubrik mit dem Namen {{Manual Objectcaption|Textbook}} vorhanden sein. Per Rechtsklick auf den Eintrag und {{Manual MenuText|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

[[Kategorie: Plugins_DMXControl_3]]

Datei:Textbook KontextmenüZeile.jpg

2026-05-19T19:37:09Z

Mkohl:

2026-05-19T09:37:14Z

Mkohl: /* {{DnD}}-Bereich */

{{Inuse}}

{{Infobox Plugin
| Name = Textbuch
| Logo =
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 0.9
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz =
| Deutsch = nein
| Email =
| Homepage = http://www.dmxcontrol.de
| Download =
}}

= 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 <Code> Textbook </code> und <Code> api-dlls </code>in das Unterverzeichnis <code>GUI / Plugins</code> verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im {{Manual MenuText|Plugin Management}} der Eintrag {{Manual MenuText|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.
{{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
# Texteditor
# {{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|Textbook Menüleiste.jpg|2|Menüleiste des Textbuch Plugins.|center|800px}}

{| class="wikitable"
|- class="hintergrundfarbe6"
! style="width: 75px;" | Icon !! style="width: 175px;" | Bezeichnung !! Beschreibung / Funktionsweise
|-
| 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;" | [[Bild:Textbook_Font.jpg]] || Text Font || Auswahl der Schriftart für die aktuell selektierte Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Bold.jpg]] || Bold || Ändert die Schrift der aktuell ausgewählten Zeile auf "Fett".
|-
| style="text-align:center;" | [[Bild:Textbook_Italic.jpg]] || Italic || Ändert die Schrift der aktuell ausgewählten Zeile auf "Kursiv"
|-
| style="text-align:center;" | [[Bild:Textbook_Textsize.jpg]] || Textsize || Vergrößert/Verkleinert den Text der aktuell ausgewählten Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Aligment.jpg]] || Aligment || Ändert die Ausrichtung der aktuell ausgewählten Zeile.
|-
| 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;" | [[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;" | [[Bild:Textbook_Options.jpg]] || Options || Öffnet das Fenster zur Einstellung der Styles und Settings.
|-
| 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.
|}

== 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.
{{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 einer Szenenliste, eine Liste mit Pausen sowie einer Liste mit Favoriten untergebracht sind.

{{Bild_mit_Unterschrift|Textbook_DaD.jpg|4|Drag&Drop Bereich des Textbuch Plugins.|center}}

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 {{DnD}} oder per Rechtsklick zu den Favoriten hinzugefügt werden.

{{Bild_mit_Unterschrift|Textbook_KontextAddFavorite.jpg|5|Kontextmenü einer Szenenliste.|center}}

Favoriten können innerhalb der Liste ebenfalls per {{DnD}} 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.

{{Bild_mit_Unterschrift|Textbook_KontextRemoveFavorite.jpg|6|Kontextmenü eines Favoriten.|center}}

{{Bild_mit_Unterschrift|Textbook_FavoriteUmbenannt.jpg|7|Command, erstellt aus umbenanntem Favoritem.|center}}

== 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:

"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.

{{Bild_mit_Unterschrift|Textbook_Optionswindow.jpg|5|Options-Fenster des Textbuch Plugins.|center|800px}}

= 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 {{Manual Windowcaption|[[Project Explorer DMXC3|Projektexplorer (Project Explorer)]]}} verwaltet. Hier sollte eine neue Rubrik mit dem Namen {{Manual Objectcaption|Textbook}} vorhanden sein. Per Rechtsklick auf den Eintrag und {{Manual MenuText|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

[[Kategorie: Plugins_DMXControl_3]]

Datei:Textbook FavoriteUmbenannt.jpg

2026-05-19T09:36:45Z

Mkohl:

Datei:Textbook KontextRemoveFavorite.jpg

2026-05-19T09:33:45Z

Mkohl:

Datei:Textbook KontextAddFavorite.jpg

2026-05-19T09:17:35Z

Mkohl:

Textbook Plugin DMXC3

2026-05-17T16:25:30Z

Mkohl: /* {{DnD}}-Bereich */

{{Inuse}}

{{Infobox Plugin
| Name = Textbuch
| Logo =
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 0.9
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz =
| Deutsch = nein
| Email =
| Homepage = http://www.dmxcontrol.de
| Download =
}}

= 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 <Code> Textbook </code> und <Code> api-dlls </code>in das Unterverzeichnis <code>GUI / Plugins</code> verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im {{Manual MenuText|Plugin Management}} der Eintrag {{Manual MenuText|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.
{{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
# Texteditor
# {{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|Textbook Menüleiste.jpg|2|Menüleiste des Textbuch Plugins.|center|800px}}

{| class="wikitable"
|- class="hintergrundfarbe6"
! style="width: 75px;" | Icon !! style="width: 175px;" | Bezeichnung !! Beschreibung / Funktionsweise
|-
| 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;" | [[Bild:Textbook_Font.jpg]] || Text Font || Auswahl der Schriftart für die aktuell selektierte Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Bold.jpg]] || Bold || Ändert die Schrift der aktuell ausgewählten Zeile auf "Fett".
|-
| style="text-align:center;" | [[Bild:Textbook_Italic.jpg]] || Italic || Ändert die Schrift der aktuell ausgewählten Zeile auf "Kursiv"
|-
| style="text-align:center;" | [[Bild:Textbook_Textsize.jpg]] || Textsize || Vergrößert/Verkleinert den Text der aktuell ausgewählten Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Aligment.jpg]] || Aligment || Ändert die Ausrichtung der aktuell ausgewählten Zeile.
|-
| 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;" | [[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;" | [[Bild:Textbook_Options.jpg]] || Options || Öffnet das Fenster zur Einstellung der Styles und Settings.
|-
| 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.
|}

== 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.
{{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 einer Szenenliste, eine Liste mit Pausen sowie einer Liste mit Favoriten untergebracht sind.

{{Bild_mit_Unterschrift|Textbook_DaD.jpg|4|Drag&Drop Bereich des Textbuch Plugins.|center}}

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:

"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.

{{Bild_mit_Unterschrift|Textbook_Optionswindow.jpg|5|Options-Fenster des Textbuch Plugins.|center|800px}}

= 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 {{Manual Windowcaption|[[Project Explorer DMXC3|Projektexplorer (Project Explorer)]]}} verwaltet. Hier sollte eine neue Rubrik mit dem Namen {{Manual Objectcaption|Textbook}} vorhanden sein. Per Rechtsklick auf den Eintrag und {{Manual MenuText|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

[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2026-05-17T15:54:47Z

Mkohl:

{{Inuse}}

{{Infobox Plugin
| Name = Textbuch
| Logo =
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 0.9
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz =
| Deutsch = nein
| Email =
| Homepage = http://www.dmxcontrol.de
| Download =
}}

= 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 <Code> Textbook </code> und <Code> api-dlls </code>in das Unterverzeichnis <code>GUI / Plugins</code> verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im {{Manual MenuText|Plugin Management}} der Eintrag {{Manual MenuText|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.
{{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
# Texteditor
# {{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|Textbook Menüleiste.jpg|2|Menüleiste des Textbuch Plugins.|center|800px}}

{| class="wikitable"
|- class="hintergrundfarbe6"
! style="width: 75px;" | Icon !! style="width: 175px;" | Bezeichnung !! Beschreibung / Funktionsweise
|-
| 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;" | [[Bild:Textbook_Font.jpg]] || Text Font || Auswahl der Schriftart für die aktuell selektierte Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Bold.jpg]] || Bold || Ändert die Schrift der aktuell ausgewählten Zeile auf "Fett".
|-
| style="text-align:center;" | [[Bild:Textbook_Italic.jpg]] || Italic || Ändert die Schrift der aktuell ausgewählten Zeile auf "Kursiv"
|-
| style="text-align:center;" | [[Bild:Textbook_Textsize.jpg]] || Textsize || Vergrößert/Verkleinert den Text der aktuell ausgewählten Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Aligment.jpg]] || Aligment || Ändert die Ausrichtung der aktuell ausgewählten Zeile.
|-
| 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;" | [[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;" | [[Bild:Textbook_Options.jpg]] || Options || Öffnet das Fenster zur Einstellung der Styles und Settings.
|-
| 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.
|}

== 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.
{{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, eine Liste mit Pausen sowie einer Liste mit Favoriten untergebracht sind.

{{Bild_mit_Unterschrift|Textbook_DaD.jpg|4|Drag&Drop Bereich des Textbuch Plugins.|center}}

== 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:

"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.

{{Bild_mit_Unterschrift|Textbook_Optionswindow.jpg|5|Options-Fenster des Textbuch Plugins.|center|800px}}

= 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 {{Manual Windowcaption|[[Project Explorer DMXC3|Projektexplorer (Project Explorer)]]}} verwaltet. Hier sollte eine neue Rubrik mit dem Namen {{Manual Objectcaption|Textbook}} vorhanden sein. Per Rechtsklick auf den Eintrag und {{Manual MenuText|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

[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2026-05-17T15:30:02Z

Mkohl: /* Options-Fenster */

{{Inuse}}

{{Infobox Plugin
| Name = Textbuch
| Logo =
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 0.9
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz =
| Deutsch = nein
| Email =
| Homepage = http://www.dmxcontrol.de
| Download =
}}

= 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 <Code> Textbook </code> und <Code> api-dlls </code>in das Unterverzeichnis <code>GUI / Plugins</code> verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im {{Manual MenuText|Plugin Management}} der Eintrag {{Manual MenuText|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.
{{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
# Texteditor
# {{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|Textbook Menüleiste.jpg|2|Menüleiste des Textbuch Plugins.|center|800px}}

{| class="wikitable"
|- class="hintergrundfarbe6"
! style="width: 75px;" | Icon !! style="width: 175px;" | Bezeichnung !! Beschreibung / Funktionsweise
|-
| 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;" | [[Bild:Textbook_Font.jpg]] || Text Font || Auswahl der Schriftart für die aktuell selektierte Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Bold.jpg]] || Bold || Ändert die Schrift der aktuell ausgewählten Zeile auf "Fett".
|-
| style="text-align:center;" | [[Bild:Textbook_Italic.jpg]] || Italic || Ändert die Schrift der aktuell ausgewählten Zeile auf "Kursiv"
|-
| style="text-align:center;" | [[Bild:Textbook_Textsize.jpg]] || Textsize || Vergrößert/Verkleinert den Text der aktuell ausgewählten Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Aligment.jpg]] || Aligment || Ändert die Ausrichtung der aktuell ausgewählten Zeile.
|-
| 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;" | [[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;" | [[Bild:Textbook_Options.jpg]] || Options || Öffnet das Fenster zur Einstellung der Styles und Settings.
|-
| 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.
|}

== 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.
{{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, eine Liste mit Pausen sowie einer Liste mit Favoriten untergebracht sind.

{{Bild_mit_Unterschrift|Textbook_DaD.jpg|4|Drag&Drop Bereich des Textbuch Plugins.|center}}

== 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:

"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.

{{Bild_mit_Unterschrift|Textbook_Optionswindow.jpg|5|Options-Fenster des Textbuch Plugins.|center|800px}}

== Befehlsliste ==
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}}
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 =
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 {{Manual Windowcaption|[[Project Explorer DMXC3|Projektexplorer (Project Explorer)]]}} verwaltet. Hier sollte eine neue Rubrik mit dem Namen {{Manual Objectcaption|Textbook}} vorhanden sein. Per Rechtsklick auf den Eintrag und {{Manual MenuText|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

[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2026-05-17T15:23:09Z

Mkohl: /* Options-Fenster */

{{Inuse}}

{{Infobox Plugin
| Name = Textbuch
| Logo =
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 0.9
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz =
| Deutsch = nein
| Email =
| Homepage = http://www.dmxcontrol.de
| Download =
}}

= 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 <Code> Textbook </code> und <Code> api-dlls </code>in das Unterverzeichnis <code>GUI / Plugins</code> verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im {{Manual MenuText|Plugin Management}} der Eintrag {{Manual MenuText|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.
{{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
# Texteditor
# {{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|Textbook Menüleiste.jpg|2|Menüleiste des Textbuch Plugins.|center|800px}}

{| class="wikitable"
|- class="hintergrundfarbe6"
! style="width: 75px;" | Icon !! style="width: 175px;" | Bezeichnung !! Beschreibung / Funktionsweise
|-
| 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;" | [[Bild:Textbook_Font.jpg]] || Text Font || Auswahl der Schriftart für die aktuell selektierte Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Bold.jpg]] || Bold || Ändert die Schrift der aktuell ausgewählten Zeile auf "Fett".
|-
| style="text-align:center;" | [[Bild:Textbook_Italic.jpg]] || Italic || Ändert die Schrift der aktuell ausgewählten Zeile auf "Kursiv"
|-
| style="text-align:center;" | [[Bild:Textbook_Textsize.jpg]] || Textsize || Vergrößert/Verkleinert den Text der aktuell ausgewählten Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Aligment.jpg]] || Aligment || Ändert die Ausrichtung der aktuell ausgewählten Zeile.
|-
| 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;" | [[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;" | [[Bild:Textbook_Options.jpg]] || Options || Öffnet das Fenster zur Einstellung der Styles und Settings.
|-
| 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.
|}

== 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.
{{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, eine Liste mit Pausen sowie einer Liste mit Favoriten untergebracht sind.

{{Bild_mit_Unterschrift|Textbook_DaD.jpg|4|Drag&Drop Bereich des Textbuch Plugins.|center}}

== 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.
{{Bild_mit_Unterschrift|Textbook_Optionswindow.jpg|5|Options-Fenster des Textbuch Plugins.|center|800px}}

== Befehlsliste ==
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}}
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 =
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 {{Manual Windowcaption|[[Project Explorer DMXC3|Projektexplorer (Project Explorer)]]}} verwaltet. Hier sollte eine neue Rubrik mit dem Namen {{Manual Objectcaption|Textbook}} vorhanden sein. Per Rechtsklick auf den Eintrag und {{Manual MenuText|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

[[Kategorie: Plugins_DMXControl_3]]

Datei:Textbook Optionswindow.jpg

2026-05-17T15:15:02Z

Mkohl: Mkohl lud eine neue Version von Datei:Textbook Optionswindow.jpg hoch

Textbook Plugin DMXC3

2026-05-17T14:52:04Z

Mkohl: /* Bedien- und Statusleiste */

{{Inuse}}

{{Infobox Plugin
| Name = Textbuch
| Logo =
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 0.9
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz =
| Deutsch = nein
| Email =
| Homepage = http://www.dmxcontrol.de
| Download =
}}

= 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 <Code> Textbook </code> und <Code> api-dlls </code>in das Unterverzeichnis <code>GUI / Plugins</code> verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im {{Manual MenuText|Plugin Management}} der Eintrag {{Manual MenuText|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.
{{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
# Texteditor
# {{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|Textbook Menüleiste.jpg|2|Menüleiste des Textbuch Plugins.|center|800px}}

{| class="wikitable"
|- class="hintergrundfarbe6"
! style="width: 75px;" | Icon !! style="width: 175px;" | Bezeichnung !! Beschreibung / Funktionsweise
|-
| 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;" | [[Bild:Textbook_Font.jpg]] || Text Font || Auswahl der Schriftart für die aktuell selektierte Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Bold.jpg]] || Bold || Ändert die Schrift der aktuell ausgewählten Zeile auf "Fett".
|-
| style="text-align:center;" | [[Bild:Textbook_Italic.jpg]] || Italic || Ändert die Schrift der aktuell ausgewählten Zeile auf "Kursiv"
|-
| style="text-align:center;" | [[Bild:Textbook_Textsize.jpg]] || Textsize || Vergrößert/Verkleinert den Text der aktuell ausgewählten Zeile.
|-
| style="text-align:center;" | [[Bild:Textbook_Aligment.jpg]] || Aligment || Ändert die Ausrichtung der aktuell ausgewählten Zeile.
|-
| 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;" | [[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;" | [[Bild:Textbook_Options.jpg]] || Options || Öffnet das Fenster zur Einstellung der Styles und Settings.
|-
| 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.
|}

== 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.
{{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, eine Liste mit Pausen sowie einer Liste mit Favoriten untergebracht sind.

{{Bild_mit_Unterschrift|Textbook_DaD.jpg|4|Drag&Drop Bereich des Textbuch Plugins.|center}}

== Options-Fenster ==
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|Textbook_Optionswindow.jpg|5|Options-Fenster des Textbuch Plugins.|center|800px}}

== Befehlsliste ==
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}}
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 =
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 {{Manual Windowcaption|[[Project Explorer DMXC3|Projektexplorer (Project Explorer)]]}} verwaltet. Hier sollte eine neue Rubrik mit dem Namen {{Manual Objectcaption|Textbook}} vorhanden sein. Per Rechtsklick auf den Eintrag und {{Manual MenuText|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

[[Kategorie: Plugins_DMXControl_3]]