Deutsches DMXC-Wiki - Benutzerbeiträge [de]

Textbook Plugin DMXC3

2021-03-23T19:00:11Z

Mic:

{{Infobox Plugin
| Name = Textbuch
| Logo = Beispiel-Textbuch.png
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 1.0.4.0
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.2.2
| Programmiersprache = C#
| Kategorie =
| Lizenz = GLP
| Deutsch = ja
| Email =
| Homepage = http://www.dmxcontrol.de
| Download = https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/
}}
= Beschreibung =
Beim Textbuch handelt es sich um ein Plugin für DMXControl 3, um die Textbuchfunktionalität aus DMXControl 2 in der Version 3 zur Verfügung zu stellen. Für Theater- und Musicalveranstaltungen ist es essentiell Stimmungen und Effekte passgenau auf Zeitpunkte oder Stichwörter einzutakten. Das Textbuch wurde entwickelt, um bei Veranstaltungen mit festem Ablauf auf basis eines Textbuches/Drehbuches oder ähnlichem die passenden Funktionen von DMXControl 3 auszulösen.

= Installation =
Das Textbuchplugin kann im DMXControl Forum unter folgendem [https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/ Link] heruntergeladen werden. Im Installationsverzeichnis von DMXControl muss die enthaltene Datei "Textbook.dll" in das Unterverzeichnis "GUI/Plugins" verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im "Plugin Management" der Eintrag "Textbook Plugin" vorhanden sein. Nach aktivieren des Eintrags stehen die Textbuchfunktionalitäten zur Verfügung. Sollte der Eintrag nicht vorhanden sein, ist die DLL Datei eventuell von Windows blockiert und muss gegebenenfalls noch freigegeben oder DMXControl als Administrator gestartet werden.

