DryWetMIDI 开源项目教程

DryWetMIDI 开源项目教程

drywetmidi .NET library to read, write, process MIDI files and to work with MIDI devices 项目地址: https://gitcode.com/gh_mirrors/dr/drywetmidi

1. 项目介绍

DryWetMIDI 是一个用于处理 MIDI 文件和 MIDI 设备的 .NET 库。它提供了丰富的功能，包括读取、写入和创建标准 MIDI 文件（SMF），处理 RMID 文件（SMF 封装在 RIFF 块中），以及与 MIDI 设备的交互。DryWetMIDI 还支持高级功能，如音乐理论 API、量化、音符分割和 MIDI 文件到 CSV 的转换。

2. 项目快速启动

2.1 安装

首先，通过 NuGet 安装 DryWetMIDI：

dotnet add package DryWetMidi

2.2 读取 MIDI 文件

使用 MidiFile.Read 方法读取 MIDI 文件：

using Melanchall.DryWetMidi.Core;

var midiFile = MidiFile.Read("SomeGreatSong.mid");

2.3 写入 MIDI 文件

使用 MidiFile.Write 方法将 MIDI 数据写入文件：

midiFile.Write("MyGreatSong.mid");

2.4 创建 MIDI 文件

从零开始创建一个 MIDI 文件：

var midiFile = new MidiFile(
    new TrackChunk(
        new SetTempoEvent(500000),
        new TextEvent("It's just a single note track."),
        new NoteOnEvent((SevenBitNumber)60, (SevenBitNumber)45),
        new NoteOffEvent((SevenBitNumber)60, (SevenBitNumber)0) { DeltaTime = 400 }
    )
);

midiFile.Write("MyFutureGreatSong.mid");

3. 应用案例和最佳实践

3.1 加速 MIDI 文件播放

通过修改 SetTempoEvent 来加速 MIDI 文件的播放：

foreach (var trackChunk in midiFile.Chunks.OfType<TrackChunk>())
{
    foreach (var setTempoEvent in trackChunk.Events.OfType<SetTempoEvent>())
    {
        setTempoEvent.MicrosecondsPerQuarterNote /= 2;
    }
}

3.2 获取 MIDI 文件的持续时间

使用 GetDuration 方法获取 MIDI 文件的持续时间：

TimeSpan midiFileDuration = midiFile.GetDuration<MetricTimeSpan>();

3.3 移除 MIDI 文件中的特定音符

移除所有 C# 音符：

midiFile.RemoveNotes(n => n.NoteName == NoteName.CSharp);

4. 典型生态项目

4.1 EMU - Sound to Light Controller

EMU 是一个专业的声音到灯光控制器，适用于现场音乐家和 DJ。它使用 DryWetMIDI 来处理 MIDI 数据，实现自动化的灯光效果。

4.2 Musical Bits

Musical Bits 开发了使用 DryWetMIDI 的音乐创作软件，帮助用户创建音乐，包括鼓声、节奏、吉他、背景合唱等。

4.3 CoyoteMIDI

CoyoteMIDI 扩展了 MIDI 设备的功能，使其能够处理键盘和鼠标输入，包括复杂的按键组合和多步骤宏。

4.4 Clone Hero

Clone Hero 是一个免费的节奏游戏，使用 DryWetMIDI 处理 MIDI 文件，支持任何 5 或 6 键的吉他控制器、游戏控制器或标准键盘。

通过这些应用案例，可以看到 DryWetMIDI 在音乐创作、游戏开发和现场表演等多个领域的广泛应用。

drywetmidi .NET library to read, write, process MIDI files and to work with MIDI devices 项目地址: https://gitcode.com/gh_mirrors/dr/drywetmidi