#include <TResamplerHold.hpp>

Collaboration diagram for tklb::ResamplerHoldTpl< T >:

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

bool	init (uint rateIn, uint rateOut, uint maxBlock=512, 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
	Estimate how many sample will be emitted in the next step. More...

bool	isInitialized () const

Size	calculateBufferSize (Size initialSize)
	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

Detailed Description

template<typename T>
class tklb::ResamplerHoldTpl< T >

Definition at line 8 of file TResamplerHold.hpp.

Member Typedef Documentation

◆ Buffer

template<typename T >

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

private

Definition at line 11 of file TResamplerHold.hpp.

◆ Size

template<typename T >

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

private

Definition at line 12 of file TResamplerHold.hpp.

◆ uchar

template<typename T >

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

private

Definition at line 9 of file TResamplerHold.hpp.

◆ uint

template<typename T >

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

private

Definition at line 10 of file TResamplerHold.hpp.

Constructor & Destructor Documentation

◆ ResamplerHoldTpl()

template<typename T >

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

inline

Definition at line 17 of file TResamplerHold.hpp.

                                                                                            {
            init(rateIn, rateOut, maxBlock, quality);
        }

Here is the call graph for this function:

Member Function Documentation

◆ calculateBufferSize()

template<typename T >

Size tklb::ResamplerHoldTpl< T >::calculateBufferSize ( Size initialSize )

inline

Calculate a buffersize fit for the resampled result.

Also adds a bit of padding.

Definition at line 86 of file TResamplerHold.hpp.

                                                   {
            return estimateOut(initialSize) + 10;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ estimateNeed()

template<typename T >

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

inline

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

Definition at line 67 of file TResamplerHold.hpp.

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

◆ estimateOut()

template<typename T >

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

inline

Estimate how many sample will be emitted in the next step.

Definition at line 74 of file TResamplerHold.hpp.

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

Here is the caller graph for this function:

◆ getLatency()

template<typename T >

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

inline

Get the latency in samples.

Definition at line 62 of file TResamplerHold.hpp.

62{ return 0; };

◆ init()

template<typename T >

bool tklb::ResamplerHoldTpl< T >::init	(	uint	rateIn,
		uint	rateOut,
		uint	maxBlock = `512`,
		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 31 of file TResamplerHold.hpp.

                                                                                     {
            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::ResamplerHoldTpl< T >::isInitialized ( ) const

inline

Definition at line 78 of file TResamplerHold.hpp.

                                   {
            return true;
        };

◆ process()

template<typename T >

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

inline

Resample function Make sure the out buffer has enough space.

Definition at line 42 of file TResamplerHold.hpp.

                                                    {
            const Size countIn = in.validSize();
            Size countOut = 0;
 
            for (int c = 0; c < in.channels(); c++) {
                Size output = 0;                                        // index in output buffer
                for (; output < out.size(); output++) {
                    const Size index = std::round(output * mFactor);    // closest sample
                    if (countIn <= index) { break; }
                    out[c][output] = in[c][index];
                }
                countOut = output;
            }
            out.setValidSize(countOut);
            return countOut;
        }

Here is the caller graph for this function:

◆ resample()

template<typename T >

static void tklb::ResamplerHoldTpl< 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 97 of file TResamplerHold.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);
 
            ResamplerHoldTpl<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

◆ mFactor

template<typename T >

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

private

Definition at line 14 of file TResamplerHold.hpp.

◆ mRateIn

template<typename T >

uint tklb::ResamplerHoldTpl< T >::mRateIn

private

Definition at line 13 of file TResamplerHold.hpp.

◆ mRateOut

template<typename T >

uint tklb::ResamplerHoldTpl< T >::mRateOut

private

Definition at line 13 of file TResamplerHold.hpp.

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

TResamplerHold.hpp

Public Member Functions

Static Public Member Functions

Private Types

Private Attributes

Detailed Description

Member Typedef Documentation

◆ Buffer

◆ Size

◆ uchar

◆ uint

Constructor & Destructor Documentation

◆ ResamplerHoldTpl()

Member Function Documentation

◆ calculateBufferSize()

◆ estimateNeed()

◆ estimateOut()

◆ getLatency()

◆ init()

◆ isInitialized()

◆ process()

◆ resample()

Member Data Documentation

◆ mFactor

◆ mRateIn

◆ mRateOut