Hamsterball Reimplementation Workflow

1. MESHWORLD geometry rendering — Parse vertex/face data, build D3D8 vertex buffers
2. Texture loading — TGA/PNG loader, D3D texture creation, UV mapping
3. Collision detection — Parse .COL files, ball collision with surfaces
4. Real ball physics — Ball_AdvancePositionOrCollision 6-phase pipeline
5. UI/menu system — Main menu, pause menu, race menus
6. Loading screen — TimerDisplay, App_ResourceLoader
7. Audio — DirectSound/BASS initialization

Key Ghidra Functions for Each Subsystem

• MESHWORLD geometry: decomp_meshworld_parse.c (0x470930) — handles .ASE vertices/faces
• Collision: Ball_AdvancePositionOrCollision (0x4564C0), Collision_TraverseSpatialTree (0x465EF0)
• Textures: LoadTexture (0x4146D0), TGA loader in decompilations/graphics/
• Menu: MainMenu_ctor (0x42DE50), UIList_AddItem (0x4497F0)

Testing Commands

# Build
cd ~/hamsterball-re/reimpl
i686-w64-mingw32-gcc -std=c11 -m32 -O2 -Iinclude \
  src/core/win32_main.c src/level/*.c \
  -o hamsterball.exe -ld3d8 -ldinput8 -ldsound -ldxguid -lole32 -lwinmm -mwindows

# Run
wine ./hamsterball.exe

# Debug Wine D3D8 translation
WINEDEBUG=+d3d8 wine ./hamsterball.exe 2>&1 | head -100

Commit Messages Pattern

• "D3D8 build: [subsystem] [action]"
• Example: "D3D8 build: MESHWORLD geometry rendering + vertex buffers"
• Always commit to both origin (public) and priv (private)

Memory to Save for Next Session

• 3781/3781 functions documented (100% complete)
• 50 docs, 21,551 lines of documentation
• First D3D8 build working (skeleton)
• Next focus: Fix WarmUp obj section parsing for bbox+vertex extraction, then test on real GPU

Common Issues & Fixes

• D3DX math not in D3D8: Use manual math or d3dx8.lib
• PresentationInterval: Use FullScreen_PresentationInterval in MinGW
• Header order: mmsystem.h before dsound.h
• Wine translation: D3D8→OpenGL happens automatically, no extra code needed