Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tinchodias/pharo-chipmunk2d
Pharo FFI bindings to Chipmunk2D library
https://github.com/tinchodias/pharo-chipmunk2d
ffi pharo
Last synced: 8 days ago
JSON representation
Pharo FFI bindings to Chipmunk2D library
- Host: GitHub
- URL: https://github.com/tinchodias/pharo-chipmunk2d
- Owner: tinchodias
- License: mit
- Created: 2020-02-13T20:24:58.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-02-08T18:39:23.000Z (11 months ago)
- Last Synced: 2024-10-30T04:50:55.573Z (about 2 months ago)
- Topics: ffi, pharo
- Language: Smalltalk
- Homepage:
- Size: 80.1 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Pharo Chipmunk2D bindings
Pharo FFI bindings to [Chipmunk2D](http://chipmunk-physics.net/).
⚠️ 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:
```bash
git clone [email protected]: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:
```bash
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:
~~~Smalltalk
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](./LICENSE).