An interpolator base class for resampling streams of floats. More...

#include <juce_GenericInterpolator.h>

Collaboration diagram for juce::GenericInterpolator< InterpolatorTraits, memorySize >:

[legend]

Public Member Functions
	GenericInterpolator () noexcept

	GenericInterpolator (GenericInterpolator &&) noexcept=default

GenericInterpolator &	operator= (GenericInterpolator &&) noexcept=default

int	process (double speedRatio, const float inputSamples, float outputSamples, int numOutputSamplesToProduce) noexcept
	Resamples a stream of samples. More...

int	process (double speedRatio, const float inputSamples, float outputSamples, int numOutputSamplesToProduce, int numInputSamplesAvailable, int wrapAround) noexcept
	Resamples a stream of samples. More...

int	processAdding (double speedRatio, const float inputSamples, float outputSamples, int numOutputSamplesToProduce, float gain) noexcept
	Resamples a stream of samples, adding the results to the output data with a gain. More...

int	processAdding (double speedRatio, const float inputSamples, float outputSamples, int numOutputSamplesToProduce, int numInputSamplesAvailable, int wrapAround, float gain) noexcept
	Resamples a stream of samples, adding the results to the output data with a gain. More...

void	reset () noexcept
	Resets the state of the interpolator. More...

Static Public Member Functions
static constexpr float	getBaseLatency () noexcept
	Returns the latency of the interpolation algorithm in isolation. More...

Private Member Functions
int	interpolate (double speedRatio, const float input, float output, int numOutputSamplesToProduce) noexcept

int	interpolate (double speedRatio, const float input, float output, int numOutputSamplesToProduce, int numInputSamplesAvailable, int wrap) noexcept

int	interpolateAdding (double speedRatio, const float input, float output, int numOutputSamplesToProduce, float gain) noexcept

int	interpolateAdding (double speedRatio, const float input, float output, int numOutputSamplesToProduce, int numInputSamplesAvailable, int wrap, float gain) noexcept

forcedinline void	pushInterpolationSample (float newValue) noexcept

forcedinline void	pushInterpolationSamples (const float *input, int numOutputSamplesToProduce) noexcept

forcedinline void	pushInterpolationSamples (const float *input, int numOutputSamplesToProduce, int numInputSamplesAvailable, int wrapAround) noexcept

Private Attributes
int	indexBuffer = 0

float	lastInputSamples [(size_t) memorySize]

double	subSamplePos = 1.0

Detailed Description

template<class InterpolatorTraits, int memorySize>
class juce::GenericInterpolator< InterpolatorTraits, memorySize >

An interpolator base class for resampling streams of floats.

Note that the resamplers are stateful, so when there's a break in the continuity of the input stream you're feeding it, you should call reset() before feeding it any new data. And like with any other stateful filter, if you're resampling multiple channels, make sure each one uses its own interpolator object.

See also: LagrangeInterpolator, CatmullRomInterpolator, WindowedSincInterpolator, LinearInterpolator, ZeroOrderHoldInterpolator

@tags{Audio}

Constructor & Destructor Documentation

◆ GenericInterpolator() [1/2]

template<class InterpolatorTraits , int memorySize>

juce::GenericInterpolator< InterpolatorTraits, memorySize >::GenericInterpolator ( )

inlinenoexcept

References juce::gl::reset.

◆ GenericInterpolator() [2/2]

template<class InterpolatorTraits , int memorySize>

juce::GenericInterpolator< InterpolatorTraits, memorySize >::GenericInterpolator ( GenericInterpolator< InterpolatorTraits, memorySize > && )

defaultnoexcept

Member Function Documentation

◆ getBaseLatency()

template<class InterpolatorTraits , int memorySize>

static constexpr float juce::GenericInterpolator< InterpolatorTraits, memorySize >::getBaseLatency ( )

inlinestaticconstexprnoexcept

Returns the latency of the interpolation algorithm in isolation.

In the context of resampling the total latency of a process using the interpolator is the base latency divided by the speed ratio.

◆ interpolate() [1/2]

template<class InterpolatorTraits , int memorySize>

int juce::GenericInterpolator< InterpolatorTraits, memorySize >::interpolate	(	double	speedRatio,
		const float *	input,
		float *	output,
		int	numOutputSamplesToProduce
	)

