Development Team/Sugargame: Difference between revisions

Sugargame is a Python package which allows [http://www.pygame.org/ Pygame] programs to run well under Sugar.  

The olpcgames framework provides a wrapper around Pygame which attempts to allow a Pygame program to run mostly unmodified under Sugar.  To this end, the Pygame program is run in a separate thread with its own Pygame message loop while the main thread runs the GTK message loop.  Also, olpcgames wraps Sugar APIs such as the journal and mesh into a Pygame-like API.

Sugargame takes a simpler approach; it provides a way to embed Pygame into a GTK widget.  The Sugar APIs are used to interact with Sugar, the Pygame APIs are used for the game.   

To use Sugargame to Sugarize a Pygame program, set up an activity directory and copy the Sugargame package to it.

To make the Activity class, start with test/TestActivity.py from the Sugargame distribution.   

The activity should create a single PygameCanvas widget and call run_pygame on it.  Pass the main loop function of the Pygame program.

To add Pygame to an existing Sugar activity, create a PygameCanvas widget and call run_pygame on it.   

Due to limitations of Pygame and SDL, there can only be one PygameCanvas in the entire activity.

The argument to run_pygame is a function structured like a Pygame program.  In the main loop, remember to dispatch GTK messages using gtk.main_iteration().