pygraphics

🖌️ pygraphics

Cross-platform 2D drawing and graphics engine for the PyDevices stack — Area dirty bounding boxes, framebuf-compatible FrameBuffer, embedded romfonts, shapes, and image loaders.

📦 MIP: pygraphics 🐍 PyPI: pydevices-pygraphics ⚡ Native C & Pure-Python Parity 🌐 MicroPython · CircuitPython · CPython · Direct WebAssembly · Pyodide

📐 Area Bounding Boxes

Every shape and text primitive returns an Area(x, y, w, h) bounding box for partial screen refresh and dirty-rect updates.

🔤 Embedded Romfonts

Zero-dependency built-in 8x8, 8x14, and 8x16 romfonts with arbitrary scaling, transparency, and external .bin file support.

🖼️ Streaming BMP565

Stream and slice massive 16-bit RGB565 bitmaps without loading full images into microcontroller RAM.

⚡ Hardware Blit Fast-Paths

Direct SPI/SDL bulk blit dispatch with clipping context managers (with draw.clip(...)).

---

💻 Live Interactive 2D Drawing Demo

Try editing the drawing primitives below and click ▶ Run to execute them with direct MicroPython WebAssembly:

import pygraphics from displaydev.auto import AutoDisplay # Initialize display canvas (320x240) display = AutoDisplay(width=320, height=240, canvas_id=CANVAS_ID) buf = bytearray(320 * 240 * 2) fb = pygraphics.FrameBuffer(buf, 320, 240, pygraphics.RGB565) fb.fill(0x1082) # Draw shapes with Area returns fb.round_rect(20, 20, 120, 70, 10, 0xF800, f=True) fb.circle(220, 55, 35, 0x07E0, f=True) fb.line(20, 110, 300, 110, 0xFFFF) # Render embedded romfonts pygraphics.text8(fb, "Romfont 8x8", 20, 130, 0xFFE0) pygraphics.text14(fb, "Romfont 8x14", 20, 150, 0x07FF) pygraphics.text16(fb, "Romfont 8x16", 20, 175, 0xFFFF) # Blit to display and present display.blit_rect(buf, 0, 0, 320, 240) display.show() print(f"Drawn shapes in {pygraphics.implementation()} backend!")

▶ Run ↺ Reset Initializing Python…

---

🚀 Quick Install

Distribution	Channel	Role
pydevices-pygraphics	TestPyPI	Native C-extension wheel for desktop, Android, and CPython (native_cmod)
pygraphics	MIP	Pure-Python package for microcontrollers and builds without a C compiler (pygraphics_python)

# CPython / Desktop
pip install -i https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ pydevices-pygraphics

# MicroPython
import mip
mip.install("pygraphics", index="https://PyDevices.github.io/mip")

---

🎮 Featured Browser Demos

Explore complete applications and arcade games built with pygraphics:

🔴 Bouncing Balls

High-framerate physics simulation with vector circles and bounding-box collision detection.

▶ Launch Live Demo

👾 Alien Arcade

Retro Space Invaders-style sprite engine with transparency and animated framebuffers.

▶ Launch Live Demo

🦖 Dino Runner

Classic obstacle jumping arcade running with dirty scanline refresh and physics.

▶ Launch Live Demo

🕹️ Testris Arcade

Full-featured falling-blocks game with matrix rotation, score tracking, and ghost pieces.

▶ Launch Live Demo

---

📚 Documentation Map

• 🚀 Getting started — Core drawing workflows, dirty rectangles, and canvases.
• 📦 Installation — MIP, TestPyPI, wheel building, and platform matrix.
• 🎨 Graphics guide — FrameBuffer vs Draw, clipping stacks, fonts, and blit fast-paths.
• 🖼️ Graphics files — BMP565, PBM, PGM image loaders and streaming.
• ⚡ Benchmarks — Native C extension vs Pure-Python performance metrics.
• 📚 API Reference — Full autogenerated API documentation.