mirror of
https://github.com/TriM-Organization/Linglun-Converter.git
synced 2025-09-06 20:56:28 +00:00
文档更新，代码更新
This commit is contained in:
@ -46,7 +46,7 @@
|
||||
那么请把看到的如左下图的界面变为右下图吧：
|
||||
|
||||
<table><tr>
|
||||
<td><img src="https://foruda.gitee.com/images/1665933104313107707/41108f03_9911226.jpeg"> </td>
|
||||
<td><img src="https://foruda.gitee.com/images/1665933104313107707/41108f03_9911226.jpeg"></td>
|
||||
<td><img src="https://foruda.gitee.com/images/1665933122534781330/3887a901_9911226.jpeg"></td>
|
||||
</tr></table>
|
||||
|
||||
|
||||
@ -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（神羽和金羿的算法）；旧算法，即通过音轨分组的算法编号为1（Dislink的算法）。新算法在某些方面转换效果更好，但是如果新算法转换有误的话，请使用旧算法。
|
||||
- 转换算法（**已废弃**）：通过不同通道隔离音轨，识别最佳乐器的算法编号为3（金羿的算法）；将所有的音轨合并，通过通道来分组的算法编号为2（神羽和金羿的算法）；旧算法，即通过音轨分组的算法编号为1（Dislink的算法）。新算法在某些方面转换效果更好，但是如果新算法转换有误的话，请使用旧算法。
|
||||
|
||||
- 输出格式：目前的演示程序仅支持`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)了解详细内容。
|
||||
|
||||
- 没有报错且在输出路径下找到对应的文件即为生成成功：
|
||||
|
||||
|
||||
@ -1,24 +1,24 @@
|
||||
<h1 align="center">伶伦转换器</h1>
|
||||
<h1 align="center">**伶伦转换器**</h1>
|
||||
|
||||
# 新手答疑指南
|
||||
|
||||
**考虑到某些用户电脑技术不是特别先进，且对这个项目充满了好奇心，但是又了解的不是很充分，为此，我特别在这里写一份新手指南，以满足各位的好奇心。放心，本文件全程中文。**
|
||||
|
||||
## 第一部分 关于音·创的作用
|
||||
## 第一部分 关于 **音·创** 的作用
|
||||
|
||||
### 1.1 音·创简介
|
||||
### 1.1 **音·创** 简介
|
||||
|
||||
音·创 Musicreater 是一款免费开源的针对 **《我的世界》** 的midi音乐转换库
|
||||
**音·创 _Musicreater_** 是一款免费开源的针对 **《我的世界》** 的midi音乐转换库
|
||||
|
||||
而能够与人交互，以达到转换功能的，是 音·创 的程序实现：伶伦转换器。
|
||||
而能够与人交互，以达到转换功能的，是 **音·创** 库的程序实现：**伶伦转换器**。
|
||||
|
||||
伶伦转换器 目前已经具备较为完善的[**教程**](./%E5%8A%9F%E8%83%BD%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md)，其中包括了下载安装一类，使你能够方便地进行转换。
|
||||
**伶伦转换器** 目前已经具备较为完善的[**教程**](./%E5%8A%9F%E8%83%BD%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md)，其中包括了下载安装一类，使你能够方便地进行转换。
|
||||
|
||||
伶伦转换器也是免费开源的，采用**带有特殊条款的Apache2.0**开源协议授权，详情请见[协议](../LICENSE.md)。
|
||||
**伶伦转换器**也是免费开源的，采用**带有特殊条款的Apache2.0**开源协议授权，详情请见[协议](../LICENSE.md)。
|
||||
|
||||
另外的，伶伦转换器并不是伶伦的主要开发方向，其功能也并非是伶伦本体（伶伦DAW）所提供的主要功能。**从音·创到伶伦的开发，其目的是为了方便《我的世界》的音乐作者，进行《我的世界》相关音乐的开发与创作**，而并不是转换MIDI文件！音·创的实现是在伶伦DAW之前试行一定的技术探索，以更好地开发数字音乐工作站。
|
||||
另外的，**伶伦转换器**并不是伶伦的主要开发方向，其功能也并非是 **伶伦** 本体（伶伦DAW）所提供的主要功能。**从 _音·创_ 到 _伶伦_ 的开发，其目的是为了方便 _《我的世界》_ 的音乐作者，进行 _《我的世界》_ 相关音乐的开发与创作**，而并不是转换MIDI文件！转换器的实现是在数字音频工作站的开发之前进行一定的技术探索，以更好地开发数字音乐工作站。
|
||||
|
||||
### 1.2 音·创库版本到底目前有什么功能？
|
||||
### 1.2 **音·创** 库到底有什么功能？
|
||||
* - [x] 支持导入`.mid`文件
|
||||
* - [x] 支持写入`.mcpack`文件
|
||||
* - [x] 支持写入`.bdx`文件
|
||||
@ -59,7 +59,7 @@
|
||||
|
||||
0. 最简单的方法是向你心仪的作编曲人投递一份申请，请求TA将其作编曲过程中的相关工程文件给你，这样，你就可以获得一首乐曲的电子曲谱，从而获得其MIDI文件。
|
||||
1. 如果无法向作曲人申请相关文件的话，成为一个作编曲人也许是一个不错的选择，当然，很多人做不到这一点，但是有必要提到这一点，当你在下面的渠道中都无法获得想要的文件时，你应该考虑是不是需要自己创作内容，或者，请别人帮你创作内容。
|
||||
2. 当你没有这样的文件时，问问别人或者从群里下载公开的文件也是个思路，不过这个办法通常使用次数有限且能找到的文件不多，不过，值得注意的是，**[音·创开发交流群](https://jq.qq.com/?_wv=1027&k=hpeRxrYr)的群文件中所含的MIDI文件均为网友分享学习交流使用，请在下载后一个小时内删除。**
|
||||
2. 当你没有这样的文件时，问问别人或者从群里下载公开的文件也是个思路，不过这个办法通常使用次数有限且能找到的文件不多，不过，值得注意的是，[**音·创**开发交流群](https://jq.qq.com/?_wv=1027&k=hpeRxrYr)的**群文件中所含的MIDI文件均为网友分享学习交流使用，请在下载后一个小时内删除。**
|
||||
3. 自己找MIDI：现在，我将给你提供一个完整的找mid的方法，请认真学习：
|
||||
|
||||
**1.** 首先你需要在[MidiShow](www.midishow.com)网站中注册一个账号，并不复杂，你可能只需要一个QQ号便可以授权登录。
|
||||
@ -125,7 +125,7 @@
|
||||
|
||||
如果你是使用桌面平台游玩基岩版，像我一样，是可以直接打开这个文件、并将这个包导入我的世界的。当然，移动平台也很简单，在游戏资源包界面有导入本地资源包的选项，便可将其导入。
|
||||
|
||||
资源包导入世界之后的使用方法，我们也制作了[**简单的教程**](./%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)，如果你对使用导入后的文件有所疑问，可以看看。
|
||||
资源包导入世界之后的使用方法，我们也制作了[**简单的教程**](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)，如果你对使用导入后的文件有所疑问，可以看看。
|
||||
|
||||
#### 2.4.2 .bdx是什么
|
||||
|
||||
|
||||
@ -1,40 +0,0 @@
|
||||
<h1 align="center">伶伦转换器</h1>
|
||||
|
||||
# 生成文件的使用
|
||||
|
||||
*这是本库所生成文件的使用声明，不是使用教程，点击[此处查看使用教程](%E5%8A%9F%E8%83%BD%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md)；若要查看有关文件结构的内容，可以点击[此处](./%E7%94%9F%E6%88%90%E6%96%87%E4%BB%B6%E7%BB%93%E6%9E%84%E8%AF%B4%E6%98%8E.md)*
|
||||
|
||||
## 附加包格式
|
||||
|
||||
支持的文件后缀：`.MCPACK`
|
||||
|
||||
1. 导入附加包
|
||||
2. 在一个循环方块中输入指令 `function index`
|
||||
3. 将需要聆听音乐的实体的播放所用计分板设置为 `1`
|
||||
4. 激活循环方块
|
||||
5. 若想要暂停播放，可以停止循环指令方块的激活状态
|
||||
6. 若想要重置某实体的播放，可以将其播放用的计分板重置
|
||||
|
||||
> 其中 步骤三 和 步骤四 的顺序可以调换。
|
||||
|
||||
## 结构格式
|
||||
|
||||
支持的文件后缀：`.MCSTRUCTURE`、`.BDX`
|
||||
|
||||
1. 将结构导入世界
|
||||
|
||||
- 延迟播放器
|
||||
|
||||
2. 将结构生成的第一个指令方块之模式更改为**脉冲**
|
||||
3. 激活脉冲方块
|
||||
4. 若欲重置播放，可以停止对此链的激活，例如停止区块加载
|
||||
5. 此播放器不支持暂停
|
||||
|
||||
- 计分板播放器
|
||||
|
||||
2. 在所生成的第一个指令方块前，放置一个循环指令方块，其朝向应当对着所生成的第一个方块
|
||||
3. 在循环指令方块中输入使播放对象的播放用计分板加分的指令，延迟为`0`，每次循环增加`1`分
|
||||
4. 激活循环方块
|
||||
5. 若想要暂停播放，可以停止循环指令方块的激活状态
|
||||
6. 若想要重置某实体的播放，可以将其播放用的计分板重置
|
||||
|
||||
16
docs/问与答.md
16
docs/问与答.md
@ -4,19 +4,19 @@
|
||||
|
||||
## 关于音·创与伶伦转换器
|
||||
|
||||
1. “伶伦”是什么？
|
||||
1. “**伶伦**”是什么？
|
||||
|
||||
伶伦是一个针对《我的世界》的数字音频工作站，用以创作、编辑《我的世界》风格的曲目。
|
||||
**伶伦** 是一个针对《我的世界》的数字音频工作站，用以创作、编辑《我的世界》风格的曲目。
|
||||
|
||||
2. “伶伦转换器”是什么？
|
||||
2. “**伶伦转换器**”是什么？
|
||||
|
||||
伶伦转换器是一个用于将Midi文件转换至我的世界可读格式的工具。其使用音·创库作为转换工具库，其目的旨在方便midi创作者进行简单的音乐转换，同时也是音·创库的一个项目实现。
|
||||
**伶伦转换器** 是一个用于将Midi文件转换至我的世界可读格式的工具。其使用 **音·创** 作为转换工具库，其目的旨在方便midi创作者进行简单的音乐转换，同时也是 **音·创** 的一个实现。
|
||||
|
||||
3. 为什么要将音·创库的功能迁移至伶伦转换器？
|
||||
3. 为什么要将 **音·创** 的功能迁移至 **伶伦转换器**？
|
||||
|
||||
音·创库作为单独存在的转换工具库，如果每次更新都需要从源码下载更新可能对用户十分的不友好。而且，音·创库的实现本是为了其他程序的调用，而不是一个转换程序。经过一段时间的观察与开发后，我们发现如果是以一种“可以用来转换音乐”的工具出现在大众面前，那么音·创库不仅不能被人理解，反而可能会让人困惑于其的具体功用，因此将伶伦转换器作为音·创库的实现，将独立的转换功能用更加亲用户的形式展现在大众面前，是一个更好的选择。
|
||||
**音·创** 作为单独存在的转换工具库，如果每次更新都需要从源码下载更新可能对用户十分的不友好。而且，**音·创** 的实现本是为了其他程序的调用，而不是一个转换程序。经过一段时间的观察与开发后，我们发现如果是以一种“可以用来转换音乐”的工具出现在大众面前，那么 **音·创** 不仅不能被人理解，反而可能会让人困惑于其的具体功用，因此将 **伶伦转换器** 作为 **音·创** 库的实现，将独立的转换功能用更加亲用户的形式展现在大众面前，是一个更好的选择。
|
||||
|
||||
4. 之前使用的“音·创库版本”的示例程序，现在还能用吗？
|
||||
4. 之前使用的“**音·创库版本**”的示例程序，现在还能用吗？
|
||||
|
||||
仍然可以使用，不过由于不再维护，已有的错误不会自动修复。
|
||||
|
||||
@ -30,6 +30,6 @@
|
||||
|
||||
详见问1，切换你所需要的播放器即可。
|
||||
|
||||
4. 转换算法是什么？怎么填？是越新越好吗？
|
||||
4. **（_已废弃_）** 转换算法是什么？怎么填？是越新越好吗？
|
||||
|
||||
转换算法是音·创库中所需要指定的内容，转换的算法都已经开源，可以在音·创仓库内找到。目前转换算法1对应的算法是将midi文件中的所有音轨单独提取并逐轨解析。而算法2是将所有音符单独提取出来，而后解析各个音符。算法的转换过程的差异可能会导致结果不同，但由于算法1已经不在进行主动维护，算法2的效果将会比1更好，所以建议使用算法2。算法3所对应的是尚在研究的插值算法，使用可能导致转换出错。
|
||||
Reference in New Issue
Block a user