> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec-b886298.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# DA3Render - ComfyUI Built-in Node Documentation

> 此节点用于从 Depth Anything 3 几何数据渲染可视化结果。

此节点用于从 Depth Anything 3 几何数据渲染可视化结果。根据所选输出模式，可输出深度图、置信度图或天空遮罩。

## ## 输入

| 参数             | 描述                                                                                                                                                                                  | 数据类型          | 是否必需 | 范围                                                               |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- | ---- | ---------------------------------------------------------------- |
| `da3_geometry` | 包含深度数据以及可选的天空和置信度张量的 Depth Anything 3 几何数据包                                                                                                                                         | DA3\_GEOMETRY | 是    | -                                                                |
| `output`       | 要渲染的可视化类型。<br />- depth：归一化的灰度深度图像。<br />- depth\_colored：通过 Turbo 颜色映射的深度。<br />- sky\_mask：天空概率，范围 \[0, 1]（仅适用于 Mono/Metric 模型）。<br />- confidence：归一化的深度置信度（仅适用于 Small/Base 模型）。 | COMBO         | 是    | "depth"<br />"depth\_colored"<br />"sky\_mask"<br />"confidence" |

### `output` 选项的子参数

当 `output` 设置为 `"depth"` 或 `"depth_colored"` 时：

| 参数               | 描述                                                                                                                                  | 数据类型    | 是否必需 | 范围                                     |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------- | ---- | -------------------------------------- |
| `normalization`  | 深度归一化方法。<br />- v2\_style：均值/标准差归一化，获得感知上平衡的结果（默认）。<br />- min\_max：将完整深度范围拉伸至 \[0, 1]，获得最大对比度。<br />- raw：不进行缩放，保留 Metric 模型的度量单位。 | COMBO   | 是    | "v2\_style"<br />"min\_max"<br />"raw" |
| `apply_sky_clip` | 在归一化前将天空区域深度裁剪至前景深度的第 99 百分位数。需要在 da3\_geometry 输入中包含天空键（仅适用于 Mono/Metric 模型）。默认值：False                                             | BOOLEAN | 是    | True<br />False                        |

当 `output` 设置为 `"sky_mask"` 时：

| 参数        | 描述                           | 数据类型    | 是否必需 | 范围              |
| --------- | ---------------------------- | ------- | ---- | --------------- |
| `colored` | 对天空遮罩应用 Turbo 颜色映射。默认值：False | BOOLEAN | 是    | True<br />False |

当 `output` 设置为 `"confidence"` 时：

| 参数        | 描述                           | 数据类型    | 是否必需 | 范围              |
| --------- | ---------------------------- | ------- | ---- | --------------- |
| `colored` | 对置信度图应用 Turbo 颜色映射。默认值：False | BOOLEAN | 是    | True<br />False |

### 参数约束

* 当 `apply_sky_clip` 设置为 True 时，`da3_geometry` 输入必须包含天空张量。此功能仅在使用 Mono 或 Metric 模型时可用。如果缺少天空张量，节点将报错。
* `sky_mask` 输出选项需要在 `da3_geometry` 输入中包含天空张量。此功能仅适用于 Mono 或 Metric 模型。
* `confidence` 输出选项需要在 `da3_geometry` 输入中包含置信度张量。此功能仅适用于 Small 或 Base 模型。

## ## 输出

| 输出名称    | 描述                                                                                 | 数据类型  |
| ------- | ---------------------------------------------------------------------------------- | ----- |
| `IMAGE` | 渲染后的可视化图像张量。对于深度输出，返回灰度或彩色深度图。对于 sky\_mask 和 confidence，根据 colored 参数返回灰度或彩色可视化结果。 | IMAGE |

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

***

**Source fingerprint (SHA-256):** `54d4cde95a916cac26c8a2e19c5623e794d46c0d7652f1c8204f9f2a0deabe0c`