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*

權數陣列，寬度中的每個核心子項目各有一個權數。 此參數必須是 Null，其會將權數設定為等於預設值。

[in] columns

類型： float*

加權陣列，高度中每個核心子專案的一個權數。 此參數必須是 Null，其會將權數設定為等於預設值。

傳回值

類型： HRESULT

如果方法成功，傳回值會D3D_OK。

備註

此方法的設計目的是要篩選單一色彩紋理。 單色卷積篩選是 2D 方塊篩選，擁有權數都設定為 1.0;篩選核心解析度的範圍從 1 x 1 到 7 x 7。 當單色紋理篩選設定為紋理取樣器，並在位置執行紋理取樣時，Direct3D 會執行卷積。

限制包含：

  • 這個方法指定的篩選會記錄在狀態欄塊中，作為 D3DSBT_PIXELSTATE的一部分。
  • 唯一支援的紋理位址模式為： D3DPTADDRESSCAPS_BORDER;框線色彩一律為 0。
  • mipmap 不支援這個方法。
  • 使用具有卷積篩選的非單色紋理會產生驅動程式錯誤。

需求

   
目標平台 Windows
標頭 d3d9.h
程式庫 D3D9.lib

另請參閱

IDirect3DDevice9Ex