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

將影像繪製至裝置內容。

語法

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

參數

[in] effect

類型： ID2D1Image*

要繪製至裝置內容的影像。

[in, optional] targetOffset

類型： const D2D1_POINT_2F

將轉譯影像目的地空間中的位移。 影像的整個邏輯範圍將會轉譯至對應的目的地。 如果未指定，目的地來源將會 (0、0) 。 影像的左上角將會對應至目標位移。 這不一定是原點。 這個預設值為 NULL。

[in, ref, 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插補點Mode，則會根據世界轉換所隱含的縮放比例來使用不同的縮放器。

不論繪製影像矩形的哪個部分為何，都會捨棄任何在此呼叫所繪製之效果上累積的任何無效矩形。

如果 compositeMode是D2D1_COMPOSITE_MODE_SOURCE_OVER，DrawImage 將會使用 ID2D1DeviceContext：：SetPrimitiveBlend 所指定的目前選取基本混合。 如果 compositeMode 未 D2D1_COMPOSITE_MODE_SOURCE_OVER，則會將影像延伸為透明，最多可延伸至目前的軸對齊剪輯。

如果有影像矩形和世界轉換，這相當於插入剪輯效果來代表影像矩形，以及要納入世界轉換的 2D 關聯轉換。

規格需求

需求	值
最低支援的用戶端	適用於 Windows 7 的 Windows 8 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	適用於 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	d2d1_1.h
Dll	D2d1.dll

另請參閱

ID2D1Bitmap

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1Effect

ID2D1Image