WeldVertices - ComfyUI Built-in Node Documentation

Weld Vertices merges coincident vertices in a 3D mesh, so faces that previously had separate corner points end up sharing the same vertices. It groups nearby vertices using grid quantization with a tolerance based on the mesh bounding box, and averages vertex colors for each merged group. This is useful when a mesh arrives unwelded, meaning each face has its own vertices and no shared edges.

Inputs

Parameter	Description	Data Type	Required	Range
`mesh`	The input 3D mesh whose coincident vertices will be merged.	MESH	Yes	-
`epsilon_rel`	Weld tolerance (fraction of bbox diagonal). 1e-5 for float dedup; 1e-3 for visibly-close-but-distinct verts. Default: 1e-5.	FLOAT	Yes	0.0 to unlimited
`epsilon_abs`	Absolute weld tolerance (overrides epsilon_rel when > 0). Default: 0.0.	FLOAT	Yes	0.0 to unlimited

Note: When epsilon_abs is greater than 0, it takes precedence over epsilon_rel and the relative tolerance is ignored. When epsilon_abs is 0, the relative tolerance epsilon_rel is used.

Outputs

Output Name	Description	Data Type
`mesh`	The welded mesh with merged vertices, updated face indices, and averaged vertex colors (if the input mesh had colors).	MESH

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): f8779e764b344de651b8459f6e4c28773509d9596a98fd164dc7044278856435

​Inputs

​Outputs

Inputs

Outputs