FFmpeg
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
cafenc.c
Go to the documentation of this file.
1 /*
2  * Core Audio Format muxer
3  * Copyright (c) 2011 Carl Eugen Hoyos
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 "avformat.h"
23 #include "caf.h"
24 #include "isom.h"
25 #include "avio_internal.h"
26 #include "libavutil/intfloat.h"
27 #include "libavutil/dict.h"
28 
29 typedef struct {
30  int64_t data;
34  int packets;
35 } CAFContext;
36 
37 static uint32_t codec_flags(enum AVCodecID codec_id) {
38  switch (codec_id) {
41  return 1; //< kCAFLinearPCMFormatFlagIsFloat
45  return 2; //< kCAFLinearPCMFormatFlagIsLittleEndian
48  return 3; //< kCAFLinearPCMFormatFlagIsFloat | kCAFLinearPCMFormatFlagIsLittleEndian
49  default:
50  return 0;
51  }
52 }
53 
54 static uint32_t samples_per_packet(enum AVCodecID codec_id, int channels, int block_align) {
55  switch (codec_id) {
56  case AV_CODEC_ID_PCM_S8:
69  return 1;
70  case AV_CODEC_ID_MACE3:
71  case AV_CODEC_ID_MACE6:
72  return 6;
74  return 64;
75  case AV_CODEC_ID_AMR_NB:
76  case AV_CODEC_ID_GSM:
77  case AV_CODEC_ID_ILBC:
78  case AV_CODEC_ID_QCELP:
79  return 160;
80  case AV_CODEC_ID_GSM_MS:
81  return 320;
82  case AV_CODEC_ID_MP1:
83  return 384;
84  case AV_CODEC_ID_MP2:
85  case AV_CODEC_ID_MP3:
86  return 1152;
87  case AV_CODEC_ID_AC3:
88  return 1536;
89  case AV_CODEC_ID_QDM2:
90  case AV_CODEC_ID_QDMC:
91  return 2048 * channels;
92  case AV_CODEC_ID_ALAC:
93  return 4096;
95  return (block_align - 4 * channels) * 8 / (4 * channels) + 1;
97  return (block_align - 7 * channels) * 2 / channels + 2;
98  default:
99  return 0;
100  }
101 }
102 
104 {
105  AVIOContext *pb = s->pb;
106  AVCodecParameters *par = s->streams[0]->codecpar;
107  CAFContext *caf = s->priv_data;
108  AVDictionaryEntry *t = NULL;
109  unsigned int codec_tag = ff_codec_get_tag(ff_codec_caf_tags, par->codec_id);
110  int64_t chunk_size = 0;
111  int frame_size = par->frame_size;
112 
113  if (s->nb_streams != 1) {
114  av_log(s, AV_LOG_ERROR, "CAF files have exactly one stream\n");
115  return AVERROR(EINVAL);
116  }
117 
118  switch (par->codec_id) {
119  case AV_CODEC_ID_AAC:
120  case AV_CODEC_ID_OPUS:
121  av_log(s, AV_LOG_ERROR, "muxing codec currently unsupported\n");
122  return AVERROR_PATCHWELCOME;
123  }
124 
125  if (!codec_tag) {
126  av_log(s, AV_LOG_ERROR, "unsupported codec\n");
127  return AVERROR_INVALIDDATA;
128  }
129 
130  if (!par->block_align && !(pb->seekable & AVIO_SEEKABLE_NORMAL)) {
131  av_log(s, AV_LOG_ERROR, "Muxing variable packet size not supported on non seekable output\n");
132  return AVERROR_INVALIDDATA;
133  }
134 
135  if (par->codec_id != AV_CODEC_ID_MP3 || frame_size != 576)
136  frame_size = samples_per_packet(par->codec_id, par->channels, par->block_align);
137 
138  ffio_wfourcc(pb, "caff"); //< mFileType
139  avio_wb16(pb, 1); //< mFileVersion
140  avio_wb16(pb, 0); //< mFileFlags
141 
142  ffio_wfourcc(pb, "desc"); //< Audio Description chunk
143  avio_wb64(pb, 32); //< mChunkSize
144  avio_wb64(pb, av_double2int(par->sample_rate)); //< mSampleRate
145  avio_wl32(pb, codec_tag); //< mFormatID
146  avio_wb32(pb, codec_flags(par->codec_id)); //< mFormatFlags
147  avio_wb32(pb, par->block_align); //< mBytesPerPacket
148  avio_wb32(pb, frame_size); //< mFramesPerPacket
149  avio_wb32(pb, par->channels); //< mChannelsPerFrame
150  avio_wb32(pb, av_get_bits_per_sample(par->codec_id)); //< mBitsPerChannel
151 
152  if (par->channel_layout) {
153  ffio_wfourcc(pb, "chan");
154  avio_wb64(pb, 12);
156  }
157 
158  if (par->codec_id == AV_CODEC_ID_ALAC) {
159  ffio_wfourcc(pb, "kuki");
160  avio_wb64(pb, 12 + par->extradata_size);
161  avio_write(pb, "\0\0\0\14frmaalac", 12);
162  avio_write(pb, par->extradata, par->extradata_size);
163  } else if (par->codec_id == AV_CODEC_ID_AMR_NB) {
164  ffio_wfourcc(pb, "kuki");
165  avio_wb64(pb, 29);
166  avio_write(pb, "\0\0\0\14frmasamr", 12);
167  avio_wb32(pb, 0x11); /* size */
168  avio_write(pb, "samrFFMP", 8);
169  avio_w8(pb, 0); /* decoder version */
170 
171  avio_wb16(pb, 0x81FF); /* Mode set (all modes for AMR_NB) */
172  avio_w8(pb, 0x00); /* Mode change period (no restriction) */
173  avio_w8(pb, 0x01); /* Frames per sample */
174  } else if (par->codec_id == AV_CODEC_ID_QDM2 || par->codec_id == AV_CODEC_ID_QDMC) {
175  ffio_wfourcc(pb, "kuki");
176  avio_wb64(pb, par->extradata_size);
177  avio_write(pb, par->extradata, par->extradata_size);
178  }
179 
181  if (av_dict_count(s->metadata)) {
182  ffio_wfourcc(pb, "info"); //< Information chunk
183  while ((t = av_dict_get(s->metadata, "", t, AV_DICT_IGNORE_SUFFIX))) {
184  chunk_size += strlen(t->key) + strlen(t->value) + 2;
185  }
186  avio_wb64(pb, chunk_size + 4);
188  t = NULL;
189  while ((t = av_dict_get(s->metadata, "", t, AV_DICT_IGNORE_SUFFIX))) {
190  avio_put_str(pb, t->key);
191  avio_put_str(pb, t->value);
192  }
193  }
194 
195  ffio_wfourcc(pb, "data"); //< Audio Data chunk
196  caf->data = avio_tell(pb);
197  avio_wb64(pb, -1); //< mChunkSize
198  avio_wb32(pb, 0); //< mEditCount
199 
200  avio_flush(pb);
201  return 0;
202 }
203 
205 {
206  CAFContext *caf = s->priv_data;
207 
208  avio_write(s->pb, pkt->data, pkt->size);
209  if (!s->streams[0]->codecpar->block_align) {
210  void *pkt_sizes = caf->pkt_sizes;
211  int i, alloc_size = caf->size_entries_used + 5;
212  if (alloc_size < 0) {
213  caf->pkt_sizes = NULL;
214  } else {
215  caf->pkt_sizes = av_fast_realloc(caf->pkt_sizes,
216  &caf->size_buffer_size,
217  alloc_size);
218  }
219  if (!caf->pkt_sizes) {
220  av_free(pkt_sizes);
221  return AVERROR(ENOMEM);
222  }
223  for (i = 4; i > 0; i--) {
224  unsigned top = pkt->size >> i * 7;
225  if (top)
226  caf->pkt_sizes[caf->size_entries_used++] = 128 | top;
227  }
228  caf->pkt_sizes[caf->size_entries_used++] = pkt->size & 127;
229  caf->packets++;
230  }
231  return 0;
232 }
233 
235 {
236  CAFContext *caf = s->priv_data;
237  AVIOContext *pb = s->pb;
238  AVCodecParameters *par = s->streams[0]->codecpar;
239 
240  if (pb->seekable & AVIO_SEEKABLE_NORMAL) {
241  int64_t file_size = avio_tell(pb);
242 
243  avio_seek(pb, caf->data, SEEK_SET);
244  avio_wb64(pb, file_size - caf->data - 8);
245  avio_seek(pb, file_size, SEEK_SET);
246  if (!par->block_align) {
247  ffio_wfourcc(pb, "pakt");
248  avio_wb64(pb, caf->size_entries_used + 24);
249  avio_wb64(pb, caf->packets); ///< mNumberPackets
250  avio_wb64(pb, caf->packets * samples_per_packet(par->codec_id, par->channels, par->block_align)); ///< mNumberValidFrames
251  avio_wb32(pb, 0); ///< mPrimingFrames
252  avio_wb32(pb, 0); ///< mRemainderFrames
253  avio_write(pb, caf->pkt_sizes, caf->size_entries_used);
254  caf->size_buffer_size = 0;
255  }
256  avio_flush(pb);
257  }
258  av_freep(&caf->pkt_sizes);
259  return 0;
260 }
261 
263  .name = "caf",
264  .long_name = NULL_IF_CONFIG_SMALL("Apple CAF (Core Audio Format)"),
265  .mime_type = "audio/x-caf",
266  .extensions = "caf",
267  .priv_data_size = sizeof(CAFContext),
268  .audio_codec = AV_CODEC_ID_PCM_S16BE,
269  .video_codec = AV_CODEC_ID_NONE,
273  .codec_tag = (const AVCodecTag* const []){ff_codec_caf_tags, 0},
274 };
static void write_packet(OutputFile *of, AVPacket *pkt, OutputStream *ost, int unqueue)
Definition: ffmpeg.c:671
void avio_wb64(AVIOContext *s, uint64_t val)
Definition: aviobuf.c:468
#define NULL
Definition: coverity.c:32
const char * s
Definition: avisynth_c.h:768
Bytestream IO Context.
Definition: avio.h:161
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:59
int packets
Definition: cafenc.c:34
enum AVCodecID codec_id
Specific type of the encoded data (the codec used).
Definition: avcodec.h:4152
int size
Definition: avcodec.h:1680
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:244
CAF common code.
static av_always_inline uint64_t av_double2int(double f)
Reinterpret a double as a 64-bit integer.
Definition: intfloat.h:70
unsigned int ff_codec_get_tag(const AVCodecTag *tags, enum AVCodecID id)
Definition: utils.c:3043
static AVPacket pkt
This struct describes the properties of an encoded stream.
Definition: avcodec.h:4144
int frame_size
Audio only.
Definition: avcodec.h:4273
Format I/O context.
Definition: avformat.h:1349
Public dictionary API.
void avio_wl32(AVIOContext *s, unsigned int val)
Definition: aviobuf.c:374
uint8_t
AVStream ** streams
A list of all streams in the file.
Definition: avformat.h:1417
uint8_t * pkt_sizes
Definition: cafenc.c:31
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
uint8_t * data
Definition: avcodec.h:1679
static av_always_inline int64_t avio_tell(AVIOContext *s)
ftell() equivalent for AVIOContext.
Definition: avio.h:556
void avio_write(AVIOContext *s, const unsigned char *buf, int size)
Definition: aviobuf.c:216
static av_always_inline void ffio_wfourcc(AVIOContext *pb, const uint8_t *s)
Definition: avio_internal.h:58
uint64_t channel_layout
Audio only.
Definition: avcodec.h:4254
#define av_log(a,...)
AVCodecID
Identify the syntax and semantics of the bitstream.
Definition: avcodec.h:214
int size_entries_used
Definition: cafenc.c:33
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:176
AVDictionary * metadata
Metadata that applies to the whole file.
Definition: avformat.h:1567
int av_get_bits_per_sample(enum AVCodecID codec_id)
Return codec bits per sample.
Definition: utils.c:1662
static int caf_write_header(AVFormatContext *s)
Definition: cafenc.c:103
#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:179
preferred ID for decoding MPEG audio layer 1, 2 or 3
Definition: avcodec.h:557
int ff_standardize_creation_time(AVFormatContext *s)
Standardize creation_time metadata in AVFormatContext to an ISO-8601 timestamp string.
Definition: utils.c:5473
int extradata_size
Size of the extradata content in bytes.
Definition: avcodec.h:4170
unsigned int nb_streams
Number of elements in AVFormatContext.streams.
Definition: avformat.h:1405
int block_align
Audio only.
Definition: avcodec.h:4269
int seekable
A combination of AVIO_SEEKABLE_ flags or 0 when the stream is not seekable.
Definition: avio.h:261
int void avio_flush(AVIOContext *s)
Force flushing of buffered data.
Definition: aviobuf.c:236
AVOutputFormat ff_caf_muxer
Definition: cafenc.c:262
static int write_trailer(AVFormatContext *s1)
Definition: v4l2enc.c:94
const char * name
Definition: avformat.h:524
static uint32_t samples_per_packet(enum AVCodecID codec_id, int channels, int block_align)
Definition: cafenc.c:54
void * av_fast_realloc(void *ptr, unsigned int *size, size_t min_size)
Reallocate the given buffer if it is not large enough, otherwise do nothing.
Definition: mem.c:450
enum AVCodecID codec_id
Definition: vaapi_decode.c:235
static uint32_t codec_flags(enum AVCodecID codec_id)
Definition: cafenc.c:37
int avio_put_str(AVIOContext *s, const char *str)
Write a NULL-terminated string.
Definition: aviobuf.c:390
#define AVERROR_PATCHWELCOME
Not yet implemented in FFmpeg, patches welcome.
Definition: error.h:62
#define AVIO_SEEKABLE_NORMAL
Seeking works like for a local file.
Definition: avio.h:40
int frame_size
Definition: mxfenc.c:1896
AVIOContext * pb
I/O context.
Definition: avformat.h:1391
void avio_w8(AVIOContext *s, int b)
Definition: aviobuf.c:194
static int caf_write_packet(AVFormatContext *s, AVPacket *pkt)
Definition: cafenc.c:204
void avio_wb16(AVIOContext *s, unsigned int val)
Definition: aviobuf.c:480
static int caf_write_trailer(AVFormatContext *s)
Definition: cafenc.c:234
int sample_rate
Audio only.
Definition: avcodec.h:4262
void ff_mov_write_chan(AVIOContext *pb, int64_t channel_layout)
Definition: isom.c:626
Main libavformat public API header.
int64_t data
Definition: cafenc.c:30
int size_buffer_size
Definition: cafenc.c:32
char * key
Definition: dict.h:86
#define av_free(p)
char * value
Definition: dict.h:87
as in Berlin toast format
Definition: avcodec.h:574
void * priv_data
Format private data.
Definition: avformat.h:1377
static void write_header(FFV1Context *f)
Definition: ffv1enc.c:337
uint8_t * extradata
Extra binary data needed for initializing the decoder, codec-dependent.
Definition: avcodec.h:4166
int channels
Audio only.
Definition: avcodec.h:4258
void avio_wb32(AVIOContext *s, unsigned int val)
Definition: aviobuf.c:382
#define av_freep(p)
#define AV_DICT_IGNORE_SUFFIX
Return first entry in a dictionary whose first part corresponds to the search key, ignoring the suffix of the found key string.
Definition: dict.h:70
AVCodecParameters * codecpar
Definition: avformat.h:1252
const AVCodecTag ff_codec_caf_tags[]
Known codec tags for CAF.
Definition: caf.c:34
This structure stores compressed data.
Definition: avcodec.h:1656