using System;
using NAudio.Wave.SampleProviders;
namespace NAudio.Wave
{
///
/// Useful extension methods to make switching between WaveAndSampleProvider easier
///
public static class WaveExtensionMethods
{
///
/// Converts a WaveProvider into a SampleProvider (only works for PCM)
///
/// WaveProvider to convert
///
public static ISampleProvider ToSampleProvider(this IWaveProvider waveProvider)
{
return SampleProviderConverters.ConvertWaveProviderIntoSampleProvider(waveProvider);
}
///
/// Allows sending a SampleProvider directly to an IWavePlayer without needing to convert
/// back to an IWaveProvider
///
/// The WavePlayer
///
///
public static void Init(this IWavePlayer wavePlayer, ISampleProvider sampleProvider, bool convertTo16Bit = false)
{
IWaveProvider provider = convertTo16Bit ? (IWaveProvider)new SampleToWaveProvider16(sampleProvider) : new SampleToWaveProvider(sampleProvider);
wavePlayer.Init(provider);
}
///
/// Turns WaveFormatExtensible into a standard waveformat if possible
///
/// Input wave format
/// A standard PCM or IEEE waveformat, or the original waveformat
public static WaveFormat AsStandardWaveFormat(this WaveFormat waveFormat)
{
var wfe = waveFormat as WaveFormatExtensible;
return wfe != null ? wfe.ToStandardWaveFormat() : waveFormat;
}
///
/// Converts a ISampleProvider to a IWaveProvider but still 32 bit float
///
/// SampleProvider to convert
/// An IWaveProvider
public static IWaveProvider ToWaveProvider(this ISampleProvider sampleProvider)
{
return new SampleToWaveProvider(sampleProvider);
}
///
/// Converts a ISampleProvider to a IWaveProvider but and convert to 16 bit
///
/// SampleProvider to convert
/// A 16 bit IWaveProvider
public static IWaveProvider ToWaveProvider16(this ISampleProvider sampleProvider)
{
return new SampleToWaveProvider16(sampleProvider);
}
///
/// Concatenates one Sample Provider on the end of another
///
/// The sample provider to play first
/// The sample provider to play next
/// A single sampleprovider to play one after the other
public static ISampleProvider FollowedBy(this ISampleProvider sampleProvider, ISampleProvider next)
{
return new ConcatenatingSampleProvider(new[] { sampleProvider, next});
}
///
/// Concatenates one Sample Provider on the end of another with silence inserted
///
/// The sample provider to play first
/// Silence duration to insert between the two
/// The sample provider to play next
/// A single sample provider
public static ISampleProvider FollowedBy(this ISampleProvider sampleProvider, TimeSpan silenceDuration, ISampleProvider next)
{
var silenceAppended = new OffsetSampleProvider(sampleProvider) {LeadOut = silenceDuration};
return new ConcatenatingSampleProvider(new[] { silenceAppended, next });
}
///
/// Skips over a specified amount of time (by consuming source stream)
///
/// Source sample provider
/// Duration to skip over
/// A sample provider that skips over the specified amount of time
public static ISampleProvider Skip(this ISampleProvider sampleProvider, TimeSpan skipDuration)
{
return new OffsetSampleProvider(sampleProvider) { SkipOver = skipDuration};
}
///
/// Takes a specified amount of time from the source stream
///
/// Source sample provider
/// Duration to take
/// A sample provider that reads up to the specified amount of time
public static ISampleProvider Take(this ISampleProvider sampleProvider, TimeSpan takeDuration)
{
return new OffsetSampleProvider(sampleProvider) { Take = takeDuration };
}
///
/// Converts a Stereo Sample Provider to mono, allowing mixing of channel volume
///
/// Stereo Source Provider
/// Amount of left channel to mix in (0 = mute, 1 = full, 0.5 for mixing half from each channel)
/// Amount of right channel to mix in (0 = mute, 1 = full, 0.5 for mixing half from each channel)
/// A mono SampleProvider
public static ISampleProvider ToMono(this ISampleProvider sourceProvider, float leftVol = 0.5f, float rightVol = 0.5f)
{
if(sourceProvider.WaveFormat.Channels == 1) return sourceProvider;
return new StereoToMonoSampleProvider(sourceProvider) {LeftVolume = leftVol, RightVolume = rightVol};
}
///
/// Converts a Mono ISampleProvider to stereo
///
/// Mono Source Provider
/// Amount to mix to left channel (1.0 is full volume)
/// Amount to mix to right channel (1.0 is full volume)
///
public static ISampleProvider ToStereo(this ISampleProvider sourceProvider, float leftVol = 1.0f, float rightVol = 1.0f)
{
if (sourceProvider.WaveFormat.Channels == 2) return sourceProvider;
return new MonoToStereoSampleProvider(sourceProvider) { LeftVolume = leftVol, RightVolume = rightVol };
}
}
}