文档 /
节点说明 /
TripoSplat 预处理图像
TripoSplat 预处理图像
此节点将每个输入图像裁剪为黑色背景上的居中正方形,并添加填充以达到指定的输出大小。
节点说明
TripoSplatPreprocessImage 更新于 2026-11-12
TripoSplat 预处理图像 - 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 (步长: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 上编辑
Source fingerprint (SHA-256): ec66941846398ee6637576b11ae9d2f9576f6b05ed2ef730cdbf99a68fe9b838