Create distance-aware background or foreground blur from an optional depth map, or estimate depth locally from the source image.
Where: Flowgen → Add → Image & Vector → Adjust → Depth Blur
Key ideas
- Depth Blur is one graph step: Create distance-aware background or foreground blur from an optional depth map, or estimate depth locally from the source image.
- Typed sockets: Inputs: Image / image_in — the image to blur.; Depth / mask_in — optional grayscale depth map.. Outputs: Image Output / image_out — the depth-aware blurred image.. Settings stay on the node rather than masquerading as extra wires.
- Card and Properties agree: The compact card and selected-node Properties sidebar expose the same persisted controls: Focus: 0–100, default 78; 100 is near and 0 far.; Focus Range: 0–100, default 18.; Blur Radius: 0–120 px, default 34.; Near Blur: 0–100, default 100.; Invert Depth.; Show Focus Map.; Advanced: blades 0–8, rotation 0–180°, highlights/threshold 0–100..
- Execution behavior: This browser-local pure operation previews automatically after a short pause while a control changes, then overwrites one durable result file after the value settles. Deselecting the card or starting a downstream flow flushes the pending save. A terminal error exposes Retry; there is no normal Run button.
- Cost and privacy boundary: It calls no generation provider and charges no Sparks/Flowies. Processing happens in the open browser, so it cannot execute in a headless/server-only flow and the source must be readable by the page.
- Depth Fog / Blur card: PureOpNode uses the authored shared-card path. Blur an image by distance using a connected or locally estimated depth map.
- Properties sidebar: Card-owned operation controls; common properties shell
- Opened surfaces: Live image preview; focus-map preview
- Click to set Focus: Pick focus resolves the same cached wired or locally estimated depth map used by the blur, displays it over the actual fitted picture, samples a noise-resistant neighborhood, and writes the clicked plane to Focus.
Steps
- Connect the image and optionally a Depth Map output.
- Set Focus on the desired plane.
- Increase/decrease Focus Range for the sharp band.
- Tune Blur Radius and Near Blur.
- Use Show Focus Map to diagnose the selection, then turn it off.
- Shape lens highlights in Advanced and connect the result.
- Click Pick focus, wait for the depth surface, then click the subject that should remain sharp.
Inputs
- Image / image_in — the image to blur.
- Depth / mask_in — optional grayscale depth map.
Outputs
- Image Output / image_out — the depth-aware blurred image.
Controls
- Focus: 0–100, default 78; 100 is near and 0 far.
- Focus Range: 0–100, default 18.
- Blur Radius: 0–120 px, default 34.
- Near Blur: 0–100, default 100.
- Invert Depth.
- Show Focus Map.
- Advanced: blades 0–8, rotation 0–180°, highlights/threshold 0–100.
Important behavior
- Without Depth, the node estimates a map locally with Depth Anything V2.
- With Depth connected, that map drives focus directly.
- Show Focus Map visualizes the in-focus band instead of the finished photograph, which is useful for tuning.
MCP authoring
- Create with create_node { type: "depthBlur" }.
- Connect exact handles with connect_nodes when the node has more than one input or output.
- Use set_props with the complete opParams bag and let the open Flowgen client preview/save it; there is no normal run_node step.
Depth Fog / Blur controls and presets
- Add path: Flowgen → Add → Image & Vector → Adjust → Depth Fog / Blur.
- Card: PureOpNode.
- Properties: Card-owned operation controls; common properties shell.
- Controls: Focus; Range; Radius; Near Blur; Invert Depth; Show Focus Map.
- Opened surfaces: Live image preview; focus-map preview.
Picker accuracy
The picker samples a 5 x 5 median around the click and respects Invert, avoiding a single noisy edge pixel or the opposite depth orientation. The first local estimate can download the approximately 47 MB model; later slider/picker work reuses the cached map.
Tips
- Test the operation on one representative asset before placing it inside a List iteration.
- Keep the untouched source upstream so the operation can be changed or bypassed later.
- Judge edges and color at the intended delivery size as well as at full preview size.
Limitations and important notes
- Estimated monocular depth can be wrong around reflections, transparency, fine hair, or ambiguous scale.
- This simulates optical blur after capture; it does not recover missing depth or detail.
Troubleshooting
The foreground and background are reversed
Toggle Invert Depth, then retune Focus.
FAQ
Does this open the full Image Editor?
No. This is a focused Flowgen node. Use Image Editor when you need layers, selections, paint, paths, or several edits in one document.
Can I use it in a List iteration?
Yes. Wire the current row field into the typed input, collect the exact output handle, and test one row before scaling the run.