Add option to select FFmpeg decoding mode

neon-nyan · neon-nyan · commit fad9ca6bb570 · 2026-04-23T20:20:42.000+07:00
We have 4 options here:
- Automatic
- Automatic with System Decoder
- Force System Decoder
- Force FFmpeg Software Decoder
diff --git a/CollapseLauncher/Classes/GameManagement/ImageBackground/ImageBackgroundManager.FFmpeg.cs b/CollapseLauncher/Classes/GameManagement/ImageBackground/ImageBackgroundManager.FFmpeg.cs
@@ -1,5 +1,6 @@
 ﻿using CollapseLauncher.Helper;
 using CollapseLauncher.Helper.StreamUtility;
+using FFmpegInteropX;
 using Hi3Helper;
 using Hi3Helper.Shared.Region;
 using System;
@@ -33,8 +34,11 @@ public partial class ImageBackgroundManager
 {
     #region Shared/Static Properties and Fields
 
-    private const string GlobalIsUseFFmpegConfigKey      = "GlobalIsUseFFmpeg";
-    private const string GlobalFFmpegCustomPathConfigKey = "GlobalFFmpegCustomPath";
+    private const string GlobalIsUseFFmpegConfigKey        = "GlobalIsUseFFmpeg";
+    private const string GlobalFFmpegCustomPathConfigKey   = "GlobalFFmpegCustomPath";
+    private const string GlobalFFmpegDecodingModeConfigKey = "GlobalFFmpegDecodingMode";
+
+    public VideoDecoderMode[] AvailableFFmpegDecodingModes => field ??= Enum.GetValues<VideoDecoderMode>();
 
     public bool GlobalIsUseFFmpeg
     {
@@ -68,6 +72,31 @@ public bool GlobalIsFFmpegCurrentlyUsed
         }
     }
 
+    public VideoDecoderMode GlobalFFmpegDecodingMode
+    {
+        get
+        {
+            string? value = LauncherConfig.GetAppConfigValue(GlobalFFmpegDecodingModeConfigKey);
+            if (Enum.TryParse<VideoDecoderMode>(value, out var result))
+            {
+                return result;
+            }
+
+            return default;
+        }
+        set
+        {
+            if (!Enum.IsDefined<VideoDecoderMode>(value))
+            {
+                value = default;
+            }
+
+            string valueStr = value.ToString();
+            LauncherConfig.SetAndSaveConfigValue(GlobalFFmpegDecodingModeConfigKey, valueStr);
+            OnPropertyChanged();
+        }
+    }
+
     #endregion
 
     public void RefreshFFmpegBinding()
diff --git a/CollapseLauncher/Classes/GameManagement/ImageBackground/ImageBackgroundManager.Loaders.cs b/CollapseLauncher/Classes/GameManagement/ImageBackground/ImageBackgroundManager.Loaders.cs
@@ -198,6 +198,11 @@ private void SpawnImageLayer(Uri? overlayFilePath,
             layerElement.IsVideoAutoplay = WindowUtility.CurrentWindowIsVisible;
         }
 
+        layerElement.BindProperty(LayeredBackgroundImage.FfmpegDecoderModeProperty,
+                                  this,
+                                  nameof(GlobalFFmpegDecodingMode),
+                                  bindingMode: BindingMode.OneWay);
+
         layerElement.BindProperty(LayeredBackgroundImage.ParallaxHoverSourceProperty,
                                   this,
                                   nameof(GlobalParallaxHoverSource),
diff --git a/CollapseLauncher/Classes/GameManagement/ImageBackground/ImageBackgroundManager.cs b/CollapseLauncher/Classes/GameManagement/ImageBackground/ImageBackgroundManager.cs
@@ -2,8 +2,10 @@
 using CollapseLauncher.Helper.Image;
 using CollapseLauncher.Helper.LauncherApiLoader.HoYoPlay;
 using CollapseLauncher.Helper.Metadata;
+using CollapseLauncher.Interfaces;
 using CollapseLauncher.Interfaces.Class;
 using CollapseLauncher.XAMLs.Theme.CustomControls;
+using Google.Protobuf.WellKnownTypes;
 using Hi3Helper.SentryHelper;
 using Hi3Helper.Shared.Region;
 using Microsoft.UI.Xaml;
@@ -27,7 +29,8 @@ namespace CollapseLauncher.GameManagement.ImageBackground;
 
 [GeneratedBindableCustomProperty]
 public partial class ImageBackgroundManager
-    : NotifyPropertyChanged
+    : NotifyPropertyChanged,
+      INotifyAllPropertyChanged
 {
     internal static ImageBackgroundManager Shared => field ??= new ImageBackgroundManager();
 
@@ -612,6 +615,12 @@ public void ResetContexts()
         Interlocked.Exchange(ref _previousContextHash, 0);
         ImageContextSources.Clear();
     }
+
+    void INotifyAllPropertyChanged.NotifyAllChanged()
+    {
+        OnPropertyChanged(nameof(GlobalFFmpegDecodingMode));
+        OnPropertyChanged(nameof(AvailableFFmpegDecodingModes));
+    }
 }
 
 [GeneratedBindableCustomProperty]
