Bullet physics and OpenSceneGraph integration
Clone or download
mccdo Merge pull request #31 from alilja/master
Documentation Formatting
Latest commit 4ae292a Aug 6, 2016
Type Name Latest commit message Commit time
Failed to load latest commit information.
applications Correct compiler warnings. Dec 7, 2013
data Add soft body path demo (flag). Feb 27, 2012
doc Documentation re-org. Aug 21, 2013
examples Minor documentation fix. Nov 15, 2013
scripts Adding new RigidBody interface as a replacement for OSGToCollada. Aug 28, 2011
src Add missing #include for <algorithm> Jul 18, 2016
tests Fix typo. Nov 15, 2013
README.md added wiki Jun 16, 2015
UseosgBullet.cmake.in make osgBullet be able to be found the CMake way. Jun 16, 2012
osgBulletConfig.cmake.in update the lib directory name setting. Jun 21, 2013
osgBulletConfigVersion.cmake.in make osgBullet be able to be found the CMake way. Jun 16, 2012
releasenotes.txt Mergins 216-250 from 2.0 branch. Oct 16, 2011




osgBullet is a set of software tools for applications that use both OpenSceneGraph (OSG) and Bullet. The osgBullet library is the result of collaborative work between Paul Martz (Skew Matrix Software), Ames Lab, and ARDEC. It's used as part of the VE-Suite project. osgBullet is open source and available under the GNU LGPL v2.1 software license.


Online Doxygen documentation can be found here.



osgbpp: The osgBullet physics previewer. Loads a model file, creates a Bullet rigid body to match the geometry, and drops it on a surface. View a graphical representation of the collision shape with the --debug option. Use the --help option for more info.


The osgbCollision library Includes the following features:

  • Supports using Bullet for collision detection, with no dependency on libBulletDynamics. Utility functions for converting between Bullet collision shapes and OSG scene graphs (create a scene graph to render a collision shape, for example, or create a collision shape from a scene graph).

  • A NodeVisitor to compute collision shapes per Geode and assemble them into a single btCompoundShape.

  • Utility functions for converting between Bullet and OSG matrix and vector data types.

  • A template class to incorporate Bullet objects as OSG Objects to support reference counting and association as UserData. Allows you to reference count a btRigidBody, for example, or store a btCollisionShape as UserData.

The osgbDynamics library Includes the following features:

  • Supports interleaved/serial physics step and render, and a separate physics simulation thread. Threaded physics simulation features an efficient triple buffering mechanism for shared transform data.

  • A MotionState class to keep your OSG subgraph visual representation in sync with the Bullet rigid body / collision shape. Bullet effectively owns the OSG transformation matrix, and the MotionState transparently accounts for center of mass and scaling.

  • Convenience routines to create rigid bodies from scene graphs, which handles all of the details of creating a MotionState, setting the initial transformation, handling center of mass offset, and creating scaled collision shapes.

  • A GLDebugDrawer debugging aid class that renders information regarding Bullet collision shapes and intersection points, both within the OSG scene and graphically as a HUD.


The project contains a small collection of example programs to demonstrate use of many of osgBullet's features.


The project contains several test programs to ensure correct functionality.

Building, Running, and More

Lots of additional information is available on the wiki.


Skew Matrix Software provides full osgBullet development and consulting services. For support requests beyond issuing issues through GitHub, please contact Skew Matrix Software LLC.


All contributions are welcome and will be considered for inclusion in the project. Until otherwise specified, please use pull requests or issues to introduce changes.