Format (Input Assignment) DMXC3

Format (Input Assignment) DMXC3

Artikel beschreibt DMXControl 3.2.2

Inhaltsverzeichnis A Autoprepare B Bedienoberfläche (GUI) Blackout Bühnenansicht (Stage View) C Chat D Dateien im Projekt (Project Files) DDFs im Projekt (Project DDFs) Device Manager (Add Device Dialog) DDF Library DMX-Schnittstellen (DMX-Interfaces) DMX-In DMX-Out-Zuordnung (DMX-In DMX-Out-Mapping) E Effekte und Filter (Effects and Filters) Effektvisualisierung (Effect Visualizer) Einfrieren (Freeze) Eingangszuweisung (Input Assignment) Executor Executor-Seite (Executor Page) F Fanning Farbliste (Color List) G Gerät (Device) Gerätegruppe (Device Group) Gerätesteuerung (Device Control) Gobo-Ähnlichkeiten (Gobo Affinity) Goboliste (Gobo List) Group Handling H Hardware Abstraction Layer (HAL) Hervorheben (Highlight) K Kanalübersicht (Channel Overview) Kernel (Server) L Lastmanagement (Electricity) M Macroboard Manueller Takt (Manual Beat) Master Matrix MIDI-Verwaltung (MIDI-Manager) N Netzwerkfunktionalitäten O Ordnungsliste (Item List) P Panel-Konzept Patching Preset Programm- und Projekteinstellungen (Application and Project Settings) Programmer Programmer Filter Projektexplorer (Project Explorer) Projektaufgaben (Project ToDos) Protokolldateien (Log Files) R Radix (radiale Matrix) S Server-Client-Konzept Softdesk Softdesk Designer Steuerungsfestner (Control Panel) Szenenliste (Cuelist) Szenenlistegruppe (Cuelist Group) Szenenzeitkonfiguration (Cue Timing Editor)

Abbildung 1: Format-Node

Das Format-Node formatiert einzelne Werte und kann verschiedene Textbausteine von verschiedenen Nodes dynamisch zu einem einzigen Text zusammensetzen, der dann wiederum in einem Label oder einem Button als Beschriftungstext eines Softdesk genutzt werden kann.

Eingänge

Name		Zulässige Werte	Datentyp	Beschreibung
deutsche GUI	englische GUI
0		beliebig	String	Eingang für Text, zum Beispiel aus anderen Nodes.
1
2
3

Ausgänge

Name		Ausgebende Werte	Datentyp	Beschreibung
deutsche GUI	englische GUI
Ausgabe	Output	beliebig	String	Gibt den zusammengesetzten oder formatierten Text aus, um hiermit einen Button oder ein Label im Softdesk dynamisch zu beschriften.

Eigenschaften

Das Format-Node bietet folgende Einstellparameter in den Eigenschaften (Properties).

Einstellung		Möglicher Parameter	Standardwert	Beschreibung
deutsche GUI	englische GUI
Einstellungen des Kernels (Kernel properties)
Name		beliebiger Text	Format	Benutzerdefinierte Beschreibung des Nodes im Titel.
Format		beliebiger Text	{0}, {1}, {2}, {3}	Angabe der gewünschten Ausgabereihenfolge und des zugehörigen Formats der Werte.
Eingänge (Inputs)
0		beliebiger Text	leer	Individueller Wert für die Eingänge 1 bis 4 des Nodes.
1
2
3
Einstellungen der Oberfläche (GUI properties)
Position		X-Koordinate Y-Koordinate	variabel	Manuelle Position in X-Richtung und Y-Richtung für das Node in der Graphenansicht.

Wie der Text zusammengebaut wird, hängt von den Angaben im Feld Format ab. Die folgende Tabelle zeigt verschiedene Beispiele, wie mit Hilfe des Format-Node Zahlenwerte und Texte angepasst werden können.

Anwendungsfall	Code	Ausgabe	Beschreibung
Standard-Wert bei erster Verwendung	{0}, {1}, {2}, {3}	Text A, Text B, Text C, Text D	Alle an den vier Eingängen des Format-Nodes ankommenden Textbausteine werden zu einem Text zusammengesetzt.
RGB-Wert generieren	{0};{1};{2}	255;96;0	Analog zum Standard-Fall wird aus drei der vier Eingänge ein gemeinsamer Text (String) gebaut, welcher im Folgenden als RGB-Wert interpretiert und weiterverarbeitet werden kann. Liegen an den Eingängen 0 bis 2 die Werte 255, 128 und 0 an, generiert der Format-Node die links genannte Ausgabe.
Runden eines Zahlenwerts auf ganze Zahlen	{2:0}	11	Zahlenwerte am Eingang 2 als ganze Zahlen ausgegeben. Hier konvertiert der Format-Node den anliegenden Wert 11,376 am Eingang 2 in den ganzzahligen Wert 11.
BPM-Wert für Label in Softdesk	{0:0.#} BPM	128,5 BPM	Ist mit dem Eingang 0 der BPM-Wert eines Speedmaster verbinden, kann man sich die Ausgabe aus dem Format-Nodes zum Beispiel auf 128,5 BPM "umbauen" lassen.

Vorgaben für weitere Formatierungsmöglichkeiten (insbesondere für Zahlenwerte) sind unter http://www.csharp-examples.net/string-format-double/ einzusehen. Dabei handelt es sich in erster Linie um Formatierungsmöglichkeiten für Zahlenwerte.