diff --git a/CollapseLauncher/Classes/Interfaces/INotifyAllPropertyChanged.cs b/CollapseLauncher/Classes/Interfaces/INotifyAllPropertyChanged.cs
@@ -0,0 +1,10 @@
+﻿using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace CollapseLauncher.Interfaces;
+
+public interface INotifyAllPropertyChanged
+{
+    void NotifyAllChanged();
+}
diff --git a/CollapseLauncher/XAMLs/MainApp/Pages/SettingsPage.xaml b/CollapseLauncher/XAMLs/MainApp/Pages/SettingsPage.xaml
@@ -15,6 +15,7 @@
       xmlns:innerConfig="using:Hi3Helper.Shared.Region"
       xmlns:localWindowSize="using:CollapseLauncher.WindowSize"
       xmlns:localeSourceGen="using:Hi3Helper.LocaleSourceGen"
+      xmlns:ffmpegInterop="using:FFmpegInteropX"
       xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
       xmlns:plugins="using:CollapseLauncher.Plugins"
       Loaded="Page_Loaded"
@@ -35,6 +36,9 @@
         <conv:BooleanToIsEnabledOpacityConverter x:Key="BooleanToIsEnabledOpacityConverter" />
         <conv:NullableVisibilityConverter x:Key="NullableVisibilityConverter" />
         <conv:RemoveNewLineStringConverter x:Key="RemoveNewLineStringConverter" />
+        <conv:FFmpegVideoDecoderModeToIndexConverter x:Key="FFmpegVideoDecoderModeToIndexConverter" />
+        <conv:FFmpegVideoDecoderModeToHelpLocaleConverter x:Key="FFmpegVideoDecoderModeToHelpLocaleConverter" />
+        <conv:ObjectToLocaleKvpConverter x:Key="ObjectToLocaleKvpConverter" />
     </Page.Resources>
     <Grid>
         <ScrollViewer>
@@ -450,6 +454,57 @@
                                         </Grid>
                                     </StackPanel>
                                 </Grid>
