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

目的地影像的指標。

傳回值

如果此函式成功，則傳回值為零。

如果函式失敗，傳回值為 GLU 錯誤碼， (請參閱 gluErrorString) 。

備註

gluScaleImage函式會使用適當的圖元存放區模式調整圖元影像，以將來源影像中的資料解壓縮，並將資料封裝到目的地影像。

壓縮影像時， gluScaleImage 會使用方塊篩選來取樣來源影像，並建立目的地影像的圖元。 放大影像時，來源影像中的圖元會以線性方式插補，以建立目的地影像。

如需 格式、 typein和 typeout 參數可接受的值描述，請參閱 glReadPixels。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	Glu.h
程式庫	Glu32.lib
DLL	Glu32.dll

另請參閱

glDrawPixels

glReadPixels

gluBuild1DMipmaps

gluBuild2DMipmaps

gluErrorString