vpGetMatrix - Man Page

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)

Referenced By

VolPack(3), vpCurrentMatrix(3), vpIdentityMatrix(3), vpSetMatrix(3).

VolPack