Houdini 20.5 Nodes Geometry nodes

Match Size geometry node

Resizes and recenters the input geometry to match a reference bounding box.

On this page

The reference can be the bounding box of the geometry in the second input, the bounds of a group in the first input, or specified numerically.

Parameters

Group

Subset of geometry to move to the reference size. Note that the entire input is used as the source position if Use Groups to Determine Justification Bounds is not set.

Group Type

The type of elements referenced in the Group field.

Justify With

How to compute the reference bounding box.

Origin and Unit Size

The reference point is a unit bounding box. The reference size will be unit-sized.

Second Input

The bounding box of the second input will be used as reference. If there is no second iput, a zero-sized bounding box at the origin is used.

Location and Size

The reference bounding box is anchored to a specific point and given the specific size. Which corner of the bounding box is anchored depends on the Justify options.

Input If Wired

The second input’s bounding box is used if present. If not present, the location and size is used.

Use Groups to Determine Justification Bounds

By default the entirety of the inputs are used to compute the reference bounds. If one wants to anchor against a piece of the input geometry, or only transform a piece, explicit source and target groups can be provided.

Source Group

The parts of the first input to use to build a bounding box. It is this bounding box that is then aligned to the reference bounding box. A source group can be used to select some anchor geometry to control what part of the source ends up aligned to the target.

Source Group Type

The type of elements referenced in the Source Group field.

Target Group

The parts of the second input to use to build a reference bounding box. Specifying a subset of the target allows specifying an anchor target to ensure consistent alignment of two sub-components irrespective of the rest of the geometry.

Target Group Type

The type of elements referenced in the Target Group field.

Target Position

Anchor for the reference bounding box if no second input is given. It represents the center of the box unless the relevant axis' justification is Min or Max, in which case it represents the edge of the reference box.

Target Size

Size of the reference bounding box if no second input is given.

Translate

Whether to translate the object to match the reference box.

Justify X/Y/Z

Controls how the each axis is translated to match the reference box.

None

No movement on the x-axis

Min

The minimum of the object’s bounding box is aligned to the minimum of the reference’s bounding box.

Center

The center of the object’s bounding box is aligned to the center of the reference’s bounding box.

Max

The maximum of the object’s bounding box is aligned to the maximum of the reference’s bounding box.

To

Controls which axis of the reference box the object is justified to.

Same

Matches the justification of reference: so the minimum will match minimum, or center match center.

Min

The justification side of the object’s bounding box is aligned to the minimum of the reference’s bounding box.

Center

The justification side of the object’s bounding box is aligned to the center of the reference’s bounding box.

Max

The justification side of the object’s bounding box is aligned to the maximum of the reference’s bounding box.

Offset by

Additional offset to apply to the justification. This allows for a fixed-size gap, or fixed-size overlap to be specified.

Scale to Fit

Whether to scale the geometry to match the size of the reference box.

Uniform Scale

Preserve the aspect ratio of the geometry by scaling all axes equally.

Scale Axis

In case of uniform scale not all axes can necessarily be fit. This determines which axis is used.

X

The x-axis will be matched.

Y

The y-axis will be matched.

Z

The z-axis will be matched.

Best Fit

The object will be fully contained in the reference box.

Perimeter

The total edge lengths of the two models will be scaled to match. This is not well defined if either model lacks edges.

Area

The total surface area of the two models will be scaled to match. This is not well defined if either model has no surface.

Volume

The total volume of the two models will be scaled to match. This is not well defined if either model lacks volume.

Scale X/Y/Z

Controls whether each axis will be scaled to the reference box.

Restore Transform

Applies the inverse of the transform stored in the given detail attribute. If it was created by a Match Size’s Stash Transform, this will have the effect of restoring the geometry to its original space.

Stash Transform

Stores the transform applied to the geometry into the given detail attribute. This can then be undone with another Match Axis and the Restore Transform option, or applied directly with the Transform by Attribute SOP.

Inputs

Source Geometry

The geometry which will be resized to fit the destination.

Destination Size

The geometry whose bounding box will be used to determine how to center and size the source.

See also

Geometry nodes