Note,即音符,是谱面的主要构成之一,每个音符都应该含有以下参数:
| 字段 | 类型 | 描述 | 默认值 | 加入版本 |
| above | int | 1 为从线的正面下落,其他数字为从线的背面下落 | 1 | - |
| alpha | int | 音符不透明度,0为完全透明,255为完全不透明 | 255 | - |
| endTime | beat | 音符结束时间,若 type 为 2 ,此值为Hold的结束时间,否则与startTime一致 | - | - |
| startTime | beat | 音符开始时间,若 type 为 2 ,此值为Hold的开始时间,否则与endTime一致 | - | - |
| isFake | int | 音符真值,1为假,其他数为真 | 0 | - |
| positionX | float | 音符相对于判定线中心点的X坐标 | - | - |
| size | float | 音符大小倍率 | 1.0 | - |
| speed | float | 流速倍率 | 1.0 | - |
| type | int | 音符类型,详见对照表 | - | - |
| visibleTime | float | 音符可见时间,单位为秒 | 999999.0000 | - |
| yOffset | float | 音符的Y轴偏移,正数向上偏移,负数向下偏移,同时偏移打击特效的位置 | 0 | - |
| hitsound | string? | 音符自定义打击音文件相对于谱面文件根目录路径 | - | 142 |
| judgeArea | float | 判定区域宽度倍率 | 1.0 | 170 |
| tint或color | int[3] | 音符颜色,格式为[R, G, B],范围为0-255 | [255, 255, 255] | 170 |
| tintHitEffects | int[3]? | 音符打击特效颜色,格式为[R, G, B],范围为0-255 | [255, 255, 255] | 170 |
size 字段实际上在RPE中显示为宽度,即只能控制音符的宽度而不是音符的整个大小。
above 字段在为 1 时, 音符从判定线的正面下落,其他数值时从判定线的背面下落。
hitsound 字段在没有自定义音效时不存在。
- 假音符没有判定,没有打击特效与音效,不计分,不计物量,若为
Hold 则始终显示为未打击样式。
color 字段用于给音符染色,染色方式为顶点颜色乘法,即 noteColor = noteColor * color。
-
color字段修改过字段名称,由于color版本被公测,后续版本更换为tint,所以这两个字段可能都有被使用,定义不变,请注意兼容。
tintHitEffects 字段用于给音符的打击特效染色,当此字段出现时,无论判定是Good还是Perfect
,打击特效均使用此颜色(使用原始材质进行顶点颜色算法),不需要额外计算。
| 字段值 | 描述 |
| 1 | Tap |
| 2 | Hold |
| 3 | Flick |
| 4 | Drag |
| Default | Tap |