Ovis_3D_Line_Endpoints_Get()
Abstract
Returns the start and end positions of a 3D line.
Syntax
Ovis_3D_Line_Endpoints_Get (line_dec_ptr, from_ptr, to_ptr)
| Argument | Type | Description |
|---|---|---|
line_dec_ptr |
OvisT_3D_Line * |
Line |
from_ptr |
OvisT_3D_Position * |
Start of the line |
to_ptr |
OvisT_3D_Position * |
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 returns 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 */
Ovis_3D_Line_Endpoints_Get (line, &from, &to);
Errors
- Return address for 'from' position value is NIL.
- Return address for 'to' position value is NIL.
- Decoration is NIL.
- Decoration is not a 3D Line.
Reference
- Use the function
Ovis_3D_Line_Endpoints_Set()to modify the endpoints of the line.