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:
HRESULT ReferenceColorSimilarity(
HRESULT hrPrev,
ITcVnImage* ipSrcImage,
ITcVnImage*& ipDestImage,
ITcVnColorModel* ipColorModel,
float fVariance = 0.15f,
float fLuminanceWeight = 0
)
Parameters
|
Name |
Type |
Default |
Description |
|---|---|---|---|
|
hrPrev |
|
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) | |
|
ipSrcImage |
|
RGB source image (USINT, 3 channels) | |
|
ipDestImage |
|
Returns the similarity to ipColorModel for each pixel in ipSrcImage (USINT, 1 channel. An appropriate destination image will be created if required.) | |
|
ipColorModel |
|
Color model | |
|
fVariance |
float |
0.15f |
Allowed color variance (0.1 - 0.3 might be a good start to try) |
|
fLuminanceWeight |
float |
0 |
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. Ignored if ipColorModel is of type RGB.) |
Return valueRequired 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 |