Поделиться через

перечисление D2D1_CONVOLVEMATRIX_PROP (d2d1effects.h)

  • Статья

Идентификаторы свойств матричного эффекта Convolve.

Синтаксис

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 точек на дюйм.


Тип — 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
Матрица ядра, применяемая к изображению. Элементы ядра не ограничены и указываются как числа с плавающей точкой.


Первый набор чисел KernelSizeX в float[] соответствует первой строке в ядре.
Второй набор чисел 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
Указывает, применяется ли ядро свертки к альфа-каналу или только к цветовым каналам.


Если задать для этого параметра значение 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, прежде чем эффект передает значения следующему эффекту в графе. Эффект зажимает значения до предварительного развертывания альфа-канала.


Если для этого параметра задано значение TRUE, эффект будет зажимать значения. Если для этого параметра задано значение FALSE, эффект не будет зажимать значения цвета.
но другие эффекты и выходная поверхность могут зажать значения, если они не имеют достаточно высокой точности.

Тип — BOOL.

Значение по умолчанию — FALSE.
D2D1_CONVOLVEMATRIX_PROP_FORCE_DWORD
Значение: 0xffffffff

Требования

Требование Значение
Заголовок d2d1effects.h