Skip to main content

Dialog: XY-Diagramm-Konfiguration

Symbol: _visu_icon_xy_chart.png

Funktion: Der Dialog enthält die Konfiguration des Kartesischen XY-Diagramms, das Daten aus einem Array visualisiert.

Aufruf: In Eigenschaft Kartesischen XY-Diagramm auf _visu_icon_xy_chart.png XYChart klicken.

Voraussetzung: Im aktiven Visualisierungseditor ist ein XY-Diagramm selektiert und die dazugehörige Ansicht Eigenschaften ist geöffnet.

_visu_img_tree_view.png

Die Baumansicht, die im Dialog links ist, visualisiert die Konfiguration des XY-Diagramms und fungiert als Navigator. Wenn Sie nichts oder den Top-Level-Eintrag (1) selektiert haben, ist rechts die Gruppe Elementeinstellungen sichtbar. Dort ist konfiguriert, wann das Diagramm aktualisiert wird. Außerdem stehen Einstellungen zur Verfügung, die das Aussehen und die Funktionalität des Diagramms betreffen.

Wenn Sie einen Eintrag unter dem Knoten Kurven (2) selektiert haben, ist rechts die Gruppe Kurveneinstellungen sichtbar. Dort ist konfiguriert, welche Y-Koordinatenachse der selektierten Kurve zugeordnet ist und welche Arraydaten die Kurve visualisiert. Außerdem stehen Einstellungen zur Verfügung, die das Aussehen und die Funktionalität der selektierten Kurve betreffen. Der Eintrag zeigt den Namen der Kurve an und dahinter in Klammern die zugeordnete Koordinatenachse. Beispielsweise bedeutet Curve1 [AxisY1], dass der Kurve Curve1 die vertikale Ordinatenachse AxisY1 zugeordnet ist.

Wenn Sie einen Eintrag unter dem Knoten Axen (3) selektiert haben, ist rechts die Gruppe Achseinstellungen sichtbar. Dort ist konfiguriert, wo die Y-Koordinatenachse im Diagramm angeordnet ist. Außerdem stehen Einstellungen zur Verfügung, die das Aussehen und die Funktionalität der selektierten Koordinatenachse betreffen. Der Eintrag zeigt den Namen der Achse an und dahinter in Klammern deren Funktion. Eine Achse kann entweder als X oder als Y-Achse fungieren. Beispielsweise bedeutet AxisX(X), dass die Achse AxisX als horizontale Abszissenachse X fungiert.

Hinzufügen

Fügt einen neuen Eintrag in der Ansicht hinzu

Folge: Neben der neuen Kurve oder Achse erscheint eine leere Konfiguration. Bearbeiten Sie dort die Einstellungen.

Löschen

Entfernt den selektierten Eintrag

Nach oben

Verschiebt den selektierten Eintrag um einen nach oben

Nach unten

Verschiebt den selektierten Eintrag um einen nach unten

OK

Speichert die Einstellungen, schließt den Dialog und zeigt das Element entsprechend den Einstellungen an

Gruppe: Elementeinstellungen

Tabelle 132. Aktualisierung

Typ

  • Automatisch: Wenn Arraydaten, die das Rendern des Diagramms beeinflussen, oder Arrayelemente sich ändern, wird das Diagramm automatisch aktualisiert.

    Tipp: Unter Erweiterte Variablen ist zusätzlich die Einstellung Automatische Aktualisierung aktivieren verfügbar, um programmatisch die automatische Aktualisierung zu steuern.

  • Variable: Wenn der Variablenwert sich ändert, wird das Diagramm aktualisiert.

Variable

Variable (Ganzzahliger Datentyp)

Verfügbar, wenn der Typ Variable ausgewählt ist.

Siehe: Beispiel Variable



Beispiel 50. Beispiel Variable

Deklaration

PROGRAM Sine
VAR_INPUT
   uiUpdate : UINT;
END_VAR

Zuweisung

Sine.uiUpdate


Tabelle 133. Hintergrund

Typ

  • Kein Hintergrund

  • Reine Farbe: Farbiger Hintergrund, konfiguriert in den Eingabefeldern Farbe und Transparenz.

  • Farbverlauf: Hintergrund mit Farbverlauf. _cds_icon_three_dots.png öffnet den Farbverlaufseditor.

  • Bild: Hintergrund mit Bild, konfiguriert im Eingabefeld Bild-ID.

  • Vom Stil: Hintergrund, so wie im Stil definiert.

