oyk 1.2.1

OYK is ODE (Open Dynamics Engine) bindings for Rust yaw kinetics
Documentation
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
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
//! meta
//!

use crate::ode::*;
use crate::ode::cls::*;
use crate::ode::krp::*;

/// id for trait MetaInf
#[derive(Debug)]
pub enum MetaId {
  /// ODE Sphere
  Sphere = 0,
  /// ODE Box
  Box,
  /// ODE Capsule
  Capsule,
  /// ODE Cylinder
  Cylinder,
  /// ODE Plane
  Plane,
  /// ODE Ray
  Ray,
  /// ODE Convex
  Convex,
  /// ODE GeomTransform
  GeomTransform,
  /// ODE TriMesh
  TriMesh,
  /// ODE Heightfield
  Heightfield,
  /// ODE Composite
  Composite
}

// #[macro_export]
macro_rules! meta_panic {
  ($s: ident, $e: expr) => { panic!("Expected {} but {:?}", $e, $s.id()); };
}
// pub use meta_panic;

/// MetaInf
pub trait MetaInf {
  /// MetaID
  fn id(&self) -> MetaId;
  /// every struct has krp
  fn get_krp_mut(&mut self) -> &mut Krp;
  /// every struct has krp
  fn get_krp(&self) -> &Krp;
  /// every struct has tcm
  fn get_tcm_mut(&mut self) -> &mut TCMaterial;
  /// every struct has tcm
  fn get_tcm(&self) -> &TCMaterial;
  /// as MetaSphere
  fn as_sphere(&self) -> &MetaSphere { meta_panic!(self, "Sphere"); }
  /// as MetaBox
  fn as_box(&self) -> &MetaBox { meta_panic!(self, "Box"); }
  /// as MetaCapsule
  fn as_capsule(&self) -> &MetaCapsule { meta_panic!(self, "Capsule"); }
  /// as MetaCylinder
  fn as_cylinder(&self) -> &MetaCylinder { meta_panic!(self, "Cylinder"); }
  /// as MetaPlane
  fn as_plane(&self) -> &MetaPlane { meta_panic!(self, "Plane"); }
  /// as MetaConvex
  fn as_convex(&self) -> &MetaConvex { meta_panic!(self, "Convex"); }
  /// as MetaTriMesh
  fn as_trimesh(&self) -> &MetaTriMesh { meta_panic!(self, "TriMesh"); }
  /// as MetaComposite
  fn as_composite(&self) -> &MetaComposite { meta_panic!(self, "Composite"); }
  /// clone MetaInf
  fn dup(&self) -> Box<dyn MetaInf> { meta_panic!(self, "Clone"); }
}

/// MetaSphere
#[derive(Clone)]
pub struct MetaSphere {
  /// mass density
  pub dm: dReal,
  /// radius
  pub r: dReal,
  /// krp
  pub krp: Krp,
  /// material
  pub tcm: TCMaterial
}

impl MetaSphere {
  /// construct
  pub fn new(dm: dReal, r: dReal,
    krp: Krp, tex: i32, col: dVector4) -> Box<MetaSphere> {
    Box::new(MetaSphere{dm: dm, r: r,
      krp: krp, tcm: TCMaterial::new(tex, col)})
  }
}

impl MetaInf for MetaSphere {
  /// MetaID
  fn id(&self) -> MetaId { MetaId::Sphere }
  /// every struct has krp
  fn get_krp_mut(&mut self) -> &mut Krp { &mut self.krp }
  /// every struct has krp
  fn get_krp(&self) -> &Krp { &self.krp }
  /// every struct has tcm
  fn get_tcm_mut(&mut self) -> &mut TCMaterial { &mut self.tcm }
  /// every struct has tcm
  fn get_tcm(&self) -> &TCMaterial { &self.tcm }
  /// as MetaSphere
  fn as_sphere(&self) -> &MetaSphere { self }
  /// clone MetaInf
  fn dup(&self) -> Box<dyn MetaInf> { Box::new(self.clone()) }
}

/// MetaBox
#[derive(Clone)]
pub struct MetaBox {
  /// mass density
  pub dm: dReal,
  /// lxyz
  pub lxyz: dVector3,
  /// krp
  pub krp: Krp,
  /// material
  pub tcm: TCMaterial
}

impl MetaBox {
  /// construct
  pub fn new(dm: dReal, lxyz: dVector3,
    krp: Krp, tex: i32, col: dVector4) -> Box<MetaBox> {
    Box::new(MetaBox{dm: dm, lxyz: lxyz,
      krp: krp, tcm: TCMaterial::new(tex, col)})
  }
}

