[ENHANCEMENT] Add offsets support for Album titles (#3618)

* add album title offsets * cleanup * cleanup * fix inconsistency
FunkinCrew · Jan 17, 2025 · 69d8570 · 69d8570
1 parent a17b0e8
commit 69d8570
Show file tree

Hide file tree

Showing 3 changed files with 25 additions and 2 deletions.
diff --git a/source/funkin/data/freeplay/album/AlbumData.hx b/source/funkin/data/freeplay/album/AlbumData.hx
@@ -36,6 +36,13 @@ typedef AlbumData =
    */
   public var albumTitleAsset:String;
 
+  /**
+   * Offsets for the album title.
+   */
+  @:optional
+  @:default([0, 0])
+  public var albumTitleOffsets:Null<Array<Float>>;
+
   /**
    * An optional array of animations for the album title.
    */

diff --git a/source/funkin/ui/freeplay/Album.hx b/source/funkin/ui/freeplay/Album.hx
@@ -76,6 +76,14 @@ class Album implements IRegistryEntry<AlbumData>
     return _data.albumTitleAsset;
   }
 
+  /**
+   * Get the offsets for the album title.
+   */
+  public function getAlbumTitleOffsets():Null<Array<Float>>
+  {
+    return _data.albumTitleOffsets;
+  }
+
   public function hasAlbumTitleAnimations()
   {
     return _data.albumTitleAnimations.length > 0;

diff --git a/source/funkin/ui/freeplay/AlbumRoll.hx b/source/funkin/ui/freeplay/AlbumRoll.hx
@@ -112,7 +112,7 @@ class AlbumRoll extends FlxSpriteGroup
     var albumGraphic = Paths.image(albumData.getAlbumArtAssetKey());
     newAlbumArt.replaceFrameGraphic(0, albumGraphic);
 
-    buildAlbumTitle(albumData.getAlbumTitleAssetKey());
+    buildAlbumTitle(albumData.getAlbumTitleAssetKey(), albumData.getAlbumTitleOffsets());
 
     applyExitMovers();
 
@@ -198,14 +198,19 @@ class AlbumRoll extends FlxSpriteGroup
     albumTitle.visible = true;
   }
 
-  public function buildAlbumTitle(assetKey:String):Void
+  public function buildAlbumTitle(assetKey:String, ?titleOffsets:Null<Array<Float>>):Void
   {
     if (albumTitle != null)
     {
       remove(albumTitle);
       albumTitle = null;
     }
 
+    if (titleOffsets == null)
+    {
+      titleOffsets = [0, 0];
+    }
+
     albumTitle = FunkinSprite.createSparrow(925, 500, assetKey);
     albumTitle.visible = albumTitle.frames != null && newAlbumArt.visible;
     albumTitle.animation.addByPrefix('idle', 'idle0', 24, true);
@@ -219,6 +224,9 @@ class AlbumRoll extends FlxSpriteGroup
 
     albumTitle.zIndex = 1000;
 
+    albumTitle.x += titleOffsets[0];
+    albumTitle.y += titleOffsets[1];
+
     if (_exitMovers != null) _exitMovers.set([albumTitle],
       {
         x: FlxG.width,