inlineprivatenoexcept

References juce::gl::input, and juce::gl::output.

◆ interpolate() [2/2]

template<class InterpolatorTraits , int memorySize>

int juce::GenericInterpolator< InterpolatorTraits, memorySize >::interpolate	(	double	speedRatio,
		const float *	input,
		float *	output,
		int	numOutputSamplesToProduce,
		int	numInputSamplesAvailable,
		int	wrap
	)

inlineprivatenoexcept

References juce::gl::f, juce::gl::input, juce::jmax(), and juce::gl::output.

◆ interpolateAdding() [1/2]

template<class InterpolatorTraits , int memorySize>

int juce::GenericInterpolator< InterpolatorTraits, memorySize >::interpolateAdding	(	double	speedRatio,
		const float *	input,
		float *	output,
		int	numOutputSamplesToProduce,
		float	gain
	)

inlineprivatenoexcept

References juce::gl::input, and juce::gl::output.

◆ interpolateAdding() [2/2]

template<class InterpolatorTraits , int memorySize>

int juce::GenericInterpolator< InterpolatorTraits, memorySize >::interpolateAdding	(	double	speedRatio,
		const float *	input,
		float *	output,
		int	numOutputSamplesToProduce,
		int	numInputSamplesAvailable,
		int	wrap,
		float	gain
	)

inlineprivatenoexcept

References juce::gl::f, juce::gl::input, juce::jmax(), and juce::gl::output.

◆ operator=()

template<class InterpolatorTraits , int memorySize>

GenericInterpolator& juce::GenericInterpolator< InterpolatorTraits, memorySize >::operator= ( GenericInterpolator< InterpolatorTraits, memorySize > && )

defaultnoexcept

◆ process() [1/2]

template<class InterpolatorTraits , int memorySize>

int juce::GenericInterpolator< InterpolatorTraits, memorySize >::process	(	double	speedRatio,
		const float *	inputSamples,
		float *	outputSamples,
		int	numOutputSamplesToProduce
	)

inlinenoexcept

Resamples a stream of samples.

Parameters

speedRatio	the number of input samples to use for each output sample
inputSamples	the source data to read from. This must contain at least (speedRatio * numOutputSamplesToProduce) samples.
outputSamples	the buffer to write the results into
numOutputSamplesToProduce	the number of output samples that should be created

Returns: the actual number of input samples that were used

◆ process() [2/2]

template<class InterpolatorTraits , int memorySize>

int juce::GenericInterpolator< InterpolatorTraits, memorySize >::process	(	double	speedRatio,
		const float *	inputSamples,
		float *	outputSamples,
		int	numOutputSamplesToProduce,
		int	numInputSamplesAvailable,
		int	wrapAround
	)

inlinenoexcept

Resamples a stream of samples.

Parameters

speedRatio	the number of input samples to use for each output sample
inputSamples	the source data to read from. This must contain at least (speedRatio * numOutputSamplesToProduce) samples.
outputSamples	the buffer to write the results into
numOutputSamplesToProduce	the number of output samples that should be created
numInputSamplesAvailable	the number of available input samples. If it needs more samples than available, it either wraps back for wrapAround samples, or it feeds zeroes
wrapAround	if the stream exceeds available samples, it wraps back for wrapAround samples. If wrapAround is set to 0, it will feed zeroes.

Returns: the actual number of input samples that were used

◆ processAdding() [1/2]

template<class InterpolatorTraits , int memorySize>

int juce::GenericInterpolator< InterpolatorTraits, memorySize >::processAdding	(	double	speedRatio,
		const float *	inputSamples,
		float *	outputSamples,
		int	numOutputSamplesToProduce,
		float	gain
	)

inlinenoexcept

Resamples a stream of samples, adding the results to the output data with a gain.

Parameters

speedRatio	the number of input samples to use for each output sample
inputSamples	the source data to read from. This must contain at least (speedRatio * numOutputSamplesToProduce) samples.
outputSamples	the buffer to write the results to - the result values will be added to any pre-existing data in this buffer after being multiplied by the gain factor
numOutputSamplesToProduce	the number of output samples that should be created
gain	a gain factor to multiply the resulting samples by before adding them to the destination buffer

