opencore/codecs_v2/audio/gsm_amr/amr_nb/common/src/extract_h.cpp

   1 /* ------------------------------------------------------------------
   2  * Copyright (C) 1998-2009 PacketVideo
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *      http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
  13  * express or implied.
  14  * See the License for the specific language governing permissions
  15  * and limitations under the License.
  16  * -------------------------------------------------------------------
  17  */
  18 /****************************************************************************************
  19 Portions of this file are derived from the following 3GPP standard:
  20
  21     3GPP TS 26.073
  22     ANSI-C code for the Adaptive Multi-Rate (AMR) speech codec
  23     Available from http://www.3gpp.org
  24
  25 (C) 2004, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TTA, TTC)
  26 Permission to distribute, modify and use this file under the standard license
  27 terms listed above has been obtained from the copyright holder.
  28 ****************************************************************************************/
  29 /*
  30
  31  Filename: extract_h.cpp
  32
  33 ------------------------------------------------------------------------------
  34  INPUT AND OUTPUT DEFINITIONS
  35
  36  Inputs:
  37     L_var1 = 32 bit long signed integer (Word32 ) whose value falls
  38              in the range : 0x8000 0000 <= L_var1 <= 0x7fff ffff.
  39
  40  Local Stores/Buffers/Pointers Needed:
  41     None
  42
  43  Global Stores/Buffers/Pointers Needed:
  44     None
  45
  46  Outputs:
  47     L_var1 = Most significant word of input (Word16)
  48
  49  Pointers and Buffers Modified:
  50     None
  51
  52  Local Stores Modified:
  53     None
  54
  55  Global Stores Modified:
  56     None
  57
  58 ------------------------------------------------------------------------------
  59  FUNCTION DESCRIPTION
  60
  61  This function returns the 16 MSB of the input, L_var1.
  62
  63 ------------------------------------------------------------------------------
  64  REQUIREMENTS
  65
  66  None
  67
  68 ------------------------------------------------------------------------------
  69  REFERENCES
  70
  71  [1] basicop2.c, ETS Version 2.0.0, February 8, 1999
  72
  73 ------------------------------------------------------------------------------
  74  PSEUDO-CODE
  75
  76 Word16 extract_h (Word32 L_var1)
  77 {
  78     Word16 var_out;
  79
  80     var_out = (Word16) (L_var1 >> 16);
  81 #if (WMOPS)
  82     multiCounter[currCounter].extract_h++;
  83 #endif
  84     return (var_out);
  85 }
  86
  87 ------------------------------------------------------------------------------
  88 */
  89
  90
  91 /*----------------------------------------------------------------------------
  92 ; INCLUDES
  93 ----------------------------------------------------------------------------*/
  94 #include    "basic_op.h"
  95
  96 /*----------------------------------------------------------------------------
  97 ; MACROS
  98 ; Define module specific macros here
  99 ----------------------------------------------------------------------------*/
 100
 101 /*----------------------------------------------------------------------------
 102 ; DEFINES
 103 ; Include all pre-processor statements here. Include conditional
 104 ; compile variables also.
 105 ----------------------------------------------------------------------------*/
 106
 107 /*----------------------------------------------------------------------------
 108 ; LOCAL FUNCTION DEFINITIONS
 109 ; Function Prototype declaration
 110 ----------------------------------------------------------------------------*/
 111
 112 /*----------------------------------------------------------------------------
 113 ; LOCAL STORE/BUFFER/POINTER DEFINITIONS
 114 ; Variable declaration - defined here and used outside this module
 115 ----------------------------------------------------------------------------*/
 116
 117 /*----------------------------------------------------------------------------
 118 ; EXTERNAL FUNCTION REFERENCES
 119 ; Declare functions defined elsewhere and referenced in this module
 120 ----------------------------------------------------------------------------*/
 121
 122 /*----------------------------------------------------------------------------
 123 ; EXTERNAL GLOBAL STORE/BUFFER/POINTER REFERENCES
 124 ; Declare variables used in this module but defined elsewhere
 125 ----------------------------------------------------------------------------*/
 126
 127 /*----------------------------------------------------------------------------
 128 ; FUNCTION CODE
 129 ----------------------------------------------------------------------------*/
 130 Word16 extract_h(Word32 L_var1)
 131 {
 132     /*----------------------------------------------------------------------------
 133     ; Define all local variables
 134     ----------------------------------------------------------------------------*/
 135
 136     /*----------------------------------------------------------------------------
 137     ; Function body here
 138     ----------------------------------------------------------------------------*/
 139
 140     /*----------------------------------------------------------------------------
 141     ; Return nothing or data or data pointer
 142     ----------------------------------------------------------------------------*/
 143     return ((Word16)(L_var1 >> 16));
 144 }