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.54 or later

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

Tc3_Vision