Image/Video Background Refactor

BackgroundTest/App.xaml

@@ -0,0 +1,36 @@
+<Application x:Class="BackgroundTest.App"
+             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
+    <Application.Resources>
+        <ResourceDictionary>
+            <ResourceDictionary.MergedDictionaries>
+                <XamlControlsResources xmlns="using:Microsoft.UI.Xaml.Controls" />
+                <ResourceDictionary Source="ms-appx:///CustomControl/NewPipsPager/NewPipsPager_themeresources.xaml" />
+                <ResourceDictionary Source="ms-appx:///CustomControl/NewPipsPager/NewPipsPager.xaml" />
+
+                <ResourceDictionary Source="ms-appx:///CustomControl/LayeredBackgroundImage/LayeredBackgroundImage.xaml" />
+
+                <ResourceDictionary Source="ms-appx:///CustomControl/PanelSlideshow/PanelSlideshow_themeresources.xaml" />
+                <ResourceDictionary Source="ms-appx:///CustomControl/PanelSlideshow/PanelSlideshow.xaml" />
+                <ResourceDictionary>
+                    <ResourceDictionary.ThemeDictionaries>
+                        <ResourceDictionary x:Key="Default">
+                            <AcrylicBrush x:Key="ContentBackgroundAcrylicBrush"
+                                          FallbackColor="#F0222222"
+                                          TintColor="#F0222222"
+                                          TintLuminosityOpacity="0.7"
+                                          TintOpacity="0" />
+                        </ResourceDictionary>
+                        <ResourceDictionary x:Key="Light">
+                            <AcrylicBrush x:Key="ContentBackgroundAcrylicBrush"
+                                          FallbackColor="#F0FFFFFF"
+                                          TintColor="#FFFFFF"
+                                          TintLuminosityOpacity="1"
+                                          TintOpacity="0.0" />
+                        </ResourceDictionary>
+                    </ResourceDictionary.ThemeDictionaries>
+                </ResourceDictionary>
+            </ResourceDictionary.MergedDictionaries>
+        </ResourceDictionary>
+    </Application.Resources>
+</Application>

BackgroundTest/App.xaml.cs

@@ -0,0 +1,23 @@
+using Microsoft.UI.Xaml;
+
+// ReSharper disable SwitchStatementMissingSomeEnumCasesNoDefault
+// ReSharper disable CommentTypo
+// ReSharper disable StringLiteralTypo
+
+namespace BackgroundTest;
+
+public partial class App
+{
+    private TestWindow? _window;
+
+    public App()
+    {
+        InitializeComponent();
+    }
+
+    protected override void OnLaunched(LaunchActivatedEventArgs args)
+    {
+        _window = new TestWindow();
+        _window.Activate();
+    }
+}

BackgroundTest/BackgroundTest.csproj

