glMatrixMode function

The glMatrixMode function specifies which matrix is the current matrix.

Syntax

void WINAPI glMatrixMode(
   GLenum mode
);

Parameters

mode

The matrix stack that is the target for subsequent matrix operations. The mode parameter can assume one of three values.

Value Meaning
GL_MODELVIEW
Applies subsequent matrix operations to the modelview matrix stack.
GL_PROJECTION
Applies subsequent matrix operations to the projection matrix stack.
GL_TEXTURE
Applies subsequent matrix operations to the texture matrix stack.

Return value

This function does not return a value.

Error codes

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

Name Meaning
GL_INVALID_ENUM
mode was not an accepted value.
GL_INVALID_OPERATION
The function was called between a call to glBegin and the corresponding call to glEnd.

Remarks

The glMatrixMode function sets the current matrix mode.

The following function retrieves information related to glMatrixMode:

glGet with argument GL_MATRIX_MODE

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

glPushMatrix