glGetTexGendv-Funktion

Die Funktionen glGetTexGendv, glGetTexGenfv und glGetTexGeniv geben Texturkoordinatengenerierungsparameter zurück.

Syntax

void WINAPI glGetTexGendv(
   GLenum   coord,
   GLenum   pname,
   GLdouble *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 Ebenengleichungskoeffizienten zurück, die die Linearkoordinatengenerierung 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. Die zurückgegebenen Werte sind werte, die in Augenkoordinaten verwaltet werden. Sie sind nicht gleich 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-Koordinaten-Generierungsfunktion zurück, die Sie mit glTexGen angegeben haben. Der Coord-Parameter benennt eine der Texturkoordinaten (s, t, r, q), wobei die symbolische Konstante GL_S, GL_T, GL_R oder GL_Q verwendet wird.

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

Weitere Informationen

glBegin

glEnd

glTexGen