> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# SplatToFile3D - ComfyUI Built-in Node Documentation

> Complete documentation for the SplatToFile3D node in ComfyUI. Learn its inputs, outputs, parameters and usage.

# SplatToFile3D 节点文档

## ## 概述

SplatToFile3D 节点可将高斯泼溅数据转换为 File3D 对象，该对象可与保存或预览 3D 节点配合使用。此节点仅支持单批次处理一个项目，并允许您为导出的 3D 数据选择不同的输出文件格式。

## ## 输入

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

## ## 输出

| 输出名称       | 描述                                    | 数据类型   |
| ---------- | ------------------------------------- | ------ |
| `model_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):** `c04fe04faa8ce81ad699e67c00d047550b0cadbfd037b687331f76944501a9f6`