Farbe

  • Stilfarbe aus der Auswahlliste. Beispiel: LightGreen

  • Fester Wert, der im Farbdialog ausgewählt wird.

Verfügbar, wenn der Typ Reine Farbe ausgewählt ist

Transparenz

Transparenzwert (255 bis 0), der die Durchsichtigkeit der zugehörigen Farbe festlegt

Beispiel 255: Die Farbe ist deckend. 0: Die Farbe ist voll transparent.

Verfügbar, wenn der Typ Bild ausgewählt ist.

Bild-ID

<image pool name> . <ID>

Beispiel: Images.Logo

Verfügbar, wenn der Typ Bild ausgewählt ist.

Transparenzfarbe

standard icon: Hintergrund, mit transparenter Farbe dargestellt.

  • Stilfarbe aus der Auswahlliste. Beispiel: LightGreen

  • Fester Wert, der im Farbdialog ausgewählt wird.

Verfügbar, wenn der Typ Bild ausgewählt ist.

Skalierungsart

  • Isotropisch: Das Bild wird vollständig im Elementrahmen dargestellt und dazu vergrößert oder verkleinert. Dabei werden die Proportionen beibehalten, das Verhältnis Höhe zu Breite bleibt erhalten.

  • Anisotropisch: Das Bild passt sich der Größe des Elementrahmens an, so dass der gesamte Elementrahmen gefüllt ist. Dabei werden die Proportionen nicht beibehalten.

  • Fest: Das Bild behält die Originalgröße, auch wenn sich die Größe des Elementrahmens ändert. Zu berücksichtigen ist dabei auch, ob die Option Abschneiden aktiviert ist.

Verfügbar, wenn der Typ Bild ausgewählt ist.



Tabelle 134. Hauptcursor

Typ

  • Nicht verwendet

  • _visu_icon_cursor_vertical.png Vertikal

  • _visu_icon_cursor_cross_big.png Großes Kreuz

  • _visu_icon_cursor_cross_small.png Kleines Kreuz

  • _visu_icon_cursor_interceptor.png Schnittpunkte

Linienart

Beispiel: Punkte

Nicht verfügbar, wenn der Typ _visu_icon_cursor_cross_small.png ausgewählt ist.

Farbe

  • Stilfarbe aus der Auswahlliste. Beispiel: LightGreen

  • Fester Wert, der im Farbdialog ausgewählt wird.

X-Positionsvariable

Variable (ganzzahliger Datentyp), in welche die Cursor X-Position geschrieben wird.

Beispiel: PLC_PRG.iPosition

Nicht verfügbar, wenn der Typ _visu_icon_cursor_cross_small.png ausgewählt ist.



Tabelle 135. Erweiterte Variablen

Elementvariable

Variable mit Datentyp VisuStructXYChart aus Bibliothek VisuElemXYChart

Die hier konfigurierte Variable wird mit der statischen Konfiguration initialisiert. Zur Laufzeit reagiert das Element Kartesische XY-Diagramm auf Veränderungen in dieser Struktur. Dadurch kann das Element zur Laufzeit programmatisch gesteuert werden.

Hinweis: Wenn diese Struktur programmatisch gesteuert wird, kann es Probleme mit der Reihenfolge bei den Zuweisungen geben. Daher sollte die Applikation ihre Initialwerte erst zuweisen, wenn das Visualisierungselement initialisiert ist und die Strukturvariable iInitialized auf 1 gewechselt hat.

Die Variable iInitialized steht erst ab CODESYS-Version SP16 zur Verfügung. Bei älteren Versionen lässt sich das Problem mit der Reihenfolge nicht sauber lösen.

Siehe: Beispiel Elementvariable

Automatische Aktualisierung aktivieren

Variable (Datentyp BOOL), um das automatische Aktualisieren des Diagramms programmatisch zu steuern.

TRUE: Die Darstellung des Diagramms wird nach einer Änderung automatisch aktualisiert.

Beispiel: PLC_PRG.bIsUpdating

Hinweis: Verfügbar, wenn unter Aktualisierung der Typ Automatisch ausgewählt ist.



Beispiel 51. Beispiel: Elementvariable

Deklaration

PROGRAM PLC_PRG
VAR
   XYChart : VisuStructXYChart;
END_VAR

Zuweisung