impl MetaInf for MetaBox {
  /// MetaID
  fn id(&self) -> MetaId { MetaId::Box }
  /// every struct has krp
  fn get_krp_mut(&mut self) -> &mut Krp { &mut self.krp }
  /// every struct has krp
  fn get_krp(&self) -> &Krp { &self.krp }
  /// every struct has tcm
  fn get_tcm_mut(&mut self) -> &mut TCMaterial { &mut self.tcm }
  /// every struct has tcm
  fn get_tcm(&self) -> &TCMaterial { &self.tcm }
  /// as MetaBox
  fn as_box(&self) -> &MetaBox { self }
  /// clone MetaInf
  fn dup(&self) -> Box<dyn MetaInf> { Box::new(self.clone()) }
}

/// MetaCapsule
#[derive(Clone)]
pub struct MetaCapsule {
  /// mass density
  pub dm: dReal,
  /// radius
  pub r: dReal,
  /// length
  pub l: dReal,
  /// krp
  pub krp: Krp,
  /// material
  pub tcm: TCMaterial
}

impl MetaCapsule {
  /// construct
  pub fn new(dm: dReal, r: dReal, l: dReal,
    krp: Krp, tex: i32, col: dVector4) -> Box<MetaCapsule> {
    Box::new(MetaCapsule{dm: dm, r: r, l: l,
      krp: krp, tcm: TCMaterial::new(tex, col)})
  }
}

impl MetaInf for MetaCapsule {
  /// MetaID
  fn id(&self) -> MetaId { MetaId::Capsule }
  /// every struct has krp
  fn get_krp_mut(&mut self) -> &mut Krp { &mut self.krp }
  /// every struct has krp
  fn get_krp(&self) -> &Krp { &self.krp }
  /// every struct has tcm
  fn get_tcm_mut(&mut self) -> &mut TCMaterial { &mut self.tcm }
  /// every struct has tcm
  fn get_tcm(&self) -> &TCMaterial { &self.tcm }
  /// as MetaCapsule
  fn as_capsule(&self) -> &MetaCapsule { self }
  /// clone MetaInf
  fn dup(&self) -> Box<dyn MetaInf> { Box::new(self.clone()) }
}

/// MetaCylinder
#[derive(Clone)]
pub struct MetaCylinder {
  /// mass density
  pub dm: dReal,
  /// radius
  pub r: dReal,
  /// length
  pub l: dReal,
  /// krp
  pub krp: Krp,
  /// material
  pub tcm: TCMaterial
}

impl MetaCylinder {
  /// construct
  pub fn new(dm: dReal, r: dReal, l: dReal,
    krp: Krp, tex: i32, col: dVector4) -> Box<MetaCylinder> {
    Box::new(MetaCylinder{dm: dm, r: r, l: l,
      krp: krp, tcm: TCMaterial::new(tex, col)})
  }
}

impl MetaInf for MetaCylinder {
  /// MetaID
  fn id(&self) -> MetaId { MetaId::Cylinder }
  /// every struct has krp
  fn get_krp_mut(&mut self) -> &mut Krp { &mut self.krp }
  /// every struct has krp
  fn get_krp(&self) -> &Krp { &self.krp }
  /// every struct has tcm
  fn get_tcm_mut(&mut self) -> &mut TCMaterial { &mut self.tcm }
  /// every struct has tcm
  fn get_tcm(&self) -> &TCMaterial { &self.tcm }
  /// as MetaCylinder
  fn as_cylinder(&self) -> &MetaCylinder { self }
  /// clone MetaInf
  fn dup(&self) -> Box<dyn MetaInf> { Box::new(self.clone()) }
}

/// MetaPlane
#[derive(Clone)]
pub struct MetaPlane {
  /// mass density
  pub dm: dReal,
  /// lxyz
  pub lxyz: dVector3,
  /// norm
  pub norm: dVector4,
  /// krp
  pub krp: Krp,
  /// material
  pub tcm: TCMaterial
}

impl MetaPlane {
  /// construct
  pub fn new(dm: dReal, lxyz: dVector3, norm: dVector4,
    krp: Krp, tex: i32, col: dVector4) -> Box<MetaPlane> {
    Box::new(MetaPlane{dm: dm, lxyz: lxyz, norm: norm,
      krp: krp, tcm: TCMaterial::new(tex, col)})
  }
}

impl MetaInf for MetaPlane {
  /// MetaID
  fn id(&self) -> MetaId { MetaId::Plane }
  /// every struct has krp
  fn get_krp_mut(&mut self) -> &mut Krp { &mut self.krp }
  /// every struct has krp
  fn get_krp(&self) -> &Krp { &self.krp }
  /// every struct has tcm
  fn get_tcm_mut(&mut self) -> &mut TCMaterial { &mut self.tcm }
  /// every struct has tcm
  fn get_tcm(&self) -> &TCMaterial { &self.tcm }
  /// as MetaPlane
  fn as_plane(&self) -> &MetaPlane { self }
  /// clone MetaInf
  fn dup(&self) -> Box<dyn MetaInf> { Box::new(self.clone()) }
}

