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 (#321).
• Optimized MidiFileUtilities.GetDuration methods.
• Fixed: MIDI devices session is not closed on domain unload or process exit (#318).
• Fixed: Bytes array values with whitespaces causes CSV deserialization failed.