Share via


D2D1_CONVOLVEMATRIX_PROP-Enumeration (d2d1effects.h)

Bezeichner für Eigenschaften des Convolve-Matrixeffekts.

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
} ;

Konstanten

 
D2D1_CONVOLVEMATRIX_PROP_KERNEL_UNIT_LENGTH
Wert: 0
Die Größe einer Einheit im Kernel. Die Einheiten befinden sich in (DIPs/Kernel-Einheit), wobei eine Kerneleinheit die Größe des Elements im Faltungskern entspricht.
Ein Wert von 1 (DIP/Kerneleinheit) entspricht einem Pixel in einem Bild bei 96 DPI.


Der Typ ist FLOAT.

Der Standardwert ist 1.0f.
D2D1_CONVOLVEMATRIX_PROP_SCALE_MODE
Wert: 1
Der Interpolationsmodus, den der Effekt verwendet, um das Image auf die entsprechende Kerneleinheitslänge zu skalieren. Es gibt sechs Skalierungsmodi, die in Qualität und Geschwindigkeit liegen.


Der Typ ist D2D1_CONVOLVEMATRIX_SCALE_MODE.

Der Standardwert ist D2D1_CONVOLVEMATRIX_SCALE_MODE_LINEAR.
D2D1_CONVOLVEMATRIX_PROP_KERNEL_SIZE_X
Wert: 2
Die Breite der Kernelmatrix. Die Einheiten werden in Kerneleinheiten angegeben.


Der Typ ist UINT32.

Der Standardwert ist 3.
D2D1_CONVOLVEMATRIX_PROP_KERNEL_SIZE_Y
Wert: 3
Die Höhe der Kernelmatrix. Die Einheiten werden in Kerneleinheiten angegeben.


Der Typ ist UINT32.

Der Standardwert ist 3.
D2D1_CONVOLVEMATRIX_PROP_KERNEL_MATRIX
Wert: 4
Die Kernelmatrix, die auf das Image angewendet werden soll. Die Kernelelemente sind nicht begrenzt und werden als Floats angegeben.


Der erste Satz von KernelSizeX-Zahlen im FLOAT[] entspricht der ersten Zeile im Kernel.
Der zweite Satz von KernelSizeX-Zahlen entspricht der zweiten Zeile und so weiter bis zu KernelSizeY-Zeilen.

Der Typ ist FLOAT[].

Der Standardwert ist {0.0f, 0.0f, 0.0f, 0.0f, 1.0f, 0.0f, 0.0f, 0.0f, 0.0f}.
D2D1_CONVOLVEMATRIX_PROP_DIVISOR
Wert: 5
Die Kernelmatrix wird auf ein Pixel angewendet, und dann wird das Ergebnis durch diesen Wert geteilt.


0 verhält sich als Wert von float epsilon.

Der Typ ist FLOAT.

Der Standardwert ist 1.0f.
D2D1_CONVOLVEMATRIX_PROP_BIAS
Wert: 6
Der Effekt wendet die Kernelmatrix, den Divisor an, und dann wird die Bias dem Ergebnis hinzugefügt. Die Verzerrung ist ungebunden und einheitslos.


Der Typ ist FLOAT.

Der Standardwert ist 0.0f.
D2D1_CONVOLVEMATRIX_PROP_KERNEL_OFFSET
Wert: 7
Verschiebt den Faltungskern von einer zentrierten Position auf dem Ausgabepixel in eine position, die Sie nach links/rechts und nach oben/unten angeben. Der Offset wird in Kerneleinheiten definiert.


Bei einigen Offsets und Kernelgrößen landen die Beispiele des Convolution-Kernels nicht in einem Pixelbildzentrum. Die Pixelwerte für das Kernelbeispiel werden durch bilineare Interpolation berechnet.

Der Typ ist D2D1_VECTOR_2F.

Der Standardwert ist {0.0f, 0.0f}.
D2D1_CONVOLVEMATRIX_PROP_PRESERVE_ALPHA
Wert: 8
Gibt an, ob der Faltungskern auf den Alphakanal oder nur auf die Farbkanäle angewendet wird.


Wenn Sie dies auf TRUE festlegen, wird der Faltungskern nur auf die Farbkanäle angewendet.

Wenn Sie dies auf FALSE festlegen, wird der Convolution-Kernel auf alle Kanäle angewendet.

Der Typ ist BOOL.

Der Standardwert ist FALSE.
D2D1_CONVOLVEMATRIX_PROP_BORDER_MODE
Wert: 9
Der Modus, der zum Berechnen des Rahmens des Bilds verwendet wird, weich oder hart.


Der Typ ist D2D1_BORDER_MODE.

Der Standardwert ist D2D1_BORDER_MODE_SOFT.
D2D1_CONVOLVEMATRIX_PROP_CLAMP_OUTPUT
Wert: 10
Gibt an, ob der Effekt Farbwerte zwischen 0 und 1 klemmt, bevor der Effekt die Werte an den nächsten Effekt im Diagramm übergibt. Der Effekt klemmt die Werte, bevor er das Alpha vormultipliziert.


Wenn Sie dies auf TRUE festlegen, klammert der Effekt die Werte ein. Wenn Sie dies auf FALSE festlegen, klammert der Effekt die Farbwerte nicht ein.
aber andere Effekte und die Ausgabeoberfläche können die Werte klammern, wenn sie nicht von hoher Genauigkeit sind.

Der Typ ist BOOL.

Der Standardwert ist FALSE.
D2D1_CONVOLVEMATRIX_PROP_FORCE_DWORD
Wert: 0xffffffff

Anforderungen

Anforderung Wert
Header d2d1effects.h