GLGETCOLORTABLEPARAMETER

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

名前

glGetColorTableParameterfv, glGetColorTableParameteriv - 色参照テーブルのパラメータを取得する

書式

void glGetColorTableParameterfv( GLenum target,


                                   GLenum pname,
                                   GLfloat *params )

void glGetColorTableParameteriv( GLenum target,


                                   GLenum pname,
                                   GLint *params )

delim $$

引き数

target: 対象となる色テーブル。次の値のいずれかでなければならない: GL_COLOR_TABLE, GL_POST_CONVOLUTION_COLOR_TABLE, GL_POST_COLOR_MATRIX_COLOR_TABLE, GL_PROXY_COLOR_TABLE, GL_PROXY_POST_CONVOLUTION_COLOR_TABLE, GL_PROXY_POST_COLOR_MATRIX_COLOR_TABLE。
pname: 色参照テーブルのパラメータのシンボル名。次の値のいずれかでなければならない: GL_COLOR_TABLE_BIAS, GL_COLOR_TABLE_SCALE, GL_COLOR_TABLE_FORMAT, GL_COLOR_TABLE_WIDTH, GL_COLOR_TABLE_RED_SIZE, GL_COLOR_TABLE_GREEN_SIZE, GL_COLOR_TABLE_BLUE_SIZE, GL_COLOR_TABLE_ALPHA_SIZE, GL_COLOR_TABLE_LUMINANCE_SIZE, GL_COLOR_TABLE_INTENSITY_SIZE。
params: パラメータの値が格納される配列を指すポインタ。

説明

色テーブル target に固有のパラメータを返す。 pname に GL_COLOR_TABLE_SCALE または GL_COLOR_TABLE_BIAS が設定されている場合、glGetColorTableParameter は、 target が指すテーブルのスケールパラメータまたはバイアスパラメータを返す。こういった問い合わせの場合は、target には GL_COLOR_TABLE または GL_POST_CONVOLUTION_COLOR_TABLE, GL_POST_COLOR_MATRIX_COLOR_TABLE のいずれかが設定されており、かつ params が4個の要素を持つ配列を指していなければならない。この配列は赤・緑・青・アルファ値のスケール係数またはバイアス係数を受け取る(挙げた順で配列に格納される)。 glGetColorTableParameter を使って、色テーブルのフォーマットと大きさを取得することもできる。このような問い合わせの場合は、target には対象となる色テーブルまたは代理色テーブルを指定すること。フォーマットと大きさは glColorTable によって設定される。以下の表は、問い合わせを受けると思われるフォーマットと大きさを列挙したものである。以下で pname に対して挙げられているシンボル定数のそれぞれについて、params は指定された長さの配列を指し、示された値を受け取らなければならない。


パラメンター	N	意味

GL_COLOR_TABLE_FORMAT	1	内部フォーマット(例: GL_RGBA)
GL_COLOR_TABLE_WIDTH	1	テーブル内の要素数
GL_COLOR_TABLE_RED_SIZE	1	赤色要素の大きさ(ビット単位)
GL_COLOR_TABLE_GREEN_SIZE	1	緑色要素の大きさ
GL_COLOR_TABLE_BLUE_SIZE	1	青色要素の大きさ
GL_COLOR_TABLE_ALPHA_SIZE	1	アルファ値要素の大きさ
GL_COLOR_TABLE_LUMINANCE_SIZE	1	輝度要素の大きさ
GL_COLOR_TABLE_INTENSITY_SIZE	1	強度要素の大きさ

注意

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

エラー

GL_INVALID_ENUM: target または pname の値が不正な場合に起こる。 GL_INVALID_OPERATION: glBegin と、その対になる glEnd の間で glGetColorTableParameter が実行されると起こる。

jman

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

GLGETCOLORTABLEPARAMETER

名前

書式

引き数

説明

注意

エラー

関連項目

Index