glGetTexLevelParameteriv-Funktion
Die Funktionen glGetTexLevelParameterfv und glGetTexLevelParameteriv geben Texturparameterwerte für einen bestimmten Detailgrad zurück.
Syntax
void WINAPI glGetTexLevelParameteriv(
GLenum target,
GLint level,
GLenum pname,
GLint *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 |
|---|---|
|
target oder pname war kein akzeptierter Wert. |
|
level ist kleiner als null oder größer als log2*(max)*, wobei max der zurückgegebene Wert von GL_MAX_TEXTURE_SIZE ist. |
|
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 |
|
| Bibliothek |
|
| DLL |
|