描述
用于 Ideogram 4 结构化 JSON 描述格式的可视化提示构建器。
此节点在 ComfyUI 内提供一个交互式编辑器,让你可以在画布上绘制区域、分配对象或文本标签、描述和色彩主题,然后组装与 Ideogram 4 期望的 schema 兼容的最终描述 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 | 组装完成的描述 JSON 字符串,采用所选格式(紧凑或美观)。 |
| 1 | IMAGE | (可能是预览/背景图像,通过工具栏重用或捕获) |
| 2 | BOUNDINGBOX | (可能来自编辑器的边界框,采用像素或归一化形式) |
| 3 | INT | (未知,可能是令牌数或区域数) |
| 4 | INT | (未知) |
使用说明 / 编辑器功能
-
画布控制
- 拖拽:绘制新区域。
- Ctrl/Cmd+拖拽:即便在已有区域上也能强制绘制新区域。
- 点击:选择区域。
- Alt+点击:循环选择重叠区域。
- 双击:内联编辑描述。
- 右键:区域列表(选择/删除/复制/排序;顶部为最前)。
- Del/Backspace:移除选中区域。
- Ctrl/Cmd + C / V / D:复制/粘贴/复制选中区域。
- 位于 obj/text 旁的 bbox 字段(px/out)可编辑。
-
颜色色块
- 点击:编辑。
- 拖拽:排序。
- 右键:移除。
- 悬停 + Ctrl/Cmd + C / V:复制/粘贴十六进制值。
- “+”:添加颜色(如果剪贴板中有颜色则使用该颜色)。
-
工具栏
- 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 登录后即可参与讨论。