F_VN_ConnectedComponentsExp

F_VN_ConnectedComponentsExp 1:

Computes the connected components of an image. (expert function)

Syntax

Definition:

FUNCTION F_VN_ConnectedComponentsExp : HRESULT
VAR_INPUT
    ipSrcImage    : ITcVnImage;
    ipLabelImage  : Reference To ITcVnImage;
END_VAR
VAR_IN_OUT
    nLabels       : DINT;
END_VAR
VAR_INPUT
    eConnectivity : ETcVnPixelConnectivity;
    eLabelType    : ETcVnElementType;
    eAlgorithm    : ETcVnConnectedComponentsAlgorithm;
    hrPrev        : HRESULT;
END_VAR

F_VN_ConnectedComponentsExp 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, type depends on eLabelType. An appropriate destination image will be created if required.)

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_ConnectedComponentsExp 3: In/Outputs

Name

Type

Description

nLabels

DINT

Returns the number of labels

F_VN_ConnectedComponentsExp 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