id3.h

   1 /*
   2  * Copyright 2005 Timo Hirvonen
   3  */
   4
   5 #ifndef _ID3_H
   6 #define _ID3_H
   7
   8 #include <string.h>
   9
  10 /* flags for id3_read_tags */
  11 #define ID3_V1  (1 << 0)
  12 #define ID3_V2  (1 << 1)
  13
  14 enum id3_key {
  15         ID3_ARTIST,
  16         ID3_ALBUM,
  17         ID3_TITLE,
  18         ID3_DATE,
  19         ID3_GENRE,
  20         ID3_DISC,
  21         ID3_TRACK,
  22         ID3_ALBUMARTIST,
  23         ID3_ARTISTSORT,
  24         ID3_ALBUMARTISTSORT,
  25         ID3_COMPILATION,
  26         ID3_RG_TRACK_GAIN,
  27         ID3_RG_TRACK_PEAK,
  28         ID3_RG_ALBUM_GAIN,
  29         ID3_RG_ALBUM_PEAK,
  30         ID3_COMMENT,
  31         NUM_ID3_KEYS
  32 };
  33
  34 struct id3tag {
  35         char v1[128];
  36         char *v2[NUM_ID3_KEYS];
  37
  38         unsigned int has_v1 : 1;
  39         unsigned int has_v2 : 1;
  40 };
  41
  42 #define UTF16_IS_LSURROGATE(uch) (0xdc00 <= uch && 0xdfff >= uch)
  43 #define UTF16_IS_HSURROGATE(uch) (0xd800 <= uch && 0xdbff >= uch)
  44 #define UTF16_IS_BOM(uch) (uch == 0xfeff)
  45
  46 extern const char * const id3_key_names[NUM_ID3_KEYS];
  47
  48 int id3_tag_size(const char *buf, int buf_size);
  49
  50 static inline void id3_init(struct id3tag *id3)
  51 {
  52         memset(id3, 0, sizeof(*id3));
  53 }
  54
  55 void id3_free(struct id3tag *id3);
  56 int id3_read_tags(struct id3tag *id3, int fd, unsigned int flags);
  57 char *id3_get_comment(struct id3tag *id3, enum id3_key key);
  58
  59 #endif