+                                <ComboBox x:Name="VideoCodecFfmpegDecodingMethod"
+                                          CornerRadius="14"
+                                          IsEnabled="{Binding GlobalIsFFmpegAvailable, Mode=OneWay, Converter={StaticResource BooleanVisibilityConverter}}"
+                                          ItemsSource="{Binding AvailableFFmpegDecodingModes, Mode=OneWay}"
+                                          Margin="0,8,0,0"
+                                          Visibility="{Binding ElementName=VideoCodecUseFfmpeg, Path=IsOn, Mode=OneWay, Converter={StaticResource BooleanVisibilityConverter}}"
+                                          SelectedIndex="{Binding GlobalFFmpegDecodingMode, Mode=TwoWay, Converter={StaticResource FFmpegVideoDecoderModeToIndexConverter}}">
+                                    <ComboBox.ItemTemplate>
+                                        <DataTemplate x:DataType="ffmpegInterop:VideoDecoderMode">
+                                            <TextBlock Text="{x:Bind helper:Locale.Current.Lang._DictKvpFFmpegDecodingMode, Mode=OneWay, Converter={StaticResource ObjectToLocaleKvpConverter}, ConverterParameter={Binding}}"
+                                                       ToolTipService.ToolTip="{Binding Converter={StaticResource FFmpegVideoDecoderModeToHelpLocaleConverter}, Mode=OneWay, ConverterParameter='Tooltip'}"/>
+                                        </DataTemplate>
+                                    </ComboBox.ItemTemplate>
+                                    <ComboBox.Header>
+                                        <StackPanel Orientation="Horizontal"
+                                                    Spacing="8">
+                                            <TextBlock Text="{x:Bind helper:Locale.Current.Lang._SettingsPage.VideoBackground_FFmpegVideoDecodingMethod, Mode=OneWay}"/>
+                                            <Button Width="24"
+                                                    Height="24"
+                                                    Padding="0"
+                                                    CornerRadius="4"
+                                                    Style="{ThemeResource AcrylicButtonStyle}">
+                                                <Button.Content>
+                                                    <FontIcon FontFamily="{ThemeResource FontAwesome}"
+                                                              FontSize="10"
+                                                              Glyph="&#x3f;" />
+                                                </Button.Content>
+                                                <Button.Flyout>
+                                                    <Flyout Placement="Right">
+                                                        <ItemsRepeater ItemsSource="{Binding AvailableFFmpegDecodingModes, Mode=OneWay}"
+                                                                       Margin="0,-8">
+                                                            <ItemsRepeater.ItemTemplate>
+                                                                <DataTemplate x:DataType="ffmpegInterop:VideoDecoderMode">
+                                                                    <StackPanel MaxWidth="420"
+                                                                                Margin="0,8"
+                                                                                Spacing="4">
+                                                                        <TextBlock Style="{ThemeResource BodyLargeStrongTextBlockStyle}"
+                                                                                   Text="{Binding Converter={StaticResource FFmpegVideoDecoderModeToHelpLocaleConverter}, Mode=OneWay}"
+                                                                                   TextWrapping="Wrap"/>
+                                                                        <TextBlock Text="{Binding Converter={StaticResource FFmpegVideoDecoderModeToHelpLocaleConverter}, Mode=OneWay, ConverterParameter='Tooltip'}"
+                                                                                   TextWrapping="Wrap"/>
+                                                                    </StackPanel>
+                                                                </DataTemplate>
+                                                            </ItemsRepeater.ItemTemplate>
+                                                        </ItemsRepeater>
+                                                    </Flyout>
+                                                </Button.Flyout>
+                                            </Button>
+                                        </StackPanel>
+                                    </ComboBox.Header>
+                                </ComboBox>
                             </StackPanel>
                             <TextBlock Margin="0,16,0,8"
                                        Style="{ThemeResource SubtitleTextBlockStyle}"
diff --git a/CollapseLauncher/XAMLs/MainApp/Pages/SettingsPage.xaml.cs b/CollapseLauncher/XAMLs/MainApp/Pages/SettingsPage.xaml.cs
@@ -19,6 +19,7 @@
 using CollapseLauncher.XAMLs.Theme.ContentDialog;
 using CollapseLauncher.XAMLs.Theme.CustomControls;
 using CommunityToolkit.WinUI;
+using FFmpegInteropX;
 using Hi3Helper;
 using Hi3Helper.EncTool;
 using Hi3Helper.Plugin.Core.Management;
@@ -57,6 +58,7 @@
 using static Hi3Helper.Logger;
 using static Hi3Helper.Shared.Region.LauncherConfig;
 using CollapseUIExt = CollapseLauncher.Extension.UIElementExtensions;
+using CollapseLauncher.Interfaces;
 
 // ReSharper disable AsyncVoidMethod
 // ReSharper disable SwitchStatementHandlesSomeKnownEnumValuesWithDefault
@@ -93,6 +95,8 @@ public sealed partial class SettingsPage : Page
         private          List<string>                                       DialogMethodNames        { get; }
         public           string                                             SelectedDialogMethodName { get; set; }
 
+        private EnumToIndexConverter<VideoDecoderMode> _ffmpegDecodingModeConverter = StaticConverter<EnumToIndexConverter<VideoDecoderMode>>.Shared;
+
     #nullable enable
         private string? _previousSearchQuery;
 #nullable restore
