Merge pull request #297 from winnerspiros/copilot/fix-vulkan-texture-issues

fix: eliminate storyboard atlas overflow GPU stalls + bump framework to 2026.503.7

Author: winnerspiros

osu.Android.props

@@ -99,7 +99,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.Android" Version="2026.503.6" />
+    <PackageReference Include="ppy.osu.Framework.Android" Version="2026.503.7" />
     <!-- `ppy.osu.Framework.NativeLibs` is a transitive dependency of `ppy.osu.Framework`
          that ships desktop-only natives (Linux/macOS/Windows) under `runtimes/<rid>/native/`
          — including a bare Linux `libbass.so`/`libbass_fx.so`/`libbassmix.so` for linux-arm64.

osu.Game/Storyboards/Drawables/DrawableStoryboard.cs

@@ -85,10 +85,17 @@ private void load(IGameplayClock? clock, CancellationToken? cancellationToken, G
             if (clock != null)
                 Clock = clock;
 
+            // Storyboard assets are per-beatmap images (backgrounds, sprites, animations) that are
+            // typically large (e.g. 1920×1080, 2732×1572) and are loaded once per play session.
+            // Using a regular atlased TextureStore causes a storm of atlas overflow events during
+            // beatmap load (one new 2048×2048 GPU texture + vkQueueSubmit per overflow, 8+ times in
+            // ~5 seconds), each stalling the render thread and dropping FPS.
+            // LargeTextureStore skips atlasing entirely so every storyboard asset gets its own GPU
+            // texture with no atlas packing, eliminating all overflow stalls on Android Vulkan.
             dependencies.CacheAs(typeof(TextureStore),
-                new TextureStore(host.Renderer, host.CreateTextureLoaderStore(
+                new LargeTextureStore(host.Renderer, host.CreateTextureLoaderStore(
                     CreateResourceLookupStore()
-                ), false, scaleAdjust: 1));
+                )));
 
             foreach (var layer in Storyboard.Layers)
             {

osu.Game/osu.Game.csproj

@@ -38,10 +38,10 @@
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
     <PackageReference Include="Realm" Version="20.1.0" />
-    <PackageReference Include="ppy.osu.Framework" Version="2026.503.6" />
+    <PackageReference Include="ppy.osu.Framework" Version="2026.503.7" />
     <!--
       Explicitly pin `ppy.Veldrid.SPIRV` to the winnerspiros fork build that
-      `ppy.osu.Framework 2026.503.6` was compiled against. This version is the only
+      `ppy.osu.Framework 2026.503.7` was compiled against. This version is the only
       one whose `runtimes/android-arm64/native/libveldrid-spirv.so` is aligned to 16 KB
       pages (required by Android 16+). It lives only as a release asset on
       <https://github.com/winnerspiros/veldrid-spirv/releases/tag/1.0> and is vendored

osu.iOS.props

@@ -33,6 +33,6 @@
     <SuppressTrimAnalysisWarnings>true</SuppressTrimAnalysisWarnings>
   </PropertyGroup>
   <ItemGroup>
-    <PackageReference Include="ppy.osu.Framework.iOS" Version="2026.503.6" />
+    <PackageReference Include="ppy.osu.Framework.iOS" Version="2026.503.7" />
   </ItemGroup>
 </Project>