pygame   documentation ||  Home  ||  Help Contents  ||   || pygame || cdrom || constants || cursor || display || draw || || event || font || image || joystick || key || mixer || || mixer_music || mouse || movie || sndarray || surfarray || time || || transform ||   || CD || Channel || Clock || Font || Joystick || Movie || || Overlay || Rect || Sound || Surface ||   || color || cursors || sprite ||

pygame.display

Returns true if the current display is active on the screen. This done with the call to pygame.display.set_mode(). It is potentially subject to the activity of a running window manager.
 
Calling set_mode() will change all existing display surface to reference the new display mode. The old display surface will be lost after this call.

After calling pygame.display.set_mode() with the OPENGL flag you will likely want to check the value of any special opengl attributes you requested. You will not always get what you requested.
 
See pygame.display.gl_set_attribute() for a list of flags.
 
The OPENGL flags are; GL_ALPHA_SIZE, GL_DEPTH_SIZE, GL_STENCIL_SIZE, GL_ACCUM_RED_SIZE, GL_ACCUM_GREEN_SIZE, GL_ACCUM_BLUE_SIZE, GL_ACCUM_ALPHA_SIZE, GL_RED_SIZE, GL_GREEN_SIZE, GL_BLUE_SIZE, GL_DEPTH_SIZE

When calling pygame.display.set_mode() with the OPENGL flag, pygame automatically handles setting the opengl attributes like color and doublebuffering. OPENGL offers several other attributes you may want control over. Pass one of these attributes as the flag, and its appropriate value.
 
This must be called before pygame.display.set_mode()
 
The OPENGL flags are; GL_ALPHA_SIZE, GL_DEPTH_SIZE, GL_STENCIL_SIZE, GL_ACCUM_RED_SIZE, GL_ACCUM_GREEN_SIZE, GL_ACCUM_BLUE_SIZE, GL_ACCUM_ALPHA_SIZE GL_MULTISAMPLEBUFFERS, GL_MULTISAMPLESAMPLES, GL_STEREO

This uses the same arguments as the call to pygame.display.set_mode(). It is used to determine if a requested display mode is available. It will return 0 if the requested mode is not possible. Otherwise it will return the best and closest matching bit depth for the mode requested.
 
The size is a 2-number-sequence containing the width and height of the desired display mode. Flags represents a set of different options for the display mode. If omitted or given as 0, it will default to a simple software window. You can mix several flags together with the bitwise-or (|) operator. Possible flags are HWSURFACE (or the value 1), HWPALETTE, DOUBLEBUF, and/or FULLSCREEN. There are other flags available but these are the most usual. A full list of flags can be found in the SDL documentation. The optional depth arguement is the requested bits per pixel. It will usually be left omitted, in which case the display will use the best/fastest pixel depth available.

Sets the current display mode. If calling this after the mode has already been set, this will change the display mode to the desired type. Sometimes an exact match for the requested video mode is not available. In this case SDL will try to find the closest match and work with that instead.
 
The size is a 2-number-sequence containing the width and height of the desired display mode. Flags represents a set of different options for the new display mode. If omitted or given as 0, it will default to a simple software window. You can mix several flags together with the bitwise-or (|) operator. Possible flags are HWSURFACE (or the value 1), HWPALETTE, DOUBLEBUF, and/or FULLSCREEN. There are other flags available but these are the most usual. A full list of flags can be found in the pygame documentation.
 
The optional depth arguement is the requested bits per pixel. It will usually be left omitted, in which case the display will use the best/fastest pixel depth available.
 
You can create an OpenGL surface (for use with PyOpenGL) by passing the OPENGL flag. You will likely want to use the DOUBLEBUF flag when using OPENGL. In which case, the flip() function will perform the GL buffer swaps. When you are using an OPENGL video mode, you will not be able to perform most of the pygame drawing functions (fill, set_at, etc) on the display surface.