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

Prepare o sampler de textura para filtragem de convolução monocromática em uma textura de cor única.

Sintaxe

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

Parâmetros

[in] width

Tipo: UINT

A largura do kernel de filtro; variando de 1 a D3DCONVOLUTIONMONO_MAXWIDTH. O valor padrão é 1.

[in] height

Tipo: UINT

A altura do kernel de filtro; variando de 1 a D3DCONVOLUTIONMONO_MAXHEIGHT. O valor padrão é 1.

[in] rows

Tipo: float*

Uma matriz de pesos, um peso para cada subelemento de kernel na largura. Esse parâmetro deve ser NULL, que definirá os pesos iguais ao valor padrão.

[in] columns

Tipo: float*

Uma matriz de pesos, um peso para cada subelemento de kernel na altura. Esse parâmetro deve ser NULL, que definirá os pesos iguais ao valor padrão.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK.

Comentários

Esse método foi projetado para filtrar uma única textura de cor. Um filtro de convolução monocromática é um filtro de caixa 2D com todos os pesos definidos como 1,0; a resolução do kernel de filtro varia de 1 x 1 a 7 x 7. Quando a filtragem de textura monocromática é definida como um amostrador de textura e a amostragem de textura é executada no local, o Direct3D executa a convolução.

As restrições incluem:

  • O filtro especificado por esse método é registrado em blocos de estado como parte de D3DSBT_PIXELSTATE.
  • O único modo de endereço de textura com suporte é: D3DPTADDRESSCAPS_BORDER; a cor da borda é sempre 0.
  • Não há suporte para esse método em mipmaps.
  • O uso de uma textura não monocromática com filtragem de convolução gerará um erro de driver.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho d3d9.h
Biblioteca D3D9.lib

Confira também

Idirect3ddevice9ex