Hilfsfunktionen

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.

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.

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:

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:

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.

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.

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,
// }