DrawPoints

Draw a collection of points.

Syntax

Definition:

HRESULT DrawPoints(
    HRESULT            hrPrev,
    ITcVnContainer*    ipPoints,
    ITcVnImage*        ipDestImage,
    ETcVnDrawShape     eShape,
    TcVnVector4_LREAL& aColor,
    ULONG              nSize = 3,
    LONG               nThickness = 1,
    ETcVnLineType      eLineType = LT_8_CONNECTED
)

Parameters

Name

Type

Default

Description

hrPrev

HRESULT

 

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

ipPoints

ITcVnContainer*

 

Container with TcVnPoint2_DINT or TcVnPoint2_REAL elements

ipDestImage

ITcVnImage*

 

Destination image

eShape

ETcVnDrawShape

 

Point shape

aColor

TcVnVector4_LREAL&

 

Color (for {-1, -1, -1, -1}, a random color is chosen for each point)

nSize

ULONG

3

Size of the shape (half width)

nThickness

LONG

1

Line thickness (if negative, the shape is filled if it is closed)

eLineType

ETcVnLineType

LT_8_CONNECTED

Line type

DrawPoints 1: Return value

HRESULT

Required License

TC3 Vision Base

System Requirements

Development environment

Target platform

PLC libraries to include

TwinCAT V3.1.4024.59 or later

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

Tc3_Vision