Visualisierungselement: Path3D

X

X-Koordinate (in Pixel) der linken oberen Ecke des Elements

Beispiel: 10

Y

Y-Koordinate (in Pixel) der linken oberen Ecke des Elements

Beispiel: 10

Breite

Angabe in Pixel

Beispiel: 150

Höhe

Angabe in Pixel

Beispiel: 30

Bahndaten (VisuStruct3DTrack)

Variable vom Typ VisuStruct3DTrack, die im IEC-Code deklariert ist

Beispiel: PLC_PRG.pc.vs3dt.

Eine Beschreibung der Struktur finden Sie im Bibliotheksverwalter in der Bibliothek VisuElem3DPath.library.

Die Datenstruktur beschreibt eine Bahn oder Spur durch eine bestimmte Anzahl von Punkten. Die Punkte werden durch die Applikation bestimmt und gepuffert. Die Spur zeigt typischerweise die letzten n Positionen an, so dass immer nur ein bestimmter Teil von ihnen dargestellt wird.

VisuStruct3DTrack.pProjection ist eine Variable, die durch das Visualisierungselement gesetzt wird und Informationen über die Bahn-/Spurprojektion enthält. Sie kann von der Applikation (nur) gelesen werden. Außerdem können die Methoden Projection.Apply oder .ApplyV verwendet werden, um zu sehen, ob die transformierte Position innerhalb oder außerhalb des Visualisierungsanzeigebereichs liegt, der durch Projection.ElementRect definiert ist.

Bahnfarbe

Farbe der gezeichneten Bahn

Bahnliniendicke

Bahnliniendicke in Pixel

Beispiel: 2

Randpunktmarkierung

Spurdaten(VisuStruct3DTrack)

Variable vom Typ VisuStruct3DTrack, die im IEC-Code deklariert ist

Beispiel: PLC_PRG.pc.vs3dt

Eine Beschreibung der Struktur finden Sie im Bibliotheksverwalter in der Bibliothek VisuElem3DPath.library.

Spurfarbe

Farbe der gezeichneten Spur

Spurliniendicke

Spurliniendicke in Pixel

Beispiel: 2

Steuerungsdatenstruktur (VisuStruct3DControl)

Variable vom Typ VisuStruct3DControl, die im IEC-Code deklariert ist

Beispiel: PLC_PRG.pc.vs3dc

Die Werte können über die Applikation selbst oder über das Visualisierungselement ControlPanel gesetzt werden. Die Bibliothek VisuElem3DPath enthält fertig benutzbare Visualisierungsframes, die eine mögliche Benutzerschnittstelle für diese Daten zur Verfügung stellt.

Eine Beschreibung der Struktur finden Sie im Bibliotheksverwalter in der Bibliothek VisuElem3DPath.

Unter den Ereignissen werden bereits konfigurierte Benutzereingaben aufgelistet. Sie enthalten jeweils die Aktion, die ausgelöst wird, und in knapper Form deren Einstellung.

Beispiel: ST-Code ausführen: PLC_PRG.i_x := 0;

OnDialogClosed

Eingabeereignis: Der Benutzer schließt einen Dialog.

OnMouseClick

Eingabeereignis: Der Benutzer führt im Elementbereich einen vollständigen Mausklick aus. Er drückt die Maustaste und gibt sie wieder frei.

OnMouseDown

Eingabeereignis: Der Benutzer drückt die Maustaste.

OnMouseEnter

Eingabeereignis: Der Benutzer zieht den Mauszeiger auf das Element

OnMouseLeave

Eingabeereignis: Der Benutzer zieht den Mauszeiger von einem Element weg

OnMouseMove

Eingabeereignis: Der Benutzer bewegt den Mauszeiger innerhalb des Elementbereichs

OnMouseUp

Beispielsituation: Ein Visualisierungsbenutzer drückt die Maustaste innerhalb des Elementbereichs des Tastelements und verrutscht dann die Cursorposition so, dass diese außerhalb des Elementbereichs liegt. Die Aktion wird trotzdem beendet, da OnMouseUp auslöst.

