Subversion Repositories Games.Descent

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
3 pmbaty 1
/*
2
  SDL_image:  An example image loading library for use with SDL
3
  Copyright (C) 1997-2012 Sam Lantinga <slouken@libsdl.org>
4
 
5
  This software is provided 'as-is', without any express or implied
6
  warranty.  In no event will the authors be held liable for any damages
7
  arising from the use of this software.
8
 
9
  Permission is granted to anyone to use this software for any purpose,
10
  including commercial applications, and to alter it and redistribute it
11
  freely, subject to the following restrictions:
12
 
13
  1. The origin of this software must not be misrepresented; you must not
14
     claim that you wrote the original software. If you use this software
15
     in a product, an acknowledgment in the product documentation would be
16
     appreciated but is not required.
17
  2. Altered source versions must be plainly marked as such, and must not be
18
     misrepresented as being the original software.
19
  3. This notice may not be removed or altered from any source distribution.
20
*/
21
 
22
/* A simple library to load images of various formats as SDL surfaces */
23
 
24
#ifndef _SDL_IMAGE_H
25
#define _SDL_IMAGE_H
26
 
27
#include "SDL.h"
28
#include "SDL_version.h"
29
#include "begin_code.h"
30
 
31
/* Set up for C function definitions, even when using C++ */
32
#ifdef __cplusplus
33
extern "C" {
34
#endif
35
 
36
/* Printable format: "%d.%d.%d", MAJOR, MINOR, PATCHLEVEL
37
*/
38
#define SDL_IMAGE_MAJOR_VERSION 1
39
#define SDL_IMAGE_MINOR_VERSION 2
40
#define SDL_IMAGE_PATCHLEVEL    12
41
 
42
/* This macro can be used to fill a version structure with the compile-time
43
 * version of the SDL_image library.
44
 */
45
#define SDL_IMAGE_VERSION(X)                                            \
46
{                                                                       \
47
        (X)->major = SDL_IMAGE_MAJOR_VERSION;                           \
48
        (X)->minor = SDL_IMAGE_MINOR_VERSION;                           \
49
        (X)->patch = SDL_IMAGE_PATCHLEVEL;                              \
50
}
51
 
52
/* This function gets the version of the dynamically linked SDL_image library.
53
   it should NOT be used to fill a version structure, instead you should
54
   use the SDL_IMAGE_VERSION() macro.
55
 */
56
extern DECLSPEC const SDL_version * SDLCALL IMG_Linked_Version(void);
57
 
58
typedef enum
59
{
60
    IMG_INIT_JPG = 0x00000001,
61
    IMG_INIT_PNG = 0x00000002,
62
    IMG_INIT_TIF = 0x00000004,
63
    IMG_INIT_WEBP = 0x00000008
64
} IMG_InitFlags;
65
 
66
/* Loads dynamic libraries and prepares them for use.  Flags should be
67
   one or more flags from IMG_InitFlags OR'd together.
68
   It returns the flags successfully initialized, or 0 on failure.
69
 */
70
extern DECLSPEC int SDLCALL IMG_Init(int flags);
71
 
72
/* Unloads libraries loaded with IMG_Init */
73
extern DECLSPEC void SDLCALL IMG_Quit(void);
74
 
75
/* Load an image from an SDL data source.
76
   The 'type' may be one of: "BMP", "GIF", "PNG", etc.
77
 
78
   If the image format supports a transparent pixel, SDL will set the
79
   colorkey for the surface.  You can enable RLE acceleration on the
80
   surface afterwards by calling:
81
        SDL_SetColorKey(image, SDL_RLEACCEL, image->format->colorkey);
82
 */
83
extern DECLSPEC SDL_Surface * SDLCALL IMG_LoadTyped_RW(SDL_RWops *src, int freesrc, char *type);
84
/* Convenience functions */
85
extern DECLSPEC SDL_Surface * SDLCALL IMG_Load(const char *file);
86
extern DECLSPEC SDL_Surface * SDLCALL IMG_Load_RW(SDL_RWops *src, int freesrc);
87
 
88
/* Invert the alpha of a surface for use with OpenGL
89
   This function is now a no-op, and only provided for backwards compatibility.
90
*/
91
extern DECLSPEC int SDLCALL IMG_InvertAlpha(int on);
92
 
93
/* Functions to detect a file type, given a seekable source */
94
extern DECLSPEC int SDLCALL IMG_isICO(SDL_RWops *src);
95
extern DECLSPEC int SDLCALL IMG_isCUR(SDL_RWops *src);
96
extern DECLSPEC int SDLCALL IMG_isBMP(SDL_RWops *src);
97
extern DECLSPEC int SDLCALL IMG_isGIF(SDL_RWops *src);
98
extern DECLSPEC int SDLCALL IMG_isJPG(SDL_RWops *src);
99
extern DECLSPEC int SDLCALL IMG_isLBM(SDL_RWops *src);
100
extern DECLSPEC int SDLCALL IMG_isPCX(SDL_RWops *src);
101
extern DECLSPEC int SDLCALL IMG_isPNG(SDL_RWops *src);
102
extern DECLSPEC int SDLCALL IMG_isPNM(SDL_RWops *src);
103
extern DECLSPEC int SDLCALL IMG_isTIF(SDL_RWops *src);
104
extern DECLSPEC int SDLCALL IMG_isXCF(SDL_RWops *src);
105
extern DECLSPEC int SDLCALL IMG_isXPM(SDL_RWops *src);
106
extern DECLSPEC int SDLCALL IMG_isXV(SDL_RWops *src);
107
extern DECLSPEC int SDLCALL IMG_isWEBP(SDL_RWops *src);
108
 
109
/* Individual loading functions */
110
extern DECLSPEC SDL_Surface * SDLCALL IMG_LoadICO_RW(SDL_RWops *src);
111
extern DECLSPEC SDL_Surface * SDLCALL IMG_LoadCUR_RW(SDL_RWops *src);
112
extern DECLSPEC SDL_Surface * SDLCALL IMG_LoadBMP_RW(SDL_RWops *src);
113
extern DECLSPEC SDL_Surface * SDLCALL IMG_LoadGIF_RW(SDL_RWops *src);
114
extern DECLSPEC SDL_Surface * SDLCALL IMG_LoadJPG_RW(SDL_RWops *src);
115
extern DECLSPEC SDL_Surface * SDLCALL IMG_LoadLBM_RW(SDL_RWops *src);
116
extern DECLSPEC SDL_Surface * SDLCALL IMG_LoadPCX_RW(SDL_RWops *src);
117
extern DECLSPEC SDL_Surface * SDLCALL IMG_LoadPNG_RW(SDL_RWops *src);
118
extern DECLSPEC SDL_Surface * SDLCALL IMG_LoadPNM_RW(SDL_RWops *src);
119
extern DECLSPEC SDL_Surface * SDLCALL IMG_LoadTGA_RW(SDL_RWops *src);
120
extern DECLSPEC SDL_Surface * SDLCALL IMG_LoadTIF_RW(SDL_RWops *src);
121
extern DECLSPEC SDL_Surface * SDLCALL IMG_LoadXCF_RW(SDL_RWops *src);
122
extern DECLSPEC SDL_Surface * SDLCALL IMG_LoadXPM_RW(SDL_RWops *src);
123
extern DECLSPEC SDL_Surface * SDLCALL IMG_LoadXV_RW(SDL_RWops *src);
124
extern DECLSPEC SDL_Surface * SDLCALL IMG_LoadWEBP_RW(SDL_RWops *src);
125
 
126
extern DECLSPEC SDL_Surface * SDLCALL IMG_ReadXPMFromArray(char **xpm);
127
 
128
/* We'll use SDL for reporting errors */
129
#define IMG_SetError    SDL_SetError
130
#define IMG_GetError    SDL_GetError
131
 
132
/* Ends C function definitions when using C++ */
133
#ifdef __cplusplus
134
}
135
#endif
136
#include "close_code.h"
137
 
138
#endif /* _SDL_IMAGE_H */