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

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

Tc3_Vision