gluBuild1DMipmaps-Funktion
Die gluBuild1DMipmaps-Funktion erstellt 1-D-Mipmaps.
Syntax
void WINAPI gluBuild1DMipmaps(
GLenum target,
GLint components,
GLint width,
GLenum format,
GLenum type,
const void *data
);
Parameter
-
Ziel
-
Die Zieltextur. Muss GL_TEXTURE_1D sein.
-
components
-
Die Anzahl der Farbkomponenten in der Textur. Muss 1, 2, 3 oder 4 sein.
-
width
-
Die Breite des Texturbilds.
-
format
-
Das Format der Pixeldaten. Die folgenden Werte sind gültig: GL_COLOR_INDEX, GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_RGB, GL_RGBA, GL_BGR_EXT, GL_BGRA_EXT, GL_LUMINANCE oder GL_LUMINANCE_ALPHA.
-
type
-
Der Datentyp für Daten. Die folgenden Werte sind gültig: GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT oder GL_FLOAT.
-
data
-
Ein Zeiger auf die Bilddaten im Arbeitsspeicher.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Bemerkungen
Die gluBuild1DMipmaps-Funktion ruft das Eingabebild ab und generiert alle mipmap-Bilder (mit gluScaleImage), sodass das Eingabebild als mipmappenfähiges Texturbild verwendet werden kann. Die funktion glTexImage1D wird dann aufgerufen, um die einzelnen Images zu laden. Wenn die Breite des Eingabebilds keine Leistung von zwei ist, wird das Bild auf die nächste Leistung von zwei skaliert, bevor die mipmaps generiert werden.
Ein Rückgabewert von 0 zeigt den Erfolg an. Andernfalls wird ein GLU-Fehlercode zurückgegeben (siehe gluErrorString).
Eine Beschreibung der zulässigen Werte für den Formatparameter finden Sie unter glTexImage1D. Eine Beschreibung der zulässigen Werte für den Typparameter finden Sie unter glDrawPixels.
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 |
|