src/video/SDL_video.c
author Sam Lantinga <slouken@libsdl.org>
Thu, 27 Apr 2006 05:49:51 +0000
branchSDL-1.3
changeset 1655 59227394023d
parent 1654 0a53c90a37f9
child 1656 96c2f89cc7e1
permissions -rw-r--r--
SDL_OPENGLBLIT is really gone...
     1 /*
     2     SDL - Simple DirectMedia Layer
     3     Copyright (C) 1997-2006 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_sysvideo.h"
    28 #include "SDL_blit.h"
    29 #include "SDL_pixels_c.h"
    30 #include "SDL_cursor_c.h"
    31 #include "../events/SDL_sysevents.h"
    32 #include "../events/SDL_events_c.h"
    33 
    34 /* Available video drivers */
    35 static VideoBootStrap *bootstrap[] = {
    36 #if SDL_VIDEO_DRIVER_QUARTZ
    37 	&QZ_bootstrap,
    38 #endif
    39 #if SDL_VIDEO_DRIVER_X11
    40 	&X11_bootstrap,
    41 #endif
    42 #if SDL_VIDEO_DRIVER_DGA
    43 	&DGA_bootstrap,
    44 #endif
    45 #if SDL_VIDEO_DRIVER_NANOX
    46 	&NX_bootstrap,
    47 #endif
    48 #if SDL_VIDEO_DRIVER_IPOD
    49 	&iPod_bootstrap,
    50 #endif
    51 #if SDL_VIDEO_DRIVER_QTOPIA
    52 	&Qtopia_bootstrap,
    53 #endif
    54 #if SDL_VIDEO_DRIVER_WSCONS
    55 	&WSCONS_bootstrap,
    56 #endif
    57 #if SDL_VIDEO_DRIVER_FBCON
    58 	&FBCON_bootstrap,
    59 #endif
    60 #if SDL_VIDEO_DRIVER_DIRECTFB
    61 	&DirectFB_bootstrap,
    62 #endif
    63 #if SDL_VIDEO_DRIVER_PS2GS
    64 	&PS2GS_bootstrap,
    65 #endif
    66 #if SDL_VIDEO_DRIVER_GGI
    67 	&GGI_bootstrap,
    68 #endif
    69 #if SDL_VIDEO_DRIVER_VGL
    70 	&VGL_bootstrap,
    71 #endif
    72 #if SDL_VIDEO_DRIVER_SVGALIB
    73 	&SVGALIB_bootstrap,
    74 #endif
    75 #if SDL_VIDEO_DRIVER_GAPI
    76 	&GAPI_bootstrap,
    77 #endif
    78 #if SDL_VIDEO_DRIVER_WINDIB
    79 	&WINDIB_bootstrap,
    80 #endif
    81 #if SDL_VIDEO_DRIVER_DDRAW
    82 	&DIRECTX_bootstrap,
    83 #endif
    84 #if SDL_VIDEO_DRIVER_BWINDOW
    85 	&BWINDOW_bootstrap,
    86 #endif
    87 #if SDL_VIDEO_DRIVER_TOOLBOX
    88 	&TOOLBOX_bootstrap,
    89 #endif
    90 #if SDL_VIDEO_DRIVER_DRAWSPROCKET
    91 	&DSp_bootstrap,
    92 #endif
    93 #if SDL_VIDEO_DRIVER_CYBERGRAPHICS
    94 	&CGX_bootstrap,
    95 #endif
    96 #if SDL_VIDEO_DRIVER_PHOTON
    97 	&ph_bootstrap,
    98 #endif
    99 #if SDL_VIDEO_DRIVER_EPOC
   100 	&EPOC_bootstrap,
   101 #endif
   102 #if SDL_VIDEO_DRIVER_XBIOS
   103 	&XBIOS_bootstrap,
   104 #endif
   105 #if SDL_VIDEO_DRIVER_GEM
   106 	&GEM_bootstrap,
   107 #endif
   108 #if SDL_VIDEO_DRIVER_PICOGUI
   109 	&PG_bootstrap,
   110 #endif
   111 #if SDL_VIDEO_DRIVER_DC
   112 	&DC_bootstrap,
   113 #endif
   114 #if SDL_VIDEO_DRIVER_RISCOS
   115 	&RISCOS_bootstrap,
   116 #endif
   117 #if SDL_VIDEO_DRIVER_OS2FS
   118 	&OS2FSLib_bootstrap,
   119 #endif
   120 #if SDL_VIDEO_DRIVER_AALIB
   121 	&AALIB_bootstrap,
   122 #endif
   123 #if SDL_VIDEO_DRIVER_DUMMY
   124 	&DUMMY_bootstrap,
   125 #endif
   126 	NULL
   127 };
   128 
   129 SDL_VideoDevice *current_video = NULL;
   130 
   131 /* Various local functions */
   132 int SDL_VideoInit(const char *driver_name, Uint32 flags);
   133 void SDL_VideoQuit(void);
   134 
   135 static SDL_GrabMode SDL_WM_GrabInputOff(void);
   136 
   137 
   138 /*
   139  * Initialize the video and event subsystems -- determine native pixel format
   140  */
   141 int SDL_VideoInit (const char *driver_name, Uint32 flags)
   142 {
   143 	SDL_VideoDevice *video;
   144 	int index;
   145 	int i;
   146 	SDL_PixelFormat vformat;
   147 	Uint32 video_flags;
   148 
   149 	/* Toggle the event thread flags, based on OS requirements */
   150 #if defined(MUST_THREAD_EVENTS)
   151 	flags |= SDL_INIT_EVENTTHREAD;
   152 #elif defined(CANT_THREAD_EVENTS)
   153 	if ( (flags & SDL_INIT_EVENTTHREAD) == SDL_INIT_EVENTTHREAD ) {
   154 		SDL_SetError("OS doesn't support threaded events");
   155 		return(-1);
   156 	}
   157 #endif
   158 
   159 	/* Check to make sure we don't overwrite 'current_video' */
   160 	if ( current_video != NULL ) {
   161 		SDL_VideoQuit();
   162 	}
   163 
   164 	/* Select the proper video driver */
   165 	index = 0;
   166 	video = NULL;
   167 	if ( driver_name != NULL ) {
   168 #if 0	/* This will be replaced with a better driver selection API */
   169 		if ( SDL_strrchr(driver_name, ':') != NULL ) {
   170 			index = atoi(SDL_strrchr(driver_name, ':')+1);
   171 		}
   172 #endif
   173 		for ( i=0; bootstrap[i]; ++i ) {
   174 			if ( SDL_strncmp(bootstrap[i]->name, driver_name,
   175 			             SDL_strlen(bootstrap[i]->name)) == 0 ) {
   176 				if ( bootstrap[i]->available() ) {
   177 					video = bootstrap[i]->create(index);
   178 					break;
   179 				}
   180 			}
   181 		}
   182 	} else {
   183 		for ( i=0; bootstrap[i]; ++i ) {
   184 			if ( bootstrap[i]->available() ) {
   185 				video = bootstrap[i]->create(index);
   186 				if ( video != NULL ) {
   187 					break;
   188 				}
   189 			}
   190 		}
   191 	}
   192 	if ( video == NULL ) {
   193 		SDL_SetError("No available video device");
   194 		return(-1);
   195 	}
   196 	current_video = video;
   197 	current_video->name = bootstrap[i]->name;
   198 
   199 	/* Do some basic variable initialization */
   200 	video->screen = NULL;
   201 	video->shadow = NULL;
   202 	video->visible = NULL;
   203 	video->physpal = NULL;
   204 	video->gammacols = NULL;
   205 	video->gamma = NULL;
   206 	video->wm_title = NULL;
   207 	video->wm_icon  = NULL;
   208 	video->offset_x = 0;
   209 	video->offset_y = 0;
   210 	SDL_memset(&video->info, 0, (sizeof video->info));
   211 	
   212 	video->displayformatalphapixel = NULL;
   213 
   214 	/* Set some very sane GL defaults */
   215 	video->gl_config.driver_loaded = 0;
   216 	video->gl_config.dll_handle = NULL;
   217 	video->gl_config.red_size = 3;
   218 	video->gl_config.green_size = 3;
   219 	video->gl_config.blue_size = 2;
   220 	video->gl_config.alpha_size = 0;
   221 	video->gl_config.buffer_size = 0;
   222 	video->gl_config.depth_size = 16;
   223 	video->gl_config.stencil_size = 0;
   224 	video->gl_config.double_buffer = 1;
   225 	video->gl_config.accum_red_size = 0;
   226 	video->gl_config.accum_green_size = 0;
   227 	video->gl_config.accum_blue_size = 0;
   228 	video->gl_config.accum_alpha_size = 0;
   229 	video->gl_config.stereo = 0;
   230 	video->gl_config.multisamplebuffers = 0;
   231 	video->gl_config.multisamplesamples = 0;
   232 	
   233 	/* Initialize the video subsystem */
   234 	SDL_memset(&vformat, 0, sizeof(vformat));
   235 	if ( video->VideoInit(video, &vformat) < 0 ) {
   236 		SDL_VideoQuit();
   237 		return(-1);
   238 	}
   239 
   240 	/* Create a zero sized video surface of the appropriate format */
   241 	video_flags = SDL_SWSURFACE;
   242 	SDL_VideoSurface = SDL_CreateRGBSurface(video_flags, 0, 0,
   243 				vformat.BitsPerPixel,
   244 				vformat.Rmask, vformat.Gmask, vformat.Bmask, 0);
   245 	if ( SDL_VideoSurface == NULL ) {
   246 		SDL_VideoQuit();
   247 		return(-1);
   248 	}
   249 	SDL_PublicSurface = NULL;	/* Until SDL_SetVideoMode() */
   250 
   251 #if 0 /* Don't change the current palette - may be used by other programs.
   252        * The application can't do anything with the display surface until
   253        * a video mode has been set anyway. :)
   254        */
   255 	/* If we have a palettized surface, create a default palette */
   256 	if ( SDL_VideoSurface->format->palette ) {
   257 		SDL_PixelFormat *vf = SDL_VideoSurface->format;
   258 		SDL_DitherColors(vf->palette->colors, vf->BitsPerPixel);
   259 		video->SetColors(video,
   260 				 0, vf->palette->ncolors, vf->palette->colors);
   261 	}
   262 #endif
   263 	video->info.vfmt = SDL_VideoSurface->format;
   264 
   265 	/* Start the event loop */
   266 	if ( SDL_StartEventLoop(flags) < 0 ) {
   267 		SDL_VideoQuit();
   268 		return(-1);
   269 	}
   270 	SDL_CursorInit(flags & SDL_INIT_EVENTTHREAD);
   271 
   272 	/* We're ready to go! */
   273 	return(0);
   274 }
   275 
   276 char *SDL_VideoDriverName(char *namebuf, int maxlen)
   277 {
   278 	if ( current_video != NULL ) {
   279 		SDL_strlcpy(namebuf, current_video->name, maxlen);
   280 		return(namebuf);
   281 	}
   282 	return(NULL);
   283 }
   284 
   285 /*
   286  * Get the current display surface
   287  */
   288 SDL_Surface *SDL_GetVideoSurface(void)
   289 {
   290 	SDL_Surface *visible;
   291 
   292 	visible = NULL;
   293 	if ( current_video ) {
   294 		visible = current_video->visible;
   295 	}
   296 	return(visible);
   297 }
   298 
   299 /*
   300  * Get the current information about the video hardware
   301  */
   302 const SDL_VideoInfo *SDL_GetVideoInfo(void)
   303 {
   304 	const SDL_VideoInfo *info;
   305 
   306 	info = NULL;
   307 	if ( current_video ) {
   308 		info = &current_video->info;
   309 	}
   310 	return(info);
   311 }
   312 
   313 /*
   314  * Return a pointer to an array of available screen dimensions for the
   315  * given format, sorted largest to smallest.  Returns NULL if there are
   316  * no dimensions available for a particular format, or (SDL_Rect **)-1
   317  * if any dimension is okay for the given format.  If 'format' is NULL,
   318  * the mode list will be for the format given by SDL_GetVideoInfo()->vfmt
   319  */
   320 SDL_Rect ** SDL_ListModes (SDL_PixelFormat *format, Uint32 flags)
   321 {
   322 	SDL_VideoDevice *video = current_video;
   323 	SDL_VideoDevice *this  = current_video;
   324 	SDL_Rect **modes;
   325 
   326 	modes = NULL;
   327 	if ( SDL_VideoSurface ) {
   328 		if ( format == NULL ) {
   329 			format = SDL_VideoSurface->format;
   330 		}
   331 		modes = video->ListModes(this, format, flags);
   332 	}
   333 	return(modes);
   334 }
   335 
   336 /*
   337  * Check to see if a particular video mode is supported.
   338  * It returns 0 if the requested mode is not supported under any bit depth,
   339  * or returns the bits-per-pixel of the closest available mode with the
   340  * given width and height.  If this bits-per-pixel is different from the
   341  * one used when setting the video mode, SDL_SetVideoMode() will succeed,
   342  * but will emulate the requested bits-per-pixel with a shadow surface.
   343  */
   344 static Uint8 SDL_closest_depths[4][8] = {
   345 	/* 8 bit closest depth ordering */
   346 	{ 0, 8, 16, 15, 32, 24, 0, 0 },
   347 	/* 15,16 bit closest depth ordering */
   348 	{ 0, 16, 15, 32, 24, 8, 0, 0 },
   349 	/* 24 bit closest depth ordering */
   350 	{ 0, 24, 32, 16, 15, 8, 0, 0 },
   351 	/* 32 bit closest depth ordering */
   352 	{ 0, 32, 16, 15, 24, 8, 0, 0 }
   353 };
   354 
   355 
   356 #ifdef __MACOS__ /* MPW optimization bug? */
   357 #define NEGATIVE_ONE 0xFFFFFFFF
   358 #else
   359 #define NEGATIVE_ONE -1
   360 #endif
   361 
   362 int SDL_VideoModeOK (int width, int height, int bpp, Uint32 flags)
   363 {
   364 	int table, b, i;
   365 	int supported;
   366 	SDL_PixelFormat format;
   367 	SDL_Rect **sizes;
   368 
   369 	/* Currently 1 and 4 bpp are not supported */
   370 	if ( bpp < 8 || bpp > 32 ) {
   371 		return(0);
   372 	}
   373 	if ( (width <= 0) || (height <= 0) ) {
   374 		return(0);
   375 	}
   376 
   377 	/* Search through the list valid of modes */
   378 	SDL_memset(&format, 0, sizeof(format));
   379 	supported = 0;
   380 	table = ((bpp+7)/8)-1;
   381 	SDL_closest_depths[table][0] = bpp;
   382 	SDL_closest_depths[table][7] = 0;
   383 	for ( b = 0; !supported && SDL_closest_depths[table][b]; ++b ) {
   384 		format.BitsPerPixel = SDL_closest_depths[table][b];
   385 		sizes = SDL_ListModes(&format, flags);
   386 		if ( sizes == (SDL_Rect **)0 ) {
   387 			/* No sizes supported at this bit-depth */
   388 			continue;
   389 		} else 
   390 		if (sizes == (SDL_Rect **)NEGATIVE_ONE) {
   391 			/* Any size supported at this bit-depth */
   392 			supported = 1;
   393 			continue;
   394 		} else if (current_video->handles_any_size) {
   395 			/* Driver can center a smaller surface to simulate fullscreen */
   396 			for ( i=0; sizes[i]; ++i ) {
   397 				if ((sizes[i]->w >= width) && (sizes[i]->h >= height)) {
   398 					supported = 1; /* this mode can fit the centered window. */
   399 					break;
   400 				}
   401 			}
   402 		} else
   403 		for ( i=0; sizes[i]; ++i ) {
   404 			if ((sizes[i]->w == width) && (sizes[i]->h == height)) {
   405 				supported = 1;
   406 				break;
   407 			}
   408 		}
   409 	}
   410 	if ( supported ) {
   411 		--b;
   412 		return(SDL_closest_depths[table][b]);
   413 	} else {
   414 		return(0);
   415 	}
   416 }
   417 
   418 /*
   419  * Get the closest non-emulated video mode to the one requested
   420  */
   421 static int SDL_GetVideoMode (int *w, int *h, int *BitsPerPixel, Uint32 flags)
   422 {
   423 	int table, b, i;
   424 	int supported;
   425 	int native_bpp;
   426 	SDL_PixelFormat format;
   427 	SDL_Rect **sizes;
   428 
   429 	/* Check parameters */
   430 	if ( *BitsPerPixel < 8 || *BitsPerPixel > 32 ) {
   431 		SDL_SetError("Invalid bits per pixel (range is {8...32})");
   432 		return(0);
   433 	}
   434 	if ((*w <= 0) || (*h <= 0)) {
   435 		SDL_SetError("Invalid width or height");
   436 		return(0);
   437 	}
   438 
   439 	/* Try the original video mode, get the closest depth */
   440 	native_bpp = SDL_VideoModeOK(*w, *h, *BitsPerPixel, flags);
   441 	if ( native_bpp == *BitsPerPixel ) {
   442 		return(1);
   443 	}
   444 	if ( native_bpp > 0 ) {
   445 		*BitsPerPixel = native_bpp;
   446 		return(1);
   447 	}
   448 
   449 	/* No exact size match at any depth, look for closest match */
   450 	SDL_memset(&format, 0, sizeof(format));
   451 	supported = 0;
   452 	table = ((*BitsPerPixel+7)/8)-1;
   453 	SDL_closest_depths[table][0] = *BitsPerPixel;
   454 	SDL_closest_depths[table][7] = SDL_VideoSurface->format->BitsPerPixel;
   455 	for ( b = 0; !supported && SDL_closest_depths[table][b]; ++b ) {
   456 		int best;
   457 
   458 		format.BitsPerPixel = SDL_closest_depths[table][b];
   459 		sizes = SDL_ListModes(&format, flags);
   460 		if ( sizes == (SDL_Rect **)0 ) {
   461 			/* No sizes supported at this bit-depth */
   462 			continue;
   463 		}
   464 		best=0;
   465 		for ( i=0; sizes[i]; ++i ) {
   466 			/* Mode with both dimensions bigger or equal than asked ? */
   467 			if ((sizes[i]->w >= *w) && (sizes[i]->h >= *h)) {
   468 				/* Mode with any dimension smaller or equal than current best ? */
   469 				if ((sizes[i]->w <= sizes[best]->w) || (sizes[i]->h <= sizes[best]->h)) {
   470 					/* Now choose the mode that has less pixels */
   471 					if ((sizes[i]->w * sizes[i]->h) <= (sizes[best]->w * sizes[best]->h)) {
   472 						best=i;
   473 						supported = 1;
   474 					}
   475 				}
   476 			}
   477 		}
   478 		if (supported) {
   479 			*w=sizes[best]->w;
   480 			*h=sizes[best]->h;
   481 			*BitsPerPixel = SDL_closest_depths[table][b];
   482 		}
   483 	}
   484 	if ( ! supported ) {
   485 		SDL_SetError("No video mode large enough for %dx%d", *w, *h);
   486 	}
   487 	return(supported);
   488 }
   489 
   490 /* This should probably go somewhere else -- like SDL_surface.c */
   491 static void SDL_ClearSurface(SDL_Surface *surface)
   492 {
   493 	Uint32 black;
   494 
   495 	black = SDL_MapRGB(surface->format, 0, 0, 0);
   496 	SDL_FillRect(surface, NULL, black);
   497 	if ((surface->flags&SDL_HWSURFACE) && (surface->flags&SDL_DOUBLEBUF)) {
   498 		SDL_Flip(surface);
   499 		SDL_FillRect(surface, NULL, black);
   500 	}
   501 	SDL_Flip(surface);
   502 }
   503 
   504 /*
   505  * Create a shadow surface suitable for fooling the app. :-)
   506  */
   507 static void SDL_CreateShadowSurface(int depth)
   508 {
   509 	Uint32 Rmask, Gmask, Bmask;
   510 
   511 	/* Allocate the shadow surface */
   512 	if ( depth == (SDL_VideoSurface->format)->BitsPerPixel ) {
   513 		Rmask = (SDL_VideoSurface->format)->Rmask;
   514 		Gmask = (SDL_VideoSurface->format)->Gmask;
   515 		Bmask = (SDL_VideoSurface->format)->Bmask;
   516 	} else {
   517 		Rmask = Gmask = Bmask = 0;
   518 	}
   519 	SDL_ShadowSurface = SDL_CreateRGBSurface(SDL_SWSURFACE,
   520 				SDL_VideoSurface->w, SDL_VideoSurface->h,
   521 						depth, Rmask, Gmask, Bmask, 0);
   522 	if ( SDL_ShadowSurface == NULL ) {
   523 		return;
   524 	}
   525 
   526 	/* 8-bit shadow surfaces report that they have exclusive palette */
   527 	if ( SDL_ShadowSurface->format->palette ) {
   528 		SDL_ShadowSurface->flags |= SDL_HWPALETTE;
   529 		if ( depth == (SDL_VideoSurface->format)->BitsPerPixel ) {
   530 			SDL_memcpy(SDL_ShadowSurface->format->palette->colors,
   531 				SDL_VideoSurface->format->palette->colors,
   532 				SDL_VideoSurface->format->palette->ncolors*
   533 							sizeof(SDL_Color));
   534 		} else {
   535 			SDL_DitherColors(
   536 			SDL_ShadowSurface->format->palette->colors, depth);
   537 		}
   538 	}
   539 
   540 	/* If the video surface is resizable, the shadow should say so */
   541 	if ( (SDL_VideoSurface->flags & SDL_RESIZABLE) == SDL_RESIZABLE ) {
   542 		SDL_ShadowSurface->flags |= SDL_RESIZABLE;
   543 	}
   544 	/* If the video surface has no frame, the shadow should say so */
   545 	if ( (SDL_VideoSurface->flags & SDL_NOFRAME) == SDL_NOFRAME ) {
   546 		SDL_ShadowSurface->flags |= SDL_NOFRAME;
   547 	}
   548 	/* If the video surface is fullscreen, the shadow should say so */
   549 	if ( (SDL_VideoSurface->flags & SDL_FULLSCREEN) == SDL_FULLSCREEN ) {
   550 		SDL_ShadowSurface->flags |= SDL_FULLSCREEN;
   551 	}
   552 	/* If the video surface is flippable, the shadow should say so */
   553 	if ( (SDL_VideoSurface->flags & SDL_DOUBLEBUF) == SDL_DOUBLEBUF ) {
   554 		SDL_ShadowSurface->flags |= SDL_DOUBLEBUF;
   555 	}
   556 	return;
   557 }
   558 
   559 #ifdef __QNXNTO__
   560     #include <sys/neutrino.h>
   561 #endif /* __QNXNTO__ */
   562 
   563 /*
   564  * Set the requested video mode, allocating a shadow buffer if necessary.
   565  */
   566 SDL_Surface * SDL_SetVideoMode (int width, int height, int bpp, Uint32 flags)
   567 {
   568 	SDL_VideoDevice *video, *this;
   569 	SDL_Surface *prev_mode, *mode;
   570 	int video_w;
   571 	int video_h;
   572 	int video_bpp;
   573 	int is_opengl;
   574 	SDL_GrabMode saved_grab;
   575 
   576 	/* Handle obsolete flags */
   577 	if ( (flags & SDL_OPENGLBLIT_OBSOLETE) == SDL_OPENGLBLIT_OBSOLETE ) {
   578 		SDL_SetError("SDL_OPENGLBLIT is no longer supported");
   579 		return(NULL);
   580 	}
   581 
   582 	/* Start up the video driver, if necessary..
   583 	   WARNING: This is the only function protected this way!
   584 	 */
   585 	if ( ! current_video ) {
   586 		if ( SDL_Init(SDL_INIT_VIDEO|SDL_INIT_NOPARACHUTE) < 0 ) {
   587 			return(NULL);
   588 		}
   589 	}
   590 	this = video = current_video;
   591 
   592 	/* Default to the current width and height */
   593 	if ( width == 0 ) {
   594 		width = video->info.current_w;
   595 	}
   596 	if ( height == 0 ) {
   597 		height = video->info.current_h;
   598 	}
   599 	/* Default to the current video bpp */
   600 	if ( bpp == 0 ) {
   601 		flags |= SDL_ANYFORMAT;
   602 		bpp = SDL_VideoSurface->format->BitsPerPixel;
   603 	}
   604 
   605 	/* Get a good video mode, the closest one possible */
   606 	video_w = width;
   607 	video_h = height;
   608 	video_bpp = bpp;
   609 	if ( ! SDL_GetVideoMode(&video_w, &video_h, &video_bpp, flags) ) {
   610 		return(NULL);
   611 	}
   612 
   613 	/* Check the requested flags */
   614 	/* There's no palette in > 8 bits-per-pixel mode */
   615 	if ( video_bpp > 8 ) {
   616 		flags &= ~SDL_HWPALETTE;
   617 	}
   618 #if 0
   619 	if ( (flags&SDL_FULLSCREEN) != SDL_FULLSCREEN ) {
   620 		/* There's no windowed double-buffering */
   621 		flags &= ~SDL_DOUBLEBUF;
   622 	}
   623 #endif
   624 	if ( (flags&SDL_DOUBLEBUF) == SDL_DOUBLEBUF ) {
   625 		/* Use hardware surfaces when double-buffering */
   626 		flags |= SDL_HWSURFACE;
   627 	}
   628 
   629 	is_opengl = ( ( flags & SDL_OPENGL ) == SDL_OPENGL );
   630 	if ( is_opengl ) {
   631 		/* These flags are for 2D video modes only */
   632 		flags &= ~(SDL_HWSURFACE|SDL_DOUBLEBUF);
   633 	}
   634 
   635 	/* Reset the keyboard here so event callbacks can run */
   636 	SDL_ResetKeyboard();
   637 	SDL_ResetMouse();
   638 	SDL_cursorstate &= ~CURSOR_USINGSW;
   639 
   640 	/* Clean up any previous video mode */
   641 	if ( SDL_PublicSurface != NULL ) {
   642 		SDL_PublicSurface = NULL;
   643 	}
   644 	if ( SDL_ShadowSurface != NULL ) {
   645 		SDL_Surface *ready_to_go;
   646 		ready_to_go = SDL_ShadowSurface;
   647 		SDL_ShadowSurface = NULL;
   648 		SDL_FreeSurface(ready_to_go);
   649 	}
   650 	if ( video->physpal ) {
   651 		SDL_free(video->physpal->colors);
   652 		SDL_free(video->physpal);
   653 		video->physpal = NULL;
   654 	}
   655 	if( video->gammacols) {
   656 		SDL_free(video->gammacols);
   657 		video->gammacols = NULL;
   658 	}
   659 
   660 	/* Save the previous grab state and turn off grab for mode switch */
   661 	saved_grab = SDL_WM_GrabInputOff();
   662 
   663 	/* Try to set the video mode, along with offset and clipping */
   664 	prev_mode = SDL_VideoSurface;
   665 	SDL_LockCursor();
   666 	SDL_VideoSurface = NULL;	/* In case it's freed by driver */
   667 	mode = video->SetVideoMode(this, prev_mode,video_w,video_h,video_bpp,flags);
   668 	if ( mode ) { /* Prevent resize events from mode change */
   669           /* But not on OS/2 */
   670 #ifndef __OS2__
   671 	    SDL_PrivateResize(mode->w, mode->h);
   672 #endif
   673 
   674 	    /* Sam - If we asked for OpenGL mode, and didn't get it, fail */
   675 	    if ( is_opengl && !(mode->flags & SDL_OPENGL) ) {
   676 		mode = NULL;
   677 		SDL_SetError("OpenGL not available");
   678 	    }
   679 	}
   680 	/*
   681 	 * rcg11292000
   682 	 * If you try to set an SDL_OPENGL surface, and fail to find a
   683 	 * matching  visual, then the next call to SDL_SetVideoMode()
   684 	 * will segfault, since  we no longer point to a dummy surface,
   685 	 * but rather NULL.
   686 	 * Sam 11/29/00
   687 	 * WARNING, we need to make sure that the previous mode hasn't
   688 	 * already been freed by the video driver.  What do we do in
   689 	 * that case?  Should we call SDL_VideoInit() again?
   690 	 */
   691 	SDL_VideoSurface = (mode != NULL) ? mode : prev_mode;
   692 
   693 	if ( (mode != NULL) && (!is_opengl) ) {
   694 		/* Sanity check */
   695 		if ( (mode->w < width) || (mode->h < height) ) {
   696 			SDL_SetError("Video mode smaller than requested");
   697 			return(NULL);
   698 		}
   699 
   700 		/* If we have a palettized surface, create a default palette */
   701 		if ( mode->format->palette ) {
   702 			SDL_PixelFormat *vf = mode->format;
   703 			SDL_DitherColors(vf->palette->colors, vf->BitsPerPixel);
   704 			video->SetColors(this, 0, vf->palette->ncolors,
   705 			                           vf->palette->colors);
   706 		}
   707 
   708 		/* Clear the surface to black */
   709 		video->offset_x = 0;
   710 		video->offset_y = 0;
   711 		mode->offset = 0;
   712 		SDL_SetClipRect(mode, NULL);
   713 		SDL_ClearSurface(mode);
   714 
   715 		/* Now adjust the offsets to match the desired mode */
   716 		video->offset_x = (mode->w-width)/2;
   717 		video->offset_y = (mode->h-height)/2;
   718 		mode->offset = video->offset_y*mode->pitch +
   719 				video->offset_x*mode->format->BytesPerPixel;
   720 #ifdef DEBUG_VIDEO
   721   fprintf(stderr,
   722 	"Requested mode: %dx%dx%d, obtained mode %dx%dx%d (offset %d)\n",
   723 		width, height, bpp,
   724 		mode->w, mode->h, mode->format->BitsPerPixel, mode->offset);
   725 #endif
   726 		mode->w = width;
   727 		mode->h = height;
   728 		SDL_SetClipRect(mode, NULL);
   729 	}
   730 	SDL_ResetCursor();
   731 	SDL_UnlockCursor();
   732 
   733 	/* If we failed setting a video mode, return NULL... (Uh Oh!) */
   734 	if ( mode == NULL ) {
   735 		return(NULL);
   736 	}
   737 
   738 	/* If there is no window manager, set the SDL_NOFRAME flag */
   739 	if ( ! video->info.wm_available ) {
   740 		mode->flags |= SDL_NOFRAME;
   741 	}
   742 
   743 	/* Reset the mouse cursor and grab for new video mode */
   744 	SDL_SetCursor(NULL);
   745 	if ( video->UpdateMouse ) {
   746 		video->UpdateMouse(this);
   747 	}
   748 	SDL_WM_GrabInput(saved_grab);
   749 	SDL_GetRelativeMouseState(NULL, NULL); /* Clear first large delta */
   750 
   751 #if SDL_VIDEO_OPENGL
   752 	/* Load GL symbols (before MakeCurrent, where we need glGetString). */
   753 	if ( flags & SDL_OPENGL ) {
   754 
   755 #if defined(__QNXNTO__) && (_NTO_VERSION < 630)
   756 #define __SDL_NOGETPROCADDR__
   757 #elif defined(__MINT__)
   758 #define __SDL_NOGETPROCADDR__
   759 #endif
   760 #ifdef __SDL_NOGETPROCADDR__
   761     #define SDL_PROC(ret,func,params) video->func=func;
   762 #else
   763     #define SDL_PROC(ret,func,params) \
   764     do { \
   765         video->func = SDL_GL_GetProcAddress(#func); \
   766         if ( ! video->func ) { \
   767             SDL_SetError("Couldn't load GL function %s: %s\n", #func, SDL_GetError()); \
   768         return(NULL); \
   769         } \
   770     } while ( 0 );
   771 
   772 #endif /* __SDL_NOGETPROCADDR__ */
   773 
   774 #include "SDL_glfuncs.h"
   775 #undef SDL_PROC	
   776 	}
   777 #endif /* SDL_VIDEO_OPENGL */
   778 
   779 	/* If we're running OpenGL, make the context current */
   780 	if ( (video->screen->flags & SDL_OPENGL) &&
   781 	      video->GL_MakeCurrent ) {
   782 		if ( video->GL_MakeCurrent(this) < 0 ) {
   783 			return(NULL);
   784 		}
   785 	}
   786 
   787 	/* Create a shadow surface if necessary */
   788 	/* There are three conditions under which we create a shadow surface:
   789 		1.  We need a particular bits-per-pixel that we didn't get.
   790 		2.  We need a hardware palette and didn't get one.
   791 		3.  We need a software surface and got a hardware surface.
   792 	*/
   793 	if ( !(SDL_VideoSurface->flags & SDL_OPENGL) &&
   794 	     (
   795 	     (  !(flags&SDL_ANYFORMAT) &&
   796 			(SDL_VideoSurface->format->BitsPerPixel != bpp)) ||
   797 	     (   (flags&SDL_HWPALETTE) && 
   798 				!(SDL_VideoSurface->flags&SDL_HWPALETTE)) ||
   799 		/* If the surface is in hardware, video writes are visible
   800 		   as soon as they are performed, so we need to buffer them
   801 		 */
   802 	     (   ((flags&SDL_HWSURFACE) == SDL_SWSURFACE) &&
   803 				(SDL_VideoSurface->flags&SDL_HWSURFACE)) ||
   804 	     (   (flags&SDL_DOUBLEBUF) &&
   805 				(SDL_VideoSurface->flags&SDL_HWSURFACE) &&
   806 				!(SDL_VideoSurface->flags&SDL_DOUBLEBUF))
   807 	     ) ) {
   808 		SDL_CreateShadowSurface(bpp);
   809 		if ( SDL_ShadowSurface == NULL ) {
   810 			SDL_SetError("Couldn't create shadow surface");
   811 			return(NULL);
   812 		}
   813 		SDL_PublicSurface = SDL_ShadowSurface;
   814 	} else {
   815 		SDL_PublicSurface = SDL_VideoSurface;
   816 	}
   817 	video->info.vfmt = SDL_VideoSurface->format;
   818 	video->info.current_w = SDL_VideoSurface->w;
   819 	video->info.current_h = SDL_VideoSurface->h;
   820 
   821 	/* We're done! */
   822 	return(SDL_PublicSurface);
   823 }
   824 
   825 /* 
   826  * Convert a surface into the video pixel format.
   827  */
   828 SDL_Surface * SDL_DisplayFormat (SDL_Surface *surface)
   829 {
   830 	Uint32 flags;
   831 
   832 	if ( ! SDL_PublicSurface ) {
   833 		SDL_SetError("No video mode has been set");
   834 		return(NULL);
   835 	}
   836 	/* Set the flags appropriate for copying to display surface */
   837 	if (((SDL_PublicSurface->flags&SDL_HWSURFACE) == SDL_HWSURFACE) && current_video->info.blit_hw)
   838 		flags = SDL_HWSURFACE;
   839 	else 
   840 		flags = SDL_SWSURFACE;
   841 #ifdef AUTORLE_DISPLAYFORMAT
   842 	flags |= (surface->flags & (SDL_SRCCOLORKEY|SDL_SRCALPHA));
   843 	flags |= SDL_RLEACCELOK;
   844 #else
   845 	flags |= surface->flags & (SDL_SRCCOLORKEY|SDL_SRCALPHA|SDL_RLEACCELOK);
   846 #endif
   847 	return(SDL_ConvertSurface(surface, SDL_PublicSurface->format, flags));
   848 }
   849 
   850 /*
   851  * Convert a surface into a format that's suitable for blitting to
   852  * the screen, but including an alpha channel.
   853  */
   854 SDL_Surface *SDL_DisplayFormatAlpha(SDL_Surface *surface)
   855 {
   856 	SDL_PixelFormat *vf;
   857 	SDL_PixelFormat *format;
   858 	SDL_Surface *converted;
   859 	Uint32 flags;
   860 	/* default to ARGB8888 */
   861 	Uint32 amask = 0xff000000;
   862 	Uint32 rmask = 0x00ff0000;
   863 	Uint32 gmask = 0x0000ff00;
   864 	Uint32 bmask = 0x000000ff;
   865 
   866 	if ( ! SDL_PublicSurface ) {
   867 		SDL_SetError("No video mode has been set");
   868 		return(NULL);
   869 	}
   870 	vf = SDL_PublicSurface->format;
   871 
   872 	switch(vf->BytesPerPixel) {
   873 	    case 2:
   874 		/* For XGY5[56]5, use, AXGY8888, where {X, Y} = {R, B}.
   875 		   For anything else (like ARGB4444) it doesn't matter
   876 		   since we have no special code for it anyway */
   877 		if ( (vf->Rmask == 0x1f) &&
   878 		     (vf->Bmask == 0xf800 || vf->Bmask == 0x7c00)) {
   879 			rmask = 0xff;
   880 			bmask = 0xff0000;
   881 		}
   882 		break;
   883 
   884 	    case 3:
   885 	    case 4:
   886 		/* Keep the video format, as long as the high 8 bits are
   887 		   unused or alpha */
   888 		if ( (vf->Rmask == 0xff) && (vf->Bmask == 0xff0000) ) {
   889 			rmask = 0xff;
   890 			bmask = 0xff0000;
   891 		}
   892 		break;
   893 
   894 	    default:
   895 		/* We have no other optimised formats right now. When/if a new
   896 		   optimised alpha format is written, add the converter here */
   897 		break;
   898 	}
   899 	format = SDL_AllocFormat(32, rmask, gmask, bmask, amask);
   900 	flags = SDL_PublicSurface->flags & SDL_HWSURFACE;
   901 	flags |= surface->flags & (SDL_SRCALPHA | SDL_RLEACCELOK);
   902 	converted = SDL_ConvertSurface(surface, format, flags);
   903 	SDL_FreeFormat(format);
   904 	return(converted);
   905 }
   906 
   907 /*
   908  * Update a specific portion of the physical screen
   909  */
   910 void SDL_UpdateRect(SDL_Surface *screen, Sint32 x, Sint32 y, Uint32 w, Uint32 h)
   911 {
   912 	if ( screen ) {
   913 		SDL_Rect rect;
   914 
   915 		/* Perform some checking */
   916 		if ( w == 0 )
   917 			w = screen->w;
   918 		if ( h == 0 )
   919 			h = screen->h;
   920 		if ( (int)(x+w) > screen->w )
   921 			return;
   922 		if ( (int)(y+h) > screen->h )
   923 			return;
   924 
   925 		/* Fill the rectangle */
   926 		rect.x = (Sint16)x;
   927 		rect.y = (Sint16)y;
   928 		rect.w = (Uint16)w;
   929 		rect.h = (Uint16)h;
   930 		SDL_UpdateRects(screen, 1, &rect);
   931 	}
   932 }
   933 void SDL_UpdateRects (SDL_Surface *screen, int numrects, SDL_Rect *rects)
   934 {
   935 	int i;
   936 	SDL_VideoDevice *video = current_video;
   937 	SDL_VideoDevice *this = current_video;
   938 
   939 	if ( screen->flags & SDL_OPENGL ) {
   940 		SDL_SetError("OpenGL active, use SDL_GL_SwapBuffers()");
   941 		return;
   942 	}
   943 	if ( screen == SDL_ShadowSurface ) {
   944 		/* Blit the shadow surface using saved mapping */
   945 		SDL_Palette *pal = screen->format->palette;
   946 		SDL_Color *saved_colors = NULL;
   947 		if ( pal && !(SDL_VideoSurface->flags & SDL_HWPALETTE) ) {
   948 			/* simulated 8bpp, use correct physical palette */
   949 			saved_colors = pal->colors;
   950 			if ( video->gammacols ) {
   951 				/* gamma-corrected palette */
   952 				pal->colors = video->gammacols;
   953 			} else if ( video->physpal ) {
   954 				/* physical palette different from logical */
   955 				pal->colors = video->physpal->colors;
   956 			}
   957 		}
   958 		if ( SHOULD_DRAWCURSOR(SDL_cursorstate) ) {
   959 			SDL_LockCursor();
   960 			SDL_DrawCursor(SDL_ShadowSurface);
   961 			for ( i=0; i<numrects; ++i ) {
   962 				SDL_LowerBlit(SDL_ShadowSurface, &rects[i], 
   963 						SDL_VideoSurface, &rects[i]);
   964 			}
   965 			SDL_EraseCursor(SDL_ShadowSurface);
   966 			SDL_UnlockCursor();
   967 		} else {
   968 			for ( i=0; i<numrects; ++i ) {
   969 				SDL_LowerBlit(SDL_ShadowSurface, &rects[i], 
   970 						SDL_VideoSurface, &rects[i]);
   971 			}
   972 		}
   973 		if ( saved_colors ) {
   974 			pal->colors = saved_colors;
   975 		}
   976 
   977 		/* Fall through to video surface update */
   978 		screen = SDL_VideoSurface;
   979 	}
   980 	if ( screen == SDL_VideoSurface ) {
   981 		/* Update the video surface */
   982 		if ( screen->offset ) {
   983 			for ( i=0; i<numrects; ++i ) {
   984 				rects[i].x += video->offset_x;
   985 				rects[i].y += video->offset_y;
   986 			}
   987 			video->UpdateRects(this, numrects, rects);
   988 			for ( i=0; i<numrects; ++i ) {
   989 				rects[i].x -= video->offset_x;
   990 				rects[i].y -= video->offset_y;
   991 			}
   992 		} else {
   993 			video->UpdateRects(this, numrects, rects);
   994 		}
   995 	}
   996 }
   997 
   998 /*
   999  * Performs hardware double buffering, if possible, or a full update if not.
  1000  */
  1001 int SDL_Flip(SDL_Surface *screen)
  1002 {
  1003 	SDL_VideoDevice *video = current_video;
  1004 	/* Copy the shadow surface to the video surface */
  1005 	if ( screen == SDL_ShadowSurface ) {
  1006 		SDL_Rect rect;
  1007 		SDL_Palette *pal = screen->format->palette;
  1008 		SDL_Color *saved_colors = NULL;
  1009 		if ( pal && !(SDL_VideoSurface->flags & SDL_HWPALETTE) ) {
  1010 			/* simulated 8bpp, use correct physical palette */
  1011 			saved_colors = pal->colors;
  1012 			if ( video->gammacols ) {
  1013 				/* gamma-corrected palette */
  1014 				pal->colors = video->gammacols;
  1015 			} else if ( video->physpal ) {
  1016 				/* physical palette different from logical */
  1017 				pal->colors = video->physpal->colors;
  1018 			}
  1019 		}
  1020 
  1021 		rect.x = 0;
  1022 		rect.y = 0;
  1023 		rect.w = screen->w;
  1024 		rect.h = screen->h;
  1025 		if ( SHOULD_DRAWCURSOR(SDL_cursorstate) ) {
  1026 			SDL_LockCursor();
  1027 			SDL_DrawCursor(SDL_ShadowSurface);
  1028 			SDL_LowerBlit(SDL_ShadowSurface, &rect,
  1029 					SDL_VideoSurface, &rect);
  1030 			SDL_EraseCursor(SDL_ShadowSurface);
  1031 			SDL_UnlockCursor();
  1032 		} else {
  1033 			SDL_LowerBlit(SDL_ShadowSurface, &rect,
  1034 					SDL_VideoSurface, &rect);
  1035 		}
  1036 		if ( saved_colors ) {
  1037 			pal->colors = saved_colors;
  1038 		}
  1039 
  1040 		/* Fall through to video surface update */
  1041 		screen = SDL_VideoSurface;
  1042 	}
  1043 	if ( (screen->flags & SDL_DOUBLEBUF) == SDL_DOUBLEBUF ) {
  1044 		SDL_VideoDevice *this  = current_video;
  1045 		return(video->FlipHWSurface(this, SDL_VideoSurface));
  1046 	} else {
  1047 		SDL_UpdateRect(screen, 0, 0, 0, 0);
  1048 	}
  1049 	return(0);
  1050 }
  1051 
  1052 static void SetPalette_logical(SDL_Surface *screen, SDL_Color *colors,
  1053 			       int firstcolor, int ncolors)
  1054 {
  1055 	SDL_Palette *pal = screen->format->palette;
  1056 	SDL_Palette *vidpal;
  1057 
  1058 	if ( colors != (pal->colors + firstcolor) ) {
  1059 		SDL_memcpy(pal->colors + firstcolor, colors,
  1060 		       ncolors * sizeof(*colors));
  1061 	}
  1062 
  1063 	vidpal = SDL_VideoSurface->format->palette;
  1064 	if ( (screen == SDL_ShadowSurface) && vidpal ) {
  1065 		/*
  1066 		 * This is a shadow surface, and the physical
  1067 		 * framebuffer is also indexed. Propagate the
  1068 		 * changes to its logical palette so that
  1069 		 * updates are always identity blits
  1070 		 */
  1071 		SDL_memcpy(vidpal->colors + firstcolor, colors,
  1072 		       ncolors * sizeof(*colors));
  1073 	}
  1074 	SDL_FormatChanged(screen);
  1075 }
  1076 
  1077 static int SetPalette_physical(SDL_Surface *screen,
  1078                                SDL_Color *colors, int firstcolor, int ncolors)
  1079 {
  1080 	SDL_VideoDevice *video = current_video;
  1081 	int gotall = 1;
  1082 
  1083 	if ( video->physpal ) {
  1084 		/* We need to copy the new colors, since we haven't
  1085 		 * already done the copy in the logical set above.
  1086 		 */
  1087 		SDL_memcpy(video->physpal->colors + firstcolor,
  1088 		       colors, ncolors * sizeof(*colors));
  1089 	}
  1090 	if ( screen == SDL_ShadowSurface ) {
  1091 		if ( SDL_VideoSurface->flags & SDL_HWPALETTE ) {
  1092 			/*
  1093 			 * The real screen is also indexed - set its physical
  1094 			 * palette. The physical palette does not include the
  1095 			 * gamma modification, we apply it directly instead,
  1096 			 * but this only happens if we have hardware palette.
  1097 			 */
  1098 			screen = SDL_VideoSurface;
  1099 		} else {
  1100 			/*
  1101 			 * The video surface is not indexed - invalidate any
  1102 			 * active shadow-to-video blit mappings.
  1103 			 */
  1104 			if ( screen->map->dst == SDL_VideoSurface ) {
  1105 				SDL_InvalidateMap(screen->map);
  1106 			}
  1107 			if ( video->gamma ) {
  1108 				if( ! video->gammacols ) {
  1109 					SDL_Palette *pp = video->physpal;
  1110 					if(!pp)
  1111 						pp = screen->format->palette;
  1112 					video->gammacols = SDL_malloc(pp->ncolors
  1113 							  * sizeof(SDL_Color));
  1114 					SDL_ApplyGamma(video->gamma,
  1115 						       pp->colors,
  1116 						       video->gammacols,
  1117 						       pp->ncolors);
  1118 				} else {
  1119 					SDL_ApplyGamma(video->gamma, colors,
  1120 						       video->gammacols
  1121 						       + firstcolor,
  1122 						       ncolors);
  1123 				}
  1124 			}
  1125 			SDL_UpdateRect(screen, 0, 0, 0, 0);
  1126 		}
  1127 	}
  1128 
  1129 	if ( screen == SDL_VideoSurface ) {
  1130 		SDL_Color gcolors[256];
  1131 
  1132 		if ( video->gamma ) {
  1133 			SDL_ApplyGamma(video->gamma, colors, gcolors, ncolors);
  1134 			colors = gcolors;
  1135 		}
  1136 		gotall = video->SetColors(video, firstcolor, ncolors, colors);
  1137 		if ( ! gotall ) {
  1138 			/* The video flags shouldn't have SDL_HWPALETTE, and
  1139 			   the video driver is responsible for copying back the
  1140 			   correct colors into the video surface palette.
  1141 			*/
  1142 			;
  1143 		}
  1144 		SDL_CursorPaletteChanged();
  1145 	}
  1146 	return gotall;
  1147 }
  1148 
  1149 /*
  1150  * Set the physical and/or logical colormap of a surface:
  1151  * Only the screen has a physical colormap. It determines what is actually
  1152  * sent to the display.
  1153  * The logical colormap is used to map blits to/from the surface.
  1154  * 'which' is one or both of SDL_LOGPAL, SDL_PHYSPAL
  1155  *
  1156  * Return nonzero if all colours were set as requested, or 0 otherwise.
  1157  */
  1158 int SDL_SetPalette(SDL_Surface *screen, int which,
  1159 		   SDL_Color *colors, int firstcolor, int ncolors)
  1160 {
  1161 	SDL_Palette *pal;
  1162 	int gotall;
  1163 	int palsize;
  1164 
  1165 	if ( ! current_video ) {
  1166 		return 0;
  1167 	}
  1168 	if ( screen != SDL_PublicSurface ) {
  1169 		/* only screens have physical palettes */
  1170 		which &= ~SDL_PHYSPAL;
  1171 	} else if( (screen->flags & SDL_HWPALETTE) != SDL_HWPALETTE ) {
  1172 		/* hardware palettes required for split colormaps */
  1173 		which |= SDL_PHYSPAL | SDL_LOGPAL;
  1174 	}
  1175 
  1176 	/* Verify the parameters */
  1177 	pal = screen->format->palette;
  1178 	if( !pal ) {
  1179 		return 0;	/* not a palettized surface */
  1180 	}
  1181 	gotall = 1;
  1182 	palsize = 1 << screen->format->BitsPerPixel;
  1183 	if ( ncolors > (palsize - firstcolor) ) {
  1184 		ncolors = (palsize - firstcolor);
  1185 		gotall = 0;
  1186 	}
  1187 
  1188 	if ( which & SDL_LOGPAL ) {
  1189 		/*
  1190 		 * Logical palette change: The actual screen isn't affected,
  1191 		 * but the internal colormap is altered so that the
  1192 		 * interpretation of the pixel values (for blits etc) is
  1193 		 * changed.
  1194 		 */
  1195 		SetPalette_logical(screen, colors, firstcolor, ncolors);
  1196 	}
  1197 	if ( which & SDL_PHYSPAL ) {
  1198 		SDL_VideoDevice *video = current_video;
  1199 		/*
  1200 		 * Physical palette change: This doesn't affect the
  1201 		 * program's idea of what the screen looks like, but changes
  1202 		 * its actual appearance.
  1203 		 */
  1204 		if(!video)
  1205 			return gotall;	/* video not yet initialized */
  1206 		if(!video->physpal && !(which & SDL_LOGPAL) ) {
  1207 			/* Lazy physical palette allocation */
  1208 			int size;
  1209 			SDL_Palette *pp = SDL_malloc(sizeof(*pp));
  1210 			if ( !pp ) {
  1211 				return 0;
  1212 			}
  1213 			current_video->physpal = pp;
  1214 			pp->ncolors = pal->ncolors;
  1215 			size = pp->ncolors * sizeof(SDL_Color);
  1216 			pp->colors = SDL_malloc(size);
  1217 			if ( !pp->colors ) {
  1218 				return 0;
  1219 			}
  1220 			SDL_memcpy(pp->colors, pal->colors, size);
  1221 		}
  1222 		if ( ! SetPalette_physical(screen,
  1223 		                           colors, firstcolor, ncolors) ) {
  1224 			gotall = 0;
  1225 		}
  1226 	}
  1227 	return gotall;
  1228 }
  1229 
  1230 int SDL_SetColors(SDL_Surface *screen, SDL_Color *colors, int firstcolor,
  1231 		  int ncolors)
  1232 {
  1233 	return SDL_SetPalette(screen, SDL_LOGPAL | SDL_PHYSPAL,
  1234 			      colors, firstcolor, ncolors);
  1235 }
  1236 
  1237 /*
  1238  * Clean up the video subsystem
  1239  */
  1240 void SDL_VideoQuit (void)
  1241 {
  1242 	SDL_Surface *ready_to_go;
  1243 
  1244 	if ( current_video ) {
  1245 		SDL_VideoDevice *video = current_video;
  1246 		SDL_VideoDevice *this  = current_video;
  1247 
  1248 		/* Halt event processing before doing anything else */
  1249 		SDL_StopEventLoop();
  1250 
  1251 		/* Clean up allocated window manager items */
  1252 		if ( SDL_PublicSurface ) {
  1253 			SDL_PublicSurface = NULL;
  1254 		}
  1255 		SDL_CursorQuit();
  1256 
  1257 		/* Just in case... */
  1258 		SDL_WM_GrabInputOff();
  1259 
  1260 		/* Clean up the system video */
  1261 		video->VideoQuit(this);
  1262 
  1263 		/* Free any lingering surfaces */
  1264 		ready_to_go = SDL_ShadowSurface;
  1265 		SDL_ShadowSurface = NULL;
  1266 		SDL_FreeSurface(ready_to_go);
  1267 		if ( SDL_VideoSurface != NULL ) {
  1268 			ready_to_go = SDL_VideoSurface;
  1269 			SDL_VideoSurface = NULL;
  1270 			SDL_FreeSurface(ready_to_go);
  1271 		}
  1272 		SDL_PublicSurface = NULL;
  1273 
  1274 		/* Clean up miscellaneous memory */
  1275 		if ( video->physpal ) {
  1276 			SDL_free(video->physpal->colors);
  1277 			SDL_free(video->physpal);
  1278 			video->physpal = NULL;
  1279 		}
  1280 		if ( video->gammacols ) {
  1281 			SDL_free(video->gammacols);
  1282 			video->gammacols = NULL;
  1283 		}
  1284 		if ( video->gamma ) {
  1285 			SDL_free(video->gamma);
  1286 			video->gamma = NULL;
  1287 		}
  1288 		if ( video->wm_title != NULL ) {
  1289 			SDL_free(video->wm_title);
  1290 			video->wm_title = NULL;
  1291 		}
  1292 		if ( video->wm_icon != NULL ) {
  1293 			SDL_free(video->wm_icon);
  1294 			video->wm_icon = NULL;
  1295 		}
  1296 
  1297 		/* Finish cleaning up video subsystem */
  1298 		video->free(this);
  1299 		current_video = NULL;
  1300 	}
  1301 	return;
  1302 }
  1303 
  1304 /* Load the GL driver library */
  1305 int SDL_GL_LoadLibrary(const char *path)
  1306 {
  1307 	SDL_VideoDevice *video = current_video;
  1308 	SDL_VideoDevice *this = current_video;
  1309 	int retval;
  1310 
  1311 	retval = -1;
  1312 	if ( video == NULL ) {
  1313 		SDL_SetError("Video subsystem has not been initialized");
  1314 	} else {
  1315 		if ( video->GL_LoadLibrary ) {
  1316 			retval = video->GL_LoadLibrary(this, path);
  1317 		} else {
  1318 			SDL_SetError("No dynamic GL support in video driver");
  1319 		}
  1320 	}
  1321 	return(retval);
  1322 }
  1323 
  1324 void *SDL_GL_GetProcAddress(const char* proc)
  1325 {
  1326 	SDL_VideoDevice *video = current_video;
  1327 	SDL_VideoDevice *this = current_video;
  1328 	void *func;
  1329 
  1330 	func = NULL;
  1331 	if ( video->GL_GetProcAddress ) {
  1332 		if ( video->gl_config.driver_loaded ) {
  1333 			func = video->GL_GetProcAddress(this, proc);
  1334 		} else {
  1335 			SDL_SetError("No GL driver has been loaded");
  1336 		}
  1337 	} else {
  1338 		SDL_SetError("No dynamic GL support in video driver");
  1339 	}
  1340 	return func;
  1341 }
  1342 
  1343 /* Set the specified GL attribute for setting up a GL video mode */
  1344 int SDL_GL_SetAttribute( SDL_GLattr attr, int value )
  1345 {
  1346 	int retval;
  1347 	SDL_VideoDevice *video = current_video;
  1348 
  1349 	retval = 0;
  1350 	switch (attr) {
  1351 		case SDL_GL_RED_SIZE:
  1352 			video->gl_config.red_size = value;
  1353 			break;
  1354 		case SDL_GL_GREEN_SIZE:
  1355 			video->gl_config.green_size = value;
  1356 			break;
  1357 		case SDL_GL_BLUE_SIZE:
  1358 			video->gl_config.blue_size = value;
  1359 			break;
  1360 		case SDL_GL_ALPHA_SIZE:
  1361 			video->gl_config.alpha_size = value;
  1362 			break;
  1363 		case SDL_GL_DOUBLEBUFFER:
  1364 			video->gl_config.double_buffer = value;
  1365 			break;
  1366 		case SDL_GL_BUFFER_SIZE:
  1367 			video->gl_config.buffer_size = value;
  1368 			break;
  1369 		case SDL_GL_DEPTH_SIZE:
  1370 			video->gl_config.depth_size = value;
  1371 			break;
  1372 		case SDL_GL_STENCIL_SIZE:
  1373 			video->gl_config.stencil_size = value;
  1374 			break;
  1375 		case SDL_GL_ACCUM_RED_SIZE:
  1376 			video->gl_config.accum_red_size = value;
  1377 			break;
  1378 		case SDL_GL_ACCUM_GREEN_SIZE:
  1379 			video->gl_config.accum_green_size = value;
  1380 			break;
  1381 		case SDL_GL_ACCUM_BLUE_SIZE:
  1382 			video->gl_config.accum_blue_size = value;
  1383 			break;
  1384 		case SDL_GL_ACCUM_ALPHA_SIZE:
  1385 			video->gl_config.accum_alpha_size = value;
  1386 			break;
  1387 		case SDL_GL_STEREO:
  1388 			video->gl_config.stereo = value;
  1389 			break;
  1390 		case SDL_GL_MULTISAMPLEBUFFERS:
  1391 			video->gl_config.multisamplebuffers = value;
  1392 			break;
  1393 		case SDL_GL_MULTISAMPLESAMPLES:
  1394 			video->gl_config.multisamplesamples = value;
  1395 			break;
  1396 		default:
  1397 			SDL_SetError("Unknown OpenGL attribute");
  1398 			retval = -1;
  1399 			break;
  1400 	}
  1401 	return(retval);
  1402 }
  1403 
  1404 /* Retrieve an attribute value from the windowing system. */
  1405 int SDL_GL_GetAttribute(SDL_GLattr attr, int* value)
  1406 {
  1407 	int retval = -1;
  1408 	SDL_VideoDevice* video = current_video;
  1409 	SDL_VideoDevice* this = current_video;
  1410 
  1411 	if ( video->GL_GetAttribute ) {
  1412 		retval = this->GL_GetAttribute(this, attr, value);
  1413 	} else {
  1414 		*value = 0;
  1415 		SDL_SetError("GL_GetAttribute not supported");
  1416 	}
  1417 	return retval;
  1418 }
  1419 
  1420 /* Perform a GL buffer swap on the current GL context */
  1421 void SDL_GL_SwapBuffers(void)
  1422 {
  1423 	SDL_VideoDevice *video = current_video;
  1424 	SDL_VideoDevice *this = current_video;
  1425 
  1426 	if ( video->screen->flags & SDL_OPENGL ) {
  1427 		video->GL_SwapBuffers(this);
  1428 	} else {
  1429 		SDL_SetError("OpenGL video mode has not been set");
  1430 	}
  1431 }
  1432 
  1433 /*
  1434  * Sets/Gets the title and icon text of the display window, if any.
  1435  */
  1436 void SDL_WM_SetCaption (const char *title, const char *icon)
  1437 {
  1438 	SDL_VideoDevice *video = current_video;
  1439 	SDL_VideoDevice *this  = current_video;
  1440 
  1441 	if ( video ) {
  1442 		if ( title ) {
  1443 			if ( video->wm_title ) {
  1444 				SDL_free(video->wm_title);
  1445 			}
  1446 			video->wm_title = SDL_strdup(title);
  1447 		}
  1448 		if ( icon ) {
  1449 			if ( video->wm_icon ) {
  1450 				SDL_free(video->wm_icon);
  1451 			}
  1452 			video->wm_icon = SDL_strdup(icon);
  1453 		}
  1454 		if ( (title || icon) && (video->SetCaption != NULL) ) {
  1455 			video->SetCaption(this, video->wm_title,video->wm_icon);
  1456 		}
  1457 	}
  1458 }
  1459 void SDL_WM_GetCaption (char **title, char **icon)
  1460 {
  1461 	SDL_VideoDevice *video = current_video;
  1462 
  1463 	if ( video ) {
  1464 		if ( title ) {
  1465 			*title = video->wm_title;
  1466 		}
  1467 		if ( icon ) {
  1468 			*icon = video->wm_icon;
  1469 		}
  1470 	}
  1471 }
  1472 
  1473 /* Utility function used by SDL_WM_SetIcon();
  1474  * flags & 1 for color key, flags & 2 for alpha channel. */
  1475 static void CreateMaskFromColorKeyOrAlpha(SDL_Surface *icon, Uint8 *mask, int flags)
  1476 {
  1477 	int x, y;
  1478 	Uint32 colorkey;
  1479 #define SET_MASKBIT(icon, x, y, mask) \
  1480 	mask[(y*((icon->w+7)/8))+(x/8)] &= ~(0x01<<(7-(x%8)))
  1481 
  1482 	colorkey = icon->format->colorkey;
  1483 	switch (icon->format->BytesPerPixel) {
  1484 		case 1: { Uint8 *pixels;
  1485 			for ( y=0; y<icon->h; ++y ) {
  1486 				pixels = (Uint8 *)icon->pixels + y*icon->pitch;
  1487 				for ( x=0; x<icon->w; ++x ) {
  1488 					if ( *pixels++ == colorkey ) {
  1489 						SET_MASKBIT(icon, x, y, mask);
  1490 					}
  1491 				}
  1492 			}
  1493 		}
  1494 		break;
  1495 
  1496 		case 2: { Uint16 *pixels;
  1497 			for ( y=0; y<icon->h; ++y ) {
  1498 				pixels = (Uint16 *)icon->pixels +
  1499 				                   y*icon->pitch/2;
  1500 				for ( x=0; x<icon->w; ++x ) {
  1501 					if ( (flags & 1) && *pixels == colorkey ) {
  1502 						SET_MASKBIT(icon, x, y, mask);
  1503 					} else if((flags & 2) && (*pixels & icon->format->Amask) == 0) {
  1504 						SET_MASKBIT(icon, x, y, mask);
  1505 					}
  1506 					pixels++;
  1507 				}
  1508 			}
  1509 		}
  1510 		break;
  1511 
  1512 		case 4: { Uint32 *pixels;
  1513 			for ( y=0; y<icon->h; ++y ) {
  1514 				pixels = (Uint32 *)icon->pixels +
  1515 				                   y*icon->pitch/4;
  1516 				for ( x=0; x<icon->w; ++x ) {
  1517 					if ( (flags & 1) && *pixels == colorkey ) {
  1518 						SET_MASKBIT(icon, x, y, mask);
  1519 					} else if((flags & 2) && (*pixels & icon->format->Amask) == 0) {
  1520 						SET_MASKBIT(icon, x, y, mask);
  1521 					}
  1522 					pixels++;
  1523 				}
  1524 			}
  1525 		}
  1526 		break;
  1527 	}
  1528 }
  1529 
  1530 /*
  1531  * Sets the window manager icon for the display window.
  1532  */
  1533 void SDL_WM_SetIcon (SDL_Surface *icon, Uint8 *mask)
  1534 {
  1535 	SDL_VideoDevice *video = current_video;
  1536 	SDL_VideoDevice *this  = current_video;
  1537 
  1538 	if ( icon && video->SetIcon ) {
  1539 		/* Generate a mask if necessary, and create the icon! */
  1540 		if ( mask == NULL ) {
  1541 			int mask_len = icon->h*(icon->w+7)/8;
  1542 			int flags = 0;
  1543 			mask = (Uint8 *)SDL_malloc(mask_len);
  1544 			if ( mask == NULL ) {
  1545 				return;
  1546 			}
  1547 			SDL_memset(mask, ~0, mask_len);
  1548 			if ( icon->flags & SDL_SRCCOLORKEY ) flags |= 1;
  1549 			if ( icon->flags & SDL_SRCALPHA ) flags |= 2;
  1550 			if( flags ) {
  1551 				CreateMaskFromColorKeyOrAlpha(icon, mask, flags);
  1552 			}
  1553 			video->SetIcon(video, icon, mask);
  1554 			SDL_free(mask);
  1555 		} else {
  1556 			video->SetIcon(this, icon, mask);
  1557 		}
  1558 	}
  1559 }
  1560 
  1561 /*
  1562  * Grab or ungrab the keyboard and mouse input.
  1563  * This function returns the final grab mode after calling the
  1564  * driver dependent function.
  1565  */
  1566 static SDL_GrabMode SDL_WM_GrabInputRaw(SDL_GrabMode mode)
  1567 {
  1568 	SDL_VideoDevice *video = current_video;
  1569 	SDL_VideoDevice *this  = current_video;
  1570 
  1571 	/* Only do something if we have support for grabs */
  1572 	if ( video->GrabInput == NULL ) {
  1573 		return(video->input_grab);
  1574 	}
  1575 
  1576 	/* If the final grab mode if off, only then do we actually grab */
  1577 #ifdef DEBUG_GRAB
  1578   printf("SDL_WM_GrabInputRaw(%d) ... ", mode);
  1579 #endif
  1580 	if ( mode == SDL_GRAB_OFF ) {
  1581 		if ( video->input_grab != SDL_GRAB_OFF ) {
  1582 			mode = video->GrabInput(this, mode);
  1583 		}
  1584 	} else {
  1585 		if ( video->input_grab == SDL_GRAB_OFF ) {
  1586 			mode = video->GrabInput(this, mode);
  1587 		}
  1588 	}
  1589 	if ( mode != video->input_grab ) {
  1590 		video->input_grab = mode;
  1591 		if ( video->CheckMouseMode ) {
  1592 			video->CheckMouseMode(this);
  1593 		}
  1594 	}
  1595 #ifdef DEBUG_GRAB
  1596   printf("Final mode %d\n", video->input_grab);
  1597 #endif
  1598 
  1599 	/* Return the final grab state */
  1600 	if ( mode >= SDL_GRAB_FULLSCREEN ) {
  1601 		mode -= SDL_GRAB_FULLSCREEN;
  1602 	}
  1603 	return(mode);
  1604 }
  1605 SDL_GrabMode SDL_WM_GrabInput(SDL_GrabMode mode)
  1606 {
  1607 	SDL_VideoDevice *video = current_video;
  1608 
  1609 	/* If the video isn't initialized yet, we can't do anything */
  1610 	if ( ! video ) {
  1611 		return SDL_GRAB_OFF;
  1612 	}
  1613 
  1614 	/* Return the current mode on query */
  1615 	if ( mode == SDL_GRAB_QUERY ) {
  1616 		mode = video->input_grab;
  1617 		if ( mode >= SDL_GRAB_FULLSCREEN ) {
  1618 			mode -= SDL_GRAB_FULLSCREEN;
  1619 		}
  1620 		return(mode);
  1621 	}
  1622 
  1623 #ifdef DEBUG_GRAB
  1624   printf("SDL_WM_GrabInput(%d) ... ", mode);
  1625 #endif
  1626 	/* If the video surface is fullscreen, we always grab */
  1627 	if ( mode >= SDL_GRAB_FULLSCREEN ) {
  1628 		mode -= SDL_GRAB_FULLSCREEN;
  1629 	}
  1630 	if ( SDL_VideoSurface && (SDL_VideoSurface->flags & SDL_FULLSCREEN) ) {
  1631 		mode += SDL_GRAB_FULLSCREEN;
  1632 	}
  1633 	return(SDL_WM_GrabInputRaw(mode));
  1634 }
  1635 static SDL_GrabMode SDL_WM_GrabInputOff(void)
  1636 {
  1637 	SDL_GrabMode mode;
  1638 
  1639 	/* First query the current grab state */
  1640 	mode = SDL_WM_GrabInput(SDL_GRAB_QUERY);
  1641 
  1642 	/* Now explicitly turn off input grab */
  1643 	SDL_WM_GrabInputRaw(SDL_GRAB_OFF);
  1644 
  1645 	/* Return the old state */
  1646 	return(mode);
  1647 }
  1648 
  1649 /*
  1650  * Iconify the window in window managed environments.
  1651  * A successful iconification will result in an SDL_APPACTIVE loss event.
  1652  */
  1653 int SDL_WM_IconifyWindow(void)
  1654 {
  1655 	SDL_VideoDevice *video = current_video;
  1656 	SDL_VideoDevice *this  = current_video;
  1657 	int retval;
  1658 
  1659 	retval = 0;
  1660 	if ( video->IconifyWindow ) {
  1661 		retval = video->IconifyWindow(this);
  1662 	}
  1663 	return(retval);
  1664 }
  1665 
  1666 /*
  1667  * Toggle fullscreen mode
  1668  */
  1669 int SDL_WM_ToggleFullScreen(SDL_Surface *surface)
  1670 {
  1671 	SDL_VideoDevice *video = current_video;
  1672 	SDL_VideoDevice *this  = current_video;
  1673 	int toggled;
  1674 
  1675 	toggled = 0;
  1676 	if ( SDL_PublicSurface && (surface == SDL_PublicSurface) &&
  1677 	     video->ToggleFullScreen ) {
  1678 		if ( surface->flags & SDL_FULLSCREEN ) {
  1679 			toggled = video->ToggleFullScreen(this, 0);
  1680 			if ( toggled ) {
  1681 				SDL_VideoSurface->flags &= ~SDL_FULLSCREEN;
  1682 				SDL_PublicSurface->flags &= ~SDL_FULLSCREEN;
  1683 			}
  1684 		} else {
  1685 			toggled = video->ToggleFullScreen(this, 1);
  1686 			if ( toggled ) {
  1687 				SDL_VideoSurface->flags |= SDL_FULLSCREEN;
  1688 				SDL_PublicSurface->flags |= SDL_FULLSCREEN;
  1689 			}
  1690 		}
  1691 		/* Double-check the grab state inside SDL_WM_GrabInput() */
  1692 		if ( toggled ) {
  1693 			SDL_WM_GrabInput(video->input_grab);
  1694 		}
  1695 	}
  1696 	return(toggled);
  1697 }
  1698 
  1699 /*
  1700  * Get some platform dependent window manager information
  1701  */
  1702 int SDL_GetWMInfo (SDL_SysWMinfo *info)
  1703 {
  1704 	SDL_VideoDevice *video = current_video;
  1705 	SDL_VideoDevice *this  = current_video;
  1706 
  1707 	if ( video && video->GetWMInfo ) {
  1708 		return(video->GetWMInfo(this, info));
  1709 	} else {
  1710 		return(0);
  1711 	}
  1712 }