dotnet C# 通过 Vortice 使用 Direct2D 特效入门

本文将告诉大家如何通过 Vortice 使用 D2D 的特效

本文属于 DirectX 系列博客，更多 DirectX 和 D2D 以及 Vortice 库的博客，请参阅我的博客导航

上一篇： DirectX 使用 Vortice 从零开始控制台创建 Direct2D1 窗口修改颜色

在上一篇博客里面，咱创建了一个 Win32 空窗口，接着给他挂上了 DirectX 交换链。使用以下代码从交换链里面拿到了 DXGI 平面，拿到的的 DXGI 平面即可被绘制 2D 内容在上面，从而将内容绘制输出到窗口上

        DXGI.IDXGISwapChain1 swapChain = ... // 忽略交换链之前的代码

        D3D11.ID3D11Texture2D backBufferTexture = swapChain.GetBuffer<D3D11.ID3D11Texture2D>(0);

        // 获取到 dxgi 的平面，这个屏幕就约等于窗口渲染内容
        DXGI.IDXGISurface dxgiSurface = backBufferTexture.QueryInterface<DXGI.IDXGISurface>();

接下来咱将创建 D2D 设备，再通过 D2D 设备，从而拿到 ID2D1DeviceContext 对象，设置 DXGI 平面作为 ID2D1DeviceContext 输出，如此即可使用继承自 ID2D1RenderTarget 的 ID2D1DeviceContext 进行绘制界面。此步骤更详细的内容，请参阅 dotnet DirectX 通过 Vortice 控制台使用 ID2D1DeviceContext 绘制画面

        DXGI.IDXGIDevice dxgiDevice = d3D11Device.QueryInterface<DXGI.IDXGIDevice>();
        ID2D1Device d2dDevice = d2DFactory.CreateDevice(dxgiDevice);
        ID2D1DeviceContext d2dDeviceContext = d2dDevice.CreateDeviceContext();

        // 设置 DXGI 平面作为 ID2D1DeviceContext 输出
        ID2D1Bitmap1 d2dBitmap = d2dDeviceContext.CreateBitmapFromDxgiSurface(dxgiSurface);
        d2dDeviceContext.Target = d2dBitmap;

使用 Direct2D 特效之前，需要先了解一些概念。在 Direct2D 里面，可使用 ID2D1Effect 特效，特效的常用方法就是先使用 SetInput 方法将某个 ID2D1Bitmap 设置为输入源，再通过 SetValue 设置一些参数。最后将特效放入到 ID2D1DeviceContext 的 DrawImage 方法绘制出来

在 Direct2D 里面有许多内建特效，作为入门的博客，咱随便选一个简单的 GaussianBlur 特效作为例子。先通过 ID2D1DeviceContext 创建出特效，代码如下

                var gaussianBlurEffect = d2dDeviceContext.CreateEffect(EffectGuids.GaussianBlur);
                using ID2D1Effect d2dEffect = new ID2D1Effect(gaussianBlurEffect);

创建出来的特效现在是缺少输入源的，接下来咱随便写一点代码创建一个 ID2D1Bitmap 作为输入源。为了方便编写例子，我这里采用的是创建放在内存里的 IWICBitmap 作为画布，通过自己绘制的内容作为 ID2D1Bitmap 输出，方法如下

        ID2D1Bitmap CreateBitmap()
        {
            using var wicImagingFactory = new IWICImagingFactory();
            using IWICBitmap wicBitmap =
                wicImagingFactory.CreateBitmap(1000, 1000, Win32.Graphics.Imaging.Apis.GUID_WICPixelFormat32bppPBGRA);
            var renderTargetProperties = new D2D.RenderTargetProperties(Vortice.DCommon.PixelFormat.Premultiplied);
            using D2D.ID2D1RenderTarget wicBitmapRenderTarget =
                d2DFactory.CreateWicBitmapRenderTarget(wicBitmap, renderTargetProperties);
            wicBitmapRenderTarget.BeginDraw();
            using var brush = wicBitmapRenderTarget.CreateSolidColorBrush(color);
            wicBitmapRenderTarget.FillEllipse(new Ellipse(new System.Numerics.Vector2(200, 200), 100, 100), brush);
            wicBitmapRenderTarget.EndDraw();

            ID2D1Bitmap1 intputBitmap = renderTarget.CreateBitmapFromWicBitmap(wicBitmap);
            return intputBitmap;
        }

