FFmpeg coverage

GCC Code Coverage Report

Directory:	../../../ffmpeg/		Exec	Total	Coverage
File:	src/libavcodec/mpeg4audio.h	Lines:	24	29	82.8 %
Date:	2021-04-20 15:25:36	Branches:	6	12	50.0 %


/*
 * MPEG-4 Audio common header
 * Copyright (c) 2008 Baptiste Coudurier <baptiste.coudurier@free.fr>
 *
 * This file is part of FFmpeg.
 *
 * FFmpeg is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * FFmpeg is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with FFmpeg; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 */

#ifndef AVCODEC_MPEG4AUDIO_H
#define AVCODEC_MPEG4AUDIO_H

#include <stdint.h>

#include "libavutil/attributes.h"

#include "get_bits.h"
#include "internal.h"
#include "put_bits.h"

typedef struct MPEG4AudioConfig {
    int object_type;
    int sampling_index;
    int sample_rate;
    int chan_config;
    int sbr; ///< -1 implicit, 1 presence
    int ext_object_type;
    int ext_sampling_index;
    int ext_sample_rate;
    int ext_chan_config;
    int channels;
    int ps;  ///< -1 implicit, 1 presence
    int frame_length_short;
} MPEG4AudioConfig;

extern av_export_avcodec const int avpriv_mpeg4audio_sample_rates[16];
extern const uint8_t ff_mpeg4audio_channels[14];

/**
 * Parse MPEG-4 systems extradata from a potentially unaligned GetBitContext to retrieve audio configuration.
 * @param[in] c        MPEG4AudioConfig structure to fill.
 * @param[in] gb       Extradata from container.
 * @param[in] sync_extension look for a sync extension after config if true.
 * @param[in] logctx opaque struct starting with an AVClass element, used for logging.
 * @return negative AVERROR code on error, on success AudioSpecificConfig bit index in extradata.
 */
int ff_mpeg4audio_get_config_gb(MPEG4AudioConfig *c, GetBitContext *gb,
                                int sync_extension, void *logctx);

#if LIBAVCODEC_VERSION_MAJOR < 59
/**
 * Parse MPEG-4 systems extradata from a raw buffer to retrieve audio configuration.
 * @param[in] c        MPEG4AudioConfig structure to fill.
 * @param[in] buf      Extradata from container.
 * @param[in] bit_size Extradata size in bits.
 * @param[in] sync_extension look for a sync extension after config if true.
 * @return negative AVERROR code on error, on success AudioSpecificConfig bit index in extradata.
 */
int avpriv_mpeg4audio_get_config(MPEG4AudioConfig *c, const uint8_t *buf,
                                 int bit_size, int sync_extension);
#endif

/**
 * Parse MPEG-4 systems extradata from a raw buffer to retrieve audio configuration.
 * @param[in] c        MPEG4AudioConfig structure to fill.
 * @param[in] buf      Extradata from container.
 * @param[in] size     Extradata size in bytes.
 * @param[in] sync_extension look for a sync extension after config if true.
 * @param[in] logctx opaque struct starting with an AVClass element, used for logging.
 * @return negative AVERROR code on error, AudioSpecificConfig bit index in extradata on success.
 */
int avpriv_mpeg4audio_get_config2(MPEG4AudioConfig *c, const uint8_t *buf,
                                  int size, int sync_extension, void *logctx);

