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
     fglGet with argument GL_PROJECTION_MATRIX
     fglGet with argument GL_TEXTURE_MATRIX


SEE ALSO
     fglLoadIdentity, fglMatrixMode, fglMultMatrix, fglPushMatrix