FFmpeg  4.2.2
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(const 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, ba = 0;
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  ba = bpcss[id - 23];
182  bps = bpcss[id - 23];
183  }
184  } else if (!bps) {
185  avpriv_request_sample(s, "Unknown bits per sample");
186  return AVERROR_PATCHWELCOME;
187  }
188 
189  if (channels == 0 || channels >= INT_MAX / (BLOCK_SIZE * bps >> 3)) {
190  av_log(s, AV_LOG_ERROR, "Invalid number of channels %u\n", channels);
191  return AVERROR_INVALIDDATA;
192  }
193 
194  if (rate == 0 || rate > INT_MAX) {
195  av_log(s, AV_LOG_ERROR, "Invalid sample rate: %u\n", rate);
196  return AVERROR_INVALIDDATA;
197  }
198 
199  st = avformat_new_stream(s, NULL);
200  if (!st)
201  return AVERROR(ENOMEM);
203  st->codecpar->codec_tag = id;
204  st->codecpar->codec_id = codec;
205  st->codecpar->channels = channels;
206  st->codecpar->sample_rate = rate;
208  st->codecpar->bit_rate = channels * rate * bps;
209  st->codecpar->block_align = ba ? ba : FFMAX(bps * st->codecpar->channels / 8, 1);
210  if (data_size != AU_UNKNOWN_SIZE)
211  st->duration = (((int64_t)data_size)<<3) / (st->codecpar->channels * (int64_t)bps);
212 
213  st->start_time = 0;
214  avpriv_set_pts_info(st, 64, 1, rate);
215 
216  return 0;
217 }
218 
220  .name = "au",
221  .long_name = NULL_IF_CONFIG_SMALL("Sun AU"),
222  .read_probe = au_probe,
223  .read_header = au_read_header,
224  .read_packet = ff_pcm_read_packet,
225  .read_seek = ff_pcm_read_seek,
226  .codec_tag = (const AVCodecTag* const []) { codec_au_tags, 0 },
227 };
228 
229 #endif /* CONFIG_AU_DEMUXER */
230 
231 #if CONFIG_AU_MUXER
232 
233 typedef struct AUContext {
234  uint32_t header_size;
235 } AUContext;
236 
237 #include "rawenc.h"
238 
239 static int au_get_annotations(AVFormatContext *s, char **buffer)
240 {
241  static const char * keys[] = {
242  "Title",
243  "Artist",
244  "Album",
245  "Track",
246  "Genre",
247  NULL };
248  int i;
249  int cnt = 0;
250  AVDictionary *m = s->metadata;
251  AVDictionaryEntry *t = NULL;
252  AVBPrint bprint;
253 
255 
256  for (i = 0; keys[i] != NULL; i++) {
257  t = av_dict_get(m, keys[i], NULL, 0);
258  if (t != NULL) {
259  if (cnt++)
260  av_bprint_chars(&bprint, '\n', 1);
261  av_bprint_append_data(&bprint, keys[i], strlen(keys[i]));
262  av_bprint_chars(&bprint, '=', 1);
263  av_bprint_append_data(&bprint, t->value, strlen(t->value));
264  }
265  }
266  /* pad with 0's */
267  av_bprint_append_data(&bprint, "\0\0\0\0\0\0\0\0", 8);
268  return av_bprint_finalize(&bprint, buffer);
269 }
270 
271 static int au_write_header(AVFormatContext *s)
272 {
273  int ret;
274  AUContext *au = s->priv_data;
275  AVIOContext *pb = s->pb;
276  AVCodecParameters *par = s->streams[0]->codecpar;
277  char *annotations = NULL;
278 
279  au->header_size = AU_DEFAULT_HEADER_SIZE;
280 
281  if (s->nb_streams != 1) {
282  av_log(s, AV_LOG_ERROR, "only one stream is supported\n");
283  return AVERROR(EINVAL);
284  }
285 
286  par->codec_tag = ff_codec_get_tag(codec_au_tags, par->codec_id);
287  if (!par->codec_tag) {
288  av_log(s, AV_LOG_ERROR, "unsupported codec\n");
289  return AVERROR(EINVAL);
290  }
291 
292  if (av_dict_count(s->metadata) > 0) {
293  ret = au_get_annotations(s, &annotations);
294  if (ret < 0)
295  return ret;
296  if (annotations != NULL) {
297  au->header_size = (24 + strlen(annotations) + 8) & ~7;
298  if (au->header_size < AU_DEFAULT_HEADER_SIZE)
299  au->header_size = AU_DEFAULT_HEADER_SIZE;
300  }
301  }
302  ffio_wfourcc(pb, ".snd"); /* magic number */
303  avio_wb32(pb, au->header_size); /* header size */
304  avio_wb32(pb, AU_UNKNOWN_SIZE); /* data size */
305  avio_wb32(pb, par->codec_tag); /* codec ID */
306  avio_wb32(pb, par->sample_rate);
307  avio_wb32(pb, par->channels);
308  if (annotations != NULL) {
309  avio_write(pb, annotations, au->header_size - 24);
310  av_freep(&annotations);
311  } else {
312  avio_wb64(pb, 0); /* annotation field */
313  }
314  avio_flush(pb);
315 
316  return 0;
317 }
318 
319 static int au_write_trailer(AVFormatContext *s)
320 {
321  AVIOContext *pb = s->pb;
322  AUContext *au = s->priv_data;
323  int64_t file_size = avio_tell(pb);
324 
325  if ((s->pb->seekable & AVIO_SEEKABLE_NORMAL) && file_size < INT32_MAX) {
326  /* update file size */
327  avio_seek(pb, 8, SEEK_SET);
328  avio_wb32(pb, (uint32_t)(file_size - au->header_size));
329  avio_seek(pb, file_size, SEEK_SET);
330  avio_flush(pb);
331  }
332 
333  return 0;
334 }
335 
337  .name = "au",
338  .long_name = NULL_IF_CONFIG_SMALL("Sun AU"),
339  .mime_type = "audio/basic",
340  .extensions = "au",
341  .priv_data_size = sizeof(AUContext),
342  .audio_codec = AV_CODEC_ID_PCM_S16BE,
343  .video_codec = AV_CODEC_ID_NONE,
344  .write_header = au_write_header,
346  .write_trailer = au_write_trailer,
347  .codec_tag = (const AVCodecTag* const []) { codec_au_tags, 0 },
348  .flags = AVFMT_NOTIMESTAMPS,
349 };
350 
351 #endif /* CONFIG_AU_MUXER */
static void write_packet(OutputFile *of, AVPacket *pkt, OutputStream *ost, int unqueue)
Definition: ffmpeg.c:689
void avio_wb64(AVIOContext *s, uint64_t val)
Definition: aviobuf.c:463
#define NULL
Definition: coverity.c:32
Bytestream IO Context.
Definition: avio.h:161
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:59
int size
enum AVCodecID ff_codec_get_id(const AVCodecTag *tags, unsigned int tag)
Definition: utils.c:3125
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:4886
#define avpriv_request_sample(...)
channels
Definition: aptx.c:30
enum AVCodecID codec_id
Specific type of the encoded data (the codec used).
Definition: avcodec.h:3957
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:246
unsigned int ff_codec_get_tag(const AVCodecTag *tags, enum AVCodecID id)
Definition: utils.c:3115
const char * key
#define BLOCK_SIZE
Definition: adx.h:53
This struct describes the properties of an encoded stream.
Definition: avcodec.h:3949
int av_bprint_finalize(AVBPrint *buf, char **ret_str)
Finalize a print buffer.
Definition: bprint.c:235
AVOutputFormat ff_au_muxer
Format I/O context.
Definition: avformat.h:1358
#define av_assert0(cond)
assert() equivalent, that is always enabled.
Definition: avassert.h:37
static char buffer[20]
Definition: seek.c:32
uint8_t
unsigned int avio_rb32(AVIOContext *s)
Definition: aviobuf.c:800
AVStream * avformat_new_stream(AVFormatContext *s, const AVCodec *c)
Add a new stream to a media file.
Definition: utils.c:4459
AVStream ** streams
A list of all streams in the file.
Definition: avformat.h:1426
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:1496
static av_always_inline int64_t avio_tell(AVIOContext *s)
ftell() equivalent for AVIOContext.
Definition: avio.h:557
void avio_write(AVIOContext *s, const unsigned char *buf, int size)
Definition: aviobuf.c:218
static av_always_inline void ffio_wfourcc(AVIOContext *pb, const uint8_t *s)
Definition: avio_internal.h:58
#define av_log(a,...)
int64_t bit_rate
The average bitrate of the encoded data (in bits per second).
Definition: avcodec.h:3986
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:259
AVCodecID
Identify the syntax and semantics of the bitstream.
Definition: avcodec.h:215
#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:1533
AVDictionary * metadata
Metadata that applies to the whole file.
Definition: avformat.h:1598
#define AV_BPRINT_SIZE_UNLIMITED
unsigned int avio_rl32(AVIOContext *s)
Definition: aviobuf.c:769
#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
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:3953
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:638
unsigned char * buf
Buffer must have AVPROBE_PADDING_SIZE of extra allocated bytes filled with zero.
Definition: avformat.h:448
unsigned int nb_streams
Number of elements in AVFormatContext.streams.
Definition: avformat.h:1414
int block_align
Audio only.
Definition: avcodec.h:4074
int seekable
A combination of AVIO_SEEKABLE_ flags or 0 when the stream is not seekable.
Definition: avio.h:260
int void avio_flush(AVIOContext *s)
Force flushing of buffered data.
Definition: aviobuf.c:238
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&#39;s been allocated with av_malloc() or another memory allocation functio...
Definition: dict.h:76
static struct @313 state
static int write_trailer(AVFormatContext *s1)
Definition: v4l2enc.c:94
const char * name
Definition: avformat.h:505
static const AVCodecTag codec_au_tags[]
Definition: au.c:41
#define s(width, name)
Definition: cbs_vp9.c:257
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:52
Stream structure.
Definition: avformat.h:881
#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:467
#define AU_DEFAULT_HEADER_SIZE
Definition: au.c:39
int ff_pcm_read_packet(AVFormatContext *s, AVPacket *pkt)
Definition: pcm.c:29
#define AVIO_SEEKABLE_NORMAL
Seeking works like for a local file.
Definition: avio.h:40
AVIOContext * pb
I/O context.
Definition: avformat.h:1400
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
double value
Definition: eval.c:98
AVInputFormat ff_au_demuxer
This structure contains the data a format has to probe a file.
Definition: avformat.h:446
int64_t duration
Decoding: duration of the stream, in stream time base.
Definition: avformat.h:930
int sample_rate
Audio only.
Definition: avcodec.h:4067
#define AVPROBE_SCORE_MAX
maximum score
Definition: avformat.h:458
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:920
static double c[64]
unsigned bps
Definition: movenc.c:1497
#define MKBETAG(a, b, c, d)
Definition: common.h:367
char * value
Definition: dict.h:87
void * priv_data
Format private data.
Definition: avformat.h:1386
static void write_header(FFV1Context *f)
Definition: ffv1enc.c:337
int bits_per_coded_sample
The number of bits per sample in the codedwords.
Definition: avcodec.h:3999
int channels
Audio only.
Definition: avcodec.h:4063
void avio_wb32(AVIOContext *s, unsigned int val)
Definition: aviobuf.c:377
#define av_freep(p)
const char * name
A comma separated list of short names for the format.
Definition: avformat.h:654
AVCodecParameters * codecpar
Codec parameters associated with this stream.
Definition: avformat.h:1028
uint32_t codec_tag
Additional information about the codec (corresponds to the AVI FOURCC).
Definition: avcodec.h:3961
#define MKTAG(a, b, c, d)
Definition: common.h:366
enum AVCodecID id
#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