TriM-Organization/Musicreater
2
0
Fork 0
mirror of https://github.com/TriM-Organization/Musicreater.git synced 2024-09-20 21:22:32 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

修改版权声明以及部分教程文档

Browse Source
This commit is contained in:
EillesWan 2023-01-01 03:23:48 +08:00
parent 9ca0788eb2
commit 2ebdf6be24
8 changed files with 605 additions and 558 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
LICENSE → LICENSE.md
View File

@ -1,3 +1,28 @@
**注意，以下条款或版权声明应当且必须是高于此项目中任何其他声明的**
1. 音·创的全部开发者享有其完整版权，开发者可以在任一时刻终止以后音·创源代码开放，若经由开发者授予特殊权利，则授权对象可以将源代码进行特定的被特殊授权的操作
2. 除部分代码特殊声明外，音·创允许对其进行商业化使用，但是需要经过音·创主要开发者（诸葛亮与八卦阵、金羿）的一致授权，同时，授权对象在商业化授权的使用过程中必须依照Apache2.0协议
3. 若存在对于音·创包含的部分代码的特殊开源声明，则此部分代码依照其特定的开源方式授权，但若此部分代码经由此部分代码的主要开发者一致特殊授权后商用，则授权对象在商用时依照此部分的开发者所准许的方式（或条款）进行商用，或默认依照Apache2.0协议进行商业化使用
4. Apache2.0 协议的英文原文副本可见下文
> The English Translation of the TERMS AND CONDITIONS above is listed below
> This translated version is for reference only and has no legal effect.
> The version with legal effect is the Chinese version above.
**Note, The TERMS AND CONDITIONS below should and must be above all others in this project**
1. *Musicreater* is fully copyrighted by all its developers, the developers have the right to make *Musicreater* close sourced at any time. Operations are permitted under specific terms instructed by its developer(s).
2. Commercial use of *Musicreater* is permitted under Apache License 2.0 with the unanimous permission of the steering developers of *Musicreater* (*bgArray*诸葛亮与八卦阵 and *Eilles*金羿).
4. *Musicreater* is open sourced under priority given:
1. License granted by the core developer(s) of a section after negotiation.
2. Explicitly stated license.
3. Apache 2.0 License.
5. A copy of the original Apache Lisence 2.0 can be found below.
```text
Apache License Apache License
Version 2.0, January 2004 Version 2.0, January 2004
http://www.apache.org/licenses/ http://www.apache.org/licenses/
@ -189,4 +214,4 @@
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and See the License for the specific language governing permissions and
limitations under the License. limitations under the License.
```

7
README.md
View File

