debian man page for dtk_load_image

DTK_LOAD_IMAGE(3)						Draw Toolkit manual						 DTK_LOAD_IMAGE(3)

NAME
       dtk_load_image - Load an image file as a texture

SYNOPSIS
       #include <drawtk.h>

       dtk_htex dtk_load_image(const char *filename, unsigned int mxlvl);

DESCRIPTION
       This function load the image file specified by filename argument. It will creates the mipmaps until level mxlvl. Upon creation, the texture
       will then been tracked by an internal texture manager so that the next call using the same filename argument will return the  same  texture
       handle, thus sparing the resources of the system.

       There is no need for a valid window to create successfully a texture, i.e.  creation of textures are completely decoupled from the creation
       of others resources and can even be created in one thread to be used in another one.

       Mipmaps are version of the same image at lower resolution (every power of two). Mipmap at level 0 is the original image. Given the size	of
       the  texture  displayed	in  the  framebuffer,  the closest mipmaps are used to interpolate the value of displayed pixels. Do a research on
       internet for further details about mipmaps.

RETURN VALUE
       In case of success, the function returns the handle to the created texture.  In case of failure, NULL is returned.

THREAD SAFETY
       dtk_load_image() is thread-safe.

SEE ALSO

EPFL
								       2010							 DTK_LOAD_IMAGE(3)