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> 2265ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 232dd4bdd715f586d4d30cf90cc6fc2bbfbce60fe0Glenn Kasten#include <media/AudioBufferProvider.h> 2465ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 2565ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopiannamespace android { 2665ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian// ---------------------------------------------------------------------------- 2765ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 2865ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopianclass AudioResampler { 2965ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopianpublic: 3065ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian // Determines quality of SRC. 3165ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian // LOW_QUALITY: linear interpolator (1st order) 3265ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian // MED_QUALITY: cubic interpolator (3rd order) 3365ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian // HIGH_QUALITY: fixed multi-tap FIR (e.g. 48KHz->44.1KHz) 3465ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian // NOTE: high quality SRC will only be supported for 3565ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian // certain fixed rate conversions. Sample rate cannot be 36e53b9ead781c36e96d6b6f012ddffc93a3d80f0dGlenn Kasten // changed dynamically. 3765ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian enum src_quality { 38ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten DEFAULT_QUALITY=0, 3965ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian LOW_QUALITY=1, 4065ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian MED_QUALITY=2, 4176b111685010e1fea7c0a865c038aee35507fde4SathishKumar Mani HIGH_QUALITY=3, 42ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten VERY_HIGH_QUALITY=4, 4365ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian }; 4465ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 4565ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian static AudioResampler* create(int bitDepth, int inChannelCount, 46ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten int32_t sampleRate, src_quality quality=DEFAULT_QUALITY); 4765ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 4865ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian virtual ~AudioResampler(); 4965ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 5065ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian virtual void init() = 0; 5165ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian virtual void setSampleRate(int32_t inSampleRate); 5265ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian virtual void setVolume(int16_t left, int16_t right); 534ff14bae91075eb274eb1c2975982358946e7e63John Grossman virtual void setLocalTimeFreq(uint64_t freq); 544ff14bae91075eb274eb1c2975982358946e7e63John Grossman 554ff14bae91075eb274eb1c2975982358946e7e63John Grossman // set the PTS of the next buffer output by the resampler 564ff14bae91075eb274eb1c2975982358946e7e63John Grossman virtual void setPTS(int64_t pts); 5765ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 5865ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian virtual void resample(int32_t* out, size_t outFrameCount, 5965ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian AudioBufferProvider* provider) = 0; 6065ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 61243f5f91755c01614a8cafe90b0806396e22d553Eric Laurent virtual void reset(); 62c59c004a3a6042c0990d71179f88eee2ce781e3cGlenn Kasten virtual size_t getUnreleasedFrames() const { return mInputIndex; } 63243f5f91755c01614a8cafe90b0806396e22d553Eric Laurent 64ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten // called from destructor, so must not be virtual 65ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten src_quality getQuality() const { return mQuality; } 66ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten 6765ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopianprotected: 6865ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian // number of bits for phase fraction - 30 bits allows nearly 2x downsampling 6965ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian static const int kNumPhaseBits = 30; 7065ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 7165ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian // phase mask for fraction 7265ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian static const uint32_t kPhaseMask = (1LU<<kNumPhaseBits)-1; 7365ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 7465ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian // multiplier to calculate fixed point phase increment 7565ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian static const double kPhaseMultiplier = 1L << kNumPhaseBits; 7665ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 77ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten AudioResampler(int bitDepth, int inChannelCount, int32_t sampleRate, src_quality quality); 7865ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 7965ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian // prevent copying 8065ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian AudioResampler(const AudioResampler&); 8165ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian AudioResampler& operator=(const AudioResampler&); 8265ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 834ff14bae91075eb274eb1c2975982358946e7e63John Grossman int64_t calculateOutputPTS(int outputFrameIndex); 844ff14bae91075eb274eb1c2975982358946e7e63John Grossman 85004f719467c498942c40de9f260be601ee45e630Glenn Kasten const int32_t mBitDepth; 86004f719467c498942c40de9f260be601ee45e630Glenn Kasten const int32_t mChannelCount; 87004f719467c498942c40de9f260be601ee45e630Glenn Kasten const int32_t mSampleRate; 8865ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian int32_t mInSampleRate; 8965ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian AudioBufferProvider::Buffer mBuffer; 9065ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian union { 9165ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian int16_t mVolume[2]; 9265ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian uint32_t mVolumeRL; 9365ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian }; 9465ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian int16_t mTargetVolume[2]; 9565ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian size_t mInputIndex; 9665ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian int32_t mPhaseIncrement; 9765ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian uint32_t mPhaseFraction; 984ff14bae91075eb274eb1c2975982358946e7e63John Grossman uint64_t mLocalTimeFreq; 994ff14bae91075eb274eb1c2975982358946e7e63John Grossman int64_t mPTS; 100ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten 101ac6020508acedd316391dee42329040bf45f8d90Glenn Kastenprivate: 102ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten const src_quality mQuality; 103ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten 104ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten // Return 'true' if the quality level is supported without explicit request 105ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten static bool qualityIsSupported(src_quality quality); 106ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten 107ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten // For pthread_once() 108ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten static void init_routine(); 109ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten 110ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten // Return the estimated CPU load for specific resampler in MHz. 111ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten // The absolute number is irrelevant, it's the relative values that matter. 112ac6020508acedd316391dee42329040bf45f8d90Glenn Kasten static uint32_t qualityMHz(src_quality quality); 11365ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian}; 11465ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 11565ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian// ---------------------------------------------------------------------------- 11665ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian} 11765ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian; // namespace android 11865ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian 11965ab47156e1c7dfcd8cc4266253a5ff30219e7f0Mathias Agopian#endif // ANDROID_AUDIO_RESAMPLER_H 120