DrawContours

Draws a single point set or multiple point sets that are interpreted as contours.

Syntax

Definition:

HRESULT DrawContours(
    HRESULT            hrPrev,
    ITcVnContainer*    ipContours,
    LONG               nContourIndex,
    ITcVnImage*        ipDestImage,
    TcVnVector4_LREAL& aColor,
    LONG               nThickness,
    ETcVnLineType      eLineType = LT_8_CONNECTED,
    ITcVnContainer*    ipHierarchy = nullptr,
    LONG               nMaxLevel = 2147483647,
    TcVnPoint&         aOffset = {0, 0}
)

Parameters

Name

Type

Default

Description

hrPrev

HRESULT

 

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

ipContours

ITcVnContainer*

 

Single contour (ContainerType_Vector_TcVnPoint2_DINT) or multiple contours (ContainerType_Vector_Vector_TcVnPoint2_DINT)

nContourIndex

LONG

 

Index of a specific contour to be drawn (if negative, all contours within the container are drawn)

ipDestImage

ITcVnImage*

 

Destination image

aColor

TcVnVector4_LREAL&

 

Color

nThickness

LONG

 

Line thickness (if negative, the contours are filled)

eLineType

ETcVnLineType

LT_8_CONNECTED

Line type

ipHierarchy

ITcVnContainer*

nullptr

Contour hierarchy (ContainerType_Vector_TcVnVector4_DINT)

nMaxLevel

LONG

2147483647

Maximum level of contours to be drawn

aOffset

TcVnPoint&

{0, 0}

Offset by which every contour point is shifted

DrawContours 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