GLUSCALEIMAGE
Section: Misc. Reference Manual Pages (3G)
索引
xjman
名前
gluScaleImage
- 画像を任意の大きさに変える
書式
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 が返される。
関連項目
glDrawPixels(3G), glReadPixels(3G), gluBuild1DMipmaps(3G), gluBuild2DMipmaps(3G),
gluBuild3DMipmaps(3G),
gluErrorString(3G)
Index
- 名前
-
- 書式
-
- 引き数
-
- 説明
-
- 注意
-
- エラー
-
- 関連項目
-
Time: 07:01:13 GMT, January 12, 2009