= Bedienelemente =
Nach öffnen des Textbuches sollte sich ein Fenster gemäß untenstehender Abbildung öffnen.
{{Bild_mit_Unterschrift|Beispiel-Textbuch.png|1|Textbuch mit Beispieltext.|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# Drag and Drop Bereich
# Textbuch Bedien- und Statusleiste
# Befehlsliste

== Menüleiste ==
Die Menüleiste beinhaltet allgemeine Funktionen zum Speichern und Bearbeiten des Textbuch-Verhaltens.
{{Bild_mit_Unterschrift|Textbuch - Menüleiste.png|2|Menüleiste des Textbuch Plugins.|center|400px}}

{| class="wikitable"
|- class="hintergrundfarbe6"
! style="width: 75px;" | Icon !! style="width: 175px;" | Bezeichnung !! Beschreibung / Funktionsweise
|-
| style="text-align:center;" | [[Bild:DMXC3_Icon_V-Collection_save_as.png]] || Save|| Die Änderungen im Textbuch werden in der Projektstruktur gespeichert.
|-
| style="text-align:center;" | || Import file || Externe Textdateien (*.txt, *.rtf) werden in den Texteditor des Textbuches importiert.
|-
| style="text-align:center;" | || Export file || Das aktuelle Textbuch wird inklusive der Formatierungen in Form eines *.rtf Dokumentes exportiert. Beim Bearbeiten mit externen Programmen ist es notwendig, dass das \v Tag des RTF-Standards unterstützt wird (Textbuchkommandos werden großenteils als versteckter Text gespeichert).
|-
| style="text-align:center;" | || Show drag-drop panel || Blendet das Steuerelement zum erstellen von Textbuchbefehlen per Drag and Drop ein/aus.
|-
| style="text-align:center;" | || Show ruler || Blendet das Lineal im Texteditor ein/aus.
|-
| style="text-align:center;" | || Show commandbox || Blendet die Tabelle mit den vorhandenen Textbuchkommandos ein/aus.
|-
| style="text-align:center;" | || Show linenumbers || Blendet die Zeilennummerierung im Texteditor ein/aus.
|-
| style="text-align:center;" | || Scroll to next item after go || Nach dem Ausführen eines Kommandos mit "Go" wird zum nächsten Element gescrollt.
|-
| style="text-align:center;" | || Next line after go || Nach dem Ausführen eines Kommandos mit "Go" wird die nächsten Zeile im Textbuch selektiert.
|-
| style="text-align:center;" | || Next command after go || Nach dem Ausführen eines Kommandos mit "Go" wird das nächste Textbuchkommando selektiert.
|-
| style="text-align:center;" | [[Bild:DMXC3_Icon_V-Collection_undo.png]] || Undo || Macht die letzte Änderung im Texteditor rückgängig.
|-
| style="text-align:center;" | [[Bild:DMXC3_Icon_V-Collection_redo.png]] || Redo || Stellt die letzte Änderung im Texteditor wieder her.
|-
| style="text-align:center;" | [[Bild:DMXC3_Icon_V-Collection_add.png]] || Add || Öffnet einen Dialog zum einfügen neuer Textbuchkommandos.
|}

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

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

== Bedien- und Statusleiste ==
Die Bedien- und Statusleiste umfasst eine Fortschrittsanzeige, Buttons für den Sprung zum nächsten beziehungsweise zum vorhergehenden Objekt sowie die Buttons "Go" und "Autoscroll". Zur Einbindung des Textbuches in Softdesks oder zum Anlegen von Shortcuts sind die Buttons der Bedienleiste auch über das Inputassignment ansteuerbar und können zum Beispiel mit externen Befehlsgebern oder Tasten verknüpft werden.
{{Bild_mit_Unterschrift|Textbuch - Status und Bedienleiste.png|4|Status- und Bedienleiste des Textbuch Plugins|center|800px}}
Je nach Einstellung wird mit "Go" zum nächsten Kommando oder zur nächsten Zeile gesprungen. Ebenso verhalten sich die Buttons "Back" und "Next", wobei hier die entsprechenden Kommandos nicht ausgeführt werden.
Sind die Optionen "scroll to next Item after Go" und "next Command after Go" kann mit der Option "Autoscroll" sanft zwischen den entsprechenden Zeilen gescrollt werden. Die Zeit, zum Überblenden zwischen den Zeilen wird über den Parameter "Delta-t" des nachfolgenden Kommandos eingestellt.

== 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 Cuelist oder Inputassignment)
* 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 Stichwörter als Info für den Operator zu hinterlegen
* Kommentar - Möglichkeit 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 im Projektfile von DMXControl gespeichert. Da das Textbuch aktuell ein reines GUI-Plugin ist, werden die Textbücher rein von der GUI verarbeitet. Ein bearbeiten der Textbücher im betrieb mit mehreren Clients ist deshalb nicht möglich. Das zeitgleiche nutzen von Textbüchern ist jedoch möglich. Die Textbücher werden über den Projektexplorer verwaltet. Hier sollte eine neue Rubrik mit dem Namen "Textbook" vorhanden sein. Per Rechtsklick auf den Eintrag und "Create Textbook" kann ein neues Textbuch erstellt und mit doppelklick darauf geöffnet werden.

== Cuelisten und Cues ==
Für die Einblendzeit wird die in DMXControl definierte Zeit zum einblenden der Aktion aufgeführt. Werden Cuelisten gestartet/gestoppt wird die Fade- beziehungsweise Release-time als Einblendzeit angezeigt. Wird GoTo verwendet wird die "GoTo Time" der Cuelist angezeigt. Soll die Fadetime der entsprechenden Cuelist als Einblendzeit genutzt werden, so muss in der Cuelist die Option "Use Cue Time as GoTo Time" auf "True" gesetzt werden. Da das "GoTo" Kommando des Textbuches eigentlich auf dem "GoNext" Kommando von DMXControl beruht, sollten in der Cuelist im Bereich der "GoNext Behaviour" die Optionen "Start Cuelist" auf "True" und "Always use next Index" auf "False" stehen.

== Inputassignment ==
Je verwendetem Textbuch in einem Projekt kann eine beliebige Anzahl von Eingangsquellen angelegt werden. Diese erscheinen im Inputassignment unter dem Kapitel 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 Inputassignment-Kommando im Textbuch ist einstellbar, ob die entsprechende Variable bei betätigung auf "True" oder "False" gesetzt werden soll. Eine Einblendzeit wird für Inputassignment-Kommandos nicht angezeigt, da die Aktion instantan 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

2021-03-23T18:48:28Z

Mic: /* Bekannte Bugs / Features */

{{Infobox Plugin
| Name = Textbuch
| Logo = Beispiel-Textbuch.png
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 1.3
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz = GLP
| Deutsch = ja
| Email =
| Homepage = http://www.dmxcontrol.de
| Download = https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/
}}
= Beschreibung =
Beim Textbuch handelt es sich um ein Plugin für DMXControl 3, um die Textbuchfunktionalität aus DMXControl 2 in der Version 3 zur Verfügung zu stellen. Für Theater- und Musicalveranstaltungen ist es essentiell Stimmungen und Effekte passgenau auf Zeitpunkte oder Stichwörter einzutakten. Das Textbuch wurde entwickelt, um bei Veranstaltungen mit festem Ablauf auf basis eines Textbuches/Drehbuches oder ähnlichem die passenden Funktionen von DMXControl 3 auszulösen.

= Installation =
Das Textbuchplugin kann im DMXControl Forum unter folgendem [https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/ Link] heruntergeladen werden. Im Installationsverzeichnis von DMXControl muss die enthaltene Datei "Textbook.dll" in das Unterverzeichnis "GUI/Plugins" verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im "Plugin Management" der Eintrag "Textbook Plugin" vorhanden sein. Nach aktivieren des Eintrags stehen die Textbuchfunktionalitäten zur Verfügung. Sollte der Eintrag nicht vorhanden sein, ist die DLL Datei eventuell von Windows blockiert und muss gegebenenfalls noch freigegeben oder DMXControl als Administrator gestartet werden.

= Bedienelemente =
Nach öffnen des Textbuches sollte sich ein Fenster gemäß untenstehender Abbildung öffnen.
{{Bild_mit_Unterschrift|Beispiel-Textbuch.png|1|Textbuch mit Beispieltext.|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# Drag and Drop Bereich
# Textbuch Bedien- und Statusleiste
# Befehlsliste

== Menüleiste ==
Die Menüleiste beinhaltet allgemeine Funktionen zum Speichern und Bearbeiten des Textbuch-Verhaltens.
{{Bild_mit_Unterschrift|Textbuch - Menüleiste.png|2|Menüleiste des Textbuch Plugins.|center|400px}}

{| class="wikitable"
|- class="hintergrundfarbe6"
! style="width: 75px;" | Icon !! style="width: 175px;" | Bezeichnung !! Beschreibung / Funktionsweise
|-
| style="text-align:center;" | [[Bild:DMXC3_Icon_V-Collection_save_as.png]] || Save|| Die Änderungen im Textbuch werden in der Projektstruktur gespeichert.
|-
| style="text-align:center;" | || Import file || Externe Textdateien (*.txt, *.rtf) werden in den Texteditor des Textbuches importiert.
|-
| style="text-align:center;" | || Export file || Das aktuelle Textbuch wird inklusive der Formatierungen in Form eines *.rtf Dokumentes exportiert. Beim Bearbeiten mit externen Programmen ist es notwendig, dass das \v Tag des RTF-Standards unterstützt wird (Textbuchkommandos werden großenteils als versteckter Text gespeichert).
|-
| style="text-align:center;" | || Show drag-drop panel || Blendet das Steuerelement zum erstellen von Textbuchbefehlen per Drag and Drop ein/aus.
|-
| style="text-align:center;" | || Show ruler || Blendet das Lineal im Texteditor ein/aus.
|-
| style="text-align:center;" | || Show commandbox || Blendet die Tabelle mit den vorhandenen Textbuchkommandos ein/aus.
|-
| style="text-align:center;" | || Show linenumbers || Blendet die Zeilennummerierung im Texteditor ein/aus.
|-
| style="text-align:center;" | || Scroll to next item after go || Nach dem Ausführen eines Kommandos mit "Go" wird zum nächsten Element gescrollt.
|-
| style="text-align:center;" | || Next line after go || Nach dem Ausführen eines Kommandos mit "Go" wird die nächsten Zeile im Textbuch selektiert.
|-
| style="text-align:center;" | || Next command after go || Nach dem Ausführen eines Kommandos mit "Go" wird das nächste Textbuchkommando selektiert.
|-
| style="text-align:center;" | [[Bild:DMXC3_Icon_V-Collection_undo.png]] || Undo || Macht die letzte Änderung im Texteditor rückgängig.
|-
| style="text-align:center;" | [[Bild:DMXC3_Icon_V-Collection_redo.png]] || Redo || Stellt die letzte Änderung im Texteditor wieder her.
|-
| style="text-align:center;" | [[Bild:DMXC3_Icon_V-Collection_add.png]] || Add || Öffnet einen Dialog zum einfügen neuer Textbuchkommandos.
|}

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

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

== Bedien- und Statusleiste ==
Die Bedien- und Statusleiste umfasst eine Fortschrittsanzeige, Buttons für den Sprung zum nächsten beziehungsweise zum vorhergehenden Objekt sowie die Buttons "Go" und "Autoscroll". Zur Einbindung des Textbuches in Softdesks oder zum Anlegen von Shortcuts sind die Buttons der Bedienleiste auch über das Inputassignment ansteuerbar und können zum Beispiel mit externen Befehlsgebern oder Tasten verknüpft werden.
{{Bild_mit_Unterschrift|Textbuch - Status und Bedienleiste.png|4|Status- und Bedienleiste des Textbuch Plugins|center|800px}}
Je nach Einstellung wird mit "Go" zum nächsten Kommando oder zur nächsten Zeile gesprungen. Ebenso verhalten sich die Buttons "Back" und "Next", wobei hier die entsprechenden Kommandos nicht ausgeführt werden.
Sind die Optionen "scroll to next Item after Go" und "next Command after Go" kann mit der Option "Autoscroll" sanft zwischen den entsprechenden Zeilen gescrollt werden. Die Zeit, zum Überblenden zwischen den Zeilen wird über den Parameter "Delta-t" des nachfolgenden Kommandos eingestellt.

== 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 Cuelist oder Inputassignment)
* 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 Stichwörter als Info für den Operator zu hinterlegen
* Kommentar - Möglichkeit 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 im Projektfile von DMXControl gespeichert. Da das Textbuch aktuell ein reines GUI-Plugin ist, werden die Textbücher rein von der GUI verarbeitet. Ein bearbeiten der Textbücher im betrieb mit mehreren Clients ist deshalb nicht möglich. Das zeitgleiche nutzen von Textbüchern ist jedoch möglich. Die Textbücher werden über den Projektexplorer verwaltet. Hier sollte eine neue Rubrik mit dem Namen "Textbook" vorhanden sein. Per Rechtsklick auf den Eintrag und "Create Textbook" kann ein neues Textbuch erstellt und mit doppelklick darauf geöffnet werden.

== Cuelisten und Cues ==
Für die Einblendzeit wird die in DMXControl definierte Zeit zum einblenden der Aktion aufgeführt. Werden Cuelisten gestartet/gestoppt wird die Fade- beziehungsweise Release-time als Einblendzeit angezeigt. Wird GoTo verwendet wird die "GoTo Time" der Cuelist angezeigt. Soll die Fadetime der entsprechenden Cuelist als Einblendzeit genutzt werden, so muss in der Cuelist die Option "Use Cue Time as GoTo Time" auf "True" gesetzt werden. Da das "GoTo" Kommando des Textbuches eigentlich auf dem "GoNext" Kommando von DMXControl beruht, sollten in der Cuelist im Bereich der "GoNext Behaviour" die Optionen "Start Cuelist" auf "True" und "Always use next Index" auf "False" stehen.

== Inputassignment ==
Je verwendetem Textbuch in einem Projekt kann eine beliebige Anzahl von Eingangsquellen angelegt werden. Diese erscheinen im Inputassignment unter dem Kapitel 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 Inputassignment-Kommando im Textbuch ist einstellbar, ob die entsprechende Variable bei betätigung auf "True" oder "False" gesetzt werden soll. Eine Einblendzeit wird für Inputassignment-Kommandos nicht angezeigt, da die Aktion instantan 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

2020-01-25T11:04:17Z

Mic: /* Bedien- und Statusleiste */

{{Infobox Plugin
| Name = Textbuch
| Logo = Beispiel-Textbuch.png
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 1.3
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz = GLP
| Deutsch = ja
| Email =
| Homepage = http://www.dmxcontrol.de
| Download = https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/
}}
= Beschreibung =
Beim Textbuch handelt es sich um ein Plugin für DMXControl 3, um die Textbuchfunktionalität aus DMXControl 2 in der Version 3 zur Verfügung zu stellen. Für Theater- und Musicalveranstaltungen ist es essentiell Stimmungen und Effekte passgenau auf Zeitpunkte oder Stichwörter einzutakten. Das Textbuch wurde entwickelt, um bei Veranstaltungen mit festem Ablauf auf basis eines Textbuches/Drehbuches oder ähnlichem die passenden Funktionen von DMXControl 3 auszulösen.

= Installation =
Das Textbuchplugin kann im DMXControl Forum unter folgendem [https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/ Link] heruntergeladen werden. Im Installationsverzeichnis von DMXControl muss die enthaltene Datei "Textbook.dll" in das Unterverzeichnis "GUI/Plugins" verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im "Plugin Management" der Eintrag "Textbook Plugin" vorhanden sein. Nach aktivieren des Eintrags stehen die Textbuchfunktionalitäten zur Verfügung. Sollte der Eintrag nicht vorhanden sein, ist die DLL Datei eventuell von Windows blockiert und muss gegebenenfalls noch freigegeben oder DMXControl als Administrator gestartet werden.

= Bedienelemente =
Nach öffnen des Textbuches sollte sich ein Fenster gemäß untenstehender Abbildung öffnen.
{{Bild_mit_Unterschrift|Beispiel-Textbuch.png|1|Textbuch mit Beispieltext.|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# Drag and Drop Bereich
# Textbuch Bedien- und Statusleiste
# Befehlsliste

== Menüleiste ==
Die Menüleiste beinhaltet allgemeine Funktionen zum Speichern und Bearbeiten des Textbuch-Verhaltens.
{{Bild_mit_Unterschrift|Textbuch - Menüleiste.png|2|Menüleiste des Textbuch Plugins.|center|400px}}

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

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

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

== Bedien- und Statusleiste ==
Die Bedien- und Statusleiste umfasst eine Fortschrittsanzeige, Buttons für den Sprung zum nächsten beziehungsweise zum vorhergehenden Objekt sowie die Buttons "Go" und "Autoscroll". Zur Einbindung des Textbuches in Softdesks oder zum Anlegen von Shortcuts sind die Buttons der Bedienleiste auch über das Inputassignment ansteuerbar und können zum Beispiel mit externen Befehlsgebern oder Tasten verknüpft werden.
{{Bild_mit_Unterschrift|Textbuch - Status und Bedienleiste.png|4|Status- und Bedienleiste des Textbuch Plugins|center|800px}}
Je nach Einstellung wird mit "Go" zum nächsten Kommando oder zur nächsten Zeile gesprungen. Ebenso verhalten sich die Buttons "Back" und "Next", wobei hier die entsprechenden Kommandos nicht ausgeführt werden.
Sind die Optionen "scroll to next Item after Go" und "next Command after Go" kann mit der Option "Autoscroll" sanft zwischen den entsprechenden Zeilen gescrollt werden. Die Zeit, zum Überblenden zwischen den Zeilen wird über den Parameter "Delta-t" des nachfolgenden Kommandos eingestellt.

== 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 Cuelist oder Inputassignment)
* 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 Stichwörter als Info für den Operator zu hinterlegen
* Kommentar - Möglichkeit 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 im Projektfile von DMXControl gespeichert. Da das Textbuch aktuell ein reines GUI-Plugin ist, werden die Textbücher rein von der GUI verarbeitet. Ein bearbeiten der Textbücher im betrieb mit mehreren Clients ist deshalb nicht möglich. Das zeitgleiche nutzen von Textbüchern ist jedoch möglich. Die Textbücher werden über den Projektexplorer verwaltet. Hier sollte eine neue Rubrik mit dem Namen "Textbook" vorhanden sein. Per Rechtsklick auf den Eintrag und "Create Textbook" kann ein neues Textbuch erstellt und mit doppelklick darauf geöffnet werden.

== Cuelisten und Cues ==
Für die Einblendzeit wird die in DMXControl definierte Zeit zum einblenden der Aktion aufgeführt. Werden Cuelisten gestartet/gestoppt wird die Fade- beziehungsweise Release-time als Einblendzeit angezeigt. Wird GoTo verwendet wird die "GoTo Time" der Cuelist angezeigt. Soll die Fadetime der entsprechenden Cuelist als Einblendzeit genutzt werden, so muss in der Cuelist die Option "Use Cue Time as GoTo Time" auf "True" gesetzt werden. Da das "GoTo" Kommando des Textbuches eigentlich auf dem "GoNext" Kommando von DMXControl beruht, sollten in der Cuelist im Bereich der "GoNext Behaviour" die Optionen "Start Cuelist" auf "True" und "Always use next Index" auf "False" stehen.

== Inputassignment ==
Je verwendetem Textbuch in einem Projekt kann eine beliebige Anzahl von Eingangsquellen angelegt werden. Diese erscheinen im Inputassignment unter dem Kapitel 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 Inputassignment-Kommando im Textbuch ist einstellbar, ob die entsprechende Variable bei betätigung auf "True" oder "False" gesetzt werden soll. Eine Einblendzeit wird für Inputassignment-Kommandos nicht angezeigt, da die Aktion instantan 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)
[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2020-01-25T11:03:25Z

Mic: /* Bedien- und Statusleiste */

{{Infobox Plugin
| Name = Textbuch
| Logo = Beispiel-Textbuch.png
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 1.3
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz = GLP
| Deutsch = ja
| Email =
| Homepage = http://www.dmxcontrol.de
| Download = https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/
}}
= Beschreibung =
Beim Textbuch handelt es sich um ein Plugin für DMXControl 3, um die Textbuchfunktionalität aus DMXControl 2 in der Version 3 zur Verfügung zu stellen. Für Theater- und Musicalveranstaltungen ist es essentiell Stimmungen und Effekte passgenau auf Zeitpunkte oder Stichwörter einzutakten. Das Textbuch wurde entwickelt, um bei Veranstaltungen mit festem Ablauf auf basis eines Textbuches/Drehbuches oder ähnlichem die passenden Funktionen von DMXControl 3 auszulösen.

= Installation =
Das Textbuchplugin kann im DMXControl Forum unter folgendem [https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/ Link] heruntergeladen werden. Im Installationsverzeichnis von DMXControl muss die enthaltene Datei "Textbook.dll" in das Unterverzeichnis "GUI/Plugins" verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im "Plugin Management" der Eintrag "Textbook Plugin" vorhanden sein. Nach aktivieren des Eintrags stehen die Textbuchfunktionalitäten zur Verfügung. Sollte der Eintrag nicht vorhanden sein, ist die DLL Datei eventuell von Windows blockiert und muss gegebenenfalls noch freigegeben oder DMXControl als Administrator gestartet werden.

= Bedienelemente =
Nach öffnen des Textbuches sollte sich ein Fenster gemäß untenstehender Abbildung öffnen.
{{Bild_mit_Unterschrift|Beispiel-Textbuch.png|1|Textbuch mit Beispieltext.|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# Drag and Drop Bereich
# Textbuch Bedien- und Statusleiste
# Befehlsliste

== Menüleiste ==
Die Menüleiste beinhaltet allgemeine Funktionen zum Speichern und Bearbeiten des Textbuch-Verhaltens.
{{Bild_mit_Unterschrift|Textbuch - Menüleiste.png|2|Menüleiste des Textbuch Plugins.|center|400px}}

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

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

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

== Bedien- und Statusleiste ==
Die Bedien- und Statusleiste umfasst eine Fortschrittsanzeige, Buttons für den Sprung zum nächsten beziehungsweise zum vorhergehenden Objekt sowie die Buttons "Go" und "Autoscroll". Zur einbindung des Textbuches in Softdesks oder zum anlegen von Shortcuts sind die Buttons der Bedienleiste auch über das Inputassignment ansteuerbar und können zum Beispiel mit externen Befehlsgebern oder Tasten verknüpft werden.
{{Bild_mit_Unterschrift|Textbuch - Status und Bedienleiste.png|4|Status- und Bedienleiste des Textbuch Plugins|center|800px}}
Je nach Einstellung wird mit "Go" zum nächsten Kommando oder zur nächsten Zeile gesprungen. Ebenso verhalten sich die Buttons "Back" und "Next", wobei hier die entsprechenden Kommandos nicht ausgeführt werden.
Sind die Optionen "scroll to next Item after Go" und "next Command after Go" kann mit der Option "Autoscroll" sanft zwischen den entsprechenden Zeilen gescrollt werden. Die Zeit, zum Überblenden zwischen den Zeilen wird über den Parameter "Delta-t" des nachfolgenden Kommandos eingestellt.

== 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 Cuelist oder Inputassignment)
* 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 Stichwörter als Info für den Operator zu hinterlegen
* Kommentar - Möglichkeit 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 im Projektfile von DMXControl gespeichert. Da das Textbuch aktuell ein reines GUI-Plugin ist, werden die Textbücher rein von der GUI verarbeitet. Ein bearbeiten der Textbücher im betrieb mit mehreren Clients ist deshalb nicht möglich. Das zeitgleiche nutzen von Textbüchern ist jedoch möglich. Die Textbücher werden über den Projektexplorer verwaltet. Hier sollte eine neue Rubrik mit dem Namen "Textbook" vorhanden sein. Per Rechtsklick auf den Eintrag und "Create Textbook" kann ein neues Textbuch erstellt und mit doppelklick darauf geöffnet werden.

== Cuelisten und Cues ==
Für die Einblendzeit wird die in DMXControl definierte Zeit zum einblenden der Aktion aufgeführt. Werden Cuelisten gestartet/gestoppt wird die Fade- beziehungsweise Release-time als Einblendzeit angezeigt. Wird GoTo verwendet wird die "GoTo Time" der Cuelist angezeigt. Soll die Fadetime der entsprechenden Cuelist als Einblendzeit genutzt werden, so muss in der Cuelist die Option "Use Cue Time as GoTo Time" auf "True" gesetzt werden. Da das "GoTo" Kommando des Textbuches eigentlich auf dem "GoNext" Kommando von DMXControl beruht, sollten in der Cuelist im Bereich der "GoNext Behaviour" die Optionen "Start Cuelist" auf "True" und "Always use next Index" auf "False" stehen.

== Inputassignment ==
Je verwendetem Textbuch in einem Projekt kann eine beliebige Anzahl von Eingangsquellen angelegt werden. Diese erscheinen im Inputassignment unter dem Kapitel 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 Inputassignment-Kommando im Textbuch ist einstellbar, ob die entsprechende Variable bei betätigung auf "True" oder "False" gesetzt werden soll. Eine Einblendzeit wird für Inputassignment-Kommandos nicht angezeigt, da die Aktion instantan 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)
[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2020-01-25T11:02:56Z

Mic: /* Texteditor */

{{Infobox Plugin
| Name = Textbuch
| Logo = Beispiel-Textbuch.png
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 1.3
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz = GLP
| Deutsch = ja
| Email =
| Homepage = http://www.dmxcontrol.de
| Download = https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/
}}
= Beschreibung =
Beim Textbuch handelt es sich um ein Plugin für DMXControl 3, um die Textbuchfunktionalität aus DMXControl 2 in der Version 3 zur Verfügung zu stellen. Für Theater- und Musicalveranstaltungen ist es essentiell Stimmungen und Effekte passgenau auf Zeitpunkte oder Stichwörter einzutakten. Das Textbuch wurde entwickelt, um bei Veranstaltungen mit festem Ablauf auf basis eines Textbuches/Drehbuches oder ähnlichem die passenden Funktionen von DMXControl 3 auszulösen.

= Installation =
Das Textbuchplugin kann im DMXControl Forum unter folgendem [https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/ Link] heruntergeladen werden. Im Installationsverzeichnis von DMXControl muss die enthaltene Datei "Textbook.dll" in das Unterverzeichnis "GUI/Plugins" verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im "Plugin Management" der Eintrag "Textbook Plugin" vorhanden sein. Nach aktivieren des Eintrags stehen die Textbuchfunktionalitäten zur Verfügung. Sollte der Eintrag nicht vorhanden sein, ist die DLL Datei eventuell von Windows blockiert und muss gegebenenfalls noch freigegeben oder DMXControl als Administrator gestartet werden.

= Bedienelemente =
Nach öffnen des Textbuches sollte sich ein Fenster gemäß untenstehender Abbildung öffnen.
{{Bild_mit_Unterschrift|Beispiel-Textbuch.png|1|Textbuch mit Beispieltext.|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# Drag and Drop Bereich
# Textbuch Bedien- und Statusleiste
# Befehlsliste

== Menüleiste ==
Die Menüleiste beinhaltet allgemeine Funktionen zum Speichern und Bearbeiten des Textbuch-Verhaltens.
{{Bild_mit_Unterschrift|Textbuch - Menüleiste.png|2|Menüleiste des Textbuch Plugins.|center|400px}}

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

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

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

== Bedien- und Statusleiste ==
Die Bedien- und Statusleiste umfasst eine Fortschrittsanzeige, Buttons für den Sprung zum nächsten beziehungsweise zum vorhergehenden Objekt sowie die Buttons "Go" und "Autoscroll". Zur einbindung des Textbuches in Softdesks oder zum anlegen von Shortcuts sind die Buttons der Bedienleiste auch über das Inputassignment ansteuerbar und können zum Beispiel mit externen Befehlsgebern oder Tasten verknüpft werden.
{{Bild_mit_Unterschrift|Textbuch - Status und Bedienleiste.png|4|Status- und Bedienleiste des Textbuch Plugins|center|800px}}
Je nach Einstellung wird mit "Go" zum nächsten Kommando oder zur nächsten Zeile gesprungen. Ebenso verhalten sich die Buttons "Back" und "Next", wobei hier die entsprechenden Kommandos nicht ausgeführt werden.
Sind die Optionen "scroll to next Item after Go" und "next Command after Go" kann mit der Option "Autoscroll" sanft zwischen den entsprechenden Zeilen gescrollt werden. Die Zeit, zum überblenden zwischen den Zeilen wird über den Parameter "Delta-t" des nachfolgenden Kommandos eingestellt.

== 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 Cuelist oder Inputassignment)
* 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 Stichwörter als Info für den Operator zu hinterlegen
* Kommentar - Möglichkeit 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 im Projektfile von DMXControl gespeichert. Da das Textbuch aktuell ein reines GUI-Plugin ist, werden die Textbücher rein von der GUI verarbeitet. Ein bearbeiten der Textbücher im betrieb mit mehreren Clients ist deshalb nicht möglich. Das zeitgleiche nutzen von Textbüchern ist jedoch möglich. Die Textbücher werden über den Projektexplorer verwaltet. Hier sollte eine neue Rubrik mit dem Namen "Textbook" vorhanden sein. Per Rechtsklick auf den Eintrag und "Create Textbook" kann ein neues Textbuch erstellt und mit doppelklick darauf geöffnet werden.

== Cuelisten und Cues ==
Für die Einblendzeit wird die in DMXControl definierte Zeit zum einblenden der Aktion aufgeführt. Werden Cuelisten gestartet/gestoppt wird die Fade- beziehungsweise Release-time als Einblendzeit angezeigt. Wird GoTo verwendet wird die "GoTo Time" der Cuelist angezeigt. Soll die Fadetime der entsprechenden Cuelist als Einblendzeit genutzt werden, so muss in der Cuelist die Option "Use Cue Time as GoTo Time" auf "True" gesetzt werden. Da das "GoTo" Kommando des Textbuches eigentlich auf dem "GoNext" Kommando von DMXControl beruht, sollten in der Cuelist im Bereich der "GoNext Behaviour" die Optionen "Start Cuelist" auf "True" und "Always use next Index" auf "False" stehen.

== Inputassignment ==
Je verwendetem Textbuch in einem Projekt kann eine beliebige Anzahl von Eingangsquellen angelegt werden. Diese erscheinen im Inputassignment unter dem Kapitel 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 Inputassignment-Kommando im Textbuch ist einstellbar, ob die entsprechende Variable bei betätigung auf "True" oder "False" gesetzt werden soll. Eine Einblendzeit wird für Inputassignment-Kommandos nicht angezeigt, da die Aktion instantan 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)
[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2020-01-25T11:02:36Z

Mic: /* Menüleiste */

{{Infobox Plugin
| Name = Textbuch
| Logo = Beispiel-Textbuch.png
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 1.3
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz = GLP
| Deutsch = ja
| Email =
| Homepage = http://www.dmxcontrol.de
| Download = https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/
}}
= Beschreibung =
Beim Textbuch handelt es sich um ein Plugin für DMXControl 3, um die Textbuchfunktionalität aus DMXControl 2 in der Version 3 zur Verfügung zu stellen. Für Theater- und Musicalveranstaltungen ist es essentiell Stimmungen und Effekte passgenau auf Zeitpunkte oder Stichwörter einzutakten. Das Textbuch wurde entwickelt, um bei Veranstaltungen mit festem Ablauf auf basis eines Textbuches/Drehbuches oder ähnlichem die passenden Funktionen von DMXControl 3 auszulösen.

= Installation =
Das Textbuchplugin kann im DMXControl Forum unter folgendem [https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/ Link] heruntergeladen werden. Im Installationsverzeichnis von DMXControl muss die enthaltene Datei "Textbook.dll" in das Unterverzeichnis "GUI/Plugins" verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im "Plugin Management" der Eintrag "Textbook Plugin" vorhanden sein. Nach aktivieren des Eintrags stehen die Textbuchfunktionalitäten zur Verfügung. Sollte der Eintrag nicht vorhanden sein, ist die DLL Datei eventuell von Windows blockiert und muss gegebenenfalls noch freigegeben oder DMXControl als Administrator gestartet werden.

= Bedienelemente =
Nach öffnen des Textbuches sollte sich ein Fenster gemäß untenstehender Abbildung öffnen.
{{Bild_mit_Unterschrift|Beispiel-Textbuch.png|1|Textbuch mit Beispieltext.|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# Drag and Drop Bereich
# Textbuch Bedien- und Statusleiste
# Befehlsliste

== Menüleiste ==
Die Menüleiste beinhaltet allgemeine Funktionen zum Speichern und Bearbeiten des Textbuch-Verhaltens.
{{Bild_mit_Unterschrift|Textbuch - Menüleiste.png|2|Menüleiste des Textbuch Plugins.|center|400px}}

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

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

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

== Bedien- und Statusleiste ==
Die Bedien- und Statusleiste umfasst eine Fortschrittsanzeige, Buttons für den Sprung zum nächsten beziehungsweise zum vorhergehenden Objekt sowie die Buttons "Go" und "Autoscroll". Zur einbindung des Textbuches in Softdesks oder zum anlegen von Shortcuts sind die Buttons der Bedienleiste auch über das Inputassignment ansteuerbar und können zum Beispiel mit externen Befehlsgebern oder Tasten verknüpft werden.
{{Bild_mit_Unterschrift|Textbuch - Status und Bedienleiste.png|4|Status- und Bedienleiste des Textbuch Plugins|center|800px}}
Je nach Einstellung wird mit "Go" zum nächsten Kommando oder zur nächsten Zeile gesprungen. Ebenso verhalten sich die Buttons "Back" und "Next", wobei hier die entsprechenden Kommandos nicht ausgeführt werden.
Sind die Optionen "scroll to next Item after Go" und "next Command after Go" kann mit der Option "Autoscroll" sanft zwischen den entsprechenden Zeilen gescrollt werden. Die Zeit, zum überblenden zwischen den Zeilen wird über den Parameter "Delta-t" des nachfolgenden Kommandos eingestellt.

== 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 Cuelist oder Inputassignment)
* 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 Stichwörter als Info für den Operator zu hinterlegen
* Kommentar - Möglichkeit 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 im Projektfile von DMXControl gespeichert. Da das Textbuch aktuell ein reines GUI-Plugin ist, werden die Textbücher rein von der GUI verarbeitet. Ein bearbeiten der Textbücher im betrieb mit mehreren Clients ist deshalb nicht möglich. Das zeitgleiche nutzen von Textbüchern ist jedoch möglich. Die Textbücher werden über den Projektexplorer verwaltet. Hier sollte eine neue Rubrik mit dem Namen "Textbook" vorhanden sein. Per Rechtsklick auf den Eintrag und "Create Textbook" kann ein neues Textbuch erstellt und mit doppelklick darauf geöffnet werden.

== Cuelisten und Cues ==
Für die Einblendzeit wird die in DMXControl definierte Zeit zum einblenden der Aktion aufgeführt. Werden Cuelisten gestartet/gestoppt wird die Fade- beziehungsweise Release-time als Einblendzeit angezeigt. Wird GoTo verwendet wird die "GoTo Time" der Cuelist angezeigt. Soll die Fadetime der entsprechenden Cuelist als Einblendzeit genutzt werden, so muss in der Cuelist die Option "Use Cue Time as GoTo Time" auf "True" gesetzt werden. Da das "GoTo" Kommando des Textbuches eigentlich auf dem "GoNext" Kommando von DMXControl beruht, sollten in der Cuelist im Bereich der "GoNext Behaviour" die Optionen "Start Cuelist" auf "True" und "Always use next Index" auf "False" stehen.

== Inputassignment ==
Je verwendetem Textbuch in einem Projekt kann eine beliebige Anzahl von Eingangsquellen angelegt werden. Diese erscheinen im Inputassignment unter dem Kapitel 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 Inputassignment-Kommando im Textbuch ist einstellbar, ob die entsprechende Variable bei betätigung auf "True" oder "False" gesetzt werden soll. Eine Einblendzeit wird für Inputassignment-Kommandos nicht angezeigt, da die Aktion instantan 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)
[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2020-01-25T11:00:27Z

Mic: /* Befehlsliste */

{{Infobox Plugin
| Name = Textbuch
| Logo = Beispiel-Textbuch.png
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 1.3
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz = GLP
| Deutsch = ja
| Email =
| Homepage = http://www.dmxcontrol.de
| Download = https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/
}}
= Beschreibung =
Beim Textbuch handelt es sich um ein Plugin für DMXControl 3, um die Textbuchfunktionalität aus DMXControl 2 in der Version 3 zur Verfügung zu stellen. Für Theater- und Musicalveranstaltungen ist es essentiell Stimmungen und Effekte passgenau auf Zeitpunkte oder Stichwörter einzutakten. Das Textbuch wurde entwickelt, um bei Veranstaltungen mit festem Ablauf auf basis eines Textbuches/Drehbuches oder ähnlichem die passenden Funktionen von DMXControl 3 auszulösen.

= Installation =
Das Textbuchplugin kann im DMXControl Forum unter folgendem [https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/ Link] heruntergeladen werden. Im Installationsverzeichnis von DMXControl muss die enthaltene Datei "Textbook.dll" in das Unterverzeichnis "GUI/Plugins" verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im "Plugin Management" der Eintrag "Textbook Plugin" vorhanden sein. Nach aktivieren des Eintrags stehen die Textbuchfunktionalitäten zur Verfügung. Sollte der Eintrag nicht vorhanden sein, ist die DLL Datei eventuell von Windows blockiert und muss gegebenenfalls noch freigegeben oder DMXControl als Administrator gestartet werden.

= Bedienelemente =
Nach öffnen des Textbuches sollte sich ein Fenster gemäß untenstehender Abbildung öffnen.
{{Bild_mit_Unterschrift|Beispiel-Textbuch.png|1|Textbuch mit Beispieltext.|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# Drag and Drop Bereich
# Textbuch Bedien- und Statusleiste
# Befehlsliste

== Menüleiste ==
Die Menüleiste beinhaltet allgemeine Funktionen zum Speichern und Bearbeiten des Textbuch-Verhaltens.
{{Bild_mit_Unterschrift|Textbuch - Menüleiste.png|2|Menüleiste des Textbuch Plugins.|center|400px}}

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

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

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

== Bedien- und Statusleiste ==
Die Bedien- und Statusleiste umfasst eine Fortschrittsanzeige, Buttons für den Sprung zum nächsten beziehungsweise zum vorhergehenden Objekt sowie die Buttons "Go" und "Autoscroll". Zur einbindung des Textbuches in Softdesks oder zum anlegen von Shortcuts sind die Buttons der Bedienleiste auch über das Inputassignment ansteuerbar und können zum Beispiel mit externen Befehlsgebern oder Tasten verknüpft werden.
{{Bild_mit_Unterschrift|Textbuch - Status und Bedienleiste.png|4|Status- und Bedienleiste des Textbuch Plugins|center|800px}}
Je nach Einstellung wird mit "Go" zum nächsten Kommando oder zur nächsten Zeile gesprungen. Ebenso verhalten sich die Buttons "Back" und "Next", wobei hier die entsprechenden Kommandos nicht ausgeführt werden.
Sind die Optionen "scroll to next Item after Go" und "next Command after Go" kann mit der Option "Autoscroll" sanft zwischen den entsprechenden Zeilen gescrollt werden. Die Zeit, zum überblenden zwischen den Zeilen wird über den Parameter "Delta-t" des nachfolgenden Kommandos eingestellt.

== 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 Cuelist oder Inputassignment)
* 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 Stichwörter als Info für den Operator zu hinterlegen
* Kommentar - Möglichkeit 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 im Projektfile von DMXControl gespeichert. Da das Textbuch aktuell ein reines GUI-Plugin ist, werden die Textbücher rein von der GUI verarbeitet. Ein bearbeiten der Textbücher im betrieb mit mehreren Clients ist deshalb nicht möglich. Das zeitgleiche nutzen von Textbüchern ist jedoch möglich. Die Textbücher werden über den Projektexplorer verwaltet. Hier sollte eine neue Rubrik mit dem Namen "Textbook" vorhanden sein. Per Rechtsklick auf den Eintrag und "Create Textbook" kann ein neues Textbuch erstellt und mit doppelklick darauf geöffnet werden.

== Cuelisten und Cues ==
Für die Einblendzeit wird die in DMXControl definierte Zeit zum einblenden der Aktion aufgeführt. Werden Cuelisten gestartet/gestoppt wird die Fade- beziehungsweise Release-time als Einblendzeit angezeigt. Wird GoTo verwendet wird die "GoTo Time" der Cuelist angezeigt. Soll die Fadetime der entsprechenden Cuelist als Einblendzeit genutzt werden, so muss in der Cuelist die Option "Use Cue Time as GoTo Time" auf "True" gesetzt werden. Da das "GoTo" Kommando des Textbuches eigentlich auf dem "GoNext" Kommando von DMXControl beruht, sollten in der Cuelist im Bereich der "GoNext Behaviour" die Optionen "Start Cuelist" auf "True" und "Always use next Index" auf "False" stehen.

== Inputassignment ==
Je verwendetem Textbuch in einem Projekt kann eine beliebige Anzahl von Eingangsquellen angelegt werden. Diese erscheinen im Inputassignment unter dem Kapitel 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 Inputassignment-Kommando im Textbuch ist einstellbar, ob die entsprechende Variable bei betätigung auf "True" oder "False" gesetzt werden soll. Eine Einblendzeit wird für Inputassignment-Kommandos nicht angezeigt, da die Aktion instantan 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)
[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2020-01-25T10:58:20Z

Mic: /* Menüleiste */

{{Infobox Plugin
| Name = Textbuch
| Logo = Beispiel-Textbuch.png
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 1.3
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz = GLP
| Deutsch = ja
| Email =
| Homepage = http://www.dmxcontrol.de
| Download = https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/
}}
= Beschreibung =
Beim Textbuch handelt es sich um ein Plugin für DMXControl 3, um die Textbuchfunktionalität aus DMXControl 2 in der Version 3 zur Verfügung zu stellen. Für Theater- und Musicalveranstaltungen ist es essentiell Stimmungen und Effekte passgenau auf Zeitpunkte oder Stichwörter einzutakten. Das Textbuch wurde entwickelt, um bei Veranstaltungen mit festem Ablauf auf basis eines Textbuches/Drehbuches oder ähnlichem die passenden Funktionen von DMXControl 3 auszulösen.

= Installation =
Das Textbuchplugin kann im DMXControl Forum unter folgendem [https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/ Link] heruntergeladen werden. Im Installationsverzeichnis von DMXControl muss die enthaltene Datei "Textbook.dll" in das Unterverzeichnis "GUI/Plugins" verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im "Plugin Management" der Eintrag "Textbook Plugin" vorhanden sein. Nach aktivieren des Eintrags stehen die Textbuchfunktionalitäten zur Verfügung. Sollte der Eintrag nicht vorhanden sein, ist die DLL Datei eventuell von Windows blockiert und muss gegebenenfalls noch freigegeben oder DMXControl als Administrator gestartet werden.

= Bedienelemente =
Nach öffnen des Textbuches sollte sich ein Fenster gemäß untenstehender Abbildung öffnen.
{{Bild_mit_Unterschrift|Beispiel-Textbuch.png|1|Textbuch mit Beispieltext.|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# Drag and Drop Bereich
# Textbuch Bedien- und Statusleiste
# Befehlsliste

== Menüleiste ==
Die Menüleiste beinhaltet allgemeine Funktionen zum Speichern und Bearbeiten des Textbuch-Verhaltens.
{{Bild_mit_Unterschrift|Textbuch - Menüleiste.png|2|Menüleiste des Textbuch Plugins.|center|400px}}

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

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

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

== Bedien- und Statusleiste ==
Die Bedien- und Statusleiste umfasst eine Fortschrittsanzeige, Buttons für den Sprung zum nächsten beziehungsweise zum vorhergehenden Objekt sowie die Buttons "Go" und "Autoscroll". Zur einbindung des Textbuches in Softdesks oder zum anlegen von Shortcuts sind die Buttons der Bedienleiste auch über das Inputassignment ansteuerbar und können zum Beispiel mit externen Befehlsgebern oder Tasten verknüpft werden.
{{Bild_mit_Unterschrift|Textbuch - Status und Bedienleiste.png|4|Status- und Bedienleiste des Textbuch Plugins|center|800px}}
Je nach Einstellung wird mit "Go" zum nächsten Kommando oder zur nächsten Zeile gesprungen. Ebenso verhalten sich die Buttons "Back" und "Next", wobei hier die entsprechenden Kommandos nicht ausgeführt werden.
Sind die Optionen "scroll to next Item after Go" und "next Command after Go" kann mit der Option "Autoscroll" sanft zwischen den entsprechenden Zeilen gescrollt werden. Die Zeit, zum überblenden zwischen den Zeilen wird über den Parameter "Delta-t" des nachfolgenden Kommandos eingestellt.

== 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 - Sprechender Name für das Kommando, frei Konfigurierbar, dieser wird auch im Texteditor angezeigt
* Run - Button zum außertourlichen ausführen des Befehls (Button funktioniert, ist jedoch in aktueller Version nicht sichtbar)
* Typ - Typ des Kommandos (aktuell nur Cuelist oder Inputassignment)
* 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"
* Stichwort - Möglichkeit Stichwörter als Info für den Operator zu hinterlegen
* Kommentar - Möglichkeit 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 im Projektfile von DMXControl gespeichert. Da das Textbuch aktuell ein reines GUI-Plugin ist, werden die Textbücher rein von der GUI verarbeitet. Ein bearbeiten der Textbücher im betrieb mit mehreren Clients ist deshalb nicht möglich. Das zeitgleiche nutzen von Textbüchern ist jedoch möglich. Die Textbücher werden über den Projektexplorer verwaltet. Hier sollte eine neue Rubrik mit dem Namen "Textbook" vorhanden sein. Per Rechtsklick auf den Eintrag und "Create Textbook" kann ein neues Textbuch erstellt und mit doppelklick darauf geöffnet werden.

== Cuelisten und Cues ==
Für die Einblendzeit wird die in DMXControl definierte Zeit zum einblenden der Aktion aufgeführt. Werden Cuelisten gestartet/gestoppt wird die Fade- beziehungsweise Release-time als Einblendzeit angezeigt. Wird GoTo verwendet wird die "GoTo Time" der Cuelist angezeigt. Soll die Fadetime der entsprechenden Cuelist als Einblendzeit genutzt werden, so muss in der Cuelist die Option "Use Cue Time as GoTo Time" auf "True" gesetzt werden. Da das "GoTo" Kommando des Textbuches eigentlich auf dem "GoNext" Kommando von DMXControl beruht, sollten in der Cuelist im Bereich der "GoNext Behaviour" die Optionen "Start Cuelist" auf "True" und "Always use next Index" auf "False" stehen.

== Inputassignment ==
Je verwendetem Textbuch in einem Projekt kann eine beliebige Anzahl von Eingangsquellen angelegt werden. Diese erscheinen im Inputassignment unter dem Kapitel 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 Inputassignment-Kommando im Textbuch ist einstellbar, ob die entsprechende Variable bei betätigung auf "True" oder "False" gesetzt werden soll. Eine Einblendzeit wird für Inputassignment-Kommandos nicht angezeigt, da die Aktion instantan 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)
[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2020-01-22T23:06:23Z

Mic: /* Cuelisten und Cues */

{{Infobox Plugin
| Name = Textbuch
| Logo = Beispiel-Textbuch.png
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 1.3
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz = GLP
| Deutsch = ja
| Email =
| Homepage = http://www.dmxcontrol.de
| Download = https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/
}}
= Beschreibung =
Beim Textbuch handelt es sich um ein Plugin für DMXControl 3, um die Textbuchfunktionalität aus DMXControl 2 in der Version 3 zur Verfügung zu stellen. Für Theater- und Musicalveranstaltungen ist es essentiell Stimmungen und Effekte passgenau auf Zeitpunkte oder Stichwörter einzutakten. Das Textbuch wurde entwickelt, um bei Veranstaltungen mit festem Ablauf auf basis eines Textbuches/Drehbuches oder ähnlichem die passenden Funktionen von DMXControl 3 auszulösen.

= Installation =
Das Textbuchplugin kann im DMXControl Forum unter folgendem [https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/ Link] heruntergeladen werden. Im Installationsverzeichnis von DMXControl muss die enthaltene Datei "Textbook.dll" in das Unterverzeichnis "GUI/Plugins" verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im "Plugin Management" der Eintrag "Textbook Plugin" vorhanden sein. Nach aktivieren des Eintrags stehen die Textbuchfunktionalitäten zur Verfügung. Sollte der Eintrag nicht vorhanden sein, ist die DLL Datei eventuell von Windows blockiert und muss gegebenenfalls noch freigegeben oder DMXControl als Administrator gestartet werden.

= Bedienelemente =
Nach öffnen des Textbuches sollte sich ein Fenster gemäß untenstehender Abbildung öffnen.
{{Bild_mit_Unterschrift|Beispiel-Textbuch.png|1|Textbuch mit Beispieltext.|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# Drag and Drop Bereich
# Textbuch Bedien- und Statusleiste
# Befehlsliste

== Menüleiste ==
Die Menüleiste beinhaltet allgemeine Funktionen zum Speichern und Bearbeiten des Textbuch-Verhaltens.
{{Bild_mit_Unterschrift|Textbuch - Menüleiste.png|2|Menüleiste des Textbuch Plugins.|center|400px}}

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

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

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

== Bedien- und Statusleiste ==
Die Bedien- und Statusleiste umfasst eine Fortschrittsanzeige, Buttons für den Sprung zum nächsten beziehungsweise zum vorhergehenden Objekt sowie die Buttons "Go" und "Autoscroll". Zur einbindung des Textbuches in Softdesks oder zum anlegen von Shortcuts sind die Buttons der Bedienleiste auch über das Inputassignment ansteuerbar und können zum Beispiel mit externen Befehlsgebern oder Tasten verknüpft werden.
{{Bild_mit_Unterschrift|Textbuch - Status und Bedienleiste.png|4|Status- und Bedienleiste des Textbuch Plugins|center|800px}}
Je nach Einstellung wird mit "Go" zum nächsten Kommando oder zur nächsten Zeile gesprungen. Ebenso verhalten sich die Buttons "Back" und "Next", wobei hier die entsprechenden Kommandos nicht ausgeführt werden.
Sind die Optionen "scroll to next Item after Go" und "next Command after Go" kann mit der Option "Autoscroll" sanft zwischen den entsprechenden Zeilen gescrollt werden. Die Zeit, zum überblenden zwischen den Zeilen wird über den Parameter "Delta-t" des nachfolgenden Kommandos eingestellt.

== 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 - Sprechender Name für das Kommando, frei Konfigurierbar, dieser wird auch im Texteditor angezeigt
* Run - Button zum außertourlichen ausführen des Befehls (Button funktioniert, ist jedoch in aktueller Version nicht sichtbar)
* Typ - Typ des Kommandos (aktuell nur Cuelist oder Inputassignment)
* 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"
* Stichwort - Möglichkeit Stichwörter als Info für den Operator zu hinterlegen
* Kommentar - Möglichkeit 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 im Projektfile von DMXControl gespeichert. Da das Textbuch aktuell ein reines GUI-Plugin ist, werden die Textbücher rein von der GUI verarbeitet. Ein bearbeiten der Textbücher im betrieb mit mehreren Clients ist deshalb nicht möglich. Das zeitgleiche nutzen von Textbüchern ist jedoch möglich. Die Textbücher werden über den Projektexplorer verwaltet. Hier sollte eine neue Rubrik mit dem Namen "Textbook" vorhanden sein. Per Rechtsklick auf den Eintrag und "Create Textbook" kann ein neues Textbuch erstellt und mit doppelklick darauf geöffnet werden.

== Cuelisten und Cues ==
Für die Einblendzeit wird die in DMXControl definierte Zeit zum einblenden der Aktion aufgeführt. Werden Cuelisten gestartet/gestoppt wird die Fade- beziehungsweise Release-time als Einblendzeit angezeigt. Wird GoTo verwendet wird die "GoTo Time" der Cuelist angezeigt. Soll die Fadetime der entsprechenden Cuelist als Einblendzeit genutzt werden, so muss in der Cuelist die Option "Use Cue Time as GoTo Time" auf "True" gesetzt werden. Da das "GoTo" Kommando des Textbuches eigentlich auf dem "GoNext" Kommando von DMXControl beruht, sollten in der Cuelist im Bereich der "GoNext Behaviour" die Optionen "Start Cuelist" auf "True" und "Always use next Index" auf "False" stehen.

== Inputassignment ==
Je verwendetem Textbuch in einem Projekt kann eine beliebige Anzahl von Eingangsquellen angelegt werden. Diese erscheinen im Inputassignment unter dem Kapitel 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 Inputassignment-Kommando im Textbuch ist einstellbar, ob die entsprechende Variable bei betätigung auf "True" oder "False" gesetzt werden soll. Eine Einblendzeit wird für Inputassignment-Kommandos nicht angezeigt, da die Aktion instantan 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)
[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2020-01-22T22:58:48Z

Mic: /* Input Assignment */

{{Infobox Plugin
| Name = Textbuch
| Logo = Beispiel-Textbuch.png
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 1.3
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz = GLP
| Deutsch = ja
| Email =
| Homepage = http://www.dmxcontrol.de
| Download = https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/
}}
= Beschreibung =
Beim Textbuch handelt es sich um ein Plugin für DMXControl 3, um die Textbuchfunktionalität aus DMXControl 2 in der Version 3 zur Verfügung zu stellen. Für Theater- und Musicalveranstaltungen ist es essentiell Stimmungen und Effekte passgenau auf Zeitpunkte oder Stichwörter einzutakten. Das Textbuch wurde entwickelt, um bei Veranstaltungen mit festem Ablauf auf basis eines Textbuches/Drehbuches oder ähnlichem die passenden Funktionen von DMXControl 3 auszulösen.

= Installation =
Das Textbuchplugin kann im DMXControl Forum unter folgendem [https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/ Link] heruntergeladen werden. Im Installationsverzeichnis von DMXControl muss die enthaltene Datei "Textbook.dll" in das Unterverzeichnis "GUI/Plugins" verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im "Plugin Management" der Eintrag "Textbook Plugin" vorhanden sein. Nach aktivieren des Eintrags stehen die Textbuchfunktionalitäten zur Verfügung. Sollte der Eintrag nicht vorhanden sein, ist die DLL Datei eventuell von Windows blockiert und muss gegebenenfalls noch freigegeben oder DMXControl als Administrator gestartet werden.

= Bedienelemente =
Nach öffnen des Textbuches sollte sich ein Fenster gemäß untenstehender Abbildung öffnen.
{{Bild_mit_Unterschrift|Beispiel-Textbuch.png|1|Textbuch mit Beispieltext.|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# Drag and Drop Bereich
# Textbuch Bedien- und Statusleiste
# Befehlsliste

== Menüleiste ==
Die Menüleiste beinhaltet allgemeine Funktionen zum Speichern und Bearbeiten des Textbuch-Verhaltens.
{{Bild_mit_Unterschrift|Textbuch - Menüleiste.png|2|Menüleiste des Textbuch Plugins.|center|400px}}

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

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

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

== Bedien- und Statusleiste ==
Die Bedien- und Statusleiste umfasst eine Fortschrittsanzeige, Buttons für den Sprung zum nächsten beziehungsweise zum vorhergehenden Objekt sowie die Buttons "Go" und "Autoscroll". Zur einbindung des Textbuches in Softdesks oder zum anlegen von Shortcuts sind die Buttons der Bedienleiste auch über das Inputassignment ansteuerbar und können zum Beispiel mit externen Befehlsgebern oder Tasten verknüpft werden.
{{Bild_mit_Unterschrift|Textbuch - Status und Bedienleiste.png|4|Status- und Bedienleiste des Textbuch Plugins|center|800px}}
Je nach Einstellung wird mit "Go" zum nächsten Kommando oder zur nächsten Zeile gesprungen. Ebenso verhalten sich die Buttons "Back" und "Next", wobei hier die entsprechenden Kommandos nicht ausgeführt werden.
Sind die Optionen "scroll to next Item after Go" und "next Command after Go" kann mit der Option "Autoscroll" sanft zwischen den entsprechenden Zeilen gescrollt werden. Die Zeit, zum überblenden zwischen den Zeilen wird über den Parameter "Delta-t" des nachfolgenden Kommandos eingestellt.

== 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 - Sprechender Name für das Kommando, frei Konfigurierbar, dieser wird auch im Texteditor angezeigt
* Run - Button zum außertourlichen ausführen des Befehls (Button funktioniert, ist jedoch in aktueller Version nicht sichtbar)
* Typ - Typ des Kommandos (aktuell nur Cuelist oder Inputassignment)
* 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"
* Stichwort - Möglichkeit Stichwörter als Info für den Operator zu hinterlegen
* Kommentar - Möglichkeit 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 im Projektfile von DMXControl gespeichert. Da das Textbuch aktuell ein reines GUI-Plugin ist, werden die Textbücher rein von der GUI verarbeitet. Ein bearbeiten der Textbücher im betrieb mit mehreren Clients ist deshalb nicht möglich. Das zeitgleiche nutzen von Textbüchern ist jedoch möglich. Die Textbücher werden über den Projektexplorer verwaltet. Hier sollte eine neue Rubrik mit dem Namen "Textbook" vorhanden sein. Per Rechtsklick auf den Eintrag und "Create Textbook" kann ein neues Textbuch erstellt und mit doppelklick darauf geöffnet werden.

== Cuelisten und Cues ==

== Inputassignment ==
Je verwendetem Textbuch in einem Projekt kann eine beliebige Anzahl von Eingangsquellen angelegt werden. Diese erscheinen im Inputassignment unter dem Kapitel 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 Inputassignment-Kommando im Textbuch ist einstellbar, ob die entsprechende Variable bei betätigung auf "True" oder "False" gesetzt werden soll. Eine Einblendzeit wird für Inputassignment-Kommandos nicht angezeigt, da die Aktion instantan 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)
[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2020-01-22T22:53:35Z

Mic: /* Nutzung */

{{Infobox Plugin
| Name = Textbuch
| Logo = Beispiel-Textbuch.png
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 1.3
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz = GLP
| Deutsch = ja
| Email =
| Homepage = http://www.dmxcontrol.de
| Download = https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/
}}
= Beschreibung =
Beim Textbuch handelt es sich um ein Plugin für DMXControl 3, um die Textbuchfunktionalität aus DMXControl 2 in der Version 3 zur Verfügung zu stellen. Für Theater- und Musicalveranstaltungen ist es essentiell Stimmungen und Effekte passgenau auf Zeitpunkte oder Stichwörter einzutakten. Das Textbuch wurde entwickelt, um bei Veranstaltungen mit festem Ablauf auf basis eines Textbuches/Drehbuches oder ähnlichem die passenden Funktionen von DMXControl 3 auszulösen.

= Installation =
Das Textbuchplugin kann im DMXControl Forum unter folgendem [https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/ Link] heruntergeladen werden. Im Installationsverzeichnis von DMXControl muss die enthaltene Datei "Textbook.dll" in das Unterverzeichnis "GUI/Plugins" verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im "Plugin Management" der Eintrag "Textbook Plugin" vorhanden sein. Nach aktivieren des Eintrags stehen die Textbuchfunktionalitäten zur Verfügung. Sollte der Eintrag nicht vorhanden sein, ist die DLL Datei eventuell von Windows blockiert und muss gegebenenfalls noch freigegeben oder DMXControl als Administrator gestartet werden.

= Bedienelemente =
Nach öffnen des Textbuches sollte sich ein Fenster gemäß untenstehender Abbildung öffnen.
{{Bild_mit_Unterschrift|Beispiel-Textbuch.png|1|Textbuch mit Beispieltext.|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# Drag and Drop Bereich
# Textbuch Bedien- und Statusleiste
# Befehlsliste

== Menüleiste ==
Die Menüleiste beinhaltet allgemeine Funktionen zum Speichern und Bearbeiten des Textbuch-Verhaltens.
{{Bild_mit_Unterschrift|Textbuch - Menüleiste.png|2|Menüleiste des Textbuch Plugins.|center|400px}}

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

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

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

== Bedien- und Statusleiste ==
Die Bedien- und Statusleiste umfasst eine Fortschrittsanzeige, Buttons für den Sprung zum nächsten beziehungsweise zum vorhergehenden Objekt sowie die Buttons "Go" und "Autoscroll". Zur einbindung des Textbuches in Softdesks oder zum anlegen von Shortcuts sind die Buttons der Bedienleiste auch über das Inputassignment ansteuerbar und können zum Beispiel mit externen Befehlsgebern oder Tasten verknüpft werden.
{{Bild_mit_Unterschrift|Textbuch - Status und Bedienleiste.png|4|Status- und Bedienleiste des Textbuch Plugins|center|800px}}
Je nach Einstellung wird mit "Go" zum nächsten Kommando oder zur nächsten Zeile gesprungen. Ebenso verhalten sich die Buttons "Back" und "Next", wobei hier die entsprechenden Kommandos nicht ausgeführt werden.
Sind die Optionen "scroll to next Item after Go" und "next Command after Go" kann mit der Option "Autoscroll" sanft zwischen den entsprechenden Zeilen gescrollt werden. Die Zeit, zum überblenden zwischen den Zeilen wird über den Parameter "Delta-t" des nachfolgenden Kommandos eingestellt.

== 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 - Sprechender Name für das Kommando, frei Konfigurierbar, dieser wird auch im Texteditor angezeigt
* Run - Button zum außertourlichen ausführen des Befehls (Button funktioniert, ist jedoch in aktueller Version nicht sichtbar)
* Typ - Typ des Kommandos (aktuell nur Cuelist oder Inputassignment)
* 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"
* Stichwort - Möglichkeit Stichwörter als Info für den Operator zu hinterlegen
* Kommentar - Möglichkeit 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 im Projektfile von DMXControl gespeichert. Da das Textbuch aktuell ein reines GUI-Plugin ist, werden die Textbücher rein von der GUI verarbeitet. Ein bearbeiten der Textbücher im betrieb mit mehreren Clients ist deshalb nicht möglich. Das zeitgleiche nutzen von Textbüchern ist jedoch möglich. Die Textbücher werden über den Projektexplorer verwaltet. Hier sollte eine neue Rubrik mit dem Namen "Textbook" vorhanden sein. Per Rechtsklick auf den Eintrag und "Create Textbook" kann ein neues Textbuch erstellt und mit doppelklick darauf geöffnet werden.

== Cuelisten und Cues ==

== Input Assignment ==

= 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)
[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2020-01-22T22:52:57Z

Mic: /* Bekannte Bugs / Features */

{{Infobox Plugin
| Name = Textbuch
| Logo = Beispiel-Textbuch.png
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 1.3
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz = GLP
| Deutsch = ja
| Email =
| Homepage = http://www.dmxcontrol.de
| Download = https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/
}}
= Beschreibung =
Beim Textbuch handelt es sich um ein Plugin für DMXControl 3, um die Textbuchfunktionalität aus DMXControl 2 in der Version 3 zur Verfügung zu stellen. Für Theater- und Musicalveranstaltungen ist es essentiell Stimmungen und Effekte passgenau auf Zeitpunkte oder Stichwörter einzutakten. Das Textbuch wurde entwickelt, um bei Veranstaltungen mit festem Ablauf auf basis eines Textbuches/Drehbuches oder ähnlichem die passenden Funktionen von DMXControl 3 auszulösen.

= Installation =
Das Textbuchplugin kann im DMXControl Forum unter folgendem [https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/ Link] heruntergeladen werden. Im Installationsverzeichnis von DMXControl muss die enthaltene Datei "Textbook.dll" in das Unterverzeichnis "GUI/Plugins" verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im "Plugin Management" der Eintrag "Textbook Plugin" vorhanden sein. Nach aktivieren des Eintrags stehen die Textbuchfunktionalitäten zur Verfügung. Sollte der Eintrag nicht vorhanden sein, ist die DLL Datei eventuell von Windows blockiert und muss gegebenenfalls noch freigegeben oder DMXControl als Administrator gestartet werden.

= Bedienelemente =
Nach öffnen des Textbuches sollte sich ein Fenster gemäß untenstehender Abbildung öffnen.
{{Bild_mit_Unterschrift|Beispiel-Textbuch.png|1|Textbuch mit Beispieltext.|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# Drag and Drop Bereich
# Textbuch Bedien- und Statusleiste
# Befehlsliste

== Menüleiste ==
Die Menüleiste beinhaltet allgemeine Funktionen zum Speichern und Bearbeiten des Textbuch-Verhaltens.
{{Bild_mit_Unterschrift|Textbuch - Menüleiste.png|2|Menüleiste des Textbuch Plugins.|center|400px}}

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

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

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

== Bedien- und Statusleiste ==
Die Bedien- und Statusleiste umfasst eine Fortschrittsanzeige, Buttons für den Sprung zum nächsten beziehungsweise zum vorhergehenden Objekt sowie die Buttons "Go" und "Autoscroll". Zur einbindung des Textbuches in Softdesks oder zum anlegen von Shortcuts sind die Buttons der Bedienleiste auch über das Inputassignment ansteuerbar und können zum Beispiel mit externen Befehlsgebern oder Tasten verknüpft werden.
{{Bild_mit_Unterschrift|Textbuch - Status und Bedienleiste.png|4|Status- und Bedienleiste des Textbuch Plugins|center|800px}}
Je nach Einstellung wird mit "Go" zum nächsten Kommando oder zur nächsten Zeile gesprungen. Ebenso verhalten sich die Buttons "Back" und "Next", wobei hier die entsprechenden Kommandos nicht ausgeführt werden.
Sind die Optionen "scroll to next Item after Go" und "next Command after Go" kann mit der Option "Autoscroll" sanft zwischen den entsprechenden Zeilen gescrollt werden. Die Zeit, zum überblenden zwischen den Zeilen wird über den Parameter "Delta-t" des nachfolgenden Kommandos eingestellt.

== 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 - Sprechender Name für das Kommando, frei Konfigurierbar, dieser wird auch im Texteditor angezeigt
* Run - Button zum außertourlichen ausführen des Befehls (Button funktioniert, ist jedoch in aktueller Version nicht sichtbar)
* Typ - Typ des Kommandos (aktuell nur Cuelist oder Inputassignment)
* 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"
* Stichwort - Möglichkeit Stichwörter als Info für den Operator zu hinterlegen
* Kommentar - Möglichkeit 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 =
== Textbuch anlegen ==
Die Textbücher werden komplett im Projektfile von DMXControl gespeichert. Da das Textbuch aktuell ein reines GUI-Plugin ist, werden die Textbücher rein von der GUI verarbeitet. Ein bearbeiten der Textbücher im betrieb mit mehreren Clients ist deshalb nicht möglich. Das zeitgleiche nutzen von Textbüchern ist jedoch möglich. Die Textbücher werden über den Projektexplorer verwaltet. Hier sollte eine neue Rubrik mit dem Namen "Textbook" vorhanden sein. Per Rechtsklick auf den Eintrag und "Create Textbook" kann ein neues Textbuch erstellt und mit doppelklick darauf geöffnet werden.

== Cuelisten und Cues ==

== Input Assignment ==

= 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)
[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2020-01-22T22:51:57Z

Mic: /* Bekannte Bugs / Features */

{{Infobox Plugin
| Name = Textbuch
| Logo = Beispiel-Textbuch.png
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 1.3
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz = GLP
| Deutsch = ja
| Email =
| Homepage = http://www.dmxcontrol.de
| Download = https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/
}}
= Beschreibung =
Beim Textbuch handelt es sich um ein Plugin für DMXControl 3, um die Textbuchfunktionalität aus DMXControl 2 in der Version 3 zur Verfügung zu stellen. Für Theater- und Musicalveranstaltungen ist es essentiell Stimmungen und Effekte passgenau auf Zeitpunkte oder Stichwörter einzutakten. Das Textbuch wurde entwickelt, um bei Veranstaltungen mit festem Ablauf auf basis eines Textbuches/Drehbuches oder ähnlichem die passenden Funktionen von DMXControl 3 auszulösen.

= Installation =
Das Textbuchplugin kann im DMXControl Forum unter folgendem [https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/ Link] heruntergeladen werden. Im Installationsverzeichnis von DMXControl muss die enthaltene Datei "Textbook.dll" in das Unterverzeichnis "GUI/Plugins" verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im "Plugin Management" der Eintrag "Textbook Plugin" vorhanden sein. Nach aktivieren des Eintrags stehen die Textbuchfunktionalitäten zur Verfügung. Sollte der Eintrag nicht vorhanden sein, ist die DLL Datei eventuell von Windows blockiert und muss gegebenenfalls noch freigegeben oder DMXControl als Administrator gestartet werden.

= Bedienelemente =
Nach öffnen des Textbuches sollte sich ein Fenster gemäß untenstehender Abbildung öffnen.
{{Bild_mit_Unterschrift|Beispiel-Textbuch.png|1|Textbuch mit Beispieltext.|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# Drag and Drop Bereich
# Textbuch Bedien- und Statusleiste
# Befehlsliste

== Menüleiste ==
Die Menüleiste beinhaltet allgemeine Funktionen zum Speichern und Bearbeiten des Textbuch-Verhaltens.
{{Bild_mit_Unterschrift|Textbuch - Menüleiste.png|2|Menüleiste des Textbuch Plugins.|center|400px}}

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

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

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

== Bedien- und Statusleiste ==
Die Bedien- und Statusleiste umfasst eine Fortschrittsanzeige, Buttons für den Sprung zum nächsten beziehungsweise zum vorhergehenden Objekt sowie die Buttons "Go" und "Autoscroll". Zur einbindung des Textbuches in Softdesks oder zum anlegen von Shortcuts sind die Buttons der Bedienleiste auch über das Inputassignment ansteuerbar und können zum Beispiel mit externen Befehlsgebern oder Tasten verknüpft werden.
{{Bild_mit_Unterschrift|Textbuch - Status und Bedienleiste.png|4|Status- und Bedienleiste des Textbuch Plugins|center|800px}}
Je nach Einstellung wird mit "Go" zum nächsten Kommando oder zur nächsten Zeile gesprungen. Ebenso verhalten sich die Buttons "Back" und "Next", wobei hier die entsprechenden Kommandos nicht ausgeführt werden.
Sind die Optionen "scroll to next Item after Go" und "next Command after Go" kann mit der Option "Autoscroll" sanft zwischen den entsprechenden Zeilen gescrollt werden. Die Zeit, zum überblenden zwischen den Zeilen wird über den Parameter "Delta-t" des nachfolgenden Kommandos eingestellt.

== 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 - Sprechender Name für das Kommando, frei Konfigurierbar, dieser wird auch im Texteditor angezeigt
* Run - Button zum außertourlichen ausführen des Befehls (Button funktioniert, ist jedoch in aktueller Version nicht sichtbar)
* Typ - Typ des Kommandos (aktuell nur Cuelist oder Inputassignment)
* 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"
* Stichwort - Möglichkeit Stichwörter als Info für den Operator zu hinterlegen
* Kommentar - Möglichkeit 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 =
== Textbuch anlegen ==
Die Textbücher werden komplett im Projektfile von DMXControl gespeichert. Da das Textbuch aktuell ein reines GUI-Plugin ist, werden die Textbücher rein von der GUI verarbeitet. Ein bearbeiten der Textbücher im betrieb mit mehreren Clients ist deshalb nicht möglich. Das zeitgleiche nutzen von Textbüchern ist jedoch möglich. Die Textbücher werden über den Projektexplorer verwaltet. Hier sollte eine neue Rubrik mit dem Namen "Textbook" vorhanden sein. Per Rechtsklick auf den Eintrag und "Create Textbook" kann ein neues Textbuch erstellt und mit doppelklick darauf geöffnet werden.

== Cuelisten und Cues ==

== Input Assignment ==

= 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
[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2020-01-22T22:50:17Z

Mic: /* Nutzung */

{{Infobox Plugin
| Name = Textbuch
| Logo = Beispiel-Textbuch.png
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 1.3
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz = GLP
| Deutsch = ja
| Email =
| Homepage = http://www.dmxcontrol.de
| Download = https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/
}}
= Beschreibung =
Beim Textbuch handelt es sich um ein Plugin für DMXControl 3, um die Textbuchfunktionalität aus DMXControl 2 in der Version 3 zur Verfügung zu stellen. Für Theater- und Musicalveranstaltungen ist es essentiell Stimmungen und Effekte passgenau auf Zeitpunkte oder Stichwörter einzutakten. Das Textbuch wurde entwickelt, um bei Veranstaltungen mit festem Ablauf auf basis eines Textbuches/Drehbuches oder ähnlichem die passenden Funktionen von DMXControl 3 auszulösen.

= Installation =
Das Textbuchplugin kann im DMXControl Forum unter folgendem [https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/ Link] heruntergeladen werden. Im Installationsverzeichnis von DMXControl muss die enthaltene Datei "Textbook.dll" in das Unterverzeichnis "GUI/Plugins" verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im "Plugin Management" der Eintrag "Textbook Plugin" vorhanden sein. Nach aktivieren des Eintrags stehen die Textbuchfunktionalitäten zur Verfügung. Sollte der Eintrag nicht vorhanden sein, ist die DLL Datei eventuell von Windows blockiert und muss gegebenenfalls noch freigegeben oder DMXControl als Administrator gestartet werden.

= Bedienelemente =
Nach öffnen des Textbuches sollte sich ein Fenster gemäß untenstehender Abbildung öffnen.
{{Bild_mit_Unterschrift|Beispiel-Textbuch.png|1|Textbuch mit Beispieltext.|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# Drag and Drop Bereich
# Textbuch Bedien- und Statusleiste
# Befehlsliste

== Menüleiste ==
Die Menüleiste beinhaltet allgemeine Funktionen zum Speichern und Bearbeiten des Textbuch-Verhaltens.
{{Bild_mit_Unterschrift|Textbuch - Menüleiste.png|2|Menüleiste des Textbuch Plugins.|center|400px}}

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

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

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

== Bedien- und Statusleiste ==
Die Bedien- und Statusleiste umfasst eine Fortschrittsanzeige, Buttons für den Sprung zum nächsten beziehungsweise zum vorhergehenden Objekt sowie die Buttons "Go" und "Autoscroll". Zur einbindung des Textbuches in Softdesks oder zum anlegen von Shortcuts sind die Buttons der Bedienleiste auch über das Inputassignment ansteuerbar und können zum Beispiel mit externen Befehlsgebern oder Tasten verknüpft werden.
{{Bild_mit_Unterschrift|Textbuch - Status und Bedienleiste.png|4|Status- und Bedienleiste des Textbuch Plugins|center|800px}}
Je nach Einstellung wird mit "Go" zum nächsten Kommando oder zur nächsten Zeile gesprungen. Ebenso verhalten sich die Buttons "Back" und "Next", wobei hier die entsprechenden Kommandos nicht ausgeführt werden.
Sind die Optionen "scroll to next Item after Go" und "next Command after Go" kann mit der Option "Autoscroll" sanft zwischen den entsprechenden Zeilen gescrollt werden. Die Zeit, zum überblenden zwischen den Zeilen wird über den Parameter "Delta-t" des nachfolgenden Kommandos eingestellt.

== 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 - Sprechender Name für das Kommando, frei Konfigurierbar, dieser wird auch im Texteditor angezeigt
* Run - Button zum außertourlichen ausführen des Befehls (Button funktioniert, ist jedoch in aktueller Version nicht sichtbar)
* Typ - Typ des Kommandos (aktuell nur Cuelist oder Inputassignment)
* 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"
* Stichwort - Möglichkeit Stichwörter als Info für den Operator zu hinterlegen
* Kommentar - Möglichkeit 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 =
== Textbuch anlegen ==
Die Textbücher werden komplett im Projektfile von DMXControl gespeichert. Da das Textbuch aktuell ein reines GUI-Plugin ist, werden die Textbücher rein von der GUI verarbeitet. Ein bearbeiten der Textbücher im betrieb mit mehreren Clients ist deshalb nicht möglich. Das zeitgleiche nutzen von Textbüchern ist jedoch möglich. Die Textbücher werden über den Projektexplorer verwaltet. Hier sollte eine neue Rubrik mit dem Namen "Textbook" vorhanden sein. Per Rechtsklick auf den Eintrag und "Create Textbook" kann ein neues Textbuch erstellt und mit doppelklick darauf geöffnet werden.

== Cuelisten und Cues ==

== Input Assignment ==

= Bekannte Bugs / Features =
[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2020-01-22T22:49:31Z

Mic: /* Externe Ansteuerung */

{{Infobox Plugin
| Name = Textbuch
| Logo = Beispiel-Textbuch.png
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 1.3
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz = GLP
| Deutsch = ja
| Email =
| Homepage = http://www.dmxcontrol.de
| Download = https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/
}}
= Beschreibung =
Beim Textbuch handelt es sich um ein Plugin für DMXControl 3, um die Textbuchfunktionalität aus DMXControl 2 in der Version 3 zur Verfügung zu stellen. Für Theater- und Musicalveranstaltungen ist es essentiell Stimmungen und Effekte passgenau auf Zeitpunkte oder Stichwörter einzutakten. Das Textbuch wurde entwickelt, um bei Veranstaltungen mit festem Ablauf auf basis eines Textbuches/Drehbuches oder ähnlichem die passenden Funktionen von DMXControl 3 auszulösen.

= Installation =
Das Textbuchplugin kann im DMXControl Forum unter folgendem [https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/ Link] heruntergeladen werden. Im Installationsverzeichnis von DMXControl muss die enthaltene Datei "Textbook.dll" in das Unterverzeichnis "GUI/Plugins" verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im "Plugin Management" der Eintrag "Textbook Plugin" vorhanden sein. Nach aktivieren des Eintrags stehen die Textbuchfunktionalitäten zur Verfügung. Sollte der Eintrag nicht vorhanden sein, ist die DLL Datei eventuell von Windows blockiert und muss gegebenenfalls noch freigegeben oder DMXControl als Administrator gestartet werden.

= Bedienelemente =
Nach öffnen des Textbuches sollte sich ein Fenster gemäß untenstehender Abbildung öffnen.
{{Bild_mit_Unterschrift|Beispiel-Textbuch.png|1|Textbuch mit Beispieltext.|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# Drag and Drop Bereich
# Textbuch Bedien- und Statusleiste
# Befehlsliste

== Menüleiste ==
Die Menüleiste beinhaltet allgemeine Funktionen zum Speichern und Bearbeiten des Textbuch-Verhaltens.
{{Bild_mit_Unterschrift|Textbuch - Menüleiste.png|2|Menüleiste des Textbuch Plugins.|center|400px}}

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

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

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

== Bedien- und Statusleiste ==
Die Bedien- und Statusleiste umfasst eine Fortschrittsanzeige, Buttons für den Sprung zum nächsten beziehungsweise zum vorhergehenden Objekt sowie die Buttons "Go" und "Autoscroll". Zur einbindung des Textbuches in Softdesks oder zum anlegen von Shortcuts sind die Buttons der Bedienleiste auch über das Inputassignment ansteuerbar und können zum Beispiel mit externen Befehlsgebern oder Tasten verknüpft werden.
{{Bild_mit_Unterschrift|Textbuch - Status und Bedienleiste.png|4|Status- und Bedienleiste des Textbuch Plugins|center|800px}}
Je nach Einstellung wird mit "Go" zum nächsten Kommando oder zur nächsten Zeile gesprungen. Ebenso verhalten sich die Buttons "Back" und "Next", wobei hier die entsprechenden Kommandos nicht ausgeführt werden.
Sind die Optionen "scroll to next Item after Go" und "next Command after Go" kann mit der Option "Autoscroll" sanft zwischen den entsprechenden Zeilen gescrollt werden. Die Zeit, zum überblenden zwischen den Zeilen wird über den Parameter "Delta-t" des nachfolgenden Kommandos eingestellt.

== 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 - Sprechender Name für das Kommando, frei Konfigurierbar, dieser wird auch im Texteditor angezeigt
* Run - Button zum außertourlichen ausführen des Befehls (Button funktioniert, ist jedoch in aktueller Version nicht sichtbar)
* Typ - Typ des Kommandos (aktuell nur Cuelist oder Inputassignment)
* 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"
* Stichwort - Möglichkeit Stichwörter als Info für den Operator zu hinterlegen
* Kommentar - Möglichkeit 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 =
== Textbuch anlegen ==
Die Textbücher werden komplett im Projektfile von DMXControl gespeichert. Da das Textbuch aktuell ein reines GUI-Plugin ist, werden die Textbücher rein von der GUI verarbeitet. Ein bearbeiten der Textbücher im betrieb mit mehreren Clients ist deshalb nicht möglich. Das zeitgleiche nutzen von Textbüchern ist jedoch möglich. Die Textbücher werden über den Projektexplorer verwaltet. Hier sollte eine neue Rubrik mit dem Namen "Textbook" vorhanden sein. Per Rechtsklick auf den Eintrag und "Create Textbook" kann ein neues Textbuch erstellt und mit doppelklick darauf geöffnet werden.

== Cuelisten und Cues ==

== Input Assignment ==

[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2020-01-22T22:49:09Z

Mic: /* Drag 'n' Drop Bereich */

{{Infobox Plugin
| Name = Textbuch
| Logo = Beispiel-Textbuch.png
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 1.3
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz = GLP
| Deutsch = ja
| Email =
| Homepage = http://www.dmxcontrol.de
| Download = https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/
}}
= Beschreibung =
Beim Textbuch handelt es sich um ein Plugin für DMXControl 3, um die Textbuchfunktionalität aus DMXControl 2 in der Version 3 zur Verfügung zu stellen. Für Theater- und Musicalveranstaltungen ist es essentiell Stimmungen und Effekte passgenau auf Zeitpunkte oder Stichwörter einzutakten. Das Textbuch wurde entwickelt, um bei Veranstaltungen mit festem Ablauf auf basis eines Textbuches/Drehbuches oder ähnlichem die passenden Funktionen von DMXControl 3 auszulösen.

= Installation =
Das Textbuchplugin kann im DMXControl Forum unter folgendem [https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/ Link] heruntergeladen werden. Im Installationsverzeichnis von DMXControl muss die enthaltene Datei "Textbook.dll" in das Unterverzeichnis "GUI/Plugins" verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im "Plugin Management" der Eintrag "Textbook Plugin" vorhanden sein. Nach aktivieren des Eintrags stehen die Textbuchfunktionalitäten zur Verfügung. Sollte der Eintrag nicht vorhanden sein, ist die DLL Datei eventuell von Windows blockiert und muss gegebenenfalls noch freigegeben oder DMXControl als Administrator gestartet werden.

= Bedienelemente =
Nach öffnen des Textbuches sollte sich ein Fenster gemäß untenstehender Abbildung öffnen.
{{Bild_mit_Unterschrift|Beispiel-Textbuch.png|1|Textbuch mit Beispieltext.|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# Drag and Drop Bereich
# Textbuch Bedien- und Statusleiste
# Befehlsliste

== Menüleiste ==
Die Menüleiste beinhaltet allgemeine Funktionen zum Speichern und Bearbeiten des Textbuch-Verhaltens.
{{Bild_mit_Unterschrift|Textbuch - Menüleiste.png|2|Menüleiste des Textbuch Plugins.|center|400px}}

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

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

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

== Bedien- und Statusleiste ==
Die Bedien- und Statusleiste umfasst eine Fortschrittsanzeige, Buttons für den Sprung zum nächsten beziehungsweise zum vorhergehenden Objekt sowie die Buttons "Go" und "Autoscroll". Zur einbindung des Textbuches in Softdesks oder zum anlegen von Shortcuts sind die Buttons der Bedienleiste auch über das Inputassignment ansteuerbar und können zum Beispiel mit externen Befehlsgebern oder Tasten verknüpft werden.
{{Bild_mit_Unterschrift|Textbuch - Status und Bedienleiste.png|4|Status- und Bedienleiste des Textbuch Plugins|center|800px}}
Je nach Einstellung wird mit "Go" zum nächsten Kommando oder zur nächsten Zeile gesprungen. Ebenso verhalten sich die Buttons "Back" und "Next", wobei hier die entsprechenden Kommandos nicht ausgeführt werden.
Sind die Optionen "scroll to next Item after Go" und "next Command after Go" kann mit der Option "Autoscroll" sanft zwischen den entsprechenden Zeilen gescrollt werden. Die Zeit, zum überblenden zwischen den Zeilen wird über den Parameter "Delta-t" des nachfolgenden Kommandos eingestellt.

== 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 - Sprechender Name für das Kommando, frei Konfigurierbar, dieser wird auch im Texteditor angezeigt
* Run - Button zum außertourlichen ausführen des Befehls (Button funktioniert, ist jedoch in aktueller Version nicht sichtbar)
* Typ - Typ des Kommandos (aktuell nur Cuelist oder Inputassignment)
* 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"
* Stichwort - Möglichkeit Stichwörter als Info für den Operator zu hinterlegen
* Kommentar - Möglichkeit 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 =
== Textbuch anlegen ==
Die Textbücher werden komplett im Projektfile von DMXControl gespeichert. Da das Textbuch aktuell ein reines GUI-Plugin ist, werden die Textbücher rein von der GUI verarbeitet. Ein bearbeiten der Textbücher im betrieb mit mehreren Clients ist deshalb nicht möglich. Das zeitgleiche nutzen von Textbüchern ist jedoch möglich. Die Textbücher werden über den Projektexplorer verwaltet. Hier sollte eine neue Rubrik mit dem Namen "Textbook" vorhanden sein. Per Rechtsklick auf den Eintrag und "Create Textbook" kann ein neues Textbuch erstellt und mit doppelklick darauf geöffnet werden.

= Externe Ansteuerung =
== Cuelisten und Cues ==

== Input Assignment ==

[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2020-01-22T22:48:51Z

Mic: /* Befehlsliste */

{{Infobox Plugin
| Name = Textbuch
| Logo = Beispiel-Textbuch.png
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 1.3
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz = GLP
| Deutsch = ja
| Email =
| Homepage = http://www.dmxcontrol.de
| Download = https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/
}}
= Beschreibung =
Beim Textbuch handelt es sich um ein Plugin für DMXControl 3, um die Textbuchfunktionalität aus DMXControl 2 in der Version 3 zur Verfügung zu stellen. Für Theater- und Musicalveranstaltungen ist es essentiell Stimmungen und Effekte passgenau auf Zeitpunkte oder Stichwörter einzutakten. Das Textbuch wurde entwickelt, um bei Veranstaltungen mit festem Ablauf auf basis eines Textbuches/Drehbuches oder ähnlichem die passenden Funktionen von DMXControl 3 auszulösen.

= Installation =
Das Textbuchplugin kann im DMXControl Forum unter folgendem [https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/ Link] heruntergeladen werden. Im Installationsverzeichnis von DMXControl muss die enthaltene Datei "Textbook.dll" in das Unterverzeichnis "GUI/Plugins" verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im "Plugin Management" der Eintrag "Textbook Plugin" vorhanden sein. Nach aktivieren des Eintrags stehen die Textbuchfunktionalitäten zur Verfügung. Sollte der Eintrag nicht vorhanden sein, ist die DLL Datei eventuell von Windows blockiert und muss gegebenenfalls noch freigegeben oder DMXControl als Administrator gestartet werden.

= Bedienelemente =
Nach öffnen des Textbuches sollte sich ein Fenster gemäß untenstehender Abbildung öffnen.
{{Bild_mit_Unterschrift|Beispiel-Textbuch.png|1|Textbuch mit Beispieltext.|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# Drag and Drop Bereich
# Textbuch Bedien- und Statusleiste
# Befehlsliste

== Menüleiste ==
Die Menüleiste beinhaltet allgemeine Funktionen zum Speichern und Bearbeiten des Textbuch-Verhaltens.
{{Bild_mit_Unterschrift|Textbuch - Menüleiste.png|2|Menüleiste des Textbuch Plugins.|center|400px}}

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

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

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

== Bedien- und Statusleiste ==
Die Bedien- und Statusleiste umfasst eine Fortschrittsanzeige, Buttons für den Sprung zum nächsten beziehungsweise zum vorhergehenden Objekt sowie die Buttons "Go" und "Autoscroll". Zur einbindung des Textbuches in Softdesks oder zum anlegen von Shortcuts sind die Buttons der Bedienleiste auch über das Inputassignment ansteuerbar und können zum Beispiel mit externen Befehlsgebern oder Tasten verknüpft werden.
{{Bild_mit_Unterschrift|Textbuch - Status und Bedienleiste.png|4|Status- und Bedienleiste des Textbuch Plugins|center|800px}}
Je nach Einstellung wird mit "Go" zum nächsten Kommando oder zur nächsten Zeile gesprungen. Ebenso verhalten sich die Buttons "Back" und "Next", wobei hier die entsprechenden Kommandos nicht ausgeführt werden.
Sind die Optionen "scroll to next Item after Go" und "next Command after Go" kann mit der Option "Autoscroll" sanft zwischen den entsprechenden Zeilen gescrollt werden. Die Zeit, zum überblenden zwischen den Zeilen wird über den Parameter "Delta-t" des nachfolgenden Kommandos eingestellt.

== 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 - Sprechender Name für das Kommando, frei Konfigurierbar, dieser wird auch im Texteditor angezeigt
* Run - Button zum außertourlichen ausführen des Befehls (Button funktioniert, ist jedoch in aktueller Version nicht sichtbar)
* Typ - Typ des Kommandos (aktuell nur Cuelist oder Inputassignment)
* 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"
* Stichwort - Möglichkeit Stichwörter als Info für den Operator zu hinterlegen
* Kommentar - Möglichkeit 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 =
== Textbuch anlegen ==
Die Textbücher werden komplett im Projektfile von DMXControl gespeichert. Da das Textbuch aktuell ein reines GUI-Plugin ist, werden die Textbücher rein von der GUI verarbeitet. Ein bearbeiten der Textbücher im betrieb mit mehreren Clients ist deshalb nicht möglich. Das zeitgleiche nutzen von Textbüchern ist jedoch möglich. Die Textbücher werden über den Projektexplorer verwaltet. Hier sollte eine neue Rubrik mit dem Namen "Textbook" vorhanden sein. Per Rechtsklick auf den Eintrag und "Create Textbook" kann ein neues Textbuch erstellt und mit doppelklick darauf geöffnet werden.

= Externe Ansteuerung =
== Cuelisten und Cues ==

== Input Assignment ==

[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2020-01-22T22:38:46Z

Mic: /* Bedien- und Statusleiste */

{{Infobox Plugin
| Name = Textbuch
| Logo = Beispiel-Textbuch.png
| Screenshot =
| Beschreibung =
| Hersteller =
| AktuelleVersion = 1.3
| AktuelleVersionFreigabeDatum =
| Status = beta
| Funktioniertmit = 3.2
| Programmiersprache = C#
| Kategorie =
| Lizenz = GLP
| Deutsch = ja
| Email =
| Homepage = http://www.dmxcontrol.de
| Download = https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/
}}
= Beschreibung =
Beim Textbuch handelt es sich um ein Plugin für DMXControl 3, um die Textbuchfunktionalität aus DMXControl 2 in der Version 3 zur Verfügung zu stellen. Für Theater- und Musicalveranstaltungen ist es essentiell Stimmungen und Effekte passgenau auf Zeitpunkte oder Stichwörter einzutakten. Das Textbuch wurde entwickelt, um bei Veranstaltungen mit festem Ablauf auf basis eines Textbuches/Drehbuches oder ähnlichem die passenden Funktionen von DMXControl 3 auszulösen.

= Installation =
Das Textbuchplugin kann im DMXControl Forum unter folgendem [https://forum.dmxcontrol-projects.org/index.php?thread/14941-textbuch-plugin/ Link] heruntergeladen werden. Im Installationsverzeichnis von DMXControl muss die enthaltene Datei "Textbook.dll" in das Unterverzeichnis "GUI/Plugins" verschoben werden. Im Anschluss sollte nach Neustart von DMXControl 3 im "Plugin Management" der Eintrag "Textbook Plugin" vorhanden sein. Nach aktivieren des Eintrags stehen die Textbuchfunktionalitäten zur Verfügung. Sollte der Eintrag nicht vorhanden sein, ist die DLL Datei eventuell von Windows blockiert und muss gegebenenfalls noch freigegeben oder DMXControl als Administrator gestartet werden.

= Bedienelemente =
Nach öffnen des Textbuches sollte sich ein Fenster gemäß untenstehender Abbildung öffnen.
{{Bild_mit_Unterschrift|Beispiel-Textbuch.png|1|Textbuch mit Beispieltext.|center|800px}}
Das Fenster gliedert sich dabei in Folgende Bereiche, welche im Anschluss erklärt werden:
# Menüleiste
# Texteditor
# Drag and Drop Bereich
# Textbuch Bedien- und Statusleiste
# Befehlsliste

== Menüleiste ==
Die Menüleiste beinhaltet allgemeine Funktionen zum Speichern und Bearbeiten des Textbuch-Verhaltens.
{{Bild_mit_Unterschrift|Textbuch - Menüleiste.png|2|Menüleiste des Textbuch Plugins.|center|400px}}

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

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

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

== Bedien- und Statusleiste ==
Die Bedien- und Statusleiste umfasst eine Fortschrittsanzeige, Buttons für den Sprung zum nächsten beziehungsweise zum vorhergehenden Objekt sowie die Buttons "Go" und "Autoscroll". Zur einbindung des Textbuches in Softdesks oder zum anlegen von Shortcuts sind die Buttons der Bedienleiste auch über das Inputassignment ansteuerbar und können zum Beispiel mit externen Befehlsgebern oder Tasten verknüpft werden.
{{Bild_mit_Unterschrift|Textbuch - Status und Bedienleiste.png|4|Status- und Bedienleiste des Textbuch Plugins|center|800px}}
Je nach Einstellung wird mit "Go" zum nächsten Kommando oder zur nächsten Zeile gesprungen. Ebenso verhalten sich die Buttons "Back" und "Next", wobei hier die entsprechenden Kommandos nicht ausgeführt werden.
Sind die Optionen "scroll to next Item after Go" und "next Command after Go" kann mit der Option "Autoscroll" sanft zwischen den entsprechenden Zeilen gescrollt werden. Die Zeit, zum überblenden zwischen den Zeilen wird über den Parameter "Delta-t" des nachfolgenden Kommandos eingestellt.

== Befehlsliste ==
{{Bild_mit_Unterschrift|Textbuch - Commandlist.png|5|Liste der Textbuch Kommandos.|center|800px}}

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

= Externe Ansteuerung =
== Cuelisten und Cues ==

== Input Assignment ==

[[Kategorie: Plugins_DMXControl_3]]

Textbook Plugin DMXC3

2020-01-22T22:31:50Z

Mic: /* Drag 'n' Drop Bereich */

Textbook Plugin DMXC3

2020-01-22T22:31:23Z

Mic: /* Drag 'n' Drop Bereich */

Textbook Plugin DMXC3

2020-01-22T22:25:48Z

Mic: /* Texteditor */

Textbook Plugin DMXC3

2020-01-22T22:10:07Z

Mic:

Textbook Plugin DMXC3

2020-01-20T21:45:58Z

Mic: Mic verschob die Seite Textbook nach Textbook Plugin (DMXC3): bessere auffindbarkeit

Textbook Plugin DMXC3

2020-01-20T18:19:05Z

Mic: /* Textbuch Fenster */

Textbook Plugin DMXC3

2020-01-20T17:52:19Z

Mic: Die Seite wurde neu angelegt: „{{Infobox Plugin | Name = Textbuch | Logo = Beispiel-Textbuch.png | Screenshot = | Beschreibung = | Hersteller = | AktuelleVersion = 1.3 | AktuelleVersionFr…“

Datei:Textbuch - Commandlist.png

2020-01-20T17:48:44Z

Mic:

Befehlsliste des Textbuch-Plugins

Datei:Textbuch - Status und Bedienleiste.png

2020-01-20T17:48:15Z

Mic:

Status und Bedienleiste des Textbuch-Plugins

Datei:Textbuch - Texteditor.png

2020-01-20T17:47:37Z

Mic:

Texteditor des Textbuch-Plugins

Datei:Textbuch - Menüleiste.png

2020-01-20T17:46:26Z

Mic:

Menüleiste des Textbuch-Plugins

Datei:Beispiel-Textbuch.png

2020-01-20T16:53:27Z

Mic:

Beispiel der Textbuchoberfläche im Textbuch-Plugin