Ovis_2D_Triangle_Corners_Set()
Abstract
Specifies the corner positions of the 2D triangle.
Syntax
Ovis_2D_Triangle_Corners_Set (triangle_dec_ptr, a, b, c)
| Argument | Type | Description |
|---|---|---|
triangle_dec_ptr |
OvisT_2D_Triangle * |
Triangle |
a |
OvisT_2D_Corner |
Specifies point a |
b |
OvisT_2D_Corner |
Specifies point b |
c |
OvisT_2D_Corner |
Specifies point c |
Return Type
OvisT_Compcode
OvisC_Compcode_Success if the provided object is a valid 2D triangle. Otherwise, it returns OvisC_Compcode_Failure.
Header
ovis_decoration.h
Details
This function specifies the corner positions of the 2D triangle. Corners are defined relative to the "center" position of the triangle using values between -1 and 1. A corner of 1,1 based on a center in the middle of the window will be in the upper-right corner of the window.
Example
OvisT_2D_Corner a, b, c;
OvisT_2D_Triangle * triangle;
/* … .triangle created at some point */
/* One corner on the "center", the other two a bit below and to the left and right of the center */
a.x_offset = a.y_offset = 0;
b.x_offset = -0.1b.y_offset = -0.1;
c.x_offset = +0.1; c.y_offset = -0.1;
Ovis_2D_Triangle_Corners_Set (triangle, a, b, c);
Errors
- Decoration is not a 2D triangle.
- Decoration is NIL.
Reference
- Use the function
Ovis_2D_Triangle_Corners_Get()to obtain the corners of a triangle.