Easy Apply IPAdapter (Regional)(ipadapterApplyRegional)

Le nœud Easy Apply IPAdapter (Regional) applique un IPAdapter à un pipeline Easy-Use, en utilisant une image de référence et un masque facultatif pour contrôler où et comment l'adaptateur influence le résultat. Il accepte également un texte de prompt positif/négatif et des contrôles de poids indépendants pour les composants d'image et de prompt. Il se trouve dans la catégorie EasyUse/Adapter.

Description

Ce nœud ajoute un guidage régional basé sur IPAdapter à un PIPE_LINE. Contrairement à une application globale simple d'IPAdapter, la variante régionale vous permet de fournir des prompts texte et un masque afin que l'adaptateur puisse être ciblé sur une zone spécifique ou utilisé avec un conditionnement régional sensible au prompt. Il renvoie un pipe mis à jour, un objet IPADAPTER_PARAMS pour une utilisation ultérieure, et des sorties de conditionnement positif/négatif.

Entrées

Requis

• pipe (PIPE_LINE) : Le pipeline Easy-Use contenant le modèle actif, CLIP, VAE et d'autres états de l'échantillonneur. Le nœud met à jour ce pipe avec le conditionnement nouvellement généré et les paramètres IPAdapter.
• image (IMAGE) : L'image de référence utilisée par l'IPAdapter. L'adaptateur apprend ou extrait les informations de style/contenu visuel de cette image et les applique à la génération.
• positive (STRING, default: "") : Texte de prompt positif utilisé avec l'application régionale de l'IPAdapter. Il est encodé et combiné dans la sortie de conditionnement positif.
• negative (STRING, default: "") : Texte de prompt négatif utilisé avec l'application régionale de l'IPAdapter. Il est encodé et combiné dans la sortie de conditionnement négatif.
• image_weight (FLOAT, default: 1, range: -1 to 3, step: 0.05) : Contrôle la force avec laquelle l'image de référence influence le résultat. Des valeurs négatives peuvent être utilisées pour inverser ou contrer l'influence de l'image.
• prompt_weight (FLOAT, default: 1, range: 0 to 10, step: 0.05) : Contrôle la force avec laquelle le texte de prompt fourni influence le résultat.
• weight_type (COMBO) : Détermine comment le poids de l'IPAdapter est appliqué. Les options disponibles suivent le comportement standard du poids IPAdapter, comme les courbes d'atténuation ou les modes de pondération de style/composition.
• start_at (FLOAT, default: 0, range: 0 to 1, step: 0.001) : L'étape de débruitage à laquelle l'effet IPAdapter commence. Une valeur de 0 commence à l'appliquer dès le début du processus d'échantillonnage.
• end_at (FLOAT, default: 1, range: 0 to 1, step: 0.001) : L'étape de débruitage à laquelle l'effet IPAdapter s'arrête. Une valeur de 1 le maintient actif jusqu'à la fin du processus d'échantillonnage.

Facultatif

• mask (MASK, facultatif) : Un masque qui définit la région où l'IPAdapter doit être appliqué. Lorsqu'il est fourni, l'effet de l'adaptateur est restreint ou ciblé selon le masque. Lorsqu'il est omis, l'adaptateur s'applique globalement ou avec le comportement régional par défaut.
• optional_ipadapter_params (IPADAPTER_PARAMS, facultatif) : Paramètres IPAdapter existants qui peuvent être transmis pour remplacer ou compléter les paramètres du widget. Cela est utile pour enchaîner ou réutiliser des configurations d'adaptateur.

Sorties

• PIPE_LINE : Le pipeline Easy-Use mis à jour avec le conditionnement régional IPAdapter et les paramètres appliqués, prêt à être transmis à un échantillonneur ou à d'autres nœuds de pipeline.
• IPADAPTER_PARAMS : L'objet de paramètres IPAdapter créé par ce nœud, qui peut être réutilisé dans d'autres nœuds compatibles IPAdapter.
• CONDITIONING : La sortie de conditionnement positif, comprenant le prompt positif encodé et l'influence régionale de l'IPAdapter.
• CONDITIONING : La sortie de conditionnement négatif, comprenant le prompt négatif encodé et l'influence négative correspondante de l'IPAdapter.

Notes d'utilisation

• Laissez positive ou negative vide si vous ne souhaitez pas que ce texte de prompt contribue.
• Utilisez image_weight et prompt_weight indépendamment pour équilibrer la référence visuelle par rapport au prompt texte.
• Pour restreindre l'influence de l'IPAdapter à une seule partie de l'image, fournissez un masque. Si aucun masque n'est fourni, le nœud applique l'adaptateur sans restriction de région spatiale.
• La plage start_at / end_at vous permet d'appliquer l'adaptateur uniquement pendant une portion spécifique du programme de débruitage, ce qui peut aider à préserver la structure au début ou à ajouter des détails fins à la fin.
• Si vous avez déjà un objet IPADAPTER_PARAMS provenant d'un autre nœud ou d'un appel précédent, transmettez-le dans optional_ipadapter_params pour conserver les paramètres avancés intacts.