RESOLVE FX · OPTICAL DEFOCUS

Lens Blur.

Blur is not the whole look.
The aperture writes the signature.

Lens Blur turns defocus into a design decision: choose the aperture source, build the footprint, shape the light response, then decide how much of that optical model belongs in the shot. It looks convincing only when geometry and depth logic are treated separately.

01 / SHAPE

Shape Type + Aperture

02 / CHARACTER

Size + Optical Controls

03 / FINISH

Quality + Alpha + Blend

In the lab, switch between Hexagon and Triangle, then stretch Anamorphism. Keep Blur Size unchanged. You will see why aperture footprint and blur amount are different creative decisions.

APERTURE FOOTPRINT / LIVE LAB
INPUTAPERTURE MODEL
Optical character in the teaching model

This lab focuses on the Real Apertures idea. Creative and External Input are covered in the article and node graph because their exact shapes depend on the selected preset or supplied source image.

SVG · recalculated on change

Independent teaching visualization, not a Resolve renderer. Blur Size is a normalized demo scale, aperture rounding is geometric, and Chroma Shift / Highlights / Apodization / Catadioptric are illustrative mappings. Use the actual screenshots below for Resolve control names and the installed Resolve build for final behavior.

COLOR / RESOLVE FX BLUR

Actual Resolve captures + an explicitly independent aperture teaching model.

14 visible controls · + External Input crop · 7 captures · 4 exercises

01THE APERTURE MODEL

A bright point becomes a footprint. The footprint becomes the visual language of defocus.

Lens Blur is not merely “more blur.” Its identity comes from the shape that redistributes light, the optical modifiers applied to that shape, and the region of the image allowed to receive it.

A point becomes an aperture footprint

Lens Blur is better understood not as a prettier Gaussian but as energy from a point being redistributed through a virtual aperture footprint. That is why a small bright source can become readable polygonal or creative bokeh. Shape Type and Aperture Shape establish the footprint, while Blur Size sets its scale.

Optical character is a separate decision layer

Blade Curvature and Rotation reshape the iris, Anamorphism changes its aspect ratio, Chroma Shift introduces color separation, and Highlights, Apodization, and Catadioptric alter how light energy reads inside defocus. None of these controls replaces a correctly chosen Blur Size or creates scene depth by itself.

Lens Blur does not know what is near or far

The effect can look like optical defocus, but it has no built-in scene depth map. If the background must defocus more than the foreground, build a matte/depth isolation first or use CineFocus. Otherwise the expensive bokeh character is applied uniformly to the node region.

Current control behavior and Shape Type modes: Blackmagic Design · Resolve 21.1 support ↗ · Resolve 21 · Blur FX chapter ↗

02THE ACTUAL INSPECTOR

Read the panel as five decisions: source, speed, geometry, light response, and final mix.

The screenshots are actual Lens Blur interface captures from the project archive. The main capture is in Real apertures mode. Captured values describe those frames only and are not declared defaults or recommended settings.

Shape

Choose the aperture-shape source first; style the bokeh after that.

Shape Type

Selects one of three shape sources: Real Apertures, Creative, or External Input. Real Apertures uses realistic polygonal iris shapes; Creative exposes decorative shapes; External Input takes an arbitrary white-on-black shape from an additional RGB input on Lens Blur.

CheckDo not start with Chroma Shift or Catadioptric before choosing the correct Shape Type: changing mode affects both appearance and which controls are available.

Aperture Shape

With Real Apertures, selects Triangle, Square, Pentagon, Hexagon, Heptagon, or Octagon. Creative exposes a different set: Heart, Star, Starfish, Starburst, Petals, Lip, Eye, Droplet, and Leaf. Shape defines the bokeh silhouette, not its amount.

CheckCompare shapes on small bright point sources. On a flat wall or skin, the difference can remain subtle even at a large Blur Size.

Preview Shape

Displays the selected aperture shape so it can be inspected independently from the picture. It is a diagnostic preview, not another blur model or a final render mode.

CheckUse Preview Shape to verify geometry, then return to the actual shot: a pleasing iris on its own does not guarantee believable bokeh.

Speed Options

Quality trades speed for fidelity, Blur Alpha governs transparency, and External Input adds shape cropping.

Quality

The menu contains Full, Half (Faster), and Quarter (Fast). This is a quality/performance trade-off for Lens Blur: reserve Full for final judgement of complex bokeh and fine edges, while the faster modes are useful during interactive setup on heavy shots.

CheckDo not judge final quality from Quarter alone. Return to Full before delivery and re-check small highlights, hair edges, and textured masks.

Blur Alpha

Includes the alpha channel in Lens Blur processing. On ordinary opaque footage the difference may be invisible, but on keyed graphics, titles, and composited elements this checkbox determines whether the matte receives the same optical softness as RGB.

