ID2D1DeviceContext：:D rawImage (ID2D1Image，constD2D1_POINT_2F，constD2D1_RECT_F*，D2D1_INTERPOLATION_MODE，D2D1_COMPOSITE_MODE) 方法 (d2d1_1.h)

项目
08/22/2023

将图像绘制到设备上下文。

语法

void DrawImage(
  [in]           ID2D1Image              *image,
  [in, optional] const D2D1_POINT_2F     *targetOffset,
  [in, optional] const D2D1_RECT_F       *imageRectangle,
                 D2D1_INTERPOLATION_MODE interpolationMode,
                 D2D1_COMPOSITE_MODE     compositeMode
);

参数

[in] image

类型： ID2D1Image*

要绘制到设备上下文中的图像。

[in, optional] targetOffset

类型： const D2D1_POINT_2F*

图像将呈现到的目标空间中的偏移量。图像的整个逻辑范围将呈现到相应的目标。如果未指定，则目标源将 (0、0) 。图像的左上角将映射到目标偏移量。这不一定是原点。此默认值为 NULL。

[in, optional] imageRectangle

类型： const D2D1_RECT_F*

处理图像时，图像空间中的相应矩形将映射到给定的原点。此默认值为 NULL。

interpolationMode

类型： D2D1_INTERPOLATION_MODE

将用于缩放图像（如有必要）的内插模式。

compositeMode

类型： D2D1_COMPOSITE_MODE

将应用于当前所选剪辑限制的复合模式。默认值为 D2D1_COMPOSITE_MODE_SOURCE_OVER

返回值

无

备注

如果D2D1_INTERPOLATION_MODE_HIGH_QUALITYinterpolationMode，则将根据世界转换所隐含的比例系数使用不同的缩放器。

无论绘制图像矩形的哪个部分，此调用绘制的任何效果上累积的任何无效矩形都将被丢弃。

如果D2D1_COMPOSITE_MODE_SOURCE_OVER compositeMode，DrawImage 将使用 ID2D1DeviceContext：：SetPrimitiveBlend 指定的当前所选基元混合。如果未D2D1_COMPOSITE_MODE_SOURCE_OVERcompositeMode，图像将扩展到透明到当前轴对齐的剪辑。

如果有一个图像矩形和一个世界转换，这相当于插入一个剪裁效果来表示图像矩形和一个 2D 仿射变换以考虑世界转换。

要求


最低受支持的客户端	适用于 Windows 7 的 Windows 8 和平台更新 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows Server 2012 和适用于 Windows Server 2008 R2 的平台更新 [桌面应用 \|UWP 应用]
目标平台	Windows
标头	d2d1_1.h
DLL	D2d1.dll