OnValueChanged

Ereignis, das durch eine Wertänderung Folgeaktionen auslöst

Welche Folgeaktionen ausgelöst werden, wird im Dialog Eingabekonfiguration konfiguriert.

Die festgelegten Folgeaktionen und die jeweils dazugehörige Konfiguration werden unterhalb der Elementeigenschaft angezeigt.

Das Ereignis OnValueChanged kann durch das Compiler-Define VISU_NO_VALUECHANGED im Eigenschaftendialog der Applikation deaktiviert werden.

Tasten

Bei Auftreten eines Mausklickereignisses wird in der Applikation die unter Variable festgelegte Variable beschrieben. Die Codierung hängt von den Optionen FALSE Tasten und Beim Betreten tasten, falls Maus gefangen ab.

Variable

Voraussetzung: Die Option FALSE Tasten ist nicht aktiviert.

Variable (BOOL) für das Mausklickereignis

TRUE: Es liegt ein Mausklickereignis an. Es dauert solange ein Benutzer die Maustaste drückt, während er mit dem Mauszeiger das Element fokussiert. Es endet, wenn er die Taste freigibt.

FALSE: Es liegt kein Mausklickereignis an.

Beispiel: PLC_PRG.bIsTapped

FALSE Tasten

: Das Mausklickereignis führt zum komplementären Wert in Variable.

TRUE: Es liegt kein Mausklickereignis an.

FALSE: Solange das Mausklickereignis dauert.

Beim Betreten tasten, falls Maus gefangen

: Bei der Benutzereingabe wird zusätzlich berücksichtigt, ob bei gedrückter Maustaste der Mauszeiger innerhalb oder außerhalb des Elementbereichs gezogen wird.

TRUE: Solange das Mausklickereignis dauert und dabei der Mauszeiger innerhalb des Elementbereichs bewegt wird.

FALSE: Es liegt kein Mausklickereignis an. Oder aber der Benutzer bewegt den Mauszeiger bei gedrückter Maustaste außerhalb des Elementbereichs.

Sobald der Benutzer den Mauszeiger in den Elementbereich zurückbewegt, ist der Wert wieder TRUE. Man sagt, die „Maus ist gefangen“.

Umschalten

Bei Auftreten eines Mausklickereignisses wird die Variable gesetzt und bei Beenden des Mausklickereignisses zurückgesetzt.

Variable

Variable (BOOL) für das Umschalten beim Beenden des Mausklickereignisses

Das ist, wenn der Benutzer die Maustaste freigibt und dabei der Mauszeiger im Elementbereich ist. Wenn der Benutzer die Maustaste freigibt und dabei der Mauszeiger außerhalb des Elementbereich ist, liegt kein Beenden des Mausklickereignisses vor und der Wert wird nicht umgeschaltet.

Umschalten beim Loslassen, falls Maus gefangen

: Der Wert schaltet um, unabhängig davon, wo der Mauszeiger beim Freigeben der Maustaste ist. Man sagt, die „Maus ist gefangen“.

Tastaturkürzel

Tastaturkürzel auf dem Element, um bestimmte Eingabeaktionen auszulösen

Bei Eintreten des Tastaturkürzel-Ereignisses werden die unter der Eigenschaft Ereignis(se) angegebenen Eingabeaktionen ausgelöst. Dabei ist nicht die Eingabeaktion selbst angegeben, sondern das Mauseingabeereignis, das auch zu dieser Eingabeaktion führt.

Taste

Taste, bei deren Drücken eine Eingabeaktion folgt.

Beispiel: T

Die folgenden Eigenschaften erscheinen, wenn eine Taste ausgewählt wird.

Ereignis(se)

Umschalten

: Kombination mit Umschalttaste

Beispiel: Umschalt + T

Steuerung

: Kombination mit Steuerungstaste

Beispiel: Strg + T

Alt

: Kombination mit Alt-Taste

Beispiel: Alt + T

Koordinatensystem

: Das Koordinatensystem wird angezeigt

