Lightweight 2D game library for Python, inspired by Haaf's Game Engine.
import pgfx
pgfx.init(800, 600, "My Game")
x, y = 400, 300
def update(dt):
global x, y
speed = 200 * dt
if pgfx.key_down(pgfx.KEY_LEFT): x -= speed
if pgfx.key_down(pgfx.KEY_RIGHT): x += speed
if pgfx.key_down(pgfx.KEY_UP): y -= speed
if pgfx.key_down(pgfx.KEY_DOWN): y += speed
return not pgfx.key_pressed(pgfx.KEY_ESCAPE)
def render():
pgfx.clear(pgfx.Color(20, 20, 40))
pgfx.circle_fill(x, y, 20, pgfx.WHITE)
pgfx.run(update, render)
- Sprites — load, draw, rotate, scale, flip
- Text — TrueType fonts
- Audio — sounds and music
- Input — keyboard, mouse, gamepads
- Particles — configurable particle systems
- Lighting — ambient and point lights
- Collision — rects, circles, raycasts
ship = pgfx.sprite_load("ship.png")
pgfx.draw(ship, 100, 200)
pgfx.draw_ex(ship, 300, 200, rot=0.5, scale=2, alpha=0.8)font = pgfx.font_load("font.ttf", 24)
pgfx.text(font, f"FPS: {pgfx.fps()}", 10, 10, pgfx.WHITE)laser = pgfx.sound_load("laser.wav")
pgfx.sound_play(laser)
music = pgfx.music_load("theme.ogg")
pgfx.music_play(music, loop=True)# Keyboard
if pgfx.key_pressed(pgfx.KEY_SPACE):
shoot()
# Mouse
mx, my = pgfx.mouse_pos()
if pgfx.mouse_pressed(pgfx.MOUSE_LEFT):
click(mx, my)
# Gamepad
if pgfx.gamepad_connected():
move_x = pgfx.gamepad_axis(0, pgfx.GAMEPAD_AXIS_LX)fire = pgfx.particles_create(
primitive="circle_soft",
emission_rate=100,
lifetime_min=0.3, lifetime_max=0.8,
speed_min=50, speed_max=100,
start_color=(255, 200, 50, 255),
end_color=(255, 50, 0, 0),
start_size=10, end_size=2
)
# In update:
pgfx.particles_fire(fire, x, y)
pgfx.particles_update(fire, dt)
# In render:
pgfx.particles_render(fire)pgfx.set_ambient(pgfx.Color(30, 30, 50))
torch = pgfx.light_create(150, pgfx.Color(255, 200, 100))
pgfx.light_set_flicker(torch, 0.2, 3.0)
# In render:
pgfx.light_draw(torch, player_x, player_y)
| Function |
Description |
init(width, height, title, **opts) |
Initialize window. Options: vsync, fullscreen, resizable, fixed_dt |
run(update_fn, render_fn) |
Start game loop. update_fn(dt) returns False to quit |
quit() |
Exit game loop |
dt() |
Delta time in seconds |
fps() |
Current FPS |
time() |
Time since init |
screen_size() |
Returns (width, height) |
| Function |
Description |
key_down(key) |
Key is held |
key_pressed(key) |
Key just pressed |
key_released(key) |
Key just released |
mouse_pos() |
Returns (x, y) |
mouse_down(btn) |
Button is held |
mouse_pressed(btn) |
Button just pressed |
mouse_wheel() |
Wheel delta (-1, 0, 1) |
gamepad_connected(idx=0) |
Gamepad connected |
gamepad_button(idx, btn) |
Button pressed |
gamepad_axis(idx, axis) |
Axis value (-1 to 1) |
gamepad_trigger(idx, trigger) |
Trigger value (0 to 1) |
| Function |
Description |
texture_load(path) |
Load texture, returns ID |
texture_free(tex) |
Free texture |
texture_size(tex) |
Returns (width, height) |
| Function |
Description |
sprite_load(path) |
Load sprite from image |
sprite_create(tex, x, y, w, h) |
Create sprite from texture region |
sprite_sheet(path, cols, rows) |
Load sprite sheet, returns list of IDs |
sprite_set_origin(spr, ox, oy) |
Set origin point |
sprite_set_color(spr, color) |
Set tint color |
sprite_free(spr) |
Free sprite |
| Function |
Description |
clear(color) |
Clear screen |
draw(spr, x, y) |
Draw sprite |
draw_ex(spr, x, y, rot=0, scale=1, alpha=1, flip_x=False, flip_y=False) |
Draw with transform |
rect_fill(x, y, w, h, color) |
Draw rectangle |
line(x1, y1, x2, y2, color) |
Draw line |
circle_fill(x, y, r, color) |
Draw circle |
| Function |
Description |
font_load(path, size) |
Load TTF font |
font_free(font) |
Free font |
text(font, string, x, y, color) |
Draw text |
| Function |
Description |
sound_load(path) |
Load sound (WAV, OGG) |
sound_free(snd) |
Free sound |
sound_play(snd, volume=1, pan=0, loop=False) |
Play sound |
sound_stop(snd) |
Stop sound |
music_load(path) |
Load music |
music_free(mus) |
Free music |
music_play(mus, loop=True) |
Play music |
music_stop(mus) |
Stop music |
music_pause(mus) |
Pause music |
music_resume(mus) |
Resume music |
set_master_volume(vol) |
Set master volume (0-1) |
set_music_volume(vol) |
Set music volume (0-1) |
| Function |
Description |
collide_rects(x1, y1, w1, h1, x2, y2, w2, h2) |
Rectangle overlap |
collide_circles(x1, y1, r1, x2, y2, r2) |
Circle overlap |
collide_circle_rect(cx, cy, r, rx, ry, rw, rh) |
Circle-rect overlap |
point_in_rect(px, py, rx, ry, rw, rh) |
Point in rectangle |
point_in_circle(px, py, cx, cy, r) |
Point in circle |
raycast_rect(ox, oy, dx, dy, rx, ry, rw, rh) |
Ray-rect intersection, returns distance or None |
sprite_rect(spr, x, y) |
Get sprite bounds (x, y, w, h) |
collide_sprites(spr1, x1, y1, spr2, x2, y2) |
Sprite overlap |
point_in_sprite(px, py, spr, sx, sy) |
Point in sprite |
| Function |
Description |
particles_create(**params) |
Create particle system |
particles_free(ps) |
Free particle system |
particles_set(ps, **params) |
Update parameters |
particles_fire(ps, x, y) |
Start emitting |
particles_emit(ps, x, y, count) |
Emit burst |
particles_stop(ps) |
Stop emitting |
particles_move_to(ps, x, y) |
Move emitter |
particles_update(ps, dt) |
Update (call in update) |
particles_render(ps) |
Render (call in render) |
particles_is_alive(ps) |
Any particles alive |
particles_count(ps) |
Active particle count |
Particle parameters: primitive, emission_rate, lifetime_min, lifetime_max, speed_min, speed_max, direction, spread, gravity, start_color, end_color, start_size, end_size, max_particles
| Function |
Description |
set_ambient(color) |
Set ambient light |
light_create(radius, color) |
Create light |
light_set_color(light, color) |
Change color |
light_set_intensity(light, intensity) |
Set intensity (0-1) |
light_set_flicker(light, amount, speed) |
Add flicker effect |
light_draw(light, x, y) |
Draw light |
light_free(light) |
Free light |
Colors: WHITE, BLACK, RED, GREEN, BLUE, YELLOW, CYAN, MAGENTA, TRANSPARENT
Keys: KEY_A-KEY_Z, KEY_0-KEY_9, KEY_F1-KEY_F12, KEY_LEFT, KEY_RIGHT, KEY_UP, KEY_DOWN, KEY_SPACE, KEY_ESCAPE, KEY_ENTER, KEY_TAB, KEY_BACKSPACE, KEY_LSHIFT, KEY_RSHIFT, KEY_LCTRL, KEY_RCTRL, KEY_LALT, KEY_RALT
Mouse: MOUSE_LEFT, MOUSE_RIGHT, MOUSE_MIDDLE
Gamepad buttons: GAMEPAD_A, GAMEPAD_B, GAMEPAD_X, GAMEPAD_Y, GAMEPAD_LB, GAMEPAD_RB, GAMEPAD_BACK, GAMEPAD_START, GAMEPAD_GUIDE, GAMEPAD_LSTICK, GAMEPAD_RSTICK, GAMEPAD_DPAD_UP, GAMEPAD_DPAD_DOWN, GAMEPAD_DPAD_LEFT, GAMEPAD_DPAD_RIGHT
Gamepad axes: GAMEPAD_AXIS_LX, GAMEPAD_AXIS_LY, GAMEPAD_AXIS_RX, GAMEPAD_AXIS_RY
Gamepad triggers: GAMEPAD_TRIGGER_L, GAMEPAD_TRIGGER_R
MIT