IF XYChart.iInitialized > 0 THEN
   XYChart.eBackgroundType := VisuEnumXYChartBGType.PLAIN;     // plain color
   XYChart.diColorBg := 16#00000080;                           // blue
   XYChart.eGrid := VisuEnumXYChartGridType.NO;                // no grid
END_IF


Tabelle 136. Zusätzlicher Cursor

Der Cursortyp des zusätzlichen Cursors entspricht dem des Hauptcursors.

Linienart

Beispiel: Punkte

Farbe

  • Stilfarbe aus der Auswahlliste. Beispiel: LightGreen

  • Fester Wert, der im Farbdialog ausgewählt wird.



Tabelle 137. Raster

Typ

Raster, dargestellt als

  • Nicht verwendet

  • _visu_icon_grid_line_large.png Weites Raster

  • _visu_icon_grid_line_narrow.png Enges Raster

  • _visu_icon_grid_dot_large.png Weites gepunktetes Raster

  • _visu_icon_grid_dot_narrow.png Enges gepunktetes Raster

Linienart

Beispiel: Punkte

Nicht verfügbar, wenn der Typ _visu_icon_grid_dot_large.png oder der Typ _visu_icon_grid_dot_narrow.png ausgewählt sind.

Farbe

  • Stilfarbe aus der Auswahlliste. Beispiel: LightGreen

  • Fester Wert, der im Farbdialog ausgewählt wird.

Raster hinter der Kurve

standard icon: Raster wird in der Ebene hinter der Kurve dargestellt. Wenn beispielsweise die Kurve als Flächendiagramm dargestellt wird, ist in der farbig gefüllten Fläche kein Raster sichtbar. Wenn die Füllfarbe aber einen Transparenzwert von beispielsweise 128 und halbtransparent ist, ist das Raster trotzdem sichtbar.

_cds_icon_option_deactivated.png: Raster liegt über der Kurve. Wenn beispielsweise die Kurve als Flächendiagramm dargestellt wird, wird die farbig gefüllte Fläche immer mit Raster dargestellt.



Tabelle 138. Nulllinie

Position

Darstellung der Nulllinien

  • Nicht verwendet

  • Für Y-Achse anzeigen

  • Für X-Achse anzeigen

  • Für beide anzeigen

Linienart

Beispiel: Punkte

Liniendicke

Beispiel: 2

Farbe

  • Stilfarbe aus der Auswahlliste. Beispiel: LightGreen

  • Fester Wert, der im Farbdialog ausgewählt wird.



Gruppe: Kurveneinstellungen

Die Einstellungen beziehen sich auf die in der Baumansicht selektierte Kurve.

Gehört zur Y-Achse

Y-Achse, die der selektierten Kurve zugeordnet ist. Eine Y-Achse kann mehrere Kurven zugeordnet haben. Die Auswahlliste enthält alle Achsen, die im Element erzeugt wurden.

Beispiel: Y

Tabelle 139. Daten X / Daten Y

Variable

Arrayvariable von Basisdatentypen, benutzerdefinierten Datentypen oder Funktionsbausteinen. Die Variable enthält die Kurvendaten für die X- oder Y-Daten.

  • Eindimensionale Arrayvariable eines Basisdatentyps:

    ARRAY [ <untere Indexgrenze> .. <obere Indexgrenze> ] OF <Basisdatentyp>

  • Zweidimensionale Arrayvariable eines Basisdatentyps:

    ARRAY [ <untere Indexgrenze 1> .. <obere Indexgrenze 1> , <untere Indexgrenze 2> .. <obere Indexgrenze 2> ] OF <Basisdatentyp>

    <untere Indexgrenze 1> .. <obere Indexgrenze 1> : 1. Dimension

    <untere Indexgrenze 2> .. <obere Indexgrenze 1> : 2. Dimension

  • Eindimensionale Arrayvariable eines benutzerdefinierter Datentyp

    ARRAY [ <untere Indexgrenze> .. <obere Indexgrenze> ] OF <DUT-Name>

  • Eindimensionale Arrayvariable einer Enumeration

    ARRAY [ <untere Indexgrenze> .. <obere Indexgrenze> ] OF <Name der Enumeration>

  • Eindimensionale Arrayvariable eines Funktionsbausteins

    ARRAY [ <untere Indexgrenze> .. <obere Indexgrenze> ] OF <Name des Funktionsbausteins>

Basisdatentyp:

