DTK_CREATE_IMAGE(3)						Draw Toolkit manual					       DTK_CREATE_IMAGE(3)

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)

EPFL
								       2011						       DTK_CREATE_IMAGE(3)