Format (Input Assignment) DMXC3: Unterschied zwischen den Versionen

Aus Deutsches DMXC-Wiki
Zur Navigation springen Zur Suche springen
(Formatierung finalisiert, Übersetzungen ergänzt und Bild eingefügt)
Zeile 2: Zeile 2:
 
{{DMXC3_Manual-Navigation_Hauptprogramm}}
 
{{DMXC3_Manual-Navigation_Hauptprogramm}}
  
 
+
{{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 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.
 
 
[Bild]
 
  
 
= Eingänge =
 
= Eingänge =
 
{| class="wikitable toptextcells"
 
{| class="wikitable toptextcells"
 
|-
 
|-
! style="width: 8em" | Name !! style="width: 12em" | Zulässige Werte !! style="width: 8em" | Datentyp !! Beschreibung
+
! 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
 
|-
 
|-
| 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.
 
|-
 
|-
| 1
+
| colspan="2" | 1
 
|-
 
|-
| 2
+
| colspan="2" | 2
 
|-
 
|-
| 3
+
| colspan="2" | 3
 
|-
 
|-
 
|}
 
|}
Zeile 24: Zeile 24:
 
{| class="wikitable toptextcells"
 
{| class="wikitable toptextcells"
 
|-
 
|-
! style="width: 8em" | Name !! style="width: 12em" | Ausgebende Werte !! style="width: 8em" | Datentyp !! Beschreibung
+
! 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
 
|-
 
|-
| 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.
 
|-
 
|-
 
|}
 
|}
= Konfiguration =
+
 
Das Format-Node bietet folgende Einstellparameter in den Properties.
+
= Eigenschaften =
 +
Das Format-Node bietet folgende Einstellparameter in den Eigenschaften (Properties).
 
{| class="wikitable toptextcells"
 
{| class="wikitable toptextcells"
|- class="hintergrundfarbe6"
+
|- class="hintergrundfarbe10"
! style="width: 8em" | Einstellung !! style="width: 12em" | Möglicher Parameter !! style="width: 8em" | Standardwert !! Beschreibung
+
! colspan="2" | Einstellung !! style="width: 175px" rowspan="2" | Möglicher Parameter !! style="width: 175px" rowspan="2" | Standardwert !! rowspan="2" | Beschreibung
 +
|- class="hintergrundfarbe10"
 +
! style="width: 175px" | deutsche GUI !! style="width: 175px" | englische GUI
 
|-
 
|-
| '''Name''' || beliebiger Text || Format || Benutzerdefinierte Beschreibung des Nodes im Titel.
+
| colspan="2" | 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.
+
| colspan="2" | Format || beliebiger Text || {0}, {1}, {2}, {3} || Angabe der gewünschten Ausgabereihenfolge und des zugehörigen Formats der Werte.
|- class="hintergrundfarbe5"
+
|- class="hintergrundfarbe11"
| colspan="4" | '''Inputs'''
+
| colspan="5" | '''Eingänge (Inputs)'''
 
|-
 
|-
| '''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.  
 
|-
 
|-
| '''1'''
+
| colspan="2" | 1
 
|-
 
|-
| '''2'''
+
| colspan="2" | 2
 
|-
 
|-
| '''3'''
+
| colspan="2" | 3
|- class="hintergrundfarbe5"
+
|- class="hintergrundfarbe11"
| colspan="4" | '''GUI properties'''
+
| colspan="5" | '''GUI-Eigenschaften'''
 
|-
 
|-
| '''Position''' || X-Koordinate<br />Y-Koordinate || variabel || Manuelle Position in X-Richtung und Y-Richtung für das Node.
+
| 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 58: Zeile 63:
 
{| class="wikitable toptextcells"
 
{| class="wikitable toptextcells"
 
|-
 
|-
! style="width: 12em" | Anwendungsfall !! style="width: 12em" | Code !! style="width: 12em" | Ausgabe !! Beschreibung
+
! style="width: 175px" | Anwendungsfall !! style="width: 175px" | Code !! style="width: 175px" | Ausgabe !! Beschreibung
 
|-
 
|-
 
| 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.
Zeile 70: Zeile 75:
  
 
<!-- = Anwendungsbeispiel = -->
 
<!-- = Anwendungsbeispiel = -->
 +
 
[[Kategorie:Input Assignment DMXC3]]
 
[[Kategorie:Input Assignment DMXC3]]
 
[[Kategorie:Converter-Nodes DMXC3]]
 
[[Kategorie:Converter-Nodes DMXC3]]

Version vom 8. Mai 2020, 20:02 Uhr

Books.png Format (Input Assignment) DMXC3 Artikel beschreibt
DMXControl 3.2.1
Inhaltsverzeichnis

A

B

C

D

E

F

G

H

K

L

M

N

O

P

R

S


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
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
GUI-Eigenschaften
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.
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.