DATE | DATE_AND_TIME | DINT | DT | DWORD | INT | LDATE | LDATE_AND_TIME | LDT | LINT | LREAL | LTIME | LTIME_OF_DAY | LTOD | LWORD | REAL | SINT | TIME | TIME_OF_DAY |TOD | UDINT | UINT | ULINT | USINT | WORD

Hinweis: Stellen Sie bei einer Achse nur dann eine feste Skalierung ein, wenn Sie den Wertebereich kennen. Ansonsten ist es ratsam, die Skalierung auf automatisch zu setzen.

Siehe: Beispiele

Zu verwendendes Element

Das Arrayelement des komplexen Datentyps, das verwendet wird.

. Verfügbar, wenn der Datentyp von Variable das Array eines komplexen Datentyps (bestehend aus mehreren Elementen) ist:

  • Mehrdimensionales Array

  • Benutzerdefinierter Datentyp

  • Funktionsbaustein

_cds_icon_arrow_down.png: Öffnet Auswahlliste mit allen Arrayelementen.



Beispiel 52. Beispiel Zweidimensionales Array des Basistypen REAL

Deklaration

PROGRAM Curve
VAR
   aDataXY : ARRAY [1..2, 1..50] OF REAL;
END_VAR

Daten X

Variable: Curve.aDataXY

Zu verwendendes Element: [1]

Daten Y

Variable: Curve.aDataXY

Zu verwendendes Element: [2]

Somit werden in dieser Kurve 100 Arraywerte dargestellt.



Beispiel 53. Beispiel: Eindimensionales Array eines benutzerdefinierten Datentyps

Deklaration

TYPE STRUCT_A :
STRUCT
        iX: INT;
        rY: REAL;
        bResult: BOOL;
END_STRUCT
END_TYPE

PLC_PRG
VAR
        aDataXY : ARRAY [1..50] OF STRUCT_A;
END_VAR

Daten X

Variable: aDataXY.iX

Zu verwendendes Element: iX

Daten Y

Variable: aDataXY.rY

Zu verwendendes Element: rY



Beispiel 54. Beispiel: Eindimensionales Array der Struktur POINT
PLC_PRG
VAR
        aPoints_1: ARRAY[0..99] OF POINT; // POINT ist eine Struktur mit iX und iY
END_VAR

Daten X

Variable: PLC_PRG.aPoints_1

Zu verwendendes Element: iX

Daten Y

Variable: PLC_PRG.aPoints_1

Zu verwendendes Element: iY

Somit stehen 200 X und Y-Werte zur Verfügung, die in 100 Kurvenpunkten im Diagramm angezeigt werden.



Beispiel 55. Beispiel: Eindimensionales Array eines Funktionsbausteins

Deklaration

FUNCTION_BLOCK FB_A
VAR_INPUT
        iIn: INT;
END_VAR
VAR_OUTPUT
        iOut: INT;
END_VAR
PROGRAM PLC_PRG
VAR
        aDataXY : ARRAY [1..50] OF FB_A;
END_VAR

Daten X

Variable: PLC_PRG.aDataXY

Zu verwendendes Element: iIn

Daten Y

Variable: PLC_PRG.aDataXY

Zu verwendendes Element: iOut



Tabelle 140. Eigenschaft Arrayindizes

Die Arrayindizes begrenzen die Darstellung der Kurve auf einen Teilbereich. Statt dass alle Punkte im XY-Diagramm dargestellt werden, werden nur die Punkte ab dem Minimum bis zum Maximum dargestellt. Minimum und Maximum sind Indexe, die die Indexgrenzen nicht verletzen dürfen. Das wird auch vom Compiler überwacht. Entnehmen Sie die Indexgrenzen der Arraydeklaration.

Beispiel: <variable name> : ARRAY [ <lower index bound> .. <upper index bound> ] OF <data type>;

Außerdem können Sie die Darstellung programmatisch in der Instanz von VisuStructXYChartCurve begrenzen. Dafür stehen die Strukturelemente diIndexMin und diIndexMax zur Verfügung, die die gleiche Funktion erfüllen wie Minimum und Maximum. Zur Laufzeit werden die Werte hier in diese Strukturelemente kopiert.

Sie können den Darstellungsbereich auch nur einseitig begrenzen und nur ein Minimum oder nur ein Maximum angeben. Wenn Sie weder hier noch in der Struktur eine Begrenzung angeben, wird die Kurve vollständig dargestellt.

