ID2D1DeviceContext::DrawImage(ID2D1Effect*,D2D1_INTERPOLATION_MODE,D2D1_COMPOSITE_MODE) method (d2d1_1.h)
Draws an image to the device context.
Syntax
void DrawImage(
[in] ID2D1Effect *effect,
D2D1_INTERPOLATION_MODE interpolationMode,
D2D1_COMPOSITE_MODE compositeMode
);
Parameters
[in] effect
Type: ID2D1Effect*
The effect to be drawn to the device context.
interpolationMode
Type: D2D1_INTERPOLATION_MODE
The interpolation mode that will be used to scale the image if necessary.
compositeMode
Type: D2D1_COMPOSITE_MODE
The composite mode that will be applied to the limits of the currently selected clip. The default value is D2D1_COMPOSITE_MODE_SOURCE_OVER
Return value
None
Remarks
If interpolationMode is D2D1_INTERPOLATION_MODE_HIGH_QUALITY, different scalers will be used depending on the scale factor implied by the world transform.
Any invalid rectangles accumulated on any effect that is drawn by this call will be discarded regardless of which portion of the image rectangle is drawn.
If compositeMode is D2D1_COMPOSITE_MODE_SOURCE_OVER, DrawImage will use the currently selected primitive blend specified by ID2D1DeviceContext::SetPrimitiveBlend. If compositeMode is not D2D1_COMPOSITE_MODE_SOURCE_OVER, the image will be extended to transparent up to the current axis-aligned clip.
If there is an image rectangle and a world transform, this is equivalent to inserting a clip effect to represent the image rectangle and a 2D affine transform to take into account the world 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 | d2d1_1.h |
| DLL | D2d1.dll |