#include <TResamplerCosine.hpp>

Collaboration diagram for tklb::ResamplerCosineTpl< T >:

Public Member Functions
	ResamplerCosineTpl (uint rateIn, uint rateOut, uint maxBlock=512, uchar quality=5)

	ResamplerCosineTpl ()=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	Buffer = AudioBufferTpl< T >

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 tklb::ResamplerCosineTpl< T >

Definition at line 8 of file TResamplerCosine.hpp.

Member Typedef Documentation

◆ Buffer

template<typename T >

using tklb::ResamplerCosineTpl< T >::Buffer = AudioBufferTpl<T>

private

Definition at line 11 of file TResamplerCosine.hpp.

◆ Size

template<typename T >

using tklb::ResamplerCosineTpl< T >::Size = typename Buffer::Size

private

Definition at line 12 of file TResamplerCosine.hpp.

◆ uchar

template<typename T >

using tklb::ResamplerCosineTpl< T >::uchar = unsigned char

private

Definition at line 9 of file TResamplerCosine.hpp.

◆ uint

template<typename T >

using tklb::ResamplerCosineTpl< T >::uint = unsigned int

private

Definition at line 10 of file TResamplerCosine.hpp.

Constructor & Destructor Documentation

◆ ResamplerCosineTpl() [1/2]

template<typename T >

tklb::ResamplerCosineTpl< T >::ResamplerCosineTpl	(	uint	rateIn,
		uint	rateOut,
		uint	maxBlock = `512`,
		uchar	quality = `5`
	)

inline

Definition at line 20 of file TResamplerCosine.hpp.

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

Here is the call graph for this function:

◆ ResamplerCosineTpl() [2/2]

template<typename T >

tklb::ResamplerCosineTpl< T >::ResamplerCosineTpl ( )

default

Member Function Documentation

◆ calculateBufferSize()

template<typename T >

Size tklb::ResamplerCosineTpl< T >::calculateBufferSize ( Size in )

inline

Calculate a buffersize fit for the resampled result.

Also adds a bit of padding.

Definition at line 113 of file TResamplerCosine.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 >

Size tklb::ResamplerCosineTpl< T >::estimateNeed ( const Size out ) const

inline

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

Definition at line 96 of file TResamplerCosine.hpp.

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

◆ estimateOut()

template<typename T >

Size tklb::ResamplerCosineTpl< T >::estimateOut ( const Size in ) const

inline

Definition at line 100 of file TResamplerCosine.hpp.

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

Here is the caller graph for this function:

◆ getLatency()

template<typename T >

int tklb::ResamplerCosineTpl< T >::getLatency ( ) const

inline

Get the latency in samples.

Definition at line 89 of file TResamplerCosine.hpp.

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

◆ init()

template<typename T >

bool tklb::ResamplerCosineTpl< T >::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 TResamplerCosine.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 >

bool tklb::ResamplerCosineTpl< T >::isInitialized ( ) const

inline

Definition at line 105 of file TResamplerCosine.hpp.

                                   {
            return true;
        };

◆ process()

template<typename T >

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

inline

Resample function Make sure the out buffer has enough space.

Definition at line 49 of file TResamplerCosine.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; }
 
                    const T next = in[c][lastIndex];
                    T mix = 0.5 * (1.0 - cos((position - lastPosition) * 3.1416));
                    out[c][output] = last + mix * (next - last);
                    last = next;
                }
                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 >

static void tklb::ResamplerCosineTpl< T >::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 124 of file TResamplerCosine.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);
 
            ResamplerCosineTpl<T> resampler;
            resampler.init(rateIn, rateOut, copy.size(), 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 >

constexpr Size tklb::ResamplerCosineTpl< T >::MAX_CHANNELS = 32

staticconstexprprivate

Definition at line 17 of file TResamplerCosine.hpp.

◆ mFactor

template<typename T >

double tklb::ResamplerCosineTpl< T >::mFactor = 1.0

private

Definition at line 15 of file TResamplerCosine.hpp.

◆ mLastFrame

template<typename T >

T tklb::ResamplerCosineTpl< T >::mLastFrame[MAX_CHANNELS]

private

Definition at line 18 of file TResamplerCosine.hpp.

◆ mOffset

template<typename T >

T tklb::ResamplerCosineTpl< T >::mOffset = 0

private

Definition at line 16 of file TResamplerCosine.hpp.

◆ mRateIn

template<typename T >

uint tklb::ResamplerCosineTpl< T >::mRateIn

private

Definition at line 14 of file TResamplerCosine.hpp.

◆ mRateOut

template<typename T >

uint tklb::ResamplerCosineTpl< T >::mRateOut

private

Definition at line 14 of file TResamplerCosine.hpp.

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

TResamplerCosine.hpp

Public Member Functions

Static Public Member Functions

Private Types

Private Attributes

Static Private Attributes

Detailed Description

Member Typedef Documentation

◆ Buffer

◆ Size

◆ uchar

◆ uint

Constructor & Destructor Documentation

◆ ResamplerCosineTpl() [1/2]

◆ ResamplerCosineTpl() [2/2]

Member Function Documentation

◆ calculateBufferSize()

◆ estimateNeed()

◆ estimateOut()

◆ getLatency()

◆ init()

◆ isInitialized()

◆ process()

◆ resample()

Member Data Documentation

◆ MAX_CHANNELS

◆ mFactor

◆ mLastFrame

◆ mOffset

◆ mRateIn

◆ mRateOut