Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/iambijoykar/floating_hippo
A simple 2D simulation library using Pymunk and Pygames
https://github.com/iambijoykar/floating_hippo
2d 2d-simulation beginner-friendly pygame pymunk python python-library python3 simulation simulations
Last synced: 11 days ago
JSON representation
A simple 2D simulation library using Pymunk and Pygames
- Host: GitHub
- URL: https://github.com/iambijoykar/floating_hippo
- Owner: iamBijoyKar
- License: mit
- Created: 2024-01-11T10:35:43.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2024-04-15T16:37:05.000Z (9 months ago)
- Last Synced: 2024-12-04T00:46:51.261Z (29 days ago)
- Topics: 2d, 2d-simulation, beginner-friendly, pygame, pymunk, python, python-library, python3, simulation, simulations
- Language: Python
- Homepage:
- Size: 7.61 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Floating Hippo
Floating Hippo is a simple, abstracted, and easy to use library for 2D simulations using Pymunk and Pygames. This is designed to make it easier to create simulations without worrying about the complexity of Pymunk and Pygames. Is is a good starting point for beginners who want to learn about physics simulations.
> **Note:** This library is still in development and is not ready for use. We are looking for contributors to help us finish this project 🙂
## Features 🚀
- **Simple:** Floating Hippo is designed to be simple and easy to use.
- **Abstracted:** Floating Hippo abstracts the complexity of Pymunk and Pygames to make it easier to create simulations.
- **Customizable:** Floating Hippo allows you to customize the simulation as per your needs.
- **Event Handling:** Floating Hippo provides an event handling system to handle events like mouse clicks, key presses, etc.
- **Built-in Shapes:** Floating Hippo provides built-in shapes like circle, segment, and polygon to create the simulation.
## Installation 🪄
```bash
pip install floating-hippo
```
## Usage 📖
Simple example of a simulation dropping balls on a |_| shaped platform on mouse click using Floating Hippo.
### Code 👇
```python
from floating_hippo import Simulation
# Create a simulation
simulation = Simulation(800,600,caption="Test",gravity=(0,1000))
# Create a segment shape like |_|
simulation.create_segment((100,100),(100,500))
simulation.create_segment((100,500),(600,500))
simulation.create_segment((600,500),(600,100))
@simulation.events.add_event("mousebuttondown")
def on_click(event,*args,**kwargs):
simulation.create_ball(event.pos)
```
## License 📜
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Contributing 🤝
Contributions, issues and feature requests are welcome! Feel free to check [issues page](https://github.com/iamBijoyKar/floating_hippo/issues).
## Show your support ⭐️
Give a ⭐️ if this project helped you!