文档 /
节点说明 /
保存点云
保存点云
保存点云节点将3D点云文件保存到输出目录，并可选择为3D查看器提供预览数据。它处理文件命名和保存，同时传递相机和模型信息用于显示。
节点说明
SavePointCloud 更新于 2026-11-12
保存点云 - ComfyUI Built-in Node Documentation
保存点云节点将3D点云文件保存到输出目录，并可选择为3D查看器提供预览数据。它处理文件命名和保存，同时传递相机和模型信息用于显示。
保存点云节点将3D点云文件保存到输出目录，并可选择为3D查看器提供预览数据。它处理文件命名和保存，同时传递相机和模型信息用于显示。
## 输入
| 参数 | 描述 | 数据类型 | 是否必需 | 范围 |
|---|---|---|---|---|
model_3d | 点云文件 (.ply) | FILE3D\_POINT\_CLOUD\_ANY 或 FILE3D\_PLY | 是 | - |
filename_prefix | 保存文件名的前缀（默认："3d/ComfyUI"） | STRING | 是 | - |
viewport_state | 包含相机和模型信息的当前视口状态 | LOAD3D | 是 | - |
model_3d_info | 3D查看器的附加模型信息 | LOAD3D\_MODEL\_INFO | 否 | - |
camera_info | 3D查看器的相机信息 | LOAD3D\_CAMERA | 否 | - |
width | 预览显示的宽度（像素，默认：1024） | INT | 是 | 1 至 4096 |
height | 预览显示的高度（像素，默认：1024） | INT | 是 | 1 至 4096 |
保存的文件使用 filename_prefix 并附加 5 位计数器写入输出目录（例如 3d/ComfyUI_00001.ply）。当未连接可选的 camera_info 输入时，相机信息取自 viewport_state；同样，当未连接 model_3d_info 时，模型信息取自 viewport_state（若无可用信息则为空列表）。 |
输出
| 输出名 | 描述 | 数据类型 |
|---|---|---|
model_3d | 已保存的点云文件 | FILE3D\_POINT\_CLOUD\_ANY |
model_3d_info | 3D查看器的模型信息 | LOAD3D\_MODEL\_INFO |
camera_info | 3D查看器的相机信息 | LOAD3D\_CAMERA |
width | 预览显示的宽度 | INT |
height | 预览显示的高度 | INT |
本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑
Source fingerprint (SHA-256): ce8f005c431843a57d87a4aff2eed7a1604ebdf360f83b3aaaadc3ed364d218a