FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
mpeg4audio.h
Go to the documentation of this file.
1 /*
2  * MPEG-4 Audio common header
3  * Copyright (c) 2008 Baptiste Coudurier <baptiste.coudurier@free.fr>
4  *
5  * This file is part of FFmpeg.
6  *
7  * FFmpeg is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU Lesser General Public
9  * License as published by the Free Software Foundation; either
10  * version 2.1 of the License, or (at your option) any later version.
11  *
12  * FFmpeg is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15  * Lesser General Public License for more details.
16  *
17  * You should have received a copy of the GNU Lesser General Public
18  * License along with FFmpeg; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20  */
21 
22 #ifndef AVCODEC_MPEG4AUDIO_H
23 #define AVCODEC_MPEG4AUDIO_H
24 
25 #include <stdint.h>
26 #include "get_bits.h"
27 #include "put_bits.h"
28 
29 typedef struct MPEG4AudioConfig {
34  int sbr; ///< -1 implicit, 1 presence
39  int channels;
40  int ps; ///< -1 implicit, 1 presence
43 
44 extern av_export const int avpriv_mpeg4audio_sample_rates[16];
45 extern const uint8_t ff_mpeg4audio_channels[8];
46 
47 /**
48  * Parse MPEG-4 systems extradata from a potentially unaligned GetBitContext to retrieve audio configuration.
49  * @param[in] c MPEG4AudioConfig structure to fill.
50  * @param[in] gb Extradata from container.
51  * @param[in] sync_extension look for a sync extension after config if true.
52  * @return On error -1 is returned, on success AudioSpecificConfig bit index in extradata.
53  */
55  int sync_extension);
56 
57 /**
58  * Parse MPEG-4 systems extradata from a raw buffer to retrieve audio configuration.
59  * @param[in] c MPEG4AudioConfig structure to fill.
60  * @param[in] buf Extradata from container.
61  * @param[in] bit_size Extradata size in bits.
62  * @param[in] sync_extension look for a sync extension after config if true.
63  * @return On error -1 is returned, on success AudioSpecificConfig bit index in extradata.
64  */
66  int bit_size, int sync_extension);
67 
70  // Support? Name
71  AOT_AAC_MAIN, ///< Y Main
72  AOT_AAC_LC, ///< Y Low Complexity
73  AOT_AAC_SSR, ///< N (code in SoC repo) Scalable Sample Rate
74  AOT_AAC_LTP, ///< Y Long Term Prediction
75  AOT_SBR, ///< Y Spectral Band Replication
76  AOT_AAC_SCALABLE, ///< N Scalable
77  AOT_TWINVQ, ///< N Twin Vector Quantizer
78  AOT_CELP, ///< N Code Excited Linear Prediction
79  AOT_HVXC, ///< N Harmonic Vector eXcitation Coding
80  AOT_TTSI = 12, ///< N Text-To-Speech Interface
81  AOT_MAINSYNTH, ///< N Main Synthesis
82  AOT_WAVESYNTH, ///< N Wavetable Synthesis
83  AOT_MIDI, ///< N General MIDI
84  AOT_SAFX, ///< N Algorithmic Synthesis and Audio Effects
85  AOT_ER_AAC_LC, ///< N Error Resilient Low Complexity
86  AOT_ER_AAC_LTP = 19, ///< N Error Resilient Long Term Prediction
87  AOT_ER_AAC_SCALABLE, ///< N Error Resilient Scalable
88  AOT_ER_TWINVQ, ///< N Error Resilient Twin Vector Quantizer
89  AOT_ER_BSAC, ///< N Error Resilient Bit-Sliced Arithmetic Coding
90  AOT_ER_AAC_LD, ///< N Error Resilient Low Delay
91  AOT_ER_CELP, ///< N Error Resilient Code Excited Linear Prediction
92  AOT_ER_HVXC, ///< N Error Resilient Harmonic Vector eXcitation Coding
93  AOT_ER_HILN, ///< N Error Resilient Harmonic and Individual Lines plus Noise
94  AOT_ER_PARAM, ///< N Error Resilient Parametric
95  AOT_SSC, ///< N SinuSoidal Coding
96  AOT_PS, ///< N Parametric Stereo
97  AOT_SURROUND, ///< N MPEG Surround
98  AOT_ESCAPE, ///< Y Escape Value
99  AOT_L1, ///< Y Layer 1
100  AOT_L2, ///< Y Layer 2
101  AOT_L3, ///< Y Layer 3
102  AOT_DST, ///< N Direct Stream Transfer
103  AOT_ALS, ///< Y Audio LosslesS
104  AOT_SLS, ///< N Scalable LosslesS
105  AOT_SLS_NON_CORE, ///< N Scalable LosslesS (non core)
106  AOT_ER_AAC_ELD, ///< N Error Resilient Enhanced Low Delay
107  AOT_SMR_SIMPLE, ///< N Symbolic Music Representation Simple
108  AOT_SMR_MAIN, ///< N Symbolic Music Representation Main
109  AOT_USAC_NOSBR, ///< N Unified Speech and Audio Coding (no SBR)
110  AOT_SAOC, ///< N Spatial Audio Object Coding
111  AOT_LD_SURROUND, ///< N Low Delay MPEG Surround
112  AOT_USAC, ///< N Unified Speech and Audio Coding
113 };
114 
115 #define MAX_PCE_SIZE 320 ///<Maximum size of a PCE including the 3-bit ID_PCE
116  ///<marker and the comment
117 
119 
120 #endif /* AVCODEC_MPEG4AUDIO_H */
N Parametric Stereo.
Definition: mpeg4audio.h:96
int avpriv_copy_pce_data(PutBitContext *pb, GetBitContext *gb)
Definition: mpeg4audio.c:180
Y Layer 1.
Definition: mpeg4audio.h:99
int avpriv_mpeg4audio_get_config(MPEG4AudioConfig *c, const uint8_t *buf, int bit_size, int sync_extension)
Parse MPEG-4 systems extradata from a raw buffer to retrieve audio configuration. ...
Definition: mpeg4audio.c:155
const uint8_t ff_mpeg4audio_channels[8]
Definition: mpeg4audio.c:67
N Scalable LosslesS (non core)
Definition: mpeg4audio.h:105
N Code Excited Linear Prediction.
Definition: mpeg4audio.h:78
N Error Resilient Parametric.
Definition: mpeg4audio.h:94
N Error Resilient Long Term Prediction.
Definition: mpeg4audio.h:86
N MPEG Surround.
Definition: mpeg4audio.h:97
uint8_t
N Error Resilient Low Delay.
Definition: mpeg4audio.h:90
int ff_mpeg4audio_get_config_gb(MPEG4AudioConfig *c, GetBitContext *gb, int sync_extension)
Parse MPEG-4 systems extradata from a potentially unaligned GetBitContext to retrieve audio configura...
Definition: mpeg4audio.c:86
N Algorithmic Synthesis and Audio Effects.
Definition: mpeg4audio.h:84
N Scalable LosslesS.
Definition: mpeg4audio.h:104
N General MIDI.
Definition: mpeg4audio.h:83
av_export const int avpriv_mpeg4audio_sample_rates[16]
Definition: mpeg4audio.c:62
N Error Resilient Harmonic and Individual Lines plus Noise.
Definition: mpeg4audio.h:93
bitstream reader API header.
Y Escape Value.
Definition: mpeg4audio.h:98
N Error Resilient Low Complexity.
Definition: mpeg4audio.h:85
N Unified Speech and Audio Coding (no SBR)
Definition: mpeg4audio.h:109
N Symbolic Music Representation Main.
Definition: mpeg4audio.h:108
N Error Resilient Twin Vector Quantizer.
Definition: mpeg4audio.h:88
N Text-To-Speech Interface.
Definition: mpeg4audio.h:80
N Low Delay MPEG Surround.
Definition: mpeg4audio.h:111
N Error Resilient Scalable.
Definition: mpeg4audio.h:87
AudioObjectType
Definition: mpeg4audio.h:68
N Unified Speech and Audio Coding.
Definition: mpeg4audio.h:112
N Harmonic Vector eXcitation Coding.
Definition: mpeg4audio.h:79
N Error Resilient Harmonic Vector eXcitation Coding.
Definition: mpeg4audio.h:92
Y Main.
Definition: mpeg4audio.h:71
N Main Synthesis.
Definition: mpeg4audio.h:81
N (code in SoC repo) Scalable Sample Rate.
Definition: mpeg4audio.h:73
N Scalable.
Definition: mpeg4audio.h:76
N Direct Stream Transfer.
Definition: mpeg4audio.h:102
N Wavetable Synthesis.
Definition: mpeg4audio.h:82
N Error Resilient Code Excited Linear Prediction.
Definition: mpeg4audio.h:91
#define av_export
Definition: internal.h:68
Y Layer 2.
Definition: mpeg4audio.h:100
void * buf
Definition: avisynth_c.h:690
N Error Resilient Bit-Sliced Arithmetic Coding.
Definition: mpeg4audio.h:89
int frame_length_short
Definition: mpeg4audio.h:41
N Error Resilient Enhanced Low Delay.
Definition: mpeg4audio.h:106
N Twin Vector Quantizer.
Definition: mpeg4audio.h:77
Y Spectral Band Replication.
Definition: mpeg4audio.h:75
static double c[64]
N SinuSoidal Coding.
Definition: mpeg4audio.h:95
Y Audio LosslesS.
Definition: mpeg4audio.h:103
Y Layer 3.
Definition: mpeg4audio.h:101
Y Long Term Prediction.
Definition: mpeg4audio.h:74
N Symbolic Music Representation Simple.
Definition: mpeg4audio.h:107
int sbr
-1 implicit, 1 presence
Definition: mpeg4audio.h:34
int ext_sampling_index
Definition: mpeg4audio.h:36
int ps
-1 implicit, 1 presence
Definition: mpeg4audio.h:40
N Spatial Audio Object Coding.
Definition: mpeg4audio.h:110
Y Low Complexity.
Definition: mpeg4audio.h:72
bitstream writer API