NAME¶
vpGetMatrix - retrieve the contents of a transformation matrix
SYNOPSIS¶
#include <volpack.h>
vpResult
vpGetMatrix(vpc,
matrix_code, matrix )
-
- vpContext *vpc;
-
- int matrix_code;
-
- vpMatrix4 matrix;
ARGUMENTS¶
- vpc
- VolPack context from vpCreateContext.
- matrix_code
- A code specifying one of the VolPack transformation
matrices (VP_MODEL, VP_VIEW, VP_PROJECT or VP_SCREEN).
- matrix
- Matrix for storing the result.
DESCRIPTION¶
vpGetMatrix retrieves the contents of one of the transformation matrices
(see vpCurrentMatrix(3)). The special code VP_SCREEN causes the function to
compute the transformation from object coordinates to image coordinates and
return a matrix describing this transformation.
ERRORS¶
The normal return value is VP_OK. The following error return value is possible:
- VPERROR_BAD_OPTION
- The matrix_code argument is invalid.
SEE ALSO¶
VolPack(3), vpCreateContext(3), vpCurrentMatrix(3)