src/video/SDL_video.c
author Sam Lantinga <slouken@libsdl.org>
Tue, 24 Nov 2009 16:43:18 +0000
changeset 3488 3d2f42580488
parent 3486 c87dbbde2bc2
child 3489 e1bd98b56e94
permissions -rw-r--r--
Fixed bug #771

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