vtrans − apply a homogeneous transformation to vector data

vtrans [-H] [if=<infile>] [of=<outfile>] [rx=] [ry=] [rz=] [tx=] [ty=] [tz=] [sx=] [sy=] [sz=] [f=] [-b] [-r] [-n] [-s] [-i] [-z] [-p]

Vtrans transforms a 2D or 3D vector file via a homogeneous transformation. The points may be rotated, translated, scaled, or any combination thereof. The operations are performed in the following order: rotation about the x, y, then z axes, translation, then scaling. The order of rotations may be reversed using the -b flag. Following rotation, translation, and scaling, various bounding box manipulations may be performed. A tight bounding box may be computed (this may optionally be constrained to a square/cube). The bounding box (and all vector data) may be translated such that the (xlo, ylo, zlo) corner of the box is at (0,0,0). A selectable amount of "fudge space" may be placed around the data. Finally, the bounding box values may be constrained to be integers.

if=<output file>

specifies a VisionX vector input file.

of=<output file>

specifies a VisionX vector output file.

rx=<angle>

set the angle of rotation about the x-axis. The angle is specified in degrees unless the -r flag is used (see below).

ry=<angle>

set the angle of rotation about the y-axis. The angle is specified in degrees unless the -r flag is used (see below).

rz=<angle>

set the angle of rotation about the z-axis. The angle is specified in degrees unless the -r flag is used (see below).

tx=<value>

set the amount of translation along the x-axis.

ty=<value>

set the amount of translation along the y-axis.

tz=<value>

set the amount of translation along the z-axis.

sx=<value>

set the amount of x-axis scaling.

sy=<value>

set the amount of y-axis scaling.

sz=<value>

set the amount of z-axis scaling.

f=<value>

set the amount of "fudge space" used to expand the orginal bounding box.

-b

apply the rotations in backward order (z, y, then x).

-r

rotation angles are specified in radians instead of degrees.

-n

compute a new tight bounding box.

-s

compute a new tight square (cubic) bounding box.

-i

rescale and set the bounding box to have integer values.

-z

rescale (tight box) so that the (xlo, ylo, zlo) corner of the box is at (0,0,0).

-p

inhibit packing.

W. J. Kostis