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

项目
02/24/2024

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

语法

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

参数

[in] effect

类型： ID2D1Effect*

要绘制到设备上下文的效果。

[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_QUALITY interpolationMode，将根据世界转换所隐含的比例因子使用不同的缩放器。

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

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

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

要求

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