[R] 将SflList和ClockCount移动到BaseChart内，从而方便音击复用。

Author: Starrah

chart/BaseChart.cs

@@ -25,10 +25,40 @@ public abstract class BaseChart<TNote>: IBaseChart where TNote: BaseNote
     /**
      * 所有拍号声明构成的列表。
      *
-     * 已知该内容，目前在游戏内暂无实质性的效果。maimai中无任何效果，chunnithm则会把这个作为显示小节和拍子参考线时候额依据、但也仅影响显示效果，对游戏本身无影响。
+     * 已知该内容，目前在游戏内暂无实质性的效果。maimai中无任何效果，chunithm则会把这个作为显示小节和拍子参考线时候额依据、但也仅影响显示效果，对游戏本身无影响。
      */
     public List<MET> MetList = [];
 
+    /**
+     * 所有变速声明构成的列表。
+     *
+     * maimai不会用到，ongeki和chunithm才会用到。
+     */
+    public List<(Rational Time, Rational Duration, decimal Multiplier)> SflList = [];
+    
+    /**
+     * 谱面开头的“哒哒哒哒”声音的个数。
+     *
+     * 具体而言，有两种指定方式：
+     * 1. 直接设置本属性。则会利用游戏内部自带的CLK_DEF机制，会按每拍一次的频率生成指定个数的"哒"声。
+     * 2. 设置ExplicitClocks属性。这个直接对应于谱面中的CLK语句，有几行就是几声。
+     */
+    public int ClockCount
+    {
+        get => ExplicitClocks?.Count ?? field;
+        set
+        {
+            field = value;
+            ExplicitClocks = null;
+        }
+    } = 4;
+    
+    /**
+     * 这是MA2/OGKR语句中，通过CLK指令所显式指定的哒哒哒哒的时刻。
+     * 除去极个别官谱外，一般来说极少会用到。详见ClockCount属性上的注释。
+     */
+    public List<Rational>? ExplicitClocks;
+    
     /**
      * 根据BPMList中的声明，将小节时间转换为秒。
      */
@@ -76,6 +106,9 @@ public virtual void Sort()
         BpmList.AddRange(sortedBpms);
 
         MetList = MetList.OrderBy(x => x.Time).ToList();
+        SflList = SflList.OrderBy(x => x.Time).ToList();
+        if (ExplicitClocks != null) ExplicitClocks = ExplicitClocks.Order().ToList();
+        
         Notes = SortNotes().ToList(); // LINQ OrderBy 是稳定排序
     }
 
@@ -106,6 +139,12 @@ public virtual void Shift(Rational offset, decimal? bpm = null)
             .Skip(MetList.Count(x => x.Time <= 0) - 1)
             .Select((x, i) => i == 0 ? x with { Time = 0 } : x).ToList();
 
+        // 对SflList和ExplicitClocks的处理：加上offset后，只保留>=0的项
+        SflList = SflList.Select(x => x with { Time = x.Time + offset })
+            .Where(x => x.Time >= 0).ToList();
+        if (ExplicitClocks != null) 
+            ExplicitClocks = ExplicitClocks.Select(x => x + offset).Where(x => x >= 0).ToList();
+        
         // Notes，时间加上offset，但注意需要对children进行递归操作
         HashSet<BaseNote> processed = [];
         Notes = Notes.Where(x => addOffset(x).Time >= 0).ToList();

chart/BaseNote.cs

@@ -12,9 +12,13 @@ public abstract class BaseNote
     /**
      * 音符的结束时刻。以小节为单位（分数时间）
      *
-     * 默认实现中实现为等于开始时刻（瞬间音符，没有持续时间）。有持续时间的音符应当重写此属性。
+     * 默认实现中实现为等于开始时刻（瞬间音符，没有持续时间），且该属性只能get不能set。有持续时间的音符应当重写此属性。
      */
-    public virtual Rational EndTime => Time;
+    public virtual Rational EndTime
+    {
+        get => Time;
+        set => throw new InvalidOperationException("Cannot directly manipulate Note's EndTime. You may want to manipulate the 'Duration' property on the note.");
+    }
 
     /**
      * 如果有某个音符，包含另一个/一些音符作为子音符，这些子音符本身不会出现在Chart的Notes列表内：

chart/chu/ChuChart.cs

@@ -12,5 +12,4 @@ public class ChuChart : BaseChart<ChuNote>
     public string DisplayLevel { get; set; } = ""; // 显示等级，字符串
     public decimal Level { get; set; } // 定数，小数
     public string MusicId { get; set; } = "0";
-    public List<(Rational Time, Rational Duration, decimal Multiplier)> SflList = []; // 所有变速声明构成的列表。
 }

chart/mai/MaiChart.cs

@@ -1,23 +1,11 @@
 using MuConvert.chart;
-using MuConvert.utils;
-using Rationals;
 
 namespace MuConvert.mai;
 
 public class MaiChart: BaseChart<Note>
 {
     public string DefaultTouchSize = "M1";
 
-    public int ClockCount
-    {
-        get => ExplicitClocks?.Count ?? field;
-        set
-        {
-            field = value;
-            ExplicitClocks = null;
-        }
-    } = 4;
-
     /**
      * 获得谱面开始的时刻（即谱面中第一个音符的开始时刻）。
      * 
@@ -33,14 +21,6 @@ public int ClockCount
         note is Slide { segments.Count: > 1 }); // 星星段数大于1（fes星星）
 
     public Statistics Statistics => new(this);
-    
-    /**
-     * 这是MA2语句中，通过CLK指令所显式指定的哒哒哒哒的时刻。
-     * 一般来说极少会用到，这里只是忠实地记录一下；一方面符合我们“0信息损失”的原则、忠实地记录铺面中的信息；
-     * 另一方面，可以用作ClockCount自动推导的来源之一。
-     * 普通用户理论上极少会用到这个东西。
-     */
-    public List<Rational>? ExplicitClocks;
 
     protected override IEnumerable<Note> SortNotes()
     {

chart/mai/Note.cs

@@ -5,6 +5,9 @@
 
 namespace MuConvert.mai;
 
+/**
+ * maimai的Note基类
+ */
 public abstract class Note: BaseNote
 {
     public readonly MaiChart Chart;