@@ -799,6 +803,10 @@ private void LanguageSelector_SelectionChanged(object sender, SelectionChangedEv
             string selectedKey = Locale.Current.Lang.LanguageID;
             PluginManager.SetPluginLocaleId(selectedKey);
 
+            ((INotifyAllPropertyChanged)ImageBackgroundManager.Shared).NotifyAllChanged();
+            CustomDnsConnectionTypeComboBox.UpdateLayout();
+            CustomDnsProviderListComboBox.UpdateLayout();
+            VideoCodecFfmpegDecodingMethod.UpdateLayout();
             InitializeSettingsSearch();
         }
 
diff --git a/CollapseLauncher/XAMLs/MainApp/ValueConverters.cs b/CollapseLauncher/XAMLs/MainApp/ValueConverters.cs
@@ -2,6 +2,7 @@
 using CollapseLauncher.Helper;
 using CollapseLauncher.Helper.Metadata;
 using CollapseLauncher.Plugins;
+using FFmpegInteropX;
 using Hi3Helper;
 using Hi3Helper.Data;
 using Hi3Helper.EncTool;
@@ -19,6 +20,7 @@
 using System.Collections;
 using System.Collections.Generic;
 using System.IO;
+using System.Linq;
 using System.Net.Http;
 using System.Numerics;
 using System.Threading;
@@ -1212,4 +1214,112 @@ public object ConvertBack(object value, Type targetType, object parameter, strin
             throw new NotImplementedException();
         }
     }
+
+    public partial class ObjectToLocaleKvpConverter : IValueConverter
+    {
+        public object? Convert(object? value, Type targetType, object? parameter, string language)
+        {
+            if (value is not Dictionary<string, string> asKvp)
+            {
+                return parameter;
+            }
+
+            string? paramStr = parameter?.ToString();
+            if (paramStr == null ||
+                !asKvp.TryGetValue(paramStr, out string? localizedValue))
+            {
+                return parameter;
+            }
+
+            return localizedValue;
+        }
+
+        public object ConvertBack(object value, Type targetType, object parameter, string language)
+            => throw new NotImplementedException();
+    }
+
+    public partial class FFmpegVideoDecoderModeToLocalizedConverter : IValueConverter
+    {
+        public object? Convert(object? value, Type targetType, object parameter, string language)
+        {
+            if (value is not VideoDecoderMode asEnum)
+            {
+                return value;
+            }
+
+            Dictionary<string, string> dict = [];
+            string enumStr = asEnum.ToString();
+
+            if (!dict.TryGetValue(enumStr, out string? localedString))
+            {
+                return enumStr;
+            }
+
+            return localedString;
+        }
+
+        public object ConvertBack(object value, Type targetType, object parameter, string language)
+            => throw new NotImplementedException();
+    }
+
+    public partial class FFmpegVideoDecoderModeToHelpLocaleConverter : IValueConverter
+    {
+        public object? Convert(object? value, Type targetType, object parameter, string language)
+        {
+            if (value is not VideoDecoderMode asEnum)
+            {
+                return value;
+            }
+
+            bool isConvertTooltip = parameter is string parameterStr &&
+                parameterStr.Equals("Tooltip", StringComparison.OrdinalIgnoreCase);
+
+            var lang = Locale.Current.Lang;
+
+            Dictionary<string, string> dict = (isConvertTooltip ? lang?._DictKvpFFmpegDecodingModeTooltip : lang?._DictKvpFFmpegDecodingMode) ?? [];
+            string enumStr = asEnum.ToString();
+
+            if (!dict.TryGetValue(enumStr, out string? localedString))
+            {
+                return lang?._Misc?.DescriptionNotAvailable ?? enumStr;
+            }
+
+            return localedString;
+        }
+
+        public object ConvertBack(object value, Type targetType, object parameter, string language)
+            => throw new NotImplementedException();
+    }
+
+    public partial class FFmpegVideoDecoderModeToIndexConverter : EnumToIndexConverter<VideoDecoderMode>;
+
+    public partial class EnumToIndexConverter<TEnum> : IValueConverter
+        where TEnum : struct, Enum
+    {
+        private static List<TEnum> _enums = [.. Enum.GetValues<TEnum>()];
+
+        public object? Convert(object? value, Type targetType, object parameter, string language)
+        {
+            if (value is not TEnum asEnum ||
+                !Enum.IsDefined<TEnum>(asEnum))
+            {
+                asEnum = default;
+            }
+
+            int indexOf = _enums.IndexOf(asEnum);
+            return indexOf < 0 || indexOf > _enums.Count - 1 ? default : indexOf;
+        }
+
+        public object ConvertBack(object value, Type targetType, object parameter, string language)
+        {
+            if (value is not int asIndex ||
+                asIndex < 0 ||
+                asIndex > _enums.Count - 1)
+            {
+                return default(TEnum);
+            }
+
+            return _enums[asIndex];
+        }
+    }
 }
