added screen wipe helper methods

Author: BenMakesGames

BenMakesGames.PlayPlayMini.GraphicsExtensions/BenMakesGames.PlayPlayMini.GraphicsExtensions.csproj

@@ -5,7 +5,7 @@
         <Company>Ben Hendel-Doying</Company>
         <Description>Some GraphicsManager extensions for PlayPlayMini.</Description>
         <Copyright>2023-2025 Ben Hendel-Doying</Copyright>
-        <Version>7.0.0-rc1</Version>
+        <Version>7.0.0-rc2</Version>
 
         <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
         <PackageTags>monogame playplaymini graphics extensions animations text</PackageTags>

BenMakesGames.PlayPlayMini.GraphicsExtensions/GameStateTransitions/GameStateManagerExtensions.cs

@@ -0,0 +1,55 @@
+using Microsoft.Xna.Framework;
+
+namespace BenMakesGames.PlayPlayMini.GraphicsExtensions.GameStateTransitions;
+
+/// <summary>
+/// Extension methods for doing quick screen wipes between game states
+/// </summary>
+public static class GameStateManagerExtensions
+{
+    public static void ChangeStateWithScreenWipe<T>(
+        this GameStateManager gsm,
+        ScreenWipeDirection direction,
+        Color? color = null
+    ) where T : GameState =>
+        gsm.ChangeState<ScreenWipe, ScreenWipeConfig>(new ScreenWipeConfig()
+        {
+            PreviousState = gsm.CurrentState,
+            NextState = gsm.CreateState<T>(),
+            Color = color ?? Color.Black,
+            Direction = direction
+        });
+
+    public static void ChangeStateWithScreenWipe<T, TConfig>(
+        this GameStateManager gsm,
+        TConfig config,
+        ScreenWipeDirection direction,
+        Color? color = null
+    ) where T : GameState<TConfig> =>
+        gsm.ChangeState<ScreenWipe, ScreenWipeConfig>(new ScreenWipeConfig()
+        {
+            PreviousState = gsm.CurrentState,
+            NextState = gsm.CreateState<T, TConfig>(config),
+            Color = color ?? Color.Black,
+            Direction = direction
+        });
+
+    /// <summary>Change to the given game state, via a screen wipe.</summary>
+    /// <param name="gsm"></param>
+    /// <param name="nextState">Game state to switch to.</param>
+    /// <param name="direction">Direction of wipe.</param>
+    /// <param name="color">Color of wipe (defaults to <see cref="P:Microsoft.Xna.Framework.Color.Black">Color.Black</see>)</param>
+    public static void ChangeStateWithScreenWipe(
+        this GameStateManager gsm,
+        AbstractGameState nextState,
+        ScreenWipeDirection direction,
+        Color? color = null
+    ) =>
+        gsm.ChangeState<ScreenWipe, ScreenWipeConfig>(new ScreenWipeConfig()
+        {
+            PreviousState = gsm.CurrentState,
+            NextState = nextState,
+            Color = color ?? Color.Black,
+            Direction = direction
+        });
+}