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

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

Tc3_Vision