Linglun-Converter/docs/功能使用说明.md

伶伦转换器

使用教程

下载与启动教程

视窗(Windows)操作系统

里纽克斯(Linux)与其衍生操作系统

安卓(Android)与其衍生操作系统

使用教程

1. 参数说明

• midi路径：含有mid文件路径、文件名、后缀的完整文件路径，或者一个目录（magicDemo可接受批量转换）。可以使用相对或绝对路径皆可

• 输出路径：输出文件夹的路径，不需要指示文件名

• 转换算法：通过不同通道隔离音轨，识别最佳乐器的算法编号为3（金羿的算法）；将所有的音轨合并，通过通道来分组的算法编号为2（神羽和金羿的算法）；旧算法，即通过音轨分组的算法编号为1（Dislink的算法）。新算法在某些方面转换效果更好，但是如果新算法转换有误的话，请使用旧算法。

• 输出格式：目前的演示程序仅支持BDX结构和MCPACK包

• 播放方式：目前的转换库仅支持计分板和延迟的两种播放方式，具体地关于这些播放方式如何使用的问题，详见生成文件的使用说明

• 音量：小数数据，在0~1（包含首尾）的范围之内，用以表示播放音量大小。

• 速度倍率：小数数据，其值不可为0，用以表示游戏中播放此音乐的速度倍数。

• 进度条：是否启用进度条。目前的转换库已经支持自定义进度条，但是当前的演示程序并不能做到这一点。具体的有关进度条自定义的内容，可以看功能文档中的相关部分自行修改参数。

• 计分板名称（仅计分板播放器）：游戏内的计分板名称

• 是否重置计分板（仅计分板播放器）：歌曲放完是否重置，推荐选择自动重置

• 玩家选择器（仅延迟播放器）：包括 @x 在内的全部选择器。例：若要选择全部标签为Holo的玩家，则需要如此输入：@a[tag=Holo]

• 作者（仅BDX结构）：音乐结构的生成作者

• 指令结构最大高度（仅结构输出）：生成音乐结构的最大堆叠高度，可以查看相关结构部分的开发文档了解详细知识。

• 没有报错且在输出路径下找到对应的文件即为生成成功：