MultiFormatReader Class Reference

MultiFormatReader reads raw audio files in different formats and machine endianness representations. More...

#include <MultiFormatReader.h>

Collaboration diagram for MultiFormatReader:

Public Types
enum	FormatT {   Int8 = 0 , Int16 , Int32 , Uint8 ,   Uint16 , Uint32 , Float , Double }

Public Member Functions
	MultiFormatReader (const char *filename)
	~MultiFormatReader ()
void	Reset ()
size_t	ReadSamples (void *buffer, size_t len, MultiFormatReader::FormatT format, MachineEndianness::EndiannessT end)
size_t	ReadSamples (void *buffer, size_t len, size_t stride, MultiFormatReader::FormatT format, MachineEndianness::EndiannessT end)

Private Member Functions
size_t	Read (void *buffer, size_t size, size_t len, size_t stride)
void	SwapBytes (void *buffer, size_t size, size_t len)

Private Attributes
FILE *	mpFid
MachineEndianness	mEnd
uint8_t	mSwapBuffer [8]

Detailed Description

MultiFormatReader reads raw audio files in different formats and machine endianness representations.

Definition at line 49 of file MultiFormatReader.h.

Member Enumeration Documentation

FormatT

enum MultiFormatReader::FormatT

Enumerator
Int8
Int16
Int32
Uint8
Uint16
Uint32
Float
Double

Definition at line 56 of file MultiFormatReader.h.

   {
      Int8 = 0,
      Int16,
      Int32,
      Uint8,
      Uint16,
      Uint32,
      Float,
      Double
   } FormatT;

Constructor & Destructor Documentation

MultiFormatReader()

MultiFormatReader::MultiFormatReader

(

const char *

filename

)

Definition at line 39 of file MultiFormatReader.cpp.

   : mpFid(NULL)
{
   mpFid = fopen(filename, "rb");
      
   if (mpFid == NULL)
   {
      throw std::runtime_error("Error opening file");
   }
}

References mpFid.

~MultiFormatReader()

MultiFormatReader::~MultiFormatReader

(

)

Definition at line 50 of file MultiFormatReader.cpp.

{
   if (mpFid != NULL)
   {
      fclose(mpFid);
   }
}

References mpFid.

Member Function Documentation

Read()

size_t MultiFormatReader::Read ( void *  buffer, size_t  size, size_t  len, size_t  stride  )

private

Definition at line 109 of file MultiFormatReader.cpp.

{
   size_t actRead = 0;
   uint8_t* pWork = (uint8_t*) buffer;
   
   if (stride > 1)
   {
      // There are gaps between consecutive samples,
      // so do a scattered read
      for (size_t n = 0; n < len; n++)
      {
         actRead += fread(&(pWork[n*size]), size, 1, mpFid);
         // FIXME: TRAP_ERR fseek return in MultiFormatReader unchecked.
         fseek(mpFid, (stride - 1) * size, SEEK_CUR);
      }
   }
   else
   {
      // Just do a linear read
      actRead = fread(buffer, size, len, mpFid);
   }
 
   return actRead;
}

References mpFid, and size.

Referenced by ReadSamples().

Here is the caller graph for this function:

ReadSamples() [1/2]

size_t MultiFormatReader::ReadSamples	(	void *	buffer,
		size_t	len,
		MultiFormatReader::FormatT	format,
		MachineEndianness::EndiannessT	end
	)

Definition at line 66 of file MultiFormatReader.cpp.

{
   return ReadSamples(buffer, len, 1, format, end);
}

References details::end(), anonymous_namespace{ExportPCM.cpp}::format, and ReadSamples().

Referenced by ReadSamples(), and FormatClassifier::ReadSignal().

Here is the call graph for this function:

Here is the caller graph for this function:

ReadSamples() [2/2]

size_t MultiFormatReader::ReadSamples	(	void *	buffer,
		size_t	len,
		size_t	stride,
		MultiFormatReader::FormatT	format,
		MachineEndianness::EndiannessT	end
	)

Definition at line 74 of file MultiFormatReader.cpp.

{
   bool swapflag = (mEnd.Which() != end);
   size_t actRead=0;
   
   switch(format)
   {
      case Int8:
      case Uint8:
         actRead = Read(buffer, 1, len, stride);
         break;
      case Int16:
      case Uint16:
         actRead = Read(buffer, 2, len, stride);
         if(swapflag) SwapBytes(buffer, 2, len);
         break;
      case Int32:
      case Uint32:
      case Float:
         actRead = Read(buffer, 4, len, stride);
         if(swapflag) SwapBytes(buffer, 4, len);
         break;
      case Double:
         actRead = Read(buffer, 8, len, stride);
         if(swapflag) SwapBytes(buffer, 8, len);
         break;
      default:
         break;
   }
 
   return actRead;
}

References Double, details::end(), Float, anonymous_namespace{ExportPCM.cpp}::format, Int16, Int32, Int8, mEnd, Read(), SwapBytes(), Uint16, Uint32, Uint8, and MachineEndianness::Which().

Here is the call graph for this function:

Reset()

void MultiFormatReader::Reset

(

)

Definition at line 58 of file MultiFormatReader.cpp.

{
   if (mpFid != NULL)
   {
      rewind(mpFid);
   }
}

References mpFid.

Referenced by FormatClassifier::ReadSignal().

Here is the caller graph for this function:

SwapBytes()

void MultiFormatReader::SwapBytes ( void *  buffer, size_t  size, size_t  len  )

private

Definition at line 135 of file MultiFormatReader.cpp.

{
   uint8_t* pResBuffer = (uint8_t*) buffer;
   uint8_t* pCurBuffer;
   
   if (size > 8)
   {
      throw std::runtime_error("SwapBytes Exception: Format width exceeding 8 bytes.");
   }
   
   for (size_t i = 0; i < len; i++)
   {
      pCurBuffer = &(pResBuffer[i*size]);
      memcpy(mSwapBuffer, &(pCurBuffer[0]), size);
      
      for (size_t n = 0; n < size; n++)
      {
         pCurBuffer[n] = mSwapBuffer[size - n - 1];   
      }
   }
}

References mSwapBuffer, and size.

Referenced by ReadSamples().

Here is the caller graph for this function:

Member Data Documentation

mEnd

MachineEndianness MultiFormatReader::mEnd

private

Definition at line 52 of file MultiFormatReader.h.

Referenced by ReadSamples().

mpFid

FILE* MultiFormatReader::mpFid

private

Definition at line 51 of file MultiFormatReader.h.

Referenced by MultiFormatReader(), Read(), Reset(), and ~MultiFormatReader().

mSwapBuffer

uint8_t MultiFormatReader::mSwapBuffer[8]

private

Definition at line 53 of file MultiFormatReader.h.

Referenced by SwapBytes().

---

The documentation for this class was generated from the following files:

• MultiFormatReader.h
• MultiFormatReader.cpp