glGetTexLevelParameterfv-Funktion

Die Funktionen glGetTexLevelParameterfv und glGetTexLevelParameteriv geben Texturparameterwerte für einen bestimmten Detailgrad zurück.

Syntax

void WINAPI glGetTexLevelParameterfv(
   GLenum  target,
   GLint   level,
   GLenum  pname,
   GLfloat *params
);

Parameter

Ziel

Der symbolische Name der Zieltextur: entweder GL_TEXTURE_1D, GL_TEXTURE_2D, GL_PROXY_TEXTURE_1D oder GL_PROXY_TEXTURE_2D.

level

Die Detailanzahl des gewünschten Bilds. Ebene 0 ist die Basisimageebene. Ebene n ist das n-th-mipmap-Reduktionsbild.

pname

Der symbolische Name eines Texturparameters. Die folgenden Parameternamen werden akzeptiert.

Wert	Bedeutung
GL_TEXTURE_WIDTH	Der parameter params gibt einen einzelnen Wert zurück, der die Breite des Texturbilds enthält. Dieser Wert enthält den Rahmen des Texturbilds.
GL_TEXTURE_HEIGHT	Der parameter params gibt einen einzelnen Wert zurück, der die Höhe des Texturbildes enthält. Dieser Wert enthält den Rahmen des Texturbilds.
GL_TEXTURE_INTERNAL_FORMAT	Der parameter params gibt einen einzelnen Wert zurück, der das Texelformat der Textur beschreibt.
GL_TEXTURE_BORDER	Der parameter params gibt einen einzelnen Wert zurück: die Breite in Pixel des Rahmens des Texturbilds.
GL_TEXTURE_RED_SIZE	Die interne Speicherauflösung der roten Komponente eines Texel. Die von OpenGL ausgewählte Auflösung entspricht der vom Benutzer angeforderten Auflösung mit dem Komponentenargument glTexImage1D oder glTexImage2D.
GL_TEXTURE_GREEN_SIZE	Die interne Speicherauflösung der grünen Komponente eines Texel. Die von OpenGL ausgewählte Auflösung entspricht der vom Benutzer angeforderten Auflösung mit dem Komponentenargument glTexImage1D oder glTexImage2D.
GL_TEXTURE_BLUE_SIZE	Die interne Speicherauflösung der blauen Komponente eines Texel. Die von OpenGL ausgewählte Auflösung entspricht der vom Benutzer angeforderten Auflösung mit dem Komponentenargument glTexImage1D oder glTexImage2D.
GL_TEXTURE_ALPHA_SIZE	Die interne Speicherauflösung der Alphakomponente eines Texel. Die von OpenGL ausgewählte Auflösung entspricht der vom Benutzer angeforderten Auflösung mit dem Komponentenargument glTexImage1D oder glTexImage2D.
GL_TEXTURE_LUMINANCE_SIZE	Die interne Speicherauflösung der Luminanzkomponente eines Texel. Die von OpenGL ausgewählte Auflösung entspricht der vom Benutzer angeforderten Auflösung mit dem Komponentenargument glTexImage1D oder glTexImage2D.
GL_TEXTURE_INTENSITY_SIZE	Die interne Speicherauflösung der Intensitätskomponente eines Texel. Die von OpenGL ausgewählte Auflösung entspricht der vom Benutzer angeforderten Auflösung mit dem Komponentenargument glTexImage1D oder glTexImage2D.
GL_TEXTURE_COMPONENTS	Der parameter params gibt einen einzelnen Wert zurück: die Anzahl der Komponenten im Texturbild.

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_VALUE	level ist kleiner als null oder größer als log2*(max)*, wobei max der zurückgegebene Wert von GL_MAX_TEXTURE_SIZE ist.
GL_INVALID_OPERATION	Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Die glGetTexLevelParameter-Funktion gibt in params Texturparameterwerte für einen bestimmten Wert der Detailebene zurück, der als Ebene angegeben ist. Der Zielparameter definiert die Zieltextur entweder GL_TEXTURE_1D, GL_TEXTURE_2D, GL_PROXY_TEXTURE_1D oder GL_PROXY_TEXTURE_2D, um eine eindimensionale oder zweidimensionale Texturierung anzugeben. Der pname-Parameter gibt den Texturparameter an, dessen Wert oder Werte zurückgegeben werden.

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

glGetTexParameter

glTexImage1D

glTexImage2D

glTexParameter