ratr0-engine Logo

User Guide

  • Getting Started
    • Initialization
      • ratr0_engine_startup()
    • Configuration Options
  • Introduction
    • Motivation
    • Architecture & Design
  • Collision system
    • AABB
    • Spatial hashing
      • Strategy
  • Rendering Architecture
    • Motivation
    • Central Concepts
      • Copper lists
      • Playfields
      • Double buffering
      • Render list
      • Background restoration algorithm (dirty rectangles)
        • Idea
        • BOB changes
      • Graphics effects
        • Palette interpolation
  • Input system
    • Description
    • Design ideas
      • Keyboard input
  • The Memory subsystem
    • Motivation
  • Sprites
    • Hardware sprites
    • Soft sprites (BOBs)
    • Creating a sprite in the RATR0 engine
  • Stages system
    • Description
    • Stages
  • Errors I made during development
  • Conclusions

Utilities (ratr0-utils)

  • Welcome to ratr0-utils
    • Installation
    • Command Line Tools
      • The ratr0-maketiles tool
        • Parameters in detail
      • The ratr0-makesprites tool
        • Parameters in detail
        • Creating more than one sprite
      • The ratr0-converttiled tool
        • Parameters in detail
      • The ratr0-makecoplist tool
        • Parameters in detail
        • Copper list format
        • Example list:
    • Asset Formats
      • The Tiles File Format
        • Introduction
        • Specification
      • The Level File Format
        • Introduction
        • Specification
      • The Sprites File Format
        • Introduction
        • Specification

Technical Reference

  • API Reference
    • Core Lifecycle
      • ratr0_engine_startup()
    • Memory Management
      • Ratr0MemoryConfig
        • general_pool_size
        • general_table_size
        • chip_pool_size
        • chip_table_size
    • Data Structures
      • Ratr0Surface
        • width
        • height
        • depth
        • is_interleaved
        • buffer
    • Graphics & Display
      • ratr0_display_init_buffers()
    • Search Index
ratr0-engine
  • ratr0-engine Documentation
  • Edit on GitHub

ratr0-engine Documentation

Welcome to the documentation for the ratr0-engine.

User Guide

  • Getting Started
    • Initialization
    • Configuration Options
  • Introduction
    • Motivation
    • Architecture & Design
  • Collision system
    • AABB
    • Spatial hashing
  • Rendering Architecture
    • Motivation
    • Central Concepts
  • Input system
    • Description
    • Design ideas
  • The Memory subsystem
    • Motivation
  • Sprites
    • Hardware sprites
    • Soft sprites (BOBs)
    • Creating a sprite in the RATR0 engine
  • Stages system
    • Description
    • Stages
  • Errors I made during development
  • Conclusions

Utilities (ratr0-utils)

  • Welcome to ratr0-utils
    • Installation
    • Command Line Tools
    • Asset Formats

Technical Reference

  • API Reference
    • Core Lifecycle
    • Memory Management
    • Data Structures
    • Graphics & Display
    • Search Index

Overview

This engine focuses on high-performance C development with a stable API.

Next

© Copyright 2025-2026, Wei-ju Wu.

Built with Sphinx using a theme provided by Read the Docs.