F_VN_DrawLine_TcVnVector4_DINT

F_VN_DrawLine_TcVnVector4_DINT 1:

Draws a line.

Syntax

Definition:

FUNCTION F_VN_DrawLine_TcVnVector4_DINT : HRESULT
VAR_IN_OUT
    aLine       : TcVnVector4_DINT;
END_VAR
VAR_INPUT
    ipDestImage : ITcVnImage;
END_VAR
VAR_IN_OUT
    aColor      : TcVnVector4_LREAL;
END_VAR
VAR_INPUT
    nThickness  : DINT;
    hrPrev      : HRESULT;
END_VAR

F_VN_DrawLine_TcVnVector4_DINT 2: Inputs

Name

Type

Description

ipDestImage

ITcVnImage

Destination image

nThickness

DINT

Line thickness

hrPrev

HRESULT

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

F_VN_DrawLine_TcVnVector4_DINT 3: In/Outputs

Name

Type

Description

aLine

TcVnVector4_DINT

The start and end point of a line segment [x1, y1, x2, y2]

aColor

TcVnVector4_LREAL

Color

F_VN_DrawLine_TcVnVector4_DINT 4: Return value

HRESULT

HRESULT

16#734

OUTOFRANGE

Part of the line lies outside of the image area. Use the function F_VN_ClipLineToBoundary_ITcVnImage to ensure that the specified line fits in the image area.

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