gluBuild2DMipmaps-Funktion
Die gluBuild2DMipmaps-Funktion erstellt 2D-Mipmaps.
Syntax
void WINAPI gluBuild2DMipmaps(
GLenum target,
GLint components,
GLint width,
GLInt height,
GLenum format,
GLenum type,
const void *data
);
Parameter
-
Ziel
-
Die Zieltextur. Muss GL_TEXTURE_2D sein.
-
components
-
Die Anzahl der Farbkomponenten in der Textur. Muss 1, 2, 3 oder 4 sein.
-
width
-
Die Breite des Texturbilds.
-
height
-
Die Höhe des Texturbilds.
-
format
-
Das Format der Pixeldaten. Muss eine der folgenden Sein: 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. Muss eine der folgenden Sein: 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 gluBuild2DMipmaps-Funktion ruft das Eingabebild ab und generiert alle mipmap-Bilder (mit gluScaleImage), sodass das Eingabebild als mipmappenfähiges Texturbild verwendet werden kann. Rufen Sie glTexImage2D auf, um jedes der Bilder zu laden. Wenn die Abmessungen des Eingabebilds keine Potenzen von zwei sind, wird das Bild skaliert, sodass sowohl die Breite als auch die Höhe Potenzen von zwei sind, bevor die Mipmaps generiert werden.
Ein Rückgabewert von 0 (null) gibt 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 glTexImage2D. Eine Beschreibung der zulässigen Werte für den Typ 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 |
|