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)