Nodes/atlas-camera/Atlas Crop ROI ✂️
ComfyUI Node

Atlas Crop ROI ✂️

A ComfyUI node in Atlas/advanced with 11 inputs and 6 outputs.

By mikejamesvfx·Created 2 months ago·Updated about 23 hours ago· 1
Atlas Crop ROI ✂️
  • solve
  • source_image
  • camera_path
  • exclude_mask
  • guide
  • mask
  • gen_width
  • gen_height
  • crop
  • report
roi_slot1
pad_frac0.10
snap64
hole_dilate_px4
max_gen_long_edge1280
roi_sourceartist
min_area_px1024
CategoryAtlas/advanced

Inputs (11)

NameTypeDefaultDescription
solveATLAS_SOLVE
source_imageIMAGE
camera_pathoptATLAS_CAMERA_PATHThe move; the crop renders its FINAL frame (whose holes are a superset of every earlier frame's). No path = the solved pose.
roi_slotoptINT11–3Which artist ▦ Fill ROI (budget 3). An unused slot emits an empty crop that every downstream node treats as a no-op.
pad_fracoptFLOAT0.100–0.5
snapoptINT648–128ROI grid snap (/64 covers every adapter).
hole_dilate_pxoptINT40–64
max_gen_long_edgeoptINT1280256–4096Generation raster cap; the crop is scaled down (aspect kept, /16) when its native long edge exceeds this.
roi_sourceoptCOMBOartistartist: the viewport's drawn Fill ROIs (the default; artist selection wins). auto_largest: survey the end frame's disocclusion holes and take the roi_slot-th LARGEST cluster — the holes the viewport wand cannot fix. Same clustering recipe as the CLI (survey_hole_rois), so the two cannot drift.
min_area_pxoptINT10241–1048576auto_largest only: clusters smaller than this (survey-resolution px) are ignored — the wand or a band layer handles those.
exclude_maskoptMASKauto_largest only: region already carried by something other than geometry (SkyDome, matte). Subtracted before clustering so a generator is never aimed at it. Auto mode ALSO always drops what the move did not reveal — holes whose ray at infinity lands on a hole in the plate (sky: nothing was ever occluding it) or outside the plate frame entirely (never looked at — that is outpainting). This input is for regions those geometric tests cannot know about.

Outputs (6)

NameTypeDescription
guideIMAGE
maskMASK
gen_widthINT
gen_heightINT
cropATLAS_CROP
reportSTRING