Pymunk is a easy-to-use pythonic 2d physics library
Pymunk is a easy-to-use pythonic 2d physics library that can be used whenever you need 2d rigid body physics from Python. Perfect when you need 2d physics in your game, demo or other application! It is built on top of the very capable 2d physics library Chipmunk.
The first version was released in 2007 and Pymunk is still actively developed and maintained today.
Pymunk has been used with success in many projects, big and small. For example: 2 Pyweek game competition winners, more than 10 published scientific papers and even in a self-driving car simulation! See the Showcases section on the Pymunk webpage for some examples.
2007 - 2017, Victor Blomqvist - firstname.lastname@example.org, MIT License
This release is based on the latest Pymunk release (5.3.0), using Chipmunk 7.0 rev d7603e3927 (source included)
In the normal case pymunk can be installed with pip:
> pip install pymunk
It has one (or two) dependencies. CFFI and if not on Windows or OSX you also need a working gcc compiler.
Quick code example:
import pymunk # Import pymunk.. space = pymunk.Space() # Create a Space which contain the simulation space.gravity = 0,-1000 # Set its gravity body = pymunk.Body(1,1666) # Create a Body with mass and moment body.position = 50,100 # Set the position of the body poly = pymunk.Poly.create_box(body) # Create a box shape and attach to body space.add(body, poly) # Add both body and shape to the simulation while True: # Infinite loop simulation space.step(0.02) # Step the simulation one step forward
For more detailed and advanced examples, take a look at the included demos (in examples/).
The source distribution of Pymunk ships with a number of demos in the examples directory, and it also contains the full documentation including API reference.
You can also find the full documentation including examples and API reference on the Pymunk homepage, http://www.pymunk.org
“Make 2d physics easy to include in your game”
It is (or is striving to be):
Regardless of the method you use I will try to answer your questions as soon as I see them. (And if you ask on SO or the forum other people might help as well!)
Basically Pymunk have been made to be as easy to install and distribute as possible, usually pip install will take care of everything for you.
Pymunk has been tested and runs fine on both Python 2 and Python 3. It has been tested on recent versions of CPython (2 and 3) and Pypy. For an exact list of tested versions see the Travis and Appveyor test configs.
This section is only required in case you dont install pymunk the normal way (pip install or setup.py install). Otherwise its handled automatically by the install command.
Pymunk is built on top of the c library Chipmunk. It uses CFFI to interface with the Chipmunk library file. Because of this Chipmunk has to be compiled before it can be used with Pymunk. Compilation has to be done with GCC or another compiler that uses the same flags.
The source distribution does not include a precompiled Chipmunk library file, instead you need to build it yourself.
There are basically two options, either building it automatically as part of installation using for example Pip:
> pip install pymunk-source-dist.zip
Or if you have the source unpacked / you got Pymunk by cloning its git repo, you can explicitly tell Pymunk to compile it inplace:
> python setup.py build_ext --inplace
Note that chipmunk is actually not built as a python extension, but distutils / setuptools doesn’t currently handle pure native libraries that needs to be built in a good way if built with build_clib.
The compiled file goes into the /pymunk folder (same as space.py, body.py and others).
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|File Name & Checksum SHA256 Checksum Help||Version||File Type||Upload Date|
|pymunk-5.3.0-py2.py3-none-win32.whl (173.1 kB) Copy SHA256 Checksum SHA256||py2.py3||Wheel||Jun 11, 2017|
|pymunk-5.3.0-py2.py3-none-win_amd64.whl (179.4 kB) Copy SHA256 Checksum SHA256||py2.py3||Wheel||Jun 11, 2017|
|pymunk-5.3.0.zip (5.7 MB) Copy SHA256 Checksum SHA256||–||Source||Jun 11, 2017|