#include <TResamplerLinear.hpp>

Collaboration diagram for tklb::ResamplerLinearTpl< T, Buffer >:

Public Member Functions
	ResamplerLinearTpl (uint rateIn, uint rateOut, uint maxBlock=512, uchar channels=2, uchar quality=5)

	ResamplerLinearTpl ()=default

bool	init (uint rateIn, uint rateOut, uint maxBlock=512, uchar channels=2, uchar quality=5)
	setup the resampler More...

Size	process (const Buffer &in, Buffer &out)
	Resample function Make sure the out buffer has enough space. More...

int	getLatency () const
	Get the latency in samples. More...

Size	estimateNeed (const Size out) const
	Estimate how many samples need to be put in to get n samples out. More...

Size	estimateOut (const Size in) const

bool	isInitialized () const

Size	calculateBufferSize (Size in)
	Calculate a buffersize fit for the resampled result. More...

Static Public Member Functions
static void	resample (Buffer &buffer, const uint rateOut, const uchar quality=5)
	Resamples the provided buffer from its sampleRate to the target rate. More...

Private Types
using	uchar = unsigned char

using	uint = unsigned int

using	Size = typename Buffer::Size

Private Attributes
uint	mRateIn

uint	mRateOut

double	mFactor = 1.0

T	mOffset = 0

T	mLastFrame [MAX_CHANNELS]

Static Private Attributes
static constexpr Size	MAX_CHANNELS = 32

Detailed Description

template<typename T, class Buffer = AudioBufferTpl<T>>
class tklb::ResamplerLinearTpl< T, Buffer >

Definition at line 8 of file TResamplerLinear.hpp.

Member Typedef Documentation

◆ Size

template<typename T , class Buffer = AudioBufferTpl<T>>

using tklb::ResamplerLinearTpl< T, Buffer >::Size = typename Buffer::Size

private

Definition at line 12 of file TResamplerLinear.hpp.

◆ uchar

template<typename T , class Buffer = AudioBufferTpl<T>>

using tklb::ResamplerLinearTpl< T, Buffer >::uchar = unsigned char

private

Definition at line 10 of file TResamplerLinear.hpp.

◆ uint

template<typename T , class Buffer = AudioBufferTpl<T>>

using tklb::ResamplerLinearTpl< T, Buffer >::uint = unsigned int

private

Definition at line 11 of file TResamplerLinear.hpp.

Constructor & Destructor Documentation

◆ ResamplerLinearTpl() [1/2]

template<typename T , class Buffer = AudioBufferTpl<T>>

tklb::ResamplerLinearTpl< T, Buffer >::ResamplerLinearTpl	(	uint	rateIn,
		uint	rateOut,
		uint	maxBlock = `512`,
		uchar	channels = `2`,
		uchar	quality = `5`
	)

inline

Definition at line 20 of file TResamplerLinear.hpp.

                                                                                                                  {
            for (auto& i : mLastFrame) { i = 0.0; }
            init(rateIn, rateOut, maxBlock, quality);
        }

Here is the call graph for this function:

◆ ResamplerLinearTpl() [2/2]

template<typename T , class Buffer = AudioBufferTpl<T>>

tklb::ResamplerLinearTpl< T, Buffer >::ResamplerLinearTpl ( )

default

Member Function Documentation

◆ calculateBufferSize()

template<typename T , class Buffer = AudioBufferTpl<T>>

Size tklb::ResamplerLinearTpl< T, Buffer >::calculateBufferSize ( Size in )

inline

Calculate a buffersize fit for the resampled result.

Also adds a bit of padding.

