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 }; } } }