谱面格式：修订间差异

<!--如果你通过查看源代码发现了这里，那么恭喜你发现了查看内容的第二种方法。-->

{{技术型}}

{{Usercheck}}

<!-- 部分 需下载的谱面集合缓存：https://arc.estertion.win/dl/-->

<!--Visual Studio Code aff插件下载地址：https://marketplace.visualstudio.com/items?itemName=yojohanshinwataikei.vscode-arcaea-file-format-->

 谱面的后缀名为aff，所有在安装包中的官方谱面（即[[Arcaea]]曲包中 无需世界解锁 的曲目的PST/PRS/FTR/ETR 难度和愚人节版本中的愚人节谱面）没有加密，可以直接阅读

 谱面所在位置为(Android apk)/assets/songs/<曲目id> 或 (iOS ipa)/Payload/Arc-mobile.app/songs/<曲目id>里，其中0，1，2，3 ，4 分别对应PST，PRS，FTR，BYD ，ETR 。<s>其他的是什么东西自己打开便知道了</s>

*'''t'''(ms)：Timing起始位置，数字为 非负 整数

*'''bpm'''(拍/分钟)：节奏速度，数字为小数

*'''beats'''(四分音个数(拍))：表示每多少个四分音符(拍)为一小节（出现一条小节线），数字为 小数，当bpm不为0时 不可 为0（为0代表每0个四分音符为1 小 节 ， 会出现除零错误使游戏崩溃）。 比如4.00就是4/4拍，代表四拍一小节

**'''需要注意的是每个谱面一定要有一个t=0的Timing ，并 且其bpm 数值要大于等于0，beats 数值不为负数 ，才可被正常读取。'''

*'''t'''(ms):地面Note所在时间，数字为 非负 整数

*'''t1,t2'''(ms):地面Hold物件开始/结束的时间，数字为 非负 整数，'''t1＜t2'''

*'''lane'''(0～5/float): 物件所在轨道，一般情况下轨道的编号从左到右依次为1，2，3，4，绝大部分情况下也只需要用到1~4轨道 ；当该值为float时候，则使用坐标作为该note的位置，float轨道坐标与arc坐标的映射公式为 '''-0.5 + lane * 2'''，请注意：如果要使用float轨道note最好是将它作为演出note使用，而不是当正常note使用，因为它的判定不同于正常轨道note的判定

