Join GitHub today
GitHub is home to over 40 million developers working together to host and review code, manage projects, and build software together.Sign up
Rigid body plugin for SideFX Houdini https://vimeo.com/user3251535/videos
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Type||Name||Latest commit message||Commit time|
|Failed to load latest commit information.|
BulletSOP is plugin used for making first class hollywood visual effects for movies like Chappie(by Image-engine), San Andreas(by MethodStudios) and others. BulletSOP is implementation of Bullet library inside SideFx Houdini. It's a plugin for creating incredibly large rigid body simulations on average PC. The tool is very powerful, flexible and speed is very impressive as well as memory footprint. 1. Installation 1.1 Plugin For 64bit OS only! Copy library from "install/<yourOS>" to "$HOME/houdini13/dso/" for eg.: WIN -> C:/Users/<Name>/Documents/houdini13/dso UNX -> /home/<name>/houdini13/dso OSX -> /Users/<Name>/Library/Preferences/houdini/13/dso Note: OSX version compiled by Chris Rydalch( firstname.lastname@example.org ) 1.2 Icons Icons created by Igor Bondar( email@example.com ). Thanks a lot! Copy files from "install/icons" to "$HOME/houdini13/config/Icons/" for eg.: WIN -> C:/Users/<Name>/Documents/houdini13/config/Icons UNX -> /home/<name>/houdini13/config/Icons OSX -> /Users/<Name>/Library/Preferences/houdini/13/config/Icons 2. Compilation All source code files are in "source_code/src" folder. Source code has been tested only on 64bit OS. It may works on 32bit OS too. Important! Zip file with source code package doesn't include Bullet Library. You can compile it by your self(check Compilation of Bullet Library section) or download pre-compile: https://www.dropbox.com/sh/y7t205a5akttky8/80Iv6SgWQr Put compiled or downloaded(above) Bullet Library to: source code files - BulletSOP_2_0_10_source_code/source_code/<your OS>/bullet-<version>/src libraries files - BulletSOP_2_0_10_source_code/source_code/<your OS>/bullet-<version>/lib Firstly try to compile some of a Houdini example from "Houdini<version>\toolkit\samples\SOP" to make sure that you have all dev package and compiler compatible! More info here: http://www.sidefx.com/docs/hdk13/hdk_intro.html 2.1 Windows For Windows there is Visual Studio 2008 project - BulletSOP_2_0_10_source_code/source_code/win64/bulletSOP2.sln You can compile Debug and Release (both x64) version. Project settings uses System Enviroment variable call "houdini12" or/and "houdini13" with value of actual Houdini version. Setting Enviroment Variable: - From the Desktop, right-click My Computer and click Properties. - Click Advanced System Settings link in the left column. - In the System Properties window click the Environment Variables button. - Now to add a new System variable click on New - Set name to houdini and value to your houdini version, for eg.: Variable Name: houdini13 Variable Value: 13.0.376 Also go to "Project settings -> Linker -> Command line" and change last line to path where plugin needs to be, for eg.: -out:"C:/Users/<your user name>/Documents/houdini13/dso/SOP_bullet.dll" Major project setting were done in: C/C++ -> General C/C++ -> Command line Linker -> Input Linker -> Command line 2.2 Linux: Run console and write: cd /opt/hfs<your version> source houdini_setup cd <...>/BulletSOP_2_0_10_source_code/source_code/linux64 sh build.sh houdini -foreground 2.3 OSX Guide created by Chris Rydalch( firstname.lastname@example.org ) Complete online version here: https://gist.github.com/crydalch/969bf739883b138f41e2 Make sure you've got the latest Xcode installed. Under Mavericks, to get the command line tools installed, you have to run xcode-select --install, and choose Install from the pop-up window. After installing Houdini, you need to run it in a shell with all the Houdini environment variables setup correctly. If you don't have one you've created yourself, you can run /Applications/Houdini 13.0.385/Houdini Shell.terminal. Lastly, run this command in a Terminal, to create our working directory: mkdir ~/bullet_sop_dev. Then cd into that directory, and we're ready to get started. 1) Download the Bullet SOP code to ~bullet_sop_dev, and unzip/untar. 2) cd ~/bullet_sop_dev/BulletSOP-master/source/macosx_x86_64_clang 3) Build it with sh build.sh. Ignore any errors that say ld: library not found for -lc.o 4) Verify the plugin was installed via ls -ltr /Users/$USER/Library/Preferences/houdini/13.0/dso/bulletSOP.dylib 5) Install the icons via cp ~/bullet_sop_dev/BulletSOP-master/icons /Users/$USER/Library/Preferences/houdini/13.0/config/Icons (or any location included in $HOUDINI_UI_ICON_PATH, which isn't setup by default; just use your home dir preferences, unless you've got a reason to use another and add it to the icon path) 3. Compilation of Bullet Library: Download source code: http://code.google.com/p/bullet/downloads/list Official guide: http://bulletphysics.org/mediawiki-1.5.8/index.php/Installation After compilation copy: bullet source code files - BulletSOP_2_0_12_source_code/source_code/<your OS>/bullet-<version>/src bullet libraries files - BulletSOP_2_0_12_source_code/source_code/<your OS>/bullet-<version>/lib 3.1. Windows: I can recommend cmake-gui! 3.2 Linux Use console commands: cmake . -G "Unix Makefiles" -DBUILD_MULTITHREADING=1 -DCMAKE_CXX_FLAGS="-fPIC" -DCMAKE_C_FLAGS="-fPIC" make 3.3 OSX Guide created by Chris Rydalch( email@example.com ) Complete online version here: https://gist.github.com/crydalch/969bf739883b138f41e2 1) Download the Bullet library and Bullet SOP: curl -o ~/bullet_sop_dev https://bullet.googlecode.com/files/bullet-2.82-r2704.tgz cd ~/bullet_sop_dev; tar xvfz bullet-2.82-r2704.tgz; cd bullet-2.82-r2704 Download the Bullet SOP code to ~bullet_sop_dev, and unzip/untar. 2) Patch btSolverBody.h 1, though there may be a compiler flag to do this as well 2: cd ~/bullet_sop_dev/bullet-2.82-r2704/src/BulletDynamics/ConstraintSolver; cp ~/bullet_sop_dev/BulletSOP-master/source/macosx_x86_64_clang/btSolverBody.patch . Run the patch with patch < btSolverBody.patch, and answer Y to Reversed (or previously applied) patch detected! Assume -R? 3) Configure Bullet with Cmake (omits Demos, build static libs, etc...) cd ~/bullet_sop_dev/bullet-2.82-r2704; cmake . -G "Unix Makefiles" -DBUILD_DEMOS:BOOL=OFF -DBUILD_SHARED_LIBS:BOOL=OFF -DCMAKE_OSX_ARCHITECTURES='x86_64' -DBUILD_MULTITHREADING=1 -DCMAKE_CXX_FLAGS="-fPIC" -DCMAKE_C_FLAGS="-fPIC" 4) Build and install with make -j4; sudo make install (set -j to as many threads as you have/want to use) 5) Verify that the /usr/local/bullet/ has properly populated lib and include dirs. This is where the build.sh script will look for the Bullet libraries and headers.