A High-Performance 2D Physics Engine in C 🛠️
Celeris is a powerful and efficient 2D physics engine written in C, designed to simulate realistic object interactions in virtual environments. It features robust collision detection, force dynamics, and energy conservation, all within a modular architecture that is easy to integrate into various applications, such as game development and physics simulations.
- Realistic Physics Simulation: Simulates motion, collision, and response of objects with high accuracy. ⚙️
- Modular Design: Well-organized structure allows easy customization and extension. 🧩
- Efficient Performance: Optimized for speed, making it suitable for real-time applications. ⚡
- Comprehensive Documentation: Includes detailed guides for developers and users. 📚
- Unit Testing: Ensures reliability and correctness through extensive tests. ✅
- Cross-Platform: Build and run on different operating systems with ease. 🌍
Celeris/
├── Makefile
├── README.md
├── assets/
│ ├── models/
│ ├── shaders/
│ └── textures/
├── build/
├── docs/
│ ├── README.md
│ ├── design_document.md
│ ├── developer_guide.md
│ └── user_guide.md
├── include/
│ ├── body.h
│ ├── camera.h
│ ├── collision.h
│ ├── collision_response.h
│ ├── constraint.h
│ ├── force_generator.h
│ ├── input.h
│ ├── integration.h
│ ├── material.h
│ ├── physics_world.h
│ ├── renderer.h
│ ├── timer.h
│ ├── utils.h
│ └── vector.h
├── src/
│ ├── body.c
│ ├── camera.c
│ ├── collision.c
│ ├── collision_response.c
│ ├── constraint.c
│ ├── force_generator.c
│ ├── input.c
│ ├── integration.c
│ ├── main.c
│ ├── material.c
│ ├── physics_world.c
│ ├── renderer.c
│ ├── timer.c
│ ├── utils.c
│ └── vector.c
├── tests/
│ ├── test_body.c
│ ├── test_collision.c
│ ├── test_collision_response.c
│ ├── test_integration.c
│ ├── test_physics_world.c
│ └── test_vector.c
└── tools/
├── clang-format
├── clang-tidy
├── valgrind_suppressions.supp
└── Dockerfile
- C Compiler: GCC or Clang
- Make: For building the project
- Git: For version control
- CMake (optional): For alternative build configuration
- Clone the Repository:
git clone git@github.com:acmpesuecc/VectorX.git cd celeris - Build the Project: Using Make:
Or using CMake:
make
mkdir build cd build cmake .. make - Run the Tests:
make test
- Include the Engine: Integrate the include/ and lib/ files into your project.
- Link Libraries: Make sure to link against the Celeris static library if you're using external projects.
- Execute: Run the compiled binaries from the bin/ directory.
- Developer Guide: For understanding the architecture and contributing to the project.
- User Guide: For instructions on integrating and using the engine in your projects.
- Design Document: In-depth explanation of the design decisions and system architecture.
We welcome contributions! Please see our Contributing Guide for more details on how to contribute.
This project is licensed under the MIT License - see the LICENSE file for details.
Special thanks to the open-source community for providing the tools and libraries that made this project possible. Inspiration and techniques drawn from various physics engines and game development resources.
A High-Performance 2D Physics Engine in C 🛠️
Celeris is a powerful and efficient 2D physics engine written in C, designed to simulate realistic object interactions in virtual environments. It features robust collision detection, force dynamics, and energy conservation, all within a modular architecture that is easy to integrate into various applications, such as game development and physics simulations.
- Realistic Physics Simulation: Simulates motion, collision, and response of objects with high accuracy. ⚙️
- Modular Design: Well-organized structure allows easy customization and extension. 🧩
- Efficient Performance: Optimized for speed, making it suitable for real-time applications. ⚡
- Comprehensive Documentation: Includes detailed guides for developers and users. 📚
- Unit Testing: Ensures reliability and correctness through extensive tests. ✅
- Cross-Platform: Build and run on different operating systems with ease. 🌍
Celeris/
├── Makefile
├── README.md
├── assets/
│ ├── models/
│ ├── shaders/
│ └── textures/
├── build/
├── docs/
│ ├── README.md
│ ├── design_document.md
│ ├── developer_guide.md
│ └── user_guide.md
├── include/
│ ├── body.h
│ ├── camera.h
│ ├── collision.h
│ ├── collision_response.h
│ ├── constraint.h
│ ├── force_generator.h
│ ├── input.h
│ ├── integration.h
│ ├── material.h
│ ├── physics_world.h
│ ├── renderer.h
│ ├── timer.h
│ ├── utils.h
│ └── vector.h
├── src/
│ ├── body.c
│ ├── camera.c
│ ├── collision.c
│ ├── collision_response.c
│ ├── constraint.c
│ ├── force_generator.c
│ ├── input.c
│ ├── integration.c
│ ├── main.c
│ ├── material.c
│ ├── physics_world.c
│ ├── renderer.c
│ ├── timer.c
│ ├── utils.c
│ └── vector.c
├── tests/
│ ├── test_body.c
│ ├── test_collision.c
│ ├── test_collision_response.c
│ ├── test_integration.c
│ ├── test_physics_world.c
│ └── test_vector.c
└── tools/
├── clang-format
├── clang-tidy
├── valgrind_suppressions.supp
└── Dockerfile
- C Compiler: GCC or Clang
- Make: For building the project
- Git: For version control
- CMake (optional): For alternative build configuration
- Clone the Repository:
git clone https://github.com/yourusername/celeris.git cd celeris - Build the Project: Using Make:
Or using CMake:
make
mkdir build cd build cmake .. make - Run the Tests:
make test
- Include the Engine: Integrate the include/ and lib/ files into your project.
- Link Libraries: Make sure to link against the Celeris static library if you're using external projects.
- Execute: Run the compiled binaries from the bin/ directory.
- Developer Guide: For understanding the architecture and contributing to the project.
- User Guide: For instructions on integrating and using the engine in your projects.
- Design Document: In-depth explanation of the design decisions and system architecture.
We welcome contributions! Please see our Contributing Guide for more details on how to contribute.
This project is licensed under the MIT License - see the LICENSE file for details.
Special thanks to the open-source community for providing the tools and libraries that made this project possible. Inspiration and techniques drawn from various physics engines and game development resources.