Developer Docs
Developer Docs
Breadcrumbs

Modifiers | Transform


image-20251209-154622.png

Transform Modifiers

Transform modifiers manipulate geometry by changing its position, orientation, size, or repetition. They are typically used to align objects, fit geometry within constraints, or apply systematic transformations based on parameters or logic in the graph.

These modifiers do not create new geometry, but modify existing geometry flowing through the graph.

Modifier

Description

Input/Output

Align

The align places the object on the world origin (X, Y, and Z axis), positioning either the center (middle) or one of the extrema (left, right, top, bottom, front, or back) of your object on the origin of the selected direction(s).

You can align the object relative to a target and optionally use a reference object for additional control. Offsets allow you to fine-tune the final position after alignment, and the node also exposes the resulting movement along each axis.
image-20251209-152528.png

Inputs

  • Target: A 2D or 3D object.

  • Alignment (X): This will move your object over the X axis and make it go left, middle, or right.

  • Alignment (Y): This will move your object over the Y axis and make it go up, middle, or down.

  • Alignment (Z): This will move your object over the Z axis and make it go front, middle, or back.

  • Reference: Specifies the object or coordinate space used as the reference for alignment.

  • Offset (X): Adds a positional offset along the X axis after alignment is applied.

  • Offset (Y): Adds a positional offset along the Y axis after alignment is applied.

  • Offset (Z): Adds a positional offset along the Z axis after alignment is applied.

Outputs

  • Geometry: The aligned geometry.

  • Moved (X): Outputs the amount of movement applied along the X axis.

  • Moved (Y): Outputs the amount of movement applied along the Y axis.

  • Moved (Z): Outputs the amount of movement applied along the Z axis.

Contain

The contain modifier fits the object within a container defined by width, height, and depth. It adjusts the size of the object so it fits inside the specified bounding box while maintaining the selected mode and aspect ratio behavior.
image-20231106-121055.png

Inputs

  • Target: A 2D or 3D object.

  • Width (X): Defines the container width along the X axis.

  • Height (Y): Defines the container height along the Y axis.

  • Depth (Z): Defines the container depth along the Z axis.

  • Mode: Determines how the object is scaled to fit the container (e.g., shrink or grow).

    • Match container (shrink or grow): The shape will grow or shrink to fit into the container.

    • Shrink to container size (do not grow): The shape will only shrink to fit into the container.

    • Grow to container size (do not shrink): The shape will only grow to fit into the container.

  • Aspect Ratio: Controls whether the object's proportions are maintained when fitting inside the container.

    • Maintain aspect ratio within container.

    • Deform to fit container.

Outputs

  • Geometry: The contained geometry.

Repeat

The repeat modifier duplicates the object along one or more axes. You can control the number of repetitions and the spacing between them, and optionally recenter the repeated pattern around the origin.
image-20251209-153610.png

Inputs

  • Target: A 2D or 3D object.

  • Repeat X: Number of repetitions along the X axis.

  • Repeat Y: Number of repetitions along the Y axis.

  • Repeat Z: Number of repetitions along the Z axis.

  • Offset X: Spacing between repetitions along the X axis.

  • Offset Y: Spacing between repetitions along the Y axis.

  • Offset Z: Spacing between repetitions along the Z axis.

  • Recenter: When enabled, centers the full repeated pattern around the origin.

Outputs

  • Geometry: The repeated geometry.

Rotate

The rotate modifier rotates the object around the X, Y, and Z axes. You can define the rotation amount per axis to control the final orientation of the object.
image-20251209-161602.png

Inputs

  • Target: A 2D or 3D object.

  • X: Rotation amount around the X axis.

  • Y: Rotation amount around the Y axis.

  • Z: Rotation amount around the Z axis.

Outputs

  • Geometry: The rotated geometry.

Scale

The scale modifier scales the object along the X, Y, and Z axes. You can define a scaling factor per axis to adjust the size of the object.
image-20251209-161621.png

Inputs

  • Target: A 2D or 3D object.

  • X: Scale factor along the X axis.

  • Y: Scale factor along the Y axis.

  • Z: Scale factor along the Z axis.

Outputs

  • Geometry: The scaled geometry.

Translate

The translate modifier moves the object along the X, Y, and Z axes. You can define a translation amount per axis to control the object's final position.
image-20251209-161642.png

Inputs

  • Target: A 2D or 3D object.

  • X: Translation distance along the X axis.

  • Y: Translation distance along the Y axis.

  • Z: Translation distance along the Z axis.

Outputs

  • Geometry: The translated geometry.