sdl_setvideomode — Set up a video mode with the specified width, height and bits-per-pixel.
void sdl_setvideomode( | $width, | |
$height, | ||
$bpp, | ||
$flags) ; |
long | $width; |
long | $height; |
long | $bpp; |
long | $flags; |
Set up a video mode with the specified width, height and bits-per- pixel.
If bpp is 0, it is treated as the current display bits per pixel.
The flags parameter is the same as the flags field of the SDL_Surface structure. OR’d combinations of the following values are valid.
Values of flags parameter
SDL_SWSURFACE
Create the video surface in system memory
SDL_HWSURFACE
Create the video surface in video memory
SDL_ASYNCBLIT
Enables the use of asynchronous updates of the display surface. This will usually slow down blitting on single CPU machines, but may provide a speed increase on SMP systems.
SDL_ANYFORMAT
Normally, if a video surface of the requested bits-per-pixel (bpp) is not available, SDL will emulate one with a shadow surface. Passing SDL_ANYFORMAT prevents this and causes SDL to use the video surface, regardless of its pixel depth.
SDL_HWPALETTE
Give SDL exclusive palette access. Without this flag you may not always get the colors you request with sdl_setcolors. or sdl_setpalette..
SDL_DOUBLEBUF
Enable hardware double buffering; only valid with SDL_HWSURFACE. Calling sdl_flip will flip the buffers and update the screen. All drawing will take place on the surface that is not displayed at the moment. If double buffering could not be enabled then sdl_flip will just perform a sdl_updaterect on the entire screen.
SDL_FULLSCREEN
SDL will attempt to use a fullscreen mode. If a hardware resolution change is not possible (for whatever reason), the next higher resolution will be used and the display window centered on a black background.
SDL_OPENGL
Create an OpenGL rendering context. You should have previously set OpenGL video attributes with SDL_GL_SetAttribute.
SDL_OPENGLBLIT
Create an OpenGL rendering context, like above, but allow normal blitting operations. The screen (2D) surface may have an alpha channel, and sdl_updaterects must be used for updating changes to the screen surface.
SDL_RESIZABLE
Create a resizable window. When the window is resized by the user a SDL_VIDEORESIZE event is gen‐ erated and SDL_SetVideoMode can be called again with the new size. SDL_NOFRAME If possible, SDL_NOFRAME causes SDL to create a window with no title bar or frame decoration. Fullscreen modes automatically have this flag set.
Return an "array" of type surface or NULL if it fails. See the section called “Resources”. The surface returned is freed by SDL_Quit() and should nt be freed by the caller.