1/*
2 * Copyright (c) 2010 The Khronos Group Inc.
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining
5 * a copy of this software and associated documentation files (the
6 * "Software"), to deal in the Software without restriction, including
7 * without limitation the rights to use, copy, modify, merge, publish,
8 * distribute, sublicense, and/or sell copies of the Software, and to
9 * permit persons to whom the Software is furnished to do so, subject
10 * to the following conditions:
11 * The above copyright notice and this permission notice shall be included
12 * in all copies or substantial portions of the Software.
13 *
14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
15 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
16 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
17 * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
18 * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
19 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
20 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
21 *
22 */
23
24/** OMX_AudioExt.h - OpenMax IL version 1.1.2
25 * The OMX_AudioExt header file contains extensions to the
26 * definitions used by both the application and the component to
27 * access video items.
28 */
29
30#ifndef OMX_AudioExt_h
31#define OMX_AudioExt_h
32
33#ifdef __cplusplus
34extern "C" {
35#endif /* __cplusplus */
36
37/* Each OMX header shall include all required header files to allow the
38 * header to compile without errors.  The includes below are required
39 * for this header file to compile successfully
40 */
41#include <OMX_Core.h>
42
43#define OMX_AUDIO_AACToolAndroidSSBR (OMX_AUDIO_AACToolVendor << 0) /**< SSBR: MPEG-4 Single-rate (downsampled) Spectral Band Replication tool allowed or active */
44#define OMX_AUDIO_AACToolAndroidDSBR (OMX_AUDIO_AACToolVendor << 1) /**< DSBR: MPEG-4 Dual-rate Spectral Band Replication tool allowed or active */
45
46typedef enum OMX_AUDIO_CODINGEXTTYPE {
47    OMX_AUDIO_CodingAndroidUnused = OMX_AUDIO_CodingKhronosExtensions + 0x00100000,
48    OMX_AUDIO_CodingAndroidAC3,         /**< AC3 encoded data */
49    OMX_AUDIO_CodingAndroidOPUS,        /**< OPUS encoded data */
50    OMX_AUDIO_CodingAndroidEAC3,        /**< EAC3 encoded data */
51} OMX_AUDIO_CODINGEXTTYPE;
52
53typedef struct OMX_AUDIO_PARAM_ANDROID_AC3TYPE {
54    OMX_U32 nSize;                 /**< size of the structure in bytes */
55    OMX_VERSIONTYPE nVersion;      /**< OMX specification version information */
56    OMX_U32 nPortIndex;            /**< port that this structure applies to */
57    OMX_U32 nChannels;             /**< Number of channels */
58    OMX_U32 nSampleRate;           /**< Sampling rate of the source data.  Use 0 for
59                                        variable or unknown sampling rate. */
60} OMX_AUDIO_PARAM_ANDROID_AC3TYPE;
61
62typedef struct OMX_AUDIO_PARAM_ANDROID_EAC3TYPE {
63    OMX_U32 nSize;                 /**< size of the structure in bytes */
64    OMX_VERSIONTYPE nVersion;      /**< OMX specification version information */
65    OMX_U32 nPortIndex;            /**< port that this structure applies to */
66    OMX_U32 nChannels;             /**< Number of channels */
67    OMX_U32 nSampleRate;           /**< Sampling rate of the source data.  Use 0 for
68                                        variable or unknown sampling rate. */
69} OMX_AUDIO_PARAM_ANDROID_EAC3TYPE;
70
71typedef struct OMX_AUDIO_PARAM_ANDROID_OPUSTYPE {
72    OMX_U32 nSize;            /**< size of the structure in bytes */
73    OMX_VERSIONTYPE nVersion; /**< OMX specification version information */
74    OMX_U32 nPortIndex;       /**< port that this structure applies to */
75    OMX_U32 nChannels;        /**< Number of channels */
76    OMX_U32 nBitRate;         /**< Bit rate of the encoded data data.  Use 0 for variable
77                                   rate or unknown bit rates. Encoding is set to the
78                                   bitrate closest to specified  value (in bps) */
79    OMX_U32 nSampleRate;      /**< Sampling rate of the source data.  Use 0 for
80                                   variable or unknown sampling rate. */
81    OMX_U32 nAudioBandWidth;  /**< Audio band width (in Hz) to which an encoder should
82                                   limit the audio signal. Use 0 to let encoder decide */
83} OMX_AUDIO_PARAM_ANDROID_OPUSTYPE;
84
85typedef struct OMX_AUDIO_PARAM_ANDROID_AACPRESENTATIONTYPE {
86    OMX_U32 nSize;            /**< size of the structure in bytes */
87    OMX_VERSIONTYPE nVersion; /**< OMX specification version information */
88    OMX_S32 nMaxOutputChannels;    /**< Maximum channel count to be output, -1 if unspecified, 0 if downmixing disabled */
89    OMX_S32 nDrcCut;               /**< The DRC attenuation factor, between 0 and 127, -1 if unspecified */
90    OMX_S32 nDrcBoost;             /**< The DRC amplification factor, between 0 and 127, -1 if unspecified */
91    OMX_S32 nHeavyCompression;     /**< 0 for light compression, 1 for heavy compression, -1 if unspecified */
92    OMX_S32 nTargetReferenceLevel; /**< Target reference level, between 0 and 127, -1 if unspecified */
93    OMX_S32 nEncodedTargetLevel;   /**< Target reference level assumed at the encoder, between 0 and 127, -1 if unspecified */
94    OMX_S32 nPCMLimiterEnable;     /**< Signal level limiting, 0 for disable, 1 for enable, -1 if unspecified */
95} OMX_AUDIO_PARAM_ANDROID_AACPRESENTATIONTYPE;
96
97#ifdef __cplusplus
98}
99#endif /* __cplusplus */
100
101#endif /* OMX_AudioExt_h */
102/* File EOF */
103