コンテンツにスキップ

マスク付きメディア潜在変数のエンコード (Encode Masked Media Latent)

元画像とバイナリマスクを InpaintMaskArtifact にエンコードします。このアーティファクトを入力することで、下流の Generate Media Latents ノードが自動的にインペイント(Inpainting)モードに切り替わります。

カテゴリ: ModularDiffusion/Encode\Decode

概要 (TL;DR)

  • インペイント(Inpainting) に使用します。出力されるアーティファクトにはマスク、マスク済み画像潜在変数、強度がひとまとめに含まれており、下流のノードで個別の入力を用意する必要がありません。
  • latents 出力を Generate Media Latents ノードの input_latent 入力に接続します。Generate ノードはアーティファクトの型を自動検知し、インペイントパイプラインに自動ルーティングします。
  • インペイント用パイプラインクラスが登録されているモデル(例: Flux Fill, SDXL Inpaint)でのみ動作します。

ワークフローにおける一般的な配置 (Typical workflow position)

Load Image ──┐
             ├─→ [Encode Masked Media Latent] → Generate Media Latents → Decode
Paint Mask ──┘

ノードプレビュー (Node preview)

Encode Masked Media Latent

入力 (Inputs)

名前 型 必須 備考
pipeline Pipeline Config はい インペイントに対応している必要があります(ドライバが _inpaint_pipeline_class を保持)。
image ImageArtifact / ImageUrlArtifact はい 元画像。
mask ImageArtifact / ImageUrlArtifact はい バイナリマスク — 白ピクセル = インペイント対象領域、黒ピクセル = 元画像を保持。
strength float (0.0〜1.0) いいえ インペイントのデノイズ強度(デフォルト: 1.0)。値を小さくすると元画像のディテールが強く残ります。

出力 (Outputs)

名前 型 備考
latents InpaintMaskArtifact マスク + 元画像/マスク済み画像潜在変数 + 強度を統合したアーティファクト。

ヒントと注意点 (Tips & pitfalls)

  • パイプラインがインペイントに対応している必要があります: 選択したパイプラインにインペイントバリアントが存在しない場合、検証エラーとなります。Pipeline Builder で Flux Fill などを選択してください。
  • マスクは元画像の解像度と一致させてください: 内部で潜在変数グリッドにリサンプリングされますが、アスペクト比が大きく異なると歪みの原因となります。
  • strength はこのアーティファクト上で設定されます: Generate Media Latents 側ではなく、本ノード側で強度を調整します。

関連項目 (See also)