Метод IDirect3DDevice9Ex::SetConvolutionMonoKernel (d3d9.h)

  • Статья

Подготовьте средство выборки текстур для фильтрации монохромных свертки по одноцветной текстуре.

Синтаксис

HRESULT SetConvolutionMonoKernel(
  [in] UINT  width,
  [in] UINT  height,
  [in] float *rows,
  [in] float *columns
);

Параметры

[in] width

Тип: UINT

Ширина ядра фильтра; в диапазоне от 1 до D3DCONVOLUTIONMONO_MAXWIDTH. Значение по умолчанию — 1.

[in] height

Тип: UINT

Высота ядра фильтра; в диапазоне от 1 до D3DCONVOLUTIONMONO_MAXHEIGHT. Значение по умолчанию — 1.

[in] rows

Тип: float*

Массив весов, по одному весу для каждого подэлетера ядра в ширину. Этот параметр должен иметь значение NULL, что позволит задать весовые коэффициенты, равные значению по умолчанию.

[in] columns

Тип: float*

Массив весов, по одному весу для каждого подэлеента ядра в высоте. Этот параметр должен иметь значение NULL, что позволит задать весовые коэффициенты, равные значению по умолчанию.

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

Тип: HRESULT

Если метод выполнен успешно, возвращаемое значение будет D3D_OK.

Комментарии

Этот метод предназначен для фильтрации одноцветной текстуры. Монохромный фильтр свертки — это двухмерный фильтр коробки со всеми весами, равными 1,0; разрешение ядра фильтра в диапазоне от 1 x 1 до 7 x 7. Если для монохромной фильтрации текстур задано средство выборки текстур, а выборка текстур выполняется в расположении, Direct3D выполняет свертки.

К ним относятся указанные ниже ограничения.

  • Фильтр, заданный этим методом, записывается в блоки состояний как часть D3DSBT_PIXELSTATE.
  • Единственный поддерживаемый режим адреса текстуры: D3DPTADDRESSCAPS_BORDER; цвет границы всегда равен 0.
  • Этот метод не поддерживается для MIP-карт.
  • Использование немонохромной текстуры с фильтрацией свертки приведет к ошибке драйвера.

Требования

   
Целевая платформа Windows
Header d3d9.h
Библиотека D3D9.lib

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

IDirect3DDevice9Ex