以上代码不是本文的重点，大家也可以采用加载本地图片等方式获取到 ID2D1Bitmap 对象。如何加载本机图片，请参阅 WPF 对接 Vortice 在 Direct2D 绘制从 WIC 加载的图片

获取到 ID2D1Bitmap 对象，即可调用 SetInput 方法设置输入源，代码如下

                using ID2D1Bitmap intputBitmap = CreateBitmap();

                d2dEffect.SetInput(0, intputBitmap, new RawBool(true));

接着使用 SetValue 方法设置特效的一些参数，特效的参数都是灵活的。此 SetValue 方法的第一个参数表示的是将要设置特效的哪个参数，第二个参数才是特效参数的值，例如以下代码，设置模糊度

                const int D2D1_GAUSSIANBLUR_PROP_STANDARD_DEVIATION = 0;
                d2dEffect.SetValue(D2D1_GAUSSIANBLUR_PROP_STANDARD_DEVIATION, 2.5f);

完成特效的设置之后，即可调用 DrawImage 方法将特效结果绘制出来，代码如下

                renderTarget.DrawImage(d2dEffect);

以上就是特效的入门玩法，可以通过高性能的 Direct2D 特效，绘制出绚丽的界面

下面是特效使用部分的代码

        // 创建 D2D 设备，通过设置 ID2D1DeviceContext 的 Target 输出为 dxgiSurface 从而让 ID2D1DeviceContext 渲染内容渲染到窗口上
        // 如 https://learn.microsoft.com/en-us/windows/win32/direct2d/images/devicecontextdiagram.png 图
        // 获取 DXGI 设备，用来创建 D2D 设备
        DXGI.IDXGIDevice dxgiDevice = d3D11Device.QueryInterface<DXGI.IDXGIDevice>();
        ID2D1Device d2dDevice = d2DFactory.CreateDevice(dxgiDevice);
        ID2D1DeviceContext d2dDeviceContext = d2dDevice.CreateDeviceContext();

        ID2D1Bitmap1 d2dBitmap = d2dDeviceContext.CreateBitmapFromDxgiSurface(dxgiSurface);
        d2dDeviceContext.Target = d2dBitmap;

        var renderTarget = d2dDeviceContext;

        var stopwatch = Stopwatch.StartNew();
        var count = 0;

        // 随意创建颜色
        var color = new Color4((byte) Random.Shared.Next(255), (byte) Random.Shared.Next(255),
            (byte) Random.Shared.Next(255));

        Task.Factory.StartNew(() =>
        {
            while (true)
            {
                // 开始绘制逻辑
                renderTarget.BeginDraw();

                // 清空画布
                renderTarget.Clear(new Color4(0xFF,0xFF,0xFF));

                // 随便创建一张图片
                using var inputBitmap = CreateBitmap();

                var gaussianBlurEffect = d2dDeviceContext.CreateEffect(EffectGuids.GaussianBlur);
                using ID2D1Effect d2dEffect = new ID2D1Effect(gaussianBlurEffect);

                d2dEffect.SetInput(0, inputBitmap, new RawBool(true));
                const int D2D1_GAUSSIANBLUR_PROP_STANDARD_DEVIATION = 0;
                d2dEffect.SetValue(D2D1_GAUSSIANBLUR_PROP_STANDARD_DEVIATION, count / 60f * 3f);

                renderTarget.DrawImage(d2dEffect);

                renderTarget.EndDraw();

                swapChain.Present(1, DXGI.PresentFlags.None);
                // 等待刷新
                d3D11DeviceContext.Flush();

                // 统计刷新率
                count++;
                if (stopwatch.Elapsed >= TimeSpan.FromSeconds(1))
                {
                    Console.WriteLine($"FPS: {count / stopwatch.Elapsed.TotalSeconds}");
                    stopwatch.Restart();
                    count = 0;
                }
            }
        }, TaskCreationOptions.LongRunning);

        ID2D1Bitmap CreateBitmap()
        {
            using var wicImagingFactory = new IWICImagingFactory();
            using IWICBitmap wicBitmap =
                wicImagingFactory.CreateBitmap(1000, 1000, Win32.Graphics.Imaging.Apis.GUID_WICPixelFormat32bppPBGRA);
            var renderTargetProperties = new D2D.RenderTargetProperties(Vortice.DCommon.PixelFormat.Premultiplied);
            using D2D.ID2D1RenderTarget wicBitmapRenderTarget =
                d2DFactory.CreateWicBitmapRenderTarget(wicBitmap, renderTargetProperties);
            wicBitmapRenderTarget.BeginDraw();
            using var brush = wicBitmapRenderTarget.CreateSolidColorBrush(color);
            wicBitmapRenderTarget.FillEllipse(new Ellipse(new System.Numerics.Vector2(200, 200), 100, 100), brush);
            wicBitmapRenderTarget.EndDraw();

            ID2D1Bitmap1 inputBitmap = renderTarget.CreateBitmapFromWicBitmap(wicBitmap);
            return inputBitmap;
        }

