Source library

PS1 Scene Playback Performance Optimization Plan

docs/ps1/performance-optimization-plan.md

This is the website shelf page for docs/ps1/performance-optimization-plan.md. It exists because the project has hundreds of Markdown files and the website should not pretend the interesting work only happened in the polished essays.

Why this file matters

Active PS1 reference. This is active engineering documentation for the PS1 port. It is close enough to the code that stale claims here become real bugs.

Date: 2026-04-25

File facts

Field Value
Source path docs/ps1/performance-optimization-plan.md
Lines 2811
Approx. words 81362
Code fences 3

Outline

  • PS1 Scene Playback Performance Optimization Plan
  • Executive Summary
  • Current Runtime Shape
  • Measured Pack Evidence
  • Observed Runtime Baseline
  • Dirty Restore And Upload Evidence
  • Guardrails
  • Phase 0: Advanced Metrics Foundation
  • Phase 1: Held-Entry No-Work Path
  • Phase 2: Row/X-Aware Dirty Restore And Upload
  • Phase 3: Specialized FG2 Compositors
  • Phase 4: FG2 Streaming, Prefetch, And CD Access
  • Phase 5: Pack Format Improvements
  • VISITOR3 White-Whale Candidate Deck After v338

Read it in context