функция обратного вызова PFND3DDDI_SETCONVOLUTIONKERNELMONO (d3dumddi.h)

Функция SetConvolutionKernelMono определяет разрешение и вес фильтра ядра, который используется при установке режима фильтрации текстур D3DTEXF_CONVOLUTIONMONO.

Синтаксис

PFND3DDDI_SETCONVOLUTIONKERNELMONO Pfnd3dddiSetconvolutionkernelmono;

HRESULT Pfnd3dddiSetconvolutionkernelmono(
  HANDLE hDevice,
  const D3DDDIARG_SETCONVOLUTIONKERNELMONO *unnamedParam2
)
{...}

Параметры

hDevice

Дескриптор устройства отображения (графический контекст).

unnamedParam2

pData [in]

Указатель на структуру D3DDDIARG_SETCONVOLUTIONKERNELMONO , описывающую параметры для задания ядра монохромной свертки.

Возвращаемое значение

SetConvolutionKernelMono возвращает одно из следующих значений:

Комментарии

D3DTEXF_CONVOLUTIONMONO — это режим фильтрации текстур, который используется для выборки монохромных текстур (то есть текстур, отформатированных в виде одного бита на пиксель (D3DDDIFMT_A1)). В среде выполнения Direct3D 9.L фильтр свертки является двумерным фильтром коробки (то есть все весовые коэффициенты = 1,0). Однако функция SetConvolutionKernelMono определена для поддержки более общего фильтра. Если для D3DTEXF_CONVOLUTIONMONO задано средство выборки текстур, состояния выборки текстур D3DTSS_MIPFILTER, D3DTSS_MINFILTER и D3DTSS_MAGFILTER игнорируются. Адрес текстуры D3DTADDRESS_BORDER с цветом границы 0 должен применяться в этом режиме фильтрации. Драйвер отображения пользовательского режима должен возвращать ошибку или игнорировать отрисованный примитив, если этот режим фильтрации используется с немонохромной текстурой.

Для выполнения свертки используется следующая формула:

Result = Sum(i=0, i <N_v)[ (R_i*(1 - альфа) + R_i+1*alpha) * S)]

Rk = Sum(j=0, j <N_u)[T_k,j*(1 - beta) + T_k,j+1*beta], где 0 < k < N_v

S = 1 / (N_u * N_v)

N_u и N_v — это ширина и высота ядра фильтра.

T_i,j — это образцы текстур из монохромной текстуры в расположении (i, j).

Точность операций фильтрации должна быть не менее 6 бит.

Интерполированные значения координат текстуры (U, V) в центре пикселей являются координатами центра ядра фильтра.

Координаты верхнего левого примера ядра фильтра (U_f,Vf) вычисляются следующим образом:

U_f = U * TextureWidth - N_u * 0,5

V_f = V * TextureHeight - N_v * 0,5

Следующее действие

beta = U_f - усечение(U_f)

alpha = V_f - усечение(V_f)

Требования

См. также раздел

D3DDDIARG_SETCONVOLUTIONKERNELMONO

D3DDDI_DEVICEFUNCS