fglLoadMatrix(3G) OpenGL Reference fglLoadMatrix(3G)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 4 x 4 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) = x
|m[2] m[6] m[10] m[14] | | 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_COLOR_MATRIX
fglGet with argument GL_MODELVIEW_MATRIX
Page 1
fglLoadMatrix(3G) OpenGL Reference fglLoadMatrix(3G)
fglGet with argument GL_PROJECTION_MATRIX
fglGet with argument GL_TEXTURE_MATRIX
SEE ALSO
fglLoadIdentity, fglMatrixMode, fglMultMatrix, fglPushMatrix
Page 2