Source library
PS1 Debug Snippets
docs/archive/PS1_DEBUG_SNIPPETS.md
This is the website shelf page for docs/archive/PS1_DEBUG_SNIPPETS.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
Historical archive. This is older project documentation preserved for context. It is not the current source of truth, but it explains the roads that were tried.
Reference for visual debugging techniques used during PS1 port development. Since printf() doesn’t output to DuckStation TTY console, these visual techniques are essential.
File facts
| Field | Value |
|---|---|
| Source path | docs/archive/PS1_DEBUG_SNIPPETS.md |
| Lines | 337 |
| Approx. words | 1409 |
| Code fences | 12 |
Outline
- PS1 Debug Snippets
- Colored Rectangle Markers
- Color Reference (Palette Index)
- Common Marker Patterns
- Encoding Values in Rectangle Size
- Debug Test Loop
- Isolating Hangs
- Full Screen Color Flash
- Debug Findings Reference
- LoadImage Behavior (Dec 2025)
- CD State Corruption
- IMPORTANT: Current State Clarification (Dec 21, 2025)
- BREAKTHROUGH: Sprite Rendering Working (Dec 21, 2025)
- Real-Time Variable Display with TILE Primitives (Dec 2025)