SAMLoader (Pipe) 노드: ComfyUI SAM 체크포인트 로더(samLoaderForDetailerFix)

SAMLoader (Pipe)는 Detailer Fix 워크플로에서 사용되는 감지 힌트 및 마스크 처리 옵션과 함께 SAM(Segment Anything Model) 체크포인트를 번들로 제공합니다. 일반 SAM 로더의 파이프 대응 버전으로, 원시 SAM 모델을 노출하는 대신 모델과 분할 설정을 모두 담은 PIPE_LINE을 생성합니다. 따라서 후속 EasyUse Detailer Fix 노드에서 일관된 SAM 기반 리파인먼트를 적용할 수 있습니다.

입력

model_name

로드할 SAM 체크포인트를 선택합니다. 드롭다운에는 ComfyUI 모델 디렉터리의 사용 가능한 SAM 체크포인트가 나열됩니다.

device_mode

SAM 추론에 사용할 디바이스를 선택합니다. AUTO는 ComfyUI가 디바이스를 자동으로 선택하고, Prefer GPU는 사용 가능한 경우 GPU를 사용하고 그렇지 않으면 CPU로 폴백하며, CPU는 CPU 실행을 강제합니다. VRAM이 낮은 시스템에서는 메모리 부담을 줄이기 위해 CPU를 사용하세요.

sam_detection_hint

SAM이 실행되기 전에 기존 마스크 또는 감지 결과에서 생성되는 힌트의 종류를 제어합니다. 옵션:

• center-1: 중앙에 단일 포인트를 사용합니다.
• horizontal-2: 수평선을 따라 두 개의 포인트를 사용합니다.
• vertical-2: 수직선을 따라 두 개의 포인트를 사용합니다.
• rect-4: 사각형 모서리 네 개의 포인트를 사용합니다.
• diamond-4: 다이아몬드 모서리 네 개의 포인트를 사용합니다.
• mask-area: 마스크 영역 자체를 힌트로 사용합니다.
• mask-points: 마스크에서 샘플링된 포인트를 사용합니다.
• mask-point-bbox: 마스크에서 샘플링된 포인트와 바운딩 박스를 함께 사용합니다.
• none: 포인트/마스크 힌트를 비활성화합니다. SAM은 바운딩 박스 프롬프트를 사용합니다.

sam_dilation

SAM 감지에 사용되는 마스크에 적용되는 팽창 값(픽셀 단위)입니다. 양수 값은 마스크를 확장하고 음수 값은 마스크를 침식하거나 축소합니다. 양수 팽창을 사용하여 주변 컨텍스트를 추가하거나 음수 팽창을 사용하여 느슨한 마스크 가장자리를 조이세요.

sam_threshold

SAM 예측 마스크를 이진 마스크로 변환할 때 적용되는 0~1 범위의 임계값(기본값 0.93)입니다. 값이 높을수록 가장 강한 SAM 예측만 유지하고, 값이 낮을수록 더 넓은 영역을 허용합니다.

sam_bbox_expansion

감지된 바운딩 박스를 SAM에 전달하기 전에 확장할 픽셀 수입니다. 값이 클수록 SAM에 더 많은 주변 컨텍스트를 제공하며, 0이면 감지된 박스가 변경되지 않습니다.

sam_mask_hint_threshold

마스크 힌트가 활성화된 경우 사용되는 0~1 범위의 임계값(기본값 0.7)입니다. 이 값 이상의 픽셀은 마스크 힌트의 전경으로 처리됩니다. 값이 낮을수록 생성된 힌트 마스크가 더 많이 포함됩니다.

sam_mask_hint_use_negative

SAM에 네거티브 마스크/포인트 힌트를 제공할지 여부와 방법을 제어합니다:

• False: 네거티브 힌트를 제공하지 않습니다.
• Small: 대상 주변에 작은 네거티브 힌트 영역을 제공합니다.
• Outter: 대상 외부의 바깥 영역에 네거티브 힌트를 제공합니다.

Outter 철자는 노드의 옵션 목록에서 유지된 표기입니다.

출력

PIPE_LINE

로드된 SAM 모델과 구성된 감지 힌트, 팽창, 임계값, 바운딩 박스 확장, 마스크 힌트 임계값 및 네거티브 힌트 설정을 포함하는 파이프라인입니다. 이 파이프를 PIPE_LINE 입력을 받는 Detailer Fix 노드에 전달하세요. 원시 SAM_MODEL 출력이 아니므로 일반 SAM 모델을 기대하는 노드에 직접 연결할 수 없습니다.

사용 참고 사항

• 기본 설정은 일반적인 Detailer Fix 리파인먼트에 맞게 조정되어 있습니다: AUTO 디바이스, center-1 힌트, 팽창 없음, 0.93 임계값, 바운딩 박스 확장 없음, 0.7 마스크 힌트 임계값, 네거티브 힌트 없음.
• SAM 마스크가 얇거나 작은 구조를 놓치는 경우 sam_threshold를 낮추거나 작은 양수 sam_dilation을 추가하세요.
• 마스크가 배경으로 번지는 경우 sam_threshold를 높이거나 음수 sam_dilation을 적용하거나 sam_mask_hint_use_negative를 Small 또는 Outter로 설정하세요.
• sam_bbox_expansion은 감지된 박스가 피사체를 잘라낼 때 유용합니다. 박스를 확장하면 SAM이 마스크를 리파인하기 전에 객체 경계를 더 많이 볼 수 있습니다.