**4.0.0版本起新增 “enwidenlanes ”的scenecontrol类型（见[[#Scenecontrol| 下 文]] ），在标记为启用后，轨道由4条扩充至6条，在1轨左侧新增0轨，在4轨右侧新增5轨；在不在谱面文件内标记开启 “enwidenlanes ”的情况下，游戏依然会正常摆放相应物件<s>（但是你打不到）</s>

===Arc & 天 空音符 （Arctap）===

  arc(t1,t2,x1,x2,easing,y1,y2,color,hitsound,arctype);

*'''t1,t2'''(ms)：Arc物件开始/结束的时间，数字为 非负 整数，'''t1可以等于t2'''，当t1=t2时，Arc与判定线平行，物量为0，且此种类型的Arc可以起到连接Arc组的作用（即宏观上算作不分立的Arc，不能换手）

*'''x1,x2'''：代表Arc物件开始/结束时的横坐标，'''数字为小数'''

*'''easing'''(b,s,si,so)：Arc滑动方式。b =Bezier ，s=Straight ，si=Sine Out ，so=Sine In 。'''当t1=t2时该参数无意义（都是直的）'''

*'''y1,y2'''：代表Arc物件开始/结束时的纵坐标，'''数字为小数'''

*'''color'''：Arc颜色，0蓝，1红，2绿<ref> 只有愚人节版本（v2.0.2、v2.6.1、v3.5.3、v3.12.6 、v4.4.2、v5.5.6、v5.5.8 ）可以正常读取绿Arc，其他版本不能正常读取绿Arc</ref>，3灰，0~3以外均为黑色，'''在arctype=true时该参数无意义，且能被游戏正常读取'''

*'''hitsound'''：v4.0.0实装 ， 给予Arctap特殊打击音效，'''对整条黑线上所有的Arctap生效，'''将它们替换为特殊样式，并应用特殊打击音效。举例：填写glass_wav时，将把 songs/(songid)/glass.wav 作为打击音效，填写“none”代表不应用特殊音效，无arctap 或arcType=false时，该参数无意义（但是不能乱填，起码不能让游戏崩溃），等价于填写“none”

*'''arctype'''(false,true,designant)： 当填写false/true时， 判 断该Arc 是 否为音轨 （黑线）。false为 音弧（ 普通Arc ） ，true为 音轨 ，但是只要有Arctap 且该值不为designant时 会将此Arc的类型强制转换为 音轨；填写designant时，该Arc表现为红偏粉 的 音轨，且该Arc上的ArcTap也会被染色。'''请注意，designant类型的Arc上的ArcTap不会被记入总Combo数，击打时也不会计入Combo和HP，且只会在[[Designant.]]/[[Lament Rain]]异象时生效。'''<ref>使用6.0以下版本时当该Arc类型为designant时会当成false处理</ref>

** 当arctype=true，并且该Arc上有天 空音符 （Arctap）时，代码如下

*'''tn1,tn2,……,tnm'''(ms)：m个天空物件在这条判定线上的时间点，数字为 非负 整数，且不能超出t1和t2的区间

 

 

===Camera<ref>本功能在v1.7.0在代码中被标记关闭，v1.8.0中相关代码被彻底删除，但在之后的愚人节版本（v2.0.2、v2.6.1、v3.5.3、v3.12.6）中被恢复，且v4.0.0版本后不再被删除</ref>===

*'''t''' (ms): 开始时间

*'''yozAng''' (deg°): yoz平面角度，抬头-正  低头-负

*'''ease''' (string): qi, qo, reset (qi=Cubic in，qo=Cubic out，reset=重置Camera状态，非上述三个值均为Linear)

*'''duration''' (ms): 语句持续时间

当ease不为reset 时 将关闭Arc对Camera 的 倾斜控制。

'' 请注意，xyz轴移动的坐标并非与Arc位置坐标相同 (为世界坐 标) 。Arc x坐标1.00对应850的移动距离；y坐标1.00对应450 的 移动距离。''

*'''param'''：参数，“*”代表可选，但是两个参数 必须 同时出现/不出现

:**当前版本使用trackhide/trackshow时等效于 ''scenecontrol(t,trackdisplay,1.00,0/255);''

 

:**param1：轨道从当前alpha变换到目标alpha(param2)所要花费的时间，数字为小数，单位为秒，填0.00等价于填1.00

:**param2：轨道需要变换到的目标alpha值，可以填非负整数；<255时有黑色背景特效，否则没有；=0为轨道完全透明，=255为轨道不透明，>=256时 透明度溢出（可看作 透明度对256取余数计算 ） 。

 

:*redline（v3.0.0新增） ： 背景红线效果 （见Arcahv和Désive）

:**param1：红线存在的时间，数字为小数，单位为秒

:**param2：未 使用

:**使用例： ''scenecontrol(40960,redline,1.88,0);''

:**param1：从当前alpha变换为指定alpha的持续时间，数字为小数，单位为秒

:**使用例：''scenecontrol(1000,arcahvdebris,1.00,128);''

:**param1：未 使用

:***enwidencamera的相机移动效果实际相当于camera(t,0,450,450,0,0,0,s,duration);语句，但enwidencamera会同时将Sky Input线移动 至Arc坐标下y=1.61处 ，同时也不会关闭接Arc时的相机抖动 。

*anglex/angley（v3.12.6新增）<ref>此机制在2023年愚人节版本4.4.2过后不久删除了部分代码，导致无法正常读取，在5.0.0版本中彻底从代码中消失，直至2024年愚人节版本5.5.6又被重新添加回来</ref> ：

===Flick<ref>Flick从3.5.3版本起被删除了部分代码，因此Flick不能在3.5.3版本之后正常读取</ref>===

*'''x,y''':Flick初始位置的横、纵坐标，'''数字为小数'''

*'''vx,vy''':Flick滑动方向向量的横向、纵向值，'''数字为小数'''，实际滑动方位角为正右方基础上逆时针arctan(vy/vx)

*通常（无Camera）情况下，实体Arc的起始点和结束点、Arctap的坐标不应超出(-0.50,0.00)，(1.50,0.00)，(0.00,1.00)，(1.00,1.00)四个点组成的梯形（Beyond难度中后两个点改为(-0.25,1.00)，(1.25,1.00) ）

**存在enwidencamera的情况下，实体Arc的起始点和结束点、Arctap的坐标不应超出(-1.00,0.00)，(2.00,0.00)，(-0.25,1.61)，(1.25,1.61)四个点组成的梯形（Beyond难度中后两个点改为(-0.63,1.61)，(1.63,1.61)）

** 超出Beyond难度梯形范围可能会导致部分Arc或Arctap位于屏幕外

** 但其搭载的Arctap仍需位 于 坐标界限内

*[[Tempestissimo]] 的BYD谱面中间的四押的部分Arc的y坐标达到了1.01，以此达成了整条音弧在上下剧烈颤动以及高架桥的视觉效果