glGetTexGeniv-Funktion

Die Funktionen glGetTexGendv, glGetTexGenfvund glGetTexGeniv geben Parameter für die Texturkoordinatengenerierung zurück.

Syntax

void WINAPI glGetTexGeniv(
   GLenum coord,
   GLenum pname,
   GLint  *params
);

Parameter

Coord

Eine Texturkoordinate. Muss GL _ S, GL _ T, GL _ R oder GL _ Q sein.

pname

Der symbolische Name der werte, die zurückgegeben werden sollen. Muss entweder GL TEXTURE GEN MODE oder der Name einer der Gleichungen der Texturgenerierungsebene _ _ _ sein: GL _ OBJECT PLANE oder GL EYE _ _ _ PLANE. Diese Werte lauten wie folgt.

Wert Bedeutung
GL _ TEXTURE _ GEN _ MODE
Der Parameter params gibt die einwertige Texturgenerierungsfunktion zurück, eine symbolische Konstante.
_ _ GL-OBJEKTEBENE
Der Parameter params gibt die vier Ebenengleichungskoeffizienten zurück, die die Linearkoordinatengenerierung des Objekts angeben. Ganzzahlige Werte werden, wenn sie angefordert werden, direkt aus der internen Gleitkommadarstellung zugeordnet.
GL _ EYE _ PLANE
Der Parameter params gibt die vier Ebenengleichungskoeffizienten zurück, die die Generierung der linearen Augenkoordinate angeben. Ganzzahlige Werte werden, wenn sie angefordert werden, direkt aus der internen Gleitkommadarstellung zugeordnet. Die zurückgegebenen Werte werden in Augenkoordinaten beibehalten. Sie sind nicht gleich den Werten, die mit glTexGenangegeben wurden, es sei denn, die Modellansichtsmatrix wurde zum Zeitpunkt des GlTexGen-Namens identifiziert.

params

Gibt die angeforderten Daten zurück.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Fehlercodes

Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.

Name Bedeutung
GL _ INVALID _ ENUM
coord oder pname war kein akzeptierter Wert.
UNGÜLTIGER _ _ GL-VORGANG
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Die glGetTexGen-Funktion gibt in Parametern ausgewählte Parameter einer Texturkoordinatengenerierungsfunktion zurück, die Sie mit glTexGen angegeben haben. Der koord-Parameter benennt eine der Texturkoordinaten (s, t, r, q) unter Verwendung der symbolischen Konstante GL _ S, GL T, GL R oder GL _ _ _ Q.

Wenn ein Fehler generiert wird, werden keine Änderungen am Inhalt der Parameter vorgenommen.

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

glTexGen