Skip to content
SPBokeh Documentation
Buy SPBokeh

Parameter reference

Open a parameter to find what it changes, when it works, its default and range, and related controls.

Quick distinctions

  • Edge Enhance concentrates swirl toward the outer image; Swirl Transition controls its gradual introduction from the center.
  • Matte Expand moves a bright-region boundary; Edge Feather softens a focus boundary.
  • Focus Distance selects a manual depth; Focus Point selects the location sampled by After Effects Auto Focus.
  • Opacity Fade fades the bokeh layer into defocus; Defocus Blend smooths changes between out-of-focus depths.
  • Built-in Mask > View > Preview displays the focus matte; Render Quality > Preview renders bokeh with a faster processing configuration.

All controls by group

Preset & Bokeh Basics

ControlWhat it doesHost
PresetApplies a saved snapshot of bokeh, lens, swirl, and Built-in Mask settings.AE / PR
RadiusSets the base bokeh radius relative to a 1080-pixel-high reference frame.AE / PR
Aperture ShapeSelects the circular or polygonal aperture used for bokeh sampling.AE / PR
Highlight PowerIncreases the contribution of bright source samples inside each bokeh shape.AE / PR
Highlight ThresholdSets how bright a source sample must be to receive extra highlight weighting.AE / PR

Swirl

ControlWhat it doesHost
Swirl StrengthControls the overall amount of radial bokeh compression associated with the swirl.AE / PR
Edge EnhanceChanges the strength and radial concentration of bokeh compression toward the outer image.AE / PR
CenterDefines the optical origin for swirl and several lens aberrations.AE / PR
Swirl BiasRotates the orientation of bokeh shapes along the radial swirl field.AE / PR
Swirl TransitionControls how gradually the swirl and selected off-axis distortions appear away from the center.AE / PR

Bokeh Details

ControlWhat it doesHost
Lens CharacterEnables editing of the Bokeh Details and Lens Aberrations controls.AE / PR
Rim / Bright RimAdds a brighter band around the outside of a bokeh shape.AE / PR
Rim WidthControls how wide the bright outer band of a bokeh shape appears.AE / PR
Onion RingAdds concentric ring variations inside a bokeh shape.AE / PR
Onion Ring CountSets the intended number of concentric rings within the bokeh.AE / PR
Aperture RoundnessAdjusts the curvature of polygonal aperture sides.AE / PR
Chromatic AberrationSeparates red and blue blur sampling slightly around the green component.AE / PR

Lens Aberrations

ControlWhat it doesHost
Cat-eyeClips outer-frame bokeh into a cat-eye aperture shape.AE / PR
Cat-eye FalloffChanges how quickly cat-eye deformation develops with distance from the optical Center.AE / PR
ComaBends bokeh asymmetrically to suggest coma aberration.AE / PR
Field CurvatureIncreases existing defocus toward the edges of the frame.AE / PR
AnamorphicStretches bokeh along a chosen axis while compressing it along the perpendicular axis.AE / PR
Anamorphic AngleSets the axis used by Anamorphic stretching.AE / PR
Edge VignetteDarkens RGB toward the outer image relative to the optical Center.AE / PR

Focus & Depth

ControlWhat it doesHost
Depth LayerSelects an external RGB luminance depth map in After Effects.AE
Mask LayerSelects an external grayscale focus map in After Effects, with white areas kept sharp.AE
Use Depth LayerMakes Premiere Pro read the input frame Alpha as depth data.PR
Depth GuideOpens Premiere Pro instructions for feeding a depth map through Track Matte Key.PR
Focus DistanceSelects the depth plane to keep sharp when true depth data is available.AE / PR
Auto FocusSets focus automatically from the depth around Focus Point in After Effects.AE
Focus PointChooses the position from which After Effects Auto Focus estimates depth.AE
Focus Smoothing (s)Smooths changes in the depth selected by After Effects Auto Focus over time.AE
Edge FeatherSoftens focus-matte boundaries for depth maps, external focus maps, and the Built-in Mask.AE / PR
Matte ExpandExpands or erodes the bright regions of an external depth or focus map before depth inversion.AE / PR
Foreground BlurCreates a separate bokeh layer for out-of-focus near objects so they can overlap the background.AE / PR
Foreground SpreadControls how far the foreground bokeh layer extends outside the source object’s outline.AE / PR

Advanced

ControlWhat it doesHost
Opacity FadeFades the bokeh contribution into the image as an area leaves focus.AE / PR
BG ExcludeReduces background bokeh sampling across a subject marked as in focus.AE / PR
Subject RangeOffsets the focus-matte weights that define the subject for background exclusion.AE / PR
Focus RangeSets the half-width of the sharp depth interval around Focus Distance.AE / PR
Focus FalloffControls how gradually a true-depth image moves from sharp to fully blurred in Smooth mode.AE / PR
Falloff CurveSelects how depth distance maps to defocus for a true depth source.AE / PR
Depth InvertReverses the near/far polarity of depth input.AE / PR
Defocus BlendSmooths abrupt changes in bokeh radius between neighboring out-of-focus depths.AE / PR
Edge GuideUses source-image luminance differences to guide softening at focus boundaries.AE / PR
Anti-AliasingReconstructs certain detected hard-depth contours to reduce stair-stepping and narrow edge artifacts.AE / PR

Built-in Mask

ControlWhat it doesHost
EnableTurns on the built-in elliptical focus mask.AE / PR
ViewSwitches between a grayscale preview of the final focus matte and the normal bokeh image.AE / PR
CenterPositions the built-in ellipse that defines the clear or blurred region.AE / PR
SizeSets the elliptical mask’s clear-core radius relative to half the frame’s shorter dimension.AE / PR
AspectChanges the ellipse’s width relative to its height.AE / PR
AngleRotates the elliptical focus mask.AE / PR
FeatherControls the soft transition from the ellipse’s clear core to its outer region.AE / PR
InvertSwaps the ellipse’s clear and blurred regions.AE / PR
InfluenceControls how strongly the ellipse shapes the base blur field.AE / PR

Render & Color

ControlWhat it doesHost
Render QualityChooses the bokeh engine strategy and sampling budget.AE / PR
Color ProcessingTells SPBokeh which transfer relationship to use when reading host RGB values.AE / PR
Processing DeviceSelects whether SPBokeh tries GPU acceleration or uses CPU processing.AE / PR

Other

ControlWhat it doesHost
InfoOpens plugin information including version, licensing, and device state.AE / PR
DocumentationOpens the SPBokeh documentation in your default web browser.AE / PR