Función gluBuild2DMipmaps

La función gluBuild2DMipmaps crea mapas MIP 2D.

Sintaxis

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

Parámetros

Destino

Textura de destino. Debe ser GL_TEXTURE_2D.

components

Número de componentes de color de la textura. Debe ser 1, 2, 3 o 4.

width

Ancho de la imagen de textura.

height

Alto de la imagen de textura.

format

Formato de los datos de píxeles. Debe ser uno de los siguientes: 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 de datos para los datos. Debe ser uno de los siguientes: GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT o GL_FLOAT.

data

Puntero a los datos de la imagen en la memoria.

Valor devuelto

Esta función no devuelve ningún valor.

Observaciones

La función gluBuild2DMipmaps obtiene la imagen de entrada y genera todas las imágenes de mapa mip (mediante gluScaleImage) para que la imagen de entrada se pueda usar como una imagen de textura mipmapped. Para cargar cada una de las imágenes, llame a glTexImage2D. Si las dimensiones de la imagen de entrada no son potencias de dos, la imagen se escala para que tanto el ancho como el alto sean potencias de dos antes de que se generen los mapas MIP.

Un valor devuelto de cero indica que se ha realizado correctamente. De lo contrario, se devuelve un código de error GLU (consulte gluErrorString).

Para obtener una descripción de los valores aceptables para el parámetro format , vea glTexImage2D. Para obtener una descripción de los valores aceptables para el tipo, consulte glDrawPixels.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Glu.h
Biblioteca	Glu32.lib
Archivo DLL	Glu32.dll

Consulte también

glDrawPixels

glTexImage2D

gluBuild1DMipmaps

gluScaleImage