gluBuild1DMipmaps 函数

gluBuild1DMipmaps 函数创建一维 mipmap。

语法

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

参数

目标

目标纹理。 必须GL_TEXTURE_1D。

components

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

width

纹理图像的宽度。

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

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

返回值

此函数不返回值。

注解

gluBuild1DMipmaps 函数获取输入图像，并使用 gluScaleImage) 生成 (的所有 mipmap 图像，以便输入图像可用作误贴纹理图像。 然后调用 glTexImage1D 函数以加载每个图像。 如果输入图像的宽度不是 2 的幂，则会在生成 mipmap 之前将图像缩放到最接近的 2 幂。

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

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

要求

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

另请参阅

glDrawPixels

glTexImage1D

gluBuild2DMipmaps

gluScaleImage