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

# RenderMesh - ComfyUI Built-in Node Documentation

> 此节点通过光线投射单个视图将 3D 网格渲染为 2D 图像。

此节点通过光线投射单个视图将 3D 网格渲染为 2D 图像。它可以输出带纹理的网格、顶点颜色、纯色着色表面、表面法线或深度。相机和可选的模型变换可以来自 Load3D / Preview3D 查看器；如果未连接相机，则会自动为默认前视图取景。

## 输入

| 参数              | 描述                                                                          | 数据类型                | 必需 | 范围                                                                                             |
| --------------- | --------------------------------------------------------------------------- | ------------------- | -- | ---------------------------------------------------------------------------------------------- |
| `网格`            | 要渲染的 3D 网格。                                                                 | MESH                | 是  | —                                                                                              |
| `模式`            | 要渲染的内容。auto：如果存在纹理则使用纹理，否则使用顶点颜色，否则使用着色黏土。（默认："auto"）                       | COMBO               | 是  | `"auto"`<br />`"texture"`<br />`"vertex colors"`<br />`"solid"`<br />`"normal"`<br />`"depth"` |
| `宽度`            | 渲染图像的宽度，单位为像素。（默认：1024）                                                     | INT                 | 是  | 64 到 4096 （步长：8）                                                                               |
| `高度`            | 渲染图像的高度，单位为像素。（默认：1024）                                                     | INT                 | 是  | 64 到 4096 （步长：8）                                                                               |
| `背景`            | 网格未覆盖像素所使用的背景颜色。（默认："#000000"）                                              | COLOR               | 是  | —                                                                                              |
| `model_3d_info` | 来自同一 Load3D / Preview3D 查看器的模型变换。将其与 `camera_info` 连接以匹配查看器取景。              | LOAD3D\_MODEL\_INFO | 否  | —                                                                                              |
| `camera_info`   | 来自 Load3D / Preview3D 查看器或 Create Camera Info 节点的相机。如果未连接任何相机，则会自动为默认前视图取景。 | LOAD3D\_CAMERA      | 否  | —                                                                                              |

注意：仅渲染批处理网格中的第一个项目——如果网格批次包含多个项目，该节点会记录警告并使用第一个项目。`texture` 模式要求网格同时具有纹理和 UV，而 `vertex colors` 模式要求顶点颜色；如果所选模式的数据不可用，节点会回退到 `solid` 着色渲染。`normal` 模式在存在平滑顶点法线时使用它们，否则使用逐面法线。在 `depth` 模式下，较近的表面显得更亮（近处 = 白色），未被网格覆盖的像素保持黑色。`model_3d_info` 和 `camera_info` 应从同一个 Load3D / Preview3D 查看器一起连接，以便渲染结果与查看器取景匹配。

## 输出

| 输出名称    | 描述                            | 数据类型  |
| ------- | ----------------------------- | ----- |
| `image` | 网格的渲染图像。                      | IMAGE |
| `mask`  | 一个掩码，在渲染网格的位置为 1.0，其他位置为 0.0。 | MASK  |

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

***

**Source fingerprint (SHA-256):** `d23e85a904520eb2dfed899eb3e6a9cf45c980df00c034503687ac4eccc66ac4`