Función gluBuild1DMipmaps

La función gluBuild1DMipmaps crea mapas mip 1D.

Sintaxis

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

Parámetros

Destino

Textura de destino. Debe ser GL_TEXTURE_1D.

components

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

width

Ancho de la imagen de textura.

format

Formato de los datos de píxeles. Los siguientes valores son válidos: 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. Los valores siguientes son válidos: 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 imagen en memoria.

Valor devuelto

Esta función no devuelve ningún valor.

Observaciones

La función gluBuild1DMipmaps obtiene la imagen de entrada y genera todas las imágenes mipmap (mediante gluScaleImage) para que la imagen de entrada se pueda usar como una imagen de textura mipmapped. A continuación, se llama a la función glTexImage1D para cargar cada una de las imágenes. Si el ancho de la imagen de entrada no es una potencia de dos, la imagen se escala a la potencia más cercana 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 , consulte glTexImage1D. Para obtener una descripción de los valores aceptables para el parámetro de 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

glTexImage1D

gluBuild2DMipmaps

gluScaleImage