Site navigation

Depth Blur and Depth Masks

Use one reusable relative DepthMap for focus blur, range masks, and localized edits while keeping the source image editable.

Generate a DepthMap

  1. Select an image-filled shape and open Depth Blur in the Inspector.
  2. Choose Enable Depth Blur to download the optional local model, then choose Generate Depth Map.
  3. Turn on Preview Depth to inspect the near-to-far field. Use Pick Focus to sample a focal depth from that preview.

Adjust and save the effect

Tune blur amount, focal distance, and transition range. Saving creates a depthBlureffect that references the document's DepthMap resource. It does not replace the image with a blurred bitmap, so the same map can later drive additional depth-aware effects. The Inspector preview and saved replay use the same canonical depth-aware compositor.

Use the same map as a mask

Open Adjustments → Depth Mask on the image, or select an Adjustment Layer and choose its source image. Pick a generated map, reuse a saved map, or import Varve's self-describing .vdepth.json resource. The contained preview, valid-sample histogram, legend, and Sample near/Sample far controls make the map's orientation visible before you edit the range.

Set numeric near/far endpoints and separate depth-domain transitions. ChooseReplace, Intersect, Add / union, orSubtract when a raster mask already exists, then chooseApply depth mask. This does not enable blur or change source pixels. The resulting mask stays in the existing Mask surface, where the Refine Mask brush can add, subtract, and protect coverage without rerunning inference.

Revisit, remove, and work offline

The accepted map, range recipe, and resolved mask coverage are saved separately from the blur effect. Changing a range is a lightweight edit; it does not rerun the model. RemovingDepth Blur leaves a map that is still referenced by a mask. Reopening, refining, and exporting an accepted mask work without the model being installed. UseRegenerate Depth Map only when the source image or estimate needs to change.

Persistence and invalidation

A persisted map records its dimensions, normalized near/far convention, model and preprocessing provenance, source asset hash, and a versioned 16-bit scalar payload. Rendering only needs the stored resource; model inference is needed only to create or regenerate it. If the source asset changes, Varve marks the saved map stale and asks you to regenerate it.

Limitations

Generated depth is relative, not metric, and is a guide for image effects rather than a measurement or 3D reconstruction. Transparent objects, reflections, hair, wires, thin structures, and severe occlusion may need manual coverage refinement or a separate matte. The current scalar import is Varve's validated .vdepth.json profile; arbitrary grayscale PNG, EXR, HEIC, and camera-depth metadata are not silently treated as depth. Missing or corrupt maps fail soft and preserve the last resolved coverage where available.

Read the depth-aware effects overview →

Search Varve