pygameCreating a window in pygame - pygame.display.set_mode()


Syntax

  • pygame.display.set_mode(resolution=(0,0), flags=0, depth=0) # Returns a pygame.Surface representing the window on screen
  • flags = pygame.FULLSCREEN | pygame.OPENGL # Flags can be combined using the "|" (bitwise OR or "pipe") character.

Parameters

parameterexplaination
resolutiona pair of numbers representing the width and height of the window
flagsadditional options that change the type of window - see "Remarks" for avaliable flags
depthamount of bits used for color

Remarks

  • Possible values for the flag arguments are:
flagdescription
pygame.FULLSCREENwindow is fullscreen
pygame.RESIZABLEwindow is resizeable
pygame.NOFRAMEwindow has no border or controls
pygame.DOUBLEBUFuse double buffer - recommended for HWSURFACE or OPENGL
pygame.HWSURFACEwindow is hardware accelerated, only possible in combination with FULLSCREEN
pygame.OPENGLwindow is renderable by OpenGL

Other remarks:

  • Pygame can currently only handle one single window at a time. Creating a second window by calling pygame.display.set_mode((x,y)) a second time will close the first window.

  • Changing the depths argument is almost never required - pygame will select the best one by itself. In case a depth that is not supported by the system is set, pygame will emulate this depth, which can be very slow.

  • Things that are drawn onto the surface returned by pygame.display.set_mode() are not immediately visible on screen - the display first has to be flipped using pygame.display.update() or pygame.display.flip().