Direct2D 和 GDI 互操作性概述

最新推荐文章于 2021-04-23 18:01:25 发布
最新推荐文章于 2021-04-23 18:01:25 发布
阅读量4k 收藏 5
点赞数
分类专栏： Windows系统 文章标签： gdi

必备条件

此概述假设您熟悉基本的 Direct2D 绘制操作。有关教程，请参见 Direct2D 快速入门。它还假设您熟悉 GDI 绘制操作。

将 Direct2D 内容绘制到 GDI 设备上下文

要将 Direct2D 内容绘制到 GDI DC，可以使用 ID2D1DCRenderTarget。要创建 DC 呈现器目标，可以使用 ID2D1Factory::CreateDCRenderTarget 方法。此方法使用两个参数。

第一个参数是 D2D1_RENDER_TARGET_PROPERTIES 结构，指定呈现、远程处理、DPI、像素格式和用法信息。要使 DC 呈现器目标能够使用 GDI，请将 DXGI 格式设置为DXGI_FORMAT_B8G8R8A8_UNORM，并将 Alpha 模式设置为 D2D1_ALPHA_MODE_PREMULTIPLIED 或 D2D1_ALPHA_MODE_IGNORE。

第二个参数是接收 DC 呈现器目标引用的指针的地址。

下面的代码创建一个 DC 呈现器目标。

// Create a DC render target.
D2D1_RENDER_TARGET_PROPERTIES props = D2D1::RenderTargetProperties(
    D2D1_RENDER_TARGET_TYPE_DEFAULT,
    D2D1::PixelFormat(
        DXGI_FORMAT_B8G8R8A8_UNORM,
        D2D1_ALPHA_MODE_IGNORE),
    0,
    0,
    D2D1_RENDER_TARGET_USAGE_NONE,
    D2D1_FEATURE_LEVEL_DEFAULT
    );

hr = m_pD2DFactory->CreateDCRenderTarget(&props, &m_pDCRT);

在前面的代码中，m_pD2DFactory 是一个指向 ID2D1Factory 的指针，而 m_pDCRT 是一个指向 ID2D1DCRenderTarget 的指针。

必须先使用 DC 呈现器目标的 BindDC 方法将该目标与 GDI DC 关联，然后才能使用该目标进行呈现。每次使用不同的 DC 时，或者所要绘制的区域大小发生变化时，都要执行此操作。

BindDC 方法使用两个参数：hDC 和 pSubRect。hDC 参数提供一个设备上下文的句柄，该设备上下文用于接收呈现器目标的输出。pSubRect 参数是一个矩形，描述了用来呈现内容的设备上下文区域。如果 pSubRect 所描述的设备上下文区域改变了大小，DC 呈现器目标也将更新大小，以便与设备上下文区域相匹配。

下面的代码将 DC 绑定到 DC 呈现器目标。

