保存 3D（高级） - ComfyUI Built-in Node Documentation

将 3D 模型保存到 ComfyUI 输出目录中的文件，并生成已保存场景的预览。

将 3D 模型保存到 ComfyUI 输出目录中的文件，并生成已保存场景的预览。它还会将 3D 模型、其在场景中的放置、相机信息以及视口尺寸传递给下游节点。当模型放置或相机信息未连接时，节点使用视口状态中存储的值。

输入

参数	描述	数据类型	必需	范围
`model_3d`	来自上游 3D 节点的 3D 模型文件。	FILE3D	是	GLB GLTF FBX OBJ STL USDZ 任意值
`filename_prefix`	用于保存文件名的前缀（默认值："3d/ComfyUI"）。	STRING	是	自由文本
`viewport_state`	包含相机和模型放置信息的视口状态，通常来自 Load 3D 节点。	LOAD3D	是	-
`model_3d_info`	场景中每个模型的放置：位置、旋转和缩放（Y 轴向上的世界空间）。连接时覆盖 `viewport_state` 中存储的模型放置。	LOAD3DMODELINFO	否	-
`camera_info`	视口相机信息：位置、注视目标、缩放和类型。连接时覆盖 `viewport_state` 中存储的相机信息。	LOAD3DCAMERA	否	-
`width`	视口的渲染宽度（像素）（默认值：1024）。	INT	是	1 到 4096
`height`	视口的渲染高度（像素）（默认值：1024）。	INT	是	1 到 4096

注意：model_3d_info 和 camera_info 是可选的。当任一输入未连接时，节点回退到 viewport_state 中存储的对应值。

输出名称	描述	数据类型
`model_3d`	从输入传递过来的 3D 模型文件。	FILE3D
`model_3d_info`	场景中每个模型的放置：位置、旋转和缩放（Y 轴向上的世界空间）。	LOAD3DMODELINFO
`camera_info`	视口相机信息：位置、注视目标、缩放和类型。	LOAD3DCAMERA
`width`	从输入传递过来的渲染宽度值。	INT
`height`	从输入传递过来的渲染高度值。	INT

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！在 GitHub 上编辑

Source fingerprint (SHA-256): 27cb15c5cf382e6e5b8164cfd456993404222c61d59edff2d51f9f1c8e47b25f