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 Pathname: ./gsm-amr/c/src/negate.c
32
33 ------------------------------------------------------------------------------
34 REVISION HISTORY
35
36 Description: Created separate file for the negate function. Sync'ed up with
37 the current template and fixed tabs.
38
39 Description: Removed conditional code that updates WMOPS counter
40
41 Who: Date:
42 Description:
43
44 ------------------------------------------------------------------------------
45 INPUT AND OUTPUT DEFINITIONS
46
47 Inputs:
48 var1 = 16 bit short signed integer (Word16) whose value falls in
49 the range : 0xffff 8000 <= var1 <= 0x0000 7fff.
50
51 Local Stores/Buffers/Pointers Needed:
52 None
53
54 Global Stores/Buffers/Pointers Needed:
55 None
56
57 Outputs:
58 var1 = negated value of input (Word16)
59
60 Pointers and Buffers Modified:
61 None
62
63 Local Stores Modified:
64 None
65
66 Global Stores Modified:
67 None
68
69 ------------------------------------------------------------------------------
70 FUNCTION DESCRIPTION
71
72 This function negates var1 with saturation; saturate in the case where input
73 is -32768: negate(var1) = sub(0,var1).
74
75 ------------------------------------------------------------------------------
76 REQUIREMENTS
77
78 None
79
80 ------------------------------------------------------------------------------
81 REFERENCES
82
83 [1] basicop2.c, ETS Version 2.0.0, February 8, 1999
84
85 ------------------------------------------------------------------------------
86 PSEUDO-CODE
87
88 Word16 negate (Word16 var1)
89 {
90 Word16 var_out;
91
92 var_out = (var1 == MIN_16) ? MAX_16 : -var1;
93 #if (WMOPS)
94 multiCounter[currCounter].negate++;
95 #endif
96 return (var_out);
97 }
98
99 ------------------------------------------------------------------------------
100 RESOURCES USED
101 When the code is written for a specific target processor the
102 the resources used should be documented below.
103
104 STACK USAGE: [stack count for this module] + [variable to represent
105 stack usage for each subroutine called]
106
107 where: [stack usage variable] = stack usage for [subroutine
108 name] (see [filename].ext)
109
110 DATA MEMORY USED: x words
111
112 PROGRAM MEMORY USED: x words
113
114 CLOCK CYCLES: [cycle count equation for this module] + [variable
115 used to represent cycle count for each subroutine
116 called]
117
118 where: [cycle count variable] = cycle count for [subroutine
119 name] (see [filename].ext)
120
121 ------------------------------------------------------------------------------
122 */
123
124
125 /*----------------------------------------------------------------------------
126 ; INCLUDES
127 ----------------------------------------------------------------------------*/
128 #include "negate.h"
129
130 /*----------------------------------------------------------------------------
131 ; MACROS
132 ; Define module specific macros here
133 ----------------------------------------------------------------------------*/
134
135 /*----------------------------------------------------------------------------
136 ; DEFINES
137 ; Include all pre-processor statements here. Include conditional
138 ; compile variables also.
139 ----------------------------------------------------------------------------*/
140
141 /*----------------------------------------------------------------------------
142 ; LOCAL FUNCTION DEFINITIONS
143 ; Function Prototype declaration
144 ----------------------------------------------------------------------------*/
145
146 /*----------------------------------------------------------------------------
147 ; LOCAL STORE/BUFFER/POINTER DEFINITIONS
148 ; Variable declaration - defined here and used outside this module
149 ----------------------------------------------------------------------------*/
150
151 /*----------------------------------------------------------------------------
152 ; EXTERNAL FUNCTION REFERENCES
153 ; Declare functions defined elsewhere and referenced in this module
154 ----------------------------------------------------------------------------*/
155
156 /*----------------------------------------------------------------------------
157 ; EXTERNAL GLOBAL STORE/BUFFER/POINTER REFERENCES
158 ; Declare variables used in this module but defined elsewhere
159 ----------------------------------------------------------------------------*/
160
161 /*----------------------------------------------------------------------------
162 ; FUNCTION CODE
163 ----------------------------------------------------------------------------*/
negate(Word16 var1)164 Word16 negate(Word16 var1)
165 {
166 /*----------------------------------------------------------------------------
167 ; Define all local variables
168 ----------------------------------------------------------------------------*/
169
170 /*----------------------------------------------------------------------------
171 ; Function body here
172 ----------------------------------------------------------------------------*/
173 var1 = (var1 == MIN_16) ? MAX_16 : -var1;
174
175 /*----------------------------------------------------------------------------
176 ; Return nothing or data or data pointer
177 ----------------------------------------------------------------------------*/
178 return (var1);
179 }
180