'\" e  
'\"macro stdmacro
.ds Vn Version 1.2
.ds Dt 24 September 1999
.ds Re Release 1.2.1
.ds Dp May 22 14:45
.ds Dm 5 May 22 14:
.ds Xs 65358     4
.TH GLLOADIDENTITY 3G
.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
1 0 0 0
.ce
0 1 0 0
.ce
0 0 1 0
.ce
0 0 0 1

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_COLOR_MATRIX\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