NAME

       dtk_create_circle - Create and modify circular shape

SYNOPSIS

       #include <drawtk.h>

       dtk_hshape dtk_create_circle(dtk_hshape shp,
                       float cx, float cy, float r, int filled,
                       const float *color, unsigned int numpoints);

DESCRIPTION

       dtk_create_circle()  creates  an approximation of a circle of radius r centered at (cx,cy)
       using num_points vertices.

       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)