Gitter

: Gitterlinien werden angezeigt

Gitterfarbe

Farbe der Gitterlinien

Hervorhebungsart

Variable

Projektvariable, die die ID eines Elements angibt

Beispiel: PLC_PRG.iVarElementID

Diese „highlight ID“ wird für die Einstellung der Hevorhebungsart berücksichtigt. Die Variable muss in der IEC-Applikation gesetzt werden.

Hervorhebungsfarbe

Beispiel: Rot

Rahmenliniendicke

Dicke des Rahmens um das Element, in Pixel

Beispiel: 1

Rahmenlinienstil

Hintergrund transparent

: Der Hintergrund des Elements wird transparent dargestellt.

: Der Hintergrund des Elements wird in der definierten Hintergrundfarbe dargestellt.

Hintergrundfarbe

Stilfarbe oder Farbe

Die Eigenschaften enthalten feste Werte für die Koordinaten des Rotationspunkts. Der Rotationspunkt ist im Editor als Symbol dargestellt und dient als Zentrum für die Rotation und die Skalierung.

X

X-Koordinate des Rotationspunkts

Y

Y-Koordinate des Rotationspunkts

Bewegung

X

Ein Erhöhen des Werts zur Laufzeit führt zu einer Bewegung nach rechts.

Y

Ein Erhöhen des Werts zur Laufzeit führt zu einer Bewegung nach unten.

Rotation

Variable (numerischer Datentyp) für den Drehwinkel in Grad

Beispiel PLC_PRG.iAngle1.

Der Mittelpunkt des Elements rotiert um den Punkt in Zentrum. Dieser Rotationspunkt wird im Editor als Symbol dargestellt.

Zur Laufzeit bleibt die Ausrichtung des Elements in Bezug zum Koordinatensystem der Visualisierung erhalten. Ein Erhöhen des Werts führt zu einer Rechtsdrehung.

Skalierung

Variable (ganzzahliger Datentyp), um eine zentrische Streckung zu bewirken

Beispiel PLC_PRG.iScaling

Bezugspunkt ist die Eigenschaft Zentrum.

Der Wert 1 verkleinert das Element um den Faktor 0.001. Der Wert 1000 belässt das Element in Originalgröße.

Innere Rotation

Variable (numerischer Datentyp) für den Drehwinkel in Grad

Beispiel: PLC_PRG.iAngle2.

Zur Laufzeit rotiert das Elements entsprechend dem Variablenwert um den Rotationspunkt in Zentrum. Zudem dreht die Ausrichtung des Elements bezüglich des Koordinatensystems der Visualisierung. Ein Erhöhen des Werts im Code bewirkt eine Rechtsdrehung.

Der Rotationspunkt wird im Editor als Symbol dargestellt.

Unsichtbarkeit

Variable (BOOL) für das Umschalten der Sichtbarkeit des Elements

TRUE: Das Element ist zur Laufzeit nicht sichtbar.

Animationsdauer

Vairable für die Dauer in Millisekunden, in der das Element eine Animation ausführt

Die animierte Bewegung wird ausgeführt, wenn mindestens ein Wert einer animierbaren Eigenschaft geändert wird. Die dann ausgeführte Bewegung ist nicht ruckartig, sondern wird reibungslos in der angegebenen Animationsdauer ausgeführt. Das Visualisierungselement fliegt die Sollposition an und rotiert dabei dynamisch. Die Übergänge sind fließend.

In den Vordergrund bringen

Variable (BOOL) für das Stellen des Elements in den Vordergrund

TRUE: Das Visualisierungselement wird zur Laufzeit im Vordergrund dargestellt.

FALSE: Das Visualisierungselement wird zur Laufzeit in der Ebene dargestellt, in der es im Visualisierungseditor eingefügt wurde.

Beispiel: bIsInForeground mit VAR bIsInForeground : BOOL := FALSE; END_VAR

Schaltfläche Zugriffsrechte

Öffnet den Dialog Zugriffsrechte. Dort können Sie die Zugriffsrechte für das Element ändern.