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

<h1 align="center">伶伦转换器</h1>

# 使用教程

## 下载与启动教程

### [视窗(Windows)操作系统](./download%26start/Windows.md)
### [林纳克斯(Linux)与其衍生操作系统](./download%26start/Linux.md)
### [安卓(Android)与其衍生操作系统](./download%26start/Android.md)

## 命令行版本的使用教程

> 注意，图形用户界面版本无需查看此内容。

1.	参数说明

<img src=https://foruda.gitee.com/images/1695492228675012042/2136cbe4_9911226.png>

-	MIDI地址：含有mid文件路径、文件名、后缀的完整文件路径，或者一个目录（可接受批量转换）。相对或绝对路径皆可

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

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

-	输出文件类型：支持 `BDX` 结构和 `MCPACK` 包，其中，以 `BDX` 结构输出支持延迟和积分两种播放器， `MCPACK` 附加包则比前者多了一种 中继器播放器。

-	播放器类型：`BDX` 结构仅支持**计分板**和**延迟**的两种播放方式；`MCPACK`则支持**计分板**、**延迟**和**中继器**三种播放方式。具体地关于这些播放方式如何使用的问题，详见[生成文件的使用说明](https://gitee.com/TriM-Organization/Musicreater/blob/master/docs/%E7%94%9F%E6%88%90%E6%96%87%E4%BB%B6%E7%9A%84%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md)

-	音量大小：正小数，在0（不含）~1（包含）的范围之内，用以表示播放音量大小。

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

-	启用进度条：是否启用自动生成进度条。

    - 若是，则可选是否自定义进度条
    
        自定义的进度条样式，可以参考[功能文档](https://gitee.com/TriM-Organization/Musicreater/blob/master/docs/%E5%BA%93%E7%9A%84%E7%94%9F%E6%88%90%E4%B8%8E%E5%8A%9F%E8%83%BD%E6%96%87%E6%A1%A3.md#%E8%BF%9B%E5%BA%A6%E6%9D%A1%E8%87%AA%E5%AE%9A%E4%B9%89)

-	计分板名称（仅计分板播放器）：游戏内的用以延迟的计分板名称

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

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

-   作者（仅BDX结构）：结构的生成作者署名

-   指令结构最大高度（`MCPACK`的计分板播放器不含此项）：生成音乐结构的最大堆叠高度。对于如何堆叠的问题，可以查看[结构部分的开发文档](https://gitee.com/TriM-Organization/Musicreater/blob/master/docs/%E5%BA%93%E7%9A%84%E7%94%9F%E6%88%90%E4%B8%8E%E5%8A%9F%E8%83%BD%E6%96%87%E6%A1%A3.md#%E6%96%87%E4%BB%B6%E6%A0%BC%E5%BC%8F)了解详细内容。

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

<img src=https://foruda.gitee.com/images/1659973655881460036/输出.png>