vpscale(3)

NAME

vpScale - multiply the current transformation matrix by a scaling matrix

SYNOPSIS

#include <volpack.h>
vpResult
vpScale(vpc, sx, sy, sz)
    vpContext *vpc;
    double sx.FA double sy.FA double sz.FE

ARGUMENTS

vpc VolPack context from vpCreateContext. sx Scale factor for the X dimension.
sy Scale factor for the Y dimension.
sz Scale factor for the Z dimension.

DESCRIPTION

vpScale is used to multiply the current transformation matrix by a 4-by-4 scaling matrix. The arguments specify independent scale factors for each of the three cartesian axes. The scaling matrix is:

sx 0 0 0

0 sy 0 0
0 0 sz 0
0 0 0 1 Use vpCurrentMatrix to set the current transformation

matrix. By default, the scaling matrix is post-multiplied (M = M*S where M is the current matrix and S is the scaling matrix). The VP_CONCAT_MODE option to vpSeti can be used to select pre-multiplication.

STATE VARIABLES

The current matrix concatenation parameters can be retrieved with the following state variable codes (see vpGeti(3)): VP_CURRENT_MATRIX, VP_CONCAT_MODE.

ERRORS

The return value is always VP_OK.

SEE ALSO

VolPack(3), vpCreateContext(3), vpCurrentMatrix(3)

VolPack vpScale(3)