ID2D1RenderTarget::CreateCompatibleRenderTarget メソッド
中間オフスクリーン描画中に使用する、現在のレンダー ターゲットと互換性のあるビットマップ レンダー ターゲットを作成します。
構文
HRESULT CreateCompatibleRenderTarget(
D2D1_SIZE_F desiredSize,
D2D1_SIZE_U desiredPixelSize,
D2D1_PIXEL_FORMAT desiredFormat,
D2D1_COMPATIBLE_RENDER_TARGET_OPTIONS options,
[out] ID2D1BitmapRenderTarget **bitmapRenderTarget
);
パラメーター
- desiredSize
D2D1_SIZE_F 新しいレンダー ターゲットが元のレンダー ターゲットと異なる場合の、新しいレンダー ターゲットの必要なサイズ (デバイス非依存のピクセル単位)。詳細については、「解説」を参照してください。 - desiredPixelSize
D2D1_SIZE_U 新しいレンダー ターゲットが元のレンダー ターゲットと異なる場合の、新しいレンダー ターゲットの必要なサイズ (ピクセル単位)。詳細については、「解説」を参照してください。 - desiredFormat
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 7, Windows Vista SP2 および Windows Vista 用のプラットフォーム更新プログラム |
サーバーの最小要件 |
Windows Server 2008 R2, Windows Server 2008 SP2 および Windows Server 2008 用のプラットフォーム更新プログラム |
ヘッダー |
D2d1.h |
ライブラリ |
D2d1.lib |
DLL |
D2d1.dll |