Método IDirect3DDevice9Ex::SetConvolutionMonoKernel (d3d9.h)

  • Artículo

Prepare el muestreador de texturas para el filtrado de convolución monocromática en una textura de un solo color.

Sintaxis

HRESULT SetConvolutionMonoKernel(
  [in] UINT  width,
  [in] UINT  height,
  [in] float *rows,
  [in] float *columns
);

Parámetros

[in] width

Tipo: UINT

Ancho del kernel de filtro; de 1 a D3DCONVOLUTIONMONO_MAXWIDTH. El valor predeterminado es 1.

[in] height

Tipo: UINT

Alto del kernel de filtro; comprendido entre 1 y D3DCONVOLUTIONMONO_MAXHEIGHT. El valor predeterminado es 1.

[in] rows

Tipo: float*

Matriz de pesos, un peso para cada subelemento de kernel en el ancho. Este parámetro debe ser NULL, que establecerá los pesos iguales al valor predeterminado.

[in] columns

Tipo: float*

Matriz de pesos, un peso para cada subelemento de kernel en el alto. Este parámetro debe ser NULL, que establecerá los pesos iguales al valor predeterminado.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es D3D_OK.

Comentarios

Este método está diseñado para filtrar una sola textura de color. Un filtro de convolución monocromática es un filtro de caja 2D con todos los pesos establecidos en 1,0; la resolución del kernel de filtro oscila entre 1 x 1 y 7 x 7. Cuando el filtrado de texturas monocromáticas se establece en un muestreador de textura y el muestreo de textura se realiza en la ubicación, Direct3D realiza la convolución.

Entre las restricciones se incluyen:

  • El filtro especificado por este método se registra en bloques de estado como parte de D3DSBT_PIXELSTATE.
  • El único modo de dirección de textura admitido es: D3DPTADDRESSCAPS_BORDER; el color del borde siempre es 0.
  • Este método no se admite para mapas mip.
  • El uso de una textura no monocromática con filtrado de convolución generará un error de controlador.

Requisitos

   
Plataforma de destino Windows
Encabezado d3d9.h
Library D3D9.lib

Consulte también

IDirect3DDevice9Ex