-
Notifications
You must be signed in to change notification settings - Fork 24
/
README
122 lines (89 loc) · 4.62 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
Ruby Bindings to Chipmunk Physics Version 6.1.3
*********************************************************************************
** This project is currently unmaintained. If you are interested in taking it **
** over, please open an issue. **
*********************************************************************************
(C) Scott Lembcke, Beoran, John Mair (banisterfiend) and Shawn Anderson (shawn42)
IMPORTANT NOTICE:
This is version 6.1.3.3 of the bindings for MRI Ruby 1.9.x to
Chipmunk version 6.1.3.
(1) 1/10/09 Cross-Platform Gem built by John Mair (banisterfiend)
* Just go: gem install chipmunk
FORUM:
http://www.slembcke.net/forums
CONTACT:
[email protected] (also on Google Talk) for Chipmunk.
[email protected] for these bindings to Ruby.
ABOUT CHIPMUNK:
Chipmunk is a simple, lightweight and fast 2D rigid body physics library
written in C by Slembcke. It's licensed under the unrestrictive, OSI approved
MIT license.
ABOUT THESE RUBY BINDINGS:
Although chipmunk comes with ruby bindings, they are not always up to date
with regards to the functionality of the C library, and historically, they
have been incompatible with recent versions of Ruby.
Therefore, these bindings are intended to as an enhanced version with more
features and better compatibility with recent versions of Ruby. They are also
intended to be an alternative to the chipmunk-ffi bindings when performance
is of the utmost importance, as it may be for games.
The intent is for these bindings to be mostly source code compatible with the
FFI bindings. Main exceptions are when it did not support the functionality I
added yet. All this is documented by specs and by the html documentation.
If you have any problems with these bindings, please contact the maintainer at
[email protected], or report the issue on the issue tracker:
https://github.com/chipmunk-rb/chipmunk/issues
REQUIREMENTS
* 1.9.x.
* rspec for running the specs.
* rake and rake-compiler for compiling the extension.
INSTALLATION
Clone this repository and do:
rake clean compile
There is also a gem available for Linux and OS/X, and a binary gem for Windows,
which you can try to install with:
gem install chipmunk
However, due to incompatilties in the latest versions of
Rake, Rake-Compiler and rubygems, the gem method of installation may fail for
you. This will be solved when these incompatibilities are solved by these
upstream tools.
These bindings vendor Chipmunk 6.1.3 with a few extra patches, so you don't
need to have it installed.
DOCUMENTATION:
Full handcrafted documentation based on the C documentation is available at:
http://chipmunk-rb.github.com/chipmunk/
CHANGES:
* Bumped to Chipmunk version 6.1.3; dropped 1.8 support
* Since 5.3.4.4: Vendored chipmunk again, uncleanly. should compile well now.
* Version 5.3.4.2 and 5.3.4.3 are broken, don't use them.
* Since 5.3.4.1: Vendored chipmunk again, cleanly. Several bugfixes.
* Since 5.1.0 : Much more of Chipmunk's functionality is wrapped. Unvendored
chipmunk. More specs and documentation.
VERSIONING POLICY:
Since 6.1.3.0 these bindings follow the version of chipmunk, followed by an
extra number for the version of the bindings. All major releases will be
backwards compatible in their API. The API may be enhanced in minor releases.
KNOWN BUGS:
* There are no bindings to SpaceHash since I think they are not so useful
anymore since Chipmunk supports BB queries.
* Some methods may crash with a segentation violation in case they are not
used correctly, according to the underlying requirements of the C library.
CONTRACTING:
Howling Moon Software (Slembke's company) is available for contracting if you
want to make the physics in your game really stand out. Feel free to contact
them through their webpage: http://howlingmoonsoftware.com/contracting.php
TODO:
* Allow several constructors to be more flexible and take nil as a default
argument.
* Try to prevent segfauts on incorrect use of certain methods, if possible.
* Some more specs.
* Fix the gem when the upstream tools get fixed.
INFO FOR MAINTAINERS:
(1) 1/10/09 Cross-Platform Gem built by John Mair (banisterfiend)
* Just go: gem install chipmunk
(2) Patched for 1.9.1 by Beoran ([email protected])
(3) How to build the gems? (maintainers only)
* Install rake-compiler (http://github.com/luislavena/rake-compiler)
* Install 1.9.1 mingw ruby versions (instructions above)
* Type: rake cross native gem RUBY_CC_VERSION=1.9.1
* Upload new gems to rubygems
Join the chat at https://gitter.im/beoran/chipmunk