src/video/SDL_sysvideo.h
author Sam Lantinga <slouken@libsdl.org>
Wed, 26 Jul 2006 03:24:27 +0000
changeset 1944 91f41fc124a7
parent 1942 4371d679ee12
child 1945 3182150b470f
permissions -rw-r--r--
The AAlib driver is fun, but not worth rewriting for SDL 1.3
slouken@0
     1
/*
slouken@0
     2
    SDL - Simple DirectMedia Layer
slouken@1312
     3
    Copyright (C) 1997-2006 Sam Lantinga
slouken@0
     4
slouken@0
     5
    This library is free software; you can redistribute it and/or
slouken@1312
     6
    modify it under the terms of the GNU Lesser General Public
slouken@0
     7
    License as published by the Free Software Foundation; either
slouken@1312
     8
    version 2.1 of the License, or (at your option) any later version.
slouken@0
     9
slouken@0
    10
    This library is distributed in the hope that it will be useful,
slouken@0
    11
    but WITHOUT ANY WARRANTY; without even the implied warranty of
slouken@0
    12
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
slouken@1312
    13
    Lesser General Public License for more details.
slouken@0
    14
slouken@1312
    15
    You should have received a copy of the GNU Lesser General Public
slouken@1312
    16
    License along with this library; if not, write to the Free Software
slouken@1312
    17
    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
slouken@0
    18
slouken@0
    19
    Sam Lantinga
slouken@252
    20
    slouken@libsdl.org
slouken@0
    21
*/
slouken@1402
    22
#include "SDL_config.h"
slouken@0
    23
slouken@0
    24
#ifndef _SDL_sysvideo_h
slouken@0
    25
#define _SDL_sysvideo_h
slouken@0
    26
slouken@0
    27
#include "SDL_mouse.h"
slouken@0
    28
slouken@0
    29
/* The SDL video driver */
slouken@1895
    30
slouken@1895
    31
typedef struct SDL_Window SDL_Window;
slouken@1895
    32
typedef struct SDL_Texture SDL_Texture;
slouken@1895
    33
typedef struct SDL_Renderer SDL_Renderer;
slouken@1895
    34
typedef struct SDL_RenderDriver SDL_RenderDriver;
slouken@1895
    35
typedef struct SDL_VideoDisplay SDL_VideoDisplay;
slouken@0
    36
typedef struct SDL_VideoDevice SDL_VideoDevice;
slouken@0
    37
slouken@1895
    38
/* Define the SDL texture structure */
slouken@1895
    39
struct SDL_Texture
slouken@1895
    40
{
slouken@1895
    41
    Uint32 id;
slouken@1895
    42
slouken@1895
    43
    Uint32 format;      /**< The pixel format of the texture */
slouken@1895
    44
    int access;         /**< SDL_TextureAccess */
slouken@1895
    45
    int w;              /**< The width of the texture */
slouken@1895
    46
    int h;              /**< The height of the texture */
slouken@1895
    47
slouken@1895
    48
    SDL_Renderer *renderer;
slouken@1895
    49
slouken@1895
    50
    void *driverdata;   /**< Driver specific texture representation */
slouken@1895
    51
slouken@1895
    52
    SDL_Texture *next;
slouken@1895
    53
};
slouken@1895
    54
slouken@1895
    55
/* Define the SDL renderer structure */
slouken@1895
    56
