F_VN_TrainImageColor
Create a new color model, describing the image color.
Can use available TwinCAT Job Tasks for executing parallel code regions.
Can return partial results when canceled by Watchdog.
Syntax
Definition:
FUNCTION F_VN_TrainImageColor : HRESULT
VAR_INPUT
ipSrcImage : ITcVnImage;
ipColorModel : Reference To ITcVnColorModel;
nDifferentColors : UDINT;
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipSrcImage |
Source image (3 channels (RGB) of type USINT) | |
|
ipColorModel |
Reference To ITcVnColorModel |
Returns the color model |
|
nDifferentColors |
UDINT |
Number of different colors to distinguish |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
Return valueWeiterführende Informationen
Die Funktion F_VN_TrainImageColor trainiert ein Farbmodell basierend auf einem Referenzbild. Wenn das trainierte Farbmodell auf der Festplatte gespeichert werden soll, muss die F_VN_TrainImageColor_ITcVnMlModel mit dem Typ ITcVnMlModel verwendet werden.
Parameter
Referenzbild
Das Referenzbild ipSrcImage muss 3 Kanäle im RGB-Format und den Element-Typ USINT (8 Bit) haben.
Farbmodell
Der Parameter ipColorModel gibt das trainierte Farbmodell zurück. Dieses ist ein Interface Pointer vom Typ ITcVnColorModel.
Anzahl zu unterscheidender Farben
Die Anzahl nDifferentColors definiert die Anzahl an zu trainierenden Farben. Achten Sie darauf, der Bildhintergrund z. B. auch eine eigene Farbe sein kann.
Expert-Parameter
Weitere Parameter finden Sie in der Expert-Variante F_VN_TrainImageColorExp.
Anwendung
Das Trainieren eines Farbmodells für ein Referenzbild mit 4 verschiedenfarbigen Objekten sowie dunklem Hintergrund sieht z.B. so aus:
VAR
ipColorModel : ITcVnColorModel;
END_VAR
hr := F_VN_TrainImageColor(
ipSrcImage := ipImageRef,
ipColorModel := ipColorModel,
nDifferentColors:= 5, // 4 colors + 1 background = 5
hrPrev := hr);
Verwandte Funktionen
Es gibt drei Möglichkeiten die Referenzfarbe an die entsprechende F_VN_ReferenceColorSimilarity Funktion zu übergeben:
- Als trainiertes Farbmodell vom Typ
ITcVnColorModel - Als trainiertes Farbmodell vom Typ
ITcVnMlModel - Direkt mit Werten in einem
TcVnVector3_LREAL
Für die Farbmodelle gibt es entsprechende Funktionen zum Trainieren und für alle drei Datentypen jeweils eine Funktion zur Ausführung:
- F_VN_TrainImageColor zum Trainieren eines Farbmodells
- F_VN_ReferenceColorSimilarity zur Segmentierung mittels Farbmodell
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 |