Skip to main content

Transform

The Transform tool applies geometric transformations to volume meshes, including reorientation, rotation, translation, scaling, and mirroring. These operations modify the physical coordinates of all vertices in the mesh, permanently changing its position, orientation, or size in 3D space.

Accessing the Tool

Navigate to the Volume Mesh ribbon tab and click Transform in the Transform section.

Target Object(s)

Before applying transformations, select which volume mesh objects will be affected:

TargetDescription
Active Volume MeshApply transformation only to the currently active mesh
Selected Volume MeshesApply to all selected volume mesh objects
Visible Volume MeshesApply to all visible (non-hidden) volume meshes
All Volume MeshesApply to every volume mesh in the project

Transformation Operations

The tool provides six transformation modes, organized as tabs:

Rotate

Rotate the target volume mesh(es) around a specified axis by a given angle.

Rotation Axis

Select one or more axes around which to rotate:

  • X: Rotate around the X-axis
  • Y: Rotate around the Y-axis
  • Z: Rotate around the Z-axis

Multiple axes can be selected for compound rotations.

Rotation Angle

ParameterRangeDefault
Angle (°)-360 to 3600

Positive angles rotate counterclockwise when looking from the positive axis direction toward the origin.

Rotation Center

By default, rotation occurs around the object's bounding box centroid. Uncheck Object centroid to specify a custom rotation center:

ParameterDescription
X (mm)X-coordinate of custom rotation center
Y (mm)Y-coordinate of custom rotation center
Z (mm)Z-coordinate of custom rotation center
tip

Press the P key while hovering over the volume mesh to pick a point as the rotation center.

Translate

Move the target volume mesh(es) by a specified distance in each axis direction.

Translation Vector

ParameterDescriptionRange
X (mm)Distance to move along X-axis±999999999999
Y (mm)Distance to move along Y-axis±999999999999
Z (mm)Distance to move along Z-axis±999999999999

Positive values move in the positive axis direction; negative values move in the negative direction.

Scale

Resize the target volume mesh(es) by specified scale factors.

Scale Factor

ParameterDescriptionRangeDefault
XScale factor along X-axis0.00001 - 9999991.0
YScale factor along Y-axis0.00001 - 9999991.0
ZScale factor along Z-axis0.00001 - 9999991.0

A scale factor of 1.0 leaves the dimension unchanged. Values greater than 1.0 enlarge; values less than 1.0 shrink.

Uniform Scaling

Enable Uniform scaling to maintain proportions. When checked, changing any scale factor automatically updates the others to match.

Mirror

Reflect the target volume mesh(es) across one or more coordinate planes.

Mirror Axis

OptionDescription
XMirror across the YZ plane (flip left-right)
YMirror across the XZ plane (flip front-back)
ZMirror across the XY plane (flip top-bottom)

Multiple axes can be selected for compound mirroring operations.

Matrix

Apply a custom 4×4 transformation matrix for advanced transformations.

The transformation matrix follows the standard homogeneous coordinates format:

| m0 m4 m8 m12 | | X-axis Y-axis Z-axis Translation-X |
| m1 m5 m9 m13 | = | X-axis Y-axis Z-axis Translation-Y |
| m2 m6 m10 m14 | | X-axis Y-axis Z-axis Translation-Z |
| m3 m7 m11 m15 | | Perspective (typically 0,0,0,1) |

The upper-left 3×3 submatrix controls rotation and scaling. The rightmost column (m12, m13, m14) controls translation. The default identity matrix leaves the mesh unchanged.

Reorient

Apply a six-parameter rigid transform using three translation values and three Euler rotation angles.

Translation

ParameterDescriptionRange
X (mm)Relative translation distance along X-axis±999999999999
Y (mm)Relative translation distance along Y-axis±999999999999
Z (mm)Relative translation distance along Z-axis±999999999999

Rotation Angles

ParameterDescriptionRangeDefault
X (°)Rotation angle around X-axis-360 to 3600
Y (°)Rotation angle around Y-axis-360 to 3600
Z (°)Rotation angle around Z-axis-360 to 3600

Rotation Center

ParameterDescriptionRangeDefault
Object centroidWhen enabled, rotate around the volume mesh bounding box center. When disabled, rotate around the specified rotation center.n/aOn
X (mm)X-coordinate of the custom rotation center.±9999999999990
Y (mm)Y-coordinate of the custom rotation center.±9999999999990
Z (mm)Z-coordinate of the custom rotation center.±9999999999990

When Object centroid is disabled, use the P key while the mouse is over the object to pick the rotation center.

info

Reorient uses relative translation values, not an absolute target position. Rotation uses each volume mesh's current bounding box centroid by default, or an explicit rotation center when Object centroid is disabled, using the same XYZ angle convention as Interactive Transform.

Move to Image Center

Move the target volume mesh(es) to the center of the active volume image.

This operation is useful for aligning meshes with CT/MRI image data or centering a mesh within the project coordinate system. Click Apply to translate the mesh so its centroid coincides with the volume image center.

Applying Transformations

After configuring the transformation parameters:

  1. Click Apply to execute the transformation
  2. The operation modifies vertex coordinates permanently
  3. A progress dialog appears for large meshes
warning

Transformation operations permanently modify mesh vertex coordinates. There is no undo after the operation completes. Consider saving your project before applying transformations.

Practical Examples

Rotating a Mesh 90° Around the Z-Axis

  1. Open the Transform tool
  2. Select the Rotate tab
  3. Check only Z in Rotation axis
  4. Set Angle to 90
  5. Leave Object centroid checked
  6. Click Apply

Applying a Six-Value Rigid Transform

  1. Open the Transform tool
  2. Select the Reorient tab
  3. Enter the translation values in X, Y, and Z
  4. Enter the rotation angles in X, Y, and Z
  5. Click Apply

Scaling a Mesh to Double Size

  1. Open the Transform tool
  2. Select the Scale tab
  3. Enable Uniform scaling
  4. Set X to 2.0 (Y and Z update automatically)
  5. Click Apply

Converting Units from Inches to Millimeters

To convert a mesh modeled in inches to millimeters:

  1. Open the Transform tool
  2. Select the Scale tab
  3. Enable Uniform scaling
  4. Set X to 25.4 (1 inch = 25.4 mm)
  5. Click Apply

Centering a Mesh at the Origin

  1. First, note the current centroid position
  2. Select the Translate tab
  3. Enter negative values of the centroid coordinates
  4. Click Apply