SampleFormat.h File Reference

#include "MemoryX.h"
#include <cstdlib>

Include dependency graph for SampleFormat.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
class	SampleBuffer
class	GrowableSampleBuffer

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

Typedefs
using	samplePtr = char *
using	constSamplePtr = const char *
using	Floats = ArrayOf< float >
using	FloatBuffers = ArraysOf< float >
using	Doubles = ArrayOf< double >

Enumerations
enum	sampleFormat : unsigned {   int16Sample = 0x00020001 , int24Sample = 0x00040001 , floatSample = 0x0004000F , narrowestSampleFormat = int16Sample ,   widestSampleFormat = floatSample }
enum	fillFormat { fillZero = 0 , fillTwo = 2 }

Functions
MATH_API TranslatableString	GetSampleFormatStr (sampleFormat format)
MATH_API void	SamplesToFloats (constSamplePtr src, sampleFormat srcFormat, float *dst, size_t len, size_t srcStride=1, size_t dstStride=1)
	Copy samples from any format into the widest format, which is 32 bit float, with no dithering. More...
MATH_API void	CopySamples (constSamplePtr src, sampleFormat srcFormat, samplePtr dst, sampleFormat dstFormat, size_t len, DitherType ditherType=gHighQualityDither, unsigned int srcStride=1, unsigned int dstStride=1)
	Copy samples from any format to any other format; apply dithering only if narrowing the format. More...
MATH_API void	ClearSamples (samplePtr buffer, sampleFormat format, size_t start, size_t len)
MATH_API void	ReverseSamples (samplePtr buffer, sampleFormat format, int start, int len)
MATH_API void	InitDitherers ()

Variables
MATH_API DitherType	gLowQualityDither
	These global variables are assigned at application startup or after change of preferences. More...
MATH_API DitherType	gHighQualityDither

Macro Definition Documentation

SAMPLE_SIZE

#define SAMPLE_SIZE

(

SampleFormat

)

(SampleFormat >> 16)

Definition at line 44 of file SampleFormat.h.

SAMPLE_SIZE_DISK

#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 59 of file SampleFormat.h.

Typedef Documentation

constSamplePtr

using constSamplePtr = const char *

Definition at line 50 of file SampleFormat.h.

Doubles

using Doubles = ArrayOf<double>

Definition at line 200 of file SampleFormat.h.

FloatBuffers

using FloatBuffers = ArraysOf<float>

Definition at line 199 of file SampleFormat.h.

Floats

using Floats = ArrayOf<float>

Definition at line 198 of file SampleFormat.h.

samplePtr

using samplePtr = char *

Definition at line 49 of file SampleFormat.h.

Enumeration Type Documentation

fillFormat

enum fillFormat

Enumerator
fillZero
fillTwo

Definition at line 53 of file SampleFormat.h.

             {
   fillZero = 0,
   fillTwo = 2
}fillFormat;

sampleFormat

enum sampleFormat : unsigned

Enumerator
int16Sample	The increasing sequence of these enum values must correspond to the increasing data type width These values persist in saved project files, so must not be changed in later program versions
int24Sample
floatSample
narrowestSampleFormat	Two synonyms for previous values that might change if more values were added.
widestSampleFormat

Definition at line 28 of file SampleFormat.h.

{
   int16Sample = 0x00020001,
   int24Sample = 0x00040001,
   floatSample = 0x0004000F,
 
   narrowestSampleFormat = int16Sample,
   widestSampleFormat = floatSample,
};

Function Documentation

ClearSamples()

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

Definition at line 77 of file SampleFormat.cpp.

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

References format, SAMPLE_SIZE, and size.

Referenced by RingBuffer::Clear(), AudioIO::DrainRecordBuffers(), Sequence::Get(), WaveTrack::Get(), SampleBlock::GetSamples(), RingBuffer::Put(), and Sequence::SetSamples().

Here is the caller graph for this function:

CopySamples()

MATH_API void CopySamples	(	constSamplePtr	src,
		sampleFormat	srcFormat,
		samplePtr	dst,
		sampleFormat	dstFormat,
		size_t	len,
		DitherType	ditherType = gHighQualityDither,
		unsigned int	srcStride = 1,
		unsigned int	dstStride = 1
	)

Copy samples from any format to any other format; apply dithering only if narrowing the format.

Parameters

src	address of source samples
srcFormat	format of source samples, determines sizeof each one
dst	address of floating-point numbers
len	count of samples to copy
srcStride	how many samples to advance src after copying each one
dstString	how many samples to advance dst after copying each one
dstFormat	format of destination samples, determines sizeof each one
ditherType	choice of dithering algorithm to use if narrowing the format

Parameters

ditherType

default is loaded from a global variable

Definition at line 111 of file SampleFormat.cpp.

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

References Dither::Apply(), and gDitherAlgorithm.

Referenced by AUPImportFileHandle::AddSamples(), WaveClip::Append(), Sequence::ConvertToSampleFormat(), Sequence::DoAppend(), ExportPCM::Export(), RingBuffer::Get(), SqliteSampleBlock::GetBlob(), Mixer::Process(), RingBuffer::Put(), SamplesToFloats(), and Sequence::SetSamples().

Here is the call graph for this function:

Here is the caller graph for this function:

GetSampleFormatStr()

MATH_API TranslatableString GetSampleFormatStr

(

sampleFormat

format

)

Definition at line 60 of file SampleFormat.cpp.

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

References floatSample, format, int16Sample, int24Sample, and XO.

Referenced by FormatMenuTable::OnFormatChange(), Sequence::Paste(), and anonymous_namespace{WaveTrackControls.cpp}::Status2DrawFunction().

Here is the caller graph for this function:

InitDitherers()

MATH_API void InitDitherers

(

)

Definition at line 53 of file SampleFormat.cpp.

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

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

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

Here is the call graph for this function:

Here is the caller graph for this function:

ReverseSamples()

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

Definition at line 84 of file SampleFormat.cpp.

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

References floatSample, format, SAMPLE_SIZE, and size.

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

Here is the caller graph for this function:

SamplesToFloats()

MATH_API void SamplesToFloats	(	constSamplePtr	src,
		sampleFormat	srcFormat,
		float *	dst,
		size_t	len,
		size_t	srcStride = 1,
		size_t	dstStride = 1
	)

Copy samples from any format into the widest format, which is 32 bit float, with no dithering.

Parameters

src	address of source samples
srcFormat	format of source samples, determines sizeof each one
dst	address of floating-point numbers
len	count of samples to copy
srcStride	how many samples to advance src after copying each one
dstString	how many samples to advance dst after copying each one

Definition at line 102 of file SampleFormat.cpp.

{
   CopySamples( src, srcFormat,
      reinterpret_cast<samplePtr>(dst), floatSample, len,
      DitherType::none,
      srcStride, dstStride);
}

References CopySamples(), floatSample, and none.

Referenced by AudioIoCallback::AudioCallback(), SqliteSampleBlock::CalcSummary(), DoSoftwarePlaythrough(), and WaveClipWaveformCache::GetWaveDisplay().

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

gHighQualityDither

MATH_API DitherType gHighQualityDither

Definition at line 23 of file SampleFormat.h.

gLowQualityDither

MATH_API DitherType gLowQualityDither

extern

These global variables are assigned at application startup or after change of preferences.

Definition at line 49 of file SampleFormat.cpp.

Referenced by InitDitherers(), and Mixer::Process().