Freigeben über


glLoadMatrixf-Funktion

Die Funktionen glLoadMatrixd und glLoadMatrixf ersetzen die aktuelle Matrix durch eine beliebige Matrix.

Syntax

void WINAPI glLoadMatrixf(
   const GLfloat *m
);

Parameter

m

Ein Zeiger auf eine 4x4-Matrix, die in Spalten-Hauptreihenfolge als 16 aufeinanderfolgende Werte gespeichert ist.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Fehlercodes

Der folgende Fehlercode kann von der glGetError-Funktion abgerufen werden.

Name Bedeutung
GL_INVALID_OPERATION
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Die glLoadMatrix-Funktion ersetzt die aktuelle Matrix durch die in m angegebene Matrix. Die aktuelle Matrix ist die Projektionsmatrix, Modellansichtsmatrix oder Texturmatrix, die vom aktuellen Matrixmodus bestimmt wird (siehe glMatrixMode).

Der m-Parameter verweist auf eine 4x4-Matrix von Gleitkommawerten mit einfacher oder doppelter Genauigkeit, die in Spaltenhauptreihenfolge gespeichert sind. Das heißt, die Matrix wird wie in der folgenden Abbildung dargestellt gespeichert.

Diagramm der 4x4-Matrix, auf die der m-Parameter zeigt.

Die folgenden Funktionen rufen Informationen im Zusammenhang mit glLoadMatrix ab:

glGet mit Argument GL_MATRIX_MODE

glGet mit argument GL_MODELVIEW_MATRIX

glGet mit Argument GL_PROJECTION_MATRIX

glGet mit Argument GL_TEXTURE_MATRIX

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Weitere Informationen

glBegin

glEnd

glLoadIdentity

glMatrixMode

glMultMatrix

glPushMatrix