查看“︁aff谱面格式”︁的源代码

如果想了解曲名、谱师之类的歌曲信息，请移步[[songlist]]

如果想了解关于解歌条件的部分，请移步[[unlocks]]

如果想了解曲包相关内容请移步[[packlist]]

[https://tieba.baidu.com/p/5015977438 由259WA777撰写的谱面解析]

以下是在上述解析的基础上编写的。

== 总论 ==

谱面的后缀名为aff，所有官方谱面在apk安装包中并没有加密，可以直接阅读.

谱面所在位置为\assets\songs\(歌曲文件名)里，其中0、1、2、3分别对应PST、PRS、FTR及BYD。<s>其他的是什么东西自己打开便知道了</s>

理论上更改aff文件以及对应音源后重新正确封包即可游玩。<s>但鉴于lowiro原因这里不会表述关于封包的内容。</s>

== 解析 ==

=== 文件头 ===

绝大多数谱面的开头都为以下两行代码
 AudioOffset:x
 - 

*'''<font color=#FF6600>Audio Offset(int)</font>''' 表示谱面整体往判定线后(-)/往判定线前(+)移动x毫秒
**'''当x=0时，物件对应的毫秒数即为歌曲对应的音的毫秒数。'''
**'''如果x≠0，物件对应毫秒数应为 <u><font color=#800000>音频对应的毫秒数+x</font></u>'''

有的谱面会于 '''<font color=#FF6600>Audio Offset</font>''' 下增加一行 '''<font color=#FF6600>Timing Point Density Factor</font>''' 参数，格式为
 AudioOffset:x
 TimingPointDensityFactor:y
 - 

*'''<font color=#FF6600>Timing Point Density Factor(float)</font>''' 长押判定点密度，参数y定义判定点密度为通常状态下的y倍
**'''<font color=#FF0000>y值过大会导致物量极高，且低帧率设备可能会因此而无法对长押物件正常进行判定</font>'''

=== Timing ===

Timing 代码如下
 timing(Offset,BPM,Beats);

*'''<font color=#FF6600>Offset(ms)</font>''': Timing起始位置，参数为整数型
*'''<font color=#FF6600>BPM(拍/分钟)</font>''': '''<font color=#FF0000>B</font>eats <font color=#FF0000>P</font>er <font color=#FF0000>M</font>inute'''，每分钟节拍数。精度必须达到小数点后两位
*'''<font color=#FF6600>Beats(每小节的拍数)</font>''': '''定义一小节包含多少个四分音符(拍)，影响底谱小节线显示长度。'''精度必须达到小数点后两位，比如4.00就是4/4拍，四拍一小节
*'''<font color=#FF0000>必须有一个Offset=0的Timing</font>'''

=== 地面Note & 地面Hold ===

地面Note & 地面Hold代码如下
 (t,lane);
 hold(t1,t2,lane);

*'''<font color=#FF6600>t(ms)</font>''': 地面Note所在时间，参数为整数型
*'''<font color=#FF6600>t1,t2(ms)</font>''': 地面Hold物件开始/结束的时间，参数为整数型，'''t1＜t2'''
**'''<font color=#FF0000>t1≥t2会导致ghost hold的产生，这样的hold占据1物量但无法被击打判定，会强制lost</font>'''
*'''<font color=#FF6600>lane(1～4)</font>''': 物件所在轨道，从左到右分别为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时，虹弧表示为横向直线
*x1,x2(两位小数精度): 代表Arc物件开始/结束时的横坐标
*slideasing(b,s,si,so): 虹弧滑动方式。b=Both=Sine in & out，s=straight，si=Sine in，so=Sine out。'''当t1=t2时该参数无意义，<s>都是直的</s>'''
**si与so可以两个在一起自由组合(如siso，sisi等)，为不同方向上的变换效果
*y1,y2(两位小数精度): 代表Arc物件开始/结束时的纵坐标
*color: 虹弧颜色，0=蓝，1=红，2=绿
**'''在 <font color=#FF6600>skylineBoolean=true</font> 时该参数无意义'''
*FX(none,full,incremental): 目前尚未发掘出该参数的用途，已知本参数可以填none、full、incremental，可实际上填写时并没有区别
**<s>lowiro模仿SDVX的证明(</s>
*skylineBoolean(false,true): 判定这一段虹弧是不是天空Note的引导线。false不是，为普通虹弧；true是，为天空Note的引导线。
**但是只要arc物件上挂载有arctap，本参数就无意义，该arc会强制变更为黑线</s>
**当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≤tn1＜tn2＜……＜tnm≤t2'''
*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): 本语句持续时间

=== Timing Group ===

 timinggroup(){
  //常规aff语句
 };

*每一个timinggroup语句块中的语句使用其内部单独的timing语句'''（并需要含有一个Offset为0的timing）'''，因此可以实现同时刻不同note流速。
*timinggroup语句块中的timing语句不会产生小节线。
*一张谱面理论可以存在无限多个timinggroup语句块。


如果需要用假note达成一些演出效果，可以在括号中添加noinput参数：

 timinggroup(noinput){
  //常规aff语句
 };

*此时本timinggroup内的物件只有显示效果，没有判定和物量

=== scenecontrol ===

 scenecontrol(t,type,x,y);

*t(ms): 场景开始时间
*type:
**trackhide: 隐藏轨道
**trackshow: 展示轨道
**redline: Arcahv解锁表演时的背景红线效果
**arcahvdistort: Arcahv解锁表演时的背景变形效果
**arcahvdebris: Arcahv解锁表演时的背景碎片效果
*x(float): 语句效果经过/持续时间（单位：秒）
*y(int): 不透明度（0为不显示，255为全显示）
**当type指定为redline时y参数无效（但是参数依然存在）。

=== Flick ===

代码如下：

 flick(t,x,y,vx,vy);

*'''t'''(ms): Flick所在时间
*'''x,y''': Flick初始位置的横、纵坐标，'''数字为不可省略小数点后两位的一个数'''
*'''vx,vy''': Flick滑动方向向量的横向、纵向值，'''数字为不可省略小数点后两位的一个数'''，实际滑动方位角为正右方基础上逆时针arctan(vy/vx)
*'''官方谱面目前还没有实装过Flick，请谨慎使用Flick'''

== 物量估算 ==
'''2019/1/7 已修正'''

有的时候我们并不能玩到自制谱面，这个时候我们可以通过以下方式估算本谱物量：

*统计所有地面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时，'''本物件不存在'''，更无从谈及物量
**当Hold长度短于本来的判定块长度时，整个物件对半分为两个判定块('''无论如何最后一个判定块不计入物量''')
*Arc物件与Hold相同，'''注意每个蛇单算'''
**直角Arc不+1


''需要指出,Hold和Arc可能会出现误差,原因在于末尾处可能刚好超过计数点零点几毫秒,不过即使如此误差总计也不会超过100.''