filmcraft/docs
Brandon Thomas 4aea06e2ae GPU2: standard effects on the GPU compositor (#30)
A media clip whose enabled standard effects all have a GPU implementation
plans as a GPU layer carrying them (render::plan::LayerFx): parameters are
evaluated on the CPU at the frame's time (render::gpufx::FxOp::eval, shared
with the CPU path so both clamp hostile values identically), the source is
drawn into an Rgba32Float working image at the size the CPU decodes it, the
effects run as WGSL compute passes (gpu::fx, fx.wgsl) with the CPU
reference's math, and the result is placed with Motion, opacity and blend
mode as before. Layers without effects keep the single draw.

GPU effects: Brightness & Contrast, ProcAmp, Tint, Black & White, Color
Balance, Leave Color, Change to Color, Color Pass, Color Replace, Channel
Mix, ASC CDL, Gamma Correction, Levels, Extract, Invert, Posterize, Alpha
Adjust, Gaussian / Camera / Directional Blur (+ legacy aliases), Sharpen,
Unsharp Mask, Crop, Edge Feather, Transform, H/V Flip, Mirror, Offset.
Masked effects, opacity masks, non-finite parameters and minifying
Transform/Crop zooms stay on the CPU. Devices without compute shaders run
the effects on the CPU inside the compositor.

Also fixes a debug-build overflow in Image::transformed for non-finite maps.
Parity tests (exact f32 checks and composited plans), a golden test that
plans effect chains as GPU layers, and the stack3-fx playback benchmark.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-05 07:50:20 -04:00
..
adr HW1: platform crate + VideoToolbox H.264/HEVC hardware decode (#30) 2026-10-05 04:53:28 -04: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 Docs: honest parity assessment in ROADMAP, README and agent docs 2026-10-05 06:04:09 -04:00
architecture.md GPU2: standard effects on the GPU compositor (#30) 2026-10-05 07:50:20 -04:00
captions.md fix: document that the caption track margin is a fraction of the frame height 2026-10-01 11:18:06 -04:00
contributing.md GPU2: standard effects on the GPU compositor (#30) 2026-10-05 07:50:20 -04:00
control-protocol.md HW1: platform crate + VideoToolbox H.264/HEVC hardware decode (#30) 2026-10-05 04:53:28 -04:00
graphics.md M10.7: Essential Graphics Browse/Edit UI, template/font dialogs, golden scenes 2026-10-03 01:02:24 -04:00
keyboard.md M12.7: Project panel and Media Browser parity 2026-10-03 02:14:31 -04:00
monitors.md M4.7: View menu and monitor view options: Paused Resolution, 1/16, High Quality Playback, Display Mode (alpha/RGB channels, comparison, multi-camera, source audio waveform, video+waveform split), Magnification with panning, rulers, guides (drag from rulers, lock, clear, Add Guide, templates in preferences), Snap in Program Monitor 2026-10-01 23:23:27 -04:00
performance.md GPU2: standard effects on the GPU compositor (#30) 2026-10-05 07:50:20 -04:00
project-files.md M10.7: graphics templates (.fcgt), rolls/crawls, responsive design, per-character styles, MCC/STL/TTML/DFXP captions 2026-10-02 22:52:15 -04:00
testing.md HW1: platform crate + VideoToolbox H.264/HEVC hardware decode (#30) 2026-10-05 04:53:28 -04:00
transcripts.md M10.5: Text-based editing / transcripts 2026-10-01 23:25:49 -04:00
web.md Crash and blank-screen fixes (desktop + web) 2026-10-04 00:26:19 -04:00