Bezeichnung
gl.GetTexLevelParameter -- gibt Texturparameterwerte für einen bestimmten Detaillierungsgrad zurück
Übersicht
param = gl.GetTexLevelParameter(target, level, pname)
Beschreibung
gl.GetTexLevelParameter() gibt Texturparameterwerte für einen bestimmten Detailstufenwert zurück, der als level angegeben ist. target definiert die Zieltextur, entweder #GL_TEXTURE_1D, #GL_TEXTURE_2D, #GL_PROXY_TEXTURE_1D oder #GL_PROXY_TEXTURE_2D.

#GL_MAX_TEXTURE_SIZE ist nicht wirklich beschreibend genug. Sie muss das größte quadratische Texturbild melden, das mit Mipmaps und Rändern aufgenommen werden kann, aber eine lange dünne Textur oder eine Textur ohne Mipmaps und Ränder kann leicht in den Texturspeicher passen. Die Proxy-Ziele ermöglichen es dem Benutzer, genauer abzufragen, ob GL eine Textur einer bestimmten Konfiguration aufnehmen kann. Wenn die Textur nicht untergebracht werden kann, werden die Texturzustandsvariablen, die mit gl.GetTexLevelParameter() abgefragt werden können, auf 0 gesetzt. Die Option Textur kann angepasst werden, die Werte für den Texturzustand werden so gesetzt, wie sie für ein Nicht-Proxy-Ziel gesetzt würden.

pname gibt den Texturparameter an, dessen Wert oder Werte zurückgegeben werden. Die akzeptierten Parameternamen lauten wie folgt:

#GL_TEXTURE_WIDTH
Der Parameter gibt einen Einzelwert zurück: Die Breite des Texturbildes. Dieser Wert beinhaltet den Rand des Texturbildes. Der Anfangswert ist 0.

#GL_TEXTURE_HEIGHT
Der Parameter gibt einen Einzelwert zurück: Die Höhe des Texturbildes. Dieser Wert beinhaltet den Rand des Texturbildes. Der Anfangswert ist 0.

#GL_TEXTURE_DEPTH
Der Parameter gibt einen Einzelwert zurück: Die Tiefe des Texturbildes. Dieser Wert beinhaltet den Rand des Texturbildes. Der Anfangswert ist 0.

#GL_TEXTURE_INTERNAL_FORMAT
Der Parameter gibt einen Einzelwert mit dem internen Format des Texturbildes zurück.

#GL_TEXTURE_BORDER
Der Parameter gibt einen Einzelwert zurück: Die Breite in Pixel des Randes des Texturbildes. Der Anfangswert ist 0.

#GL_TEXTURE_XXX_SIZE
Die interne Speicherauflösung einer einzelnen Komponente (XXX kann RED, GREEN, BLUE, ALPHA, LUMINANCE, INTENSITY, DEPTH sein). Die vom GL gewählte Auflösung entspricht weitgehend der vom Benutzer geforderten Auflösung mit dem Komponentenargument gl.TexImage1D(), gl.TexImage2D() und gl.CopyTexImage(). Der Anfangswert ist 0.

Weitere Informationen finden Sie in einem OpenGL-Referenzhandbuch.

Eingaben
target
gibt den symbolischen Namen der Zieltextur an, entweder #GL_TEXTURE_1D, #GL_TEXTURE_2D, #GL_PROXY_TEXTURE_1D oder #GL_PROXY_TEXTURE_2D
level
gibt die Detaillierungsstufe des gewünschten Bildes an; Level 0 ist die Basisbildebene; Level n ist das n-te Mipmap-Reduktionsbild
pname
gibt den symbolischen Namen eines Texturparameters an (siehe oben für mögliche Werte)
Rückgabewerte
param
angeforderte Daten
Fehler
#GL_INVALID_ENUM wird erzeugt, wenn target oder pname kein akzeptierter Wert ist.

#GL_INVALID_VALUE wird generiert, wenn level kleiner als 0 ist.

#GL_INVALID_VALUE kann erzeugt werden, wenn level größer als ld(max) ist, wobei max der zurückgegebene Wert von #GL_MAX_TEXTURE_SIZE ist.

#GL_INVALID_OPERATION wird erzeugt, wenn gl.GetTexLevelParameter() zwischen gl.Begin() und gl.End() ausgeführt wird.


Navigation zeigen