ComfyPilotComfyPilot
文档 / 节点说明 / 渲染网格

渲染网格

此节点通过光线投射单个视图将 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