レンダーターゲットの概要

2025-04-22

レンダーターゲットは、 ID2D1RenderTarget インターフェイスから継承するリソースです。レンダーターゲットは、描画用のリソースを作成し、実際の描画操作を実行します。このトピックでは、さまざまな種類の Direct2D レンダーターゲットとその使用方法について説明します。

レンダーターゲット
例: ウィンドウにコンテンツをレンダリングする

レンダーターゲット

レンダーターゲットは、 ID2D1RenderTarget インターフェイスから継承するリソースです。レンダーターゲットは、描画用のリソースを作成し、実際の描画操作を実行します。次の方法でグラフィックスをレンダリングするために使用できるレンダーターゲットには、いくつかの種類があります。

ID2D1HwndRenderTarget オブジェクトは、ウィンドウにコンテンツをレンダリングします。
ID2D1DCRenderTarget オブジェクトは、GDI デバイスコンテキストにレンダリングされます。
ビットマップレンダーターゲットオブジェクトは、コンテンツをオフスクリーンビットマップにレンダリングします。
DXGI レンダーターゲットオブジェクトは、Direct3D で使用するために DXGI サーフェスにレンダリングされます。

レンダーターゲットは特定のレンダリングデバイスに関連付けられているため、デバイスに依存するリソースであり、デバイスが削除されると機能しなくなります。

レンダーターゲット・機能

レンダーターゲットでハードウェアアクセラレーションを使用するかどうか、およびリモートディスプレイをローカルコンピューターとリモートコンピューターのどちらでレンダリングするかを指定できます。レンダリングターゲットは、エイリアスレンダリングまたはアンチエイリアスレンダリングを行うために設定できます。多数のプリミティブを含むシーンをレンダリングする場合、開発者はエイリアスモードで 2-D グラフィックスをレンダリングし、D3D マルチサンプルアンチエイリアシングを使用してスケーラビリティを向上させることもできます。

レンダーターゲットでは、描画操作を ID2D1Layer インターフェイスで表されるレイヤーにグループ化することもできます。レイヤーは、フレームをレンダリングするときに合成する描画操作を収集するのに役立ちます。一部のシナリオでは、レイヤー化の割り当てコストが ID2D1BitmapRenderTarget よりも小さいため、これはビットマップレンダーターゲットにレンダリングしてからビットマップコンテンツを再利用する代わりに役立ちます。

レンダーターゲットは、それ自体と互換性のある新しいレンダーターゲットを作成できます。これは、元のレンダーターゲットに設定されたさまざまなレンダーターゲットプロパティを保持しながら、中間のオフスクリーンレンダリングに役立ちます。

また、GDI デバイスコンテキストを取得するために使用できる GetDC メソッドと ReleaseDC メソッドを持つ ID2D1GdiInteropRenderTarget のレンダーターゲットで QueryInterface を呼び出すことによって、Direct2D レンダーターゲットで GDI を使用してレンダリングすることもできます。 GDI を使用したレンダリングは、レンダーターゲットが D2D1_RENDER_TARGET_USAGE_GDI_COMPATIBLE フラグを設定して作成された場合にのみ可能です。これは、主に Direct2D を使用してレンダリングするが、GDI でレンダリングする機能を必要とする拡張性モデルまたはその他のレガシコンテンツを持つアプリケーションに役立ちます。詳細については、「 Direct2D と GDI 相互運用の概要」を参照してください。

ターゲットリソースのレンダリング

ファクトリと同様に、レンダーターゲットは描画リソースを作成できます。レンダーターゲットによって作成されるすべてのリソースは、(レンダーターゲットと同様に) デバイスに依存するリソースです。レンダーターゲットでは、次の種類のリソースを作成できます。

ビットマップ
ブラシ
レイヤー
メッシュ

描画コマンド

コンテンツをレンダリングするには、レンダーターゲット描画メソッドを使用します。描画を開始する前に、 ID2D1RenderTarget::BeginDraw メソッドを呼び出します。描画が完了したら、 ID2D1RenderTarget::EndDraw メソッドを呼び出します。これらの呼び出しの間に、Draw メソッドと Fill メソッドを使用して描画リソースをレンダリングします。ほとんどの Draw メソッドと Fill メソッドは、図形 (プリミティブまたはジオメトリのいずれか) と、図形を塗りつぶしたりアウトライン表示したりするためのブラシを取ります。

レンダーターゲットは、クリッピング、不透明度マスクの適用、座標空間の変換を行うメソッドを提供します。

Direct2D では左向きの座標系が使用されます。正の x 軸の値は右に進み、正の y 軸の値は下方向に進みます。

エラー処理

レンダーターゲット描画コマンドは、要求された操作が成功したかどうかを示しません。描画エラーがあるかどうかを調べるには、レンダーターゲット の Flush メソッドまたは EndDraw メソッドを呼び出して HRESULT を取得します。

例: ウィンドウにコンテンツをレンダリングする

次の例では、 CreateHwndRenderTarget メソッドを使用して ID2D1HwndRenderTarget を作成します。

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

次の例では、 ID2D1HwndRenderTarget を 使用してウィンドウにテキストを描画します。

//  Called whenever the application needs to display the client
//  window. This method writes "Hello, World"
//
//  Note that this function will automatically discard device-specific
//  resources if the Direct3D device disappears during function
//  invocation, and will recreate the resources the next time it's
//  invoked.
//
HRESULT DemoApp::OnRender()
{
    HRESULT hr;

    hr = CreateDeviceResources();

    if (SUCCEEDED(hr))
    {
        static const WCHAR sc_helloWorld[] = L"Hello, World!";

        // Retrieve the size of the render target.
        D2D1_SIZE_F renderTargetSize = m_pRenderTarget->GetSize();

        m_pRenderTarget->BeginDraw();

        m_pRenderTarget->SetTransform(D2D1::Matrix3x2F::Identity());

        m_pRenderTarget->Clear(D2D1::ColorF(D2D1::ColorF::White));

        m_pRenderTarget->DrawText(
            sc_helloWorld,
            ARRAYSIZE(sc_helloWorld) - 1,
            m_pTextFormat,
            D2D1::RectF(0, 0, renderTargetSize.width, renderTargetSize.height),
            m_pBlackBrush
            );

        hr = m_pRenderTarget->EndDraw();

        if (hr == D2DERR_RECREATE_TARGET)
        {
            hr = S_OK;
            DiscardDeviceResources();
        }
    }

    return hr;
}

この例では、コードは省略されています。

次の方法で共有

レンダー ターゲットの概要