##### pygame documentation | Pygame Home || Help Contents || Reference Index Most useful stuff: Color | display | draw | event | font | image | key | locals | mixer | mouse | Rect | Surface | time | music | pygame Advanced stuff: cursors | joystick | mask | sprite | transform | BufferProxy | freetype | gfxdraw | midi | Overlay | PixelArray | pixelcopy | sndarray | surfarray | math Other: camera | cdrom | examples | fastevent | scrap | tests | touch | version

# Pygame Front Page

Welcome to an early "alpha" version of downloadable docs.

Please email any suggestions to: rene@pygame.org

## Tutorials

Newbie Guide

  A list of thirteen helpful tips for people to get comfortable using pygame.

Import and Initialize

  The beginning steps on importing and initializing pygame. The pygame package is made of several modules. Some modules are not included on all platforms.

How do I move an Image?

  A basic tutorial that covers the concepts behind 2D computer animation. Information about drawing and clearing objects to make them appear animated.

Chimp Tutorial, Line by Line

  The pygame examples include a simple program with an interactive fist and a chimpanzee. This was inspired by the annoying flash banner of the early 2000s. This tutorial examines every line of code used in the example.

Sprite Module Introduction

  Pygame includes a higher level sprite module to help organize games. The sprite module includes several classes that help manage details found in almost all games types. The Sprite classes are a bit more advanced than the regular pygame modules, and need more understanding to be properly used.

Surfarray Introduction

  Pygame used the NumPy python module to allow efficient per pixel effects on images. Using the surface arrays is an advanced feature that allows custom effects and filters. This also examines some of the simple effects from the pygame example, arraydemo.py.

Camera Module Introduction

  Pygame, as of 1.9, has a camera module that allows you to capture images, watch live streams, and do some basic computer vision. This tutorial covers those use cases.

Making Games Tutorial

  A large tutorial that covers the bigger topics needed to create an entire game.

Display Modes

  Getting a display surface for the screen.

Introduction to Pygame

  An introduction to the basics of pygame. This is written for users of Python and appeared in volume two of the Py magazine.

## Reference

Index

  A list of all functions, classes, and methods in the pygame package.

pygame.BufferProxy

  An array protocol view of surface pixels

pygame.cdrom

  How to access and control the CD audio devices.

pygame.Color

  Color representation.

pygame.cursors

  Loading and compiling cursor images.

pygame.display

  Configure the display surface.

pygame.draw

  Drawing simple shapes like lines and ellipses to surfaces.

pygame.event

  Manage the incoming events from various input devices and the windowing platform.

pygame.examples

  Various programs demonstrating the use of individual pygame modules.

pygame.font

  Loading and rendering TrueType fonts.

pygame.freetype

  Enhanced pygame module for loading and rendering font faces.

pygame.gfxdraw

  Anti-aliasing draw functions.

pygame.image

  Loading, saving, and transferring of surfaces.

pygame.joystick

  Manage the joystick devices.

pygame.key

  Manage the keyboard device.

pygame.locals

  Pygame constants.

pygame.mixer

  Load and play sounds

pygame.mouse

  Manage the mouse device and display.

pygame.mixer.music

  Play streaming music tracks.

pygame.Overlay

  Access advanced video overlays.

pygame

  Top level functions to manage pygame.

pygame.PixelArray

  Manipulate image pixel data.

pygame.Rect

  Flexible container for a rectangle.

pygame.scrap

  Native clipboard access.

pygame.sndarray

  Manipulate sound sample data.

pygame.sprite

  Higher level objects to represent game images.

pygame.Surface

  Objects for images and the screen.

pygame.surfarray

  Manipulate image pixel data.

pygame.tests

  Test pygame.

pygame.time

  Manage timing and framerate.

pygame.transform

  Resize and move images.

pygame C API

  The C api shared amongst pygame extension modules.

Search Page

  Search pygame documents by keyword.

Edit on GitHub