/// MetaConvex
#[derive(Clone)]
pub struct MetaConvex {
  /// free flag
  pub ff: bool,
  /// mass density
  pub dm: dReal,
  /// convexfvp *** CAUTION how to clone ***
  pub fvp: *mut convexfvp,
  /// krp
  pub krp: Krp,
  /// material
  pub tcm: TCMaterial
}

impl MetaConvex {
  /// construct
  pub fn new(ff: bool, dm: dReal, fvp: *mut convexfvp,
    krp: Krp, tex: i32, col: dVector4) -> Box<MetaConvex> {
    Box::new(MetaConvex{ff: ff, dm: dm, fvp: fvp,
      krp: krp, tcm: TCMaterial::new(tex, col)})
  }
}

impl MetaInf for MetaConvex {
  /// MetaID
  fn id(&self) -> MetaId { MetaId::Convex }
  /// every struct has krp
  fn get_krp_mut(&mut self) -> &mut Krp { &mut self.krp }
  /// every struct has krp
  fn get_krp(&self) -> &Krp { &self.krp }
  /// every struct has tcm
  fn get_tcm_mut(&mut self) -> &mut TCMaterial { &mut self.tcm }
  /// every struct has tcm
  fn get_tcm(&self) -> &TCMaterial { &self.tcm }
  /// as MetaConvex
  fn as_convex(&self) -> &MetaConvex { self }
  /// clone MetaInf
  fn dup(&self) -> Box<dyn MetaInf> { Box::new(self.clone()) }
}

impl Drop for MetaConvex {
  fn drop(&mut self) {
    if self.ff && self.fvp != 0 as *mut convexfvp {
unsafe {
      FreeConvexFVP(self.fvp, self.ff);
}
    }
  }
}

/// MetaTriMesh
#[derive(Clone)]
pub struct MetaTriMesh {
  /// free flag
  pub ff: bool,
  /// mass density
  pub dm: dReal,
  /// trimeshvi *** CAUTION how to clone ***
  pub tmv: *mut trimeshvi,
  /// krp
  pub krp: Krp,
  /// material
  pub tcm: TCMaterial
}

impl MetaTriMesh {
  /// construct
  pub fn new(ff: bool, dm: dReal, tmv: *mut trimeshvi,
    krp: Krp, tex: i32, col: dVector4) -> Box<MetaTriMesh> {
    Box::new(MetaTriMesh{ff: ff, dm: dm, tmv: tmv,
      krp: krp, tcm: TCMaterial::new(tex, col)})
  }
}

impl MetaInf for MetaTriMesh {
  /// MetaID
  fn id(&self) -> MetaId { MetaId::TriMesh }
  /// every struct has krp
  fn get_krp_mut(&mut self) -> &mut Krp { &mut self.krp }
  /// every struct has krp
  fn get_krp(&self) -> &Krp { &self.krp }
  /// every struct has tcm
  fn get_tcm_mut(&mut self) -> &mut TCMaterial { &mut self.tcm }
  /// every struct has tcm
  fn get_tcm(&self) -> &TCMaterial { &self.tcm }
  /// as MetaTriMesh
  fn as_trimesh(&self) -> &MetaTriMesh { self }
  /// clone MetaInf
  fn dup(&self) -> Box<dyn MetaInf> { Box::new(self.clone()) }
}

impl Drop for MetaTriMesh {
  fn drop(&mut self) {
    if self.ff && self.tmv != 0 as *mut trimeshvi {
unsafe {
      FreeTriMeshVI(self.tmv, self.ff);
}
    }
  }
}

/// MetaComposite (not have dup #[derive(Clone)])
pub struct MetaComposite {
  /// elements
  pub elems: Vec<Box<dyn MetaInf>>,
  /// quaternions
  pub qs: Vec<dQuaternion>,
  /// offsets
  pub ofs: Vec<dVector3>,
  /// krp
  pub krp: Krp,
  /// material
  pub tcm: TCMaterial
}

impl MetaComposite {
  /// construct
  pub fn new(elems: Vec<Box<dyn MetaInf>>,
    qs: Vec<dQuaternion>, ofs: Vec<dVector3>,
    krp: Krp, tex: i32, col: dVector4) -> Box<MetaComposite> {
    Box::new(MetaComposite{elems: elems, ofs: ofs, qs: qs,
      krp: krp, tcm: TCMaterial::new(tex, col)})
  }
}

impl MetaInf for MetaComposite {
  /// MetaID
  fn id(&self) -> MetaId { MetaId::Composite }
  /// every struct has krp
  fn get_krp_mut(&mut self) -> &mut Krp { &mut self.krp }
  /// every struct has krp
  fn get_krp(&self) -> &Krp { &self.krp }
  /// every struct has tcm
  fn get_tcm_mut(&mut self) -> &mut TCMaterial { &mut self.tcm }
  /// every struct has tcm
  fn get_tcm(&self) -> &TCMaterial { &self.tcm }
  /// as MetaComposite
  fn as_composite(&self) -> &MetaComposite { self }
}