1DTK_CREATE_CIRCLE_STR(3)      Draw Toolkit manual     DTK_CREATE_CIRCLE_STR(3)
2
3
4

NAME

6       dtk_create_circle_str - Create and modify circular strip
7

SYNOPSIS

9       #include <drawtk.h>
10
11       dtk_hshape dtk_create_circle_str(dtk_hshape shp,
12                       float cx, float cy, float r, float thick,
13                       const float *color, unsigned int numpoints);
14

DESCRIPTION

16       dtk_create_circle_str() creates an approximation of a circular strip of
17       radius r centered at (cx,cy) using num_points vertices. The radius r is
18       always referred to the outer circle.
19
20       thick  represents  the  thickness of the strip. If thick is negative or
21       greater than r, the call fails.
22
23       shp and color have the same usage and meaning as for other  shape  cre‐
24       ation function:
25
26        * shp  can be used to modify a previously created shape. If it is non-
27          null, the handle will be used to modify the shape referenced by shp.
28          If shp is NULL, the function will attempt to create a new shape.
29
30        * color  should  point to a 4 float array containing a normalized RGBA
31          value (i.e. each component is between 0.0 and 1.0).
32

RETURN VALUE

34       In case of success these functions return the handle to the newly  cre‐
35       ated  or  modified  shape.  If the shp argument is non-null, the handle
36       returned is the same value. In case of  error,  NULL  is  returned.  If
37       thick is negative or greater than r, NULL is returned.
38

SEE ALSO

40       dtk_create_circle(3),dtk_destroy_shape(3)
41
42
43
44
45
46EPFL                                 2012             DTK_CREATE_CIRCLE_STR(3)
Impressum