mirror of
https://github.com/cookiengineer/audacity
synced 2025-06-17 00:20:06 +02:00
93 lines
3.5 KiB
C++
93 lines
3.5 KiB
C++
/**********************************************************************
|
|
|
|
Audacity: A Digital Audio Editor
|
|
Audacity(R) is copyright (c) 1999-2012 Audacity Team.
|
|
License: GPL v2. See License.txt.
|
|
|
|
Resample.cpp
|
|
Dominic Mazzoni, Rob Sykes, Vaughan Johnson
|
|
|
|
**********************************************************************/
|
|
|
|
#ifndef __AUDACITY_RESAMPLE_H__
|
|
#define __AUDACITY_RESAMPLE_H__
|
|
|
|
#include "Audacity.h"
|
|
|
|
#include <wx/intl.h>
|
|
#include <wx/string.h>
|
|
|
|
#include "Prefs.h"
|
|
#include "SampleFormat.h"
|
|
|
|
class Resample
|
|
{
|
|
public:
|
|
/// Resamplers may have more than one method, offering a
|
|
/// tradeoff between speed and quality.
|
|
/// Audacity identifies two methods out of all of the choices:
|
|
/// a Fast method intended for real-time audio I/O, and a Best
|
|
/// method intended for mixing and exporting.
|
|
//
|
|
/// The first parameter lets you select either the best method or
|
|
/// the fast method.
|
|
// dMinFactor and dMaxFactor specify the range of factors for variable-rate resampling.
|
|
// For constant-rate, pass the same value for both.
|
|
Resample(const bool useBestMethod, const double dMinFactor, const double dMaxFactor);
|
|
virtual ~Resample();
|
|
|
|
static int GetNumMethods();
|
|
static wxString GetMethodName(int index);
|
|
|
|
static const wxString GetFastMethodKey();
|
|
static const wxString GetBestMethodKey();
|
|
static int GetFastMethodDefault();
|
|
static int GetBestMethodDefault();
|
|
|
|
/** @brief Main processing function. Resamples from the input buffer to the
|
|
* output buffer.
|
|
*
|
|
* Reads samples from the input buffer, and writes samples to the output
|
|
* buffer. Stops when either is exhaughsted, or we reach a convenient block
|
|
* end, unless lastFlag is set to force emptying the input buffer.
|
|
* The number of input samples used is returned in inBufferUsed, and the
|
|
* number of output samples generated is the return value of the function.
|
|
* This function may do nothing if you don't pass a large enough output
|
|
* buffer (i.e. there is no where to put a full block of output data)
|
|
@param factor The scaling factor to resample by.
|
|
@param inBuffer Buffer of input samples to be processed (mono)
|
|
@param inBufferLen Length of the input buffer, in samples.
|
|
@param lastFlag Flag to indicate this is the last lot of input samples and
|
|
the buffer needs to be emptied out into the rate converter.
|
|
@param inBufferUsed Number of samples from inBuffer that have been used
|
|
(unless lastFlag is true, we don't garuntee to process all the samples in
|
|
the input this time, we may leave some for next time)
|
|
@param outBuffer Buffer to write output (converted) samples to.
|
|
@param outBufferLen How big outBuffer is.
|
|
@return Number of output samples created by this call
|
|
*/
|
|
virtual int Process(double factor,
|
|
float *inBuffer,
|
|
int inBufferLen,
|
|
bool lastFlag,
|
|
int *inBufferUsed,
|
|
float *outBuffer,
|
|
int outBufferLen);
|
|
|
|
protected:
|
|
void SetMethod(const bool useBestMethod)
|
|
{
|
|
if (useBestMethod)
|
|
mMethod = gPrefs->Read(GetBestMethodKey(), GetBestMethodDefault());
|
|
else
|
|
mMethod = gPrefs->Read(GetFastMethodKey(), GetFastMethodDefault());
|
|
};
|
|
|
|
protected:
|
|
int mMethod; // resampler-specific enum for resampling method
|
|
void* mHandle; // constant-rate or variable-rate resampler (XOR per instance)
|
|
bool mbWantConstRateResampling;
|
|
};
|
|
|
|
#endif // __AUDACITY_RESAMPLE_H__
|