Class WaveFileReader

Namespace

NAudio.Wave

Assembly

NAudio.Core.dll

This class supports the reading of WAV files, providing a repositionable WaveStream that returns the raw data contained in the WAV file

public class WaveFileReader : WaveStream, IDisposable, IAsyncDisposable, IWaveProvider

Inheritance

object

MarshalByRefObject

Stream

WaveStream

WaveFileReader

Implements

IDisposable

IAsyncDisposable

IWaveProvider

Derived

CueWaveFileReader

Inherited Members

WaveStream.Flush()

WaveStream.Seek(long, SeekOrigin)

WaveStream.SetLength(long)

WaveStream.Write(byte[], int, int)

WaveStream.Skip(int)

WaveStream.HasData(int)

WaveStream.CanRead

WaveStream.CanSeek

WaveStream.CanWrite

WaveStream.BlockAlign

WaveStream.CurrentTime

WaveStream.TotalTime

Stream.Null

Stream.CopyTo(Stream)

Stream.CopyTo(Stream, int)

Stream.CopyToAsync(Stream)

Stream.CopyToAsync(Stream, int)

Stream.CopyToAsync(Stream, CancellationToken)

Stream.CopyToAsync(Stream, int, CancellationToken)

Stream.Dispose()

Stream.Close()

Stream.DisposeAsync()

Stream.FlushAsync()

Stream.FlushAsync(CancellationToken)

Stream.CreateWaitHandle()

Stream.BeginRead(byte[], int, int, AsyncCallback, object)

Stream.EndRead(IAsyncResult)

Stream.ReadAsync(byte[], int, int)

Stream.ReadAsync(byte[], int, int, CancellationToken)

Stream.ReadAsync(Memory<byte>, CancellationToken)

Stream.ReadExactlyAsync(Memory<byte>, CancellationToken)

Stream.ReadExactlyAsync(byte[], int, int, CancellationToken)

Stream.ReadAtLeastAsync(Memory<byte>, int, bool, CancellationToken)

Stream.BeginWrite(byte[], int, int, AsyncCallback, object)

Stream.EndWrite(IAsyncResult)

Stream.WriteAsync(byte[], int, int)

Stream.WriteAsync(byte[], int, int, CancellationToken)

Stream.WriteAsync(ReadOnlyMemory<byte>, CancellationToken)

Stream.Read(Span<byte>)

Stream.ReadByte()

Stream.ReadExactly(Span<byte>)

Stream.ReadExactly(byte[], int, int)

Stream.ReadAtLeast(Span<byte>, int, bool)

Stream.Write(ReadOnlySpan<byte>)

Stream.WriteByte(byte)

Stream.Synchronized(Stream)

Stream.ObjectInvariant()

Stream.ValidateBufferArguments(byte[], int, int)

Stream.ValidateCopyToArguments(Stream, int)

Stream.CanTimeout

Stream.ReadTimeout

Stream.WriteTimeout

MarshalByRefObject.GetLifetimeService()

MarshalByRefObject.InitializeLifetimeService()

MarshalByRefObject.MemberwiseClone(bool)

object.GetType()

object.MemberwiseClone()

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

Extension Methods

WaveExtensionMethods.ToSampleProvider(IWaveProvider)

Constructors

WaveFileReader(Stream)

Creates a Wave File Reader based on an input stream

public WaveFileReader(Stream inputStream)

Parameters

inputStream Stream

The input stream containing a WAV file including header

WaveFileReader(string)

Supports opening a WAV file

public WaveFileReader(string waveFile)

Parameters

waveFile string

Remarks

The WAV file format is a real mess, but we will only support the basic WAV file format which actually covers the vast majority of WAV files out there. For more WAV file format information visit www.wotsit.org. If you have a WAV file that can't be read by this class, email it to the NAudio project and we will probably fix this reader to support it

Properties

ExtraChunks

Gets a list of the additional chunks found in this file

public List<RiffChunk> ExtraChunks { get; }

Property Value

List<RiffChunk>

Length

This is the length of audio data contained in this WAV file, in bytes (i.e. the byte length of the data chunk, not the length of the WAV file itself) WaveFormat

public override long Length { get; }

Property Value

long

Position

Position in the WAV data chunk. Position

public override long Position { get; set; }

Property Value

long

SampleCount

Number of Sample Frames (if possible to calculate) This currently does not take into account number of channels Multiply number of channels if you want the total number of samples

public long SampleCount { get; }

Property Value

long

WaveFormat

WaveFormat

public override WaveFormat WaveFormat { get; }

Property Value

WaveFormat

Methods

Dispose(bool)

Cleans up the resources associated with this WaveFileReader

protected override void Dispose(bool disposing)

Parameters

disposing bool

GetChunkData(RiffChunk)

Gets the data for the specified chunk

public byte[] GetChunkData(RiffChunk chunk)

Parameters

chunk RiffChunk

Returns

byte[]

Read(byte[], int, int)

Reads bytes from the Wave File Read(byte[], int, int)

public override int Read(byte[] array, int offset, int count)

Parameters

array byte[]

offset int

count int

Returns

int

ReadNextSampleFrame()

Attempts to read the next sample or group of samples as floating point normalised into the range -1.0f to 1.0f

public float[] ReadNextSampleFrame()

Returns

float[]

An array of samples, 1 for mono, 2 for stereo etc. Null indicates end of file reached

TryReadFloat(out float)

Attempts to read a sample into a float. n.b. only applicable for uncompressed formats Will normalise the value read into the range -1.0f to 1.0f if it comes from a PCM encoding

[Obsolete("Use ReadNextSampleFrame instead (this version does not support stereo properly)")]
public bool TryReadFloat(out float sampleValue)

Parameters

sampleValue float

Returns

bool

False if the end of the WAV data chunk was reached