Zurück

Linear Bar Graph

Dieses Objekt ist ein lineares Balkendiagramm oder Thermometer, das durch ein umschließendes Rechteck in einer von vier Orientierungen definiert wird. Ein Zielwert kann optional auf dem Balkendiagramm markiert werden. Der Positionsattribut des Balkendiagramms bezieht sich immer auf die obere linke Ecke des Rechtecks, unabhängig von der Ausrichtung.
Attribut
AID
Attribut
Beschreibung
Object ID
Eindeutiger Bezeichner des Objekts. Muss innerhalb des Objektpools einzigartig sein (2 Bytes, 0-65534)
Type
Width
Maximale Breite des Objektbereichs in Pixeln.
Height
Maximale Höhe des Schaltflächenbereichs in Pixeln.
Colour
Target line colour
Ziel-Linienfarbe (falls gezeichnet).
Options (Output Linear Bar Graph)

Logische Bits zur Angabe, welche Teile gezeichnet werden sollen: 1 = TRUE

  • Bit 0 = Rahmen zeichnen: Wenn TRUE, wird ein Rahmen gezeichnet.
  • Bit 1 = Ziel-Linie zeichnen: Wenn TRUE, wird eine Ziel-Linie gezeichnet.
  • Bit 2 = Ticks zeichnen: Wenn TRUE, werden Markierungen (Ticks) gezeichnet.
  • Bit 3 = Balkendiagramm-Typ:
    • Wenn FALSE (0), wird das Balkendiagramm ausgefüllt.
    • Wenn TRUE (1), wird das Balkendiagramm nicht ausgefüllt, sondern zeigt den aktuellen Wert als eine einzelne Linie an der entsprechenden Position innerhalb des Balkendiagramms.

Ausrichtung und Richtung des Balkendiagramms:

  • Bit 4 = Achsenorientierung:
    • 0 = Vertikal (steigende Werte bewegen sich parallel zur y-Achse bei konstantem X).
    • 1 = Horizontal (steigende Werte bewegen sich parallel zur x-Achse bei konstantem Y).
  • Bit 5 = Richtung:
    • 0 = Wachstumsrichtung negativ (links oder unten).
    • 1 = Wachstumsrichtung positiv (rechts oder oben).
Number of ticks
Anzahl der Striche, die über den Bogen des Messgeräts gezeichnet werden sollen. Bei einem Strich wird dieser in der Mitte des Bogens platziert. Bei zwei oder mehr Strichen wird jeweils ein Strich an jedem Ende des Bogens gesetzt, und die restlichen Striche werden gleichmäßig dazwischen verteilt.
Min value
Roh-Minimalwert für die Eingabe vor der Skalierung. Offset und Skalierung müssen angewendet werden, um den tatsächlichen Minimalwert zu bestimmen.
Max value
Roh-Maximalwert für die Eingabe. Offset und Skalierung müssen angewendet werden, um den tatsächlichen Maximalwert zu bestimmen.
Variable reference
Referenz auf ein Variablen-Objekt zur Wertübernahme.
Target value variable reference
Object ID eines Number Variable-Objekts, aus dem der Zielwert des Balkendiagramms abgerufen wird. Wenn dieses Attribut auf NULL gesetzt ist, wird der Zielwert direkt aus dem Attribut „Zielwert“ abgerufen. Der Wert der referenzierten Number Variable muss im Bereich von 0 bis 65535 liegen.
Target value
Aktueller Zielwert. Wird nur verwendet, wenn das Attribut „Zielwert-Variable Referenz“ NULL ist. Der Zielwert wird als Linie im Balkendiagramm angezeigt, um einen Ziel- oder Warnwert anzuzeigen. Wenn der Zielwert > Maximalwert oder der Zielwert < Minimalwert ist, wird die Ziellinie an einem der Enden des Balkendiagramms angezeigt, ohne dass ein Fehler durch das VT generiert wird.
Value (Integer)
Aktueller Wert des Objekts, falls keine Variablenreferenz genutzt wird.
Number of macros to follow
Anzahl der enthaltenen Makroreferenzen, auch wenn sie null ist. Jede Makroreferenz besteht aus 2 Bytes: eines für die Ereignis-ID und eines für die Makro-ID. Wenn das angegebene Ereignis eintritt, wird das zugehörige Makro ausgeführt. VT-Version 5 und später: Eine Referenz auf ein Makro mit 16-Bit-Objekt-ID zählt im Kontext dieses Attributs als 2 Makroreferenzen.
Wird benutzt in
Attribut
Beschreibung
Meter
Dieses Objekt ist ein Meter, dessen allgemeines Erscheinungsbild dem VT überlassen wird, aber um einen Kreis gezeichnet wird, der in einem definierten Quadrat eingeschlossen ist. Die Winkelattribute werden aus der positiven x-Achse im mathematisch positiven (gegen den Uhrzeigersinn) Richtung berechnet. Der VT sorgt dafür, dass die Nadelbewegung andere darunter liegende Objekte nicht beeinträchtigt. Der Positionsattribut bezieht sich immer auf die obere linke Ecke des umschließenden Quadrats, unabhängig von der Ausrichtung. Das Objekt wird transparent gezeichnet, sodass Objekte darunter platziert werden können, um das Erscheinungsbild zu verbessern. Es wird empfohlen, dass die Länge der sichtbaren Markierungen 10 % der Breite des Meters beträgt, mindestens jedoch 1 Pixel (z. B. bei einer Meterbreite von weniger als 10 Pixel).
Arched Bar Graph
Dieses Objekt ähnelt einem linearen Balkendiagramm, hat jedoch eine gewölbte Form. Es wird um ein Output Ellipse Objekt gezeichnet, das von einem definierten Rechteck umschlossen wird. Die Winkel werden aus der positiven x-Achse im mathematisch positiven (gegen den Uhrzeigersinn) Richtung berechnet. Der Positionsattribut bezieht sich immer auf die obere linke Ecke des umschließenden Rechtecks, unabhängig von der Ausrichtung. Das Objekt wird transparent gezeichnet, damit Objekte darunter den visuellen Effekt verbessern können. Ein Change Size-Befehl kann dazu führen, dass die „Balkenbreite“ die Hälfte der Breite oder Höhe des Objekts erreicht oder überschreitet, was jedoch nicht zur Ablehnung des Pools führt. Der VT kann den Wert der Balkenbreite für die Zeichnung verringern, aber dieser reduzierte Wert wird nicht im Objekt gespeichert.