NAME

       dtk_create_image - Create and modify a shape displaying an image

SYNOPSIS

       #include <drawtk.h>

       dtk_hshape dtk_create_image(dtk_hshape shp,
                       float x, float y, float width, float height,
                       const float* color, dtk_htex image);

DESCRIPTION

       dtk_create_image()  creates  a  rectangle  of  size  (height,width)  centered  at  (cx,cy)
       containing the image loaded in texture image. The image will by stretched to fit the  size
       of the rectangle disregarding the dimension of the image. The color argument modulates the
       pixel values of the image, i.e. to display the image the same way it exist  in  the  image
       file, color should be white.

       shp 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.

        * 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), dtk_load_image(3)