HRESULT DemoApp::OnRender(const PAINTSTRUCT &ps)
{
// Get the dimensions of the client drawing area.
GetClientRect(m_hwnd, &rc);
// Bind the DC to the DC render target.
hr = m_pDCRT->BindDC(ps.hdc, &rc);

将 DC 呈现器目标与 DC 关联后，就可以使用该 DC 进行绘制。下面的代码使用 DC 来绘制 Direct2D 和 GDI 内容。有关完整代码，请参见 Direct2D/GDI 互操作性示例。

HRESULT DemoApp::OnRender(const PAINTSTRUCT &ps)
{

    HRESULT hr;
    RECT rc;

    // Get the dimensions of the client drawing area.
    GetClientRect(m_hwnd, &rc);

    //
    // Draw the pie chart with Direct2D.
    //

    // Create the DC render target.
    hr = CreateDeviceResources();

    if (SUCCEEDED(hr))
    {
        // Bind the DC to the DC render target.
        hr = m_pDCRT->BindDC(ps.hdc, &rc);

        m_pDCRT->BeginDraw();

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

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

        m_pDCRT->DrawEllipse(
            D2D1::Ellipse(
                D2D1::Point2F(150.0f, 150.0f),
                100.0f,
                100.0f),
            m_pBlackBrush,
            3.0
            );

        m_pDCRT->DrawLine(
            D2D1::Point2F(150.0f, 150.0f),
            D2D1::Point2F(
                (150.0f + 100.0f * 0.15425f),
                (150.0f - 100.0f * 0.988f)),
            m_pBlackBrush,
            3.0
            );

        m_pDCRT->DrawLine(
            D2D1::Point2F(150.0f, 150.0f),
            D2D1::Point2F(
                (150.0f + 100.0f * 0.525f),
                (150.0f + 100.0f * 0.8509f)),
            m_pBlackBrush,
            3.0
            );

        m_pDCRT->DrawLine(
            D2D1::Point2F(150.0f, 150.0f),
            D2D1::Point2F(
                (150.0f - 100.0f * 0.988f),
                (150.0f - 100.0f * 0.15425f)),
            m_pBlackBrush,
            3.0
            );

        hr = m_pDCRT->EndDraw();
        if (SUCCEEDED(hr))
        {
            //
            // Draw the pie chart with GDI.
            //

            // Save the original object.
            HGDIOBJ original = NULL;
            original = SelectObject(
                ps.hdc,
                GetStockObject(DC_PEN)
                );

            HPEN blackPen = CreatePen(PS_SOLID, 3, 0);
            SelectObject(ps.hdc, blackPen);

            Ellipse(ps.hdc, 300, 50, 500, 250);

            POINT pntArray1[2];
            pntArray1[0].x = 400;
            pntArray1[0].y = 150;
            pntArray1[1].x = static_cast<LONG>(400 + 100 * 0.15425);
            pntArray1[1].y = static_cast<LONG>(150 - 100 * 0.9885);

            POINT pntArray2[2];
            pntArray2[0].x = 400;
            pntArray2[0].y = 150;
            pntArray2[1].x = static_cast<LONG>(400 + 100 * 0.525);
            pntArray2[1].y = static_cast<LONG>(150 + 100 * 0.8509);


            POINT pntArray3[2];
            pntArray3[0].x = 400;
            pntArray3[0].y = 150;
            pntArray3[1].x = static_cast<LONG>(400 - 100 * 0.988);
            pntArray3[1].y = static_cast<LONG>(150 - 100 * 0.15425);

            Polyline(ps.hdc, pntArray1, 2);
            Polyline(ps.hdc, pntArray2, 2);
            Polyline(ps.hdc, pntArray3, 2);

            DeleteObject(blackPen);

            // Restore the original object.
            SelectObject(ps.hdc, original);
        }
    }

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

    return hr;
}

此代码生成以下输出（添加的标注用于强调 Direct2D 和 GDI 呈现方式之间的差别。）

 

呈现到 GDI DC 的 Direct2D 和 GDI 内容

 

ID2D1DCRenderTargets、GDI 转换以及从右向左书写语言版本的 Windows

在使用 ID2D1DCRenderTarget 时，它会将把 Direct2D 内容呈现到一个内部位图，然后通过 GDI 将该位图呈现到 DC。

GDI 能够将 GDI 转换（通过 SetWorldTransform 方法）或其他效果应用于呈现器目标使用的同一 DC，在此情况下，GDI 将对 Direct2D 生成的位图进行转换。使用 GDI 转换来转换 Direct2D 内容可能会使输出的视觉质量下降，因为所转换的是已对抗锯齿和子像素定位进行计算的位图。

例如，假设您使用呈现器目标来绘制一个包含抗锯齿几何图形和文本的场景。如果使用 GDI 转换来向 DC 应用缩放转换，并对场景进行缩放以使其放大 10 倍，那么您将看到像素化和参差不齐的边缘。（但是，如果使用 Direct2D 应用类似的转换，则不会降低场景的视觉质量。）

在某些情况下，GDI 正在执行的其他处理可能会降低 Direct2D 内容的质量，但这种情况可能并不显而易见。例如，在从右向左书写语言 (RTL) 版本的 Windows 中，由ID2D1DCRenderTarget 呈现的内容可能会在 GDI 将其复制到目标时发生水平反转。内容实际上是否反转取决于 DC 的当前设置。

您可能需要防止发生这种反转，具体取决于正在呈现的内容的类型。如果 Direct2D 内容包含 ClearType 文本，则这种反转将会降低文本质量。

您可使用 SetLayout GDI 函数来控制 RTL 呈现行为。若要防止这种镜像，请调用 SetLayout GDI 函数，并将 LAYOUT_BITMAPORIENTATIONPRESERVED 指定为第二个参数的唯一值（请勿将其与 LAYOUT_RTL 组合），如以下示例所示：

SetLayout(m_hwnd, LAYOUT_BITMAPORIENTATIONPRESERVED);

将 GDI 内容绘制到与 Direct2D GDI 兼容的呈现器目标

上一部分说明如何将 Direct2D 内容绘制到 GDI DC。也可以将 GDI 内容绘制到与 Direct2D GDI 兼容的呈现器目标。此方法对于主要使用 Direct2D 来呈现的应用程序很有用，但有一些扩展模型或其他旧内容需要使用 GDI 来呈现。

要将 GDI 内容呈现到与 Direct2D GDI 兼容的呈现器目标，请使用 ID2D1GdiInteropRenderTarget，通过它可以访问可接受 GDI 绘制调用的设备上下文。与其他接口不同，此接口不会直接创建 ID2D1GdiInteropRenderTarget 对象。而是使用现有呈现器目标实例的 QueryInterface 方法。下面的代码演示如何执行此操作：

        D2D1_RENDER_TARGET_PROPERTIES rtProps = D2D1::RenderTargetProperties();
        rtProps.usage =  D2D1_RENDER_TARGET_USAGE_GDI_COMPATIBLE;

        // Create a GDI compatible Hwnd render target.
        hr = m_pD2DFactory->CreateHwndRenderTarget(
            rtProps,
            D2D1::HwndRenderTargetProperties(m_hwnd, size),
            &m_pRenderTarget
            );


        if (SUCCEEDED(hr))
        {
            hr = m_pRenderTarget->QueryInterface(__uuidof(ID2D1GdiInteropRenderTarget), (void**)&m_pGDIRT); 
        }

在前面的代码中，m_pD2DFactory 是一个指向 ID2D1Factory 的指针，而 m_pGDIRT 是一个指向 ID2D1GdiInteropRenderTarget 的指针。

请注意，在创建与 Hwnd GDI 兼容的呈现器目标时，指定了 D2D1_RENDER_TARGET_USAGE_GDI_COMPATIBLE 标志。如果需要像素格式，请使用DXGI_FORMAT_B8G8R8A8_UNORM（可能为英文网页）。如果需要 Alpha 模式，请使用 D2D1_ALPHA_MODE_PREMULTIPLIED 或 D2D1_ALPHA_MODE_IGNORE。

请注意，QueryInterface 总是能成功执行。要测试 ID2D1GdiInteropRenderTarget 接口的方法是否适用于给定的呈现器目标，请创建一个指定 GDI 兼容性和合适像素格式的D2D1_RENDER_TARGET_PROPERTIES，然后调用该呈现器目标的 IsSupported 方法来查看呈现器目标是否与 GDI 兼容。

以下示例显示如何将饼图（GDI 内容）绘制到与 Hwnd GDI 兼容的呈现器目标。

        HDC hDC = NULL;
        hr = m_pGDIRT->GetDC(D2D1_DC_INITIALIZE_MODE_COPY, &hDC);

        if (SUCCEEDED(hr))
        {
            // Draw the pie chart to the GDI render target associated with the Hwnd render target.
            HGDIOBJ original = NULL;
            original = SelectObject(
                hDC,
                GetStockObject(DC_PEN)
                );

            HPEN blackPen = CreatePen(PS_SOLID, 3, 0);
            SelectObject(hDC, blackPen);

            Ellipse(hDC, 300, 50, 500, 250);

            POINT pntArray1[2];
            pntArray1[0].x = 400;
            pntArray1[0].y = 150;
            pntArray1[1].x = static_cast<LONG>(400 + 100 * 0.15425);
            pntArray1[1].y = static_cast<LONG>(150 - 100 * 0.9885);

            POINT pntArray2[2];
            pntArray2[0].x = 400;
            pntArray2[0].y = 150;
            pntArray2[1].x = static_cast<LONG>(400 + 100 * 0.525);
            pntArray2[1].y = static_cast<LONG>(150 + 100 * 0.8509);

            POINT pntArray3[2];
            pntArray3[0].x = 400;
            pntArray3[0].y = 150;
            pntArray3[1].x = static_cast<LONG>(400 - 100 * 0.988);
            pntArray3[1].y = static_cast<LONG>(150 - 100 * 0.15425);

            Polyline(hDC, pntArray1, 2);
            Polyline(hDC, pntArray2, 2);
            Polyline(hDC, pntArray3, 2);

            DeleteObject(blackPen);

            // Restore the original object.
            SelectObject(hDC, original);

            m_pGDIRT->ReleaseDC(NULL);
        }

该代码输出以下饼图（含标注，用于强调呈现质量上的差别）。右侧的饼图（GDI 内容）的呈现质量低于左侧的饼图（Direct2D 内容）。这是由于 Direct2D 使用 GPU，而 GDI 使用 CPU。

 

呈现到与 Direct2D GDI 兼容的呈现器目标中的 Direct2D 和 GDI 内容

 

另请参见

Direct2D/GDI 互操作示例 GDI 互操作呈现器目标示例 ID2D1Factory::CreateDCRenderTarget ID2D1DCRenderTarget ID2D1GdiInteropRenderTarget D2D1_RENDER_TARGET_PROPERTIES GDI 设备上下文 GDI SDK

 


https://msdn.microsoft.com/zh-cn/library/dd370971(v=VS.85).aspx

必备条件

此概述假设您熟悉基本的 Direct2D 绘制操作。有关教程，请参见 Direct2D 快速入门。它还假设您熟悉 GDI 绘制操作。

将 Direct2D 内容绘制到 GDI 设备上下文

要将 Direct2D 内容绘制到 GDI DC，可以使用 ID2D1DCRenderTarget。要创建 DC 呈现器目标，可以使用 ID2D1Factory::CreateDCRenderTarget 方法。此方法使用两个参数。

第一个参数是 D2D1_RENDER_TARGET_PROPERTIES 结构，指定呈现、远程处理、DPI、像素格式和用法信息。要使 DC 呈现器目标能够使用 GDI，请将 DXGI 格式设置为DXGI_FORMAT_B8G8R8A8_UNORM，并将 Alpha 模式设置为 D2D1_ALPHA_MODE_PREMULTIPLIED 或 D2D1_ALPHA_MODE_IGNORE。

第二个参数是接收 DC 呈现器目标引用的指针的地址。

下面的代码创建一个 DC 呈现器目标。

// Create a DC render target.
D2D1_RENDER_TARGET_PROPERTIES props = D2D1::RenderTargetProperties(
    D2D1_RENDER_TARGET_TYPE_DEFAULT,
    D2D1::PixelFormat(
        DXGI_FORMAT_B8G8R8A8_UNORM,
        D2D1_ALPHA_MODE_IGNORE),
    0,
    0,
    D2D1_RENDER_TARGET_USAGE_NONE,
    D2D1_FEATURE_LEVEL_DEFAULT
    );

hr = m_pD2DFactory->CreateDCRenderTarget(&props, &m_pDCRT);

在前面的代码中，m_pD2DFactory 是一个指向 ID2D1Factory 的指针，而 m_pDCRT 是一个指向 ID2D1DCRenderTarget 的指针。

必须先使用 DC 呈现器目标的 BindDC 方法将该目标与 GDI DC 关联，然后才能使用该目标进行呈现。每次使用不同的 DC 时，或者所要绘制的区域大小发生变化时，都要执行此操作。

BindDC 方法使用两个参数：hDC 和 pSubRect。hDC 参数提供一个设备上下文的句柄，该设备上下文用于接收呈现器目标的输出。pSubRect 参数是一个矩形，描述了用来呈现内容的设备上下文区域。如果 pSubRect 所描述的设备上下文区域改变了大小，DC 呈现器目标也将更新大小，以便与设备上下文区域相匹配。

下面的代码将 DC 绑定到 DC 呈现器目标。

HRESULT DemoApp::OnRender(const PAINTSTRUCT &ps)
{
// Get the dimensions of the client drawing area.
GetClientRect(m_hwnd, &rc);
// Bind the DC to the DC render target.
hr = m_pDCRT->BindDC(ps.hdc, &rc);

将 DC 呈现器目标与 DC 关联后，就可以使用该 DC 进行绘制。下面的代码使用 DC 来绘制 Direct2D 和 GDI 内容。有关完整代码，请参见 Direct2D/GDI 互操作性示例。

HRESULT DemoApp::OnRender(const PAINTSTRUCT &ps)
{

    HRESULT hr;
    RECT rc;

    // Get the dimensions of the client drawing area.
    GetClientRect(m_hwnd, &rc);

    //
    // Draw the pie chart with Direct2D.
    //

    // Create the DC render target.
    hr = CreateDeviceResources();

    if (SUCCEEDED(hr))
    {
        // Bind the DC to the DC render target.
        hr = m_pDCRT->BindDC(ps.hdc, &rc);

        m_pDCRT->BeginDraw();

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

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

        m_pDCRT->DrawEllipse(
            D2D1::Ellipse(
                D2D1::Point2F(150.0f, 150.0f),
                100.0f,
                100.0f),
            m_pBlackBrush,
            3.0
            );

        m_pDCRT->DrawLine(
            D2D1::Point2F(150.0f, 150.0f),
            D2D1::Point2F(
                (150.0f + 100.0f * 0.15425f),
                (150.0f - 100.0f * 0.988f)),
            m_pBlackBrush,
            3.0
            );

        m_pDCRT->DrawLine(
            D2D1::Point2F(150.0f, 150.0f),
            D2D1::Point2F(
                (150.0f + 100.0f * 0.525f),
                (150.0f + 100.0f * 0.8509f)),
            m_pBlackBrush,
            3.0
            );

        m_pDCRT->DrawLine(
            D2D1::Point2F(150.0f, 150.0f),
            D2D1::Point2F(
                (150.0f - 100.0f * 0.988f),
                (150.0f - 100.0f * 0.15425f)),
            m_pBlackBrush,
            3.0
            );

        hr = m_pDCRT->EndDraw();
        if (SUCCEEDED(hr))
        {
            //
            // Draw the pie chart with GDI.
            //

            // Save the original object.
            HGDIOBJ original = NULL;
            original = SelectObject(
                ps.hdc,
                GetStockObject(DC_PEN)
                );

            HPEN blackPen = CreatePen(PS_SOLID, 3, 0);
            SelectObject(ps.hdc, blackPen);

            Ellipse(ps.hdc, 300, 50, 500, 250);

            POINT pntArray1[2];
            pntArray1[0].x = 400;
            pntArray1[0].y = 150;
            pntArray1[1].x = static_cast<LONG>(400 + 100 * 0.15425);
            pntArray1[1].y = static_cast<LONG>(150 - 100 * 0.9885);

            POINT pntArray2[2];
            pntArray2[0].x = 400;
            pntArray2[0].y = 150;
            pntArray2[1].x = static_cast<LONG>(400 + 100 * 0.525);
            pntArray2[1].y = static_cast<LONG>(150 + 100 * 0.8509);


            POINT pntArray3[2];
            pntArray3[0].x = 400;
            pntArray3[0].y = 150;
            pntArray3[1].x = static_cast<LONG>(400 - 100 * 0.988);
            pntArray3[1].y = static_cast<LONG>(150 - 100 * 0.15425);

            Polyline(ps.hdc, pntArray1, 2);
            Polyline(ps.hdc, pntArray2, 2);
            Polyline(ps.hdc, pntArray3, 2);

            DeleteObject(blackPen);

            // Restore the original object.
            SelectObject(ps.hdc, original);
        }
    }

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

    return hr;
}

此代码生成以下输出（添加的标注用于强调 Direct2D 和 GDI 呈现方式之间的差别。）

 

呈现到 GDI DC 的 Direct2D 和 GDI 内容

 

ID2D1DCRenderTargets、GDI 转换以及从右向左书写语言版本的 Windows

在使用 ID2D1DCRenderTarget 时，它会将把 Direct2D 内容呈现到一个内部位图，然后通过 GDI 将该位图呈现到 DC。

GDI 能够将 GDI 转换（通过 SetWorldTransform 方法）或其他效果应用于呈现器目标使用的同一 DC，在此情况下，GDI 将对 Direct2D 生成的位图进行转换。使用 GDI 转换来转换 Direct2D 内容可能会使输出的视觉质量下降，因为所转换的是已对抗锯齿和子像素定位进行计算的位图。

例如，假设您使用呈现器目标来绘制一个包含抗锯齿几何图形和文本的场景。如果使用 GDI 转换来向 DC 应用缩放转换，并对场景进行缩放以使其放大 10 倍，那么您将看到像素化和参差不齐的边缘。（但是，如果使用 Direct2D 应用类似的转换，则不会降低场景的视觉质量。）

在某些情况下，GDI 正在执行的其他处理可能会降低 Direct2D 内容的质量，但这种情况可能并不显而易见。例如，在从右向左书写语言 (RTL) 版本的 Windows 中，由ID2D1DCRenderTarget 呈现的内容可能会在 GDI 将其复制到目标时发生水平反转。内容实际上是否反转取决于 DC 的当前设置。

您可能需要防止发生这种反转，具体取决于正在呈现的内容的类型。如果 Direct2D 内容包含 ClearType 文本，则这种反转将会降低文本质量。

您可使用 SetLayout GDI 函数来控制 RTL 呈现行为。若要防止这种镜像，请调用 SetLayout GDI 函数，并将 LAYOUT_BITMAPORIENTATIONPRESERVED 指定为第二个参数的唯一值（请勿将其与 LAYOUT_RTL 组合），如以下示例所示：

SetLayout(m_hwnd, LAYOUT_BITMAPORIENTATIONPRESERVED);

将 GDI 内容绘制到与 Direct2D GDI 兼容的呈现器目标

上一部分说明如何将 Direct2D 内容绘制到 GDI DC。也可以将 GDI 内容绘制到与 Direct2D GDI 兼容的呈现器目标。此方法对于主要使用 Direct2D 来呈现的应用程序很有用，但有一些扩展模型或其他旧内容需要使用 GDI 来呈现。

要将 GDI 内容呈现到与 Direct2D GDI 兼容的呈现器目标，请使用 ID2D1GdiInteropRenderTarget，通过它可以访问可接受 GDI 绘制调用的设备上下文。与其他接口不同，此接口不会直接创建 ID2D1GdiInteropRenderTarget 对象。而是使用现有呈现器目标实例的 QueryInterface 方法。下面的代码演示如何执行此操作：

        D2D1_RENDER_TARGET_PROPERTIES rtProps = D2D1::RenderTargetProperties();
        rtProps.usage =  D2D1_RENDER_TARGET_USAGE_GDI_COMPATIBLE;

        // Create a GDI compatible Hwnd render target.
        hr = m_pD2DFactory->CreateHwndRenderTarget(
            rtProps,
            D2D1::HwndRenderTargetProperties(m_hwnd, size),
            &m_pRenderTarget
            );


        if (SUCCEEDED(hr))
        {
            hr = m_pRenderTarget->QueryInterface(__uuidof(ID2D1GdiInteropRenderTarget), (void**)&m_pGDIRT); 
        }

在前面的代码中，m_pD2DFactory 是一个指向 ID2D1Factory 的指针，而 m_pGDIRT 是一个指向 ID2D1GdiInteropRenderTarget 的指针。

请注意，在创建与 Hwnd GDI 兼容的呈现器目标时，指定了 D2D1_RENDER_TARGET_USAGE_GDI_COMPATIBLE 标志。如果需要像素格式，请使用DXGI_FORMAT_B8G8R8A8_UNORM（可能为英文网页）。如果需要 Alpha 模式，请使用 D2D1_ALPHA_MODE_PREMULTIPLIED 或 D2D1_ALPHA_MODE_IGNORE。

请注意，QueryInterface 总是能成功执行。要测试 ID2D1GdiInteropRenderTarget 接口的方法是否适用于给定的呈现器目标，请创建一个指定 GDI 兼容性和合适像素格式的D2D1_RENDER_TARGET_PROPERTIES，然后调用该呈现器目标的 IsSupported 方法来查看呈现器目标是否与 GDI 兼容。

以下示例显示如何将饼图（GDI 内容）绘制到与 Hwnd GDI 兼容的呈现器目标。

        HDC hDC = NULL;
        hr = m_pGDIRT->GetDC(D2D1_DC_INITIALIZE_MODE_COPY, &hDC);

        if (SUCCEEDED(hr))
        {
            // Draw the pie chart to the GDI render target associated with the Hwnd render target.
            HGDIOBJ original = NULL;
            original = SelectObject(
                hDC,
                GetStockObject(DC_PEN)
                );

            HPEN blackPen = CreatePen(PS_SOLID, 3, 0);
            SelectObject(hDC, blackPen);

            Ellipse(hDC, 300, 50, 500, 250);

            POINT pntArray1[2];
            pntArray1[0].x = 400;
            pntArray1[0].y = 150;
            pntArray1[1].x = static_cast<LONG>(400 + 100 * 0.15425);
            pntArray1[1].y = static_cast<LONG>(150 - 100 * 0.9885);

            POINT pntArray2[2];
            pntArray2[0].x = 400;
            pntArray2[0].y = 150;
            pntArray2[1].x = static_cast<LONG>(400 + 100 * 0.525);
            pntArray2[1].y = static_cast<LONG>(150 + 100 * 0.8509);

            POINT pntArray3[2];
            pntArray3[0].x = 400;
            pntArray3[0].y = 150;
            pntArray3[1].x = static_cast<LONG>(400 - 100 * 0.988);
            pntArray3[1].y = static_cast<LONG>(150 - 100 * 0.15425);

            Polyline(hDC, pntArray1, 2);
            Polyline(hDC, pntArray2, 2);
            Polyline(hDC, pntArray3, 2);

            DeleteObject(blackPen);

            // Restore the original object.
            SelectObject(hDC, original);

            m_pGDIRT->ReleaseDC(NULL);
        }

该代码输出以下饼图（含标注，用于强调呈现质量上的差别）。右侧的饼图（GDI 内容）的呈现质量低于左侧的饼图（Direct2D 内容）。这是由于 Direct2D 使用 GPU，而 GDI 使用 CPU。

 

呈现到与 Direct2D GDI 兼容的呈现器目标中的 Direct2D 和 GDI 内容

 

另请参见

Direct2D/GDI 互操作示例 GDI 互操作呈现器目标示例 ID2D1Factory::CreateDCRenderTarget ID2D1DCRenderTarget ID2D1GdiInteropRenderTarget D2D1_RENDER_TARGET_PROPERTIES GDI 设备上下文 GDI SDK

 


https://msdn.microsoft.com/zh-cn/library/dd370971(v=VS.85).aspx

必备条件

此概述假设您熟悉基本的 Direct2D 绘制操作。有关教程，请参见 Direct2D 快速入门。它还假设您熟悉 GDI 绘制操作。

将 Direct2D 内容绘制到 GDI 设备上下文

要将 Direct2D 内容绘制到 GDI DC，可以使用 ID2D1DCRenderTarget。要创建 DC 呈现器目标，可以使用 ID2D1Factory::CreateDCRenderTarget 方法。此方法使用两个参数。

第一个参数是 D2D1_RENDER_TARGET_PROPERTIES 结构，指定呈现、远程处理、DPI、像素格式和用法信息。要使 DC 呈现器目标能够使用 GDI，请将 DXGI 格式设置为DXGI_FORMAT_B8G8R8A8_UNORM，并将 Alpha 模式设置为 D2D1_ALPHA_MODE_PREMULTIPLIED 或 D2D1_ALPHA_MODE_IGNORE。

第二个参数是接收 DC 呈现器目标引用的指针的地址。

下面的代码创建一个 DC 呈现器目标。

// Create a DC render target.
D2D1_RENDER_TARGET_PROPERTIES props = D2D1::RenderTargetProperties(
    D2D1_RENDER_TARGET_TYPE_DEFAULT,
    D2D1::PixelFormat(
        DXGI_FORMAT_B8G8R8A8_UNORM,
        D2D1_ALPHA_MODE_IGNORE),
    0,
    0,
    D2D1_RENDER_TARGET_USAGE_NONE,
    D2D1_FEATURE_LEVEL_DEFAULT
    );

hr = m_pD2DFactory->CreateDCRenderTarget(&props, &m_pDCRT);

在前面的代码中，m_pD2DFactory 是一个指向 ID2D1Factory 的指针，而 m_pDCRT 是一个指向 ID2D1DCRenderTarget 的指针。

必须先使用 DC 呈现器目标的 BindDC 方法将该目标与 GDI DC 关联，然后才能使用该目标进行呈现。每次使用不同的 DC 时，或者所要绘制的区域大小发生变化时，都要执行此操作。

BindDC 方法使用两个参数：hDC 和 pSubRect。hDC 参数提供一个设备上下文的句柄，该设备上下文用于接收呈现器目标的输出。pSubRect 参数是一个矩形，描述了用来呈现内容的设备上下文区域。如果 pSubRect 所描述的设备上下文区域改变了大小，DC 呈现器目标也将更新大小，以便与设备上下文区域相匹配。

下面的代码将 DC 绑定到 DC 呈现器目标。

HRESULT DemoApp::OnRender(const PAINTSTRUCT &ps)
{
// Get the dimensions of the client drawing area.
GetClientRect(m_hwnd, &rc);
// Bind the DC to the DC render target.
hr = m_pDCRT->BindDC(ps.hdc, &rc);

将 DC 呈现器目标与 DC 关联后，就可以使用该 DC 进行绘制。下面的代码使用 DC 来绘制 Direct2D 和 GDI 内容。有关完整代码，请参见 Direct2D/GDI 互操作性示例。

HRESULT DemoApp::OnRender(const PAINTSTRUCT &ps)
{

    HRESULT hr;
    RECT rc;

    // Get the dimensions of the client drawing area.
    GetClientRect(m_hwnd, &rc);

    //
    // Draw the pie chart with Direct2D.
    //

    // Create the DC render target.
    hr = CreateDeviceResources();

    if (SUCCEEDED(hr))
    {
        // Bind the DC to the DC render target.
        hr = m_pDCRT->BindDC(ps.hdc, &rc);

        m_pDCRT->BeginDraw();

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

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

        m_pDCRT->DrawEllipse(
            D2D1::Ellipse(
                D2D1::Point2F(150.0f, 150.0f),
                100.0f,
                100.0f),
            m_pBlackBrush,
            3.0
            );

        m_pDCRT->DrawLine(
            D2D1::Point2F(150.0f, 150.0f),
            D2D1::Point2F(
                (150.0f + 100.0f * 0.15425f),
                (150.0f - 100.0f * 0.988f)),
            m_pBlackBrush,
            3.0
            );

        m_pDCRT->DrawLine(
            D2D1::Point2F(150.0f, 150.0f),
            D2D1::Point2F(
                (150.0f + 100.0f * 0.525f),
                (150.0f + 100.0f * 0.8509f)),
            m_pBlackBrush,
            3.0
            );

        m_pDCRT->DrawLine(
            D2D1::Point2F(150.0f, 150.0f),
            D2D1::Point2F(
                (150.0f - 100.0f * 0.988f),
                (150.0f - 100.0f * 0.15425f)),
            m_pBlackBrush,
            3.0
            );

        hr = m_pDCRT->EndDraw();
        if (SUCCEEDED(hr))
        {
            //
            // Draw the pie chart with GDI.
            //

            // Save the original object.
            HGDIOBJ original = NULL;
            original = SelectObject(
                ps.hdc,
                GetStockObject(DC_PEN)
                );

            HPEN blackPen = CreatePen(PS_SOLID, 3, 0);
            SelectObject(ps.hdc, blackPen);

            Ellipse(ps.hdc, 300, 50, 500, 250);

            POINT pntArray1[2];
            pntArray1[0].x = 400;
            pntArray1[0].y = 150;
            pntArray1[1].x = static_cast<LONG>(400 + 100 * 0.15425);
            pntArray1[1].y = static_cast<LONG>(150 - 100 * 0.9885);

            POINT pntArray2[2];
            pntArray2[0].x = 400;
            pntArray2[0].y = 150;
            pntArray2[1].x = static_cast<LONG>(400 + 100 * 0.525);
            pntArray2[1].y = static_cast<LONG>(150 + 100 * 0.8509);


            POINT pntArray3[2];
            pntArray3[0].x = 400;
            pntArray3[0].y = 150;
            pntArray3[1].x = static_cast<LONG>(400 - 100 * 0.988);
            pntArray3[1].y = static_cast<LONG>(150 - 100 * 0.15425);

            Polyline(ps.hdc, pntArray1, 2);
            Polyline(ps.hdc, pntArray2, 2);
            Polyline(ps.hdc, pntArray3, 2);

            DeleteObject(blackPen);

            // Restore the original object.
            SelectObject(ps.hdc, original);
        }
    }

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

    return hr;
}

此代码生成以下输出（添加的标注用于强调 Direct2D 和 GDI 呈现方式之间的差别。）

 

呈现到 GDI DC 的 Direct2D 和 GDI 内容

 

ID2D1DCRenderTargets、GDI 转换以及从右向左书写语言版本的 Windows

在使用 ID2D1DCRenderTarget 时，它会将把 Direct2D 内容呈现到一个内部位图，然后通过 GDI 将该位图呈现到 DC。

GDI 能够将 GDI 转换（通过 SetWorldTransform 方法）或其他效果应用于呈现器目标使用的同一 DC，在此情况下，GDI 将对 Direct2D 生成的位图进行转换。使用 GDI 转换来转换 Direct2D 内容可能会使输出的视觉质量下降，因为所转换的是已对抗锯齿和子像素定位进行计算的位图。

例如，假设您使用呈现器目标来绘制一个包含抗锯齿几何图形和文本的场景。如果使用 GDI 转换来向 DC 应用缩放转换，并对场景进行缩放以使其放大 10 倍，那么您将看到像素化和参差不齐的边缘。（但是，如果使用 Direct2D 应用类似的转换，则不会降低场景的视觉质量。）

在某些情况下，GDI 正在执行的其他处理可能会降低 Direct2D 内容的质量，但这种情况可能并不显而易见。例如，在从右向左书写语言 (RTL) 版本的 Windows 中，由ID2D1DCRenderTarget 呈现的内容可能会在 GDI 将其复制到目标时发生水平反转。内容实际上是否反转取决于 DC 的当前设置。

您可能需要防止发生这种反转，具体取决于正在呈现的内容的类型。如果 Direct2D 内容包含 ClearType 文本，则这种反转将会降低文本质量。

您可使用 SetLayout GDI 函数来控制 RTL 呈现行为。若要防止这种镜像，请调用 SetLayout GDI 函数，并将 LAYOUT_BITMAPORIENTATIONPRESERVED 指定为第二个参数的唯一值（请勿将其与 LAYOUT_RTL 组合），如以下示例所示：

SetLayout(m_hwnd, LAYOUT_BITMAPORIENTATIONPRESERVED);

将 GDI 内容绘制到与 Direct2D GDI 兼容的呈现器目标

上一部分说明如何将 Direct2D 内容绘制到 GDI DC。也可以将 GDI 内容绘制到与 Direct2D GDI 兼容的呈现器目标。此方法对于主要使用 Direct2D 来呈现的应用程序很有用，但有一些扩展模型或其他旧内容需要使用 GDI 来呈现。

要将 GDI 内容呈现到与 Direct2D GDI 兼容的呈现器目标，请使用 ID2D1GdiInteropRenderTarget，通过它可以访问可接受 GDI 绘制调用的设备上下文。与其他接口不同，此接口不会直接创建 ID2D1GdiInteropRenderTarget 对象。而是使用现有呈现器目标实例的 QueryInterface 方法。下面的代码演示如何执行此操作：

        D2D1_RENDER_TARGET_PROPERTIES rtProps = D2D1::RenderTargetProperties();
        rtProps.usage =  D2D1_RENDER_TARGET_USAGE_GDI_COMPATIBLE;

        // Create a GDI compatible Hwnd render target.
        hr = m_pD2DFactory->CreateHwndRenderTarget(
            rtProps,
            D2D1::HwndRenderTargetProperties(m_hwnd, size),
            &m_pRenderTarget
            );


        if (SUCCEEDED(hr))
        {
            hr = m_pRenderTarget->QueryInterface(__uuidof(ID2D1GdiInteropRenderTarget), (void**)&m_pGDIRT); 
        }

在前面的代码中，m_pD2DFactory 是一个指向 ID2D1Factory 的指针，而 m_pGDIRT 是一个指向 ID2D1GdiInteropRenderTarget 的指针。

请注意，在创建与 Hwnd GDI 兼容的呈现器目标时，指定了 D2D1_RENDER_TARGET_USAGE_GDI_COMPATIBLE 标志。如果需要像素格式，请使用DXGI_FORMAT_B8G8R8A8_UNORM（可能为英文网页）。如果需要 Alpha 模式，请使用 D2D1_ALPHA_MODE_PREMULTIPLIED 或 D2D1_ALPHA_MODE_IGNORE。

请注意，QueryInterface 总是能成功执行。要测试 ID2D1GdiInteropRenderTarget 接口的方法是否适用于给定的呈现器目标，请创建一个指定 GDI 兼容性和合适像素格式的D2D1_RENDER_TARGET_PROPERTIES，然后调用该呈现器目标的 IsSupported 方法来查看呈现器目标是否与 GDI 兼容。

以下示例显示如何将饼图（GDI 内容）绘制到与 Hwnd GDI 兼容的呈现器目标。

        HDC hDC = NULL;
        hr = m_pGDIRT->GetDC(D2D1_DC_INITIALIZE_MODE_COPY, &hDC);

        if (SUCCEEDED(hr))
        {
            // Draw the pie chart to the GDI render target associated with the Hwnd render target.
            HGDIOBJ original = NULL;
            original = SelectObject(
                hDC,
                GetStockObject(DC_PEN)
                );

            HPEN blackPen = CreatePen(PS_SOLID, 3, 0);
            SelectObject(hDC, blackPen);

            Ellipse(hDC, 300, 50, 500, 250);

            POINT pntArray1[2];
            pntArray1[0].x = 400;
            pntArray1[0].y = 150;
            pntArray1[1].x = static_cast<LONG>(400 + 100 * 0.15425);
            pntArray1[1].y = static_cast<LONG>(150 - 100 * 0.9885);

            POINT pntArray2[2];
            pntArray2[0].x = 400;
            pntArray2[0].y = 150;
            pntArray2[1].x = static_cast<LONG>(400 + 100 * 0.525);
            pntArray2[1].y = static_cast<LONG>(150 + 100 * 0.8509);

            POINT pntArray3[2];
            pntArray3[0].x = 400;
            pntArray3[0].y = 150;
            pntArray3[1].x = static_cast<LONG>(400 - 100 * 0.988);
            pntArray3[1].y = static_cast<LONG>(150 - 100 * 0.15425);

            Polyline(hDC, pntArray1, 2);
            Polyline(hDC, pntArray2, 2);
            Polyline(hDC, pntArray3, 2);

            DeleteObject(blackPen);

            // Restore the original object.
            SelectObject(hDC, original);

            m_pGDIRT->ReleaseDC(NULL);
        }

该代码输出以下饼图（含标注，用于强调呈现质量上的差别）。右侧的饼图（GDI 内容）的呈现质量低于左侧的饼图（Direct2D 内容）。这是由于 Direct2D 使用 GPU，而 GDI 使用 CPU。

 

呈现到与 Direct2D GDI 兼容的呈现器目标中的 Direct2D 和 GDI 内容

 

另请参见

Direct2D/GDI 互操作示例 GDI 互操作呈现器目标示例 ID2D1Factory::CreateDCRenderTarget ID2D1DCRenderTarget ID2D1GdiInteropRenderTarget D2D1_RENDER_TARGET_PROPERTIES GDI 设备上下文 GDI SDK

 


必备条件

此概述假设您熟悉基本的 Direct2D 绘制操作。有关教程，请参见 Direct2D 快速入门。它还假设您熟悉 GDI 绘制操作。

将 Direct2D 内容绘制到 GDI 设备上下文

要将 Direct2D 内容绘制到 GDI DC，可以使用 ID2D1DCRenderTarget。要创建 DC 呈现器目标，可以使用 ID2D1Factory::CreateDCRenderTarget 方法。此方法使用两个参数。

第一个参数是 D2D1_RENDER_TARGET_PROPERTIES 结构，指定呈现、远程处理、DPI、像素格式和用法信息。要使 DC 呈现器目标能够使用 GDI，请将 DXGI 格式设置为DXGI_FORMAT_B8G8R8A8_UNORM，并将 Alpha 模式设置为 D2D1_ALPHA_MODE_PREMULTIPLIED 或 D2D1_ALPHA_MODE_IGNORE。

第二个参数是接收 DC 呈现器目标引用的指针的地址。

下面的代码创建一个 DC 呈现器目标。

// Create a DC render target.
D2D1_RENDER_TARGET_PROPERTIES props = D2D1::RenderTargetProperties(
    D2D1_RENDER_TARGET_TYPE_DEFAULT,
    D2D1::PixelFormat(
        DXGI_FORMAT_B8G8R8A8_UNORM,
        D2D1_ALPHA_MODE_IGNORE),
    0,
    0,
    D2D1_RENDER_TARGET_USAGE_NONE,
    D2D1_FEATURE_LEVEL_DEFAULT
    );

hr = m_pD2DFactory->CreateDCRenderTarget(&props, &m_pDCRT);

在前面的代码中，m_pD2DFactory 是一个指向 ID2D1Factory 的指针，而 m_pDCRT 是一个指向 ID2D1DCRenderTarget 的指针。

必须先使用 DC 呈现器目标的 BindDC 方法将该目标与 GDI DC 关联，然后才能使用该目标进行呈现。每次使用不同的 DC 时，或者所要绘制的区域大小发生变化时，都要执行此操作。

BindDC 方法使用两个参数：hDC 和 pSubRect。hDC 参数提供一个设备上下文的句柄，该设备上下文用于接收呈现器目标的输出。pSubRect 参数是一个矩形，描述了用来呈现内容的设备上下文区域。如果 pSubRect 所描述的设备上下文区域改变了大小，DC 呈现器目标也将更新大小，以便与设备上下文区域相匹配。

下面的代码将 DC 绑定到 DC 呈现器目标。

HRESULT DemoApp::OnRender(const PAINTSTRUCT &ps)
{
// Get the dimensions of the client drawing area.
GetClientRect(m_hwnd, &rc);
// Bind the DC to the DC render target.
hr = m_pDCRT->BindDC(ps.hdc, &rc);

将 DC 呈现器目标与 DC 关联后，就可以使用该 DC 进行绘制。下面的代码使用 DC 来绘制 Direct2D 和 GDI 内容。有关完整代码，请参见 Direct2D/GDI 互操作性示例。

HRESULT DemoApp::OnRender(const PAINTSTRUCT &ps)
{

    HRESULT hr;
    RECT rc;

    // Get the dimensions of the client drawing area.
    GetClientRect(m_hwnd, &rc);

    //
    // Draw the pie chart with Direct2D.
    //

    // Create the DC render target.
    hr = CreateDeviceResources();

    if (SUCCEEDED(hr))
    {
        // Bind the DC to the DC render target.
        hr = m_pDCRT->BindDC(ps.hdc, &rc);

        m_pDCRT->BeginDraw();

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

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

        m_pDCRT->DrawEllipse(
            D2D1::Ellipse(
                D2D1::Point2F(150.0f, 150.0f),
                100.0f,
                100.0f),
            m_pBlackBrush,
            3.0
            );

        m_pDCRT->DrawLine(
            D2D1::Point2F(150.0f, 150.0f),
            D2D1::Point2F(
                (150.0f + 100.0f * 0.15425f),
                (150.0f - 100.0f * 0.988f)),
            m_pBlackBrush,
            3.0
            );

        m_pDCRT->DrawLine(
            D2D1::Point2F(150.0f, 150.0f),
            D2D1::Point2F(
                (150.0f + 100.0f * 0.525f),
                (150.0f + 100.0f * 0.8509f)),
            m_pBlackBrush,
            3.0
            );

        m_pDCRT->DrawLine(
            D2D1::Point2F(150.0f, 150.0f),
            D2D1::Point2F(
                (150.0f - 100.0f * 0.988f),
                (150.0f - 100.0f * 0.15425f)),
            m_pBlackBrush,
            3.0
            );

        hr = m_pDCRT->EndDraw();
        if (SUCCEEDED(hr))
        {
            //
            // Draw the pie chart with GDI.
            //

            // Save the original object.
            HGDIOBJ original = NULL;
            original = SelectObject(
                ps.hdc,
                GetStockObject(DC_PEN)
                );

            HPEN blackPen = CreatePen(PS_SOLID, 3, 0);
            SelectObject(ps.hdc, blackPen);

            Ellipse(ps.hdc, 300, 50, 500, 250);

            POINT pntArray1[2];
            pntArray1[0].x = 400;
            pntArray1[0].y = 150;
            pntArray1[1].x = static_cast<LONG>(400 + 100 * 0.15425);
            pntArray1[1].y = static_cast<LONG>(150 - 100 * 0.9885);

            POINT pntArray2[2];
            pntArray2[0].x = 400;
            pntArray2[0].y = 150;
            pntArray2[1].x = static_cast<LONG>(400 + 100 * 0.525);
            pntArray2[1].y = static_cast<LONG>(150 + 100 * 0.8509);


            POINT pntArray3[2];
            pntArray3[0].x = 400;
            pntArray3[0].y = 150;
            pntArray3[1].x = static_cast<LONG>(400 - 100 * 0.988);
            pntArray3[1].y = static_cast<LONG>(150 - 100 * 0.15425);

            Polyline(ps.hdc, pntArray1, 2);
            Polyline(ps.hdc, pntArray2, 2);
            Polyline(ps.hdc, pntArray3, 2);

            DeleteObject(blackPen);

            // Restore the original object.
            SelectObject(ps.hdc, original);
        }
    }

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

    return hr;
}

此代码生成以下输出（添加的标注用于强调 Direct2D 和 GDI 呈现方式之间的差别。）

 

呈现到 GDI DC 的 Direct2D 和 GDI 内容

 

ID2D1DCRenderTargets、GDI 转换以及从右向左书写语言版本的 Windows

在使用 ID2D1DCRenderTarget 时，它会将把 Direct2D 内容呈现到一个内部位图，然后通过 GDI 将该位图呈现到 DC。

GDI 能够将 GDI 转换（通过 SetWorldTransform 方法）或其他效果应用于呈现器目标使用的同一 DC，在此情况下，GDI 将对 Direct2D 生成的位图进行转换。使用 GDI 转换来转换 Direct2D 内容可能会使输出的视觉质量下降，因为所转换的是已对抗锯齿和子像素定位进行计算的位图。

例如，假设您使用呈现器目标来绘制一个包含抗锯齿几何图形和文本的场景。如果使用 GDI 转换来向 DC 应用缩放转换，并对场景进行缩放以使其放大 10 倍，那么您将看到像素化和参差不齐的边缘。（但是，如果使用 Direct2D 应用类似的转换，则不会降低场景的视觉质量。）

在某些情况下，GDI 正在执行的其他处理可能会降低 Direct2D 内容的质量，但这种情况可能并不显而易见。例如，在从右向左书写语言 (RTL) 版本的 Windows 中，由ID2D1DCRenderTarget 呈现的内容可能会在 GDI 将其复制到目标时发生水平反转。内容实际上是否反转取决于 DC 的当前设置。

您可能需要防止发生这种反转，具体取决于正在呈现的内容的类型。如果 Direct2D 内容包含 ClearType 文本，则这种反转将会降低文本质量。

您可使用 SetLayout GDI 函数来控制 RTL 呈现行为。若要防止这种镜像，请调用 SetLayout GDI 函数，并将 LAYOUT_BITMAPORIENTATIONPRESERVED 指定为第二个参数的唯一值（请勿将其与 LAYOUT_RTL 组合），如以下示例所示：

SetLayout(m_hwnd, LAYOUT_BITMAPORIENTATIONPRESERVED);

将 GDI 内容绘制到与 Direct2D GDI 兼容的呈现器目标

上一部分说明如何将 Direct2D 内容绘制到 GDI DC。也可以将 GDI 内容绘制到与 Direct2D GDI 兼容的呈现器目标。此方法对于主要使用 Direct2D 来呈现的应用程序很有用，但有一些扩展模型或其他旧内容需要使用 GDI 来呈现。

要将 GDI 内容呈现到与 Direct2D GDI 兼容的呈现器目标，请使用 ID2D1GdiInteropRenderTarget，通过它可以访问可接受 GDI 绘制调用的设备上下文。与其他接口不同，此接口不会直接创建 ID2D1GdiInteropRenderTarget 对象。而是使用现有呈现器目标实例的 QueryInterface 方法。下面的代码演示如何执行此操作：

        D2D1_RENDER_TARGET_PROPERTIES rtProps = D2D1::RenderTargetProperties();
        rtProps.usage =  D2D1_RENDER_TARGET_USAGE_GDI_COMPATIBLE;

        // Create a GDI compatible Hwnd render target.
        hr = m_pD2DFactory->CreateHwndRenderTarget(
            rtProps,
            D2D1::HwndRenderTargetProperties(m_hwnd, size),
            &m_pRenderTarget
            );


        if (SUCCEEDED(hr))
        {
            hr = m_pRenderTarget->QueryInterface(__uuidof(ID2D1GdiInteropRenderTarget), (void**)&m_pGDIRT); 
        }

在前面的代码中，m_pD2DFactory 是一个指向 ID2D1Factory 的指针，而 m_pGDIRT 是一个指向 ID2D1GdiInteropRenderTarget 的指针。

请注意，在创建与 Hwnd GDI 兼容的呈现器目标时，指定了 D2D1_RENDER_TARGET_USAGE_GDI_COMPATIBLE 标志。如果需要像素格式，请使用DXGI_FORMAT_B8G8R8A8_UNORM（可能为英文网页）。如果需要 Alpha 模式，请使用 D2D1_ALPHA_MODE_PREMULTIPLIED 或 D2D1_ALPHA_MODE_IGNORE。

请注意，QueryInterface 总是能成功执行。要测试 ID2D1GdiInteropRenderTarget 接口的方法是否适用于给定的呈现器目标，请创建一个指定 GDI 兼容性和合适像素格式的D2D1_RENDER_TARGET_PROPERTIES，然后调用该呈现器目标的 IsSupported 方法来查看呈现器目标是否与 GDI 兼容。

以下示例显示如何将饼图（GDI 内容）绘制到与 Hwnd GDI 兼容的呈现器目标。

        HDC hDC = NULL;
        hr = m_pGDIRT->GetDC(D2D1_DC_INITIALIZE_MODE_COPY, &hDC);

        if (SUCCEEDED(hr))
        {
            // Draw the pie chart to the GDI render target associated with the Hwnd render target.
            HGDIOBJ original = NULL;
            original = SelectObject(
                hDC,
                GetStockObject(DC_PEN)
                );

            HPEN blackPen = CreatePen(PS_SOLID, 3, 0);
            SelectObject(hDC, blackPen);

            Ellipse(hDC, 300, 50, 500, 250);

            POINT pntArray1[2];
            pntArray1[0].x = 400;
            pntArray1[0].y = 150;
            pntArray1[1].x = static_cast<LONG>(400 + 100 * 0.15425);
            pntArray1[1].y = static_cast<LONG>(150 - 100 * 0.9885);

            POINT pntArray2[2];
            pntArray2[0].x = 400;
            pntArray2[0].y = 150;
            pntArray2[1].x = static_cast<LONG>(400 + 100 * 0.525);
            pntArray2[1].y = static_cast<LONG>(150 + 100 * 0.8509);

            POINT pntArray3[2];
            pntArray3[0].x = 400;
            pntArray3[0].y = 150;
            pntArray3[1].x = static_cast<LONG>(400 - 100 * 0.988);
            pntArray3[1].y = static_cast<LONG>(150 - 100 * 0.15425);

            Polyline(hDC, pntArray1, 2);
            Polyline(hDC, pntArray2, 2);
            Polyline(hDC, pntArray3, 2);

            DeleteObject(blackPen);

            // Restore the original object.
            SelectObject(hDC, original);

            m_pGDIRT->ReleaseDC(NULL);
        }

该代码输出以下饼图（含标注，用于强调呈现质量上的差别）。右侧的饼图（GDI 内容）的呈现质量低于左侧的饼图（Direct2D 内容）。这是由于 Direct2D 使用 GPU，而 GDI 使用 CPU。

 

呈现到与 Direct2D GDI 兼容的呈现器目标中的 Direct2D 和 GDI 内容

 

另请参见

Direct2D/GDI 互操作示例 GDI 互操作呈现器目标示例 ID2D1Factory::CreateDCRenderTarget ID2D1DCRenderTarget ID2D1GdiInteropRenderTarget D2D1_RENDER_TARGET_PROPERTIES GDI 设备上下文 GDI SDK

 

jinvmen
关注
专栏目录
Direct2D开发：Direct2D 和 GDI 互操作性概述
heshaai6843的博客
12-15 1187
本主题说明如何结合使用 Direct2D 和 GDI（可能为英文网页）。有两种方法可以结合使用 Direct2D 和 GDI：您可以将 GDI 内容写入与 Direct2D GDI 兼容的呈现器目标，也可以将 Direct2D 内容写入 GDI 设备上下文 (DC) 0X01 将Direct2D内容绘制到GDI设备上下文： 　　要将 Direct2D 内容绘制到 GDI DC，可以使用 ...
1、DirectX 系列之 Direct 2D
SKT allsunday的博客
07-17 483
为什么要用DirectWrite，因为要自己做一个文本编辑器，需要用到 1、对文本的渲染、 2、分辨率无关轮廓字体、 3、完整的Unicode文本、 4、布局支持 DirectWriteAPI支持多格式文本的测量、绘制和点击测试。 ...
Direct2D 快速入门
v5browser
07-14 487
本文为MSDN Direct2D 部分译文，欢迎指点！原文：http://msdn.microsoft.com/en-us/library/windows/desktop/dd535473(v=vs.85).aspx 转载请注明出处： Direct2D 是用于创建2D图形的本地即时模式应用程序接口。本文介绍如何在典型的Win32应用程序中运用Direct2D进行绘制。 本文包...
Windows 2D 绘图 （GDI, GDI+, Direct2D)
Blueware多媒体之窗
02-12 5550
Windows 2D 绘图GDIGDI 函数GDI+GDI 和 GDI+ 的区别GDI+ 新特性Direct2D视觉效果demo GDI GDI 是 Graphics Device Interface 的缩写，含义是图形设备接口，它的主要任务是负责系统与绘图程序之间的信息交换，处理所有 Windows 程序的图形输出。 在 Windows 操作系统下，绝大多数具备图形界面的应用程序都离不开 GDI...
Direct2D学习教程（一）（原）
weixin_30732487的博客
03-14 756
㈠ 关于Direct2D Direct2D是一个硬件加速的，提供立即模式的二维图形API。它提供了二维的几何体，位图，文本的高性能，高质量的渲染。十分方便的是，Direct2D与GDI，GDI+和D3D都是可以交互的。一项技术总是有其受众面，看看微软本身怎么说的： 大型企业级本机应用程序开发人员。 创建供下游开发人员使用的控件工具包和库的开发人员。 需要对二维图形...
Direct2D教程（一）Direct2D已经来了，谁是GDI的终结者？
weixin_34233421的博客
04-02 672
什么是Direct2D 一言以蔽之，就是Windows 7平台上的一个2D图形API，可以提供高性能，高质量的2D渲染。大多数人对Direct2D可能都比较陌生，以至于我之前在论坛上提到这个词的时候,有人竟然说你是不是写错了?可能大家比较熟悉的是Direct3D，因为D3D已经是当前游戏界的主流应用。在过去，3D世界是OpenGL与DirectX二分天下,但是由于OpenGL发展十分滞后，而且没...
使用DirectDraw和GDI绘图
04-06
在提供的文件列表中，"Drawing-with-DirectDraw-GDI.pdf"可能包含了关于DirectDraw和GDI的比较及使用方法的详细教程，而"Drawing_demo.zip"和"Drawing_src.zip"很可能是示例代码和源代码，可以帮助你实际操作和理解...
Direct2D绘制多种风格的线条
01-02
Direct2D是Windows API提供的一种高性能的2D图形渲染引擎，它被设计用来替代传统的GDI和GDI+，在Windows平台上提供更加高效且现代化的绘图能力。本主题主要探讨如何利用Direct2D来绘制各种风格的线条，这对于创建...
Direct2D入门
hixyask的专栏
12-26 825
转自http://www.cnblogs.com/wdhust/archive/2010/04/28/1723122.html   一. 资源管理(Resource management) 和Direct3D一样，Direct2D程序需要处理设备丢失(Device lost)问题。Direct2D中的资源分为设备独立资源(Device independent resource)和设备依赖
互操作性（笔记）
maoxiaohai123的博客
03-22 2156
http://www.cnblogs.com/pnljs/archive/2012/02/20/2359313.html
Direct2D教程
10-14
本文详细介绍了Direct2D编程的方方面面，尤其适合direct2d初学者使用；作者不仅文笔流畅，而且对于技术细节描述非常详尽，读者阅后不仅能够熟悉direct2d编程步骤，对于图形处理也会有一定的感知。
WPF Direct2D 入门
04-18
实际上现在很多小伙伴对于渲染性能就是听到 DirectX 才会去搜索这个博客。我在博客园看到很少的博客讲到这个。即使有也很少会说如何使用 WPF 的，这是我博客的例子，直接打开可以运行，详细请看我博客 lindexi.gitee.io
Direct2D 介绍
萧戈的专栏
04-23 3055
最近做了一个项目，需要使用Windows的2D渲染技术，对GDI、Direct2D、Direct3D、opengl等图像渲染库做了一个比较，发现使用Direct2D是最优的。因为它既没有Direct3D和Opengl使用的复杂度，又具有硬件加速功能(GDI没有硬件加速功能)。所以最终决定使用Direct2D来作为本项目的图形渲染库，但是在使用Direct2D的时候发现了一个问题，就是网上关于Direct2D的学习资料太少了（在百度上搜索了一下，发现一本书籍也没有），唯一的学习资料就是MSDN。为了能让更多的
Direct2D简介
gaoyi的专栏
09-29 1314
Direct2D是一套高性能、高质量的2D图形渲染接口，它的出现主要是为了满足以下的开发： 1 大型的企业级本地应用开发 2 控件库或者是控件工具包开发人员 3 服务端2D图形渲染 4 在D3D中进行2D绘制，主要是为了实现用户接口元素的绘制，比如3D游戏中的菜单元素。 运行环境要求： win7或者vista之后的桌面系统 windows 2008以后的服务器系统 原文： htt...
Direct2D简介（原ZDD）
YOKI君的博客
01-29 1333
1.Direct2D是什么？ Direct2D是一套高性能的硬件加速API（代码运行在GPU），用于渲染几何图形，图片和文本，并且可以与Direct3D，GDI，GDI+交互。 简而言之是一个2D图形API，可以提供高性能，高质量的2D渲染。在过去，3D世界是OpenGL与DirectX二分天下,但是由于OpenGL发展十分滞后，而且没有一个像微软这样强大的后台支柱，所以逐渐被Di
Direct2D的使用(1)
喜欢吃一口烤肉的啵啵
06-10 2055
1.添加头文件和链接
Direct2D编程入门
热门推荐
牧秦丶
10-04 1万+
Direct2D 的一个C++入门例程。大家可以看看。 源码可以用VS2008或VS2010编译运行。
MFC应用中GDI与Direct2D交互示例：创建D2D渲染目标
虽然GDI通常用于Windows图形操作，但通过与Direct2D结合，可以利用Direct2D的高性能矢量图形功能，比如抗锯齿和高分辨率支持，提升应用的图形质量。在实际开发中，可能会涉及跨技术栈的资源共享或混合绘制，以实现...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值