ID2D1RenderTarget::CreateCompatibleRenderTarget(constD2D1_SIZE_F*,constD2D1_SIZE_U*,constD2D1_PIXEL_FORMAT*,D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS,ID2D1BitmapRenderTarget**) メソッド (d2d1.h)

  • [アーティクル]

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

構文

HRESULT CreateCompatibleRenderTarget(
  const D2D1_SIZE_F                     *desiredSize,
  const D2D1_SIZE_U                     *desiredPixelSize,
  const D2D1_PIXEL_FORMAT               *desiredFormat,
  D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS options,
  ID2D1BitmapRenderTarget               **bitmapRenderTarget
);

パラメーター

desiredSize

型: [in] const D2D1_SIZE_F*

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

desiredPixelSize

型: [in] const D2D1_SIZE_U*

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

desiredFormat

型: [in] const D2D1_PIXEL_FORMAT*

新しいレンダー ターゲットの目的のピクセル形式とアルファ モード。 ピクセル形式がDXGI_FORMAT_UNKNOWNに設定されている場合、新しいレンダー ターゲットは元のレンダー ターゲットと同じピクセル形式を使用します。 アルファ モードが D2D1_ALPHA_MODE_UNKNOWN場合、新しいレンダー ターゲットのアルファ モードは既定 でD2D1_ALPHA_MODE_PREMULTIPLIEDされます。 サポートされているピクセル形式の詳細については、「 サポートされているピクセル形式」と「アルファ モード」を参照してください。

options

種類: [入力] D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS

新しいレンダー ターゲットが GDI と互換性を持つ必要があるかどうかを示す 値です。

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 は元のレンダー ターゲットと一致します。

要件

要件 値
対象プラットフォーム Windows
ヘッダー d2d1.h
Library D2d1.lib
[DLL] D2d1.dll

こちらもご覧ください

ID2D1RenderTarget