patrickoh / bounce_softbody Goto Github PK

Bounce Softbody is a small 3D softbody physics engine.

• Efficient data structures with no use of STL
• Fast memory allocators
• Built-in math library
• Tunable settings used across the entire library
• Included debug draw utility

• Fairly efficient sparse matrix and vector structures
• Full Backward Euler method
• Pre-filtered Pre-conditioned Conjugate Gradient (PPCG) method

• Spheres, capsules, and boxes
• Dynamic tree

• Unconditional simulation stability
• Stretch, spring, mouse, triangle and tetrahedron element force types
• Vertex contact, friction
• Viscosity
• Linear/non-linear time solver
• Ray-casting

• OpenGL with GLFW and GLAD
• UI by imgui
• Orbit camera
• Mouse picking
• premake build system

These are the external dependencies for the Testbed example project. If you don't care about Testbed, then you don't need these dependencies.

• GLFW
• GLAD
• imgui

Note: Use the the Testbed for learning how to use Bounce Softbody. The Testbed is a collection of visual tests and examples that can support the development of the library. As you would imagine, this application is not part of the library.

Bounce Softbody uses premake for generating project files in a platform agnostic manner. premake is available at https://premake.github.io/.

• Put premake into bounce_softbody/.

• Say { premake5 vs2019 } on a command line.
• Open { build/vs2019/bounce_softbody.sln }.
• Set testbed as the startup project.
• In the testbed debugging properties, set Working Directory to '..\..\testbed'.
• Press F5 to run.

From the official GLFW documentation:

"... To compile GLFW for X11, you need to have the X11 packages installed, as well as the basic development tools like GCC and make. For example, on Ubuntu and other distributions based on Debian GNU/Linux, you need to install the xorg-dev package, which pulls in all X.org header packages. ..."

• Say { ./premake5 gmake2 } on a terminal.
• From build/gmake2 say { make config="debug_x86" }.
• Set the testbed directory as the working directory.
• From bin/x86/debug/testbed say { ./testbed }.

• Say { ./premake5 gmake2 } on a terminal.
• From build/gmake2 say { make config="debug_x86_64" }.
• Set the testbed directory as the working directory.
• From bin/x86_64/debug/testbed say { ./testbed }.