Wenn Sie als Arrayindizes Variablen (numerischer Datentyp) angeben, können Sie die Darstellung dynamisieren.

Numerischer Datentyp : SINT | INT | DINT | LINT | USINT | UINT | UDINT | ULDINT | REAL | LREAL

Minimum

Minimaler Index als Literal, Variable (numerischer Datentyp) oder konstante Variable (numerischer Datentyp)

Bestimmt den Index, ab dem die Kurve dargestellt wird. Der Index ist dabei größer oder gleich der Indexgrenze <lower index bound>.

Beispiel: 10, PLC_PRG.uiLowerIndex, GVL.c_diMIN

Maximum

Maximaler Index als Literal, Variable (numerischer Datentyp) oder konstante Variable (numerischer Datentyp)

Beispiel: 20, PLC_PRG.uiUpperIndex, GVL.c_diMAX

Enthält den Index, bis zu dem die Kurve dargestellt wird. Der Index ist dabei kleiner oder gleich der Indexgrenze <upper index bound>.



Tabelle 141. Diagramm

Typ

  • Liniendiagramm: Daten werden als durchgehende Linie dargestellt. Außerdem können die Daten als Punkte dargestellt werden. Dafür erscheinen Eingabefelder.

    Hinweis:

    Beim Liniendiagramm können nicht mehr als 32767 Punkte pro Kurve gezeichnet werden. Wenn diese Anzahl überschritten wird, wird eine Warnung ausgegeben und es werden nur die ersten 32767 Punkte der Kurve gezeichnet.

  • Balkendiagramm: Daten werden als vertikale Balken dargestellt. Eingabefelder für Farbe und Transparenz erscheinen.

  • Flächendiagramm: Daten werden als durchgehende Linie mit farbiger Fläche dargestellt. Außerdem können die Daten als Punkte dargestellt werden. Dafür erscheinen Eingabefelder.



Die folgenden Einstellungen sind verfügbar, wenn der Typ Liniendiagramm ausgewählt ist.

Linienfarbe

_cds_icon_option_deactivated.png: Linie in Achsfarbe

  • Stilfarbe aus der Auswahlliste. Beispiel: LightGreen

  • Fester Wert, der im Farbdialog ausgewählt wird.

Linientyp

  • _cds_icon_line.png Linie

  • _cds_icon_step.png Stufe danach

  • _visu_icon_line_step_high.png Stufe davor

  • Kein. Nur Punkte

Liniendicke

Beispiel: _visu_icon_line_width_2.png 2

Linienart

Beispiel: _visu_icon_pen_style_dotted.png Punkte

Punktstil

  • Keiner

  • _cds_icon_dot.png Punkt

  • _cds_icon_cross.png Kreuz

  • _cds_icon_point_small_circle.png Kleiner Kreis

  • _cds_icon_point_big_circle.png Großer Kreis

Die folgenden Einstellungen sind verfügbar, wenn der Typ Balkendiagramm ausgewählt ist.

Balkenform

  • Feste Breite: Der Balken wird in einer festen Breite angezeigt.

  • Variable Breite: Die Balkenbreite hängt von der Distanz der Werte ab.

Hauptfarbe

  • Stilfarbe aus der Auswahlliste. Beispiel: Element-XYChart-Axis-Background

  • Fester Wert, der im Farbdialog ausgewählt wird. Beispiel: 0; 0; 0

Alternative Farbe

Rahmenfarbe

Die folgenden Einstellungen sind verfügbar, wenn der Typ Flächendiagramm ausgewählt ist.

Linienfarbe

Beispiel: Blau

_cds_icon_option_deactivated.png: Farbkonfiguration deaktiviert; dann wird die Farbe der Achse verwendet.

Fülltyp

Farbe, mit der die Fläche zwischen den Kurven gefüllt wird.

  • Keine Füllung

  • Reine Farbe: Einfarbige Fläche

  • Farbverlauf: Fläche mit Farbverlauf gefüllt

Füllfarbe

Beispiel: Grau

_cds_icon_three_dots.png: Öffnet den Dialog Farbe

Voraussetzung: In Fülltyp ist Reine Farbe ausgewählt.

_cds_icon_option_deactivated.png: Farbkonfiguration ist deaktiviert; dann wird die Farbe der Linie verwendet.

Transparenz

Transparenzwert (0 - 255) für die reine Farbe.

Beispiel: 128

