Método ID2D1Transform::MapOutputRectToInputRects (d2d1effectauthor.h)

Permite que uma transformação declare como ele mapearia um retângulo solicitado em sua saída para um conjunto de retângulos de exemplo em sua entrada.

Sintaxe

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

Parâmetros

outputRect

Tipo: const D2D1_RECT_L*

O retângulo de saída do qual as entradas devem ser mapeadas.

[out] inputRects

Tipo: D2D1_RECT_L*

O conjunto de entradas correspondente. As entradas corresponderão diretamente às entradas de transformação.

inputRectsCount

Tipo: UINT32

O número de entradas especificadas. O Direct2D garante que isso seja igual ao número de entradas especificadas na transformação.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Se falhar, retornará um código de erro HRESULT .

Comentários

A implementação da transformação deve garantir que qualquer sombreador de pixel ou implementação de retorno de chamada de software que ele fornece cumpra esse cálculo.

A implementação da transformação deve considerar esse método como puramente funcional. Ele pode basear os retângulos de entrada e saída mapeados em seu estado atual, conforme especificado pelas propriedades de efeito de encapsulamento. No entanto, ele não deve alterar seu próprio estado em resposta a esse método que está sendo invocado. A implementação do renderizador Direct2D reserva-se o direito de chamar esse método a qualquer momento e em qualquer sequência.

Requisitos

Confira também

ID2D1EffectImpl

ID2D1Transform