ComfyUI Node
Atlas Occlusion Mask 🕳
A ComfyUI node in Atlas/04 · Masks with 19 inputs and 2 outputs.
Atlas Occlusion Mask 🕳
- solve
- target_image
- primary_depth
- occlusion_mask
- coverage_mask
◄patch_azimuth_viewfront-right quarter view►
◄patch_elevation_vieweye-level shot►
◄patch_distancemedium shot►
◄source_azimuth_viewfront view►
◄source_elevation_vieweye-level shot►
◄flip_azimuthfalse►
◄depth_modeldepth-anything/Depth-Anything-V2-Metric-Outdoor-Large-hf►
◄deviceauto►
◄angle_threshold90►
◄dilate_px0►
◄soft_edge_px0►
◄power1.0►
◄occlusion_modesimple►
◄depth_bias0.05►
◄patch_view_override—►
◄exact_view_override—►
CategoryAtlas/04 · Masks
Inputs (19)
| Name | Type | Default | Description |
|---|---|---|---|
| solve | ATLAS_SOLVE | — | |
| target_image | IMAGE | — | |
| patch_azimuth_viewopt | COMBO | front-right quarter view | The LoRA azimuth target_image was generated at — should match whatever you'll later pass to AtlasAddPatchView for this image. |
| patch_elevation_viewopt | COMBO | eye-level shot | The LoRA elevation target_image was generated at. |
| patch_distanceopt | COMBO | medium shot | The LoRA distance target_image was generated at. |
| source_azimuth_viewopt | COMBO | front view | Which view your SOURCE photo already is, in the LoRA's absolute frame. Must match the value you'll use in AtlasAddPatchView. |
| source_elevation_viewopt | COMBO | eye-level shot | Elevation of the SOURCE photo in the LoRA's frame. |
| flip_azimuthopt | BOOLEAN | false | Must match the AtlasAddPatchView setting for this patch. |
| depth_modelopt | COMBO | depth-anything/Depth-Anything-V2-Metric-Outdoor-Large-hf | 10 options: depth-anything/Depth-Anything-V2-Metric-Outdoor-Large-hf, depth-anything/Depth-Anything-V2-Metric-Indoor-Large-hf, depth-anything/DA3METRIC-LARGE, depth-anything/DA3MONO-LARGE, depth-anything/DA3NESTED-GIANT-LARGE-1.1, Ruicheng/moge-2-vitl-normal, +4 |
| deviceopt | COMBO | auto | 4 options: auto, cuda, mps, cpu |
| angle_thresholdopt | FLOAT | 900–90 | Facing-angle gate in degrees for the PRIMARY camera's coverage. 90 (default) = only frustum/behind-camera/out-of-frame failures are masked. Lower values also mask surfaces too grazing to the primary. |
| dilate_pxopt | INT | 00–200 | Expand the white (missing) mask region by this many pixels. |
| soft_edge_pxopt | INT | 00–200 | Blur the dilated mask edge by this many pixels, for compositing. |
| poweropt | FLOAT | 1.00.1–8 | Gamma remap after blur; > 1 makes the patch contribution more solid near the feathered edge. |
| occlusion_modeopt | COMBO | simple | simple = Phase-1 frustum/frame/facing tests only (unchanged). depth_shadow = additionally detect surfaces hidden behind NEARER geometry from the primary's view (true MPTK camera-as-light shadow test, using primary_depth as the shadow map). Falls back to simple when primary_depth isn't connected. |
| primary_depthopt | ATLAS_DEPTH_MAP | AtlasDepthMap run on the PRIMARY/source photo — the shadow map for depth_shadow mode. Wire the same shared AtlasDepthMap the derive nodes already use. | |
| depth_biasopt | FLOAT | 0.050–1 | depth_shadow only: relative depth tolerance before a point counts as shadowed — guards against monocular depth-precision false positives. 0.05 = must be 5% farther than the stored depth. |
| patch_view_overrideopt | STRING | Optional: wire AtlasBlockoutViewport's patch_prompt output here — overrides the three patch_* dropdowns with 📐 Extract Angle's snapped views, keeping this mask aligned with the same AtlasAddPatchView wiring. Errors loudly if unparseable. | |
| exact_view_overrideopt | STRING | Optional: wire AtlasBlockoutViewport's patch_exact output here (📐's RAW orbit floats) — wins over patch_view_override and the dropdowns, flip_azimuth ignored, placing this mask's target camera IDENTICALLY to an AtlasAddPatchView driven by the same string (the shared never-drift contract). Errors loudly if unparseable. |
Outputs (2)
| Name | Type | Description |
|---|---|---|
| occlusion_mask | MASK | — |
| coverage_mask | MASK | — |