1885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/* Copyright (C) 2007-2009 Xiph.Org Foundation 2885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org Copyright (C) 2003-2008 Jean-Marc Valin 3885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org Copyright (C) 2007-2008 CSIRO */ 4885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** 5885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org @file fixed_generic.h 6885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org @brief Generic fixed-point operations 7885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org*/ 8885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/* 9885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org Redistribution and use in source and binary forms, with or without 10885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org modification, are permitted provided that the following conditions 11885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org are met: 12885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 13885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org - Redistributions of source code must retain the above copyright 14885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org notice, this list of conditions and the following disclaimer. 15885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 16885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org - Redistributions in binary form must reproduce the above copyright 17885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org notice, this list of conditions and the following disclaimer in the 18885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org documentation and/or other materials provided with the distribution. 19885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 20885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 21885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 22885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 23885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER 24885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 25885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 26885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 27885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 28885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING 29885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 30885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 31885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org*/ 32885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 33885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#ifndef FIXED_GENERIC_H 34885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define FIXED_GENERIC_H 35885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 36885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** Multiply a 16-bit signed value by a 16-bit unsigned value. The result is a 32-bit signed value */ 37885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define MULT16_16SU(a,b) ((opus_val32)(opus_val16)(a)*(opus_val32)(opus_uint16)(b)) 38885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 39885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** 16x32 multiplication, followed by a 16-bit shift right. Results fits in 32 bits */ 40885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define MULT16_32_Q16(a,b) ADD32(MULT16_16((a),SHR((b),16)), SHR(MULT16_16SU((a),((b)&0x0000ffff)),16)) 41885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 42885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** 16x32 multiplication, followed by a 16-bit shift right (round-to-nearest). Results fits in 32 bits */ 43885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define MULT16_32_P16(a,b) ADD32(MULT16_16((a),SHR((b),16)), PSHR(MULT16_16((a),((b)&0x0000ffff)),16)) 44885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 45885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** 16x32 multiplication, followed by a 15-bit shift right. Results fits in 32 bits */ 46885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define MULT16_32_Q15(a,b) ADD32(SHL(MULT16_16((a),SHR((b),16)),1), SHR(MULT16_16SU((a),((b)&0x0000ffff)),15)) 47885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 48885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** 32x32 multiplication, followed by a 31-bit shift right. Results fits in 32 bits */ 49885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define MULT32_32_Q31(a,b) ADD32(ADD32(SHL(MULT16_16(SHR((a),16),SHR((b),16)),1), SHR(MULT16_16SU(SHR((a),16),((b)&0x0000ffff)),15)), SHR(MULT16_16SU(SHR((b),16),((a)&0x0000ffff)),15)) 50885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 51885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** Compile-time conversion of float constant to 16-bit value */ 52885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define QCONST16(x,bits) ((opus_val16)(.5+(x)*(((opus_val32)1)<<(bits)))) 53885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 54885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** Compile-time conversion of float constant to 32-bit value */ 55885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define QCONST32(x,bits) ((opus_val32)(.5+(x)*(((opus_val32)1)<<(bits)))) 56885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 57885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** Negate a 16-bit value */ 58885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define NEG16(x) (-(x)) 59885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** Negate a 32-bit value */ 60885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define NEG32(x) (-(x)) 61885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 62885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** Change a 32-bit value into a 16-bit value. The value is assumed to fit in 16-bit, otherwise the result is undefined */ 63885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define EXTRACT16(x) ((opus_val16)(x)) 64885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** Change a 16-bit value into a 32-bit value */ 65885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define EXTEND32(x) ((opus_val32)(x)) 66885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 67885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** Arithmetic shift-right of a 16-bit value */ 68885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define SHR16(a,shift) ((a) >> (shift)) 69885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** Arithmetic shift-left of a 16-bit value */ 70885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define SHL16(a,shift) ((opus_int16)((opus_uint16)(a)<<(shift))) 71885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** Arithmetic shift-right of a 32-bit value */ 72885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define SHR32(a,shift) ((a) >> (shift)) 73885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** Arithmetic shift-left of a 32-bit value */ 74885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define SHL32(a,shift) ((opus_int32)((opus_uint32)(a)<<(shift))) 75885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 76885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** 32-bit arithmetic shift right with rounding-to-nearest instead of rounding down */ 77885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define PSHR32(a,shift) (SHR32((a)+((EXTEND32(1)<<((shift))>>1)),shift)) 78885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** 32-bit arithmetic shift right where the argument can be negative */ 79885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define VSHR32(a, shift) (((shift)>0) ? SHR32(a, shift) : SHL32(a, -(shift))) 80885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 81885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** "RAW" macros, should not be used outside of this header file */ 82885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define SHR(a,shift) ((a) >> (shift)) 83885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define SHL(a,shift) SHL32(a,shift) 84885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define PSHR(a,shift) (SHR((a)+((EXTEND32(1)<<((shift))>>1)),shift)) 85885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define SATURATE(x,a) (((x)>(a) ? (a) : (x)<-(a) ? -(a) : (x))) 86885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 87e3ea049fcaee2247e45f0ce793d4313babb4ef69tlegrand@chromium.org#define SATURATE16(x) (EXTRACT16((x)>32767 ? 32767 : (x)<-32768 ? -32768 : (x))) 88e3ea049fcaee2247e45f0ce793d4313babb4ef69tlegrand@chromium.org 89885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** Shift by a and round-to-neareast 32-bit value. Result is a 16-bit value */ 90885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define ROUND16(x,a) (EXTRACT16(PSHR32((x),(a)))) 91885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** Divide by two */ 92885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define HALF16(x) (SHR16(x,1)) 93885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define HALF32(x) (SHR32(x,1)) 94885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 95885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** Add two 16-bit values */ 96885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define ADD16(a,b) ((opus_val16)((opus_val16)(a)+(opus_val16)(b))) 97885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** Subtract two 16-bit values */ 98885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define SUB16(a,b) ((opus_val16)(a)-(opus_val16)(b)) 99885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** Add two 32-bit values */ 100885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define ADD32(a,b) ((opus_val32)(a)+(opus_val32)(b)) 101885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** Subtract two 32-bit values */ 102885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define SUB32(a,b) ((opus_val32)(a)-(opus_val32)(b)) 103885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 104885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** 16x16 multiplication where the result fits in 16 bits */ 105885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define MULT16_16_16(a,b) ((((opus_val16)(a))*((opus_val16)(b)))) 106885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 107885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/* (opus_val32)(opus_val16) gives TI compiler a hint that it's 16x16->32 multiply */ 108885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** 16x16 multiplication where the result fits in 32 bits */ 109885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define MULT16_16(a,b) (((opus_val32)(opus_val16)(a))*((opus_val32)(opus_val16)(b))) 110885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 111885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** 16x16 multiply-add where the result fits in 32 bits */ 112885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define MAC16_16(c,a,b) (ADD32((c),MULT16_16((a),(b)))) 113e3ea049fcaee2247e45f0ce793d4313babb4ef69tlegrand@chromium.org/** 16x32 multiply, followed by a 15-bit shift right and 32-bit add. 114e3ea049fcaee2247e45f0ce793d4313babb4ef69tlegrand@chromium.org b must fit in 31 bits. 115e3ea049fcaee2247e45f0ce793d4313babb4ef69tlegrand@chromium.org Result fits in 32 bits. */ 116885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define MAC16_32_Q15(c,a,b) ADD32(c,ADD32(MULT16_16((a),SHR((b),15)), SHR(MULT16_16((a),((b)&0x00007fff)),15))) 117885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 118885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define MULT16_16_Q11_32(a,b) (SHR(MULT16_16((a),(b)),11)) 119e3ea049fcaee2247e45f0ce793d4313babb4ef69tlegrand@chromium.org#define MULT16_16_Q11(a,b) (SHR(MULT16_16((a),(b)),11)) 120885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define MULT16_16_Q13(a,b) (SHR(MULT16_16((a),(b)),13)) 121885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define MULT16_16_Q14(a,b) (SHR(MULT16_16((a),(b)),14)) 122885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define MULT16_16_Q15(a,b) (SHR(MULT16_16((a),(b)),15)) 123885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 124885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define MULT16_16_P13(a,b) (SHR(ADD32(4096,MULT16_16((a),(b))),13)) 125885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define MULT16_16_P14(a,b) (SHR(ADD32(8192,MULT16_16((a),(b))),14)) 126885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define MULT16_16_P15(a,b) (SHR(ADD32(16384,MULT16_16((a),(b))),15)) 127885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 128885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** Divide a 32-bit value by a 16-bit value. Result fits in 16 bits */ 129885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define DIV32_16(a,b) ((opus_val16)(((opus_val32)(a))/((opus_val16)(b)))) 130885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 131885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org/** Divide a 32-bit value by a 32-bit value. Result fits in 32 bits */ 132885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#define DIV32(a,b) (((opus_val32)(a))/((opus_val32)(b))) 133885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org 134885f2ff5a7a7d6a73432d26a6c0ae9147e6b452sergeyu@chromium.org#endif 135