glGetTexEnvfv-Funktion

Die Funktionen glGetTexEnvfv und glGetTexEnviv geben Texturumgebungsparameter zurück.

Syntax

void WINAPI glGetTexEnvfv(
   GLenum  target,
   GLenum  pname,
   GLfloat *params
);

Parameter

Ziel

Eine Texturumgebung. Muss GL _ TEXTURE _ ENV sein.

pname

Der symbolische Name eines Texturumgebungsparameters. Die folgenden Werte werden akzeptiert.

Wert Bedeutung
GL _ TEXTURE _ ENV _ MODE
Der parameter-Parameter gibt den Umgebungsmodus für eine einwertige Textur zurück, eine symbolische Konstante.
GL _ TEXTURE _ ENV _ COLOR
Der Parameter params gibt vier ganzzahlige Werte oder Gleitkommawerte zurück, die die Farbe der Texturumgebung darstellen. Ganzzahlige Werte werden bei Anforderung linear aus der internen Gleitkommadarstellung zugeordnet, sodass 1,0 der positivsten darstellbaren ganzen Zahl und -1,0 der negativsten darstellbaren ganzen Zahl zugeordnet wird.

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
target oder pname war kein akzeptierter Wert.
GL _ INVALID _ OPERATION
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEndaufgerufen.

Hinweise

Die glGetTexEnv-Funktion gibt in params ausgewählte Werte einer Texturumgebung zurück, die mit glTexEnvangegeben wurde. Der Zielparameter gibt eine Texturumgebung an. Derzeit wird nur eine Texturumgebung definiert und unterstützt: GL _ TEXTURE _ ENV.

Der pname-Parameter benennt einen bestimmten Texturumgebungsparameter.

Wenn ein Fehler generiert wird, wird keine Änderung am Inhalt der Parameter 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

glTexEnv