F_VN_DrawComponentsExp

F_VN_DrawComponentsExp 1:

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

Syntax

Definition:

FUNCTION F_VN_DrawComponentsExp : HRESULT
VAR_INPUT
    ipLabelImage : ITcVnImage;
    nLabelID     : DINT;
    ipDestImage  : Reference To ITcVnImage;
    bShowLabelID : BOOL;
END_VAR
VAR_IN_OUT
    aColor       : TcVnVector4_LREAL;
END_VAR
VAR_INPUT
    nThickness   : DINT;
    fFontScale   : LREAL;
    hrPrev       : HRESULT;
END_VAR

F_VN_DrawComponentsExp 2: Inputs

Name

Type

Description

ipLabelImage

ITcVnImage

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

nLabelID

DINT

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

ipDestImage

Reference To 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

nThickness

DINT

Text line thickness

fFontScale

LREAL

Scaling factor for the text

hrPrev

HRESULT

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

F_VN_DrawComponentsExp 3: In/Outputs

Name

Type

Description

aColor

TcVnVector4_LREAL

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

F_VN_DrawComponentsExp 4: Return value

HRESULT

Required License

TC3 Vision Base

System Requirements

Development environment

Target platform

PLC libraries to include

TwinCAT V3.1. 4024.44 or later

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

Tc3_Vision