@@ -0,0 +1,104 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <!-- General Properties -->
+    <OutputType>WinExe</OutputType>
+    <StartupObject>BackgroundTest.MainEntryPoint</StartupObject>
+    <Configurations>Debug;Release</Configurations>
+    <!-- Assembly Info Properties -->
+    <AssemblyName>BackgroundTest</AssemblyName>
+    <ProductName>Collapse</ProductName>
+    <Product>Collapse</Product>
+    <Description>Collapse</Description>
+    <AssemblyTitle>Collapse</AssemblyTitle>
+    <Company>Collapse Launcher Team</Company>
+    <Authors>$(Company). neon-nyan, Cry0, bagusnl, shatyuka, gablm.</Authors>
+    <Copyright>Copyright 2022-2025 $(Company)</Copyright>
+    <!-- Versioning -->
+    <Version>1.83.12</Version>
+    <LangVersion>preview</LangVersion>
+    <Nullable>enable</Nullable>
+    <!-- Target Settings -->
+    <Platforms>x64</Platforms>
+    <TargetFramework>net10.0-windows10.0.26100.0</TargetFramework>
+    <TargetPlatformMinVersion>10.0.17763.0</TargetPlatformMinVersion>
+    <RuntimeIdentifier>win-x64</RuntimeIdentifier>
+    <CsWinRTAotOptimizerEnabled>true</CsWinRTAotOptimizerEnabled>
+    <!-- Debug Settings -->
+    <DebugType>portable</DebugType>
+    <GitVersion>false</GitVersion>
+    <!-- WinUI Properties -->
+    <UseWinUI>true</UseWinUI>
+    <WindowsAppSDKSelfContained>true</WindowsAppSDKSelfContained>
+    <!-- Analyzers Settings -->
+    <EnableAOTAnalyzer>true</EnableAOTAnalyzer>
+    <EnableTrimAnalyzer>true</EnableTrimAnalyzer>
+    <SuppressTrimAnalysisWarnings>false</SuppressTrimAnalysisWarnings>
+    <TrimmerSingleWarn>false</TrimmerSingleWarn>
+    <!-- Other Settings -->
+    <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
+    <EnablePreviewMsixTooling>true</EnablePreviewMsixTooling>
+    <BuiltInComInteropSupport>false</BuiltInComInteropSupport>
+    <RestorePackagesWithLockFile>true</RestorePackagesWithLockFile>
+    <InvariantGlobalization>false</InvariantGlobalization>
+    <ShouldComputeInputPris>true</ShouldComputeInputPris>
+    <DisableImplicitNuGetFallbackFolder>true</DisableImplicitNuGetFallbackFolder>
+    <GenerateNeutralResourcesLanguageAttribute>false</GenerateNeutralResourcesLanguageAttribute>
+    <JsonSerializerIsReflectionEnabledByDefault>false</JsonSerializerIsReflectionEnabledByDefault>
+    <WebView2EnableCsWinRTProjection>true</WebView2EnableCsWinRTProjection>
+  </PropertyGroup>
+
+  <PropertyGroup Condition="'$(Configuration)'=='Debug'">
+    <OutputType>Exe</OutputType>
+    <!-- !! IMPORTANT !!-->
+    <!-- DO NOT FORGET TO UPDATE THE DEFINECONSTANTS IN THE PUBLISH PROFILE(S) AS WELL   -->
+    <DefineConstants>DISABLE_XAML_GENERATED_MAIN;ENABLEUSERFEEDBACK;USEVELOPACK;USENEWZIPDECOMPRESS;ENABLEHTTPREPAIR;PREVIEW;DUMPGIJSON;SIMULATEGIHDR;GSPBYPASSGAMERUNNING;MHYPLUGINSUPPORT</DefineConstants>
+    <TrimMode>full</TrimMode>
+  </PropertyGroup>
+  <PropertyGroup Condition="'$(Configuration)'=='Release'">
+    <!-- !! IMPORTANT !!-->
+    <!-- DO NOT FORGET TO UPDATE THE DEFINECONSTANTS IN THE PUBLISH PROFILE(S) AS WELL   -->
+    <DefineConstants>DISABLE_XAML_GENERATED_MAIN;ENABLEUSERFEEDBACK;USEVELOPACK;USENEWZIPDECOMPRESS;ENABLEHTTPREPAIR;PREVIEW;MHYPLUGINSUPPORT</DefineConstants>
+    <Optimize>True</Optimize>
+    <GitSkipCache>true</GitSkipCache>
+  </PropertyGroup>
+  <PropertyGroup Condition="'$(Configuration)'=='Publish'">
+    <!-- !! IMPORTANT !!-->
+    <!-- DO NOT FORGET TO UPDATE THE DEFINECONSTANTS IN THE PUBLISH PROFILE(S) AS WELL   -->
+    <DefineConstants>DISABLE_XAML_GENERATED_MAIN;ENABLEUSERFEEDBACK;USEVELOPACK;USENEWZIPDECOMPRESS;ENABLEHTTPREPAIR;MHYPLUGINSUPPORT</DefineConstants>
+    <Optimize>true</Optimize>
+    <GitSkipCache>true</GitSkipCache>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <Content Include="CustomControl\BGTestImage*">
+      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
+    </Content>
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="CommunityToolkit.Common" Version="8.4.0" />
+    <PackageReference Include="CommunityToolkit.Mvvm" Version="8.4.0" />
+    <PackageReference Include="CommunityToolkit.WinUI.Behaviors" Version="8.2.250402" />
+    <PackageReference Include="CommunityToolkit.WinUI.Controls.Primitives" Version="8.2.250402" />
+    <PackageReference Include="CommunityToolkit.WinUI.Media" Version="8.2.250402" />
+    <PackageReference Include="CommunityToolkit.WinUI.Converters" Version="8.2.250402" />
+    <PackageReference Include="CommunityToolkit.WinUI.Extensions" Version="8.2.250402" />
+    <PackageReference Include="CommunityToolkit.WinUI.Controls.Sizers" Version="8.2.250402" />
+
+    <PackageReference Include="Microsoft.Graphics.Win2D" Version="1.3.2" />
+    <PackageReference Include="Microsoft.Windows.CsWinRT" Version="2.3.0-prerelease.250720.1" />
+    <PackageReference Include="Microsoft.Windows.SDK.BuildTools" Version="10.0.26100.6901" />
+    <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.8.251106002" />
+    <PackageReference Include="Microsoft.Xaml.Behaviors.WinUI.Managed" Version="3.0.0" />
+    <PackageReference Include="PhotoSauce.MagicScaler" Version="0.15.0" />
+    <PackageReference Include="PhotoSauce.NativeCodecs.Libheif" Version="1.19.5-preview1" />
+    <PackageReference Include="PhotoSauce.NativeCodecs.Libjxl" Version="0.11.1-preview2" />
+    <PackageReference Include="PhotoSauce.NativeCodecs.Libwebp" Version="*-*" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\Hi3Helper.Win32\Hi3Helper.Win32.csproj" />
+    <ProjectReference Include="..\Hi3Helper.Win32\WinRT\Hi3Helper.Win32.WinRT.csproj" />
+  </ItemGroup>
+
+</Project>

