|On this page|
The Fuse SOP is used to snap points together or snap points to a 3D grid, and optionally fusing points after the snap.
To restrict the points that can fuse and be fused to, points can be query points, or target points, or both. With only one input to the node, both query and target points are from the single input. However, with a second input to the node, only points in the first input can be query points and only points in the second input can be target points.
When fusing multiple line primitives into a single line, they will still maintain separate primitives. If you wish to make the result into a single primitive, append the Join SOP with
Only Connected enabled.
You can snap points based on their proximity to each other (given by the distance threshold) without fusing them. The snap type has more options on the actual snap behavior. This method is commonly used on a small selection of points in classic modeling operations.
Snapping to a grid is useful for grabbing points and ordering them to a 3D grid. This method is commonly used on individual point selections in classic modeling operations. Snapping to a grid is also useful when outputting to low res consoles as you can truncate vertices to lie on a certain integer boundaries globally on the model.
Snapping only moves points to new positions. To rewire the vertices of points that were snapped together, you can choose to fuse points after snapping so that only one point retains vertices from the original points.
You can select point attributes and groups that you want to be modified after a point is snapped. You can also specify the heuristics for how the attributes values should be interpolated and how group membership should be assigned.
Subset of points that will be snapped.
When enabled, this is the subset of points that will be snapped to by query points. Otherwise, the query group is also the target group, and the behavior is as if Modify Target is on, regardless of its actual value. When there is a second input connected, this group refers to the second input. When Snap Type is "Grid", there is no target group.
When disabled, target point attribute values will stay fixed and be copied over to query points, which is useful for fusing to existing geometry. When enabled, both query and target point attributes will be modified and used to interpolate the new attribute value. This is useful if you still want only one subset of points to fuse with another subset, but so that both subsets can be modified (for example, when snapping two mirrored halves together). This parameter is not applicable when a second input is connected, since that geometry cannot be modified.
This attribute will be used as the position for determining what to snap where. This attribute can be a point, vertex, or primitive attribute in the first input, and can be a point, vertex, primitive, or detail attribute in the second input; they do not need to be the same. The Group and Target Group parameters will be parsed as the corresponding type of group. If this attribute is not a point attribute in the first input, the Fuse options do not apply, because only points can be fused together.
The method used to which points to snap where. The "Points" snap type snaps points within the tolerance together. The "Grid" snap type snaps to points in a 3D grid.
The overall method used for determining which points to snap together. The "Least Target Point Number" method snaps points to the lowest target point number in range, which can ensure that after snapping, if Output Positions is "Least Point Number", no differently snapped points will be within Snap Distance of each other. The "Closest Target Point" method snaps points to the closest target point, if it is in range, which is preferable if snapping disjoint pieces together.
The maximum distance to snap points together.
The method to use to combine values of Position Attribute when snapping points together.
When enabled, the point attribute with this name is used to specify the radii of the points. Two points will be able to fuse together if the closest distance between their spheres with the corresponding radius is within the Snap Distance.
When enabled, the point attribute with this name is used to limit which points can be snapped together by comparing this attribute’s values for the corresponding points. The comparison is specified by the Match Type. This attribute can only be an integer or string attribute.
The comparison to use for comparing the Match Attribute values of points. "Equal Attribute Values" requires values of Match Attribute to be equal in order for points to be considered for snapping together, which is useful for snapping within several separate pieces and not between pieces. "Unequal Attribute Values" requires that at least one point has a different value than the rest, which is useful for snapping between several separate pieces and not within pieces.
How to specify the grid size.
The number of units between each grid line
The number of grid lines every unit
Grid Power 2
The same as gridlines, but a power of two is specified. This means a value of 7 means 128, and 9 means 512.
A number from 0 to 1 which specifies what offset the grid should have from (0,0,0).
Which way points should snap to the grid.
Maximum distance to move points to grid
Fuse Snapped Points
When enabled, points that are snapped to the same position will be replaced with a single point, connected to all vertices of the original points.
Keep Fused Points
When enabled, points that would otherwise be deleted by the Fuse Snapped Points option are kept.
Remove Repeated Vertices and Degenerate Primitives
Remove sequential vertices that reference the same point in polygons or curves, and then deletes any degenerate primitives, such as closed polygons with 2 or fewer vertices, or polygon curves with 1 or fewer vertices.
Remove Unused Points from Degenerate Primitives
Remove any points that no longer have vertices connected to them due to the deletion of degenerate primitives.
Remove All Unused Points
Remove all points that have no vertices connected to them.
Output Attributes and Groups
Recompute Affected Normals
Recomputes any normals that are affected by polygons that use any fused points.
Snapped Points Group
When enabled, a point group with this name is created containing all points that snapped to another point.
Snapped Destination Attribute
When enabled, a point attribute with this name is created, which contains the point number of the point that was snapped to, or -1 if not applicable.
Attributes to Snap
The number of patterns of attributes to be modified.
The heuristic to use to determine the new attribute value of a point based on the points that it snapped to. These interpolate over only target points, unless Modify Target is enabled. "First Match" will snap to the attribute value of the point with the least point number. Likewise, "Last Match" will snap to the point with the greatest number.
The point attributes that you want to be merged together after fusing. Only certain types of attributes can be used for each Snap Method.
Groups to Snap
The number of patterns of groups to be modified.
The heuristic to use to determine how the points get assigned to the Point Groups of the points they snapped to.
Point Group Names
The names of the point groups that you want to be updated after fusing according to the Group Propagation.