Hilfsfunktionen
Folgende Hilfsfunktionen werden als Standardverhalten von bestimmten Controls genutzt oder um Interoperabilität mit PLC-Datentypen zu gewährleisten.
BoxColorConverter
Die Funktion BoxColorConverter
ist in der Kategorie Vision
gelistet. Sie wird als Standard-Wert für das BoxColorConversion
Attribut des Color Controls verwendet. Sie konvertiert zwischen dem RGB und dem durch den format
-Parameter angegebenen Farbformat.
Parameter | Datentyp | Beschreibung |
---|---|---|
|
| Der zu konvertierende Farbwert. |
|
| Richtung der Konvertierung.
|
|
| Format für Konvertierung:
|
Die Funktion gibt die konvertierte Farbe als Number[]
zurück.
ConvertColor
Die Funktion ConvertColor
ist in der Kategorie Vision
gelistet. Sie konvertiert ein Farbarray zwischen den Formaten Gray, RGB, HSV und HLS.
Parameter | Datentyp | Beschreibung |
---|---|---|
|
| Der zu konvertierende Farbwert. |
|
| Format des angegebenen Farbwerts:
|
|
| Format, in das konvertiert wird:
|
|
| Rundet alle Ausgabeelemente auf Integer-Werte. |
Die Funktion gibt die konvertierte Farbe als Number[]
zurück.
Um z.B. die Farbe Rot im RGB-Format in das HLS-Format zu konvertieren, kann folgender Funktionsaufruf verwendet werden:
let rgb = [255, 0, 0];
let hls = TcHmi.Functions.Beckhoff.Vision.ConvertColor(rgb, "RGB", "HLS", true);
console.log(hls);
//console output
//[0, 127.5, 255]
PixelColorFormatter
Die Funktion PixelColorFormatter
ist in der Kategorie Formatting
gelistet. Sie ist der Standardwert für das PixelColorFormat
-Eigenschaft des Image Watch Controls. Sie konvertiert den PixelColor
-Wert in einen per HTLM darstellbaren String. Konkret werden die Farbwerte der einzelnen Kanäle aneinandergehangen und farblich markiert:
Parameter | Datentyp | Beschreibung |
---|---|---|
|
| Der zu konvertierende Farbwert. |
Die Funktion gibt einen als HTML codierten String
zurück.
ShapeValueFormatter
Die Funktion ShapeValueFormatter
ist in der Kategorie Formatting
gelistet. Sie ist der Standardwert für die ShapeValueFormat
-Eigenschaft des Image Watch Controls. Sie konvertiert den ShapeValue
-Wert in einen per HTML darstellbaren String. Konkret wird z. B. bei einem Rechteck die Fläche in Pixeln berechnet und als String zurückgegeben:
Parameter | Datentyp | Beschreibung |
---|---|---|
|
| Die zu konvertierenden Shape Daten. |
| Typ des übergebenen Shapes. |
Die Funktion gibt einen als HTML codierten String
zurück.
ToRotatedRectangle
Die Funktion ToRotatedRectangle
ist in der Kategorie Data Conversion gelistet. Sie konvertiert ein UprightRectangle
in ein RotatedRectangle
mit Winkel 0
.
Parameter | Datentyp | Beschreibung |
---|---|---|
| Das zu konvertierende Rechteck. |
Die Funktion gibt das konvertierte Rechteck als TcVnRotatedRectangle zurück und kann wie folgt angewandt werden:
let upright = {
nWidth: 100,
nHeight: 60,
nX: 200,
nY: 100,
}
let rotated = TcHmi.Functions.Beckhoff.Vision.ToRotatedRectangle(upright);
console.log(rotated);
//console output
// {
// aCenter: [250, 130],
// fAngle: 0,
// stSize: { fWidth: 100, fHeight: 60 },
// }
ToUprightRectangle
Die Funktion ToUprightRectangle
ist in der Kategorie Data Conversion gelistet. Sie konvertiert ein RotatedRectangle
in ein UprightRectangle
und verwirft dabei den Winkel.
Parameter | Datentyp | Beschreibung |
---|---|---|
| Das zu konvertierende Rechteck. |
Die Funktion gibt das konvertierte Rechteck als TcVnRectangle zurück und kann wie folgt angewandt werden:
let rotated = {
aCenter: [250, 130],
fAngle: 0,
stSize: { fWidth: 100, fHeight: 60 },
}
let upright = TcHmi.Functions.Beckhoff.Vision.ToUprightRectangle(rotated);
console.log(upright);
//console output
// {
// nWidth: 100,
// nHeight: 60,
// nX: 200,
// nY: 100,
// }