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 と互換性がありません。

要件

こちらもご覧ください

ID2D1RenderTarget