CheckIf RGB is soft while the matte edge remains hard or halos, compare Blur Alpha states and inspect premultiplication across the composite.

Horizontal and Vertical Crop

Conditional controls for External Input. They crop unused black area around the shape image so Lens Blur has less source area to process. Until the crop reaches the white shape itself, the intended bokeh geometry should remain unchanged.

When visibleCrop is an input-shape optimization, not an artistic scale control. Once the crop cuts into the white shape, you are changing the aperture rather than merely speeding processing.

Controls · Geometry

Blur Size sets scale; Blade Curvature, Rotation, and Anamorphism shape the footprint.

Blur Size

The primary defocus scale. Increasing it enlarges the bokeh footprint and makes aperture shape easier to read on point highlights. The page screenshot shows 4.00 as one captured panel state, not a recommended default.

CheckLarge Blur Size quickly exposes masks, edge contamination, and missing depth separation. Establish believable scale first, then add optical styling.

Blade Curvature

Rounds the edges of the selected aperture shape in Real and Creative modes. Lower values keep a harder polygonal character; increasing the control produces rounder bokeh. It changes silhouette rather than blur amount.

CheckJudge it on bokeh discs, not general facial softness. If the blades are not visible, Blur Size or the highlights may simply be too small to reveal them.

Rotation

Rotates the aperture shape. It matters little on near-circular bokeh but can significantly change the orientation of Triangle, Square, Star, or any other asymmetric shape.

CheckRotation does not create motion and is not a substitute for Directional Blur. It only rotates virtual-iris geometry.

Anamorphism

Changes the Lens Blur aspect ratio, stretching bokeh along one axis for an anamorphic-like character. It is an optical footprint aspect ratio, not a one-direction motion streak.

CheckMatch the stretch to the rest of the shot’s lens language. Strong arbitrary Anamorphism on spherical source optics often reads as a post effect.

Controls · Light response

These controls change how light reads inside defocus, and they are especially easy to overdo.

Chroma Shift

Adds chromatic-aberration-like color separation inside the blur. It is not a calibrated model of a specific lens; it is a stylistic optical control that becomes more visible on high-contrast bokeh edges.

CheckInspect white highlights and skin. If the colored fringe becomes the first thing the eye notices, Chroma Shift is already stronger than the optical idea.

Highlights

Changes how bright areas contribute to Lens Blur and is most visible on practical lights, reflections, and specular points. It can make luminous bokeh more expressive, but it does not replace correct source exposure.

CheckWatch clipping and halos. Strong Highlights on already clipped sources can quickly turn optical bokeh into glowing blobs.

Apodization

With Real and Creative apertures, changes the energy distribution inside bokeh. Negative values emphasize ring/diffraction-like structure, while positive values progressively filter the edges for smoother bokeh. It is not a generic edge blur.

CheckEvaluate several highlights at different sizes. One attractive ring on a test light can become distracting texture across hundreds of tiny points in a real shot.

Catadioptric

Simulates catadioptric or mirror-lens character and, as it increases, can reintroduce more readable source structure while the image remains distorted through the bokeh shape. It is a specialized look, not a general Lens Blur sharpening control.

CheckFor ordinary photographic defocus, start at zero. High Catadioptric values can create double or ring-like overlays that immediately read as a specific mirror-lens effect.

Global Blend

Blend doses an already-built optical model; it does not repair wrong geometry.

Blend

The final dry/wet between the calculated Lens Blur and the source. Lowering Blend restores some sharp source, but it does not reduce Blur Size, reshape the aperture, or undo an excessive Chroma Shift inside the processed component.

CheckBuild believable blur at 1.000 first, then reduce it. If Blend is used to hide a bad matte or artificial bokeh, the underlying problem remains inside the effect.

03THREE APERTURE SOURCES

Shape Type changes more than the silhouette: it changes the workflow and available controls.

The current reference manual documents Real Apertures, Creative, and External Input as distinct paths. Treat them as three ways of sourcing the blur footprint, not as quality levels.

01

Real Apertures

Triangle · Square · Pentagon · Hexagon · Heptagon · Octagon

A set of polygonal iris shapes suited to photographic bokeh. Blade Curvature lets you move from obvious straight blades toward a rounder footprint.

Optical baseline

02

Creative

Heart · Star · Starfish · Starburst · Petals · Lip · Eye · Droplet · Leaf

Models the idea of a custom aperture card in front of a lens. It is deliberately decorative: use it when bokeh shape is part of the design, not when trying to invisibly mimic normal optics.

Shaped bokeh

03

External Input

Second RGB input · White shape on black · Horizontal / Vertical Crop

Lets you use your own white-on-black aperture image. In the Color node graph, feed the shape into Lens Blur’s second RGB input; crop controls can remove unused black margins and reduce unnecessary processing.

Custom shape map

