1 /*

     2     SDL_image:  An example image loading library for use with SDL

     3     Copyright (C) 1997-2009 Sam Lantinga

     4 

     5     This library is free software; you can redistribute it and/or

     6     modify it under the terms of the GNU Lesser General Public

     7     License as published by the Free Software Foundation; either

     8     version 2.1 of the License, or (at your option) any later version.

     9 

    10     This library is distributed in the hope that it will be useful,

    11     but WITHOUT ANY WARRANTY; without even the implied warranty of

    12     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

    13     Lesser General Public License for more details.

    14 

    15     You should have received a copy of the GNU Lesser General Public

    16     License along with this library; if not, write to the Free Software

    17     Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

    18 

    19     Sam Lantinga

    20     slouken@libsdl.org

    21 */

    22 

    23 /* A simple library to load images of various formats as SDL surfaces */

    24 

    25 #ifndef _SDL_IMAGE_H

    26 #define _SDL_IMAGE_H

    27 

    28 #include "SDL.h"

    29 #include "SDL_version.h"

    30 #include "begin_code.h"

    31 

    32 /* Set up for C function definitions, even when using C++ */

    33 #ifdef __cplusplus

    34 extern "C" {

    35 #endif

    36 

    37 /* Printable format: "%d.%d.%d", MAJOR, MINOR, PATCHLEVEL

    38 */

    39 #define SDL_IMAGE_MAJOR_VERSION	1

    40 #define SDL_IMAGE_MINOR_VERSION	2

    41 #define SDL_IMAGE_PATCHLEVEL	10

    42 

    43 typedef enum

    44 {

    45     IMG_INIT_JPG = 0x00000001,

    46     IMG_INIT_PNG = 0x00000002,

    47     IMG_INIT_TIF = 0x00000004

    48 } IMG_InitFlags;

    49 

    50 /* Loads dynamic libraries and prepares them for use.  Flags should be

    51    one or more flags from IMG_InitFlags OR'd together.

    52    It returns the flags successfully initialized, or 0 on failure.

    53  */

    54 extern DECLSPEC int SDLCALL IMG_Init(int flags);

    55 

    56 /* Unloads libraries loaded with IMG_Init */

    57 extern DECLSPEC void SDLCALL IMG_Quit(void);

    58 

    59 /* Load an image from an SDL data source.

    60    The 'type' may be one of: "BMP", "GIF", "PNG", etc.

    61 

    62    If the image format supports a transparent pixel, SDL will set the

    63    colorkey for the surface.  You can enable RLE acceleration on the

    64    surface afterwards by calling:

    65 	SDL_SetColorKey(image, SDL_RLEACCEL, image->format->colorkey);

    66  */

    67 extern DECLSPEC SDL_Surface * SDLCALL IMG_LoadTyped_RW(SDL_RWops *src, int freesrc, char *type);

    68 /* Convenience functions */

    69 extern DECLSPEC SDL_Surface * SDLCALL IMG_Load(const char *file);

    70 extern DECLSPEC SDL_Surface * SDLCALL IMG_Load_RW(SDL_RWops *src, int freesrc);

    71 

    72 /* Functions to detect a file type, given a seekable source */

    73 extern DECLSPEC int SDLCALL IMG_isPNG(SDL_RWops *src);

    74 

    75 /* Individual loading functions */

    76 extern DECLSPEC SDL_Surface * SDLCALL IMG_LoadPNG_RW(SDL_RWops *src);

    77 

    78 /* We'll use SDL for reporting errors */

    79 #define IMG_SetError	SDL_SetError

    80 #define IMG_GetError	SDL_GetError

    81 

    82 /* Ends C function definitions when using C++ */

    83 #ifdef __cplusplus

    84 }

    85 #endif

    86 #include "close_code.h"

    87 

    88 #endif /* _SDL_IMAGE_H */