glMultMatrixf-Funktion

Die Funktionen glMultMatrixd und glMultMatrixf multiplizieren die aktuelle Matrix mit einer beliebigen Matrix.

Syntax

void WINAPI glMultMatrixf(
   const GLfloat *m
);

Parameter

m

Ein Zeiger auf eine 4x4-Matrix, die in Spaltenhauptreihenfolge als 16 aufeinander folgende 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 glEndaufgerufen.

Bemerkungen

Die glMultMatrix-Funktion multipliziert die aktuelle Matrix mit der in m angegebenen Matrix. Das heißt, wenn M die aktuelle Matrix und T die an glMultMatrix übergebene Matrix ist, wird M durch M T ersetzt.

Die aktuelle Matrix ist die Projektionsmatrix, Modellansichtsmatrix oder Texturmatrix, die durch den aktuellen Matrixmodus bestimmt wird (siehe glMatrixMode).

Der m-Parameter zeigt 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 glMultMatrix 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

Requirements (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

glLoadMatrix

glMatrixMode

glPushMatrix