ComfyPilotComfyPilot
文档 / 节点说明 / 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