ID2D1DeviceContext::D rawImage(ID2D1Effect,constD2D1_POINT_2F,constD2D1_RECT_F*,D2D1_INTERPOLATION_MODE,D2D1_COMPOSITE_MODE) メソッド (d2d1_1.h)

[アーティクル]
02/26/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

戻り値

なし

解説

interpolationMode がD2D1_INTERPOLATION_MODE_HIGH_QUALITY場合、ワールド変換によって暗黙的に示されるスケールファクターに応じて、異なるスケーラーが使用されます。

この呼び出しによって描画される効果に対して累積された無効な四角形は、イメージの四角形のどの部分が描画されているかに関係なく破棄されます。

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