'\"! eqn | mmdoc
'\"macro stdmacro
.ds Vn Version 1.2
.ds Dt 6 March 1997
.ds Re Release 1.1.0
.ds Dp Mar 17 18:07
.ds Dm  Mar  6 20:0
.ds Xs 55947 3 matrixmode.gl
.TH GLMATRIXMODE
.SH NAME
.B "glMatrixMode
\- specify which matrix is the current matrix

.SH C SPECIFICATION
void \f3glMatrixMode\fP(
GLenum \fImode\fP )
.nf
.fi

.SH PARAMETERS
.TP \w'\f2mode\fP\ \ 'u 
\f2mode\fP
Specifies which matrix stack is the target
for subsequent matrix operations.
Three values are accepted:
\f3GL_MODELVIEW\fP,
\f3GL_PROJECTION\fP, and
\f3GL_TEXTURE\fP.
The initial value is \f3GL_MODELVIEW\fP.
.SH DESCRIPTION
\f3glMatrixMode\fP sets the current matrix mode.
\f2mode\fP can assume one of three values:
.TP 25
\f3GL_MODELVIEW\fP
Applies subsequent matrix operations to the modelview matrix stack.
.TP
\f3GL_PROJECTION\fP
Applies subsequent matrix operations to the projection matrix stack.
.TP
\f3GL_TEXTURE\fP
Applies subsequent matrix operations to the texture matrix stack.
.P
To find out which matrix stack is currently the target of all matrix
operations, call \f3glGet\fP with argument \f3GL_MATRIX_MODE\fP. The initial
value is \f3GL_MODELVIEW\fP.
.SH ERRORS
\f3GL_INVALID_ENUM\fP is generated if \f2mode\fP is not an accepted value.
.P
\f3GL_INVALID_OPERATION\fP is generated if \f3glMatrixMode\fP
is executed between the execution of \f3glBegin\fP
and the corresponding execution of \f3glEnd\fP.
.SH ASSOCIATED GETS
\f3glGet\fP with argument \f3GL_MATRIX_MODE\fP
.SH SEE ALSO
\f3glLoadMatrix\fP,
\f3glPushMatrix\fP