NAME

       dtk_create_shape - Create and modify custom shape

SYNOPSIS

       #include <drawtk.h>

       dtk_hshape dtk_create_shape(dtk_hshape shp,
                       unsigned int ind_num, const float *vertex_array,
                       int filled, const float *color);

DESCRIPTION

       dtk_create_shape()   creates   a   shape  specified  by  ind_num  vertices  referenced  by
       vertex_array. In this array, the position parameters  (x,y)  of  each  vertex  are  packed
       together  and  the  list should ordered, so that the array is filled in the following way:
       x0,y0,x1,y1,x2,y2,...,xN,yN.

       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. In the case of filled polygon
          request, the last point specified in vertex_array will be connected with the first one.

        * 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)