https://github.com/mwja/piston2d-python
Python bindings for piston2d
https://github.com/mwja/piston2d-python
graphics loop opengl piston2d python python-bindings rust rust-bindings
Last synced: 4 months ago
JSON representation
Python bindings for piston2d
- Host: GitHub
- URL: https://github.com/mwja/piston2d-python
- Owner: mwja
- License: mpl-2.0
- Created: 2021-05-11T22:36:42.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-05-31T17:40:53.000Z (over 4 years ago)
- Last Synced: 2025-05-18T20:08:08.956Z (7 months ago)
- Topics: graphics, loop, opengl, piston2d, python, python-bindings, rust, rust-bindings
- Language: Rust
- Homepage: https://starsflower.github.io/piston2d-python/
- Size: 5.67 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# piston2d
[](https://GitHub.com/starsflower/piston2d-python/releases/)  [](https://www.python.org/) [](https://www.rust-lang.org/) [](https://github.com/starsflower/piston2d-python/pulls)
`piston2d`, or `piston2d-python`, is a Python binding for the amazing Rust library `piston2d`.
*This is very WIP, so I will not accept any issues (yet). Assume that breaking changes happen with every commit.*
## Getting started
This assumes you have installed the library to your computer. This is not meant to be extensive, but will develop into a proper tutorial as the project goes on.
### Setting up the window and event handlers
```python
from piston2d.window import Window
from piston2d.window import WindowSettings
from piston2d.window.events import Events
from piston2d.window.events import EventSettings
window = Window(WindowSettings("my window name", (180, 180)))
events = Events(EventSettings())
```
### Setting up graphics
```python
from piston2d.opengl import GlGraphics
# ...
graphics = GlGraphics("3.2")
```
### Start the loop
```python
# List to keep track of keys...
keys = []
while event := events.next(window):
if button := event.press_args():
keys.append(button.value())
print("Keys pressed: {}".format(keys))
if button := event.release_args():
try:
keys.remove(button.value())
except:
pass
```
### Draw loop
```python
while event := events.next(window):
# ...
if args := event.render_args():
# Begin the draw loop
context = graphics.draw_begin(args.viewport)
# Draw code here
# End the draw loop
graphics.draw_end()
```
### Drawing shapes
As of writing, only the rectangle and circle arc are implemented:
```python
from piston2d.graphics import circle_arc, rectangle
WHITE = [1.0, 1.0, 1.0, 1.0]
# ...
while event := events.next(window):
# ...
if args := event.render_args():
# Begin the draw loop
context = graphics.draw_begin(args.viewport)
# Draw circle arc in center (ish)
circle_arc(WHITE, 15.0, 0.0,
math.tau, [50, 50, 80, 80], context.transform(), graphics)
# Draw rectangle in top left corner
rectangle(WHITE,
[0, 0, 30, 30], context.transform(), graphics)
# End the draw loop
graphics.draw_end()
```
You may also want to clear the screen:
```python
# ...
BLACK = [0.0, 0.0, 0.0, 1.0]
while event := events.next(window):
# ...
if args := event.render_args():
# Begin the draw loop
context = graphics.draw_begin(args.viewport)
# Clear the screen
graphics.clear_color(BLACK)
# Draw code here...
# End the draw loop
graphics.draw_end()
```
## Examples
- `tests/simple_window.py` • A simple window to test drawing using `GlGraphics`.
Example:
## Building
Use setuptools to build
```python
pip install setuptools wheel setuptools_rust
python setup.py install
```