trusty (3) dtk_create_circle.3.gz

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)