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