IDirect3DDevice9Ex::SetConvolutionMonoKernel メソッド (d3d9.h)
単色テクスチャでモノクロ畳み込みフィルター処理を行うテクスチャ サンプラーを準備します。
構文
HRESULT SetConvolutionMonoKernel(
[in] UINT width,
[in] UINT height,
[in] float *rows,
[in] float *columns
);
パラメーター
[in] width
型: UINT
フィルター カーネルの幅。1 ~ D3DCONVOLUTIONMONO_MAXWIDTHの範囲。 既定値は 1 です。
[in] height
型: UINT
フィルター カーネルの高さ。1 ~ D3DCONVOLUTIONMONO_MAXHEIGHTの範囲。 既定値は 1 です。
[in] rows
型: float*
重みの配列。幅のカーネル サブ要素ごとに 1 つの重み。 このパラメーターは NULL である必要があります。これにより、重みが既定値と等しくなります。
[in] columns
型: float*
重みの配列。高さのカーネル サブ要素ごとに 1 つの重み。 このパラメーターは NULL である必要があります。これにより、重みが既定値と等しくなります。
戻り値
種類: HRESULT
メソッドが成功した場合、戻り値はD3D_OK。
解説
このメソッドは、単一の色のテクスチャをフィルター処理するように設計されています。 モノクロ畳み込みフィルターは、すべての重みが1.0に設定された2Dボックスフィルタです。フィルター カーネルの解像度は 1 x 1 から 7 x 7 の範囲です。 モノクロ テクスチャ フィルタリングがテクスチャ サンプラーに設定され、テクスチャ サンプリングが場所で実行されると、Direct3D は畳み込みを実行します。
次のような制約があります。
- このメソッドで指定されたフィルターは、 D3DSBT_PIXELSTATEの一部として状態ブロックに記録されます。
- サポートされているテクスチャ アドレス モードは、 D3DPTADDRESSCAPS_BORDERのみです。罫線の色は常に 0 です。
- このメソッドは、ミップマップではサポートされていません。
- 畳み込みフィルター処理で非モノクロ テクスチャを使用すると、ドライバー エラーが生成されます。
要件
対象プラットフォーム | Windows |
ヘッダー | d3d9.h |
Library | D3D9.lib |