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 
35 /* if we don't know the size in advance */
36 #define AU_UNKNOWN_SIZE ((uint32_t)(~0))
37 /* the specification requires an annotation field of at least eight bytes */
38 #define AU_HEADER_SIZE (24+8)
39 
40 static const AVCodecTag codec_au_tags[] = {
41  { AV_CODEC_ID_PCM_MULAW, 1 },
42  { AV_CODEC_ID_PCM_S8, 2 },
43  { AV_CODEC_ID_PCM_S16BE, 3 },
44  { AV_CODEC_ID_PCM_S24BE, 4 },
45  { AV_CODEC_ID_PCM_S32BE, 5 },
46  { AV_CODEC_ID_PCM_F32BE, 6 },
47  { AV_CODEC_ID_PCM_F64BE, 7 },
49  { AV_CODEC_ID_PCM_ALAW, 27 },
50  { AV_CODEC_ID_NONE, 0 },
51 };
52 
53 #if CONFIG_AU_DEMUXER
54 
55 static int au_probe(AVProbeData *p)
56 {
57  if (p->buf[0] == '.' && p->buf[1] == 's' &&
58  p->buf[2] == 'n' && p->buf[3] == 'd')
59  return AVPROBE_SCORE_MAX;
60  else
61  return 0;
62 }
63 
64 #define BLOCK_SIZE 1024
65 
66 static int au_read_header(AVFormatContext *s)
67 {
68  int size, data_size = 0;
69  unsigned int tag;
70  AVIOContext *pb = s->pb;
71  unsigned int id, channels, rate;
72  int bps;
73  enum AVCodecID codec;
74  AVStream *st;
75 
76  tag = avio_rl32(pb);
77  if (tag != MKTAG('.', 's', 'n', 'd'))
78  return AVERROR_INVALIDDATA;
79  size = avio_rb32(pb); /* header size */
80  data_size = avio_rb32(pb); /* data size in bytes */
81 
82  if (data_size < 0 && data_size != AU_UNKNOWN_SIZE) {
83  av_log(s, AV_LOG_ERROR, "Invalid negative data size '%d' found\n", data_size);
84  return AVERROR_INVALIDDATA;
85  }
86 
87  id = avio_rb32(pb);
88  rate = avio_rb32(pb);
89  channels = avio_rb32(pb);
90 
91  if (size > 24) {
92  /* skip unused data */
93  avio_skip(pb, size - 24);
94  }
95 
96  codec = ff_codec_get_id(codec_au_tags, id);
97 
98  if (codec == AV_CODEC_ID_NONE) {
99  avpriv_request_sample(s, "unknown or unsupported codec tag: %u", id);
100  return AVERROR_PATCHWELCOME;
101  }
102 
103  bps = av_get_bits_per_sample(codec);
104  if (!bps) {
105  avpriv_request_sample(s, "Unknown bits per sample");
106  return AVERROR_PATCHWELCOME;
107  }
108 
109  if (channels == 0 || channels >= INT_MAX / (BLOCK_SIZE * bps >> 3)) {
110  av_log(s, AV_LOG_ERROR, "Invalid number of channels %u\n", channels);
111  return AVERROR_INVALIDDATA;
112  }
113 
114  if (rate == 0 || rate > INT_MAX) {
115  av_log(s, AV_LOG_ERROR, "Invalid sample rate: %u\n", rate);
116  return AVERROR_INVALIDDATA;
117  }
118 
119  st = avformat_new_stream(s, NULL);
120  if (!st)
121  return AVERROR(ENOMEM);
123  st->codec->codec_tag = id;
124  st->codec->codec_id = codec;
125  st->codec->channels = channels;
126  st->codec->sample_rate = rate;
127  st->codec->bit_rate = channels * rate * bps;
128  st->codec->block_align = FFMAX(bps * st->codec->channels / 8, 1);
129  if (data_size != AU_UNKNOWN_SIZE)
130  st->duration = (((int64_t)data_size)<<3) / (st->codec->channels * (int64_t)bps);
131 
132  st->start_time = 0;
133  avpriv_set_pts_info(st, 64, 1, rate);
134 
135  return 0;
136 }
137 
138 AVInputFormat ff_au_demuxer = {
139  .name = "au",
140  .long_name = NULL_IF_CONFIG_SMALL("Sun AU"),
141  .read_probe = au_probe,
142  .read_header = au_read_header,
143  .read_packet = ff_pcm_read_packet,
144  .read_seek = ff_pcm_read_seek,
145  .codec_tag = (const AVCodecTag* const []) { codec_au_tags, 0 },
146 };
147 
148 #endif /* CONFIG_AU_DEMUXER */
149 
150 #if CONFIG_AU_MUXER
151 
152 #include "rawenc.h"
153 
154 static int au_write_header(AVFormatContext *s)
155 {
156  AVIOContext *pb = s->pb;
157  AVCodecContext *enc = s->streams[0]->codec;
158 
159  if (s->nb_streams != 1) {
160  av_log(s, AV_LOG_ERROR, "only one stream is supported\n");
161  return AVERROR(EINVAL);
162  }
163 
164  enc->codec_tag = ff_codec_get_tag(codec_au_tags, enc->codec_id);
165  if (!enc->codec_tag) {
166  av_log(s, AV_LOG_ERROR, "unsupported codec\n");
167  return AVERROR(EINVAL);
168  }
169 
170  ffio_wfourcc(pb, ".snd"); /* magic number */
171  avio_wb32(pb, AU_HEADER_SIZE); /* header size */
172  avio_wb32(pb, AU_UNKNOWN_SIZE); /* data size */
173  avio_wb32(pb, enc->codec_tag); /* codec ID */
174  avio_wb32(pb, enc->sample_rate);
175  avio_wb32(pb, enc->channels);
176  avio_wb64(pb, 0); /* annotation field */
177  avio_flush(pb);
178 
179  return 0;
180 }
181 
182 static int au_write_trailer(AVFormatContext *s)
183 {
184  AVIOContext *pb = s->pb;
185  int64_t file_size = avio_tell(pb);
186 
187  if (s->pb->seekable && file_size < INT32_MAX) {
188  /* update file size */
189  avio_seek(pb, 8, SEEK_SET);
190  avio_wb32(pb, (uint32_t)(file_size - AU_HEADER_SIZE));
191  avio_seek(pb, file_size, SEEK_SET);
192  avio_flush(pb);
193  }
194 
195  return 0;
196 }
197 
198 AVOutputFormat ff_au_muxer = {
199  .name = "au",
200  .long_name = NULL_IF_CONFIG_SMALL("Sun AU"),
201  .mime_type = "audio/basic",
202  .extensions = "au",
203  .audio_codec = AV_CODEC_ID_PCM_S16BE,
204  .video_codec = AV_CODEC_ID_NONE,
205  .write_header = au_write_header,
206  .write_packet = ff_raw_write_packet,
207  .write_trailer = au_write_trailer,
208  .codec_tag = (const AVCodecTag* const []) { codec_au_tags, 0 },
209 };
210 
211 #endif /* CONFIG_AU_MUXER */
void avio_wb64(AVIOContext *s, uint64_t val)
Definition: aviobuf.c:361
const char * s
Definition: avisynth_c.h:668
Bytestream IO Context.
Definition: avio.h:68
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:59
enum AVCodecID id
Definition: mxfenc.c:89
enum AVCodecID ff_codec_get_id(const AVCodecTag *tags, unsigned int tag)
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.
#define AU_HEADER_SIZE
Definition: au.c:38
int64_t avio_seek(AVIOContext *s, int64_t offset, int whence)
fseek() equivalent for AVIOContext.
Definition: aviobuf.c:199
int64_t avio_skip(AVIOContext *s, int64_t offset)
Skip given number of bytes forward.
Definition: aviobuf.c:256
unsigned int ff_codec_get_tag(const AVCodecTag *tags, enum AVCodecID id)
#define BLOCK_SIZE
Definition: adx.h:53
int block_align
number of bytes per packet if constant and known or 0 Used by some WAV based audio codecs...
Format I/O context.
Definition: avformat.h:944
void void avpriv_request_sample(void *avc, const char *msg,...) av_printf_format(2
Log a generic warning message about a missing feature.
unsigned int avio_rb32(AVIOContext *s)
Definition: aviobuf.c:610
AVStream * avformat_new_stream(AVFormatContext *s, const AVCodec *c)
Add a new stream to a media file.
AVStream ** streams
Definition: avformat.h:992
uint32_t tag
Definition: movenc.c:894
static av_always_inline int64_t avio_tell(AVIOContext *s)
ftell() equivalent for AVIOContext.
Definition: avio.h:248
static av_always_inline void ffio_wfourcc(AVIOContext *pb, const uint8_t *s)
Definition: avio_internal.h:50
AVCodecID
Identify the syntax and semantics of the bitstream.
int av_get_bits_per_sample(enum AVCodecID codec_id)
Return codec bits per sample.
unsigned int avio_rl32(AVIOContext *s)
Definition: aviobuf.c:579
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
void av_log(void *avcl, int level, const char *fmt,...)
Definition: log.c:246
#define FFMAX(a, b)
Definition: common.h:56
int size
AVCodecContext * codec
Codec context associated with this stream.
Definition: avformat.h:662
unsigned char * buf
Buffer must have AVPROBE_PADDING_SIZE of extra allocated bytes filled with zero.
Definition: avformat.h:336
unsigned int nb_streams
A list of all streams in the file.
Definition: avformat.h:991
int seekable
A combination of AVIO_SEEKABLE_ flags or 0 when the stream is not seekable.
Definition: avio.h:117
int bit_rate
the average bitrate
int void avio_flush(AVIOContext *s)
Force flushing of buffered data to the output s.
Definition: aviobuf.c:193
const char * name
Definition: avformat.h:378
static const AVCodecTag codec_au_tags[]
Definition: au.c:40
int ff_raw_write_packet(AVFormatContext *s, AVPacket *pkt)
int ff_pcm_read_seek(AVFormatContext *s, int stream_index, int64_t timestamp, int flags)
Stream structure.
Definition: avformat.h:643
#define AVERROR_PATCHWELCOME
Not yet implemented in FFmpeg, patches welcome.
Definition: error.h:62
int ff_pcm_read_packet(AVFormatContext *s, AVPacket *pkt)
NULL
Definition: eval.c:55
enum AVMediaType codec_type
enum AVCodecID codec_id
int sample_rate
samples per second
AVIOContext * pb
I/O context.
Definition: avformat.h:977
main external API structure.
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:148
unsigned int codec_tag
fourcc (LSB first, so "ABCD" -> (&#39;D&#39;<<24) + (&#39;C&#39;<<16) + (&#39;B&#39;<<8) + &#39;A&#39;).
This structure contains the data a format has to probe a file.
Definition: avformat.h:334
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFilterBuffer structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later.That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another.Buffer references ownership and permissions
int64_t duration
Decoding: duration of the stream, in stream time base.
Definition: avformat.h:696
#define AVPROBE_SCORE_MAX
maximum score, half of that is used for file-extension-based detection
Definition: avformat.h:340
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:689
unsigned bps
Definition: movenc.c:895
int channels
number of audio channels
void avio_wb32(AVIOContext *s, unsigned int val)
Definition: aviobuf.c:299
const char * name
A comma separated list of short names for the format.
Definition: avformat.h:461
#define MKTAG(a, b, c, d)
Definition: common.h:282
#define AU_UNKNOWN_SIZE
Definition: au.c:36