sdl_setvideomode(3) [opensolaris man page]

SDL_SetVideoMode(3)						 SDL API Reference					       SDL_SetVideoMode(3)

NAME

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

SYNOPSIS

       #include "SDL.h"

       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	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 the colors you request with SDL_SetCol-
			   ors 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  generated  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 automat-
			   ically have this flag set.

	      Note:

	      Whatever flags SDL_SetVideoMode could satisfy are set in the flags member of the returned surface.

	      Note:

	      The bpp parameter is the number of bits per pixel, so a bpp of 24 uses the packed representation of 3 bytes/pixel. For the more com-
	      mon  4 bytes/pixel mode, use a bpp of 32. Somewhat oddly, both 15 and 16 will request a 2 bytes/pixel mode, but different pixel for-
	      mats.

RETURN VALUE

       The framebuffer surface, or NULL if it fails. The surface returned is freed by SDL_Quit() and should nt be freed by the caller.

SEE ALSO

       SDL_LockSurface, SDL_SetColors, SDL_Flip, SDL_Surface

SDL
							      Tue 11 Sep 2001, 23:01					       SDL_SetVideoMode(3)

Check Out this Related Man Page

SDL_Surface(3)							 SDL API Reference						    SDL_Surface(3)

NAME

       SDL_Surface - Graphical Surface Structure

STRUCTURE DEFINITION

       typedef struct SDL_Surface {
	       Uint32 flags;			       /* Read-only */
	       SDL_PixelFormat *format; 	       /* Read-only */
	       int w, h;			       /* Read-only */
	       Uint16 pitch;			       /* Read-only */
	       void *pixels;			       /* Read-write */

	       /* clipping information */
	       SDL_Rect clip_rect;		       /* Read-only */

	       /* Reference count -- used when freeing surface */
	       int refcount;			       /* Read-mostly */

	    /* This structure also contains private fields not shown here */
       } SDL_Surface;

STRUCTURE DATA

       flags		   Surface flags

       format		   Pixel format

       w, h		   Width and height of the surface

       pitch		   Length of a surface scanline in bytes

       pixels		   Pointer to the actual pixel data

       clip_rect	   surface clip rectangle

DESCRIPTION

       SDL_Surface's  represent  areas	of  "graphical" memory, memory that can be drawn to. The video framebuffer is returned as a SDL_Surface by
       SDL_SetVideoMode and SDL_GetVideoSurface. Most of the fields should be pretty obvious. w and h are the width and height of the  surface	in
       pixels.	pixels is a pointer to the actual pixel data, the surface should be locked before accessing this field. The clip_rect field is the
       clipping rectangle as set by SDL_SetClipRect.

       The following are supported in the flags field.

       SDL_SWSURFACE	   Surface is stored in system memory

       SDL_HWSURFACE	   Surface is stored in video memory

       SDL_ASYNCBLIT	   Surface uses asynchronous blits if possible

       SDL_ANYFORMAT	   Allows any pixel-format (Display surface)

       SDL_HWPALETTE	   Surface has exclusive palette

       SDL_DOUBLEBUF	   Surface is double buffered (Display surface)

       SDL_FULLSCREEN	   Surface is full screen (Display Surface)

       SDL_OPENGL	   Surface has an OpenGL context (Display Surface)

       SDL_OPENGLBLIT	   Surface supports OpenGL blitting (Display Surface)

       SDL_RESIZABLE	   Surface is resizable (Display Surface)

       SDL_HWACCEL	   Surface blit uses hardware acceleration

       SDL_SRCCOLORKEY	   Surface use colorkey blitting

       SDL_RLEACCEL	   Colorkey blitting is accelerated with RLE

       SDL_SRCALPHA	   Surface blit uses alpha blending

       SDL_PREALLOC	   Surface uses preallocated memory

SEE ALSO

       SDL_PixelFormat

SDL
							      Tue 11 Sep 2001, 23:01						    SDL_Surface(3)

Linux and UNIX Man Pages

sdl_setvideomode(3) [opensolaris man page]

Check Out this Related Man Page