> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# SavePointCloud - 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 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SavePointCloud/zh.md)

***

**Source fingerprint (SHA-256):** `ce8f005c431843a57d87a4aff2eed7a1604ebdf360f83b3aaaadc3ed364d218a`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.