[R] Slide的Head属性重命名为OwnHead

Author: Starrah

chart/Slide.cs

@@ -22,7 +22,8 @@ public Star(Tap inTake): this(inTake.Chart, inTake.Time) // 拷贝构造函数
 [DebuggerDisplay("{DebuggerDisplay(),nq}")]
 public class Slide : Note
 {
-    public Tap? Head; // 根据simai语法，星星头既可以是普通的星星形状(1-5)，也可以是Tap形状的(1@-5)，也可以没有(1?-5或1!-5)
+    public Tap? OwnHead; // 属于自己的星星头。只有在SharedHeadWith=null的那根星星上应该设置此项，否则直接通过SharedHeadWith链过去即可
+    // PS: 根据simai语法，星星头既可以是普通的星星形状(1-5)，也可以是Tap形状的(1@-5)，也可以没有(1?-5或1!-5)
     public Slide? SharedHeadWith;
     public List<SlideSegment> segments = new();
     public Duration WaitTime;
@@ -34,14 +35,17 @@ public Slide(Chart chart, Rational time) : base(chart, time)
 
     public override int Key
     {
-        get => Head?.Key ?? SharedHeadWith?.Key ?? _key;
+        get => OwnHead?.Key ?? SharedHeadWith?.Key ?? _key;
         set
         {
-            Utils.Assert(Head == null && SharedHeadWith?.Key == null, "尝试为有头星星手动设置星星头");
+            Utils.Assert(OwnHead == null && SharedHeadWith?.Key == null, "尝试为有头星星手动设置星星头");
             if (value < 1 || value > 8) throw new ArgumentException(string.Format(Locale.InvalidKey, value));
             _key = value;
         }
     }
+    
+    // 所有的SharedHeadWith的连接关系，会构成一棵树，其中只有树根节点有OwnHead且SharedHeadWith为null。
+    public Slide SharedHeadWithRoot => SharedHeadWith != null ? SharedHeadWith.SharedHeadWithRoot : this;
 
     public int EndKey => segments.Count > 0 ? segments.Last().EndKey : Key;
 
@@ -75,10 +79,12 @@ private string DebuggerDisplay()
     {
         string result;
         if (SharedHeadWith != null) result = "*";
-        else if (Head != null) result = Head.DebuggerDisplay();
-        else result = Key.ToString();
-        if (Head != null && !(Head is Star)) result += "@"; // Tap形状的头
-        else if (Head == null && SharedHeadWith == null) result += "?"; // 无头
+        else if (OwnHead != null)
+        {
+            result = OwnHead.DebuggerDisplay();
+            if (!(OwnHead is Star)) result += "@"; // Tap形状的头
+        }
+        else result = Key + "?"; // 无头
 
         var segStart = Key;
         foreach (var s in segments)

generator/MA2Generator.cs

@@ -136,7 +136,7 @@ private void AddTap(Tap tap, int bar, int tick)
             }
             else if (note is Slide slide)
             {
-                if (slide.Head != null) AddTap(slide.Head, bar, tick);
+                if (slide.OwnHead != null) AddTap(slide.OwnHead, bar, tick);
 
                 // 首先很重要的一点是，详见 https://github.com/Neskol/MaiLib/issues/46#issuecomment-3301893924 ，
                 // 官机现在对于多段星星，是会无视掉每一段分别指定的时长，把总时长加和然后全程匀速处理的。

parser/MA2Parser.cs

@@ -217,7 +217,7 @@ void pair()
                 toRemove.Add(pairedTap);
                 for (int j = 0; j < slideLists[i].Count; j++)
                 {
-                    if (j == 0) slideLists[i][j].Head = pairedTap;
+                    if (j == 0) slideLists[i][j].OwnHead = pairedTap;
                     else slideLists[i][j].SharedHeadWith = slideLists[i][0];
                 }
             }

parser/simai/SimaiParser.cs

@@ -451,7 +451,7 @@ public sealed override object VisitSlide(P.SlideContext context)
             head = null;
         }
         else if (context.STAR_TO_TAP() == null) head = new Star(head); // 除非标记了STAR_TO_TAP，否则把tap转为star
-        result.Head = head;
+        result.OwnHead = head;
 
         currNote = result;
         VisitSlideBody(context.slideBody());