< Summary

Information
Class: MusicTheory.Theory.Midi.MidiFileWriter
Assembly: MusicTheory
File(s): /home/runner/work/MusicTheory/MusicTheory/Theory/Midi/MidiFileWriter.cs
Line coverage
95%
Covered lines: 126
Uncovered lines: 6
Coverable lines: 132
Total lines: 281
Line coverage: 95.4%
Branch coverage
92%
Covered branches: 92
Total branches: 100
Branch coverage: 92%
Method coverage

Feature is only available for sponsors

Upgrade to PRO version

Metrics

MethodBranch coverage Crap Score Cyclomatic complexity Line coverage
WriteSingleTrack(...)100%3434100%
WriteMultipleTracks(...)95.83%2424100%
BuildTrackChunk(...)81.25%383281.81%
BuildTextMeta(...)50%22100%
WriteVarLen(...)100%44100%
RemoveMetaInternal(...)100%44100%

File(s)

/home/runner/work/MusicTheory/MusicTheory/Theory/Midi/MidiFileWriter.cs

#LineLine coverage
 1using System;
 2using System.Collections.Generic;
 3using System.IO;
 4using System.Linq;
 5using MusicTheory.Theory.Time;
 6
 7namespace MusicTheory.Theory.Midi;
 8
 9/// <summary>
 10/// シンプルな SMF (Standard MIDI File) Writer。
 11/// Format0 (単一) と Format1 (複数同期トラック) をサポート。
 12/// 対応メタイベント: Tempo(FF51), TimeSignature(FF58), KeySignature(FF59), Text/Name/Marker (FF01/03/06)。
 13/// </summary>
 14public static class MidiFileWriter
 15{
 16    /// <summary>
 17    /// トラックを SMF format0 バイト列として書き出す。Tempo/TimeSignature メタイベントは track.MetaEvents から収集。
 18    /// </summary>
 19    public static byte[] WriteSingleTrack(MidiTrack track, int division = Duration.TicksPerQuarter, bool useRunningStatu
 20    {
 2021        if (division <= 0) throw new ArgumentOutOfRangeException(nameof(division));
 1822        track.Sort();
 1823        var events = new List<(long tick, byte[] data, bool channel)>();
 24
 25        // Meta events
 5626        foreach (var me in track.MetaEvents)
 27        {
 28            switch (me)
 29            {
 30                case TempoEvent te:
 31                    // FF 51 03 tttttt
 332                    int us = te.Tempo.MicrosecondsPerQuarter;
 333                    events.Add((te.Tick, new byte[]{0xFF,0x51,0x03,(byte)((us>>16)&0xFF),(byte)((us>>8)&0xFF),(byte)(us&
 334                    break;
 35                case TimeSignatureEvent tse:
 36                    // FF 58 04 nn dd cc bb
 337                    byte nn = (byte)tse.Signature.Numerator;
 38                    // dd = log2(denominator)
 339                    byte dd = (byte)Math.Log2(tse.Signature.Denominator);
 340                    byte cc = 24; // メトロノームクリック (デフォルト)
 341                    byte bb = 8;  // 32分音符数 (四分音符あたり)
 342                    events.Add((tse.Tick, new byte[]{0xFF,0x58,0x04, nn, dd, cc, bb}, false));
 343                    break;
 44                case KeySignatureEvent kse:
 45                    // FF 59 02 sf mi (sf=-7..7 flats/sharps, mi=0 major 1 minor)
 146                    sbyte sf = (sbyte)kse.SharpsFlats;
 147                    byte mi = (byte)(kse.IsMinor ? 1:0);
 148                    events.Add((kse.Tick, new byte[]{0xFF,0x59,0x02,(byte)sf, mi}, false));
 149                    break;
 50                case TextEvent txt:
 151                    events.Add((txt.Tick, BuildTextMeta(0x01, txt.Text), false));
 152                    break;
 53                case TrackNameEvent tname:
 154                    events.Add((tname.Tick, BuildTextMeta(0x03, tname.Name), false));
 155                    break;
 56                case MarkerEvent mark:
 157                    events.Add((mark.Tick, BuildTextMeta(0x06, mark.Label), false));
 58                    break;
 59            }
 60        }
 61
 62        // Note events
 12463        foreach (var ne in track.Notes)
 64        {
 4465            int statusBase = ne.IsNoteOn ? 0x90 : 0x80; // 0x9x / 0x8x
 4466            byte status = (byte)(statusBase | (ne.Channel & 0x0F));
 4467            byte pitch = (byte)Math.Clamp(ne.Pitch, 0, 127);
 4468            byte velocity = (byte)Math.Clamp(ne.Velocity, 0, 127);
 4469            events.Add((ne.Tick, new byte[]{status, pitch, velocity}, true));
 70        }
 71
 72        // End Of Track (tick = 最後のイベント tick と同じ or 0)
 7273        long endTick = events.Count > 0 ? events.Max(e => e.tick) : 0;
 1874        events.Add((endTick, new byte[]{0xFF,0x2F,0x00}, false));
 75
 12876        events.Sort((a,b)=> a.tick.CompareTo(b.tick));
 77
 1878        var trackData = new MemoryStream();
 1879        long prevTick = 0;
 1880        byte? lastStatus = null;
 18081        foreach (var ev in events)
 82        {
 7283            long delta = ev.tick - prevTick;
 7284            WriteVarLen(trackData, delta);
 7285            prevTick = ev.tick;
 7286            if (useRunningStatus && ev.channel)
 87            {
 2088                byte status = ev.data[0];
 2089                if (lastStatus.HasValue && lastStatus.Value == status)
 90                {
 91                    // omit status
 392                    trackData.Write(ev.data, 1, ev.data.Length-1);
 93                }
 94                else
 95                {
 1796                    trackData.Write(ev.data, 0, ev.data.Length);
 1797                    lastStatus = status;
 98                }
 99            }
 100            else
 101            {
 128102                trackData.Write(ev.data, 0, ev.data.Length); if (ev.channel) lastStatus = ev.data[0];
 103            }
 104        }
 105
 18106        byte[] trackBytes = trackData.ToArray();
 107
 108        // Header (MThd)
 18109        var ms = new MemoryStream();
 18110        using (var bw = new BinaryWriter(ms, System.Text.Encoding.ASCII, leaveOpen:true))
 111        {
 18112            bw.Write(new byte[]{(byte)'M',(byte)'T',(byte)'h',(byte)'d'});
 18113            bw.Write(BitConverter.GetBytes(System.Net.IPAddress.HostToNetworkOrder(6))); // length
 18114            bw.Write(BitConverter.GetBytes(System.Net.IPAddress.HostToNetworkOrder((short)0))); // format 0
 18115            bw.Write(BitConverter.GetBytes(System.Net.IPAddress.HostToNetworkOrder((short)1))); // ntrks=1
 18116            bw.Write(BitConverter.GetBytes(System.Net.IPAddress.HostToNetworkOrder((short)division))); // division
 117
 118            // Track chunk
 18119            bw.Write(new byte[]{(byte)'M',(byte)'T',(byte)'r',(byte)'k'});
 18120            bw.Write(BitConverter.GetBytes(System.Net.IPAddress.HostToNetworkOrder(trackBytes.Length)));
 18121            bw.Write(trackBytes);
 18122        }
 18123        return ms.ToArray();
 124    }
 125
 126    /// <summary>複数トラック (Format1)。各 MidiTrack は独立にソートされ、先頭テンポ/拍子は最初のトラック(インデックス0)に集約することを推奨。</summary>
 127    public static byte[] WriteMultipleTracks(IReadOnlyList<MidiTrack> tracks, int division = Duration.TicksPerQuarter, b
 128    {
 11129        if (tracks==null || tracks.Count==0) throw new ArgumentException("tracks empty");
 7130        if (consolidateConductor && tracks.Count>1)
 131        {
 132            // 先頭トラックに Tempo/TimeSig/KeySig を集約 (tick=0 のもの優先) し他トラックから除去
 5133            var primary = tracks[0];
 5134            var others = tracks.Skip(1);
 5135            var conductorTypes = new HashSet<Type>{ typeof(TempoEvent), typeof(TimeSignatureEvent), typeof(KeySignatureE
 20136            foreach (var ot in others)
 137            {
 9138                var moving = ot.MetaEvents.Where(m=>conductorTypes.Contains(m.GetType())).ToList();
 16139                foreach (var m in moving)
 140                {
 141                    // 既に primary に同種 tick==m.Tick が無ければ追加
 6142                    if (!primary.MetaEvents.Any(x=> x.GetType()==m.GetType() && x.Tick==m.Tick)) primary.AddMeta(m);
 143                }
 144                // 除去 (Tempo/TimeSig/KeySig のみ)
 5145                RemoveMetaInternal(ot, conductorTypes);
 146            }
 147        }
 53148        foreach (var t in tracks) t.Sort();
 7149        var trackChunks = new List<byte[]>();
 40150        foreach (var track in tracks)
 13151            trackChunks.Add(BuildTrackChunk(track, useRunningStatus));
 152
 7153        var ms = new MemoryStream();
 7154        using var bw = new BinaryWriter(ms, System.Text.Encoding.ASCII, leaveOpen:true);
 155        // Header
 7156        bw.Write(new byte[]{(byte)'M',(byte)'T',(byte)'h',(byte)'d'});
 7157        bw.Write(BitConverter.GetBytes(System.Net.IPAddress.HostToNetworkOrder(6)));
 7158        bw.Write(BitConverter.GetBytes(System.Net.IPAddress.HostToNetworkOrder((short)1))); // format1
 7159        bw.Write(BitConverter.GetBytes(System.Net.IPAddress.HostToNetworkOrder((short)trackChunks.Count))); // ntrks
 7160        bw.Write(BitConverter.GetBytes(System.Net.IPAddress.HostToNetworkOrder((short)division)));
 161        // Tracks
 40162        foreach (var chunk in trackChunks)
 13163            bw.Write(chunk);
 7164        return ms.ToArray();
 7165    }
 166
 167    private static byte[] BuildTrackChunk(MidiTrack track, bool useRunningStatus)
 168    {
 13169        var events = new List<(long tick, byte[] data, bool channel)>();
 40170        foreach (var me in track.MetaEvents)
 171        {
 172            switch (me)
 173            {
 174                case TempoEvent te:
 5175                    int us = te.Tempo.MicrosecondsPerQuarter;
 5176                    events.Add((te.Tick, new byte[]{0xFF,0x51,0x03,(byte)((us>>16)&0xFF),(byte)((us>>8)&0xFF),(byte)(us&
 5177                    break;
 178                case TimeSignatureEvent tse:
 4179                    byte nn = (byte)tse.Signature.Numerator; byte dd = (byte)Math.Log2(tse.Signature.Denominator); byte 
 1180                    events.Add((tse.Tick, new byte[]{0xFF,0x58,0x04, nn, dd, cc, bb}, false));
 1181                    break;
 182                case KeySignatureEvent kse:
 0183                    sbyte sf = (sbyte)kse.SharpsFlats; byte mi = (byte)(kse.IsMinor?1:0);
 0184                    events.Add((kse.Tick, new byte[]{0xFF,0x59,0x02,(byte)sf, mi}, false));
 0185                    break;
 186                case TextEvent txt:
 0187                    events.Add((txt.Tick, BuildTextMeta(0x01, txt.Text), false));
 0188                    break;
 189                case TrackNameEvent tname:
 1190                    events.Add((tname.Tick, BuildTextMeta(0x03, tname.Name), false));
 1191                    break;
 192                case MarkerEvent mark:
 0193                    events.Add((mark.Tick, BuildTextMeta(0x06, mark.Label), false));
 194                    break;
 195            }
 196        }
 40197        foreach (var ne in track.Notes)
 198        {
 14199            int statusBase = ne.IsNoteOn ? 0x90 : 0x80; byte status = (byte)(statusBase | (ne.Channel & 0x0F));
 14200            byte pitch = (byte)Math.Clamp(ne.Pitch, 0, 127); byte velocity = (byte)Math.Clamp(ne.Velocity, 0, 127);
 7201            events.Add((ne.Tick, new byte[]{status, pitch, velocity}, true));
 202        }
 27203        long endTick = events.Count>0 ? events.Max(e=>e.tick) : 0;
 13204        events.Add((endTick, new byte[]{0xFF,0x2F,0x00}, false));
 29205        events.Sort((a,b)=> a.tick.CompareTo(b.tick));
 13206        var ms = new MemoryStream();
 282207        long prev=0; byte? lastStatus=null; foreach (var ev in events){ long d=ev.tick-prev; WriteVarLen(ms,d); prev=ev.
 13208        var data = ms.ToArray();
 13209        var chunk = new MemoryStream();
 13210        using var bw = new BinaryWriter(chunk, System.Text.Encoding.ASCII, leaveOpen:true);
 13211        bw.Write(new byte[]{(byte)'M',(byte)'T',(byte)'r',(byte)'k'});
 13212        bw.Write(BitConverter.GetBytes(System.Net.IPAddress.HostToNetworkOrder(data.Length)));
 13213        bw.Write(data);
 13214        return chunk.ToArray();
 13215    }
 216
 217    private static byte[] BuildTextMeta(byte type, string text)
 218    {
 4219        var bytes = System.Text.Encoding.UTF8.GetBytes(text ?? "");
 4220        var ms = new MemoryStream();
 16221        ms.WriteByte(0xFF); ms.WriteByte(type); WriteVarLen(ms, bytes.Length); ms.Write(bytes,0,bytes.Length);
 4222        return ms.ToArray();
 223    }
 224
 225    private static void WriteVarLen(Stream s, long value)
 226    {
 227        // 最大 4 バイト想定
 103228        uint buffer = (uint)value & 0x7F;
 106229        while ((value >>= 7) > 0)
 230        {
 3231            buffer <<= 8;
 3232            buffer |= (uint)(((uint)value & 0x7F) | 0x80);
 233        }
 234        while (true)
 235        {
 106236            s.WriteByte((byte)buffer);
 109237            if ((buffer & 0x80) != 0) buffer >>= 8; else break;
 238        }
 103239    }
 240    private static void RemoveMetaInternal(MidiTrack track, HashSet<Type> types)
 241    {
 9242        var keep = track.MetaEvents.Where(m=>!types.Contains(m.GetType())).ToList();
 5243        var field = typeof(MidiTrack).GetField("_meta", System.Reflection.BindingFlags.NonPublic|System.Reflection.Bindi
 5244        if (field!=null && field.GetValue(track) is List<MetaEvent> list)
 245        {
 10246            list.Clear(); list.AddRange(keep);
 247        }
 5248    }
 249}
 250
 251/// <summary>コンダクタートラック生成 / 集約ヘルパ。</summary>
 252public static class MidiConductorHelper
 253{
 254    public static (MidiTrack conductor, IList<MidiTrack> others) ExtractConductor(IReadOnlyList<MidiTrack> tracks)
 255    {
 256        if (tracks.Count==0) throw new ArgumentException("tracks empty");
 257        var conductor = new MidiTrack();
 258        foreach (var m in tracks[0].MetaEvents) conductor.AddMeta(m);
 259        return (conductor, tracks.Skip(1).ToList());
 260    }
 261    public static MidiTrack ConsolidateAndStrip(IList<MidiTrack> tracks)
 262    {
 263        if (tracks.Count==0) throw new ArgumentException("tracks empty");
 264        // consolidate by calling writer helper indirectly not exposed; replicate logic here
 265        var conductor = new MidiTrack();
 266        var types = new HashSet<Type>{ typeof(TempoEvent), typeof(TimeSignatureEvent), typeof(KeySignatureEvent) };
 267        foreach (var t in tracks)
 268        {
 269            var moving = t.MetaEvents.Where(m=>types.Contains(m.GetType())).ToList();
 270            foreach (var m in moving)
 271                if (!conductor.MetaEvents.Any(x=>x.GetType()==m.GetType() && x.Tick==m.Tick)) conductor.AddMeta(m);
 272            // strip
 273            var field = typeof(MidiTrack).GetField("_meta", System.Reflection.BindingFlags.NonPublic|System.Reflection.B
 274            if (field!=null && field.GetValue(t) is List<MetaEvent> list)
 275            {
 276                list.RemoveAll(m=>types.Contains(m.GetType()));
 277            }
 278        }
 279        return conductor;
 280    }
 281}
Generated by: ReportGenerator 5.4.17.0
10/08/2025 - 01:23:29
GitHub | reportgenerator.io

Methods/Properties

WriteSingleTrack(MusicTheory.Theory.Time.MidiTrack,System.Int32,System.Boolean)
WriteMultipleTracks(System.Collections.Generic.IReadOnlyList`1<MusicTheory.Theory.Time.MidiTrack>,System.Int32,System.Boolean,System.Boolean)
BuildTrackChunk(MusicTheory.Theory.Time.MidiTrack,System.Boolean)
BuildTextMeta(System.Byte,System.String)
WriteVarLen(System.IO.Stream,System.Int64)
RemoveMetaInternal(MusicTheory.Theory.Time.MidiTrack,System.Collections.Generic.HashSet`1<System.Type>)