Função gluBuild2DMipmaps

A função gluBuild2DMipmaps cria mipmaps 2D.

Sintaxe

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

Parâmetros

destino

A textura de destino. Deve ser GL_TEXTURE_2D.

Componentes

O número de componentes de cor na textura. Deve ser 1, 2, 3 ou 4.

width

A largura da imagem de textura.

altura

A altura da imagem de textura.

format

O formato dos dados de pixel. Deve ser um dos seguintes: GL_COLOR_INDEX, GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_RGB, GL_RGBA, GL_BGR_EXT, GL_BGRA_EXT, GL_LUMINANCE ou GL_LUMINANCE_ALPHA.

tipo

O tipo de dados para dados. Deve ser um dos seguintes: GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT ou GL_FLOAT.

data

Um ponteiro para os dados de imagem na memória.

Retornar valor

Essa função não retorna um valor.

Comentários

A função gluBuild2DMipmaps obtém a imagem de entrada e gera todas as imagens mipmap (usando gluScaleImage) para que a imagem de entrada possa ser usada como uma imagem de textura mipmapped. Para carregar cada uma das imagens, chame glTexImage2D. Se as dimensões da imagem de entrada não forem potências de dois, a imagem será dimensionada para que a largura e a altura sejam potências de dois antes que os mipmaps sejam gerados.

Um valor retornado de zero indica êxito. Caso contrário, um código de erro GLU será retornado (consulte gluErrorString).

Para obter uma descrição dos valores aceitáveis para o parâmetro de formato , consulte glTexImage2D. Para obter uma descrição dos valores aceitáveis para o tipo, consulte glDrawPixels.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Glu.h
Biblioteca	Glu32.lib
DLL	Glu32.dll

Confira também

glDrawPixels

glTexImage2D

gluBuild1DMipmaps

gluScaleImage