F_VN_ConnectedComponentsWithStatsExp

F_VN_ConnectedComponentsWithStatsExp 1:

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

F_VN_ConnectedComponentsWithStatsExp 2: Inputs

Name

Type

Description

ipSrcImage

ITcVnImage

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

ETcVnPixelConnectivity

Selects if 4- or 8-way pixel connectivity should be used

eLabelType

ETcVnElementType

Selects the type of ipLabelImage (only UINT or DINT supported)

eAlgorithm

ETcVnConnectedComponentsAlgorithm

Selects the applied algorithm

hrPrev

HRESULT

HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

F_VN_ConnectedComponentsWithStatsExp 3: In/Outputs

Name

Type

Description

nLabels

DINT

Returns the number of labels

F_VN_ConnectedComponentsWithStatsExp 4: Return value

HRESULT

Required License

TC3 Vision Base

System Requirements

Development environment

Target platform

PLC libraries to include

TwinCAT V3.1.4024.54 or later

PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU

Tc3_Vision