ID2D1RenderTarget::CreateCompatibleRenderTarget(D2D1_SIZE_F,D2D1_SIZE_U,ID2D1BitmapRenderTarget**) メソッド (d2d1.h)

  • [アーティクル]

現在のレンダー ターゲットと互換性のある中間オフスクリーン描画中に使用するビットマップ レンダー ターゲットを作成します。

構文

HRESULT CreateCompatibleRenderTarget(
  D2D1_SIZE_F             desiredSize,
  D2D1_SIZE_U             desiredPixelSize,
  ID2D1BitmapRenderTarget **bitmapRenderTarget
);

パラメーター

desiredSize

種類: [入力] D2D1_SIZE_F

元のレンダー ターゲットと異なる必要がある場合は、新しいレンダー ターゲットの目的のサイズ (デバイスに依存しないピクセル単位)。 詳細については、「解説」セクションを参照してください。

desiredPixelSize

型: [入力] D2D1_SIZE_U

元のレンダー ターゲットと異なる必要がある場合は、新しいレンダー ターゲットの目的のサイズをピクセル単位で指定します。 詳細については、「解説」を参照してください。

bitmapRenderTarget

種類: [out] ID2D1BitmapRenderTarget**

このメソッドが戻るとき、 には、新しいビットマップ レンダー ターゲットへのポインターへのポインターが含まれます。 このパラメーターは初期化せずに渡されます。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 それ以外の場合は、 HRESULT エラー コードが返されます。

注釈

新しいレンダー ターゲットのピクセル サイズと DPI は、desiredSize または desiredPixelSize の値を指定することで変更できます。

  • desiredSize が指定されていても desiredPixelSize が指定されていない場合、ピクセル サイズは親ターゲット DPI を使用して目的のサイズから計算されます。 desiredSize が整数ピクセル サイズにマップされる場合、互換性のあるレンダー ターゲットの DPI は親ターゲットの DPI と同じです。 desiredSize が小数ピクセル サイズにマップされている場合、ピクセル サイズは最も近い整数に切り上げられ、互換性のあるレンダー ターゲットの DPI は親レンダー ターゲットの DPI よりもわずかに高くなります。 いずれの場合も、座標 (desiredSize.width, desiredSize.height) は、互換性のあるレンダー ターゲットの右下隅にマップされます。
  • desiredPixelSize が指定されていて、desiredSize が指定されていない場合、新しいレンダー ターゲットの DPI は元のレンダー ターゲットと同じです。
  • desiredSize と desiredPixelSize の両方が指定されている場合、スケールの違いを考慮して新しいレンダー ターゲットの DPI が計算されます。
  • desiredSize も desiredPixelSize も指定されていない場合、新しいレンダー ターゲットのサイズと DPI は元のレンダー ターゲットと一致します。

このメソッドによって作成されたビットマップ レンダー ターゲットは、GDI と互換性がありません。

要件

要件 値
サポートされている最小のクライアント Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー d2d1.h
Library D2d1.lib
[DLL] D2d1.dll

こちらもご覧ください

ID2D1RenderTarget