glLoadMatrix

TriggerTek Logo
abcdefghijklmnopqrstuvwxyz_
GLLOADMATRIX(3G)					     GLLOADMATRIX(3G)



NAME
       glLoadMatrixd,  glLoadMatrixf  -	 replace  the current matrix with the
       specified matrix


C SPECIFICATION
       void glLoadMatrixd( const GLdouble *m )
       void glLoadMatrixf( const GLfloat *m )


PARAMETERS
       m  Specifies a pointer to 16 consecutive values, which are used as the
	  elements of a 4×4 column-major matrix.

DESCRIPTION
       glLoadMatrix  replaces  the current matrix with the one whose elements
       are specified by m.  The current matrix is the projection matrix, mod-
       elview matrix, or texture matrix, depending on the current matrix mode
       (see glMatrixMode).

       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]   v[2]



















			      m[3] m[7] m[11] m[15]   v[3]



       Where ‘‘×’’ denotes matrix multiplication.

       Projection and texture transformations are similarly defined.

NOTES
       While  the elements of the matrix may be specified with single or dou-
       ble precision, the GL implementation may store  or  operate  on	these
       values in less than single precision.

ERRORS
       GL_INVALID_OPERATION  is generated if glLoadMatrix is executed between
       the execution of glBegin and the corresponding execution of glEnd.

ASSOCIATED GETS
       glGet with argument GL_MATRIX_MODE
       glGet with argument GL_COLOR_MATRIX
       glGet with argument GL_MODELVIEW_MATRIX
       glGet with argument GL_PROJECTION_MATRIX
       glGet with argument GL_TEXTURE_MATRIX

SEE ALSO
       glLoadIdentity(3G),	  glMatrixMode(3G),	    glMultMatrix(3G),
       glPushMatrix(3G)



							     GLLOADMATRIX(3G)