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
| Plateforme cible | Windows |
| En-tête | d3d9.h |
| Bibliothèque | D3D9.lib |