diff --git a/CollapseLauncher/XAMLs/Theme/CustomControls/LayeredBackgroundImage.Events.Loaders.cs b/CollapseLauncher/XAMLs/Theme/CustomControls/LayeredBackgroundImage.Events.Loaders.cs
@@ -377,7 +377,8 @@ private static async Task<bool> LoadVideoFromSourceAsync(
                             MaxDecoderThreads     = (uint)Environment.ProcessorCount,
                             VideoOutputAllow10bit = true,
                             VideoOutputAllowBgra8 = true,
-                            VideoOutputAllowNv12  = true
+                            VideoOutputAllowNv12  = true,
+                            VideoDecoderMode      = instance.FfmpegDecoderMode
                         }
                     };
 
diff --git a/CollapseLauncher/XAMLs/Theme/CustomControls/LayeredBackgroundImage.Properties.cs b/CollapseLauncher/XAMLs/Theme/CustomControls/LayeredBackgroundImage.Properties.cs
@@ -1,4 +1,5 @@
 ﻿#nullable enable
+using FFmpegInteropX;
 using Hi3Helper.Data;
 using Microsoft.UI.Xaml;
 using Microsoft.UI.Xaml.Media;
@@ -30,6 +31,12 @@ public bool UseFfmpegDecoder
         set => SetValue(UseFfmpegDecoderProperty, value);
     }
 
+    public VideoDecoderMode FfmpegDecoderMode
+    {
+        get => (VideoDecoderMode)GetValue(FfmpegDecoderModeProperty);
+        set => SetValue(FfmpegDecoderModeProperty, value);
+    }
+
     public bool IsAudioEnabled
     {
         get => (bool)GetValue(IsAudioEnabledProperty);
@@ -254,6 +261,12 @@ private bool IsUseStaticBackgroundUsed
                                     typeof(LayeredBackgroundImage),
                                     new PropertyMetadata(false));
 
+    public static readonly DependencyProperty FfmpegDecoderModeProperty =
+        DependencyProperty.Register(nameof(FfmpegDecoderMode),
+                                    typeof(VideoDecoderMode),
+                                    typeof(LayeredBackgroundImage),
+                                    new PropertyMetadata(VideoDecoderMode.Automatic));
+
     public static readonly DependencyProperty AudioVolumeProperty =
         DependencyProperty.Register(nameof(AudioVolume),
                                     typeof(double),
diff --git a/Hi3Helper.Core/Lang/en_US.json b/Hi3Helper.Core/Lang/en_US.json
diff --git a/Hi3Helper.Core/Lang/id_ID.json b/Hi3Helper.Core/Lang/id_ID.json

Original file line number	Diff line number	Diff line change
`@@ -377,7 +377,8 @@ private static async Task<bool> LoadVideoFromSourceAsync(`
`377`	`377`	`MaxDecoderThreads = (uint)Environment.ProcessorCount,`
`378`	`378`	`VideoOutputAllow10bit = true,`
`379`	`379`	`VideoOutputAllowBgra8 = true,`
`380`		`- VideoOutputAllowNv12 = true`
	`380`	`+ VideoOutputAllowNv12 = true,`
	`381`	`+ VideoDecoderMode = instance.FfmpegDecoderMode`
`381`	`382`	`}`
`382`	`383`	`};`
`383`	`384`