TripoSplatPreprocessImage - ComfyUI Built-in Node Documentation

This node crops each input image to a centered square on a black background and adds padding to reach the specified output size. It is designed to prepare images for the TripoSplat 3D model by ensuring consistent square framing and optional alpha matte erosion to prevent border artifacts.

Inputs

Parameter	Description	Data Type	Required	Range
`image`	The input image(s) to preprocess.	IMAGE	Yes	-
`mask`	Alpha mask for the image, used to determine the crop region.	MASK	Yes	-
`erode_radius`	Erode the alpha matte by this pixel radius before cropping (avoids border bleed). Default: 1. Set to 0 to disable erosion.	INT	Yes	0 to 16
`size`	Square image size. The model is trained at 1024; other sizes run but are off-distribution. Default: 1024.	INT	Yes	256 to 4096 (step of 16)

Note: The mask input is required and must be provided. If the mask has a different batch size than the image, it is automatically repeated to match. If the mask dimensions differ from the image dimensions, the mask is resized to match the image using bilinear interpolation. The output size is automatically rounded down to the nearest multiple of 16 (minimum 16) to ensure compatibility with DINOv3 patch and Flux2 VAE stride requirements. The node raises an error if the mask contains no foreground pixels (empty mask). When erode_radius is 0, no erosion is applied. The square crop is centered on the mask’s alpha bounding box and sized to 1.2 times the larger bounding box dimension; any area outside the image bounds is filled with black.

Outputs

Output Name	Description	Data Type
`image`	The preprocessed image(s) cropped to a centered square on a black background with padding, at the requested `size` resolution.	IMAGE

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

Source fingerprint (SHA-256): ec66941846398ee6637576b11ae9d2f9576f6b05ed2ef730cdbf99a68fe9b838

​Inputs

​Outputs

Inputs

Outputs