struct SDL_Renderer
slouken@1895
    57
{
slouken@1923
    58
    int (*ActivateRenderer) (SDL_Renderer * renderer);
slouken@1895
    59
    int (*CreateTexture) (SDL_Renderer * renderer, SDL_Texture * texture);
slouken@1895
    60
    int (*QueryTexturePixels) (SDL_Renderer * renderer, SDL_Texture * texture,
slouken@1895
    61
                               void **pixels, int *pitch);
slouken@1895
    62
    int (*SetTexturePalette) (SDL_Renderer * renderer, SDL_Texture * texture,
slouken@1895
    63
                              const SDL_Color * colors, int firstcolor,
slouken@1895
    64
                              int ncolors);
slouken@1895
    65
    int (*GetTexturePalette) (SDL_Renderer * renderer, SDL_Texture * texture,
slouken@1895
    66
                              SDL_Color * colors, int firstcolor,
slouken@1895
    67
                              int ncolors);
slouken@1895
    68
    int (*UpdateTexture) (SDL_Renderer * renderer, SDL_Texture * texture,
slouken@1895
    69
                          const SDL_Rect * rect, const void *pixels,
slouken@1895
    70
                          int pitch);
slouken@1895
    71
    int (*LockTexture) (SDL_Renderer * renderer, SDL_Texture * texture,
slouken@1895
    72
                        const SDL_Rect * rect, int markDirty, void **pixels,
slouken@1895
    73
                        int *pitch);
slouken@1895
    74
    void (*UnlockTexture) (SDL_Renderer * renderer, SDL_Texture * texture);
slouken@1895
    75
    void (*DirtyTexture) (SDL_Renderer * renderer, SDL_Texture * texture,
slouken@1895
    76
                          int numrects, const SDL_Rect * rects);
slouken@1895
    77
    int (*RenderFill) (SDL_Renderer * renderer, const SDL_Rect * rect,
slouken@1895
    78
                       Uint32 color);
slouken@1895
    79
    int (*RenderCopy) (SDL_Renderer * renderer, SDL_Texture * texture,
slouken@1895
    80
                       const SDL_Rect * srcrect, const SDL_Rect * dstrect,
slouken@1895
    81
                       int blendMode, int scaleMode);
slouken@1895
    82
    void (*RenderPresent) (SDL_Renderer * renderer);
slouken@1895
    83
    void (*DestroyTexture) (SDL_Renderer * renderer, SDL_Texture * texture);
slouken@1895
    84
slouken@1895
    85
    void (*DestroyRenderer) (SDL_Renderer * renderer);
slouken@1895
    86
slouken@1895
    87
    /* The current renderer info */
slouken@1895
    88
    SDL_RendererInfo info;
slouken@1895
    89
slouken@1895
    90
    /* The window associated with the renderer */
slouken@1895
    91
    SDL_WindowID window;
slouken@1895
    92
slouken@1895
    93
    void *driverdata;
slouken@1895
    94
};
slouken@1895
    95
slouken@1895
    96
/* Define the SDL render driver structure */
slouken@1895
    97
struct SDL_RenderDriver
slouken@1895
    98
{
slouken@1895
    99
    SDL_Renderer *(*CreateRenderer) (SDL_Window * window, Uint32 flags);
slouken@1895
   100
slouken@1895
   101
    /* Info about the renderer capabilities */
slouken@1895
   102
    SDL_RendererInfo info;
slouken@1895
   103
};
slouken@1895
   104
slouken@1895
   105
/* Define the SDL window structure, corresponding to toplevel windows */
slouken@1895
   106
struct SDL_Window
slouken@1895
   107
{
slouken@1895
   108
    Uint32 id;
slouken@1895
   109
slouken@1895
   110
    char *title;
slouken@1895
   111
    int x, y;
slouken@1895
   112
    int w, h;
slouken@1895
   113
    Uint32 flags;
slouken@1895
   114
slouken@1895
   115
    int display;
slouken@1895
   116
    SDL_Renderer *renderer;
slouken@1895
   117
slouken@1895
   118
    void *userdata;
slouken@1895
   119
    void *driverdata;
slouken@1895
   120
};
slouken@1895
   121
#define FULLSCREEN_VISIBLE(W) \
slouken@1895
   122
    (((W)->flags & SDL_WINDOW_FULLSCREEN) && \
slouken@1895
   123
     ((W)->flags & SDL_WINDOW_SHOWN) && \
slouken@1895
   124
     !((W)->flags & SDL_WINDOW_MINIMIZED))
slouken@1895
   125
slouken@1895
   126
/* Define the SDL display structure
slouken@1895
   127
   This corresponds to physical monitors attached to the system.
slouken@1895
   128
 */
slouken@1895
   129
