> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/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           | 否    | -                 |
| `宽度`    | 画布及边界框像素网格的宽度（默认值：1024）。                    | INT             | 是    | 64 至 16384（步长：16） |
| `高度`    | 画布及边界框像素网格的高度（默认值：1024）。                    | INT             | 是    | 64 至 16384（步长：16） |
| `编辑器状态` | 绘制边界框并设置每个框的类型、文本、描述、调色板。先从背景元素开始，最后处理前景元素。 | 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):** `a63939f13edc6c6507590a390dcd6d0a3321febb5831baab1655d9952228612c`