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)