Voraussetzung: In Fülltyp ist Reine Farbe ausgewählt.

Farbverlauf

Fläche wird mit Farbverlauf gefüllt.

_cds_icon_three_dots.png: Öffnet den Dialog Farbverlaufeditor

Voraussetzung: In Fülltyp ist Farbverlauf ausgewählt.

Liniendicke

Beispiel: _visu_icon_line_width_2.png 2

Linienart

Beispiel: _visu_icon_pen_style_dotted.png Punkte

Punktstil

Im Diagramm werden die Daten als Punkte im Punktstil dargestellt.

  • keiner

  • _cds_icon_dot.png Punkt

  • _cds_icon_cross.png Kreuz

  • _cds_icon_point_small_circle.png Kleiner Kreis

  • _cds_icon_point_big_circle.png Großer Kreis

Vom Cursor erfasster Kurvenwert

Variable (Ganzzahliger Datentyp), in welche die Y-Position des Cursors der Kurve geschrieben wird.

Beispiel: Sine.Cursor_Pos_Y

Tabelle 142. Erweiterte Variablen

Kurvenvariable

Variable (Datentyp VisuStructXYChartCurve aus Bibliothek VisuElemXYChart)

Die hier konfigurierte Variable wird mit der statischen Konfiguration initialisiert. Zur Laufzeit reagiert das Element Kartesische XY-Diagramm auf Veränderungen in dieser Struktur. Dadurch kann das Element zur Laufzeit programmatisch steuert werden.

Hinweis: Wenn diese Struktur programmatisch gesteuert wird, kann es Probleme mit der Reihenfolge bei den Zuweisungen geben. Daher sollte die Applikation ihre Initialwerte erst zuweisen, wenn das Visualisierungselement initialisiert ist und die Strukturvariable iInitialized auf 1 gewechselt hat.

Die Variable iInitialized steht erst ab CODESYS-Version SP16 zur Verfügung. Bei älteren Versionen lässt sich das Problem mit der Reihenfolge nicht sauber lösen.

Siehe: Beispiel Kurvenvariable



Beispiel 56. Beispiel Kurvenvariable

Deklaration

PROGRAM PLC_PRG
VAR
   XYCurve : VisuStructXYChartCurve;
END_VAR

Zuweisung

IF XYCurve.iInitialized > 0 THEN
   XYCurve.diColor    := 16#00FF0000;           // red
   XYCurve.iLineWidth := iLineWidth;            // line width
END_IF


Tabelle 143. Referenzkurve

Kurve

Kurve, auf die Bezug genommen wird. Die Fläche zwischen den Kurven wird farblich gefüllt.

Farbe

Farbe, mit der die Fläche zwischen den Kurven gefüllt wird.

  • Stilfarbe aus der Auswahlliste. Beispiel: Hellgrau

  • Fester Wert, der im Farbdialog ausgewählt wird. Beispiel: 0; 0; 0



Gruppe: Achseinstellungen

Die Einstellungen beziehen sich auf die in der Baumansicht selektierte Achse.

Tabelle 144. Anzeigeeinstellung

Position

  • X-Achse: Selektierte Achse ist die X-Achse. Im XY-Diagramm gibt es genau eine X-Achse.

  • Auf der linken Seite: Selektierte Achse ist Y-Achse und im Diagramm links dargestellt.

  • Auf der rechten Seite: Selektierte Achse ist Y-Achse und im Diagramm rechts dargestellt

Minimum

Maximum

Minimale und maximale Grenze des Achsenwerts, innerhalb der die Kurve angezeigt wird

. Angabe der Grenze als

  • Variable (numerischer Datentyp)

    Beispiel: PLC_PRG.iMinX, PLC_PRG.iMaxX

  • Konstante Variable (numerischer Datentyp)

    Deklaration in GVL: VAR_GLOBAL CONSTANT c_iMINX : INT; c_iMAXX : INT; END_VAR

    Beispiel: GVL.c_iMINX, GVL.c_iMAXX

  • Fester Wert (numerisches Literal)

    Beispiel: -1000, 1000

Numerischer Datentyp : SINT | INT | DINT | LINT | USINT | UINT | UDINT | ULDINT | REAL | LREAL

Anmerkung

Nur sichtbar, wenn Autoskalierung deaktiviert ist.

Autoskalierung

standard icon: Die Achse wird automatisch skaliert. Die Einstellungen Minimum und Maximum sind nicht sichtbar.



