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¶