Atlas Path-Guided Hole Repair 🎥

The atlas-camera repair story has two chapters. The first - AtlasPlanarHolePatch - fills holes in the relief mesh by fitting planes from surrounding geometry, which is great for enclosed holes that have real neighbours to lean on. But open tears, silhouettes, and the messy leftovers at the frame edge don't have that support. Atlas Path-Guided Hole Repair is the chapter-two node: it uses the camera path itself to find and select exactly which source-space holes matter, from the viewpoint you'll actually see them at. It's the 🎥 in Atlas/06 · Patch & Repair.

The trick is where the selection happens. Instead of trying to unproject brush strokes through geometry that doesn't exist, the node renders candidate planes with stable island IDs from a chosen frame of your camera path - the default being the last frame (frame_offset_from_end = 0). Because the IDs are stable, selecting them is deterministic: automatic modes pick visible fitted islands, or you paint on the render and the brush selects whole connected source islands.

How it works

It takes the remaining source-space holes from a first AtlasPlanarHolePatch pass, plus the authored camera path, and renders the scene from a chosen pose with each hole island carrying a stable ID. Then selection happens in rendered space:

• selection_mode = all_visible / smallest_visible / largest_visible - agent-style: automatically select every (or the smallest/largest) visible qualifying island at that angle.
• selection_mode = paint_overlap - you brush on the angle_preview render, and any island whose painted share clears paint_overlap_fraction gets its complete source-space component selected. No unprojecting through broken geometry.

The output repair_mask is exact source-space coverage of the selected islands - which the node tells you to wire into a second AtlasPlanarHolePatch with deliberately relaxed acceptance settings. First pass does the easy closed holes; this node finds the hard ones; the relaxed pass actually fills them.

Inputs and outputs

Required: solve, hole_mask (remaining holes from the first pass), camera_path. Key optional: path_frames (preview background only), paint_mask (for paint_overlap), exclude_mask (must match the mask you gave the mesh node, or it hunts for tears in geometry that was never built), layer, frame_offset_from_end, lens_scale_override (focal multiplier for the candidate render), resolution (long edge, default 768), selection_mode, max_selected_islands, min_visible_pixels, plus the plane-fit gates (ring_cells, normal_tolerance_deg, max_plane_error_m, max_hole_fraction, enclosed_only, min_normal_support_fraction).

Outputs: repair_mask, angle_preview, visible_islands, report.

Installing it

Core-tier node:

cd <ComfyUI>/custom_nodes
git clone https://github.com/mikejamesvfx/atlas-camera.git

Restart, find it in Atlas/06 · Patch & Repair (ComfyUI Manager: "atlas-camera").

Common issues

The exclude_mask contract is the trap. It's subtracted before connected components are found, separating open foreground tears from the exterior - and the tooltip says the report states its frame coverage so you can read the polarity back. Wire the same mask you gave the mesh node; if the two disagree, this node hunts for tears in geometry that was never built.

And remember the two-pass shape: this node selects, it doesn't fill. If you wire repair_mask into a AtlasPlanarHolePatch with the same strict settings as the first pass, the hard holes get rejected again and nothing happens. Relax the gates on the second pass - that's the design.