Add the base test case for testing position for those type of shaders.

- No shader.
- Outline shader(with different size).
- Shadow shader(with different size).
- Outline and shadow shader(with different size).

osu.Framework.Font.Tests/Visual/Sprites/TestSceneKaraokeSpriteTextTransforms.cs

@@ -0,0 +1,201 @@
+// Copyright (c) karaoke.dev <[email protected]>. Licensed under the MIT Licence.
+// See the LICENCE file in the repository root for full licence text.
+
+using NUnit.Framework;
+using osu.Framework.Extensions;
+using osu.Framework.Extensions.Color4Extensions;
+using osu.Framework.Font.Tests.Helper;
+using osu.Framework.Graphics;
+using osu.Framework.Graphics.Shaders;
+using osu.Framework.Graphics.Sprites;
+using osu.Framework.Timing;
+using osuTK;
+using osuTK.Graphics;
+
+namespace osu.Framework.Font.Tests.Visual.Sprites
+{
+    public class TestSceneKaraokeSpriteTextTransforms : BackgroundGridTestScene
+    {
+        private const string left_text_color = "#FFDD77";
+        private const string left_outline_color = "#CCA532";
+        private const string left_shadow_color = "#6B5B2D";
+
+        private const string right_text_color = "#AA88FF";
+        private const string right_outline_color = "#5932CC";
+        private const string right_shadow_color = "#3D2D6B";
+
+        private const double start_time = 1000;
+        private const double end_time = 5000;
+        private const double exrea_time = 500;
+
+        private readonly ManualClock manualClock = new();
+        private readonly TestKaraokeSpriteText karaokeSpriteText;
+
+        public TestSceneKaraokeSpriteTextTransforms()
+        {
+            Child = karaokeSpriteText = new TestKaraokeSpriteText
+            {
+                Anchor = Anchor.Centre,
+                Origin = Anchor.Centre,
+                LeftTextColour = Color4Extensions.FromHex(left_text_color),
+                RightTextColour = Color4Extensions.FromHex(right_text_color),
+                Clock = new FramedClock(manualClock),
+                Scale = new Vector2(2),
+            };
+
+            AddLabel("Load lyric");
+
+            AddStep("Single character", () =>
+            {
+                karaokeSpriteText.Text = "カ";
+                karaokeSpriteText.TimeTags = TestCaseTagHelper.ParseTimeTags(new[] { $"[0,start]:{start_time}", $"[0,end]:{end_time}" });
+                karaokeSpriteText.Font = FontUsage.Default.With(size: 120);
+            });
+
+            AddStep("Multiple character", () =>
+            {
+                karaokeSpriteText.Text = "カラオケ";
+                karaokeSpriteText.TimeTags = TestCaseTagHelper.ParseTimeTags(new[] { $"[0,start]:{start_time}", "[1,start]:2000", "[2,start]:3000", "[3,start]:4000", $"[3,end]:{end_time}" });
+                karaokeSpriteText.Font = FontUsage.Default.With(size: 60);
+            });
+
+            AddLabel("Timing");
+
+            AddSliderStep("Adjust clock time", 0, end_time + exrea_time, start_time - exrea_time, time =>
+            {
+                manualClock.CurrentTime = time;
+            });
+
+            AddStep("Move to start time", () =>
+            {
+                manualClock.CurrentTime = start_time;
+            });
+
+            AddStep("Move to end time", () =>
+            {
+                manualClock.CurrentTime = end_time;
+            });
+        }
+
+        [Test]
+        public void TestNoneShader()
+        {
+            AddStep("Clear shader", () =>
+            {
+                karaokeSpriteText.LeftTextColour = Color4Extensions.FromHex(left_text_color);
+                karaokeSpriteText.RightTextColour = Color4Extensions.FromHex(right_text_color);
+                karaokeSpriteText.LeftLyricTextShaders = null;
+                karaokeSpriteText.RightLyricTextShaders = null;
+            });
+        }
+
+        [Test]
+        public void TestApplyOutlineShader()
+        {
+            AddStep("Apply shader", () =>
+            {
+                karaokeSpriteText.LeftTextColour = Color4.White;
+                karaokeSpriteText.RightTextColour = Color4.White;
+                karaokeSpriteText.LeftLyricTextShaders = new[]
+                {
+                    GetShaderByType<OutlineShader>().With(s =>
+                    {
+                        s.Radius = 10;
+                        s.Colour = Color4Extensions.FromHex(left_text_color);
+                        s.OutlineColour = Color4Extensions.FromHex(left_outline_color);
+                    })
+                };
+                karaokeSpriteText.RightLyricTextShaders = new[]
+                {
+                    GetShaderByType<OutlineShader>().With(s =>
+                    {
+                        s.Radius = 10;
+                        s.Colour = Color4Extensions.FromHex(right_text_color);
+                        s.OutlineColour = Color4Extensions.FromHex(right_outline_color);
+                    })
+                };
+            });
+        }
+
+        [Test]
+        public void TestApplyShadowShader()
+        {
+            AddStep("Apply shadow", () =>
+            {
+                karaokeSpriteText.LeftTextColour = Color4Extensions.FromHex(left_text_color);
+                karaokeSpriteText.RightTextColour = Color4Extensions.FromHex(right_text_color);
+                karaokeSpriteText.LeftLyricTextShaders = new[]
+                {
+                    GetShaderByType<ShadowShader>().With(s =>
+                    {
+                        s.ShadowOffset = new Vector2(10);
+                        s.ShadowColour = Color4Extensions.FromHex(left_shadow_color);
+                    })
+                };
+                karaokeSpriteText.RightLyricTextShaders = new[]
+                {
+                    GetShaderByType<ShadowShader>().With(s =>
+                    {
+                        s.ShadowOffset = new Vector2(10);
+                        s.ShadowColour = Color4Extensions.FromHex(right_shadow_color);
+                    })
+                };
+            });
+        }
+
+        [Test]
+        public void TestApplyOutlineAndShadowShader()
+        {
+            AddStep("Apply shader", () =>
+            {
+                karaokeSpriteText.LeftTextColour = Color4.White;
+                karaokeSpriteText.RightTextColour = Color4.White;
+                karaokeSpriteText.LeftLyricTextShaders = new[]
+                {
+                    new StepShader
+                    {
+                        StepShaders = new ICustomizedShader[]
+                        {
+                            GetShaderByType<OutlineShader>().With(s =>
+                            {
+                                s.Radius = 10;
+                                s.Colour = Color4Extensions.FromHex(left_text_color);
+                                s.OutlineColour = Color4Extensions.FromHex(left_outline_color);
+                            }),
+                            GetShaderByType<ShadowShader>().With(s =>
+                            {
+                                s.ShadowOffset = new Vector2(10);
+                                s.ShadowColour = Color4Extensions.FromHex(left_shadow_color);
+                            })
+                        }
+                    }
+                };
+                karaokeSpriteText.RightLyricTextShaders = new[]
+                {
+                    new StepShader
+                    {
+                        StepShaders = new ICustomizedShader[]
+                        {
+                            GetShaderByType<OutlineShader>().With(s =>
+                            {
+                                s.Radius = 10;
+                                s.Colour = Color4Extensions.FromHex(right_text_color);
+                                s.OutlineColour = Color4Extensions.FromHex(right_outline_color);
+                            }),
+                            GetShaderByType<ShadowShader>().With(s =>
+                            {
+                                s.ShadowOffset = new Vector2(10);
+                                s.ShadowColour = Color4Extensions.FromHex(right_shadow_color);
+                            })
+                        }
+                    }
+                };
+            });
+        }
+
+        private class TestKaraokeSpriteText : KaraokeSpriteText
+        {
+            public override bool RemoveCompletedTransforms => false;
+        }
+    }
+}