FFmpeg coverage


Directory: ../../../ffmpeg/
File: src/libavcodec/mpeg4audio.h
Date: 2021-09-16 08:47:15
Exec Total Coverage
Lines: 24 29 82.8%
Branches: 6 12 50.0%

Line Branch Exec Source
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
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[14];
50
51 /**
52 * Parse MPEG-4 systems extradata from a potentially unaligned GetBitContext to retrieve audio configuration.
53 * @param[in] c MPEG4AudioConfig structure to fill.
54 * @param[in] gb Extradata from container.
55 * @param[in] sync_extension look for a sync extension after config if true.
56 * @param[in] logctx opaque struct starting with an AVClass element, used for logging.
57 * @return negative AVERROR code on error, on success AudioSpecificConfig bit index in extradata.
58 */
59 int ff_mpeg4audio_get_config_gb(MPEG4AudioConfig *c, GetBitContext *gb,
60 int sync_extension, void *logctx);
61
62 /**
63 * Parse MPEG-4 systems extradata from a raw buffer to retrieve audio configuration.
64 * @param[in] c MPEG4AudioConfig structure to fill.
65 * @param[in] buf Extradata from container.
66 * @param[in] size Extradata size in bytes.
67 * @param[in] sync_extension look for a sync extension after config if true.
68 * @param[in] logctx opaque struct starting with an AVClass element, used for logging.
69 * @return negative AVERROR code on error, AudioSpecificConfig bit index in extradata on success.
70 */
71 int avpriv_mpeg4audio_get_config2(MPEG4AudioConfig *c, const uint8_t *buf,
72 int size, int sync_extension, void *logctx);
73
74 enum AudioObjectType {
75 AOT_NULL,
76 // Support? Name
77 AOT_AAC_MAIN, ///< Y Main
78 AOT_AAC_LC, ///< Y Low Complexity
79 AOT_AAC_SSR, ///< N (code in SoC repo) Scalable Sample Rate
80 AOT_AAC_LTP, ///< Y Long Term Prediction
81 AOT_SBR, ///< Y Spectral Band Replication
82 AOT_AAC_SCALABLE, ///< N Scalable
83 AOT_TWINVQ, ///< N Twin Vector Quantizer
84 AOT_CELP, ///< N Code Excited Linear Prediction
85 AOT_HVXC, ///< N Harmonic Vector eXcitation Coding
86 AOT_TTSI = 12, ///< N Text-To-Speech Interface
87 AOT_MAINSYNTH, ///< N Main Synthesis
88 AOT_WAVESYNTH, ///< N Wavetable Synthesis
89 AOT_MIDI, ///< N General MIDI
90 AOT_SAFX, ///< N Algorithmic Synthesis and Audio Effects
91 AOT_ER_AAC_LC, ///< N Error Resilient Low Complexity
92 AOT_ER_AAC_LTP = 19, ///< N Error Resilient Long Term Prediction
93 AOT_ER_AAC_SCALABLE, ///< N Error Resilient Scalable
94 AOT_ER_TWINVQ, ///< N Error Resilient Twin Vector Quantizer
95 AOT_ER_BSAC, ///< N Error Resilient Bit-Sliced Arithmetic Coding
96 AOT_ER_AAC_LD, ///< N Error Resilient Low Delay
97 AOT_ER_CELP, ///< N Error Resilient Code Excited Linear Prediction
98 AOT_ER_HVXC, ///< N Error Resilient Harmonic Vector eXcitation Coding
99 AOT_ER_HILN, ///< N Error Resilient Harmonic and Individual Lines plus Noise
100 AOT_ER_PARAM, ///< N Error Resilient Parametric
101 AOT_SSC, ///< N SinuSoidal Coding
102 AOT_PS, ///< N Parametric Stereo
103 AOT_SURROUND, ///< N MPEG Surround
104 AOT_ESCAPE, ///< Y Escape Value
105 AOT_L1, ///< Y Layer 1
106 AOT_L2, ///< Y Layer 2
107 AOT_L3, ///< Y Layer 3
108 AOT_DST, ///< N Direct Stream Transfer
109 AOT_ALS, ///< Y Audio LosslesS
110 AOT_SLS, ///< N Scalable LosslesS
111 AOT_SLS_NON_CORE, ///< N Scalable LosslesS (non core)
112 AOT_ER_AAC_ELD, ///< N Error Resilient Enhanced Low Delay
113 AOT_SMR_SIMPLE, ///< N Symbolic Music Representation Simple
114 AOT_SMR_MAIN, ///< N Symbolic Music Representation Main
115 AOT_USAC_NOSBR, ///< N Unified Speech and Audio Coding (no SBR)
116 AOT_SAOC, ///< N Spatial Audio Object Coding
117 AOT_LD_SURROUND, ///< N Low Delay MPEG Surround
118 AOT_USAC, ///< N Unified Speech and Audio Coding
119 };
120
121 #define MAX_PCE_SIZE 320 ///<Maximum size of a PCE including the 3-bit ID_PCE
122 ///<marker and the comment
123
124 216 static av_always_inline unsigned int ff_pce_copy_bits(PutBitContext *pb,
125 GetBitContext *gb,
126 int bits)
127 {
128 216 unsigned int el = get_bits(gb, bits);
129 216 put_bits(pb, bits, el);
130 216 return el;
131 }
132
133 18 static inline int ff_copy_pce_data(PutBitContext *pb, GetBitContext *gb)
134 {
135 int five_bit_ch, four_bit_ch, comment_size, bits;
136 18 int offset = put_bits_count(pb);
137
138 18 ff_pce_copy_bits(pb, gb, 10); // Tag, Object Type, Frequency
139 18 five_bit_ch = ff_pce_copy_bits(pb, gb, 4); // Front
140 18 five_bit_ch += ff_pce_copy_bits(pb, gb, 4); // Side
141 18 five_bit_ch += ff_pce_copy_bits(pb, gb, 4); // Back
142 18 four_bit_ch = ff_pce_copy_bits(pb, gb, 2); // LFE
143 18 four_bit_ch += ff_pce_copy_bits(pb, gb, 3); // Data
144 18 five_bit_ch += ff_pce_copy_bits(pb, gb, 4); // Coupling
145
1/2
✗ Branch 1 not taken.
✓ Branch 2 taken 18 times.
18 if (ff_pce_copy_bits(pb, gb, 1)) // Mono Mixdown
146 ff_pce_copy_bits(pb, gb, 4);
147
1/2
✗ Branch 1 not taken.
✓ Branch 2 taken 18 times.
18 if (ff_pce_copy_bits(pb, gb, 1)) // Stereo Mixdown
148 ff_pce_copy_bits(pb, gb, 4);
149
1/2
✗ Branch 1 not taken.
✓ Branch 2 taken 18 times.
18 if (ff_pce_copy_bits(pb, gb, 1)) // Matrix Mixdown
150 ff_pce_copy_bits(pb, gb, 3);
151
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 18 times.
18 for (bits = five_bit_ch*5+four_bit_ch*4; bits > 16; bits -= 16)
152 ff_pce_copy_bits(pb, gb, 16);
153
1/2
✓ Branch 0 taken 18 times.
✗ Branch 1 not taken.
18 if (bits)
154 18 ff_pce_copy_bits(pb, gb, bits);
155 18 align_put_bits(pb);
156 18 align_get_bits(gb);
157 18 comment_size = ff_pce_copy_bits(pb, gb, 8);
158
1/2
✗ Branch 0 not taken.
✓ Branch 1 taken 18 times.
18 for (; comment_size > 0; comment_size--)
159 ff_pce_copy_bits(pb, gb, 8);
160
161 18 return put_bits_count(pb) - offset;
162 }
163
164 #endif /* AVCODEC_MPEG4AUDIO_H */
165