FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
au.c
Go to the documentation of this file.
1 /*
2  * AU muxer and demuxer
3  * Copyright (c) 2001 Fabrice Bellard
4  *
5  * first version by Francois Revol <revol@free.fr>
6  *
7  * This file is part of FFmpeg.
8  *
9  * FFmpeg is free software; you can redistribute it and/or
10  * modify it under the terms of the GNU Lesser General Public
11  * License as published by the Free Software Foundation; either
12  * version 2.1 of the License, or (at your option) any later version.
13  *
14  * FFmpeg is distributed in the hope that it will be useful,
15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17  * Lesser General Public License for more details.
18  *
19  * You should have received a copy of the GNU Lesser General Public
20  * License along with FFmpeg; if not, write to the Free Software
21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22  */
23 
24 /*
25  * Reference documents:
26  * http://www.opengroup.org/public/pubs/external/auformat.html
27  * http://www.goice.co.jp/member/mo/formats/au.html
28  */
29 
30 #include "avformat.h"
31 #include "internal.h"
32 #include "avio_internal.h"
33 #include "pcm.h"
34 #include "libavutil/avassert.h"
35 
36 /* if we don't know the size in advance */
37 #define AU_UNKNOWN_SIZE ((uint32_t)(~0))
38 /* the specification requires an annotation field of at least eight bytes */
39 #define AU_DEFAULT_HEADER_SIZE (24+8)
40 
41 static const AVCodecTag codec_au_tags[] = {
42  { AV_CODEC_ID_PCM_MULAW, 1 },
43  { AV_CODEC_ID_PCM_S8, 2 },
44  { AV_CODEC_ID_PCM_S16BE, 3 },
45  { AV_CODEC_ID_PCM_S24BE, 4 },
46  { AV_CODEC_ID_PCM_S32BE, 5 },
47  { AV_CODEC_ID_PCM_F32BE, 6 },
48  { AV_CODEC_ID_PCM_F64BE, 7 },
53  { AV_CODEC_ID_PCM_ALAW, 27 },
54  { AV_CODEC_ID_ADPCM_G726LE, MKBETAG('7','2','6','2') },
55  { AV_CODEC_ID_NONE, 0 },
56 };
57 
58 #if CONFIG_AU_DEMUXER
59 
60 static int au_probe(AVProbeData *p)
61 {
62  if (p->buf[0] == '.' && p->buf[1] == 's' &&
63  p->buf[2] == 'n' && p->buf[3] == 'd')
64  return AVPROBE_SCORE_MAX;
65  else
66  return 0;
67 }
68 
69 static int au_read_annotation(AVFormatContext *s, int size)
70 {
71  static const char * keys[] = {
72  "title",
73  "artist",
74  "album",
75  "track",
76  "genre",
77  NULL };
78  AVIOContext *pb = s->pb;
79  enum { PARSE_KEY, PARSE_VALUE, PARSE_FINISHED } state = PARSE_KEY;
80  char c;
81  AVBPrint bprint;
82  char * key = NULL;
83  char * value = NULL;
84  int i;
85 
87 
88  while (size-- > 0) {
89  c = avio_r8(pb);
90  switch(state) {
91  case PARSE_KEY:
92  if (c == '\0') {
93  state = PARSE_FINISHED;
94  } else if (c == '=') {
95  av_bprint_finalize(&bprint, &key);
97  state = PARSE_VALUE;
98  } else {
99  av_bprint_chars(&bprint, c, 1);
100  }
101  break;
102  case PARSE_VALUE:
103  if (c == '\0' || c == '\n') {
104  if (av_bprint_finalize(&bprint, &value) != 0) {
105  av_log(s, AV_LOG_ERROR, "Memory error while parsing AU metadata.\n");
106  } else {
108  for (i = 0; keys[i] != NULL && key != NULL; i++) {
109  if (av_strcasecmp(keys[i], key) == 0) {
110  av_dict_set(&(s->metadata), keys[i], value, AV_DICT_DONT_STRDUP_VAL);
111  av_freep(&key);
112  value = NULL;
113  }
114  }
115  }
116  av_freep(&key);
117  av_freep(&value);
118  state = (c == '\0') ? PARSE_FINISHED : PARSE_KEY;
119  } else {
120  av_bprint_chars(&bprint, c, 1);
121  }
122  break;
123  case PARSE_FINISHED:
124  break;
125  default:
126  /* should never happen */
127  av_assert0(0);
128  }
129  }
130  av_bprint_finalize(&bprint, NULL);
131  av_freep(&key);
132  return 0;
133 }
134 
135 #define BLOCK_SIZE 1024
136 
137 static int au_read_header(AVFormatContext *s)
138 {
139  int size, data_size = 0;
140  unsigned int tag;
141  AVIOContext *pb = s->pb;
142  unsigned int id, channels, rate;
143  int bps;
144  enum AVCodecID codec;
145  AVStream *st;
146 
147  tag = avio_rl32(pb);
148  if (tag != MKTAG('.', 's', 'n', 'd'))
149  return AVERROR_INVALIDDATA;
150  size = avio_rb32(pb); /* header size */
151  data_size = avio_rb32(pb); /* data size in bytes */
152 
153  if (data_size < 0 && data_size != AU_UNKNOWN_SIZE) {
154  av_log(s, AV_LOG_ERROR, "Invalid negative data size '%d' found\n", data_size);
155  return AVERROR_INVALIDDATA;
156  }
157 
158  id = avio_rb32(pb);
159  rate = avio_rb32(pb);
160  channels = avio_rb32(pb);
161 
162  if (size > 24) {
163  /* parse annotation field to get metadata */
164  au_read_annotation(s, size - 24);
165  }
166 
167  codec = ff_codec_get_id(codec_au_tags, id);
168 
169  if (codec == AV_CODEC_ID_NONE) {
170  avpriv_request_sample(s, "unknown or unsupported codec tag: %u", id);
171  return AVERROR_PATCHWELCOME;
172  }
173 
174  bps = av_get_bits_per_sample(codec);
175  if (codec == AV_CODEC_ID_ADPCM_G726LE) {
176  if (id == MKBETAG('7','2','6','2')) {
177  bps = 2;
178  } else {
179  const uint8_t bpcss[] = {4, 0, 3, 5};
180  av_assert0(id >= 23 && id < 23 + 4);
181  bps = bpcss[id - 23];
182  }
183  } else if (!bps) {
184  avpriv_request_sample(s, "Unknown bits per sample");
185  return AVERROR_PATCHWELCOME;
186  }
187 
188  if (channels == 0 || channels >= INT_MAX / (BLOCK_SIZE * bps >> 3)) {
189  av_log(s, AV_LOG_ERROR, "Invalid number of channels %u\n", channels);
190  return AVERROR_INVALIDDATA;
191  }
192 
193  if (rate == 0 || rate > INT_MAX) {
194  av_log(s, AV_LOG_ERROR, "Invalid sample rate: %u\n", rate);
195  return AVERROR_INVALIDDATA;
196  }
197 
198  st = avformat_new_stream(s, NULL);
199  if (!st)
200  return AVERROR(ENOMEM);
202  st->codecpar->codec_tag = id;
203  st->codecpar->codec_id = codec;
204  st->codecpar->channels = channels;
205  st->codecpar->sample_rate = rate;
207  st->codecpar->bit_rate = channels * rate * bps;
208  st->codecpar->block_align = FFMAX(bps * st->codecpar->channels / 8, 1);
209  if (data_size != AU_UNKNOWN_SIZE)
210  st->duration = (((int64_t)data_size)<<3) / (st->codecpar->channels * (int64_t)bps);
211 
212  st->start_time = 0;
213  avpriv_set_pts_info(st, 64, 1, rate);
214 
215  return 0;
216 }
217 
218 AVInputFormat ff_au_demuxer = {
219  .name = "au",
220  .long_name = NULL_IF_CONFIG_SMALL("Sun AU"),
221  .read_probe = au_probe,
222  .read_header = au_read_header,
223  .read_packet = ff_pcm_read_packet,
224  .read_seek = ff_pcm_read_seek,
225  .codec_tag = (const AVCodecTag* const []) { codec_au_tags, 0 },
226 };
227 
228 #endif /* CONFIG_AU_DEMUXER */
229 
230 #if CONFIG_AU_MUXER
231 
232 typedef struct AUContext {
233  uint32_t header_size;
234 } AUContext;
235 
236 #include "rawenc.h"
237 
238 static int au_get_annotations(AVFormatContext *s, char **buffer)
239 {
240  static const char * keys[] = {
241  "Title",
242  "Artist",
243  "Album",
244  "Track",
245  "Genre",
246  NULL };
247  int i;
248  int cnt = 0;
249  AVDictionary *m = s->metadata;
250  AVDictionaryEntry *t = NULL;
251  AVBPrint bprint;
252 
254 
255  for (i = 0; keys[i] != NULL; i++) {
256  t = av_dict_get(m, keys[i], NULL, 0);
257  if (t != NULL) {
258  if (cnt++)
259  av_bprint_chars(&bprint, '\n', 1);
260  av_bprint_append_data(&bprint, keys[i], strlen(keys[i]));
261  av_bprint_chars(&bprint, '=', 1);
262  av_bprint_append_data(&bprint, t->value, strlen(t->value));
263  }
264  }
265  /* pad with 0's */
266  av_bprint_append_data(&bprint, "\0\0\0\0\0\0\0\0", 8);
267  return av_bprint_finalize(&bprint, buffer);
268 }
269 
270 static int au_write_header(AVFormatContext *s)
271 {
272  int ret;
273  AUContext *au = s->priv_data;
274  AVIOContext *pb = s->pb;
275  AVCodecParameters *par = s->streams[0]->codecpar;
276  char *annotations = NULL;
277 
278  au->header_size = AU_DEFAULT_HEADER_SIZE;
279 
280  if (s->nb_streams != 1) {
281  av_log(s, AV_LOG_ERROR, "only one stream is supported\n");
282  return AVERROR(EINVAL);
283  }
284 
285  par->codec_tag = ff_codec_get_tag(codec_au_tags, par->codec_id);
286  if (!par->codec_tag) {
287  av_log(s, AV_LOG_ERROR, "unsupported codec\n");
288  return AVERROR(EINVAL);
289  }
290 
291  if (av_dict_count(s->metadata) > 0) {
292  ret = au_get_annotations(s, &annotations);
293  if (ret < 0)
294  return ret;
295  if (annotations != NULL) {
296  au->header_size = (24 + strlen(annotations) + 8) & ~7;
297  if (au->header_size < AU_DEFAULT_HEADER_SIZE)
298  au->header_size = AU_DEFAULT_HEADER_SIZE;
299  }
300  }
301  ffio_wfourcc(pb, ".snd"); /* magic number */
302  avio_wb32(pb, au->header_size); /* header size */
303  avio_wb32(pb, AU_UNKNOWN_SIZE); /* data size */
304  avio_wb32(pb, par->codec_tag); /* codec ID */
305  avio_wb32(pb, par->sample_rate);
306  avio_wb32(pb, par->channels);
307  if (annotations != NULL) {
308  avio_write(pb, annotations, au->header_size - 24);
309  av_freep(&annotations);
310  } else {
311  avio_wb64(pb, 0); /* annotation field */
312  }
313  avio_flush(pb);
314 
315  return 0;
316 }
317 
318 static int au_write_trailer(AVFormatContext *s)
319 {
320  AVIOContext *pb = s->pb;
321  AUContext *au = s->priv_data;
322  int64_t file_size = avio_tell(pb);
323 
324  if (s->pb->seekable && file_size < INT32_MAX) {
325  /* update file size */
326  avio_seek(pb, 8, SEEK_SET);
327  avio_wb32(pb, (uint32_t)(file_size - au->header_size));
328  avio_seek(pb, file_size, SEEK_SET);
329  avio_flush(pb);
330  }
331 
332  return 0;
333 }
334 
335 AVOutputFormat ff_au_muxer = {
336  .name = "au",
337  .long_name = NULL_IF_CONFIG_SMALL("Sun AU"),
338  .mime_type = "audio/basic",
339  .extensions = "au",
340  .priv_data_size = sizeof(AUContext),
341  .audio_codec = AV_CODEC_ID_PCM_S16BE,
342  .video_codec = AV_CODEC_ID_NONE,
343  .write_header = au_write_header,
345  .write_trailer = au_write_trailer,
346  .codec_tag = (const AVCodecTag* const []) { codec_au_tags, 0 },
347  .flags = AVFMT_NOTIMESTAMPS,
348 };
349 
350 #endif /* CONFIG_AU_MUXER */
void avio_wb64(AVIOContext *s, uint64_t val)
Definition: aviobuf.c:440
#define NULL
Definition: coverity.c:32
const char * s
Definition: avisynth_c.h:768
Bytestream IO Context.
Definition: avio.h:147
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:59
enum AVCodecID id
Definition: mxfenc.c:104
enum AVCodecID ff_codec_get_id(const AVCodecTag *tags, unsigned int tag)
Definition: utils.c:3012
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:4560
enum AVCodecID codec_id
Specific type of the encoded data (the codec used).
Definition: avcodec.h:3980
int av_dict_count(const AVDictionary *m)
Get number of entries in dictionary.
Definition: dict.c:35
int64_t avio_seek(AVIOContext *s, int64_t offset, int whence)
fseek() equivalent for AVIOContext.
Definition: aviobuf.c:230
unsigned int ff_codec_get_tag(const AVCodecTag *tags, enum AVCodecID id)
Definition: utils.c:3002
#define BLOCK_SIZE
Definition: adx.h:53
This struct describes the properties of an encoded stream.
Definition: avcodec.h:3972
int av_bprint_finalize(AVBPrint *buf, char **ret_str)
Finalize a print buffer.
Definition: bprint.c:235
Format I/O context.
Definition: avformat.h:1338
#define av_assert0(cond)
assert() equivalent, that is always enabled.
Definition: avassert.h:37
void void avpriv_request_sample(void *avc, const char *msg,...) av_printf_format(2
Log a generic warning message about a missing feature.
uint8_t
unsigned int avio_rb32(AVIOContext *s)
Definition: aviobuf.c:757
AVStream * avformat_new_stream(AVFormatContext *s, const AVCodec *c)
Add a new stream to a media file.
Definition: utils.c:4193
AVStream ** streams
A list of all streams in the file.
Definition: avformat.h:1406
void av_bprint_append_data(AVBPrint *buf, const char *data, unsigned size)
Append data to a print buffer.
Definition: bprint.c:158
AVDictionaryEntry * av_dict_get(const AVDictionary *m, const char *key, const AVDictionaryEntry *prev, int flags)
Get a dictionary entry with matching key.
Definition: dict.c:40
uint32_t tag
Definition: movenc.c:1382
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:511
void avio_write(AVIOContext *s, const unsigned char *buf, int size)
Definition: aviobuf.c:204
static av_always_inline void ffio_wfourcc(AVIOContext *pb, const uint8_t *s)
Definition: avio_internal.h:66
#define av_log(a,...)
int64_t bit_rate
The average bitrate of the encoded data (in bits per second).
Definition: avcodec.h:4009
AVCodecID
Identify the syntax and semantics of the bitstream.
Definition: avcodec.h:191
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:176
int av_get_bits_per_sample(enum AVCodecID codec_id)
Return codec bits per sample.
Definition: utils.c:3535
AVDictionary * metadata
Metadata that applies to the whole file.
Definition: avformat.h:1554
#define AV_BPRINT_SIZE_UNLIMITED
unsigned int avio_rl32(AVIOContext *s)
Definition: aviobuf.c:726
#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:176
void av_bprint_init(AVBPrint *buf, unsigned size_init, unsigned size_max)
Definition: bprint.c:69
enum AVMediaType codec_type
General type of the encoded data.
Definition: avcodec.h:3976
simple assert() macros that are a bit more flexible than ISO C assert().
#define FFMAX(a, b)
Definition: common.h:94
int avio_r8(AVIOContext *s)
Definition: aviobuf.c:595
unsigned char * buf
Buffer must have AVPROBE_PADDING_SIZE of extra allocated bytes filled with zero.
Definition: avformat.h:463
unsigned int nb_streams
Number of elements in AVFormatContext.streams.
Definition: avformat.h:1394
int block_align
Audio only.
Definition: avcodec.h:4097
int seekable
A combination of AVIO_SEEKABLE_ flags or 0 when the stream is not seekable.
Definition: avio.h:243
int void avio_flush(AVIOContext *s)
Force flushing of buffered data.
Definition: aviobuf.c:224
int av_strcasecmp(const char *a, const char *b)
Locale-independent case-insensitive compare.
Definition: avstring.c:213
#define AV_DICT_DONT_STRDUP_VAL
Take ownership of a value that's been allocated with av_malloc() or another memory allocation functio...
Definition: dict.h:76
GLsizei GLboolean const GLfloat * value
Definition: opengl_enc.c:109
static int write_trailer(AVFormatContext *s1)
Definition: v4l2enc.c:94
const char * name
Definition: avformat.h:524
static const AVCodecTag codec_au_tags[]
Definition: au.c:41
int ff_raw_write_packet(AVFormatContext *s, AVPacket *pkt)
Definition: rawenc.c:29
int ff_pcm_read_seek(AVFormatContext *s, int stream_index, int64_t timestamp, int flags)
Definition: pcm.c:45
Stream structure.
Definition: avformat.h:889
#define AVERROR_PATCHWELCOME
Not yet implemented in FFmpeg, patches welcome.
Definition: error.h:62
#define AVFMT_NOTIMESTAMPS
Format does not need / have any timestamps.
Definition: avformat.h:486
#define AU_DEFAULT_HEADER_SIZE
Definition: au.c:39
int ff_pcm_read_packet(AVFormatContext *s, AVPacket *pkt)
Definition: pcm.c:29
AVIOContext * pb
I/O context.
Definition: avformat.h:1380
static struct @246 state
int av_dict_set(AVDictionary **pm, const char *key, const char *value, int flags)
Set the given entry in *pm, overwriting an existing entry.
Definition: dict.c:70
static void write_packet(OutputFile *of, AVPacket *pkt, OutputStream *ost)
Definition: ffmpeg.c:645
This structure contains the data a format has to probe a file.
Definition: avformat.h:461
int64_t duration
Decoding: duration of the stream, in stream time base.
Definition: avformat.h:943
int sample_rate
Audio only.
Definition: avcodec.h:4090
#define AVPROBE_SCORE_MAX
maximum score
Definition: avformat.h:473
Main libavformat public API header.
int64_t start_time
Decoding: pts of the first frame of the stream in presentation order, in stream time base...
Definition: avformat.h:936
static double c[64]
unsigned bps
Definition: movenc.c:1383
#define MKBETAG(a, b, c, d)
Definition: common.h:343
char * value
Definition: dict.h:87
void * priv_data
Format private data.
Definition: avformat.h:1366
static void write_header(FFV1Context *f)
Definition: ffv1enc.c:344
int bits_per_coded_sample
The number of bits per sample in the codedwords.
Definition: avcodec.h:4022
int channels
Audio only.
Definition: avcodec.h:4086
void avio_wb32(AVIOContext *s, unsigned int val)
Definition: aviobuf.c:354
#define av_freep(p)
const char * name
A comma separated list of short names for the format.
Definition: avformat.h:664
AVCodecParameters * codecpar
Definition: avformat.h:1241
uint32_t codec_tag
Additional information about the codec (corresponds to the AVI FOURCC).
Definition: avcodec.h:3984
#define MKTAG(a, b, c, d)
Definition: common.h:342
GLuint buffer
Definition: opengl_enc.c:102
#define AU_UNKNOWN_SIZE
Definition: au.c:37
void av_bprint_chars(AVBPrint *buf, char c, unsigned n)
Append char c n times to a print buffer.
Definition: bprint.c:140