done, methinks

Author: PurSnake

source/funkin/FunkinMemory.hx

@@ -28,7 +28,7 @@ class FunkinMemory
 
   static var purgeFilter:Array<String> = ["/week", "/characters", "/charSelect", "/results"];
 
-  public static var allowVRAMCaching:Bool = true;
+  public static var allowVRAMCaching:Bool = #if desktop true #else false #end;
 
   /**
    * Caches textures that are always required.

source/funkin/Preferences.hx

@@ -15,6 +15,33 @@ import funkin.ui.debug.FunkinDebugDisplay.DebugDisplayMode;
 @:nullSafety
 class Preferences
 {
+  /**
+   * VRAM Caching allows to decrease some used RAM memory for optimization and better use.
+   * @default `true` on desktop, otherwise `false`
+   */
+  public static var vramCaching(get, set):Bool;
+
+  static function get_vramCaching():Bool
+  {
+    #if desktop
+    return Save?.instance?.options?.vramCaching ?? true;
+    #else
+    return false;
+    #end
+  }
+
+  static function set_vramCaching(value:Bool):Bool
+  {
+    #if desktop
+    Save.instance.options.vramCaching = value;
+    openfl.utils.Assets.allowGPU = FunkinMemory.allowVRAMCaching = value;
+    Save.instance.flush();
+    return value;
+    #else
+    return false;
+    #end
+  }
+
   /**
    * FPS
    * Always the refresh rate of the display on mobile, or 60 on web.
@@ -516,6 +543,10 @@ class Preferences
     // Apply the allowScreenTimeout setting.
     lime.system.System.allowScreenTimeout = Preferences.screenTimeout;
     #end
+
+    #if desktop
+    openfl.utils.Assets.allowGPU = FunkinMemory.allowVRAMCaching = Preferences.vramCaching;
+    #end
   }
 
   static function toggleFramerateCap(unlocked:Bool):Void

source/funkin/save/Save.hx

@@ -120,6 +120,7 @@ class Save implements ConsoleClass
           framerate: #if mobile refreshRate #else 60 #end,
           naughtyness: true,
           downscroll: false,
+          vramCaching: true,
           flashingLights: true,
           zoomCamera: true,
           debugDisplay: 'Off',
@@ -1593,6 +1594,12 @@ typedef SaveDataOptions =
    */
   var downscroll:Bool;
 
+  /**
+   * If enabled, sprites will load into VRAM.
+   * @default `true`
+   */
+  var vramCaching:Bool;
+
   /**
    * If disabled, flashing lights in the main menu and other areas will be less intense.
    * @default `true`

source/funkin/ui/options/PreferencesMenu.hx

@@ -138,6 +138,13 @@ class PreferencesMenu extends Page<OptionsState.OptionsMenuPageName>
       Preferences.hapticsIntensityMultiplier = value;
     }, null, Preferences.hapticsIntensityMultiplier, 0.1, 5, 0.1, 1);
     #end
+
+    #if desktop
+    createPrefItemCheckbox('VRAM Caching', 'If enabled, most sprites will be loaded into VRAM.', function(value:Bool):Void {
+      Preferences.vramCaching = value;
+    }, Preferences.vramCaching);
+    #end
+
     createPrefItemCheckbox('Flashing Lights', 'If disabled, it will dampen flashing effects. Useful for people with photosensitive epilepsy.',
       function(value:Bool):Void {
         Preferences.flashingLights = value;