GLCONVOLUTIONPARAMETER

名前

書式

                                GLenum pname,
                                GLfloat params )

                                GLenum pname,
                                GLint params )

delim $$

引き数

target

畳み込みパラメータの対象。 GL_CONVOLUTION_1D, GL_CONVOLUTION_2D, GL_SEPARABLE_2D のいずれかでなければならない。

pname

設定するパラメータ。 GL_CONVOLUTION_BORDER_MODE でなければならない。

params

パラメータの値。 GL_REDUCE, GL_CONSTANT_BORDER, GL_REPLICATE_BORDER のいずれかでなければならない。

書式

                                 GLenum pname,
                                 const GLfloat *params )

                                 GLenum pname,
                                 const GLint *params )

引き数

target

畳み込みパラメータの対象。 GL_CONVOLUTION_1D, GL_CONVOLUTION_2D, GL_SEPARABLE_2D のいずれかでなければならない。

pname

設定するパラメータ。 GL_CONVOLUTION_BORDER_MODE, GL_CONVOLUTION_BORDER_COLOR, GL_CONVOLUTION_FILTER_SCALE, GL_CONVOLUTION_FILTER_BIAS のいずれかでなければならない。

params

パラメータの値。 pname が GL_CONVOLUTION_BORDER_MODE の場合、 params は GL_REDUCE, GL_CONSTANT_BORDER, GL_REPLICATE_BORDER のいずれかでなければならない。 それ以外の場合、params は 4 個の値(赤、緑、青、アルファ値) を持つベクトルでなければならない。 このベクトルは、 畳み込みフィルタカーネルのスケーリング処理(pname が GL_CONVOLUTION_FILTER_SCALE の場合は) または畳み込みフィルタカーネルのバイアス処理(pname が GL_CONVOLUTION_FILTER_BIAS の場合)、 定数境界色の設定 (pname が GL_CONVOLUTION_BORDER_COLOR の場合)のいずれかでなければならない。

説明

target は、影響を与える畳み込みフィルタを選択する: 1D フィルタの場合は GL_CONVOLUTION_1D, 2D フィルタの場合は GL_CONVOLUTION_2D, 分割可能 2D フィルタの場合は GL_SEPARABLE_2D を指定する。

pname は変更するパラメータを指定する。 GL_CONVOLUTION_FILTER_SCALE と GL_CONVOLUTION_FILTER_BIAS は畳み込みフィルタカーネルの定義に影響する。 詳しくは glConvolutionFilter1D, glConvolutionFilter2D, glSeparableFilter2D を参照すること。 これらの場合、params は 4 つの値を持つ配列であり、 それぞれの値は赤、緑、青、アルファ値に適用される。 GL_CONVOLUTION_FILTER_SCALE に対する初期値は (1, 1, 1, 1) であり、 GL_CONVOLUTION_FILTER_BIAS に対する初期値は (0, 0, 0, 0) である。

GL_CONVOLUTION_BORDER_MODE の pname 値は、 畳み込みの境界モードを指定する。 以下の値を指定できる:

GL_REDUCE

畳み込みの結果として得られるイメージは入力イメージより小さい。 フィルタの幅が $Wf$, 高さが $Hf$, 入力イメージの幅が $Ws$, 高さが $Hs$ ならば、 畳み込み処理されたイメージの幅は $Ws ~-~ Wf ~+~ 1$ となり、 高さは $Hs ~-~ Hf ~+~ 1$ となる。 (この縮小によりイメージの幅や高さが 0 以下になる場合、出力は単に 空になる。 エラーは出力されない。) 畳み込みの結果として得られるイメージの座標は、 幅方向では 0 から $Ws ~-~ Wf$ となり、 高さ方向では 0 から $Hs ~-~ Hf$ となる。

GL_CONSTANT_BORDER

畳み込みの結果得られるイメージは入力イメージと同じサイズになる。 GL_CONVOLUTION_BORDER_COLOR で指定された色のピクセルで 入力イメージが囲まれるような処理が行われる。

GL_REPLICATE_BORDER

畳み込みの結果得られるイメージは入力イメージと同じサイズになる。 入力イメージの境界の最も外側にあるピクセルが複製されるような処理が 行われる。

注意

エラー

関連する取得値

関連項目

Index

名前

書式

引き数

書式

引き数

説明

注意

エラー

関連する取得値

関連項目