glGetTexLevelParameterfv-Funktion

Die Funktionen glGetTexLevelParameterfv und glGetTexLevelParameteriv geben Texturparameterwerte für eine bestimmte Detailebene zurück.

Syntax

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

Parameter

Ziel

Der symbolische Name der Zieltextur: GL _ TEXTURE _ 1D, GL _ TEXTURE _ 2D, GL _ PROXY TEXTURE _ _ 1D oder GL _ PROXY TEXTURE _ _ 2D.

level

Die Detailebenennummer des gewünschten Bilds. Ebene 0 ist die Basisimageebene. Ebene n ist das n-te Mipmap-Reduzierungsbild.

pname

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

Wert Bedeutung
GL _ _ TEXTURBREITE
Der Parameter params gibt einen einzelnen Wert zurück, der die Breite des Texturbilds enthält. Dieser Wert schließt den Rahmen des Texturbilds ein.
GL _ _ TEXTURHÖHE
Der Parameter params gibt einen einzelnen Wert zurück, der die Höhe des Texturbilds enthält. Dieser Wert schließt den Rahmen des Texturbilds ein.
INTERNES _ _ _ GL-TEXTURFORMAT
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 des Rahmens des Texturbilds in Pixel.
GL _ TEXTURE _ RED _ SIZE
Die interne Speicherauflösung der roten Komponente eines Texels. Die von OpenGL gewählte Auflösung ist eine enge Übereinstimmung mit 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 gewählte Auflösung ist eine enge Übereinstimmung mit der vom Benutzer angeforderten Auflösung mit dem Komponentenargument glTexImage1D oder glTexImage2D.
GL _ _ _ TEXTURBLAUE GRÖßE
Die interne Speicherauflösung der blauen Komponente eines Texels. Die von OpenGL gewählte Auflösung ist eine enge Übereinstimmung mit der vom Benutzer angeforderten Auflösung mit dem Komponentenargument glTexImage1D oder glTexImage2D.
GL _ TEXTURE _ ALPHA _ SIZE
Die interne Speicherauflösung der Alphakomponente eines Texels. Die von OpenGL gewählte Auflösung ist eine enge Übereinstimmung mit der vom Benutzer angeforderten Auflösung mit dem Komponentenargument glTexImage1D oder glTexImage2D.
GL _ TEXTUR _ LUDOMINANZGRÖßE _
Die interne Speicherauflösung der Leuchtdichtekomponente eines Texels. Die von OpenGL gewählte Auflösung ist eine enge Übereinstimmung mit der vom Benutzer angeforderten Auflösung mit dem Komponentenargument glTexImage1D oder glTexImage2D.
GL _ TEXTURE _ INTENSITY _ SIZE
Die interne Speicherauflösung der Intensitätskomponente eines Texels. Die von OpenGL gewählte Auflösung ist eine enge Übereinstimmung mit der vom Benutzer angeforderten Auflösung mit dem Komponentenargument glTexImage1D oder glTexImage2D.
_ _ GL-TEXTURKOMPONENTEN
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 _ UNGÜLTIGER _ WERT
level ist kleiner als 0 (null) oder größer als Protokoll 2 (max), wobei max der zurückgegebene Wert von GL _ MAX TEXTURE SIZE _ _ ist.
UNGÜLTIGER _ _ GL-VORGANG
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Hinweise

Die glGetTexLevelParameter-Funktion gibt in Parametertexturparameterwerten für einen bestimmten Detailebenenwert 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 eindimensionale oder zweidimensionale Textur anzugeben. Der pname-Parameter gibt den Texturparameter an, dessen Wert oder Werte zurückgegeben werden.

Wenn ein Fehler generiert wird, werden keine Änderungen 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

Weitere Informationen

glBegin

glEnd

glGetTexParameter

glTexImage1D

glTexImage2D

glTexParameter