Musicreater/msctPkgver/main.py

# -*- coding: utf-8 -*-


# 音·创 开发交流群 861684859
# Email EillesWan2006@163.com W-YI_DoctorYI@outlook.com EillesWan@outlook.com
# 版权所有 金羿("Eilles Wan") & 诸葛亮与八卦阵("bgArray") & 鸣凤鸽子("MingFengPigeon")
# 若需转载或借鉴 许可声明请查看仓库目录下的 Lisence.md


"""
音·创 库版 (Musicreater Package Version)
是一款免费开源的针对《我的世界：基岩版》的midi音乐转换库
Musicreater pkgver (Package Version 音·创 库版)
A free open source library used for convert midi file into formats that is suitable for **Minecraft: Bedrock Edition**.

Copyright 2023 all the developers of Musicreater

开源相关声明请见 ../Lisence.md
Terms & Conditions: ../Lisence.md
"""

import mido
import brotli
import json
import uuid
import shutil

from .utils import *
from .exceptions import *


class SingleNote:
    def __init__(
        self, instrument: int, pitch: int, velocity, startTime: int, lastTime: int
    ):
        """用于存储单个音符的类
        :param instrument 乐器编号
        :param pitch 音符编号
        :param velocity 力度/响度
        :param startTime 开始之时(ms)
            注：此处的时间是用从乐曲开始到当前的毫秒数
        :param lastTime 音符延续时间(ms)"""
        self.instrument = instrument
        '''乐器编号'''
        self.note = pitch
        '''音符编号'''
        self.velocity = velocity
        '''力度/响度'''
        self.startTime = startTime
        '''开始之时 ms'''
        self.lastTime = lastTime
        '''音符持续时间 ms'''

    @property
    def inst(self):
        '''乐器编号'''
        return self.instrument

    @property
    def pitch(self):
        '''音符编号'''
        return self.note

    def __str__(self):
        return f"Note(inst = {self.inst}, pitch = {self.note}, velocity = {self.velocity}, startTime = {self.startTime}, lastTime = {self.lastTime}, )"

    def __tuple__(self):
        return (self.inst, self.note, self.velocity, self.startTime, self.lastTime)

    def __dict__(self):
        return {
            "inst": self.inst,
            "pitch": self.note,
            "velocity": self.velocity,
            "startTime": self.startTime,
            "lastTime": self.lastTime,
        }


"""
学习笔记：
tempo:  microseconds per quarter note 毫秒每四分音符，换句话说就是一拍占多少毫秒
tick:  midi帧
ticks_per_beat:  帧每拍，即一拍多少帧

那么：

tick / ticks_per_beat => amount_of_beats 拍数(四分音符数)

tempo * amount_of_beats => 毫秒数

所以：

tempo * tick / ticks_per_beat => 毫秒数

###########

seconds per tick:
(tempo / 1000000.0) / ticks_per_beat

seconds:
tick * tempo / 1000000.0 / ticks_per_beat

microseconds:
tick * tempo / 1000.0 / ticks_per_beat

gameticks:
tick * tempo / 1000000.0 / ticks_per_beat * 一秒多少游戏刻


"""


