Pharo Chipmunk2D bindings

Pharo FFI bindings to Chipmunk2D.

⚠️ Warning: Not ready for production: API coverage is very incomplete and must check for memory leaks ⚠️

Chipmunk2D is a simple, lightweight, fast and portable 2D rigid body physics library written in C. It’s licensed under the unrestrictive, OSI approved MIT license. Hundreds of shipping games have chosen Chipmunk because of the high quality, speed, and accuracy of its 2D physics simulations.

Install

There are two steps that may be done in parallel. One if building the C library, and second, get Pharo and load the bindings.

Build C library

The objective of this step is to have the library in a directory named Chipmunk2D in the image directory.

First, git clone and checkout a specific commit:

git clone git@github.com:slembcke/Chipmunk2D.git
cd Chipmunk2D
git checkout d0239ef4599b3688a5a336373f7d0a68426414ba

Why that commit? at the moment of writing this README, the most recent tag in the chipmunk repo is too old (7.0.3) and build fails.

Second, cd to the library root directory and execute in command-line:

cmake .
make

It should show something like:

[ 34%] Linking C static library libchipmunk.a
[ 34%] Built target chipmunk_static
...
[ 69%] Linking C shared library libchipmunk.dylb
[ 69%] Built target chipmunk
...
[100%] Linking C executable chipmunk_demos
[100%] Built target chipmunk_demos

You can run the original library demos with ./demo/chipmunk_demos. Press keys A to Z to select between scenes.

Build Pharo bindings

Evaluate in Pharo 11:

Metacello new 
  baseline: 'Chipmunk2D'; 
  repository: 'github://tinchodias/pharo-chipmunk2D/';
  load.

Ensure in CpLibrary class that whether macModuleName or unixModuleName point to the right file.

History

The origin of this code dates back to https://github.com/cldm/pharo-storm that also comes from Esteban Lorenzano's Storm repostory in the old SmalltalkHub.

License

This code is licensed under the MIT license.