SAMLoader (Pipe)(samLoaderForDetailerFix)

SAMLoader (Pipe) объединяет чекпойнт SAM (Segment Anything Model) с опциями подсказки детекции и обработки маски, используемыми в рабочих процессах Detailer Fix. Это pipe-совместимый аналог обычного загрузчика SAM: вместо предоставления сырой модели SAM он создаёт PIPE_LINE, который содержит как модель, так и настройки сегментации, поэтому последующие ноды EasyUse Detailer Fix могут применять согласованное SAM-уточнение.

Входы

model_name

Выберите чекпойнт SAM для загрузки. В раскрывающемся списке перечислены доступные чекпойнты SAM в вашем каталоге моделей ComfyUI.

device_mode

Выбирает устройство, используемое для вывода SAM. AUTO позволяет ComfyUI выбирать устройство автоматически, Prefer GPU использует GPU при наличии и переключается на CPU в противном случае, а CPU принудительно использует CPU. Используйте CPU на системах с небольшим объёмом VRAM, чтобы снизить нагрузку на память.

sam_detection_hint

Управляет типом подсказки, генерируемой из существующей маски или детекции до запуска SAM. Варианты:

• center-1: использовать одну точку в центре.
• horizontal-2: использовать две точки вдоль горизонтальной линии.
• vertical-2: использовать две точки вдоль вертикальной линии.
• rect-4: использовать четыре угловые точки прямоугольника.
• diamond-4: использовать четыре угловые точки ромба.
• mask-area: использовать саму область маски как подсказку.
• mask-points: использовать точки, выбранные из маски.
• mask-point-bbox: использовать точки, выбранные из маски, плюс границы (Bounding Box).
• none: отключить точечные и масочные подсказки; SAM полагается на подсказку с границами (Bounding Box).

sam_dilation

Дилатация, применяемая к маске для детекции SAM, в пикселях. Положительные значения расширяют маску; отрицательные значения сужают или уменьшают её. Используйте положительную дилатацию для добавления окружающего контекста или отрицательную, чтобы подтянуть расплывчатые края маски.

sam_threshold

Порог от 0 до 1 (по умолчанию 0.93), применяемый к маске предсказания SAM при преобразовании её в бинарную маску. Более высокие значения сохраняют только самые сильные предсказания SAM; более низкие значения включают большую область.

sam_bbox_expansion

Количество пикселей, на которое расширяются обнаруженные границы (Bounding Box) перед передачей в SAM. Большие значения дают SAM больше окружающего контекста; значение 0 оставляет обнаруженные границы без изменений.

sam_mask_hint_threshold

Порог от 0 до 1 (по умолчанию 0.7), используемый, когда активна подсказка маски. Пиксели выше этого значения считаются передним планом для подсказки маски. Более низкие значения включают большую часть сгенерированной маски-подсказки.

sam_mask_hint_use_negative

Управляет тем, предоставляются ли SAM негативные подсказки маски или точек и каким образом:

• False: не предоставлять негативные подсказки.
• Small: предоставить небольшую область негативной подсказки вокруг цели.
• Outter: предоставить негативные подсказки во внешней области за пределами цели.

Написание Outter сохранено из списка опций ноды.

Выходы

PIPE_LINE

Конвейер, содержащий загруженную модель SAM и настроенные параметры: подсказку детекции, дилатацию, порог, расширение границ (Bounding Box), порог подсказки маски и негативные подсказки. Передайте этот конвейер в ноду Detailer Fix, которая принимает PIPE_LINE на входе. Это не сырой выход 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 видеть больше границ объекта перед уточнением маски.