be.tarsos.dsp.resample

Class Resampler

java.lang.Object

be.tarsos.dsp.resample.Resampler

public class Resampler
extends java.lang.Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Resampler.Result

Constructor Summary

Constructors

Constructor and Description
Resampler(boolean highQuality, double minFactor, double maxFactor) Create a new resampling session.
Resampler(Resampler other) Clone an existing resampling session.

Method Summary

Modifier and Type	Method and Description
int	getFilterWidth()
Resampler.Result	process(double factor, float[] inBuffer, int inBufferOffset, int inBufferLen, boolean lastBatch, float[] outBuffer, int outBufferOffset, int outBufferLen) Process a batch of samples.
boolean	process(double factor, java.nio.FloatBuffer inputBuffer, boolean lastBatch, java.nio.FloatBuffer outputBuffer) Process a batch of samples.
boolean	process(double factor, be.tarsos.dsp.resample.SampleBuffers buffers, boolean lastBatch) Process a batch of samples.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Resampler

public Resampler(Resampler other)

Clone an existing resampling session. Faster than creating one from scratch.

Parameters:

other -

Resampler

public Resampler(boolean highQuality,
                 double minFactor,
                 double maxFactor)

Create a new resampling session.

Parameters:

highQuality - true for better quality, slower processing time

minFactor - lower bound on resampling factor for this session

maxFactor - upper bound on resampling factor for this session

Throws:

java.lang.IllegalArgumentException - if minFactor or maxFactor is not positive, or if maxFactor is less than minFactor

Method Detail

getFilterWidth

public int getFilterWidth()

process

public boolean process(double factor,
                       be.tarsos.dsp.resample.SampleBuffers buffers,
                       boolean lastBatch)

Process a batch of samples. There is no guarantee that the input buffer will be drained.

Parameters:

factor - factor at which to resample this batch

buffers - sample buffer for producing input and consuming output

lastBatch - true if this is known to be the last batch of samples

Returns:

true iff resampling is complete (ie. no input samples consumed and no output samples produced)

process

public boolean process(double factor,
                       java.nio.FloatBuffer inputBuffer,
                       boolean lastBatch,
                       java.nio.FloatBuffer outputBuffer)

Process a batch of samples. Convenience method for when the input and output are both floats.

Parameters:

factor - factor at which to resample this batch

inputBuffer - contains input samples in the range -1.0 to 1.0

outputBuffer - output samples will be deposited here

lastBatch - true if this is known to be the last batch of samples

Returns:

true iff resampling is complete (ie. no input samples consumed and no output samples produced)

process

public Resampler.Result process(double factor,
                                float[] inBuffer,
                                int inBufferOffset,
                                int inBufferLen,
                                boolean lastBatch,
                                float[] outBuffer,
                                int outBufferOffset,
                                int outBufferLen)

Process a batch of samples. Alternative interface if you prefer to work with arrays.

Parameters:

factor - resampling rate for this batch

inBuffer - array containing input samples in the range -1.0 to 1.0

inBufferOffset - offset into inBuffer at which to start processing

inBufferLen - number of valid elements in the inputBuffer

lastBatch - pass true if this is the last batch of samples

outBuffer - array to hold the resampled data

outBufferOffset - Offset in the output buffer.

outBufferLen - Output buffer length.

Returns:

the number of samples consumed and generated