ID2D1RenderTarget::CreateCompatibleRenderTarget メソッド

  • [アーティクル]

中間オフスクリーン描画中に使用する、現在のレンダー ターゲットと互換性のあるビットマップ レンダー ターゲットを作成します。新しいビットマップ レンダー ターゲットのピクセル形式 (アルファ モードを除く) は、現在のレンダー ターゲットと同じです。

構文

HRESULT CreateCompatibleRenderTarget(
         D2D1_SIZE_F desiredSize,
         D2D1_SIZE_U desiredPixelSize,
  [out]  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 用のプラットフォーム更新プログラム

サーバーの最小要件

 Windows Server 2008 R2, Windows Server 2008 SP2 および Windows Server 2008 用のプラットフォーム更新プログラム

ヘッダー

 D2d1.h

ライブラリ

 D2d1.lib

DLL

 D2d1.dll

参照

ID2D1RenderTarget