> ## 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.

# DA3Render - ComfyUI Built-in Node Documentation

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

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

## ## 输入

| 参数             | 描述                                                                        | 数据类型          | 是否必需 | 范围                                                                     |
| -------------- | ------------------------------------------------------------------------- | ------------- | ---- | ---------------------------------------------------------------------- |
| `da3_geometry` | 包含深度数据以及可选的天空和置信度张量的 Depth Anything 3 几何数据包                               | DA3\_GEOMETRY | 是    | -                                                                      |
| `output`       | 要渲染的可视化类型。选项包括 depth、depth\_colored、sky\_mask 和 confidence。每个选项都有其各自的子参数。 | COMBO         | 是    | `"depth"`<br />`"depth_colored"`<br />`"sky_mask"`<br />`"confidence"` |

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

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

| 参数               | 描述                                                                                                             | 数据类型    | 是否必需 | 范围                                         |
| ---------------- | -------------------------------------------------------------------------------------------------------------- | ------- | ---- | ------------------------------------------ |
| `normalization`  | 深度归一化方法。v2\_style 使用均值/标准差归一化以获得感知上平衡的结果（默认）。min\_max 将完整深度范围拉伸至 \[0, 1] 以获得最大对比度。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`