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

# BakeTextureFromVoxel - ComfyUI Built-in Node Documentation

> 此节点使用网格现有的 UV 布局将 PBR 纹理烘焙到 3D 网格上。

此节点使用网格现有的 UV 布局将 PBR 纹理烘焙到 3D 网格上。它在每个纹素处从稀疏体素体积中采样颜色和材质属性，并输出基色图像以及金属度和粗糙度贴图。它不会对网格进行 UV 展开，因此上游必须连接 UV 展开节点。

## 输入

| 参数               | 描述                                                | 数据类型  | 是否必需 | 范围        |
| ---------------- | ------------------------------------------------- | ----- | ---- | --------- |
| `mesh`           | 要烘焙纹理的 3D 网格。必须已具有 UV 布局；上游必须连接 UV 展开节点。          | MESH  | 是    |           |
| `voxel_colors`   | 包含逐体素颜色和可选 PBR 属性（金属度和粗糙度通道）的稀疏体素体积。              | VOXEL | 是    |           |
| `texture_size`   | 正方形 UV 图集分辨率（显示名称："resolution"，默认值：2048）。         | INT   | 是    | 64 到 8192 |
| `reference_mesh` | 可选的密集预抽取网格；在采样前将每个纹素反向投影到其真实表面，从而消除粗糙网格上的面片化烘焙效果。 | MESH  | 否    |           |

注意：

* 输入网格必须具有 UV。如果不存在 UV，节点将引发错误。UV 必须与顶点一一对应（每个顶点一个 UV）。
* 当网格和体素坐标包含批次维度时，每个批次项将单独烘焙。如果某个批次项没有体素或没有面，则跳过该项并为其生成黑色纹理。
* 当为批次提供 `reference_mesh` 时，会按批次索引进行匹配；除非该 `reference_mesh` 仅包含单个网格，在这种情况下，该网格将用于所有批次项。

## 输出

| 输出名称         | 描述                                     | 数据类型  |
| ------------ | -------------------------------------- | ----- |
| `base_color` | RGB 基色纹理贴图。值为 0–1 范围内的浮点数。             | IMAGE |
| `metallic`   | 灰度金属度贴图（浮点数，0–1）。当体素颜色不包含金属度通道时，此图为黑色。 | IMAGE |
| `roughness`  | 灰度粗糙度贴图（浮点数，0–1）。当体素颜色不包含粗糙度通道时，此图为黑色。 | IMAGE |

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

***

**Source fingerprint (SHA-256):** `419f9e064edaeb9db8d5e052cf57a3b8b77bf7e025e8a0fc9aa0e1919c06b51c`