F_VN_ClipLineToBoundary_ITcVnImage

F_VN_ClipLineToBoundary_ITcVnImage 1:

Clips a line to the boundary of an image.

Syntax

Definition:

FUNCTION F_VN_ClipLineToBoundary_ITcVnImage : HRESULT
VAR_IN_OUT
    aLine       : TcVnVector4_LREAL;
END_VAR
VAR_INPUT
    ipImage     : ITcVnImage;
END_VAR
VAR_IN_OUT
    aStartPoint : TcVnPoint2_REAL;
    aEndPoint   : TcVnPoint2_REAL;
END_VAR
VAR_INPUT
    hrPrev      : HRESULT;
END_VAR

F_VN_ClipLineToBoundary_ITcVnImage 2: Inputs

Name

Type

Description

ipImage

ITcVnImage

Image, from which to derive the boundary

hrPrev

HRESULT

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

F_VN_ClipLineToBoundary_ITcVnImage 3: In/Outputs

Name

Type

Description

aLine

TcVnVector4_LREAL

The first and second element describe the x and y component of the direction vector. The third and fourth element describe the x and y component of the position vector.

aStartPoint

TcVnPoint2_REAL

Returns the clipped starting point of the line.

aEndPoint

TcVnPoint2_REAL

Returns the clipped end point of the line.

F_VN_ClipLineToBoundary_ITcVnImage 4: Return value

HRESULT

Further information

This function adjusts a line to a specified area.

Different functions exist for various definition forms in this area:

Definition of the rectangular area

Function to be used

Specified by individual X/Y coordinates

F_VN_ClipLineToBoundary

By the size of an image

F_VN_ClipLineToBoundary_ITcVnImage

By a rectangular structure

F_VN_ClipLineToBoundary_TcVnRectangle_DINT

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