Achsfarbe

  • Stilfarbe aus der Auswahlliste. Beispiel: LightGreen

  • Fester Wert, der im Farbdialog ausgewählt wird.

Tabelle 145. Hintergrund

Typ

  • Kein Hintergrund

  • Reine Farbe: Farbiger Hintergrund, konfiguriert in den Eingabefeldern Farbe und Transparenz

  • Farbverlauf: Hintergrund mit Farbverlauf. _cds_icon_three_dots.png öffnet den Farbverlaufseditor

  • Bild: Hintergrund mit Bild, konfiguriert im Eingabefeld Bild-ID

Farbe

  • Stilfarbe aus der Auswahlliste. Beispiel: LightGreen

  • Fester Wert, der im Farbdialog ausgewählt wird

Verfügbar, wenn der Typ Reine Farbe ausgewählt ist

Transparenz

Transparenzwert (255 bis 0), der die Durchsichtigkeit der zugehörigen Farbe festlegt

Beispiel 255: Die Farbe ist deckend. 0: Die Farbe ist voll transparent

Verfügbar, wenn der Typ Reine Farbe ausgewählt ist

Bild-ID

<image pool name> . <ID>

Beispiel: Images.Logo

Verfügbar, wenn der Typ Bild ausgewählt ist

Transparenzfarbe

standard icon: Hintergrund, mit transparenter Farbe dargestellt

  • Stilfarbe aus der Auswahlliste

    Beispiel: LightGreen

  • Fester Wert, der im Farbdialog ausgewählt wird

Verfügbar, wenn der Typ Bild ausgewählt ist

Skalierungsart

  • Isotropisch:

    Das Bild wird vollständig im Elementrahmen dargestellt und dazu vergrößert oder verkleinert. Dabei werden die Proportionen beibehalten, das Verhältnis Höhe zu Breite bleibt erhalten.

  • Anisotropisch:

    Das Bild passt sich der Größe des Elementrahmens an, so dass der gesamte Elementrahmen gefüllt ist. Dabei werden die Proportionen nicht beibehalten.

  • Fest:

    Das Bild behält die Originalgröße, auch wenn sich die Größe des Elementrahmens ändert. Zu berücksichtigen ist dabei auch, ob die Option Abschneiden aktiviert ist.

Verfügbar, wenn der Typ Bild ausgewählt ist



Tabelle 146. Erweiterte Variablen

Achsvariable

Variable (Datentyp VisuStructXYChartAxis aus Bibliothek VisuElemXYChart)

Die hier konfigurierte Variable wird mit der statischen Konfiguration initialisiert. Zur Laufzeit reagiert das Element Kartesische XY-Diagramm auf Veränderungen in dieser Struktur. Dadurch kann das Element zur Laufzeit programmatisch steuert werden.

Hinweis: Wenn diese Struktur programmatisch gesteuert wird, kann es Probleme mit der Reihenfolge bei den Zuweisungen geben. Daher sollte die Applikation ihre Initialwerte erst zuweisen, wenn das Visualisierungselement initialisiert ist und die Strukturvariable iInitialized auf 1 gewechselt hat.

Die Variable iInitialized steht erst ab CODESYS-Version SP16 zur Verfügung. Bei älteren Versionen lässt sich das Problem mit der Reihenfolge nicht sauber lösen.

Siehe: Beispiel Achsvariable



Beispiel 57. Beispiel Achsvariable

Deklaration

PROGRAM PLC_PRG
VAR
   XYAxis : VisuStructXYChartAxis;
END_VAR

Zuweisung

IF XYCurve.iInitialized > 0 THEN
   XYAxis.rMin := 12.0;           // minimum axis value
   XYAxis.rMax := 36.0;           // maximum axis value
END_IF


Tabelle 147. Erweiterte Darstellungsparameter

Lineal anzeigen

Achsenüberschneidung im Ursprung

Zahlen darstellen

Maximalen Achswert darstellen

Minimalen Achswert darstellen

Mittlere Achswerte darstellen

Zahlen überschreiben

standard icon: Die Achse wird entsprechend dargestellt

Zahlendrehwinkel

Winkel in Grad, der angibt, um wie viel Grad sich die Zahlen der Achsbeschriftung drehen

Beispiel: 45

Die Drehung erfolgt im Uhrzeigersinn, wobei die Null-Grad-Position die übliche Anzeigeposition ist. Die Gradzahl kann negativ sein.

