F_VN_DrawLines
Draws lines.
Syntax
Definition:
FUNCTION F_VN_DrawLines : HRESULT
VAR_INPUT
ipLines : ITcVnContainer;
nLineIndex : DINT;
ipDestImage : ITcVnImage;
END_VAR
VAR_IN_OUT
aColor : TcVnVector4_LREAL;
END_VAR
VAR_INPUT
nThickness : DINT;
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipLines |
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 |
DINT |
Index of a specific line to be drawn (if negative, all lines within the container are drawn) |
|
ipDestImage |
Destination image | |
|
nThickness |
DINT |
Line thickness |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
Return valueHRESULT
|
| 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 |