IDirect3DDevice9Ex::SetConvolutionMonoKernel
単一色のテクスチャー上でモノクロの畳み込みフィルタリング用のテクスチャー サンプラーを準備します。
HRESULT
SetConvolutionMonoKernel(
UINT Width,
UINT Height,
float *RowWeights,
float *ColumnWeights
);
パラメータ
- Width
フィルター カーネルの幅 (1 ~ D3DCONVOLUTIONMONO_MAXWIDTH)。既定値は 1 です。 - Height
フィルター カーネルの高さ (1 ~ D3DCONVOLUTIONMONO_MAXHEIGHT)。既定値は 1 です。 - RowWeights
一連の重みから構成される配列 (幅のカーネル サブ要素ごとに重みは 1 つ)。このパラメーターは、NULL(重みが既定値に設定される) でなければなりません。 - ColumnWeights
一連の重みから構成される配列 (高さのカーネル サブ要素ごとに重みは 1 つ)。このパラメーターは、NULL(重みが既定値に設定される) でなければなりません。
戻り値
メソッドが成功した場合は、D3D_OK を返します。
解説
このメソッドは、単一色のテクスチャーをフィルタリングするためのものです。モノクロの畳み込みフィルターは、すべての重みを 1.0 に設定した 2D ボックス フィルターです。フィルター カーネルの解像度は 1 x 1 ~ 7 x 7 の範囲です。モノクロのテクスチャー フィルタリングをテクスチャー サンプラーに設定し、位置に対してテクスチャー サンプリングを実行すると、Direct3D によって畳み込みが実行されます。
次のような制限があります。
- このメソッドによって指定されたフィルターは、D3DSBT_PIXELSTATE の一部として状態ブロックに記録される。
- サポートされている唯一のテクスチャー アドレス モードは D3DPTADDRESSCAPS_BORDER で、境界色は必ず 0 です。
- このメソッドは、ミップマップに対してはサポートされていません。
- 畳み込みフィルタリングでモノクロ以外のテクスチャーを使用すると、ドライバー エラーになります。
要件
ヘッダー: D3d9.h 宣言
ライブラリ: D3D9.lib 内容