Partager via


énumération D2D1_CONVOLVEMATRIX_PROP (d2d1effects.h)

Identificateurs des propriétés de l’effet de matrice convolve.

Syntax

typedef enum D2D1_CONVOLVEMATRIX_PROP {
  D2D1_CONVOLVEMATRIX_PROP_KERNEL_UNIT_LENGTH = 0,
  D2D1_CONVOLVEMATRIX_PROP_SCALE_MODE = 1,
  D2D1_CONVOLVEMATRIX_PROP_KERNEL_SIZE_X = 2,
  D2D1_CONVOLVEMATRIX_PROP_KERNEL_SIZE_Y = 3,
  D2D1_CONVOLVEMATRIX_PROP_KERNEL_MATRIX = 4,
  D2D1_CONVOLVEMATRIX_PROP_DIVISOR = 5,
  D2D1_CONVOLVEMATRIX_PROP_BIAS = 6,
  D2D1_CONVOLVEMATRIX_PROP_KERNEL_OFFSET = 7,
  D2D1_CONVOLVEMATRIX_PROP_PRESERVE_ALPHA = 8,
  D2D1_CONVOLVEMATRIX_PROP_BORDER_MODE = 9,
  D2D1_CONVOLVEMATRIX_PROP_CLAMP_OUTPUT = 10,
  D2D1_CONVOLVEMATRIX_PROP_FORCE_DWORD = 0xffffffff
} ;

Constantes

 
D2D1_CONVOLVEMATRIX_PROP_KERNEL_UNIT_LENGTH
Valeur : 0
Taille d’une unité dans le noyau. Les unités se trouvent dans (dips/unité de noyau), où une unité de noyau est la taille de l’élément dans le noyau de convolution.
La valeur 1 (unité DIP/noyau) correspond à un pixel dans une image à 96 PPP.


Le type est FLOAT.

La valeur par défaut est 1.0f.
D2D1_CONVOLVEMATRIX_PROP_SCALE_MODE
Valeur : 1
Mode d’interpolation utilisé par l’effet pour mettre à l’échelle l’image à la longueur d’unité de noyau correspondante. Il existe six modes d’échelle qui varient en qualité et en vitesse.


Le type est D2D1_CONVOLVEMATRIX_SCALE_MODE.

La valeur par défaut est D2D1_CONVOLVEMATRIX_SCALE_MODE_LINEAR.
D2D1_CONVOLVEMATRIX_PROP_KERNEL_SIZE_X
Valeur : 2
Largeur de la matrice du noyau. Les unités sont spécifiées dans les unités de noyau.


Le type est UINT32.

La valeur par défaut est 3.
D2D1_CONVOLVEMATRIX_PROP_KERNEL_SIZE_Y
Valeur : 3
Hauteur de la matrice du noyau. Les unités sont spécifiées dans les unités de noyau.


Le type est UINT32.

La valeur par défaut est 3.
D2D1_CONVOLVEMATRIX_PROP_KERNEL_MATRIX
Valeur : 4
Matrice du noyau à appliquer à l’image. Les éléments du noyau ne sont pas limités et sont spécifiés en tant que floats.


Le premier ensemble de nombres KernelSizeX dans float[] correspond à la première ligne du noyau.
Le deuxième ensemble de nombres KernelSizeX correspond à la deuxième ligne, et ainsi de suite jusqu’aux lignes KernelSizeY.

Le type est FLOAT[].

La valeur par défaut est {0.0f, 0.0f, 0.0f, 0.0f, 1.0f, 0.0f, 0.0f, 0.0f, 0.0f}.
D2D1_CONVOLVEMATRIX_PROP_DIVISOR
Valeur : 5
La matrice du noyau est appliquée à un pixel, puis le résultat est divisé par cette valeur.


0 se comporte comme une valeur de float epsilon.

Le type est FLOAT.

La valeur par défaut est 1.0f.
D2D1_CONVOLVEMATRIX_PROP_BIAS
Valeur : 6
L’effet applique la matrice du noyau, le diviseur, puis le biais est ajouté au résultat. Le biais est illimité et sans unité.


Le type est FLOAT.

La valeur par défaut est 0,0f.
D2D1_CONVOLVEMATRIX_PROP_KERNEL_OFFSET
Valeur : 7
Déplace le noyau de convolution d’une position centrée sur le pixel de sortie vers une position que vous spécifiez à gauche/droite et haut/bas. Le décalage est défini dans les unités du noyau.


Avec certains décalages et tailles de noyau, les échantillons du noyau de convolution n’atterrissent pas sur un centre d’images en pixels. Les valeurs de pixels de l’exemple de noyau sont calculées par interpolation bilinéaire.

Le type est D2D1_VECTOR_2F.

La valeur par défaut est {0.0f, 0.0f}.
D2D1_CONVOLVEMATRIX_PROP_PRESERVE_ALPHA
Valeur : 8
Spécifie si le noyau de convolution est appliqué au canal alpha ou uniquement aux canaux de couleur.


Si vous définissez cette valeur sur TRUE, le noyau de convolution est appliqué uniquement aux canaux de couleur.

Si vous définissez cette valeur sur FALSE, le noyau de convolution est appliqué à tous les canaux.

Le type est BOOL.

La valeur par défaut est FALSE.
D2D1_CONVOLVEMATRIX_PROP_BORDER_MODE
Valeur : 9
Mode utilisé pour calculer la bordure de l’image, soft ou hard.


Le type est D2D1_BORDER_MODE.

La valeur par défaut est D2D1_BORDER_MODE_SOFT.
D2D1_CONVOLVEMATRIX_PROP_CLAMP_OUTPUT
Valeur : 10
Indique si l’effet restreint les valeurs de couleur entre 0 et 1 avant que l’effet ne passe les valeurs à l’effet suivant dans le graphique. L’effet restreint les valeurs avant de prémultiplier l’alpha.


Si vous définissez cette valeur sur TRUE, l’effet restreint les valeurs. Si vous définissez cette valeur sur FALSE, l’effet ne restreint pas les valeurs de couleur,
mais d’autres effets et la surface de sortie peuvent serrer les valeurs si elles ne sont pas suffisamment précises.

Le type est BOOL.

La valeur par défaut est FALSE.
D2D1_CONVOLVEMATRIX_PROP_FORCE_DWORD
Valeur : 0xffffffff

Configuration requise

Condition requise Valeur
En-tête d2d1effects.h