gluBuild1DMipmaps-Funktion

Die gluBuild1DMipmaps-Funktion erstellt 1D-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 die 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 Mipmapbilder (mithilfe von gluScaleImage), sodass das Eingabebild als mipmapped-Texturbild verwendet werden kann. Die glTexImage1D-Funktion wird dann aufgerufen, um jedes der Bilder zu laden. Wenn die Breite des Eingabebilds keine Zweierstärke ist, wird das Bild auf die nächste Zweierstärke skaliert, 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 glTexImage1D. Eine Beschreibung der zulässigen Werte für den Typparameter 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
Glu.h
Bibliothek
Glu32.lib
DLL
Glu32.dll

Weitere Informationen

glDrawPixels

glTexImage1D

gluBuild2DMipmaps

gluScaleImage