譜面格式

在您查看以下內容之前，我們需要您回答我們提供的問題。
ABA型的三字符songid是？

已確認。

技術型隱藏頁面索引

譜面格式 · 曲包信息格式 · 解鎖條件格式 · 歌曲信息格式 · 劇情格式

警告，這裏只是譜面格式的介紹帖，自製譜一切後果自負！

由於lowiro明確講過禁止傳播官方以外的版本，所以本頁面將保持孤立狀態，嚴禁鏈入/引用!

由259WA777撰寫的譜面解析

以下是在上述解析的基礎上編寫的。

總論

譜面的後綴名為aff，所有官方譜面在apk安裝包中並沒有加密，可以直接閱讀。

譜面所在位置為\assets\songs\(歌曲文件名)里，其中0,1,2,3分別對應PST,PRS,FTR及BYD。~~其他的是什麼東西自己打開便知道了~~

理論上更改aff文件以及對應音源後重新正確封包即可遊玩。

解析

文件頭

所有譜面開始都為以下兩行代碼

AudioOffset:x
-

這行代碼表示音樂整體往前(-)/往後(+)移動x毫秒
推薦x=0，這樣你物件對應的毫秒數即為歌曲對應的音的毫秒數。
但是如果x≠0，你的物件對應毫秒數應為(音對應的毫秒數+x)
鑑於有些音源以開頭為基準第一個采音不在整拍上，可能有時候你真的需要x≠0。~~懶得算了~~

有的譜面會在AudioOffset行下方加入一行TimingPointDensityFactor：

TimingPointDensityFactor:x

這行代碼表示音弧和長條的物量密度調整為正常值的x倍
x=1時效果與省略此行相同
~~如果x的值特別大的話...~~

在該文件里並沒有曲名，譜師之類的歌曲信息，請移步歌曲信息(songlist)格式

如果想更改關於解歌條件的部分，請移步解鎖條件(unlocks)格式

如果想更改曲包相關內容請移步曲包信息(packlist)格式

Timing

Timing代碼如下

timing(Offset,BPM,Beats);

Offset(ms):Timing起始位置，數字為整數
BPM(拍/分鐘):節奏速度，數字為不可省略小數點後兩位的一個數
Beats(四分音個數(拍)):表示每多少個四分音符(拍)為一小節（出現一條小節線），數字為不可省略小數點後兩位的一個數，比如4.00就是4/4拍，四拍一小節
- 需要注意的是一定有一個Offset=0的Timing！

地面Note & 地面Hold

地面Note & 地面Hold代碼如下

(t,lane);
hold(t1,t2,lane);

t(ms):地面Note所在時間，數字為整數
t1,t2(ms):地面Hold物件開始/結束的時間，數字為整數，t1＜t2
lane(1～4):物件所在軌道，從左到右分別為1,2,3,4

虹弧Arc & 天空Note

虹弧Arc & 天空Note代碼如下

arc(t1,t2,x1,x2,slideeasing,y1,y2,color,FX,skylineBoolean);

