> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-chore-sync-comfy-api-v2-spec.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# TripoSplatPreprocessImage - ComfyUI Built-in Node Documentation

> 此节点将每个输入图像裁剪为黑色背景上的居中正方形，并添加填充以达到指定的输出大小。

此节点将每个输入图像裁剪为黑色背景上的居中正方形，并添加填充以达到指定的输出大小。它旨在通过确保一致的正方形构图和可选的 alpha 遮罩腐蚀来防止边缘伪影，从而为 TripoSplat 3D 模型准备图像。

## 输入

| 参数             | 描述                                                  | 数据类型  | 必需 | 范围                      |
| -------------- | --------------------------------------------------- | ----- | -- | ----------------------- |
| `image`        | 要预处理的输入图像。                                          | IMAGE | 是  | -                       |
| `mask`         | 图像的 Alpha 遮罩，用于确定裁剪区域。                              | MASK  | 是  | -                       |
| `erode_radius` | 在裁剪之前按此像素半径腐蚀 alpha 遮罩（避免边缘渗色）。默认值：1。设置为 0 可禁用腐蚀。   | INT   | 是  | 0 到 16                  |
| `size`         | 正方形图像大小。模型在 1024 分辨率下训练；其他尺寸也可运行，但会偏离训练分布。默认值：1024。 | INT   | 是  | 256 到 4096 (step of 16) |

**注意：** `mask` 输入为必需项，必须提供。如果 mask 的批次大小与图像不同，则会自动重复以匹配。如果 mask 的尺寸与图像尺寸不同，则会使用双线性插值将 mask 调整为与图像匹配。输出大小会自动向下取整为最接近的 16 的倍数（最小为 16），以确保与 DINOv3 patch 和 Flux2 VAE 步长要求兼容。如果 mask 不包含任何前景像素（空 mask），节点将引发错误。当 `erode_radius` 为 0 时，不进行腐蚀。正方形裁剪以 mask 的 alpha 边界框为中心，大小设置为较大边界框尺寸的 1.2 倍；图像边界之外的任何区域均填充为黑色。

## 输出

| 输出名称    | 描述                                                | 数据类型  |
| ------- | ------------------------------------------------- | ----- |
| `image` | 预处理后的图像，裁剪为黑色背景上的居中正方形并带有填充，分辨率按所请求的 `size` 尺寸输出。 | IMAGE |

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

***

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