FFmpeg
adtsenc.c
Go to the documentation of this file.
1 /*
2  * ADTS muxer.
3  * Copyright (c) 2006 Baptiste Coudurier <baptiste.coudurier@smartjog.com>
4  * Mans Rullgard <mans@mansr.com>
5  *
6  * This file is part of FFmpeg.
7  *
8  * FFmpeg is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Lesser General Public
10  * License as published by the Free Software Foundation; either
11  * version 2.1 of the License, or (at your option) any later version.
12  *
13  * FFmpeg is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16  * Lesser General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public
19  * License along with FFmpeg; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21  */
22 
23 #include "libavcodec/get_bits.h"
24 #include "libavcodec/put_bits.h"
25 #include "libavcodec/codec_id.h"
26 #include "libavcodec/codec_par.h"
27 #include "libavcodec/packet.h"
28 #include "libavcodec/mpeg4audio.h"
30 #include "libavutil/opt.h"
31 #include "avformat.h"
32 #include "apetag.h"
33 #include "id3v2.h"
34 
35 #define ADTS_HEADER_SIZE 7
36 
37 typedef struct ADTSContext {
38  AVClass *class;
43  int pce_size;
44  int apetag;
45  int id3v2tag;
46  int mpeg_id;
48 } ADTSContext;
49 
50 #define ADTS_MAX_FRAME_BYTES ((1 << 14) - 1)
51 
52 static int adts_decode_extradata(AVFormatContext *s, ADTSContext *adts, const uint8_t *buf, int size)
53 {
54  GetBitContext gb;
55  PutBitContext pb;
56  MPEG4AudioConfig m4ac;
57  int off, ret;
58 
59  ret = init_get_bits8(&gb, buf, size);
60  if (ret < 0)
61  return ret;
62  off = avpriv_mpeg4audio_get_config2(&m4ac, buf, size, 1, s);
63  if (off < 0)
64  return off;
65  skip_bits_long(&gb, off);
66  adts->objecttype = m4ac.object_type - 1;
67  adts->sample_rate_index = m4ac.sampling_index;
68  adts->channel_conf = m4ac.chan_config;
69 
70  if (adts->objecttype > 3U) {
71  av_log(s, AV_LOG_ERROR, "MPEG-4 AOT %d is not allowed in ADTS\n", adts->objecttype+1);
72  return AVERROR_INVALIDDATA;
73  }
74  if (adts->sample_rate_index == 15) {
75  av_log(s, AV_LOG_ERROR, "Escape sample rate index illegal in ADTS\n");
76  return AVERROR_INVALIDDATA;
77  }
78  if (get_bits(&gb, 1)) {
79  av_log(s, AV_LOG_ERROR, "960/120 MDCT window is not allowed in ADTS\n");
80  return AVERROR_INVALIDDATA;
81  }
82  if (get_bits(&gb, 1)) {
83  av_log(s, AV_LOG_ERROR, "Scalable configurations are not allowed in ADTS\n");
84  return AVERROR_INVALIDDATA;
85  }
86  if (get_bits(&gb, 1)) {
87  av_log(s, AV_LOG_ERROR, "Extension flag is not allowed in ADTS\n");
88  return AVERROR_INVALIDDATA;
89  }
90  if (!adts->channel_conf) {
91  init_put_bits(&pb, adts->pce_data, MAX_PCE_SIZE);
92 
93  put_bits(&pb, 3, 5); //ID_PCE
94  adts->pce_size = (ff_copy_pce_data(&pb, &gb) + 3) / 8;
95  flush_put_bits(&pb);
96  }
97 
98  adts->write_adts = 1;
99 
100  return 0;
101 }
102 
104 {
105  ADTSContext *adts = s->priv_data;
106  AVCodecParameters *par = s->streams[0]->codecpar;
107 
108  if (par->codec_id != AV_CODEC_ID_AAC) {
109  av_log(s, AV_LOG_ERROR, "Only AAC streams can be muxed by the ADTS muxer\n");
110  return AVERROR(EINVAL);
111  }
112  if (par->extradata_size > 0)
113  return adts_decode_extradata(s, adts, par->extradata,
114  par->extradata_size);
115 
116  return 0;
117 }
118 
120 {
121  ADTSContext *adts = s->priv_data;
122 
123  if (adts->id3v2tag)
125 
126  return 0;
127 }
128 
130  uint8_t *buf, int size, int pce_size)
131 {
132  PutBitContext pb;
133 
134  unsigned full_frame_size = (unsigned)ADTS_HEADER_SIZE + size + pce_size;
135  if (full_frame_size > ADTS_MAX_FRAME_BYTES) {
136  av_log(NULL, AV_LOG_ERROR, "ADTS frame size too large: %u (max %d)\n",
137  full_frame_size, ADTS_MAX_FRAME_BYTES);
138  return AVERROR_INVALIDDATA;
139  }
140 
141  init_put_bits(&pb, buf, ADTS_HEADER_SIZE);
142 
143  /* adts_fixed_header */
144  put_bits(&pb, 12, 0xfff); /* syncword */
145  put_bits(&pb, 1, ctx->mpeg_id); /* ID */
146  put_bits(&pb, 2, 0); /* layer */
147  put_bits(&pb, 1, 1); /* protection_absent */
148  put_bits(&pb, 2, ctx->objecttype); /* profile_objecttype */
149  put_bits(&pb, 4, ctx->sample_rate_index);
150  put_bits(&pb, 1, 0); /* private_bit */
151  put_bits(&pb, 3, ctx->channel_conf); /* channel_configuration */
152  put_bits(&pb, 1, 0); /* original_copy */
153  put_bits(&pb, 1, 0); /* home */
154 
155  /* adts_variable_header */
156  put_bits(&pb, 1, 0); /* copyright_identification_bit */
157  put_bits(&pb, 1, 0); /* copyright_identification_start */
158  put_bits(&pb, 13, full_frame_size); /* aac_frame_length */
159  put_bits(&pb, 11, 0x7ff); /* adts_buffer_fullness */
160  put_bits(&pb, 2, 0); /* number_of_raw_data_blocks_in_frame */
161 
162  flush_put_bits(&pb);
163 
164  return 0;
165 }
166 
168 {
169  ADTSContext *adts = s->priv_data;
170  AVCodecParameters *par = s->streams[0]->codecpar;
171  AVIOContext *pb = s->pb;
172  uint8_t buf[ADTS_HEADER_SIZE];
173 
174  if (!pkt->size)
175  return 0;
176  if (!par->extradata_size) {
177  uint8_t *side_data;
178  size_t side_data_size;
179  int ret;
180 
182  &side_data_size);
183  if (side_data_size) {
184  ret = adts_decode_extradata(s, adts, side_data, side_data_size);
185  if (ret < 0)
186  return ret;
187  ret = ff_alloc_extradata(par, side_data_size);
188  if (ret < 0)
189  return ret;
190  memcpy(par->extradata, side_data, side_data_size);
191  }
192  }
193  if (adts->write_adts) {
194  int err = adts_write_frame_header(adts, buf, pkt->size,
195  adts->pce_size);
196  if (err < 0)
197  return err;
198  avio_write(pb, buf, ADTS_HEADER_SIZE);
199  if (adts->pce_size) {
200  avio_write(pb, adts->pce_data, adts->pce_size);
201  adts->pce_size = 0;
202  }
203  }
204  avio_write(pb, pkt->data, pkt->size);
205 
206  return 0;
207 }
208 
210 {
211  ADTSContext *adts = s->priv_data;
212 
213  if (adts->apetag)
215 
216  return 0;
217 }
218 
219 #define ENC AV_OPT_FLAG_ENCODING_PARAM
220 #define OFFSET(obj) offsetof(ADTSContext, obj)
221 static const AVOption options[] = {
222  { "write_id3v2", "Enable ID3v2 tag writing", OFFSET(id3v2tag), AV_OPT_TYPE_BOOL, {.i64 = 0}, 0, 1, ENC},
223  { "write_apetag", "Enable APE tag writing", OFFSET(apetag), AV_OPT_TYPE_BOOL, {.i64 = 0}, 0, 1, ENC},
224  { "write_mpeg2", "Set MPEG version to MPEG-2", OFFSET(mpeg_id), AV_OPT_TYPE_BOOL, {.i64 = 0}, 0, 1, ENC},
225  { NULL },
226 };
227 
228 static const AVClass adts_muxer_class = {
229  .class_name = "ADTS muxer",
230  .item_name = av_default_item_name,
231  .option = options,
232  .version = LIBAVUTIL_VERSION_INT,
233 };
234 
236  .name = "adts",
237  .long_name = NULL_IF_CONFIG_SMALL("ADTS AAC (Advanced Audio Coding)"),
238  .mime_type = "audio/aac",
239  .extensions = "aac,adts",
240  .priv_data_size = sizeof(ADTSContext),
241  .audio_codec = AV_CODEC_ID_AAC,
242  .video_codec = AV_CODEC_ID_NONE,
243  .init = adts_init,
247  .priv_class = &adts_muxer_class,
249 };
skip_bits_long
static void skip_bits_long(GetBitContext *s, int n)
Skips the specified number of bits.
Definition: get_bits.h:268
AVCodecParameters::extradata
uint8_t * extradata
Extra binary data needed for initializing the decoder, codec-dependent.
Definition: codec_par.h:76
adts_write_trailer
static int adts_write_trailer(AVFormatContext *s)
Definition: adtsenc.c:209
AVOutputFormat::name
const char * name
Definition: avformat.h:510
AVERROR
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later. That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another. Frame references ownership and permissions
opt.h
adts_init
static int adts_init(AVFormatContext *s)
Definition: adtsenc.c:103
AVCodecParameters
This struct describes the properties of an encoded stream.
Definition: codec_par.h:54
ADTSContext::apetag
int apetag
Definition: adtsenc.c:44
AVFMT_NOTIMESTAMPS
#define AVFMT_NOTIMESTAMPS
Format does not need / have any timestamps.
Definition: avformat.h:481
adts_decode_extradata
static int adts_decode_extradata(AVFormatContext *s, ADTSContext *adts, const uint8_t *buf, int size)
Definition: adtsenc.c:52
init_put_bits
static void init_put_bits(PutBitContext *s, uint8_t *buffer, int buffer_size)
Initialize the PutBitContext s.
Definition: put_bits.h:62
id3v2.h
apetag.h
put_bits
static void put_bits(Jpeg2000EncoderContext *s, int val, int n)
put n times val bit
Definition: j2kenc.c:221
AVPacket::data
uint8_t * data
Definition: packet.h:374
AVOption
AVOption.
Definition: opt.h:251
MAX_PCE_SIZE
#define MAX_PCE_SIZE
Maximum size of a PCE including the 3-bit ID_PCE.
Definition: mpeg4audio.h:117
options
static const AVOption options[]
Definition: adtsenc.c:221
ADTS_MAX_FRAME_BYTES
#define ADTS_MAX_FRAME_BYTES
Definition: adtsenc.c:50
MPEG4AudioConfig
Definition: mpeg4audio.h:29
get_bits
static unsigned int get_bits(GetBitContext *s, int n)
Read 1-25 bits.
Definition: get_bits.h:325
mpeg4audio.h
ADTS_HEADER_SIZE
#define ADTS_HEADER_SIZE
Definition: adtsenc.c:35
adts_write_packet
static int adts_write_packet(AVFormatContext *s, AVPacket *pkt)
Definition: adtsenc.c:167
GetBitContext
Definition: get_bits.h:107
adts_write_header
static int adts_write_header(AVFormatContext *s)
Definition: adtsenc.c:119
pkt
AVPacket * pkt
Definition: movenc.c:59
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:180
init_get_bits8
static int init_get_bits8(GetBitContext *s, const uint8_t *buffer, int byte_size)
Initialize GetBitContext.
Definition: get_bits.h:524
codec_id.h
avpriv_mpeg4audio_get_config2
int avpriv_mpeg4audio_get_config2(MPEG4AudioConfig *c, const uint8_t *buf, int size, int sync_extension, void *logctx)
Parse MPEG-4 systems extradata from a raw buffer to retrieve audio configuration.
Definition: mpeg4audio.c:165
s
#define s(width, name)
Definition: cbs_vp9.c:256
ADTSContext::id3v2tag
int id3v2tag
Definition: adtsenc.c:45
init
int(* init)(AVBSFContext *ctx)
Definition: dts2pts_bsf.c:365
ctx
AVFormatContext * ctx
Definition: movenc.c:48
ff_copy_pce_data
static int ff_copy_pce_data(PutBitContext *pb, GetBitContext *gb)
Definition: mpeg4audio_copy_pce.h:38
get_bits.h
PutBitContext
Definition: put_bits.h:50
ADTSContext::pce_size
int pce_size
Definition: adtsenc.c:43
ff_ape_write_tag
int ff_ape_write_tag(AVFormatContext *s)
Write an APE tag into a file.
Definition: apetag.c:176
ADTSContext::objecttype
int objecttype
Definition: adtsenc.c:40
AVFormatContext
Format I/O context.
Definition: avformat.h:1216
LIBAVUTIL_VERSION_INT
#define LIBAVUTIL_VERSION_INT
Definition: version.h:85
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:66
NULL
#define NULL
Definition: coverity.c:32
write_trailer
static int write_trailer(AVFormatContext *s1)
Definition: v4l2enc.c:100
av_default_item_name
const char * av_default_item_name(void *ptr)
Return the context name.
Definition: log.c:237
MPEG4AudioConfig::sampling_index
int sampling_index
Definition: mpeg4audio.h:31
ENC
#define ENC
Definition: adtsenc.c:219
AVCodecParameters::extradata_size
int extradata_size
Size of the extradata content in bytes.
Definition: codec_par.h:80
AV_CODEC_ID_AAC
@ AV_CODEC_ID_AAC
Definition: codec_id.h:440
AVIOContext
Bytestream IO Context.
Definition: avio.h:166
AVPacket::size
int size
Definition: packet.h:375
NULL_IF_CONFIG_SMALL
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
Definition: internal.h:115
ADTSContext::write_adts
int write_adts
Definition: adtsenc.c:39
size
int size
Definition: twinvq_data.h:10344
ID3v2_DEFAULT_MAGIC
#define ID3v2_DEFAULT_MAGIC
Default magic bytes for ID3v2 header: "ID3".
Definition: id3v2.h:35
avio_write
void avio_write(AVIOContext *s, const unsigned char *buf, int size)
Definition: aviobuf.c:232
ADTSContext::channel_conf
int channel_conf
Definition: adtsenc.c:42
AV_CODEC_ID_NONE
@ AV_CODEC_ID_NONE
Definition: codec_id.h:50
AVOutputFormat
Definition: avformat.h:509
packet.h
av_packet_get_side_data
uint8_t * av_packet_get_side_data(const AVPacket *pkt, enum AVPacketSideDataType type, size_t *size)
Get side information from packet.
Definition: avpacket.c:251
ADTSContext::sample_rate_index
int sample_rate_index
Definition: adtsenc.c:41
MPEG4AudioConfig::chan_config
int chan_config
Definition: mpeg4audio.h:33
adts_muxer_class
static const AVClass adts_muxer_class
Definition: adtsenc.c:228
write_packet
static int write_packet(Muxer *mux, OutputStream *ost, AVPacket *pkt)
Definition: ffmpeg_mux.c:61
ff_adts_muxer
const AVOutputFormat ff_adts_muxer
Definition: adtsenc.c:235
ret
ret
Definition: filter_design.txt:187
AVClass::class_name
const char * class_name
The name of the class; usually it is the same name as the context structure type to which the AVClass...
Definition: log.h:71
avformat.h
MPEG4AudioConfig::object_type
int object_type
Definition: mpeg4audio.h:30
U
#define U(x)
Definition: vpx_arith.h:37
AV_PKT_DATA_NEW_EXTRADATA
@ AV_PKT_DATA_NEW_EXTRADATA
The AV_PKT_DATA_NEW_EXTRADATA is used to notify the codec or the format that the extradata buffer was...
Definition: packet.h:56
ADTSContext::pce_data
uint8_t pce_data[MAX_PCE_SIZE]
Definition: adtsenc.c:47
adts_write_frame_header
static int adts_write_frame_header(ADTSContext *ctx, uint8_t *buf, int size, int pce_size)
Definition: adtsenc.c:129
flush_put_bits
static void flush_put_bits(PutBitContext *s)
Pad the end of the output stream with zeros.
Definition: put_bits.h:143
codec_par.h
AVCodecParameters::codec_id
enum AVCodecID codec_id
Specific type of the encoded data (the codec used).
Definition: codec_par.h:62
AVPacket
This structure stores compressed data.
Definition: packet.h:351
AV_OPT_TYPE_BOOL
@ AV_OPT_TYPE_BOOL
Definition: opt.h:244
flags
#define flags(name, subs,...)
Definition: cbs_av1.c:561
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:27
AVERROR_INVALIDDATA
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:61
write_header
static void write_header(FFV1Context *f)
Definition: ffv1enc.c:346
put_bits.h
OFFSET
#define OFFSET(obj)
Definition: adtsenc.c:220
ff_id3v2_write_simple
int ff_id3v2_write_simple(struct AVFormatContext *s, int id3v2_version, const char *magic)
Write an ID3v2 tag containing all global metadata from s.
Definition: id3v2enc.c:445
mpeg4audio_copy_pce.h
ADTSContext::mpeg_id
int mpeg_id
Definition: adtsenc.c:46
ADTSContext
Definition: adtsenc.c:37
ff_alloc_extradata
int ff_alloc_extradata(AVCodecParameters *par, int size)
Allocate extradata with additional AV_INPUT_BUFFER_PADDING_SIZE at end which is always set to 0.
Definition: utils.c:238