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

Préparez l’échantillonneur de texture pour le filtrage de convolution monochrome sur une texture unicolore.

Syntaxe

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

Paramètres

[in] width

Type : UINT

Largeur du noyau de filtre ; allant de 1 à D3DCONVOLUTIONMONO_MAXWIDTH. La valeur par défaut est 1.

[in] height

Type : UINT

Hauteur du noyau de filtre ; comprise entre 1 et D3DCONVOLUTIONMONO_MAXHEIGHT. La valeur par défaut est 1.

[in] rows

Type : float*

Tableau de pondérations, un poids pour chaque sous-élément du noyau dans la largeur. Ce paramètre doit être NULL, ce qui définit les pondérations égales à la valeur par défaut.

[in] columns

Type : float*

Tableau de pondérations, un poids pour chaque sous-élément du noyau dans la hauteur. Ce paramètre doit être NULL, ce qui définit les pondérations égales à la valeur par défaut.

Valeur retournée

Type : HRESULT

Si la méthode réussit, la valeur de retour est D3D_OK.

Notes

Cette méthode est conçue pour filtrer une texture de couleur unique. Un filtre de convolution monochrome est un filtre de boîte 2D dont toutes les pondérations sont définies sur 1.0 ; la résolution du noyau de filtre varie de 1 x 1 à 7 x 7. Lorsque le filtrage de texture monochrome est défini sur un échantillonneur de texture et que l’échantillonnage de texture est effectué à l’emplacement, Direct3D effectue la convolution.

Les restrictions sont les suivantes :

• Le filtre spécifié par cette méthode est enregistré dans les blocs d’état dans le cadre de D3DSBT_PIXELSTATE.
• Le seul mode d’adresse de texture pris en charge est : D3DPTADDRESSCAPS_BORDER ; la couleur de bordure est toujours 0.
• Cette méthode n’est pas prise en charge pour les mipmaps.
• L’utilisation d’une texture non monochrome avec filtrage de convolution génère une erreur de pilote.

Spécifications

Voir aussi

IDirect3DDevice9Ex