'\"! 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 33588 3 loadidentity.gl
.TH GLLOADIDENTITY
.SH NAME
.B "glLoadIdentity
\- replace the current matrix with the identity matrix

.SH C SPECIFICATION
void \f3glLoadIdentity\fP( void )
.nf
.fi

.SH DESCRIPTION
\f3glLoadIdentity\fP replaces the current matrix with the identity matrix.
It is semantically equivalent to calling \f3glLoadMatrix\fP
with the identity matrix

.ce

.EQ
left (  down 20 { ~ matrix {
   ccol { 1 above 0 above 0 above 0~ }
   ccol { 0 above 1 above 0 above 0~ }
   ccol { 0 above 0 above 1 above 0~ }
   ccol { 0 above 0 above 0 above 1 }
} } ~~ right )
.EN


but in some cases it is more efficient.
.SH ERRORS
\f3GL_INVALID_OPERATION\fP is generated if \f3glLoadIdentity\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
.br
\f3glGet\fP with argument \f3GL_MODELVIEW_MATRIX\fP
.br
\f3glGet\fP with argument \f3GL_PROJECTION_MATRIX\fP
.br
\f3glGet\fP with argument \f3GL_TEXTURE_MATRIX\fP
.SH SEE ALSO
\f3glLoadMatrix\fP,
\f3glMatrixMode\fP,
\f3glMultMatrix\fP,
\f3glPushMatrix\fP