KKeine Bearbeitungszusammenfassung |
Keine Bearbeitungszusammenfassung |
||
| Zeile 1: | Zeile 1: | ||
{{Kapitelüberschrift|Version=DMXControl 3.2.0}} | |||
{{DMXC3_Manual-Navigation_Hauptprogramm}} | |||
Dieser 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 genutzt werden kann. | Dieser 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 genutzt werden kann. | ||
[Bild] | [Bild] | ||
=Eingänge= | = Eingänge = | ||
{| class="wikitable toptextcells" | {| class="wikitable toptextcells" | ||
|- | |- | ||
| Zeile 16: | Zeile 21: | ||
|- | |- | ||
|} | |} | ||
=Ausgänge= | = Ausgänge = | ||
{| class="wikitable toptextcells" | {| class="wikitable toptextcells" | ||
|- | |- | ||
| Zeile 24: | Zeile 29: | ||
|- | |- | ||
|} | |} | ||
=Konfiguration= | = Konfiguration = | ||
Das Format-Node bietet folgende Einstellparameter in den Properties. | |||
{| class="wikitable toptextcells" | |||
|- class="hintergrundfarbe6" | |||
! style="width: 8em" | Einstellung !! style="width: 12em" | Möglicher Parameter !! style="width: 8em" | Standardwert !! Beschreibung | |||
|- | |||
| '''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. | |||
|- | |||
|} | |||
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. | |||
{| class="wikitable toptextcells" | {| class="wikitable toptextcells" | ||
| Zeile 32: | Zeile 48: | ||
|- | |- | ||
| Standard-Wert bei erster Verwendung || <code>{0}, {1}, {2}, {3}</code> || '''Text A, Text B, Text C, Text D''' || Alle an den vier Eingängen des Format-Nodes ankommenden Textbausteine werden zu einem Text zusammengesetzt. | | Standard-Wert bei erster Verwendung || <code>{0}, {1}, {2}, {3}</code> || '''Text A, Text B, Text C, Text D''' || Alle an den vier Eingängen des Format-Nodes ankommenden Textbausteine werden zu einem Text zusammengesetzt. | ||
|- | |||
| Runden eines Zahlenwerts auf ganze Zahlen || <code>{2:0}</code> || '''11''' || Zahlenwerte am Eingang <code>2</code> als ganze Zahlen ausgegeben. Hier konvertiert der Format-Node den anliegenden Wert <code>11,376</code> am Eingang <code>2</code> in den ganzzahligen Wert <code>11</code>. | |||
|- | |- | ||
| BPM-Wert für Label in Softdesk || <code>{0:0.#} BPM</code> || '''128,5 BPM''' || Ist mit dem Eingang <code>0</code> der BPM-Wert eines Speedmaster verbinden, kann man sich die Ausgabe aus dem Format-Nodes zum Beispiel auf '''128,5 BPM''' "umbauen" lassen. | | BPM-Wert für Label in Softdesk || <code>{0:0.#} BPM</code> || '''128,5 BPM''' || Ist mit dem Eingang <code>0</code> 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/ '''http://www.csharp-examples.net/string-format-double/'''] einzusehen. Dabei handelt es sich in erster Linie um Formatierungsmöglichkeiten für Zahlenwerte. | |||
<!-- = Anwendungsbeispiel = --> | |||
=Anwendungsbeispiel= | |||
Version vom 17. Dezember 2019, 08:54 Uhr
|
Format (Input Assignment) DMXC3 | Artikel beschreibt DMXControl 3.2.0 |
Dieser 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 genutzt werden kann.
[Bild]
Eingänge
| Name | Zulässige Werte | Datentyp | Beschreibung |
|---|---|---|---|
| 0 | beliebig | String | Eingang für Text, zum Beispiel aus anderen Nodes. |
| 1 | |||
| 2 | |||
| 3 |
Ausgänge
| Name | Ausgebende Werte | Datentyp | Beschreibung |
|---|---|---|---|
| Output | beliebig | String | Gibt den zusammengesetzten oder formatierten Text aus, um hiermit einen Button oder ein Label im Softdesk dynamisch zu beschriften. |
Konfiguration
Das Format-Node bietet folgende Einstellparameter in den Properties.
| Einstellung | Möglicher Parameter | Standardwert | Beschreibung |
|---|---|---|---|
| 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. |
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. |
| 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.