共用方式為


D2D1_CONVOLVEMATRIX_PROP列舉 (d2d1effects.h)

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

常數

 
D2D1_CONVOLVEMATRIX_PROP_KERNEL_UNIT_LENGTH
值: 0
核心中一個單位的大小。 單位位於 (DIP/核心單位) ,其中核心單位是卷積核心中元素的大小。
1 (DIP/核心單位的值) 對應至 96 DPI 影像中的一個圖元。


此類型為 FLOAT。

預設值為 1.0f。
D2D1_CONVOLVEMATRIX_PROP_SCALE_MODE
值: 1
效果用來將影像調整為對應的核心單位長度的插補模式。 品質與速度有六種調整模式。


類型D2D1_CONVOLVEMATRIX_SCALE_MODE。

預設值為 D2D1_CONVOLVEMATRIX_SCALE_MODE_LINEAR。
D2D1_CONVOLVEMATRIX_PROP_KERNEL_SIZE_X
值: 2
核心矩陣的寬度。 這些單位會以核心單位指定。


此類型為UINT32。

預設值是 3。
D2D1_CONVOLVEMATRIX_PROP_KERNEL_SIZE_Y
值: 3
核心矩陣的高度。 這些單位會以核心單位指定。


此類型為UINT32。

預設值是 3。
D2D1_CONVOLVEMATRIX_PROP_KERNEL_MATRIX
值: 4
要套用至映像的核心矩陣。 核心元素不會系結,而且會指定為浮點數。


FLOAT[] 中的第一組 KernelSizeX 數位會對應至核心中的第一個數據列。
第二組 KernelSizeX 數字會對應至第二個數據列,依此類傳至 KernelSizeY 數據列。

此類型為 FLOAT[]。

默認值為 {0.0f、0.0f、0.0f、0.0f、1.0f、0.0f、0.0f、0.0f、0.0f}。
D2D1_CONVOLVEMATRIX_PROP_DIVISOR
值: 5
核心矩陣會套用至像素,然後結果會除以此值。


0 的行為會當做 float epsilon 的值。

此類型為 FLOAT。

預設值為 1.0f。
D2D1_CONVOLVEMATRIX_PROP_BIAS
值: 6
效果會套用核心矩陣、除數,然後將偏差新增至結果。 偏差未系結且無單位。


此類型為 FLOAT。

預設值為 0.0f。
D2D1_CONVOLVEMATRIX_PROP_KERNEL_OFFSET
值: 7
將捲積核心從輸出圖元上置中的位置移轉至您指定左/右和向上/向下的位置。 位移是以核心單位定義。


使用某些位移和核心大小時,卷積核心的樣本不會落在圖元影像中心。 核心樣本的圖元值是透過雙向插補來計算。

類型D2D1_VECTOR_2F。

默認值為 {0.0f, 0.0f}。
D2D1_CONVOLVEMATRIX_PROP_PRESERVE_ALPHA
值: 8
指定卷積核心是套用至 Alpha 色板還是只套用色彩通道。


如果您將此設定為TRUE,則捲積核心只會套用至色彩通道。

如果您將此設定為 FALSE,則捲積核心會套用至所有通道。

此類型為 BOOL。

預設值為 FALSE。
D2D1_CONVOLVEMATRIX_PROP_BORDER_MODE
值: 9
用來計算影像框線、軟式或硬式的模式。


類型D2D1_BORDER_MODE。

預設值為 D2D1_BORDER_MODE_SOFT。
D2D1_CONVOLVEMATRIX_PROP_CLAMP_OUTPUT
值: 10
效果是否會在效果將值傳遞至圖形中的下一個效果之前,將色彩值限制在 0 到 1 之間。 效果會先限制值,再預先乘以Alpha。


如果您將此設定為TRUE,效果將會限制值。 如果您將此設定為 FALSE,效果將不會限制色彩值。
但其他效果和輸出介面可能會如果值不夠高,則可能會限制這些值。

此類型為 BOOL。

預設值為 FALSE。
D2D1_CONVOLVEMATRIX_PROP_FORCE_DWORD
值: 0xffffffff

規格需求

需求
標頭 d2d1effects.h