GLIGENTextBoxApplyBatchCoords

GLIGENTextBoxApplyBatchCoords ノードは、技術的に GLIGEN モデルに基づいています。JSON 形式の座標文字列を解析してテキストバウンディングボックスの位置とサイズを定義します。

GLIGENTextBoxApplyBatchCoords は、バッチ生成プロセス向けに設計されたノードで、特定のテキストコンテンツに対する精密な空間制御を可能にします。その中核機能は、一連の座標点を受け取り、指定されたテキストプロンプトを画像生成キャンバス上の特定領域にバインドすることで、テキストベースの空間構図ガイダンスを実現することです。このノードは、時間経過やバッチごとに要素の位置を変化させる必要があるワークフロー向けに特別に設計されています。

ノード機能

このノードは、技術的に GLIGEN モデルに基づいています。JSON 形式の座標文字列を解析してテキストバウンディングボックスの位置とサイズを定義します。潜在空間からの入力を受け取ってバッチサイズを決定し、空間制約情報をテキストプロンプトと共に条件付けデータにエンコードし、最終的に位置情報が融合された条件付けデータストリームを出力します。その座標入力フォーマットは、Spline Editor ノードと直接互換性を持つように設計されており、複雑なモーション軌跡の計画を容易にします。

ノードパラメータ説明 - GLIGENTextBoxApplyBatchCoords

入力接続 (Inputs)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`conditioning_to`	CONDITIONING	はい	-	-	既存の条件付けデータを受け取ります。このノードは新しい空間テキスト制約情報をそれに付加します。
`latents`	LATENT	はい	-	-	潜在空間表現を提供し、主に生成プロセスのバッチサイズを決定するために使用されます。
`clip`	CLIP	はい	-	-	テキストエンコーダーを提供し、入力されたテキストプロンプトのエンコードに使用されます。メインプロンプトと同じ CLIP モデルを使用する必要があります。
`gligen_textbox_model`	GLIGEN	はい	-	-	ロードされた GLIGEN モデルに接続します。このモデルは空間制約のロジックを処理します。

コントロールパラメータ (Parameters)

パラメータ名	データ型	必須	デフォルト値	範囲/オプション	説明
`coordinates`	STRING	はい	-	-	バウンディングボックスの位置を定義する JSON 形式の座標文字列を受け取ります。通常は Spline Editor ノードから提供されます。
`text`	STRING	はい	-	-	空間位置制約を適用する必要があるテキスト記述部分を入力します。
`width`	INT	はい	128	8 - 4096 (ステップ: 8)	GLIGEN テキストバウンディングボックスの幅を設定します。有効範囲は 8 から 4096 で、調整ステップは 8 です。
`height`	INT	はい	128	8 - 4096 (ステップ: 8)	GLIGEN テキストバウンディングボックスの高さを設定します。有効範囲は 8 から 4096 で、調整ステップは 8 です。
`size_multiplier`	FLOAT	いいえ	[1.0]	1.0	-

出力 (Output)

パラメータ名	データ型	説明
conditioning	CONDITIONING	空間制約情報が付加された最終的な条件付けデータを出力します。
coord_preview	IMAGE	座標とバウンディングボックスの位置をプレビューするための可視化画像を出力します。

使用シナリオ

このノードは、主に AnimateDiff-Evolved と組み合わせたアニメーション生成ワークフローで使用されます。例えば、ユーザーはまず Spline Editor ノードを使用して、複数のキーフレームにおける物体（例：「1匹の蝶」）の飛行経路を描画します。その後、生成された座標シーケンスと対応するテキストプロンプトをこのノードに入力することで、生成されるビデオシーケンス内で蝶の移動軌跡と出現位置を精密に制御できます。

注意事項

このノードは、専用の GLIGEN モデルファイルが必要であり、別途ダウンロードする必要があることに注意してください。入力する座標文字列は有効な JSON 形式でなければならず、定義されたバウンディングボックスの位置はキャンバス境界を超えてはいけません。超えた場合、予測不可能な生成結果を引き起こす可能性があります。