Ovis_3D_Line_Endpoints_Set()
Abstract
Specifies the start and end positions of a 3D line.
Syntax
Ovis_3D_Line_Endpoints_Set (line_dec_ptr, from, to)
| Argument | Type | Description |
|---|---|---|
line_dec_ptr |
OvisT_3D_Line * |
Line |
from |
OvisT_3D_Position |
Specifies the start of the line |
to |
OvisT_3D_Position |
Specifies the end of the line |
Return Type
OvisT_Compcode
OvisC_Compcode_Success if the provided object is a valid line. Otherwise, it returns OvisC_Compcode_Failure.
Header
ovis_decoration.h
Details
This function specifies the start and end positions of the 3D line. The line can be a solid line or a segmented line.
Example
OvisT_3D_Position from, to;
OvisT_3D_Line * line;
/* … .line created at some point */
/* Line from 100 to 200 meters above the Equator at the Greenwich line */
Ovis_3D_Position_Geodetic_Set (&from, 0, 0, 100);
Ovis_3D_Position_Geodetic_Set (&to, 0, 0, 200);
Ovis_3D_Line_Endpoints_Set (line, from, to);
Errors
- Decoration is not a 3D line.
- Decoration is NIL.
Reference
- Use the function
Ovis_3D_Line_Endpoints_Get()to obtain the endpoints of the line.