SampleFormat.h File Reference

#include "Audacity.h"
#include "MemoryX.h"
#include <wx/defs.h>
#include "audacity/Types.h"

Go to the source code of this file.

Classes
class	SampleBuffer
class	GrowableSampleBuffer

Macros
#define	SAMPLE_SIZE_DISK(SampleFormat)
	Return the size on disk of one uncompressed sample (bytes) More...

Typedefs
using	Floats = ArrayOf< float >
using	FloatBuffers = ArraysOf< float >
using	Doubles = ArrayOf< double >

Enumerations
enum	fillFormat { fillZero = 0, fillTwo = 2 }

Functions
const wxChar *	GetSampleFormatStr (sampleFormat format)
void	CopySamples (samplePtr src, sampleFormat srcFormat, samplePtr dst, sampleFormat dstFormat, unsigned int len, bool highQuality=true, unsigned int srcStride=1, unsigned int dstStride=1)
void	CopySamplesNoDither (samplePtr src, sampleFormat srcFormat, samplePtr dst, sampleFormat dstFormat, unsigned int len, unsigned int srcStride=1, unsigned int dstStride=1)
void	ClearSamples (samplePtr buffer, sampleFormat format, size_t start, size_t len)
void	ReverseSamples (samplePtr buffer, sampleFormat format, int start, int len)
void	InitDitherers ()

Macro Definition Documentation

#define SAMPLE_SIZE_DISK

(

SampleFormat

)

Value:

(((SampleFormat) == int24Sample) ? \
   size_t{ 3 } : SAMPLE_SIZE(SampleFormat) )

Return the size on disk of one uncompressed sample (bytes)

Definition at line 43 of file SampleFormat.h.

Referenced by AudacityProject::GetEstimatedRecordingMinsLeftOnDisk(), and SimpleBlockFile::GetSpaceUsage().

Typedef Documentation

using Doubles = ArrayOf<double>

Definition at line 155 of file SampleFormat.h.

using FloatBuffers = ArraysOf<float>

Definition at line 154 of file SampleFormat.h.

using Floats = ArrayOf<float>

Definition at line 153 of file SampleFormat.h.

Enumeration Type Documentation

enum fillFormat

Enumerator
fillZero
fillTwo

Definition at line 37 of file SampleFormat.h.

             {
   fillZero = 0,
   fillTwo = 2
}fillFormat;

Function Documentation

void ClearSamples	(	samplePtr	buffer,
		sampleFormat	format,
		size_t	start,
		size_t	len
	)

Definition at line 77 of file SampleFormat.cpp.

References SAMPLE_SIZE.

Referenced by audacityAudioCallback(), RingBuffer::Clear(), BlockFile::CommonReadData(), AudioIO::FillBuffers(), Sequence::Get(), WaveTrack::Get(), ODDecodeBlockFile::Read256(), ODPCMAliasBlockFile::Read256(), ODDecodeBlockFile::Read64K(), ODPCMAliasBlockFile::Read64K(), SilentBlockFile::ReadData(), SimpleBlockFile::ReadData(), ODDecodeBlockFile::ReadData(), and Sequence::SetSamples().

{
   auto size = SAMPLE_SIZE(format);
   memset(dst + start*size, 0, len*size);
}

void CopySamples	(	samplePtr	src,
		sampleFormat	srcFormat,
		samplePtr	dst,
		sampleFormat	dstFormat,
		unsigned int	len,
		bool	highQuality = true,
		unsigned int	srcStride = 1,
		unsigned int	dstStride = 1
	)

Definition at line 102 of file SampleFormat.cpp.

References Dither::Apply(), gHighQualityDither, and gLowQualityDither.

Referenced by Sequence::Append(), WaveClip::Append(), audacityAudioCallback(), ODPCMAliasBlockFile::CalcSummary(), ODDecodeBlockFile::CalcSummary(), BlockFile::CalcSummary(), BlockFile::CommonReadData(), ComputeLegacySummaryInfo(), Sequence::ConvertToSampleFormat(), DoSoftwarePlaythrough(), RingBuffer::Get(), NyquistEffect::GetCallback(), WaveClip::GetWaveDisplay(), Mixer::Process(), RingBuffer::Put(), BlockFile::Read256(), BlockFile::Read64K(), SimpleBlockFile::ReadData(), and Sequence::SetSamples().

{
   gDitherAlgorithm.Apply(
      highQuality ? gHighQualityDither : gLowQualityDither,
      src, srcFormat, dst, dstFormat, len, srcStride, dstStride);
}

void CopySamplesNoDither	(	samplePtr	src,
		sampleFormat	srcFormat,
		samplePtr	dst,
		sampleFormat	dstFormat,
		unsigned int	len,
		unsigned int	srcStride = 1,
		unsigned int	dstStride = 1
	)

Definition at line 114 of file SampleFormat.cpp.

References Dither::Apply(), and none.

{
   gDitherAlgorithm.Apply(
      DitherType::none,
      src, srcFormat, dst, dstFormat, len, srcStride, dstStride);
}

const wxChar* GetSampleFormatStr

(

sampleFormat

format

)

Definition at line 60 of file SampleFormat.cpp.

References _(), floatSample, int16Sample, and int24Sample.

Referenced by Sequence::Paste(), and TrackInfo::Status2DrawFunction().

{
   switch(format) {
   case int16Sample:
      /* i18n-hint: Audio data bit depth (precision): 16-bit integers */
      return _("16-bit PCM");
   case int24Sample:
      /* i18n-hint: Audio data bit depth (precision): 24-bit integers */
      return _("24-bit PCM");
   case floatSample:
      /* i18n-hint: Audio data bit depth (precision): 32-bit floating point */
      return _("32-bit float");
   }
   return wxT("Unknown format"); // compiler food
}

void InitDitherers

(

)

Definition at line 53 of file SampleFormat.cpp.

References QualityPrefs::BestDitherChoice(), QualityPrefs::FastDitherChoice(), gHighQualityDither, and gLowQualityDither.

Referenced by QualityPrefs::Commit(), and AudacityApp::OnInit().

{
   // Read dither preferences
   gLowQualityDither = QualityPrefs::FastDitherChoice();
   gHighQualityDither = QualityPrefs::BestDitherChoice();
}

void ReverseSamples	(	samplePtr	buffer,
		sampleFormat	format,
		int	start,
		int	len
	)

Definition at line 84 of file SampleFormat.cpp.

References floatSample, and SAMPLE_SIZE.

Referenced by Mixer::MixSameRate(), and Mixer::MixVariableRates().

{
   auto size = SAMPLE_SIZE(format);
   samplePtr first = dst + start * size;
   samplePtr last = dst + (start + len - 1) * size;
   enum : size_t { fixedSize = SAMPLE_SIZE(floatSample) };
   wxASSERT(static_cast<size_t>(size) <= fixedSize);
   char temp[fixedSize];
   while (first < last) {
      memcpy(temp, first, size);
      memcpy(first, last, size);
      memcpy(last, temp, size);
      first += size;
      last -= size;
   }
}