> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# PaintMesh - ComfyUI Built-in Node Documentation

> PaintMesh 接收一个 3D 网格和一个体素颜色场。

PaintMesh 接收一个 3D 网格和一个体素颜色场。它为每个顶点分配场中最近体素的颜色，并返回应用了这些顶点颜色的网格。如果体素场为空，则使用默认零（黑色）顶点颜色绘制网格。

## 输入

| 参数     | 描述                                  | 数据类型  | 是否必需 | 范围  |
| ------ | ----------------------------------- | ----- | ---- | --- |
| `网格`   | 要绘制的网格。                             | MESH  | 是    | N/A |
| `体素颜色` | 包含用于绘制的颜色数据的体素场。仅使用该场中的基础颜色 RGB 通道。 | VOXEL | 是    | N/A |

注意：当体素场坐标包含批量索引通道，且输入网格包含多个网格项时，该节点会分别将颜色应用到批次中的每个网格项。如果某个网格项没有匹配的体素，它将获得默认零（黑色）顶点颜色。由于体素场可能携带完整的 PBR 数据，但仅基础颜色 RGB 用于顶点颜色，采样颜色会从 sRGB 转换为线性 RGB，以用于输出网格。

## 输出

| 输出名称   | 描述            | 数据类型 |
| ------ | ------------- | ---- |
| `mesh` | 已应用顶点颜色的绘制网格。 | MESH |

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

***

**Source fingerprint (SHA-256):** `55683bef55b18487ba660fe619d6ec176f786de346be12724751b71901c14116`