F_VN_ConnectedComponentsWithStatsExp
Computes the connected components and corresponding statistics of an image. (expert function)
Syntax
Definition:
FUNCTION F_VN_ConnectedComponentsWithStatsExp : HRESULT
VAR_INPUT
ipSrcImage : ITcVnImage;
ipLabelImage : Reference To ITcVnImage;
ipBoundingBoxes : Reference To ITcVnContainer;
ipNumPixels : Reference To ITcVnContainer;
ipCentroids : Reference To ITcVnContainer;
END_VAR
VAR_IN_OUT
nLabels : DINT;
END_VAR
VAR_INPUT
eConnectivity : ETcVnPixelConnectivity;
eLabelType : ETcVnElementType;
eAlgorithm : ETcVnConnectedComponentsAlgorithm;
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipSrcImage |
Source image (USINT, 1 channel, binary) | |
|
ipLabelImage |
Reference To ITcVnImage |
Returns the labels for each source image pixel (1 channel, DINT. An appropriate destination image will be created if required.) |
|
ipBoundingBoxes |
Reference To ITcVnContainer |
Returns the bounding boxes for each labeled region. (ContainerType_Vector_TcVnRectangle_DINT; Non-zero interface pointers are reused.) |
|
ipNumPixels |
Reference To ITcVnContainer |
Returns the number of pixels for each labeled region. (ContainerType_Vector_DINT; Non-zero interface pointers are reused.) |
|
ipCentroids |
Reference To ITcVnContainer |
Returns the centroids for each labeled region. (ContainerType_Vector_TcVnPoint2_LREAL; Non-zero interface pointers are reused.) |
|
eConnectivity |
Selects if 4- or 8-way pixel connectivity should be used | |
|
eLabelType |
Selects the type of ipLabelImage (only UINT or DINT supported) | |
|
eAlgorithm |
Selects the applied algorithm | |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
In/Outputs
|
Name |
Type |
Description |
|---|---|---|
|
nLabels |
DINT |
Returns the number of labels |
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 |