Go to: Related nodes. Attributes.

Merge vertices within a given threshold. Vertices must lie on the same object to be merged.

Two methods are used to merge vertices. First, a pairwise comparison of selected vertices is performed. A pair is considered if both vertices lie on a border and they share an edge. They are merged with another pair if the respective vertices are within distance attrbute of one another and their orientations match (i.e. the normals on both faces point in the same direction). Second, any selected vertices which share an edge are merged if the distance between them is within the threshold value.

Both edges and vertices are merged.

NOTE: If only two vertices are selected and alwaysMergeTwoVertices is set to true, the tolerance is ignored and the vertices will be merged regardless of distance. Resulting geometry may have extra vertices or edges to ensure valid topology.

Node nameParentsMFn typeCompatible function sets
polyMergeVertpolyModifierWorldkPolyMergeVertkBase
kNamedObject
kDependencyNode
kMidModifier
kPolyMergeVert

Related nodes

polyBevel, polyPlanarProj, polyProj, polyQuad, polySoftEdge, polySubdEdge, polyMoveVertex, polyMoveEdge, polyExtrudeEdge, polyMoveFace, polyChipOff, polyExtrudeFace, polySewEdge, polySphProj, polyCylProj

Attributes (4)

alwaysMergeTwoVertices, distance, mergeToComponents, texture

Long name (short name)TypeDefaultFlags
distance (d) distance (double)0.01cmoutputinputconnectablestorablekeyable
Tolerance to determine whether vertices (and edges) should be merged.
alwaysMergeTwoVertices (am) boolfalseoutputinputconnectablestorablekeyable
If true : if only two vertices are selected, they will be merged regardless of distance
texture (tx) booltrueoutputinputconnectablestorablekeyable
If true : texture is sewn as well as the 3d edge.
mergeToComponents (mtc) componentListNULLoutputinputconnectablestorable
Optionally defines the position to merge all of the vertices to. If set, the distance attribute will be ignored and instead the center point of the set components will be calculated and all vertices will be merged to that location.