pygame-qpython 2.6.1.1

Pygame for QPython

This project is a branch of pygame on QPython.

Pygame is a free and open-source cross-platform library for the development of multimedia applications like video games using Python. It uses the Simple DirectMedia Layer library and several other popular libraries to abstract the most common functions, making writing these programs a more intuitive task.

👉 We need your help to make pygame the best it can be! New contributors are welcome.

---

Installation

Before installing pygame, you must check that Python is installed on your machine.

To find out, open a command prompt (Windows) or a terminal (MacOS/Linux) and type:

python --version

If a message such as Python 3.8.10 appears, Python is correctly installed. Otherwise, go to the official Python website to install it.

Next, check if pip is installed:

pip --version

If you see something like pip 20.0.2 from /usr/lib/..., you're ready to install pygame:

pip install pygame

Once installed, test pygame by running:

python3 -m pygame.examples.aliens

If this doesn’t work, check the Getting Started guide for platform-specific setup help.

---

Help

If you're new to pygame, you should be able to get started fairly quickly. Pygame comes with many tutorials and introductions. There's also full reference documentation.

You can browse documentation on the docs page, or locally via:

python -m pygame.docs

If local docs aren't found, it will open the online documentation.

To upgrade pygame to the latest version:

pip install pygame --upgrade

Best of all, the examples/ directory includes many playable programs to get you started.

---

Features

Pygame is a powerful library for game development, offering a wide range of features:

🎨 Graphics

• Easy tools for 2D graphics and animation
• Support for images, rectangles, and polygon shapes

🔊 Sound

• Play and manipulate sound and music
• Supports WAV, MP3, and OGG formats

🎮 Input

• Handle keyboard, mouse, and joystick input easily

🕹️ Game Development Tools

• Collision detection
• Sprite management
• Game loop support

Whether you're building a platformer, puzzle game, or something new — Pygame has you covered.

---

Building From Source

To use in-development features or contribute to Pygame, build it from source instead of installing via pip.

Installing from source is mostly automated. The most work is compiling dependencies. Once done, run:

python setup.py install