BackgroundTest/CustomControl/ChangedStructItemArgs.cs

@@ -0,0 +1,15 @@
+namespace BackgroundTest.CustomControl;
+
+public readonly struct ChangedStructItemArgs<TItem>(TItem oldItem, TItem newItem)
+    where TItem : struct
+{
+    public TItem OldItem { get; private init; } = oldItem;
+    public TItem NewItem { get; private init; } = newItem;
+}
+
+public class ChangedObjectItemArgs<TItem>(TItem? oldItem, TItem? newItem)
+    where TItem : class
+{
+    public TItem? OldItem { get; private init; } = oldItem;
+    public TItem? NewItem { get; private init; } = newItem;
+}

BackgroundTest/CustomControl/Extensions.cs

@@ -0,0 +1,110 @@
+using Microsoft.UI.Input;
+using Microsoft.UI.Xaml;
+using Microsoft.UI.Xaml.Controls;
+using Microsoft.UI.Xaml.Data;
+using System;
+using System.IO;
+using System.Runtime.CompilerServices;
+
+namespace BackgroundTest.CustomControl;
+
+public static class Extensions
+{
+    public static readonly DependencyProperty CursorTypeProperty =
+        DependencyProperty.RegisterAttached("CursorType", typeof(InputSystemCursorShape),
+                                            typeof(UIElement), new PropertyMetadata(InputSystemCursorShape.Arrow));
+
+    public static InputSystemCursorShape GetCursorType(DependencyObject obj) => (InputSystemCursorShape)obj.GetValue(CursorTypeProperty);
+
+    public static void SetCursorType(DependencyObject obj, InputSystemCursorShape value)
+    {
+        InputSystemCursor? cursor = InputSystemCursor.Create(value);
+        if (cursor is null ||
+            obj is not UIElement asElement)
+        {
+            return;
+        }
+
+        asElement.SetCursor(cursor);
+        asElement.SetValue(CursorTypeProperty, value);
+    }
+
+    extension(Control source)
+    {
+        [UnsafeAccessor(UnsafeAccessorKind.Method, Name = "GetTemplateChild")]
+        private extern DependencyObject GetTemplateChildAccessor(string name);
+
+        internal T GetTemplateChild<T>(string name)
+            where T : class
+        {
+            DependencyObject obj = source.GetTemplateChildAccessor(name);
+            if (obj is not T castObj)
+            {
+                throw new
+                    InvalidCastException($"Cannot cast type to: {typeof(T).Name} as the object expects type: {obj.GetType().Name}");
+            }
+
+            return castObj;
+        }
+    }
+
+    /// <param name="element">The <seealso cref="UIElement"/> member of an element</param>
+    extension(UIElement element)
+    {
+        /// <summary>
+        /// Set the cursor for the element.
+        /// </summary>
+        /// <param name="inputCursor">The cursor you want to set. Use <see cref="InputSystemCursor.Create"/> to choose the cursor you want to set.</param>
+        [UnsafeAccessor(UnsafeAccessorKind.Method, Name = "set_ProtectedCursor")]
+        private extern void SetCursor(InputCursor inputCursor);
+    }
+
+    internal static double TryGetDouble(this object? obj)
+    {
+        return obj switch
+        {
+            sbyte asSbyte   => asSbyte,
+            byte asByte     => asByte,
+            ushort asUshort => asUshort,
+            short asShort   => asShort,
+            uint asUint     => asUint,
+            int asInt       => asInt,
+            ulong asUlong   => asUlong,
+            long asLong     => asLong,
+            float asFloat   => asFloat,
+            double asDouble => asDouble,
+            _               => double.NaN
+        };
+    }
+
+    internal static void BindProperty(this FrameworkElement element,
+                                      FrameworkElement      source,
+                                      string                propertyName,
+                                      DependencyProperty    dependencyProperty,
+                                      BindingMode           bindingMode)
+    {
+        element.SetBinding(dependencyProperty, new Binding
+        {
+            Mode = bindingMode,
+            Source = source,
+            Path = new PropertyPath(propertyName)
+        });
+    }
+
+    internal static Uri GetStringAsUri(this string asStringSource)
+    {
+        // Try to create URL with absolute path.
+        // If not (assume it's a relative local path), then try to get the fully qualified local path.
+        if (Uri.TryCreate(asStringSource, UriKind.Absolute, out Uri? sourceUri) ||
+            Path.IsPathFullyQualified(asStringSource))
+        {
+            return sourceUri ?? new Uri(asStringSource);
+        }
+
+        string             currentWorkingDir  = Directory.GetCurrentDirectory();
+        ReadOnlySpan<char> asStringSourceSpan = asStringSource.Trim("/\\");
+        asStringSource = Path.Join(currentWorkingDir, asStringSourceSpan);
+
+        return sourceUri ?? new Uri(asStringSource);
+    }
+}