enum AudioObjectType {
    AOT_NULL,
                               // Support?                Name
    AOT_AAC_MAIN,              ///< Y                       Main
    AOT_AAC_LC,                ///< Y                       Low Complexity
    AOT_AAC_SSR,               ///< N (code in SoC repo)    Scalable Sample Rate
    AOT_AAC_LTP,               ///< Y                       Long Term Prediction
    AOT_SBR,                   ///< Y                       Spectral Band Replication
    AOT_AAC_SCALABLE,          ///< N                       Scalable
    AOT_TWINVQ,                ///< N                       Twin Vector Quantizer
    AOT_CELP,                  ///< N                       Code Excited Linear Prediction
    AOT_HVXC,                  ///< N                       Harmonic Vector eXcitation Coding
    AOT_TTSI             = 12, ///< N                       Text-To-Speech Interface
    AOT_MAINSYNTH,             ///< N                       Main Synthesis
    AOT_WAVESYNTH,             ///< N                       Wavetable Synthesis
    AOT_MIDI,                  ///< N                       General MIDI
    AOT_SAFX,                  ///< N                       Algorithmic Synthesis and Audio Effects
    AOT_ER_AAC_LC,             ///< N                       Error Resilient Low Complexity
    AOT_ER_AAC_LTP       = 19, ///< N                       Error Resilient Long Term Prediction
    AOT_ER_AAC_SCALABLE,       ///< N                       Error Resilient Scalable
    AOT_ER_TWINVQ,             ///< N                       Error Resilient Twin Vector Quantizer
    AOT_ER_BSAC,               ///< N                       Error Resilient Bit-Sliced Arithmetic Coding
    AOT_ER_AAC_LD,             ///< N                       Error Resilient Low Delay
    AOT_ER_CELP,               ///< N                       Error Resilient Code Excited Linear Prediction
    AOT_ER_HVXC,               ///< N                       Error Resilient Harmonic Vector eXcitation Coding
    AOT_ER_HILN,               ///< N                       Error Resilient Harmonic and Individual Lines plus Noise
    AOT_ER_PARAM,              ///< N                       Error Resilient Parametric
    AOT_SSC,                   ///< N                       SinuSoidal Coding
    AOT_PS,                    ///< N                       Parametric Stereo
    AOT_SURROUND,              ///< N                       MPEG Surround
    AOT_ESCAPE,                ///< Y                       Escape Value
    AOT_L1,                    ///< Y                       Layer 1
    AOT_L2,                    ///< Y                       Layer 2
    AOT_L3,                    ///< Y                       Layer 3
    AOT_DST,                   ///< N                       Direct Stream Transfer
    AOT_ALS,                   ///< Y                       Audio LosslesS
    AOT_SLS,                   ///< N                       Scalable LosslesS
    AOT_SLS_NON_CORE,          ///< N                       Scalable LosslesS (non core)
    AOT_ER_AAC_ELD,            ///< N                       Error Resilient Enhanced Low Delay
    AOT_SMR_SIMPLE,            ///< N                       Symbolic Music Representation Simple
    AOT_SMR_MAIN,              ///< N                       Symbolic Music Representation Main
    AOT_USAC_NOSBR,            ///< N                       Unified Speech and Audio Coding (no SBR)
    AOT_SAOC,                  ///< N                       Spatial Audio Object Coding
    AOT_LD_SURROUND,           ///< N                       Low Delay MPEG Surround
    AOT_USAC,                  ///< N                       Unified Speech and Audio Coding
};

#define MAX_PCE_SIZE 320 ///<Maximum size of a PCE including the 3-bit ID_PCE
                         ///<marker and the comment

static av_always_inline unsigned int ff_pce_copy_bits(PutBitContext *pb,
                                                      GetBitContext *gb,
                                                      int bits)
{
    unsigned int el = get_bits(gb, bits);
    put_bits(pb, bits, el);
    return el;
}

static inline int ff_copy_pce_data(PutBitContext *pb, GetBitContext *gb)
{
    int five_bit_ch, four_bit_ch, comment_size, bits;
    int offset = put_bits_count(pb);

    ff_pce_copy_bits(pb, gb, 10);               // Tag, Object Type, Frequency
    five_bit_ch  = ff_pce_copy_bits(pb, gb, 4); // Front
    five_bit_ch += ff_pce_copy_bits(pb, gb, 4); // Side
    five_bit_ch += ff_pce_copy_bits(pb, gb, 4); // Back
    four_bit_ch  = ff_pce_copy_bits(pb, gb, 2); // LFE
    four_bit_ch += ff_pce_copy_bits(pb, gb, 3); // Data
    five_bit_ch += ff_pce_copy_bits(pb, gb, 4); // Coupling
    if (ff_pce_copy_bits(pb, gb, 1))            // Mono Mixdown
        ff_pce_copy_bits(pb, gb, 4);
    if (ff_pce_copy_bits(pb, gb, 1))            // Stereo Mixdown
        ff_pce_copy_bits(pb, gb, 4);
    if (ff_pce_copy_bits(pb, gb, 1))            // Matrix Mixdown
        ff_pce_copy_bits(pb, gb, 3);
    for (bits = five_bit_ch*5+four_bit_ch*4; bits > 16; bits -= 16)
        ff_pce_copy_bits(pb, gb, 16);
    if (bits)
        ff_pce_copy_bits(pb, gb, bits);
    align_put_bits(pb);
    align_get_bits(gb);
    comment_size = ff_pce_copy_bits(pb, gb, 8);
    for (; comment_size > 0; comment_size--)
        ff_pce_copy_bits(pb, gb, 8);

    return put_bits_count(pb) - offset;
}

#endif /* AVCODEC_MPEG4AUDIO_H */


Generated by: GCOVR (Version 4.2)

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