DryWetMIDI 6.1.3

Lazy reading/writing API

DryWetMIDI now provides ways to read/write data from/to a MIDI file sequentially token by token which allows to keep low memory consumption. Here the new methods and classes aimed for this task:

• MidiFile.ReadLazy;
• MidiFile.WriteLazy;
• MidiTokensReader;
• MidiTokensWriter;
• TimedObjectsWriter.

Small changes and bug fixes

• Added EnumerateObjects method to the GetObjectsUtilities.
• Fixed: MidiFile.Equals don't respect TimeDivision.
• Fixed: Merger skips objects sometimes (#225).

DryWetMIDI 6.1.2

Apple Silicon support

DryWetMIDI multimedia API now supports Apple Silicon chips when used on macOS (#204). Thanks to @ThaddeusChristopher for testing!

Nativeless version

The library has now nativeless version where all native-dependent API is cut out. More info in the Nativeless package article.

New features and improvements

• Added BytesFormat property to BytesToMidiEventConverter.
• Added BytesFormat property to MidiEventToBytesConverter.
• Removed FfStatusBytePolicy property from BytesToMidiEventConverter.
• IInputDevice/IOutputDevice are now derived from IDisposable (#205).

DryWetMIDI 6.1.1

This release continues unifying API to work with different MIDI objects finishing the work done in the previous release.

New features and improvements

• Added Resizer tool which can resize groups of objects of different types or entire MIDI files.
• Added Merger tool to merge nearby objects of different types.
• Added SplitByObjects method to the Splitter class.
• Added TimeSpanUtilities.Round method.
• Added TimeSpanUtilities.IsZeroTimeSpan method.
• Added Count property to the TimedObjectsCollection class.
• Added SplitFileByChunksSettings.PreserveTempoMap property.
• Added ILengthedObject.EndTime property.
• Added GetDuration methods for TrackChunk.

Small changes and bug fixes

• All exception classes are now serializable.
• Fixed: ReplaceTempoMap throws an exception for empty track chunks collections / MIDI file.

DryWetMIDI 6.1.0

This release focuses on unifying API to work with different MIDI objects.

Tools

First of all, new tool added – Repeater. It allows repeat MIDI data specified number of times with different options applied.

Also, some old tools were unified into single ones:

• TimedEventsQuantizer, NotesQuantizer and ChordsQuantizer have been replaced by new Quantizer tool which can quantize objects of different types simultaneously. More than that, it can now quantize start and end times at the same time, applying randomization if specified (and thus Randomizer tool is now obsolete). More info in the Quantizer article.
• NotesSplitter and ChordsSplitter have been replaced by new Splitter tool which can split objects of different types simultaneously. Also all methods from MidiFileSplitter class have been moved to the Splitter one. More info in the Splitter articles.

Objects managers

Also the work has been done on unifying separate manager classes for each object type. So now TimedEventsManager, NotesManager and ChordsManager classes are now obsolete. You should use TimedObjectsManager class now which can manage objects of different types simultaneously. More info in the Objects managers article.

New features and improvements

• Clone method has been moved from separate classes (like Note or TimedEvent) to ITimedObject interface.
• Split method has been moved from separate classes (like Note or Chord) to ILengthedObject.
• Added SetTime method to TimedObjectUtilities (SetTime within TimedEventsManagingUtilities is obsolete now).
• Added SetLength method to LengthedObjectUtilities (SetTimeAndLength methods within NotesManagingUtilities and ChordsManagingUtilities are obsolete now).
• Added MoveToStart method to PatternBuilder class.
• Added parameter of RepeatSettings type to PatternBuilder's Repeat methods.
• Added Note methods by a note string to PatternBuilder.
• Added Chord methods by a chord string to PatternBuilder.
• Changed default value of the Playback.InterruptNotesOnStop property to true.
• Parsing of MusicTheory.Note ignores case now.
• Parsing of Chord.GetNames method supports 7b9, add11, 7#11, 7+11, 7(#11) and 7aug11 chords now (see complete list of supported chords here).
• Added TimeType property to the PlaybackCurrentTimeWatcher.
• Constructor of the PlaybackCurrentTimeWatcher is now public so you can create different watchers.
• Added WatchOnlyRunningPlaybacks property to the PlaybackCurrentTimeWatcherSettings.
• Added SetPlaybackTimeType method to the PlaybackCurrentTimeWatcher.
• Added Note's constructor by pair of timed events.
• Added parameter of the TimedEventDetectionSettings type to timed events managing methods.
• Added Constructor and TimedEventDetectionSettings properties to NoteDetectionSettings.
• Added Constructor property to ChordDetectionSettings.

Small changes and bug fixes

• Added new total properties for MetricTimeSpan (#144).
• Handled big internal values within time spans conversions.
• Fixed: NotEnoughBytesPolicy is ignored on reading some events.
• Fixed: [TrackChunk](https://melanchall.github.io/drywetmidi/a...

DryWetMIDI 6.0.1

This is a minor release containing following changes:

• HighPrecisionTickGenerator implementation for macOS uses less CPU now and comsume less power.
• GetAll static method for InputDevice and for OutputDevice returns ICollection now.
• Fixed: VirtualDevice.IsEnabled doesn't work.
• Fixed: EndOfTrackEvent written incorrectly in some cases if it present in a MIDI file with ReadingSettings.EndOfTrackStoringPolicy set to EndOfTrackStoringPolicy.Store on reading the file.
• Fixed: Events don't preserve order on transfer to next part on MIDI file splitting.

DryWetMIDI 6.0.0

Devices API available for macOS now

DryWetMIDI allows now work with MIDI devices on macOS! More than that, a couple of new classes are available for macOS only:

• VirtualDevice;
• DevicesWatcher.

Also HighPrecisionTickGenerator implemented for macOS too so you can now use Playback with default settings on that platform. Its implementation for macOS is not good (in terms of performance) for now but will be optimized for the next release of the library.

Breaking changes

This version of the library has following breaking changes:

• Melanchall.DryWetMidi.Devices namespace renamed to Melanchall.DryWetMidi.Multimedia to reflect its content more precisely since not only devices are there.
• DriverManufacturer, ProductIdentifier and DriverVersion properties were removed from the MidiDevice class and replaced by GetProperty method for InputDevice and for OutputDevice.
• Channels, DeviceType, NotesNumber, SupportsLeftRightVolumeControl, SupportsPatchCaching, SupportsVolumeControl, VoicesNumber and Volume properties were removed from OutputDevice and replaced by GetProperty method.
• Removed InvalidSysExEventReceived and InvalidShortEventReceived events from InputDevice and replaced them with ErrorOccurred one.
• All obsolete APIs were removed from the library.

New features

• Added VirtualDevice class which allows create virtual MIDI devices on macOS.
• Added GetProperty method for InputDevice and for OutputDevice.
• Added GetSupportedProperties method for InputDevice and for OutputDevice.
• Added DevicesWatcher class which allows watch adding or removing a MIDI device.
• Added ConvertMultiple methods to BytesToMidiEventConverter (#134).
• Added FfStatusBytesPolicy property to BytesToMidiEventConverter.
• Implemented delta-times support in BytesToMidiEventConverter and MidiEventToBytesConverter (#134).
• Exploded WritingSettings property of MidiEventToBytesConverter into separate properties.
• Exploded ReadingSettings property of BytesToMidiEventConverter into separate properties.
• Added UnknownChannelEventPolicy property for BytesToMidiEventConverter.
• Added GetByIndex method for InputDevice and for OutputDevice.

Small changes and bug fixes

• MidiException class has been moved to Melanchall.DryWetMidi.Common namespace.
• MidiDeviceException is subclassed from MidiException now.
• Fixed: GetObjects methods of the GetObjectsUtilities sometimes return wrong chords when notes are gathered across different track chunks.

DryWetMIDI 5.2.1

New features and improvements

• Added EventCallback property to DevicesConnector.
• Added CutPart method to MidiFileSplitter.
• Improved performance of GetNotes, ProcessNotes and RemoveNotes methods of NotesManagingUtilities.
• Improved GetChords, ProcessChords and RemoveChords methods of ChordsManagingUtilities.
• Improved performance of ticks to metric timespan conversion (#129).
• Added DeviceErrorOccurred event to Playback (#121).
• Replaced MidiClockSettings parameter by PlaybackSettings in all playback creation methods and put MidiClockSettings inside PlaybackSettings.
• Removed Playback constructors by MidiEvents, added GetPlayback utility methods for MidiEvents to (with output device parameter and without it).
• Tracked data will be now sent by Playback when value of TrackControlValue, TrackPitchValue or TrackProgram changed to true.
• Added IMetadata interface.
• Added TryPlayEvent and GetTimedEvents protected virtual method to Playback (please see Custom playback article).
• Added EndOfTrackStoringPolicy to ReadingSettings (#17).
• Added Metadata property to MidiEventPlayedEventArgs (please see Custom playback article).

Small changes and bug fixes

• Made TickGenerator.TickGenerated event public.
• Made EndOfTrackEvent class public (#17).
• Removed sealed modifier from Playback.
• Removed sealed modifier from TimedEvent, Note and Chord classes, made their Clone methods virtual.
• Fixed: Concurrent access to Octave and Note caches is failed (#116).
• Fixed: NoteSearchContext and ChordSearchContext are not respected in GetObjects methods for track chunks collection and for MIDI file.
• Fixed: Tracked data is sent by Playback when we jump to data change event.

DryWetMIDI 5.2.0

Performance

Methods to get, process and remove timed events and notes now work faster and consume less memory. Full tables with benchmarks results can be found here:

• synthetic benchmarks;
• benchmarks on real files.

New features and improvements

• Added GetObjectsUtilities class containing methods that allow get objects of different types from the input ones (or MIDI file, for example).
• ProcessTimedEvents and RemoveTimedEvents methods return now count of processed/removed timed events.
• ProcessNotes and RemoveNotes methods return now count of processed/removed notes.
• ProcessChords and RemoveChords methods return now count of processed/removed chords.
• Added IsEnabled property to MidiDevice.
• Added methods to Playback to move to snap points by data.
• All move-to-by-snap-points methods of Playback return bool now to indicate whether time changed or not.
• Added PlaybackStart and PlaybackEnd properties to Playback.
• Added IsEnabled to PlaybackSnapping.
• Added PlaybackSnapping.Clear method.
• Added TrackProgram, TrackPitchValue and TrackControlValue to Playback.
• Removed reading handlers API.
• Added <, >, <=, >= operators for Tempo and TimeSignature.
• BeatsPerMinute property of Tempo is now of double type.
• Added settings parameter to SplitByChannel method.
• Added settings parameter to SplitByNotes method.
• Return type of GetTimedEvents, GetNotes and GetChords changed from IEnumerable<T> to ICollection<T>.
• Added NoteDetectionSettings to GetNotes, ProcessNotes and RemoveNotes.
• Added ChordDetectionSettings to GetChords, ProcessChords and RemoveChords.
• Added ChordDetectionSettings to ChordsQuantizingSettings and ChordsRandomizingSettings.
• Added NoteDetectionSettings to NotesQuantizingSettings and NotesRandomizingSettings.
• Added SilentNoteOnPolicy property to InputDevice.
• Added SplitByChunks method to MidiFileSplitter.

Small changes and bug fixes

• Some methods are now obsolete:
  • GetTimedEventsAndNotesUtilities (OBS5);
  • GetNotesAndRestsUtilities (OBS6);
  • TimedEventsManagingUtilities.ToTrackChunk, NotesManagingUtilities.ToTrackChunk, ChordsManagingUtilities.ToTrackChunk (OBS7);
  • TimedEventsManagingUtilities.ToFile, NotesManagingUtilities.ToFile, ChordsManagingUtilities.ToFile (OBS8);
  • TimedEventsManagingUtilities.AddTimedEvents, NotesManagingUtilities.AddNotes, ChordsManagingUtilities.AddChords ([OBS9](https://melanchall.github.io/drywetmidi/obsolet...

DryWetMIDI 5.1.2

Obsolete API

New section has been added to documentation site: Obsolete. This section contains the list of methods and classes that are obsolete and thus will be removed by a next release.

The current list of obsolete API:

• OBS1: WritingSettings.CompressionPolicy
• OBS2: ReaderSettings.ReadFromMemory
• OBS3: TempoMap.TimeSignature
• OBS4: TempoMap.Tempo

New features and improvements

• Added ReaderSettings.BufferingPolicy property.
• Increased speed of MidiFile.Read method.
• Increased speed of MidiFile.Write method.
• Implemented buffered MIDI file writing (see WriterSettings.UseBuffering).
• Decreased memory usage of MidiWriter.Write3ByteDword and MidiWriter.WriteVlqNumber.
• Reduced memory usage for ChannelEvent.
• Added ReadingSettings.ZeroLengthDataPolicy property.
• Added RPN classes (see RegisteredParameter).
• Added TempoMap.GetTimeSignatureChanges and TempoMap.GetTimeSignatureAtTime methods.
• Added WritingSettings.WriteHeaderChunk property (#94).
• Added GS standard percussion API (#93).
• Added SliceMidiFileSettings.Markers property (#99).
• Non-SMF events will be filtered out on saving to MIDI file or track chunk (#103).

Small changes and bug fixes

• Added value validation in setters of some MIDI events classes properties.
• Edge Note Off events will always be put to current part on MIDI file splitting (#99).
• Fixed: Events transferred incorrectly between parts on MIDI file splitting (#99).
• Fixed: SmpteOffsetEvent writes in wrong way.
• Fixed: SmpteOffsetEvent equality check is wrong.
• Fixed: Failed to use devices API in UWP app (#95).

DryWetMIDI 5.1.1

New features

• Removed interval parameter from MidiClockSettings.CreateTickGeneratorCallback.
• Turned ITickGenerator to TickGenerator abstract class.
• Added RepeatStarted event to Playback.
• Made constructors of MidiEventReceivedEventArgs and MidiEventSentEventArgs public to have ability to fire corresponding events in custom input/output devices.
• DevicesConnector now uses IInputDevice instead of InputDevice.
• Removed IDisposable from DevicesConnector.
• Added AreDevicesConnected property to DevicesConnector.
• Added Parse/TryParse to Octave.
• Added INotifyTimeChanged interface on TimedEvent, Note and Chord.
• Added INotifyLengthChanged interface on Note and Chord.

Small changes and bug fixes

• Chords parsing uses CNT now.
• Fixed: Multi-thread access to active notes metadata inside Playback can cause exceptions.
• Fixed: Playback.EventPlayed not fired for meta events (#82).
• Fixed: Slash chord name contains Sharp instead of # for sharped notes as result of GetNames.