∇

Overview

The surfaceTransformPoints utility performs geometric transformations on surfaces, e.g. scale, translate, rotate, and convert between surface formats. It is similar to the transformPoints utility.

Usage

Synopsis 

surfaceTransformPoints [OPTIONS] <input> <output>

Examples

Translate all points by the vector (0 0 1):

surfaceTransformPoints -translate '(0 0 1)' input.obj output.obj

Scale a surface to convert from [mm] to [m] and recentre:

surfaceTransformPoints -recentre -scale 0.001 input.stl output.stl

Input

Arguments

<input>           The input surface file
  <output>          The output surface file

Options

  -auto-centre      Use bounding box centre as centre for rotations
  -case <dir>       Case directory (instead of current directory)
  -centre <point>   Use specified <point> as centre for rotations
  -read-format <type>
                    Input format (default: use file extension)
  -read-scale <scalar | vector>
                    Uniform or non-uniform input scaling
  -recentre         Recentre the bounding box before other operations
  -rollPitchYaw <vector>
                    Rotate by '(roll pitch yaw)' degrees
  -rotate <(vectorA vectorB)>
                    Rotate from <vectorA> to <vectorB> - eg, '((1 0 0) (0 0 1))'
  -rotate-angle <(vector angle)>
                    Rotate <angle> degrees about <vector> - eg, '((1 0 0) 45)'
  -rotate-x <deg>   Rotate (degrees) about x-axis
  -rotate-y <deg>   Rotate (degrees) about y-axis
  -rotate-z <deg>   Rotate (degrees) about z-axis
  -translate <vector>
                    Translate by specified <vector> before rotations
  -write-format <type>
                    Output format (default: use file extension)
  -write-scale <scalar | vector>
                    Uniform or non-uniform output scaling
  -yawPitchRoll <vector>
                    Rotate by '(yaw pitch roll)' degrees
  -doc              Display documentation in browser
  -help             Display short help and exit
  -help-compat      Display compatibility options and exit
  -help-full        Display full help and exit
  • The surface format is deduced from the input and output file extensions.
  • roll=rotate about x, pitch=rotate about y, yaw=rotate about z.

Files

No file needed.

Fields

No field needed.

Output

Logs

No log output.

Files

Property Description Path Type
<output> New surface file <case>/ input type

Fields

No field output.

Further information

Tutorial:

Source code:

History:

  • Introduced in version 1.5