1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
|
/* Copyright (C) 2001--2005 Chris Vaill
This file is part of nid3lib.
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA*/
#ifndef _ID3_H_
#define _ID3_H_
typedef struct id3_struct *id3_t;
typedef struct id3_frame_struct *id3_frame_t;
enum {
ID3_RDONLY,
ID3_RDWR
};
/* text encoding codes */
enum id3_text_encoding {
ID3_TEXT_ISO = 0,
ID3_TEXT_UTF16 = 1,
ID3_TEXT_UTF16BE = 2,
ID3_TEXT_UTF8 = 3
};
/* tag version codes */
enum id3_version {
ID3_VERSION_NONE,
ID3_VERSION_1, /* ID3v1 not implemented */
ID3_VERSION_2_2,
ID3_VERSION_2_3,
ID3_VERSION_2_4
};
/* padding policy codes */
enum id3_pad_policy {
/* use existing padding, double tag size if necessary */
ID3_PADDING_DEFAULT,
/* remove all padding */
ID3_PADDING_NONE,
/* user sets exact size of tag */
ID3_PADDING_CUSTOM
};
/* frame flags */
enum id3_fflag {
ID3_FFLAG_TAGALTER_PRESERVE = 0,
ID3_FFLAG_FILEALTER_PRESERVE = 1,
ID3_FFLAG_READONLY = 2,
ID3_FFLAG_HAS_GROUPID = 3,
ID3_FFLAG_IS_COMPRESSED = 4,
ID3_FFLAG_IS_ENCRYPTED = 5,
ID3_FFLAG_IS_UNSYNCED = 6,
ID3_FFLAG_HAS_DATALEN = 7
};
/*
* frame-specific flags
*/
/* for RVA2 */
enum id3_rva_channel {
ID3_CHANNEL_OTHER = 0x00,
ID3_CHANNEL_MASTER = 0x01, /* master volume */
ID3_CHANNEL_FRIGHT = 0x02, /* front right */
ID3_CHANNEL_FLEFT = 0x03, /* front left */
ID3_CHANNEL_BRIGHT = 0x04, /* back right */
ID3_CHANNEL_BLEFT = 0x05, /* back left */
ID3_CHANNEL_FCENTER = 0x06, /* front center */
ID3_CHANNEL_BCENTER = 0x07, /* back center */
ID3_CHANNEL_SUB = 0x08, /* subwoofer */
ID3_CHANNEL_ANY = 0xFF
};
struct id3_rva_t {
enum id3_rva_channel channel;
float adjustment;
unsigned char peak_bits;
unsigned char peak[1];
};
/*
* Function prototypes
*/
id3_t id3_open(const char *fname, int mode);
int id3_close(id3_t id3);
int id3_get_size(id3_t id3);
void id3_set_size(id3_t id3, int size);
int id3_set_version(id3_t tag, enum id3_version ver);
enum id3_version id3_get_version(id3_t tag);
void id3_set_pad_policy(id3_t tag, enum id3_pad_policy policy);
enum id3_pad_policy id3_get_pad_policy(id3_t tag);
int id3_frame_count(id3_t id3);
id3_frame_t id3_get_frame(id3_t id3, int index);
id3_frame_t id3_get_frame_by_id(id3_t tag, const char *id);
int id3_set_append(id3_t tag, int append);
int id3_set_unsync(id3_t tag, int unsync);
int id3_frame_get_size(id3_frame_t f);
char *id3_frame_get_id(id3_frame_t f);
int id3_frame_set_id(id3_frame_t f, const char *id);
void *id3_frame_get_raw(id3_frame_t f);
int id3_frame_set_raw(id3_frame_t f, void *buf, int size);
int id3_frame_get_flag(id3_frame_t f, enum id3_fflag flg);
void id3_frame_set_flag(id3_frame_t f, enum id3_fflag flg);
void id3_frame_clear_flag(id3_frame_t f, enum id3_fflag flg);
void id3_frame_delete(id3_frame_t f);
id3_frame_t id3_frame_add(id3_t id3, const char *id);
int id3_frame_text_enc(id3_frame_t f);
char *id3_frame_text(id3_frame_t f);
int id3_frame_save_image(id3_frame_t f, const char *fname);
int id3_write(id3_t id3);
void id3_strip(id3_t id3);
id3_frame_t id3_add_text_frame(id3_t id3, const char *id, const char *text, int encoding);
char *id3_title_get(id3_t tag);
int id3_title_set(id3_t tag, const char *s, enum id3_text_encoding enc);
char *id3_artist_get(id3_t tag);
int id3_artist_set(id3_t tag, const char *s, enum id3_text_encoding enc);
char *id3_album_get(id3_t tag);
int id3_album_set(id3_t tag, const char *s, enum id3_text_encoding enc);
char *id3_genre_get(id3_t tag);
int id3_genre_set(id3_t tag, const char *s, enum id3_text_encoding enc);
char *id3_date_get(id3_t tag);
int id3_date_set(id3_t tag, const char *s, enum id3_text_encoding enc);
char *id3_tracknum_get(id3_t tag);
int id3_tracknum_set(id3_t tag, const char *s, enum id3_text_encoding enc);
char *id3_comment_get(id3_t tag, const char *desc, const char *lang);
int id3_comment_set(id3_t tag, const char *text, const char *desc,
const char *lang, enum id3_text_encoding enc);
float id3_rva_get(id3_t tag, const char *ident, enum id3_rva_channel channel);
int id3_rva_set(id3_t tag, const char *ident,
enum id3_rva_channel channel, float adjust);
const char *id3_id_description(const char *id);
const char *id3_genre_name(int genre);
int id3_genre_number(const char *desc);
#endif
|
