Format (Input Assignment) DMXC3: Unterschied zwischen den Versionen

Aus Deutsches DMXC-Wiki
(Formatierung finalisiert, Übersetzungen ergänzt und Bild eingefügt)
Keine Bearbeitungszusammenfassung
 
(4 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Kapitelüberschrift|Version=DMXControl 3.2.1}}
{{Manual Header
{{DMXC3_Manual-Navigation_Hauptprogramm}}
| Type = DMXC3 Main-Software
| Version = 3.3.2}}


{{Bild_mit_Unterschrift | DMXC3_IA-Node_Format.png |1| Format-Node | right}}
{{Bild mit Unterschrift | DMXC3 IA-Node Format.png |1| Format-Node | right}}
Das {{Manual_Objectcaption|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 {{Manual_Windowcaption|[[Softdesk_DMXC3|Softdesk]]}} genutzt werden kann.
Das {{Manual Objectcaption|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 {{Manual Windowcaption|[[Softdesk DMXC3|Softdesk]]}} genutzt werden kann.
{{Clear}}


= Eingänge =
= Eingänge =
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader IA-Nodes In-Output | de | in}}
|-
 
! colspan="2" | Name !! style="width: 175px" rowspan="2" | Zulässige Werte !! style="width: 125px" rowspan="2" | Datentyp !! rowspan="2" | Beschreibung
|-
! style="width: 175px;" | deutsche GUI !! style="width: 175px;" | englische GUI
|-
| colspan="2" | 0 || rowspan="4" | beliebig || rowspan="4" | String || rowspan="4" | Eingang für Text, zum Beispiel aus anderen Nodes.
| colspan="2" | 0 || rowspan="4" | beliebig || rowspan="4" | String || rowspan="4" | Eingang für Text, zum Beispiel aus anderen Nodes.
|-
|-
Zeile 19: Zeile 17:
|-
|-
| colspan="2" | 3
| colspan="2" | 3
|-
|}
|}
= Ausgänge =
= Ausgänge =
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader IA-Nodes In-Output | de | out}}
|-
 
! colspan="2" | Name !! style="width: 175px" rowspan="2" | Ausgebende Werte !! style="width: 125px" rowspan="2" | Datentyp !! rowspan="2" | Beschreibung
|-
! style="width: 175px;" | deutsche GUI !! style="width: 175px;" | 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.
| Ausgabe || Output || beliebig || String || Gibt den zusammengesetzten oder formatierten Text aus, um hiermit einen Button oder ein Label im Softdesk dynamisch zu beschriften.
|-
|}
|}


