id3v2.h
Go to the documentation of this file.
1 /*
2  * ID3v2 header parser
3  * Copyright (c) 2003 Fabrice Bellard
4  *
5  * This file is part of Libav.
6  *
7  * Libav 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  * Libav 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 Libav; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20  */
21 
22 #ifndef AVFORMAT_ID3V2_H
23 #define AVFORMAT_ID3V2_H
24 
25 #include <stdint.h>
26 #include "avformat.h"
27 #include "internal.h"
28 #include "metadata.h"
29 
30 #define ID3v2_HEADER_SIZE 10
31 
35 #define ID3v2_DEFAULT_MAGIC "ID3"
36 
37 #define ID3v2_FLAG_DATALEN 0x0001
38 #define ID3v2_FLAG_UNSYNCH 0x0002
39 #define ID3v2_FLAG_ENCRYPTION 0x0004
40 #define ID3v2_FLAG_COMPRESSION 0x0008
41 
47 };
48 
49 typedef struct ID3v2EncContext {
50  int version;
51  int64_t size_pos;
52  int len;
54 
55 typedef struct ID3v2ExtraMeta {
56  const char *tag;
57  void *data;
60 
61 typedef struct ID3v2ExtraMetaGEOB {
62  uint32_t datasize;
68 
69 typedef struct ID3v2ExtraMetaAPIC {
71  int len;
72  const char *type;
74  enum AVCodecID id;
76 
83 int ff_id3v2_match(const uint8_t *buf, const char *magic);
84 
90 int ff_id3v2_tag_len(const uint8_t *buf);
91 
97 void ff_id3v2_read(AVFormatContext *s, const char *magic, ID3v2ExtraMeta **extra_meta);
98 
102 void ff_id3v2_start(ID3v2EncContext *id3, AVIOContext *pb, int id3v2_version,
103  const char *magic);
104 
109 
114 
119 
126 int ff_id3v2_write_simple(struct AVFormatContext *s, int id3v2_version, const char *magic);
127 
132 void ff_id3v2_free_extra_meta(ID3v2ExtraMeta **extra_meta);
133 
139 
142 
148 extern const char ff_id3v2_tags[][4];
149 
153 extern const char ff_id3v2_4_tags[][4];
154 
158 extern const char ff_id3v2_3_tags[][4];
159 
160 extern const CodecMime ff_id3v2_mime_tags[];
161 
162 extern const char *ff_id3v2_picture_types[21];
163 
164 #endif /* AVFORMAT_ID3V2_H */