Метод ID2D1Transform::MapInputRectsToOutputRect (d2d1effectauthor.h)

  • Статья

Выполняет обратное сопоставление с MapOutputRectToInputRects.

Синтаксис

HRESULT MapInputRectsToOutputRect(
  [in] const D2D1_RECT_L *inputRects,
  [in] const D2D1_RECT_L *inputOpaqueSubRects,
       UINT32            inputRectCount,
       D2D1_RECT_L       *outputRect,
       D2D1_RECT_L       *outputOpaqueSubRect
);

Параметры

[in] inputRects

Тип: const D2D1_RECT_L*

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

[in] inputOpaqueSubRects

Тип: const D2D1_RECT_L*

Массив входных прямоугольников для сопоставления с непрозрачным выходным прямоугольником.

inputRectCount

Тип: UINT32

Указанное число входных данных. Реализация гарантирует, что это равно количеству входных данных, указанному в преобразовании.

outputRect

Тип: D2D1_RECT_L*

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

outputOpaqueSubRect

Тип: D2D1_RECT_L*

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

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

Тип: HRESULT

Если метод завершается успешно, он возвращает S_OK. В случае сбоя возвращается код ошибки HRESULT .

Комментарии

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

В отличие от функций MapOutputRectToInputRects и MapInvalidRect , этот метод явно вызывается отрисовщиком в определенном месте в его алгоритме отрисовки. Реализация преобразования может изменять свое состояние в зависимости от входных прямоугольников и использовать эти сведения для управления сведениями о отрисовке. Этот метод всегда вызывается перед методами MapInvalidRect и MapOutputRectToInputRects преобразования.

Требования

Требование Значение
Минимальная версия клиента Windows 8 и обновление платформы для Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header d2d1effectauthor.h
Библиотека D2d1.lib

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

ID2D1EffectImpl

ID2D1Transform