RenderTargetProperties 関数
D2D1_RENDER_TARGET_PROPERTIES 構造体を作成します。
構文
D2D1_RENDER_TARGET_PROPERTIES RenderTargetProperties(
D2D1_RENDER_TARGET_TYPE type = D2D1_RENDER_TARGET_TYPE_DEFAULT ,
__in const PIXEL_FORMAT pixelFormat = D2D1::PixelFormat() ,
FLOAT dpiX = 0.0,
FLOAT dpiY = 0.0,
D2D1_RENDER_TARGET_USAGE usage = D2D1_RENDER_TARGET_USAGE_NONE ,
D2D1_FEATURE_LEVEL minLevel = D2D1_FEATURE_LEVEL_DEFAULT
);
パラメーター
- type
D2D1_RENDER_TARGET_TYPE レンダー ターゲットがハードウェア レンダリングとソフトウェア レンダリングのどちらを使用する必要があるかを指定する値。既定値 D2D1_RENDER_TARGET_TYPE_DEFAULT は、ハードウェア レンダリングを使用するように指定します。ハードウェア レンダリングが使用できない場合、レンダー ターゲットはソフトウェア レンダリングを使用します。WIC ビットマップ レンダー ターゲットではハードウェア レンダリングがサポートされていない点に注意してください。 - pixelFormat [in]
PIXEL_FORMAT レンダー ターゲットのピクセル形式とアルファ モード。既定のピクセル形式は D2D1::PixelFormat であり、レンダー ターゲットでサポートされているピクセル形式を選択するように Direct2D に指示します。各レンダー ターゲットでサポートされているピクセル形式およびアルファ モードの一覧については、「サポートされているピクセル形式とアルファ モード」を参照してください。 - dpiX
FLOAT レンダー ターゲットの水平方向の DPI。既定値は 0.0 です。dpiX and dpiY が両方とも 0.0 に設定されている場合、レンダー ターゲットは既定の DPI を使用します。詳細については、「D2D1_RENDER_TARGET_PROPERTIES」を参照してください。 - dpiY
FLOAT レンダー ターゲットの垂直方向の DPI。既定値は 0.0 です。dpiX and dpiY が両方とも 0.0 に設定されている場合、レンダー ターゲットは既定の DPI を使用します。詳細については、「D2D1_RENDER_TARGET_PROPERTIES」を参照してください。 - usage
D2D1_RENDER_TARGET_USAGE レンダー ターゲットのリモート処理方法、および GDI と互換性のあるレンダー ターゲットにするかどうかを指定します。既定値 D2D1_RENDER_TARGET_USAGE_NONE は GDI と互換性がなく、Direct3Dコマンド ストリームのリモート処理を使用する (使用可能な場合) レンダー ターゲットを作成します。 - minLevel
D2D1_FEATURE_LEVEL ハードウェア レンダリングに必要最低限の Direct3D 機能レベル。既定値 D2D1_FEATURE_LEVEL_DEFAULT は、Direct2D がデバイスの Direct3D 機能レベルが適切かどうかを判断する必要があることを示します。このフィールドが使用されるのは、ID2D1HwndRenderTarget オブジェクトおよび ID2D1DCRenderTarget オブジェクトを作成する場合のみです。詳細については、「D2D1_RENDER_TARGET_PROPERTIES」を参照してください。
戻り値
D2D1_RENDER_TARGET_PROPERTIES
指定された設定を含む D2D1_RENDER_TARGET_PROPERTIES。
例
次の例では、D2D1::RenderTargetProperties 関数を使用して、ほとんどのレンダー ターゲットに適した D2D1_RENDER_TARGET_PROPERTIES 構造体を作成します。完全なコードについては、「"Hello World" サンプル」を参照してください。
RECT rc;
GetClientRect(m_hwnd, &rc);
D2D1_SIZE_U size = D2D1::SizeU(
rc.right - rc.left,
rc.bottom - rc.top
);
// Create a Direct2D render target.
hr = m_pD2DFactory->CreateHwndRenderTarget(
D2D1::RenderTargetProperties(),
D2D1::HwndRenderTargetProperties(m_hwnd, size),
&m_pRenderTarget
);
要件
クライアントの最小要件 |
Windows 7, Windows Vista SP2 および Windows Vista 用のプラットフォーム更新プログラム |
サーバーの最小要件 |
Windows Server 2008 R2, Windows Server 2008 SP2 および Windows Server 2008 用のプラットフォーム更新プログラム |
ヘッダー |
D2d1helper.h |
ライブラリ |
D2d1.lib |
DLL |
D2d1.dll |
名前空間 |
D2D1 |