Easy Apply IPAdapter (Regional)(ipadapterApplyRegional)

Узел Easy Apply IPAdapter (Regional) применяет IPAdapter к пайплайну Easy-Use, используя референсное изображение и необязательную маску для управления тем, где и как адаптер влияет на результат. Он также принимает текст позитивного/негативного промпта и независимые элементы управления весом для компонентов изображения и промпта. Он находится в категории EasyUse/Adapter.

Описание

Этот узел добавляет региональное направление на основе IPAdapter к PIPE_LINE. В отличие от обычного глобального применения IPAdapter, региональный вариант позволяет указать текстовые промпты и маску, чтобы адаптер можно было нацелить на конкретную область или использовать с региональным условием, учитывающим промпт. Он выводит обновлённый пайплайн, объект IPADAPTER_PARAMS для дальнейшего использования и выходы позитивного/негативного условия.

Входы

Обязательно

• pipe (PIPE_LINE): Пайплайн Easy-Use, содержащий активную модель, CLIP, VAE и другое состояние сэмплера. Узел обновляет этот пайплайн, добавляя новые сгенерированные условия и параметры IPAdapter.
• image (IMAGE): Референсное изображение, используемое IPAdapter. Адаптер изучает или извлекает информацию о визуальном стиле/содержимом из этого изображения и применяет её к генерации.
• positive (STRING, по умолчанию: ""): Текст позитивного промпта, используемый при региональном применении IPAdapter. Он кодируется и объединяется в выход позитивного условия.
• negative (STRING, по умолчанию: ""): Текст негативного промпта, используемый при региональном применении IPAdapter. Он кодируется и объединяется в выход негативного условия.
• image_weight (FLOAT, по умолчанию: 1, диапазон: -1 до 3, шаг: 0.05): Управляет тем, насколько сильно референсное изображение влияет на результат. Отрицательные значения можно использовать для инвертирования или противодействия влиянию изображения.
• prompt_weight (FLOAT, по умолчанию: 1, диапазон: 0 до 10, шаг: 0.05): Управляет тем, насколько сильно указанный текст промпта влияет на результат.
• weight_type (COMBO): Определяет, как применяется вес IPAdapter. Доступные опции следуют стандартному поведению веса IPAdapter, например, кривые смягчения или режимы взвешивания стиля/композиции.
• start_at (FLOAT, по умолчанию: 0, диапазон: 0 до 1, шаг: 0.001): Шаг денойзинга, на котором начинается эффект IPAdapter. Значение 0 начинает применять его с начала процесса выборки.
• end_at (FLOAT, по умолчанию: 1, диапазон: 0 до 1, шаг: 0.001): Шаг денойзинга, на котором заканчивается эффект IPAdapter. Значение 1 оставляет его активным до конца процесса выборки.

Необязательно

• mask (MASK, необязательно): Маска, определяющая область, где должен применяться IPAdapter. При её наличии эффект адаптера ограничивается или фокусируется согласно маске. Если маска не указана, адаптер применяется глобально или с поведением по умолчанию для регионального режима.
• optional_ipadapter_params (IPADAPTER_PARAMS, необязательно): Существующие параметры IPAdapter, которые можно передать, чтобы переопределить или дополнить настройки виджетов. Это полезно для объединения в цепочку или повторного использования конфигураций адаптера.

Выходы

• PIPE_LINE: Обновлённый пайплайн Easy-Use с применёнными региональными условиями и параметрами IPAdapter, готовый к передаче в сэмплер или другие узлы пайплайна.
• IPADAPTER_PARAMS: Объект параметров IPAdapter, созданный этим узлом, который можно повторно использовать в других узлах, совместимых с IPAdapter.
• CONDITIONING: Выход позитивного условия, включающий закодированный позитивный промпт и региональное влияние IPAdapter.
• CONDITIONING: Выход негативного условия, включающий закодированный негативный промпт и соответствующее негативное влияние IPAdapter.

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

• Оставьте positive или negative пустыми, если вы не хотите, чтобы этот текст промпта участвовал.
• Используйте image_weight и prompt_weight независимо, чтобы сбалансировать визуальный референс с текстовым промптом.
• Чтобы ограничить влияние IPAdapter только частью изображения, укажите маску. Если маска не указана, узел применяет адаптер без пространственных ограничений.
• Диапазон start_at / end_at позволяет применять адаптер только на определённом участке графика денойзинга, что может помочь сохранить структуру на ранних этапах или добавить мелкие детали на поздних.
• Если у вас уже есть объект IPADAPTER_PARAMS из другого узла или предыдущего вызова, передайте его в optional_ipadapter_params, чтобы расширенные настройки остались без изменений.