GLUSCALEIMAGE(3G)

名前
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