Condividi tramite


Funzione gluBuild2DMipmaps

La funzione gluBuild2DMipmaps crea mipmap 2D.

Sintassi

void WINAPI gluBuild2DMipmaps(
         GLenum target,
         GLint  components,
         GLint  width,
         GLInt  height,
         GLenum format,
         GLenum type,
   const void   *data
);

Parametri

target

Trama di destinazione. Deve essere GL_TEXTURE_2D.

Componenti

Numero di componenti di colore nella trama. Deve essere 1, 2, 3 o 4.

width

Larghezza dell'immagine della trama.

height

Altezza dell'immagine della trama.

format

Formato dei dati pixel. Deve essere uno dei seguenti: GL_COLOR_INDEX, GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_RGB, GL_RGBA, GL_BGR_EXT, GL_BGRA_EXT, GL_LUMINANCE o GL_LUMINANCE_ALPHA.

type

Tipo di dati per i dati. Deve essere uno dei seguenti: GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT o GL_FLOAT.

data

Puntatore ai dati dell'immagine in memoria.

Valore restituito

Questa funzione non restituisce un valore.

Commenti

La funzione gluBuild2DMipmaps ottiene l'immagine di input e genera tutte le immagini mipmap (usando gluScaleImage) in modo che l'immagine di input possa essere usata come immagine di trama mipmapped. Per caricare ognuna delle immagini, chiamare glTexImage2D. Se le dimensioni dell'immagine di input non sono potenze di due, l'immagine viene ridimensionata in modo che sia la larghezza che l'altezza siano potenze di due prima che vengano generate le mipmap.

Un valore restituito pari a zero indica l'esito positivo. In caso contrario, viene restituito un codice di errore GLU (vedere gluErrorString).

Per una descrizione dei valori accettabili per il parametro di formato , vedere glTexImage2D. Per una descrizione dei valori accettabili per il tipo, vedere glDrawPixels.

Requisiti

Requisito Valore
Client minimo supportato
Windows 2000 Professional [solo app desktop]
Server minimo supportato
Windows 2000 Server [solo app desktop]
Intestazione
Glu.h
Libreria
Glu32.lib
DLL
Glu32.dll

Vedi anche

glDrawPixels

glTexImage2D

gluBuild1DMipmaps

gluScaleImage