glTexParameterf-Funktion
Legt Texturparameter fest.
Syntax
void WINAPI glTexParameterf(
GLenum target,
GLenum pname,
GLfloat param
);
Parameter
-
Ziel
-
Die Zieltextur, die entweder GL _ TEXTURE _ 1D oder GL _ TEXTURE _ 2D sein muss.
-
pname
-
Der symbolische Name eines einwertigen Texturparameters. Die folgenden Symbole werden in pname akzeptiert.
Wert Bedeutung - GL _ TEXTURE _ MIN _ FILTER
Die Texturverkleinerungsfunktion wird immer dann verwendet, wenn das zu texturierende Pixel einem Bereich zugeordnet wird, der größer als ein Texturelement ist. Es gibt sechs definierte Vergrößerungsfunktionen. Zwei von ihnen verwenden das nächste oder die nächsten vier Texturelemente, um den Texturwert zu berechnen. Die anderen vier verwenden Mipmaps.
Eine Mipmap ist eine geordnete Gruppe von Arrays, die das gleiche Bild mit progressiv niedrigeren Auflösungen darstellen. Wenn die Textur die Abmessungen 2nx2m aufweist, gibt es max(n, m) + 1 mipmaps. Die erste Mipmap ist die ursprüngliche Textur mit den Abmessungen 2nx2m. Jede nachfolgende Mipmap hat die Abmessungen 2k1x2l1, wobei 2kx2l die Dimensionen der vorherigen Mipmap sind, bis entweder k = 0 oder l = 0 ist. An diesem Punkt haben nachfolgende Mipmaps die Dimension 1x2l1 oder 2k1x1 bis zur endgültigen Mipmap, die die Dimension 1x1 aufweist. Mipmaps werden mit glTexImage1D oder glTexImage2D definiert, wobei das Detailebenenargument die Reihenfolge der Mipmaps angibt. Ebene 0 ist die ursprüngliche Textur. level bold max(n, m) ist die endgültige 1x1-Mipmap.- GL _ TEXTURE _ MAG _ FILTER
Die Texturvergrößerungsfunktion wird verwendet, wenn das texturierte Pixel einem Bereich zugeordnet wird, der kleiner oder gleich einem Texturelement ist. Die Texturvergrößerungsfunktion wird entweder auf GL _ NEAREST oder GL _ LINEAR festgelegt. - GL _ TEXTURE _ WRAP _ S
Legt den Wrap-Parameter für Texturkoordinaten entweder auf GL _ WRAP oder GL REPEAT _ fest. GL WRAP bewirkt, dass die Koordinaten von an _ den Bereich 0,1 geklammern werden, und ist nützlich, um das [ ] Umschließen von Artefakten zu verhindern, wenn ein einzelnes Bild einem Objekt zugeordnet wird. GL _ REPEAT bewirkt, dass der ganzzahlige Teil der Koordinate ignoriert wird. OpenGL verwendet nur den Bruchteil, wodurch ein sich wiederholendes Muster erstellt wird. Auf Rahmentexturelemente wird nur zugegriffen, wenn wrapping auf GL WRAP festgelegt _ ist. Zunächst wird GL _ TEXTURE WRAP S auf GL REPEAT _ _ _ festgelegt. - GL _ TEXTURE _ WRAP _ T
Legt den Wrap-Parameter für die Texturkoordinate t entweder auf GL _ WRAP oder GL REPEAT _ fest. Weitere Informationen finden Sie in der Diskussion unter GL _ TEXTURE _ WRAP _ S. Anfänglich ist GL _ TEXTURE WRAP T auf GL _ _ REPEAT festgelegt. _ -
param
-
Der Wert von pname.
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 keiner der akzeptierten definierten Werte, oder wenn param über einen definierten konstanten Wert verfügen sollte (basierend auf dem Wert von pname) und nicht. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEndaufgerufen. |
Bemerkungen
Texturzuordnung ist eine Technik, bei der ein Bild auf die Oberfläche eines Objekts angewendet wird, als wäre das Bild ein Decal oder Cellophane Shrink Wrap. Das Bild wird im Texturraum mit einem Koordinatensystem (s, t) erstellt. Eine Textur ist ein ein- oder zweidimensionales Bild und eine Reihe von Parametern, die bestimmen, wie Stichproben vom Bild abgeleitet werden.
Die glTexParameter-Funktion weist den Wert oder die Werte in Parametern dem Texturparameter zu, der als pname angegeben ist. Der Zielparameter definiert die Zieltextur, entweder GL _ TEXTURE _ 1D oder GL _ TEXTURE _ 2D.
Wenn mehr Texturelemente im Minification-Prozess entnommen werden, sind weniger Aliasartefakte erkennbar. Die _ Gl NEAREST- und GL _ LINEAR- Minification-Funktionen können zwar schneller sein als die anderen vier, aber sie stichprobenieren nur ein oder vier Texturelemente, um den Texturwert des zu renderenden Pixels zu bestimmen, und können Mintermuster oder unregelmäßige Übergänge erzeugen. Der Standardwert von GL _ TEXTURE MIN FILTER ist GL _ _ _ NEAREST _ MIPMAP _ LINEAR.
Angenommen, die Texturierung ist aktiviert (durch Aufrufen von glEnable mit dem Argument GL _ TEXTURE _ 1D oder GL _ TEXTURE _ 2D) und GL _ TEXTURE MIN FILTER ist auf eine der Funktionen _ _ festgelegt, die eine Mipmap erfordern. Wenn die Dimensionen der aktuell definierten Texturbilder (mit vorherigen Aufrufen von glTexImage1D oder glTexImage2D)nicht der richtigen Sequenz für Mipmaps folgen oder weniger Texturbilder definiert sind, als benötigt werden, oder der Satz von Texturbildern eine unterschiedliche Anzahl von Texturkomponenten aufweist, ist es so, als ob die Texturzuordnung deaktiviert wäre. Die lineare Filterung greift nur in 2D-Texturen auf die vier nächstgelegenen Texturelemente zu. In 1D-Texturen greift die lineare Filterung auf die beiden nächsten Texturelemente zu. Die folgende Funktion ruft Informationen im Zusammenhang mit glTexParameterf, glTexParameteri, glTexParameterfv und glTexParameteriv ab.
Requirements (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 |
|