A small 🎮 2D physics engine that explains mechanics ⚡ in physics engines for educational use ✨.
Cirobb
🚀 Overview
Cirobb is a 2D Rigid Body Physics Engine inspired by Box2D Lite that was created with the purpose of helping people who are starting in this wonderful world of physics for Videogames. The Engine uses the Erin Catto’s Contact Persistence Algorithm and it’s implementation of the PGS (Projected Gauss Seidel) solver to solve the MLCP very well known as a SI (Sequential Impulse).
Additionally, it features a straightforward 2D Collision Detection system that efficiently calculates Contact Points, Normal Direction, and Penetration depth. This project aims to provide a clear and detailed understanding of how physics engines work under the hood, making it an ideal learning resource for game developers.
💡 For more complex simulations with multiple constraints and shapes, we recommend using Box2D, which is considered the best open-source 2D physics engine available.
📸 Captures
⚡ Demos & Examples
🔜 Future Features
| ✨ Direct Solver | Improve Velocity Solver convergence |
| 🔗 Distance Constraint | Optional feature for distance-based constraints |
| 🔷 Convex Polygons | Collision Detection against convex polygons |
| 🔄 Contact Points | Change from Distance-Based to Feature-Based |
📚 Learning Resources
Experts and Their Contributions
Erin Catto
- Iterative Dynamics with Temporal Coherence
- Modeling and Solving Constraints
- Soft Constraints
- Numerical Methods
- Continuous Collision Detection
- Understanding Constraints
Dirk Gregorius
- The Separating Axis test Between Convex Polyhedra
- Robust Contact Creation for physics Simulation
Erwin Coumans
- Forum Bullet
- Exploring MLCP Solvers And Featherstone
Tonge Richard
- Iterative Rigid Body Solvers 2012
- Iterative Rigid Body Solvers 2013
Brian Vincent Mirtich
- Impulse-based Dynamic Simulation of Rigid Body Systems
Kenny Erleben
- Book of Physics-Based Animation 2005
- Numerical Methods for Linear Complementarity Problems in Physics-based Animation
David Baraff
- Analytical Methods for Dynamic Simulation of Non-penetrating Rigid Bodies
- Fast Contact Force Computation for Nonpenetrating Rigid Bodies
- Linear-Time Dynamics using Lagrange Multipliers
- Physically Based Modeling, Pixar Animation Studios
Jim Van Verth
- Numerical Integration
- Understanding Rotations
Matthias Müller
- Position Based Dynamics
Michael B. Cline
- Post-Stabilization for Rigid Body Simulation with Contact and Constraints
Randy Gaul
- Separating Axis Test (SAT) and Support Points in 2D
Books on Game Physics and Collision Detection
- Game Physics Pearls by Gino van den Bergen and Dirk Gregorius
- Real-Time Collision Detection by Christer Ericson
⭐ Support the Project
If you find this project helpful, please give it a star! ⭐
📝 Note
Cirobb is designed as an educational introduction to 2D physics engines. It intentionally maintains simplicity to facilitate learning and understanding of fundamental concepts.