struct SDL_VideoDisplay
slouken@1895
   130
{
slouken@1895
   131
    int max_display_modes;
slouken@1895
   132
    int num_display_modes;
slouken@1895
   133
    SDL_DisplayMode *display_modes;
slouken@1895
   134
    SDL_DisplayMode desktop_mode;
slouken@1895
   135
    SDL_DisplayMode current_mode;
slouken@1895
   136
    SDL_DisplayMode desired_mode;
slouken@1895
   137
    SDL_DisplayMode *fullscreen_mode;
slouken@1895
   138
    SDL_Palette *palette;
slouken@1895
   139
slouken@1895
   140
    Uint16 *gamma;
slouken@1895
   141
    Uint16 *saved_gamma;        /* (just offset into gamma) */
slouken@1895
   142
slouken@1895
   143
    int num_render_drivers;
slouken@1895
   144
    SDL_RenderDriver *render_drivers;
slouken@1895
   145
slouken@1895
   146
    int num_windows;
slouken@1895
   147
    SDL_Window *windows;
slouken@1895
   148
slouken@1895
   149
    SDL_Renderer *current_renderer;
slouken@1895
   150
slouken@1895
   151
    /* The hash list of textures */
slouken@1895
   152
    SDL_Texture *textures[64];
slouken@1895
   153
slouken@1895
   154
    SDL_VideoDevice *device;
slouken@1895
   155
slouken@1895
   156
    void *driverdata;
slouken@1895
   157
};
slouken@1895
   158
slouken@0
   159
/* Define the SDL video driver structure */
slouken@0
   160
#define _THIS	SDL_VideoDevice *_this
slouken@0
   161
slouken@1895
   162
