Skip to main content

Pygame Zero like API to teach 3d games programming based on Raylib

Project description

Richlib

A simplified API for Raylib for use in education and to enable beginners to create 3d games.

Current state: working, but untested alpha, API may change.

Use

Richlib is just a few classes that sit on top of Raylib Python CFFI. Once you have imported Richlib you automatically get all of raylib.static and raylib.pyray and you could just copy any Raylib Python example code you find. Then if you want to use Richlib's classes as well as Raylib you can.

The normal way of using Richlib is not to write your own main game loop. Instead, you set some variables to tell Richlib how you'd like your game to be:

from richlib import *

WIDTH=800
HEIGHT=640
CAMERA=rl.CAMERA_FIRST_PERSON
DATA_DIR="examples/models/resources/models/"

cube = Cube((0, 10, 0), (10, 20, 10), 'blue')

Then you define some specially named methods:

def draw():
    clear()
    cube.draw()

def update():
    cube.x = cube.x + 1
    if cube.x > 100:
        cube.x = -100

Then you tell Richlib to run your methods in its game loop:

run()

Differences from Pygame Zero

  1. We don't have a special mode in the Mu editor like Pygame Zero does, and therefore it is necessary to add an import line to the start of every program, and a run() line to the end.

  2. The underlying API, Raylib, is not object oriented like Pygame is. The stuff added by Richlib is object oriented but you might notice there is no proper equivalent of the screen object because Raylib doesn't have one.

  3. 3D games are inherently more complex than 2D, e.g. there is no equivalent of the camera object for the 2d programmer to worry about.

  4. To mitigate (3) as much as possible we do automate some stuff that you might expect to do manually in Pygame Zero.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for richlib, version 0.0.6
Filename, size File type Python version Upload date Hashes
Filename, size richlib-0.0.6-py3-none-any.whl (22.4 MB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size richlib-0.0.6.tar.gz (19.6 MB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page