gluScaleImage -
画像を任意の大きさに変える
GLint
gluScaleImage( GLenum
format,
GLsizei wIn,
GLsizei hIn,
GLenum typeIn,
const void *dataIn,
GLsizei wOut,
GLsizei hOut,
GLenum typeOut,
GLvoid* 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, 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 または
typeOut が
GL_UNSIGNED_BYTE_3_3_2 か
GL_UNSIGNED_BYTE_2_3_3_REV
であり、かつ
format が
GL_RGB でない場合には
GLU_INVALID_OPERATION が返される。
typeIn または
typeOut が
GL_UNSIGNED_SHORT_5_6_5 か
GL_UNSIGNED_SHORT_5_6_5_REV
であり、かつ
format が
GL_RGB でない場合には
GLU_INVALID_OPERATION が返される。
typeIn または
typeOut が
GL_UNSIGNED_SHORT_4_4_4_4 か
GL_UNSIGNED_SHORT_4_4_4_4_REV
であり、かつ
format が
GL_RGBA と
GL_BGRA の
いずれでもなければ、
GLU_INVALID_OPERATION が返される。
typeIn または
typeOut が
GL_UNSIGNED_SHORT_5_5_5_1 か
GL_UNSIGNED_SHORT_1_5_5_5_REV
であり、かつ
format が
GL_RGBA と
GL_BGRA の
いずれでもなければ、
GLU_INVALID_OPERATION が返される。
typeIn または
typeOut が
GL_UNSIGNED_INT_8_8_8_8 か
GL_UNSIGNED_INT_8_8_8_8_REV
であり、かつ
format が
GL_RGBA と
GL_BGRA の
いずれでもなければ
GLU_INVALID_OPERATION が返される。
typeIn または
typeOut が
GL_UNSIGNED_INT_10_10_10_2 か
GL_UNSIGNED_INT_2_10_10_10_REV
であり、かつ
format が
GL_RGBA と
GL_BGRA の
いずれでもなければ
GLU_INVALID_OPERATION が返される。
関連項目¶
glDrawPixels,
glReadPixels,
gluBuild1DMipmaps,
gluBuild2DMipmaps,
gluBuild3DMipmaps,
gluErrorString