= Eigenschaften =
= Eigenschaften =
Das Format-Node bietet folgende Einstellparameter in den Eigenschaften (Properties).
Das Format-Node bietet folgende Einstellparameter in den Eigenschaften (Properties).
{| class="wikitable toptextcells"
{{DMXC3 Manual-Tableheader Settings | de}}
|- class="hintergrundfarbe10"
 
! colspan="2" | Einstellung !! style="width: 175px" rowspan="2" | Möglicher Parameter !! style="width: 175px" rowspan="2" | Standardwert !! rowspan="2" | Beschreibung
{{DMXC3 Manual-Tablesection | S1 | 5 | Einstellungen des Kernels (Kernel properties) }}
|- class="hintergrundfarbe10"
 
! style="width: 175px" | deutsche GUI !! style="width: 175px" | englische GUI
|-
| colspan="2" | Name || beliebiger Text || Format || Benutzerdefinierte Beschreibung des Nodes im Titel.
| colspan="2" | Name || beliebiger Text || Format || Benutzerdefinierte Beschreibung des Nodes im Titel.
|-
|-
| colspan="2" | Format || beliebiger Text || {0}, {1}, {2}, {3} || Angabe der gewünschten Ausgabereihenfolge und des zugehörigen Formats der Werte.
| colspan="2" | Format || beliebiger Text || {0}, {1}, {2}, {3} || Angabe der gewünschten Ausgabereihenfolge und des zugehörigen Formats der Werte.
|- class="hintergrundfarbe11"
 
| colspan="5" | '''Eingänge (Inputs)'''
{{DMXC3 Manual-Tablesection | S2 | 5 | Eingänge (Inputs) }}
|-
 
| colspan="2" | 0 || rowspan="4" | beliebiger Text || rowspan="4" | leer || rowspan="4" | Individueller Wert für die Eingänge 1 bis 4 des Nodes.  
| colspan="2" | 0 || rowspan="4" | beliebiger Text || rowspan="4" | leer || rowspan="4" | Individueller Wert für die Eingänge 1 bis 4 des Nodes.  
|-
|-
Zeile 53: Zeile 43:
|-
|-
| colspan="2" | 3
| colspan="2" | 3
|- class="hintergrundfarbe11"
 
| colspan="5" | '''GUI-Eigenschaften'''
{{DMXC3 Manual-Tablesection | S1 | 5 | Einstellungen der Oberfläche (GUI properties) }}
|-
 
| colspan="2" | Position || X-Koordinate<br />Y-Koordinate || variabel || Manuelle Position in X-Richtung und Y-Richtung für das Node in der Graphenansicht.
| colspan="2" | Position || X-Koordinate<br />Y-Koordinate || variabel || Manuelle Position in X-Richtung und Y-Richtung für das Node in der Graphenansicht.
|}
|}
Zeile 67: Zeile 57:
| 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>.
| RGB-Wert generieren || <code>{0};{1};{2}</code> || '''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 {{Manual Commands|0}} bis {{Manual Commands|2}} die Werte <code>255</code>, <code>96</code> und <code>0</code> an, generiert der {{Manual Objectcaption|Format}}-Node die links genannte Ausgabe.
|-
| Runden eines Zahlenwerts auf ganze Zahlen || <code>{2:0}</code> || '''11''' || Zahlenwerte am Eingang {{Manual Commands|2}} als ganze Zahlen ausgegeben. Hier konvertiert der {{Manual Objectcaption|Format}}-Node den anliegenden Wert <code>11,376</code> am Eingang {{Manual Commands|2}} 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 {{Manual Commands|0}} der BPM-Wert eines {{Manual Objectcaption|[[Speed Master (Input Assignment) DMXC3|Geschwindigkeits-Masters (Speed masters)]]}}-Nodes verbinden, kann man sich die Ausgabe aus dem {{Manual Objectcaption|Format}}-Nodes zum Beispiel auf '''128,5 BPM''' "umbauen" lassen.
|-
|-
| Verbleibende Dauer des Fades einer Szene für ein Label im Softdesk || <code>{0:mm}:{1:ss} min</code> || '''03:47 min''' || Verbindet man den Ausgang {{Manual Commands|Fade Time Left}} des {{Manual Objectcaption|[[Cue (Input Assignment) DMXC3|Szenen (Cue)]]}}-Nodes mit den Eingängen {{Manual Commands|0}} und {{Manual Commands|1}} des {{Manual Objectcaption|Format}}-Nodes, kann man sich mit dem angegeben Format die verbleibende Fade-Zeit einer Szene in einem Label im Softdesk anzeigen lassen - hier also '''03:47 min'''.
|}
|}
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.
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.

Aktuelle Version vom 26. April 2026, 15:48 Uhr

Books.png Artikel beschreibt
DMXControl 3.3.2
Stand: 26.04.2026		 Format (Input Assignment) DMXC3
Inhaltsverzeichnis

A

B

C

D

E

F

G

H

K

L

M

N

O

P

R

S

T

U


Abbildung 1: Format-Node
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, 96 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 Geschwindigkeits-Masters (Speed masters)-Nodes verbinden, kann man sich die Ausgabe aus dem Format-Nodes zum Beispiel auf 128,5 BPM "umbauen" lassen.
Verbleibende Dauer des Fades einer Szene für ein Label im Softdesk {0:mm}:{1:ss} min 03:47 min Verbindet man den Ausgang Fade Time Left des Szenen (Cue)-Nodes mit den Eingängen 0 und 1 des Format-Nodes, kann man sich mit dem angegeben Format die verbleibende Fade-Zeit einer Szene in einem Label im Softdesk anzeigen lassen - hier also 03:47 min.

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.

Abgerufen von „https://wiki-de.dmxcontrol-projects.org/index.php?title=Format_(Input_Assignment)_DMXC3&oldid=19124“