文档更新,代码更新

This commit is contained in:
2023-09-24 02:14:04 +08:00
parent 7c078be0cf
commit 732dd0453d
8 changed files with 218 additions and 235 deletions

View File

@ -5,40 +5,44 @@
## 下载与启动教程
### [视窗(Windows)操作系统](./download%26start/Windows.md)
### [里纽克斯(Linux)与其衍生操作系统](./download%26start/Linux.md)
### [林纳克斯(Linux)与其衍生操作系统](./download%26start/Linux.md)
### [安卓(Android)与其衍生操作系统](./download%26start/Android.md)
## 使用教程
1. 参数说明
<img src=https://foruda.gitee.com/images/1674146209644269990/26b53aa7_9911226.png>
<img src=https://foruda.gitee.com/images/1695492228675012042/2136cbe4_9911226.png>
- midi路径含有mid文件路径、文件名、后缀的完整文件路径或者一个目录magicDemo可接受批量转换)。可以使用相对或绝对路径皆可
- MIDI地址含有mid文件路径、文件名、后缀的完整文件路径或者一个目录可接受批量转换。相对或绝对路径皆可
- 输出路径:输出文件夹的路径,不需要指示文件名
- 输出地址:输出文件夹的路径,不需要指示文件名
- 转换算法通过不同通道隔离音轨识别最佳乐器的算法编号为3金羿的算法将所有的音轨合并通过通道来分组的算法编号为2神羽和金羿的算法旧算法即通过音轨分组的算法编号为1Dislink的算法。新算法在某些方面转换效果更好但是如果新算法转换有误的话请使用旧算法。
- 转换算法**已废弃**通过不同通道隔离音轨识别最佳乐器的算法编号为3金羿的算法将所有的音轨合并通过通道来分组的算法编号为2神羽和金羿的算法旧算法即通过音轨分组的算法编号为1Dislink的算法。新算法在某些方面转换效果更好但是如果新算法转换有误的话请使用旧算法。
- 输出格式:目前的演示程序仅支持`BDX`结构和`MCPACK`
- 输出文件类型:支持 `BDX` 结构和 `MCPACK` 包,其中,以 `BDX` 结构输出支持延迟和积分两种播放器, `MCPACK` 附加包则比前者多了一种 中继器播放器。
- 播放方式:目前的转换库仅支持**计分板**和**延迟**的两种播放方式,具体地关于这些播放方式如何使用的问题,详见[生成文件的使用说明](./%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)
- 播放器类型:`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不含~1包含的范围之内用以表示播放音量大小。
- 速度倍率:小数数据其值不可为0用以表示游戏中播放此音乐的速度倍数。
- 速度倍率:小数其值不可为0用以表示游戏中播放此音乐的速度倍数。
- 进度条:是否启用进度条。目前的转换库已经支持自定义进度条,但是当前的演示程序并不能做到这一点。具体的有关进度条自定义的内容,可以看[功能文档](./%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)中的相关部分自行修改参数
- 进度条:是否启用自动生成进度条。
- 计分板名称(仅计分板播放器):游戏内的计分板名称
- 若是,则可选是否自定义进度条
自定义的进度条样式,可以参考[功能文档](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结构音乐结构的生成作者
- 作者仅BDX结构结构的生成作者署名
- 指令结构最大高度(仅结构输出):生成音乐结构的最大堆叠高度,可以查看相关[结构部分的开发文档](./%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#%E7%94%9F%E6%88%90%E6%96%87%E4%BB%B6%E7%BB%93%E6%9E%84##%E6%96%87%E4%BB%B6%E6%A0%BC%E5%BC%8F)了解详细知识
- 指令结构最大高度(`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)了解详细内容
- 没有报错且在输出路径下找到对应的文件即为生成成功: