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