glLoadIdentity function

The glLoadIdentity function replaces the current matrix with the identity matrix.

Syntax

void WINAPI glLoadIdentity(void);

Parameters

This function has no parameters.

Return value

This function does not return a value.

Error codes

The following error code can be retrieved by the glGetError function.

Name Meaning
GL_INVALID_OPERATION
The function was called between a call to glBegin and the corresponding call to glEnd.

Remarks

The glLoadIdentity function replaces the current matrix with the identity matrix. It is semantically equivalent to calling glLoadMatrix with the following identity matrix.

Diagram showing the identity matrix that glLoadIdentity calls.

However, in some cases, it is more efficient.

The following functions retrieve information related to glLoadIdentity:

glGet with argument GL_MATRIX_MODE

glGet with argument GL_MODELVIEW_MATRIX

glGet with argument GL_PROJECTION_MATRIX

glGet with argument GL_TEXTURE_MATRIX

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
Gl.h
Library
Opengl32.lib
DLL
Opengl32.dll

See also

glBegin

glEnd

glLoadMatrix

glMatrixMode

glMultMatrix

glPushMatrix