glGetTexGeniv-Funktion

Die Funktionen glGetTexGendv, glGetTexGenfv und glGetTexGeniv geben Parameter zur 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 zurückzugebenden Werte. Muss entweder GL_TEXTURE_GEN_MODE oder der Name einer der Formeln der Texturgenerierungsebene sein: GL_OBJECT_PLANE oder GL_EYE_PLANE. Diese Werte sind wie folgt:

Wert	Bedeutung
GL_TEXTURE_GEN_MODE	Der parameter params gibt die einwertige Texturgenerierungsfunktion zurück, eine symbolische Konstante.
GL_OBJECT_PLANE	Der parameter params gibt die vier ebenen Gleichungskoeffizienten zurück, die die lineare Koordinatengenerierung des Objekts angeben. Ganzzahlige Werte werden bei Anforderung direkt aus der internen Gleitkommadarstellung zugeordnet.
GL_EYE_PLANE	Der Parameter params gibt die vier Ebenengleichungskoeffizienten zurück, die die lineare Augenkoordinatengenerierung angeben. Ganzzahlige Werte werden bei Anforderung direkt aus der internen Gleitkommadarstellung zugeordnet. Bei den zurückgegebenen Werten handelt es sich um werte, die in Augenkoordinaten beibehalten werden. Sie entsprechen nicht den mit glTexGen angegebenen Werten, es sei denn, die Modellansichtsmatrix wurde zum Zeitpunkt des Aufrufs von glTexGen 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.
GL_INVALID_OPERATION	Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Die glGetTexGen-Funktion gibt in Params ausgewählte Parameter einer Textur-Koordinatengenerierungsfunktion zurück, die Sie mit glTexGen angegeben haben. Der Coord-Parameter benennt eine der Texturkoordinaten (s, t, r, q) unter Verwendung der symbolischen Konstanten GL_S, GL_T, GL_R oder GL_Q.

Wenn ein Fehler generiert wird, wird keine Änderung am Inhalt von Params vorgenommen.

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

Siehe auch

glBegin

glEnd

glTexGen