RenderMesh - 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