F_VN_ReferenceColorSimilarity_ITcVnColorModel

Computes the similarity to a reference color model for each pixel in the source image.
Can use available TwinCAT Job Tasks for executing parallel code regions.
Can return partial results when canceled by Watchdog.

Syntax

Definition:

FUNCTION F_VN_ReferenceColorSimilarity_ITcVnColorModel : HRESULT
VAR_INPUT
    ipSrcImage   : ITcVnImage;
    ipDestImage  : Reference To  ITcVnImage;
    ipColorModel : ITcVnColorModel;
    hrPrev       : HRESULT;
END_VAR

Inputs

Name	Type	Description
ipSrcImage	ITcVnImage	RGB source image (USINT, 3 channels)
ipDestImage	Reference To ITcVnImage	Returns the similarity to ipColorModel for each pixel in ipSrcImage (USINT, 1 channel. An appropriate destination image will be created if required.)
ipColorModel	ITcVnColorModel	Color model
hrPrev	HRESULT	HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

Return value

HRESULT

Weiterführende Informationen

Es gibt drei Möglichkeiten die Referenzfarbe an die entsprechende Funktion zu übergeben:

Als trainiertes Farbmodell vom Typ ITcVnColorModel
Als trainiertes Farbmodell vom Typ ITcVnMlModel
Direkt mit Werten in einem TcVnVector3_LREAL, siehe Beispiel

Zum Trainieren eines Farbmodells muss eine entsprechende F_VN_TrainImageColor Funktion verwendet werden. Die beiden Farbmodelle unterscheiden sich nur im Datentyp, funktionell gibt es keine Unterschiede. Der ITcVnMlModel ist der allgemeine Datentyp für ML-Modelle für den es auch Funktionsbausteine zum Laden und Speichern gibt. Daher sollte dieser Datentyp und die entsprechenden Funktionen verwendet werden, wenn das Trainierte Farbmodell auf der Festplatte gespeichert werden soll.

Beispiele

Color Similarity mit RGB-Referenz-Farbe

Required License

TC3 Vision Base

System Requirements

Development environment	Target platform	PLC libraries to include
TwinCAT V3.1. 4024.44 or later	PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU	Tc3_Vision