effectcraft/docs
bflatastic 4eb69e7577 Render: render.backend says why it renders on the CPU; mcp --gpu documented (#262)
get_project / render.backend reported "gpuAcceleration": true with
"active": "cpu" and no reason, which read as a broken GPU. The
headless MCP server only attaches the GPU compositor when started with
--gpu, which docs/agents.md didn't mention, and a failed --gpu said
only "no usable GPU adapter" (the adapter's error went to a log no
one sees). The session now keeps the host's reason there is no GPU
compositor (accel_note): the CLI's "headless: renders on the CPU
unless started with --gpu", or the desktop app's compositor setup or
retirement error. The status reports it as `why` whenever it renders
on the CPU (or that the project's renderer is Software Only). --gpu
failures include the adapter's error (Gpu::try_headless).
docs/agents.md documents `mcp --gpu`.

Test: render_backend_says_why_it_renders_on_the_cpu (engine).
Checked with effectcraft-cli mcp and mcp --gpu.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 18:09:01 +07:00
..
brand Licensing: standard LICENSE files, NOTICE, ArtCraft brand terms 2026-10-04 10:05:24 -04:00
fidelity G2: improve editing reliability and Windows rendering fidelity 2026-10-06 00:00:31 -05:00
images M0.11: README rewrite with headless screenshots (hero, graph editor, effects, 3D, render queue) 2026-10-01 23:31:40 -04:00
agents.md Render: render.backend says why it renders on the CPU; mcp --gpu documented (#262) 2026-10-08 18:09:01 +07:00
architecture.md fix: contain GPU initialization and retire failed readbacks 2026-10-06 16:40:12 -05:00
contributors.md About: contributor and model credits compiled in (grab bag + table, self-submitted names) (#228) 2026-10-07 21:16:47 -04:00
control-protocol.md Viewer: Snapping options pick which layer features snap (#253) 2026-10-08 17:14:05 +07:00
effects.md Merge main into M13.28 worktree 2026-10-04 02:57:55 -04:00
gaps.md Docs: parity.md and gaps.md G8 describe ease presets (#254) 2026-10-08 17:25:00 +07:00
parity.md Docs: parity.md and gaps.md G8 describe ease presets (#254) 2026-10-08 17:25:00 +07:00
plugins.md M13.12: docs (pdf README, parity, plug-ins), EPS Type 3 fonts reported 2026-10-03 09:51:22 -04:00
preferences.md App: a launch whose window never drew makes the next use OpenGL (#243) 2026-10-08 13:57:21 +07:00
releasing.md Docs: releasing.md, the release procedure release.yml points to (#136) 2026-10-07 11:53:50 +07:00
testing.md Effects: the sim golden test accepts macOS 27's libm hash for Mr. Mercury (#232) 2026-10-08 13:36:09 +07:00
web.md Web: a lost graphics device says so and offers a reload (#225) 2026-10-08 12:38:11 +07:00