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

  • 發行項

將影像繪製到裝置內容。

語法

void DrawImage(
  [in]                ID2D1Image              *image,
  [in, optional]      D2D1_POINT_2F           targetOffset,
  [in, ref, 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, 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，則會根據世界轉換所隱含的縮放比例來使用不同的縮放器。

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

如果 compositeModeD2D1_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