1a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber/* ------------------------------------------------------------------
2a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber * Copyright (C) 1998-2009 PacketVideo
3a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber *
4a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber * Licensed under the Apache License, Version 2.0 (the "License");
5a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber * you may not use this file except in compliance with the License.
6a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber * You may obtain a copy of the License at
7a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber *
8a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber *      http://www.apache.org/licenses/LICENSE-2.0
9a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber *
10a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber * Unless required by applicable law or agreed to in writing, software
11a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber * distributed under the License is distributed on an "AS IS" BASIS,
12a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
13a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber * express or implied.
14a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber * See the License for the specific language governing permissions
15a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber * and limitations under the License.
16a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber * -------------------------------------------------------------------
17a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber */
18a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber/****************************************************************************************
19a30d40083856cb4edd225faf8b488fab156e5976Andreas HuberPortions of this file are derived from the following 3GPP standard:
20a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
21a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    3GPP TS 26.073
22a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ANSI-C code for the Adaptive Multi-Rate (AMR) speech codec
23a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    Available from http://www.3gpp.org
24a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
25a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber(C) 2004, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TTA, TTC)
26a30d40083856cb4edd225faf8b488fab156e5976Andreas HuberPermission to distribute, modify and use this file under the standard license
27a30d40083856cb4edd225faf8b488fab156e5976Andreas Huberterms listed above has been obtained from the copyright holder.
28a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber****************************************************************************************/
29a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber/*
30a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber------------------------------------------------------------------------------
31a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
32a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
33a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
34a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber Filename: /audio/gsm_amr/c/include/preemph.h
35a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
36a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber     Date: 02/05/2002
37a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
38a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber------------------------------------------------------------------------------
39a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber REVISION HISTORY
40a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
41a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber Description: Placed header file in the proper template format.  Added
42a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber parameter pOverflow for the basic math ops.
43a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
44a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber Description:  Replaced "int" and/or "char" with OSCL defined types.
45a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
46a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber Description: Moved _cplusplus #ifdef after Include section.
47a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
48a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber Description:
49a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
50a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber------------------------------------------------------------------------------
51a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber INCLUDE DESCRIPTION
52a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
53a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber This file contains all the constant definitions and prototype definitions
54a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber needed by the file, preemph.c
55a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
56a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber------------------------------------------------------------------------------
57a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber*/
58a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
59a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber/*----------------------------------------------------------------------------
60a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber; CONTINUE ONLY IF NOT ALREADY DEFINED
61a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber----------------------------------------------------------------------------*/
62a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber#ifndef preemph_h
63a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber#define preemph_h "$Id $"
64a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
65a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
66a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber/*----------------------------------------------------------------------------
67a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber; INCLUDES
68a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber----------------------------------------------------------------------------*/
69a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
70a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber#include "typedef.h"
71a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
72a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber/*--------------------------------------------------------------------------*/
73a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber#ifdef __cplusplus
74a30d40083856cb4edd225faf8b488fab156e5976Andreas Huberextern "C"
75a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber{
76a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber#endif
77a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
78a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    /*----------------------------------------------------------------------------
79a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ; MACROS
80a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ; Define module specific macros here
81a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ----------------------------------------------------------------------------*/
82a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
83a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    /*----------------------------------------------------------------------------
84a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ; DEFINES
85a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ; Include all pre-processor statements here.
86a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ----------------------------------------------------------------------------*/
87a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
88a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    /*----------------------------------------------------------------------------
89a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ; EXTERNAL VARIABLES REFERENCES
90a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ; Declare variables used in this module but defined elsewhere
91a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ----------------------------------------------------------------------------*/
92a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
93a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    /*----------------------------------------------------------------------------
94a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ; SIMPLE TYPEDEF'S
95a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ----------------------------------------------------------------------------*/
96a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
97a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    /*----------------------------------------------------------------------------
98a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ; ENUMERATED TYPEDEF'S
99a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ----------------------------------------------------------------------------*/
100a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
101a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    /*----------------------------------------------------------------------------
102a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ; STRUCTURES TYPEDEF'S
103a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ----------------------------------------------------------------------------*/
104a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    typedef struct
105a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    {
106a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber        Word16 mem_pre;          /* filter state */
107a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    } preemphasisState;
108a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
109a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    /*----------------------------------------------------------------------------
110a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ; GLOBAL FUNCTION DEFINITIONS
111a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ; Function Prototype declaration
112a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ----------------------------------------------------------------------------*/
113a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
114a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    Word16 preemphasis_reset(preemphasisState *st);
115a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    /* reset of preemphasis filter (i.e. set state memory to zero)
116a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber       returns 0 on success
117a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber     */
118a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    void preemphasis_exit(preemphasisState **st);
119a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    /* de-initialize preemphasis filter (i.e. free status struct)
120a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber       stores NULL in *st
121a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber     */
122a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
123a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    void preemphasis(
124a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber        preemphasisState *st, /* (i/o): preemphasis filter state                */
125a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber        Word16 *signal,    /* (i/o): input signal overwritten by the output     */
126a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber        Word16 g,          /* (i)  : preemphasis coefficient                    */
127a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber        Word16 L,          /* (i)  : size of filtering                          */
128a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber        Flag   *pOverflow  /* (o)  : overflow indicator                         */
129a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    );
130a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
131a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    /*----------------------------------------------------------------------------
132a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ; END
133a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber    ----------------------------------------------------------------------------*/
134a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber#ifdef __cplusplus
135a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber}
136a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber#endif
137a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
138a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber#endif /* preemph_H_ */
139a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
140a30d40083856cb4edd225faf8b488fab156e5976Andreas Huber
141