Skip to content
SPBokeh Documentation
Buy SPBokeh

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.

Read: Render quality, performance & color

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.

Read: Host differences