/* * Copyright (C) 2014 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #pragma once #include "audio/android/cutils/log.h" namespace cocos2d { /* Behavior of is_same<>::value is true if the types are identical, * false otherwise. Identical to the STL std::is_same. */ template struct is_same { static const bool value = false; }; template struct is_same // partial specialization { static const bool value = true; }; /* MixMul is a multiplication operator to scale an audio input signal * by a volume gain, with the formula: * * O(utput) = I(nput) * V(olume) * * The output, input, and volume may have different types. * There are 27 variants, of which 14 are actually defined in an * explicitly templated class. * * The following type variables and the underlying meaning: * * Output type TO: int32_t (Q4.27) or int16_t (Q.15) or float [-1,1] * Input signal type TI: int32_t (Q4.27) or int16_t (Q.15) or float [-1,1] * Volume type TV: int32_t (U4.28) or int16_t (U4.12) or float [-1,1] * * For high precision audio, only the = * needs to be accelerated. This is perhaps the easiest form to do quickly as well. * * A generic version is NOT defined to catch any mistake of using it. */ template TO MixMul(TI value, TV volume); template <> inline int32_t MixMul(int16_t value, int16_t volume) { return value * volume; } template <> inline int32_t MixMul(int32_t value, int16_t volume) { return (value >> 12) * volume; } template <> inline int32_t MixMul(int16_t value, int32_t volume) { return value * (volume >> 16); } template <> inline int32_t MixMul(int32_t value, int32_t volume) { return (value >> 12) * (volume >> 16); } template <> inline float MixMul(float value, int16_t volume) { static const float norm = 1. / (1 << 12); return value * volume * norm; } template <> inline float MixMul(float value, int32_t volume) { static const float norm = 1. / (1 << 28); return value * volume * norm; } template <> inline int16_t MixMul(float value, int16_t volume) { return clamp16_from_float(MixMul(value, volume)); } template <> inline int16_t MixMul(float value, int32_t volume) { return clamp16_from_float(MixMul(value, volume)); } template <> inline float MixMul(int16_t value, int16_t volume) { static const float norm = 1. / (1 << (15 + 12)); return static_cast(value) * static_cast(volume) * norm; } template <> inline float MixMul(int16_t value, int32_t volume) { static const float norm = 1. / (1ULL << (15 + 28)); return static_cast(value) * static_cast(volume) * norm; } template <> inline int16_t MixMul(int16_t value, int16_t volume) { return clamp16(MixMul(value, volume) >> 12); } template <> inline int16_t MixMul(int32_t value, int16_t volume) { return clamp16(MixMul(value, volume) >> 12); } template <> inline int16_t MixMul(int16_t value, int32_t volume) { return clamp16(MixMul(value, volume) >> 12); } template <> inline int16_t MixMul(int32_t value, int32_t volume) { return clamp16(MixMul(value, volume) >> 12); } /* Required for floating point volume. Some are needed for compilation but * are not needed in execution and should be removed from the final build by * an optimizing compiler. */ template <> inline float MixMul(float value, float volume) { return value * volume; } template <> inline float MixMul(int16_t value, float volume) { static const float float_from_q_15 = 1. / (1 << 15); return value * volume * float_from_q_15; } template <> inline int32_t MixMul(int32_t value, float volume) { LOG_ALWAYS_FATAL("MixMul Runtime Should not be here"); return value * volume; } template <> inline int32_t MixMul(int16_t value, float volume) { LOG_ALWAYS_FATAL("MixMul Runtime Should not be here"); static const float u4_12_from_float = (1 << 12); return value * volume * u4_12_from_float; } template <> inline int16_t MixMul(int16_t value, float volume) { LOG_ALWAYS_FATAL("MixMul Runtime Should not be here"); return clamp16_from_float(MixMul(value, volume)); } template <> inline int16_t MixMul(float value, float volume) { return clamp16_from_float(value * volume); } /* * MixAccum is used to add into an accumulator register of a possibly different * type. The TO and TI types are the same as MixMul. */ template inline void MixAccum(TO *auxaccum, TI value) { if (!is_same::value) { LOG_ALWAYS_FATAL("MixAccum type not properly specialized: %zu %zu\n", sizeof(TO), sizeof(TI)); } *auxaccum += value; } template<> inline void MixAccum(float *auxaccum, int16_t value) { static const float norm = 1. / (1 << 15); *auxaccum += norm * value; } template<> inline void MixAccum(float *auxaccum, int32_t value) { static const float norm = 1. / (1 << 27); *auxaccum += norm * value; } template<> inline void MixAccum(int32_t *auxaccum, int16_t value) { *auxaccum += value << 12; } template<> inline void MixAccum(int32_t *auxaccum, float value) { *auxaccum += clampq4_27_from_float(value); } /* MixMulAux is just like MixMul except it combines with * an accumulator operation MixAccum. */ template inline TO MixMulAux(TI value, TV volume, TA *auxaccum) { MixAccum(auxaccum, value); return MixMul(value, volume); } /* MIXTYPE is used to determine how the samples in the input frame * are mixed with volume gain into the output frame. * See the volumeRampMulti functions below for more details. */ enum { MIXTYPE_MULTI, MIXTYPE_MONOEXPAND, MIXTYPE_MULTI_SAVEONLY, MIXTYPE_MULTI_MONOVOL, MIXTYPE_MULTI_SAVEONLY_MONOVOL, }; /* * The volumeRampMulti and volumeRamp functions take a MIXTYPE * which indicates the per-frame mixing and accumulation strategy. * * MIXTYPE_MULTI: * NCHAN represents number of input and output channels. * TO: int32_t (Q4.27) or float * TI: int32_t (Q4.27) or int16_t (Q0.15) or float * TV: int32_t (U4.28) or int16_t (U4.12) or float * vol: represents a volume array. * * This accumulates into the out pointer. * * MIXTYPE_MONOEXPAND: * Single input channel. NCHAN represents number of output channels. * TO: int32_t (Q4.27) or float * TI: int32_t (Q4.27) or int16_t (Q0.15) or float * TV: int32_t (U4.28) or int16_t (U4.12) or float * Input channel count is 1. * vol: represents volume array. * * This accumulates into the out pointer. * * MIXTYPE_MULTI_SAVEONLY: * NCHAN represents number of input and output channels. * TO: int16_t (Q.15) or float * TI: int32_t (Q4.27) or int16_t (Q0.15) or float * TV: int32_t (U4.28) or int16_t (U4.12) or float * vol: represents a volume array. * * MIXTYPE_MULTI_SAVEONLY does not accumulate into the out pointer. * * MIXTYPE_MULTI_MONOVOL: * Same as MIXTYPE_MULTI, but uses only volume[0]. * * MIXTYPE_MULTI_SAVEONLY_MONOVOL: * Same as MIXTYPE_MULTI_SAVEONLY, but uses only volume[0]. * */ template inline void volumeRampMulti(TO* out, size_t frameCount, const TI* in, TA* aux, TV *vol, const TV *volinc, TAV *vola, TAV volainc) { #ifdef ALOGVV ALOGVV("volumeRampMulti, MIXTYPE:%d\n", MIXTYPE); #endif if (aux != NULL) { do { TA auxaccum = 0; switch (MIXTYPE) { case MIXTYPE_MULTI: for (int i = 0; i < NCHAN; ++i) { *out++ += MixMulAux(*in++, vol[i], &auxaccum); vol[i] += volinc[i]; } break; case MIXTYPE_MONOEXPAND: for (int i = 0; i < NCHAN; ++i) { *out++ += MixMulAux(*in, vol[i], &auxaccum); vol[i] += volinc[i]; } in++; break; case MIXTYPE_MULTI_SAVEONLY: for (int i = 0; i < NCHAN; ++i) { *out++ = MixMulAux(*in++, vol[i], &auxaccum); vol[i] += volinc[i]; } break; case MIXTYPE_MULTI_MONOVOL: for (int i = 0; i < NCHAN; ++i) { *out++ += MixMulAux(*in++, vol[0], &auxaccum); } vol[0] += volinc[0]; break; case MIXTYPE_MULTI_SAVEONLY_MONOVOL: for (int i = 0; i < NCHAN; ++i) { *out++ = MixMulAux(*in++, vol[0], &auxaccum); } vol[0] += volinc[0]; break; default: LOG_ALWAYS_FATAL("invalid mixtype %d", MIXTYPE); break; } auxaccum /= NCHAN; *aux++ += MixMul(auxaccum, *vola); vola[0] += volainc; } while (--frameCount); } else { do { switch (MIXTYPE) { case MIXTYPE_MULTI: for (int i = 0; i < NCHAN; ++i) { *out++ += MixMul(*in++, vol[i]); vol[i] += volinc[i]; } break; case MIXTYPE_MONOEXPAND: for (int i = 0; i < NCHAN; ++i) { *out++ += MixMul(*in, vol[i]); vol[i] += volinc[i]; } in++; break; case MIXTYPE_MULTI_SAVEONLY: for (int i = 0; i < NCHAN; ++i) { *out++ = MixMul(*in++, vol[i]); vol[i] += volinc[i]; } break; case MIXTYPE_MULTI_MONOVOL: for (int i = 0; i < NCHAN; ++i) { *out++ += MixMul(*in++, vol[0]); } vol[0] += volinc[0]; break; case MIXTYPE_MULTI_SAVEONLY_MONOVOL: for (int i = 0; i < NCHAN; ++i) { *out++ = MixMul(*in++, vol[0]); } vol[0] += volinc[0]; break; default: LOG_ALWAYS_FATAL("invalid mixtype %d", MIXTYPE); break; } } while (--frameCount); } } template inline void volumeMulti(TO* out, size_t frameCount, const TI* in, TA* aux, const TV *vol, TAV vola) { #ifdef ALOGVV ALOGVV("volumeMulti MIXTYPE:%d\n", MIXTYPE); #endif if (aux != NULL) { do { TA auxaccum = 0; switch (MIXTYPE) { case MIXTYPE_MULTI: for (int i = 0; i < NCHAN; ++i) { *out++ += MixMulAux(*in++, vol[i], &auxaccum); } break; case MIXTYPE_MONOEXPAND: for (int i = 0; i < NCHAN; ++i) { *out++ += MixMulAux(*in, vol[i], &auxaccum); } in++; break; case MIXTYPE_MULTI_SAVEONLY: for (int i = 0; i < NCHAN; ++i) { *out++ = MixMulAux(*in++, vol[i], &auxaccum); } break; case MIXTYPE_MULTI_MONOVOL: for (int i = 0; i < NCHAN; ++i) { *out++ += MixMulAux(*in++, vol[0], &auxaccum); } break; case MIXTYPE_MULTI_SAVEONLY_MONOVOL: for (int i = 0; i < NCHAN; ++i) { *out++ = MixMulAux(*in++, vol[0], &auxaccum); } break; default: LOG_ALWAYS_FATAL("invalid mixtype %d", MIXTYPE); break; } auxaccum /= NCHAN; *aux++ += MixMul(auxaccum, vola); } while (--frameCount); } else { do { switch (MIXTYPE) { case MIXTYPE_MULTI: for (int i = 0; i < NCHAN; ++i) { *out++ += MixMul(*in++, vol[i]); } break; case MIXTYPE_MONOEXPAND: for (int i = 0; i < NCHAN; ++i) { *out++ += MixMul(*in, vol[i]); } in++; break; case MIXTYPE_MULTI_SAVEONLY: for (int i = 0; i < NCHAN; ++i) { *out++ = MixMul(*in++, vol[i]); } break; case MIXTYPE_MULTI_MONOVOL: for (int i = 0; i < NCHAN; ++i) { *out++ += MixMul(*in++, vol[0]); } break; case MIXTYPE_MULTI_SAVEONLY_MONOVOL: for (int i = 0; i < NCHAN; ++i) { *out++ = MixMul(*in++, vol[0]); } break; default: LOG_ALWAYS_FATAL("invalid mixtype %d", MIXTYPE); break; } } while (--frameCount); } } } // namespace cocos2d {