apps/metadata.h

   1 /***************************************************************************
   2  *             __________               __   ___.
   3  *   Open      \______   \ ____   ____ |  | _\_ |__   _______  ___
   4  *   Source     |       _//  _ \_/ ___\|  |/ /| __ \ /  _ \  \/  /
   5  *   Jukebox    |    |   (  <_> )  \___|    < | \_\ (  <_> > <  <
   6  *   Firmware   |____|_  /\____/ \___  >__|_ \|___  /\____/__/\_ \
   7  *                     \/            \/     \/    \/            \/
   8  * $Id$
   9  *
  10  * Copyright (C) 2005 Dave Chapman
  11  *
  12  * This program is free software; you can redistribute it and/or
  13  * modify it under the terms of the GNU General Public License
  14  * as published by the Free Software Foundation; either version 2
  15  * of the License, or (at your option) any later version.
  16  *
  17  * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
  18  * KIND, either express or implied.
  19  *
  20  ****************************************************************************/
  21
  22 #ifndef _METADATA_H
  23 #define _METADATA_H
  24
  25 #include <stdbool.h>
  26 #include "file.h"
  27 #include "config.h"
  28
  29
  30 /* Audio file types. */
  31 /* NOTE: The values of the AFMT_* items are used for the %fc tag in the WPS
  32          - so new entries MUST be added to the end to maintain compatibility.
  33  */
  34 enum
  35 {
  36     AFMT_UNKNOWN = 0,  /* Unknown file format */
  37
  38     /* start formats */
  39
  40     AFMT_MPA_L1,       /* MPEG Audio layer 1 */
  41     AFMT_MPA_L2,       /* MPEG Audio layer 2 */
  42     AFMT_MPA_L3,       /* MPEG Audio layer 3 */
  43
  44 #if CONFIG_CODEC == SWCODEC
  45     AFMT_AIFF,         /* Audio Interchange File Format */
  46     AFMT_PCM_WAV,      /* Uncompressed PCM in a WAV file */
  47     AFMT_OGG_VORBIS,   /* Ogg Vorbis */
  48     AFMT_FLAC,         /* FLAC */
  49     AFMT_MPC,          /* Musepack */
  50     AFMT_A52,          /* A/52 (aka AC3) audio */
  51     AFMT_WAVPACK,      /* WavPack */
  52     AFMT_MP4_ALAC,     /* Apple Lossless Audio Codec */
  53     AFMT_MP4_AAC,      /* Advanced Audio Coding (AAC) in M4A container */
  54     AFMT_SHN,          /* Shorten */
  55     AFMT_SID,          /* SID File Format */
  56     AFMT_ADX,          /* ADX File Format */
  57     AFMT_NSF,          /* NESM (NES Sound Format) */
  58     AFMT_SPEEX,        /* Ogg Speex speech */
  59     AFMT_SPC,          /* SPC700 save state */
  60     AFMT_APE,          /* Monkey's Audio (APE) */
  61     AFMT_WMA,          /* WMAV1/V2 in ASF */
  62     AFMT_MOD,          /* Amiga MOD File Format */
  63     AFMT_SAP,          /* Amiga 8Bit SAP Format */
  64     AFMT_RM_COOK,      /* Cook in RM/RA */
  65     AFMT_RM_AAC,       /* AAC in RM/RA */
  66     AFMT_RM_AC3,       /* AC3 in RM/RA */
  67 #endif
  68
  69     /* add new formats at any index above this line to have a sensible order -
  70        specified array index inits are used */
  71     /* format arrays defined in id3.c */
  72
  73     AFMT_NUM_CODECS,
  74
  75 #if CONFIG_CODEC == SWCODEC && defined(HAVE_RECORDING)
  76     /* masks to decompose parts */
  77     CODEC_AFMT_MASK    = 0x0fff,
  78     CODEC_TYPE_MASK    = 0x7000,
  79
  80     /* switch for specifying codec type when requesting a filename */
  81     CODEC_TYPE_DECODER = (0 << 12), /* default */
  82     CODEC_TYPE_ENCODER = (1 << 12),
  83 #endif /* CONFIG_CODEC == SWCODEC && defined(HAVE_RECORDING) */
  84 };
  85
  86 #if CONFIG_CODEC == SWCODEC
  87 #define CODEC_EXTENSION "codec"
  88
  89 #ifdef HAVE_RECORDING
  90 #define ENCODER_SUFFIX  "_enc"
  91 enum rec_format_indexes
  92 {
  93     __REC_FORMAT_START_INDEX = -1,
  94
  95     /* start formats */
  96
  97     REC_FORMAT_PCM_WAV,
  98     REC_FORMAT_AIFF,
  99     REC_FORMAT_WAVPACK,
 100     REC_FORMAT_MPA_L3,
 101
 102     /* add new formats at any index above this line to have a sensible order -
 103        specified array index inits are used
 104        REC_FORMAT_CFG_NUM_BITS should allocate enough bits to hold the range
 105        REC_FORMAT_CFG_VALUE_LIST should be in same order as indexes
 106     */
 107
 108     REC_NUM_FORMATS,
 109
 110     REC_FORMAT_DEFAULT = REC_FORMAT_PCM_WAV,
 111     REC_FORMAT_CFG_NUM_BITS = 2
 112 };
 113
 114 #define REC_FORMAT_CFG_VAL_LIST "wave,aiff,wvpk,mpa3"
 115
 116 /* get REC_FORMAT_* corresponding AFMT_* */
 117 extern const int rec_format_afmt[REC_NUM_FORMATS];
 118 /* get AFMT_* corresponding REC_FORMAT_* */
 119 extern const int afmt_rec_format[AFMT_NUM_CODECS];
 120
 121 #define AFMT_ENTRY(label, root_fname, enc_root_fname, ext_list) \
 122     { label, root_fname, enc_root_fname, ext_list }
 123 #else /* !HAVE_RECORDING */
 124 #define AFMT_ENTRY(label, root_fname, enc_root_fname, ext_list) \
 125     { label, root_fname, ext_list }
 126 #endif /* HAVE_RECORDING */
 127
 128 #else /* !SWCODEC */
 129
 130 #define AFMT_ENTRY(label, root_fname, enc_root_fname, ext_list) \
 131     { label, ext_list }
 132 #endif /* CONFIG_CODEC == SWCODEC */
 133
 134 /** Database of audio formats **/
 135 /* record describing the audio format */
 136 struct afmt_entry
 137 {
 138     char label[8];      /* format label */
 139 #if CONFIG_CODEC == SWCODEC
 140     char *codec_root_fn; /* root codec filename (sans _enc and .codec) */
 141 #ifdef HAVE_RECORDING
 142     char *codec_enc_root_fn; /* filename of encoder codec */
 143 #endif
 144 #endif
 145     char *ext_list;     /* double NULL terminated extension
 146                            list for type with the first as
 147                            the default for recording */
 148 };
 149
 150 /* database of labels and codecs. add formats per above enum */
 151 extern const struct afmt_entry audio_formats[AFMT_NUM_CODECS];
 152
 153 #if MEMORYSIZE > 2
 154 #define ID3V2_BUF_SIZE 900
 155 #else
 156 #define ID3V2_BUF_SIZE 300
 157 #endif
 158
 159 enum {
 160     ID3_VER_1_0 = 1,
 161     ID3_VER_1_1,
 162     ID3_VER_2_2,
 163     ID3_VER_2_3,
 164     ID3_VER_2_4
 165 };
 166
 167 struct mp3entry {
 168     char path[MAX_PATH];
 169     char* title;
 170     char* artist;
 171     char* album;
 172     char* genre_string;
 173     char* disc_string;
 174     char* track_string;
 175     char* year_string;
 176     char* composer;
 177     char* comment;
 178     char* albumartist;
 179     char* grouping;
 180     int discnum;
 181     int tracknum;
 182     int version;
 183     int layer;
 184     int year;
 185     unsigned char id3version;
 186     unsigned int codectype;
 187     unsigned int bitrate;
 188     unsigned long frequency;
 189     unsigned long id3v2len;
 190     unsigned long id3v1len;
 191     unsigned long first_frame_offset; /* Byte offset to first real MP3 frame.
 192                                          Used for skipping leading garbage to
 193                                          avoid gaps between tracks. */
 194     unsigned long vbr_header_pos;
 195     unsigned long filesize; /* without headers; in bytes */
 196     unsigned long length;   /* song length in ms */
 197     unsigned long elapsed;  /* ms played */
 198
 199     int lead_trim;          /* Number of samples to skip at the beginning */
 200     int tail_trim;          /* Number of samples to remove from the end */
 201
 202     /* Added for Vorbis */
 203     unsigned long samples;  /* number of samples in track */
 204
 205     /* MP3 stream specific info */
 206     unsigned long frame_count; /* number of frames in the file (if VBR) */
 207
 208     /* Used for A52/AC3 */
 209     unsigned long bytesperframe; /* number of bytes per frame (if CBR) */
 210
 211     /* Xing VBR fields */
 212     bool vbr;
 213     bool has_toc;           /* True if there is a VBR header in the file */
 214     unsigned char toc[100]; /* table of contents */
 215
 216     /* these following two fields are used for local buffering */
 217     char id3v2buf[ID3V2_BUF_SIZE];
 218     char id3v1buf[4][92];
 219
 220     /* resume related */
 221     unsigned long offset;  /* bytes played */
 222     int index;             /* playlist index */
 223
 224     /* runtime database fields */
 225     long tagcache_idx;     /* 0=invalid, otherwise idx+1 */
 226     int rating;
 227     int score;
 228     long playcount;
 229     long lastplayed;
 230     long playtime;
 231
 232     /* replaygain support */
 233
 234 #if CONFIG_CODEC == SWCODEC
 235     char* track_gain_string;
 236     char* album_gain_string;
 237     long track_gain;    /* 7.24 signed fixed point. 0 for no gain. */
 238     long album_gain;
 239     long track_peak;    /* 7.24 signed fixed point. 0 for no peak. */
 240     long album_peak;
 241 #endif
 242
 243     /* Cuesheet support */
 244     struct cuesheet *cuesheet;
 245
 246     /* Musicbrainz Track ID */
 247     char* mb_track_id;
 248 };
 249
 250 unsigned int probe_file_format(const char *filename);
 251 bool get_metadata(struct mp3entry* id3, int fd, const char* trackname);
 252 bool mp3info(struct mp3entry *entry, const char *filename);
 253 void adjust_mp3entry(struct mp3entry *entry, void *dest, const void *orig);
 254 void copy_mp3entry(struct mp3entry *dest, const struct mp3entry *orig);
 255 #if CONFIG_CODEC == SWCODEC
 256 void strip_tags(int handle_id);
 257 #endif
 258
 259 #endif
 260
 261