日常维护

pages/spritesheet.md

@@ -100,30 +100,37 @@
     显示这个缩略图的时候，画面正中心偏移多少像素。
 - **`"clips"`**  
     里面是对每个表情分别进行设置。
-- **`"name"`**  
-    后续出现的name指的是人物的各个表情，  
-    以下四个表情是默认存在的，因为和按拍效果有关，但你也可以在此基础上增加新的表情，自己命名一个其他表情，这会在紫色版块**播放表情**中有效。
-    - `neutral`表示普通表情，  
-    - `happy`表示拍子按对时的表情，  
-    - `barely`表示拍子按歪时的表情，  
-    - `missed`表示漏过没按时的表情。      
-- **`"frames"`**  
-    这是每种状态所涉及的帧数。在精灵图里从左往右，从0开始计算。例如：  
-    - `[0,1]`：第1张和第2张组合成两帧的动图；  
-    - `[3,5]`：第4张和第6张组合成两帧的动图；  
-    - `[0,1,1,1]`第1张和第2张组合成四帧的动图，其中第2张播放三次。  
-- **`"loop"`**  
-    动图的循环模式，如果是`no`那么播放完就会自动回到neutral状态，如果是`onbeat`就会一直循环。
-- **`"loopStart"`**  
-    如果设置为循环，首先按列表播放一次完整动画，接着再从列表内第loopstart+1项播放到结尾，并以此为循环。打比方做了一个5帧的骑车的动画`[助力，上车，坐下，蹬左脚，蹬右脚]`，loopstart：3，则实际效果为骑上车后循环骑车动作。
-- **`"fps"`**  
-    动图播放的帧数，填大于0的帧数，就是按填写的帧数播放；填0就自动随着音乐bpm改变。
-- **`"portaitOffset"`**  
-    截取动图中的一部分作为显示对话时的立绘，两个数字表示截取立绘的起始位置。以每一帧画面的左下角作为原点，第一个数字为横坐标，第二个数字为纵坐标。
-- **`"portaitSize"`**  
-    截取动图中的一部分作为显示对话时的立绘，两个数字表示截取立绘图片的像素大小。第一个数字为立绘的宽度，第二个数字为立绘的高度。
-- **`"portaitScale"`**  
-    图片放大比例，这是显示对话时的立绘用的，因为立绘画面一般都只是人物的头部和上身，且立绘窗口也比较大，这里最好填写大于1的数字。
+    - **`"name"`**  
+        后续出现的name指的是人物的各个表情，  
+        以下四个表情是默认存在的，因为和按拍效果有关，但你也可以在此基础上增加新的表情，自己命名一个其他表情，这会在紫色版块**播放表情**中有效。
+        - `neutral` 表示普通状态下的默认表情，  
+        - `happy` 是**击中**时的表情，  
+        - `barely` 是**失误**的表情，  
+        - `missed` 是**错失**的表情。  
+        > `neutral` 表情是**必需**的，无论是轨道角色还是精灵资源。  
+            在早期，以上四个表情在轨道角色上时也是必需的，不过在后来的版本中移除了其他三个表情的限制。
+    - **`"frames"`**  
+        这是每种状态所涉及的帧数。在精灵图里从左往右，从0开始计算。例如：  
+        - `[0,1]`：第1张和第2张组合成两帧的动图；  
+        - `[3,5]`：第4张和第6张组合成两帧的动图；  
+        - `[0,1,1,1]`第1张和第2张组合成四帧的动图，其中第2张播放三次。  
+    - **`"loop"`**  
+        动图的循环模式
+        - `no`：播放一次回到 neutral 状态。
+        - `yes`：按 `fps` 值循环。  
+        - `onbeat`：按节拍循环。  
+        > 当 loop 值不为 `onbeat` 且 `neutral` 表情无帧时会导致精灵缩放效果在播放至第三拍时停止（无论是从哪个小节开始）。这是一个已知 bug。
+    - **`"loopStart"`**  
+        在每轮循环帧播放完毕后回到 `frames` 中此值所指处的帧继续播放。
+        例：一个 5 帧的动画`[5,6,7,8,9]`，loopstart：3，实际效果为 `[5,6,7,8,9,8,9,8,9,8,9,...]`。
+    - **`"fps"`**  
+        播放帧率，填大于0的帧率，就是按填写的帧率播放；填0就自动随着音乐bpm改变。可以为小数。
+    - **`"portaitOffset"`**  
+        截取动图中的一部分作为显示对话时的立绘，两个数字表示截取立绘的起始位置。以每一帧画面的左下角作为原点，第一个数字为横坐标，第二个数字为纵坐标。
+    - **`"portaitSize"`**  
+        截取动图中的一部分作为显示对话时的立绘，两个数字表示截取立绘图片的像素大小。第一个数字为立绘的宽度，第二个数字为立绘的高度。
+    - **`"portaitScale"`**  
+        图片放大比例，这是显示对话时的立绘用的，因为立绘画面一般都只是人物的头部和上身，且立绘窗口也比较大，这里最好填写大于1的数字。
 
 ## 回到编辑器添加人物