Definition at line 115 of file TResamplerLinear.hpp.

                                          {
            return estimateOut(in) + 10;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ estimateNeed()

template<typename T , class Buffer = AudioBufferTpl<T>>

Size tklb::ResamplerLinearTpl< T, Buffer >::estimateNeed ( const Size out ) const

inline

Estimate how many samples need to be put in to get n samples out.

Definition at line 98 of file TResamplerLinear.hpp.

                                                {
            return std::round(out * mFactor);
        }

◆ estimateOut()

template<typename T , class Buffer = AudioBufferTpl<T>>

Size tklb::ResamplerLinearTpl< T, Buffer >::estimateOut ( const Size in ) const

inline

Definition at line 102 of file TResamplerLinear.hpp.

                                              {
            return std::round(in * (double(mRateOut) / double(mRateIn)));
        }

Here is the caller graph for this function:

◆ getLatency()

template<typename T , class Buffer = AudioBufferTpl<T>>

int tklb::ResamplerLinearTpl< T, Buffer >::getLatency ( ) const

inline

Get the latency in samples.

Definition at line 91 of file TResamplerLinear.hpp.

                               {
            return 1; // lerp wil be one sample behind
        };

◆ init()

template<typename T , class Buffer = AudioBufferTpl<T>>

bool tklb::ResamplerLinearTpl< T, Buffer >::init	(	uint	rateIn,
		uint	rateOut,
		uint	maxBlock = `512`,
		uchar	channels = `2`,
		uchar	quality = `5`
	)

inline

setup the resampler

Parameters

rateIn	Input sample rate
rateOut	Desired output samplerate
maxBlock	The maximum blocksize beeing passed into process(). Only relevant when doing non float resampling to allocate space for the conversion buffers
quality	Quality factor from 1-10. Higher results in better quality and higher CPU usage. Depending on implementataion may not do anything.

Returns: True on success

Definition at line 37 of file TResamplerLinear.hpp.

                                                                                                         {
            TKLB_ASSERT(channels <= MAX_CHANNELS)
            mRateIn = rateIn;
            mRateOut = rateOut;
            mFactor = double(mRateIn) / double(mRateOut);
            return true;
        }

Here is the caller graph for this function:

◆ isInitialized()

template<typename T , class Buffer = AudioBufferTpl<T>>

bool tklb::ResamplerLinearTpl< T, Buffer >::isInitialized ( ) const

inline

Definition at line 107 of file TResamplerLinear.hpp.

                                   {
            return true;
        };

◆ process()

template<typename T , class Buffer = AudioBufferTpl<T>>

Size tklb::ResamplerLinearTpl< T, Buffer >::process	(	const Buffer &	in,
		Buffer &	out
	)

inline

Resample function Make sure the out buffer has enough space.

Definition at line 49 of file TResamplerLinear.hpp.

                                                    {
            TKLB_ASSERT(in.sampleRate == mRateIn);
            TKLB_ASSERT(out.sampleRate == mRateOut);
            TKLB_ASSERT(in.validSize() > 0)
            TKLB_ASSERT(estimateOut(in.validSize()) <= out.size())
 
            const Size countIn = in.validSize();
            Size countOut = 0;
            const T offset = mOffset;
            T lastMix = 0;
 
            for (int c = 0; c < in.channels(); c++) {
                Size output = 0;                                    // index in output buffer
                T last = mLastFrame[c];                             // last sample
                T mix = 0.0;
                for (; output < out.size(); output++) {
                    const T position = output * mFactor;    // index in input buffer, somewhere between two samples
                    const T lastPosition = std::floor(position);    // next sample index in the input buffer
                    const Size lastIndex = lastPosition;
                    const Size nextIndex = lastPosition + 1;        // next sample index in the input buffer this is the one we need to fetch
 
                    if (countIn <= nextIndex) { break; }
 
                    mix = position - lastPosition;                  // mix factor between first and second sample
                    const T next = in[c][lastIndex];
                    out[c][output] = last + mix * (next - last);
                    // out[c][o] = next * mix + last * (T(1.0) - mix);
                    last = next; // TODO tkbl this seems like bullshit
                    // ! fix this mess since this gets carried over after one sample and no interpolation happens ?
                }
                mLastFrame[c] = last;
                lastMix = mix;
                countOut = output;
            }
            // mOffset = lastMix;
            out.setValidSize(countOut);
            return countOut;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ resample()

template<typename T , class Buffer = AudioBufferTpl<T>>

static void tklb::ResamplerLinearTpl< T, Buffer >::resample	(	Buffer &	buffer,
		const uint	rateOut,
		const uchar	quality = `5`
	)

inlinestatic

Resamples the provided buffer from its sampleRate to the target rate.

Parameters

buffer	Audiobuffer to resample, set the rate of the buffer object
rateOut	Desired output samplerate in Hz
quality	Quality from 1-10

Definition at line 126 of file TResamplerLinear.hpp.

                                                                                          {
            // TODO tklb compensate delay
            const uint rateIn = buffer.sampleRate;
            const Size samples = buffer.size();
            TKLB_ASSERT(rateIn > 0)
            // Make a copy, this could be skipped when a conversion to float is needed anyways
            Buffer copy;
            copy.resize(buffer);
            copy.set(buffer);
            copy.sampleRate = rateIn;
            copy.setValidSize(samples);
 
            ResamplerLinearTpl<T, Buffer> resampler;
            resampler.init(rateIn, rateOut, copy.size(), buffer.channels(), quality);
            buffer.resize(resampler.calculateBufferSize(samples));
 
            resampler.process(copy, buffer);
        }

Here is the call graph for this function:

Member Data Documentation

◆ MAX_CHANNELS

template<typename T , class Buffer = AudioBufferTpl<T>>

constexpr Size tklb::ResamplerLinearTpl< T, Buffer >::MAX_CHANNELS = 32

staticconstexprprivate

Definition at line 14 of file TResamplerLinear.hpp.

◆ mFactor

template<typename T , class Buffer = AudioBufferTpl<T>>

double tklb::ResamplerLinearTpl< T, Buffer >::mFactor = 1.0

private

Definition at line 16 of file TResamplerLinear.hpp.

◆ mLastFrame

template<typename T , class Buffer = AudioBufferTpl<T>>

T tklb::ResamplerLinearTpl< T, Buffer >::mLastFrame[MAX_CHANNELS]

private

Definition at line 18 of file TResamplerLinear.hpp.

◆ mOffset

template<typename T , class Buffer = AudioBufferTpl<T>>

T tklb::ResamplerLinearTpl< T, Buffer >::mOffset = 0

private

Definition at line 17 of file TResamplerLinear.hpp.

◆ mRateIn

template<typename T , class Buffer = AudioBufferTpl<T>>

uint tklb::ResamplerLinearTpl< T, Buffer >::mRateIn

private

Definition at line 15 of file TResamplerLinear.hpp.

◆ mRateOut

template<typename T , class Buffer = AudioBufferTpl<T>>

uint tklb::ResamplerLinearTpl< T, Buffer >::mRateOut

private

Definition at line 15 of file TResamplerLinear.hpp.

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

TResamplerLinear.hpp

Public Member Functions

Static Public Member Functions

Private Types

Private Attributes

Static Private Attributes

Detailed Description

Member Typedef Documentation

◆ Size

◆ uchar

◆ uint

Constructor & Destructor Documentation

◆ ResamplerLinearTpl() [1/2]

◆ ResamplerLinearTpl() [2/2]

Member Function Documentation

◆ calculateBufferSize()

◆ estimateNeed()

◆ estimateOut()

◆ getLatency()

◆ init()

◆ isInitialized()

◆ process()

◆ resample()

Member Data Documentation

◆ MAX_CHANNELS

◆ mFactor

◆ mLastFrame

◆ mOffset

◆ mRateIn

◆ mRateOut