ID2D1Transform::MapInputRectsToOutputRect method (d2d1effectauthor.h)
Performs the inverse mapping to MapOutputRectToInputRects.
Syntax
HRESULT MapInputRectsToOutputRect(
[in] const D2D1_RECT_L *inputRects,
[in] const D2D1_RECT_L *inputOpaqueSubRects,
UINT32 inputRectCount,
D2D1_RECT_L *outputRect,
D2D1_RECT_L *outputOpaqueSubRect
);
Parameters
[in] inputRects
Type: const D2D1_RECT_L*
An array of input rectangles to be mapped to the output rectangle. The inputRects parameter is always equal to the input bounds.
[in] inputOpaqueSubRects
Type: const D2D1_RECT_L*
An array of input rectangles to be mapped to the opaque output rectangle.
inputRectCount
Type: UINT32
The number of inputs specified. The implementation guarantees that this is equal to the number of inputs specified on the transform.
outputRect
Type: D2D1_RECT_L*
The output rectangle that maps to the corresponding input rectangle.
outputOpaqueSubRect
Type: D2D1_RECT_L*
The output rectangle that maps to the corresponding opaque input rectangle.
Return value
Type: HRESULT
If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.
Remarks
The transform implementation must ensure that any pixel shader or software callback implementation it provides honors this calculation.
Unlike the MapOutputRectToInputRects and MapInvalidRect functions, this method is explicitly called by the renderer at a determined place in its rendering algorithm. The transform implementation may change its state based on the input rectangles and use this information to control its rendering information. This method is always called before the MapInvalidRect and MapOutputRectToInputRects methods of the transform.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 8 and Platform Update for Windows 7 [desktop apps | UWP apps] |
| Minimum supported server | Windows Server 2012 and Platform Update for Windows Server 2008 R2 [desktop apps | UWP apps] |
| Target Platform | Windows |
| Header | d2d1effectauthor.h |
| Library | D2d1.lib |