Skip to content
SPBokeh Documentation
Buy SPBokeh

Troubleshooting: edges & occlusion

A depth map tells SPBokeh where things are, but it may not describe every fine strand, reflection, or hidden background pixel. Run these checks before raising blur quality.

A bright halo appears around the subject

First compare the source footage and its depth map at the same frame. Check alignment, crop, depth polarity, and the actual contour. Use Matte Expand to shift the bright-region boundary, then Edge Feather to change its softness. If out-of-focus background samples still bleed into the subject, adjust BG Exclude and then Subject Range.

Read: Masks & subject edgesAdvanced transitions

Background bokeh cuts through a clear object

Try BG Exclude. It reduces background samples crossing the in-focus matte, and works best with an accurate subject boundary. Subject Range can expand or tighten what the algorithm considers the subject, but it cannot recreate a missing contour in the depth map. If the depth map is inverted and Foreground Blur is on, fix the polarity first — BG Exclude won't offset a foreground pass pointed at the subject.

Read: BG Exclude

Fine edges look jagged

Check whether Edge Feather is in a hard or soft-edge range. Anti-Aliasing matters around hard, detectable depth contours; it stops contributing once Edge Feather reaches 0.075. If the edge is soft instead, try Edge Guide to reduce mixing across a strong RGB boundary. Edge Guide has no effect at Edge Feather = 0.

Read: Anti-AliasingEdge Guide

Blur changes abruptly between depth layers

A coarse or stepped depth map can produce visible steps in bokeh size. Try Defocus Blend for transitions between out-of-focus depths. Opacity Fade is a separate control that fades bokeh in as an area leaves focus. In Smooth mode, Focus Falloff also affects the depth transition.

Read: Advanced transitions & occlusion

Matte Expand doesn't change the near foreground outline

Matte Expand modifies the input used by the main focus path. The Foreground Blur pass estimates near-object contours from the original depth data, before that expansion. For the near layer, check Foreground Blur, Foreground Spread, source depth precision, and the foreground itself. Small expand values can also be rounded when the processing radius is converted to pixels.

Read: Foreground blur