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