Libav
apetag.c
Go to the documentation of this file.
1 /*
2  * APE tag handling
3  * Copyright (c) 2007 Benjamin Zores <ben@geexbox.org>
4  * based upon libdemac from Dave Chapman.
5  *
6  * This file is part of Libav.
7  *
8  * Libav is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Lesser General Public
10  * License as published by the Free Software Foundation; either
11  * version 2.1 of the License, or (at your option) any later version.
12  *
13  * Libav is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16  * Lesser General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public
19  * License along with Libav; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21  */
22 
23 #include <inttypes.h>
24 
25 #include "libavutil/intreadwrite.h"
26 #include "libavutil/dict.h"
27 #include "avformat.h"
28 #include "avio_internal.h"
29 #include "apetag.h"
30 #include "internal.h"
31 
32 #define APE_TAG_VERSION 2000
33 #define APE_TAG_FOOTER_BYTES 32
34 #define APE_TAG_FLAG_CONTAINS_HEADER (1 << 31)
35 #define APE_TAG_FLAG_CONTAINS_FOOTER (1 << 30)
36 #define APE_TAG_FLAG_IS_HEADER (1 << 29)
37 #define APE_TAG_FLAG_IS_BINARY (1 << 1)
38 
40 {
41  AVIOContext *pb = s->pb;
42  uint8_t key[1024], *value;
43  uint32_t size, flags;
44  int i, c;
45 
46  size = avio_rl32(pb); /* field size */
47  flags = avio_rl32(pb); /* field flags */
48  for (i = 0; i < sizeof(key) - 1; i++) {
49  c = avio_r8(pb);
50  if (c < 0x20 || c > 0x7E)
51  break;
52  else
53  key[i] = c;
54  }
55  key[i] = 0;
56  if (c != 0) {
57  av_log(s, AV_LOG_WARNING, "Invalid APE tag key '%s'.\n", key);
58  return -1;
59  }
60  if (size > INT32_MAX - FF_INPUT_BUFFER_PADDING_SIZE) {
61  av_log(s, AV_LOG_ERROR, "APE tag size too large.\n");
62  return AVERROR_INVALIDDATA;
63  }
64  if (flags & APE_TAG_FLAG_IS_BINARY) {
65  uint8_t filename[1024];
66  enum AVCodecID id;
68  if (!st)
69  return AVERROR(ENOMEM);
70 
71  size -= avio_get_str(pb, size, filename, sizeof(filename));
72  if (size <= 0) {
73  av_log(s, AV_LOG_WARNING, "Skipping binary tag '%s'.\n", key);
74  return 0;
75  }
76 
77  av_dict_set(&st->metadata, key, filename, 0);
78 
79  if ((id = ff_guess_image2_codec(filename)) != AV_CODEC_ID_NONE) {
80  AVPacket pkt;
81  int ret;
82 
83  ret = av_get_packet(s->pb, &pkt, size);
84  if (ret < 0) {
85  av_log(s, AV_LOG_ERROR, "Error reading cover art.\n");
86  return ret;
87  }
88 
91  st->codec->codec_id = id;
92 
93  st->attached_pic = pkt;
96  } else {
98  if (!st->codec->extradata)
99  return AVERROR(ENOMEM);
100  if (avio_read(pb, st->codec->extradata, size) != size) {
101  av_freep(&st->codec->extradata);
102  return AVERROR(EIO);
103  }
104  st->codec->extradata_size = size;
106  }
107  } else {
108  value = av_malloc(size+1);
109  if (!value)
110  return AVERROR(ENOMEM);
111  c = avio_read(pb, value, size);
112  if (c < 0) {
113  av_free(value);
114  return c;
115  }
116  value[c] = 0;
117  av_dict_set(&s->metadata, key, value, AV_DICT_DONT_STRDUP_VAL);
118  }
119  return 0;
120 }
121 
123 {
124  AVIOContext *pb = s->pb;
125  int64_t file_size = avio_size(pb);
126  uint32_t val, fields, tag_bytes;
127  uint8_t buf[8];
128  int64_t tag_start;
129  int i;
130 
131  if (file_size < APE_TAG_FOOTER_BYTES)
132  return 0;
133 
134  avio_seek(pb, file_size - APE_TAG_FOOTER_BYTES, SEEK_SET);
135 
136  avio_read(pb, buf, 8); /* APETAGEX */
137  if (strncmp(buf, "APETAGEX", 8)) {
138  return 0;
139  }
140 
141  val = avio_rl32(pb); /* APE tag version */
142  if (val > APE_TAG_VERSION) {
143  av_log(s, AV_LOG_ERROR, "Unsupported tag version. (>=%d)\n", APE_TAG_VERSION);
144  return 0;
145  }
146 
147  tag_bytes = avio_rl32(pb); /* tag size */
148  if (tag_bytes - APE_TAG_FOOTER_BYTES > (1024 * 1024 * 16)) {
149  av_log(s, AV_LOG_ERROR, "Tag size is way too big\n");
150  return 0;
151  }
152 
153  if (tag_bytes > file_size - APE_TAG_FOOTER_BYTES) {
154  av_log(s, AV_LOG_ERROR, "Invalid tag size %"PRIu32".\n", tag_bytes);
155  return 0;
156  }
157  tag_start = file_size - tag_bytes - APE_TAG_FOOTER_BYTES;
158 
159  fields = avio_rl32(pb); /* number of fields */
160  if (fields > 65536) {
161  av_log(s, AV_LOG_ERROR, "Too many tag fields (%"PRIu32")\n", fields);
162  return 0;
163  }
164 
165  val = avio_rl32(pb); /* flags */
166  if (val & APE_TAG_FLAG_IS_HEADER) {
167  av_log(s, AV_LOG_ERROR, "APE Tag is a header\n");
168  return 0;
169  }
170 
171  avio_seek(pb, file_size - tag_bytes, SEEK_SET);
172 
173  for (i=0; i<fields; i++)
174  if (ape_tag_read_field(s) < 0) break;
175 
176  return tag_start;
177 }
178 
180 {
181  AVDictionaryEntry *e = NULL;
182  int64_t start, end;
183  int size, count = 0;
184 
185  if (!s->pb->seekable)
186  return 0;
187 
188  start = avio_tell(s->pb);
189 
190  // header
191  avio_write(s->pb, "APETAGEX", 8); // id
192  avio_wl32 (s->pb, APE_TAG_VERSION); // version
193  avio_wl32(s->pb, 0); // reserve space for size
194  avio_wl32(s->pb, 0); // reserve space for tag count
195 
196  // flags
199  ffio_fill(s->pb, 0, 8); // reserved
200 
201  while ((e = av_dict_get(s->metadata, "", e, AV_DICT_IGNORE_SUFFIX))) {
202  int val_len = strlen(e->value);
203 
204  avio_wl32(s->pb, val_len); // value length
205  avio_wl32(s->pb, 0); // item flags
206  avio_put_str(s->pb, e->key); // key
207  avio_write(s->pb, e->value, val_len); // value
208  count++;
209  }
210 
211  size = avio_tell(s->pb) - start;
212 
213  // footer
214  avio_write(s->pb, "APETAGEX", 8); // id
215  avio_wl32 (s->pb, APE_TAG_VERSION); // version
216  avio_wl32(s->pb, size); // size
217  avio_wl32(s->pb, count); // tag count
218 
219  // flags
221  ffio_fill(s->pb, 0, 8); // reserved
222 
223  // update values in the header
224  end = avio_tell(s->pb);
225  avio_seek(s->pb, start + 12, SEEK_SET);
226  avio_wl32(s->pb, size);
227  avio_wl32(s->pb, count);
228  avio_seek(s->pb, end, SEEK_SET);
229 
230  return 0;
231 }
void * av_malloc(size_t size)
Allocate a block of size bytes with alignment suitable for all memory accesses (including vectors if ...
Definition: mem.c:62
Bytestream IO Context.
Definition: avio.h:68
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:54
int64_t avio_size(AVIOContext *s)
Get the filesize.
Definition: aviobuf.c:241
int size
enum AVCodecID id
Definition: mxfenc.c:84
#define AV_LOG_WARNING
Something somehow does not look correct.
Definition: log.h:129
#define APE_TAG_FLAG_CONTAINS_FOOTER
Definition: apetag.c:35
int index
stream index in AVFormatContext
Definition: avformat.h:700
int64_t avio_seek(AVIOContext *s, int64_t offset, int whence)
fseek() equivalent for AVIOContext.
Definition: aviobuf.c:186
void av_freep(void *arg)
Free a memory block which has been allocated with av_malloc(z)() or av_realloc() and set the pointer ...
Definition: mem.c:198
Format I/O context.
Definition: avformat.h:922
Public dictionary API.
void avio_wl32(AVIOContext *s, unsigned int val)
Definition: aviobuf.c:271
uint8_t
uint8_t * extradata
some codecs need / can use extradata like Huffman tables.
Definition: avcodec.h:1164
AVStream * avformat_new_stream(AVFormatContext *s, const AVCodec *c)
Add a new stream to a media file.
Definition: utils.c:2521
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:38
static int flags
Definition: log.c:44
int av_get_packet(AVIOContext *s, AVPacket *pkt, int size)
Allocate and read the payload of a packet and initialize its fields with default values.
Definition: utils.c:117
static av_always_inline int64_t avio_tell(AVIOContext *s)
ftell() equivalent for AVIOContext.
Definition: avio.h:219
void avio_write(AVIOContext *s, const unsigned char *buf, int size)
Definition: aviobuf.c:165
int avio_read(AVIOContext *s, unsigned char *buf, int size)
Read size bytes from AVIOContext into buf.
Definition: aviobuf.c:463
#define AV_PKT_FLAG_KEY
The packet contains a keyframe.
Definition: avcodec.h:1019
AVCodecID
Identify the syntax and semantics of the bitstream.
Definition: avcodec.h:105
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:123
AVDictionary * metadata
Metadata that applies to the whole file.
Definition: avformat.h:1130
void av_free(void *ptr)
Free a memory block which has been allocated with av_malloc(z)() or av_realloc(). ...
Definition: mem.c:186
unsigned int avio_rl32(AVIOContext *s)
Definition: aviobuf.c:575
#define AVERROR(e)
Definition: error.h:43
void av_log(void *avcl, int level, const char *fmt,...)
Definition: log.c:169
int64_t ff_ape_parse_tag(AVFormatContext *s)
Read and parse an APE tag.
Definition: apetag.c:122
int flags
A combination of AV_PKT_FLAG values.
Definition: avcodec.h:979
int avio_r8(AVIOContext *s)
Definition: aviobuf.c:454
AVCodecContext * codec
Codec context associated with this stream.
Definition: avformat.h:718
#define FF_INPUT_BUFFER_PADDING_SIZE
Required number of additionally allocated bytes at the end of the input bitstream for decoding...
Definition: avcodec.h:531
int seekable
A combination of AVIO_SEEKABLE_ flags or 0 when the stream is not seekable.
Definition: avio.h:117
void ffio_fill(AVIOContext *s, int b, int count)
Definition: aviobuf.c:151
#define AV_DICT_DONT_STRDUP_VAL
Take ownership of a value that's been allocated with av_malloc() and chilren.
Definition: dict.h:66
#define APE_TAG_FLAG_CONTAINS_HEADER
Definition: apetag.c:34
#define APE_TAG_FLAG_IS_BINARY
Definition: apetag.c:37
AVDictionary * metadata
Definition: avformat.h:771
Opaque data information usually sparse.
Definition: avutil.h:191
#define AV_DISPOSITION_ATTACHED_PIC
The stream is stored in the file as an attached picture/"cover art" (e.g.
Definition: avformat.h:690
int avio_put_str(AVIOContext *s, const char *str)
Write a NULL-terminated string.
Definition: aviobuf.c:287
Stream structure.
Definition: avformat.h:699
NULL
Definition: eval.c:55
enum AVMediaType codec_type
Definition: avcodec.h:1058
#define APE_TAG_FOOTER_BYTES
Definition: apetag.c:33
enum AVCodecID codec_id
Definition: avcodec.h:1067
AVIOContext * pb
I/O context.
Definition: avformat.h:964
int extradata_size
Definition: avcodec.h:1165
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:68
int ff_ape_write_tag(AVFormatContext *s)
Write an APE tag into a file.
Definition: apetag.c:179
#define APE_TAG_FLAG_IS_HEADER
Definition: apetag.c:36
Main libavformat public API header.
int disposition
AV_DISPOSITION_* bit field.
Definition: avformat.h:760
char * key
Definition: dict.h:75
enum AVCodecID ff_guess_image2_codec(const char *filename)
Definition: img2.c:97
char * value
Definition: dict.h:76
static int ape_tag_read_field(AVFormatContext *s)
Definition: apetag.c:39
#define AV_DICT_IGNORE_SUFFIX
Definition: dict.h:62
int avio_get_str(AVIOContext *pb, int maxlen, char *buf, int buflen)
Read a string from pb into buf.
Definition: aviobuf.c:629
int stream_index
Definition: avcodec.h:975
#define APE_TAG_VERSION
Definition: apetag.c:32
This structure stores compressed data.
Definition: avcodec.h:950
AVPacket attached_pic
For streams with AV_DISPOSITION_ATTACHED_PIC disposition, this packet will contain the attached pictu...
Definition: avformat.h:789