Easy Apply Inpaint ノード(applyInpaint)

説明

Easy Apply Inpaint ノード（applyInpaint）は、グラフ内で EasyUse の PIPE_LINE を保持しながら、画像にマスクベースのインペイントを適用します。EasyUse/Inpaint カテゴリに属し、更新済みの PIPE_LINE を返すため、単独の出力ノードとして使用するのではなく、EasyUse パイプラインのフローに挿入するように設計されています。

このノードは、入力画像、マスク、パイプラインオブジェクトを受け取り、選択済みのバックエンドと条件付け戦略を使用してインペイント処理を実行します。マスクの展開、計算精度、スケジューリング、オプションのノイズマスク処理に関するコントロールを提供します。

入力

pipe

• 型: PIPE_LINE（必須）
• モデル、VAE、条件付け、潜在変数、その他のワークフロー状態を保持する EasyUse パイプラインオブジェクトです。インペイント操作はこのパイプラインのコンテキストで適用され、更新済みのパイプラインが出力として返されます。

image

• 型: IMAGE（必須）
• インペイント対象の画像です。ほとんどのワークフローでは、変更するオブジェクトや領域を含むオリジナル画像です。

mask

• 型: MASK（必須）
• インペイントする領域を示すシングルチャンネルのマスクです。ゼロ以外の領域が再生成対象として扱われます。

inpaint_mode

• 型: COMBO（必須）
• オプション: normal、fooocus_inpaint、brushnet_random、brushnet_segmentation、powerpaint

インペイントのバックエンドまたは戦略を選択します：

• normal：通常のインペイント動作。
• fooocus_inpaint：Fooocus スタイルのインペイント。
• brushnet_random：ランダムな生成パターンを使用する BrushNet インペイント。
• brushnet_segmentation：セグメンテーション情報によってガイドされる BrushNet インペイント。
• powerpaint：PowerPaint ベースのインペイント。さまざまなタスクタイプに応じて function セレクタが有効になります。

encode

• 型: COMBO（必須、デフォルト "none"）
• オプション: none、vae_encode_inpaint、inpaint_model_conditioning、different_diffusion

インペイント処理のために入力画像とマスクをどのようにエンコードまたは条件付けするかを制御します：

• none：インペイント固有の追加エンコードは適用されません。
• vae_encode_inpaint：インペイント専用の VAE エンコードパスを使用します。
• inpaint_model_conditioning：インペイントモデル向けの条件付けを使用します。
• different_diffusion：ディファレントディフュージョンスタイルの条件付け/推論戦略を使用します。

grow_mask_by

• 型: INT（必須、デフォルト 6、範囲 0〜64、ステップ 1）
• インペイント前にマスクを展開するピクセル数です。マスクを拡張すると、ハードエッジを避け、生成済みコンテンツを周囲の領域にブレンドする余地をモデルに与えます。

dtype

• 型: COMBO（必須）
• オプション: float16、bfloat16、float32、float64
• インペイント計算に使用する精度です。float16 は通常最速で、最も少ないメモリを使用します。bfloat16 は互換性のあるハードウェアで推奨される場合があります。float32 と float64 はパフォーマンスコストと引き換えに数値精度を高めます。

fitting

• 型: FLOAT（必須、デフォルト 1、範囲 0.3〜1）
• インペイントされたコンテンツが選択済みの動作にどの程度フィットするかを制御します。1 はデフォルトのフルフィット値です。値を低くすると、条件付けの強さを弱めたり、より緩い結果を許容したりできます。

function

• 型: COMBO（必須）
• オプション: text guided、shape guided、object removal、context aware、image outpainting

インペイント操作のセマンティックな動作を選択します。特に、異なるタスクタイプをサポートするモードで有効です：

• text guided：テキストプロンプトによって駆動される生成。
• shape guided：シェイプ情報によってガイドされる生成。
• object removal：オブジェクトを削除し、領域を自然に埋めます。
• context aware：マスク領域のコンテキストを認識したフィリング。
• image outpainting：画像を既存の境界を超えて拡張します。

scale

• 型: FLOAT（必須、デフォルト 1、範囲 0〜10）
• インペイント操作に適用される追加のスケール乗数です。1 はニュートラルなデフォルト値で、値を高くするとインペイントモデルが使用するスケールが増幅されます。

start_at / end_at

• 型: INT（必須、start_at デフォルト 0、end_at デフォルト 10000、範囲 0〜10000）
• インペイント操作の影響を受けるサンプリング/ノイズ除去範囲の開始と終了を定義します。デフォルトの 0〜10000 は全スケジュールをカバーします。この範囲を制限すると、完全な再生成ではなくライトなレタッチに役立ちます。

noise_mask

• 型: BOOLEAN（オプション、デフォルト true）
• 有効にすると、ノードはサンプリング中にノイズマスクを使用するため、マスクされたインペイント領域はノイズから拡散され、マスクされていない領域は保持されます。選択済みのエンコード/条件付けパスがすでにマスクを処理している場合や、メモリ使用量を削減する必要がある場合は、これを無効にします。

出力

PIPE_LINE

• インペイント結果と関連する状態を含む更新済みの EasyUse パイプラインです。後続のノードを使用して、結果をデコード、プレビュー、または保存します。

使用上の注意

• noise_mask 以外のすべての入力は必須のため、ノードは直接インペイント処理を実行できます。
• このノードは PIPE_LINE のみを返します。単独の画像やマスクは出力しません。
• PowerPaint スタイルのタスク選択を行うには、inpaint_mode を powerpaint に設定し、目的の function を選択します。
• grow_mask_by を増やすことは、入力マスクがオブジェクトに密着している場合に、目に見える継ぎ目を減らす実用的な方法です。
• inpaint_model_conditioning や different_diffusion などの encode モードを使用する場合は、インペイントモデルとサンプラーによって相互作用が異なるため、noise_mask をオンとオフの両方でテストしてください。
• start_at と end_at は 0〜10000 のスケールを使用します。狭いウィンドウは微妙な編集に役立ちます。初期の構造形成ステップをスキップするには start_at を十分に高く設定するか、微細な詳細を完全に上書きしないように end_at を低く設定します。