> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-custom-nodes-sdk-v2-frontend.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# SplatToFile3D - ComfyUI Built-in Node Documentation

> SplatToFile3D 节点将高斯溅射转换为 File3D 对象，该对象可与 Save 或 Preview 3D 节点一起使用。

SplatToFile3D 节点将高斯溅射转换为 File3D 对象，该对象可与 Save 或 Preview 3D 节点一起使用。它仅支持每个批次一个项目，并允许你为导出的 3D 数据选择不同的输出文件格式。

## 输入

| 参数      | 描述                                                                                                                               | 数据类型  | 必需 | 范围                             |
| ------- | -------------------------------------------------------------------------------------------------------------------------------- | ----- | -- | ------------------------------ |
| `splat` | 要序列化为文件的高斯溅射数据                                                                                                                   | SPLAT | 是  | -                              |
| `格式`    | 3D 文件的输出文件格式。ply：标准 3D 高斯溅射，包含完整球谐函数。ksplat：mkkellogg SplatBuffer（第 0 级，未压缩），仅基础颜色。spz：Niantic gzip 压缩（约小 10 倍），仅基础颜色（默认值："ply"） | COMBO | 是  | "ply"<br />"ksplat"<br />"spz" |

注意：此节点仅支持每个批次一个项目。如果输入溅射在批次中包含多个项目，节点会记录警告并使用第一个项目。如果提供了不支持的格式，节点会引发错误。

## 输出

| 输出名称    | 描述                                     | 数据类型   |
| ------- | -------------------------------------- | ------ |
| `3D 模型` | 一个 File3D 对象，包含所选格式的序列化高斯溅射数据，可用于保存或预览 | FILE3D |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/SplatToFile3D/zh.md)

***

**Source fingerprint (SHA-256):** `4bb49f417a66f25fce577894a67f39bae6157c4eb88ccf8fad77d74141a50409`