> ## 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 takes a 3D mesh and a voxel color field.

PaintMesh takes a 3D mesh and a voxel color field. It assigns each vertex the color of the nearest voxel in the field and returns the mesh with those vertex colors applied. If the voxel field is empty, the mesh is painted with default zero (black) vertex colors.

## Inputs

| Parameter      | Description                                                                                                    | Data Type | Required | Range |
| -------------- | -------------------------------------------------------------------------------------------------------------- | --------- | -------- | ----- |
| `mesh`         | The mesh to be painted.                                                                                        | MESH      | Yes      | N/A   |
| `voxel_colors` | Voxel field containing color data used for painting. Only the base color RGB channels are used from the field. | VOXEL     | Yes      | N/A   |

Note: When the voxel field coordinates include a batch index channel and the input mesh contains multiple mesh items, the node applies the colors separately to each mesh item in the batch. If a given mesh item has no matching voxels, it receives default zero (black) vertex colors. The sampled colors are converted from sRGB to linear RGB for the output mesh, since the voxel field may carry full PBR data but only the base color RGB is used for vertex colors.

## Outputs

| Output Name | Description                                  | Data Type |
| ----------- | -------------------------------------------- | --------- |
| `mesh`      | The painted mesh with vertex colors applied. | MESH      |

> This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! [Edit on GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/PaintMesh/en.md)

***

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