SAMLoader (Pipe)(samLoaderForDetailerFix)

SAMLoader (Pipe) empaqueta un checkpoint SAM (Segment Anything Model) con las opciones de sugerencia de detección y procesamiento de máscaras utilizadas por los flujos de trabajo Detailer Fix. Es la contraparte compatible con pipe de un cargador SAM simple: en lugar de exponer un modelo SAM sin procesar, produce un PIPE_LINE que transporta tanto el modelo como las configuraciones de segmentación, de modo que los nodos EasyUse Detailer Fix posteriores puedan aplicar un refinamiento consistente basado en SAM.

Entradas

model_name

Selecciona el checkpoint SAM a cargar. El menú desplegable lista los checkpoints SAM disponibles en tu directorio de modelos de ComfyUI.

device_mode

Selecciona el dispositivo utilizado para la inferencia SAM. AUTO permite que ComfyUI elija el dispositivo automáticamente, Prefer GPU usa la GPU cuando está disponible y recurre a la CPU en caso contrario, y CPU fuerza la ejecución en CPU. Usa CPU en sistemas con poca VRAM para reducir la presión sobre la memoria.

sam_detection_hint

Controla qué tipo de sugerencia se genera a partir de la máscara o detección existente antes de que SAM se ejecute. Opciones:

• center-1: usa un solo punto en el centro.
• horizontal-2: usa dos puntos a lo largo de una línea horizontal.
• vertical-2: usa dos puntos a lo largo de una línea vertical.
• rect-4: usa cuatro puntos de las esquinas del rectángulo.
• diamond-4: usa cuatro puntos de las esquinas del rombo.
• mask-area: usa el área de la máscara como sugerencia.
• mask-points: usa puntos muestreados de la máscara.
• mask-point-bbox: usa puntos muestreados de la máscara más una caja delimitadora.
• none: desactiva las sugerencias de puntos/máscara; SAM se basa en la indicación de la caja delimitadora.

sam_dilation

Dilatación aplicada a la máscara utilizada para la detección SAM, en píxeles. Los valores positivos expanden la máscara; los valores negativos la erosionan/encogen. Usa una dilatación positiva para añadir contexto circundante o una dilatación negativa para apretar los bordes flojos de la máscara.

sam_threshold

Umbral de 0 a 1 (por defecto 0.93) aplicado a la máscara de predicción SAM al convertirla en una máscara binaria. Los valores más altos conservan solo las predicciones SAM más fuertes; los valores más bajos aceptan más área.

sam_bbox_expansion

Número de píxeles en que se expande la caja delimitadora detectada antes de pasarla a SAM. Los valores más grandes dan a SAM más contexto circundante; 0 mantiene la caja detectada sin cambios.

sam_mask_hint_threshold

Umbral de 0 a 1 (por defecto 0.7) utilizado cuando una sugerencia de máscara está activa. Los píxeles por encima de este valor se tratan como primer plano para la sugerencia de máscara. Los valores más bajos incluyen más de la máscara de sugerencia generada.

sam_mask_hint_use_negative

Controla si se suministran sugerencias negativas de máscara/puntos a SAM y cómo:

• False: no suministrar sugerencias negativas.
• Small: suministrar un área pequeña de sugerencia negativa alrededor del objetivo.
• Outter: suministrar sugerencias negativas en la región exterior fuera del objetivo.

La escritura Outter se conserva de la lista de opciones del nodo.

Salidas

PIPE_LINE

Un pipeline que contiene el modelo SAM cargado y las configuraciones de sugerencia de detección, dilatación, umbral, expansión de caja, umbral de sugerencia de máscara y sugerencias negativas. Pasa este pipe a un nodo Detailer Fix que acepte una entrada PIPE_LINE. No es una salida SAM_MODEL sin procesar, por lo que no se puede conectar directamente a nodos que esperan un modelo SAM simple.

Notas de uso

• Las configuraciones predeterminadas están ajustadas para el refinamiento típico de Detailer Fix: dispositivo AUTO, sugerencia center-1, sin dilatación, umbral 0.93, sin expansión de caja, umbral de sugerencia de máscara 0.7 y sin sugerencias negativas.
• Si las máscaras SAM omiten estructuras finas o pequeñas, baja sam_threshold o añade una pequeña sam_dilation positiva.
• Si las máscaras se desbordan hacia el fondo, sube sam_threshold, aplica una sam_dilation negativa o establece sam_mask_hint_use_negative en Small o Outter.
• sam_bbox_expansion es útil cuando la caja detectada recorta el sujeto; expandirla permite que SAM vea más del contorno del objeto antes de refinar la máscara.