Ovis_Decoration_2D_Line Create()
Abstract
Creates a 2D line.
Syntax
Ovis_Decoration_2D_Line_Create (from, to, color, thickness, layer_ptr, destroy_proc, user_state_ptr)
| Argument | Type | Description |
|---|---|---|
from |
OvisT_2D_Position |
Start of the line |
to |
OvisT_2D_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_2D_Line *
The 2D line
Header
ovis_decoration.h
Details
This function creates the Ovis 2D line. It specifies the attributes of the line.
Example
OvisT_2D_Position from, to;
OvisT_2D_Line * line;
PrgT_Color olor = prg_color_from_string ("green");
from.x = to.x = 0;
from.y = 50;
to.y = -50;
line = Ovis_Decoration_2D_Line_Create (from, to, color, 3, OPC_NIL,
OPC_NIL, OPC_NIL);
Errors
- Invalid 'from' 2D position
<x,y>. 2D position values must be between –128 and 127. - Invalid 'to' 2D position
<x,y>. 2D position values must be between –128 and 127.
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_2D_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.