書式
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 または 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 が返される。