Atlas Planar Hole Patch ◩

When you derive a relief mesh from a photo, you get holes - the spots an occluder hid from the camera, where the mesh has no data. The naive fix is to just let the mesh sink or smear there. Atlas Planar Hole Patch is the considered fix: it fits conservative local planes into the holes, using the valid geometry that already surrounds them. It's the ◩ in Atlas/06 · Patch & Repair, and it's the first chapter of the pack's repair story.

"Conservative" is doing a lot of work there. This node does not invent surfaces from nothing - it recovers the relief mesh's image-space lattice, groups the missing quads into enclosed components, finds a cluster of agreeing normals around each island, averages them into one patch plane, and generates the patch interior on exact camera rays. Accepted patches reuse the perimeter indices, so they become part of the relief mesh with projective UVs - not separate wall/box primitives floating in the scene.

How it works

The gate structure is the real design. Every hole island has to clear a stack of tests before it's filled:

• enclosed_only (default on) - reject components touching the image frame. The doctrine: frame and sky openings are not occlusion holes, they're clean-plate/background-layer territory.
• normal_tolerance_deg - max boundary-normal spread; lower is safer at corners, higher accepts rougher/curved surfaces.
• max_plane_error_m - max 95th-percentile residual for the densest plane-position band among the agreeing normals. This is the "does the plane actually fit" check.
• min_normal_support_fraction - the share of surrounding valid normals that must agree on one plane angle; lower lets you do one-sided facade repairs.
• max_hole_fraction - largest accepted component as a fraction of relief grid cells, which keeps big sky/background gaps out of the fill path.
• max_patch_edge_factor / max_patch_depth_factor - reject grazing ray spikes and forward/backward Z needles that would produce spikes or floating patches.

Rejected islands pass through unchanged - the docstring's word is that ambiguous multi-surface boundaries "pass through for a clean plate or hidden-geometry layer to handle." This node is honest about what it won't touch.

Inputs and outputs

Required: solve. Optional: hole_mask (leave unwired to treat every hole in the target layers as a candidate - what you want for a whole-solve sweep; the gates still bound what gets filled), layer (blank = primary relief; a name = that layer; * = every relief mesh, chaining one pass per layer), and the gate inputs above.

Outputs: solve (patches added), remaining_holes, report, and created_islands (a mask of what it actually filled).

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

Run order matters: this node goes before AtlasRetopologizeLayer, so retopology sees the relief plus accepted patches as one mesh. Run it after and the retopo ignores your patches.

If holes aren't being filled, read the report before loosening the gates - most likely they're frame-touching (flip enclosed_only only if you genuinely want frame-edge fills) or too large for max_hole_fraction. And remember this node fills closed holes; the open-tear leftovers are AtlasPathGuidedHoleRepair's job, feeding a second pass with relaxed settings.