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