NAME¶
vpTranslate - multiply the current transformation matrix by a translation matrix
SYNOPSIS¶
#include <volpack.h>
vpResult
vpTranslate(vpc,
tx, ty, tz )
-
- vpContext *vpc;
-
- double *tx, *ty, *tz;
ARGUMENTS¶
- vpc
- VolPack context from vpCreateContext.
- tx
- X component of translation vector.
- ty
- Y component of translation vector.
- tz
- Z component of translation vector.
DESCRIPTION¶
vpTranslate is used to multiply the current transformation matrix by a
4-by-4 translation matrix. The translation matrix is:
-
- 1 0 0 tx
0 1 0 ty
0 0 1 tz
0 0 0 1
Use
vpCurrentMatrix to set the current transformation matrix. By default,
the transformation matrix is post-multiplied (M = M*T where M is the current
matrix and T is the translation 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)