Ovis_Decoration_3D_Line_Create()
Abstract
Creates a 3D line.
Syntax
Ovis_Decoration_3D_Line_Create (from, to, color, thickness, layer_ptr, destroy_proc, user_state_ptr)
| Argument | Type | Description |
|---|---|---|
from |
OvisT_3D_Position |
Start of the line |
to |
OvisT_3D_Position |
End of the line |
color |
PrgT_Color |
Color |
thickness |
unsigned char |
Thickness of the line, in pixels |
layer_ptr |
OvisT_Layer * |
Ovis layer |
destroy_proc |
OvisT_Decoration_State_Destroy_Proc |
Destroys the data associated with the object and deallocates its memory |
user_state_ptr |
void * |
Optional user-provided state of the decoration |
Return Type
OvisT_3D_Line *
The 3D line
Header
ovis_decoration.h
Details
This function creates the Ovis 3D line. It specifies the attributes of the line.
Example
OvisT_3D_Position from, to;
OvisT_3D_Line * line;
PrgT_Color color = prg_color_from_string ("green");
OvisT_Entity * entity;
/* Draw a line between a moving entity and a fixed position */
Ovis_3D_Position_Entity_Set (&from, entity);
Ovis_3D_Position_Geodetic_Set (0, 20, 100);
line = Ovis_Decoration_3D_Line_Create (from, to, color, 3, OPC_NIL, OPC_NIL,
OPC_NIL);
Errors
- None
Reference
- Use the function
Ovis_Decoration_Color_Set()to modify the color of the line. - Use the function
Ovis_Decoration_Transparency_Set()to modify the transparency of the line. - Use the function
Ovis_Decoration_Flashing_Set()to modify the flashing status. - Use the function
Ovis_Shape_Pattern_Set()to modify the pattern used in the line. - Use the function
Ovis_3D_Line_Endpoints_Set()to modify the endpoints of the line. - Use the function
Ovis_Line_Thickness_Set()to modify the thickness of the line. - Use the function
Ovis_Line_Arrows_Set()to enable/disable arrows at the ends of the line.