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

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

Tc3_Vision