BackgroundTest/CustomControl/LayeredBackgroundImage/IMediaCacheHandler.cs

@@ -0,0 +1,39 @@
+using System;
+using System.IO;
+using System.Threading.Tasks;
+
+namespace BackgroundTest.CustomControl.LayeredBackgroundImage;
+
+/// <summary>
+/// An interface which implements media cache handler for loading cached media sources.
+/// </summary>
+public interface IMediaCacheHandler
+{
+    /// <summary>
+    /// Loads the media source from cached local path or URL or Seekable and Readable <see cref="Stream"/>.
+    /// </summary>
+    /// <param name="sourceObject">The input source to be cached.</param>
+    /// <returns>An instance of <see cref="MediaCacheResult"/> which defines the cached source and its properties.</returns>
+    Task<MediaCacheResult> LoadCachedSource(object? sourceObject);
+}
+
+/// <summary>
+/// Contains the result and properties of the cached media source.
+/// </summary>
+public class MediaCacheResult
+{
+    /// <summary>
+    /// Indicates whether to force using the WIC (Windows Imaging Component) decoder for image source or not.
+    /// </summary>
+    public bool ForceUseInternalDecoder { get; set; }
+
+    /// <summary>
+    /// The source of the media. Only <see cref="string"/> or <see cref="Uri"/> for local path and URL, or Seekable and Readable <see cref="Stream"/> types are supported.
+    /// </summary>
+    public object? CachedSource { get; set; }
+
+    /// <summary>
+    /// Whether to perform Dispose if <see cref="CachedSource"/> is a <see cref="Stream"/> type.
+    /// </summary>
+    public bool DisposeStream { get; set; }
+}