View Source: SDL_SetVideoMode(3) - Waikato Linux Users Group

You are viewing an old revision of this page. View the current version.

SDL_SetVideoMode
!!!SDL_SetVideoMode
NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
SEE ALSO
----
!!NAME


SDL_SetVideoMode- Set up a video mode with the specified width, height and bits-per-pixel.
!!SYNOPSIS


__#include __


__SDL_Surface *SDL_SetVideoMode__(__int width, int
height, int bpp, Uint32 flags__);
!!DESCRIPTION


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.


__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 to 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 depth
(__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
depth.


__SDL_HWPALETTE__


Give SDL exclusive palette access. Without this flag you may
not always get the the colors you request with
__SDL_SetColors__.


__SDL_DOUBLEBUF__


Enable double buffering. Calling __SDL_Flip__ will flip
the buffers and update the screen. 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


__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.


__SDL_RESIZABLE__


Create a resizable window. When the window is resized by the
user a __SDL_VIDEORESIZE__ event is generated and
__SDL_SetVideoMode__ can be called again with the new
size.


__Note:__


Whatever __flags SDL_SetVideoMode__ could satisfy are set
in the __flags__ member of the returned
surface.
!!RETURN VALUE


The framebuffer surface, or __NULL__ if it
fails.
!!SEE ALSO


__SDL_LockSurface__, __SDL_SetColors__,
__SDL_Flip__, __SDL_Surface__
----

One page links to SDL_SetVideoMode(3):

SDLManPages

This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.

Version 1, saved on Monday, June 3, 2002 6:53:49 pm by "perry"

Edit PageHistory Diff Info LikePages