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

Статья
08/22/2023

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

Синтаксис

HRESULT MapOutputRectToInputRects(
        const D2D1_RECT_L *outputRect,
  [out] D2D1_RECT_L       *inputRects,
        UINT32            inputRectsCount
);

Параметры

outputRect

Тип: const D2D1_RECT_L*

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

[out] inputRects

Тип: D2D1_RECT_L*

Соответствующий набор входных данных. Входные данные будут непосредственно соответствовать входным данным преобразования.

inputRectsCount

Тип: UINT32

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

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

Тип: HRESULT

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

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

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

Требования


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

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

ID2D1EffectImpl

ID2D1Transform