GLGETMINMAX

Section: Misc. Reference Manual Pages (3G)
索引 xjman

名前

glGetMinmax - ピクセル値の最大値および最小値を取得する

書式

void glGetMinmax( GLenum target,


                    GLboolean reset,
                    GLenum format,
                    GLenum types,
                    GLvoid *values )

引き数

target: GL_MINMAX でなければならない。
reset: GL_TRUE ならば、実際に返される minmax テーブル内の全てのエントリが初期値にリセットされる。 (他のエントリは変化しない。) GL_FALSE ならば、minmax テーブルは変化しない。
format: values に返されるデータのフォーマットを指定する。以下の値のいずれかでなければならない: GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_RGB, GL_BGR, GL_RGBA, GL_BGRA, GL_LUMINANCE, GL_LUMINANCE_ALPHA。
types: values に返されるデータの型を指定する。以下の値を指定できる: 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。
values: 返される値が格納される領域を指すポインタ。

説明

glGetMinmax は、累算された最小ピクセル値および最大ピクセル値 (コンポーネントごとに計算)を返す。返された値は幅が2の1次元のイメージに格納される。返り値の最初の集合が最小値であり、ふたつ目の集合が最大値である。返り値のフォーマットは format によって決められ、型は types によって決められる。

返り値に対してはピクセル転送操作は行なわれないが、 1次元のイメージに対して適用できるピクセル格納モードは行なわれる。指定された format で要求されたが、 minmax テーブルの内部フォーマットに含まれない色コンポーネントに対しては、0 が返される。内部的な色コンポーネントから format で要求されたコンポーネントへの割り当ては以下のように行なわれる:


内部コンポーネント	結果として得られるコンポーネント

Red	Red
Green	Green
Blue	Blue
Alpha	Alpha
Luminance	Red

reset が GL_TRUE ならば、返り値に対応する minmax テーブルのエントリは、初期値にリセットされる。 reset が GL_TRUE であっても、返されなかった最小値および最大値は更新されない。

注意

glGetMinmax が存在するのは、引き数 GL_EXTENSIONS を指定して glGetString を呼ぶと GL_ARB_imaging が返される場合だけである。

エラー

GL_INVALID_ENUM: target が GL_MINMAX でない場合に起こる。 values. GL_INVALID_ENUM: format が指定可能な値のいずれでもない場合に起こる。 values. GL_INVALID_ENUM: types が指定可能な値のいずれでもない場合に起こる。 GL_INVALID_OPERATION: glBegin と、その対になる glEnd の間で glGetMinmax が実行されると起こる。 GL_INVALID_OPERATION: types が 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 のいずれかであり、かつ format が GL_RGB でない場合に起こる。 GL_INVALID_OPERATION: types が 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 のいずれかであり、かつ format が GL_RGBA と GL_BGRA のいずれでもない場合に起こる。

jman

Time: 07:01:08 GMT, January 12, 2009

GLGETMINMAX

名前

書式

引き数

説明

注意

エラー

関連項目

Index