DryWetMIDI 8.0.3

This small release is the last in this year. And the last one with support of 32-bit processes for Multimedia API on Windows.

Happy New Year! 🎄 🎉

Important

You can help to make the library better! Please take a quick survey.

Small changes

• Stabilized Playback.
• Handled exceptions within Playback.
• DeviceErrorOccurred event of Playback has been replaced with ErrorOccurred one.
• Changed the type of the time parameter to ITimeSpan in TimeSpanUtilities.Round for BarBeatTicksTimeSpan and BarBeatFractionTimeSpan (#333).
• Improved TempoMap operations performance.
• Improved performance of BarBeatTicksTimeSpan conversion for simple cases.
• Handled null custom timed events in timed events processing utilities.
• Handled null custom notes in notes processing utilities.
• Handled null custom chords in chords processing utilities.

Bug fixes

• Fixed: Playback.NoteCallback is still applied to already played notes after it has been set to null.
• Fixed: Result of GetObjects is not sorted when chords and timed events requested, and notes and chords passed.
• Fixed: GetTempoMap returns wrong tempo map after events were set on EventsCollection by index.

DryWetMIDI 8.0.2

Another one minor release. It fixes critical bug with the Playback – Playback skips some notes (#334). It's highly recommended to switch to the new version of the library.

DryWetMIDI 8.0.1

This minor release addresses issues with the Playback.

First of all, performance of Playback instance creation was degraded in the 8.0.0 version. Now that is fixed. More than that, Playback's constructor is faster and consumes less memory than in the 7.2.0 version. It's highly recommended to switch to the new version of the library.

Also, a couple of bugs were fixed:

• If you create an instance of the Playback via passing an objects collection, playback can work unexpectedly if input objects are not sorted by their times.
• If you change the time of a playback (for example, via MoveToTime) and there is a note in the new position, NoteCallback won't be applied.

DryWetMIDI 8.0.0

Major playback improvements

Now it’s possible to change playback’s data on the fly (#78)! It was a big challenge to implement this functionality (do you even use red-black trees?). But now you can add, remove and change objects without needing to recreate an instance of the Playback or even stop it. You’ll find the detailed guide on how to use the feature in the Dynamic changes article of the library docs.

Also a bunch of bugs related to the Playback were fixed:

• currently playing note is not interrupted when PlaybackEnd reached;
• MoveToTime has no effect if it’s executed just before the first Start method call;
• IsRunning can return invalid value due to race conditions when Loop property is set to true;
• Start and then Stop calls in the middle of a note can cause unexpected behavior when InterruptNotesOnStop and TrackNotes are set to true.

Data tracking is now on by default. So in case of jumps in time you’ll get correctly applied program, pitch and control values. TrackNotes is now true by default too. Of course you can turn the feature off via corresponding properties if you want.

Several new things were added:

• Playback: added SendNoteOffEventsForNonActiveNotes and SendNoteOnEventsForActiveNotes properties;
• PlaybackSettings: added CalculateTempoMap property;
• NotesPlaybackStarted and NotesPlaybackFinished events args: added original notes (see NotesEventArgs.OriginalNotes).

Please note that there are some breaking changes:

• Play method has been removed. It causes confusion and does nothing but just calling Start and then SpinWait.SpinUntil(() => !IsRunning). You can do these actions by yourself if you for some reason want the blocking playback.
• PlaybackHint has been removed from PlaybackSettings. There was no noticeable performance gain in using this feature. You can just disable data tracking if you want.
• Snapping has been reworked. First of all, there is no Snapping property within the Playback anymore. Snapping functionality was moved just right into the Playback. Snapping.IsEnabled is replaced with IsSnappingEnabled. SnapToNotesStarts and SnapToNotesEnds methods are replaced with the much more flexible SnapToEvents one.

New features and improvements

• Split CsvSerializerSettings into CsvSerializationSettings for serialization methods and CsvDeserializationSettings for deserialization ones.
• Time, length and note formats can be resolved automatically on CSV deserialization (which is the default behavior now).
• Added UnknownRecordPolicy property to CsvDeserializationSettings.
• Introduced CsvException which replaces FormatException in CsvSerializer.
• Added BytesArrayDelimiter property to CsvSerializationSettings and CsvDeserializationSettings.
• Added RemoveDuplicatedControlChangeEvents property to SanitizingSettings.
• Replaced RemoveOrphanedNoteOnEvents property of SanitizingSettings with OrphanedNoteOnEventsPolicy which provides more ways to handle orphaned Note On events.

Small changes and bug fixes

• Implemented piano roll multi-cell custom actions.
• Print line and symbol indices in piano roll errors.
• Handle empty collections in ManageTempoMap methods of the [TempoMapManagingUtilities](https://melanchall.github.io/dr...

DryWetMIDI 7.2.0

Objects managing methods are unified

Now it's possible to process objects of different types simultaneously. Thus now you can call, for example, just midiFile.ProcessObjects(ObjectType.Chord | ObjectType.Note, ...) instead of ProcessChords after ProcessNotes. The same story for objects removal. So in addition to this set of methods

• GetTimedEvents/GetNotes/GetChords
• ProcessTimedEvents/ProcessNotes/ProcessChords
• RemoveTimedEvents/RemoveNotes/RemoveChords

we have

• GetObjects
• ProcessObjects
• RemoveObjects

Also objects detection settings were decoupled. So ChordDetectionSettings doesn't contain NoteDetectionSettings from now, as well as NoteDetectionSettings doesn't contain TimedEventDetectionSettings. Methods shown in the first list accept those settings as separate parameters now.

PatternBuilder improvements

Now you can insert simple patterns more quickly – via new PianoRoll method. For example:

var midiFile = new PatternBuilder()
    .SetNoteLength(MusicalTimeSpan.Eighth)
    .PianoRoll(@"
        F#2   ||||||||
        D2    --|---|-
        C2    |---|---")
    .Repeat(9)
    .Build()
    .ToFile(TempoMap.Default, (FourBitNumber)9);
midiFile.Write("pianoroll-simple.mid", true);

Please read the PianoRoll section of the Pattern article to learn more.

Also a couple of new methods have been added to the PatternBuilder: ControlChange and PitchBend.

Small changes

• Added SanitizingSettings.RemoveDuplicatedNotes property.
• Added SanitizingSettings.RemoveDuplicatedSequenceTrackNameEvents property.
• Added SanitizingSettings.NoteMinVelocity property.
• Changed default value of the SanitizingSettings.Trim property to false since trimming can be undesirable.
• settings parameter of the methods from RestsUtilities is optional now.

DryWetMIDI 7.1.0

Rests redesigned

Now you can get rests between different types of objects and by any logic you will describe. Please read updated Rests section of the docs. This entails a breaking change – there is no ObjectType.Rest option anymore. So to get, for example, notes and rests between them you need to write following code:

var notesAndRests = midiFile
    .GetNotes()
    .WithRests(RestDetectionSettings.NoNotesByChannel);

To feel the power of the new approach, just take a look to the snippet:

var notesAndChordsAndRests = midiFile
    .GetObjects(ObjectType.Note | ObjectType.Chord)
    .WithRests(new RestDetectionSettings
    {
        KeySelector = obj => obj is Note note && note.NoteNumber > 100
            ? (object)note.NoteNumber
            : null
    });

Here we get notes, chords and rests between notes with note number > 100 separately for each note number. Rests won't be built for chords and notes with note number <= 100.

CSV serialization redesigned

CSV serialization and deserialization have been completely reworked with the new CsvSerializer class. Please read CSV serializer article to learn more.

Small changes

• Supported flats in chord progressions to parse.
• Added the EventRecorded event to the Recording.
• Allow zero repeats number for Repeater.
• Added the Trim feature to Sanitizer.

DryWetMIDI 7.0.2

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

DryWetMIDI 7.0.1

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.

DryWetMIDI 7.0.0

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.

DryWetMIDI 6.1.4

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