ID2D1CommandSink：:D rawImage 方法 (d2d1_1.h)

將提供的影像繪製到命令接收。

語法

HRESULT 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) 。 影像的左上角將會對應至目標位移。 這不一定是原點。

[in, optional] imageRectangle

類型：const D2D1_RECT_F*

處理影像時，影像空間中的對應矩形將會對應至提供的原點。

interpolationMode

類型： D2D1_INTERPOLATION_MODE

必要時，用來調整影像的插補模式。

compositeMode

類型： D2D1_COMPOSITE_MODE

如果指定，將會套用至目前選取之剪輯限制的複合模式。

傳回值

類型： HRESULT

如果方法成功，則會傳回 S_OK。 如果失敗，則會傳回 HRESULT 錯誤碼。

備註

因為影像本身可以是命令清單，或包含接著包含命令清單的效果圖，所以此方法可能會導致遞迴處理。

規格需求

另請參閱

ID2D1CommandList：：Stream

ID2D1CommandSink

ID2D1DeviceCoNtext：:D rawImage