The actual Shape Type screenshot on this page confirms the three top-level modes. The Real apertures dropdown screenshot confirms Triangle, Square, Pentagon, Hexagon, Heptagon, and Octagon. Creative presets and External Input behavior are documented in the current Resolve 21 manual, because those states are not captured in this project’s screenshot set.

04BUILD THE OPTICAL CHAIN

One Lens Blur node should own one clear optical idea.

Keep the base grade separate, isolate the region only when needed, decide whether the aperture is built-in or external, and restore texture after strong defocus when the shot needs it.

COLOR / OPTICAL DEFOCUS CHAIN
Input → Balance → Lens Blur → Grain → Output. External Input can add a custom aperture map to Lens Blur.InputIMAGE SIGNAL01 · BalancePRIMARY CORRECTION02 · Lens BlurLENS / BUILT-IN SHAPE03 · GrainTEXTURE RESTOREOutputIMAGE SIGNAL
03 / 05

One node owns the optical defocus

Start with Real Apertures or Creative. Establish Blur Size and aperture geometry first, then add Anamorphism, Chroma Shift, Highlights, Apodization, or Catadioptric only when the shot needs that optical behavior.

Green lines show the image path. The gold dashed connection appears only in External Input mode and represents the custom shape map feeding Lens Blur’s second RGB input. If the blur is local, a tracked Window or matte belongs to the Lens Blur isolation stage even though it is not drawn as a separate serial node. This is a teaching diagram, not a Resolve screenshot.

Related Color workflow: node pipeline ↗ · Power Windows / Tracker ↗

05BUILD IT IN RESOLVE

Four exercises cover photographic, anamorphic, creative, and custom-aperture workflows.

These are teaching sequences, not magic slider values. The acceptance condition is what matters; exact numbers remain subordinate to the shot.

01

Background with believable polygonal bokeh

Create optical softness in the background while keeping the foreground subject sharp.

PreparePrepare a dedicated node with a tracked matte or depth isolation for the background. Choose a shot containing small practical lights or specular highlights.

  1. 01

    Choose Real Apertures and begin with Hexagon or Octagon, with Chroma Shift, Apodization, and Catadioptric at neutral settings.

  2. 02

    Raise Blur Size only until bokeh scale matches the intended depth and shot/lens context.

  3. 03

    Refine Blade Curvature and Rotation against real highlights rather than general image softness.

  4. 04

    Restore grain after defocus and inspect matte edges through motion at Full Quality.

Acceptance check

The foreground remains clearly sharp, bokeh exists only in the intended depth region, and the aperture shape reads on highlights without feeling like a pasted-on filter.

02

Anamorphic character for night practicals

Stretch bokeh along one axis without turning it into a motion streak.

PrepareUse a shot with point lights and source lens language that can plausibly support an anamorphic-like character.

  1. 01

    Establish Blur Size and Aperture Shape first with Anamorphism at 1.0.

  2. 02

    Adjust Anamorphism gradually and compare the aspect ratio of bokeh discs rather than general blur alone.

  3. 03

    If a subtle optical imperfection helps, add a small Chroma Shift only after geometry already feels believable.

  4. 04

    Verify that faces, titles, and neutral edges have not acquired accidental colored fringes.

Acceptance check

Bokeh stretches consistently with the shot’s optical idea without reading as directional motion blur, and chroma remains secondary.

03

Creative shape for music or advertising work

Make bokeh shape an intentional part of the graphic design.

PrepareChoose a shot where bright points are large enough to read and do not cover critical facial or product detail.

  1. 01

    Switch Shape Type to Creative and choose one shape, such as Star or Petals.

  2. 02

    Use Preview Shape only for orientation, then tune Rotation on the actual image.

  3. 03

    Keep Apodization and Highlights restrained so the shape reads through geometry rather than extra glow or ringing.

  4. 04

    Compare the result against a normal Real Aperture version; the creative shape should provide a deliberate advantage rather than novelty for its own sake.

Acceptance check

Creative bokeh is visible where it should be, without compromising readability of the main subject.

04

Custom aperture map through External Input

Use a branded or purpose-built shape instead of the built-in aperture list.

PreparePrepare a small white shape on black. Add it to the node graph as a separate source that can feed Lens Blur’s second RGB input.

  1. 01

    Set Shape Type to External Input and connect the shape source to Lens Blur’s second RGB input.

  2. 02

    Make sure the white shape is intact and surrounded by sufficient black padding.

  3. 03

    If the map is large, use Horizontal/Vertical Crop only to remove unused black margins without cutting into the white shape.

  4. 04

    Check the bokeh at several Blur Size values and in a short render; custom shapes can expose aliasing faster than standard irises.

Acceptance check

Lens Blur uses the custom silhouette, the node graph remains understandable, crop does not distort the shape, and performance has been checked on the real shot.

