comparison include/SDL_video.h @ 3500:4b594623401b

Work in progress on multi-display support: * Added display parameter to many internal functions so video modes can be set on displays that aren't the public current one. * The fullscreen mode is associated with fullscreen windows - not displays, so different windows more naturally have a mode associated with them based on their width and height. It's no longer necessary to specify a fullscreen mode, a default one will be picked automatically for fullscreen windows.
author Sam Lantinga <slouken@libsdl.org>
date Tue, 01 Dec 2009 05:57:15 +0000
parents 40b1f7cb2062
children fa1abe1ff8b8
comparison
equal deleted inserted replaced
3499:4cf8a1423d57 3500:4b594623401b
48 * \sa SDL_GetNumDisplayModes() 48 * \sa SDL_GetNumDisplayModes()
49 * \sa SDL_GetDisplayMode() 49 * \sa SDL_GetDisplayMode()
50 * \sa SDL_GetDesktopDisplayMode() 50 * \sa SDL_GetDesktopDisplayMode()
51 * \sa SDL_GetCurrentDisplayMode() 51 * \sa SDL_GetCurrentDisplayMode()
52 * \sa SDL_GetClosestDisplayMode() 52 * \sa SDL_GetClosestDisplayMode()
53 * \sa SDL_SetDisplayMode() 53 * \sa SDL_SetWindowDisplayMode()
54 * \sa SDL_GetWindowDisplayMode()
54 */ 55 */
55 typedef struct 56 typedef struct
56 { 57 {
57 Uint32 format; /**< pixel format */ 58 Uint32 format; /**< pixel format */
58 int w; /**< width */ 59 int w; /**< width */
425 SDL_DisplayMode 426 SDL_DisplayMode
426 * closest); 427 * closest);
427 428
428 /** 429 /**
429 * \brief Set the display mode used when a fullscreen window is visible 430 * \brief Set the display mode used when a fullscreen window is visible
430 * on the currently selected display. 431 * on the currently selected display. By default the window's
431 * 432 * dimensions and the desktop format and refresh rate are used.
432 * \param mode The mode to use, or NULL for the desktop mode. 433 *
434 * \param mode The mode to use, or NULL for the default mode.
433 * 435 *
434 * \return 0 on success, or -1 if setting the display mode failed. 436 * \return 0 on success, or -1 if setting the display mode failed.
435 * 437 *
436 * \sa SDL_SetWindowFullscreen() 438 * \sa SDL_SetWindowFullscreen()
437 */ 439 */
438 extern DECLSPEC int SDLCALL SDL_SetFullscreenDisplayMode(const SDL_DisplayMode 440 extern DECLSPEC int SDLCALL SDL_SetWindowDisplayMode(SDL_WindowID windowID,
441 const SDL_DisplayMode
439 * mode); 442 * mode);
440 443
441 /** 444 /**
442 * \brief Fill in information about the display mode used when a fullscreen 445 * \brief Fill in information about the display mode used when a fullscreen
443 * window is visible on the currently selected display. 446 * window is visible on the currently selected display.
444 */ 447 */
445 extern DECLSPEC int SDLCALL SDL_GetFullscreenDisplayMode(SDL_DisplayMode * 448 extern DECLSPEC int SDLCALL SDL_GetWindowDisplayMode(SDL_WindowID windowID,
446 mode); 449 SDL_DisplayMode * mode);
447 450
448 /** 451 /**
449 * \brief Set the palette entries for indexed display modes. 452 * \brief Set the palette entries for indexed display modes.
450 * 453 *
451 * \return 0 on success, or -1 if the display mode isn't palettized or the 454 * \return 0 on success, or -1 if the display mode isn't palettized or the
678 /** 681 /**
679 * \brief Set the window's fullscreen state. 682 * \brief Set the window's fullscreen state.
680 * 683 *
681 * \return 0 on success, or -1 if setting the display mode failed. 684 * \return 0 on success, or -1 if setting the display mode failed.
682 * 685 *
683 * \sa SDL_SetFullscreenDisplayMode() 686 * \sa SDL_WindowDisplayMode()
684 */ 687 */
685 extern DECLSPEC int SDLCALL SDL_SetWindowFullscreen(SDL_WindowID windowID, 688 extern DECLSPEC int SDLCALL SDL_SetWindowFullscreen(SDL_WindowID windowID,
686 int fullscreen); 689 int fullscreen);
687 690
688 /** 691 /**