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

劉英偉

本文将告诉大家如何通过 Vortice 使用 D2D 的特效
本文属于 DirectX 系列博客，更多 DirectX 和 D2D 以及 Vortice 库的博客，请参阅我的 博客导航
上一篇： DirectX 使用 Vortice 从零开始控制台创建 Direct2D1 窗口修改颜色
在上一篇博客里面，咱创建了一个 Win32 空窗口，接着给他挂上了 DirectX 交换链。使用以下代码从交换链里面拿到了 DXGI 平面，拿到的的 DXGI 平面即可被绘制 2D 内容在上面，从而将内容绘制输出到窗口上

1.         DXGI.IDXGISwapChain1 swapChain = ... // 忽略交换链之前的代码
3.         D3D11.ID3D11Texture2D backBufferTexture = swapChain.GetBuffer<D3D11.ID3D11Texture2D>(0);
5.         // 获取到 dxgi 的平面，这个屏幕就约等于窗口渲染内容
6.         DXGI.IDXGISurface dxgiSurface = backBufferTexture.QueryInterface<DXGI.IDXGISurface>();

复制代码

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

1.         DXGI.IDXGIDevice dxgiDevice = d3D11Device.QueryInterface<DXGI.IDXGIDevice>();
2.         ID2D1Device d2dDevice = d2DFactory.CreateDevice(dxgiDevice);
3.         ID2D1DeviceContext d2dDeviceContext = d2dDevice.CreateDeviceContext();
5.         // 设置 DXGI 平面作为 ID2D1DeviceContext 输出
6.         ID2D1Bitmap1 d2dBitmap = d2dDeviceContext.CreateBitmapFromDxgiSurface(dxgiSurface);
7.         d2dDeviceContext.Target = d2dBitmap;

复制代码

使用 Direct2D 特效之前，需要先了解一些概念。在 Direct2D 里面，可使用 ID2D1Effect 特效，特效的常用方法就是先使用 SetInput 方法将某个 ID2D1Bitmap 设置为输入源，再通过 SetValue 设置一些参数。最后将特效放入到 ID2D1DeviceContext 的 DrawImage 方法绘制出来
在 Direct2D 里面有许多内建特效，作为入门的博客，咱随便选一个简单的 GaussianBlur 特效作为例子。先通过 ID2D1DeviceContext 创建出特效，代码如下

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

复制代码

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

1.         ID2D1Bitmap CreateBitmap()
2.         {
3.             using var wicImagingFactory = new IWICImagingFactory();
4.             using IWICBitmap wicBitmap =
5.                 wicImagingFactory.CreateBitmap(1000, 1000, Win32.Graphics.Imaging.Apis.GUID_WICPixelFormat32bppPBGRA);
6.             var renderTargetProperties = new D2D.RenderTargetProperties(Vortice.DCommon.PixelFormat.Premultiplied);
7.             using D2D.ID2D1RenderTarget wicBitmapRenderTarget =
8.                 d2DFactory.CreateWicBitmapRenderTarget(wicBitmap, renderTargetProperties);
9.             wicBitmapRenderTarget.BeginDraw();
10.             using var brush = wicBitmapRenderTarget.CreateSolidColorBrush(color);
11.             wicBitmapRenderTarget.FillEllipse(new Ellipse(new System.Numerics.Vector2(200, 200), 100, 100), brush);
12.             wicBitmapRenderTarget.EndDraw();
14.             ID2D1Bitmap1 intputBitmap = renderTarget.CreateBitmapFromWicBitmap(wicBitmap);
15.             return intputBitmap;
16.         }

复制代码

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

1.                 using ID2D1Bitmap intputBitmap = CreateBitmap();
3.                 d2dEffect.SetInput(0, intputBitmap, new RawBool(true));

复制代码

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

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

复制代码

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

1.                 renderTarget.DrawImage(d2dEffect);

复制代码

以上就是特效的入门玩法，可以通过高性能的 Direct2D 特效，绘制出绚丽的界面
下面是特效使用部分的代码

1.         // 创建 D2D 设备，通过设置 ID2D1DeviceContext 的 Target 输出为 dxgiSurface 从而让 ID2D1DeviceContext 渲染内容渲染到窗口上        // 如 https://learn.microsoft.com/en-us/windows/win32/direct2d/images/devicecontextdiagram.png 图        // 获取 DXGI 设备，用来创建 D2D 设备        DXGI.IDXGIDevice dxgiDevice = d3D11Device.QueryInterface();        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);
2.                 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 命令进入此空文件夹，在命令行里面输入以下代码，即可获取到本文的代码

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

复制代码

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

1. git remote remove origin
2. git remote add origin https://github.com/lindexi/lindexi_gd.git
3. 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://www.cnblogs.com/lindexi/archive/2023/07/19/17566560.html
免责声明：由于采集信息均来自互联网，如果侵犯了您的权益，请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容，谢谢合作！