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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
|
/*
* pybox2d -- http://pybox2d.googlecode.com
*
* Copyright (c) 2010 Ken Lauer / sirkne at gmail dot com
*
* This software is provided 'as-is', without any express or implied
* warranty. In no event will the authors be held liable for any damages
* arising from the use of this software.
* Permission is granted to anyone to use this software for any purpose,
* including commercial applications, and to alter it and redistribute it
* freely, subject to the following restrictions:
* 1. The origin of this software must not be misrepresented; you must not
* claim that you wrote the original software. If you use this software
* in a product, an acknowledgment in the product documentation would be
* appreciated but is not required.
* 2. Altered source versions must be plainly marked as such, and must not be
* misrepresented as being the original software.
* 3. This notice may not be removed or altered from any source distribution.
*/
/*
* This is the main Python SWIG interface file.
*/
%module(directors="1") Box2D
%{
#include "Box2D/Box2D.h"
%}
/*note:
swig generated names: _Box2D.<class>_<name>
python obfuscated names: __<class>_<name>
*/
#ifdef SWIGPYTHON
/* To disable assertions->exceptions, comment out the two lines that define
USE_EXCEPTIONS. One is here, one is in Common/b2Settings.h */
#define USE_EXCEPTIONS
#ifdef USE_EXCEPTIONS
/* See Common/b2Settings.h also. It defines b2Assert to instead throw
an exception if USE_EXCEPTIONS is defined. */
%include "exception.i"
%exception {
try {
$action
} catch(b2AssertException) {
// error already set, pass it on to python
SWIG_fail;
}
if (PyErr_Occurred()) {
// This is if we set the error inside a function; report it to swig
SWIG_fail;
}
}
#endif
/* Director-exceptions are a result of callbacks that happen as a result to
the physics step or debug draw, usually. So, catch those errors and report
them back to Python.
Example:
If there is a typo in your b2Draw instance's DrawPolygon (in
Python), when you call world.DrawDebugData(), callbacks will be made
to such functions as that. Being Python code called from the C++ module,
they turn into director exceptions then and will crash the application
unless handled in C++ (try/catch) and then passed to Python (SWIG_fail).
*/
%exception b2World::Step {
try { $action }
catch (Swig::DirectorException) { SWIG_fail; }
catch (b2AssertException) { SWIG_fail; }
}
%exception b2World::DrawDebugData {
try { $action }
catch (Swig::DirectorException) { SWIG_fail; }
catch (b2AssertException) { SWIG_fail; }
}
%exception b2World::QueryAABB {
try { $action }
catch (Swig::DirectorException) { SWIG_fail; }
catch (b2AssertException) { SWIG_fail; }
}
%exception b2World::RayCast {
try { $action }
catch (Swig::DirectorException) { SWIG_fail; }
catch (b2AssertException) { SWIG_fail; }
}
%exception b2World::DestroyJoint {
try { $action }
catch (Swig::DirectorException) { SWIG_fail; }
catch (b2AssertException) { SWIG_fail; }
}
%exception b2World::DestroyBody {
try { $action }
catch (Swig::DirectorException) { SWIG_fail; }
catch (b2AssertException) { SWIG_fail; }
}
#pragma SWIG nowarn=314
/* ---- classes to ignore ---- */
/*Most of these are just internal structures, so there is no need to have them
accessible by Python. You can safely comment out any %ignore if you for some reason
do need them. Ignoring shrinks the library by a small amount. */
//%ignore b2ContactManager; // TODO
%ignore b2Chunk;
%ignore b2DynamicTree;
%ignore b2DynamicTreeNode;
%ignore b2Island;
%ignore b2Position;
%ignore b2Velocity;
%ignore b2TimeStep;
%ignore b2Simplex;
%ignore b2SimplexVertex;
%ignore b2SimplexCache;
%ignore b2StackAllocator;
%ignore b2StackEntry;
%ignore b2ContactRegister;
%ignore b2BlockAllocator;
%ignore b2Timer;
/* ---- features ---- */
/* Autodoc puts the basic docstrings for each function */
%feature("autodoc", "1");
/* Add callback support for the following classes */
%feature("director") b2ContactListener;
%feature("director") b2ContactFilter;
%feature("director") b2DestructionListener;
%feature("director") b2Draw;
%feature("director") b2DrawExtended;
%feature("director") b2QueryCallback;
%feature("director") b2RayCastCallback;
/* ---- includes ---- */
/* The order of these is important. */
/* Doxygen-generated docstrings. Can safely be commented out. */
%include "Box2D/Box2D_doxygen.i"
/* __dir__ replacement. Can safely be commented out. */
%include "Box2D/Box2D_dir.i"
/* __init__ replacement allowing kwargs. Can safely be commented out, but tests will fail. */
%include "Box2D/Box2D_kwargs.i"
/* __repr__ replacement -- pretty printing. Can safely be commented out. */
%include "Box2D/Box2D_printing.i"
/* Miscellaneous inline code. */
%include "Box2D/Box2D_inline.i"
/* Miscellaneous extended classes: b2Color, b2Version, b2DistanceProxy, b2BroadPhase */
%include "Box2D/Box2D_misc.i"
/* Typemaps that allow for tuples to be used in place of vectors,
the removal of getAsType, etc. */
%include "Box2D/Box2D_typemaps.i"
/* Contact-related classes (b2Contact, b2Manifold, etc.) */
%include "Box2D/Box2D_contact.i"
/* b2Vec2, b2Vec3, b2Mat22, b2Transform, b2AABB and related extensions. */
%include "Box2D/Box2D_math.i"
/* Allows for userData to be used. Also modifies CreateBody/Joint. */
%include "Box2D/Box2D_userdata.i"
/* b2World only. */
%include "Box2D/Box2D_world.i"
/* b2Body, b2Fixture, and related definitions. */
%include "Box2D/Box2D_bodyfixture.i"
/* b2Shape, b2CircleShape, b2PolygonShape. */
%include "Box2D/Box2D_shapes.i"
/* All joints and definitions. Defines b2JointTypes dict. */
%include "Box2D/Box2D_joints.i"
/* Extending the debug draw class. */
%include "Box2D/Box2D_debugdraw.i"
/* Include everything from the C++ library now */
%include "Box2D/Box2D.h"
/* And finally tag on the secondary namespace code to the end of Box2D.py */
%pythoncode %{
# Backward-compatibility
b2LoopShape = b2ChainShape
# Initialize the alternative namespace b2.*, and clean-up the
# dir listing of Box2D by removing *_swigregister.
#
# To see what this is, try import Box2D; print(dir(Box2D.b2))
from . import b2
s=None
to_remove=[]
for s in locals():
if s.endswith('_swigregister'):
to_remove.append(s)
elif s!='b2' and s.startswith('b2'):
if s[2]=='_': # Covers b2_*
setattr(b2, s[3].lower() + s[4:], locals()[s])
else: # The other b2*
if s[3].isupper():
setattr(b2, s[2:], locals()[s])
else:
setattr(b2, s[2].lower() + s[3:], locals()[s])
for s in to_remove:
del locals()[s]
del s
del to_remove
%}
#endif
|
