Skip to content
This repository has been archived by the owner on Feb 11, 2021. It is now read-only.

Latest commit

 

History

History
355 lines (297 loc) · 9.94 KB

SDL_sysvideo.h

File metadata and controls

355 lines (297 loc) · 9.94 KB
 
Apr 26, 2001
Apr 26, 2001
1
2
/*
SDL - Simple DirectMedia Layer
Jan 24, 2010
Jan 24, 2010
3
Copyright (C) 1997-2010 Sam Lantinga
Apr 26, 2001
Apr 26, 2001
4
5
This library is free software; you can redistribute it and/or
Feb 1, 2006
Feb 1, 2006
6
modify it under the terms of the GNU Lesser General Public
Apr 26, 2001
Apr 26, 2001
7
License as published by the Free Software Foundation; either
Feb 1, 2006
Feb 1, 2006
8
version 2.1 of the License, or (at your option) any later version.
Apr 26, 2001
Apr 26, 2001
9
10
11
12
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Feb 1, 2006
Feb 1, 2006
13
Lesser General Public License for more details.
Apr 26, 2001
Apr 26, 2001
14
Feb 1, 2006
Feb 1, 2006
15
16
17
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
Apr 26, 2001
Apr 26, 2001
18
19
Sam Lantinga
Dec 14, 2001
Dec 14, 2001
20
slouken@libsdl.org
Apr 26, 2001
Apr 26, 2001
21
*/
Feb 21, 2006
Feb 21, 2006
22
#include "SDL_config.h"
Apr 26, 2001
Apr 26, 2001
23
24
25
26
#ifndef _SDL_sysvideo_h
#define _SDL_sysvideo_h
Jun 30, 2010
Jun 30, 2010
27
#include "SDL_shape.h"
Apr 26, 2001
Apr 26, 2001
28
Jul 10, 2006
Jul 10, 2006
29
30
/* The SDL video driver */
Jun 30, 2010
Jun 30, 2010
31
32
typedef struct SDL_WindowShaper SDL_WindowShaper;
typedef struct SDL_ShapeDriver SDL_ShapeDriver;
Jul 10, 2006
Jul 10, 2006
33
34
35
typedef struct SDL_VideoDisplay SDL_VideoDisplay;
typedef struct SDL_VideoDevice SDL_VideoDevice;
Jun 30, 2010
Jun 30, 2010
36
37
38
39
40
41
/* Define the SDL window-shaper structure */
struct SDL_WindowShaper
{
/* The window associated with the shaper */
SDL_Window *window;
Aug 15, 2010
Aug 15, 2010
42
43
/* The user's specified coordinates for the window, for once we give it a shape. */
Uint32 userx,usery;
Jun 30, 2010
Jun 30, 2010
44
Jul 23, 2010
Jul 23, 2010
45
46
/* The parameters for shape calculation. */
SDL_WindowShapeMode mode;
Jun 30, 2010
Jun 30, 2010
47
48
49
50
51
52
53
54
55
56
57
/* Has this window been assigned a shape? */
SDL_bool hasshape;
void *driverdata;
};
/* Define the SDL shape driver structure */
struct SDL_ShapeDriver
{
SDL_WindowShaper *(*CreateShaper)(SDL_Window * window);
Aug 14, 2010
Aug 14, 2010
58
int (*SetWindowShape)(SDL_WindowShaper *shaper,SDL_Surface *shape,SDL_WindowShapeMode *shape_mode);
Jun 30, 2010
Jun 30, 2010
59
60
61
int (*ResizeWindowShape)(SDL_Window *window);
};
Feb 3, 2011
Feb 3, 2011
62
63
64
65
66
67
68
typedef struct SDL_WindowUserData
{
char *name;
void *data;
struct SDL_WindowUserData *next;
} SDL_WindowUserData;
Jul 10, 2006
Jul 10, 2006
69
/* Define the SDL window structure, corresponding to toplevel windows */
Sep 15, 2008
Sep 15, 2008
70
71
struct SDL_Window
{
Jan 24, 2010
Jan 24, 2010
72
const void *magic;
Sep 15, 2008
Sep 15, 2008
73
74
Uint32 id;
char *title;
Feb 11, 2011
Feb 11, 2011
75
76
77
78
79
80
81
82
83
84
85
86
87
88
/* The fullscreen values */
struct {
int x, y;
int w, h;
} fullscreen;
/* The windowed values */
struct {
int x, y;
int w, h;
} windowed;
/* The public values */
Sep 15, 2008
Sep 15, 2008
89
90
91
int x, y;
int w, h;
Uint32 flags;
Jul 10, 2006
Jul 10, 2006
92
Dec 1, 2009
Dec 1, 2009
93
SDL_DisplayMode fullscreen_mode;
Jun 30, 2010
Jun 30, 2010
94
Feb 3, 2011
Feb 3, 2011
95
SDL_Surface *surface;
Feb 4, 2011
Feb 4, 2011
96
SDL_bool surface_valid;
Feb 3, 2011
Feb 3, 2011
97
Jun 30, 2010
Jun 30, 2010
98
SDL_WindowShaper *shaper;
Dec 1, 2009
Dec 1, 2009
99
Feb 3, 2011
Feb 3, 2011
100
101
SDL_WindowUserData *data;
Sep 15, 2008
Sep 15, 2008
102
void *driverdata;
Jan 21, 2010
Jan 21, 2010
103
104
105
SDL_Window *prev;
SDL_Window *next;
Jul 10, 2006
Jul 10, 2006
106
107
108
109
110
111
};
#define FULLSCREEN_VISIBLE(W) \
(((W)->flags & SDL_WINDOW_FULLSCREEN) && \
((W)->flags & SDL_WINDOW_SHOWN) && \
!((W)->flags & SDL_WINDOW_MINIMIZED))
Sep 2, 2008
Sep 2, 2008
112
113
114
/*
* Define the SDL display structure This corresponds to physical monitors
* attached to the system.
Apr 26, 2001
Apr 26, 2001
115
*/
Sep 15, 2008
Sep 15, 2008
116
117
118
119
120
121
122
struct SDL_VideoDisplay
{
int max_display_modes;
int num_display_modes;
SDL_DisplayMode *display_modes;
SDL_DisplayMode desktop_mode;
SDL_DisplayMode current_mode;
Apr 26, 2001
Apr 26, 2001
123
Dec 3, 2009
Dec 3, 2009
124
SDL_Window *fullscreen_window;
Apr 26, 2001
Apr 26, 2001
125
Sep 15, 2008
Sep 15, 2008
126
SDL_VideoDevice *device;
Apr 26, 2001
Apr 26, 2001
127
Sep 15, 2008
Sep 15, 2008
128
void *driverdata;
Jul 10, 2006
Jul 10, 2006
129
};
Apr 26, 2001
Apr 26, 2001
130
Jul 10, 2006
Jul 10, 2006
131
132
/* Define the SDL video driver structure */
#define _THIS SDL_VideoDevice *_this
Apr 26, 2001
Apr 26, 2001
133
Sep 15, 2008
Sep 15, 2008
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
struct SDL_VideoDevice
{
/* * * */
/* The name of this video driver */
const char *name;
/* * * */
/* Initialization/Query functions */
/*
* Initialize the native video subsystem, filling in the list of
* displays for this driver, returning 0 or -1 if there's an error.
*/
int (*VideoInit) (_THIS);
/*
* Reverse the effects VideoInit() -- called if VideoInit() fails or
* if the application is shutting down the video subsystem.
*/
void (*VideoQuit) (_THIS);
/* * * */
/*
* Display functions
*/
Dec 6, 2009
Dec 6, 2009
160
161
162
163
164
/*
* Get the bounds of a display
*/
int (*GetDisplayBounds) (_THIS, SDL_VideoDisplay * display, SDL_Rect * rect);
Sep 15, 2008
Sep 15, 2008
165
/*
Feb 10, 2011
Feb 10, 2011
166
* Get a list of the available display modes for a display.
Sep 15, 2008
Sep 15, 2008
167
*/
Dec 1, 2009
Dec 1, 2009
168
void (*GetDisplayModes) (_THIS, SDL_VideoDisplay * display);
Sep 15, 2008
Sep 15, 2008
169
170
171
172
173
174
175
/*
* Setting the display mode is independent of creating windows, so
* when the display mode is changed, all existing windows should have
* their data updated accordingly, including the display surfaces
* associated with them.
*/
Dec 1, 2009
Dec 1, 2009
176
int (*SetDisplayMode) (_THIS, SDL_VideoDisplay * display, SDL_DisplayMode * mode);
Sep 15, 2008
Sep 15, 2008
177
178
179
180
181
182
183
184
/* * * */
/*
* Window functions
*/
int (*CreateWindow) (_THIS, SDL_Window * window);
int (*CreateWindowFrom) (_THIS, SDL_Window * window, const void *data);
void (*SetWindowTitle) (_THIS, SDL_Window * window);
Jan 2, 2009
Jan 2, 2009
185
void (*SetWindowIcon) (_THIS, SDL_Window * window, SDL_Surface * icon);
Sep 15, 2008
Sep 15, 2008
186
187
188
189
190
191
192
193
void (*SetWindowPosition) (_THIS, SDL_Window * window);
void (*SetWindowSize) (_THIS, SDL_Window * window);
void (*ShowWindow) (_THIS, SDL_Window * window);
void (*HideWindow) (_THIS, SDL_Window * window);
void (*RaiseWindow) (_THIS, SDL_Window * window);
void (*MaximizeWindow) (_THIS, SDL_Window * window);
void (*MinimizeWindow) (_THIS, SDL_Window * window);
void (*RestoreWindow) (_THIS, SDL_Window * window);
Feb 11, 2011
Feb 11, 2011
194
195
void (*PrepWindowFullscreen) (_THIS, SDL_Window * window);
void (*SetWindowFullscreen) (_THIS, SDL_Window * window);
Sep 15, 2008
Sep 15, 2008
196
197
void (*SetWindowGrab) (_THIS, SDL_Window * window);
void (*DestroyWindow) (_THIS, SDL_Window * window);
Feb 3, 2011
Feb 3, 2011
198
199
200
201
int (*CreateWindowFramebuffer) (_THIS, SDL_Window * window, Uint32 * format, void ** pixels, int *pitch);
int (*UpdateWindowFramebuffer) (_THIS, SDL_Window * window, int numrects, SDL_Rect * rects);
void (*DestroyWindowFramebuffer) (_THIS, SDL_Window * window);
Jun 30, 2010
Jun 30, 2010
202
203
204
205
206
/* * * */
/*
* Shaped-window functions
*/
SDL_ShapeDriver shape_driver;
Sep 15, 2008
Sep 15, 2008
207
208
209
210
211
212
213
214
215
216
217
/* Get some platform dependent window information */
SDL_bool(*GetWindowWMInfo) (_THIS, SDL_Window * window,
struct SDL_SysWMinfo * info);
/* * * */
/*
* OpenGL support
*/
int (*GL_LoadLibrary) (_THIS, const char *path);
void *(*GL_GetProcAddress) (_THIS, const char *proc);
Feb 9, 2009
Feb 9, 2009
218
void (*GL_UnloadLibrary) (_THIS);
Sep 15, 2008
Sep 15, 2008
219
220
221
222
223
224
225
226
227
228
229
230
231
SDL_GLContext(*GL_CreateContext) (_THIS, SDL_Window * window);
int (*GL_MakeCurrent) (_THIS, SDL_Window * window, SDL_GLContext context);
int (*GL_SetSwapInterval) (_THIS, int interval);
int (*GL_GetSwapInterval) (_THIS);
void (*GL_SwapWindow) (_THIS, SDL_Window * window);
void (*GL_DeleteContext) (_THIS, SDL_GLContext context);
/* * * */
/*
* Event manager functions
*/
void (*PumpEvents) (_THIS);
Jan 12, 2009
Jan 12, 2009
232
233
234
/* Suspend the screensaver */
void (*SuspendScreenSaver) (_THIS);
Sep 19, 2009
Sep 19, 2009
235
236
237
238
239
/* Text input */
void (*StartTextInput) (_THIS);
void (*StopTextInput) (_THIS);
void (*SetTextInputRect) (_THIS, SDL_Rect *rect);
Jul 8, 2010
Jul 8, 2010
240
241
242
243
244
/* Clipboard */
int (*SetClipboardText) (_THIS, const char *text);
char * (*GetClipboardText) (_THIS);
SDL_bool (*HasClipboardText) (_THIS);
Sep 15, 2008
Sep 15, 2008
245
246
/* * * */
/* Data common to all drivers */
Jan 12, 2009
Jan 12, 2009
247
SDL_bool suspend_screensaver;
Sep 15, 2008
Sep 15, 2008
248
249
int num_displays;
SDL_VideoDisplay *displays;
Feb 10, 2011
Feb 10, 2011
250
SDL_Window *windows;
Jan 24, 2010
Jan 24, 2010
251
Uint8 window_magic;
Sep 15, 2008
Sep 15, 2008
252
Uint32 next_object_id;
Jul 8, 2010
Jul 8, 2010
253
char * clipboard_text;
Sep 15, 2008
Sep 15, 2008
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
/* * * */
/* Data used by the GL drivers */
struct
{
int red_size;
int green_size;
int blue_size;
int alpha_size;
int depth_size;
int buffer_size;
int stencil_size;
int double_buffer;
int accum_red_size;
int accum_green_size;
int accum_blue_size;
int accum_alpha_size;
int stereo;
int multisamplebuffers;
int multisamplesamples;
int accelerated;
Mar 24, 2009
Mar 24, 2009
275
276
int major_version;
int minor_version;
Sep 15, 2008
Sep 15, 2008
277
278
279
280
281
282
283
284
285
286
287
int retained_backing;
int driver_loaded;
char driver_path[256];
void *dll_handle;
} gl_config;
/* * * */
/* Data private to this driver */
void *driverdata;
struct SDL_GLDriverData *gl_data;
May 31, 2009
May 31, 2009
288
289
290
291
#if SDL_VIDEO_DRIVER_PANDORA
struct SDL_PrivateGLESData *gles_data;
#endif
Sep 15, 2008
Sep 15, 2008
292
293
294
/* * * */
/* The function used to dispose of this structure */
void (*free) (_THIS);
Apr 26, 2001
Apr 26, 2001
295
296
};
Sep 15, 2008
Sep 15, 2008
297
298
299
300
301
302
303
typedef struct VideoBootStrap
{
const char *name;
const char *desc;
int (*available) (void);
SDL_VideoDevice *(*create) (int devindex);
} VideoBootStrap;
Apr 26, 2001
Apr 26, 2001
304
Jul 23, 2006
Jul 23, 2006
305
306
#if SDL_VIDEO_DRIVER_COCOA
extern VideoBootStrap COCOA_bootstrap;
Feb 16, 2006
Feb 16, 2006
307
308
#endif
#if SDL_VIDEO_DRIVER_X11
Apr 26, 2001
Apr 26, 2001
309
310
extern VideoBootStrap X11_bootstrap;
#endif
Feb 16, 2006
Feb 16, 2006
311
#if SDL_VIDEO_DRIVER_DIRECTFB
Sep 4, 2001
Sep 4, 2001
312
313
extern VideoBootStrap DirectFB_bootstrap;
#endif
Jan 21, 2011
Jan 21, 2011
314
315
#if SDL_VIDEO_DRIVER_WINDOWS
extern VideoBootStrap WINDOWS_bootstrap;
Apr 26, 2001
Apr 26, 2001
316
#endif
Feb 16, 2006
Feb 16, 2006
317
#if SDL_VIDEO_DRIVER_BWINDOW
Apr 26, 2001
Apr 26, 2001
318
319
extern VideoBootStrap BWINDOW_bootstrap;
#endif
Feb 2, 2011
Feb 2, 2011
320
321
#if SDL_VIDEO_DRIVER_PANDORA
extern VideoBootStrap PND_bootstrap;
Feb 16, 2006
Feb 16, 2006
322
#endif
Aug 27, 2008
Aug 27, 2008
323
324
#if SDL_VIDEO_DRIVER_NDS
extern VideoBootStrap NDS_bootstrap;
May 31, 2009
May 31, 2009
325
#endif
Feb 2, 2011
Feb 2, 2011
326
327
#if SDL_VIDEO_DRIVER_UIKIT
extern VideoBootStrap UIKIT_bootstrap;
Aug 27, 2008
Aug 27, 2008
328
#endif
Jun 10, 2010
Jun 10, 2010
329
330
331
#if SDL_VIDEO_DRIVER_ANDROID
extern VideoBootStrap Android_bootstrap;
#endif
Feb 2, 2011
Feb 2, 2011
332
333
334
#if SDL_VIDEO_DRIVER_DUMMY
extern VideoBootStrap DUMMY_bootstrap;
#endif
Jul 10, 2006
Jul 10, 2006
335
Jun 26, 2010
Jun 26, 2010
336
extern SDL_VideoDevice *SDL_GetVideoDevice(void);
Sep 15, 2008
Sep 15, 2008
337
338
extern int SDL_AddBasicVideoDisplay(const SDL_DisplayMode * desktop_mode);
extern int SDL_AddVideoDisplay(const SDL_VideoDisplay * display);
Dec 1, 2009
Dec 1, 2009
339
extern SDL_bool SDL_AddDisplayMode(SDL_VideoDisplay *display, const SDL_DisplayMode * mode);
Feb 10, 2011
Feb 10, 2011
340
extern SDL_VideoDisplay *SDL_GetDisplayForWindow(SDL_Window *window);
Sep 15, 2008
Sep 15, 2008
341
342
extern int SDL_RecreateWindow(SDL_Window * window, Uint32 flags);
Jul 10, 2006
Jul 10, 2006
343
Sep 15, 2008
Sep 15, 2008
344
345
extern void SDL_OnWindowShown(SDL_Window * window);
extern void SDL_OnWindowHidden(SDL_Window * window);
Feb 3, 2011
Feb 3, 2011
346
extern void SDL_OnWindowResized(SDL_Window * window);
Dec 1, 2009
Dec 1, 2009
347
348
extern void SDL_OnWindowMinimized(SDL_Window * window);
extern void SDL_OnWindowRestored(SDL_Window * window);
Sep 15, 2008
Sep 15, 2008
349
350
extern void SDL_OnWindowFocusGained(SDL_Window * window);
extern void SDL_OnWindowFocusLost(SDL_Window * window);
Jan 21, 2010
Jan 21, 2010
351
extern SDL_Window * SDL_GetFocusWindow(void);
Apr 26, 2001
Apr 26, 2001
352
Sep 15, 2008
Sep 15, 2008
353
#endif /* _SDL_sysvideo_h */
Jul 10, 2006
Jul 10, 2006
354
355
/* vi: set ts=4 sw=4 expandtab: */