Skip to content
SPBokeh Documentation
Buy SPBokeh

Troubleshooting: controls, presets & older projects

Lens Character controls are disabled

Check that Lens Character is enabled. The Bokeh Details and Lens Aberrations groups are disabled when it is off. The trial also restricts lens features and render quality. A saved parameter value can remain in the project even when the trial is not rendering that feature.

A preset changed which area is sharp

Presets can enable and reshape the Built-in Mask as well as change the optical look. Check Built-in Mask > Enable, Size, Aspect, Feather, and Influence. Presets preserve the mask's Center and View but may change the other shape settings.

Read: Presets

The preview is grayscale and doesn't show bokeh

Check Built-in Mask > View. Preview here shows the final focus matte, including depth and mask processing. Select Final to return to the rendered image. Render Quality > Preview is a different setting; it still displays bokeh.

A parameter name no longer exists

A few controls were renamed after 1.0.0:

Previous nameCurrent name
Focus DepthFocus Distance
Depth RangeFocus Range
Depth FeatherFocus Falloff
Occlusion StrengthBG Exclude

If an expression refers to a parameter by its display name, update the name. Check expressions that use numeric property indices after any panel reordering. Existing values and keyframes use persistent parameter IDs, but the rendered image can still change after algorithm updates.

Read: Migration from 1.0.0