glPushMatrix

glPushMatrix, glPopMatrix

Name

glPushMatrix, glPopMatrix - Legen die aktuelle Matrix auf den Stack bzw. nehmen sie wieder herunter.

Delphi-Spezifikation

procedure glPushMatrix;
procedure glPopMatrix;

Beschreibung

Für jeden Matrizenmodus gibt es einen eigenen Stapel, wobei dieser für GL_MODELVIEW mindestens 32 Einträge aufnehmen können muss, für GL_COLOR, GL_PROJECTION und GL_TEXTURE mindestens 2. (Die aktuelle Matrix im jeweiligen Modus ist die Matrix die auf dem passenden Stapel liegt.)

glPushMatrix legt die aktuelle Matrix auf den Stapel, glPopMatrix nimmt die oberste Matrix wieder vom Stapel und ersetzt die aktuelle Matrix dann mit dieser. Beim Start der GL enthält jeder Stack eine Matrix, die Identitätsmatrix.

Fehler werden generiert, wenn eine Matrix auf einen vollen Stapel gelegt wird, oder eine Matrix vom Stack herunter genommen werden soll obwohl dieser leer ist. In beiden Fällen wird das Fehlerflag gesetzt.

Fehlermeldungen

GL_STACK_OVERFLOW wird generiert wenn glPushMatrix aufgerufen wird und der aktuelle Matrizenstapel voll ist.

GL_STACK_UNDERFLOW wird generiert wenn glPopMatrix aufgerufen wird und sich auf dem aktuellen Matrizenstapel nur die Identitätsmatrix befindet. (Also der Stapel quasi leer ist)

GL_INVALID_OPERATION wird generiert wenn glPushMatrix oder glPopMatrix zwischen einem glBegin und dem passenden glEnd aufgerufen werden.

Zugehörige Wertrückgaben

glGet mit dem Token GL_MATRIX_MODE
glGet mit dem Token GL_COLOR_MATRIX
glGet mit dem Token GL_MODELVIEW_MATRIX
glGet mit dem Token GL_PROJECTION_MATRIX
glGet mit dem Token GL_TEXTURE_MATRIX
glGet mit dem Token GL_MODELVIEW_STACK_DEPTH
glGet mit dem Token GL_PROJECTION_STACK_DEPTH
glGet mit dem Token GL_TEXTURE_STACK_DEPTH
glGet mit dem Token GL_MAX_MODELVIEW_STACK_DEPTH
glGet mit dem Token GL_MAX_PROJECTION_STACK_DEPTH
glGet mit dem Token GL_MAX_TEXTURE_STACK_DEPTH

Links

http://www.opengl.org/sdk/docs/man/xhtml/glPushMatrix.xml

Siehe auch

Hintergrund: Stack

glFrustum, glLoadIdentity, glLoadMatrix, glLoadTransposeMatrix, glMatrixMode, glMultMatrix, glMultTransposeMatrix, glOrtho, glRotate, glScale, glTranslate, glViewport