glGetTexEnvfv-Funktion

Artikel
06/13/2023

Die Funktionen glGetTexEnvfvv 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 params gibt den einwertigen Texturumgebungsmodus zurück, eine symbolische Konstante.
GL_TEXTURE_ENV_COLOR	Der parameter params gibt vier ganzzahlige oder gleitkommawerte zurück, die die Texturumgebungsfarbe sind. Ganzzahlwerte werden bei Anforderung linear aus der internen Gleitkommadarstellung zugeordnet, sodass 1,0 der positivsten darstellbaren Ganzzahl und -1,0 der negativsten darstellbaren Ganzen 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 glEnd aufgerufen.

Bemerkungen

Die glGetTexEnv-Funktion gibt in Params ausgewählte Werte einer Texturumgebung zurück, die mit glTexEnv angegeben wurde. Der Zielparameter gibt eine Texturumgebung an. Derzeit wird nur eine Texturumgebung definiert und unterstützt: GL_TEXTURE_ENV.

Der Parameter pname benennt einen bestimmten Texturumgebungsparameter.

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
glTexEnv

Freigeben über