PhysicsEngines

Revision as of 19:24, 15 September 2007

There are several physics engines available for use in OpenSim. Currently, they are "basicphysics", "OpenDynamicsEngine", "RealPhysX" & "BulletX" (modified version). The plugin "basicphysics" is the default and can be seen in the OpenSim.ini file.

• When starting OpenSim in either Windows or Linux, one can add -physics=OpenDynamicsEngine to run the OpenDynamicsEngine (ODE) instead of basicphysics, or change the corresponding parameter in OpenSim.ini.

• When starting OpenSim in Windows, one can add -physics=RealPhysX if one has the appropriate DLL's which are not shipped with OpenSim due to license constraints.

• When starting OpenSim in either Windows or Linux, one can add -physics=modified_BulletX to run a modified version of the BulletX Physics Engine aka Modified BulletX. See the next information about details and progress.

To conclude, basicphysics & OpenDynamicsEngine both are appropriate for Linux and in addition, RealPhysX is appropriate as an option for Windows if the supporting DLL's are available. Modified BulletX should be fine for Windows and Linux (not the original BulletX).

Compiling ODE from source (Linux)

If you want to compile the OpenDynamicsEngine (ODE) by yourself, get the latest source code (Ver. 0.8.1-rc1 as of 20070905) from http://www.ode.org/. Unpack it, switch to the ode directory and compile it as follows:

./configure --with-trimesh=gimpact --enable-shared
make -k

This should create a libode.a and lidode.so file in the src/ode subdirectory. Copy these two files to the opensim bin directory (after having backed up the original files there).

The above configuration parameters are the default as compiled for the libode that is shipped with OpenSim. You can also try to configure libode with: --with trimesh=opcode and/or --enable-double-precision (the latter may not work and may crash when starting OpenSim).

Modified BulletX

This is a modified version of BulletX. The original version of BulletX runs under and has code-dependencies with MS.XNA. The orginal BulletX can be found at XNADev.ru. The modified version removes all code dependencies with MS.XNA. On the other hand, it needs another library to work. This library is based on Mono.Xna and it's called MonoCompactMaths. The modified BulletX and the MonoXnaCompactMaths can be found on the svn of OpenSim. Because its code independency of MS.XNA, the modified BulletX should can be run under either MS.Net or Mono and, therefore, either Windows or Linux (obviously you can combine Windows + Mono)

BulletX Plugin in OpenSim

BulletX Plugin in OpenSim runs the modified version of BulletX. Currently, BulletX Plugin suports collisions Av2Av and Av2Prim. Prims won't move in an collision, but avies yes. By the way, collisions needs tunning. Prim2Prim collisions are currently not suported and prims are in a like non physical-state. The currently collision's behavoir are:

• For avies, like and sphere of 1m of radious and 50Kg of mass
• For prims, like a Box of the prim-size and a mass that it depends of its sizes. The mass it's the mass of Box of water with density = 1Kg/l = 1Kg/dm3 = 1000Kg/m3 (Be water my friend! :D).

To-do list (next changes)

Near future:

• Add orientation management of prims (it needs an upgrade of MonoXnaCompactMaths) (to be sent)
• Try to implement Nuclex.Heightmap class
• Tune collisions

Midle future/Long Term:

• Introduce physical check so prims could collide and roll down the hill.
• Introduce Prim Shape Type to have more than the box shape.