Easy Apply Inpaint: узел инпейтинга для ComfyUI-Easy-Use(applyInpaint)

Описание

Узел Easy Apply Inpaint (applyInpaint) применяет инпейтинг по маске к изображению, проводя EasyUse PIPE_LINE через граф. Он относится к категории EasyUse/Inpaint и возвращает обновлённый PIPE_LINE, поэтому предназначен для встраивания в конвейер EasyUse, а не для использования в качестве самостоятельного выходного узла.

Узел принимает входное изображение, маску и объект конвейера, после чего выполняет проход инпейтинга с использованием выбранного бэкенда и стратегии условия. Он предоставляет настройки для расширения маски, точности вычислений, планирования и необязательной обработки шумовой маски.

Входы

pipe

• Тип: PIPE_LINE (обязательно)
• Объект конвейера EasyUse, содержащий модель, VAE, условие, латентное представление и другое состояние рабочего процесса. Операция инпейтинга применяется в контексте этого конвейера, а обновлённый конвейер возвращается на выходе.

image

• Тип: IMAGE (обязательно)
• Изображение для инпейтинга. В большинстве рабочих процессов это оригинальное изображение, содержащее объект или область для изменения.

mask

• Тип: MASK (обязательно)
• Одноканальная маска, указывающая область для инпейтинга. Ненулевые области считаются зоной регенерации.

inpaint_mode

• Тип: КОМБО (обязательно)
• Варианты: normal, fooocus_inpaint, brushnet_random, brushnet_segmentation, powerpaint

Выбирает бэкенд или стратегию инпейтинга:

• normal: стандартное поведение инпейтинга.
• fooocus_inpaint: инпейтинг в стиле Fooocus.
• brushnet_random: инпейтинг BrushNet со случайным паттерном генерации.
• brushnet_segmentation: инпейтинг BrushNet на основе информации о сегментации.
• powerpaint: инпейтинг на основе PowerPaint, при котором селектор function становится полезным для разных типов задач.

encode

• Тип: КОМБО (обязательно, по умолчанию "none")
• Варианты: none, vae_encode_inpaint, inpaint_model_conditioning, different_diffusion

Управляет тем, как входное изображение и маска кодируются или преобразуются в условие для прохода инпейтинга:

• none: дополнительное кодирование, специфичное для инпейтинга, не применяется.
• vae_encode_inpaint: использует путь кодирования VAE, специализированный для инпейтинга.
• inpaint_model_conditioning: использует условие, предназначенное для моделей инпейтинга.
• different_diffusion: использует стратегию условия/вывода в стиле different-diffusion.

grow_mask_by

• Тип: INT (обязательно, по умолчанию 6, диапазон 0–64, шаг 1)
• Количество пикселей для расширения маски перед инпейтингом. Расширение маски помогает избежать резких краёв и даёт модели возможность вписать сгенерированное содержимое в окружающую область.

dtype

• Тип: КОМБО (обязательно)
• Варианты: float16, bfloat16, float32, float64
• Точность, используемая при вычислениях инпейтинга. float16 обычно самый быстрый вариант и потребляет меньше всего памяти; bfloat16 может быть предпочтителен на совместимом оборудовании; float32 и float64 повышают числовую точность в ущерб производительности.

fitting

• Тип: ПЛАВАЮЩИЙ (обязательно, по умолчанию 1, диапазон 0.3–1)
• Управляет степенью подгонки результата инпейтинга под выбранное поведение. 1 является стандартным значением полной подгонки; более низкие значения можно использовать для ослабления условия или получения более свободного результата.

function

• Тип: КОМБО (обязательно)
• Варианты: text guided, shape guided, object removal, context aware, image outpainting

Выбирает семантическое поведение операции инпейтинга, особенно для режимов, поддерживающих различные типы задач:

• text guided: генерация на основе текстового запроса.
• shape guided: генерация на основе информации о форме.
• object removal: удаление объекта и естественное заполнение области.
• context aware: заполнение замаскированной области с учётом контекста.
• image outpainting: расширение изображения за пределы существующих границ.

scale

• Тип: ПЛАВАЮЩИЙ (обязательно, по умолчанию 1, диапазон 0–10)
• Дополнительный множитель масштаба, применяемый к операции инпейтинга. 1 является нейтральным значением по умолчанию; более высокие значения усиливают масштаб, используемый моделью инпейтинга.

start_at / end_at

• Тип: INT (обязательно; start_at по умолчанию 0, end_at по умолчанию 10000, диапазон 0–10000)
• Определяют начало и конец диапазона выборки/очистки от шума, затрагиваемого операцией инпейтинга. Значение по умолчанию 0–10000 охватывает весь график. Ограничение этого диапазона может быть полезно для лёгкой ретуши вместо полной регенерации.

noise_mask

• Тип: БУЛЕВО (необязательно, по умолчанию true)
• При включении узел использует шумовую маску во время выборки, чтобы замаскированная область инпейтинга восстанавливалась из шума, а незамаскированная область сохранялась. Отключите эту опцию, когда выбранный путь кодирования/условия уже обрабатывает маску или когда необходимо снизить использование памяти.

Выходы

PIPE_LINE

• Обновлённый конвейер EasyUse, содержащий результат инпейтинга и связанное состояние. Используйте нижестоящие узлы для декодирования, предпросмотра или сохранения результата.

Примечания по использованию

• Все входы, кроме noise_mask, являются обязательными, поэтому узел может выполнять проход инпейтинга напрямую.
• Узел возвращает только PIPE_LINE; он не выводит отдельное изображение или маску.
• Для выбора задачи в стиле PowerPaint установите inpaint_mode в значение powerpaint и выберите нужную function.
• Увеличение grow_mask_by является практичным способом уменьшить видимые швы, когда входная маска плотно прилегает к объекту.
• При использовании режимов encode, таких как inpaint_model_conditioning или different_diffusion, проверьте noise_mask как во включённом, так и в выключенном состоянии, поскольку взаимодействие зависит от модели инпейтинга и сэмплера.
• start_at и end_at используют шкалу 0–10000. Узкое окно может быть полезно для тонких правок: установите start_at достаточно высоко, чтобы пропустить ранние этапы формирования структуры, или установите end_at ниже, чтобы не перезаписывать полностью мелкие детали.