NAME
fglLoadMatrixd, fglLoadMatrixf - replace the current matrix
with the specified matrix
FORTRAN SPECIFICATION
SUBROUTINE fglLoadMatrixd( CHARACTER*8 m )
SUBROUTINE fglLoadMatrixf( CHARACTER*8 m )
PARAMETERS
m Specifies a pointer to 16 consecutive values, which are
used as the elements of a 4x4 column-major matrix.
DESCRIPTION
fglLoadMatrix replaces the current matrix with the one whose
elements are specified by m. The current matrix is the
projection matrix, modelview matrix, or texture matrix,
depending on the current matrix mode (see fglMatrixMode).
The current matrix, M, defines a transformation of
coordinates. For instance, assume M refers to the modelview
matrix. If v = (v[0],v[1],v[2],v[3]) is the set of object
coordinates of a vertex, and m points to an array of 16
single- or double-precision floating-point values
m[0],m[1],...,m[15], then the modelview transformation M(v)
does the following:
( m[0] m[4] m[8] m[12] ) ( v[0] )
| | | |
|m[1] m[5] m[9] m[13] | | v[1] |
M(v) = |m[2] m[6] m[10] m[14] | x | v[2] |
| | | |
(m[3] m[7] m[11] m[15] ) ( v[3] )
Where 'x' denotes matrix multiplication.
Projection and texture transformations are similarly
defined.
NOTES
While the elements of the matrix may be specified with
single or double precision, the GL implementation may store
or operate on these values in less than single precision.
ERRORS
GL_INVALID_OPERATION is generated if fglLoadMatrix is
executed between the execution of fglBegin and the
corresponding execution of fglEnd.
ASSOCIATED GETS
fglGet with argument GL_MATRIX_MODE
fglGet with argument GL_MODELVIEW_MATRIX
fglGet with argument GL_PROJECTION_MATRIX
fglGet with argument GL_TEXTURE_MATRIX
SEE ALSO
fglLoadIdentity, fglMatrixMode, fglMultMatrix, fglPushMatrix