Fixed: Orphaned declaration of dJointAddPUTorque() was replaced with dJointAddPUTorques()
[ode.git] / CHANGELOG.txt
blobb4acab3fbcb72c954ccc070a933b056f52d5c79c
1 ODE CHANGELOG
2 -------------
4 the rules for this file:
5   * entries are sorted newest-first.
6   * summarize sets of changes - dont reproduce every CVS log comment here.
7   * don't ever delete anything.
8   * keep the format consistent (79 char width, M/D/Y date format).
10 ------------------------------------------------------------------------------
11 06/28/2023 Oleh Derevenko
12         * dJointAddPUTorques() was added to replace orphaned declaration of 
13           dJointAddPUTorque()
15 06/24/2023 Oleh Derevenko (by Tilmann)
16         * Fixed a missing break in a switch statement in demo_jointPU.cpp while
17           handling gravity switching request.
18         * Fixed wrong face index being returned in convex-trimesh libCCD 
19           collision check routine.
20         * Fixed use of potentially outdated AABBs in GIIMPACT cylinder-trimesh
21           collision check routine.
23 11/08/2020 Steve Peters
24         * dGeomBoxPointDepth implementation was fixed for locations outside of
25           the box.
27 10/16/2020 Oleh Derevenko
28         * A fault on method call from within Joint class destructor in Python
29           bindings fixed (by Tyler Limkemann)
31 07/28/2020 Oleh Derevenko
32         * A threaded job data race fixed on job release (issue #70). 
33           The bug could cause writes to functions's stack area after 
34           the function returned and World simulation errors not being reported
35           with the function result if the simulation failed.
37 05/11/2020 Oleh Derevenko
38         * GIMPACT math macros were changed to use standard floating point math
39           rather than custom "optimized" implementations.
41 02/19/2020 Oleh Derevenko
42         * libCCD configuration description strings have been added for 
43           use with dGetConfiguration() and dCheckConfiguration().
45 03/06/2019 Oleh Derevenko
46         * dWorldAttachQuickStepDynamicIterationStatisticsSink public function 
47           was added to allow dynamic step count adjustment monitoring for
48           world instances.
50 02/21/2019 Oleh Derevenko
51         * Dynamic step count adjustment was implemented for dWorldQuickStep
52           with dWorldSetQuickStepDynamicIterationParameters and 
53           dWorldGetQuickStepDynamicIterationParameters new API functions
54           to control the feature.
55           The solver estimates per body resulting contact force maximal 
56           absolute adjustment value and may exit after fewer iterations if
57           the adjustments get smaller than the given threshold, or iterate 
58           longer if the adjustments are still significant after the default
59           iteration count is executed.
61 01/20/2019 Oleh Derevenko
62         * x86 targets have been changed to generate SSE2 code for calculations
63           by default with possibility to explicitly configure back for FPU.
65 11/12/2018 Oleh Derevenko
66         * The commentary from 11/05/2018 was wrong. The constraints were not
67           reset to their natural order and remained randomized.
68           The other thing that was missing was full contraint reorder without 
69           separation into independent and dependent ones. The algorithm doesn't
70           converge without it well.
72 11/10/2018 Oleh Derevenko
73         * An incorrect optimization to Jacobian Copy building code from #1938
74           that resulted in corrupt data in multi-threaded execution mode was 
75           fixed.
77 11/05/2018 Oleh Derevenko
78         * An unintended change from commit #1898 has been reverted.
79           The QuickStep used to solve with randomized constraint order 
80           each 8th iteration. The other iterations, the constraints 
81           were reset to their natural order, as generated, with the dependent
82           constraints gathered in reverse order at end (the reverse order is 
83           somehow important). With the commit #1898 the constraints were
84           randomly reordered each 8th iteration but then remained 
85           in that randomized order and only were re-randomized on subsequent
86           multiples of 8.
88 10/09/2017 Markus Rickert
89         * CMake support for project file generation has been added.
91 06/14/2017 Oleh Derevenko
92         * dxHashSpace::collide() has been changed to fault host program 
93           if scene gets too large and causes integer overflow.
95 06/06/2017 Oleh Derevenko
96         * Memory and pointer size integer type use has been changed so that 
97           internal typedefs are used instead of "_t" suffixed types.
99 05/09/2017 Oleh Derevenko
100         * Introduction of cooperative algorithms API. 
101           L*D*LT cooperative factorization and linear equation system 
102           cooperative solving have been implemented.
103         * AtomicReadReorderBarrier, AtomicStore, AtomicStorePointer functions 
104           have been added and some atomic function implementations have been 
105           improved in OU.
107 02/20/2017 Oleh Derevenko
108         * Project generation options have been changed to have built-in
109           multithreaded threading implementation enabled by default.
111 02/19/2017 Oleh Derevenko
112         * dWorldStep threaded implementation has been extended to the final 
113           steps of constraint force applications and body position updates
114           after the LCP solving. Note that body callbacks (if set) may be
115           called from multiple threads if threaded execution is enabled.
116         * OU atomicord32 type has been fixed to be unsigned on all supported
117           platforms.
119 01/09/2017 Oleh Derevenko
120         * dGeomTriMeshDataPreprocess2() public function has been added to 
121           replace dGeomTriMeshDataPreprocess(). Face angles pre-computation
122           for triangle meshes has been implemented.
124 11/13/2016 Oleh Derevenko
125         * dGeomTriMeshDataGetBuff and dGeomTriMeshDataSetBuff have been marked 
126           deprecated and their functionality implemented via 
127           dGeomTriMeshDataGet and dGeomTriMeshDataSet. Extra function variant
128           dGeomTriMeshDataGet2() has been added to allow returning data size.
130 11/07/2016 Oleh Derevenko
131         * The implementation of OPCODE TriMesh data pre-processing 
132           (dGeomTriMeshDataPreprocess()) has been optimized to only contain
133           a sort and a single pass over edges (used to be a sort and O(N^2)).
135 10/29/2016 Oleh Derevenko
136         * dGeomTriMeshDataPreprocess() public function has been changed to 
137           return a boolean status (it can fail in low memory conditions).
139 07/10/2016 Oleh Derevenko
140         * The correct handling of dJOINT_REVERSE mode for AngularMotor Joint 
141           implemented (issue #37).
143 06/29/2016 Oleh Derevenko
144         * A bug fixed with HashSpace calling big boxes collision twice 
145           (both straight and reverse geometries order) since revision #1831.
147 06/03/2016 Oleh Derevenko
148         * dJointSetHinge2Axes public function has been added and 
149           dJointSetHinge2Axis1/2 have been marked deprecated due to being 
150           unsafe.
152 05/13/2016 Oleh Derevenko
153         * ICE Container class allocation strategy fixed to avoid reserving 
154           excess memory with large collections.
156 05/10/2016 Oleh Derevenko
157         * dSafeNormalize3 and dSafeNormalize4 functions changed to leave the
158           parameter intact instead of replacing it with the X-axis unit in case 
159           of fault.
161 04/12/2016 Oleh Derevenko
162         * A function to create a self-threaded threading implementation object
163           has been moved back to public headers as there could be a use for it
164           while running several worlds in parallel threads.
166 01/09/2016 Oleh Derevenko
167         * Hinge2 joint corected to avoid faulting asserts when the axes get 
168           temporarily invalid during assignments (suggested by David Mansolino)
170 01/03/2016 Oleh Derevenko
171         * An invalid memory access fixed in dxSAPSpace::BoxPruning() in case
172           if there were NaN values in AABBs to be sorted.
174 12/25/2015 Oleh Derevenko
175         * Unexpected joint mode assignment (instead of comparison) fixed within
176           an dUASSERT in dJointSetTransmissionAxis2() of transmission joint
178 11/28/2015 Oleh Derevenko
179         * Convex-Trimesh collider added (libccd+GIMPACT only)(by Piotr Piastucki)
180         * dCreateConvex() and dGeomSetConvex() public APIs changed to expect 
181           their parameter arrays as const pointers
183 11/01/2015 Oleh Derevenko
184         * OPCODE mesh colliders' input coordinates have been offset to  
185           mesh-relative frames to decrease potential computational errors
186           (suggested by luckytrashsc2@g***l.com)
188 08/05/2015 Oleh Derevenko
189         * Implemented change to return highest depth contacts subset for GIMPACT 
190           in cases if contacts count exceeds requested maximum (as suggested in 
191           the issue #36 by Piotr Piastucki)
193 11/17/2014 Daniel K. O.
194         * Added support for using libccd from the system (if found via
195           pkg-config)
197 11/10/2014 Oleh Derevenko
198         * Floating point division by zero in capsule-ray collision routine 
199           in case if the ray axis was parallel the cylinder and the ray started
200           from within it fixed (issue #26)
202 11/08/2014 Oleh Derevenko
203         * Threading support has been extended to complete implementation 
204           of QuickStep
206 10/29/2014 Daniel K. O.
207         * Added dJointSetDBallDistance
209 10/19/2014 Oleh Derevenko
210         * Built-in threading implementation compilation fixed for OSX
211           (clock_gettime() is missing from the system - reported by Bram)
213 08/10/2014 Oleh Derevenko
214         * Declarations of dWorld[Get/Set]AutoDisableLinearAverageThreshold and
215           dWorld[Get/Set]AutoDisableAngularAverageThreshold have been removed 
216           from public headers (were orphaned since rev.1052)
218 07/16/2014 Oleh Derevenko
219         * Two fixes by Francesco Cat applied (fixes for mistakes made during
220           code style improvements in the past)
221                  
222 02/27/14 Daniel K. O.
223         * Added dODE_VERSION macro to public headers (issue #24).
225 02/11/14 Daniel K. O.
226         * Added dJointGetHinge2Angle2 (issue #12).
228 02/07/14 Daniel K. O.
229         * Added dWorldSetData/dWorldGetData (issue #21).
231 01/31/14 Daniel K. O.
232         * Applied patch #185: Stable, implicit gyroscopic forces.
234 01/27/14 Daniel K. O.
235         * Fixed cylinder AABB computation.
237 01/25/14 Daniel K. O.
238         * Removed ALLOCA calls from dHashSpace; it should not depend
239           on stack size limits anymore.
241 12/06/13 Daniel K. O.
242         * Applied patch #181: fix some bugs in AMotor joint.
243         * Applied patch #186: fix some bugs in PU joint.
244         * Applied patch #182: Transmission joint.
245         * Applied patch #184: implement rolling friction for contacts.
247 08/08/13 Oleh Derevenko
248         * Joint feedback forces application fixed in QuickStep implementation
249           (was broken since revision #1919 in old repository (#1927 in new one))
251 08/04/13 Oleh Derevenko
252         * Bugfix #89 by Luc applied (dJointAddSliderForce() adds a zero force
253           when the parent body is NULL) 
255 05/18/13 Oleh Derevenko
256         * OU library has been included in ODE at revision #46 instead of  
257           being used as an external link due to difficulties using external 
258           references with new protocol used for storage at SF.
260 03/03/13 Oleh Derevenko
261         * Fixed issue with "findex==-1" constraints being intermixed with 
262           "findex!=-1" ones during constraints random reordering in QuickStep.
264 02/03/13 Oleh Derevenko
265         * [u]int[8/16/32] renamed to contain "d" prefix so that global namespace
266           was not polluted with these names unconditionally. 
267           If your project depended on these types other than just for passing 
268           parameters to ODE calls, add similar typedefs for yourself in some 
269           of your project's global headers.
271 01/02/13 Oleh Derevenko
272         * Applied patch #183 by Joseph Cooper (complementary matrix 
273           calculation fix).
275 12/28/12 Oleh Derevenko
276         * A bug with heightfield data assigned to a wrong field in 
277           dGeomHeightfieldSetHeightfieldData fixed (bug report #88 by Luc).
279 12/18/12 Oleh Derevenko
280         * Fixed issue with some kinds of joints (Ball, DBall, DHinge, Fixed)
281           might overwrite world ERP value with their custom ERP during 
282           getInfo2() call and that inappropriate value would then be passed 
283           to subsequent joints in solver instead of world ERP.
285 12/01/12 Oleh Derevenko
286         * Fixed issues reported in patches #151 and #22 (collisions with
287           SAPSpace and QuadTreeSpace might not work because geometries list
288           was misused in them).
289         * Applied patch #160 "IsPointInPolygon in convex.cpp returns wrong 
290           results" (by Janis Rucis)
292 11/25/12 Oleh Derevenko
293         * Configuration option --disable-threading-intf added 
294           (--no-threading-intf for Windows/Premake). This allows disabling
295           threading interface support (external implementations may not be 
296           assigned) but eliminates dependency on OU and use of atomics in 
297           steppers.
299 11/05/12 Oleh Derevenko
300         * Fixed zero comparisons in OPCODE to use relative error instead of
301           absolute epsilon value (found by Bill Sellers)
303 06/08/12 Daniel K. O.
304         * Removed the need for defining dSINGLE/dDOUBLE; this is stored now in
305           the generated ode/precision.h header.
306         * Some code cleanup to get rid of GCC warnings.
308 05/30/12 Daniel K. O.
309         * Made drawstuff draw shadows for lines.
310         * Fixed dhinge's last constraint to properly handle rotations.
312 05/03/12 Daniel K. O.
313         * Added two new joints: Double Ball and Double Hinge.
315 04/22/12 Daniel K. O.
316         * Fixed plane2d joint: uninitialized variables (reported by Dimitris
317           Papavasiliou)
319 04/14/12 Oleh Derevenko
320         * Assertion checking macros moved into library private headers.
322 04/13/12 Daniel K. O.
323         * Applied patch from bug  #3431829 - better handling of capsule-box with
324           deep penetrations.
325         * Fixed zero-mu issues: now either mu or mu2 can be set to zero.
327 03/17/12 Oleh Derevenko
328         * Threaded execution support interface added. Optional built-in threading
329           implementation added.
330           Internal threading implementation is excluded by default and to be used, 
331           it must be enabled with configure/premake.
332           At present, if threading interface is assigned to a world, island 
333           selection and stepping is performed in multiple threads (one thread per 
334           island).
336 03/12/12 Oleh Derevenko
337         * PURE_INLINE macro renamed to ODE_PURE_INLINE and definition of 
338           dNextAfter()/dCopySign() corrected to avoid creating conflicts with 
339           other libraries.
341 02/03/12 Oleh Derevenko
342         * Assertion checking macros moved from common.h to error.h
344 12/18/11 Oleh Derevenko
345         * dIVERIFY macro added (same as dIASSERT in debug mode but evaluates its
346           expression in release mode) to be used to assert variable value 
347           which is not used further in text while avoiding compiler warning.
348         * dICHECK macro added (same as dIASSERT but evaluates its expression and 
349           raises assertion fault regardless of compilation mode) to be used to
350           generate a fault in cases when error is very unlikely but must be 
351           handled and handling is very troublesome (e.g. failure to lock a mutex
352           due to lack of resources).
354 12/07/11 Oleh Derevenko
355         * Partially fixed size_t to integer conversion warnings
356         * Fixed type signedness and added casts to size_t wherever necessary 
357           in Step/QuickStep
359 11/04/11 Daniel K. O.
360         * Applied patch #3429454 - fix compilation on some platforms.
362 10/28/11 Daniel K. O.
363         * Fixed a box-capsule bug: more reasonable normal for deep penetrations
364           (contributed by Georg Martius.)
366 10/27/11 Daniel K. O.
367         * Disabled merging of contacts for trimesh-sphere by default.
368         * Added new demo: demo_tracks.
370 10/17/11 Daniel K. O.
371         * Added python bindings, contributed by Gideon Klompje.
372         * Updated some build scripts.
373         * Changed spheres distribution in demo_space_stress.
375 05/17/11 Oleh Derevenko
376         * A typo in step.cpp fixed (assignment operator in a conditional 
377           instead of comparison) (reported by Bram Stolk)
379 01/29/11 Oleh Derevenko
380         * Heightfield zone boundaries calculation code fixed to also consider
381           whole next cell after the AABB if the AABB ends exactly at the cell
382           boundary.
384 01/23/11 Daniel K. O.
385         * Applied patch from Daniel Fiser, add libccd collider for
386           box-cylinder.
388 01/20/11 Daniel K. O.
389         * Applied patch from Daniel Fiser, fix infinite loop in libccd caused
390           by numerical problems.
392 01/06/11 Daniel K. O.
393         * Applied patch from Daniel Fiser, efficient libccd tests when using
394           CONTACTS_UNIMPORTANT.
396 12/17/10 Daniel K. O.
397         * Applied patches from Daniel Fiser for new colliders based on libccd.
399 11/08/10 Daniel K. O.
400         * Applied patches from Daniel Fiser to incorporate libccd for
401           Cylinder-Cylinder collision tests.
403 08/21/10 Oleh Derevenko
404         * Fix applied to dxReallocateTemporayWorldProcessContext() to remove typo 
405           which caused segmentation fault (by Kyle McKay).
406           dTestSolveLCP() fixed to avoid exceeding allocated memory pool 
407           (by Kyle McKay).
409 07/19/10 Oleh Derevenko
410         * Patch applied (#3030783) to fix drawstuff dimensions being ignored
411           in OSX GLUT port (by Danny Price).
413          Daniel K. O.
414         * Applied patch #2991622: dGeomGetRelPointPos, dGeomGetPosRelPoint,
415           dGeomVectorToWorld, and dGeomVectorFromWorld.
417 07/16/10 Daniel K. O.
418         * Fixed bug #2937076: don't try to build demos if drawstuff is disabled.
420 05/02/10 Oleh Derevenko
421         * Missing extern "C" wrapper has been added to include/ode/export-dif.h
422           (reported by Danny Price). The change affects dWorldExportDIF() public 
423           function.
425 05/02/10 Oleh Derevenko
426         * Patch applied (#2995450) to generate up to four contacts for box-
427           plane collision test (by alexdu) and fix contact depths.
429 05/02/10 Oleh Derevenko
430         * dGeomLowLevelControl function added with ability to change/query OPCODE 
431           trimesh-sphere contact merging behavior at runtime.
433 02/18/10 Daniel K. O.
434         * Fixed bug affecting disabled joints and dWorldStep.
436 01/16/10 Oleh Derevenko
437         * Patch applied (#2931174) to make demos work for recent MacOS.
438         * Patch applied (#2931177) to fix the demos' framerate on X11.
440 12/20/09 Oleh Derevenko
441         * QuadTreeSpace implementation corrected to avoid object-block relation 
442           ambiguity due to numeric errors.
444 12/04/09 Oleh Derevenko
445         * odecpp classes changed to be inheritable and easily expandable
447 11/29/09 Oleh Derevenko
448         * Improvement for trimesh-plane collision (also used in trimesh-heightfield)
449           to exclude mesh vertices that have already generated contacts from further
450           examination and contact generation in other triangles (suggested by LR).
452 10/25/09 Oleh Derevenko
453         * Macros changed to static inline functions in odemath.h and related files.
454           Some code duplication has been eliminated across the files.
456         * Fixed handling of --disable-asserts and --enable-double-precision 
457           (absence of --enable-double-precision) in configure script. The script
458           was not appending compiler defines correctly.
460         * dWorldStep implementation changed to remove allocation on stack. 
461           dUSE_MALLOC_FOR_ALLOCA define has been removed as well as corresponding
462           configuration parameter. Also dMemoryFlag public variable has been removed.
463           (look for presence of ODE_EXT_malloc_not_alloca configuration string if
464           your application is dependent on that variable).
466 09/05/09 Oleh Derevenko
467         * dWorldStepFast1 API removed along with dWorld[Get/Set]AutoEnableDepthSF1
469 08/29/09 Oleh Derevenko
470         * Fixed uninitialized floating point array used in computations.
472 08/12/09 Oleh Derevenko
473         * A typo fixed in dGeomCopyOffsetRotation() (final_posr was used instead 
474           of offset_posr). Reported by Tilmann.
476 08/11/09 Daniel K. O.
477         * Made sure neither dSINGLE or dDOUBLE is defined by default; the user
478           should always explicitly specify the precision.
480 06/27/09 Oleh Derevenko
481         * New functions have been added:
482            - dWorldUseSharedWorkingMemory
483            - dWorldCleanupWorkingMemory
484            - dWorldSetStepMemoryReservationPolicy
485            - dWorldSetStepMemoryManager
486                 
487 06/25/09 Remi Ricard (papaDoc)
488         * Add limit to the to the second axis of the universal joint
489          for the pu joint.
491 06/14/09 Oleh Derevenko
492                 * dWorldQuickStep re-implemented to avoid memory allocation on stack.
493                   Also several optimizations have been made to decrease memory 
494                   requirements and optimize algorithm implementation of dWorldQuickStep.
495                   dWorldStep still remains with old memory allocation however new APIs
496                   mentioned below are fully functional for it.
497                   Both dWorldStep and dWorldQuickStep have been changed to return boolean
498                   success status.
500                 * dInitODE2() changed to automatically call 
501                   AllocateODEDataForThread(dAllocateFlagBasicData) after library 
502                   initialization as this is a required initialization minimum that
503                   must always be performed anyway.
505 06/05/09 Daniel K. O.
506          * Removed aliasing issues from OPCODE/Ice, plus some other warnings.
507            Now it builds on gcc 4.3.2 with '-Wall -Werror -O3".
509 05/30/09 Oleh Derevenko
510          * A minor memory usage optimization for QuickStep.
512 05/24/09 Daniel K. O.
513          * Made the new trimesh collider the default.
514          * Added a "-texturepath" option to drawstuff.
516 05/18/09 Oleh Derevenko
517         * Heightfield rotation fixed to avoid NaNs while rotating infinite
518           MIN/MAX heights.
520 05/03/09 Oleh Derevenko
521         * Incorrect parameter order fixed on contact merging in Sphere-Trimesh
522           collisions. The bug resulted in merged contact remaining with normal
523           of first contact found. Thanks to Dimitris Papavasiliou for reporting.
525 04/23/09 Daniel K. O.
526         * Fixed bug #2685170: use the C99 __func__ instead of __FUNCTION__ when
527           a C99 implementation is available.
529 04/07/09 Remi Ricard (papaDoc)
530         * Remove unused code in demo_joints.cpp, reported by Tilmann.
532 04/07/09 Remi Ricard (papaDoc)
533         * Fix bug in collision categories in demo_jointPU, reported by Tilmann
535 03/14/09 Oleh Derevenko
536         * A possibility to initialize/close ODE multiple times recursively has 
537           been added.
538           Also, now a call to dSpaceSetManualCleanup() is required for each 
539           space right after creation if ODE has been initialized in thread data
540           manual cleanup mode.
541            
542 03/07/09 Oleh Derevenko
543         * Thread local data has been cleaned up from OPCODE and OdeTls as it is
544           not used (OPC_SweepAndPrune.* and OPC_BoxPruning.* have been removed
545           - rebuilding project files is necessary).
547 02/07/09 Daniel K. O.
548         * New house of cards demo, which stresses the friction handling stability.
550 01/29/09 Remi Ricard (papaDoc)
551         * Fix bug: Fix problem when attaching no body to a joint. Before calling
552           setRelativeValues a check is made for bodies.
553         * Add unittest
555 01/28/09 Daniel K. O.
556         * Applied patch #2538046: Heightfield AABB bounds patch.
558 01/23/09 Remi Ricard (papaDoc)
559          * Add new function dJointSetUniversalAxis1Offset and dJointSetUniversalAxis2Offset
560          * Add unittest for those funcitons.
562 01/23/09 Remi Ricard (papaDoc)
563          * Fix problem with dJointGetUniversalAngle2 when the joint is attached to
564            only a body 2. The sign was inverted.
565          * Add unit test to verify for this problem
567 01/21/09 Remi Ricard (papaDoc)
568          * Fix bug reported by Tilman: dxJointPU::getInfo1 was setting twice the
569            limit of limot1 to zero and not limot2
571 01/17/09 Daniel K. O.
572         * Fixed a bug in dSpaceCollide2: if both geoms are not in spaces they would
573           not have valid AABBs.
575 12/20/08 Daniel K. O.
576         * New functions: dJointEnable, dJointDisable, dJointIsEnabled
577           (patch #2454764).
579 12/19/08 Daniel K. O.
580         * Removed inline asm statements that break builds on 64-bit VC++.
582 12/09/08 Daniel K. O.
583         * Applied patch #2381592, which adds support for Kinematic Bodies.
585 12/06/08 Oleh Derevenko
587        * Applied a patch by Martijn Buijs to make GIMPACT trimesh-ray collisions to
588          be consistent with those in OPCODE.
589        * Swapped geometries returned in contacts for OPCODE Trimesh-Plane collisions
590          as they were returned in unnatural order being different from that in GIMPACT
591        * Applied a patch by Martijn Buijs to make side1, side2 fields of contact 
592          structure be always initialized, either with -1 for non-trmesh geometries
593          or with triangle index for trimeshes. These fields were only assigned for
594          trimesh-trimesh collisions before.
595        * dGeomTriMeshSetTriMergeCallback/dGeomTriMeshGetTriMergeCallback API added
596          to set/get user defined callback procedure for trimeshes that would be 
597          invoked when contacts are merged to let user code accumulate attributes of
598          original contact triangles and generate a fake index by which it would 
599          later be able to determine those attributes. If the callback is not 
600          assigned (the default) -1 is generated as triangle index for merged 
601          contacts (there was an index of first of merged triangles before!!!).
602          The callback is currently used within OPCODE trimesh-sphere and OPCODE
603          new trimesh-trimesh collisions.
605 11/20/08 Remi Ricard (papaDoc)
606        * Fix problem with dJointGetPUPosition and
607          dJointGetPUPositionRate when the joint is attached to only
608          a body 2. The sign was inverted.
609        * Fix bug: When a pu joint had only one body attached to position 2,
610          dJointAttach(jId, 0, bId). The body was not push in the right direction to
611          move back between the limits.
612        * Add unit test to check the above problem
613        * Add the function void dJointSetPUAnchorOffset
614        * Make the function void dJointSetPUAnchorDelta deprecated
616 11/19/08 Remi Ricard (papaDoc)
617        * Fix bug: When a pr joint had only one body attached to position 2,
618          dJointAttach(jId, 0, bId). The body was not push in the right direction to
619          move back between the limits.
620        * Add unit test to check the above problem
622 11/19/08 Remi Ricard (papaDoc)
623         * Fix problem with dJointGetPRPosition and
624           dJointGetPRPositionRate when the joint is attached to only
625           a body 2. The sign was inverted.
626         * Add unit test to check the above problem
627         * Increase the tolerance to remove failure in unit test
628         * Remove compilation warning in unit test with the use of REAL()
630 11/18/08 Remi Ricard (papaDoc)
631        * Fix bug: When a piston joint had only one body attached to position 2,
632          dJointAttach(jId, 0, bId). The body was not push in the right direction to
633          move back between the limits.
634        * Add more functionality to demo_piston.cpp
635        * Run astyle on modified files.
637 11/18/08 Remi Ricard (papaDoc)
638         * Fix bug: When a slider joint had only one body attached to position 2,
639          dJointAttach(jId, 0, bId). The body was not push in the right direction to
640          move back between the limits.
642 10/29/08 Oleh Derevenko
644         * Premake scripts changed to only include chosen collision library
645           sources in project on Windows. --all-collis-libs premake option 
646           added to allow inclusion of all collision library sources into the 
647           project
649 10/15/08 Remi Ricard (papaDoc)
650         * Applying patch #2158425 64-bit GIMPACT provided by Mark
651           William. This patch enable GIMPACT to works on 64-bit machine.
653 10/15/08 Remi Ricard (papaDoc)
654         * Add function dJointGetPRAngle and dJointGetPRAngleRate
656 10/15/08 Remi Ricard (papaDoc)
657         * Enable the motor on the rotoide part of the PR joint
659 10/15/08 Remi Ricard (papaDoc)
660         * Add unit test to check if using directly a joint
661           or using after setting with default values is the same.
662         * Add function setRelativeValues called in dJointAttach for
663           all joints.
665 10/10/08 Remi Ricard (papaDoc)
666         * Fix bug in dJointGetPUAxis2. The axis was not multiplied with the
667           the rotation matrix of the good body.
668         * Fix bug if there is only one body on the PU joint the axis returned
669           was not the right one.
670         * Add unit test to verify previous bug.
672 10/03/08 Rodrigo Hernandez (Kwizatz)
673         * Added Blender script to create ODE convex geoms under tools.
675 10/01/08 Rodrigo Hernandez (Kwizatz)
676         * Convex-Convex collision detection code is finally stable.
678 08/31/08 Daniel K. O.
679         * Applied patch 2080674: Improved dBodySetRotation; now exact rotation
680           matrices are preserved until the next simulation step.
682 08/07/08 Daniel K. O.
683         * Fixed strict aliasing issue that was breaking the new trimesh collider.
685 07/24/08 Daniel K. O.
686         * New functions: dBodyGetGyroscopicMode and dBodySetGyroscopicMode
687           (patch #2019242).
689 07/15/08  Remi Ricard (papaDoc)
690         * Add a new define ODE_API_DEPRECATED to mark function as deprecated
691           when necessary.
693 07/14/08 Remi Ricard (papaDoc)
694         * Finish adding patch 1336066: Joint feedback in quickstep by jsinecky
695         * demo_boxstack.cpp can now print joint feedback
697 07/11/08 Daniel K. O.
698         * Bumped version for 0.10.1
699         * Added proper usage of libtool's version info.
701 07/10/08 Remi Ricard (papaDoc)
702         * Add new function dJointSetPistonAnchorOffset
703         * Add unittest for the piston joint
704         * Fix problem with dJointGetPistonPosition and 
705           dJointGetPistonPositionRate when the joint is attached to only
706           a body 2. The sign was inverted.
708 07/09/08 Remi Ricard (papaDoc)
709         * Optimize function Multiply1_12q1 in quickstep
710           Patch proposed by Riemer v.d. Zee and modified by Patrick Baggett
712 07/08/08 Remi Ricard (papaDoc)
713         * Update the slider joint to have the same behavior as the other joint
714           when there is only a body2 attached to it.
715         * Update documentation for the slider joint.
716         * Remove warning by using REAL()
717         * Add new unittest for dJointGetSliderPositionRate
719 07/08/08 Remi Ricard (papaDoc)
720         * Update unittest for the slider.
721         * Rename the new function dJointSetHingeAxisDelta to 
722           dJointSetHingeAxisOffset. This remove will remove confusion with 
723           the old function dJointSetHingeAnchorDelta
724         * Update documentation for the Hinge unittest
725         * Remove warning by using REAL()
727 07/07/08 Daniel K. O.
728         * Max Correcting Vel doesn't affect bounciness, as before.
730 07/03/08 Remi Ricard (papaDoc)
731         * Add new function dJointSetHingeAxisDelta
732         * Add unittest for this new function
734 06/17/08 Remi Ricard (papaDoc)
736         *  Move the computation of the Relative Rotation for the slider joint
737            into a function.
738         * Add unittest for to check qrel 
740 06/17/08 Remi Ricard (papaDoc)
742        * Remove unused variables. 
743        * Remove a conversion warning between unsigned int and int
744         
745 06/17/08 Remi Ricard (papaDoc)
747         * Move the function hingeComputeRelativeRotation as a member of 
748           the hinge structure/class.
750 06/17/08 Remi Ricard (papaDoc)
752         *  Move the computation of the Relative Rotation for the fixed joint
753            into a function.
755 06/16/08 Remi Ricard (papaDoc)
757         * Add testunit for the dxJointFixed
759 06/04/08 Daniel K. O.
761         * Moved joints to ode/src/joints, converted them to true virtual
762           methods.
764 06/02/08 Daniel K. O.
766         * Added an Auto<T> template to step.cpp to handle memory deallocation.
768 05/09/08 Daniel K. O.
770         * Applied patch #1335202: Contact Joint Motion (with some corrections),
771           and added demo_motion.
773 05/01/08 Oleh Derevenko
775         * Memory leak in GIMPACT fixed (reported by Derek)
777 04/28/08 Oleh Derevenko
779         * Added possibility to collide a space of lower sublevel as a geometry
780           against another space of a higher level with dSpaceCollide2.
781           dSpaceSetSublevel/dSpaceGetSublevel are used for sublevel assignment/
782           retrieval.
784 04/27/08 Oleh Derevenko
786         * Fixed incorrect memory copying which could lead to memory corruption
787           in GIMPACT (luckily, in unused code)
788         * Fixed possible memory read beyond the end of allocated buffer along
789           with unnecessary extra memory copying in GIMPACT.
790         * Fixed buffer reserve being incorrectly reset to zero for bitsets 
791           what resulted in unnecessary memory reallocations in GIMPACT.
792         * Implemented support for ability to run collision detection from
793           multiple threads for separate spaces.
794            
795 04/14/08 Oleh Derevenko
797         * Fixed possible memory corruption in new trimesh-trimesh collider
798           in case if two degenerated triangles are checked against each other.
800 04/12/08 Oleh Derevenko
802         * Fixed sporadic assertion failure on vector normalization caused
803           by small triangles degenerating into segments during space 
804           transformations.
806 03/28/08 Remi
808         * Fix a bug in dJointXXXGetInfo. The value in limot.limit was not
809           always updated. (Ex: If hi and lo limit were changed). 
811 03/27/08 Remi
813         * Added a new Joint: Prismatic Universal (patch #1828454).
815          Daniel K. O.
817         * Fixed bug #1841309: collide2() method buggy.
819 03/18/08 Rodrigo
821         * New function: dVector4Copy.
823 03/14/08 david
825         * Added stub calls for trimesh functions.
826         * Applied patch #1914232: dGetConfiguration.
827         * Applied patch #1655333: Optimize the function dNormalize3.
828         * New function: dSetColliderOverride.
829         * New function: dCheckConfiguration.
830         
831          Daniel K. O.
833         * Disabled building shared library by default with autotools.
835 03/13/08 david
837         * New function: dJointGetNumBodies (patch #1901550).
838         * New function: dSpaceGetClass (patch #1901637).
839         * Applied patch #1901649: Add missing function in the export
841 03/12/08 Rodrigo
843         * Fixed drawstuff build issues on OSX.
845 01/12/08 Daniel K. O.
847         * Fixed a typedef bug in configure.in.
848         * Added dCylinder to the C++ wrappers.
849         * Applied patch 1851394: support for GIMPACT with double precision,
850           dCollide fix.
851         * Moved bunny geometry to bunny_geom.h.
853 12/11/07 Daniel K. O.
855         * Added damping and MaxAngularVel() functions.
856         * Const-correctness: added const qualifier to some dWorldGet and dBodyGet
857           functions.
858         * Updated the odecpp.h header.
860 12/07/07 Daniel K. O.
862         * Removed most of the compiler warnings from Drawstuff, ODE and
863           OPCODE
864         * Upgraded automake requirement to 1.10, and change some Makefile.am
866 12/06/07 Rodrigo
868         * Modified autotools to use libtool for
869           library generation and administration
870         * Removed release and debug flags for configure.in
871           CPPFLAGS, CFLAGS, CXXFLAGS should be set by the
872           user to their liking, respecting autotools policies.
874 11/30/07 Daniel K. O.
875         * Applied patch 1813079 (moved callback)
876         * Replaced moveAndRotateBody by dxStepBody in stepfast.cpp
878 11/10/07 david
880         * Added 'Sweep and Prune' collision space.
881         * New Piston joint type with demo, by Remi Ricard
882         * Added build option to use 16-bit indices for OPCODE trimesh
884 11/03/06 david
886         * Integrated Christoph Beyer's average based sampling system for body
887           disabling.
889 10/26/06 Francisco Leon
891         * Totally refactored trimesh collision system.
892           Using GIMPACT instead of OPCODE. Now works correctly, and faster.
893           Visit http://gimpact.sourceforge.net.
894           
895         * Finally, test_moving_trimesh.exe works nicely.   
896           
897         * Fixed autodisable system. Now is possible to set bigger sleeping 
898           threshold values and objects won't be sleeping on the air. They will
899           rest on the floor properly.
900                   
901         * dInitODE function added.
902         
903         * Is Obligatory to call dInitODE() at the beginning for initialize ODE,
904           and calling dCloseODE() when the program ends.
906 09/20/06 bram
908         * Fixed two bugs in cyl/plane collision test.
910 09/13/06 Remi
912         * New Rotoide - Prismatic joint type
913         * dJointGetUniversalAngles for efficient angle retrieval.
915 08/09/06 david
917         * Integrated plane2d joint type which constrains bodies to z == 0.
919 07/06/06 david
921         * Added heightfield primitive collision code. Simple test available in
922           ode/test/test_heightfield
924 04/03/06 rodrigo
926         * Added Convex primitive collision code,
927           currently only convex-sphere and convex-plane work
929 04/01/06 bram
931         * Added program to test trimesh vs sphere: ode/test/test_basket
933 03/20/06 jason379
935         * Added new autogenerated Visual Studio projects, with Premake scripts
937 03/17/06 bram
939         * Added plane/cyl intersection test
940         * Renamed CCylinder to Capsule
941         
942 02/04/06 gcarlton
944         * Added support for geom offsets.
946 10/26/05 rodrigo
948         * Removed LIBTOOL from autotools since it was not really required.
949         * Added a target to build ODE as a shared library, this shared
950           library gets build alongside the static one, no flags required.
952 10/24/05 tfautre
954         (Backported patches from STABLE branch, applied by Adam)
955         
956         * dRandInt changed for a non-double all-int version.
957         * mics minor fixes and improvements.
959 04/05/05 tfautre
961         * Fixed segmentation fault with OPCODE on 64 bits systems.
963 03/31/05 tfautre
965         * Fixed timer.cpp compiler error on x86-64 using GCC.
967 03/29/05 colin
969         * Added trimesh preprocessing to mark unneeded edges and verts.  Also
970           added support for preprocessed info to the ccylinder-trimesh
971           collider.
973 12/07/04 adam
975         * Important AMotors bugfix
977 09/22/04 jeff
979         * Assorted small bugfixes and tweaks for
980           trimesh_{box,ccylinder,trimesh} collisions
982 09/21/04 jeff
984         * added functions to joint.cpp to allow joint attachment to moving
985           geoms.
987         * added malloc-based memory allocation in step.cpp & lcp.cpp (turned
988           on with a #define switch in common.h)
989         
990 05/29/04 russ
992         * added joint feedback to the QuickStep solver
994 05/18/04 russ
996         * added warm starting to the QuickStep solver
998 05/18/04 russ
1000         * added the QuickStep solver
1001         
1002         * added contact parameter functions.
1004 05/05/04 adam
1006         * use dRandInt instead of rand() in stepfast.
1008 04/21/04 russ
1010         * added auto-disable support from Aras Pranckevicius (with
1011           modifications by russ). this useful feature can speed up
1012           simulation significantly in some cases.
1013         
1014         * various internal tidyups.
1016 04/20/04 russ
1018         * changed the meaning of the 'index' argument to dJointGetBody():
1019           it was the only remaining API function that does not respect
1020           dJOINT_REVERSE (spotted by Matthew D. Hancher).
1021         
1022         * updated the C++ headers: fixed two minor bugs and added
1023           support for dQuadTreeSpace, dRay, and the dGeom::getSpace() method
1024           (from Matthew D. Hancher).
1026 04/18/04 russ
1028         * changed the way that the dInfinity constant is implemented: now it
1029           is #defined to be one of: FLT_MAX, DBL_MAX, HUGE_VAL, HUGE_VALF, or
1030           a large numeric constant. previously it was a variable that was
1031           exported from the library. this simplifies the configuration and
1032           build process quite a bit, especially in the case of DLLs.
1033         
1034         * removed the old, deprecated collision system (geom.cpp,space.cpp,
1035           geom.h,space.h,odecpp_old_collision.h). the ODE_OLD_COLLISION
1036           configuration setting no longer has any meaning.
1037         
1038         * removed support for dGeomGroups, which have been deprecated for
1039           a while and are equivalent to 'spaces' anyway.
1041 04/13/04 russ
1043         * bug fix in dMassSetCappedCylinder(), from Matthew D. Hancher.
1045 04/08/04 russ
1047         * added trimesh-CCylinder capability, from Vadim Macagon
1048           <vadim_mcagon@hotmail.com>.
1050 04/04/04 adam
1052         * yet another rewrite of triangle-box collision code, this
1053         time based on code donated by Croteam, ported by asko@jetti.org
1054         and tweaked by Erwin.
1056 04/04/04 adam
1058         * merged trimesh-trimesh collision code by
1059         Jeffrey Smith <jeffreys@Softimage.com>.
1061         * changed it to not break the trimesh interface, fix
1062         some GCC compilation problems, bring it up to date with
1063         ODE changes from 2003-11-15 -> 2004-04-04.
1065         * add ability to drop meshes on meshes in test_moving_trimesh,
1066         not as good as it could be but it's illustrative.
1068 01/16/04 adam
1070         * implement a bunch of ultra-simple TriMesh functions that were
1071         in the headers but not in the code -- patch by
1072         Vadim Macagon <vadim_mcagon@hotmail.com>
1074         * disable temporal coherence on trimeshes by default, since
1075         it has scaleability issues that don't make it a general clear win.
1077 12/01/03 adam
1079         * implement dxHashSpace::collide2(), not particularly efficiently.
1081 11/14/03 adam
1083         * applied several Trimesh fixes and improvements from
1084         Aras Pranckevicius <nearaz@interamotion.com>
1086 10/22/03 adam
1088         * apply Nguyen Binh's work for removing many dSetZero() calls
1089         and some other extraneous initializations.
1091 07/29/03 martin
1093         * added dJointAdd*Torque/Force().
1095 07/10/03 russ
1097         * added the StepFast code, by David Whittaker.
1099 07/02/03 martin
1101         * added dMassSet*Total().
1103 07/01/03 martin
1105         * added joint limits and motors to universal joints.
1107         * reversed the polarity of the dJOINT_REVERSE flag.
1109 06/30/03 russ
1111         * added the TriMesh geom class and the quad tree space to the ODE
1112           core. both of these were developed by Erwin de Vries. added OPCODE
1113           to the ODE distribution, this is required by TriMesh.
1115 06/23/03 martin
1117         * added dGeomSetQuaternion() and dGeomGetQuaternion()
1118         
1119         * added dJointGet*Anchor2()
1121 05/07/03 russ
1123         * added dGeomGetSpace().
1125 02/05/03 russ
1127         * added dMassSetCylinder().
1129 12/07/02 russ
1131         * added dAreConnectedExcluding().
1133 11/30/02 russ
1135         * added the ray geom class.
1137         * added the dGeomXXXPointDepth() functions.
1139         * added a collision test infrastructure, and some more tests.
1141 11/24/02 russ
1143         * added support for multiple box-box contacts.
1145 11/10/02 russ
1147         * added new collision system. select between the old/new system by
1148           setting the ODE_OLD_COLLISION variable in config/user-settings.
1150 10/28/02 russ
1152         * fixed two problems in the LCP code to improve the reliability of
1153           the dContactApprox1 contact mode.
1155         * added a FAQ question about rolling bodies getting stuck when they
1156           hit multiple geoms.
1158 09/08/02 russ
1160         * added dClosestLineSegmentPoints().
1161         * implemented dCollideCB().
1163 08/28/02 russ
1165         * added dJointSetFeedback() and dJointGetFeedback().
1167 08/05/02 russ
1169         * added dGeomTransformSetInfo() and dGeomTransformGetInfo().
1171 07/13/02 russ
1173         * added dBodySetForce(), dBodySetTorque(), dWorldImpulseToForce(),
1174           dBodyGetPosRelPoint(), dBodyGetPosRelPoint(), dBodyVectorToWorld(),
1175           dBodyVectorFromWorld().
1177         * added dBodyGetPointVel() (thanks to Colin Reed).
1179         * added a new C++ interface (from Martin C. Martin, with modifications
1180           by russ). the old C++ interface is now in odecpp_old.h.
1182 06/25/02 russ
1184         * added an additional BSD-style licensing option for ODE.
1186 06/23/02 russ
1188         * added dCloseODE(), contributed by Nate Waddoups and David McClurg.
1190 05/16/02 russ
1192         * added dSpaceQuery(), contributed by Nate Waddoups.
1194 04/07/02 russ
1196         * added a section to the documentation for universal joints.
1197           this includes a picture of the joint.
1199 04/05/02 russ
1201         * added a universal joint class (generously contributed by
1202           Martin C. Martin). it doesn't (yet) have a motor or joint limits,
1203           but it does come with tests.
1205 03/11/02 russ
1207         * makefile changes to accomodate OSs with command line length
1208           limitations (thanks to Norman Lin).
1210 01/06/02 russ
1212         * added the dBodySetGravityMode() and dBodyGetGravityMode()
1213           functions, which change the dxBodyNoGravity body flag.
1215         * added support for building a DLL with MSVC - there is now a
1216           msvc-dll target. thanks to Norman Lin for doing this.
1218 12/28/01 russ
1220         * added the dParamCFM joint parameter.
1222 12/24/01 russ
1224         * reworked the build system to make it more cross-platform.
1225           there is now a single top-level makefile and a configurator.c
1226           program. see the INSTALL file for details.
1228 12/04/01 russ
1230         * the "angular motor" joint has been completed, and a new section
1231           has been added to the documentation.
1233 11/26/01 russ
1235         * added a new joint type: "angular motor". using this joint is a good
1236           way to get ball-joint motors and limits. this is work in progress -
1237           it has not been fully implemented or tested yet.
1239 11/22/01 russ
1241         * replaced the mmap()-based joint group stack (stack.cpp) with a
1242           malloc()-based arena stack (obstack.cpp). this will be more
1243           portable and should not impact performance.
1245 11/12/01 russ
1247         * changed the meaning of the 'flags' parameter to dCollide() and
1248           related functions: now the size of the contact buffer is kept in
1249           the lower 16 bits. this change will be backward compatible.
1251         * added dBodyGetFiniteRotationMode() and dBodyGetFiniteRotationAxis().
1253         * added dBodyAddForceAtRelPos() function.
1255 11/11/01 russ
1257         * added the ability to manually enable and disable bodies.
1258           see dBodyEnable(), dBodyDisable(), dBodyIsEnabled().
1260         * fixed a potential bug: when a world is destroyed that contains
1261           joints in joint groups, those joints are marked as "deactivated" in
1262           the joint group, so when the joint group is destroyed they can be
1263           ignored.
1265         * the test_boxstack demo has new options to enable and disable bodies.
1267         * new configuration parameter in config.h: dEFFICIENT_SIZE.
1269 11/11/01 russ
1271         * started the change log for ODE. changes older than today were added
1272           to this file by inspecting the CVS logs.
1274 11/05/01 russ
1276         * added REAL() constructions for floating point numbers, to prevent
1277           many warnings when compiling under VC++.
1279 11/03/01 russ
1281         * added geometry transform class, documented composite objects.
1283         * added collision rule: no contacts if both geoms on the same body.
1284           this is not the best rule, may have to remove this in the future.
1286         * new dMassAdd() function.
1288         * capped cylinder to capped cylinder collision function.
1290 10/31/01 russ
1292         * increase CFM in some demos to make them more robust.
1294 10/29/01 russ
1296         * added new accessor functions.
1298 10/19/01 russ
1300         * added the dJOINT_TWOBODIES flag to the joint, that says it can not
1301           be attached to just one body.
1303 10/12/01 russ
1305         * fixed a collision bug in dCollide() that was causing memory
1306           corruption when multiple contacts were being returned.
1308 10/11/01 russ
1310         * joints can now return m=0 to be "inactive". added a "null" joint
1311           to test this.
1313 10/09/01 russ
1315         * in the LCP solver, try to fail gracefully when s <= 0.
1317         * dAABBTestFn() API change.
1319 10/08/01 russ
1321         * fixed a contact swapping bug in dCollide().
1323 10/07/01 russ
1325         * added capped cylinder geometry object.
1327 09/30/01 russ
1329         * the test_buggy demo now uses geometry groups.
1331         * added a dAABBTestFn field in the geometry classes.
1333 09/29/01 russ
1335         * added geometry groups.
1337 09/20/01 russ
1339         * added finite rotation stuff.