Examples¶

Here you will find a list of the included examples. Each example have a short description and a screenshot (if applicable).

To look at the source code of an example open it on github by following the link. The examples are also included in the source distribution of Easymunk (but not if you install using the wheel file). You can find the source distribution at PyPI, https://pypi.org/project/pymunk/#files (file named pymunk-x.y.z.zip).

Jupyter Notebooks¶

There are a couple examples that are provided as Jupyter Notebooks (.ipynb). They are possible to either view online in a browser directly on github, or opened as a Notebook.

matplotlib_util_demo.ipynb¶

Displays the same space as the pygame and pyglet draw demos, but using matplotlib and the notebook.

Source: examples/matplotlib_util_demo.ipynb

newtons_cradle.ipynb¶

Similar simulation as newtons_cradle.py, but this time as a Notebook. Compared to the draw demo this demo will output a animation of the simulated space.

Source: examples/newtons_cradle.ipynb

Standalone Python¶

To run the examples yourself either install easymunk or run it using the convenience run.py script.

Given that easymunk is installed where your python will find it:

>cd examples
>python breakout.py

Each example contains something unique. Not all of the examples use the same style. For example, some use the easymunk.pygame_util module to draw stuff, others contain the actual drawing code themselves. However, each example is self contained. Except for external libraries (such as pygame) and easymunk each example can be run directly to make it easy to read the code and understand what happens even if it means that some code is repeated for each example.

If you have made something that uses easymunk and would like it displayed here or in a showcase section of the site, feel free to contact me!

Example files

arrows.py ¶

Source: examples/arrows.py

Showcase of flying arrows that can stick to objects in a somewhat realistic looking way.

balls_and_lines.py ¶

Source: examples/balls_and_lines.py

This example lets you dynamically create static walls and dynamic balls

basic_test.py ¶

Source: examples/basic_test.py

Very simple example that does not depend on any third party library such as pygame or pyglet like the other examples.

bouncing_balls.py ¶

Source: examples/bouncing_balls.py

This example spawns (bouncing) balls randomly on a L-shape constructed of two segment shapes. Not interactive.

box2d_pyramid.py ¶

Source: examples/box2d_pyramid.py

Remake of the pyramid demo from the box2d testbed.

box2d_vertical_stack.py ¶

Source: examples/box2d_vertical_stack.py

Remake of the veritcal stack demo from the box2d testbed.

breakout.py ¶

Source: examples/breakout.py

Very simple breakout clone. A circle shape serves as the paddle, then breakable bricks constructed of Poly-shapes.

The code showcases several pymunk concepts such as elasitcity, impulses, constant object speed, joints, collision handlers and post step callbacks.

constraints.py ¶

Source: examples/constraints.py

Pymunk constraints demo. Showcase of all the constraints included in easymunk.

Adapted from the Chipmunk Joints demo: https://github.com/slembcke/Chipmunk2D/blob/master/demo/Joints.c

contact_and_no_flipy.py ¶

Source: examples/contact_and_no_flipy.py

This example spawns (bouncing) balls randomly on a L-shape constructed of two segment shapes. For each collision it draws a red circle with size depending on collision strength. Not interactive.

contact_with_friction.py ¶

Source: examples/contact_with_friction.py

This example spawns (bouncing) balls randomly on a L-shape constructed of two segment shapes. Displays collsion strength and rotating balls thanks to friction. Not interactive.

copy_and_pickle.py ¶

Source: examples/copy_and_pickle.py

This example shows how you can copy, save and load a space using pickle.

damped_rotary_spring_pointer.py ¶

Source: examples/damped_rotary_spring_pointer.py

This example showcase an arrow pointing or aiming towards the cursor.

_images/damped_rotary_spring_pointer.png

deformable.py ¶

Source: examples/deformable.py

This is an example on how the autogeometry can be used for deformable terrain.

flipper.py ¶

Source: examples/flipper.py

A very basic flipper game.

index_video.py ¶

Source: examples/index_video.py

Program used to generate the logo animation on the pymunk main page.

This program will showcase several features of Pymunk, such as collisions, debug drawing, automatic generation of shapes from images, motors, joints and sleeping bodies.

kivy_pymunk_demo ¶

Source: examples/kivy_pymunk_demo

A rudimentary port of the intro video used for the intro animation on pymunk.org. The code is tested on both Windows and Android.

Note that it doesn’t display Kivy best practices, the intro_video code was just converted to Kivy in the most basic way to show that its possible, its not supposed to show the best way to structure a Kivy application using Pymunk.

logo.py ¶

Source: examples/logo.py

A very simple script to create the Easymunk Logo from pixel-art.

It opens a screen with the logo. Press Alt+1 to save a screenshot to the desktop.

newtons_cradle.py ¶

Source: examples/newtons_cradle.py

A screensaver version of Newton’s Cradle with an interactive mode.

platformer.py ¶

Source: examples/platformer.py

Showcase of a very basic 2d platformer

The red girl sprite is taken from Sithjester’s RMXP Resources: http://untamed.wild-refuge.net/rmxpresources.php?characters

Note

The code of this example is a bit messy. If you adapt this to your own code you might want to structure it a bit differently.

playground.py ¶

Source: examples/playground.py

A basic playground. Most interesting function is draw a shape, basically move the mouse as you want and pymunk will approximate a Poly shape from the drawing.