GLGETCONVOLUTIONFILTER

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

名前

glGetConvolutionFilter 現在の 1D または 2D の畳み込みフィルタのカーネルを取得する  

書式

void glGetConvolutionFilter( GLenum target, 

                               GLenum format,
                               GLenum type,
                               GLvoid *image )

 

引き数

target
取得するフィルタ。 GL_CONVOLUTION_1D または GL_CONVOLUTION_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, GL_UNSIGNED_INT_2_10_10_10_REV。
image
出力されるイメージが格納される場所を指すポインタ。
 

説明

glGetConvolutionFilter は、現在の 1D または 2D の 畳み込みフィルタのカーネルをイメージとして返す。 1次元または2次元のイメージは、format および type による 指定に従って、image に格納される。 このイメージには、ピクセル転送操作が実行されることはないが、 関連するピクセル格納モードは適用される。

format には含まれるが、フィルタの内部フォーマットには含まれない 色要素については、0 が返される。 内部的な色要素から format の色要素への割り当ては以下の 表のように行なわれる。

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

注意

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

エラー

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

関連する取得値

glGetConvolutionParameter  

関連項目

glGetSeparableFilter(3G), glConvolutionParameter(3G), glConvolutionFilter1D(3G), glConvolutionFilter2D(3G)

 

Index

名前
書式
引き数
説明
注意
エラー
関連する取得値
関連項目

jman


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