Returns: the actual number of input samples that were used

◆ processAdding() [2/2]

template<class InterpolatorTraits , int memorySize>

int juce::GenericInterpolator< InterpolatorTraits, memorySize >::processAdding	(	double	speedRatio,
		const float *	inputSamples,
		float *	outputSamples,
		int	numOutputSamplesToProduce,
		int	numInputSamplesAvailable,
		int	wrapAround,
		float	gain
	)

inlinenoexcept

Resamples a stream of samples, adding the results to the output data with a gain.

Parameters

speedRatio	the number of input samples to use for each output sample
inputSamples	the source data to read from. This must contain at least (speedRatio * numOutputSamplesToProduce) samples.
outputSamples	the buffer to write the results to - the result values will be added to any pre-existing data in this buffer after being multiplied by the gain factor
numOutputSamplesToProduce	the number of output samples that should be created
numInputSamplesAvailable	the number of available input samples. If it needs more samples than available, it either wraps back for wrapAround samples, or it feeds zeroes
wrapAround	if the stream exceeds available samples, it wraps back for wrapAround samples. If wrapAround is set to 0, it will feed zeroes.
gain	a gain factor to multiply the resulting samples by before adding them to the destination buffer

Returns: the actual number of input samples that were used

◆ pushInterpolationSample()

template<class InterpolatorTraits , int memorySize>

forcedinline void juce::GenericInterpolator< InterpolatorTraits, memorySize >::pushInterpolationSample ( float newValue )

inlineprivatenoexcept

◆ pushInterpolationSamples() [1/2]

template<class InterpolatorTraits , int memorySize>

forcedinline void juce::GenericInterpolator< InterpolatorTraits, memorySize >::pushInterpolationSamples	(	const float *	input,
		int	numOutputSamplesToProduce
	)

inlineprivatenoexcept

References juce::gl::input.

◆ pushInterpolationSamples() [2/2]

template<class InterpolatorTraits , int memorySize>

forcedinline void juce::GenericInterpolator< InterpolatorTraits, memorySize >::pushInterpolationSamples	(	const float *	input,
		int	numOutputSamplesToProduce,
		int	numInputSamplesAvailable,
		int	wrapAround
	)

inlineprivatenoexcept

References juce::gl::f, and juce::gl::input.

◆ reset()

template<class InterpolatorTraits , int memorySize>

void juce::GenericInterpolator< InterpolatorTraits, memorySize >::reset ( )

inlinenoexcept

Resets the state of the interpolator.

Call this when there's a break in the continuity of the input data stream.

References juce::begin(), juce::gl::end, and juce::gl::f.

Member Data Documentation

◆ indexBuffer

template<class InterpolatorTraits , int memorySize>

int juce::GenericInterpolator< InterpolatorTraits, memorySize >::indexBuffer = 0

private

◆ lastInputSamples

template<class InterpolatorTraits , int memorySize>

float juce::GenericInterpolator< InterpolatorTraits, memorySize >::lastInputSamples[(size_t) memorySize]

private

◆ subSamplePos

template<class InterpolatorTraits , int memorySize>

double juce::GenericInterpolator< InterpolatorTraits, memorySize >::subSamplePos = 1.0

private

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

juce_GenericInterpolator.h

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

template<class InterpolatorTraits, int memorySize> class juce::GenericInterpolator< InterpolatorTraits, memorySize >

Constructor & Destructor Documentation

◆ GenericInterpolator() [1/2]

◆ GenericInterpolator() [2/2]

Member Function Documentation

◆ getBaseLatency()

◆ interpolate() [1/2]

◆ interpolate() [2/2]

◆ interpolateAdding() [1/2]

◆ interpolateAdding() [2/2]

◆ operator=()

◆ process() [1/2]

◆ process() [2/2]

◆ processAdding() [1/2]

◆ processAdding() [2/2]

◆ pushInterpolationSample()

◆ pushInterpolationSamples() [1/2]

◆ pushInterpolationSamples() [2/2]

◆ reset()

Member Data Documentation

◆ indexBuffer

◆ lastInputSamples

◆ subSamplePos

template<class InterpolatorTraits, int memorySize>
class juce::GenericInterpolator< InterpolatorTraits, memorySize >