SDL_GetVideoMode, part 3: pixel count compare was failing when only 1 video mode was present
2 SDL - Simple DirectMedia Layer
3 Copyright (C) 1997-2004 Sam Lantinga
5 This library is free software; you can redistribute it and/or
6 modify it under the terms of the GNU Library General Public
7 License as published by the Free Software Foundation; either
8 version 2 of the License, or (at your option) any later version.
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 Library General Public License for more details.
15 You should have received a copy of the GNU Library General Public
16 License along with this library; if not, write to the Free
17 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
28 /* The high-level video driver subsystem */
35 #include "SDL_error.h"
36 #include "SDL_video.h"
37 #include "SDL_events.h"
38 #include "SDL_mutex.h"
39 #include "SDL_sysvideo.h"
40 #include "SDL_sysevents.h"
42 #include "SDL_pixels_c.h"
43 #include "SDL_events_c.h"
44 #include "SDL_cursor_c.h"
46 /* Available video drivers */
47 static VideoBootStrap *bootstrap[] = {
72 #ifdef ENABLE_DIRECTFB
102 #ifdef ENABLE_TOOLBOX
105 #ifdef ENABLE_DRAWSPROCKET
108 #ifdef ENABLE_CYBERGRAPHICS
123 #ifdef ENABLE_PICOGUI
135 #ifdef ENABLE_DUMMYVIDEO
141 SDL_VideoDevice *current_video = NULL;
143 /* Various local functions */
144 int SDL_VideoInit(const char *driver_name, Uint32 flags);
145 void SDL_VideoQuit(void);
146 void SDL_GL_UpdateRectsLock(SDL_VideoDevice* this, int numrects, SDL_Rect* rects);
148 static SDL_GrabMode SDL_WM_GrabInputOff(void);
150 static int lock_count = 0;
155 * Initialize the video and event subsystems -- determine native pixel format
157 int SDL_VideoInit (const char *driver_name, Uint32 flags)
159 SDL_VideoDevice *video;
162 SDL_PixelFormat vformat;
165 /* Toggle the event thread flags, based on OS requirements */
166 #if defined(MUST_THREAD_EVENTS)
167 flags |= SDL_INIT_EVENTTHREAD;
168 #elif defined(CANT_THREAD_EVENTS)
169 if ( (flags & SDL_INIT_EVENTTHREAD) == SDL_INIT_EVENTTHREAD ) {
170 SDL_SetError("OS doesn't support threaded events");
175 /* Check to make sure we don't overwrite 'current_video' */
176 if ( current_video != NULL ) {
180 /* Select the proper video driver */
183 if ( driver_name != NULL ) {
184 #if 0 /* This will be replaced with a better driver selection API */
185 if ( strrchr(driver_name, ':') != NULL ) {
186 index = atoi(strrchr(driver_name, ':')+1);
189 for ( i=0; bootstrap[i]; ++i ) {
190 if ( strncmp(bootstrap[i]->name, driver_name,
191 strlen(bootstrap[i]->name)) == 0 ) {
192 if ( bootstrap[i]->available() ) {
193 video = bootstrap[i]->create(index);
199 for ( i=0; bootstrap[i]; ++i ) {
200 if ( bootstrap[i]->available() ) {
201 video = bootstrap[i]->create(index);
202 if ( video != NULL ) {
208 if ( video == NULL ) {
209 SDL_SetError("No available video device");
212 current_video = video;
213 current_video->name = bootstrap[i]->name;
215 /* Do some basic variable initialization */
216 video->screen = NULL;
217 video->shadow = NULL;
218 video->visible = NULL;
219 video->physpal = NULL;
220 video->gammacols = NULL;
222 video->wm_title = NULL;
223 video->wm_icon = NULL;
226 memset(&video->info, 0, (sizeof video->info));
228 video->displayformatalphapixel = NULL;
230 /* Set some very sane GL defaults */
231 video->gl_config.driver_loaded = 0;
232 video->gl_config.dll_handle = NULL;
233 video->gl_config.red_size = 5;
234 #if 1 /* This seems to work on more video cards, as a default */
235 video->gl_config.green_size = 5;
237 video->gl_config.green_size = 6;
239 video->gl_config.blue_size = 5;
240 video->gl_config.alpha_size = 0;
241 video->gl_config.buffer_size = 0;
242 video->gl_config.depth_size = 16;
243 video->gl_config.stencil_size = 0;
244 video->gl_config.double_buffer = 1;
245 video->gl_config.accum_red_size = 0;
246 video->gl_config.accum_green_size = 0;
247 video->gl_config.accum_blue_size = 0;
248 video->gl_config.accum_alpha_size = 0;
249 video->gl_config.stereo = 0;
250 video->gl_config.multisamplebuffers = 0;
251 video->gl_config.multisamplesamples = 0;
253 /* Initialize the video subsystem */
254 memset(&vformat, 0, sizeof(vformat));
255 if ( video->VideoInit(video, &vformat) < 0 ) {
260 /* Create a zero sized video surface of the appropriate format */
261 video_flags = SDL_SWSURFACE;
262 SDL_VideoSurface = SDL_CreateRGBSurface(video_flags, 0, 0,
263 vformat.BitsPerPixel,
264 vformat.Rmask, vformat.Gmask, vformat.Bmask, 0);
265 if ( SDL_VideoSurface == NULL ) {
269 SDL_PublicSurface = NULL; /* Until SDL_SetVideoMode() */
271 #if 0 /* Don't change the current palette - may be used by other programs.
272 * The application can't do anything with the display surface until
273 * a video mode has been set anyway. :)
275 /* If we have a palettized surface, create a default palette */
276 if ( SDL_VideoSurface->format->palette ) {
277 SDL_PixelFormat *vf = SDL_VideoSurface->format;
278 SDL_DitherColors(vf->palette->colors, vf->BitsPerPixel);
279 video->SetColors(video,
280 0, vf->palette->ncolors, vf->palette->colors);
283 video->info.vfmt = SDL_VideoSurface->format;
285 /* Start the event loop */
286 if ( SDL_StartEventLoop(flags) < 0 ) {
290 SDL_CursorInit(flags & SDL_INIT_EVENTTHREAD);
292 /* We're ready to go! */
296 char *SDL_VideoDriverName(char *namebuf, int maxlen)
298 if ( current_video != NULL ) {
299 strncpy(namebuf, current_video->name, maxlen-1);
300 namebuf[maxlen-1] = '\0';
307 * Get the current display surface
309 SDL_Surface *SDL_GetVideoSurface(void)
311 SDL_Surface *visible;
314 if ( current_video ) {
315 visible = current_video->visible;
321 * Get the current information about the video hardware
323 const SDL_VideoInfo *SDL_GetVideoInfo(void)
325 const SDL_VideoInfo *info;
328 if ( current_video ) {
329 info = ¤t_video->info;
335 * Return a pointer to an array of available screen dimensions for the
336 * given format, sorted largest to smallest. Returns NULL if there are
337 * no dimensions available for a particular format, or (SDL_Rect **)-1
338 * if any dimension is okay for the given format. If 'format' is NULL,
339 * the mode list will be for the format given by SDL_GetVideoInfo()->vfmt
341 SDL_Rect ** SDL_ListModes (SDL_PixelFormat *format, Uint32 flags)
343 SDL_VideoDevice *video = current_video;
344 SDL_VideoDevice *this = current_video;
348 if ( SDL_VideoSurface ) {
349 if ( format == NULL ) {
350 format = SDL_VideoSurface->format;
352 modes = video->ListModes(this, format, flags);
358 * Check to see if a particular video mode is supported.
359 * It returns 0 if the requested mode is not supported under any bit depth,
360 * or returns the bits-per-pixel of the closest available mode with the
361 * given width and height. If this bits-per-pixel is different from the
362 * one used when setting the video mode, SDL_SetVideoMode() will succeed,
363 * but will emulate the requested bits-per-pixel with a shadow surface.
365 static Uint8 SDL_closest_depths[4][8] = {
366 /* 8 bit closest depth ordering */
367 { 0, 8, 16, 15, 32, 24, 0, 0 },
368 /* 15,16 bit closest depth ordering */
369 { 0, 16, 15, 32, 24, 8, 0, 0 },
370 /* 24 bit closest depth ordering */
371 { 0, 24, 32, 16, 15, 8, 0, 0 },
372 /* 32 bit closest depth ordering */
373 { 0, 32, 16, 15, 24, 8, 0, 0 }
377 #ifdef macintosh /* MPW optimization bug? */
378 #define NEGATIVE_ONE 0xFFFFFFFF
380 #define NEGATIVE_ONE -1
383 int SDL_VideoModeOK (int width, int height, int bpp, Uint32 flags)
387 SDL_PixelFormat format;
390 /* Currently 1 and 4 bpp are not supported */
391 if ( bpp < 8 || bpp > 32 ) {
394 if ( (width <= 0) || (height <= 0) ) {
398 /* Search through the list valid of modes */
399 memset(&format, 0, sizeof(format));
401 table = ((bpp+7)/8)-1;
402 SDL_closest_depths[table][0] = bpp;
403 SDL_closest_depths[table][7] = 0;
404 for ( b = 0; !supported && SDL_closest_depths[table][b]; ++b ) {
405 format.BitsPerPixel = SDL_closest_depths[table][b];
406 sizes = SDL_ListModes(&format, flags);
407 if ( sizes == (SDL_Rect **)0 ) {
408 /* No sizes supported at this bit-depth */
411 if (sizes == (SDL_Rect **)NEGATIVE_ONE) {
412 /* Any size supported at this bit-depth */
415 } else if (current_video->handles_any_size) {
416 /* Driver can center a smaller surface to simulate fullscreen */
417 for ( i=0; sizes[i]; ++i ) {
418 if ((sizes[i]->w >= width) && (sizes[i]->h >= height)) {
419 supported = 1; /* this mode can fit the centered window. */
424 for ( i=0; sizes[i]; ++i ) {
425 if ((sizes[i]->w == width) && (sizes[i]->h == height)) {
433 return(SDL_closest_depths[table][b]);
440 * Get the closest non-emulated video mode to the one requested
442 static int SDL_GetVideoMode (int *w, int *h, int *BitsPerPixel, Uint32 flags)
447 SDL_PixelFormat format;
450 /* Check parameters */
451 if ( *BitsPerPixel < 8 || *BitsPerPixel > 32 ) {
452 SDL_SetError("Invalid bits per pixel (range is {8...32})");
455 if ((*w <= 0) || (*h <= 0)) {
456 SDL_SetError("Invalid width or height");
460 /* Try the original video mode, get the closest depth */
461 native_bpp = SDL_VideoModeOK(*w, *h, *BitsPerPixel, flags);
462 if ( native_bpp == *BitsPerPixel ) {
465 if ( native_bpp > 0 ) {
466 *BitsPerPixel = native_bpp;
470 /* No exact size match at any depth, look for closest match */
471 memset(&format, 0, sizeof(format));
473 table = ((*BitsPerPixel+7)/8)-1;
474 SDL_closest_depths[table][0] = *BitsPerPixel;
475 SDL_closest_depths[table][7] = SDL_VideoSurface->format->BitsPerPixel;
476 for ( b = 0; !supported && SDL_closest_depths[table][b]; ++b ) {
479 format.BitsPerPixel = SDL_closest_depths[table][b];
480 sizes = SDL_ListModes(&format, flags);
481 if ( sizes == (SDL_Rect **)0 ) {
482 /* No sizes supported at this bit-depth */
486 for ( i=0; sizes[i]; ++i ) {
487 /* Mode with both dimensions bigger or equal than asked ? */
488 if ((sizes[i]->w >= *w) && (sizes[i]->h >= *h)) {
489 /* Mode with any dimension smaller or equal than current best ? */
490 if ((sizes[i]->w <= sizes[best]->w) || (sizes[i]->h <= sizes[best]->h)) {
491 /* Now choose the mode that has less pixels */
492 if ((sizes[i]->w * sizes[i]->h) <= (sizes[best]->w * sizes[best]->h)) {
502 *BitsPerPixel = SDL_closest_depths[table][b];
506 SDL_SetError("No video mode large enough for %dx%d", *w, *h);
511 /* This should probably go somewhere else -- like SDL_surface.c */
512 static void SDL_ClearSurface(SDL_Surface *surface)
516 black = SDL_MapRGB(surface->format, 0, 0, 0);
517 SDL_FillRect(surface, NULL, black);
518 if ((surface->flags&SDL_HWSURFACE) && (surface->flags&SDL_DOUBLEBUF)) {
520 SDL_FillRect(surface, NULL, black);
526 * Create a shadow surface suitable for fooling the app. :-)
528 static void SDL_CreateShadowSurface(int depth)
530 Uint32 Rmask, Gmask, Bmask;
532 /* Allocate the shadow surface */
533 if ( depth == (SDL_VideoSurface->format)->BitsPerPixel ) {
534 Rmask = (SDL_VideoSurface->format)->Rmask;
535 Gmask = (SDL_VideoSurface->format)->Gmask;
536 Bmask = (SDL_VideoSurface->format)->Bmask;
538 Rmask = Gmask = Bmask = 0;
540 SDL_ShadowSurface = SDL_CreateRGBSurface(SDL_SWSURFACE,
541 SDL_VideoSurface->w, SDL_VideoSurface->h,
542 depth, Rmask, Gmask, Bmask, 0);
543 if ( SDL_ShadowSurface == NULL ) {
547 /* 8-bit shadow surfaces report that they have exclusive palette */
548 if ( SDL_ShadowSurface->format->palette ) {
549 SDL_ShadowSurface->flags |= SDL_HWPALETTE;
550 if ( depth == (SDL_VideoSurface->format)->BitsPerPixel ) {
551 memcpy(SDL_ShadowSurface->format->palette->colors,
552 SDL_VideoSurface->format->palette->colors,
553 SDL_VideoSurface->format->palette->ncolors*
557 SDL_ShadowSurface->format->palette->colors, depth);
561 /* If the video surface is resizable, the shadow should say so */
562 if ( (SDL_VideoSurface->flags & SDL_RESIZABLE) == SDL_RESIZABLE ) {
563 SDL_ShadowSurface->flags |= SDL_RESIZABLE;
565 /* If the video surface has no frame, the shadow should say so */
566 if ( (SDL_VideoSurface->flags & SDL_NOFRAME) == SDL_NOFRAME ) {
567 SDL_ShadowSurface->flags |= SDL_NOFRAME;
569 /* If the video surface is fullscreen, the shadow should say so */
570 if ( (SDL_VideoSurface->flags & SDL_FULLSCREEN) == SDL_FULLSCREEN ) {
571 SDL_ShadowSurface->flags |= SDL_FULLSCREEN;
573 /* If the video surface is flippable, the shadow should say so */
574 if ( (SDL_VideoSurface->flags & SDL_DOUBLEBUF) == SDL_DOUBLEBUF ) {
575 SDL_ShadowSurface->flags |= SDL_DOUBLEBUF;
581 #include <sys/neutrino.h>
582 #endif /* __QNXNTO__ */
585 * Set the requested video mode, allocating a shadow buffer if necessary.
587 SDL_Surface * SDL_SetVideoMode (int width, int height, int bpp, Uint32 flags)
589 SDL_VideoDevice *video, *this;
590 SDL_Surface *prev_mode, *mode;
595 SDL_GrabMode saved_grab;
597 /* Start up the video driver, if necessary..
598 WARNING: This is the only function protected this way!
600 if ( ! current_video ) {
601 if ( SDL_Init(SDL_INIT_VIDEO|SDL_INIT_NOPARACHUTE) < 0 ) {
605 this = video = current_video;
607 /* Default to the current video bpp */
609 flags |= SDL_ANYFORMAT;
610 bpp = SDL_VideoSurface->format->BitsPerPixel;
613 /* Get a good video mode, the closest one possible */
617 if ( ! SDL_GetVideoMode(&video_w, &video_h, &video_bpp, flags) ) {
621 /* Check the requested flags */
622 /* There's no palette in > 8 bits-per-pixel mode */
623 if ( video_bpp > 8 ) {
624 flags &= ~SDL_HWPALETTE;
627 if ( (flags&SDL_FULLSCREEN) != SDL_FULLSCREEN ) {
628 /* There's no windowed double-buffering */
629 flags &= ~SDL_DOUBLEBUF;
632 if ( (flags&SDL_DOUBLEBUF) == SDL_DOUBLEBUF ) {
633 /* Use hardware surfaces when double-buffering */
634 flags |= SDL_HWSURFACE;
637 is_opengl = ( ( flags & SDL_OPENGL ) == SDL_OPENGL );
639 /* These flags are for 2D video modes only */
640 flags &= ~(SDL_HWSURFACE|SDL_DOUBLEBUF);
643 /* Reset the keyboard here so event callbacks can run */
647 /* Clean up any previous video mode */
648 if ( SDL_PublicSurface != NULL ) {
649 SDL_PublicSurface = NULL;
651 if ( SDL_ShadowSurface != NULL ) {
652 SDL_Surface *ready_to_go;
653 ready_to_go = SDL_ShadowSurface;
654 SDL_ShadowSurface = NULL;
655 SDL_FreeSurface(ready_to_go);
657 if ( video->physpal ) {
658 free(video->physpal->colors);
659 free(video->physpal);
660 video->physpal = NULL;
662 if( video->gammacols) {
663 free(video->gammacols);
664 video->gammacols = NULL;
667 /* Save the previous grab state and turn off grab for mode switch */
668 saved_grab = SDL_WM_GrabInputOff();
670 /* Try to set the video mode, along with offset and clipping */
671 prev_mode = SDL_VideoSurface;
673 SDL_VideoSurface = NULL; /* In case it's freed by driver */
674 mode = video->SetVideoMode(this, prev_mode,video_w,video_h,video_bpp,flags);
675 if ( mode ) { /* Prevent resize events from mode change */
676 /* But not on OS/2 */
678 SDL_PrivateResize(mode->w, mode->h);
681 /* Sam - If we asked for OpenGL mode, and didn't get it, fail */
682 if ( is_opengl && !(mode->flags & SDL_OPENGL) ) {
684 SDL_SetError("OpenGL not available");
689 * If you try to set an SDL_OPENGL surface, and fail to find a
690 * matching visual, then the next call to SDL_SetVideoMode()
691 * will segfault, since we no longer point to a dummy surface,
694 * WARNING, we need to make sure that the previous mode hasn't
695 * already been freed by the video driver. What do we do in
696 * that case? Should we call SDL_VideoInit() again?
698 SDL_VideoSurface = (mode != NULL) ? mode : prev_mode;
700 if ( (mode != NULL) && (!is_opengl) ) {
702 if ( (mode->w < width) || (mode->h < height) ) {
703 SDL_SetError("Video mode smaller than requested");
707 /* If we have a palettized surface, create a default palette */
708 if ( mode->format->palette ) {
709 SDL_PixelFormat *vf = mode->format;
710 SDL_DitherColors(vf->palette->colors, vf->BitsPerPixel);
711 video->SetColors(this, 0, vf->palette->ncolors,
712 vf->palette->colors);
715 /* Clear the surface to black */
719 SDL_SetClipRect(mode, NULL);
720 SDL_ClearSurface(mode);
722 /* Now adjust the offsets to match the desired mode */
723 video->offset_x = (mode->w-width)/2;
724 video->offset_y = (mode->h-height)/2;
725 mode->offset = video->offset_y*mode->pitch +
726 video->offset_x*mode->format->BytesPerPixel;
729 "Requested mode: %dx%dx%d, obtained mode %dx%dx%d (offset %d)\n",
731 mode->w, mode->h, mode->format->BitsPerPixel, mode->offset);
735 SDL_SetClipRect(mode, NULL);
740 /* If we failed setting a video mode, return NULL... (Uh Oh!) */
741 if ( mode == NULL ) {
745 /* If there is no window manager, set the SDL_NOFRAME flag */
746 if ( ! video->info.wm_available ) {
747 mode->flags |= SDL_NOFRAME;
750 /* Reset the mouse cursor and grab for new video mode */
752 if ( video->UpdateMouse ) {
753 video->UpdateMouse(this);
755 SDL_WM_GrabInput(saved_grab);
756 SDL_GetRelativeMouseState(NULL, NULL); /* Clear first large delta */
759 /* Load GL symbols (before MakeCurrent, where we need glGetString). */
760 if ( flags & (SDL_OPENGL | SDL_OPENGLBLIT) ) {
762 #if defined(__QNXNTO__) && (_NTO_VERSION < 630)
763 #define __SDL_NOGETPROCADDR__
764 #elif defined(__MINT__)
765 #define __SDL_NOGETPROCADDR__
767 #ifdef __SDL_NOGETPROCADDR__
768 #define SDL_PROC(ret,func,params) video->func=func;
770 #define SDL_PROC(ret,func,params) \
772 video->func = SDL_GL_GetProcAddress(#func); \
773 if ( ! video->func ) { \
774 SDL_SetError("Couldn't load GL function %s: %s\n", #func, SDL_GetError()); \
779 #endif /* __SDL_NOGETPROCADDR__ */
781 #include "SDL_glfuncs.h"
784 #endif /* HAVE_OPENGL */
786 /* If we're running OpenGL, make the context current */
787 if ( (video->screen->flags & SDL_OPENGL) &&
788 video->GL_MakeCurrent ) {
789 if ( video->GL_MakeCurrent(this) < 0 ) {
794 /* Set up a fake SDL surface for OpenGL "blitting" */
795 if ( (flags & SDL_OPENGLBLIT) == SDL_OPENGLBLIT ) {
796 /* Load GL functions for performing the texture updates */
799 /* Create a software surface for blitting */
800 #ifdef GL_VERSION_1_2
801 /* If the implementation either supports the packed pixels
802 extension, or implements the core OpenGL 1.2 API, it will
803 support the GL_UNSIGNED_SHORT_5_6_5 texture format.
806 (strstr((const char *)video->glGetString(GL_EXTENSIONS), "GL_EXT_packed_pixels") ||
807 (atof((const char *)video->glGetString(GL_VERSION)) >= 1.2f))
810 SDL_VideoSurface = SDL_CreateRGBSurface(
822 #endif /* OpenGL 1.2 */
825 SDL_VideoSurface = SDL_CreateRGBSurface(
830 #if SDL_BYTEORDER == SDL_LIL_ENDIAN
843 if ( ! SDL_VideoSurface ) {
846 SDL_VideoSurface->flags = mode->flags | SDL_OPENGLBLIT;
848 /* Free the original video mode surface (is this safe?) */
849 SDL_FreeSurface(mode);
851 /* Set the surface completely opaque & white by default */
852 memset( SDL_VideoSurface->pixels, 255, SDL_VideoSurface->h * SDL_VideoSurface->pitch );
853 video->glGenTextures( 1, &video->texture );
854 video->glBindTexture( GL_TEXTURE_2D, video->texture );
858 video->is_32bit ? GL_RGBA : GL_RGB,
862 video->is_32bit ? GL_RGBA : GL_RGB,
863 #ifdef GL_VERSION_1_2
864 video->is_32bit ? GL_UNSIGNED_BYTE : GL_UNSIGNED_SHORT_5_6_5,
870 video->UpdateRects = SDL_GL_UpdateRectsLock;
872 SDL_SetError("Somebody forgot to #define HAVE_OPENGL");
877 /* Create a shadow surface if necessary */
878 /* There are three conditions under which we create a shadow surface:
879 1. We need a particular bits-per-pixel that we didn't get.
880 2. We need a hardware palette and didn't get one.
881 3. We need a software surface and got a hardware surface.
883 if ( !(SDL_VideoSurface->flags & SDL_OPENGL) &&
885 ( !(flags&SDL_ANYFORMAT) &&
886 (SDL_VideoSurface->format->BitsPerPixel != bpp)) ||
887 ( (flags&SDL_HWPALETTE) &&
888 !(SDL_VideoSurface->flags&SDL_HWPALETTE)) ||
889 /* If the surface is in hardware, video writes are visible
890 as soon as they are performed, so we need to buffer them
892 ( ((flags&SDL_HWSURFACE) == SDL_SWSURFACE) &&
893 (SDL_VideoSurface->flags&SDL_HWSURFACE)) ||
894 ( (flags&SDL_DOUBLEBUF) &&
895 (SDL_VideoSurface->flags&SDL_HWSURFACE) &&
896 !(SDL_VideoSurface->flags&SDL_DOUBLEBUF))
898 SDL_CreateShadowSurface(bpp);
899 if ( SDL_ShadowSurface == NULL ) {
900 SDL_SetError("Couldn't create shadow surface");
903 SDL_PublicSurface = SDL_ShadowSurface;
905 SDL_PublicSurface = SDL_VideoSurface;
907 video->info.vfmt = SDL_VideoSurface->format;
910 return(SDL_PublicSurface);
914 * Convert a surface into the video pixel format.
916 SDL_Surface * SDL_DisplayFormat (SDL_Surface *surface)
920 if ( ! SDL_PublicSurface ) {
921 SDL_SetError("No video mode has been set");
924 /* Set the flags appropriate for copying to display surface */
925 if (((SDL_PublicSurface->flags&SDL_HWSURFACE) == SDL_HWSURFACE) && current_video->info.blit_hw)
926 flags = SDL_HWSURFACE;
928 flags = SDL_SWSURFACE;
929 #ifdef AUTORLE_DISPLAYFORMAT
930 flags |= (surface->flags & (SDL_SRCCOLORKEY|SDL_SRCALPHA));
931 flags |= SDL_RLEACCELOK;
933 flags |= surface->flags & (SDL_SRCCOLORKEY|SDL_SRCALPHA|SDL_RLEACCELOK);
935 return(SDL_ConvertSurface(surface, SDL_PublicSurface->format, flags));
939 * Convert a surface into a format that's suitable for blitting to
940 * the screen, but including an alpha channel.
942 SDL_Surface *SDL_DisplayFormatAlpha(SDL_Surface *surface)
945 SDL_PixelFormat *format;
946 SDL_Surface *converted;
948 /* default to ARGB8888 */
949 Uint32 amask = 0xff000000;
950 Uint32 rmask = 0x00ff0000;
951 Uint32 gmask = 0x0000ff00;
952 Uint32 bmask = 0x000000ff;
954 if ( ! SDL_PublicSurface ) {
955 SDL_SetError("No video mode has been set");
958 vf = SDL_PublicSurface->format;
960 switch(vf->BytesPerPixel) {
962 /* For XGY5[56]5, use, AXGY8888, where {X, Y} = {R, B}.
963 For anything else (like ARGB4444) it doesn't matter
964 since we have no special code for it anyway */
965 if ( (vf->Rmask == 0x1f) &&
966 (vf->Bmask == 0xf800 || vf->Bmask == 0x7c00)) {
974 /* Keep the video format, as long as the high 8 bits are
976 if ( (vf->Rmask == 0xff) && (vf->Bmask == 0xff0000) ) {
983 /* We have no other optimised formats right now. When/if a new
984 optimised alpha format is written, add the converter here */
987 format = SDL_AllocFormat(32, rmask, gmask, bmask, amask);
988 flags = SDL_PublicSurface->flags & SDL_HWSURFACE;
989 flags |= surface->flags & (SDL_SRCALPHA | SDL_RLEACCELOK);
990 converted = SDL_ConvertSurface(surface, format, flags);
991 SDL_FreeFormat(format);
996 * Update a specific portion of the physical screen
998 void SDL_UpdateRect(SDL_Surface *screen, Sint32 x, Sint32 y, Uint32 w, Uint32 h)
1003 /* Perform some checking */
1008 if ( (int)(x+w) > screen->w )
1010 if ( (int)(y+h) > screen->h )
1013 /* Fill the rectangle */
1018 SDL_UpdateRects(screen, 1, &rect);
1021 void SDL_UpdateRects (SDL_Surface *screen, int numrects, SDL_Rect *rects)
1024 SDL_VideoDevice *video = current_video;
1025 SDL_VideoDevice *this = current_video;
1027 if ( screen == SDL_ShadowSurface ) {
1028 /* Blit the shadow surface using saved mapping */
1029 SDL_Palette *pal = screen->format->palette;
1030 SDL_Color *saved_colors = NULL;
1031 if ( pal && !(SDL_VideoSurface->flags & SDL_HWPALETTE) ) {
1032 /* simulated 8bpp, use correct physical palette */
1033 saved_colors = pal->colors;
1034 if ( video->gammacols ) {
1035 /* gamma-corrected palette */
1036 pal->colors = video->gammacols;
1037 } else if ( video->physpal ) {
1038 /* physical palette different from logical */
1039 pal->colors = video->physpal->colors;
1042 if ( SHOULD_DRAWCURSOR(SDL_cursorstate) ) {
1044 SDL_DrawCursor(SDL_ShadowSurface);
1045 for ( i=0; i<numrects; ++i ) {
1046 SDL_LowerBlit(SDL_ShadowSurface, &rects[i],
1047 SDL_VideoSurface, &rects[i]);
1049 SDL_EraseCursor(SDL_ShadowSurface);
1052 for ( i=0; i<numrects; ++i ) {
1053 SDL_LowerBlit(SDL_ShadowSurface, &rects[i],
1054 SDL_VideoSurface, &rects[i]);
1057 if ( saved_colors ) {
1058 pal->colors = saved_colors;
1061 /* Fall through to video surface update */
1062 screen = SDL_VideoSurface;
1064 if ( screen == SDL_VideoSurface ) {
1065 /* Update the video surface */
1066 if ( screen->offset ) {
1067 for ( i=0; i<numrects; ++i ) {
1068 rects[i].x += video->offset_x;
1069 rects[i].y += video->offset_y;
1071 video->UpdateRects(this, numrects, rects);
1072 for ( i=0; i<numrects; ++i ) {
1073 rects[i].x -= video->offset_x;
1074 rects[i].y -= video->offset_y;
1077 video->UpdateRects(this, numrects, rects);
1083 * Performs hardware double buffering, if possible, or a full update if not.
1085 int SDL_Flip(SDL_Surface *screen)
1087 SDL_VideoDevice *video = current_video;
1088 /* Copy the shadow surface to the video surface */
1089 if ( screen == SDL_ShadowSurface ) {
1091 SDL_Palette *pal = screen->format->palette;
1092 SDL_Color *saved_colors = NULL;
1093 if ( pal && !(SDL_VideoSurface->flags & SDL_HWPALETTE) ) {
1094 /* simulated 8bpp, use correct physical palette */
1095 saved_colors = pal->colors;
1096 if ( video->gammacols ) {
1097 /* gamma-corrected palette */
1098 pal->colors = video->gammacols;
1099 } else if ( video->physpal ) {
1100 /* physical palette different from logical */
1101 pal->colors = video->physpal->colors;
1109 if ( SHOULD_DRAWCURSOR(SDL_cursorstate) ) {
1111 SDL_DrawCursor(SDL_ShadowSurface);
1112 SDL_LowerBlit(SDL_ShadowSurface, &rect,
1113 SDL_VideoSurface, &rect);
1114 SDL_EraseCursor(SDL_ShadowSurface);
1117 SDL_LowerBlit(SDL_ShadowSurface, &rect,
1118 SDL_VideoSurface, &rect);
1120 if ( saved_colors ) {
1121 pal->colors = saved_colors;
1124 /* Fall through to video surface update */
1125 screen = SDL_VideoSurface;
1127 if ( (screen->flags & SDL_DOUBLEBUF) == SDL_DOUBLEBUF ) {
1128 SDL_VideoDevice *this = current_video;
1129 return(video->FlipHWSurface(this, SDL_VideoSurface));
1131 SDL_UpdateRect(screen, 0, 0, 0, 0);
1136 static void SetPalette_logical(SDL_Surface *screen, SDL_Color *colors,
1137 int firstcolor, int ncolors)
1139 SDL_Palette *pal = screen->format->palette;
1140 SDL_Palette *vidpal;
1142 if ( colors != (pal->colors + firstcolor) ) {
1143 memcpy(pal->colors + firstcolor, colors,
1144 ncolors * sizeof(*colors));
1147 vidpal = SDL_VideoSurface->format->palette;
1148 if ( (screen == SDL_ShadowSurface) && vidpal ) {
1150 * This is a shadow surface, and the physical
1151 * framebuffer is also indexed. Propagate the
1152 * changes to its logical palette so that
1153 * updates are always identity blits
1155 memcpy(vidpal->colors + firstcolor, colors,
1156 ncolors * sizeof(*colors));
1158 SDL_FormatChanged(screen);
1161 static int SetPalette_physical(SDL_Surface *screen,
1162 SDL_Color *colors, int firstcolor, int ncolors)
1164 SDL_VideoDevice *video = current_video;
1167 if ( video->physpal ) {
1168 /* We need to copy the new colors, since we haven't
1169 * already done the copy in the logical set above.
1171 memcpy(video->physpal->colors + firstcolor,
1172 colors, ncolors * sizeof(*colors));
1174 if ( screen == SDL_ShadowSurface ) {
1175 if ( SDL_VideoSurface->flags & SDL_HWPALETTE ) {
1177 * The real screen is also indexed - set its physical
1178 * palette. The physical palette does not include the
1179 * gamma modification, we apply it directly instead,
1180 * but this only happens if we have hardware palette.
1182 screen = SDL_VideoSurface;
1185 * The video surface is not indexed - invalidate any
1186 * active shadow-to-video blit mappings.
1188 if ( screen->map->dst == SDL_VideoSurface ) {
1189 SDL_InvalidateMap(screen->map);
1191 if ( video->gamma ) {
1192 if( ! video->gammacols ) {
1193 SDL_Palette *pp = video->physpal;
1195 pp = screen->format->palette;
1196 video->gammacols = malloc(pp->ncolors
1197 * sizeof(SDL_Color));
1198 SDL_ApplyGamma(video->gamma,
1203 SDL_ApplyGamma(video->gamma, colors,
1209 SDL_UpdateRect(screen, 0, 0, 0, 0);
1213 if ( screen == SDL_VideoSurface ) {
1214 SDL_Color gcolors[256];
1216 if ( video->gamma ) {
1217 SDL_ApplyGamma(video->gamma, colors, gcolors, ncolors);
1220 gotall = video->SetColors(video, firstcolor, ncolors, colors);
1222 /* The video flags shouldn't have SDL_HWPALETTE, and
1223 the video driver is responsible for copying back the
1224 correct colors into the video surface palette.
1228 SDL_CursorPaletteChanged();
1234 * Set the physical and/or logical colormap of a surface:
1235 * Only the screen has a physical colormap. It determines what is actually
1236 * sent to the display.
1237 * The logical colormap is used to map blits to/from the surface.
1238 * 'which' is one or both of SDL_LOGPAL, SDL_PHYSPAL
1240 * Return nonzero if all colours were set as requested, or 0 otherwise.
1242 int SDL_SetPalette(SDL_Surface *screen, int which,
1243 SDL_Color *colors, int firstcolor, int ncolors)
1249 if ( ! current_video ) {
1252 if ( screen != SDL_PublicSurface ) {
1253 /* only screens have physical palettes */
1254 which &= ~SDL_PHYSPAL;
1255 } else if( (screen->flags & SDL_HWPALETTE) != SDL_HWPALETTE ) {
1256 /* hardware palettes required for split colormaps */
1257 which |= SDL_PHYSPAL | SDL_LOGPAL;
1260 /* Verify the parameters */
1261 pal = screen->format->palette;
1263 return 0; /* not a palettized surface */
1266 palsize = 1 << screen->format->BitsPerPixel;
1267 if ( ncolors > (palsize - firstcolor) ) {
1268 ncolors = (palsize - firstcolor);
1272 if ( which & SDL_LOGPAL ) {
1274 * Logical palette change: The actual screen isn't affected,
1275 * but the internal colormap is altered so that the
1276 * interpretation of the pixel values (for blits etc) is
1279 SetPalette_logical(screen, colors, firstcolor, ncolors);
1281 if ( which & SDL_PHYSPAL ) {
1282 SDL_VideoDevice *video = current_video;
1284 * Physical palette change: This doesn't affect the
1285 * program's idea of what the screen looks like, but changes
1286 * its actual appearance.
1289 return gotall; /* video not yet initialized */
1290 if(!video->physpal && !(which & SDL_LOGPAL) ) {
1291 /* Lazy physical palette allocation */
1293 SDL_Palette *pp = malloc(sizeof(*pp));
1297 current_video->physpal = pp;
1298 pp->ncolors = pal->ncolors;
1299 size = pp->ncolors * sizeof(SDL_Color);
1300 pp->colors = malloc(size);
1301 if ( !pp->colors ) {
1304 memcpy(pp->colors, pal->colors, size);
1306 if ( ! SetPalette_physical(screen,
1307 colors, firstcolor, ncolors) ) {
1314 int SDL_SetColors(SDL_Surface *screen, SDL_Color *colors, int firstcolor,
1317 return SDL_SetPalette(screen, SDL_LOGPAL | SDL_PHYSPAL,
1318 colors, firstcolor, ncolors);
1322 * Clean up the video subsystem
1324 void SDL_VideoQuit (void)
1326 SDL_Surface *ready_to_go;
1328 if ( current_video ) {
1329 SDL_VideoDevice *video = current_video;
1330 SDL_VideoDevice *this = current_video;
1332 /* Halt event processing before doing anything else */
1333 SDL_StopEventLoop();
1335 /* Clean up allocated window manager items */
1336 if ( SDL_PublicSurface ) {
1337 SDL_PublicSurface = NULL;
1341 /* Just in case... */
1342 SDL_WM_GrabInputOff();
1344 /* Clean up the system video */
1345 video->VideoQuit(this);
1347 /* Free any lingering surfaces */
1348 ready_to_go = SDL_ShadowSurface;
1349 SDL_ShadowSurface = NULL;
1350 SDL_FreeSurface(ready_to_go);
1351 if ( SDL_VideoSurface != NULL ) {
1352 ready_to_go = SDL_VideoSurface;
1353 SDL_VideoSurface = NULL;
1354 SDL_FreeSurface(ready_to_go);
1356 SDL_PublicSurface = NULL;
1358 /* Clean up miscellaneous memory */
1359 if ( video->physpal ) {
1360 free(video->physpal->colors);
1361 free(video->physpal);
1362 video->physpal = NULL;
1364 if ( video->gammacols ) {
1365 free(video->gammacols);
1366 video->gammacols = NULL;
1368 if ( video->gamma ) {
1370 video->gamma = NULL;
1372 if ( video->wm_title != NULL ) {
1373 free(video->wm_title);
1374 video->wm_title = NULL;
1376 if ( video->wm_icon != NULL ) {
1377 free(video->wm_icon);
1378 video->wm_icon = NULL;
1381 /* Finish cleaning up video subsystem */
1383 current_video = NULL;
1388 /* Load the GL driver library */
1389 int SDL_GL_LoadLibrary(const char *path)
1391 SDL_VideoDevice *video = current_video;
1392 SDL_VideoDevice *this = current_video;
1396 if ( video == NULL ) {
1397 SDL_SetError("Video subsystem has not been initialized");
1399 if ( video->GL_LoadLibrary ) {
1400 retval = video->GL_LoadLibrary(this, path);
1402 SDL_SetError("No dynamic GL support in video driver");
1408 void *SDL_GL_GetProcAddress(const char* proc)
1410 SDL_VideoDevice *video = current_video;
1411 SDL_VideoDevice *this = current_video;
1415 if ( video->GL_GetProcAddress ) {
1416 if ( video->gl_config.driver_loaded ) {
1417 func = video->GL_GetProcAddress(this, proc);
1419 SDL_SetError("No GL driver has been loaded");
1422 SDL_SetError("No dynamic GL support in video driver");
1427 /* Set the specified GL attribute for setting up a GL video mode */
1428 int SDL_GL_SetAttribute( SDL_GLattr attr, int value )
1431 SDL_VideoDevice *video = current_video;
1435 case SDL_GL_RED_SIZE:
1436 video->gl_config.red_size = value;
1438 case SDL_GL_GREEN_SIZE:
1439 video->gl_config.green_size = value;
1441 case SDL_GL_BLUE_SIZE:
1442 video->gl_config.blue_size = value;
1444 case SDL_GL_ALPHA_SIZE:
1445 video->gl_config.alpha_size = value;
1447 case SDL_GL_DOUBLEBUFFER:
1448 video->gl_config.double_buffer = value;
1450 case SDL_GL_BUFFER_SIZE:
1451 video->gl_config.buffer_size = value;
1453 case SDL_GL_DEPTH_SIZE:
1454 video->gl_config.depth_size = value;
1456 case SDL_GL_STENCIL_SIZE:
1457 video->gl_config.stencil_size = value;
1459 case SDL_GL_ACCUM_RED_SIZE:
1460 video->gl_config.accum_red_size = value;
1462 case SDL_GL_ACCUM_GREEN_SIZE:
1463 video->gl_config.accum_green_size = value;
1465 case SDL_GL_ACCUM_BLUE_SIZE:
1466 video->gl_config.accum_blue_size = value;
1468 case SDL_GL_ACCUM_ALPHA_SIZE:
1469 video->gl_config.accum_alpha_size = value;
1472 video->gl_config.stereo = value;
1474 case SDL_GL_MULTISAMPLEBUFFERS:
1475 video->gl_config.multisamplebuffers = value;
1477 case SDL_GL_MULTISAMPLESAMPLES:
1478 video->gl_config.multisamplesamples = value;
1481 SDL_SetError("Unknown OpenGL attribute");
1488 /* Retrieve an attribute value from the windowing system. */
1489 int SDL_GL_GetAttribute(SDL_GLattr attr, int* value)
1492 SDL_VideoDevice* video = current_video;
1493 SDL_VideoDevice* this = current_video;
1495 if ( video->GL_GetAttribute ) {
1496 retval = this->GL_GetAttribute(this, attr, value);
1499 SDL_SetError("GL_GetAttribute not supported");
1504 /* Perform a GL buffer swap on the current GL context */
1505 void SDL_GL_SwapBuffers(void)
1507 SDL_VideoDevice *video = current_video;
1508 SDL_VideoDevice *this = current_video;
1510 if ( video->screen->flags & SDL_OPENGL ) {
1511 video->GL_SwapBuffers(this);
1513 SDL_SetError("OpenGL video mode has not been set");
1517 /* Update rects with locking */
1518 void SDL_GL_UpdateRectsLock(SDL_VideoDevice* this, int numrects, SDL_Rect *rects)
1521 SDL_GL_UpdateRects(numrects, rects);
1525 /* Update rects without state setting and changing (the caller is responsible for it) */
1526 void SDL_GL_UpdateRects(int numrects, SDL_Rect *rects)
1529 SDL_VideoDevice *this = current_video;
1530 SDL_Rect update, tmp;
1533 for ( i = 0; i < numrects; i++ )
1537 for ( y = 0; y <= rects[i].h / 256; y++ )
1541 for ( x = 0; x <= rects[i].w / 256; x++ )
1548 if ( update.w > 256 )
1551 if ( update.h > 256 )
1555 this->glTexSubImage2D(
1562 this->is_32bit? GL_RGBA : GL_RGB,
1563 #ifdef GL_VERSION_1_2
1564 this->is_32bit ? GL_UNSIGNED_BYTE : GL_UNSIGNED_SHORT_5_6_5,
1568 (Uint8 *)this->screen->pixels +
1569 this->screen->format->BytesPerPixel * update.x +
1570 update.y * this->screen->pitch );
1574 * Note the parens around the function name:
1575 * This is because some OpenGL implementations define glTexCoord etc
1576 * as macros, and we don't want them expanded here.
1578 this->glBegin(GL_TRIANGLE_STRIP);
1579 (this->glTexCoord2f)( 0.0, 0.0 );
1580 (this->glVertex2i)( update.x, update.y );
1581 (this->glTexCoord2f)( (float)(update.w / 256.0), 0.0 );
1582 (this->glVertex2i)( update.x + update.w, update.y );
1583 (this->glTexCoord2f)( 0.0, (float)(update.h / 256.0) );
1584 (this->glVertex2i)( update.x, update.y + update.h );
1585 (this->glTexCoord2f)( (float)(update.w / 256.0), (float)(update.h / 256.0) );
1586 (this->glVertex2i)( update.x + update.w , update.y + update.h );
1599 /* Lock == save current state */
1606 SDL_VideoDevice *this = current_video;
1608 this->glPushAttrib( GL_ALL_ATTRIB_BITS ); /* TODO: narrow range of what is saved */
1609 #ifdef GL_CLIENT_PIXEL_STORE_BIT
1610 this->glPushClientAttrib( GL_CLIENT_PIXEL_STORE_BIT );
1613 this->glEnable(GL_TEXTURE_2D);
1614 this->glEnable(GL_BLEND);
1615 this->glDisable(GL_FOG);
1616 this->glDisable(GL_ALPHA_TEST);
1617 this->glDisable(GL_DEPTH_TEST);
1618 this->glDisable(GL_SCISSOR_TEST);
1619 this->glDisable(GL_STENCIL_TEST);
1620 this->glDisable(GL_CULL_FACE);
1622 this->glBindTexture( GL_TEXTURE_2D, this->texture );
1623 this->glTexEnvf( GL_TEXTURE_ENV, GL_TEXTURE_ENV_MODE, GL_MODULATE );
1624 this->glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST );
1625 this->glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST );
1626 this->glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_REPEAT );
1627 this->glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_REPEAT );
1629 this->glPixelStorei( GL_UNPACK_ROW_LENGTH, this->screen->pitch / this->screen->format->BytesPerPixel );
1630 this->glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
1631 (this->glColor4f)(1.0, 1.0, 1.0, 1.0); /* Solaris workaround */
1633 this->glViewport(0, 0, this->screen->w, this->screen->h);
1634 this->glMatrixMode(GL_PROJECTION);
1635 this->glPushMatrix();
1636 this->glLoadIdentity();
1638 this->glOrtho(0.0, (GLdouble) this->screen->w, (GLdouble) this->screen->h, 0.0, 0.0, 1.0);
1640 this->glMatrixMode(GL_MODELVIEW);
1641 this->glPushMatrix();
1642 this->glLoadIdentity();
1647 /* Unlock == restore saved state */
1648 void SDL_GL_Unlock()
1654 SDL_VideoDevice *this = current_video;
1656 this->glPopMatrix();
1657 this->glMatrixMode(GL_PROJECTION);
1658 this->glPopMatrix();
1660 this->glPopClientAttrib();
1661 this->glPopAttrib();
1667 * Sets/Gets the title and icon text of the display window, if any.
1669 void SDL_WM_SetCaption (const char *title, const char *icon)
1671 SDL_VideoDevice *video = current_video;
1672 SDL_VideoDevice *this = current_video;
1676 if ( video->wm_title ) {
1677 free(video->wm_title);
1679 video->wm_title = (char *)malloc(strlen(title)+1);
1680 if ( video->wm_title != NULL ) {
1681 strcpy(video->wm_title, title);
1685 if ( video->wm_icon ) {
1686 free(video->wm_icon);
1688 video->wm_icon = (char *)malloc(strlen(icon)+1);
1689 if ( video->wm_icon != NULL ) {
1690 strcpy(video->wm_icon, icon);
1693 if ( (title || icon) && (video->SetCaption != NULL) ) {
1694 video->SetCaption(this, video->wm_title,video->wm_icon);
1698 void SDL_WM_GetCaption (char **title, char **icon)
1700 SDL_VideoDevice *video = current_video;
1704 *title = video->wm_title;
1707 *icon = video->wm_icon;
1712 /* Utility function used by SDL_WM_SetIcon();
1713 * flags & 1 for color key, flags & 2 for alpha channel. */
1714 static void CreateMaskFromColorKeyOrAlpha(SDL_Surface *icon, Uint8 *mask, int flags)
1718 #define SET_MASKBIT(icon, x, y, mask) \
1719 mask[(y*((icon->w+7)/8))+(x/8)] &= ~(0x01<<(7-(x%8)))
1721 colorkey = icon->format->colorkey;
1722 switch (icon->format->BytesPerPixel) {
1723 case 1: { Uint8 *pixels;
1724 for ( y=0; y<icon->h; ++y ) {
1725 pixels = (Uint8 *)icon->pixels + y*icon->pitch;
1726 for ( x=0; x<icon->w; ++x ) {
1727 if ( *pixels++ == colorkey ) {
1728 SET_MASKBIT(icon, x, y, mask);
1735 case 2: { Uint16 *pixels;
1736 for ( y=0; y<icon->h; ++y ) {
1737 pixels = (Uint16 *)icon->pixels +
1739 for ( x=0; x<icon->w; ++x ) {
1740 if ( (flags & 1) && *pixels == colorkey ) {
1741 SET_MASKBIT(icon, x, y, mask);
1742 } else if((flags & 2) && (*pixels & icon->format->Amask) == 0) {
1743 SET_MASKBIT(icon, x, y, mask);
1751 case 4: { Uint32 *pixels;
1752 for ( y=0; y<icon->h; ++y ) {
1753 pixels = (Uint32 *)icon->pixels +
1755 for ( x=0; x<icon->w; ++x ) {
1756 if ( (flags & 1) && *pixels == colorkey ) {
1757 SET_MASKBIT(icon, x, y, mask);
1758 } else if((flags & 2) && (*pixels & icon->format->Amask) == 0) {
1759 SET_MASKBIT(icon, x, y, mask);
1770 * Sets the window manager icon for the display window.
1772 void SDL_WM_SetIcon (SDL_Surface *icon, Uint8 *mask)
1774 SDL_VideoDevice *video = current_video;
1775 SDL_VideoDevice *this = current_video;
1777 if ( icon && video->SetIcon ) {
1778 /* Generate a mask if necessary, and create the icon! */
1779 if ( mask == NULL ) {
1780 int mask_len = icon->h*(icon->w+7)/8;
1782 mask = (Uint8 *)malloc(mask_len);
1783 if ( mask == NULL ) {
1786 memset(mask, ~0, mask_len);
1787 if ( icon->flags & SDL_SRCCOLORKEY ) flags |= 1;
1788 if ( icon->flags & SDL_SRCALPHA ) flags |= 2;
1790 CreateMaskFromColorKeyOrAlpha(icon, mask, flags);
1792 video->SetIcon(video, icon, mask);
1795 video->SetIcon(this, icon, mask);
1801 * Grab or ungrab the keyboard and mouse input.
1802 * This function returns the final grab mode after calling the
1803 * driver dependent function.
1805 static SDL_GrabMode SDL_WM_GrabInputRaw(SDL_GrabMode mode)
1807 SDL_VideoDevice *video = current_video;
1808 SDL_VideoDevice *this = current_video;
1810 /* Only do something if we have support for grabs */
1811 if ( video->GrabInput == NULL ) {
1812 return(video->input_grab);
1815 /* If the final grab mode if off, only then do we actually grab */
1817 printf("SDL_WM_GrabInputRaw(%d) ... ", mode);
1819 if ( mode == SDL_GRAB_OFF ) {
1820 if ( video->input_grab != SDL_GRAB_OFF ) {
1821 mode = video->GrabInput(this, mode);
1824 if ( video->input_grab == SDL_GRAB_OFF ) {
1825 mode = video->GrabInput(this, mode);
1828 if ( mode != video->input_grab ) {
1829 video->input_grab = mode;
1830 if ( video->CheckMouseMode ) {
1831 video->CheckMouseMode(this);
1835 printf("Final mode %d\n", video->input_grab);
1838 /* Return the final grab state */
1839 if ( mode >= SDL_GRAB_FULLSCREEN ) {
1840 mode -= SDL_GRAB_FULLSCREEN;
1844 SDL_GrabMode SDL_WM_GrabInput(SDL_GrabMode mode)
1846 SDL_VideoDevice *video = current_video;
1848 /* If the video isn't initialized yet, we can't do anything */
1850 return SDL_GRAB_OFF;
1853 /* Return the current mode on query */
1854 if ( mode == SDL_GRAB_QUERY ) {
1855 mode = video->input_grab;
1856 if ( mode >= SDL_GRAB_FULLSCREEN ) {
1857 mode -= SDL_GRAB_FULLSCREEN;
1863 printf("SDL_WM_GrabInput(%d) ... ", mode);
1865 /* If the video surface is fullscreen, we always grab */
1866 if ( mode >= SDL_GRAB_FULLSCREEN ) {
1867 mode -= SDL_GRAB_FULLSCREEN;
1869 if ( SDL_VideoSurface && (SDL_VideoSurface->flags & SDL_FULLSCREEN) ) {
1870 mode += SDL_GRAB_FULLSCREEN;
1872 return(SDL_WM_GrabInputRaw(mode));
1874 static SDL_GrabMode SDL_WM_GrabInputOff(void)
1878 /* First query the current grab state */
1879 mode = SDL_WM_GrabInput(SDL_GRAB_QUERY);
1881 /* Now explicitly turn off input grab */
1882 SDL_WM_GrabInputRaw(SDL_GRAB_OFF);
1884 /* Return the old state */
1889 * Iconify the window in window managed environments.
1890 * A successful iconification will result in an SDL_APPACTIVE loss event.
1892 int SDL_WM_IconifyWindow(void)
1894 SDL_VideoDevice *video = current_video;
1895 SDL_VideoDevice *this = current_video;
1899 if ( video->IconifyWindow ) {
1900 retval = video->IconifyWindow(this);
1906 * Toggle fullscreen mode
1908 int SDL_WM_ToggleFullScreen(SDL_Surface *surface)
1910 SDL_VideoDevice *video = current_video;
1911 SDL_VideoDevice *this = current_video;
1915 if ( SDL_PublicSurface && (surface == SDL_PublicSurface) &&
1916 video->ToggleFullScreen ) {
1917 if ( surface->flags & SDL_FULLSCREEN ) {
1918 toggled = video->ToggleFullScreen(this, 0);
1920 SDL_VideoSurface->flags &= ~SDL_FULLSCREEN;
1921 SDL_PublicSurface->flags &= ~SDL_FULLSCREEN;
1924 toggled = video->ToggleFullScreen(this, 1);
1926 SDL_VideoSurface->flags |= SDL_FULLSCREEN;
1927 SDL_PublicSurface->flags |= SDL_FULLSCREEN;
1930 /* Double-check the grab state inside SDL_WM_GrabInput() */
1932 SDL_WM_GrabInput(video->input_grab);
1939 * Get some platform dependent window manager information
1941 int SDL_GetWMInfo (SDL_SysWMinfo *info)
1943 SDL_VideoDevice *video = current_video;
1944 SDL_VideoDevice *this = current_video;
1946 if ( video && video->GetWMInfo ) {
1947 return(video->GetWMInfo(this, info));