图像分区 · 外边界羽化与核心保护

Feathering a mask sounds like the most boring operation in image editing, so here's the thing this node does that most feather nodes don't: it feathers the outer boundary of your selection outward into the source image, while keeping every pixel inside the selection at full strength. That's the difference between a mask that blends seamlessly and a mask that shrinks your edit area or softens its core. RegionEditProtectedOuterBoundaryFeather is the pack's careful, over-engineered version of that idea - and yes, it has sixteen-plus parameters. Don't panic; the defaults are designed to be usable.

The mechanism, from the source: a narrow outward-only ramp is added just outside your selection. Every pixel inside the corrected_mask keeps its existing alpha, and the surrounding source image gets a short smooth transition into it. That way you never erode the edit core - which is the classic feather mistake - and the seam blends into untouched pixels instead of cutting on the mask line. The mandatory_core_mask (whatever you must not lose, e.g. a face) and processing_support_mask (the editable window) define what's allowed to be feathered at all.

Required inputs are the geometry: corrected_mask, mandatory_core_mask, processing_support_mask, a selection (the pack's FACE_LOCAL_SELECTION type from the face/region selection nodes), and x, y, width, height for the crop. That's a lot of wires, but they're all things you already have by the time you're feathering.

The optional knobs, decoded. axis_feather_profile is the one that matters most: long_edge_10_short_edge_5 (feather by crop edges), long_axis_10_short_axis_5 (the default, feather by the long/short axis of the face), manual_per_side, or legacy_uniform_10. The axis-based profiles are smarter than uniform feathering because faces aren't square - the top of the head and the chin want different ramp distances. feather_width_mode switches between crop_short_side_ratio (feather width as a fraction of the crop, default) and fixed_pixels. Then come the raw numbers: outer_feather_crop_ratio (default 0.1), the four per-side multipliers, and a pile of *_feather_percent / *_adjustment_percent values for fine manual control.

Outputs: final_feathered_mask (what you wire forward), outer_boundary_feather_ramp (the ramp mask by itself, for inspection or debugging), and report_json.

Honest advice: treat this as a "run it on defaults, then touch one knob" node. The defaults - axis-based profile, crop-ratio width, 0.1 outer ratio - are tuned for face crops. Reach for the manual per-side controls only when the seam problem is asymmetric (hair on top blending worse than the chin, say), which is exactly what the per-side adjustment percentages exist for.

Install: ComfyUI Manager → Region Edit Toolkit (native-region-tile-planner-merge), or git clone https://github.com/Liu-Bot24/ComfyUI-Region-Edit-Toolkit.git into custom_nodes, pip-install requirements.txt into ComfyUI's real Python, restart.

Two traps. First, don't crank the outer ratio to the max (0.3) and wonder why the edit bleeds - the ramp is outward, so too much feather means the source visibly leaks into the edit zone at the edges. Second, this node expects its four inputs to describe the same crop; feed it mismatched geometry and the seams it produces will be in the wrong place. The pack is too new for community tuning threads, so let the outer_boundary_feather_ramp output be your teacher - it shows you exactly what the ramp looks like before you commit.