gluBuild2DMipmaps 函数

gluBuild2DMipmaps 函数创建 2-D 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 图像,以便输入图像可用作 mipmapped 纹理图像。 若要加载每个图像,请调用 glTexImage2D。 如果输入图像的尺寸不是两个的幂,则会缩放图像,以便在生成 mipmap 之前,宽度和高度都是两个的幂。

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

有关 格式 参数可接受的值的说明,请参阅 glTexImage2D。 有关 类型可接受的值的说明,请参阅 glDrawPixels

要求

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

Glu32.lib
DLL
Glu32.dll

另请参阅

glDrawPixels

glTexImage2D

gluBuild1DMipmaps

gluScaleImage