> ## Documentation Index
> Fetch the complete documentation index at: https://comfyuiwiki.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CreateBoundingBoxes - ComfyUI Built-in Node Documentation

> Complete documentation for the CreateBoundingBoxes node in ComfyUI. Learn its inputs, outputs, parameters and usage.

此节点提供一个画布界面，用于在图像中的物体或文本区域周围绘制边界框。它输出像素空间中的边界框坐标、与 Ideogram 提示格式兼容的结构化元素数据，以及显示带有标签和调色板的绘制框的预览图像。

## ## 输入

| 参数              | 描述                                                               | 数据类型                         | 是否必需 | 范围                |
| --------------- | ---------------------------------------------------------------- | ---------------------------- | ---- | ----------------- |
| `背景`            | 可选图像，用作画布和预览中的背景。                                                | IMAGE                        | 否    | -                 |
| `bboxes`        | 用于初始化画布的边界框、元素或JSON字符串。新的上游值会初始化画布；在画布上进行的编辑具有优先权，并会保留直到上游值再次变更。 | BOUNDING\_BOX, ARRAY, STRING | 否    | -                 |
| `宽度`            | 画布及边界框像素网格的宽度（默认值：1024）。                                         | INT                          | 是    | 64 至 16384（步长：16） |
| `高度`            | 画布及边界框像素网格的高度（默认值：1024）。                                         | INT                          | 是    | 64 至 16384（步长：16） |
| `编辑器状态`         | 绘制边界框并设置每个框的类型、文本、描述、调色板。先从背景元素开始，最后处理前景元素。                      | BOUNDING\_BOXES              | 是    | -                 |
| `last_incoming` | 由画布管理的内部状态：最后初始化画布的上游bboxes值。留空以在下次执行时从bboxes输入重新初始化画布。          | BOUNDING\_BOXES              | 否    | -                 |

## ## 输出

| 输出名称       | 描述                                                       | 数据类型          |
| ---------- | -------------------------------------------------------- | ------------- |
| `preview`  | 一张 RGB 图像，显示画布上所有已渲染的边界框，包括标签、调色板色样和描述性文本。               | IMAGE         |
| `bboxes`   | 像素坐标下的边界框列表，每个框包含 x、y、宽度和高度值。                            | BOUNDING\_BOX |
| `elements` | 元素对象的结构化数组，每个元素包含类型、边界框坐标（归一化 0-1000）、文本（针对文本类型）、描述和调色板。 | ARRAY         |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/CreateBoundingBoxes/zh.md)

***

**Source fingerprint (SHA-256):** `dc5545dffefdccf14f3919ff4d9966dbfd1a497dcd64e1863556d5728659ee94`