t1,t2(ms):虹弧Arc物件開始/結束的時間，數字為整數，t1可以等於t2，當t1=t2時，虹弧與判定線平行，物量為0。
x1,x2(-0.50～1.50):代表Arc物件開始/結束時的橫坐標，數字為不可省略小數點後兩位的一個數
slideasing(b,s,si,so):虹弧滑動方式。b=Both=Sine in & out，s=straight，si=Sine in，so=Sine out。當t1=t2時該參數無意義，都是直的
- si與so可以兩個在一起自由組合(如siso,sisi等)，siso代表x方向上滑動方式為si、y方向上滑動方式為so
y1,y2(0.00～1.00):代表Arc物件開始/結束時的縱坐標，數字為不可省略小數點後兩位的一個數
color:虹弧顏色，0藍，1紅，2綠，在skylineBoolean=true時該參數無意義
FX(none,full,incremental):目前尚未發掘出該參數的用途，已知本參數可以填none，full，incremental，可實際上填寫時並沒有區別 ~~lowiro模仿SDVX的證明(~~
skylineBoolean(false,true):判定這一段虹弧是不是天空Note的判定線。false為普通虹弧，true為天空Note的判定線。~~但是只要有Arctap本參數就無意義，都為黑線~~
- 當skylineBoolean=true，並且該判定線上有天空Note時，代碼如下

arc(t1,t2,x1,x2,slidemethod,y1,y2,color,FX,true)[arctap(tn1),arctap(tn2),……,arctap(tnm)];

tn1,tn2,……,tnm(ms):m個天空物件在這條判定線上的時間點，數字為整數，且不能超出t1和t2的區間

綜合

代碼排列順序除了第一個offset=0的Timing外不受限制。

還是一句老話，編完請自己high你不要大規模傳播!!!

1.6.1新特性

arc語句中，x1 x2 y1 y2參數可以超出限制
新增camera語句
- 位置在第一個Timing語句下方，不混雜在真正note語句里，按時間順序排列，用一個空行與真正note語句分開

camera(t,transverse,bottomzoom,linezoom,steadyangle,topzoom,angle,easing,lastingtime);

t(ms):camera開始時間
transverse:軌道底部左右橫向移動,正←負→.
bottomzoom:軌道底部上下移動,正↓負↑
linezoom:判定線前後移動,正遠離負靠近
steadyangle(°):原地的攝像頭視角轉向,正逆時針負順時針
topzoom:軌道頂部的上下移動,正↓負↑
angle(°):底盤依照屏幕中心旋轉,正逆時針負順時針
easing(qi,qo,l,reset,s):cubicin,cubicout,line,reset,sinein&out
lastingtime(ms):本語句持續時間

本功能在1.7.0在代碼中被標記關閉，1.8.0中相關代碼被徹底刪除，但在之後的愚人節版本中被恢復

2.0.2新特性

camera回來了,添加s轉換屬性
添加綠arc，color值為2，並且只有愚人節版本才能讀取綠arc

2.6.1新特性

camera和綠arc回來了
新增scenecontrol語句

scenecontrol(t,type);

t(ms):場景開始時間
type(trackhide,trackshow):是否展示軌道

3.0.0新特性

新增timinggroup語句塊

timinggroup(){
 //xxx
};

每一個timinggroup語句塊中的語句使用其內部單獨的timing語句，因此可以實現同時刻不同note流速。
timinggroup語句塊中的timing語句不會產生小節線。
一張譜面理論可以存在無限多個timinggroup語句塊。

scenecontrol語句修改參數

scenecontrol(t,type,x,y);

t(ms): 場景開始時間
type:

trackdisplay: 展示軌道
redline: Arcahv解鎖表演時的背景紅線效果
arcahvdistort: Arcahv解鎖表演時的背景變形效果
arcahvdebris: Arcahv解鎖表演時的背景碎片效果

x(float): 未知參數
y(int): 未知參數

物量估算

有的時候我們並不能玩到自製譜面，這個時候我們可以通過以下方式估算本譜物量：

統計所有地面note和arctap數量，每統計一個+1
Hold物件逐個計算，每個hold被起始位置所在BPM的osu 1/4拍(也就是SDVX的1/16小節)分成一個一個判定塊，每個判定塊開始處物量+1。
- 特殊的，每個Hold最後一個判定塊不加物量
- BPM＞255時，判定塊間隔變為所在BPM的osu 1/2拍(也就是SDVX的1/8小節)
- BPM=0時，本物件不存在，更無從談及物量
- BPM＜0時，按BPM的絕對值進行計算
- 當Hold長度短於本來的判定塊長度時，整個物件對半分為兩個判定塊(無論如何最後一個判定塊不計入物量)
- 當Hold跨越timing時，按Hold起始點的BPM進行計算
Arc物件與Hold相同，注意每個arc語句單算
- 持續時長為0的arc物量為0
- skylineBoolean為true時物量為0

需要指出，Hold和Arc可能會出現誤差，原因在於末尾處可能剛好超過計數點零點幾毫秒，不過即使如此正常情況下誤差總計也不會超過100。