GLGETSEPARABLEFILTER

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

名前

glGetSeparableFilter - 分割可能な畳み込みフィルタのカーネルイメージを返す

書式

void glGetSeparableFilter( GLenum target,


                             GLenum format,
                             GLenum type,
                             GLvoid *row,
                             GLvoid *column,
                             GLvoid *span )

引き数

target: 取得する分割可能なフィルタを指定する。 GL_SEPARABLE_2D でなければならない。
format: 出力するイメージのフォーマットを指定する。次のいずれかの値でなければならない: GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_RGB, GL_BGR GL_RGBA, GL_BGRA, GL_LUMINANCE, GL_LUMINANCE_ALPHA。
type: 出力イメージにおける、要素のデータ型を指定する。次のシンボル定数が指定可能である: 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, and GL_UNSIGNED_INT_2_10_10_10_REV。
row: 行フィルタイメージが格納されるメモリ領域を指すポインタ。
column: 列フィルタイメージが格納されるメモリ領域を指すポインタ。
span: スパンフィルタイメージが格納されるメモリ領域を指すポインタ (現在は未使用である)。

説明

glGetSeparableFilter は、現在の分割可能な 2次元畳み込みフィルタに対応する、ふたつの1次元フィルタカーネルを返す。 format および type の指定にもとづき、行イメージは row に返され、列イメージは column に返される。 (現在の実装では span はまったく影響しない。) このイメージに対してはピクセル転送操作ままったく行なわれないが、当てはまるピクセル格納モードは適用される。

format には含まれるがフィルタの内部フォーマットには含まれない色要素については、0 が値として返される。色要素の内部フォーマットから format の要素への代入は以下のように行なわれる:


内部要素	結果として得る要素

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

注意

glGetSeparableFilter が存在するのは、引き数 GL_EXTENSIONS を指定して glGetString を呼んだ際に GL_ARB_imaging が返される場合だけである。分割不可能な2次元フィルタは、glGetConvolutionFilter を使って取得しなければならない。

エラー

GL_INVALID_ENUM: target が GL_SEPARABLE_2D でない場合に起こる。 GL_INVALID_ENUM: format の値が不正な場合に起こる。 GL_INVALID_ENUM: type の値が不正な場合に起こる。 glBegin と、その対になる glEnd の間で glGetSeparableFilter を実行すると起こる。

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 のいずれでもない場合に起こる。

jman

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

GLGETSEPARABLEFILTER

名前

書式

引き数

説明

注意

エラー

関連する取得値

関連項目

Index