文档 /
节点说明 /
渲染网格
渲染网格
此节点通过光线投射单个视图将 3D 网格渲染为 2D 图像。它可以输出带纹理的网格、顶点颜色、纯色着色表面、表面法线或深度。
节点说明
RenderMesh 更新于 2026-11-12
渲染网格 - ComfyUI Built-in Node Documentation
此节点通过光线投射单个视图将 3D 网格渲染为 2D 图像。它可以输出带纹理的网格、顶点颜色、纯色着色表面、表面法线或深度。
此节点通过光线投射单个视图将 3D 网格渲染为 2D 图像。它可以输出带纹理的网格、顶点颜色、纯色着色表面、表面法线或深度。相机和可选的模型变换可以来自 Load3D / Preview3D 查看器;如果未连接相机,则会自动为默认前视图取景。
输入
| 参数 | 描述 | 数据类型 | 必需 | 范围 |
|---|---|---|---|---|
网格 | 要渲染的 3D 网格。 | MESH | 是 | — |
模式 | 要渲染的内容。auto:如果存在纹理则使用纹理,否则使用顶点颜色,否则使用着色黏土。(默认:"auto") | COMBO | 是 | "auto" "texture" "vertex colors" "solid" "normal" "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 上编辑
Source fingerprint (SHA-256): d23e85a904520eb2dfed899eb3e6a9cf45c980df00c034503687ac4eccc66ac4