DrawComponents

Draw the results of connected component function.
Can use available TwinCAT Job Tasks for executing parallel code regions.

Syntax

Definition:

HRESULT DrawComponents(
    HRESULT            hrPrev,
    ITcVnImage*        ipLabelImage,
    LONG               nLabelID,
    ITcVnImage*&       ipDestImage,
    bool               bShowLabelID,
    TcVnVector4_LREAL& aColor = {-1, -1, -1, -1},
    LONG               nThickness = 1,
    double             fFontScale = 1
)

Parameters

Name

Type

Default

Description

hrPrev

HRESULT

 

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

ipLabelImage

ITcVnImage*

 

Image contains labels for each pixel (1 channel DINT or UINT).

nLabelID

LONG

 

Value of a specific label to be drawn (if negative, all components within the image are drawn)

ipDestImage

ITcVnImage*&

 

Destination image (An appropriate image will be created if required. The output image is 1 or 3 channels USINT).

bShowLabelID

bool

 

Show lable ID in the center of the component on the destination image

aColor

TcVnVector4_LREAL&

{-1, -1, -1, -1}

Color to draw the components (for {-1, -1, -1, -1}, a random color is chosen for each component)

nThickness

LONG

1

Text line thickness

fFontScale

double

1

Scaling factor for the text

DrawComponents 1: Return value

HRESULT

Required License

TC3 Vision Base

System Requirements

Development environment

Target platform

PLC libraries to include

TwinCAT V3.1.4024.59 or later

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

Tc3_Vision