FFmpeg  4.0
amr.c
Go to the documentation of this file.
1 /*
2  * amr file format
3  * Copyright (c) 2001 FFmpeg project
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 /*
23 Write and read amr data according to RFC3267, http://www.ietf.org/rfc/rfc3267.txt?number=3267
24 
25 Only mono files are supported.
26 
27 */
28 
30 #include "avformat.h"
31 #include "internal.h"
32 
33 typedef struct {
34  uint64_t cumulated_size;
35  uint64_t block_count;
36 } AMRContext;
37 
38 static const char AMR_header[] = "#!AMR\n";
39 static const char AMRWB_header[] = "#!AMR-WB\n";
40 
41 static const uint8_t amrnb_packed_size[16] = {
42  13, 14, 16, 18, 20, 21, 27, 32, 6, 1, 1, 1, 1, 1, 1, 1
43 };
44 static const uint8_t amrwb_packed_size[16] = {
45  18, 24, 33, 37, 41, 47, 51, 59, 61, 6, 1, 1, 1, 1, 1, 1
46 };
47 
48 #if CONFIG_AMR_MUXER
49 static int amr_write_header(AVFormatContext *s)
50 {
51  AVIOContext *pb = s->pb;
52  AVCodecParameters *par = s->streams[0]->codecpar;
53 
54  s->priv_data = NULL;
55 
56  if (par->codec_id == AV_CODEC_ID_AMR_NB) {
57  avio_write(pb, AMR_header, sizeof(AMR_header) - 1); /* magic number */
58  } else if (par->codec_id == AV_CODEC_ID_AMR_WB) {
59  avio_write(pb, AMRWB_header, sizeof(AMRWB_header) - 1); /* magic number */
60  } else {
61  return -1;
62  }
63  avio_flush(pb);
64  return 0;
65 }
66 
67 static int amr_write_packet(AVFormatContext *s, AVPacket *pkt)
68 {
69  avio_write(s->pb, pkt->data, pkt->size);
70  return 0;
71 }
72 #endif /* CONFIG_AMR_MUXER */
73 
74 static int amr_probe(AVProbeData *p)
75 {
76  // Only check for "#!AMR" which could be amr-wb, amr-nb.
77  // This will also trigger multichannel files: "#!AMR_MC1.0\n" and
78  // "#!AMR-WB_MC1.0\n" (not supported)
79 
80  if (!memcmp(p->buf, AMR_header, 5))
81  return AVPROBE_SCORE_MAX;
82  else
83  return 0;
84 }
85 
86 /* amr input */
88 {
89  AVIOContext *pb = s->pb;
90  AVStream *st;
91  uint8_t header[9];
92 
93  avio_read(pb, header, 6);
94 
95  st = avformat_new_stream(s, NULL);
96  if (!st)
97  return AVERROR(ENOMEM);
98  if (memcmp(header, AMR_header, 6)) {
99  avio_read(pb, header + 6, 3);
100  if (memcmp(header, AMRWB_header, 9)) {
101  return -1;
102  }
103 
104  st->codecpar->codec_tag = MKTAG('s', 'a', 'w', 'b');
106  st->codecpar->sample_rate = 16000;
107  } else {
108  st->codecpar->codec_tag = MKTAG('s', 'a', 'm', 'r');
110  st->codecpar->sample_rate = 8000;
111  }
112  st->codecpar->channels = 1;
115  avpriv_set_pts_info(st, 64, 1, st->codecpar->sample_rate);
116 
117  return 0;
118 }
119 
121 {
122  AVCodecParameters *par = s->streams[0]->codecpar;
123  int read, size = 0, toc, mode;
124  int64_t pos = avio_tell(s->pb);
125  AMRContext *amr = s->priv_data;
126 
127  if (avio_feof(s->pb)) {
128  return AVERROR_EOF;
129  }
130 
131  // FIXME this is wrong, this should rather be in an AVParser
132  toc = avio_r8(s->pb);
133  mode = (toc >> 3) & 0x0F;
134 
135  if (par->codec_id == AV_CODEC_ID_AMR_NB) {
136  size = amrnb_packed_size[mode];
137  } else if (par->codec_id == AV_CODEC_ID_AMR_WB) {
138  size = amrwb_packed_size[mode];
139  }
140 
141  if (!size || av_new_packet(pkt, size))
142  return AVERROR(EIO);
143 
144  if (amr->cumulated_size < UINT64_MAX - size) {
145  amr->cumulated_size += size;
146  /* Both AMR formats have 50 frames per second */
147  s->streams[0]->codecpar->bit_rate = amr->cumulated_size / ++amr->block_count * 8 * 50;
148  }
149 
150  pkt->stream_index = 0;
151  pkt->pos = pos;
152  pkt->data[0] = toc;
153  pkt->duration = par->codec_id == AV_CODEC_ID_AMR_NB ? 160 : 320;
154  read = avio_read(s->pb, pkt->data + 1, size - 1);
155 
156  if (read != size - 1) {
157  av_packet_unref(pkt);
158  if (read < 0)
159  return read;
160  return AVERROR(EIO);
161  }
162 
163  return 0;
164 }
165 
166 #if CONFIG_AMR_DEMUXER
168  .name = "amr",
169  .long_name = NULL_IF_CONFIG_SMALL("3GPP AMR"),
170  .priv_data_size = sizeof(AMRContext),
175 };
176 #endif
177 
178 #if CONFIG_AMRNB_DEMUXER
179 static int amrnb_probe(AVProbeData *p)
180 {
181  int mode, i = 0, valid = 0, invalid = 0;
182  const uint8_t *b = p->buf;
183 
184  while (i < p->buf_size) {
185  mode = b[i] >> 3 & 0x0F;
186  if (mode < 9 && (b[i] & 0x4) == 0x4) {
187  int last = mode;
188  int size = amrnb_packed_size[mode];
189  while (size--) {
190  if (b[++i] != last)
191  break;
192  last = b[i];
193  }
194  if (size > 0) {
195  valid++;
196  i += size;
197  }
198  } else {
199  valid = 0;
200  invalid++;
201  i++;
202  }
203  }
204  if (valid > 100 && valid > invalid)
205  return AVPROBE_SCORE_EXTENSION / 2 + 1;
206  return 0;
207 }
208 
209 static int amrnb_read_header(AVFormatContext *s)
210 {
212  if (!st)
213  return AVERROR(ENOMEM);
215  st->codecpar->sample_rate = 8000;
216  st->codecpar->channels = 1;
219  avpriv_set_pts_info(st, 64, 1, 8000);
220 
221  return 0;
222 }
223 
225  .name = "amrnb",
226  .long_name = NULL_IF_CONFIG_SMALL("raw AMR-NB"),
227  .priv_data_size = sizeof(AMRContext),
228  .read_probe = amrnb_probe,
229  .read_header = amrnb_read_header,
232 };
233 #endif
234 
235 #if CONFIG_AMRWB_DEMUXER
236 static int amrwb_probe(AVProbeData *p)
237 {
238  int mode, i = 0, valid = 0, invalid = 0;
239  const uint8_t *b = p->buf;
240 
241  while (i < p->buf_size) {
242  mode = b[i] >> 3 & 0x0F;
243  if (mode < 10 && (b[i] & 0x4) == 0x4) {
244  int last = mode;
245  int size = amrwb_packed_size[mode];
246  while (size--) {
247  if (b[++i] != last)
248  break;
249  last = b[i];
250  }
251  if (size > 0) {
252  valid++;
253  i += size;
254  }
255  } else {
256  valid = 0;
257  invalid++;
258  i++;
259  }
260  }
261  if (valid > 100 && valid > invalid)
262  return AVPROBE_SCORE_EXTENSION / 2 - 1;
263  return 0;
264 }
265 
266 static int amrwb_read_header(AVFormatContext *s)
267 {
269  if (!st)
270  return AVERROR(ENOMEM);
272  st->codecpar->sample_rate = 16000;
273  st->codecpar->channels = 1;
276  avpriv_set_pts_info(st, 64, 1, 16000);
277 
278  return 0;
279 }
280 
282  .name = "amrwb",
283  .long_name = NULL_IF_CONFIG_SMALL("raw AMR-WB"),
284  .priv_data_size = sizeof(AMRContext),
285  .read_probe = amrwb_probe,
286  .read_header = amrwb_read_header,
289 };
290 #endif
291 
292 #if CONFIG_AMR_MUXER
294  .name = "amr",
295  .long_name = NULL_IF_CONFIG_SMALL("3GPP AMR"),
296  .mime_type = "audio/amr",
297  .extensions = "amr",
298  .audio_codec = AV_CODEC_ID_AMR_NB,
299  .video_codec = AV_CODEC_ID_NONE,
300  .write_header = amr_write_header,
301  .write_packet = amr_write_packet,
302  .flags = AVFMT_NOTIMESTAMPS,
303 };
304 #endif
#define NULL
Definition: coverity.c:32
const char * s
Definition: avisynth_c.h:768
Bytestream IO Context.
Definition: avio.h:161
int size
int64_t pos
byte position in stream, -1 if unknown
Definition: avcodec.h:1450
void avpriv_set_pts_info(AVStream *s, int pts_wrap_bits, unsigned int pts_num, unsigned int pts_den)
Set the time base and wrapping info for a given stream.
Definition: utils.c:4811
enum AVCodecID codec_id
Specific type of the encoded data (the codec used).
Definition: avcodec.h:3884
uint64_t cumulated_size
Definition: amr.c:34
static int amr_read_header(AVFormatContext *s)
Definition: amr.c:87
int size
Definition: avcodec.h:1431
const char * b
Definition: vf_curves.c:113
static AVPacket pkt
static const char AMR_header[]
Definition: amr.c:38
This struct describes the properties of an encoded stream.
Definition: avcodec.h:3876
Format I/O context.
Definition: avformat.h:1342
uint8_t
int64_t duration
Duration of this packet in AVStream->time_base units, 0 if unknown.
Definition: avcodec.h:1448
AVStream * avformat_new_stream(AVFormatContext *s, const AVCodec *c)
Add a new stream to a media file.
Definition: utils.c:4441
AVStream ** streams
A list of all streams in the file.
Definition: avformat.h:1410
uint8_t * data
Definition: avcodec.h:1430
static const char AMRWB_header[]
Definition: amr.c:39
static int flags
Definition: log.c:55
#define AVERROR_EOF
End of file.
Definition: error.h:55
static const uint8_t amrnb_packed_size[16]
Definition: amr.c:41
static av_always_inline int64_t avio_tell(AVIOContext *s)
ftell() equivalent for AVIOContext.
Definition: avio.h:557
AVInputFormat ff_amrwb_demuxer
static const uint8_t header[24]
Definition: sdr2.c:67
void avio_write(AVIOContext *s, const unsigned char *buf, int size)
Definition: aviobuf.c:218
uint64_t channel_layout
Audio only.
Definition: avcodec.h:3986
int avio_read(AVIOContext *s, unsigned char *buf, int size)
Read size bytes from AVIOContext into buf.
Definition: aviobuf.c:648
int64_t bit_rate
The average bitrate of the encoded data (in bits per second).
Definition: avcodec.h:3913
int av_new_packet(AVPacket *pkt, int size)
Allocate the payload of a packet and initialize its fields with default values.
Definition: avpacket.c:86
#define AVERROR(e)
Definition: error.h:43
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:186
enum AVMediaType codec_type
General type of the encoded data.
Definition: avcodec.h:3880
static int amr_probe(AVProbeData *p)
Definition: amr.c:74
AVOutputFormat ff_amr_muxer
int avio_r8(AVIOContext *s)
Definition: aviobuf.c:639
unsigned char * buf
Buffer must have AVPROBE_PADDING_SIZE of extra allocated bytes filled with zero.
Definition: avformat.h:450
int void avio_flush(AVIOContext *s)
Force flushing of buffered data.
Definition: aviobuf.c:238
audio channel layout utility functions
static int read_probe(AVProbeData *pd)
Definition: jvdec.c:55
const char * name
Definition: avformat.h:507
static const uint8_t amrwb_packed_size[16]
Definition: amr.c:44
static int read_header(FFV1Context *f)
Definition: ffv1dec.c:530
Stream structure.
Definition: avformat.h:873
#define AVFMT_NOTIMESTAMPS
Format does not need / have any timestamps.
Definition: avformat.h:469
static int read_packet(void *opaque, uint8_t *buf, int buf_size)
Definition: avio_reading.c:42
AVIOContext * pb
I/O context.
Definition: avformat.h:1384
void av_packet_unref(AVPacket *pkt)
Wipe the packet.
Definition: avpacket.c:592
#define AVFMT_GENERIC_INDEX
Use generic index building code.
Definition: avformat.h:470
AVInputFormat ff_amr_demuxer
#define AVPROBE_SCORE_EXTENSION
score for file extension
Definition: avformat.h:458
This structure contains the data a format has to probe a file.
Definition: avformat.h:448
static int amr_read_packet(AVFormatContext *s, AVPacket *pkt)
Definition: amr.c:120
AVInputFormat ff_amrnb_demuxer
uint64_t block_count
Definition: amr.c:35
int sample_rate
Audio only.
Definition: avcodec.h:3994
#define AVPROBE_SCORE_MAX
maximum score
Definition: avformat.h:460
Main libavformat public API header.
void * priv_data
Format private data.
Definition: avformat.h:1370
int channels
Audio only.
Definition: avcodec.h:3990
const char * name
A comma separated list of short names for the format.
Definition: avformat.h:647
AVCodecParameters * codecpar
Codec parameters associated with this stream.
Definition: avformat.h:1020
int avio_feof(AVIOContext *s)
feof() equivalent for AVIOContext.
Definition: aviobuf.c:358
uint32_t codec_tag
Additional information about the codec (corresponds to the AVI FOURCC).
Definition: avcodec.h:3888
int stream_index
Definition: avcodec.h:1432
#define AV_CH_LAYOUT_MONO
#define MKTAG(a, b, c, d)
Definition: common.h:366
This structure stores compressed data.
Definition: avcodec.h:1407
mode
Use these values in ebur128_init (or&#39;ed).
Definition: ebur128.h:83