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. Es muss eine der folgenden Werte vorhanden 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 die Daten. Folgendes muss 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 Mipmapbilder (mithilfe von gluScaleImage),damit das Eingabebild als mipmappeniertes Texturbild verwendet werden kann. Rufen Sie glTexImage2Dauf, um die einzelnen Bilder zu laden. Wenn die Abmessungen des Eingabebilds keine Zweierstärken sind, wird das Bild so skaliert, dass sowohl die Breite als auch die Höhe die Zweierleistung sind, bevor die Mipmaps generiert werden.
Der Rückgabewert 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.
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 |
|