[Odejava] bug fixes and enhancements

[William Denniss]

Hi,

I've fixed the problems associated with GeomPlane, and changed the code to prevent such problems arising in the future.

I believe they arose due to calls to "updatereferences" which gets the current position and rotation of objects.  I removed that method and moved the calls to ode which get this data into the relivent methods (e.g. getPosition).

This issue was an API one, due to internal calls to getPosition - however the public methods were also defined.  For GeomPlane they simply threw an exception which is better than nothing, but hardly ideal.  To get around this problem, I have created a new abstract class PlaceableGeom which inherits Geom.  All the position/rotation code was moved to that class - so only geometry which extend it (i.e. not GeomPlane) will work.  This also means you don't have to do checks for instances of GeomPlane before making such method calls and your code won't break in the future if more unplaceable objects are added to ODE.

I also moved the interface OdeTransformable from org.odejava.display to org.odejava and renamed it Placeable.  The naming makes more sense - and it really should have been in the org.odejava package to begin with (my bad).

The introduction of PlaceableGeom may break some existing code - if you do stuff like "Geom g = new GeomBox" then call a setPosition on that code.  All you need to do is change the "Geom" to "PlaceableGeom".  Sorry for the change - but we are exchanging a runtime error (or worse) for a logic error - which is a good thing (tm).

With these bugs fixed - the official examples run again, so I have updated the JWS on odejava.org.  I have tested CarExample on Windows XP, Linux (Fedora Core 1) and Mac OS X (10.3) with positive results in all cases.

Cheers,

Will.

[William Denniss]

As a non-placeable Geom can never have a Body, I have moved the setBody and getBody methods of Geom to PlaceableGeom.

These methods are generally only used by Body.  Several method signatures of Body dealing with Geoms were therefore needed to be changed to PlaceableGeom.

Like previous changes to PlaceableGeom, this may require you to change some method signatures or add an occasinal cast to PlaceableGeom but again - you trade a logic error (calling setBody on a GeomPlane for example) for a compiler error (as this will now be caught at compile time).

A new method was also added to PlaceableGeom "fixed()" it returns true if the PlaceableGeom doesn't have a Body (and is therefore static).  The org.odejava.display package now uses this to avoid unneeded updates on bound objects.

Will.