GLGETHISTOGRAM

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

名前

glGetHistogram - ヒストグラムのテーブルを取得する

 

書式

void glGetHistogram( GLenum target, 

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

 

引き数

target
GL_HISTOGRAM でなければならない。
reset
GL_TRUE の場合には、実際に返される各要素のカウンタが 0 にリセットされる。 (他のカウンタは影響を受けない。) GL_FALSE の場合には、ヒストグラムのテーブル中のどのカウンタ も変更されない。
format
values に返された値のフォーマット。 次の値のいずれかでなければならない: GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_RGB, GL_BGR, GL_RGBA, GL_BGRA, GL_LUMINANCE, GL_LUMINANCE_ALPHA。
type
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
 

説明

glGetHistogram はヒストグラムの現在のテーブルを1次元のイメージ として返す。 このイメージはヒストグラムと同じ幅を持つ。 このイメージに対してはピクセル転送操作は実行されないが、 1次元のイメージに適用できるピクセル格納モードは適用される。

format で要求されたが、ヒストグラムの内部フォーマットに 含まれていない色要素については 0 が返される。 内部的な色要素から format で要求された要素への割り当ては 次の表の通りである:

内部要素得られる要素
RedRed
GreenGreen
BlueBlue
AlphaAlpha
LuminanceRed

 

注意

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

 

エラー

GL_INVALID_ENUM: target が GL_HISTOGRAM でない場合に起こる。 GL_INVALID_ENUM: format の値が不正な場合に起こる。 GL_INVALID_ENUM: type の値が不正な場合に起こる。 GL_INVALID_OPERATION: glBegin と、その対になる glEnd の間で glGetHistogram が実行されると起こる。 GL_INVALID_OPERATION: type が 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: type が 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 のいずれでもない場合に起こる。  

関連項目

glHistogram(3G), glResetHistogram(3G), glGetHistogramParameter(3G)

 

Index

名前
書式
引き数
説明
注意
エラー
関連項目

jman


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