Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/faresbakhit/ray.py
CPython native bindings for Raylib
https://github.com/faresbakhit/ray.py
c game-development gamedev graphics python raylib videogames
Last synced: 3 months ago
JSON representation
CPython native bindings for Raylib
- Host: GitHub
- URL: https://github.com/faresbakhit/ray.py
- Owner: faresbakhit
- License: zlib
- Created: 2022-02-21T05:28:12.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-09-11T02:48:53.000Z (5 months ago)
- Last Synced: 2024-09-11T09:47:11.160Z (5 months ago)
- Topics: c, game-development, gamedev, graphics, python, raylib, videogames
- Language: C
- Homepage:
- Size: 45.9 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
**ray.py - CPython native bindings for Raylib**
ray.py is a cross-platform bindings for the great graphics library [Raylib](https://www.raylib.com/) 5.0+ with performance in-mind as it was built using the native Python/C API and statically links `libraylib` so you don't miss any frame!
Check out [examples](https://github.com/faresahmedb/ray.py/blob/main/examples) converted from [raylib/examples](https://github.com/raysan5/raylib/blob/master/examples)
---
## Features
- Uses the [Vectorcall](https://peps.python.org/pep-0590/) fast calling protocol
- Correct Python annotations/type hints
- Docstrings for all definitions, converted from Raylib's header file
## Getting Started
ray.py uses Python3.7+ C API so you would need Python 3.7+ installed on your system, If you don't have it, install it using your system's package manager or follow the [instructions](https://www.python.org/download) provided on Python's website.
### Installing
This requires having [pip](https://pip.pypa.io/en/stable/) and an internet connection, If your current envirnment doesn't have pip installed follow [this](https://pip.pypa.io/en/stable/installation/) instructions
```
python3 -m pip install ray.py
python3 -c "import raypy"
```
The first command installs `ray.py` and second ensures that it's working.
### Quick Start
```python
import raypy
screen_width = 800
screen_height = 450
raypy.init_window(screen_width, screen_height, "raylib [core] example - basic window")
raypy.set_target_fps(60)
while not raypy.window_should_close():
raypy.begin_drawing()
raypy.clear_background(raypy.RAYWHITE)
raypy.draw_text("Congrats! You created your first window!", 190, 200, 20, raypy.LIGHTGRAY)
raypy.end_drawing()
raypy.close_window()
```
## Building
This requires having `git`, `python3-dev` installed on your system
```
git clone https://github.com/faresahmedb/ray.py.git
cd ray.py
python3 -m venv .venv
source .venv/bin/activate OR .venv\Scripts\activate
python -m pip install build
python -m build
```
This will download the latest version of [raysan5/raylib](https://github.com/raysan5/raylib) releases and link our source files against it if you wish to change the release version or use your own repo, check `python setup.py download_deps --help`
If all goes okay you should have two new files in `dist` one of them is `ray.py-X.Y.X.tar.gz` (sdist) and the other is `ray.py-X.Y.Z-PLATFORM` (wheel)
## Rationale
Other Raylib bindings were slower than the popular graphics libraries in Python like pygame as they were written using `ctypes` or tools like `cffi` which leaves a lot of room for performance so I decided to write it all in C and see how it goes.
## License
ray.py is licensed under an unmodified zlib/libpng license, see the [LICENSE](LICENSE) file for details.