Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/louis-langholtz/PlayRho
An interactive physics engine & library.
https://github.com/louis-langholtz/PlayRho
box2d collision-detection collision-handling cplusplus cpp17 game-2d physics-2d physics-engine physics-simulation-library
Last synced: 2 months ago
JSON representation
An interactive physics engine & library.
- Host: GitHub
- URL: https://github.com/louis-langholtz/PlayRho
- Owner: louis-langholtz
- License: zlib
- Created: 2017-07-11T15:22:02.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-02-28T04:39:44.000Z (11 months ago)
- Last Synced: 2024-02-28T05:31:09.904Z (11 months ago)
- Topics: box2d, collision-detection, collision-handling, cplusplus, cpp17, game-2d, physics-2d, physics-engine, physics-simulation-library
- Language: C++
- Homepage:
- Size: 198 MB
- Stars: 111
- Watchers: 10
- Forks: 22
- Open Issues: 32
-
Metadata Files:
- Readme: README.md
- Changelog: Changes.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
Awesome Lists containing this project
- AwesomeCppGameDev - PlayRho - time oriented physics engine and library that's currently best suited for 2D games. (Physics)
README
# PlayRho
[](https://github.com/louis-langholtz/PlayRho/actions/workflows/linux.yml)
[](https://github.com/louis-langholtz/PlayRho/actions/workflows/macos.yml)
[](https://github.com/louis-langholtz/PlayRho/actions/workflows/windows.yml)
[](https://github.com/louis-langholtz/PlayRho/actions/workflows/docs.yml)
[](https://github.com/louis-langholtz/PlayRho/actions/workflows/codeql.yml)
[](https://coveralls.io/github/louis-langholtz/PlayRho?branch=master)
[](https://repology.org/project/playrho/versions)
[](https://stackoverflow.com/questions/tagged/playrho)
*A way to play with physical behaviors like the conservation of momentum.*
## Overview
PlayRho is a real-time oriented, platform independent, physics engine and library.
It's currently best suited for interactive 2-D games or demos.
The project's name is the composition of the verb *play* with the noun *rho*, where *rho* is the Greek letter often used to represent physical quantities like momentum.
PlayRho started off as a port by Louis Langholtz of the Box2D 2.3.2 physics engine to ["modern C++"](https://msdn.microsoft.com/en-us/library/hh279654.aspx).
It's evolved into a derivative work by Louis and other contributors to the code base.
Like its predecessor, PlayRho is also [licensed](LICENSE.txt) under a [Zlib License](https://opensource.org/licenses/Zlib).
Many other open source physics engines exist, like: [Bullet Physics](http://bulletphysics.org/) and [Chipmunk](https://chipmunk-physics.net).
The PlayRho library component itself requires only a standards compliant C++17 compiler and standard library implementation.
It's continuous integration backed and unit test proven to compile and work on at least Linux, macOS, and Windows.
See the status badges above for up-to-date status of builds, tests, documentation, code-security, and more.
By design, new development is done in the default/master branch, merged in by pull requests, and then possibly backported to a release branch if not API breaking.
While the master branch is intended to always be buildable and runnable, its interface is not meant to be stable and it's not meant for use unless you're specifically looking to help develop this project.
For use in projects, choose from a more stable [tagged release](https://github.com/louis-langholtz/PlayRho/releases) or a release branch.
## General Goals
- Supporting value semantics over reference semantics. Values are in and pointers are out!
- Conforming to the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines), particularly in regards to things like: [avoiding non-constant global variables](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ri-global), [preferring concrete types](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rc-concrete), and [preferring pure functions](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-pure).
- Using and supporting newer features of the C++ language standards up to [C++17](https://en.wikipedia.org/wiki/C%2B%2B17).
- Openness to contributions including pull requests with new features.
- Providing a [continuous integration](https://en.wikipedia.org/wiki/Continuous_integration) backed, [build automation](https://en.wikipedia.org/wiki/Build_automation) supported, [unit test](https://en.wikipedia.org/wiki/Unit_testing) validated, and [benchmark](https://en.wikipedia.org/wiki/Benchmark_(computing)) assessed, project.
## Additional Resources:
- [Changes Document](Changes.md): provides a run-down of changes between releases.
- [Building & Installation Document](INSTALL.md): information on how to build and install this project.
- [API Documentation](http://louis-langholtz.github.io/PlayRho/API/index.html): application programming interface (API) pages for this project.
- [Issues Web Interface](https://github.com/louis-langholtz/PlayRho/issues): for bugs reports or feature requests associated with this project.
- [stackoverflow.com playrho tag](https://stackoverflow.com/questions/tagged/playrho): for questions and answers on this project.