struct SDL_VideoDevice
slouken@1895
   163
{
slouken@1895
   164
    /* * * */
slouken@1895
   165
    /* The name of this video driver */
slouken@1895
   166
    const char *name;
slouken@0
   167
slouken@1895
   168
    /* * * */
slouken@1895
   169
    /* Initialization/Query functions */
slouken@0
   170
slouken@1895
   171
    /* Initialize the native video subsystem, filling in the list
slouken@1895
   172
       of displays for this driver, returning 0 or -1 if there's an error.
slouken@1895
   173
     */
slouken@1895
   174
    int (*VideoInit) (_THIS);
slouken@0
   175
slouken@1913
   176
    /* Reverse the effects VideoInit() -- called if VideoInit() fails
slouken@1913
   177
       or if the application is shutting down the video subsystem.
slouken@1913
   178
     */
slouken@1913
   179
    void (*VideoQuit) (_THIS);
slouken@1913
   180
slouken@1895
   181
    /* * * */
slouken@1895
   182
    /* Display functions
slouken@1895
   183
     */
slouken@0
   184
slouken@1895
   185
    /* Get a list of the available display modes.
slouken@1895
   186
     * e.g.  SDL_AddDisplayMode(_this->current_display, mode)
slouken@1895
   187
     */
slouken@1895
   188
    void (*GetDisplayModes) (_THIS);
slouken@0
   189
slouken@1895
   190
    /* Setting the display mode is independent of creating windows,
slouken@1895
   191
     * so when the display mode is changed, all existing windows
slouken@1895
   192
     * should have their data updated accordingly, including the
slouken@1895
   193
     * display surfaces associated with them.
slouken@1895
   194
     */
slouken@1895
   195
    int (*SetDisplayMode) (_THIS, SDL_DisplayMode * mode);
slouken@0
   196
slouken@1895
   197
    /* Set the color entries of the display palette */
slouken@1895
   198
    int (*SetDisplayPalette) (_THIS, SDL_Palette * palette);
slouken@0
   199
slouken@1895
   200
    /* Get the color entries of the display palette */
slouken@1895
   201
    int (*GetDisplayPalette) (_THIS, SDL_Palette * palette);
slouken@0
   202
slouken@1895
   203
    /* Set the gamma ramp */
slouken@1895
   204
    int (*SetDisplayGammaRamp) (_THIS, Uint16 * ramp);
slouken@0
   205
slouken@1895
   206
    /* Get the gamma ramp */
slouken@1895
   207
    int (*GetDisplayGammaRamp) (_THIS, Uint16 * ramp);
slouken@0
   208
slouken@1895
   209
    /* * * */
slouken@1895
   210
    /* Window functions
slouken@1895
   211
     */
slouken@1895
   212
    int (*CreateWindow) (_THIS, SDL_Window * window);
slouken@1895
   213
    int (*CreateWindowFrom) (_THIS, SDL_Window * window, const void *data);
slouken@1895
   214
    void (*SetWindowTitle) (_THIS, SDL_Window * window);
slouken@1895
   215
    void (*SetWindowPosition) (_THIS, SDL_Window * window);
slouken@1895
   216
    void (*SetWindowSize) (_THIS, SDL_Window * window);
slouken@1895
   217
    void (*ShowWindow) (_THIS, SDL_Window * window);
slouken@1895
   218
    void (*HideWindow) (_THIS, SDL_Window * window);
slouken@1895
   219
    void (*RaiseWindow) (_THIS, SDL_Window * window);
slouken@1895
   220
    void (*MaximizeWindow) (_THIS, SDL_Window * window);
slouken@1895
   221
    void (*MinimizeWindow) (_THIS, SDL_Window * window);
slouken@1895
   222
    void (*RestoreWindow) (_THIS, SDL_Window * window);
slouken@1895
   223
    void (*SetWindowGrab) (_THIS, SDL_Window * window);
slouken@1895
   224
    void (*DestroyWindow) (_THIS, SDL_Window * window);
slouken@0
   225
slouken@1895
   226
    /* Get some platform dependent window information */
slouken@1895
   227
      SDL_bool(*GetWindowWMInfo) (_THIS, SDL_Window * window,
slouken@1895
   228
                                  struct SDL_SysWMinfo * info);
slouken@0
   229
slouken@1895
   230
    /* * * */
slouken@1912
   231
    /* OpenGL support
slouken@1912
   232
     */
slouken@1895
   233
    int (*GL_LoadLibrary) (_THIS, const char *path);
slouken@1895
   234
    void *(*GL_GetProcAddress) (_THIS, const char *proc);
slouken@1912
   235
      SDL_GLContext(*GL_CreateContext) (_THIS, SDL_Window * window);
slouken@1912
   236
    int (*GL_MakeCurrent) (_THIS, SDL_Window * window, SDL_GLContext context);
slouken@1912
   237
    int (*GL_SetSwapInterval) (_THIS, int interval);
slouken@1912
   238
    int (*GL_GetSwapInterval) (_THIS);
slouken@1912
   239
    void (*GL_SwapWindow) (_THIS, SDL_Window * window);
slouken@1912
   240
    void (*GL_DeleteContext) (_THIS, SDL_GLContext context);
slouken@0
   241
slouken@1895
   242
    /* * * */
slouken@1912
   243
    /* Event manager functions
slouken@1912
   244
     */
slouken@1895
   245
    void (*PumpEvents) (_THIS);
slouken@0
   246
slouken@1895
   247
    /* * * */
slouken@1895
   248
    /* Data common to all drivers */
slouken@1895
   249
    int num_displays;
slouken@1895
   250
    SDL_VideoDisplay *displays;
slouken@1895
   251
    int current_display;
slouken@1895
   252
    Uint32 next_object_id;
slouken@0
   253
slouken@1895
   254
    /* * * */
slouken@1895
   255
    /* Data used by the GL drivers */
slouken@1895
   256
    struct
slouken@1895
   257
    {
slouken@1895
   258
        int red_size;
slouken@1895
   259
        int green_size;
slouken@1895
   260
        int blue_size;
slouken@1895
   261
        int alpha_size;
slouken@1895
   262
        int depth_size;
slouken@1895
   263
        int buffer_size;
slouken@1895
   264
        int stencil_size;
slouken@1895
   265
        int double_buffer;
slouken@1895
   266
        int accum_red_size;
slouken@1895
   267
        int accum_green_size;
slouken@1895
   268
        int accum_blue_size;
slouken@1895
   269
        int accum_alpha_size;
slouken@1895
   270
        int stereo;
slouken@1895
   271
        int multisamplebuffers;
slouken@1895
   272
        int multisamplesamples;
slouken@1895
   273
        int accelerated;
slouken@1895
   274
        int driver_loaded;
slouken@1895
   275
        char driver_path[256];
slouken@1895
   276
        void *dll_handle;
slouken@1895
   277
    } gl_config;
slouken@0
   278
slouken@1895
   279
    /* * * */
slouken@1895
   280
    /* Data private to this driver */
slouken@1895
   281
    void *driverdata;
slouken@1913
   282
    struct SDL_GLDriverData *gl_data;
slouken@0
   283
slouken@1895
   284
    /* * * */
slouken@1895
   285
    /* The function used to dispose of this structure */
slouken@1895
   286
    void (*free) (_THIS);
slouken@1895
   287
};
slouken@0
   288
