msvc: Properly specify dllexport for data symbols shared across dll boundaries
[ffmpeg.git] / libavcodec / mpeg4audio.h
1 /*
2  * MPEG-4 Audio common header
3  * Copyright (c) 2008 Baptiste Coudurier <baptiste.coudurier@free.fr>
4  *
5  * This file is part of Libav.
6  *
7  * Libav 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  * Libav 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 Libav; 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
27 #include "libavutil/attributes.h"
28
29 #include "get_bits.h"
30 #include "internal.h"
31 #include "put_bits.h"
32
33 typedef struct MPEG4AudioConfig {
34     int object_type;
35     int sampling_index;
36     int sample_rate;
37     int chan_config;
38     int sbr; ///< -1 implicit, 1 presence
39     int ext_object_type;
40     int ext_sampling_index;
41     int ext_sample_rate;
42     int ext_chan_config;
43     int channels;
44     int ps;  ///< -1 implicit, 1 presence
45     int frame_length_short;
46 } MPEG4AudioConfig;
47
48 extern av_export_avcodec const int avpriv_mpeg4audio_sample_rates[16];
49 extern const uint8_t ff_mpeg4audio_channels[8];
50
51 /**
52  * Parse MPEG-4 systems extradata to retrieve audio configuration.
53  * @param[in] c        MPEG4AudioConfig structure to fill.
54  * @param[in] buf      Extradata from container.
55  * @param[in] bit_size Extradata size in bits.
56  * @param[in] sync_extension look for a sync extension after config if true.
57  * @return On error -1 is returned, on success AudioSpecificConfig bit index in extradata.
58  */
59 int avpriv_mpeg4audio_get_config(MPEG4AudioConfig *c, const uint8_t *buf,
60                                  int bit_size, int sync_extension);
61
62 enum AudioObjectType {
63     AOT_NULL,
64                                // Support?                Name
65     AOT_AAC_MAIN,              ///< Y                       Main
66     AOT_AAC_LC,                ///< Y                       Low Complexity
67     AOT_AAC_SSR,               ///< N (code in SoC repo)    Scalable Sample Rate
68     AOT_AAC_LTP,               ///< Y                       Long Term Prediction
69     AOT_SBR,                   ///< Y                       Spectral Band Replication
70     AOT_AAC_SCALABLE,          ///< N                       Scalable
71     AOT_TWINVQ,                ///< N                       Twin Vector Quantizer
72     AOT_CELP,                  ///< N                       Code Excited Linear Prediction
73     AOT_HVXC,                  ///< N                       Harmonic Vector eXcitation Coding
74     AOT_TTSI             = 12, ///< N                       Text-To-Speech Interface
75     AOT_MAINSYNTH,             ///< N                       Main Synthesis
76     AOT_WAVESYNTH,             ///< N                       Wavetable Synthesis
77     AOT_MIDI,                  ///< N                       General MIDI
78     AOT_SAFX,                  ///< N                       Algorithmic Synthesis and Audio Effects
79     AOT_ER_AAC_LC,             ///< N                       Error Resilient Low Complexity
80     AOT_ER_AAC_LTP       = 19, ///< N                       Error Resilient Long Term Prediction
81     AOT_ER_AAC_SCALABLE,       ///< N                       Error Resilient Scalable
82     AOT_ER_TWINVQ,             ///< N                       Error Resilient Twin Vector Quantizer
83     AOT_ER_BSAC,               ///< N                       Error Resilient Bit-Sliced Arithmetic Coding
84     AOT_ER_AAC_LD,             ///< N                       Error Resilient Low Delay
85     AOT_ER_CELP,               ///< N                       Error Resilient Code Excited Linear Prediction
86     AOT_ER_HVXC,               ///< N                       Error Resilient Harmonic Vector eXcitation Coding
87     AOT_ER_HILN,               ///< N                       Error Resilient Harmonic and Individual Lines plus Noise
88     AOT_ER_PARAM,              ///< N                       Error Resilient Parametric
89     AOT_SSC,                   ///< N                       SinuSoidal Coding
90     AOT_PS,                    ///< N                       Parametric Stereo
91     AOT_SURROUND,              ///< N                       MPEG Surround
92     AOT_ESCAPE,                ///< Y                       Escape Value
93     AOT_L1,                    ///< Y                       Layer 1
94     AOT_L2,                    ///< Y                       Layer 2
95     AOT_L3,                    ///< Y                       Layer 3
96     AOT_DST,                   ///< N                       Direct Stream Transfer
97     AOT_ALS,                   ///< Y                       Audio LosslesS
98     AOT_SLS,                   ///< N                       Scalable LosslesS
99     AOT_SLS_NON_CORE,          ///< N                       Scalable LosslesS (non core)
100     AOT_ER_AAC_ELD,            ///< N                       Error Resilient Enhanced Low Delay
101     AOT_SMR_SIMPLE,            ///< N                       Symbolic Music Representation Simple
102     AOT_SMR_MAIN,              ///< N                       Symbolic Music Representation Main
103     AOT_USAC_NOSBR,            ///< N                       Unified Speech and Audio Coding (no SBR)
104     AOT_SAOC,                  ///< N                       Spatial Audio Object Coding
105     AOT_LD_SURROUND,           ///< N                       Low Delay MPEG Surround
106     AOT_USAC,                  ///< N                       Unified Speech and Audio Coding
107 };
108
109 #define MAX_PCE_SIZE 304 ///<Maximum size of a PCE including the 3-bit ID_PCE
110                          ///<marker and the comment
111
112 static av_always_inline unsigned int ff_pce_copy_bits(PutBitContext *pb,
113                                                       GetBitContext *gb,
114                                                       int bits)
115 {
116     unsigned int el = get_bits(gb, bits);
117     put_bits(pb, bits, el);
118     return el;
119 }
120
121 static inline int ff_copy_pce_data(PutBitContext *pb, GetBitContext *gb)
122 {
123     int five_bit_ch, four_bit_ch, comment_size, bits;
124     int offset = put_bits_count(pb);
125
126     ff_pce_copy_bits(pb, gb, 10);               // Tag, Object Type, Frequency
127     five_bit_ch  = ff_pce_copy_bits(pb, gb, 4); // Front
128     five_bit_ch += ff_pce_copy_bits(pb, gb, 4); // Side
129     five_bit_ch += ff_pce_copy_bits(pb, gb, 4); // Back
130     four_bit_ch  = ff_pce_copy_bits(pb, gb, 2); // LFE
131     four_bit_ch += ff_pce_copy_bits(pb, gb, 3); // Data
132     five_bit_ch += ff_pce_copy_bits(pb, gb, 4); // Coupling
133     if (ff_pce_copy_bits(pb, gb, 1))            // Mono Mixdown
134         ff_pce_copy_bits(pb, gb, 4);
135     if (ff_pce_copy_bits(pb, gb, 1))            // Stereo Mixdown
136         ff_pce_copy_bits(pb, gb, 4);
137     if (ff_pce_copy_bits(pb, gb, 1))            // Matrix Mixdown
138         ff_pce_copy_bits(pb, gb, 3);
139     for (bits = five_bit_ch*5+four_bit_ch*4; bits > 16; bits -= 16)
140         ff_pce_copy_bits(pb, gb, 16);
141     if (bits)
142         ff_pce_copy_bits(pb, gb, bits);
143     avpriv_align_put_bits(pb);
144     align_get_bits(gb);
145     comment_size = ff_pce_copy_bits(pb, gb, 8);
146     for (; comment_size > 0; comment_size--)
147         ff_pce_copy_bits(pb, gb, 8);
148
149     return put_bits_count(pb) - offset;
150 }
151
152 #endif /* AVCODEC_MPEG4AUDIO_H */