README.txt
author Sam Lantinga <slouken@libsdl.org>
Fri, 26 Oct 2018 14:58:01 -0700
changeset 617 d64228a395fc
parent 524 b4b49635cbd8
permissions -rw-r--r--
Fixed webp library detection when cross-compiling for Windows
     1 
     2 SDL_image 2.0
     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, TIFF, and simple SVG 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 zlib License, see the file "COPYING.txt" for details.