AudioResampler.h revision 01d3acba9de861cb2b718338e787cff3566fc5ec
165ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian/* 265ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian * Copyright (C) 2007 The Android Open Source Project 365ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian * 465ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian * Licensed under the Apache License, Version 2.0 (the "License"); 565ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian * you may not use this file except in compliance with the License. 665ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian * You may obtain a copy of the License at 765ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian * 865ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian * http://www.apache.org/licenses/LICENSE-2.0 965ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian * 1065ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian * Unless required by applicable law or agreed to in writing, software 1165ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian * distributed under the License is distributed on an "AS IS" BASIS, 1265ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1365ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian * See the License for the specific language governing permissions and 1465ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian * limitations under the License. 1565ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian */ 1665ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 1765ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian#ifndef ANDROID_AUDIO_RESAMPLER_H 1865ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian#define ANDROID_AUDIO_RESAMPLER_H 1965ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 2065ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian#include <stdint.h> 2165ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian#include <sys/types.h> 22e762be91c3280d837b1d48455cba90459ced7511Mathias Agopian#include <cutils/compiler.h> 2365ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 242dd4bdd715f586d4d30cf90cc6fc2bbfbce60fe0Glenn Kasten#include <media/AudioBufferProvider.h> 2565ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 2665ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopiannamespace android { 2765ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian// ---------------------------------------------------------------------------- 2865ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 29e762be91c3280d837b1d48455cba90459ced7511Mathias Agopianclass ANDROID_API AudioResampler { 3065ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopianpublic: 3165ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian // Determines quality of SRC. 3265ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian // LOW_QUALITY: linear interpolator (1st order) 3365ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian // MED_QUALITY: cubic interpolator (3rd order) 3465ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian // HIGH_QUALITY: fixed multi-tap FIR (e.g. 48KHz->44.1KHz) 3565ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian // NOTE: high quality SRC will only be supported for 3665ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian // certain fixed rate conversions. Sample rate cannot be 37e53b9ead781c36e96d6b6f012ddffc93a3d80f0dGlenn Kasten // changed dynamically. 3865ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian enum src_quality { 39ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten DEFAULT_QUALITY=0, 4065ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian LOW_QUALITY=1, 4165ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian MED_QUALITY=2, 4276b111685010e1fea7c0a865c038aee35507fde4SathishKumar Mani HIGH_QUALITY=3, 43ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten VERY_HIGH_QUALITY=4, 4486eae0e5931103e040ac2cdd023ef5db252e09f6Andy Hung DYN_LOW_QUALITY=5, 4586eae0e5931103e040ac2cdd023ef5db252e09f6Andy Hung DYN_MED_QUALITY=6, 4686eae0e5931103e040ac2cdd023ef5db252e09f6Andy Hung DYN_HIGH_QUALITY=7, 4765ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian }; 4865ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 4965ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian static AudioResampler* create(int bitDepth, int inChannelCount, 50ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten int32_t sampleRate, src_quality quality=DEFAULT_QUALITY); 5165ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 5265ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian virtual ~AudioResampler(); 5365ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 5465ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian virtual void init() = 0; 5565ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian virtual void setSampleRate(int32_t inSampleRate); 5665ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian virtual void setVolume(int16_t left, int16_t right); 574ff14bae91075eb274eb1c2975982358946e7e63John Grossman virtual void setLocalTimeFreq(uint64_t freq); 584ff14bae91075eb274eb1c2975982358946e7e63John Grossman 594ff14bae91075eb274eb1c2975982358946e7e63John Grossman // set the PTS of the next buffer output by the resampler 604ff14bae91075eb274eb1c2975982358946e7e63John Grossman virtual void setPTS(int64_t pts); 6165ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 6234af02647b387a252fb02bab8e2cb9f7bd9c8abbGlenn Kasten // Resample int16_t samples from provider and accumulate into 'out'. 6334af02647b387a252fb02bab8e2cb9f7bd9c8abbGlenn Kasten // A mono provider delivers a sequence of samples. 6434af02647b387a252fb02bab8e2cb9f7bd9c8abbGlenn Kasten // A stereo provider delivers a sequence of interleaved pairs of samples. 6534af02647b387a252fb02bab8e2cb9f7bd9c8abbGlenn Kasten // Multi-channel providers are not supported. 6634af02647b387a252fb02bab8e2cb9f7bd9c8abbGlenn Kasten // In either case, 'out' holds interleaved pairs of fixed-point signed Q19.12. 6734af02647b387a252fb02bab8e2cb9f7bd9c8abbGlenn Kasten // That is, for a mono provider, there is an implicit up-channeling. 6834af02647b387a252fb02bab8e2cb9f7bd9c8abbGlenn Kasten // Since this method accumulates, the caller is responsible for clearing 'out' initially. 6934af02647b387a252fb02bab8e2cb9f7bd9c8abbGlenn Kasten // FIXME assumes provider is always successful; it should return the actual frame count. 7065ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian virtual void resample(int32_t* out, size_t outFrameCount, 7165ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian AudioBufferProvider* provider) = 0; 7265ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 73243f5f91755c01614a8cafe90b0806396e22d553Eric Laurent virtual void reset(); 74c59c004a3a6042c0990d71179f88eee2ce781e3cGlenn Kasten virtual size_t getUnreleasedFrames() const { return mInputIndex; } 75243f5f91755c01614a8cafe90b0806396e22d553Eric Laurent 76ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten // called from destructor, so must not be virtual 77ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten src_quality getQuality() const { return mQuality; } 78ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten 7965ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopianprotected: 8065ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian // number of bits for phase fraction - 30 bits allows nearly 2x downsampling 8165ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian static const int kNumPhaseBits = 30; 8265ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 8365ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian // phase mask for fraction 8465ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian static const uint32_t kPhaseMask = (1LU<<kNumPhaseBits)-1; 8565ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 8665ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian // multiplier to calculate fixed point phase increment 8701d3acba9de861cb2b718338e787cff3566fc5ecGlenn Kasten static const double kPhaseMultiplier; 8865ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 89ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten AudioResampler(int bitDepth, int inChannelCount, int32_t sampleRate, src_quality quality); 9065ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 9165ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian // prevent copying 9265ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian AudioResampler(const AudioResampler&); 9365ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian AudioResampler& operator=(const AudioResampler&); 9465ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 954ff14bae91075eb274eb1c2975982358946e7e63John Grossman int64_t calculateOutputPTS(int outputFrameIndex); 964ff14bae91075eb274eb1c2975982358946e7e63John Grossman 97004f719467c498942c40de9f260be601ee45e630Glenn Kasten const int32_t mBitDepth; 98004f719467c498942c40de9f260be601ee45e630Glenn Kasten const int32_t mChannelCount; 99004f719467c498942c40de9f260be601ee45e630Glenn Kasten const int32_t mSampleRate; 10065ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian int32_t mInSampleRate; 10165ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian AudioBufferProvider::Buffer mBuffer; 10265ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian union { 10365ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian int16_t mVolume[2]; 10465ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian uint32_t mVolumeRL; 10565ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian }; 10665ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian int16_t mTargetVolume[2]; 10765ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian size_t mInputIndex; 10865ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian int32_t mPhaseIncrement; 10965ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian uint32_t mPhaseFraction; 1104ff14bae91075eb274eb1c2975982358946e7e63John Grossman uint64_t mLocalTimeFreq; 1114ff14bae91075eb274eb1c2975982358946e7e63John Grossman int64_t mPTS; 112ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten 113ac6020508acedd316391dee42329040bf45f8d90Glenn Kastenprivate: 114ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten const src_quality mQuality; 115ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten 116ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten // Return 'true' if the quality level is supported without explicit request 117ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten static bool qualityIsSupported(src_quality quality); 118ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten 119ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten // For pthread_once() 120ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten static void init_routine(); 121ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten 122ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten // Return the estimated CPU load for specific resampler in MHz. 123ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten // The absolute number is irrelevant, it's the relative values that matter. 124ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten static uint32_t qualityMHz(src_quality quality); 12565ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian}; 12665ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 12765ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian// ---------------------------------------------------------------------------- 12865ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian} 12965ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian; // namespace android 13065ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 13165ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian#endif // ANDROID_AUDIO_RESAMPLER_H 132