FFmpeg
aiffenc.c
Go to the documentation of this file.
1 /*
2  * AIFF/AIFF-C muxer
3  * Copyright (c) 2006 Patrick Guimond
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 #include <stdint.h>
23 
24 #include "libavutil/intfloat.h"
25 #include "libavutil/opt.h"
27 #include "avformat.h"
28 #include "internal.h"
29 #include "aiff.h"
30 #include "avio_internal.h"
31 #include "isom.h"
32 #include "id3v2.h"
33 #include "mux.h"
34 
35 typedef struct AIFFOutputContext {
36  const AVClass *class;
37  int64_t form;
38  int64_t frames;
39  int64_t ssnd;
45 
47 {
48  int ret;
49  uint64_t pos, end, size;
50  ID3v2EncContext id3v2 = { 0 };
51  AVIOContext *pb = s->pb;
52  PacketListEntry *list_entry = aiff->pict_list.head;
53 
54  if (!s->metadata && !s->nb_chapters && !list_entry)
55  return 0;
56 
57  avio_wb32(pb, MKBETAG('I', 'D', '3', ' '));
58  avio_wb32(pb, 0);
59  pos = avio_tell(pb);
60 
62  ff_id3v2_write_metadata(s, &id3v2);
63  while (list_entry) {
64  if ((ret = ff_id3v2_write_apic(s, &id3v2, &list_entry->pkt)) < 0)
65  return ret;
66  list_entry = list_entry->next;
67  }
68  ff_id3v2_finish(&id3v2, pb, s->metadata_header_padding);
69 
70  end = avio_tell(pb);
71  size = end - pos;
72 
73  /* Update chunk size */
74  avio_seek(pb, pos - 4, SEEK_SET);
75  avio_wb32(pb, size);
76  avio_seek(pb, end, SEEK_SET);
77 
78  if (size & 1)
79  avio_w8(pb, 0);
80 
81  return 0;
82 }
83 
84 static void put_meta(AVFormatContext *s, const char *key, uint32_t id)
85 {
87  AVIOContext *pb = s->pb;
88 
89  if (tag = av_dict_get(s->metadata, key, NULL, 0)) {
90  size_t size = strlen(tag->value);
91 
92  // AIFF tags are zero-padded to an even length.
93  // So simply copy the terminating \0 if the length is odd.
94  size = FFALIGN(size, 2);
95 
96  avio_wb32(pb, id);
97  avio_wb32(pb, size);
98  avio_write(pb, tag->value, size);
99  }
100 }
101 
103 {
104  AIFFOutputContext *aiff = s->priv_data;
105  AVIOContext *pb = s->pb;
106  AVCodecParameters *par;
107  uint64_t sample_rate;
108  int i, aifc = 0;
109 
110  aiff->audio_stream_idx = -1;
111  for (i = 0; i < s->nb_streams; i++) {
112  AVStream *st = s->streams[i];
113  if (aiff->audio_stream_idx < 0 && st->codecpar->codec_type == AVMEDIA_TYPE_AUDIO) {
114  aiff->audio_stream_idx = i;
115  } else if (st->codecpar->codec_type != AVMEDIA_TYPE_VIDEO) {
116  av_log(s, AV_LOG_ERROR, "AIFF allows only one audio stream and a picture.\n");
117  return AVERROR(EINVAL);
118  }
119  }
120  if (aiff->audio_stream_idx < 0) {
121  av_log(s, AV_LOG_ERROR, "No audio stream present.\n");
122  return AVERROR(EINVAL);
123  }
124 
125  par = s->streams[aiff->audio_stream_idx]->codecpar;
126 
127  /* First verify if format is ok */
128  if (!par->codec_tag)
129  return AVERROR(EINVAL);
130  if (par->codec_tag != MKTAG('N','O','N','E'))
131  aifc = 1;
132 
133  /* FORM AIFF header */
134  ffio_wfourcc(pb, "FORM");
135  aiff->form = avio_tell(pb);
136  avio_wb32(pb, 0); /* file length */
137  ffio_wfourcc(pb, aifc ? "AIFC" : "AIFF");
138 
139  if (aifc) { // compressed audio
140  if (!par->block_align) {
141  av_log(s, AV_LOG_ERROR, "block align not set\n");
142  return AVERROR(EINVAL);
143  }
144  /* Version chunk */
145  ffio_wfourcc(pb, "FVER");
146  avio_wb32(pb, 4);
147  avio_wb32(pb, 0xA2805140);
148  }
149 
150  if (par->ch_layout.order == AV_CHANNEL_ORDER_NATIVE && par->ch_layout.nb_channels > 2) {
151  ffio_wfourcc(pb, "CHAN");
152  avio_wb32(pb, 12);
153  ff_mov_write_chan(pb, par->ch_layout.u.mask);
154  }
155 
156  put_meta(s, "title", MKBETAG('N', 'A', 'M', 'E'));
157  put_meta(s, "author", MKBETAG('A', 'U', 'T', 'H'));
158  put_meta(s, "copyright", MKBETAG('(', 'c', ')', ' '));
159  put_meta(s, "comment", MKBETAG('A', 'N', 'N', 'O'));
160 
161  /* Common chunk */
162  ffio_wfourcc(pb, "COMM");
163  avio_wb32(pb, aifc ? 24 : 18); /* size */
164  avio_wb16(pb, par->ch_layout.nb_channels); /* Number of channels */
165 
166  aiff->frames = avio_tell(pb);
167  avio_wb32(pb, 0); /* Number of frames */
168 
169  if (!par->bits_per_coded_sample)
171  if (!par->bits_per_coded_sample) {
172  av_log(s, AV_LOG_ERROR, "could not compute bits per sample\n");
173  return AVERROR(EINVAL);
174  }
175  if (!par->block_align)
176  par->block_align = (par->bits_per_coded_sample * par->ch_layout.nb_channels) >> 3;
177 
178  avio_wb16(pb, par->bits_per_coded_sample); /* Sample size */
179 
181  avio_wb16(pb, (sample_rate >> 52) + (16383 - 1023));
182  avio_wb64(pb, UINT64_C(1) << 63 | sample_rate << 11);
183 
184  if (aifc) {
185  avio_wl32(pb, par->codec_tag);
186  avio_wb16(pb, 0);
187  }
188 
189  if ( (par->codec_tag == MKTAG('Q','D','M','2')
190  || par->codec_tag == MKTAG('Q','c','l','p')) && par->extradata_size) {
191  ffio_wfourcc(pb, "wave");
192  avio_wb32(pb, par->extradata_size);
193  avio_write(pb, par->extradata, par->extradata_size);
194  }
195 
196  /* Sound data chunk */
197  ffio_wfourcc(pb, "SSND");
198  aiff->ssnd = avio_tell(pb); /* Sound chunk size */
199  avio_wb32(pb, 0); /* Sound samples data size */
200  avio_wb32(pb, 0); /* Data offset */
201  avio_wb32(pb, 0); /* Block-size (block align) */
202 
203  avpriv_set_pts_info(s->streams[aiff->audio_stream_idx], 64, 1,
204  s->streams[aiff->audio_stream_idx]->codecpar->sample_rate);
205 
206  return 0;
207 }
208 
210 {
211  AIFFOutputContext *aiff = s->priv_data;
212  AVIOContext *pb = s->pb;
213  if (pkt->stream_index == aiff->audio_stream_idx)
214  avio_write(pb, pkt->data, pkt->size);
215  else {
216  /* warn only once for each stream */
217  if (s->streams[pkt->stream_index]->nb_frames == 1) {
218  av_log(s, AV_LOG_WARNING, "Got more than one picture in stream %d,"
219  " ignoring.\n", pkt->stream_index);
220  }
221  if (s->streams[pkt->stream_index]->nb_frames >= 1)
222  return 0;
223 
224  return avpriv_packet_list_put(&aiff->pict_list, pkt, NULL, 0);
225  }
226 
227  return 0;
228 }
229 
231 {
232  int ret = 0;
233  AVIOContext *pb = s->pb;
234  AIFFOutputContext *aiff = s->priv_data;
235  AVCodecParameters *par = s->streams[aiff->audio_stream_idx]->codecpar;
236 
237  /* Chunks sizes must be even */
238  int64_t file_size, data_size;
239  data_size = avio_tell(pb);
240  if (data_size & 1)
241  avio_w8(pb, 0);
242 
243  if (s->pb->seekable & AVIO_SEEKABLE_NORMAL) {
244  /* Write ID3 tags */
245  if (aiff->write_id3v2)
246  if ((ret = put_id3v2_tags(s, aiff)) < 0)
247  return ret;
248 
249  /* File length */
250  file_size = avio_tell(pb);
251  avio_seek(pb, aiff->form, SEEK_SET);
252  avio_wb32(pb, file_size - aiff->form - 4);
253 
254  /* Number of sample frames */
255  avio_seek(pb, aiff->frames, SEEK_SET);
256  avio_wb32(pb, (data_size - aiff->ssnd - 12) / par->block_align);
257 
258  /* Sound Data chunk size */
259  avio_seek(pb, aiff->ssnd, SEEK_SET);
260  avio_wb32(pb, data_size - aiff->ssnd - 4);
261  }
262 
263  return ret;
264 }
265 
267 {
268  AIFFOutputContext *aiff = s->priv_data;
269 
271 }
272 
273 #define OFFSET(x) offsetof(AIFFOutputContext, x)
274 #define ENC AV_OPT_FLAG_ENCODING_PARAM
275 static const AVOption options[] = {
276  { "write_id3v2", "Enable ID3 tags writing.",
277  OFFSET(write_id3v2), AV_OPT_TYPE_BOOL, {.i64 = 0}, 0, 1, ENC },
278  { "id3v2_version", "Select ID3v2 version to write. Currently 3 and 4 are supported.",
279  OFFSET(id3v2_version), AV_OPT_TYPE_INT, {.i64 = 4}, 3, 4, ENC },
280  { NULL },
281 };
282 
283 static const AVClass aiff_muxer_class = {
284  .class_name = "AIFF muxer",
285  .item_name = av_default_item_name,
286  .option = options,
287  .version = LIBAVUTIL_VERSION_INT,
288 };
289 
291  .p.name = "aiff",
292  .p.long_name = NULL_IF_CONFIG_SMALL("Audio IFF"),
293  .p.mime_type = "audio/aiff",
294  .p.extensions = "aif,aiff,afc,aifc",
295  .priv_data_size = sizeof(AIFFOutputContext),
296  .p.audio_codec = AV_CODEC_ID_PCM_S16BE,
297  .p.video_codec = AV_CODEC_ID_PNG,
298  .write_header = aiff_write_header,
299  .write_packet = aiff_write_packet,
300  .write_trailer = aiff_write_trailer,
301  .deinit = aiff_deinit,
302  .p.codec_tag = ff_aiff_codec_tags_list,
303  .p.priv_class = &aiff_muxer_class,
304 };
AV_LOG_WARNING
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:186
avpriv_packet_list_put
int avpriv_packet_list_put(PacketList *packet_buffer, AVPacket *pkt, int(*copy)(AVPacket *dst, const AVPacket *src), int flags)
Append an AVPacket to the list.
Definition: avpacket.c:541
AVCodecParameters::extradata
uint8_t * extradata
Extra binary data needed for initializing the decoder, codec-dependent.
Definition: codec_par.h:69
PacketList::head
PacketListEntry * head
Definition: packet_internal.h:34
ID3v2EncContext
Definition: id3v2.h:51
AIFFOutputContext::frames
int64_t frames
Definition: aiffenc.c:38
AVOutputFormat::name
const char * name
Definition: avformat.h:510
AVERROR
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame 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. Frame references ownership and permissions
opt.h
AVChannelLayout::u
union AVChannelLayout::@349 u
Details about which channels are present in this layout.
AVCodecParameters::codec_type
enum AVMediaType codec_type
General type of the encoded data.
Definition: codec_par.h:51
ffio_wfourcc
static av_always_inline void ffio_wfourcc(AVIOContext *pb, const uint8_t *s)
Definition: avio_internal.h:124
AVCodecParameters
This struct describes the properties of an encoded stream.
Definition: codec_par.h:47
id3v2.h
AIFFOutputContext::id3v2_version
int id3v2_version
Definition: aiffenc.c:43
AVPacket::data
uint8_t * data
Definition: packet.h:522
AVOption
AVOption.
Definition: opt.h:346
PacketList
Definition: packet_internal.h:33
aiff_write_packet
static int aiff_write_packet(AVFormatContext *s, AVPacket *pkt)
Definition: aiffenc.c:209
AVCodecParameters::codec_tag
uint32_t codec_tag
Additional information about the codec (corresponds to the AVI FOURCC).
Definition: codec_par.h:59
AIFFOutputContext::ssnd
int64_t ssnd
Definition: aiffenc.c:39
AVChannelLayout::order
enum AVChannelOrder order
Channel order used in this layout.
Definition: channel_layout.h:308
AVChannelLayout::mask
uint64_t mask
This member must be used for AV_CHANNEL_ORDER_NATIVE, and may be used for AV_CHANNEL_ORDER_AMBISONIC ...
Definition: channel_layout.h:335
AVChannelLayout::nb_channels
int nb_channels
Number of channels in this layout.
Definition: channel_layout.h:313
intfloat.h
ff_id3v2_start
void ff_id3v2_start(ID3v2EncContext *id3, AVIOContext *pb, int id3v2_version, const char *magic)
Initialize an ID3v2 tag.
Definition: id3v2enc.c:206
sample_rate
sample_rate
Definition: ffmpeg_filter.c:425
AIFFOutputContext::write_id3v2
int write_id3v2
Definition: aiffenc.c:42
FFOutputFormat::p
AVOutputFormat p
The public AVOutputFormat.
Definition: mux.h:36
avpriv_set_pts_info
void avpriv_set_pts_info(AVStream *st, int pts_wrap_bits, unsigned int pts_num, unsigned int pts_den)
Set the time base and wrapping info for a given stream.
Definition: avformat.c:853
AV_CODEC_ID_PCM_S16BE
@ AV_CODEC_ID_PCM_S16BE
Definition: codec_id.h:329
ENC
#define ENC
Definition: aiffenc.c:274
avio_tell
static av_always_inline int64_t avio_tell(AVIOContext *s)
ftell() equivalent for AVIOContext.
Definition: avio.h:494
av_get_bits_per_sample
int av_get_bits_per_sample(enum AVCodecID codec_id)
Return codec bits per sample.
Definition: utils.c:547
pkt
AVPacket * pkt
Definition: movenc.c:59
AV_LOG_ERROR
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:180
av_dict_get
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:62
s
#define s(width, name)
Definition: cbs_vp9.c:198
AVMEDIA_TYPE_AUDIO
@ AVMEDIA_TYPE_AUDIO
Definition: avutil.h:202
options
static const AVOption options[]
Definition: aiffenc.c:275
ff_id3v2_write_metadata
int ff_id3v2_write_metadata(AVFormatContext *s, ID3v2EncContext *id3)
Convert and write all global metadata from s into an ID3v2 tag.
Definition: id3v2enc.c:331
key
const char * key
Definition: hwcontext_opencl.c:189
ff_aiff_muxer
const FFOutputFormat ff_aiff_muxer
Definition: aiffenc.c:290
AV_CODEC_ID_PNG
@ AV_CODEC_ID_PNG
Definition: codec_id.h:113
AVFormatContext
Format I/O context.
Definition: avformat.h:1255
internal.h
AVStream::codecpar
AVCodecParameters * codecpar
Codec parameters associated with this stream.
Definition: avformat.h:766
LIBAVUTIL_VERSION_INT
#define LIBAVUTIL_VERSION_INT
Definition: version.h:85
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:66
NULL
#define NULL
Definition: coverity.c:32
isom.h
aiff.h
av_default_item_name
const char * av_default_item_name(void *ptr)
Return the context name.
Definition: log.c:237
AIFFOutputContext::form
int64_t form
Definition: aiffenc.c:37
FFOutputFormat
Definition: mux.h:32
avio_w8
void avio_w8(AVIOContext *s, int b)
Definition: aviobuf.c:178
AVCodecParameters::ch_layout
AVChannelLayout ch_layout
Audio only.
Definition: codec_par.h:180
PacketListEntry::next
struct PacketListEntry * next
Definition: packet_internal.h:29
AVCodecParameters::sample_rate
int sample_rate
Audio only.
Definition: codec_par.h:184
AVCodecParameters::extradata_size
int extradata_size
Size of the extradata content in bytes.
Definition: codec_par.h:73
ff_id3v2_write_apic
int ff_id3v2_write_apic(AVFormatContext *s, ID3v2EncContext *id3, AVPacket *pkt)
Write an attached picture from pkt into an ID3v2 tag.
Definition: id3v2enc.c:352
AVIOContext
Bytestream IO Context.
Definition: avio.h:160
AVPacket::size
int size
Definition: packet.h:523
NULL_IF_CONFIG_SMALL
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification.
Definition: internal.h:106
avpriv_packet_list_free
void avpriv_packet_list_free(PacketList *pkt_buf)
Wipe the list and unref all the packets in it.
Definition: avpacket.c:594
aiff_write_trailer
static int aiff_write_trailer(AVFormatContext *s)
Definition: aiffenc.c:230
size
int size
Definition: twinvq_data.h:10344
ID3v2_DEFAULT_MAGIC
#define ID3v2_DEFAULT_MAGIC
Default magic bytes for ID3v2 header: "ID3".
Definition: id3v2.h:35
MKBETAG
#define MKBETAG(a, b, c, d)
Definition: macros.h:56
PacketListEntry::pkt
AVPacket pkt
Definition: packet_internal.h:30
avio_write
void avio_write(AVIOContext *s, const unsigned char *buf, int size)
Definition: aviobuf.c:200
avio_wb32
void avio_wb32(AVIOContext *s, unsigned int val)
Definition: aviobuf.c:364
avio_wl32
void avio_wl32(AVIOContext *s, unsigned int val)
Definition: aviobuf.c:356
put_id3v2_tags
static int put_id3v2_tags(AVFormatContext *s, AIFFOutputContext *aiff)
Definition: aiffenc.c:46
AV_CHANNEL_ORDER_NATIVE
@ AV_CHANNEL_ORDER_NATIVE
The native channel order, i.e.
Definition: channel_layout.h:118
av_double2int
static av_always_inline uint64_t av_double2int(double f)
Reinterpret a double as a 64-bit integer.
Definition: intfloat.h:70
PacketListEntry
Definition: packet_internal.h:28
i
#define i(width, name, range_min, range_max)
Definition: cbs_h2645.c:255
avio_internal.h
AVCodecParameters::block_align
int block_align
Audio only.
Definition: codec_par.h:191
OFFSET
#define OFFSET(x)
Definition: aiffenc.c:273
AIFFOutputContext
Definition: aiffenc.c:35
tag
uint32_t tag
Definition: movenc.c:1786
ret
ret
Definition: filter_design.txt:187
AVStream
Stream structure.
Definition: avformat.h:743
avio_seek
int64_t avio_seek(AVIOContext *s, int64_t offset, int whence)
fseek() equivalent for AVIOContext.
Definition: aviobuf.c:230
AVClass::class_name
const char * class_name
The name of the class; usually it is the same name as the context structure type to which the AVClass...
Definition: log.h:71
aiff_write_header
static int aiff_write_header(AVFormatContext *s)
Definition: aiffenc.c:102
pos
unsigned int pos
Definition: spdifenc.c:413
avformat.h
AVIO_SEEKABLE_NORMAL
#define AVIO_SEEKABLE_NORMAL
Seeking works like for a local file.
Definition: avio.h:41
AV_OPT_TYPE_INT
@ AV_OPT_TYPE_INT
Definition: opt.h:235
AVPacket::stream_index
int stream_index
Definition: packet.h:524
aiff_muxer_class
static const AVClass aiff_muxer_class
Definition: aiffenc.c:283
ff_id3v2_finish
void ff_id3v2_finish(ID3v2EncContext *id3, AVIOContext *pb, int padding_bytes)
Finalize an opened ID3v2 tag.
Definition: id3v2enc.c:421
aiff_deinit
static void aiff_deinit(AVFormatContext *s)
Definition: aiffenc.c:266
put_meta
static void put_meta(AVFormatContext *s, const char *key, uint32_t id)
Definition: aiffenc.c:84
avio_wb64
void avio_wb64(AVIOContext *s, uint64_t val)
Definition: aviobuf.c:430
AVMEDIA_TYPE_VIDEO
@ AVMEDIA_TYPE_VIDEO
Definition: avutil.h:201
AVCodecParameters::bits_per_coded_sample
int bits_per_coded_sample
The number of bits per sample in the codedwords.
Definition: codec_par.h:110
packet_internal.h
AVDictionaryEntry
Definition: dict.h:89
FFALIGN
#define FFALIGN(x, a)
Definition: macros.h:78
AVCodecParameters::codec_id
enum AVCodecID codec_id
Specific type of the encoded data (the codec used).
Definition: codec_par.h:55
ff_aiff_codec_tags_list
const AVCodecTag *const ff_aiff_codec_tags_list[]
Definition: aiff.c:55
AVPacket
This structure stores compressed data.
Definition: packet.h:499
AV_OPT_TYPE_BOOL
@ AV_OPT_TYPE_BOOL
Definition: opt.h:251
avio_wb16
void avio_wb16(AVIOContext *s, unsigned int val)
Definition: aviobuf.c:442
av_log
#define av_log(a,...)
Definition: tableprint_vlc.h:27
AIFFOutputContext::pict_list
PacketList pict_list
Definition: aiffenc.c:41
MKTAG
#define MKTAG(a, b, c, d)
Definition: macros.h:55
ff_mov_write_chan
void ff_mov_write_chan(AVIOContext *pb, int64_t channel_layout)
Definition: isom.c:413
AIFFOutputContext::audio_stream_idx
int audio_stream_idx
Definition: aiffenc.c:40
mux.h