Metodo IDirect3DDevice9Ex::SetConvolutionMonoKernel (d3d9.h)

Preparare il campionatore di trama per il filtro di convoluzione monocromatica in base a una trama a colore singolo.

Sintassi

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

Parametri

[in] width

Tipo: UINT

Larghezza del kernel del filtro; compreso tra 1 e D3DCONVOLUTIONMONO_MAXWIDTH. Il valore predefinito è 1.

[in] height

Tipo: UINT

Altezza del kernel del filtro; compreso tra 1 e D3DCONVOLUTIONMONO_MAXHEIGHT. Il valore predefinito è 1.

[in] rows

Tipo: float*

Matrice di pesi, un peso per ogni sottoelemento del kernel nella larghezza. Questo parametro deve essere NULL, che imposterà i pesi uguali al valore predefinito.

[in] columns

Tipo: float*

Matrice di pesi, un peso per ogni sottoelemento del kernel nell'altezza. Questo parametro deve essere NULL, che imposterà i pesi uguali al valore predefinito.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito viene D3D_OK.

Commenti

Questo metodo è progettato per filtrare una singola trama di colore. Un filtro di convoluzione monocromatico è un filtro casella 2D con tutti i pesi impostati su 1,0; la risoluzione del kernel del filtro varia da 1 x 1 a 7 x 7. Quando il filtro delle trame monocromatico è impostato su un campionatore di trama e il campionamento delle trame viene eseguito nella posizione, Direct3D esegue la convoluzione.

Tali restrizioni includono:

• Il filtro specificato da questo metodo viene registrato nei blocchi di stato come parte di D3DSBT_PIXELSTATE.
• L'unica modalità indirizzo trama supportata è: D3DPTADDRESSCAPS_BORDER; il colore del bordo è sempre 0.
• Questo metodo non è supportato per mipmaps.
• L'uso di una trama non monocromatica con il filtro di convoluzione genererà un errore del driver.

Requisiti

Vedi anche

IDirect3DDevice9Ex