gluScaleImage(3) 画像を任意の大きさに変える

書式

GLint gluScaleImage( GLenum format,


GLsizei wIn,
GLsizei hIn,
GLenum typeIn,
const void *dataIn,
GLsizei wOut,
GLsizei hOut,
GLenum typeOut,
GLvoid* dataOut )

delim $$

引き数

format
ピクセルデータを指定する。 有効なシンボル値は次の通りである: GL_COLOR_INDEX, GL_STENCIL_INDEX, GL_DEPTH_COMPONENT, GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_RGB, GL_RGBA, GL_BGR, GL_BGRA, GL_LUMINANCE, GL_LUMINANCE_ALPHA
wIn, hIn
入力画像の高さと幅をピクセル単位で指定する。
typeIn
dataIn のデータ型を指定する。 次の型のどれかでなければならない: GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT, GL_FLOAT, GL_UNSIGNED_BYTE_3_3_2, GL_UNSIGNED_BYTE_2_3_3_REV, GL_UNSIGNED_SHORT_5_6_5, GL_UNSIGNED_SHORT_5_6_5_REV, GL_UNSIGNED_SHORT_4_4_4_4, GL_UNSIGNED_SHORT_4_4_4_4_REV, GL_UNSIGNED_SHORT_5_5_5_1, GL_UNSIGNED_SHORT_1_5_5_5_REV, GL_UNSIGNED_INT_8_8_8_8, GL_UNSIGNED_INT_8_8_8_8_REV, GL_UNSIGNED_INT_10_10_10_2, GL_UNSIGNED_INT_2_10_10_10_REV
dataIn
入力画像を指すポインタを指定する。
wOut, hOut
出力画像の高さと幅をピクセル単位で指定する。
typeOut
dataOut のデータ型を指定する。 次の型のどれかでなければならない: GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT, GL_FLOAT, GL_UNSIGNED_BYTE_3_3_2, GL_UNSIGNED_BYTE_2_3_3_REV, GL_UNSIGNED_SHORT_5_6_5, GL_UNSIGNED_SHORT_5_6_5_REV, GL_UNSIGNED_SHORT_4_4_4_4, GL_UNSIGNED_SHORT_4_4_4_4_REV, GL_UNSIGNED_SHORT_5_5_5_1, GL_UNSIGNED_SHORT_1_5_5_5_REV, GL_UNSIGNED_INT_8_8_8_8, GL_UNSIGNED_INT_8_8_8_8_REV, GL_UNSIGNED_INT_10_10_10_2, GL_UNSIGNED_INT_2_10_10_10_REV
dataOut
出力画像を指すポインタを指定する。

説明

gluScaleImage はピクセル画像のサイズを変更する。 この際には適切なピクセル格納モードを用いて入力画像からデータを取り出し、 出力画像にデータを格納する。

画像を縮小する際には、gluScaleImage はボックスフィルタを 用いて入力画像をサンプリングし、出力画像用のピクセルを生成する。 画像を拡大する際には、入力画像のピクセルには線形補間が行われ、 出力画像が生成される。

返り値が 0 の場合は成功を表し、それ以外の場合は GLU のエラーコードが返 される(gluErrorString を参照)。

引き数 format, typeIn, typeOut に指定可能な値に ついては、glReadPixels の項目を参照すること。

注意

フォーマット GL_BGR, GL_BGRA および型 GL_UNSIGNED_BYTE_3_3_2, GL_UNSIGNED_BYTE_2_3_3_REV, GL_UNSIGNED_SHORT_5_6_5, GL_UNSIGNED_SHORT_5_6_5_REV, GL_UNSIGNED_SHORT_4_4_4_4, GL_UNSIGNED_SHORT_4_4_4_4_REV, GL_UNSIGNED_SHORT_5_5_5_1, GL_UNSIGNED_SHORT_1_5_5_5_REV, GL_UNSIGNED_INT_8_8_8_8, GL_UNSIGNED_INT_8_8_8_8_REV, GL_UNSIGNED_INT_10_10_10_2, and GL_UNSIGNED_INT_2_10_10_10_REV が指定できるのは、バージョン 1.2 以降の GL だけである。

エラー

wIn, hIn, wOut, hOut のいずれかが負の場合には GLU_INVALID_VALUE が返される。

format, typeIn, typeOut のいずれかの値が 不正な場合には GLU_INVALID_ENUM が返される。

typeIn または typeOutGL_UNSIGNED_BYTE_3_3_2GL_UNSIGNED_BYTE_2_3_3_REV であり、かつ formatGL_RGB でない場合には GLU_INVALID_OPERATION が返される。

typeIn または typeOutGL_UNSIGNED_SHORT_5_6_5GL_UNSIGNED_SHORT_5_6_5_REV であり、かつ formatGL_RGB でない場合には GLU_INVALID_OPERATION が返される。

typeIn または typeOutGL_UNSIGNED_SHORT_4_4_4_4GL_UNSIGNED_SHORT_4_4_4_4_REV であり、かつ formatGL_RGBAGL_BGRA の いずれでもなければ、GLU_INVALID_OPERATION が返される。

typeIn または typeOutGL_UNSIGNED_SHORT_5_5_5_1GL_UNSIGNED_SHORT_1_5_5_5_REV であり、かつ formatGL_RGBAGL_BGRA の いずれでもなければ、GLU_INVALID_OPERATION が返される。

typeIn または typeOutGL_UNSIGNED_INT_8_8_8_8GL_UNSIGNED_INT_8_8_8_8_REV であり、かつ formatGL_RGBAGL_BGRA の いずれでもなければ GLU_INVALID_OPERATION が返される。

typeIn または typeOutGL_UNSIGNED_INT_10_10_10_2GL_UNSIGNED_INT_2_10_10_10_REV であり、かつ formatGL_RGBAGL_BGRA の いずれでもなければ GLU_INVALID_OPERATION が返される。