slouken@1895
   289
typedef struct VideoBootStrap
slouken@1895
   290
{
slouken@1895
   291
    const char *name;
slouken@1895
   292
    const char *desc;
slouken@1895
   293
    int (*available) (void);
slouken@1895
   294
    SDL_VideoDevice *(*create) (int devindex);
slouken@0
   295
} VideoBootStrap;
slouken@0
   296
slouken@1931
   297
#if SDL_VIDEO_DRIVER_COCOA
slouken@1931
   298
extern VideoBootStrap COCOA_bootstrap;
slouken@1361
   299
#endif
slouken@1361
   300
#if SDL_VIDEO_DRIVER_X11
slouken@0
   301
extern VideoBootStrap X11_bootstrap;
slouken@0
   302
#endif
slouken@1361
   303
#if SDL_VIDEO_DRIVER_NANOX
slouken@30
   304
extern VideoBootStrap NX_bootstrap;
slouken@30
   305
#endif
slouken@1361
   306
#if SDL_VIDEO_DRIVER_IPOD
icculus@1140
   307
extern VideoBootStrap iPod_bootstrap;
icculus@1140
   308
#endif
slouken@1361
   309
#if SDL_VIDEO_DRIVER_QTOPIA
slouken@1361
   310
extern VideoBootStrap Qtopia_bootstrap;
slouken@1361
   311
#endif
slouken@1361
   312
#if SDL_VIDEO_DRIVER_WSCONS
slouken@1361
   313
extern VideoBootStrap WSCONS_bootstrap;
slouken@1361
   314
#endif
slouken@1361
   315
#if SDL_VIDEO_DRIVER_FBCON
slouken@0
   316
extern VideoBootStrap FBCON_bootstrap;
slouken@0
   317
#endif
slouken@1361
   318
#if SDL_VIDEO_DRIVER_DIRECTFB
slouken@167
   319
extern VideoBootStrap DirectFB_bootstrap;
slouken@167
   320
#endif
slouken@1361
   321
#if SDL_VIDEO_DRIVER_PS2GS
slouken@0
   322
extern VideoBootStrap PS2GS_bootstrap;
slouken@0
   323
#endif
slouken@1361
   324
#if SDL_VIDEO_DRIVER_GGI
slouken@0
   325
extern VideoBootStrap GGI_bootstrap;
slouken@0
   326
#endif
slouken@1361
   327
#if SDL_VIDEO_DRIVER_VGL
slouken@75
   328
extern VideoBootStrap VGL_bootstrap;
slouken@75
   329
#endif
slouken@1361
   330
#if SDL_VIDEO_DRIVER_SVGALIB
slouken@0
   331
extern VideoBootStrap SVGALIB_bootstrap;
slouken@0
   332
#endif
slouken@1361
   333
#if SDL_VIDEO_DRIVER_GAPI
slouken@1361
   334
extern VideoBootStrap GAPI_bootstrap;
slouken@1361
   335
#endif
slouken@1895
   336
#if SDL_VIDEO_DRIVER_WIN32
slouken@1895
   337
extern VideoBootStrap WIN32_bootstrap;
slouken@1361
   338
#endif
slouken@1361
   339
#if SDL_VIDEO_DRIVER_BWINDOW
slouken@1361
   340
extern VideoBootStrap BWINDOW_bootstrap;
slouken@1361
   341
#endif
slouken@1361
   342
#if SDL_VIDEO_DRIVER_TOOLBOX
slouken@1361
   343
