FFmpeg  4.3.7
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  if (avio_feof(pb)) {
90  av_bprint_finalize(&bprint, NULL);
91  av_freep(&key);
92  return AVERROR_EOF;
93  }
94  c = avio_r8(pb);
95  switch(state) {
96  case PARSE_KEY:
97  if (c == '\0') {
98  state = PARSE_FINISHED;
99  } else if (c == '=') {
100  av_bprint_finalize(&bprint, &key);
102  state = PARSE_VALUE;
103  } else {
104  av_bprint_chars(&bprint, c, 1);
105  }
106  break;
107  case PARSE_VALUE:
108  if (c == '\0' || c == '\n') {
109  if (av_bprint_finalize(&bprint, &value) != 0) {
110  av_log(s, AV_LOG_ERROR, "Memory error while parsing AU metadata.\n");
111  } else {
113  for (i = 0; keys[i] != NULL && key != NULL; i++) {
114  if (av_strcasecmp(keys[i], key) == 0) {
115  av_dict_set(&(s->metadata), keys[i], value, AV_DICT_DONT_STRDUP_VAL);
116  av_freep(&key);
117  value = NULL;
118  }
119  }
120  }
121  av_freep(&key);
122  av_freep(&value);
123  state = (c == '\0') ? PARSE_FINISHED : PARSE_KEY;
124  } else {
125  av_bprint_chars(&bprint, c, 1);
126  }
127  break;
128  case PARSE_FINISHED:
129  break;
130  default:
131  /* should never happen */
132  av_assert0(0);
133  }
134  }
135  av_bprint_finalize(&bprint, NULL);
136  av_freep(&key);
137  return 0;
138 }
139 
140 #define BLOCK_SIZE 1024
141 
142 static int au_read_header(AVFormatContext *s)
143 {
144  int size, data_size = 0;
145  unsigned int tag;
146  AVIOContext *pb = s->pb;
147  unsigned int id, channels, rate;
148  int bps, ba = 0;
149  enum AVCodecID codec;
150  AVStream *st;
151 
152  tag = avio_rl32(pb);
153  if (tag != MKTAG('.', 's', 'n', 'd'))
154  return AVERROR_INVALIDDATA;
155  size = avio_rb32(pb); /* header size */
156  data_size = avio_rb32(pb); /* data size in bytes */
157 
158  if (data_size < 0 && data_size != AU_UNKNOWN_SIZE) {
159  av_log(s, AV_LOG_ERROR, "Invalid negative data size '%d' found\n", data_size);
160  return AVERROR_INVALIDDATA;
161  }
162 
163  id = avio_rb32(pb);
164  rate = avio_rb32(pb);
165  channels = avio_rb32(pb);
166 
167  if (size > 24) {
168  /* parse annotation field to get metadata */
169  au_read_annotation(s, size - 24);
170  }
171 
172  codec = ff_codec_get_id(codec_au_tags, id);
173 
174  if (codec == AV_CODEC_ID_NONE) {
175  avpriv_request_sample(s, "unknown or unsupported codec tag: %u", id);
176  return AVERROR_PATCHWELCOME;
177  }
178 
179  bps = av_get_bits_per_sample(codec);
180  if (codec == AV_CODEC_ID_ADPCM_G726LE) {
181  if (id == MKBETAG('7','2','6','2')) {
182  bps = 2;
183  } else {
184  const uint8_t bpcss[] = {4, 0, 3, 5};
185  av_assert0(id >= 23 && id < 23 + 4);
186  ba = bpcss[id - 23];
187  bps = bpcss[id - 23];
188  }
189  } else if (!bps) {
190  avpriv_request_sample(s, "Unknown bits per sample");
191  return AVERROR_PATCHWELCOME;
192  }
193 
194  if (channels == 0 || channels >= INT_MAX / (BLOCK_SIZE * bps >> 3)) {
195  av_log(s, AV_LOG_ERROR, "Invalid number of channels %u\n", channels);
196  return AVERROR_INVALIDDATA;
197  }
198 
199  if (rate == 0 || rate > INT_MAX) {
200  av_log(s, AV_LOG_ERROR, "Invalid sample rate: %u\n", rate);
201  return AVERROR_INVALIDDATA;
202  }
203 
204  st = avformat_new_stream(s, NULL);
205  if (!st)
206  return AVERROR(ENOMEM);
208  st->codecpar->codec_tag = id;
209  st->codecpar->codec_id = codec;
210  st->codecpar->channels = channels;
211  st->codecpar->sample_rate = rate;
213  st->codecpar->bit_rate = channels * rate * bps;
214  st->codecpar->block_align = ba ? ba : FFMAX(bps * st->codecpar->channels / 8, 1);
215  if (data_size != AU_UNKNOWN_SIZE)
216  st->duration = (((int64_t)data_size)<<3) / (st->codecpar->channels * (int64_t)bps);
217 
218  st->start_time = 0;
219  avpriv_set_pts_info(st, 64, 1, rate);
220 
221  return 0;
222 }
223 
225  .name = "au",
226  .long_name = NULL_IF_CONFIG_SMALL("Sun AU"),
227  .read_probe = au_probe,
228  .read_header = au_read_header,
229  .read_packet = ff_pcm_read_packet,
230  .read_seek = ff_pcm_read_seek,
231  .codec_tag = (const AVCodecTag* const []) { codec_au_tags, 0 },
232 };
233 
234 #endif /* CONFIG_AU_DEMUXER */
235 
236 #if CONFIG_AU_MUXER
237 
238 typedef struct AUContext {
239  uint32_t header_size;
240 } AUContext;
241 
242 #include "rawenc.h"
243 
244 static int au_get_annotations(AVFormatContext *s, char **buffer)
245 {
246  static const char * keys[] = {
247  "Title",
248  "Artist",
249  "Album",
250  "Track",
251  "Genre",
252  NULL };
253  int i;
254  int cnt = 0;
255  AVDictionary *m = s->metadata;
256  AVDictionaryEntry *t = NULL;
257  AVBPrint bprint;
258 
260 
261  for (i = 0; keys[i] != NULL; i++) {
262  t = av_dict_get(m, keys[i], NULL, 0);
263  if (t != NULL) {
264  if (cnt++)
265  av_bprint_chars(&bprint, '\n', 1);
266  av_bprint_append_data(&bprint, keys[i], strlen(keys[i]));
267  av_bprint_chars(&bprint, '=', 1);
268  av_bprint_append_data(&bprint, t->value, strlen(t->value));
269  }
270  }
271  /* pad with 0's */
272  av_bprint_append_data(&bprint, "\0\0\0\0\0\0\0\0", 8);
273  return av_bprint_finalize(&bprint, buffer);
274 }
275 
276 static int au_write_header(AVFormatContext *s)
277 {
278  int ret;
279  AUContext *au = s->priv_data;
280  AVIOContext *pb = s->pb;
281  AVCodecParameters *par = s->streams[0]->codecpar;
282  char *annotations = NULL;
283 
284  au->header_size = AU_DEFAULT_HEADER_SIZE;
285 
286  if (s->nb_streams != 1) {
287  av_log(s, AV_LOG_ERROR, "only one stream is supported\n");
288  return AVERROR(EINVAL);
289  }
290 
291  par->codec_tag = ff_codec_get_tag(codec_au_tags, par->codec_id);
292  if (!par->codec_tag) {
293  av_log(s, AV_LOG_ERROR, "unsupported codec\n");
294  return AVERROR(EINVAL);
295  }
296 
297  if (av_dict_count(s->metadata) > 0) {
298  ret = au_get_annotations(s, &annotations);
299  if (ret < 0)
300  return ret;
301  if (annotations != NULL) {
302  au->header_size = (24 + strlen(annotations) + 8) & ~7;
303  if (au->header_size < AU_DEFAULT_HEADER_SIZE)
304  au->header_size = AU_DEFAULT_HEADER_SIZE;
305  }
306  }
307  ffio_wfourcc(pb, ".snd"); /* magic number */
308  avio_wb32(pb, au->header_size); /* header size */
309  avio_wb32(pb, AU_UNKNOWN_SIZE); /* data size */
310  avio_wb32(pb, par->codec_tag); /* codec ID */
311  avio_wb32(pb, par->sample_rate);
312  avio_wb32(pb, par->channels);
313  if (annotations != NULL) {
314  avio_write(pb, annotations, au->header_size - 24);
315  av_freep(&annotations);
316  } else {
317  avio_wb64(pb, 0); /* annotation field */
318  }
319 
320  return 0;
321 }
322 
323 static int au_write_trailer(AVFormatContext *s)
324 {
325  AVIOContext *pb = s->pb;
326  AUContext *au = s->priv_data;
327  int64_t file_size = avio_tell(pb);
328 
329  if ((s->pb->seekable & AVIO_SEEKABLE_NORMAL) && file_size < INT32_MAX) {
330  /* update file size */
331  avio_seek(pb, 8, SEEK_SET);
332  avio_wb32(pb, (uint32_t)(file_size - au->header_size));
333  avio_seek(pb, file_size, SEEK_SET);
334  }
335 
336  return 0;
337 }
338 
340  .name = "au",
341  .long_name = NULL_IF_CONFIG_SMALL("Sun AU"),
342  .mime_type = "audio/basic",
343  .extensions = "au",
344  .priv_data_size = sizeof(AUContext),
345  .audio_codec = AV_CODEC_ID_PCM_S16BE,
346  .video_codec = AV_CODEC_ID_NONE,
347  .write_header = au_write_header,
349  .write_trailer = au_write_trailer,
350  .codec_tag = (const AVCodecTag* const []) { codec_au_tags, 0 },
351  .flags = AVFMT_NOTIMESTAMPS,
352 };
353 
354 #endif /* CONFIG_AU_MUXER */
static void write_packet(OutputFile *of, AVPacket *pkt, OutputStream *ost, int unqueue)
Definition: ffmpeg.c:702
void avio_wb64(AVIOContext *s, uint64_t val)
Definition: aviobuf.c:441
#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
static struct @314 state
int size
enum AVCodecID ff_codec_get_id(const AVCodecTag *tags, unsigned int tag)
Definition: utils.c:3165
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:4948
#define avpriv_request_sample(...)
enum AVCodecID codec_id
Specific type of the encoded data (the codec used).
Definition: codec_par.h:60
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:241
unsigned int ff_codec_get_tag(const AVCodecTag *tags, enum AVCodecID id)
Definition: utils.c:3155
const char * key
#define BLOCK_SIZE
Definition: adx.h:53
This struct describes the properties of an encoded stream.
Definition: codec_par.h:52
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:1351
#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:778
AVStream * avformat_new_stream(AVFormatContext *s, const AVCodec *c)
Add a new stream to a media file.
Definition: utils.c:4526
AVStream ** streams
A list of all streams in the file.
Definition: avformat.h:1419
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:1532
#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:557
void avio_write(AVIOContext *s, const unsigned char *buf, int size)
Definition: aviobuf.c:213
static av_always_inline void ffio_wfourcc(AVIOContext *pb, const uint8_t *s)
Definition: avio_internal.h:58
channels
Definition: aptx.h:33
#define av_log(a,...)
int64_t bit_rate
The average bitrate of the encoded data (in bits per second).
Definition: codec_par.h:89
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:269
AVCodecID
Identify the syntax and semantics of the bitstream.
Definition: codec_id.h:46
#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:1580
AVDictionary * metadata
Metadata that applies to the whole file.
Definition: avformat.h:1591
#define AV_BPRINT_SIZE_UNLIMITED
unsigned int avio_rl32(AVIOContext *s)
Definition: aviobuf.c:747
#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:188
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: codec_par.h:56
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:616
unsigned char * buf
Buffer must have AVPROBE_PADDING_SIZE of extra allocated bytes filled with zero.
Definition: avformat.h:443
unsigned int nb_streams
Number of elements in AVFormatContext.streams.
Definition: avformat.h:1407
int block_align
Audio only.
Definition: codec_par.h:177
int seekable
A combination of AVIO_SEEKABLE_ flags or 0 when the stream is not seekable.
Definition: avio.h:260
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 int write_trailer(AVFormatContext *s1)
Definition: v4l2enc.c:98
const char * name
Definition: avformat.h:500
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:56
Stream structure.
Definition: avformat.h:876
#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:462
#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:1393
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:441
int64_t duration
Decoding: duration of the stream, in stream time base.
Definition: avformat.h:925
int sample_rate
Audio only.
Definition: codec_par.h:170
#define AVPROBE_SCORE_MAX
maximum score
Definition: avformat.h:453
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:915
static double c[64]
unsigned bps
Definition: movenc.c:1533
#define MKBETAG(a, b, c, d)
Definition: common.h:407
char * value
Definition: dict.h:87
void * priv_data
Format private data.
Definition: avformat.h:1379
static void write_header(FFV1Context *f)
Definition: ffv1enc.c:346
int bits_per_coded_sample
The number of bits per sample in the codedwords.
Definition: codec_par.h:102
int channels
Audio only.
Definition: codec_par.h:166
void avio_wb32(AVIOContext *s, unsigned int val)
Definition: aviobuf.c:375
#define av_freep(p)
const char * name
A comma separated list of short names for the format.
Definition: avformat.h:650
AVCodecParameters * codecpar
Codec parameters associated with this stream.
Definition: avformat.h:1023
int avio_feof(AVIOContext *s)
Similar to feof() but also returns nonzero on read errors.
Definition: aviobuf.c:356
uint32_t codec_tag
Additional information about the codec (corresponds to the AVI FOURCC).
Definition: codec_par.h:64
#define MKTAG(a, b, c, d)
Definition: common.h:406
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