src/SDL2/README.txt

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