extern VideoBootStrap TOOLBOX_bootstrap;
slouken@1361
   344
#endif
slouken@1361
   345
#if SDL_VIDEO_DRIVER_DRAWSPROCKET
slouken@1361
   346
extern VideoBootStrap DSp_bootstrap;
slouken@1361
   347
#endif
slouken@1361
   348
#if SDL_VIDEO_DRIVER_CYBERGRAPHICS
slouken@1361
   349
extern VideoBootStrap CGX_bootstrap;
slouken@1361
   350
#endif
slouken@1361
   351
#if SDL_VIDEO_DRIVER_PHOTON
slouken@1361
   352
extern VideoBootStrap ph_bootstrap;
slouken@1361
   353
#endif
slouken@1361
   354
#if SDL_VIDEO_DRIVER_EPOC
slouken@1361
   355
extern VideoBootStrap EPOC_bootstrap;
slouken@1361
   356
#endif
slouken@1361
   357
#if SDL_VIDEO_DRIVER_XBIOS
slouken@1361
   358
extern VideoBootStrap XBIOS_bootstrap;
slouken@1361
   359
#endif
slouken@1361
   360
#if SDL_VIDEO_DRIVER_GEM
slouken@1361
   361
extern VideoBootStrap GEM_bootstrap;
slouken@1361
   362
#endif
slouken@1361
   363
#if SDL_VIDEO_DRIVER_PICOGUI
slouken@1361
   364
extern VideoBootStrap PG_bootstrap;
slouken@1361
   365
#endif
slouken@1361
   366
#if SDL_VIDEO_DRIVER_DC
slouken@1361
   367
extern VideoBootStrap DC_bootstrap;
slouken@1361
   368
#endif
slouken@1361
   369
#if SDL_VIDEO_DRIVER_RISCOS
slouken@1361
   370
extern VideoBootStrap RISCOS_bootstrap;
slouken@1361
   371
#endif
slouken@1361
   372
#if SDL_VIDEO_DRIVER_OS2FS
slouken@1361
   373
extern VideoBootStrap OS2FSLib_bootstrap;
slouken@1361
   374
#endif
slouken@1361
   375
#if SDL_VIDEO_DRIVER_DUMMY
slouken@173
   376
extern VideoBootStrap DUMMY_bootstrap;
slouken@173
   377
#endif
slouken@1361
   378
slouken@1895
   379
#define SDL_CurrentDisplay	(_this->displays[_this->current_display])
slouken@0
   380
slouken@1895
   381
extern SDL_VideoDevice *SDL_GetVideoDevice();
slouken@1895
   382
extern int SDL_AddBasicVideoDisplay(const SDL_DisplayMode * desktop_mode);
slouken@1895
   383
extern int SDL_AddVideoDisplay(const SDL_VideoDisplay * display);
slouken@1895
   384
extern SDL_bool SDL_AddDisplayMode(int displayIndex,
slouken@1895
   385
                                   const SDL_DisplayMode * mode);
slouken@1895
   386
extern void SDL_AddRenderDriver(int displayIndex,
slouken@1895
   387
                                const SDL_RenderDriver * driver);
slouken@1895
   388
slouken@1928
   389
extern int SDL_RecreateWindow(SDL_Window * window, Uint32 flags);
slouken@1895
   390
extern SDL_Window *SDL_GetWindowFromID(SDL_WindowID windowID);
slouken@1895
   391
extern SDL_VideoDisplay *SDL_GetDisplayFromWindow(SDL_Window * window);
slouken@1895
   392
slouken@1895
   393
extern void SDL_OnWindowShown(SDL_Window * window);
slouken@1895
   394
extern void SDL_OnWindowHidden(SDL_Window * window);
slouken@1895
   395
extern void SDL_OnWindowFocusGained(SDL_Window * window);
slouken@1895
   396
extern void SDL_OnWindowFocusLost(SDL_Window * window);
slouken@1895
   397
extern SDL_WindowID SDL_GetFocusWindow(void);
slouken@0
   398
slouken@0
   399
#endif /* _SDL_sysvideo_h */
slouken@1895
   400
slouken@1895
   401
/* vi: set ts=4 sw=4 expandtab: */