IAudioResampler.h

/*******************************************************************************
 * Copyright (c) 2024, 2026, Olivier Ayache.  All rights reserved.
 *
 * This file is part of AVPKit.
 *
 * AVPKit is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * AVPKit is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with AVPKit.  If not, see <http://www.gnu.org/licenses/>.
 *******************************************************************************/
 
#ifndef IAUDIORESAMPLER_H_
#define IAUDIORESAMPLER_H_
 
#include <com/avpkit/ferry/RefCounted.h>
#include <com/avpkit/core/AVPKit.h>
#include <com/avpkit/core/IAudioSamples.h>
 
namespace com { namespace avpkit { namespace core
  {
  class VS_API_AVPKIT IAudioResampler : public com::avpkit::ferry::RefCounted
  {
  public:
    virtual int getOutputChannels()=0;
    virtual int getOutputRate()=0;
    
    virtual int getInputChannels()=0;
    virtual int getInputRate()=0;
    virtual int resample(IAudioSamples *outputSamples, IAudioSamples *inputSamples,
        int32_t numSamples)=0;
    
    static IAudioResampler* make(int32_t outputChannels, int32_t inputChannels,
            int32_t outputRate, int32_t inputRate);
    
    /*
     * Added for 1.21
     */
    
    virtual IAudioSamples::Format getOutputFormat()=0;
    
    virtual IAudioSamples::Format getInputFormat()=0;
    
    virtual int32_t getFilterLen()=0;
    
    virtual int32_t getLog2PhaseCount()=0;
    
    virtual bool isLinear()=0;
    
    virtual double getCutoffFrequency()=0;
 
    static IAudioResampler* make(int32_t outputChannels, int32_t inputChannels,
        int32_t outputRate, int32_t inputRate,
        IAudioSamples::Format outputFmt, IAudioSamples::Format inputFmt);
 
    static IAudioResampler* make(int32_t outputChannels, int32_t inputChannels,
        int32_t outputRate, int32_t inputRate,
        IAudioSamples::Format outputFmt, IAudioSamples::Format inputFmt,
        int32_t filterLen, int32_t log2PhaseCount,
        bool isLinear, double cutoffFrequency);
 
  protected:
    IAudioResampler();
    virtual ~IAudioResampler();
    
  public:
    /*
     * Added for 3.2
     */
    
    virtual int32_t getMinimumNumSamplesRequiredInOutputSamples(IAudioSamples* inSamples)=0;
 
    virtual int32_t getMinimumNumSamplesRequiredInOutputSamples(
        int32_t numSamples)=0;
 
  };
 
  }}}
 
#endif /*IAUDIORESAMPLER_H_*/