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。

备注

此方法旨在筛选单个颜色纹理。 单色卷积筛选器是所有权重设置为 1.0 的 2D 盒式筛选器;筛选器内核分辨率范围为 1 x 1 到 7 x 7。 当单色纹理筛选设置为纹理采样器并在位置执行纹理采样时,Direct3D 将执行卷积。

具体限制包括:

  • 此方法指定的筛选器作为 D3DSBT_PIXELSTATE的一部分记录在状态块中。
  • 唯一支持的纹理地址模式是: D3DPTADDRESSCAPS_BORDER;边框颜色始终为 0。
  • mipmap 不支持此方法。
  • 将非单色纹理与卷积筛选结合使用将产生驱动程序错误。

要求

   
目标平台 Windows
标头 d3d9.h
Library D3D9.lib

请参阅

IDirect3DDevice9Ex