DryWetMIDI / .NET library to work with MIDI files and MIDI devices

I've decided to publish all releases of the DryWetMIDI in one thread.

And I'm going to start the thread with a new release – 6.1.1 version has been released both in NuGet and Unity Asset Store. Please see the changelog below.

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.

You can also see threads on the previous versions:

• v6.0.1
• v6.1.0

 

6.1.2 version has been released on NuGet (full | nativeless) and Unity Asset Store (full | nativeless).

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).

 

6.1.3 version has been released on NuGet (full | nativeless) and Unity Asset Store (full | nativeless).

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).

 

6.1.4 version has been released on NuGet (full | nativeless) and Unity Asset Store (full | nativeless).

Small changes and bug fixes

• Improved performance of GetTempoMap methods.
• Added WaitForCompleteSysExEvent property to InputDevice.
• Fixed: AccessViolationException thrown sometimes on HighPrecisionTickGenerator stop on Windows.
• Fixed: Multipacket SysEx is not received correctly on macOS (#232).

 

7.0.0 version has been released on NuGet (full | nativeless) and Unity Asset Store (full | nativeless).

Breaking changes

This version of the library has following breaking changes:

• Removed obsolete API:
  • OBS19: Use Splitter.SplitByObjects method;
  • OBS18: Use Resizer class;
  • OBS17: Use Merger class;
  • OBS16: Use TimedEvent constructor and add an object manually;
  • OBS15: Use SetTime/SetLength methods from TimedObjectUtilities/LengthedObjectUtilities;
  • OBS14: Use SetTime method from TimedObjectUtilities;
  • OBS13: Use Quantizer class;
  • OBS12: Use Splitter class;
  • OBS11: Use TimedObjectsManager class;
  • OBS10: Use Quantizer class passing QuantizingSettings with its RandomizingSettings property set.
• Removed NoteSearchContext and ChordSearchContext.
• Renamed CombineInSequence and CombineInParallel methods of PatternUtilities to MergeSequentially and MergeSimultaneously correspondingly.

New features and improvements

• Added Sanitizer tool.
• Added MergeSequentially and MergeSimultaneously methods to the Merger tool.
• Added StopReadingOnExpectedTrackChunksCountReached property to ReadingSettings (#244).
• Added ChordProcessingHint (#256).
• Added NoteProcessingHint.
• Added TimedEventProcessingHint.
• Added FromDouble method for MusicalTimeSpan.
• Added Position and Length properties to MidiToken.

Small changes and bug fixes

• Improved Quantizer performance.
• Set default pitch value for PitchBendEvent to 8192.
• Fixed: GetTimedEvents methods for multiple track chunks returns original events if a single track chunk is in the collection.
• Fixed: Exception on Chord's length setting below the distance between chord's start and its last note's time.

 

Hi melanchall,

Can you help me how to check if a Melanchall.DryWetMidi.Interaction.Note is a whole-note, quarter-note, ...?

Thanks you

 

Hi,

It can be done with the code like that:

Code (CSharp):

1. var length = note.LengthAs<MusicalTimeSpan>(tempoMap);
2. if (length == MusicalTimeSpan.Quarter)
3. {
4.     // ...
5. }

 

Thank you so much ^^

 

7.0.1 version has been released on NuGet (full | nativeless) and Unity Asset Store (full | nativeless).

New features and improvements

• Concept of the IObjectId removed. Please read updated SplitByObjects section of the docs.
• Added filter parameter to SplitObjectsAtDistance, SplitObjectsByGrid, SplitObjectsByPartsNumber and SplitObjectsByStep methods of the Splitter.
• Added PlaybackHint.
• Improved performance of the TimedObjectsManager.SaveChanges method.
• Improved performance of the TimedObjectUtilities.AddObjects method when target events collection is empty.
• Improved performance of time changing methods of the Playback.

Small changes and bug fixes

• Implemented TempoMap.Equals.
• Added max value constants in the SmpteOffsetEvent.
• Fixed: Current time is managed improperly in the MidiClock when there are speed changes.
• Fixed: NotesPlaybackStarted and NotesPlaybackFinished events of the Playback can be fired with empty notes collection.

 

7.0.2 version has been released on NuGet (full | nativeless) and Unity Asset Store (full | nativeless).

This a micro-release, which fixes a couple of bugs ✨ ✨

Small changes and bug fixes

• Improved chord name detection (#260).
• Fixed: SMPTE time divisions not being read/written correctly (#275).