preMaskDetailerFix

preMaskDetailerFix는 기존 마스크로 정의된 영역에 디테일러 수정 샘플링 패스를 적용합니다. EasyUse/Fix 카테고리에 속하며 EasyUse pipeline에서 작동합니다. 감지기 기반 디테일러 수정 노드와 달리 객체 감지 모델이 필요하지 않습니다. 제공된 mask가 잘라내고 샘플링한 후 이미지로 다시 합성할 영역을 직접 정의합니다.

입력

필수

이름	형식	기본값	설명
`pipe`	`PIPE_LINE`	—	수정 패스에서 사용하는 모델, clip, VAE, 조건화, 잠재 데이터, 이미지 데이터를 포함하는 EasyUse pipeline입니다. 이 노드는 출력에서 업데이트된 pipeline을 반환합니다.
`mask`	`MASK`	—	수정할 영역을 정의하는 마스크입니다. 바운딩 박스/크롭 영역이 디테일러 샘플링 패스로 전달되는 영역을 결정합니다.
`guide_size`	`FLOAT`	—	샘플러로 전달되는 영역의 목표 크기입니다. 더 작은 영역은 샘플링 전에 이 크기로 upscale됩니다. 이 노드에는 기본값이 지정되어 있지 않습니다.
`guide_size_for`	`BOOLEAN`	`true`	`guide_size`가 바운딩 박스(`true`)에 적용할지, 확장 후 크롭 영역(`false`)에 적용할지를 제어합니다.
`max_size`	`FLOAT`	—	샘플링되는 크롭에 허용되는 최대 크기입니다. 더 큰 크롭은 샘플링 전에 이 제한으로 downscale됩니다. 이 노드에는 기본값이 지정되어 있지 않습니다.
`mask_mode`	`BOOLEAN`	`true`	활성화되면 제공된 `mask`가 디테일러의 작업 마스크로 사용됩니다. 비활성화되면 마스크는 무시됩니다.
`seed`	`INT`	`0`	샘플링에 사용되는 무작위 시드입니다.
`steps`	`INT`	`20`	디테일러 패스의 샘플링 단계 수입니다.
`cfg`	`FLOAT`	`8`	샘플링 중에 사용되는 CFG 스케일입니다.
`sampler_name`	`COMBO`	—	사용할 샘플러로, 사용 가능한 ComfyUI 샘플러 중에서 선택됩니다.
`scheduler`	`COMBO`	—	사용할 스케줄러로, 사용 가능한 ComfyUI 스케줄러 중에서 선택됩니다.
`denoise`	`FLOAT`	`0.5`	수정 패스의 denoise 강도입니다. 값이 낮을수록 원본 이미지가 더 많이 보존됩니다.
`feather`	`INT`	`5`	샘플링된 결과를 이미지에 다시 합성하기 전에 마스크 가장자리에 적용되는 페더 반경입니다.
`crop_factor`	`FLOAT`	`3`	마스크 또는 바운딩 박스 주변에 포함되는 컨텍스트의 양을 제어합니다. 샘플링 전에 크롭 영역이 이 요소만큼 확장됩니다.
`drop_size`	`INT`	—	마스크된 영역의 최소 크기 임계값입니다. 영역이 이 값보다 작으면 디테일러 수정이 건너뜁니다.
`refiner_ratio`	`FLOAT`	`0.2`	pipeline에 refiner 모델이 포함된 경우 해당 모델에 예약되는 단계의 비율입니다.
`batch_size`	`INT`	`1`	샘플링 배치당 생성되는 샘플 수입니다.
`cycle`	`INT`	`1`	디테일러 수정 사이클을 반복할 횟수입니다. 각 사이클은 이전 사이클의 출력을 사용합니다.

선택

이름	형식	기본값	설명
`optional_image`	`IMAGE`	—	제공되면 `pipe`에 저장된 이미지 대신 이 이미지가 사용됩니다. 생략하면 pipeline의 이미지가 사용됩니다.
`inpaint_model`	`BOOLEAN`	`false`	로드된 모델이 지원하는 경우 인페인팅 모델로 샘플링을 활성화합니다.
`noise_mask_feather`	`INT`	`20`	`inpaint_model`이 활성화될 때 노이즈 마스크에 적용되는 페더링입니다.

출력

이름	형식	설명
`pipe`	`PIPE_LINE`	디테일러 수정된 이미지와 잠재 데이터를 포함하는 업데이트된 EasyUse pipeline으로, 다운스트림 노드에서 사용할 준비가 완료된 상태입니다.

사용 메모

수리하려는 영역을 이미 알고 있을 때 이 노드를 사용하세요. 해당 영역에 대한 마스크를 그리거나 생성하고 mask에 전달하면 디테일러 패스가 해당 영역으로 제한됩니다.
mask_mode가 비활성화되면 마스크 입력이 무시됩니다. 이는 동작을 비교하거나 다른 pipeline 로직에 의존하려는 경우에 유용할 수 있습니다.
crop_factor는 샘플러가 보는 주변 컨텍스트의 양을 제어합니다. 값이 클수록 모델이 영역을 더 잘 이해할 수 있지만 크롭 크기와 처리 비용도 증가합니다.
denoise는 영역이 변경되는 강도를 제어합니다. 낮은 값은 작은 수정에 더 안전하며, 큰 재생성이 필요한 경우 높은 값이 필요합니다.
cycle은 수정을 반복적으로 실행합니다. 사이클이 많을수록 결과를 다듬을 수 있지만 처리 시간도 늘어납니다.
inpaint_model을 사용할 때는 mask_mode를 활성화된 상태로 유지하고 로드된 checkpoint 또는 모델이 인페인팅을 지원하는지 확인하세요. noise_mask_feather는 노이즈 마스크의 경계를 부드럽게 하여 눈에 보이는 이음새를 방지할 수 있습니다.
이 노드는 PIPE_LINE만 출력하므로 결과 이미지를 확인하거나 사용하려면 pipeline 출력 노드 또는 다른 EasyUse 노드에 연결하세요.

pre Mask Detailer Fix

입력

필수

선택

출력

사용 메모

댓글