Anmerkung

Wenn eine Drehung eingestellt ist, wird die Einstellung in Zahlen überschreiben nicht berücksichtigt, daher kann die Zahlenanzeige überlappend dargestellt sein.

Drehung ausgerichtet an der Markierung

standard icon: Die Seite des imaginären Kastens, in dem die Zahl angezeigt wird, wird an der Referenzmarkierung ausgerichtet.

_cds_icon_option_deactivated.png: Die Mitte des imaginären Kastens, in dem die Zahl angezeigt wird, wird an der Referenzmarkierung ausgerichtet.

Texte fürs Zahlenersetzen

  • Der Index der Textliste muss dabei gleich der zu ersetzenden Zahl sein

  • Indizes dürfen negativ und gebrochen (mit Nachkommastellen) sein

  • Rotationsfunktion ist auch für Texte verfügbar

Tipp

Es wird dringend empfohlen, kurze Textlisten bereitzustellen. Das Element kann maximal 100 Texte für jede Achse verarbeiten.

Format-String

Zur Formatierung des Ausgabetextes der Achse.

  • Direkte Angabe eines Formatstrings

    Beispiel: dd:MM:yyyy HH:mm:ss:ms

  • Textlisteneintrag, der auf einen lokalisierten Formatstring verweist

    Beispiel: TextList.ID

    In der Textliste kann der Formatstring für verschiedene Sprachen unterschiedlich angegeben werden. Dementsprechend wird der Text sprachabhängig angezeigt.

Der Formatstring für Datum/Zeit wird verwendet, wenn die Daten für diese Achse vom Typ DATE/TIME/TOD/DT sind.

Das Datum und die Uhrzeit werden dann in zwei Zeilen angezeigt. Der Zeilenumbruch erfolgt zwischen Datums- und Zeitformat.



Tabelle 148. Beschriftung

Text-ID

<text list name> . <ID>

Beispiel: Texts.mm (Textliste Texts ist im Projekt bereits vorhanden)

Farbe

_cds_icon_option_deactivated.png: Beschriftung in Achsfarbe

  • Stilfarbe aus der Auswahlliste. Beispiel: LightGreen

  • Fester Wert, der im Farbdialog ausgewählt wird

Verfügbar, wenn Test-ID initialisiert ist

Drehung

  • 0°: Parallel zur Achse

  • 90°: Gedreht zur Achse

  • 270°: Gedreht zur Achse

Verfügbar, wenn Test-ID initialisiert ist.

Schriftart

  • Schriftartstil aus der Auswahlliste. Beispiel: Annotation

  • Fester Wert, der im Standarddialog Schriftart ausgewählt wird

Verfügbar, wenn Test-ID initialisiert ist



Tabelle 149. Pegelwerte

Linie entlang der Achse

Die Linie ist horizontal bei einer Y-Achse und vertikal bei einer X-Achse. Maximal sind 10 Linien möglich.

Liniennummer

Adressiert die Linie und bewirkt, dass für diese Linie im Fensterbereich unter Parameter für Linie <n> die zugehörigen Parametereinstellungen angezeigt werden

Beispiel: 3



Parameter für Linie <n>

Wert

Beispiel: 3

Maximal 10 Linien möglich

Linienart

Beispiel: Punkte

Liniendicke

Beispiel: 2

Farbe

_cds_icon_option_deactivated.png: Linie des Pegelwerts in Achsfarbe

  • Stilfarbe aus der Auswahlliste. Beispiel: LightGreen

  • Fester Wert, der im Farbdialog ausgewählt wird

Text-ID der Beschriftung

<text list name> . <ID>

Beispiel: Texts.mm (Textliste Texts ist im Projekt bereits vorhanden)

Beschriftungsposition

  • Inline

  • Oberhalb

  • Unterhalb

  • Links

  • Rechts

Beschriftungsrotation

  • 0°: Parallel zur der Achse

  • 90°: Gedreht zur Achse

  • 270°: Gedreht zur Achse

Verfügbar, wenn Text-ID der Beschriftung initialisiert ist

Schriftart

  • Schriftartstil aus der Auswahlliste. Beispiel: Annotation

  • Fester Wert, der im Standarddialog Schriftart ausgewählt wird

Verfügbar, wenn Text-ID der Beschriftung initialisiert ist

In diesem Abschnitt:
Siehe auch: