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 不支持此方法。
• 将非单色纹理与卷积筛选结合使用将产生驱动程序错误。

要求

请参阅

IDirect3DDevice9Ex