Troubleshooting: GPU, rendering & performance
SPBokeh has separate device and quality controls. A slow frame, a GPU error, and a lower-quality result usually have different causes.
Preview is slower than expected
Check Render Quality and the host preview resolution. Under Auto, a Full-resolution interactive frame generally uses Final, not Preview. Try a lower host preview resolution or explicitly choose Preview while editing. Use Info > About... to see the most recent automatic quality choice, when one is available.
Auto switched to the CPU
Auto (GPU preferred) may fall back if the GPU path is unavailable or a frame exceeds supported resource limits. Large images, device limitations, and allocation failures can all trigger it. Check the host, system, frame dimensions, and available memory. About... may show the last reported device information.
GPU was selected, but the render failed
GPU (Metal) and GPU (D3D12) are strict selections; neither silently retries on the CPU. Switch to Auto (GPU preferred) or CPU to see whether the problem is specific to the GPU path. On Windows, also confirm that DirectX_Assets is present beside SPBokehAE.aex in the installed release.
GPU input textures are checked against a maximum of 16,384 pixels per side. Other resource limits may be reached earlier, depending on the GPU, concurrent work, and frame configuration.
Final looks similar to Balanced
These levels change sample budgets and internal processing; the visible difference depends on the footage. Compare at the same host resolution and 100% zoom, preferably using a crop with fine bokeh edges or a difficult depth boundary. Final can't restore detail from a Half-resolution input delivered by the host.
The image looks too dark or too bright
Check Color Processing against the RGB encoding the host delivers. Gamma-Encoded expects sRGB-encoded input; Linear expects linear RGB. Premiere Pro's automatic interpretation can depend on which render path is in use, especially with native floating-point GPU frames.
Report a reproducible rendering problem
Include your After Effects or Premiere Pro version, operating system, SPBokeh version/build, Processing Device, Render Quality, bit depth, frame dimensions, and the exact steps that trigger the issue. A short sample project or a frame-and-depth comparison helps when the problem occurs only on certain footage.