From 7057fd5b25a9b20a5d1d0d705491061e61e7757b Mon Sep 17 00:00:00 2001 From: skal Date: Thu, 12 Mar 2026 17:16:47 +0100 Subject: docs(todo): add Wine black screen investigation task demo64k.exe runs under Wine but renders no visuals. Audio/timeline work. Co-Authored-By: Claude Sonnet 4.6 --- TODO.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) (limited to 'TODO.md') diff --git a/TODO.md b/TODO.md index c89c9a6..0f6c600 100644 --- a/TODO.md +++ b/TODO.md @@ -59,6 +59,19 @@ Ongoing shader code hygiene for granular, reusable snippets. --- +## Priority 4: Wine/Windows Black Screen + +`demo64k.exe` runs under Wine (wgpu-native v27, Vulkan/MoltenVK) but shows a black window — no visuals rendered. Audio and timeline progress correctly. GPU device/adapter init succeeds. + +**Likely causes to investigate:** +- Swapchain format mismatch (Wine Vulkan may prefer BGRA8 over RGBA8) +- Surface present failing silently (check `WGPUSurfaceGetCurrentTexture` status) +- Render pass output not reaching the surface (missing present call or wrong texture view) + +**To reproduce:** `./scripts/run_win.sh` — window opens, stays black. + +--- + ## Future: Size Optimization (64k Target) - Task #22: Windows Native Platform (Win32) -- cgit v1.2.3