资源文件说明
由于模拟器本身不提供资源文件,因此需要用户自行上传谱面、音乐、图片等资源文件。
结构
你可以单独上传谱面、音乐、图片等资源文件,也可以将它们打包为 zip 文件后上传。
特别地,如果浏览器支持,你还可以直接上传包含它们的文件夹。
谱面文件:必需,通常为官谱 JSON 格式,也可以是支持的非官谱格式谱面。
背景音乐:可选,与谱面同时播放的音乐。
- 也支持视频文件的音乐播放,如果浏览器支持还可以将背景图片替换为视频。
- 未上传音乐播放谱面时,不会播放音乐,时长显示为谱面时长[1]。
- 背景图片:可选,通常为曲绘封面,谱面播放时置于背景。
- 未上传图片播放谱面时,背景显示为纯白。
- 背景缩放采用“center+cover”的策略[2]。
gif
等动态图片将取第一帧以静态图显示。
info.csv:可选,用于自动填写谱面信息,详见下文。
line.csv:可选,用于替换指定判定线贴图,详见下文。
支持的文件格式仅供参考,以浏览器实际支持为准。
info.csv
置于 zip 文件根目录,用于自动填写谱面信息。参考:csv 标准文档
格式示例:
csv
,Chart,Music,Image,Name,Artist,Level,Illustrator,Charter,AspectRatio,NoteScale,GlobalAlpha
,谱面,音乐,图片,名称,曲师,等级,曲绘,谱师,宽高比,按键缩放,背景变暗
,SpasmodicSP.json,SpasmodicSP.ogg,SpasmodicSP.png,Spasmodic(Haocore Mix),姜米條 Remixed by Daily,SP Lv.?,笔记RE,"Phigros Spasming Team ""無極病院""",1.777778,1,0.6
,Theme Of SSS.pec,Theme Of SSS.mp3,Theme Of SSS.jpg,Theme Of SSS,ANANT-GARDE EYES,AB Lv.12,《Angel Beats!》,Tachibana InterJoke,1.461538,0.9,0.8
属性 | 说明 |
---|---|
Chart | 谱面(zip 文件内完整路径) |
Music | 音乐(zip 文件内完整路径) |
Image | 图片(zip 文件内完整路径) |
Name | 名称(显示在画面左下角) |
Artist | 曲师(显示于过渡动画) |
Level | 等级(显示在画面右下角) |
Illustrator | 曲绘(显示于过渡动画) |
Charter | 谱师(显示于过渡动画) |
AspectRatio | 宽高比(画面宽度与高度的比值,默认 1.777778,即 16:9) |
NoteScale | 按键缩放(数值越大 Note 越大,默认 1) |
BackgroundDim | 背景变暗(背景不透明度,数值越大背景越暗,默认 0.6) |
line.csv
置于 zip 文件根目录,用于替换指定判定线贴图。参考:csv 标准文档
格式示例:
csv
,Chart,LineId,Image,Scale,Aspect,UseBackgroundDim,UseLineColor,UseLineScale
,谱面,判定线id,图片,缩放,拉伸,跟随背景变暗,跟随FC/AP指示器着色,使用判定线缩放策略
,SpasmodicSP.json,20,.0.png,1,1,0,0,1
,SpasmodicSP.json,21,.1.png,1,1,0,1,1
,SpasmodicSP.json,22,.2.png,4,1,1,1,0
,SpasmodicSP.json,23,.3.png,4,1,1,1,0
属性 | 说明 |
---|---|
Chart | 谱面(zip 文件内完整路径) |
LineId | 判定线 id(即判定线数组下标,从 0 开始) |
Image | 图片(zip 文件内完整路径) |
Scale | 缩放(将图片以画面单位高度(画面高度/1080)整体缩放,默认 1) |
Aspect | 拉伸(将图片水平拉伸至原来的若干倍,默认 1) |
UseBackgroundDim | 跟随背景变暗(1:是;0:否,即图片亮度不受背景变暗的影响;默认 0) |
UseLineColor | 跟随 FC/AP 指示器着色(1:是;0:否,即图片亮度不受 FC/AP 的影响;默认 0) |
UseLineScale | 使用判定线缩放策略(1:是,即宽高比小于 3:4 时缩放受画面宽度影响;0:否;默认 1) |
隐藏文件
以.
开头的文件和文件夹将被隐藏,不会显示在选项框,通常用于存放配置文件所需的资源。
例:上传的.line.png
文件将不会显示在图片
选项框中,但可以在line.csv
中使用。
非官谱格式的谱面及其配置文件
Working in progress...