filmcraft/docs
vangel76 116364cf08 #820: fall back to DX12, then a software adapter, when the graphics start fails
Problem: a graphics driver that crashes inside wgpu instance or device
creation (Intel Vulkan igvk64.dll #512 #413 #793, AMD atio6axx.dll #477)
killed every launch the same way until the user set WGPU_BACKEND by hand;
a start-up error wgpu did report ended in an error dialog.

Fix: each start leaves a marker in the data folder (graphics-start.json),
cleared once the window has painted two frames. A marker still pending at
the next launch moves on along the platform's ladder (Windows: Vulkan+DX12,
DX12 only, software/WARP; Linux: default, software/lavapipe or llvmpipe)
and keeps the mode that works. A wgpu start-up error moves on within the
same process (eframe reuses its event loop). Fallback modes don't register
the GPU export renderer, whose own instance would load the failed driver.
An explicit WGPU_BACKEND leaves the marker alone.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-11 00:58:45 +02:00
..
adr Linux: NVDEC hardware decoding for H.264 and HEVC 2026-10-09 23:17:11 -07:00
brand Licensing: standard LICENSE files, NOTICE, ArtCraft brand terms 2026-10-04 10:05:12 -04:00
images README: new hero — Apollo 11 documentary edit (public domain) 2026-10-01 11:17:08 -04:00
agents.md Merge pull request #595 from MarekSpodBiedry/issue-476 2026-10-10 14:52:19 -04:00
architecture.md #806: export OpenEXR image sequences 2026-10-11 00:34:28 +02:00
captions.md captions: captions.list with a track that names no caption track is an error 2026-10-10 09:02:57 +02:00
codec-parity.md #800: MP2 audio in MP4 and MOV decodes instead of playing silent 2026-10-11 00:26:39 +02:00
contributing.md Progress docs: target-app parity, gaps, alpha gate, readiness by audience (#700) 2026-10-10 14:09:14 -04:00
contributors.md About: contributor and model credits compiled in (grab bag + table, self-submitted names) (#215) 2026-10-07 21:16:52 -04:00
control-protocol.md Merge pull request #794 from impostazioni/fix/alt-drag-duplicate 2026-10-10 18:15:25 -04:00
file-format-parity.md #806: export OpenEXR image sequences 2026-10-11 00:34:28 +02:00
gaps.md #820: fall back to DX12, then a software adapter, when the graphics start fails 2026-10-11 00:58:45 +02:00
graphics.md program monitor: drag a rectangle's corners round (#744) 2026-10-10 22:46:27 +03:00
hardware-parity.md Progress docs: target-app parity, gaps, alpha gate, readiness by audience (#700) 2026-10-10 14:09:14 -04:00
keyboard.md M12.7: Project panel and Media Browser parity 2026-10-03 02:14:31 -04:00
localization-parity.md #498: French (fr) interface translation 2026-10-11 00:22:08 +02:00
monitors.md #313: J/K/L shuttle the Source monitor both ways at up to 8x 2026-10-10 19:16:40 +02:00
performance.md Merge origin/main into #421; GPU export opt-in, wgpu error handler, drop panicked renderers 2026-10-10 07:21:38 -04:00
project-files.md #266: quitting with unsaved changes asks to save first 2026-10-10 21:33:45 +02:00
releasing.md #346: the from-source Flatpak includes the CLI and MCP server 2026-10-09 15:37:09 +02:00
roadmap.md Progress docs: target-app parity, gaps, alpha gate, readiness by audience (#700) 2026-10-10 14:09:14 -04:00
target-app-parity.md #805: Morph Cut morphs along optical flow instead of cross-dissolving 2026-10-11 00:32:08 +02:00
testing.md Linux: H.265 export through NVENC 2026-10-10 14:41:04 -07:00
transcripts.md transcripts: disabled, not failing, in builds without speech-to-text (#89, #97, #98) 2026-10-07 09:14:05 -05:00
ui-parity.md #577: Effect Controls shows a selected transition's own timeline 2026-10-11 00:08:40 +02:00
web.md Crash and blank-screen fixes (desktop + web) 2026-10-04 00:26:19 -04:00