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
    );

要件

参照

D2D1_RENDER_TARGET_PROPERTIES Structure

"Hello World" サンプル

サポートされているピクセル形式とアルファ モード