gluBuild2DMipmaps 函数

gluBuild2DMipmaps 函数创建二维 mipmap。

语法

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

参数

目标

目标纹理。 必须GL_TEXTURE_2D。

components

纹理中颜色分量的数目。 必须为 1、2、3 或 4。

width

纹理图像的宽度。

height

纹理图像的高度。

format

像素数据的格式。 必须是以下项之一：GL_COLOR_INDEX、GL_RED、GL_GREEN、GL_BLUE、GL_ALPHA、GL_RGB、GL_RGBA、GL_BGR_EXT、GL_BGRA_EXT、GL_LUMINANCE或GL_LUMINANCE_ALPHA。

type

数据的数据类型。 必须是以下项之一：GL_UNSIGNED_BYTE、GL_BYTE、GL_BITMAP、GL_UNSIGNED_SHORT、GL_SHORT、GL_UNSIGNED_INT、GL_INT或GL_FLOAT。

data

指向内存中图像数据的指针。

返回值

此函数不返回值。

注解

gluBuild2DMipmaps 函数获取输入图像，并使用 gluScaleImage) 生成 (的所有 mipmap 图像，以便输入图像可用作误贴纹理图像。 若要加载每个图像，请调用 glTexImage2D。 如果输入图像的尺寸不是 2 的幂，则会缩放图像，以便在生成 mipmap 之前，宽度和高度均为 2 的幂。

返回值为零表示成功。 否则，将返回 GLU 错误代码， (请参阅 gluErrorString) 。

有关 format 参数的可接受值的说明，请参阅 glTexImage2D。 有关 类型可接受的值的说明，请参阅 glDrawPixels。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	Glu.h
库	Glu32.lib
DLL	Glu32.dll

另请参阅

glDrawPixels

glTexImage2D

gluBuild1DMipmaps

gluScaleImage