gluScaleImage 函数

gluScaleImage 函数将图像缩放为任意大小。

语法

int WINAPI gluScaleImage(
         GLenum format,
         GLint  widthin,
         GLint  heightin,
         GLenum typein,
   const void   *datain,
         GLint  widthout,
         GLint  heightout,
         GLenum typeout,
         void   *dataout
);

参数

format

像素数据的格式。 以下符号值有效：GL_COLOR_INDEX、GL_STENCIL_INDEX、GL_DEPTH_COMPONENT、GL_RED、GL_GREEN、GL_BLUE、GL_ALPHA、GL_RGB、GL_RGBA、GL_BGR_EXT、GL_BGRA_EXT、GL_LUMINANCE和GL_LUMINANCE_ALPHA。

widthin

缩放的源图像的宽度。

heightin

缩放的源图像的高度。

typein

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

datain

指向源图像的指针。

widthout

目标图像的宽度。

heightout

目标图像的高度。

typeout

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

dataout

指向目标图像的指针。

返回值

如果函数成功，则返回值为 0。

如果函数失败，则返回值为 GLU 错误代码， (请参阅 gluErrorString) 。

备注

gluScaleImage 函数使用适当的像素存储模式缩放像素图像，以从源图像解包数据并将数据打包到目标图像中。

收缩图像时， gluScaleImage 使用框筛选器对源图像进行采样并为目标图像创建像素。 放大图像时，将线性内插源图像中的像素以创建目标图像。

有关 format、 typein 和 typeout 参数的可接受值的说明，请参阅 glReadPixels。

要求

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

另请参阅

glDrawPixels

glReadPixels

gluBuild1DMipmaps

gluBuild2DMipmaps

gluErrorString