/// <summary>
/// Quantizes chords contained in the specified <see cref="MidiFile"/>.
/// </summary>
/// <param name="midiFile"><see cref="MidiFile"/> to quantize chords in.</param>
/// <param name="grid">Grid to quantize objects by.</param>
/// <param name="settings">Settings according to which chords should be quantized.</param>
/// <exception cref="ArgumentNullException">
/// <para>One of the following errors occured:</para>
/// <list type="bullet">
/// <item>
/// <description><paramref name="midiFile"/> is <c>null</c>.</description>
/// </item>
/// <item>
/// <description><paramref name="grid"/> is <c>null</c>.</description>
/// </item>
/// </list>
/// </exception>
/// <exception cref="InvalidOperationException">
/// <para>One of the following errors occured:</para>
/// <list type="bullet">
/// <item>
/// <description>Chord is going to be moved beyond zero.</description>
/// </item>
/// <item>
/// <description>Chord's end is going to be moved beyond the chord's fixed end.</description>
/// </item>
/// </list>
/// </exception>
public static void QuantizeChords(this MidiFile midiFile, IGrid grid, ChordsQuantizingSettings settings = null)
{
ThrowIfArgument.IsNull(nameof(midiFile), midiFile);
ThrowIfArgument.IsNull(nameof(grid), grid);
var tempoMap = midiFile.GetTempoMap();
midiFile.GetTrackChunks().QuantizeChords(grid, tempoMap, settings);
}
/// <summary>
/// Quantizes chords contained in the specified <see cref="MidiFile"/>.
/// </summary>
/// <param name="midiFile"><see cref="MidiFile"/> to quantize chords in.</param>
/// <param name="grid">Grid to quantize objects by.</param>
/// <param name="settings">Settings according to which chords should be quantized.</param>
/// <param name="notesTolerance">Chords tolerance that defines maximum distance of chords from the
/// start of the first chord of a chord. Chords within this tolerance will be considered as a chord.</param>
/// <exception cref="ArgumentNullException"><paramref name="midiFile"/> is null. -or-
/// <paramref name="grid"/> is null.</exception>
/// <exception cref="InvalidOperationException">Chord is going to be moved beyond zero. -or-
/// Chord's end is going to be moved beyond the chord's fixed end.</exception>
/// <exception cref="ArgumentOutOfRangeException"><paramref name="notesTolerance"/> is negative.</exception>
public static void QuantizeChords(this MidiFile midiFile, IGrid grid, long notesTolerance = 0, ChordsQuantizingSettings settings = null)
{
ThrowIfArgument.IsNull(nameof(midiFile), midiFile);
ThrowIfArgument.IsNull(nameof(grid), grid);
ThrowIfNotesTolerance.IsNegative(nameof(notesTolerance), notesTolerance);
var tempoMap = midiFile.GetTempoMap();
midiFile.GetTrackChunks().QuantizeChords(grid, tempoMap, notesTolerance, settings);
}
/// <summary>
/// Quantizes chords contained in the specified collection of <see cref="TrackChunk"/>.
/// </summary>
/// <param name="trackChunks">Collection of <see cref="TrackChunk"/> to quantize chords in.</param>
/// <param name="grid">Grid to quantize objects by.</param>
/// <param name="tempoMap">Tempo map used to calculate times to quantize by.</param>
/// <param name="settings">Settings according to which chords should be quantized.</param>
/// <param name="notesTolerance">Chords tolerance that defines maximum distance of chords from the
/// start of the first chord of a chord. Chords within this tolerance will be considered as a chord.</param>
/// <exception cref="ArgumentNullException"><paramref name="trackChunks"/> is null. -or-
/// <paramref name="grid"/> is null. -or- <paramref name="tempoMap"/> is null.</exception>
/// <exception cref="InvalidOperationException">Chord is going to be moved beyond zero. -or-
/// Chord's end is going to be moved beyond the chord's fixed end.</exception>
/// <exception cref="ArgumentOutOfRangeException"><paramref name="notesTolerance"/> is negative.</exception>
public static void QuantizeChords(this IEnumerable <TrackChunk> trackChunks, IGrid grid, TempoMap tempoMap, long notesTolerance = 0, ChordsQuantizingSettings settings = null)
{
ThrowIfArgument.IsNull(nameof(trackChunks), trackChunks);
ThrowIfArgument.IsNull(nameof(grid), grid);
ThrowIfArgument.IsNull(nameof(tempoMap), tempoMap);
ThrowIfNotesTolerance.IsNegative(nameof(notesTolerance), notesTolerance);
foreach (var trackChunk in trackChunks)
{
trackChunk.QuantizeChords(grid, tempoMap, notesTolerance, settings);
}
}
/// <summary>
/// Quantizes chords contained in the specified <see cref="TrackChunk"/>.
/// </summary>
/// <param name="trackChunk"><see cref="TrackChunk"/> to quantize chords in.</param>
/// <param name="grid">Grid to quantize objects by.</param>
/// <param name="tempoMap">Tempo map used to calculate times to quantize by.</param>
/// <param name="settings">Settings according to which chords should be quantized.</param>
/// <param name="notesTolerance">Chords tolerance that defines maximum distance of chords from the
/// start of the first chord of a chord. Chords within this tolerance will be considered as a chord.</param>
/// <exception cref="ArgumentNullException"><paramref name="trackChunk"/> is null. -or-
/// <paramref name="grid"/> is null. -or- <paramref name="tempoMap"/> is null.</exception>
/// <exception cref="InvalidOperationException">Chord is going to be moved beyond zero. -or-
/// Chord's end is going to be moved beyond the chord's fixed end.</exception>
/// <exception cref="ArgumentOutOfRangeException"><paramref name="notesTolerance"/> is negative.</exception>
public static void QuantizeChords(this TrackChunk trackChunk, IGrid grid, TempoMap tempoMap, long notesTolerance = 0, ChordsQuantizingSettings settings = null)
{
ThrowIfArgument.IsNull(nameof(trackChunk), trackChunk);
ThrowIfArgument.IsNull(nameof(grid), grid);
ThrowIfArgument.IsNull(nameof(tempoMap), tempoMap);
ThrowIfNotesTolerance.IsNegative(nameof(notesTolerance), notesTolerance);
using (var chordsManager = trackChunk.ManageChords(notesTolerance))
{
new ChordsQuantizer().Quantize(chordsManager.Chords, grid, tempoMap, settings);
}
}
/// <summary>
/// Quantizes chords contained in the specified collection of <see cref="TrackChunk"/>.
/// </summary>
/// <param name="trackChunks">Collection of <see cref="TrackChunk"/> to quantize chords in.</param>
/// <param name="grid">Grid to quantize objects by.</param>
/// <param name="tempoMap">Tempo map used to calculate times to quantize by.</param>
/// <param name="settings">Settings according to which chords should be quantized.</param>
/// <exception cref="ArgumentNullException">
/// <para>One of the following errors occured:</para>
/// <list type="bullet">
/// <item>
/// <description><paramref name="trackChunks"/> is <c>null</c>.</description>
/// </item>
/// <item>
/// <description><paramref name="grid"/> is <c>null</c>.</description>
/// </item>
/// <item>
/// <description><paramref name="tempoMap"/> is <c>null</c>.</description>
/// </item>
/// </list>
/// </exception>
/// <exception cref="InvalidOperationException">
/// <para>One of the following errors occured:</para>
/// <list type="bullet">
/// <item>
/// <description>Chord is going to be moved beyond zero.</description>
/// </item>
/// <item>
/// <description>Chord's end is going to be moved beyond the chord's fixed end.</description>
/// </item>
/// </list>
/// </exception>
public static void QuantizeChords(this IEnumerable <TrackChunk> trackChunks, IGrid grid, TempoMap tempoMap, ChordsQuantizingSettings settings = null)
{
ThrowIfArgument.IsNull(nameof(trackChunks), trackChunks);
ThrowIfArgument.IsNull(nameof(grid), grid);
ThrowIfArgument.IsNull(nameof(tempoMap), tempoMap);
foreach (var trackChunk in trackChunks)
{
trackChunk.QuantizeChords(grid, tempoMap, settings);
}
}
/// <summary>
/// Quantizes chords contained in the specified <see cref="TrackChunk"/>.
/// </summary>
/// <param name="trackChunk"><see cref="TrackChunk"/> to quantize chords in.</param>
/// <param name="grid">Grid to quantize objects by.</param>
/// <param name="tempoMap">Tempo map used to calculate times to quantize by.</param>
/// <param name="settings">Settings according to which chords should be quantized.</param>
/// <exception cref="ArgumentNullException">
/// <para>One of the following errors occured:</para>
/// <list type="bullet">
/// <item>
/// <description><paramref name="trackChunk"/> is <c>null</c>.</description>
/// </item>
/// <item>
/// <description><paramref name="grid"/> is <c>null</c>.</description>
/// </item>
/// <item>
/// <description><paramref name="tempoMap"/> is <c>null</c>.</description>
/// </item>
/// </list>
/// </exception>
/// <exception cref="InvalidOperationException">
/// <para>One of the following errors occured:</para>
/// <list type="bullet">
/// <item>
/// <description>Chord is going to be moved beyond zero.</description>
/// </item>
/// <item>
/// <description>Chord's end is going to be moved beyond the chord's fixed end.</description>
/// </item>
/// </list>
/// </exception>
public static void QuantizeChords(this TrackChunk trackChunk, IGrid grid, TempoMap tempoMap, ChordsQuantizingSettings settings = null)
{
ThrowIfArgument.IsNull(nameof(trackChunk), trackChunk);
ThrowIfArgument.IsNull(nameof(grid), grid);
ThrowIfArgument.IsNull(nameof(tempoMap), tempoMap);
using (var chordsManager = trackChunk.ManageChords(settings?.ChordDetectionSettings))
{
new ChordsQuantizer().Quantize(chordsManager.Chords, grid, tempoMap, settings);
}
}
