次の方法で共有


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 内容

関連項目

IDirect3DDevice9Ex