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)