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

関連項目

IDirect3DDevice9Ex