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
如有必要,將用來調整影像的插補模式。
compositeMode
將套用至目前選取之剪輯限制的複合模式。 預設值為 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 |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應