Easy Apply IPAdapter (Regional)(ipadapterApplyRegional)

Easy Apply IPAdapter（Regional） ノードは、参照画像とオプションのマスクを使用してIPAdapterをEasy-Useパイプラインに適用し、アダプターが結果に影響を与える場所と方法を制御します。また、ポジティブ/ネガティブのプロンプトテキストと、画像とプロンプトの各コンポーネントに対する独立したウェイト制御を受け付けます。このノードは EasyUse/Adapter カテゴリにあります。

説明

このノードは、PIPE_LINE にIPAdapterベースのリージョナルガイダンスを追加します。通常のグローバルなIPAdapter適用とは異なり、リージョナル版ではテキストプロンプトとマスクを指定できるため、アダプターを特定の領域にターゲットしたり、プロンプト対応のリージョナル条件付けと組み合わせて使用したりできます。このノードは、更新済みのパイプ、さらなる使用のための IPADAPTER_PARAMS オブジェクト、およびポジティブ/ネガティブの条件付け出力を出力します。

入力

必須

• pipe (PIPE_LINE): アクティブなモデル、CLIP、VAE、その他のサンプラー状態を含むEasy-Useパイプライン。このノードは、新しく生成された条件付けと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: IPAdapterのリージョナル条件付けとパラメータが適用された更新済みのEasy-Useパイプライン。サンプラーまたは後続のパイプラインノードに渡す準備ができています。
• IPADAPTER_PARAMS: このノードによって構築されたIPAdapterパラメータオブジェクト。他のIPAdapter互換ノードで再利用できます。
• CONDITIONING: エンコードされたポジティブプロンプトとリージョナルIPAdapterの影響を含むポジティブ条件付け出力。
• CONDITIONING: エンコードされたネガティブプロンプトと対応するIPAdapterのネガティブ影響を含むネガティブ条件付け出力。

使用上の注意

• そのプロンプトテキストを反映させたくない場合は、positive または negative を空のままにします。
• 視覚的な参照とテキストプロンプトのバランスを調整するには、image_weight と prompt_weight を独立して使用します。
• IPAdapterの影響を画像の一部のみに制限するには、mask を指定します。マスクが指定されていない場合、ノードは空間的な領域制限なしでアダプターを適用します。
• start_at / end_at の範囲を使用すると、デノイズスケジュールの特定の部分でのみアダプターを適用できます。これにより、初期の構造を保持したり、後期に細かいディテールを追加したりできます。
• 別のノードや前回の呼び出しで IPADAPTER_PARAMS オブジェクトをすでに持っている場合は、それを optional_ipadapter_params に渡して、高度な設定を維持できます。