NAME¶
dtk_create_triangle - Create and modify triangle shape
SYNOPSIS¶
#include <drawtk.h>
dtk_hshape dtk_create_triangle(dtk_hshape shp,
float x1, float y1,
float x2, float y2,
float x3, float y3,
int filled, const float *color);
DESCRIPTION¶
dtk_create_triangle() creates a triangle between the vertices (
x1,
y1), (
x2,
y2) and (
x3,
y3).
shp,
filled and
color have the same usage and meaning as
for other shape creation function:
- *
- shp can be used to modify a previously created
shape. If it is non-null, the handle will be used to modify the shape
referenced by shp: no new shape is created and the returned value
is ensured to be shp in case of success, NULL otherwise. If
shp is NULL, the function will attempt to create a new
shape.
- *
- filled is set to 0 if the described shape should be
a continuous line or a non-null value if the shape is supposed to be
filled polygon.
- *
- color should point to a 4 float array containing a
normalized RGBA value (i.e. each component is between 0.0 and 1.0).
RETURN VALUE¶
In case of success these functions return the handle to the newly created or
modified shape. If the
shp argument is non-null, the handle returned is
the same value. In case of error,
NULL is returned.
SEE ALSO¶
dtk_destroy_shape(3)