DrawLines

Draws lines.

Syntax

Definition:

HRESULT DrawLines(
    HRESULT            hrPrev,
    ITcVnContainer*    ipLines,
    LONG               nLineIndex,
    ITcVnImage*        ipDestImage,
    TcVnVector4_LREAL& aColor,
    LONG               nThickness,
    ETcVnLineType      eLineType = LT_8_CONNECTED,
    ULONG              nShift = 0
)

Parameters

Name

Type

Default

Description

hrPrev

HRESULT

 

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

ipLines

ITcVnContainer*

 

Container with line descriptions (ContainerType_Vector_TcVnVector2_REAL: the distance from the origin [0] in pixels and the rotation angle [1] in radians. ContainerType_Vector_TcVnVector4_LREAL: the first and second element describe the x and y component of a vector collinear to the line. The third and fourth element describe the x and y component of a point on the line. ContainerType_Vector_TcVnVector4_DINT: start and end point [x1, y1, x2, y2])

nLineIndex

LONG

 

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

ipDestImage

ITcVnImage*

 

Destination image

aColor

TcVnVector4_LREAL&

 

Color

nThickness

LONG

 

Line thickness

eLineType

ETcVnLineType

LT_8_CONNECTED

Line type

nShift

ULONG

0

Fractional bits of the coordinates (bit shift)

DrawLines 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