@ -29,7 +29,7 @@
**此分支为音·创的包版本，即便于其他软件使用的可被import版本** **此分支为音·创的包版本，即便于其他软件使用的可被import版本**
### **看这看这！看这看这！看这看这！教程：[教程链接](https://gitee.com/EillesWan/Musicreater/blob/pkgver/docs/%E5%8A%9F%E8%83%BD%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md)** ### **看这看这！看这看这！看这看这！教程：[教程链接](./docs/%E5%8A%9F%E8%83%BD%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md)**
## 软件作者✒ ## 软件作者✒
@ -45,9 +45,10 @@
- 感谢由 **Charlie_Ping “查理平”** 带来的bdx文件转换参考， - 感谢由 **Charlie_Ping “查理平”** 带来的bdx文件转换参考，
以及mid转我的世界乐器参考表格 以及mid转我的世界乐器参考表格
- 感谢由 **CMA_2401PT** 为我们的软件开发进行指导 - 感谢由 **CMA_2401PT** 为我们的软件开发进行指导
- 感谢由 **Dislink Sforza**\<QQ1600515314\>带来的midi音色解析以及转换指令的算法，我们将其改编并应用 - 感谢由 **Dislink Sforza “断联·斯福尔扎”**\<QQ1600515314\>带来的midi音色解析以及转换指令的算法，我们将其改编并应用；同时，感谢他的[网页版转换器](https://dislink.github.io/midi2bdx/)给我们的开发与更新带来巨大的压力和动力，让我们在原本一骑绝尘的摸鱼道路上转向开发
- 感谢 **Touch “偷吃”**\<QQ1793537164\>提供的测试支持，并对程序的改进提供了丰富的意见 - 感谢 **Touch “偷吃”**\<QQ1793537164\>提供的测试支持，并对程序的改进提供了丰富的意见；同时也感谢他的不断尝试新的内容，使我们的排错更进一步
- 感谢 **Mono**\<QQ738893087\>反馈安装时的问题 - 感谢 **Mono**\<QQ738893087\>反馈安装时的问题
- 感谢 **Ammelia** 敦促我们进行新的功能开发，并为新功能提出了非常优秀的大量建议
> 感谢广大群友为此程序提供的测试等支持 > 感谢广大群友为此程序提供的测试等支持
> >

2
README_EN.md
View File

@ -28,7 +28,7 @@ Musicreater pkgver(Package Version 音·创 库版) is a free open source librar
Welcome to join our QQ group: [861684859](https://jq.qq.com/?_wv=1027&k=hpeRxrYr) Welcome to join our QQ group: [861684859](https://jq.qq.com/?_wv=1027&k=hpeRxrYr)
### **SEEEEEEEEE Tutorials [HERE](https://gitee.com/EillesWan/Musicreater/blob/pkgver/docs/Use%20of%20Funtions.md)** ### **SEEEEEEEEE Tutorials [HERE](./docs/Use%20of%20Funtions.md)**
### Authors✒ ### Authors✒

167
docs/download&atart/Android.md Normal file
View File

@ -0,0 +1,167 @@
## 使用前的准备工作
### 安装终端工具
这里我们选用 **Termux** 作为我们的终端工具来安装，这是一个强大的终端模拟器，旨在安卓环境下模拟Linux的软件包环境。
1. 下载
下载可以通过 [GitHub源](https://github.com/termux/termux-app/releases) 或者 [F-Droid源](https://f-droid.org/en/packages/com.termux/) ，个人建议选择 F-Droid 源，因为在国内可以访问得到，而 GitHub 源就看运气。
2. 安装
下载*APK*包后直接安装，安装后打开可以看到一个类似这样的界面：
<img height="512" src="https://foruda.gitee.com/images/1665933025120627254/a0479618_9911226.jpeg">
3. 完成
恭喜你，你已经获得了一个极客般流畅地操作你手机的终端工具。
### 安装运行环境
1. 换源
接下来，我们就要来准备安装一下 **Python** 运行环境了，这是运行 **Python** 源代码必要的。
首先，我估计你等不了多久，急得要死，所以我们要让下载速度稍微快一点，先来换个源。在 **Termux** 中，输入以下指令：
```bash
echo "deb https://mirror.mwt.me/termux/main stable main" > /data/data/com.termux/files/usr/etc/apt/sources.list
```
*感谢 天如<QQ 3291691454>为我们带来的简单换源方法。*
- *非必要步骤*：手动编辑换源
如果你闲着没事，非要要手动编辑个文档来换源，那用啥？用普通的编辑器肯定可以，于是我们就让他更普通一点，用**nano**吧！
在 **Termux** 中，输入以下指令：
```bash
export EDITOR=nano
apt edit-sources
```
那么请把看到的如左下图的界面变为右下图吧：
<table><tr>
<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>
- 图片中的文件，最后应该加入的两行为：
```bash
deb https://mirrors.ustc.edu.cn/termux/apt/termux-main/ stable main
deb https://mirrors.tuna.tsinghua.edu.cn/termux/apt/termux-main/ stable main
```
然后键入 `Ctrl`+`S`，再键入 `Ctrl`+`X`，退出`nano`。
在换源之后，你可能会见到类似的提示：
```bash
Your '/data/data/com.termux/files/usr/etc/apt/sources.list' file changed. Please run 'apt-get update'.
```
那就遵循它的指引，输入：
```bash
apt-get update
```
Alright.
2. 安装 **Python**
```bash
apt-get install python3
```
如果遇到提示问是否继续，那就输入`Y`表示是，如左下图，安装成功后，图若右下。
<table><tr>
<td><img src="https://foruda.gitee.com/images/1665933181440420034/7f0fb5fd_9911226.jpeg"></td>
<td><img src="https://foruda.gitee.com/images/1665933238339972260/a9f06f4f_9911226.jpeg"></td>
</tr></table>
接下来，我们来试一试 **Python** 是不是安装成了吧，输入
```bash
python3 -V
```
如果输出了形如 `Python 3.X.X` 的提示，则完成。
3. 安装依赖库
```bash
# 首先换源
pip config set global.index-url http://mirrors.aliyun.com/pypi/simple/
# 然后安装
pip install mido
pip install brotli
```
- 如果出现以下情况，真是死了鬼的，我们要来再搞个设置：
<img height="512" src="https://foruda.gitee.com/images/1665933289612919459/b87b7804_9911226.jpeg">
我们来修改收信任的源设置：
```bash
pip config set global.trusted-host mirrors.aliyun.com/
```
之后再来安装即可
```bash
pip install mido
pip install brotli
```
安装成功后您可能会见到类似下图的提示：
<img src="https://foruda.gitee.com/images/1662737676719454287/f61a70f7_9911226.png">
### 安装下载工具
既然已经有了运行环境，那么我们就需要下载下我们的**音·创库版示例代码**工具，我非常推崇**Git**这种方便快捷好用还能下载仓库的代码管理器，这个世界上你也找不到第二个，所以我们来安装一下：
```bash
pkg install git
```
安装完成后记得测试一下：
<img height="512" src="https://foruda.gitee.com/images/1665933331269483373/9374c85d_9911226.jpeg">
## 本代码库的下载与演示程序的使用
1. 使用Git下载本库及其示例代码
```bash
git clone -b pkgver https://gitee.com/EillesWan/Musicreater.git MSCTpkgver
```
当上述命令执行成功，你会在执行此命令的所在位置发现一个名为 `MSCTpkgver` 的文件夹，其中包含的正是我们心心念念下载的本程序和示例代码。
而我们要运行的也正是示例代码，因此，赶快进入下载到的文件夹：
```bash
cd MSCTpkgver
```
1. 开始使用演示程序
依照你的需要，执行以下命令之一：
```bash
python demo_convert.py #计分板播放器，支持mcpack与BDX
python demo_convert_bdx_byDelay.py #延迟播放器，仅支持BDX
```
运行成功了，哦耶！
<img height="512" src="https://foruda.gitee.com/images/1665933366784631363/db9f80f6_9911226.jpeg">

104
docs/download&atart/Linux.md Normal file
View File

@ -0,0 +1,104 @@
## 运行环境安装
### 检验Python运行环境
0. 一般的Linux发行版都有安装Python环境，我们只需要保证其版本即可，理论上 ≥Python3.6 都可以运行我们的库
我们可以使用
```bash
python -V
```
来查看 Python 版本，如下
<img src=https://foruda.gitee.com/images/1665120915821957090/429561fd_9911226.png>
1. *非必要环节*：回退版本
如果你跟作者一样，觉得 Python 3.10+ 太难用很烦人的话，那真是皆大欢喜，让我们一起来回退版本吧！
- pacman 包管理器（多用于Arch Linux上）
1. 让我们先来把 python3 加入忽略升级的列表中，使用`vim`修改`/etc/pacman.conf`，在`IgnorePkg`后加上`python3`
```bash
sudo vim /etc/pacman.conf
```
<img src=https://foruda.gitee.com/images/1665124611490335193/5e99ca26_9911226.png>
2. 然后我们开始从[Arch Achieve](https://archive.archlinux.org/packages/)上找Python的版本列表。（*这里说明一下，在Arch中，Python默认指的是Python3，而与其他某些Linux发行版中Python默认指代Python2不同，所以在Arch Achieve中也是如此。*）我这里找到的是[Python3.8.6](https://archive.archlinux.org/packages/p/python/python-3.8.6-1-x86_64.pkg.tar.zst)，于是我们用`pacman`把她下载下来并安装：
```bash
sudo pacman -U https://archive.archlinux.org/packages/p/python/python-3.8.6-1-x86_64.pkg.tar.zst
```
<img src=https://foruda.gitee.com/images/1665126362769399903/ea4b9598_9911226.png>
3. 完美！
- 其他包管理器
暂无
### 检查并安装pip包管理器依赖
1. 我们在安装依赖库之前，应该确认一下，Python自带的包管理器pip是否安装到位：
```bash
python -m pip # 确认pip是否安装
# 当这个命令输入后有长段提示出现则为已经安装
# 如果返回如下，那么则pip尚未安装
/usr/bin/python: No module named pip
# 可以使用如下命令来安装pip
sudo pacman -S python-pip
# 安装完成后记得验证
python -m pip
# 如果还是失败，那么就需要用其他工具安装pip：
wget https://bootstrap.pypa.io/get-pip.py
sudo python get-pip.py
# 安装完成后一定要验证！！！
python -m pip
```
2. 确认完成之后，我们来安装一下依赖库：
```bash
pip install mido -i https://mirrors.aliyun.com/pypi/simple/
pip install brotli -i https://mirrors.aliyun.com/pypi/simple/
```
3. 安装成功后可能会见到类似下图的提示：
<img src="https://foruda.gitee.com/images/1662737676719454287/f61a70f7_9911226.png">
## 本代码库的下载与使用
1. 使用Git下载本库及其示例代码
```bash
git clone -b pkgver https://gitee.com/EillesWan/Musicreater.git MSCTpkgver
```
当上述命令执行成功，你会在执行此命令的所在位置发现一个名为 `MSCTpkgver` 的文件夹，其中包含的正是我们心心念念下载的本程序和示例代码。
而我们要运行的也正是示例代码，因此，赶快进入下载到的文件夹：
```bash
cd MSCTpkgver
```
1. 开始使用
在目录下打开终端，执行以下命令：(选择你需要的)
```bash
python demo_convert.py #计分板播放器，支持mcpack与BDX
python demo_convert_bdx_byDelay.py #延迟播放器，仅支持BDX
```

89
docs/download&atart/Windows.md Normal file
View File

@ -0,0 +1,89 @@
## 一、运行环境安装
### （一）安装 Python3.6+
1. 首先需要下载Python的安装包，最好是 *Python3.8*，因为作者就用的是这个版本
> [下载64位Python安装包](https://www.python.org/ftp/python/3.8.10/python-3.8.10-amd64.exe)
> [下载32位Python安装包](https://www.python.org/ftp/python/3.8.10/python-3.8.10.exe)
2. 在安装时，最好需要勾选 `Add Python 3.X to PATH`，如下图所示，当然，如果您对自己非常自信，您也可以手动设置此项目：
<img src=https://foruda.gitee.com/images/1662736520757331846/e38efb81_9911226.png>
- 若您对Python一知半解或者不怎么了解、并对自己的系统盘（通常是C盘）有大约150*兆字节*(MB)的信心的话，您可以在安装时直接选择*快速安装*(Install Now)
3. 若您选择了*自定义安装*(Customize Installation)，请务必勾选 `pip` 和 `py launcher` 便于后续安装依赖，如下图：
<img src=https://foruda.gitee.com/images/1662736621235871190/2ac3d98f_9911226.png>
4. 安装结束之后可以在*终端*(命令行/PowerShell/Bash/etc)中输入：python 试试是否安装成功，成功安装之后，在终端中输入python会显示诸如如下图片的提示：
<img src=https://foruda.gitee.com/images/1659972669907359295/cmd.png>
### （二）安装依赖
1. 请以管理员模式打开您的*终端*(命令行/PowerShell/Bash/etc)
例如，命令行，可以如此打开：在*视窗开始菜单*(Windows开始)中搜索 `cmd`, 并以管理员身份运行
<img src="https://foruda.gitee.com/images/1662736878650993886/62487dd8_9911226.png">
2. 打开了终端之后，请在终端中输入以下指令
```bash
pip install mido -i https://mirrors.aliyun.com/pypi/simple/
pip install brotli -i https://mirrors.aliyun.com/pypi/simple/
```
3. 安装成功后您可能会见到类似下图的提示：
<img src="https://foruda.gitee.com/images/1662737676719454287/f61a70f7_9911226.png">
## 二、本工具的下载与使用
0. 下载本代码库以及演示程序
- 若您使用git，请直接克隆本仓库：
```bash
git clone -b pkgver https://gitee.com/EillesWan/Musicreater.git
```
- 若您不使用git，可以在[*码云*(Gitee)](https://gitee.com/EillesWan/Musicreater.git)或[*GitHub*](https://github.com/EillesWan/Musicreater.git)下载zip包，或者[加入QQ群聊861684859](https://jq.qq.com/?_wv=1027&k=hpeRxrYr)，在群文件中获取。
<img src="https://foruda.gitee.com/images/1669540786443169766/fabf0acd_9911226.png" >
值得注意的是，这张图上有1、2两个数字，虽然是手写的，但确实是数字，表示着要进行的步骤。希望眼尖得能找出我的口头禅的你们能够发现这两个用鼠标手写的数字并在安装时认真地执行。我认为这并不算十分的难，移动鼠标并单击大约消耗不了多少卡路里，不过我没有进行精确的计算，我也不是十分的清楚这个活动对于一个常人来讲有多难，但我怀疑它不难。
1. 开始使用
在目录下打开终端。
例如：打开命令行：请进入到目录下，在文件资源管理器的地址框内输入`cmd`：
<img src=https://foruda.gitee.com/images/1659974437388532868/输入.png>
<img src=https://foruda.gitee.com/images/1659974754378201859/输入c.png>
执行以下命令：(选择你需要的)
```bash
python demo_convert.py #计分板播放器，支持mcpack与BDX
python demo_convert_bdx_byDelay.py #延迟播放器，仅支持BDX
```
## 三、安装时错误的补充说明
1. Microsoft Visual C++ Redistributable 环境出错
如果你遇到了类似以下这种情况：
<img src=https://foruda.gitee.com/images/1659972789779764953/bug.jpeg>
请下载最新的VCREDIST安装包，可以参照[这个网页](https://docs.microsoft.com/zh-CN/cpp/windows/latest-supported-vc-redist)的说明，也可以在这直接选择你需要的安装包下载：
> [下载64位VCREDIST安装包](https://aka.ms/vs/17/release/vc_redist.x64.exe)
> [下载32位VCREDIST安装包](https://aka.ms/vs/17/release/vc_redist.x86.exe)
感谢群友Mono帮我们发现这个问题。

375
docs/功能使用说明.md
View File

@ -12,353 +12,39 @@
*这是演示程序（demo）的使用教程，将在这里提供演示程序的相应的使用教程* *这是演示程序（demo）的使用教程，将在这里提供演示程序的相应的使用教程*
## 视窗(Windows)操作系统 ## 下载与启动教程
### 运行环境安装 ### [视窗(Windows)操作系统](./download%26atart/Windows.md)
### [里纽克斯(Linux)操作系统](./download%26atart/Linux.md)
### [安卓(Android)与安卓衍生操作系统](./download%26atart/Android.md)
0. 安装 Python3.6+ ## 演示程序使用教程
首先需要下载Python的安装包，最好是 *Python3.8*，因为作者就用的是这个版本 1. 参数说明
> [下载64位Python安装包](https://www.python.org/ftp/python/3.8.10/python-3.8.10-amd64.exe) <img src=https://foruda.gitee.com/images/1659974810147043475/运行.png>
> [下载32位Python安装包](https://www.python.org/ftp/python/3.8.10/python-3.8.10.exe)
在安装时，最好需要勾选 `Add Python 3.X to PATH`，如下图所示，当然，如果您对自己非常自信，您也可以手动设置此项目： - midi路径：含有mid文件路径、文件名、后缀的完整文件路径，或者一个目录（demo可接受批量转换）。可以使用相对或绝对路径皆可
<img src=https://foruda.gitee.com/images/1662736520757331846/e38efb81_9911226.png> - 输出路径：输出文件夹的路径，不需要指示文件名
若您对Python一知半解或者不怎么了解、并对自己的系统盘（通常是C盘）有大约150*兆字节*(MB)的信心的话，您可以在安装时直接选择*快速安装*(Install Now) - 是否重置计分板：`1`或`0`（歌曲放完是否重置，推荐`1`）
若您选择了*自定义安装*(Customize Installation)，请务必勾选 `pip` 和 `py launcher` 便于后续安装依赖，如下图： - 进度条：是否启用进度条，以及自定义进度条样式。输入`0`或`False`表示不启用进度条，输入`1`或`True`表示使用默认进度条，其余的输入均表示使用输入的格式作为自定义的进度条样式
<img src=https://foruda.gitee.com/images/1662736621235871190/2ac3d98f_9911226.png> 若不支持自定义，则仅能输入`0`或`1`表示“关闭”或“开启”
安装结束之后可以在*终端*(命令行/PowerShell/Bash/etc)中输入：python 试试是否安装成功，成功安装之后，在终端中输入python会显示诸如如下图片的提示：
<img src=https://foruda.gitee.com/images/1659972669907359295/cmd.png>
1. 安装依赖
请以管理员模式打开您的*终端*(命令行/PowerShell/Bash/etc)
例如，命令行，可以如此打开：在*视窗开始菜单*(Windows开始)中搜索 `cmd`, 并以管理员身份运行
<img src="https://foruda.gitee.com/images/1662736878650993886/62487dd8_9911226.png">
打开了终端之后，请在终端中输入以下指令
```bash
pip install mido -i https://mirrors.aliyun.com/pypi/simple/
pip install brotli -i https://mirrors.aliyun.com/pypi/simple/
```
安装成功后您可能会见到类似下图的提示：
<img src="https://foruda.gitee.com/images/1662737676719454287/f61a70f7_9911226.png">
### 本工具的下载与使用
0. 下载本代码库以及演示程序
- 若您使用git，请直接克隆本仓库：
```bash
git clone -b pkgver https://gitee.com/EillesWan/Musicreater.git
```
- 若您不使用git，可以在[*码云*(Gitee)](https://gitee.com/EillesWan/Musicreater.git)或[*GitHub*](https://github.com/EillesWan/Musicreater.git)下载zip包，或者[加入QQ群聊861684859](https://jq.qq.com/?_wv=1027&k=hpeRxrYr)，在群文件中获取。
<img src="https://foruda.gitee.com/images/1669540786443169766/fabf0acd_9911226.png" >
1. 开始使用
在目录下打开终端，例如，打开命令行，请进入到目录下，在地址框内输入`cmd`：
<img src=https://foruda.gitee.com/images/1659974437388532868/输入.png>
<img src=https://foruda.gitee.com/images/1659974754378201859/输入c.png>
执行以下命令：(选择你需要的)
```bash
python demo_convert.py
python demo_convert_bdx_byDelay.py
```
### 补充错误说明
1. Microsoft Visual C++ Redistributable 环境出错
如果你遇到了类似以下这种情况：
<img src=https://foruda.gitee.com/images/1659972789779764953/bug.jpeg>
请下载最新的VCREDIST安装包，可以参照[这个网页](https://docs.microsoft.com/zh-CN/cpp/windows/latest-supported-vc-redist)的说明，也可以在这直接选择你需要的安装包下载：
> [下载64位VCREDIST安装包](https://aka.ms/vs/17/release/vc_redist.x64.exe)
> [下载32位VCREDIST安装包](https://aka.ms/vs/17/release/vc_redist.x86.exe)
感谢群友Mono帮我们发现这个问题
## 里纽克斯(Linux)操作系统
### 运行环境安装
0. 安装并检验Python运行环境
一般的Linux发行版都有安装Python环境，我们只需要保证其版本即可，理论上 ≥Python3.6 都可以运行我们的库
我们可以使用
```bash
python -V
```
来查看 Python 版本，如下
<img src=https://foruda.gitee.com/images/1665120915821957090/429561fd_9911226.png>
- 非必要环节
如果你跟作者一样，觉得 Python 3.10+ 太难用很烦人的话，那真是皆大欢喜，让我们一起来回退版本吧！
- pacman 包管理器（多用于Arch Linux上）
让我们先来把 python3 加入忽略升级的列表中，使用`vim`修改`/etc/pacman.conf`，在`IgnorePkg`后加上`python3`
```bash
sudo vim /etc/pacman.conf
```
<img src=https://foruda.gitee.com/images/1665124611490335193/5e99ca26_9911226.png>
然后我们开始从[Arch Achieve](https://archive.archlinux.org/packages/)上找Python的版本列表。（*这里说明一下，在Arch中，Python默认指的是Python3，而与其他某些Linux发行版中Python默认指代Python2不同，所以在Arch Achieve中也是如此。*）我这里找到的是[Python3.8.6](https://archive.archlinux.org/packages/p/python/python-3.8.6-1-x86_64.pkg.tar.zst)，于是我们用`pacman`把她下载下来：
```bash
sudo pacman -U https://archive.archlinux.org/packages/p/python/python-3.8.6-1-x86_64.pkg.tar.zst
```
<img src=https://foruda.gitee.com/images/1665126362769399903/ea4b9598_9911226.png>
完美！
1. 检查并安装pip包管理器依赖
我们在安装依赖库之前，应该确认一下，Python自带的包管理器pip是否安装到位：
```bash
python -m pip # 确认pip是否安装
# 当这个命令输入后有长段提示出现则为已经安装
# 如果返回如下，那么则pip尚未安装
/usr/bin/python: No module named pip
# 可以使用如下命令来安装pip
sudo pacman -S python-pip
# 安装完成后记得验证
python -m pip
# 如果还是失败，那么就需要用其他工具安装pip：
wget https://bootstrap.pypa.io/get-pip.py
sudo python get-pip.py
# 安装完成后一定要验证！！！
python -m pip
```
确认完成之后，我们来安装一下依赖库：
```bash
pip install mido -i https://mirrors.aliyun.com/pypi/simple/
pip install brotli -i https://mirrors.aliyun.com/pypi/simple/
```
安装成功后您可能会见到类似下图的提示：
<img src="https://foruda.gitee.com/images/1662737676719454287/f61a70f7_9911226.png">
### 本代码库的下载与使用
1. 使用Git下载本库及其示例代码
```bash
git clone -b pkgver https://gitee.com/EillesWan/Musicreater.git MSCTpkgver
```
当上述命令执行成功，你会在执行此命令的所在位置发现一个名为 `MSCTpkgver` 的文件夹，其中包含的正是我们心心念念下载的本程序和示例代码。
而我们要运行的也正是示例代码，因此，赶快进入下载到的文件夹：
```bash
cd MSCTpkgver
```
1. 开始使用
在目录下打开终端，执行以下命令：(选择你需要的)
```bash
python demo_convert.py
python demo_convert_bdx_byDelay.py
```
## 安卓(Android)与安卓衍生操作系统
### 使用前的准备工作
0. 安装终端工具
这里我们选用 **Termux** 作为我们的终端工具来安装，这是一个强大的终端模拟器，旨在安卓环境下模拟Linux的软件包环境。
下载可以通过 [GitHub](https://github.com/termux/termux-app/releases) 或者 [F-Droid](https://f-droid.org/en/packages/com.termux/) ，个人建议选择 F-Droid 源，因为在国内可以访问得到，而 GitHub 源就看运气。
下载后直接按照，打开后可以看到一个类似这样的界面：
<img src="https://foruda.gitee.com/images/1665933025120627254/a0479618_9911226.jpeg">
恭喜你，你已经获得了一个极客般流畅地操作你手机的终端工具。
1. 安装运行环境
接下来，我们就要来安装一下 **Python** 运行环境了，这是运行 **Python** 源代码必要的。
首先，我估计你等不了多久，急得要死，所以我们要让下载速度稍微快一点，先来换个源。换源要手动编辑个文档，那用啥？用普通的编辑器肯定可以，于是我们就让他更普通一点，用**nano**吧！
在 **Termux** 中，输入以下指令：
```bash
export EDITOR=nano
apt edit-sources
```
你可能会看到如下一个简单的界面：
<img src="https://foruda.gitee.com/images/1665933104313107707/41108f03_9911226.jpeg">
好，让我们动起你的双手，把它变成这样吧：
<img src="https://foruda.gitee.com/images/1665933122534781330/3887a901_9911226.jpeg">
- 图片中的文件，最后应该加入的两行为：
```bash
deb https://mirrors.ustc.edu.cn/termux/apt/termux-main/ stable main
deb https://mirrors.tuna.tsinghua.edu.cn/termux/apt/termux-main/ stable main
```
然后键入 `Ctrl`+`S`，再键入 `Ctrl`+`X`，你会见到差不多如下的提示：
```text
Your '/data/data/com.termux/files/usr/etc/apt/sources.list' file changed. Please run 'apt-get update'.
```
那就遵循它的指引，输入：
```bash
apt-get update
```
然后就完美了，我们来安装 **Python** 吧！
```bash
apt-get install python3
```
如果遇到提示问是否继续，那就输入`Y`表示是，如图。
<img src="https://foruda.gitee.com/images/1665933181440420034/7f0fb5fd_9911226.jpeg">
如果你安装成功，应该是差不多这样的：
<img src="https://foruda.gitee.com/images/1665933238339972260/a9f06f4f_9911226.jpeg">
我们来试一试 **Python** 是不是安装成了吧，输入
```bash
python3 -V
```
如果输出了形如 `Python 3.X.X` 的提示，则完成。
确认完成之后，我们来安装一下依赖库：
```bash
# 首先换源
pip config set global.index-url http://mirrors.aliyun.com/pypi/simple/
# 然后安装
pip install mido
pip install brotli
```
- 如果出现以下情况，真是死了鬼的，我们要来再搞个设置：
<img src="https://foruda.gitee.com/images/1665933289612919459/b87b7804_9911226.jpeg">
我们来修改收信任的源设置：
```bash
pip config set global.trusted-host mirrors.aliyun.com/
```
之后再来安装即可
```bash
pip install mido
pip install brotli
```
安装成功后您可能会见到类似下图的提示：
<img src="https://foruda.gitee.com/images/1662737676719454287/f61a70f7_9911226.png">
3. 安装下载工具
既然已经有了运行环境，那么我们就需要下载下我们的**音·创库版示例代码**工具，我非常推崇**Git**这种方便快捷好用还能下载仓库的代码管理器，这个世界上你也找不到第二个，所以我们来安装一下：
```bash
pkg install git
```
安装完成后记得测试一下：
<img src="https://foruda.gitee.com/images/1665933331269483373/9374c85d_9911226.jpeg">
### 本代码库的下载与使用
1. 使用Git下载本库及其示例代码
```bash
git clone -b pkgver https://gitee.com/EillesWan/Musicreater.git MSCTpkgver
```
当上述命令执行成功，你会在执行此命令的所在位置发现一个名为 `MSCTpkgver` 的文件夹，其中包含的正是我们心心念念下载的本程序和示例代码。
而我们要运行的也正是示例代码，因此，赶快进入下载到的文件夹：
```bash
cd MSCTpkgver
```
1. 开始使用
在目录下打开终端，执行以下命令：(选择你需要的)
```bash
python demo_convert.py
python demo_convert_bdx_byDelay.py
```
运行成功了，哦耶！
<img src="https://foruda.gitee.com/images/1665933366784631363/db9f80f6_9911226.jpeg">
- 计分板名称：游戏内的计分板名称
- 音量：0-1之间的小数（含0，1）正常来说推荐`1`
- 速度倍率：小数数据，其值不可为0，一般写`1`
- 玩家选择器：包括 `@x` 在内的全部选择器，即若要选择全部标签为`Holo`的玩家，则需要如此输入：`@a[tag=Holo]`
- 没有报错且在输出路径下找到mcpack或bdx即为生成成功：
<img src=https://foruda.gitee.com/images/1659973655881460036/输出.png>
# 其他说明 # 其他说明
@ -373,31 +59,6 @@
答2：详见问1，切换你所需要的播放器即可。 答2：详见问1，切换你所需要的播放器即可。
## 对于 参数 的补充说明
<img src=https://foruda.gitee.com/images/1659974810147043475/运行.png>
- midi路径：含有mid文件路径、文件名、后缀的完整文件路径，或者一个目录（demo可接受批量转换）。可以使用相对或绝对路径皆可
- 输出路径：输出文件夹的路径，不需要指示文件名
- 是否重置计分板：1或0（歌曲放完是否重置，推荐1）
- *进度条：是否启用进度条，以及自定义进度条样式。输入0或False表示不启用进度条，输入1或True表示使用默认进度条，其余的输入均表示使用输入的格式作为自定义的进度条样式
- 计分板名称：游戏内的计分板名称
- 音量：0-1之间的小数（含0，1）正常来说推荐1
- 速度倍率：小数数据，不可为0，一般写1
- 玩家选择器：包括 `@x` 在内的全部选择器，即若要选择全部标签为`Holo`的玩家，则需要如此输入：`@a[tag=Holo]`
- 没有报错且在输出路径下找到mcpack或bdx即为生成成功：
<img src=https://foruda.gitee.com/images/1659973655881460036/输出.png>
## 对于 进度条自定义 功能的说明 ## 对于 进度条自定义 功能的说明
因为我们提供了可以自动转换进度条的功能，因此在这里给出进度条自定义参数的详细解释。 因为我们提供了可以自动转换进度条的功能，因此在这里给出进度条自定义参数的详细解释。

2
msctPkgver/__init__.py
View File

@ -35,6 +35,6 @@ from .main import *
print('此Midi转换功能由音·创开发者开发，版权归参与开发的人员共同所有。') print('此Midi转换功能由音·创开发者开发，版权归参与开发的人员共同所有。')
print('Copyright © 2022 all the developers of Musicreater') print('Copyright © 2022 all the developers of Musicreater')
print("不妨试试Mid-BDX转换网页：在线的多功能Midi转换器") print("小贴：不妨试试Mid-BDX转换网页：在线的多功能Midi转换器")
print("https://dislink.github.io/midi2bdx/") print("https://dislink.github.io/midi2bdx/")