FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
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  avio_read(pb, header, 6);
87 
88  st = avformat_new_stream(s, NULL);
89  if (!st)
90  return AVERROR(ENOMEM);
91  if (memcmp(header, AMR_header, 6)) {
92  avio_read(pb, header + 6, 3);
93  if (memcmp(header, AMRWB_header, 9)) {
94  return -1;
95  }
96 
97  st->codecpar->codec_tag = MKTAG('s', 'a', 'w', 'b');
99  st->codecpar->sample_rate = 16000;
100  } else {
101  st->codecpar->codec_tag = MKTAG('s', 'a', 'm', 'r');
103  st->codecpar->sample_rate = 8000;
104  }
105  st->codecpar->channels = 1;
108  avpriv_set_pts_info(st, 64, 1, st->codecpar->sample_rate);
109 
110  return 0;
111 }
112 
114 {
115  AVCodecParameters *par = s->streams[0]->codecpar;
116  int read, size = 0, toc, mode;
117  int64_t pos = avio_tell(s->pb);
118  AMRContext *amr = s->priv_data;
119 
120  if (avio_feof(s->pb)) {
121  return AVERROR_EOF;
122  }
123 
124  // FIXME this is wrong, this should rather be in an AVParser
125  toc = avio_r8(s->pb);
126  mode = (toc >> 3) & 0x0F;
127 
128  if (par->codec_id == AV_CODEC_ID_AMR_NB) {
129  static const uint8_t packed_size[16] = {
130  12, 13, 15, 17, 19, 20, 26, 31, 5, 0, 0, 0, 0, 0, 0, 0
131  };
132 
133  size = packed_size[mode] + 1;
134  } else if (par->codec_id == AV_CODEC_ID_AMR_WB) {
135  static const uint8_t packed_size[16] = {
136  18, 24, 33, 37, 41, 47, 51, 59, 61, 6, 6, 0, 0, 0, 1, 1
137  };
138 
139  size = packed_size[mode];
140  }
141 
142  if (!size || av_new_packet(pkt, size))
143  return AVERROR(EIO);
144 
145  if (amr->cumulated_size < UINT64_MAX - size) {
146  amr->cumulated_size += size;
147  /* Both AMR formats have 50 frames per second */
148  s->streams[0]->codecpar->bit_rate = amr->cumulated_size / ++amr->block_count * 8 * 50;
149  }
150 
151  pkt->stream_index = 0;
152  pkt->pos = pos;
153  pkt->data[0] = toc;
154  pkt->duration = par->codec_id == AV_CODEC_ID_AMR_NB ? 160 : 320;
155  read = avio_read(s->pb, pkt->data + 1, size - 1);
156 
157  if (read != size - 1) {
158  av_packet_unref(pkt);
159  if (read < 0)
160  return read;
161  return AVERROR(EIO);
162  }
163 
164  return 0;
165 }
166 
167 #if CONFIG_AMR_DEMUXER
168 AVInputFormat ff_amr_demuxer = {
169  .name = "amr",
170  .long_name = NULL_IF_CONFIG_SMALL("3GPP AMR"),
171  .priv_data_size = sizeof(AMRContext),
176 };
177 #endif
178 
179 #if CONFIG_AMR_MUXER
180 AVOutputFormat ff_amr_muxer = {
181  .name = "amr",
182  .long_name = NULL_IF_CONFIG_SMALL("3GPP AMR"),
183  .mime_type = "audio/amr",
184  .extensions = "amr",
185  .audio_codec = AV_CODEC_ID_AMR_NB,
186  .video_codec = AV_CODEC_ID_NONE,
187  .write_header = amr_write_header,
188  .write_packet = amr_write_packet,
189  .flags = AVFMT_NOTIMESTAMPS,
190 };
191 #endif
#define NULL
Definition: coverity.c:32
const char * s
Definition: avisynth_c.h:768
Bytestream IO Context.
Definition: avio.h:155
int64_t pos
byte position in stream, -1 if unknown
Definition: avcodec.h:1677
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:4601
enum AVCodecID codec_id
Specific type of the encoded data (the codec used).
Definition: avcodec.h:4066
uint64_t cumulated_size
Definition: amr.c:34
static int amr_read_header(AVFormatContext *s)
Definition: amr.c:80
int size
Definition: avcodec.h:1658
static AVPacket pkt
static const char AMR_header[]
Definition: amr.c:38
This struct describes the properties of an encoded stream.
Definition: avcodec.h:4058
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:1675
AVStream * avformat_new_stream(AVFormatContext *s, const AVCodec *c)
Add a new stream to a media file.
Definition: utils.c:4231
AVStream ** streams
A list of all streams in the file.
Definition: avformat.h:1417
uint8_t * data
Definition: avcodec.h:1657
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
ptrdiff_t size
Definition: opengl_enc.c:101
static av_always_inline int64_t avio_tell(AVIOContext *s)
ftell() equivalent for AVIOContext.
Definition: avio.h:525
static const uint8_t header[24]
Definition: sdr2.c:67
void avio_write(AVIOContext *s, const unsigned char *buf, int size)
Definition: aviobuf.c:205
uint64_t channel_layout
Audio only.
Definition: avcodec.h:4168
int avio_read(AVIOContext *s, unsigned char *buf, int size)
Read size bytes from AVIOContext into buf.
Definition: aviobuf.c:616
int64_t bit_rate
The average bitrate of the encoded data (in bits per second).
Definition: avcodec.h:4095
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:179
enum AVMediaType codec_type
General type of the encoded data.
Definition: avcodec.h:4062
static int amr_probe(AVProbeData *p)
Definition: amr.c:67
int avio_r8(AVIOContext *s)
Definition: aviobuf.c:607
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:225
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:510
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:589
#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:113
uint64_t block_count
Definition: amr.c:35
int sample_rate
Audio only.
Definition: avcodec.h:4176
#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:4172
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:340
uint32_t codec_tag
Additional information about the codec (corresponds to the AVI FOURCC).
Definition: avcodec.h:4070
int stream_index
Definition: avcodec.h:1659
#define AV_CH_LAYOUT_MONO
#define MKTAG(a, b, c, d)
Definition: common.h:342
This structure stores compressed data.
Definition: avcodec.h:1634
mode
Use these values in ebur128_init (or'ed).
Definition: ebur128.h:83