以上代码将可以动态绘制一个模糊度不断变化的圆，代码省略和没有写的部分，我放在了 github 和 gitee 上，可以通过以下方式获取整个项目的代码

先创建一个空文件夹，接着使用命令行 cd 命令进入此空文件夹，在命令行里面输入以下代码，即可获取到本文的代码

git init
git remote add origin https://gitee.com/lindexi/lindexi_gd.git
git pull origin 615c235ce34b8c38abe1e99e65a5e34ddc9addb0

以上使用的是 gitee 的源，如果 gitee 不能访问，请替换为 github 的源。请在命令行继续输入以下代码

git remote remove origin
git remote add origin https://github.com/lindexi/lindexi_gd.git
git pull origin 615c235ce34b8c38abe1e99e65a5e34ddc9addb0

获取代码之后，进入 VorticeD2DEffect1 文件夹

有伙伴好奇为什么我最近写的是通过 Vortice 调用 DirectX 的博客，而不是通过 SharpDx 或 Silk.NET 调用 DirectX 的博客。这不是我收了 Vortice 的钱或者是和 Vortice 有什么 py 交易哈。其原因是 SharpDx 不维护了，作为 SharpDx 的接任者 Vortice 的行为和 API 都会靠近 SharpDx 许多，我编写起来比较顺手。而 Silk.NET 是对 DirectX 的底层封装，由于是直接底层封装，导致使用 Silk.NET 比较繁琐。尽管使用 Silk.NET 的性能从理论分析上能够比 Vortice 和 SharpDx 更好，但从定量上说，其实好不了多少。我所遇到的几乎所有性能问题，基本都卡在渲染上，而不是调用上，调用上的损耗基本可以忽略。那 Silk.NET 是不是就无用武之地？其实不然，在一些情况下，机器的性能不够业务的需求情况下，能省多少就应该省多少。而且在熟悉整个过程之后，即使将 Vortice 换成 Silk.NET 也只不过是一个体力活而已，将各个 API 进行替换即可。而且有趣的是，可以混合着 Vortice 和 Silk.NET 一起用，只有某些模块才使用 Silk.NET 编写

我创建了专门聊 Vortice 的 QQ 群： 622808968 欢迎加入交流技术

本文会经常更新，请阅读原文： https://blog.lindexi.com/post/dotnet-C-%E9%80%9A%E8%BF%87-Vortice-%E4%BD%BF%E7%94%A8-Direct2D-%E7%89%B9%E6%95%88%E5%85%A5%E9%97%A8.html ，以避免陈旧错误知识的误导，同时有更好的阅读体验。

如果你想持续阅读我的最新博客，请点击 RSS 订阅，推荐使用RSS Stalker订阅博客，或者收藏我的博客导航

本作品采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可。欢迎转载、使用、重新发布，但务必保留文章署名林德熙（包含链接： https://blog.lindexi.com ），不得用于商业目的，基于本文修改后的作品务必以相同的许可发布。如有任何疑问，请与我联系。