PyGame Implementation: Difference between revisions

From OLPC
Jump to navigation Jump to search
Line 22: Line 22:


=== API details ===
=== API details ===
(undergoing editing RIGHT NOW)
(undergoing editing and not yet finished)


==== PyGame standard modules that will or should be included ====
==== PyGame standard modules that will or should be included ====
Line 28: Line 28:
* [http://www.pygame.org/docs/ref/cursors.html Cursors] -- manages the hardware cursor. We may not need/want to support the load_xbm module; instead we may want to add support for a standard image file format supported by the tools on the XO.
* [http://www.pygame.org/docs/ref/cursors.html Cursors] -- manages the hardware cursor. We may not need/want to support the load_xbm module; instead we may want to add support for a standard image file format supported by the tools on the XO.
* [http://www.pygame.org/docs/ref/display.html Display] -- required support for setting up a display, but the number of modes is limited and the fullscreen option should be ignored. Existing PyGame code that tries to set up displays intelligently should still work if it was coded correctly, but all roads should probably lead to the same display setup result.
* [http://www.pygame.org/docs/ref/display.html Display] -- required support for setting up a display, but the number of modes is limited and the fullscreen option should be ignored. Existing PyGame code that tries to set up displays intelligently should still work if it was coded correctly, but all roads should probably lead to the same display setup result.
* [http://www.pygame.org/docs/ref/draw.html Draw] -- line and shape drawing. Antialiased color lines may need special attention because of the characteristics of the display.
* [http://www.pygame.org/docs/ref/event.html Event] -- event handling. In the long run, we want to integrate this into Sugar so that the events play nice with Sugar / GTK.
* [http://www.pygame.org/docs/ref/font.html Font] -- we want some font handling to support the platform fonts, but I don't know the platform story on this. We'll make it easy to use the platform's fonts from within this API.
* [http://www.pygame.org/docs/ref/image.html Image] -- we'll support loading and processing images from whatever file formats are supported by standard platform libraries. We especially want to make sure it's easy to use the file formats created by the tools on the platform.
* [http://www.pygame.org/docs/ref/key.html Key] -- we'll support the keyboard, including the game keys.
* [http://www.pygame.org/docs/ref/mixer.html Mixer] -- this is the sound mixer, supporting sound loading and playback for certain standard formats. Again, we should make sure we can play formats that can be created on the device, and remove support for formats that are too big or obscure.
* [http://www.pygame.org/docs/ref/mouse.html Mouse] -- obviously, we'll support the trackpad. Can the graphics tablet be supported by the same API?



==== PyGame standard modules that will not or may not be included ====
==== PyGame standard modules that will not or may not be included ====


* [http://www.pygame.org/docs/ref/cdrom.html Cdrom] -- manages CD drives; we don't have a CD so no need or value for this API.
* [http://www.pygame.org/docs/ref/cdrom.html Cdrom] -- manages CD drives; we don't have a CD so no need or value for this API.
* [http://www.pygame.org/docs/ref/joystick.html Joystick] -- There's no joystick-like device on the system, but do we want to have support available for external USB joysticks? Could we?
* [http://www.pygame.org/docs/ref/movie.html Movie] -- I don't think this is intended to be supported by the system, but even if it is we may want to leave it as a separate module.


==== Additional items that are not in PyGame but need support ====
==== Additional items that are not in PyGame but need support ====

Revision as of 04:17, 5 April 2007

PyGame Implementation Specification

What this document is about

We want to enable game development in a way that allows a variety of levels of use.

  1. Beginners who want to experiment with game development techniques in a simple environment. This document does not consider this case.
  2. Slightly more advanced beginners and students who are starting to experiment with Python but might need a lot of handholding. This document is not primarily concerned with this case but may discuss it.
  3. Advanced students and game developers who want to code in Python and can handle an API and the API documentation. The rest of this document discusses this case.
  4. Hardcore professional game developers wanting to build games that push the limits of the OLPC and want to code in C or C++. This is discussed elsewhere: SDL Implementation

Choice of API: PyGame

The overwhelming leader for Python game development is PyGame. PyGame is built upon SDL, which is a cross-platform library supporting a variety of game-related interfaces, including graphics, sound, video, and input devices. SDL has been implemented on a very wide variety of hardware.

PyGame works on most major computer systems and has been in use for some time. Some commercial games have shipped with PyGame, and a whole lot of tutorials and sample code, as well as open source games, have been written using PyGame.

In a world where we would like end users to be building their own games and developing for the OLPC environment, PyGame will give those users a leg up with all of the available material for game development. See Content and OLPC on open source software.

If you're thinking of developing games in Python for the OLPC, please start by prototyping them in PyGame. At the moment, there is no guarantee that the code will run unmodified, but the port should be simple.

API details

(undergoing editing and not yet finished)

PyGame standard modules that will or should be included

  • Cursors -- manages the hardware cursor. We may not need/want to support the load_xbm module; instead we may want to add support for a standard image file format supported by the tools on the XO.
  • Display -- required support for setting up a display, but the number of modes is limited and the fullscreen option should be ignored. Existing PyGame code that tries to set up displays intelligently should still work if it was coded correctly, but all roads should probably lead to the same display setup result.
  • Draw -- line and shape drawing. Antialiased color lines may need special attention because of the characteristics of the display.
  • Event -- event handling. In the long run, we want to integrate this into Sugar so that the events play nice with Sugar / GTK.
  • Font -- we want some font handling to support the platform fonts, but I don't know the platform story on this. We'll make it easy to use the platform's fonts from within this API.
  • Image -- we'll support loading and processing images from whatever file formats are supported by standard platform libraries. We especially want to make sure it's easy to use the file formats created by the tools on the platform.
  • Key -- we'll support the keyboard, including the game keys.
  • Mixer -- this is the sound mixer, supporting sound loading and playback for certain standard formats. Again, we should make sure we can play formats that can be created on the device, and remove support for formats that are too big or obscure.
  • Mouse -- obviously, we'll support the trackpad. Can the graphics tablet be supported by the same API?


PyGame standard modules that will not or may not be included

  • Cdrom -- manages CD drives; we don't have a CD so no need or value for this API.
  • Joystick -- There's no joystick-like device on the system, but do we want to have support available for external USB joysticks? Could we?
  • Movie -- I don't think this is intended to be supported by the system, but even if it is we may want to leave it as a separate module.

Additional items that are not in PyGame but need support

<more to come -- kentquirk>