FFmpeg  3.4.9
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 #if CONFIG_AMR_MUXER
42 static int amr_write_header(AVFormatContext *s)
43 {
44  AVIOContext *pb = s->pb;
45  AVCodecParameters *par = s->streams[0]->codecpar;
46 
47  s->priv_data = NULL;
48 
49  if (par->codec_id == AV_CODEC_ID_AMR_NB) {
50  avio_write(pb, AMR_header, sizeof(AMR_header) - 1); /* magic number */
51  } else if (par->codec_id == AV_CODEC_ID_AMR_WB) {
52  avio_write(pb, AMRWB_header, sizeof(AMRWB_header) - 1); /* magic number */
53  } else {
54  return -1;
55  }
56  avio_flush(pb);
57  return 0;
58 }
59 
60 static int amr_write_packet(AVFormatContext *s, AVPacket *pkt)
61 {
62  avio_write(s->pb, pkt->data, pkt->size);
63  return 0;
64 }
65 #endif /* CONFIG_AMR_MUXER */
66 
67 static int amr_probe(AVProbeData *p)
68 {
69  // Only check for "#!AMR" which could be amr-wb, amr-nb.
70  // This will also trigger multichannel files: "#!AMR_MC1.0\n" and
71  // "#!AMR-WB_MC1.0\n" (not supported)
72 
73  if (!memcmp(p->buf, AMR_header, 5))
74  return AVPROBE_SCORE_MAX;
75  else
76  return 0;
77 }
78 
79 /* amr input */
81 {
82  AVIOContext *pb = s->pb;
83  AVStream *st;
84  uint8_t header[9];
85 
86  if (avio_read(pb, header, 6) != 6)
87  return AVERROR_INVALIDDATA;
88 
89  st = avformat_new_stream(s, NULL);
90  if (!st)
91  return AVERROR(ENOMEM);
92  if (memcmp(header, AMR_header, 6)) {
93  if (avio_read(pb, header + 6, 3) != 3)
94  return AVERROR_INVALIDDATA;
95  if (memcmp(header, AMRWB_header, 9)) {
96  return -1;
97  }
98 
99  st->codecpar->codec_tag = MKTAG('s', 'a', 'w', 'b');
101  st->codecpar->sample_rate = 16000;
102  } else {
103  st->codecpar->codec_tag = MKTAG('s', 'a', 'm', 'r');
105  st->codecpar->sample_rate = 8000;
106  }
107  st->codecpar->channels = 1;
110  avpriv_set_pts_info(st, 64, 1, st->codecpar->sample_rate);
111 
112  return 0;
113 }
114 
116 {
117  AVCodecParameters *par = s->streams[0]->codecpar;
118  int read, size = 0, toc, mode;
119  int64_t pos = avio_tell(s->pb);
120  AMRContext *amr = s->priv_data;
121 
122  if (avio_feof(s->pb)) {
123  return AVERROR_EOF;
124  }
125 
126  // FIXME this is wrong, this should rather be in an AVParser
127  toc = avio_r8(s->pb);
128  mode = (toc >> 3) & 0x0F;
129 
130  if (par->codec_id == AV_CODEC_ID_AMR_NB) {
131  static const uint8_t packed_size[16] = {
132  12, 13, 15, 17, 19, 20, 26, 31, 5, 0, 0, 0, 0, 0, 0, 0
133  };
134 
135  size = packed_size[mode] + 1;
136  } else if (par->codec_id == AV_CODEC_ID_AMR_WB) {
137  static const uint8_t packed_size[16] = {
138  18, 24, 33, 37, 41, 47, 51, 59, 61, 6, 6, 0, 0, 0, 1, 1
139  };
140 
141  size = packed_size[mode];
142  }
143 
144  if (!size || av_new_packet(pkt, size))
145  return AVERROR(EIO);
146 
147  if (amr->cumulated_size < UINT64_MAX - size) {
148  amr->cumulated_size += size;
149  /* Both AMR formats have 50 frames per second */
150  s->streams[0]->codecpar->bit_rate = amr->cumulated_size / ++amr->block_count * 8 * 50;
151  }
152 
153  pkt->stream_index = 0;
154  pkt->pos = pos;
155  pkt->data[0] = toc;
156  pkt->duration = par->codec_id == AV_CODEC_ID_AMR_NB ? 160 : 320;
157  read = avio_read(s->pb, pkt->data + 1, size - 1);
158 
159  if (read != size - 1) {
160  av_packet_unref(pkt);
161  if (read < 0)
162  return read;
163  return AVERROR(EIO);
164  }
165 
166  return 0;
167 }
168 
169 #if CONFIG_AMR_DEMUXER
170 AVInputFormat ff_amr_demuxer = {
171  .name = "amr",
172  .long_name = NULL_IF_CONFIG_SMALL("3GPP AMR"),
173  .priv_data_size = sizeof(AMRContext),
178 };
179 #endif
180 
181 #if CONFIG_AMR_MUXER
182 AVOutputFormat ff_amr_muxer = {
183  .name = "amr",
184  .long_name = NULL_IF_CONFIG_SMALL("3GPP AMR"),
185  .mime_type = "audio/amr",
186  .extensions = "amr",
187  .audio_codec = AV_CODEC_ID_AMR_NB,
188  .video_codec = AV_CODEC_ID_NONE,
189  .write_header = amr_write_header,
190  .write_packet = amr_write_packet,
191  .flags = AVFMT_NOTIMESTAMPS,
192 };
193 #endif
#define NULL
Definition: coverity.c:32
const char * s
Definition: avisynth_c.h:768
Bytestream IO Context.
Definition: avio.h:161
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:59
int size
int64_t pos
byte position in stream, -1 if unknown
Definition: avcodec.h:1699
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:4756
enum AVCodecID codec_id
Specific type of the encoded data (the codec used).
Definition: avcodec.h:4152
uint64_t cumulated_size
Definition: amr.c:34
static int amr_read_header(AVFormatContext *s)
Definition: amr.c:80
int size
Definition: avcodec.h:1680
static AVPacket pkt
static const char AMR_header[]
Definition: amr.c:38
This struct describes the properties of an encoded stream.
Definition: avcodec.h:4144
Format I/O context.
Definition: avformat.h:1349
uint8_t
int64_t duration
Duration of this packet in AVStream->time_base units, 0 if unknown.
Definition: avcodec.h:1697
AVStream * avformat_new_stream(AVFormatContext *s, const AVCodec *c)
Add a new stream to a media file.
Definition: utils.c:4383
AVStream ** streams
A list of all streams in the file.
Definition: avformat.h:1417
uint8_t * data
Definition: avcodec.h:1679
static const char AMRWB_header[]
Definition: amr.c:39
static int flags
Definition: log.c:57
#define AVERROR_EOF
End of file.
Definition: error.h:55
static av_always_inline int64_t avio_tell(AVIOContext *s)
ftell() equivalent for AVIOContext.
Definition: avio.h:556
static const uint8_t header[24]
Definition: sdr2.c:67
void avio_write(AVIOContext *s, const unsigned char *buf, int size)
Definition: aviobuf.c:216
uint64_t channel_layout
Audio only.
Definition: avcodec.h:4254
int avio_read(AVIOContext *s, unsigned char *buf, int size)
Read size bytes from AVIOContext into buf.
Definition: aviobuf.c:636
int64_t bit_rate
The average bitrate of the encoded data (in bits per second).
Definition: avcodec.h:4181
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:181
enum AVMediaType codec_type
General type of the encoded data.
Definition: avcodec.h:4148
static int amr_probe(AVProbeData *p)
Definition: amr.c:67
int avio_r8(AVIOContext *s)
Definition: aviobuf.c:627
unsigned char * buf
Buffer must have AVPROBE_PADDING_SIZE of extra allocated bytes filled with zero.
Definition: avformat.h:463
int void avio_flush(AVIOContext *s)
Force flushing of buffered data.
Definition: aviobuf.c:236
audio channel layout utility functions
static int read_probe(AVProbeData *pd)
Definition: jvdec.c:55
const char * name
Definition: avformat.h:524
static int read_header(FFV1Context *f)
Definition: ffv1dec.c:528
Stream structure.
Definition: avformat.h:889
#define AVFMT_NOTIMESTAMPS
Format does not need / have any timestamps.
Definition: avformat.h:486
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:1391
void av_packet_unref(AVPacket *pkt)
Wipe the packet.
Definition: avpacket.c:618
#define AVFMT_GENERIC_INDEX
Use generic index building code.
Definition: avformat.h:487
This structure contains the data a format has to probe a file.
Definition: avformat.h:461
static int amr_read_packet(AVFormatContext *s, AVPacket *pkt)
Definition: amr.c:115
uint64_t block_count
Definition: amr.c:35
int sample_rate
Audio only.
Definition: avcodec.h:4262
#define AVPROBE_SCORE_MAX
maximum score
Definition: avformat.h:473
Main libavformat public API header.
void * priv_data
Format private data.
Definition: avformat.h:1377
int channels
Audio only.
Definition: avcodec.h:4258
const char * name
A comma separated list of short names for the format.
Definition: avformat.h:664
AVCodecParameters * codecpar
Definition: avformat.h:1252
int avio_feof(AVIOContext *s)
feof() equivalent for AVIOContext.
Definition: aviobuf.c:356
uint32_t codec_tag
Additional information about the codec (corresponds to the AVI FOURCC).
Definition: avcodec.h:4156
int stream_index
Definition: avcodec.h:1681
#define AV_CH_LAYOUT_MONO
#define MKTAG(a, b, c, d)
Definition: common.h:342
This structure stores compressed data.
Definition: avcodec.h:1656
mode
Use these values in ebur128_init (or&#39;ed).
Definition: ebur128.h:83