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

# 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 (step 8)                                                                             |
| `高度`            | 渲染图像的高度（像素）。(默认： 1024)                                                | INT                 | 是  | 64 到 4096 (step 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` 模式要求顶点色；如果所选模式的数据不可用，节点将回退到实体着色渲染。`model_3d_info` 和 `camera_info` 应同时连接自同一个 Load3D / Preview3D 查看器，以便渲染结果与查看器取景一致。

## 输出

| 输出名  | 描述                         | 数据类型  |
| ---- | -------------------------- | ----- |
| `图像` | 网格的渲染图像。                   | IMAGE |
| `遮罩` | 一个遮罩，网格渲染处为 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`