trusty (3) dtk_create_image.3.gz

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)