1
2SDL_image 2.0
3
4The latest version of this library is available from:
5http://www.libsdl.org/projects/SDL_image/
6
7This is a simple library to load images of various formats as SDL surfaces.
8This library supports BMP, PNM (PPM/PGM/PBM), XPM, LBM, PCX, GIF, JPEG, PNG,
9TGA, TIFF, and simple SVG formats.
10
11API:
12#include "SDL_image.h"
13
14	SDL_Surface *IMG_Load(const char *file);
15or
16	SDL_Surface *IMG_Load_RW(SDL_RWops *src, int freesrc);
17or
18	SDL_Surface *IMG_LoadTyped_RW(SDL_RWops *src, int freesrc, char *type);
19
20where type is a string specifying the format (i.e. "PNG" or "pcx").
21Note that IMG_Load_RW cannot load TGA images.
22
23To create a surface from an XPM image included in C source, use:
24
25	SDL_Surface *IMG_ReadXPMFromArray(char **xpm);
26
27An example program 'showimage' is included, with source in showimage.c
28
29JPEG support requires the JPEG library: http://www.ijg.org/
30PNG support requires the PNG library: http://www.libpng.org/pub/png/libpng.html
31    and the Zlib library: http://www.gzip.org/zlib/
32TIFF support requires the TIFF library: ftp://ftp.sgi.com/graphics/tiff/
33
34If you have these libraries installed in non-standard places, you can
35try adding those paths to the configure script, e.g.
36sh ./configure CPPFLAGS="-I/somewhere/include" LDFLAGS="-L/somewhere/lib"
37If this works, you may need to add /somewhere/lib to your LD_LIBRARY_PATH
38so shared library loading works correctly.
39
40This library is under the zlib License, see the file "COPYING.txt" for details.
41