Description
Ideogram 4の構造化JSONキャプション形式のためのビジュアルプロンプトビルダーです。
このノードはComfyUI内部でインタラクティブなエディターを提供し、キャンバス上に領域を描画し、オブジェクトやテキストラベル、説明、カラーパレットを割り当て、Ideogram 4の期待するスキーマに準拠した最終的なキャプションJSON文字列を組み立てます。
エディターはドラッグでの領域描画、選択、インライン編集、コピー/貼り付け/複製、背景画像管理、明度スライダー、トークン推定、クリップボード操作を含む完全なツールバー制御をサポートします。
入力
必須
| 名前 | 型 | デフォルト | ツールチップ |
|---|---|---|---|
width | INT | 1024 | キャンバスのアスペクト幅(bboxの計測にも使用されるピクセルグリッド)。Ideogram 4では16の倍数が必要。最小: 64、最大: 16384、ステップ: 16。 |
height | INT | 1024 | キャンバスのアスペクト高さ(bboxの計測にも使用されるピクセルグリッド)。Ideogram 4では16の倍数が必要。最小: 64、最大: 16384、ステップ: 16。 |
high_level_description | STRING | "" | 画像全体のオプションの一行概要(空白の場合は省略)。 |
background | STRING | "" | 必須のシーン背景説明。 |
style | DYNAMICCOMBO | (動的) | エディターにより入力されるドロップダウン(おそらくスタイルプリセット)。 |
aesthetics | STRING | "" | スタイル記述子(空白の場合は省略)。 |
lighting | STRING | "" | スタイル記述子(空白の場合は省略)。 |
medium | STRING | "" | スタイル記述子(空白の場合は省略)。 |
style_palette_data | STRING | "" | エディターからのシリアル化されたスタイルカラーパレット(ノードUIにより管理)。 |
elements_data | STRING | "" | エディターからのシリアル化された領域(ノードUIにより管理)。 |
bg_brightness | INT | 25 | 背景画像の明度%(ノードUIスライダーにより管理)。最小: 0、最大: 100。 |
import_mode | COMBO | "when empty" | 接続されたimport_jsonの使用方法: "when empty"はエディターに領域がない場合のみエディターをシードします(その後エディターが優先されるため編集可能)。"always"は接続されたJSONを優先とし、その変更が常に出力に反映されます。オプション: ["when empty", "always"]。 |
output_format | STRING | "compact" | 出力JSONのフォーマット(エディターツールバーで設定): "compact"(デフォルト、Ideogram 4が期待するもの)、または"pretty"(インデント付き、可読性用)。 |
coord_mode | STRING | "normalized" | bbox座標空間(エディターツールバーで設定): "normalized"(デフォルト、Ideogram 4が期待する0‑1000グリッド)、または"absolute"(ピクセル、width/heightでスケーリング。Ideogramには非標準、他のツールでピクセル座標が必要な場合用)。 |
bbox_order | STRING | "yx" | bbox軸の順序(エディターツールバーで設定): "yx"(デフォルト、Ideogramの[ymin, xmin, ymax, xmax])、または"xy"([xmin, ymin, xmax, ymax]、Qwen‑VLやほとんどの検出器が使用する標準のx1,y1,x2,y2)。 |
photo | STRING | "" | (ソースにツールチップなし) |
art_style | STRING | "" | (ソースにツールチップなし) |
オプション
| 名前 | 型 | デフォルト | ツールチップ |
|---|---|---|---|
image | IMAGE | — | エディターの背景(およびプレビューの背後)に表示されるオプションの参照画像。 |
import_json | STRING | "" | オプション: 完全なキャプションJSON。接続すると、エディターに読み込まれ、import_modeに従って出力を駆動します。 |
bboxes | BOUNDINGBOX | — | オプションのピクセル空間ボックス({x, y, width, height})。エディターに領域がない場合に領域をシードするために使用。領域が存在すると無視されます。 |
出力
| インデックス | 型 | 説明 |
|---|---|---|
| 0 | STRING | 選択したフォーマット(compactまたはpretty)で組み立てられたキャプションJSON文字列。 |
| 1 | IMAGE | (おそらくプレビュー/背景画像。ツールバーで再利用またはキャプチャされます) |
| 2 | BOUNDINGBOX | (おそらくエディターからのバウンディングボックス。ピクセルまたは正規化形式) |
| 3 | INT | (不明。トークン数または領域数の可能性) |
| 4 | INT | (不明) |
使用上の注意 / エディター機能
-
キャンバス制御
- ドラッグ: 新しい領域を描画します。
- Ctrl/Cmd+ドラッグ: 既存の領域の上でも新しい領域を強制描画します。
- クリック: 領域を選択します。
- Alt+クリック: 重なり合う領域を循環します。
- ダブルクリック: 説明をインライン編集します。
- 右クリック: 領域リスト(選択/削除/複製/並べ替え、先頭が最前面)。
- Del/Backspace: 選択した領域を削除します。
- Ctrl/Cmd + C / V / D: 選択した領域をコピー/貼り付け/複製します。
- bboxフィールド(px/out)はobj/textの横で編集可能です。
-
カラースウォッチ
- クリック: 編集します。
- ドラッグ: 並べ替えます。
- 右クリック: 削除します。
- ホバー+ Ctrl/Cmd + C / V: 16進数をコピー/貼り付けします。
- "+": 色を追加します(クリップボードに色があればそれを使用)。
-
ツールバー
- Live: ライブサンプリングプレビューを背景として使用します(最終結果も取得)。
- Grab BG / Clear BG: 最後に生成した画像を背景として使用します。
- 明度スライダー、トークン推定、およびコピー/貼り付け/すべてクリア。
-
バウンディングボックスはデフォルトで0–1000グリッドに
[ymin, xmin, ymax, xmax]として正規化されます。widthとheightがキャンバスのアスペクト比を設定します。 -
インポートモードの動作:
"when empty": エディターに領域がない場合のみJSONをインポートします。編集するとエディターが優先されます。"always": 接続されたJSONが優先されます。JSONの変更は常に出力に反映され、エディターの状態を上書きします。
-
座標モードとbboxの順序は異なる下流モデルとの互換性のために設定可能です。Ideogram 4は
"normalized"と"yx"を期待します。 -
出力形式:
"compact"(空白なし)はIdeogram 4が期待する形式、"pretty"(インデント付き)は人間の可読性用です。 -
image入力はオプションで、エディターに参照背景を提供しますが、生成されるJSONには影響しません。 -
style_palette_data、elements_data、bg_brightnessの各入力は内部のシリアル化された状態です。エディターと対話するとノードUIが自動的にこれらを管理します。 -
photoとart_styleはどちらも追加の文字列フィールドで、Ideogramのキャプション構造にマッピングされる可能性があります(ソースに詳細はありません)。
コメント
GitHubでサインインしてディスカッションに参加しましょう。