> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-comfy-router-docs.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`