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
戻り値
なし
解説
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 |