src/video/SDL_video.c
author Sam Lantinga <slouken@libsdl.org>
Tue, 01 Feb 2011 12:54:27 -0800
changeset 5144 a1345acf7b3d
parent 5141 31e7f523ab3d
child 5147 ad50b3db78bd
permissions -rw-r--r--
The renderers always support texture modulation and blend modes.
     1 /*
     2     SDL - Simple DirectMedia Layer
     3     Copyright (C) 1997-2010 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 #include "SDL_config.h"
    23 
    24 /* The high-level video driver subsystem */
    25 
    26 #include "SDL.h"
    27 #include "SDL_video.h"
    28 #include "SDL_sysvideo.h"
    29 #include "SDL_blit.h"
    30 #include "SDL_pixels_c.h"
    31 #include "SDL_renderer_gl.h"
    32 #include "SDL_renderer_gles.h"
    33 #include "SDL_renderer_sw.h"
    34 #include "../events/SDL_events_c.h"
    35 
    36 #if SDL_VIDEO_DRIVER_WINDOWS
    37 #include "windows/SDL_windowsvideo.h"
    38 extern void IME_Present(SDL_VideoData *videodata);
    39 #endif
    40 
    41 #if SDL_VIDEO_OPENGL_ES
    42 #include "SDL_opengles.h"
    43 #endif /* SDL_VIDEO_OPENGL_ES */
    44 
    45 #if SDL_VIDEO_OPENGL
    46 #include "SDL_opengl.h"
    47 #endif /* SDL_VIDEO_OPENGL */
    48 
    49 #include "SDL_syswm.h"
    50 
    51 /* On Windows, windows.h defines CreateWindow */
    52 #ifdef CreateWindow
    53 #undef CreateWindow
    54 #endif
    55 
    56 /* Available video drivers */
    57 static VideoBootStrap *bootstrap[] = {
    58 #if SDL_VIDEO_DRIVER_COCOA
    59     &COCOA_bootstrap,
    60 #endif
    61 #if SDL_VIDEO_DRIVER_X11
    62     &X11_bootstrap,
    63 #endif
    64 #if SDL_VIDEO_DRIVER_DIRECTFB
    65     &DirectFB_bootstrap,
    66 #endif
    67 #if SDL_VIDEO_DRIVER_WINDOWS
    68     &WINDOWS_bootstrap,
    69 #endif
    70 #if SDL_VIDEO_DRIVER_BWINDOW
    71     &BWINDOW_bootstrap,
    72 #endif
    73 #if SDL_VIDEO_DRIVER_PHOTON
    74     &photon_bootstrap,
    75 #endif
    76 #if SDL_VIDEO_DRIVER_QNXGF
    77     &qnxgf_bootstrap,
    78 #endif
    79 #if SDL_VIDEO_DRIVER_EPOC
    80     &EPOC_bootstrap,
    81 #endif
    82 #if SDL_VIDEO_DRIVER_NDS
    83     &NDS_bootstrap,
    84 #endif
    85 #if SDL_VIDEO_DRIVER_UIKIT
    86     &UIKIT_bootstrap,
    87 #endif
    88 #if SDL_VIDEO_DRIVER_DUMMY
    89     &DUMMY_bootstrap,
    90 #endif
    91 #if SDL_VIDEO_DRIVER_PANDORA
    92     &PND_bootstrap,
    93 #endif
    94 #if SDL_VIDEO_DRIVER_ANDROID
    95     &Android_bootstrap,
    96 #endif
    97     NULL
    98 };
    99 
   100 static SDL_VideoDevice *_this = NULL;
   101 
   102 #define CHECK_WINDOW_MAGIC(window, retval) \
   103     if (!_this) { \
   104         SDL_UninitializedVideo(); \
   105         return retval; \
   106     } \
   107     if (!window || window->magic != &_this->window_magic) { \
   108         SDL_SetError("Invalid window"); \
   109         return retval; \
   110     }
   111 
   112 #define CHECK_TEXTURE_MAGIC(texture, retval) \
   113     if (!_this) { \
   114         SDL_UninitializedVideo(); \
   115         return retval; \
   116     } \
   117     if (!texture || texture->magic != &_this->texture_magic) { \
   118         SDL_SetError("Invalid texture"); \
   119         return retval; \
   120     }
   121 
   122 /* Various local functions */
   123 static void SDL_UpdateWindowGrab(SDL_Window * window);
   124 
   125 static int
   126 cmpmodes(const void *A, const void *B)
   127 {
   128     SDL_DisplayMode a = *(const SDL_DisplayMode *) A;
   129     SDL_DisplayMode b = *(const SDL_DisplayMode *) B;
   130 
   131     if (a.w != b.w) {
   132         return b.w - a.w;
   133     }
   134     if (a.h != b.h) {
   135         return b.h - a.h;
   136     }
   137     if (SDL_BITSPERPIXEL(a.format) != SDL_BITSPERPIXEL(b.format)) {
   138         return SDL_BITSPERPIXEL(b.format) - SDL_BITSPERPIXEL(a.format);
   139     }
   140     if (SDL_PIXELLAYOUT(a.format) != SDL_PIXELLAYOUT(b.format)) {
   141         return SDL_PIXELLAYOUT(b.format) - SDL_PIXELLAYOUT(a.format);
   142     }
   143     if (a.refresh_rate != b.refresh_rate) {
   144         return b.refresh_rate - a.refresh_rate;
   145     }
   146     return 0;
   147 }
   148 
   149 static void
   150 SDL_UninitializedVideo()
   151 {
   152     SDL_SetError("Video subsystem has not been initialized");
   153 }
   154 
   155 int
   156 SDL_GetNumVideoDrivers(void)
   157 {
   158     return SDL_arraysize(bootstrap) - 1;
   159 }
   160 
   161 const char *
   162 SDL_GetVideoDriver(int index)
   163 {
   164     if (index >= 0 && index < SDL_GetNumVideoDrivers()) {
   165         return bootstrap[index]->name;
   166     }
   167     return NULL;
   168 }
   169 
   170 /*
   171  * Initialize the video and event subsystems -- determine native pixel format
   172  */
   173 int
   174 SDL_VideoInit(const char *driver_name)
   175 {
   176     SDL_VideoDevice *video;
   177     int index;
   178     int i;
   179 
   180     /* Check to make sure we don't overwrite '_this' */
   181     if (_this != NULL) {
   182         SDL_VideoQuit();
   183     }
   184 
   185     /* Start the event loop */
   186     if (SDL_StartEventLoop() < 0 ||
   187         SDL_KeyboardInit() < 0 ||
   188         SDL_MouseInit() < 0 ||
   189         SDL_TouchInit() < 0 ||
   190         SDL_QuitInit() < 0) {
   191         return -1;
   192     }
   193 
   194     /* Select the proper video driver */
   195     index = 0;
   196     video = NULL;
   197     if (driver_name == NULL) {
   198         driver_name = SDL_getenv("SDL_VIDEODRIVER");
   199     }
   200     if (driver_name != NULL) {
   201         for (i = 0; bootstrap[i]; ++i) {
   202             if (SDL_strcasecmp(bootstrap[i]->name, driver_name) == 0) {
   203                 video = bootstrap[i]->create(index);
   204                 break;
   205             }
   206         }
   207     } else {
   208         for (i = 0; bootstrap[i]; ++i) {
   209             if (bootstrap[i]->available()) {
   210                 video = bootstrap[i]->create(index);
   211                 if (video != NULL) {
   212                     break;
   213                 }
   214             }
   215         }
   216     }
   217     if (video == NULL) {
   218         if (driver_name) {
   219             SDL_SetError("%s not available", driver_name);
   220         } else {
   221             SDL_SetError("No available video device");
   222         }
   223         return -1;
   224     }
   225     _this = video;
   226     _this->name = bootstrap[i]->name;
   227     _this->next_object_id = 1;
   228 
   229 
   230     /* Set some very sane GL defaults */
   231     _this->gl_config.driver_loaded = 0;
   232     _this->gl_config.dll_handle = NULL;
   233     _this->gl_config.red_size = 3;
   234     _this->gl_config.green_size = 3;
   235     _this->gl_config.blue_size = 2;
   236     _this->gl_config.alpha_size = 0;
   237     _this->gl_config.buffer_size = 0;
   238     _this->gl_config.depth_size = 16;
   239     _this->gl_config.stencil_size = 0;
   240     _this->gl_config.double_buffer = 1;
   241     _this->gl_config.accum_red_size = 0;
   242     _this->gl_config.accum_green_size = 0;
   243     _this->gl_config.accum_blue_size = 0;
   244     _this->gl_config.accum_alpha_size = 0;
   245     _this->gl_config.stereo = 0;
   246     _this->gl_config.multisamplebuffers = 0;
   247     _this->gl_config.multisamplesamples = 0;
   248     _this->gl_config.retained_backing = 1;
   249     _this->gl_config.accelerated = -1;  /* accelerated or not, both are fine */
   250     _this->gl_config.major_version = 2;
   251     _this->gl_config.minor_version = 1;
   252 
   253     /* Initialize the video subsystem */
   254     if (_this->VideoInit(_this) < 0) {
   255         SDL_VideoQuit();
   256         return -1;
   257     }
   258     /* Make sure some displays were added */
   259     if (_this->num_displays == 0) {
   260         SDL_SetError("The video driver did not add any displays");
   261         SDL_VideoQuit();
   262         return (-1);
   263     }
   264     /* The software renderer is always available */
   265     for (i = 0; i < _this->num_displays; ++i) {
   266         SDL_VideoDisplay *display = &_this->displays[i];
   267         if (_this->GL_CreateContext) {
   268 #if SDL_VIDEO_RENDER_OGL
   269             SDL_AddRenderDriver(display, &GL_RenderDriver);
   270 #endif
   271 #if SDL_VIDEO_RENDER_OGL_ES
   272             SDL_AddRenderDriver(display, &GL_ES_RenderDriver);
   273 #endif
   274         }
   275         if (display->num_render_drivers > 0) {
   276             SDL_AddRenderDriver(display, &SW_RenderDriver);
   277         }
   278     }
   279 
   280     /* We're ready to go! */
   281     return 0;
   282 }
   283 
   284 const char *
   285 SDL_GetCurrentVideoDriver()
   286 {
   287     if (!_this) {
   288         SDL_UninitializedVideo();
   289         return NULL;
   290     }
   291     return _this->name;
   292 }
   293 
   294 SDL_VideoDevice *
   295 SDL_GetVideoDevice(void)
   296 {
   297     return _this;
   298 }
   299 
   300 int
   301 SDL_AddBasicVideoDisplay(const SDL_DisplayMode * desktop_mode)
   302 {
   303     SDL_VideoDisplay display;
   304 
   305     SDL_zero(display);
   306     if (desktop_mode) {
   307         display.desktop_mode = *desktop_mode;
   308     }
   309     display.current_mode = display.desktop_mode;
   310 
   311     return SDL_AddVideoDisplay(&display);
   312 }
   313 
   314 int
   315 SDL_AddVideoDisplay(const SDL_VideoDisplay * display)
   316 {
   317     SDL_VideoDisplay *displays;
   318     int index = -1;
   319 
   320     displays =
   321         SDL_realloc(_this->displays,
   322                     (_this->num_displays + 1) * sizeof(*displays));
   323     if (displays) {
   324         index = _this->num_displays++;
   325         displays[index] = *display;
   326         displays[index].device = _this;
   327         _this->displays = displays;
   328     } else {
   329         SDL_OutOfMemory();
   330     }
   331     return index;
   332 }
   333 
   334 int
   335 SDL_GetNumVideoDisplays(void)
   336 {
   337     if (!_this) {
   338         SDL_UninitializedVideo();
   339         return 0;
   340     }
   341     return _this->num_displays;
   342 }
   343 
   344 int
   345 SDL_GetDisplayBounds(int index, SDL_Rect * rect)
   346 {
   347     if (!_this) {
   348         SDL_UninitializedVideo();
   349         return -1;
   350     }
   351     if (index < 0 || index >= _this->num_displays) {
   352         SDL_SetError("index must be in the range 0 - %d",
   353                      _this->num_displays - 1);
   354         return -1;
   355     }
   356     if (rect) {
   357         SDL_VideoDisplay *display = &_this->displays[index];
   358 
   359         if (_this->GetDisplayBounds) {
   360             if (_this->GetDisplayBounds(_this, display, rect) < 0) {
   361                 return -1;
   362             }
   363         } else {
   364             /* Assume that the displays are left to right */
   365             if (index == 0) {
   366                 rect->x = 0;
   367                 rect->y = 0;
   368             } else {
   369                 SDL_GetDisplayBounds(index-1, rect);
   370                 rect->x += rect->w;
   371             }
   372             rect->w = display->desktop_mode.w;
   373             rect->h = display->desktop_mode.h;
   374         }
   375     }
   376     return 0;
   377 }
   378 
   379 int
   380 SDL_SelectVideoDisplay(int index)
   381 {
   382     if (!_this) {
   383         SDL_UninitializedVideo();
   384         return (-1);
   385     }
   386     if (index < 0 || index >= _this->num_displays) {
   387         SDL_SetError("index must be in the range 0 - %d",
   388                      _this->num_displays - 1);
   389         return -1;
   390     }
   391     _this->current_display = index;
   392     return 0;
   393 }
   394 
   395 int
   396 SDL_GetCurrentVideoDisplay(void)
   397 {
   398     if (!_this) {
   399         SDL_UninitializedVideo();
   400         return (-1);
   401     }
   402     return _this->current_display;
   403 }
   404 
   405 SDL_bool
   406 SDL_AddDisplayMode(SDL_VideoDisplay * display,  const SDL_DisplayMode * mode)
   407 {
   408     SDL_DisplayMode *modes;
   409     int i, nmodes;
   410 
   411     /* Make sure we don't already have the mode in the list */
   412     modes = display->display_modes;
   413     nmodes = display->num_display_modes;
   414     for (i = nmodes; i--;) {
   415         if (SDL_memcmp(mode, &modes[i], sizeof(*mode)) == 0) {
   416             return SDL_FALSE;
   417         }
   418     }
   419 
   420     /* Go ahead and add the new mode */
   421     if (nmodes == display->max_display_modes) {
   422         modes =
   423             SDL_realloc(modes,
   424                         (display->max_display_modes + 32) * sizeof(*modes));
   425         if (!modes) {
   426             return SDL_FALSE;
   427         }
   428         display->display_modes = modes;
   429         display->max_display_modes += 32;
   430     }
   431     modes[nmodes] = *mode;
   432     display->num_display_modes++;
   433 
   434     /* Re-sort video modes */
   435     SDL_qsort(display->display_modes, display->num_display_modes,
   436               sizeof(SDL_DisplayMode), cmpmodes);
   437 
   438     return SDL_TRUE;
   439 }
   440 
   441 int
   442 SDL_GetNumDisplayModesForDisplay(SDL_VideoDisplay * display)
   443 {
   444     if (!display->num_display_modes && _this->GetDisplayModes) {
   445         _this->GetDisplayModes(_this, display);
   446         SDL_qsort(display->display_modes, display->num_display_modes,
   447                   sizeof(SDL_DisplayMode), cmpmodes);
   448     }
   449     return display->num_display_modes;
   450 }
   451 
   452 int
   453 SDL_GetNumDisplayModes()
   454 {
   455     if (_this) {
   456         return SDL_GetNumDisplayModesForDisplay(SDL_CurrentDisplay);
   457     }
   458     return 0;
   459 }
   460 
   461 int
   462 SDL_GetDisplayModeForDisplay(SDL_VideoDisplay * display, int index, SDL_DisplayMode * mode)
   463 {
   464     if (index < 0 || index >= SDL_GetNumDisplayModesForDisplay(display)) {
   465         SDL_SetError("index must be in the range of 0 - %d",
   466                      SDL_GetNumDisplayModesForDisplay(display) - 1);
   467         return -1;
   468     }
   469     if (mode) {
   470         *mode = display->display_modes[index];
   471     }
   472     return 0;
   473 }
   474 
   475 int
   476 SDL_GetDisplayMode(int index, SDL_DisplayMode * mode)
   477 {
   478     return SDL_GetDisplayModeForDisplay(SDL_CurrentDisplay, index, mode);
   479 }
   480 
   481 int
   482 SDL_GetDesktopDisplayModeForDisplay(SDL_VideoDisplay * display, SDL_DisplayMode * mode)
   483 {
   484     if (mode) {
   485         *mode = display->desktop_mode;
   486     }
   487     return 0;
   488 }
   489 
   490 int
   491 SDL_GetDesktopDisplayMode(SDL_DisplayMode * mode)
   492 {
   493     if (!_this) {
   494         SDL_UninitializedVideo();
   495         return -1;
   496     }
   497     return SDL_GetDesktopDisplayModeForDisplay(SDL_CurrentDisplay, mode);
   498 }
   499 
   500 int
   501 SDL_GetCurrentDisplayModeForDisplay(SDL_VideoDisplay * display, SDL_DisplayMode * mode)
   502 {
   503     if (mode) {
   504         *mode = display->current_mode;
   505     }
   506     return 0;
   507 }
   508 
   509 int
   510 SDL_GetCurrentDisplayMode(SDL_DisplayMode * mode)
   511 {
   512     if (!_this) {
   513         SDL_UninitializedVideo();
   514         return -1;
   515     }
   516     return SDL_GetCurrentDisplayModeForDisplay(SDL_CurrentDisplay, mode);
   517 }
   518 
   519 SDL_DisplayMode *
   520 SDL_GetClosestDisplayModeForDisplay(SDL_VideoDisplay * display,
   521                                     const SDL_DisplayMode * mode,
   522                                     SDL_DisplayMode * closest)
   523 {
   524     Uint32 target_format;
   525     int target_refresh_rate;
   526     int i;
   527     SDL_DisplayMode *current, *match;
   528 
   529     if (!mode || !closest) {
   530         SDL_SetError("Missing desired mode or closest mode parameter");
   531         return NULL;
   532     }
   533 
   534     /* Default to the desktop format */
   535     if (mode->format) {
   536         target_format = mode->format;
   537     } else {
   538         target_format = display->desktop_mode.format;
   539     }
   540 
   541     /* Default to the desktop refresh rate */
   542     if (mode->refresh_rate) {
   543         target_refresh_rate = mode->refresh_rate;
   544     } else {
   545         target_refresh_rate = display->desktop_mode.refresh_rate;
   546     }
   547 
   548     match = NULL;
   549     for (i = 0; i < SDL_GetNumDisplayModesForDisplay(display); ++i) {
   550         current = &display->display_modes[i];
   551 
   552         if (current->w && (current->w < mode->w)) {
   553             /* Out of sorted modes large enough here */
   554             break;
   555         }
   556         if (current->h && (current->h < mode->h)) {
   557             if (current->w && (current->w == mode->w)) {
   558                 /* Out of sorted modes large enough here */
   559                 break;
   560             }
   561             /* Wider, but not tall enough, due to a different
   562                aspect ratio. This mode must be skipped, but closer
   563                modes may still follow. */
   564             continue;
   565         }
   566         if (!match || current->w < match->w || current->h < match->h) {
   567             match = current;
   568             continue;
   569         }
   570         if (current->format != match->format) {
   571             /* Sorted highest depth to lowest */
   572             if (current->format == target_format ||
   573                 (SDL_BITSPERPIXEL(current->format) >=
   574                  SDL_BITSPERPIXEL(target_format)
   575                  && SDL_PIXELTYPE(current->format) ==
   576                  SDL_PIXELTYPE(target_format))) {
   577                 match = current;
   578             }
   579             continue;
   580         }
   581         if (current->refresh_rate != match->refresh_rate) {
   582             /* Sorted highest refresh to lowest */
   583             if (current->refresh_rate >= target_refresh_rate) {
   584                 match = current;
   585             }
   586         }
   587     }
   588     if (match) {
   589         if (match->format) {
   590             closest->format = match->format;
   591         } else {
   592             closest->format = mode->format;
   593         }
   594         if (match->w && match->h) {
   595             closest->w = match->w;
   596             closest->h = match->h;
   597         } else {
   598             closest->w = mode->w;
   599             closest->h = mode->h;
   600         }
   601         if (match->refresh_rate) {
   602             closest->refresh_rate = match->refresh_rate;
   603         } else {
   604             closest->refresh_rate = mode->refresh_rate;
   605         }
   606         closest->driverdata = match->driverdata;
   607 
   608         /*
   609          * Pick some reasonable defaults if the app and driver don't
   610          * care
   611          */
   612         if (!closest->format) {
   613             closest->format = SDL_PIXELFORMAT_RGB888;
   614         }
   615         if (!closest->w) {
   616             closest->w = 640;
   617         }
   618         if (!closest->h) {
   619             closest->h = 480;
   620         }
   621         return closest;
   622     }
   623     return NULL;
   624 }
   625 
   626 SDL_DisplayMode *
   627 SDL_GetClosestDisplayMode(const SDL_DisplayMode * mode,
   628                           SDL_DisplayMode * closest)
   629 {
   630     if (!_this) {
   631         SDL_UninitializedVideo();
   632         return NULL;
   633     }
   634     return SDL_GetClosestDisplayModeForDisplay(SDL_CurrentDisplay, mode, closest);
   635 }
   636 
   637 int
   638 SDL_SetDisplayModeForDisplay(SDL_VideoDisplay * display, const SDL_DisplayMode * mode)
   639 {
   640     SDL_DisplayMode display_mode;
   641     SDL_DisplayMode current_mode;
   642     int ncolors;
   643 
   644     if (mode) {
   645         display_mode = *mode;
   646 
   647         /* Default to the current mode */
   648         if (!display_mode.format) {
   649             display_mode.format = display->current_mode.format;
   650         }
   651         if (!display_mode.w) {
   652             display_mode.w = display->current_mode.w;
   653         }
   654         if (!display_mode.h) {
   655             display_mode.h = display->current_mode.h;
   656         }
   657         if (!display_mode.refresh_rate) {
   658             display_mode.refresh_rate = display->current_mode.refresh_rate;
   659         }
   660 
   661         /* Get a good video mode, the closest one possible */
   662         if (!SDL_GetClosestDisplayModeForDisplay(display, &display_mode, &display_mode)) {
   663             SDL_SetError("No video mode large enough for %dx%d",
   664                          display_mode.w, display_mode.h);
   665             return -1;
   666         }
   667     } else {
   668         display_mode = display->desktop_mode;
   669     }
   670 
   671     /* See if there's anything left to do */
   672     SDL_GetCurrentDisplayModeForDisplay(display, &current_mode);
   673     if (SDL_memcmp(&display_mode, &current_mode, sizeof(display_mode)) == 0) {
   674         return 0;
   675     }
   676 
   677     /* Actually change the display mode */
   678     if (!_this->SetDisplayMode) {
   679         SDL_SetError("Video driver doesn't support changing display mode");
   680         return -1;
   681     }
   682     if (_this->SetDisplayMode(_this, display, &display_mode) < 0) {
   683         return -1;
   684     }
   685     display->current_mode = display_mode;
   686 
   687     /* Set up a palette, if necessary */
   688     if (SDL_ISPIXELFORMAT_INDEXED(display_mode.format)) {
   689         ncolors = (1 << SDL_BITSPERPIXEL(display_mode.format));
   690     } else {
   691         ncolors = 0;
   692     }
   693     if ((!ncolors && display->palette) || (ncolors && !display->palette)
   694         || (ncolors && ncolors != display->palette->ncolors)) {
   695         if (display->palette) {
   696             SDL_FreePalette(display->palette);
   697             display->palette = NULL;
   698         }
   699         if (ncolors) {
   700             display->palette = SDL_AllocPalette(ncolors);
   701             if (!display->palette) {
   702                 return -1;
   703             }
   704             SDL_DitherColors(display->palette->colors,
   705                              SDL_BITSPERPIXEL(display_mode.format));
   706         }
   707     }
   708 
   709     return 0;
   710 }
   711 
   712 int
   713 SDL_SetWindowDisplayMode(SDL_Window * window, const SDL_DisplayMode * mode)
   714 {
   715     CHECK_WINDOW_MAGIC(window, -1);
   716 
   717     if (mode) {
   718         window->fullscreen_mode = *mode;
   719     } else {
   720         SDL_zero(window->fullscreen_mode);
   721     }
   722     return 0;
   723 }
   724 
   725 int
   726 SDL_GetWindowDisplayMode(SDL_Window * window, SDL_DisplayMode * mode)
   727 {
   728     SDL_DisplayMode fullscreen_mode;
   729 
   730     CHECK_WINDOW_MAGIC(window, -1);
   731 
   732     fullscreen_mode = window->fullscreen_mode;
   733     if (!fullscreen_mode.w) {
   734         fullscreen_mode.w = window->w;
   735     }
   736     if (!fullscreen_mode.h) {
   737         fullscreen_mode.h = window->h;
   738     }
   739 
   740     if (!SDL_GetClosestDisplayModeForDisplay(window->display,
   741                                              &fullscreen_mode,
   742                                              &fullscreen_mode)) {
   743         SDL_SetError("Couldn't find display mode match");
   744         return -1;
   745     }
   746 
   747     if (mode) {
   748         *mode = fullscreen_mode;
   749     }
   750     return 0;
   751 }
   752 
   753 static void
   754 SDL_UpdateFullscreenMode(SDL_Window * window, SDL_bool attempt)
   755 {
   756     SDL_VideoDisplay *display = window->display;
   757 
   758     /* See if we're already processing a window */
   759     if (display->updating_fullscreen) {
   760         return;
   761     }
   762 
   763     display->updating_fullscreen = SDL_TRUE;
   764 
   765     /* See if we even want to do anything here */
   766     if ((window->flags & SDL_WINDOW_FULLSCREEN) &&
   767         (window->flags & SDL_WINDOW_SHOWN)) {
   768         if (attempt) {
   769             /* We just gained some state, try to gain all states */
   770             if (window->flags & SDL_WINDOW_MINIMIZED) {
   771                 SDL_RestoreWindow(window);
   772             } else {
   773                 SDL_RaiseWindow(window);
   774             }
   775         } else {
   776             /* We just lost some state, try to release all states */
   777             SDL_MinimizeWindow(window);
   778         }
   779     }
   780 
   781     if (FULLSCREEN_VISIBLE(window)) {
   782         /* Hide any other fullscreen windows */
   783         SDL_Window *other;
   784         for (other = display->windows; other; other = other->next) {
   785             if (other != window && FULLSCREEN_VISIBLE(other)) {
   786                 SDL_MinimizeWindow(other);
   787             }
   788         }
   789     }
   790 
   791     display->updating_fullscreen = SDL_FALSE;
   792 
   793     /* See if there are any fullscreen windows */
   794     for (window = display->windows; window; window = window->next) {
   795         if (FULLSCREEN_VISIBLE(window)) {
   796             SDL_DisplayMode fullscreen_mode;
   797             if (SDL_GetWindowDisplayMode(window, &fullscreen_mode) == 0) {
   798                 SDL_SetDisplayModeForDisplay(display, &fullscreen_mode);
   799                 display->fullscreen_window = window;
   800                 return;
   801             }
   802         }
   803     }
   804 
   805     /* Nope, restore the desktop mode */
   806     SDL_SetDisplayModeForDisplay(display, NULL);
   807     display->fullscreen_window = NULL;
   808 }
   809 
   810 int
   811 SDL_SetPaletteForDisplay(SDL_VideoDisplay * display, const SDL_Color * colors, int firstcolor, int ncolors)
   812 {
   813     SDL_Palette *palette;
   814     int status = 0;
   815 
   816     palette = display->palette;
   817     if (!palette) {
   818         SDL_SetError("Display mode does not have a palette");
   819         return -1;
   820     }
   821     status = SDL_SetPaletteColors(palette, colors, firstcolor, ncolors);
   822 
   823     if (_this->SetDisplayPalette) {
   824         if (_this->SetDisplayPalette(_this, display, palette) < 0) {
   825             status = -1;
   826         }
   827     }
   828     return status;
   829 }
   830 
   831 int
   832 SDL_SetDisplayPalette(const SDL_Color * colors, int firstcolor, int ncolors)
   833 {
   834     if (!_this) {
   835         SDL_UninitializedVideo();
   836         return -1;
   837     }
   838     return SDL_SetPaletteForDisplay(SDL_CurrentDisplay, colors, firstcolor, ncolors);
   839 }
   840 
   841 int
   842 SDL_GetPaletteForDisplay(SDL_VideoDisplay * display, SDL_Color * colors, int firstcolor, int ncolors)
   843 {
   844     SDL_Palette *palette;
   845 
   846     palette = display->palette;
   847     if (!palette || !palette->ncolors) {
   848         SDL_SetError("Display mode does not have a palette");
   849         return -1;
   850     }
   851     if (firstcolor < 0 || (firstcolor + ncolors) > palette->ncolors) {
   852         SDL_SetError("Palette indices are out of range");
   853         return -1;
   854     }
   855     SDL_memcpy(colors, &palette->colors[firstcolor],
   856                ncolors * sizeof(*colors));
   857     return 0;
   858 }
   859 
   860 int
   861 SDL_GetDisplayPalette(SDL_Color * colors, int firstcolor, int ncolors)
   862 {
   863     if (!_this) {
   864         SDL_UninitializedVideo();
   865         return -1;
   866     }
   867     return SDL_GetPaletteForDisplay(SDL_CurrentDisplay, colors, firstcolor, ncolors);
   868 }
   869 
   870 SDL_Window *
   871 SDL_CreateWindow(const char *title, int x, int y, int w, int h, Uint32 flags)
   872 {
   873     const Uint32 allowed_flags = (SDL_WINDOW_FULLSCREEN |
   874                                   SDL_WINDOW_OPENGL |
   875                                   SDL_WINDOW_BORDERLESS |
   876                                   SDL_WINDOW_RESIZABLE |
   877                                   SDL_WINDOW_INPUT_GRABBED);
   878     SDL_VideoDisplay *display;
   879     SDL_Window *window;
   880 
   881     if (!_this) {
   882         /* Initialize the video system if needed */
   883         if (SDL_VideoInit(NULL) < 0) {
   884             return NULL;
   885         }
   886     }
   887     if (flags & SDL_WINDOW_OPENGL) {
   888         if (!_this->GL_CreateContext) {
   889             SDL_SetError("No OpenGL support in video driver");
   890             return NULL;
   891         }
   892         SDL_GL_LoadLibrary(NULL);
   893     }
   894     display = SDL_CurrentDisplay;
   895     window = (SDL_Window *)SDL_calloc(1, sizeof(*window));
   896     window->magic = &_this->window_magic;
   897     window->id = _this->next_object_id++;
   898     window->x = x;
   899     window->y = y;
   900     window->w = w;
   901     window->h = h;
   902     window->flags = (flags & allowed_flags);
   903     window->display = display;
   904     window->next = display->windows;
   905     if (display->windows) {
   906         display->windows->prev = window;
   907     }
   908     display->windows = window;
   909 
   910     if (_this->CreateWindow && _this->CreateWindow(_this, window) < 0) {
   911         SDL_DestroyWindow(window);
   912         return NULL;
   913     }
   914 
   915     if (title) {
   916         SDL_SetWindowTitle(window, title);
   917     }
   918     if (flags & SDL_WINDOW_MAXIMIZED) {
   919         SDL_MaximizeWindow(window);
   920     }
   921     if (flags & SDL_WINDOW_MINIMIZED) {
   922         SDL_MinimizeWindow(window);
   923     }
   924     if (flags & SDL_WINDOW_SHOWN) {
   925         SDL_ShowWindow(window);
   926     }
   927     SDL_UpdateWindowGrab(window);
   928 
   929     return window;
   930 }
   931 
   932 SDL_Window *
   933 SDL_CreateWindowFrom(const void *data)
   934 {
   935     SDL_VideoDisplay *display;
   936     SDL_Window *window;
   937 
   938     if (!_this) {
   939         SDL_UninitializedVideo();
   940         return NULL;
   941     }
   942     display = SDL_CurrentDisplay;
   943     window = (SDL_Window *)SDL_calloc(1, sizeof(*window));
   944     window->magic = &_this->window_magic;
   945     window->id = _this->next_object_id++;
   946     window->flags = SDL_WINDOW_FOREIGN;
   947     window->display = display;
   948     window->next = display->windows;
   949     if (display->windows) {
   950         display->windows->prev = window;
   951     }
   952     display->windows = window;
   953 
   954     if (!_this->CreateWindowFrom ||
   955         _this->CreateWindowFrom(_this, window, data) < 0) {
   956         SDL_DestroyWindow(window);
   957         return NULL;
   958     }
   959     return window;
   960 }
   961 
   962 int
   963 SDL_RecreateWindow(SDL_Window * window, Uint32 flags)
   964 {
   965     const Uint32 allowed_flags = (SDL_WINDOW_FULLSCREEN |
   966                                   SDL_WINDOW_OPENGL |
   967                                   SDL_WINDOW_BORDERLESS |
   968                                   SDL_WINDOW_RESIZABLE |
   969                                   SDL_WINDOW_INPUT_GRABBED |
   970                                   SDL_WINDOW_FOREIGN);
   971     char *title = window->title;
   972 
   973     if ((flags & SDL_WINDOW_OPENGL) && !_this->GL_CreateContext) {
   974         SDL_SetError("No OpenGL support in video driver");
   975         return -1;
   976     }
   977     if ((window->flags & SDL_WINDOW_OPENGL) != (flags & SDL_WINDOW_OPENGL)) {
   978         if (flags & SDL_WINDOW_OPENGL) {
   979             SDL_GL_LoadLibrary(NULL);
   980         } else {
   981             SDL_GL_UnloadLibrary();
   982         }
   983     }
   984 
   985     if (window->flags & SDL_WINDOW_FOREIGN) {
   986         /* Can't destroy and re-create foreign windows, hrm */
   987         flags |= SDL_WINDOW_FOREIGN;
   988     } else {
   989         flags &= ~SDL_WINDOW_FOREIGN;
   990     }
   991 
   992     if (_this->DestroyWindow && !(flags & SDL_WINDOW_FOREIGN)) {
   993         _this->DestroyWindow(_this, window);
   994     }
   995 
   996     window->title = NULL;
   997     window->flags = (flags & allowed_flags);
   998 
   999     if (_this->CreateWindow && !(flags & SDL_WINDOW_FOREIGN)) {
  1000         if (_this->CreateWindow(_this, window) < 0) {
  1001             if (flags & SDL_WINDOW_OPENGL) {
  1002                 SDL_GL_UnloadLibrary();
  1003             }
  1004             return -1;
  1005         }
  1006     }
  1007 
  1008     if (title) {
  1009         SDL_SetWindowTitle(window, title);
  1010         SDL_free(title);
  1011     }
  1012     if (flags & SDL_WINDOW_MAXIMIZED) {
  1013         SDL_MaximizeWindow(window);
  1014     }
  1015     if (flags & SDL_WINDOW_MINIMIZED) {
  1016         SDL_MinimizeWindow(window);
  1017     }
  1018     if (flags & SDL_WINDOW_SHOWN) {
  1019         SDL_ShowWindow(window);
  1020     }
  1021     SDL_UpdateWindowGrab(window);
  1022 
  1023     return 0;
  1024 }
  1025 
  1026 static __inline__ SDL_Renderer *
  1027 SDL_GetCurrentRenderer(SDL_bool create)
  1028 {
  1029     if (!_this) {
  1030         SDL_UninitializedVideo();
  1031         return NULL;
  1032     }
  1033     if (!SDL_CurrentRenderer) {
  1034         SDL_Window *window = NULL;
  1035 
  1036         if (!create) {
  1037             SDL_SetError("Use SDL_CreateRenderer() to create a renderer");
  1038             return NULL;
  1039         }
  1040 
  1041         /* Get the first window on the first display */
  1042         if (_this->num_displays > 0) {
  1043             window = _this->displays[0].windows;
  1044         }
  1045 
  1046         if (SDL_CreateRenderer(window, -1, 0) < 0) {
  1047             return NULL;
  1048         }
  1049     }
  1050     return SDL_CurrentRenderer;
  1051 }
  1052 
  1053 Uint32
  1054 SDL_GetWindowID(SDL_Window * window)
  1055 {
  1056     CHECK_WINDOW_MAGIC(window, 0);
  1057 
  1058     return window->id;
  1059 }
  1060 
  1061 SDL_Window *
  1062 SDL_GetWindowFromID(Uint32 id)
  1063 {
  1064     SDL_Window *window;
  1065     int i;
  1066 
  1067     if (!_this) {
  1068         return NULL;
  1069     }
  1070     /* FIXME: Should we keep a separate hash table for these? */
  1071     for (i = _this->num_displays; i--;) {
  1072         SDL_VideoDisplay *display = &_this->displays[i];
  1073         for (window = display->windows; window; window = window->next) {
  1074             if (window->id == id) {
  1075                 return window;
  1076             }
  1077         }
  1078     }
  1079     return NULL;
  1080 }
  1081 
  1082 Uint32
  1083 SDL_GetWindowFlags(SDL_Window * window)
  1084 {
  1085     CHECK_WINDOW_MAGIC(window, 0);
  1086 
  1087     return window->flags;
  1088 }
  1089 
  1090 void
  1091 SDL_SetWindowTitle(SDL_Window * window, const char *title)
  1092 {
  1093     CHECK_WINDOW_MAGIC(window, );
  1094 
  1095     if (title == window->title) {
  1096         return;
  1097     }
  1098     if (window->title) {
  1099         SDL_free(window->title);
  1100     }
  1101     if (title && *title) {
  1102         window->title = SDL_strdup(title);
  1103     } else {
  1104         window->title = NULL;
  1105     }
  1106 
  1107     if (_this->SetWindowTitle) {
  1108         _this->SetWindowTitle(_this, window);
  1109     }
  1110 }
  1111 
  1112 const char *
  1113 SDL_GetWindowTitle(SDL_Window * window)
  1114 {
  1115     CHECK_WINDOW_MAGIC(window, "");
  1116 
  1117     return window->title ? window->title : "";
  1118 }
  1119 
  1120 void
  1121 SDL_SetWindowIcon(SDL_Window * window, SDL_Surface * icon)
  1122 {
  1123     CHECK_WINDOW_MAGIC(window, );
  1124 
  1125     if (_this->SetWindowIcon) {
  1126         _this->SetWindowIcon(_this, window, icon);
  1127     }
  1128 }
  1129 
  1130 void
  1131 SDL_SetWindowData(SDL_Window * window, void *userdata)
  1132 {
  1133     CHECK_WINDOW_MAGIC(window, );
  1134 
  1135     window->userdata = userdata;
  1136 }
  1137 
  1138 void *
  1139 SDL_GetWindowData(SDL_Window * window)
  1140 {
  1141     CHECK_WINDOW_MAGIC(window, NULL);
  1142 
  1143     return window->userdata;
  1144 }
  1145 
  1146 void
  1147 SDL_SetWindowPosition(SDL_Window * window, int x, int y)
  1148 {
  1149     CHECK_WINDOW_MAGIC(window, );
  1150 
  1151     if (x != SDL_WINDOWPOS_UNDEFINED) {
  1152         window->x = x;
  1153     }
  1154     if (y != SDL_WINDOWPOS_UNDEFINED) {
  1155         window->y = y;
  1156     }
  1157     if (_this->SetWindowPosition) {
  1158         _this->SetWindowPosition(_this, window);
  1159     }
  1160     SDL_SendWindowEvent(window, SDL_WINDOWEVENT_MOVED, x, y);
  1161 }
  1162 
  1163 void
  1164 SDL_GetWindowPosition(SDL_Window * window, int *x, int *y)
  1165 {
  1166     CHECK_WINDOW_MAGIC(window, );
  1167 
  1168     if (x) {
  1169         *x = window->x;
  1170     }
  1171     if (y) {
  1172         *y = window->y;
  1173     }
  1174 }
  1175 
  1176 void
  1177 SDL_SetWindowSize(SDL_Window * window, int w, int h)
  1178 {
  1179     CHECK_WINDOW_MAGIC(window, );
  1180 
  1181     window->w = w;
  1182     window->h = h;
  1183 
  1184     if (_this->SetWindowSize) {
  1185         _this->SetWindowSize(_this, window);
  1186     }
  1187     SDL_OnWindowResized(window);
  1188 }
  1189 
  1190 void
  1191 SDL_GetWindowSize(SDL_Window * window, int *w, int *h)
  1192 {
  1193     if (window) {
  1194         if (w) {
  1195             *w = window->w;
  1196         }
  1197         if (h) {
  1198             *h = window->h;
  1199         }
  1200     } else {
  1201         if (w) {
  1202             *w = 0;
  1203         }
  1204         if (h) {
  1205             *h = 0;
  1206         }
  1207     }
  1208 }
  1209 
  1210 void
  1211 SDL_ShowWindow(SDL_Window * window)
  1212 {
  1213     CHECK_WINDOW_MAGIC(window, );
  1214 
  1215     if (window->flags & SDL_WINDOW_SHOWN) {
  1216         return;
  1217     }
  1218 
  1219     if (_this->ShowWindow) {
  1220         _this->ShowWindow(_this, window);
  1221     }
  1222     SDL_SendWindowEvent(window, SDL_WINDOWEVENT_SHOWN, 0, 0);
  1223 }
  1224 
  1225 void
  1226 SDL_HideWindow(SDL_Window * window)
  1227 {
  1228     CHECK_WINDOW_MAGIC(window, );
  1229 
  1230     if (!(window->flags & SDL_WINDOW_SHOWN)) {
  1231         return;
  1232     }
  1233 
  1234     if (_this->HideWindow) {
  1235         _this->HideWindow(_this, window);
  1236     }
  1237     SDL_SendWindowEvent(window, SDL_WINDOWEVENT_HIDDEN, 0, 0);
  1238 }
  1239 
  1240 void
  1241 SDL_RaiseWindow(SDL_Window * window)
  1242 {
  1243     CHECK_WINDOW_MAGIC(window, );
  1244 
  1245     if (!(window->flags & SDL_WINDOW_SHOWN)) {
  1246         return;
  1247     }
  1248     if (_this->RaiseWindow) {
  1249         _this->RaiseWindow(_this, window);
  1250     } else {
  1251         /* FIXME: What we really want is a way to request focus */
  1252         SDL_SendWindowEvent(window, SDL_WINDOWEVENT_FOCUS_GAINED, 0, 0);
  1253     }
  1254 }
  1255 
  1256 void
  1257 SDL_MaximizeWindow(SDL_Window * window)
  1258 {
  1259     CHECK_WINDOW_MAGIC(window, );
  1260 
  1261     if (window->flags & SDL_WINDOW_MAXIMIZED) {
  1262         return;
  1263     }
  1264 
  1265     if (_this->MaximizeWindow) {
  1266         _this->MaximizeWindow(_this, window);
  1267     }
  1268     SDL_SendWindowEvent(window, SDL_WINDOWEVENT_MAXIMIZED, 0, 0);
  1269 }
  1270 
  1271 void
  1272 SDL_MinimizeWindow(SDL_Window * window)
  1273 {
  1274     CHECK_WINDOW_MAGIC(window, );
  1275 
  1276     if (window->flags & SDL_WINDOW_MINIMIZED) {
  1277         return;
  1278     }
  1279 
  1280     if (_this->MinimizeWindow) {
  1281         _this->MinimizeWindow(_this, window);
  1282     }
  1283     SDL_SendWindowEvent(window, SDL_WINDOWEVENT_MINIMIZED, 0, 0);
  1284 }
  1285 
  1286 void
  1287 SDL_RestoreWindow(SDL_Window * window)
  1288 {
  1289     CHECK_WINDOW_MAGIC(window, );
  1290 
  1291     if (!(window->flags & (SDL_WINDOW_MAXIMIZED | SDL_WINDOW_MINIMIZED))) {
  1292         return;
  1293     }
  1294 
  1295     if (_this->RestoreWindow) {
  1296         _this->RestoreWindow(_this, window);
  1297     }
  1298     SDL_SendWindowEvent(window, SDL_WINDOWEVENT_RESTORED, 0, 0);
  1299 }
  1300 
  1301 int
  1302 SDL_SetWindowFullscreen(SDL_Window * window, int fullscreen)
  1303 {
  1304     CHECK_WINDOW_MAGIC(window, -1);
  1305 
  1306     if (fullscreen) {
  1307         fullscreen = SDL_WINDOW_FULLSCREEN;
  1308     }
  1309     if ((window->flags & SDL_WINDOW_FULLSCREEN) == fullscreen) {
  1310         return 0;
  1311     }
  1312     if (fullscreen) {
  1313         window->flags |= SDL_WINDOW_FULLSCREEN;
  1314 
  1315         SDL_UpdateFullscreenMode(window, SDL_TRUE);
  1316     } else {
  1317         window->flags &= ~SDL_WINDOW_FULLSCREEN;
  1318 
  1319         SDL_UpdateFullscreenMode(window, SDL_FALSE);
  1320     }
  1321     return 0;
  1322 }
  1323 
  1324 void
  1325 SDL_SetWindowGrab(SDL_Window * window, int mode)
  1326 {
  1327     CHECK_WINDOW_MAGIC(window, );
  1328 
  1329     if ((!!mode == !!(window->flags & SDL_WINDOW_INPUT_GRABBED))) {
  1330         return;
  1331     }
  1332     if (mode) {
  1333         window->flags |= SDL_WINDOW_INPUT_GRABBED;
  1334     } else {
  1335         window->flags &= ~SDL_WINDOW_INPUT_GRABBED;
  1336     }
  1337     SDL_UpdateWindowGrab(window);
  1338 }
  1339 
  1340 static void
  1341 SDL_UpdateWindowGrab(SDL_Window * window)
  1342 {
  1343     if ((window->flags & SDL_WINDOW_INPUT_FOCUS) && _this->SetWindowGrab) {
  1344         _this->SetWindowGrab(_this, window);
  1345     }
  1346 }
  1347 
  1348 int
  1349 SDL_GetWindowGrab(SDL_Window * window)
  1350 {
  1351     CHECK_WINDOW_MAGIC(window, 0);
  1352 
  1353     return ((window->flags & SDL_WINDOW_INPUT_GRABBED) != 0);
  1354 }
  1355 
  1356 void
  1357 SDL_OnWindowShown(SDL_Window * window)
  1358 {
  1359     SDL_RaiseWindow(window);
  1360     SDL_UpdateFullscreenMode(window, SDL_TRUE);
  1361 }
  1362 
  1363 void
  1364 SDL_OnWindowHidden(SDL_Window * window)
  1365 {
  1366     SDL_UpdateFullscreenMode(window, SDL_FALSE);
  1367 }
  1368 
  1369 void
  1370 SDL_OnWindowResized(SDL_Window * window)
  1371 {
  1372     SDL_Renderer *renderer = window->renderer;
  1373 
  1374     if (renderer && renderer->DisplayModeChanged) {
  1375         renderer->DisplayModeChanged(renderer);
  1376     }
  1377 }
  1378 
  1379 void
  1380 SDL_OnWindowMinimized(SDL_Window * window)
  1381 {
  1382     SDL_UpdateFullscreenMode(window, SDL_FALSE);
  1383 }
  1384 
  1385 void
  1386 SDL_OnWindowRestored(SDL_Window * window)
  1387 {
  1388     SDL_RaiseWindow(window);
  1389     SDL_UpdateFullscreenMode(window, SDL_TRUE);
  1390 }
  1391 
  1392 void
  1393 SDL_OnWindowFocusGained(SDL_Window * window)
  1394 {
  1395     SDL_VideoDisplay *display = window->display;
  1396 
  1397     if (display->gamma && _this->SetDisplayGammaRamp) {
  1398         _this->SetDisplayGammaRamp(_this, display, display->gamma);
  1399     }
  1400     if ((window->flags & (SDL_WINDOW_INPUT_GRABBED | SDL_WINDOW_FULLSCREEN))
  1401         && _this->SetWindowGrab) {
  1402         _this->SetWindowGrab(_this, window);
  1403     }
  1404 }
  1405 
  1406 void
  1407 SDL_OnWindowFocusLost(SDL_Window * window)
  1408 {
  1409     SDL_VideoDisplay *display = window->display;
  1410 
  1411     /* If we're fullscreen on a single-head system and lose focus, minimize */
  1412     if ((window->flags & SDL_WINDOW_FULLSCREEN) &&
  1413         _this->num_displays == 1) {
  1414         SDL_MinimizeWindow(window);
  1415     }
  1416 
  1417     if (display->gamma && _this->SetDisplayGammaRamp) {
  1418         _this->SetDisplayGammaRamp(_this, display, display->saved_gamma);
  1419     }
  1420     if ((window->flags & (SDL_WINDOW_INPUT_GRABBED | SDL_WINDOW_FULLSCREEN))
  1421         && _this->SetWindowGrab) {
  1422         _this->SetWindowGrab(_this, window);
  1423     }
  1424 }
  1425 
  1426 SDL_Window *
  1427 SDL_GetFocusWindow(void)
  1428 {
  1429     SDL_VideoDisplay *display;
  1430     SDL_Window *window;
  1431 
  1432     if (!_this) {
  1433         return NULL;
  1434     }
  1435     display = SDL_CurrentDisplay;
  1436     for (window = display->windows; window; window = window->next) {
  1437         if (window->flags & SDL_WINDOW_INPUT_FOCUS) {
  1438             return window;
  1439         }
  1440     }
  1441     return NULL;
  1442 }
  1443 
  1444 void
  1445 SDL_DestroyWindow(SDL_Window * window)
  1446 {
  1447     SDL_VideoDisplay *display;
  1448 
  1449     CHECK_WINDOW_MAGIC(window, );
  1450 
  1451     if (window->title) {
  1452         SDL_free(window->title);
  1453     }
  1454     if (window->renderer) {
  1455         SDL_DestroyRenderer(window);
  1456     }
  1457 
  1458     /* Restore video mode, etc. */
  1459     SDL_UpdateFullscreenMode(window, SDL_FALSE);
  1460 
  1461     if (_this->DestroyWindow) {
  1462         _this->DestroyWindow(_this, window);
  1463     }
  1464     if (window->flags & SDL_WINDOW_OPENGL) {
  1465         SDL_GL_UnloadLibrary();
  1466     }
  1467 
  1468     /* Now invalidate magic */
  1469     window->magic = NULL;
  1470 
  1471     /* Unlink the window from the list */
  1472     display = window->display;
  1473     if (window->next) {
  1474         window->next->prev = window->prev;
  1475     }
  1476     if (window->prev) {
  1477         window->prev->next = window->next;
  1478     } else {
  1479         display->windows = window->next;
  1480     }
  1481 
  1482     SDL_free(window);
  1483 }
  1484 
  1485 void
  1486 SDL_AddRenderDriver(SDL_VideoDisplay * display, const SDL_RenderDriver * driver)
  1487 {
  1488     SDL_RenderDriver *render_drivers;
  1489 
  1490     render_drivers =
  1491         SDL_realloc(display->render_drivers,
  1492                     (display->num_render_drivers +
  1493                      1) * sizeof(*render_drivers));
  1494     if (render_drivers) {
  1495         render_drivers[display->num_render_drivers] = *driver;
  1496         display->render_drivers = render_drivers;
  1497         display->num_render_drivers++;
  1498     }
  1499 }
  1500 
  1501 int
  1502 SDL_GetNumRenderDrivers(void)
  1503 {
  1504     if (_this) {
  1505         return SDL_CurrentDisplay->num_render_drivers;
  1506     }
  1507     return 0;
  1508 }
  1509 
  1510 int
  1511 SDL_GetRenderDriverInfo(int index, SDL_RendererInfo * info)
  1512 {
  1513     if (!_this) {
  1514         SDL_UninitializedVideo();
  1515         return -1;
  1516     }
  1517     if (index < 0 || index >= SDL_GetNumRenderDrivers()) {
  1518         SDL_SetError("index must be in the range of 0 - %d",
  1519                      SDL_GetNumRenderDrivers() - 1);
  1520         return -1;
  1521     }
  1522     *info = SDL_CurrentDisplay->render_drivers[index].info;
  1523     return 0;
  1524 }
  1525 
  1526 int
  1527 SDL_CreateRenderer(SDL_Window * window, int index, Uint32 flags)
  1528 {
  1529     CHECK_WINDOW_MAGIC(window, -1);
  1530 
  1531     /* Free any existing renderer */
  1532     SDL_DestroyRenderer(window);
  1533 
  1534     if (index < 0) {
  1535         char *override = SDL_getenv("SDL_VIDEO_RENDERER");
  1536         int n = SDL_GetNumRenderDrivers();
  1537 
  1538 #if SDL_VIDEO_RENDER_OGL
  1539         if (!override && (window->flags & SDL_WINDOW_OPENGL)) {
  1540             override = "opengl";
  1541         }
  1542 #endif /* SDL_VIDEO_RENDER_OGL */
  1543 #if SDL_VIDEO_RENDER_OGL_ES
  1544         if (!override && (window->flags & SDL_WINDOW_OPENGL)) {
  1545             override = "opengl_es";
  1546         }
  1547 #endif /* SDL_VIDEO_RENDER_OGL_ES */
  1548         if (override) {
  1549             for (index = 0; index < n; ++index) {
  1550                 SDL_RenderDriver *driver =
  1551                     &SDL_CurrentDisplay->render_drivers[index];
  1552 
  1553                 if (SDL_strcasecmp(override, driver->info.name) == 0) {
  1554                     /* Create a new renderer instance */
  1555                     window->renderer = driver->CreateRenderer(window, flags);
  1556                     break;
  1557                 }
  1558             }
  1559         } else {
  1560             for (index = 0; index < n; ++index) {
  1561                 SDL_RenderDriver *driver =
  1562                     &SDL_CurrentDisplay->render_drivers[index];
  1563 
  1564                 if ((driver->info.flags & flags) == flags) {
  1565                     /* Create a new renderer instance */
  1566                     window->renderer = driver->CreateRenderer(window, flags);
  1567                     if (window->renderer) {
  1568                         /* Yay, we got one! */
  1569                         break;
  1570                     }
  1571                 }
  1572             }
  1573         }
  1574         if (index == n) {
  1575             SDL_SetError("Couldn't find matching render driver");
  1576             return -1;
  1577         }
  1578     } else {
  1579         if (index >= SDL_GetNumRenderDrivers()) {
  1580             SDL_SetError("index must be -1 or in the range of 0 - %d",
  1581                          SDL_GetNumRenderDrivers() - 1);
  1582             return -1;
  1583         }
  1584         /* Create a new renderer instance */
  1585         window->renderer = SDL_CurrentDisplay->render_drivers[index].CreateRenderer(window, flags);
  1586     }
  1587 
  1588     if (window->renderer == NULL) {
  1589         /* Assuming renderer set its error */
  1590         return -1;
  1591     }
  1592 
  1593     SDL_SelectRenderer(window);
  1594 
  1595     return 0;
  1596 }
  1597 
  1598 int
  1599 SDL_SelectRenderer(SDL_Window * window)
  1600 {
  1601     SDL_Renderer *renderer;
  1602 
  1603     CHECK_WINDOW_MAGIC(window, -1);
  1604 
  1605     renderer = window->renderer;
  1606     if (!renderer) {
  1607         SDL_SetError("Use SDL_CreateRenderer() to create a renderer");
  1608         return -1;
  1609     }
  1610     if (renderer->ActivateRenderer) {
  1611         if (renderer->ActivateRenderer(renderer) < 0) {
  1612             return -1;
  1613         }
  1614     }
  1615     SDL_CurrentDisplay->current_renderer = renderer;
  1616     return 0;
  1617 }
  1618 
  1619 int
  1620 SDL_GetRendererInfo(SDL_RendererInfo * info)
  1621 {
  1622     SDL_Renderer *renderer = SDL_GetCurrentRenderer(SDL_FALSE);
  1623     if (!renderer) {
  1624         return -1;
  1625     }
  1626     *info = renderer->info;
  1627     return 0;
  1628 }
  1629 
  1630 SDL_Texture *
  1631 SDL_CreateTexture(Uint32 format, int access, int w, int h)
  1632 {
  1633     SDL_Renderer *renderer;
  1634     SDL_Texture *texture;
  1635 
  1636     renderer = SDL_GetCurrentRenderer(SDL_TRUE);
  1637     if (!renderer) {
  1638         return 0;
  1639     }
  1640     if (!renderer->CreateTexture) {
  1641         SDL_Unsupported();
  1642         return 0;
  1643     }
  1644     if (w <= 0 || h <= 0) {
  1645         SDL_SetError("Texture dimensions can't be 0");
  1646         return 0;
  1647     }
  1648     texture = (SDL_Texture *) SDL_calloc(1, sizeof(*texture));
  1649     if (!texture) {
  1650         SDL_OutOfMemory();
  1651         return 0;
  1652     }
  1653     texture->magic = &_this->texture_magic;
  1654     texture->format = format;
  1655     texture->access = access;
  1656     texture->w = w;
  1657     texture->h = h;
  1658     texture->r = 255;
  1659     texture->g = 255;
  1660     texture->b = 255;
  1661     texture->a = 255;
  1662     texture->renderer = renderer;
  1663     texture->next = renderer->textures;
  1664     if (renderer->textures) {
  1665         renderer->textures->prev = texture;
  1666     }
  1667     renderer->textures = texture;
  1668 
  1669     if (renderer->CreateTexture(renderer, texture) < 0) {
  1670         SDL_DestroyTexture(texture);
  1671         return 0;
  1672     }
  1673     return texture;
  1674 }
  1675 
  1676 SDL_Texture *
  1677 SDL_CreateTextureFromSurface(Uint32 format, SDL_Surface * surface)
  1678 {
  1679     SDL_Texture *texture;
  1680     Uint32 requested_format = format;
  1681     SDL_PixelFormat *fmt;
  1682     SDL_Renderer *renderer;
  1683     int bpp;
  1684     Uint32 Rmask, Gmask, Bmask, Amask;
  1685 
  1686     if (!surface) {
  1687         SDL_SetError("SDL_CreateTextureFromSurface() passed NULL surface");
  1688         return 0;
  1689     }
  1690     fmt = surface->format;
  1691 
  1692     renderer = SDL_GetCurrentRenderer(SDL_TRUE);
  1693     if (!renderer) {
  1694         return 0;
  1695     }
  1696 
  1697     if (format) {
  1698         if (!SDL_PixelFormatEnumToMasks
  1699             (format, &bpp, &Rmask, &Gmask, &Bmask, &Amask)) {
  1700             SDL_SetError("Unknown pixel format");
  1701             return 0;
  1702         }
  1703     } else {
  1704         if (surface->format->Amask
  1705             || !(surface->map->info.flags &
  1706                  (SDL_COPY_COLORKEY | SDL_COPY_BLEND))) {
  1707             Uint32 it;
  1708             int pfmt;
  1709 
  1710             /* Pixel formats, sorted by best first */
  1711             static const Uint32 sdl_pformats[] = {
  1712                 SDL_PIXELFORMAT_ARGB8888,
  1713                 SDL_PIXELFORMAT_RGBA8888,
  1714                 SDL_PIXELFORMAT_ABGR8888,
  1715                 SDL_PIXELFORMAT_BGRA8888,
  1716                 SDL_PIXELFORMAT_RGB888,
  1717                 SDL_PIXELFORMAT_BGR888,
  1718                 SDL_PIXELFORMAT_RGB24,
  1719                 SDL_PIXELFORMAT_BGR24,
  1720                 SDL_PIXELFORMAT_RGB565,
  1721                 SDL_PIXELFORMAT_BGR565,
  1722                 SDL_PIXELFORMAT_ARGB1555,
  1723                 SDL_PIXELFORMAT_RGBA5551,
  1724                 SDL_PIXELFORMAT_ABGR1555,
  1725                 SDL_PIXELFORMAT_BGRA5551,
  1726                 SDL_PIXELFORMAT_RGB555,
  1727                 SDL_PIXELFORMAT_BGR555,
  1728                 SDL_PIXELFORMAT_ARGB4444,
  1729                 SDL_PIXELFORMAT_RGBA4444,
  1730                 SDL_PIXELFORMAT_ABGR4444,
  1731                 SDL_PIXELFORMAT_BGRA4444,
  1732                 SDL_PIXELFORMAT_RGB444,
  1733                 SDL_PIXELFORMAT_ARGB2101010,
  1734                 SDL_PIXELFORMAT_INDEX8,
  1735                 SDL_PIXELFORMAT_INDEX4LSB,
  1736                 SDL_PIXELFORMAT_INDEX4MSB,
  1737                 SDL_PIXELFORMAT_RGB332,
  1738                 SDL_PIXELFORMAT_INDEX1LSB,
  1739                 SDL_PIXELFORMAT_INDEX1MSB,
  1740                 SDL_PIXELFORMAT_UNKNOWN
  1741             };
  1742 
  1743             bpp = fmt->BitsPerPixel;
  1744             Rmask = fmt->Rmask;
  1745             Gmask = fmt->Gmask;
  1746             Bmask = fmt->Bmask;
  1747             Amask = fmt->Amask;
  1748 
  1749             format =
  1750                 SDL_MasksToPixelFormatEnum(bpp, Rmask, Gmask, Bmask, Amask);
  1751             if (!format) {
  1752                 SDL_SetError("Unknown pixel format");
  1753                 return 0;
  1754             }
  1755 
  1756             /* Search requested format in the supported texture */
  1757             /* formats by current renderer                      */
  1758             for (it = 0; it < renderer->info.num_texture_formats; it++) {
  1759                 if (renderer->info.texture_formats[it] == format) {
  1760                     break;
  1761                 }
  1762             }
  1763 
  1764             /* If requested format can't be found, search any best */
  1765             /* format which renderer provides                      */
  1766             if (it == renderer->info.num_texture_formats) {
  1767                 pfmt = 0;
  1768                 for (;;) {
  1769                     if (sdl_pformats[pfmt] == SDL_PIXELFORMAT_UNKNOWN) {
  1770                         break;
  1771                     }
  1772 
  1773                     for (it = 0; it < renderer->info.num_texture_formats;
  1774                          it++) {
  1775                         if (renderer->info.texture_formats[it] ==
  1776                             sdl_pformats[pfmt]) {
  1777                             break;
  1778                         }
  1779                     }
  1780 
  1781                     if (it != renderer->info.num_texture_formats) {
  1782                         /* The best format has been found */
  1783                         break;
  1784                     }
  1785                     pfmt++;
  1786                 }
  1787 
  1788                 /* If any format can't be found, then return an error */
  1789                 if (it == renderer->info.num_texture_formats) {
  1790                     SDL_SetError
  1791                         ("Any of the supported pixel formats can't be found");
  1792                     return 0;
  1793                 }
  1794 
  1795                 /* Convert found pixel format back to color masks */
  1796                 if (SDL_PixelFormatEnumToMasks
  1797                     (renderer->info.texture_formats[it], &bpp, &Rmask, &Gmask,
  1798                      &Bmask, &Amask) != SDL_TRUE) {
  1799                     SDL_SetError("Unknown pixel format");
  1800                     return 0;
  1801                 }
  1802             }
  1803         } else {
  1804             /* Need a format with alpha */
  1805             Uint32 it;
  1806             int apfmt;
  1807 
  1808             /* Pixel formats with alpha, sorted by best first */
  1809             static const Uint32 sdl_alpha_pformats[] = {
  1810                 SDL_PIXELFORMAT_ARGB8888,
  1811                 SDL_PIXELFORMAT_RGBA8888,
  1812                 SDL_PIXELFORMAT_ABGR8888,
  1813                 SDL_PIXELFORMAT_BGRA8888,
  1814                 SDL_PIXELFORMAT_ARGB1555,
  1815                 SDL_PIXELFORMAT_RGBA5551,
  1816                 SDL_PIXELFORMAT_ABGR1555,
  1817                 SDL_PIXELFORMAT_BGRA5551,
  1818                 SDL_PIXELFORMAT_ARGB4444,
  1819                 SDL_PIXELFORMAT_RGBA4444,
  1820                 SDL_PIXELFORMAT_ABGR4444,
  1821                 SDL_PIXELFORMAT_BGRA4444,
  1822                 SDL_PIXELFORMAT_ARGB2101010,
  1823                 SDL_PIXELFORMAT_UNKNOWN
  1824             };
  1825 
  1826             if (surface->format->Amask) {
  1827                 /* If surface already has alpha, then try an original */
  1828                 /* surface format first                               */
  1829                 bpp = fmt->BitsPerPixel;
  1830                 Rmask = fmt->Rmask;
  1831                 Gmask = fmt->Gmask;
  1832                 Bmask = fmt->Bmask;
  1833                 Amask = fmt->Amask;
  1834             } else {
  1835                 bpp = 32;
  1836                 Rmask = 0x00FF0000;
  1837                 Gmask = 0x0000FF00;
  1838                 Bmask = 0x000000FF;
  1839                 Amask = 0xFF000000;
  1840             }
  1841 
  1842             format =
  1843                 SDL_MasksToPixelFormatEnum(bpp, Rmask, Gmask, Bmask, Amask);
  1844             if (!format) {
  1845                 SDL_SetError("Unknown pixel format");
  1846                 return 0;
  1847             }
  1848 
  1849             /* Search this format in the supported texture formats */
  1850             /* by current renderer                                 */
  1851             for (it = 0; it < renderer->info.num_texture_formats; it++) {
  1852                 if (renderer->info.texture_formats[it] == format) {
  1853                     break;
  1854                 }
  1855             }
  1856 
  1857             /* If this format can't be found, search any best       */
  1858             /* compatible format with alpha which renderer provides */
  1859             if (it == renderer->info.num_texture_formats) {
  1860                 apfmt = 0;
  1861                 for (;;) {
  1862                     if (sdl_alpha_pformats[apfmt] == SDL_PIXELFORMAT_UNKNOWN) {
  1863                         break;
  1864                     }
  1865 
  1866                     for (it = 0; it < renderer->info.num_texture_formats;
  1867                          it++) {
  1868                         if (renderer->info.texture_formats[it] ==
  1869                             sdl_alpha_pformats[apfmt]) {
  1870                             break;
  1871                         }
  1872                     }
  1873 
  1874                     if (it != renderer->info.num_texture_formats) {
  1875                         /* Compatible format has been found */
  1876                         break;
  1877                     }
  1878                     apfmt++;
  1879                 }
  1880 
  1881                 /* If compatible format can't be found, then return an error */
  1882                 if (it == renderer->info.num_texture_formats) {
  1883                     SDL_SetError("Compatible pixel format can't be found");
  1884                     return 0;
  1885                 }
  1886 
  1887                 /* Convert found pixel format back to color masks */
  1888                 if (SDL_PixelFormatEnumToMasks
  1889                     (renderer->info.texture_formats[it], &bpp, &Rmask, &Gmask,
  1890                      &Bmask, &Amask) != SDL_TRUE) {
  1891                     SDL_SetError("Unknown pixel format");
  1892                     return 0;
  1893                 }
  1894             }
  1895         }
  1896 
  1897         format = SDL_MasksToPixelFormatEnum(bpp, Rmask, Gmask, Bmask, Amask);
  1898         if (!format) {
  1899             SDL_SetError("Unknown pixel format");
  1900             return 0;
  1901         }
  1902     }
  1903 
  1904     texture =
  1905         SDL_CreateTexture(format, SDL_TEXTUREACCESS_STATIC, surface->w,
  1906                           surface->h);
  1907     if (!texture && !requested_format) {
  1908         SDL_DisplayMode desktop_mode;
  1909         SDL_GetDesktopDisplayMode(&desktop_mode);
  1910         format = desktop_mode.format;
  1911         texture =
  1912             SDL_CreateTexture(format, SDL_TEXTUREACCESS_STATIC, surface->w,
  1913                               surface->h);
  1914     }
  1915     if (!texture) {
  1916         return 0;
  1917     }
  1918     if (bpp == fmt->BitsPerPixel && Rmask == fmt->Rmask && Gmask == fmt->Gmask
  1919         && Bmask == fmt->Bmask && Amask == fmt->Amask) {
  1920         if (SDL_MUSTLOCK(surface)) {
  1921             SDL_LockSurface(surface);
  1922             SDL_UpdateTexture(texture, NULL, surface->pixels,
  1923                               surface->pitch);
  1924             SDL_UnlockSurface(surface);
  1925         } else {
  1926             SDL_UpdateTexture(texture, NULL, surface->pixels,
  1927                               surface->pitch);
  1928         }
  1929     } else {
  1930         SDL_PixelFormat dst_fmt;
  1931         SDL_Surface *dst = NULL;
  1932 
  1933         /* Set up a destination surface for the texture update */
  1934         SDL_InitFormat(&dst_fmt, bpp, Rmask, Gmask, Bmask, Amask);
  1935         if (SDL_ISPIXELFORMAT_INDEXED(format)) {
  1936             dst_fmt.palette =
  1937                 SDL_AllocPalette((1 << SDL_BITSPERPIXEL(format)));
  1938             if (dst_fmt.palette) {
  1939                 /*
  1940                  * FIXME: Should we try to copy
  1941                  * fmt->palette?
  1942                  */
  1943                 SDL_DitherColors(dst_fmt.palette->colors,
  1944                                  SDL_BITSPERPIXEL(format));
  1945             }
  1946         }
  1947         dst = SDL_ConvertSurface(surface, &dst_fmt, 0);
  1948         if (dst) {
  1949             SDL_UpdateTexture(texture, NULL, dst->pixels, dst->pitch);
  1950             SDL_FreeSurface(dst);
  1951         }
  1952         if (dst_fmt.palette) {
  1953             SDL_FreePalette(dst_fmt.palette);
  1954         }
  1955         if (!dst) {
  1956             SDL_DestroyTexture(texture);
  1957             return 0;
  1958         }
  1959     }
  1960 
  1961     {
  1962         Uint8 r, g, b, a;
  1963         SDL_BlendMode blendMode;
  1964 
  1965         SDL_GetSurfaceColorMod(surface, &r, &g, &b);
  1966         SDL_SetTextureColorMod(texture, r, g, b);
  1967 
  1968         SDL_GetSurfaceAlphaMod(surface, &a);
  1969         SDL_SetTextureAlphaMod(texture, a);
  1970 
  1971         if (surface->map->info.flags & SDL_COPY_COLORKEY) {
  1972             /* We converted to a texture with alpha format */
  1973             SDL_SetTextureBlendMode(texture, SDL_BLENDMODE_BLEND);
  1974         } else {
  1975             SDL_GetSurfaceBlendMode(surface, &blendMode);
  1976             SDL_SetTextureBlendMode(texture, blendMode);
  1977         }
  1978     }
  1979 
  1980     if (SDL_ISPIXELFORMAT_INDEXED(format) && fmt->palette) {
  1981         SDL_SetTexturePalette(texture, fmt->palette->colors, 0,
  1982                               fmt->palette->ncolors);
  1983     }
  1984     return texture;
  1985 }
  1986 
  1987 int
  1988 SDL_QueryTexture(SDL_Texture * texture, Uint32 * format, int *access,
  1989                  int *w, int *h)
  1990 {
  1991     CHECK_TEXTURE_MAGIC(texture, -1);
  1992 
  1993     if (format) {
  1994         *format = texture->format;
  1995     }
  1996     if (access) {
  1997         *access = texture->access;
  1998     }
  1999     if (w) {
  2000         *w = texture->w;
  2001     }
  2002     if (h) {
  2003         *h = texture->h;
  2004     }
  2005     return 0;
  2006 }
  2007 
  2008 int
  2009 SDL_QueryTexturePixels(SDL_Texture * texture, void **pixels, int *pitch)
  2010 {
  2011     SDL_Renderer *renderer;
  2012 
  2013     CHECK_TEXTURE_MAGIC(texture, -1);
  2014 
  2015     renderer = texture->renderer;
  2016     if (!renderer->QueryTexturePixels) {
  2017         SDL_Unsupported();
  2018         return -1;
  2019     }
  2020     return renderer->QueryTexturePixels(renderer, texture, pixels, pitch);
  2021 }
  2022 
  2023 int
  2024 SDL_SetTexturePalette(SDL_Texture * texture, const SDL_Color * colors,
  2025                       int firstcolor, int ncolors)
  2026 {
  2027     SDL_Renderer *renderer;
  2028 
  2029     CHECK_TEXTURE_MAGIC(texture, -1);
  2030 
  2031     renderer = texture->renderer;
  2032     if (!renderer->SetTexturePalette) {
  2033         SDL_Unsupported();
  2034         return -1;
  2035     }
  2036     return renderer->SetTexturePalette(renderer, texture, colors, firstcolor,
  2037                                        ncolors);
  2038 }
  2039 
  2040 int
  2041 SDL_GetTexturePalette(SDL_Texture * texture, SDL_Color * colors,
  2042                       int firstcolor, int ncolors)
  2043 {
  2044     SDL_Renderer *renderer;
  2045 
  2046     CHECK_TEXTURE_MAGIC(texture, -1);
  2047 
  2048     renderer = texture->renderer;
  2049     if (!renderer->GetTexturePalette) {
  2050         SDL_Unsupported();
  2051         return -1;
  2052     }
  2053     return renderer->GetTexturePalette(renderer, texture, colors, firstcolor,
  2054                                        ncolors);
  2055 }
  2056 
  2057 int
  2058 SDL_SetTextureColorMod(SDL_Texture * texture, Uint8 r, Uint8 g, Uint8 b)
  2059 {
  2060     SDL_Renderer *renderer;
  2061 
  2062     CHECK_TEXTURE_MAGIC(texture, -1);
  2063 
  2064     renderer = texture->renderer;
  2065     if (r < 255 || g < 255 || b < 255) {
  2066         texture->modMode |= SDL_TEXTUREMODULATE_COLOR;
  2067     } else {
  2068         texture->modMode &= ~SDL_TEXTUREMODULATE_COLOR;
  2069     }
  2070     texture->r = r;
  2071     texture->g = g;
  2072     texture->b = b;
  2073     if (renderer->SetTextureColorMod) {
  2074         return renderer->SetTextureColorMod(renderer, texture);
  2075     } else {
  2076         return 0;
  2077     }
  2078 }
  2079 
  2080 int
  2081 SDL_GetTextureColorMod(SDL_Texture * texture, Uint8 * r, Uint8 * g,
  2082                        Uint8 * b)
  2083 {
  2084     SDL_Renderer *renderer;
  2085 
  2086     CHECK_TEXTURE_MAGIC(texture, -1);
  2087 
  2088     renderer = texture->renderer;
  2089     if (r) {
  2090         *r = texture->r;
  2091     }
  2092     if (g) {
  2093         *g = texture->g;
  2094     }
  2095     if (b) {
  2096         *b = texture->b;
  2097     }
  2098     return 0;
  2099 }
  2100 
  2101 int
  2102 SDL_SetTextureAlphaMod(SDL_Texture * texture, Uint8 alpha)
  2103 {
  2104     SDL_Renderer *renderer;
  2105 
  2106     CHECK_TEXTURE_MAGIC(texture, -1);
  2107 
  2108     renderer = texture->renderer;
  2109     if (alpha < 255) {
  2110         texture->modMode |= SDL_TEXTUREMODULATE_ALPHA;
  2111     } else {
  2112         texture->modMode &= ~SDL_TEXTUREMODULATE_ALPHA;
  2113     }
  2114     texture->a = alpha;
  2115     if (renderer->SetTextureAlphaMod) {
  2116         return renderer->SetTextureAlphaMod(renderer, texture);
  2117     } else {
  2118         return 0;
  2119     }
  2120 }
  2121 
  2122 int
  2123 SDL_GetTextureAlphaMod(SDL_Texture * texture, Uint8 * alpha)
  2124 {
  2125     CHECK_TEXTURE_MAGIC(texture, -1);
  2126 
  2127     if (alpha) {
  2128         *alpha = texture->a;
  2129     }
  2130     return 0;
  2131 }
  2132 
  2133 int
  2134 SDL_SetTextureBlendMode(SDL_Texture * texture, SDL_BlendMode blendMode)
  2135 {
  2136     SDL_Renderer *renderer;
  2137 
  2138     CHECK_TEXTURE_MAGIC(texture, -1);
  2139 
  2140     renderer = texture->renderer;
  2141     texture->blendMode = blendMode;
  2142     if (renderer->SetTextureBlendMode) {
  2143         return renderer->SetTextureBlendMode(renderer, texture);
  2144     } else {
  2145         return 0;
  2146     }
  2147 }
  2148 
  2149 int
  2150 SDL_GetTextureBlendMode(SDL_Texture * texture, SDL_BlendMode *blendMode)
  2151 {
  2152     CHECK_TEXTURE_MAGIC(texture, -1);
  2153 
  2154     if (blendMode) {
  2155         *blendMode = texture->blendMode;
  2156     }
  2157     return 0;
  2158 }
  2159 
  2160 int
  2161 SDL_UpdateTexture(SDL_Texture * texture, const SDL_Rect * rect,
  2162                   const void *pixels, int pitch)
  2163 {
  2164     SDL_Renderer *renderer;
  2165     SDL_Rect full_rect;
  2166 
  2167     CHECK_TEXTURE_MAGIC(texture, -1);
  2168 
  2169     renderer = texture->renderer;
  2170     if (!renderer->UpdateTexture) {
  2171         SDL_Unsupported();
  2172         return -1;
  2173     }
  2174     if (!rect) {
  2175         full_rect.x = 0;
  2176         full_rect.y = 0;
  2177         full_rect.w = texture->w;
  2178         full_rect.h = texture->h;
  2179         rect = &full_rect;
  2180     }
  2181     return renderer->UpdateTexture(renderer, texture, rect, pixels, pitch);
  2182 }
  2183 
  2184 int
  2185 SDL_LockTexture(SDL_Texture * texture, const SDL_Rect * rect, int markDirty,
  2186                 void **pixels, int *pitch)
  2187 {
  2188     SDL_Renderer *renderer;
  2189     SDL_Rect full_rect;
  2190 
  2191     CHECK_TEXTURE_MAGIC(texture, -1);
  2192 
  2193     if (texture->access != SDL_TEXTUREACCESS_STREAMING) {
  2194         SDL_SetError("SDL_LockTexture(): texture must be streaming");
  2195         return -1;
  2196     }
  2197     renderer = texture->renderer;
  2198     if (!renderer->LockTexture) {
  2199         SDL_Unsupported();
  2200         return -1;
  2201     }
  2202     if (!rect) {
  2203         full_rect.x = 0;
  2204         full_rect.y = 0;
  2205         full_rect.w = texture->w;
  2206         full_rect.h = texture->h;
  2207         rect = &full_rect;
  2208     }
  2209     return renderer->LockTexture(renderer, texture, rect, markDirty, pixels,
  2210                                  pitch);
  2211 }
  2212 
  2213 void
  2214 SDL_UnlockTexture(SDL_Texture * texture)
  2215 {
  2216     SDL_Renderer *renderer;
  2217 
  2218     CHECK_TEXTURE_MAGIC(texture, );
  2219 
  2220     if (texture->access != SDL_TEXTUREACCESS_STREAMING) {
  2221         return;
  2222     }
  2223     renderer = texture->renderer;
  2224     if (!renderer->UnlockTexture) {
  2225         return;
  2226     }
  2227     renderer->UnlockTexture(renderer, texture);
  2228 }
  2229 
  2230 void
  2231 SDL_DirtyTexture(SDL_Texture * texture, int numrects,
  2232                  const SDL_Rect * rects)
  2233 {
  2234     SDL_Renderer *renderer;
  2235 
  2236     CHECK_TEXTURE_MAGIC(texture, );
  2237 
  2238     if (texture->access != SDL_TEXTUREACCESS_STREAMING) {
  2239         return;
  2240     }
  2241     renderer = texture->renderer;
  2242     if (!renderer->DirtyTexture) {
  2243         return;
  2244     }
  2245     renderer->DirtyTexture(renderer, texture, numrects, rects);
  2246 }
  2247 
  2248 int
  2249 SDL_SetRenderDrawColor(Uint8 r, Uint8 g, Uint8 b, Uint8 a)
  2250 {
  2251     SDL_Renderer *renderer;
  2252 
  2253     renderer = SDL_GetCurrentRenderer(SDL_TRUE);
  2254     if (!renderer) {
  2255         return -1;
  2256     }
  2257     renderer->r = r;
  2258     renderer->g = g;
  2259     renderer->b = b;
  2260     renderer->a = a;
  2261     return 0;
  2262 }
  2263 
  2264 int
  2265 SDL_GetRenderDrawColor(Uint8 * r, Uint8 * g, Uint8 * b, Uint8 * a)
  2266 {
  2267     SDL_Renderer *renderer;
  2268 
  2269     renderer = SDL_GetCurrentRenderer(SDL_TRUE);
  2270     if (!renderer) {
  2271         return -1;
  2272     }
  2273     if (r) {
  2274         *r = renderer->r;
  2275     }
  2276     if (g) {
  2277         *g = renderer->g;
  2278     }
  2279     if (b) {
  2280         *b = renderer->b;
  2281     }
  2282     if (a) {
  2283         *a = renderer->a;
  2284     }
  2285     return 0;
  2286 }
  2287 
  2288 int
  2289 SDL_SetRenderDrawBlendMode(SDL_BlendMode blendMode)
  2290 {
  2291     SDL_Renderer *renderer;
  2292 
  2293     renderer = SDL_GetCurrentRenderer(SDL_TRUE);
  2294     if (!renderer) {
  2295         return -1;
  2296     }
  2297     renderer->blendMode = blendMode;
  2298     return 0;
  2299 }
  2300 
  2301 int
  2302 SDL_GetRenderDrawBlendMode(SDL_BlendMode *blendMode)
  2303 {
  2304     SDL_Renderer *renderer;
  2305 
  2306     renderer = SDL_GetCurrentRenderer(SDL_TRUE);
  2307     if (!renderer) {
  2308         return -1;
  2309     }
  2310     *blendMode = renderer->blendMode;
  2311     return 0;
  2312 }
  2313 
  2314 int
  2315 SDL_RenderClear()
  2316 {
  2317     SDL_Renderer *renderer;
  2318 
  2319     renderer = SDL_GetCurrentRenderer(SDL_TRUE);
  2320     if (!renderer) {
  2321         return -1;
  2322     }
  2323     if (!renderer->RenderClear) {
  2324         SDL_BlendMode blendMode = renderer->blendMode;
  2325         int status;
  2326 
  2327         if (blendMode >= SDL_BLENDMODE_BLEND) {
  2328             SDL_SetRenderDrawBlendMode(SDL_BLENDMODE_NONE);
  2329         }
  2330 
  2331         status = SDL_RenderFillRect(NULL);
  2332 
  2333         if (blendMode >= SDL_BLENDMODE_BLEND) {
  2334             SDL_SetRenderDrawBlendMode(blendMode);
  2335         }
  2336         return status;
  2337     }
  2338     return renderer->RenderClear(renderer);
  2339 }
  2340 
  2341 int
  2342 SDL_RenderDrawPoint(int x, int y)
  2343 {
  2344     SDL_Point point;
  2345 
  2346     point.x = x;
  2347     point.y = y;
  2348     return SDL_RenderDrawPoints(&point, 1);
  2349 }
  2350 
  2351 int
  2352 SDL_RenderDrawPoints(const SDL_Point * points, int count)
  2353 {
  2354     SDL_Renderer *renderer;
  2355 
  2356     if (!points) {
  2357         SDL_SetError("SDL_RenderDrawPoints(): Passed NULL points");
  2358         return -1;
  2359     }
  2360 
  2361     renderer = SDL_GetCurrentRenderer(SDL_TRUE);
  2362     if (!renderer) {
  2363         return -1;
  2364     }
  2365     if (!renderer->RenderDrawPoints) {
  2366         SDL_Unsupported();
  2367         return -1;
  2368     }
  2369     if (count < 1) {
  2370         return 0;
  2371     }
  2372     return renderer->RenderDrawPoints(renderer, points, count);
  2373 }
  2374 
  2375 int
  2376 SDL_RenderDrawLine(int x1, int y1, int x2, int y2)
  2377 {
  2378     SDL_Point points[2];
  2379 
  2380     points[0].x = x1;
  2381     points[0].y = y1;
  2382     points[1].x = x2;
  2383     points[1].y = y2;
  2384     return SDL_RenderDrawLines(points, 2);
  2385 }
  2386 
  2387 int
  2388 SDL_RenderDrawLines(const SDL_Point * points, int count)
  2389 {
  2390     SDL_Renderer *renderer;
  2391 
  2392     if (!points) {
  2393         SDL_SetError("SDL_RenderDrawLines(): Passed NULL points");
  2394         return -1;
  2395     }
  2396 
  2397     renderer = SDL_GetCurrentRenderer(SDL_TRUE);
  2398     if (!renderer) {
  2399         return -1;
  2400     }
  2401     if (!renderer->RenderDrawLines) {
  2402         SDL_Unsupported();
  2403         return -1;
  2404     }
  2405     if (count < 2) {
  2406         return 0;
  2407     }
  2408     return renderer->RenderDrawLines(renderer, points, count);
  2409 }
  2410 
  2411 int
  2412 SDL_RenderDrawRect(const SDL_Rect * rect)
  2413 {
  2414     return SDL_RenderDrawRects(&rect, 1);
  2415 }
  2416 
  2417 int
  2418 SDL_RenderDrawRects(const SDL_Rect ** rects, int count)
  2419 {
  2420     SDL_Renderer *renderer;
  2421     int i;
  2422 
  2423     if (!rects) {
  2424         SDL_SetError("SDL_RenderDrawRects(): Passed NULL rects");
  2425         return -1;
  2426     }
  2427 
  2428     renderer = SDL_GetCurrentRenderer(SDL_TRUE);
  2429     if (!renderer) {
  2430         return -1;
  2431     }
  2432     if (!renderer->RenderDrawRects) {
  2433         SDL_Unsupported();
  2434         return -1;
  2435     }
  2436     if (count < 1) {
  2437         return 0;
  2438     }
  2439     /* Check for NULL rect, which means fill entire window */
  2440     for (i = 0; i < count; ++i) {
  2441         if (rects[i] == NULL) {
  2442             SDL_Window *window = renderer->window;
  2443             SDL_Rect full_rect;
  2444             const SDL_Rect *rect;
  2445 
  2446             full_rect.x = 0;
  2447             full_rect.y = 0;
  2448             full_rect.w = window->w;
  2449             full_rect.h = window->h;
  2450             rect = &full_rect;
  2451             return renderer->RenderDrawRects(renderer, &rect, 1);
  2452         }
  2453     }
  2454     return renderer->RenderDrawRects(renderer, rects, count);
  2455 }
  2456 
  2457 int
  2458 SDL_RenderFillRect(const SDL_Rect * rect)
  2459 {
  2460     return SDL_RenderFillRects(&rect, 1);
  2461 }
  2462 
  2463 int
  2464 SDL_RenderFillRects(const SDL_Rect ** rects, int count)
  2465 {
  2466     SDL_Renderer *renderer;
  2467     int i;
  2468 
  2469     if (!rects) {
  2470         SDL_SetError("SDL_RenderFillRects(): Passed NULL rects");
  2471         return -1;
  2472     }
  2473 
  2474     renderer = SDL_GetCurrentRenderer(SDL_TRUE);
  2475     if (!renderer) {
  2476         return -1;
  2477     }
  2478     if (!renderer->RenderFillRects) {
  2479         SDL_Unsupported();
  2480         return -1;
  2481     }
  2482     if (count < 1) {
  2483         return 0;
  2484     }
  2485     /* Check for NULL rect, which means fill entire window */
  2486     for (i = 0; i < count; ++i) {
  2487         if (rects[i] == NULL) {
  2488             SDL_Window *window = renderer->window;
  2489             SDL_Rect full_rect;
  2490             const SDL_Rect *rect;
  2491 
  2492             full_rect.x = 0;
  2493             full_rect.y = 0;
  2494             full_rect.w = window->w;
  2495             full_rect.h = window->h;
  2496             rect = &full_rect;
  2497             return renderer->RenderFillRects(renderer, &rect, 1);
  2498         }
  2499     }
  2500     return renderer->RenderFillRects(renderer, rects, count);
  2501 }
  2502 
  2503 int
  2504 SDL_RenderCopy(SDL_Texture * texture, const SDL_Rect * srcrect,
  2505                const SDL_Rect * dstrect)
  2506 {
  2507     SDL_Renderer *renderer;
  2508     SDL_Window *window;
  2509     SDL_Rect real_srcrect;
  2510     SDL_Rect real_dstrect;
  2511 
  2512     CHECK_TEXTURE_MAGIC(texture, -1);
  2513 
  2514     renderer = SDL_GetCurrentRenderer(SDL_TRUE);
  2515     if (!renderer) {
  2516         return -1;
  2517     }
  2518     if (texture->renderer != renderer) {
  2519         SDL_SetError("Texture was not created with this renderer");
  2520         return -1;
  2521     }
  2522     if (!renderer->RenderCopy) {
  2523         SDL_Unsupported();
  2524         return -1;
  2525     }
  2526     window = renderer->window;
  2527 
  2528     real_srcrect.x = 0;
  2529     real_srcrect.y = 0;
  2530     real_srcrect.w = texture->w;
  2531     real_srcrect.h = texture->h;
  2532     if (srcrect) {
  2533         if (!SDL_IntersectRect(srcrect, &real_srcrect, &real_srcrect)) {
  2534             return 0;
  2535         }
  2536     }
  2537 
  2538     real_dstrect.x = 0;
  2539     real_dstrect.y = 0;
  2540     real_dstrect.w = window->w;
  2541     real_dstrect.h = window->h;
  2542     if (dstrect) {
  2543         if (!SDL_IntersectRect(dstrect, &real_dstrect, &real_dstrect)) {
  2544             return 0;
  2545         }
  2546         /* Clip srcrect by the same amount as dstrect was clipped */
  2547         if (dstrect->w != real_dstrect.w) {
  2548             int deltax = (real_dstrect.x - dstrect->x);
  2549             int deltaw = (real_dstrect.w - dstrect->w);
  2550             real_srcrect.x += (deltax * real_srcrect.w) / dstrect->w;
  2551             real_srcrect.w += (deltaw * real_srcrect.w) / dstrect->w;
  2552         }
  2553         if (dstrect->h != real_dstrect.h) {
  2554             int deltay = (real_dstrect.y - dstrect->y);
  2555             int deltah = (real_dstrect.h - dstrect->h);
  2556             real_srcrect.y += (deltay * real_srcrect.h) / dstrect->h;
  2557             real_srcrect.h += (deltah * real_srcrect.h) / dstrect->h;
  2558         }
  2559     }
  2560 
  2561     return renderer->RenderCopy(renderer, texture, &real_srcrect,
  2562                                 &real_dstrect);
  2563 }
  2564 
  2565 int
  2566 SDL_RenderReadPixels(const SDL_Rect * rect, Uint32 format,
  2567                      void * pixels, int pitch)
  2568 {
  2569     SDL_Renderer *renderer;
  2570     SDL_Window *window;
  2571     SDL_Rect real_rect;
  2572 
  2573     renderer = SDL_GetCurrentRenderer(SDL_TRUE);
  2574     if (!renderer) {
  2575         return -1;
  2576     }
  2577     if (!renderer->RenderReadPixels) {
  2578         SDL_Unsupported();
  2579         return -1;
  2580     }
  2581     window = renderer->window;
  2582 
  2583     if (!format) {
  2584         format = window->display->current_mode.format;
  2585     }
  2586 
  2587     real_rect.x = 0;
  2588     real_rect.y = 0;
  2589     real_rect.w = window->w;
  2590     real_rect.h = window->h;
  2591     if (rect) {
  2592         if (!SDL_IntersectRect(rect, &real_rect, &real_rect)) {
  2593             return 0;
  2594         }
  2595         if (real_rect.y > rect->y) {
  2596             pixels = (Uint8 *)pixels + pitch * (real_rect.y - rect->y);
  2597         }
  2598         if (real_rect.x > rect->x) {
  2599             Uint32 format = SDL_CurrentDisplay->current_mode.format;
  2600             int bpp = SDL_BYTESPERPIXEL(format);
  2601             pixels = (Uint8 *)pixels + bpp * (real_rect.x - rect->x);
  2602         }
  2603     }
  2604 
  2605     return renderer->RenderReadPixels(renderer, &real_rect,
  2606                                       format, pixels, pitch);
  2607 }
  2608 
  2609 int
  2610 SDL_RenderWritePixels(const SDL_Rect * rect, Uint32 format,
  2611                       const void * pixels, int pitch)
  2612 {
  2613     SDL_Renderer *renderer;
  2614     SDL_Window *window;
  2615     SDL_Rect real_rect;
  2616 
  2617     renderer = SDL_GetCurrentRenderer(SDL_TRUE);
  2618     if (!renderer) {
  2619         return -1;
  2620     }
  2621     if (!renderer->RenderWritePixels) {
  2622         SDL_Unsupported();
  2623         return -1;
  2624     }
  2625     window = renderer->window;
  2626 
  2627     if (!format) {
  2628         format = window->display->current_mode.format;
  2629     }
  2630 
  2631     real_rect.x = 0;
  2632     real_rect.y = 0;
  2633     real_rect.w = window->w;
  2634     real_rect.h = window->h;
  2635     if (rect) {
  2636         if (!SDL_IntersectRect(rect, &real_rect, &real_rect)) {
  2637             return 0;
  2638         }
  2639         if (real_rect.y > rect->y) {
  2640             pixels = (const Uint8 *)pixels + pitch * (real_rect.y - rect->y);
  2641         }
  2642         if (real_rect.x > rect->x) {
  2643             Uint32 format = SDL_CurrentDisplay->current_mode.format;
  2644             int bpp = SDL_BYTESPERPIXEL(format);
  2645             pixels = (const Uint8 *)pixels + bpp * (real_rect.x - rect->x);
  2646         }
  2647     }
  2648 
  2649     return renderer->RenderWritePixels(renderer, &real_rect,
  2650                                        format, pixels, pitch);
  2651 }
  2652 
  2653 void
  2654 SDL_RenderPresent(void)
  2655 {
  2656     SDL_Renderer *renderer;
  2657 
  2658     renderer = SDL_GetCurrentRenderer(SDL_TRUE);
  2659     if (!renderer || !renderer->RenderPresent) {
  2660         return;
  2661     }
  2662 #if SDL_VIDEO_DRIVER_WINDOWS
  2663     IME_Present((SDL_VideoData *)_this->driverdata);
  2664 #endif
  2665     renderer->RenderPresent(renderer);
  2666 }
  2667 
  2668 void
  2669 SDL_DestroyTexture(SDL_Texture * texture)
  2670 {
  2671     SDL_Renderer *renderer;
  2672 
  2673     CHECK_TEXTURE_MAGIC(texture, );
  2674     texture->magic = NULL;
  2675 
  2676     renderer = texture->renderer;
  2677     if (texture->next) {
  2678         texture->next->prev = texture->prev;
  2679     }
  2680     if (texture->prev) {
  2681         texture->prev->next = texture->next;
  2682     } else {
  2683         renderer->textures = texture->next;
  2684     }
  2685 
  2686     renderer->DestroyTexture(renderer, texture);
  2687     SDL_free(texture);
  2688 }
  2689 
  2690 void
  2691 SDL_DestroyRenderer(SDL_Window * window)
  2692 {
  2693     SDL_Renderer *renderer;
  2694 
  2695     CHECK_WINDOW_MAGIC(window, );
  2696 
  2697     renderer = window->renderer;
  2698     if (!renderer) {
  2699         return;
  2700     }
  2701 
  2702     /* Free existing textures for this renderer */
  2703     while (renderer->textures) {
  2704         SDL_DestroyTexture(renderer->textures);
  2705     }
  2706 
  2707     /* Free the renderer instance */
  2708     renderer->DestroyRenderer(renderer);
  2709 
  2710     /* Clear references */
  2711     window->renderer = NULL;
  2712     if (SDL_CurrentDisplay->current_renderer == renderer) {
  2713         SDL_CurrentDisplay->current_renderer = NULL;
  2714     }
  2715 }
  2716 
  2717 SDL_bool
  2718 SDL_IsScreenSaverEnabled()
  2719 {
  2720     if (!_this) {
  2721         return SDL_TRUE;
  2722     }
  2723     return _this->suspend_screensaver ? SDL_FALSE : SDL_TRUE;
  2724 }
  2725 
  2726 void
  2727 SDL_EnableScreenSaver()
  2728 {
  2729     if (!_this) {
  2730         return;
  2731     }
  2732     if (!_this->suspend_screensaver) {
  2733         return;
  2734     }
  2735     _this->suspend_screensaver = SDL_FALSE;
  2736     if (_this->SuspendScreenSaver) {
  2737         _this->SuspendScreenSaver(_this);
  2738     }
  2739 }
  2740 
  2741 void
  2742 SDL_DisableScreenSaver()
  2743 {
  2744     if (!_this) {
  2745         return;
  2746     }
  2747     if (_this->suspend_screensaver) {
  2748         return;
  2749     }
  2750     _this->suspend_screensaver = SDL_TRUE;
  2751     if (_this->SuspendScreenSaver) {
  2752         _this->SuspendScreenSaver(_this);
  2753     }
  2754 }
  2755 
  2756 void
  2757 SDL_VideoQuit(void)
  2758 {
  2759     int i, j;
  2760 
  2761     if (!_this) {
  2762         return;
  2763     }
  2764 
  2765     /* Halt event processing before doing anything else */
  2766     SDL_QuitQuit();
  2767     SDL_MouseQuit();
  2768     SDL_KeyboardQuit();
  2769     SDL_StopEventLoop();
  2770 
  2771     SDL_EnableScreenSaver();
  2772 
  2773     /* Clean up the system video */
  2774     for (i = _this->num_displays; i--;) {
  2775         SDL_VideoDisplay *display = &_this->displays[i];
  2776         while (display->windows) {
  2777             SDL_DestroyWindow(display->windows);
  2778         }
  2779         if (display->render_drivers) {
  2780             SDL_free(display->render_drivers);
  2781             display->render_drivers = NULL;
  2782         }
  2783         display->num_render_drivers = 0;
  2784     }
  2785     _this->VideoQuit(_this);
  2786 
  2787     for (i = _this->num_displays; i--;) {
  2788         SDL_VideoDisplay *display = &_this->displays[i];
  2789         for (j = display->num_display_modes; j--;) {
  2790             if (display->display_modes[j].driverdata) {
  2791                 SDL_free(display->display_modes[j].driverdata);
  2792                 display->display_modes[j].driverdata = NULL;
  2793             }
  2794         }
  2795         if (display->display_modes) {
  2796             SDL_free(display->display_modes);
  2797             display->display_modes = NULL;
  2798         }
  2799         if (display->desktop_mode.driverdata) {
  2800             SDL_free(display->desktop_mode.driverdata);
  2801             display->desktop_mode.driverdata = NULL;
  2802         }
  2803         if (display->palette) {
  2804             SDL_FreePalette(display->palette);
  2805             display->palette = NULL;
  2806         }
  2807         if (display->gamma) {
  2808             SDL_free(display->gamma);
  2809             display->gamma = NULL;
  2810         }
  2811         if (display->driverdata) {
  2812             SDL_free(display->driverdata);
  2813             display->driverdata = NULL;
  2814         }
  2815     }
  2816     if (_this->displays) {
  2817         SDL_free(_this->displays);
  2818         _this->displays = NULL;
  2819     }
  2820     if (_this->clipboard_text) {
  2821         SDL_free(_this->clipboard_text);
  2822         _this->clipboard_text = NULL;
  2823     }
  2824     _this->free(_this);
  2825     _this = NULL;
  2826 }
  2827 
  2828 int
  2829 SDL_GL_LoadLibrary(const char *path)
  2830 {
  2831     int retval;
  2832 
  2833     if (!_this) {
  2834         SDL_UninitializedVideo();
  2835         return -1;
  2836     }
  2837     if (_this->gl_config.driver_loaded) {
  2838         if (path && SDL_strcmp(path, _this->gl_config.driver_path) != 0) {
  2839             SDL_SetError("OpenGL library already loaded");
  2840             return -1;
  2841         }
  2842         retval = 0;
  2843     } else {
  2844         if (!_this->GL_LoadLibrary) {
  2845             SDL_SetError("No dynamic GL support in video driver");
  2846             return -1;
  2847         }
  2848         retval = _this->GL_LoadLibrary(_this, path);
  2849     }
  2850     if (retval == 0) {
  2851         ++_this->gl_config.driver_loaded;
  2852     }
  2853     return (retval);
  2854 }
  2855 
  2856 void *
  2857 SDL_GL_GetProcAddress(const char *proc)
  2858 {
  2859     void *func;
  2860 
  2861     if (!_this) {
  2862         SDL_UninitializedVideo();
  2863         return NULL;
  2864     }
  2865     func = NULL;
  2866     if (_this->GL_GetProcAddress) {
  2867         if (_this->gl_config.driver_loaded) {
  2868             func = _this->GL_GetProcAddress(_this, proc);
  2869         } else {
  2870             SDL_SetError("No GL driver has been loaded");
  2871         }
  2872     } else {
  2873         SDL_SetError("No dynamic GL support in video driver");
  2874     }
  2875     return func;
  2876 }
  2877 
  2878 void
  2879 SDL_GL_UnloadLibrary(void)
  2880 {
  2881     if (!_this) {
  2882         SDL_UninitializedVideo();
  2883         return;
  2884     }
  2885     if (_this->gl_config.driver_loaded > 0) {
  2886         if (--_this->gl_config.driver_loaded > 0) {
  2887             return;
  2888         }
  2889         if (_this->GL_UnloadLibrary) {
  2890             _this->GL_UnloadLibrary(_this);
  2891         }
  2892     }
  2893 }
  2894 
  2895 SDL_bool
  2896 SDL_GL_ExtensionSupported(const char *extension)
  2897 {
  2898 #if SDL_VIDEO_OPENGL || SDL_VIDEO_OPENGL_ES
  2899     const GLubyte *(APIENTRY * glGetStringFunc) (GLenum);
  2900     const char *extensions;
  2901     const char *start;
  2902     const char *where, *terminator;
  2903 
  2904     /* Extension names should not have spaces. */
  2905     where = SDL_strchr(extension, ' ');
  2906     if (where || *extension == '\0') {
  2907         return SDL_FALSE;
  2908     }
  2909     /* See if there's an environment variable override */
  2910     start = SDL_getenv(extension);
  2911     if (start && *start == '0') {
  2912         return SDL_FALSE;
  2913     }
  2914     /* Lookup the available extensions */
  2915     glGetStringFunc = SDL_GL_GetProcAddress("glGetString");
  2916     if (glGetStringFunc) {
  2917         extensions = (const char *) glGetStringFunc(GL_EXTENSIONS);
  2918     } else {
  2919         extensions = NULL;
  2920     }
  2921     if (!extensions) {
  2922         return SDL_FALSE;
  2923     }
  2924     /*
  2925      * It takes a bit of care to be fool-proof about parsing the OpenGL
  2926      * extensions string. Don't be fooled by sub-strings, etc.
  2927      */
  2928 
  2929     start = extensions;
  2930 
  2931     for (;;) {
  2932         where = SDL_strstr(start, extension);
  2933         if (!where)
  2934             break;
  2935 
  2936         terminator = where + SDL_strlen(extension);
  2937         if (where == start || *(where - 1) == ' ')
  2938             if (*terminator == ' ' || *terminator == '\0')
  2939                 return SDL_TRUE;
  2940 
  2941         start = terminator;
  2942     }
  2943     return SDL_FALSE;
  2944 #else
  2945     return SDL_FALSE;
  2946 #endif
  2947 }
  2948 
  2949 int
  2950 SDL_GL_SetAttribute(SDL_GLattr attr, int value)
  2951 {
  2952 #if SDL_VIDEO_OPENGL || SDL_VIDEO_OPENGL_ES
  2953     int retval;
  2954 
  2955     if (!_this) {
  2956         SDL_UninitializedVideo();
  2957         return -1;
  2958     }
  2959     retval = 0;
  2960     switch (attr) {
  2961     case SDL_GL_RED_SIZE:
  2962         _this->gl_config.red_size = value;
  2963         break;
  2964     case SDL_GL_GREEN_SIZE:
  2965         _this->gl_config.green_size = value;
  2966         break;
  2967     case SDL_GL_BLUE_SIZE:
  2968         _this->gl_config.blue_size = value;
  2969         break;
  2970     case SDL_GL_ALPHA_SIZE:
  2971         _this->gl_config.alpha_size = value;
  2972         break;
  2973     case SDL_GL_DOUBLEBUFFER:
  2974         _this->gl_config.double_buffer = value;
  2975         break;
  2976     case SDL_GL_BUFFER_SIZE:
  2977         _this->gl_config.buffer_size = value;
  2978         break;
  2979     case SDL_GL_DEPTH_SIZE:
  2980         _this->gl_config.depth_size = value;
  2981         break;
  2982     case SDL_GL_STENCIL_SIZE:
  2983         _this->gl_config.stencil_size = value;
  2984         break;
  2985     case SDL_GL_ACCUM_RED_SIZE:
  2986         _this->gl_config.accum_red_size = value;
  2987         break;
  2988     case SDL_GL_ACCUM_GREEN_SIZE:
  2989         _this->gl_config.accum_green_size = value;
  2990         break;
  2991     case SDL_GL_ACCUM_BLUE_SIZE:
  2992         _this->gl_config.accum_blue_size = value;
  2993         break;
  2994     case SDL_GL_ACCUM_ALPHA_SIZE:
  2995         _this->gl_config.accum_alpha_size = value;
  2996         break;
  2997     case SDL_GL_STEREO:
  2998         _this->gl_config.stereo = value;
  2999         break;
  3000     case SDL_GL_MULTISAMPLEBUFFERS:
  3001         _this->gl_config.multisamplebuffers = value;
  3002         break;
  3003     case SDL_GL_MULTISAMPLESAMPLES:
  3004         _this->gl_config.multisamplesamples = value;
  3005         break;
  3006     case SDL_GL_ACCELERATED_VISUAL:
  3007         _this->gl_config.accelerated = value;
  3008         break;
  3009     case SDL_GL_RETAINED_BACKING:
  3010         _this->gl_config.retained_backing = value;
  3011         break;
  3012     case SDL_GL_CONTEXT_MAJOR_VERSION:
  3013         _this->gl_config.major_version = value;
  3014         break;
  3015     case SDL_GL_CONTEXT_MINOR_VERSION:
  3016         _this->gl_config.minor_version = value;
  3017         break;
  3018     default:
  3019         SDL_SetError("Unknown OpenGL attribute");
  3020         retval = -1;
  3021         break;
  3022     }
  3023     return retval;
  3024 #else
  3025     SDL_Unsupported();
  3026     return -1;
  3027 #endif /* SDL_VIDEO_OPENGL */
  3028 }
  3029 
  3030 int
  3031 SDL_GL_GetAttribute(SDL_GLattr attr, int *value)
  3032 {
  3033 #if SDL_VIDEO_OPENGL || SDL_VIDEO_OPENGL_ES
  3034     void (APIENTRY * glGetIntegervFunc) (GLenum pname, GLint * params);
  3035     GLenum(APIENTRY * glGetErrorFunc) (void);
  3036     GLenum attrib = 0;
  3037     GLenum error = 0;
  3038 
  3039     glGetIntegervFunc = SDL_GL_GetProcAddress("glGetIntegerv");
  3040     if (!glGetIntegervFunc) {
  3041         return -1;
  3042     }
  3043 
  3044     glGetErrorFunc = SDL_GL_GetProcAddress("glGetError");
  3045     if (!glGetErrorFunc) {
  3046         return -1;
  3047     }
  3048 
  3049     /* Clear value in any case */
  3050     *value = 0;
  3051 
  3052     switch (attr) {
  3053     case SDL_GL_RETAINED_BACKING:
  3054         *value = _this->gl_config.retained_backing;
  3055         return 0;
  3056     case SDL_GL_RED_SIZE:
  3057         attrib = GL_RED_BITS;
  3058         break;
  3059     case SDL_GL_BLUE_SIZE:
  3060         attrib = GL_BLUE_BITS;
  3061         break;
  3062     case SDL_GL_GREEN_SIZE:
  3063         attrib = GL_GREEN_BITS;
  3064         break;
  3065     case SDL_GL_ALPHA_SIZE:
  3066         attrib = GL_ALPHA_BITS;
  3067         break;
  3068     case SDL_GL_DOUBLEBUFFER:
  3069 #ifndef SDL_VIDEO_OPENGL_ES
  3070         attrib = GL_DOUBLEBUFFER;
  3071         break;
  3072 #else
  3073         /* OpenGL ES 1.0 and above specifications have EGL_SINGLE_BUFFER      */
  3074         /* parameter which switches double buffer to single buffer. OpenGL ES */
  3075         /* SDL driver must set proper value after initialization              */
  3076         *value = _this->gl_config.double_buffer;
  3077         return 0;
  3078 #endif
  3079     case SDL_GL_DEPTH_SIZE:
  3080         attrib = GL_DEPTH_BITS;
  3081         break;
  3082     case SDL_GL_STENCIL_SIZE:
  3083         attrib = GL_STENCIL_BITS;
  3084         break;
  3085 #ifndef SDL_VIDEO_OPENGL_ES
  3086     case SDL_GL_ACCUM_RED_SIZE:
  3087         attrib = GL_ACCUM_RED_BITS;
  3088         break;
  3089     case SDL_GL_ACCUM_GREEN_SIZE:
  3090         attrib = GL_ACCUM_GREEN_BITS;
  3091         break;
  3092     case SDL_GL_ACCUM_BLUE_SIZE:
  3093         attrib = GL_ACCUM_BLUE_BITS;
  3094         break;
  3095     case SDL_GL_ACCUM_ALPHA_SIZE:
  3096         attrib = GL_ACCUM_ALPHA_BITS;
  3097         break;
  3098     case SDL_GL_STEREO:
  3099         attrib = GL_STEREO;
  3100         break;
  3101 #else
  3102     case SDL_GL_ACCUM_RED_SIZE:
  3103     case SDL_GL_ACCUM_GREEN_SIZE:
  3104     case SDL_GL_ACCUM_BLUE_SIZE:
  3105     case SDL_GL_ACCUM_ALPHA_SIZE:
  3106     case SDL_GL_STEREO:
  3107         /* none of these are supported in OpenGL ES */
  3108         *value = 0;
  3109         return 0;
  3110 #endif
  3111     case SDL_GL_MULTISAMPLEBUFFERS:
  3112 #ifndef SDL_VIDEO_OPENGL_ES
  3113         attrib = GL_SAMPLE_BUFFERS_ARB;
  3114 #else
  3115         attrib = GL_SAMPLE_BUFFERS;
  3116 #endif
  3117         break;
  3118     case SDL_GL_MULTISAMPLESAMPLES:
  3119 #ifndef SDL_VIDEO_OPENGL_ES
  3120         attrib = GL_SAMPLES_ARB;
  3121 #else
  3122         attrib = GL_SAMPLES;
  3123 #endif
  3124         break;
  3125     case SDL_GL_BUFFER_SIZE:
  3126         {
  3127             GLint bits = 0;
  3128             GLint component;
  3129 
  3130             /*
  3131              * there doesn't seem to be a single flag in OpenGL
  3132              * for this!
  3133              */
  3134             glGetIntegervFunc(GL_RED_BITS, &component);
  3135             bits += component;
  3136             glGetIntegervFunc(GL_GREEN_BITS, &component);
  3137             bits += component;
  3138             glGetIntegervFunc(GL_BLUE_BITS, &component);
  3139             bits += component;
  3140             glGetIntegervFunc(GL_ALPHA_BITS, &component);
  3141             bits += component;
  3142 
  3143             *value = bits;
  3144             return 0;
  3145         }
  3146     case SDL_GL_ACCELERATED_VISUAL:
  3147         {
  3148             /* FIXME: How do we get this information? */
  3149             *value = (_this->gl_config.accelerated != 0);
  3150             return 0;
  3151         }
  3152     default:
  3153         SDL_SetError("Unknown OpenGL attribute");
  3154         return -1;
  3155     }
  3156 
  3157     glGetIntegervFunc(attrib, (GLint *) value);
  3158     error = glGetErrorFunc();
  3159     if (error != GL_NO_ERROR) {
  3160         switch (error) {
  3161         case GL_INVALID_ENUM:
  3162             {
  3163                 SDL_SetError("OpenGL error: GL_INVALID_ENUM");
  3164             }
  3165             break;
  3166         case GL_INVALID_VALUE:
  3167             {
  3168                 SDL_SetError("OpenGL error: GL_INVALID_VALUE");
  3169             }
  3170             break;
  3171         default:
  3172             {
  3173                 SDL_SetError("OpenGL error: %08X", error);
  3174             }
  3175             break;
  3176         }
  3177         return -1;
  3178     }
  3179     return 0;
  3180 #else
  3181     SDL_Unsupported();
  3182     return -1;
  3183 #endif /* SDL_VIDEO_OPENGL */
  3184 }
  3185 
  3186 SDL_GLContext
  3187 SDL_GL_CreateContext(SDL_Window * window)
  3188 {
  3189     CHECK_WINDOW_MAGIC(window, NULL);
  3190 
  3191     if (!(window->flags & SDL_WINDOW_OPENGL)) {
  3192         SDL_SetError("The specified window isn't an OpenGL window");
  3193         return NULL;
  3194     }
  3195     return _this->GL_CreateContext(_this, window);
  3196 }
  3197 
  3198 int
  3199 SDL_GL_MakeCurrent(SDL_Window * window, SDL_GLContext context)
  3200 {
  3201     CHECK_WINDOW_MAGIC(window, -1);
  3202 
  3203     if (!(window->flags & SDL_WINDOW_OPENGL)) {
  3204         SDL_SetError("The specified window isn't an OpenGL window");
  3205         return -1;
  3206     }
  3207     if (!context) {
  3208         window = NULL;
  3209     }
  3210     return _this->GL_MakeCurrent(_this, window, context);
  3211 }
  3212 
  3213 int
  3214 SDL_GL_SetSwapInterval(int interval)
  3215 {
  3216     if (!_this) {
  3217         SDL_UninitializedVideo();
  3218         return -1;
  3219     }
  3220     if (_this->GL_SetSwapInterval) {
  3221         return _this->GL_SetSwapInterval(_this, interval);
  3222     } else {
  3223         SDL_SetError("Setting the swap interval is not supported");
  3224         return -1;
  3225     }
  3226 }
  3227 
  3228 int
  3229 SDL_GL_GetSwapInterval(void)
  3230 {
  3231     if (!_this) {
  3232         SDL_UninitializedVideo();
  3233         return -1;
  3234     }
  3235     if (_this->GL_GetSwapInterval) {
  3236         return _this->GL_GetSwapInterval(_this);
  3237     } else {
  3238         SDL_SetError("Getting the swap interval is not supported");
  3239         return -1;
  3240     }
  3241 }
  3242 
  3243 void
  3244 SDL_GL_SwapWindow(SDL_Window * window)
  3245 {
  3246     CHECK_WINDOW_MAGIC(window, );
  3247 
  3248     if (!(window->flags & SDL_WINDOW_OPENGL)) {
  3249         SDL_SetError("The specified window isn't an OpenGL window");
  3250         return;
  3251     }
  3252     _this->GL_SwapWindow(_this, window);
  3253 }
  3254 
  3255 void
  3256 SDL_GL_DeleteContext(SDL_GLContext context)
  3257 {
  3258     if (!_this || !_this->gl_data || !context) {
  3259         return;
  3260     }
  3261     _this->GL_MakeCurrent(_this, NULL, NULL);
  3262     _this->GL_DeleteContext(_this, context);
  3263 }
  3264 
  3265 #if 0                           // FIXME
  3266 /*
  3267  * Utility function used by SDL_WM_SetIcon(); flags & 1 for color key, flags
  3268  * & 2 for alpha channel.
  3269  */
  3270 static void
  3271 CreateMaskFromColorKeyOrAlpha(SDL_Surface * icon, Uint8 * mask, int flags)
  3272 {
  3273     int x, y;
  3274     Uint32 colorkey;
  3275 #define SET_MASKBIT(icon, x, y, mask) \
  3276 	mask[(y*((icon->w+7)/8))+(x/8)] &= ~(0x01<<(7-(x%8)))
  3277 
  3278     colorkey = icon->format->colorkey;
  3279     switch (icon->format->BytesPerPixel) {
  3280     case 1:
  3281         {
  3282             Uint8 *pixels;
  3283             for (y = 0; y < icon->h; ++y) {
  3284                 pixels = (Uint8 *) icon->pixels + y * icon->pitch;
  3285                 for (x = 0; x < icon->w; ++x) {
  3286                     if (*pixels++ == colorkey) {
  3287                         SET_MASKBIT(icon, x, y, mask);
  3288                     }
  3289                 }
  3290             }
  3291         }
  3292         break;
  3293 
  3294     case 2:
  3295         {
  3296             Uint16 *pixels;
  3297             for (y = 0; y < icon->h; ++y) {
  3298                 pixels = (Uint16 *) icon->pixels + y * icon->pitch / 2;
  3299                 for (x = 0; x < icon->w; ++x) {
  3300                     if ((flags & 1) && *pixels == colorkey) {
  3301                         SET_MASKBIT(icon, x, y, mask);
  3302                     } else if ((flags & 2)
  3303                                && (*pixels & icon->format->Amask) == 0) {
  3304                         SET_MASKBIT(icon, x, y, mask);
  3305                     }
  3306                     pixels++;
  3307                 }
  3308             }
  3309         }
  3310         break;
  3311 
  3312     case 4:
  3313         {
  3314             Uint32 *pixels;
  3315             for (y = 0; y < icon->h; ++y) {
  3316                 pixels = (Uint32 *) icon->pixels + y * icon->pitch / 4;
  3317                 for (x = 0; x < icon->w; ++x) {
  3318                     if ((flags & 1) && *pixels == colorkey) {
  3319                         SET_MASKBIT(icon, x, y, mask);
  3320                     } else if ((flags & 2)
  3321                                && (*pixels & icon->format->Amask) == 0) {
  3322                         SET_MASKBIT(icon, x, y, mask);
  3323                     }
  3324                     pixels++;
  3325                 }
  3326             }
  3327         }
  3328         break;
  3329     }
  3330 }
  3331 
  3332 /*
  3333  * Sets the window manager icon for the display window.
  3334  */
  3335 void
  3336 SDL_WM_SetIcon(SDL_Surface * icon, Uint8 * mask)
  3337 {
  3338     if (icon && _this->SetIcon) {
  3339         /* Generate a mask if necessary, and create the icon! */
  3340         if (mask == NULL) {
  3341             int mask_len = icon->h * (icon->w + 7) / 8;
  3342             int flags = 0;
  3343             mask = (Uint8 *) SDL_malloc(mask_len);
  3344             if (mask == NULL) {
  3345                 return;
  3346             }
  3347             SDL_memset(mask, ~0, mask_len);
  3348             if (icon->flags & SDL_SRCCOLORKEY)
  3349                 flags |= 1;
  3350             if (icon->flags & SDL_SRCALPHA)
  3351                 flags |= 2;
  3352             if (flags) {
  3353                 CreateMaskFromColorKeyOrAlpha(icon, mask, flags);
  3354             }
  3355             _this->SetIcon(_this, icon, mask);
  3356             SDL_free(mask);
  3357         } else {
  3358             _this->SetIcon(_this, icon, mask);
  3359         }
  3360     }
  3361 }
  3362 #endif
  3363 
  3364 SDL_bool
  3365 SDL_GetWindowWMInfo(SDL_Window * window, struct SDL_SysWMinfo *info)
  3366 {
  3367     CHECK_WINDOW_MAGIC(window, SDL_FALSE);
  3368 
  3369     if (!info) {
  3370         return SDL_FALSE;
  3371     }
  3372     info->subsystem = SDL_SYSWM_UNKNOWN;
  3373 
  3374     if (!_this->GetWindowWMInfo) {
  3375         return SDL_FALSE;
  3376     }
  3377     return (_this->GetWindowWMInfo(_this, window, info));
  3378 }
  3379 
  3380 void
  3381 SDL_StartTextInput(void)
  3382 {
  3383     if (_this && _this->StartTextInput) {
  3384         _this->StartTextInput(_this);
  3385     }
  3386     SDL_EventState(SDL_TEXTINPUT, SDL_ENABLE);
  3387     SDL_EventState(SDL_TEXTEDITING, SDL_ENABLE);
  3388 }
  3389 
  3390 void
  3391 SDL_StopTextInput(void)
  3392 {
  3393     if (_this && _this->StopTextInput) {
  3394         _this->StopTextInput(_this);
  3395     }
  3396     SDL_EventState(SDL_TEXTINPUT, SDL_DISABLE);
  3397     SDL_EventState(SDL_TEXTEDITING, SDL_DISABLE);
  3398 }
  3399 
  3400 void
  3401 SDL_SetTextInputRect(SDL_Rect *rect)
  3402 {
  3403     if (_this && _this->SetTextInputRect) {
  3404         _this->SetTextInputRect(_this, rect);
  3405     }
  3406 }
  3407 
  3408 /* vi: set ts=4 sw=4 expandtab: */