透過日誌判斷 Uno Platform 是否在 X11 使用 OpenGL 渲染加速的方法

lindexi發表於2024-07-24
Platform

本文告訴大家如何在 UNO 裡面，如何透過日誌資訊判斷是否在 Linux 的 X11 平臺上使用 OpenGL 渲染加速

本文的方法適用於 UNO 的 5.2.175 版本，其他版本還請大家自行測試

需要先開啟 UNO 的日誌輸出，即預設的 App.xaml.cs 裡的 InitializeLogging 方法需要確保被呼叫且裡面的程式碼需要被執行。更具體的測試就是預設選擇使用 Debug 模式，或者去掉條件編譯符

再新增日誌過濾，如以下程式碼

            builder.AddFilter("Uno.WinUI.Runtime.Skia.X11.X11OpenGLRenderer", LogLevel.Trace);

修改之後的 InitializeLogging 方法的程式碼大概如下

    public static void InitializeLogging()
    {
        // Logging is disabled by default for release builds, as it incurs a significant
        // initialization cost from Microsoft.Extensions.Logging setup. If startup performance
        // is a concern for your application, keep this disabled. If you're running on the web or
        // desktop targets, you can use URL or command line parameters to enable it.
        //
        // For more performance documentation: https://platform.uno/docs/articles/Uno-UI-Performance.html

        var factory = LoggerFactory.Create(builder =>
        {
#if __WASM__
            builder.AddProvider(new global::Uno.Extensions.Logging.WebAssembly.WebAssemblyConsoleLoggerProvider());
#elif __IOS__ || __MACCATALYST__
            builder.AddProvider(new global::Uno.Extensions.Logging.OSLogLoggerProvider());
#else
            builder.AddConsole();
#endif

            // Exclude logs below this level
            builder.SetMinimumLevel(LogLevel.Information);

            // Default filters for Uno Platform namespaces
            builder.AddFilter("Uno", LogLevel.Warning);
            builder.AddFilter("Windows", LogLevel.Warning);
            builder.AddFilter("Microsoft", LogLevel.Warning);

            builder.AddFilter("Uno.WinUI.Runtime.Skia.X11.X11OpenGLRenderer", LogLevel.Trace);

            // Generic Xaml events
            // builder.AddFilter("Microsoft.UI.Xaml", LogLevel.Debug );
            // builder.AddFilter("Microsoft.UI.Xaml.VisualStateGroup", LogLevel.Debug );
            // builder.AddFilter("Microsoft.UI.Xaml.StateTriggerBase", LogLevel.Debug );
            // builder.AddFilter("Microsoft.UI.Xaml.UIElement", LogLevel.Debug );
            // builder.AddFilter("Microsoft.UI.Xaml.FrameworkElement", LogLevel.Trace );

            // Layouter specific messages
            // builder.AddFilter("Microsoft.UI.Xaml.Controls", LogLevel.Debug );
            // builder.AddFilter("Microsoft.UI.Xaml.Controls.Layouter", LogLevel.Debug );
            // builder.AddFilter("Microsoft.UI.Xaml.Controls.Panel", LogLevel.Debug );

            // builder.AddFilter("Windows.Storage", LogLevel.Debug );

            // Binding related messages
            // builder.AddFilter("Microsoft.UI.Xaml.Data", LogLevel.Debug );
            // builder.AddFilter("Microsoft.UI.Xaml.Data", LogLevel.Debug );

            // Binder memory references tracking
            // builder.AddFilter("Uno.UI.DataBinding.BinderReferenceHolder", LogLevel.Debug );

            // DevServer and HotReload related
            // builder.AddFilter("Uno.UI.RemoteControl", LogLevel.Information);

            // Debug JS interop
            // builder.AddFilter("Uno.Foundation.WebAssemblyRuntime", LogLevel.Debug );
        });

        global::Uno.Extensions.LogExtensionPoint.AmbientLoggerFactory = factory;

#if HAS_UNO
        global::Uno.UI.Adapter.Microsoft.Extensions.Logging.LoggingAdapter.Initialize();
#endif
    }

可在 Program.cs 裡新增測試程式碼，如下面程式碼，如果有命令列引數，則不開啟 OpenGL 渲染加速，程式碼如下

public class Program
{
    [STAThread]
    public static void Main(string[] args)
    {
        App.InitializeLogging();

        if (args.Length > 0)
        {
            FeatureConfiguration.Rendering.UseOpenGLOnX11 = false;
        }

        var host = SkiaHostBuilder.Create()
            .App(() => new App())
            .UseX11()
            .UseLinuxFrameBuffer()
            .UseMacOS()
            .UseWindows()
            .Build();

        host.Run();
    }
}

嘗試執行以上程式碼，在 Linux 上進行執行。在開啟 OpenGL 渲染加速時，可在控制檯看到如下輸出程式碼

trce: Uno.WinUI.Runtime.Skia.X11.X11OpenGLRenderer[0]
      Render 0
trce: Uno.WinUI.Runtime.Skia.X11.X11OpenGLRenderer[0]
      Render 1
trce: Uno.WinUI.Runtime.Skia.X11.X11OpenGLRenderer[0]
      Render 2
trce: Uno.WinUI.Runtime.Skia.X11.X11OpenGLRenderer[0]
      Render 3

透過閱讀 UNO 的原始碼，可以瞭解到上述的日誌輸出對應的程式碼如下

namespace Uno.WinUI.Runtime.Skia.X11
{
    internal class X11OpenGLRenderer : IX11Renderer, IDisposable
    {
        ... // 忽略其他程式碼

        void IX11Renderer.InvalidateRender()
        {
            ... // 忽略其他程式碼

            if (this.Log().IsEnabled(LogLevel.Trace))
            {
                this.Log().Trace($"Render {_renderCount++}");
            }
            ... // 忽略其他程式碼
        }
    }
}

本文程式碼放在 github 和 gitee 上，可以使用如下命令列拉取程式碼。我整個程式碼倉庫比較龐大，使用以下命令列可以進行部分拉取，拉取速度比較快

先建立一個空資料夾，接著使用命令列 cd 命令進入此空資料夾，在命令列裡面輸入以下程式碼，即可獲取到本文的程式碼

git init
git remote add origin https://gitee.com/lindexi/lindexi_gd.git
git pull origin 7de15e7b026989eab007b3ca4b38f56f334f175b

以上使用的是國內的 gitee 的源，如果 gitee 不能訪問，請替換為 github 的源。請在命令列繼續輸入以下程式碼，將 gitee 源換成 github 源進行拉取程式碼。如果依然拉取不到程式碼，可以發郵件向我要程式碼

git remote remove origin
git remote add origin https://github.com/lindexi/lindexi_gd.git
git pull origin 7de15e7b026989eab007b3ca4b38f56f334f175b

獲取程式碼之後，進入 UnoDemo/BallnallqeebairCejaiwakeneadi 資料夾，即可獲取到原始碼

更多技術部落格，請參閱 部落格導航

相關文章