Ovis_3D_Triangle_Corners_Get()
Abstract
Returns the corner positions of a 3D triangle.
Syntax
Ovis_3D_Triangle_Corners_Get (triangle_dec_ptr, a_ptr, b_ptr, c_ptr)
| Argument | Type | Description |
|---|---|---|
triangle_dec_ptr |
OvisT_3D_Triangle * |
Triangle |
a_ptr |
OvisT_3D_Position * |
a position of the triangle |
b_ptr |
OvisT_3D_Position * |
b position of the triangle |
c_ptr |
OvisT_3D_Position * |
c position of the triangle |
Return Type
OvisT_Compcode
OvisC_Compcode_Success if the provided object is a valid triangle. Otherwise, it returns OvisC_Compcode_Failure.
Header
ovis_decoration.h
Details
Returns the a, b, and c corner positions of the 3D triangle.
Example
OvisT_3D_Position a, b, c;
OvisT_3D_Triangle * triangle;
/* … triangle created at some point */
Ovis_3D_Triangle_Corners_Get (triangle, &a, &b, &c);
Errors
- Decoration is NIL.
- Decoration is not a 3D triangle.
- Return address for 'a' corner position is NIL.
- Return address for 'b' corner position is NIL.
- Return address for 'c' corner position is NIL.
Reference
- Use the function
Ovis_3D_Triangle_Corners_Set()to specify the corners of a triangle.