bullet3

mirror of https://github.com/bulletphysics/bullet3 synced 2024-12-15 14:10:11 +00:00

Go to file

erwincoumans 8faac34801 move ExplititEuler cloth solver to its own file, so it can be replaced by PDB, implicit euler etc add wireframe toggle ('w' key) add --paused command-line option to start simulation in paused mode render cloth using drawPoints method		2013-09-06 18:09:35 -07:00
btgui	move ExplititEuler cloth solver to its own file, so it can be replaced by PDB, implicit euler etc	2013-09-06 18:09:35 -07:00
build3	add drawPoint/drawLine (both slow) and drawPoints (faster) to GLInstancingRenderer, with GLSL shaders	2013-09-06 12:05:56 -07:00
data	add the option to load a set of AABB's from a file, see PairBench	2013-08-23 17:55:28 -07:00
Demos3	move ExplititEuler cloth solver to its own file, so it can be replaced by PDB, implicit euler etc	2013-09-06 18:09:35 -07:00
docs	replace doc with SIGGRAPH version	2013-09-06 14:33:18 -07:00
src	move b3RaycastInfo.h so it can be used without OpenCL dependency	2013-09-02 22:31:48 -07:00
test	support compound versus compound collision shape acceleration on GPU, using aabb tree versus aabb tree.	2013-08-20 03:19:59 -07:00
readme.txt	* fixed small readme.txt error	2013-09-02 11:49:25 +02:00

readme.txt

Bullet 3.x GPU rigid body pipeline using OpenCL.

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

Requirements:
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:

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 main demo executable will be located in the bin folder.
The 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)


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.

See docs folder for further information and see the SIGGRAPH 2013 course notes at
http://www.multithreadingandvfx.org/course_notes