06CHOOSE THE RIGHT DEFOCUS MODEL

Neutral softness, shaped bokeh, depth-aware focus, and vector streaks solve different problems.

How neighboring Blur & Focus FX differ
FXWhat shapes the resultExplore it for
Gaussian Blur ↗Neutral softness without aperture geometry.Hide detail or soften backgrounds/graphics without stylized bokeh.
Lens BlurAperture-shaped footprint, optical modifiers, and custom shape input.When the defocus pattern and bokeh are part of the visual design.
AI CineFocus ↗AI depth map + virtual lens + focus distance/DoF.When defocus must vary with scene depth and a controllable focus plane.
Directional Blur ↗Blur constrained to an Angle with motion-like character.When you need a vector streak rather than an optical circle of confusion.

07READ THE FAILURE

Most Lens Blur failures reveal whether the problem is depth, footprint, light response, or performance.

01Bokeh looks good, but the whole frame is equally out of focus

The aperture controls are not the problem: Lens Blur does not build a depth map. Constrain it with a matte/depth branch or move to CineFocus when scene depth is required.

02Highlights have become huge artificial blobs

Reduce Blur Size and Highlights first. Then neutralize Chroma Shift, Apodization, and Catadioptric and reintroduce them one at a time.

03Bokeh edges have an unwanted colored fringe

Check Chroma Shift. If color separation belongs to the look, reduce it until it no longer competes with aperture shape or skin.

04Bokeh shows rings or a readable double overlay

Look at Apodization and Catadioptric. Return both toward neutral and decide which optical behavior the shot actually needs.

05External Input is connected, but the custom shape does not behave as expected

Verify Shape Type is External Input, the map is white on black, it feeds Lens Blur’s second RGB input, and crop controls have not cut into the white shape itself.

06Preview is smooth, but the final frame or matte edge looks worse

Make the final judgement at Full Quality, check Blur Alpha, and render a short sample at delivery resolution. Half/Quarter are speed tools, not a final quality certificate.

Performance

Lens Blur is heavier than a simple Gaussian, especially with large Blur Size, Full Quality, and complex shapes. During setup, use Half/Quarter, node cache, and a limited effect region; return to Full for final judgement.

Grain after defocus

Strong optical blur also blurs grain, which can make the background feel digitally sterile. In a typical pipeline, restore grain after Lens Blur so defocus and texture read as one photographic system.

Keyframes and rack defocus

Blur Size can be animated, but the change remains global within the node region. A real focus transition between depth planes requires animated matte/depth logic or CineFocus Focus Distance; Lens Blur alone is not enough.

08BEFORE YOU DELIVER

Certify the bokeh, the mask, and the render—not the slider positions.

A convincing setup in one still frame can fail in motion, on alpha edges, or when Full Quality is restored. Check the delivered image path end to end.

SELF-CHECK0 / 8

Your marks apply to this visit; nothing is sent to a server.

09COMMON CONFUSIONS

Separate aperture character from scene depth and Lens Blur becomes much easier to reason about.

Does Lens Blur create real depth of field?

It creates optical defocus character but does not understand scene depth. Different blur amounts across depth planes require matte/depth logic or AI CineFocus.

How do Real Apertures and Creative differ?

Real Apertures provides polygonal Triangle–Octagon iris shapes. Creative exposes decorative Heart, Star, Petals, and related shapes, similar to using a custom aperture card in front of a lens.

How does External Input work?

Prepare a white shape on black and feed it into Lens Blur’s second RGB input. After selecting External Input, the effect uses that map as the aperture footprint; crop controls help remove unused black margins.

Should Quality always remain at Full?

No. Half (Faster) and Quarter (Fast) are useful while tuning a heavy effect. Final decisions about bokeh, edges, and rendering should be rechecked at Full.

What does Apodization do?

In Real/Creative modes it changes energy distribution inside bokeh: the negative side emphasizes ring/diffraction-like structure, while positive values soften the footprint edges.

Is Catadioptric a sharpening control after blur?

No. It is a specialized mirror/catadioptric optical simulation that can restore more readable structure inside still-distorted bokeh. Treat it as a distinct lens look.

How is Lens Blur different from Gaussian Blur?

Gaussian is for neutral softness. Lens Blur adds aperture geometry, bokeh response, anamorphism, chroma, and custom aperture input, so it is useful when the defocus pattern itself matters.

Sources and the limits of this guide

Visible labels and captured states were checked against the seven actual Lens Blur screenshots in this project. The current Resolve 21.1 support entry is the version anchor; the Resolve 21 Blur FX manual text is used for controls that appear only in Creative or External Input modes, including the second RGB aperture input and conditional crop controls. The interactive lab is a separate teaching visualization.

The exercises were not live-certified through a Resolve render during this website update. Edition availability, small UI differences, exact optical response, and production performance should be verified in the installed build used for delivery.