Go to file
erwincoumans 8382ccdc3d Merge pull request #343 from erwincoumans/master
re-enable auto-joint velocity target motors in URDF multibody import
2015-03-23 12:13:14 -07:00
btgui add btMultiBodyConstraint::finalizeMultiDof API: if you add multi-body constraints to a multi-dof btMultiBody, before it has been finalized using the btMultiBody::finalizeMultiDof call, 2015-03-03 13:24:06 -08:00
build3 Refactored GJK, EPA and MPR as a template class, reducing/removing the dependencies 2014-11-02 12:53:36 -08:00
data prepare to create coordinate frame demo, minor cleanup for create funcs in demo entries, 2014-12-12 18:14:49 -08:00
Demos add btMultiBodyConstraint::finalizeMultiDof API: if you add multi-body constraints to a multi-dof btMultiBody, before it has been finalized using the btMultiBody::finalizeMultiDof call, 2015-03-03 13:24:06 -08:00
Demos3 fix double precision build (a demo was broken) 2015-03-23 11:43:50 -07:00
docs Add PLBVH documentation/slides. 2014-03-13 13:52:49 -07:00
Extras fix HACD crash, thanks to gjaegy 2015-02-12 13:54:19 -08:00
src more URDF2Bullet refactor to make URDF import a little bit more re-usable 2015-03-20 13:07:25 -07:00
test Update Test_v3interp.cpp 2015-02-10 18:12:55 -08:00
.travis.yml Test also with double precision 2014-05-20 11:11:15 -07:00
appveyor.yml Update appveyor.yml 2014-08-28 22:27:24 -07:00
bullet.pc.cmake Add extra -I flag to bullet.pc to allow namespaced includes 2015-02-11 16:46:36 -08:00
BulletConfig.cmake.in Add the old Bullet 2.x obsolete demos, and CMake buildsystem files, and gradually move them to newer Bullet 3.x structure 2013-12-19 12:40:59 -08:00
CMakeLists.txt Merge pull request #253 from TimothyGu/patch-1 2015-03-04 16:11:03 -08:00
README.md Update README.md 2015-03-01 10:30:20 -08:00
UseBullet.cmake fix make install, when using CMake 2014-03-06 11:40:35 -08:00
VERSION update version to 2.83 for an intermediate release (2014 will be a transition year to Bullet 3.x) 2014-05-16 16:20:07 -07:00

Travis Build Status Appveyor Build status

Bullet 2.x with optional Bullet 3 GPU rigid body pipeline using OpenCL.

This is the official repository of Bullet 2.x, moved from http://bullet.googlecode.com It includes the future work-in-progress Bullet 3 GPU pipeline.

The Bullet 2 API will stay default and up-to-date while slowly moving to Bullet 3. The steps towards Bullet 3 are in a nutshell:

  1. The old Bullet2 demos are being moved from ObsoleteDemos to AllBullet2Demos
  2. A new Bullet 3 API is created
  3. All Bullet2 functionality is added to Bullet 3. Until this is done, you can use the Demos3/BasicGpuDemo/b3GpuDynamicsWorld or explore the Demos3/GpuDemos to check out Bullet 3.

You can still use svn or svn externals using the github git repository: use svn co https://github.com/erwincoumans/bullet3/trunk

Requirements for Bullet 2

A C++ compiler for C++ 2003. The library is tested on Windows, Linux, Mac OSX, iOS, Android, but should likely work on any platform with C++ compiler. SOme optional demos require OpenGL 2 or OpenGL 3, there are some non-graphical demos and unit tests too.

Requirements for Bullet 3

The entire collision detection and rigid body dynamics is executed on the GPU.

A high-end desktop GPU, such as an AMD Radeon 7970 or NVIDIA GTX 680 or similar. We succesfully tested the software under Windows, Linux and Mac OSX. The software currently doesn't work on OpenCL CPU devices. It might run on a laptop GPU but performance is likely not very good.

License

All source code files are licensed under the permissive zlib license (http://opensource.org/licenses/Zlib) unless marked differently in a particular folder/file.

Build instructions for Bullet 3.

Windows

Click on build3/vs2010.bat and open build3/vs2010/0MySolution.sln

Linux and Mac OSX gnu make

In a terminal type:

cd build3

Dependend on your system (Linux 32bit, 64bit or Mac OSX) use one of the following lines

./premake4_linux gmake
./premake4_linux64 gmake
./premake4_osx gmake

Then

cd gmake
make

Mac OSX Xcode

Click on build3/xcode4.command or in a terminal window execute

./premake_osx xcode4

Usage

The demo executables will be located in the bin folder. The Bullet 2 demo starts with App_AllBullet2Demos* The Bullet 3 demo starts with App_Bullet3_OpenCL_Demos_*

You can just run it though a terminal/command prompt, or by clicking it.

There are some command-line options, you can see using the --help option. For example, this will perform a benchmark writing to some files:

./App_Bullet3_OpenCL_Demos_clew_gmake --benchmark
[--selected_demo=<int>]             Start with a selected demo  
[--benchmark]                       Run benchmark and export results to file  
[--maxFrameCount=<int>]             Run the benchmark for <int> frames  
[--dump_timings]                    Print the profile timings to console  
[--cl_device=<int>]                 Choose a certain OpenCL device  
[--cl_platform=<int>]               Choose a certain OpenCL platform  
[--disable_cached_cl_kernels]       Disable loading cached binary OpenCL kernels  
[--x_dim=<int>]                     Change default demo settings (x,y,z)  
[--pair_benchmark_file=<filename>]  Load AABB's from disk for the PairBench  
[--no_instanced_collision_shapes]   Disable collision shape instancing (for tests)  
[--no_shadow_map]                   Disable shadowmap rendering  
[--shadowmap_resolution=<int>]      Change the resolution of the shadowmap  
[--shadowmap_size=<int>]            Change the worldspace size of the shadowmap  
[--use_uniform_grid]                Use uniform grid broadphase (no all scenes work)  
[--use_jacobi]                      Use GPU parallel Jacobi solver (instead of PGS)  
[--use_large_batches]               Use a different strategy for the constrains solver  
[--debug_kernel_launch]             Show debug info at start/end of each kernel launch  
[--use_dbvt]                        Use the CPU dynamic BVH tree broadphase  
[--allow_opencl_cpu]                Allow to use an OpenCL CPU device  

You can use mouse picking to grab objects. When holding the ALT of CONTROL key, you have Maya style camera mouse controls. Press F1 to create a screenshot. Hit ESCAPE to exit the demo app.

Bullet 3.x only implements a small set of collision shapes and constraints:

  • Static plane
  • Static concave triangle mesh
  • Sphere
  • Convex Polyhedron
  • Compound of Convex Polyhedra

Bullet 3.x uses the separating axis test (SAT) between convex polyhedra, testing all vertex - face and edge - edge combinations. For performance it is best to keep the number of edges in a convex polyhedron low, using simple shapes such as a tetrahedron or a box.

The constraint solver currently supports two constraints:

  • point to point constraint (ball-socket
  • fixed constraint

It can be extended to other constraint types. The constraint solver uses the same algorithm as Bullet 2.x.

It is possibly to try out Bullet 3.x using the Bullet 2.x API, using the b3GpuDynamicsWorld bridge: Copy the source code of both versions in the same location, and click on build3/vs2010_bullet2gpu.bat to generate Visual Studio project files.

See docs folder for further information.