Welcome to Grafyte’s Documentation

Grafyte is a Python-first 2D engine backed by a native C++ and OpenGL core. This guide walks through the current high-level API: creating an application, managing multiple scenes, handling input, drawing objects, and using textures, collisions, camera control, and UI text.

Highlights

• Native rendering core with a small Python API

• Multi-scene workflow with an active scene model

• Raw key input and action-based input helpers

• Built-in text, UI overlays, textured sprites, camera, and collision primitives

Contents

Tutorial

• Installation
  • Requirements
  • Install From PyPI
  • Quick Verification
• Introduction to Grafyte
  • Basic Imports
  • Core Concepts
• Initializing the Application
  • Optional Font
  • Creating Your First Scene
• The Main Loop
  • Frame Timing
  • Shutdown
• Colors
  • Background Color
  • Object Color
  • Text Color
• Handling Input
  • Raw Key States
• Advanced Input (Actions)
  • Creating Actions
  • Checking Actions
  • Available Triggers
• Representing Entities
  • Scenes
  • Objects
  • Coordinate System
  • Layers
  • Text Objects
• Advanced Concepts
  • Textured Objects and Tint
  • Camera
  • Collisions
  • UI Text
  • Multiple Scenes
• Explore a Simple Bouncing Square