F_VN_ReferenceColorSimilarityExp_TcVnVector3_LREAL
Computes the similarity to a reference color for each pixel in the source image. (expert function)
Can use available TwinCAT Job Tasks for executing parallel code regions.
Can return partial results when canceled by Watchdog.
Syntax
Definition:
FUNCTION F_VN_ReferenceColorSimilarityExp_TcVnVector3_LREAL : HRESULT
VAR_INPUT
ipSrcImage : ITcVnImage;
ipDestImage : Reference To ITcVnImage;
END_VAR
VAR_IN_OUT
aRefColor : TcVnVector3_LREAL;
END_VAR
VAR_INPUT
fVariance : REAL;
fLuminanceWeight : REAL;
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipSrcImage |
RGB source image (USINT, 3 channels) | |
|
ipDestImage |
Reference To ITcVnImage |
Returns the similarity to aRefColor for each pixel in ipSrcImage (USINT, 1 channel. An appropriate destination image will be created if required.) |
|
fVariance |
REAL |
Allowed color variance (0.1 - 0.3 might be a good start to try) |
|
fLuminanceWeight |
REAL |
Weight the impact of the luminance ([0..1], e.g. set to 0 to be more resistant to unequal illumination, but might be required to differentiate between some colors) |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
Return valueWeiterfü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,
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
Required License
TC3 Vision Base
System Requirements
Development environment | Target platform | PLC libraries to include |
|---|---|---|
TwinCAT V3.1.4024.59 or later | PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU | Tc3_Vision |