class midiConvert:
    def __init__(self, debug: bool = False):
        """简单的midi转换类，将midi文件转换为我的世界结构或者包"""
        self.debugMode = debug
        self.methods = [
            self._toCmdList_m1,
            self._toCmdList_m2,
            self._toCmdList_m3,
        ]
        self.methods_byDelay = [
            self._toCmdList_withDelay_m1,
        ]
        if self.debugMode:
            from .magicBeing import prt,ipt
            self.prt = prt
            self.ipt = ipt

    def convert(self, midiFile: str, outputPath: str, oldExeFormat: bool = True):
        """转换前需要先运行此函数来获取基本信息"""

        self.midiFile = midiFile
        """midi文件路径"""

        try:
            self.midi = mido.MidiFile(self.midiFile)
            """MidiFile对象"""
        except Exception as E:
            raise MidiDestroyedError(f"文件{self.midiFile}损坏：{E}")

        self.outputPath = os.path.abspath(outputPath)
        """输出路径"""
        # 将self.midiFile的文件名，不含路径且不含后缀存入self.midiFileName
        self.midFileName = os.path.splitext(os.path.basename(self.midiFile))[0]
        """文件名，不含路径且不含后缀"""

        self.exeHead = (
            "execute {} ~ ~ ~ "
            if oldExeFormat
            else "execute as {} at @s positioned ~ ~ ~ run "
        )
        """execute指令的应用，两个版本提前决定。"""

    def __Inst2soundIDwithX(self, instrumentID):
        """返回midi的乐器ID对应的我的世界乐器名，对于音域转换算法，如下：
            2**( ( msg.note - 60 - X ) / 12 ) 即为MC的音高，其中
            X的取值随乐器不同而变化：
            竖琴harp、电钢琴pling、班卓琴banjo、方波bit、颤音琴iron_xylophone 的时候为6
            吉他的时候为7
            贝斯bass、迪吉里杜管didgeridoo的时候为8
            长笛flute、牛铃cou_bell的时候为5
            钟琴bell、管钟chime、木琴xylophone的时候为4
            而存在一些打击乐器bd(basedrum)、hat、snare，没有音域，则没有X，那么我们返回7即可
        :param instrumentID: midi的乐器ID
        default: 如果instrumentID不在范围内，返回的默认我的世界乐器名称
        :return: (str我的世界乐器名, int转换算法中的X)"""
        try:
            a = {
                0: ("note.harp", 6),
                1: ("note.harp", 6),
                2: ("note.pling", 6),
                3: ("note.harp", 6),
                4: ("note.pling", 6),
                5: ("note.pling", 6),
                6: ("note.harp", 6),
                7: ("note.harp", 6),
                8: ("note.share", 7),  # 打击乐器无音域
                9: ("note.harp", 6),
                10: ("note.didgeridoo", 8),
                11: ("note.harp", 6),
                12: ("note.xylophone", 4),
                13: ("note.chime", 4),
                14: ("note.harp", 6),
                15: ("note.harp", 6),
                16: ("note.bass", 8),
                17: ("note.harp", 6),
                18: ("note.harp", 6),
                19: ("note.harp", 6),
                20: ("note.harp", 6),
                21: ("note.harp", 6),
                22: ("note.harp", 6),
                23: ("note.guitar", 7),
                24: ("note.guitar", 7),
                25: ("note.guitar", 7),
                26: ("note.guitar", 7),
                27: ("note.guitar", 7),
                28: ("note.guitar", 7),
                29: ("note.guitar", 7),
                30: ("note.guitar", 7),
                31: ("note.bass", 8),
                32: ("note.bass", 8),
                33: ("note.bass", 8),
                34: ("note.bass", 8),
                35: ("note.bass", 8),
                36: ("note.bass", 8),
                37: ("note.bass", 8),
                38: ("note.bass", 8),
                39: ("note.bass", 8),
                40: ("note.harp", 6),
                41: ("note.harp", 6),
                42: ("note.harp", 6),
                43: ("note.harp", 6),
                44: ("note.iron_xylophone", 6),
                45: ("note.guitar", 7),
                46: ("note.harp", 6),
                47: ("note.harp", 6),
                48: ("note.guitar", 7),
                49: ("note.guitar", 7),
                50: ("note.bit", 6),
                51: ("note.bit", 6),
                52: ("note.harp", 6),
                53: ("note.harp", 6),
                54: ("note.bit", 6),
                55: ("note.flute", 5),
                56: ("note.flute", 5),
                57: ("note.flute", 5),
                58: ("note.flute", 5),
                59: ("note.flute", 5),
                60: ("note.flute", 5),
                61: ("note.flute", 5),
                62: ("note.flute", 5),
                63: ("note.flute", 5),
                64: ("note.bit", 6),
                65: ("note.bit", 6),
                66: ("note.bit", 6),
                67: ("note.bit", 6),
                68: ("note.flute", 5),
                69: ("note.harp", 6),
                70: ("note.harp", 6),
                71: ("note.flute", 5),
                72: ("note.flute", 5),
                73: ("note.flute", 5),
                74: ("note.harp", 6),
                75: ("note.flute", 5),
                76: ("note.harp", 6),
                77: ("note.harp", 6),
                78: ("note.harp", 6),
                79: ("note.harp", 6),
                80: ("note.bit", 6),
                81: ("note.bit", 6),
                82: ("note.bit", 6),
                83: ("note.bit", 6),
                84: ("note.bit", 6),
                85: ("note.bit", 6),
                86: ("note.bit", 6),
                87: ("note.bit", 6),
                88: ("note.bit", 6),
                89: ("note.bit", 6),
                90: ("note.bit", 6),
                91: ("note.bit", 6),
                92: ("note.bit", 6),
                93: ("note.bit", 6),
                94: ("note.bit", 6),
                95: ("note.bit", 6),
                96: ("note.bit", 6),
                97: ("note.bit", 6),
                98: ("note.bit", 6),
                99: ("note.bit", 6),
                100: ("note.bit", 6),
                101: ("note.bit", 6),
                102: ("note.bit", 6),
                103: ("note.bit", 6),
                104: ("note.harp", 6),
                105: ("note.banjo", 6),
                106: ("note.harp", 6),
                107: ("note.harp", 6),
                108: ("note.harp", 6),
                109: ("note.harp", 6),
                110: ("note.harp", 6),
                111: ("note.guitar", 7),
                112: ("note.harp", 6),
                113: ("note.bell", 4),
                114: ("note.harp", 6),
                115: ("note.cow_bell", 5),
                116: ("note.bd", 7),  # 打击乐器无音域
                117: ("note.bass", 8),
                118: ("note.bit", 6),
                119: ("note.bd", 7),  # 打击乐器无音域
                120: ("note.guitar", 7),
                121: ("note.harp", 6),
                122: ("note.harp", 6),
                123: ("note.harp", 6),
                124: ("note.harp", 6),
                125: ("note.hat", 7),  # 打击乐器无音域
                126: ("note.bd", 7),  # 打击乐器无音域
                127: ("note.snare", 7),  # 打击乐器无音域
            }[instrumentID]
        except BaseException:
            a = ("note.flute", 5)
        return a

    def __bitInst2IDwithX(self, instrumentID):
        try:
            try:
                return {
                    34: ('note.bd', 7),
                    35: ('note.bd', 7),
                    36: ('note.hat', 7),
                    37: ('note.snare', 7),
                    38: ('note.snare', 7),
                    39: ('note.snare', 7),
                    40: ('note.hat', 7),
                    41: ('note.snare', 7),
                    42: ('note.hat', 7),
                    43: ('note.snare', 7),
                    44: ('note.snare', 7),
                    45: ('note.bell', 4),
                    46: ('note.snare', 7),
                    47: ('note.snare', 7),
                    48: ('note.bell', 4),
                    49: ('note.hat', 7),
                    50: ('note.bell', 4),
                    51: ('note.bell', 4),
                    52: ('note.bell', 4),
                    53: ('note.bell', 4),
                    54: ('note.bell', 4),
                    55: ('note.bell', 4),
                    56: ('note.snare', 7),
                    57: ('note.hat', 7),
                    58: ('note.chime', 4),
                    59: ('note.iron_xylophone', 6),
                    60: ('note.bd', 7),
                    61: ('note.bd', 7),
                    62: ('note.xylophone', 4),
                    63: ('note.xylophone', 4),
                    64: ('note.xylophone', 4),
                    65: ('note.hat', 7),
                    66: ('note.bell', 4),
                    67: ('note.bell', 4),
                    68: ('note.hat', 7),
                    69: ('note.hat', 7),
                    70: ('note.flute', 5),
                    71: ('note.flute', 5),
                    72: ('note.hat', 7),
                    73: ('note.hat', 7),
                    74: ('note.xylophone', 4),
                    75: ('note.hat', 7),
                    76: ('note.hat', 7),
                    77: ('note.xylophone', 4),
                    78: ('note.xylophone', 4),
                    79: ('note.bell', 4),
                    80: ('note.bell', 4),
                }[instrumentID]
            except:
                return ("note.bd", 7)
        except:
            print("WARN", "无法使用打击乐器列表库，可能是不支持当前环境，打击乐器使用Dislink算法代替。")
            if instrumentID == 55:
                return ("note.cow_bell", 5)
            elif instrumentID in [41, 43, 45]:
                return ("note.hat", 7)
            elif instrumentID in [36, 37, 39]:
                return ("note.snare", 7)
            else:
                return ("note.bd", 7)

    def __score2time(self, score: int):
        return str(int(int(score / 20) / 60)) + ":" + str(int(int(score / 20) % 60))

    def __formProgressBar(
        self,
        maxscore: int,
        scoreboardname: str,
        progressbar: tuple = (
            r"▶ %%N [ %%s/%^s %%% __________ %%t|%^t ]",
            ("§e=§r", "§7=§r"),
        ),
    ) -> list:

        pgsstyle = progressbar[0]
        """用于被替换的进度条原始样式"""

        """
        | 标识符   | 指定的可变量     |
        |---------|----------------|
        | `%%N`   | 乐曲名(即传入的文件名)|
        | `%%s`   | 当前计分板值     |
        | `%^s`   | 计分板最大值     |
        | `%%t`   | 当前播放时间     |
        | `%^t`   | 曲目总时长       |
        | `%%%`   | 当前进度比率     |
        | `_`     | 用以表示进度条占位|
        """
        perEach = maxscore / pgsstyle.count('_')

        result = []

        if r"%^s" in pgsstyle:
            pgsstyle = pgsstyle.replace(r"%^s", str(maxscore))

        if r"%^t" in pgsstyle:
            pgsstyle = pgsstyle.replace(r"%^t", self.__score2time(maxscore))

        def replaceBar(i):
            try:
                return pgsstyle.replace('_', progressbar[1][0], i + 1).replace(
                    '_', progressbar[1][1]
                )
            except:
                return pgsstyle.replace('_', progressbar[1][0], i + 1)

        sbnpc = scoreboardname[:2]
        if r"%%%" in pgsstyle:
            result.append(
                "scoreboard objectives add {}PercT dummy \"百分比计算\"".format(sbnpc)
            )
            result.append(
                self.exeHead.format("@a[scores={" + scoreboardname + "=1..}]")
                + "scoreboard players set MaxScore {} {}".format(
                    scoreboardname, maxscore
                )
            )
            result.append(
                self.exeHead.format("@a[scores={" + scoreboardname + "=1..}]")
                + "scoreboard players set MaxScore {} 100".format(scoreboardname)
            )
            result.append(
                self.exeHead.format("@a[scores={" + scoreboardname + "=1..}]")
                + "scoreboard players operation @s {} = @s {}".format(
                    sbnpc + "PercT", scoreboardname
                )
            )
            result.append(
                self.exeHead.format("@a[scores={" + scoreboardname + "=1..}]")
                + "scoreboard players operation @s {} *= n100 {}".format(
                    sbnpc + "PercT", scoreboardname
                )
            )
            result.append(
                self.exeHead.format("@a[scores={" + scoreboardname + "=1..}]")
                + "scoreboard players operation @s {} /= MaxScore {}".format(
                    sbnpc + "PercT", scoreboardname
                )
            )

        if r"%%t" in pgsstyle:
            result.append(
                "scoreboard objectives add {}TMinT dummy \"时间计算：分\"".format(sbnpc)
            )
            result.append(
                "scoreboard objectives add {}TSecT dummy \"时间计算：秒\"".format(sbnpc)
            )
            result.append(
                self.exeHead.format("@a[scores={" + scoreboardname + "=1..}]")
                + "scoreboard players set n20 {} 20".format(scoreboardname)
            )
            result.append(
                self.exeHead.format("@a[scores={" + scoreboardname + "=1..}]")
                + "scoreboard players set n60 {} 60".format(scoreboardname)
            )

            result.append(
                self.exeHead.format("@a[scores={" + scoreboardname + "=1..}]")
                + "scoreboard players operation @s {} = @s {}".format(
                    sbnpc + "TMinT", scoreboardname
                )
            )
            result.append(
                self.exeHead.format("@a[scores={" + scoreboardname + "=1..}]")
                + "scoreboard players operation @s {} /= n20 {}".format(
                    sbnpc + "TMinT", scoreboardname
                )
            )
            result.append(
                self.exeHead.format("@a[scores={" + scoreboardname + "=1..}]")
                + "scoreboard players operation @s {} /= n60 {}".format(
                    sbnpc + "TMinT", scoreboardname
                )
            )

            result.append(
                self.exeHead.format("@a[scores={" + scoreboardname + "=1..}]")
                + "scoreboard players operation @s {} = @s {}".format(
                    sbnpc + "TSecT", scoreboardname
                )
            )
            result.append(
                self.exeHead.format("@a[scores={" + scoreboardname + "=1..}]")
                + "scoreboard players operation @s {} /= n20 {}".format(
                    sbnpc + "TSecT", scoreboardname
                )
            )
            result.append(
                self.exeHead.format("@a[scores={" + scoreboardname + "=1..}]")
                + "scoreboard players operation @s {} %= n60 {}".format(
                    sbnpc + "TSecT", scoreboardname
                )
            )

        for i in range(pgsstyle.count('_')):
            npgstl = (
                replaceBar(i).replace(r"%%N", self.midFileName)
                if r"%%N" in pgsstyle
                else replaceBar(i)
            )
            if r"%%s" in npgstl:
                npgstl = npgstl.replace(
                    r"%%s",
                    '"},{"score":{"name":"*","objective":"'
                    + scoreboardname
                    + '"}},{"text":"',
                )
            if r"%%%" in npgstl:
                npgstl = npgstl.replace(
                    r"%%%",
                    '"},{"score":{"name":"*","objective":"'
                    + sbnpc
                    + 'PercT"}},{"text":"%',
                )
            if r"%%t" in npgstl:
                npgstl = npgstl.replace(
                    r"%%t",
                    r'"},{"score":{"name":"*","objective":"{-}TMinT"}},{"text":":"},{"score":{"name":"*","objective":"{-}TSecT"}},{"text":"'.replace(
                        r"{-}", sbnpc
                    ),
                )
            result.append(
                self.exeHead.format(
                    "@a[scores={"
                    + scoreboardname
                    + f"={int(i * perEach)}..{math.ceil((i + 1) * perEach)}"
                    + "}]"
                )
                + r'titleraw @s actionbar {"rawtext":[{"text":"'
                + npgstl
                + r'"}]}'
            )

        if r"%%%" in pgsstyle:
            result.append("scoreboard objectives remove {}PercT".format(sbnpc))
        if r"%%t" in pgsstyle:
            result.append("scoreboard objectives remove {}TMinT".format(sbnpc))
            result.append("scoreboard objectives remove {}TSecT".format(sbnpc))

        return result

    def _toCmdList_m1(
        self, scoreboardname: str = "mscplay", volume: float = 1.0, speed: float = 1.0
    ) -> list:
        """
        使用Dislink Sforza的转换思路，将midi转换为我的世界命令列表
        :param scoreboardname: 我的世界的计分板名称
        :param volume: 音量，注意：这里的音量范围为(0,1]，如果超出将被处理为正确值，其原理为在距离玩家 (1 / volume -1) 的地方播放音频
        :param speed: 速度，注意：这里的速度指的是播放倍率，其原理为在播放音频的时候，每个音符的播放时间除以 speed
        :return: tuple(命令列表, 命令个数, 计分板最大值)
        """
        tracks = []
        if volume > 1:
            volume = 1
        if volume <= 0:
            volume = 0.001

        commands = 0
        maxscore = 0

        # 分轨的思路其实并不好，但这个算法就是这样
        # 所以我建议用第二个方法 _toCmdList_m2
        for i, track in enumerate(self.midi.tracks):

            ticks = 0
            instrumentID = 0
            singleTrack = []

            for msg in track:
                ticks += msg.time
                if msg.is_meta:
                    if msg.type == "set_tempo":
                        tempo = msg.tempo
                else:
                    if msg.type == "program_change":
                        instrumentID = msg.program

                    if msg.type == "note_on" and msg.velocity != 0:
                        try:
                            nowscore = round(
                                (ticks * tempo)
                                / ((self.midi.ticks_per_beat * float(speed)) * 50000)
                            )
                        except NameError:
                            raise NotDefineTempoError("计算当前分数时出错 未定义参量 Tempo")
                        maxscore = max(maxscore, nowscore)
                        if msg.channel == 9:
                            soundID, _X = self.__bitInst2IDwithX(instrumentID)
                        else:
                            soundID, _X = self.__Inst2soundIDwithX(instrumentID)

                        singleTrack.append(
                            "execute @a[scores={"
                            + str(scoreboardname)
                            + "="
                            + str(nowscore)
                            + "}"
                            + f"] ~ ~ ~ playsound {soundID} @s ^ ^ ^{1 / volume - 1} {msg.velocity/128} {2 ** ((msg.note - 60 - _X) / 12)}"
                        )
                        commands += 1
            if len(singleTrack) != 0:
                tracks.append(singleTrack)

        return [tracks, commands, maxscore]

    # 原本这个算法的转换效果应该和上面的算法相似的
    def _toCmdList_m2(
        self,
        scoreboardname: str = "mscplay",
        MaxVolume: float = 1.0,
        speed: float = 1.0,
    ) -> list:
        """
        使用金羿的转换思路，将midi转换为我的世界命令列表
        :param scoreboardname: 我的世界的计分板名称
        :param MaxVolume: 音量，注意：这里的音量范围为(0,1]，如果超出将被处理为正确值，其原理为在距离玩家 (1 / volume -1) 的地方播放音频
        :param speed: 速度，注意：这里的速度指的是播放倍率，其原理为在播放音频的时候，每个音符的播放时间除以 speed
        :return: tuple(命令列表, 命令个数, 计分板最大值)
        """

        MaxVolume = 1 if MaxVolume > 1 else (0.001 if MaxVolume <= 0 else MaxVolume)

        # 一个midi中仅有16通道 我们通过通道来识别而不是音轨
        channels = [[], [], [], [], [], [], [], [], [], [], [], [], [], [], [], []]

        microseconds = 0

        # 我们来用通道统计音乐信息
        for msg in self.midi:

            if msg.time != 0:
                try:
                    microseconds += msg.time * tempo / self.midi.ticks_per_beat
                    # print(microseconds)
                except NameError:
                    raise NotDefineTempoError("计算当前分数时出错 未定义参量 Tempo")

            if msg.is_meta:
                if msg.type == "set_tempo":
                    tempo = msg.tempo
                    if self.debugMode:
                        self.prt(f"TEMPO更改：{tempo}（毫秒每拍）")
            else:

                try:
                    msg.channel
                    channelMsg = True
                except:
                    channelMsg = False
                if channelMsg:
                    if msg.channel > 15:
                        raise ChannelOverFlowError(f"当前消息 {msg} 的通道超限(≤15)")

                if msg.type == "program_change":
                    channels[msg.channel].append(("PgmC", msg.program, microseconds))

                elif msg.type == "note_on" and msg.velocity != 0:
                    channels[msg.channel].append(
                        ("NoteS", msg.note, msg.velocity, microseconds)
                    )

                elif (msg.type == "note_on" and msg.velocity == 0) or (
                    msg.type == "note_off"
                ):
                    channels[msg.channel].append(("NoteE", msg.note, microseconds))
    
        """整合后的音乐通道格式
        每个通道包括若干消息元素其中逃不过这三种：

        1 切换乐器消息
        ("PgmC", 切换后的乐器ID: int, 距离演奏开始的毫秒)

        2 音符开始消息
        ("NoteS", 开始的音符ID, 力度（响度）, 距离演奏开始的毫秒)

        3 音符结束消息
        ("NoteS", 结束的音符ID, 距离演奏开始的毫秒)"""

        if self.debugMode:
            self.prt(dict(enumerate(channels)))

        tracks = []
        cmdAmount = 0
        maxScore = 0

        # 此处 我们把通道视为音轨
        for i in range(len(channels)):
            # 如果当前通道为空 则跳过
            if not channels[i]:
                continue

            if i == 9:
                SpecialBits = True
            else:
                SpecialBits = False

            nowTrack = []

            for msg in channels[i]:

                if msg[0] == "PgmC":
                    InstID = msg[1]

                elif msg[0] == "NoteS":
                    try:
                        soundID, _X = (self.__bitInst2IDwithX(InstID) if SpecialBits else self.__Inst2soundIDwithX(InstID))
                    except UnboundLocalError as E:
                        if self.debugMode:
                            raise NotDefineProgramError(f"未定义乐器便提前演奏。\n{E}")
                        else:
                            soundID, _X = (self.__bitInst2IDwithX(-1) if SpecialBits else self.__Inst2soundIDwithX(-1))
                    score_now = round(msg[-1] / float(speed) / 50)
                    maxScore = max(maxScore, score_now)

                    nowTrack.append(
                        self.exeHead.format(
                            "@a[scores=({}={})]".format(scoreboardname, score_now)
                            .replace('(', r"{")
                            .replace(")", r"}")
                        )
                        + f"playsound {soundID} @s ^ ^ ^{1 / MaxVolume - 1} {msg[2]/128} {2 ** ((msg[1] - 60 - _X) / 12)}"
                    )

                    cmdAmount += 1

            tracks.append(nowTrack)

        return [tracks, cmdAmount, maxScore]

    # 简单的单音填充
    def _toCmdList_m3(
        self,
        scoreboardname: str = "mscplay",
        MaxVolume: float = 1.0,
        speed: float = 1.0,
    ) -> list:
        """
        使用金羿的转换思路，将midi转换为我的世界命令列表，并使用完全填充算法优化音感
        :param scoreboardname: 我的世界的计分板名称
        :param MaxVolume: 音量，注意：这里的音量范围为(0,1]，如果超出将被处理为正确值，其原理为在距离玩家 (1 / volume -1) 的地方播放音频
        :param speed: 速度，注意：这里的速度指的是播放倍率，其原理为在播放音频的时候，每个音符的播放时间除以 speed
        :return: tuple(命令列表, 命令个数, 计分板最大值)
        """

        if MaxVolume > 1:
            MaxVolume = 1.0
        if MaxVolume <= 0:
            MaxVolume = 0.001

        # 一个midi中仅有16通道 我们通过通道来识别而不是音轨
        channels = [[], [], [], [], [], [], [], [], [], [], [], [], [], [], [], []]

        # 我们来用通道统计音乐信息
        for i, track in enumerate(self.midi.tracks):

            microseconds = 0

            for msg in track:

                if msg.time != 0:
                    try:
                        microseconds += msg.time * tempo / self.midi.ticks_per_beat
                    except NameError:
                        raise NotDefineTempoError("计算当前分数时出错 未定义参量 Tempo")

                if msg.is_meta:
                    if msg.type == "set_tempo":
                        tempo = msg.tempo
                else:

                    try:
                        msg.channel
                        channelMsg = True
                    except:
                        channelMsg = False
                    if channelMsg:
                        if msg.channel > 15:
                            raise ChannelOverFlowError(f"当前消息 {msg} 的通道超限(≤15)")

                    if msg.type == "program_change":
                        channels[msg.channel].append(
                            ("PgmC", msg.program, microseconds)
                        )

                    elif msg.type == "note_on" and msg.velocity != 0:
                        channels[msg.channel].append(
                            ("NoteS", msg.note, msg.velocity, microseconds)
                        )

                    elif (msg.type == "note_on" and msg.velocity == 0) or (
                        msg.type == "note_off"
                    ):
                        channels[msg.channel].append(("NoteE", msg.note, microseconds))

        """整合后的音乐通道格式
        每个通道包括若干消息元素其中逃不过这三种：

        1 切换乐器消息

        ("PgmC", 切换后的乐器ID: int, 距离演奏开始的毫秒)

        2 音符开始消息

        ("NoteS", 开始的音符ID, 力度（响度）, 距离演奏开始的毫秒)

        3 音符结束消息

        ("NoteS", 结束的音符ID, 距离演奏开始的毫秒)"""

        note_channels = [[], [], [], [], [], [], [], [], [], [], [], [], [], [], [], []]

        # 此处 我们把通道视为音轨
        for i in range(len(channels)):
            # 如果当前通道为空 则跳过

            noteMsgs = []
            MsgIndex = []

            for msg in channels[i]:

                if msg[0] == "PgmC":
                    InstID = msg[1]

                elif msg[0] == "NoteS":
                    noteMsgs.append(msg[1:])
                    MsgIndex.append(msg[1])

                elif msg[0] == "NoteE":
                    if msg[1] in MsgIndex:
                        note_channels[i].append(
                            SingleNote(
                                InstID,
                                msg[1],
                                noteMsgs[MsgIndex.index(msg[1])][1],
                                noteMsgs[MsgIndex.index(msg[1])][2],
                                msg[-1] - noteMsgs[MsgIndex.index(msg[1])][2],
                            )
                        )
                        noteMsgs.pop(MsgIndex.index(msg[1]))
                        MsgIndex.pop(MsgIndex.index(msg[1]))

        tracks = []
        cmdAmount = 0
        maxScore = 0
        CheckFirstChannel = False

        # 临时用的插值计算函数
        def _linearFun(note: SingleNote) -> list:
            '''传入音符数据，返回以半秒为分割的插值列表
            :param note: SingleNote 音符
            :return list[tuple(int开始时间（毫秒）, int乐器, int音符, int力度（内置）, float音量（播放）),]'''

            result = []

            totalCount = int(note.lastTime / 500)

            for i in range(totalCount):
                result.append(
                    (
                        note.startTime + i * 500,
                        note.instrument,
                        note.pitch,
                        note.velocity,
                        MaxVolume * ((totalCount - i) / totalCount),
                    )
                )

            return result

        # 此处 我们把通道视为音轨
        for track in note_channels:
            # 如果当前通道为空 则跳过
            if not track:
                continue

            if note_channels.index(track) == 0:
                CheckFirstChannel = True
                SpecialBits = False
            elif note_channels.index(track) == 9:
                SpecialBits = True
            else:
                CheckFirstChannel = False
                SpecialBits = False

            nowTrack = []

            for note in track:

                for everynote in _linearFun(note):
                    # 应该是计算的时候出了点小问题
                    # 我们应该用一个MC帧作为时间单位而不是半秒

                    if SpecialBits:
                        soundID, _X = self.__bitInst2IDwithX(InstID)
                    else:
                        soundID, _X = self.__Inst2soundIDwithX(InstID)

                    score_now = round(everynote[0] / speed / 50000)

                    maxScore = max(maxScore, score_now)

                    nowTrack.append(
                        "execute @a[scores={"
                        + str(scoreboardname)
                        + "="
                        + str(score_now)
                        + "}"
                        + f"] ~ ~ ~ playsound {soundID} @s ~ ~{1 / everynote[4] - 1} ~ {note.velocity * (0.7 if CheckFirstChannel else 0.9)} {2 ** ((note.pitch - 60 - _X) / 12)}"
                    )

                    cmdAmount += 1
            tracks.append(nowTrack)

        return [tracks, cmdAmount, maxScore]

    def _toCmdList_withDelay_m1(
        self,
        volume: float = 1.0,
        speed: float = 1.0,
        player: str = "@a",
        # isMixedWithPrograssBar=False,
    ) -> list:
        """
        使用Dislink Sforza的转换思路，将midi转换为我的世界命令列表，并输出每个音符之后的延迟
        :param volume: 音量，注意：这里的音量范围为(0,1]，如果超出将被处理为正确值，其原理为在距离玩家 (1 / volume -1) 的地方播放音频
        :param speed: 速度，注意：这里的速度指的是播放倍率，其原理为在播放音频的时候，每个音符的播放时间除以 speed
        :param player: 玩家选择器，默认为`@a`
        :param isMixedWithPrograssBar: 进度条，（当此参数为True时使用默认进度条，当此参数为其他值为真的表达式时识别为进度条自定义参数，若为其他值为假的表达式则不生成进度条）
        :return: 全部指令列表[ ( str指令, int距离上一个指令的延迟 ),...]
        """
        tracks = {}

        if volume > 1:
            volume = 1
        if volume <= 0:
            volume = 0.001

        # 此处是对于仅有 True 的参数和自定义参数的判断
        # if isMixedWithPrograssBar == True:
        #     isMixedWithPrograssBar = (
        #         r"▶ %%N [ %%s/%^s %%% __________ %%t|%^t ]",
        #         ("§e=§r", "§7=§r"),
        #     )

        for i, track in enumerate(self.midi.tracks):

            instrumentID = 0
            ticks = 0

            for msg in track:
                ticks += msg.time
                if msg.is_meta:
                    if msg.type == "set_tempo":
                        tempo = msg.tempo
                else:
                    if msg.type == "program_change":
                        instrumentID = msg.program
                    if msg.type == "note_on" and msg.velocity != 0:
                        nowtick = round(
                            (ticks * tempo)
                            / ((self.midi.ticks_per_beat * float(speed)) * 50000)
                        )
                        soundID, _X = self.__Inst2soundIDwithX(instrumentID)
                        try:
                            tracks[nowtick].append(
                                f"execute {player} ~ ~ ~ playsound {soundID} @s ~ ~{1 / volume - 1} ~ {msg.velocity * (0.7 if msg.channel == 0 else 0.9)} {2 ** ((msg.note - 60 - _X) / 12)}"
                            )
                        except BaseException:
                            tracks[nowtick] = [
                                f"execute {player} ~ ~ ~ playsound {soundID} @s ~ ~{1 / volume - 1} ~ {msg.velocity * (0.7 if msg.channel == 0 else 0.9)} {2 ** ((msg.note - 60 - _X) / 12)}",
                            ]

        results = []

        allticks = list(tracks.keys())
        # if isMixedWithPrograssBar:
        #     results.append("scoreboard objectives add {}")

        for i in range(len(allticks)):
            if i != 0:
                for j in range(len(tracks[allticks[i]])):
                    if j != 0:
                        results.append((tracks[allticks[i]][j], 0))
                    else:
                        results.append(
                            (tracks[allticks[i]][j], allticks[i] - allticks[i - 1])
                        )
            else:
                for j in range(len(tracks[allticks[i]])):
                    results.append((tracks[allticks[i]][j], allticks[i]))

        return results, max(allticks)

    def tomcpack(
        self,
        method: int = 1,
        volume: float = 1.0,
        speed: float = 1.0,
        progressbar=None,
        scoreboardname: str = "mscplay",
        isAutoReset: bool = False,
    ) -> tuple:
        """
        使用method指定的转换算法，将midi转换为我的世界mcpack格式的包
        :param method: 转换算法
        :param isAutoReset: 是否自动重置计分板
        :param progressbar: 进度条，（当此参数为True时使用默认进度条，为其他的值为真的参数时识别为进度条自定义参数，为其他值为假的时候不生成进度条）
        :param scoreboardname: 我的世界的计分板名称
        :param volume: 音量，注意：这里的音量范围为(0,1]，其原理为在距离玩家 (1 / volume -1) 的地方播放音频
        :param speed: 速度，注意：这里的速度指的是播放倍率，其原理为在播放音频的时候，每个音符的播放时间除以 speed
        :return 成功与否，成功返回(True,True)，失败返回(False,str失败原因)
        """

        # try:
        cmdlist, maxlen, maxscore = self.methods[method - 1](
            scoreboardname, volume, speed
        )
        # except:
        #     return (False, f"无法找到算法ID{method}对应的转换算法")

        # 当文件f夹{self.outputPath}/temp/functions存在时清空其下所有项目，然后创建
        if os.path.exists(f"{self.outputPath}/temp/functions/"):
            shutil.rmtree(f"{self.outputPath}/temp/functions/")
        os.makedirs(f"{self.outputPath}/temp/functions/mscplay")

        # 写入manifest.json
        if not os.path.exists(f"{self.outputPath}/temp/manifest.json"):
            with open(
                f"{self.outputPath}/temp/manifest.json", "w", encoding="utf-8"
            ) as f:
                f.write(
                    '{\n  "format_version": 1,\n  "header": {\n    "description": "'
                    + self.midFileName
                    + ' Pack : behavior pack",\n    "version": [ 0, 0, 1 ],\n    "name": "'
                    + self.midFileName
                    + 'Pack",\n    "uuid": "'
                    + str(uuid.uuid4())
                    + '"\n  },\n  "modules": [\n    {\n      "description": "'
                    + f"the Player of the Music {self.midFileName}"
                    + '",\n      "type": "data",\n      "version": [ 0, 0, 1 ],\n      "uuid": "'
                    + str(uuid.uuid4())
                    + '"\n    }\n  ]\n}'
                )
        else:
            with open(
                f"{self.outputPath}/temp/manifest.json", "r", encoding="utf-8"
            ) as manifest:
                data = json.loads(manifest.read())
                data["header"][
                    "description"
                ] = f"the Player of the Music {self.midFileName}"
                data["header"]["name"] = self.midFileName
                data["header"]["uuid"] = str(uuid.uuid4())
                data["modules"][0]["description"] = "None"
                data["modules"][0]["uuid"] = str(uuid.uuid4())
                manifest.close()
            open(f"{self.outputPath}/temp/manifest.json", "w", encoding="utf-8").write(
                json.dumps(data)
            )

        # 将命令列表写入文件
        indexfile = open(
            f"{self.outputPath}/temp/functions/index.mcfunction", "w", encoding="utf-8"
        )
        for track in cmdlist:
            indexfile.write(
                "function mscplay/track" + str(cmdlist.index(track) + 1) + "\n"
            )
            with open(
                f"{self.outputPath}/temp/functions/mscplay/track{cmdlist.index(track) + 1}.mcfunction",
                "w",
                encoding="utf-8",
            ) as f:
                f.write("\n".join(track))
        indexfile.writelines(
            (
                "scoreboard players add @a[scores={"
                + scoreboardname
                + "=1..}] "
                + scoreboardname
                + " 1\n",
                (
                    "scoreboard players reset @a[scores={"
                    + scoreboardname
                    + "="
                    + str(maxscore + 20)
                    + "..}]"
                    + f" {scoreboardname}\n"
                )
                if isAutoReset
                else "",
                f"function mscplay/progressShow\n" if progressbar else "",
            )
        )

        if progressbar:
            if progressbar:
                with open(
                    f"{self.outputPath}/temp/functions/mscplay/progressShow.mcfunction",
                    "w",
                    encoding="utf-8",
                ) as f:
                    f.writelines(
                        "\n".join(self.__formProgressBar(maxscore, scoreboardname))
                    )
            else:
                with open(
                    f"{self.outputPath}/temp/functions/mscplay/progressShow.mcfunction",
                    "w",
                    encoding="utf-8",
                ) as f:
                    f.writelines(
                        "\n".join(
                            self.__formProgressBar(
                                maxscore, scoreboardname, progressbar
                            )
                        )
                    )

        indexfile.close()

        if os.path.exists(f"{self.outputPath}/{self.midFileName}.mcpack"):
            os.remove(f"{self.outputPath}/{self.midFileName}.mcpack")
        makeZip(
            f"{self.outputPath}/temp/", f"{self.outputPath}/{self.midFileName}.mcpack"
        )

        shutil.rmtree(f"{self.outputPath}/temp/")

        return (True, maxlen, maxscore)

    def toBDXfile(
        self,
        method: int = 1,
        volume: float = 1.0,
        speed: float = 1.0,
        progressbar=False,
        scoreboardname: str = "mscplay",
        isAutoReset: bool = False,
        author: str = "Eilles",
        maxheight: int = 64,
    ):
        """
        使用method指定的转换算法，将midi转换为BDX结构文件
        :param method: 转换算法
        :param author: 作者名称
        :param progressbar: 进度条，（当此参数为True时使用默认进度条，为其他的值为真的参数时识别为进度条自定义参数，为其他值为假的时候不生成进度条）
        :param maxheight: 生成结构最大高度
        :param scoreboardname: 我的世界的计分板名称
        :param volume: 音量，注意：这里的音量范围为(0,1]，如果超出将被处理为正确值，其原理为在距离玩家 (1 / volume -1) 的地方播放音频
        :param speed: 速度，注意：这里的速度指的是播放倍率，其原理为在播放音频的时候，每个音符的播放时间除以 speed
        :param isAutoReset: 是否自动重置计分板
        :return 成功与否，成功返回(True,未经过压缩的源,结构占用大小)，失败返回(False,str失败原因)
        """
        # try:
        cmdlist, totalcount, maxScore = self.methods[method - 1](
            scoreboardname, volume, speed
        )
        # except Exception as E:
        #     return (False, f"无法找到算法ID{method}对应的转换算法: {E}")

        if not os.path.exists(self.outputPath):
            os.makedirs(self.outputPath)

        with open(
            os.path.abspath(os.path.join(self.outputPath, f"{self.midFileName}.bdx")),
            "w+",
        ) as f:
            f.write("BD@")

        _bytes = (
            b"BDX\x00"
            + author.encode("utf-8")
            + b" & Musicreater\x00\x01command_block\x00"
        )

        commands = []

        for track in cmdlist:
            commands += track

        if isAutoReset:
            commands.append(
                "scoreboard players reset @a[scores={"
                + scoreboardname
                + "="
                + str(maxScore + 20)
                + "}] "
                + scoreboardname,
            )

        cmdBytes, size, finalPos = toBDXbytes([(i,0)for i in commands], maxheight - 1)
        # 此处是对于仅有 True 的参数和自定义参数的判断
        if progressbar:
            pgbBytes, pgbSize, pgbNowPos = toBDXbytes(
                [
                    (i, 0)
                    for i in (
                        self.__formProgressBar(maxScore, scoreboardname)
                        if progressbar == True
                        else self.__formProgressBar(
                            maxScore, scoreboardname, progressbar
                        )
                    )
                ],
                maxheight - 1,
            )
            _bytes += pgbBytes
            _bytes += move(y, -pgbNowPos[1])
            _bytes += move(z, -pgbNowPos[2])
            _bytes += move(x, 2)

            size[0] += 2 + pgbSize[0]
            size[1] = max(size[1], pgbSize[1])
            size[2] = max(size[2], pgbSize[2])

        _bytes += cmdBytes

        with open(
            os.path.abspath(os.path.join(self.outputPath, f"{self.midFileName}.bdx")),
            "ab+",
        ) as f:
            f.write(brotli.compress(_bytes + b"XE"))

        return (True, totalcount, maxScore, size, finalPos)

    def toBDXfile_withDelay(
        self,
        method: int = 1,
        volume: float = 1.0,
        speed: float = 1.0,
        progressbar=False,
        player: str = "@a",
        author: str = "Eilles",
        maxheight: int = 64,
    ):
        """
        使用method指定的转换算法，将midi转换为BDX结构文件
        :param method: 转换算法
        :param author: 作者名称
        :param progressbar: 进度条，（当此参数为True时使用默认进度条，为其他的值为真的参数时识别为进度条自定义参数，为其他值为假的时候不生成进度条）
        :param maxheight: 生成结构最大高度
        :param volume: 音量，注意：这里的音量范围为(0,1]，如果超出将被处理为正确值，其原理为在距离玩家 (1 / volume -1) 的地方播放音频
        :param speed: 速度，注意：这里的速度指的是播放倍率，其原理为在播放音频的时候，每个音符的播放时间除以 speed
        :param player: 玩家选择器，默认为`@a`
        :return 成功与否，成功返回(True,未经过压缩的源,结构占用大小)，失败返回(False,str失败原因)
        """

        # try:
        cmdlist, maxdelay = self.methods_byDelay[method - 1](
            volume,
            speed,
            player,
        )
        # except Exception as E:
        #     return (False, f"无法找到算法ID{method}对应的转换算法\n{E}")

        if not os.path.exists(self.outputPath):
            os.makedirs(self.outputPath)

        with open(
            os.path.abspath(os.path.join(self.outputPath, f"{self.midFileName}.bdx")),
            "w+",
        ) as f:
            f.write("BD@")

        _bytes = (
            b"BDX\x00"
            + author.encode("utf-8")
            + b" & Musicreater\x00\x01command_block\x00"
        )

        # 此处是对于仅有 True 的参数和自定义参数的判断
        if progressbar == True:
            progressbar = (
                r"▶ %%N [ %%s/%^s %%% __________ %%t|%^t ]",
                ("§e=§r", "§7=§r"),
            )

        cmdBytes, size, finalPos = toBDXbytes(cmdlist, maxheight - 1)

        if progressbar:
            scbname = self.midFileName[:5] + "Pgb"
            _bytes += formCMDblk(
                r"scoreboard objectives add {} dummy {}播放用".replace(r"{}", scbname),
                1,
                customName="初始化进度条",
            )
            _bytes += move(z, 2)
            _bytes += formCMDblk(
                r"scoreboard players add {} {} 1".format(player, scbname),
                1,
                1,
                customName="显示进度条并加分",
            )
            _bytes += move(y, 1)
            pgbBytes, pgbSize, pgbNowPos = toBDXbytes(
                [
                    (i, 0)
                    for i in self.__formProgressBar(maxdelay, scbname, progressbar)
                ],
                maxheight - 1,
            )
            _bytes += pgbBytes
            _bytes += move(y, -1 - pgbNowPos[1])
            _bytes += move(z, -2 - pgbNowPos[2])
            _bytes += move(x, 2)
            _bytes += formCMDblk(
                r"scoreboard players reset {} {}".format(player, scbname),
                1,
                customName="置零进度条",
            )
            _bytes += move(y, 1)
            size[0] += 2 + pgbSize[0]
            size[1] = max(size[1], pgbSize[1])
            size[2] = max(size[2], pgbSize[2])

        size[1] += 1
        _bytes += cmdBytes

        with open(
            os.path.abspath(os.path.join(self.outputPath, f"{self.midFileName}.bdx")),
            "ab+",
        ) as f:
            f.write(brotli.compress(_bytes + b"XE"))

        return (True, len(cmdlist), maxdelay, size, finalPos)


    def toDICT(
        self,
    ) -> list:
        """
        使用金羿的转换思路，将midi转换为字典
        :return: dict()
        """

        # 一个midi中仅有16通道 我们通过通道来识别而不是音轨
        channels = [[], [], [], [], [], [], [], [], [], [], [], [], [], [], [], []]
        microseconds = 0

        # 我们来用通道统计音乐信息
        for msg in self.midi:

            if msg.time != 0:
                try:
                    microseconds += msg.time * tempo / self.midi.ticks_per_beat
                    # print(microseconds)
                except NameError:
                    raise NotDefineTempoError("计算当前分数时出错 未定义参量 Tempo")

            if msg.is_meta:
                if msg.type == "set_tempo":
                    tempo = msg.tempo
            else:

                try:
                    msg.channel
                    channelMsg = True
                except:
                    channelMsg = False
                if channelMsg:
                    if msg.channel > 15:
                        raise ChannelOverFlowError(f"当前消息 {msg} 的通道超限(≤15)")

                if msg.type == "program_change":
                    channels[msg.channel].append(("PgmC", msg.program, microseconds))

                elif msg.type == "note_on" and msg.velocity != 0:
                    channels[msg.channel].append(
                        ("NoteS", msg.note, msg.velocity, microseconds)
                    )

                elif (msg.type == "note_on" and msg.velocity == 0) or (
                    msg.type == "note_off"
                ):
                    channels[msg.channel].append(("NoteE", msg.note, microseconds))
    
        """整合后的音乐通道格式
        每个通道包括若干消息元素其中逃不过这三种：

        1 切换乐器消息
        ("PgmC", 切换后的乐器ID: int, 距离演奏开始的毫秒)

        2 音符开始消息
        ("NoteS", 开始的音符ID, 力度（响度）, 距离演奏开始的毫秒)

        3 音符结束消息
        ("NoteS", 结束的音符ID, 距离演奏开始的毫秒)"""

        return dict(enumerate(channels))