GLGETCOLORTABLE

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

名前

glGetColorTable - 色参照テーブルの内容を取得する

書式

void glGetColorTable( GLenum target,


                        GLenum format,
                        GLenum type,
                        GLvoid *table )

引き数

target: GL_COLOR_TABLE, GL_POST_CONVOLUTION_COLOR_TABLE, GL_POST_COLOR_MATRIX_COLOR_TABLE のいずれかでなければならない。
format: table が持つピクセルデータの書式である。指定できる値は GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_LUMINANCE, GL_LUMINANCE_ALPHA, GL_RGB, GL_BGR, GL_RGBA, GL_BGRA である。
type: table が持つピクセルデータの型である。次のシンボル定数が指定できる: 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。
table: ピクセルデータの1次元配列を指すポインタである。この配列は色テーブルの内容を持つ。

説明

glGetColorTable は、target が示す色テーブルの内容を table が指す領域に返す。ピクセル転送操作は実行されないが、glReadPixels に適用できるピクセル格納モードは実行される。引き数で与えた format で要求されたが、色参照テーブルの内部フォーマットに含まれていない色要素は 0 として返される。内部的な色要素から format で要求された要素への割り当ては次のように行なわれる:


内部要素	得られる要素

赤	赤
緑	緑
青	青
アルファ値	アルファ値
輝度	赤
強度	赤

注意

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

エラー

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

jman

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

GLGETCOLORTABLE

名前

書式

引き数

説明

注意

エラー

関連項目

Index