git.sesse.net Git - vlc/blob - include/vlc_meta.h

   1 /*****************************************************************************
   2  * vlc_meta.h: Stream meta-data
   3  *****************************************************************************
   4  * Copyright (C) 2004 the VideoLAN team
   5  * $Id$
   6  *
   7  * Authors: Laurent Aimar <fenrir@via.ecp.fr>
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License as published by
  11  * the Free Software Foundation; either version 2 of the License, or
  12  * (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public License
  20  * along with this program; if not, write to the Free Software
  21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  22  *****************************************************************************/
  23
  24 #ifndef VLC_META_H
  25 #define VLC_META_H 1
  26
  27 /**
  28  * \file
  29  * This file defines functions and structures for stream meta-data in vlc
  30  *
  31  */
  32
  33 typedef enum vlc_meta_type_t
  34 {
  35     vlc_meta_Title,
  36     vlc_meta_Artist,
  37     vlc_meta_Genre,
  38     vlc_meta_Copyright,
  39     vlc_meta_Album,
  40     vlc_meta_TrackNumber,
  41     vlc_meta_Description,
  42     vlc_meta_Rating,
  43     vlc_meta_Date,
  44     vlc_meta_Setting,
  45     vlc_meta_URL,
  46     vlc_meta_Language,
  47     vlc_meta_NowPlaying,
  48     vlc_meta_Publisher,
  49     vlc_meta_EncodedBy,
  50     vlc_meta_ArtworkURL,
  51     vlc_meta_TrackID
  52 } vlc_meta_type_t;
  53
  54 #define VLC_META_TYPE_COUNT 17
  55
  56 typedef enum vlc_meta_status_e {
  57     ITEM_PREPARSED      = 1,
  58     ITEM_ARTURL_FETCHED = 2,
  59     ITEM_ART_FETCHED    = 4,
  60     ITEM_ART_NOTFOUND   = 8
  61 } vlc_meta_status_e;
  62
  63 /**
  64  * Basic function to deal with meta
  65  */
  66 struct vlc_meta_t;
  67
  68 VLC_EXPORT(vlc_meta_t *, vlc_meta_New, ( void ));
  69 VLC_EXPORT(void,         vlc_meta_Delete, ( vlc_meta_t *m ));
  70 VLC_EXPORT(void,         vlc_meta_Set, ( vlc_meta_t *p_meta, vlc_meta_type_t meta_type, const char *psz_val ));
  71 VLC_EXPORT(const char *, vlc_meta_Get, ( const vlc_meta_t *p_meta, vlc_meta_type_t meta_type ));
  72
  73 VLC_EXPORT(void,         vlc_meta_AddExtra, ( vlc_meta_t *m, const char *psz_name, const char *psz_value ));
  74 VLC_EXPORT(const char *, vlc_meta_GetExtra, ( const vlc_meta_t *m, const char *psz_name ));
  75 VLC_EXPORT(unsigned,     vlc_meta_GetExtraCount, ( const vlc_meta_t *m ));
  76
  77 /**
  78  * Allocate a copy of all extra meta names and a table with it.
  79  * Be sure to free both the returned pointers and its name.
  80  */
  81 VLC_EXPORT(char **,      vlc_meta_CopyExtraNames, ( const vlc_meta_t *m ));
  82
  83 VLC_EXPORT(void,         vlc_meta_Merge, ( vlc_meta_t *dst, const vlc_meta_t *src ));
  84
  85 VLC_EXPORT(vlc_meta_status_e, vlc_meta_GetStatus, ( vlc_meta_t *m ));
  86 VLC_EXPORT(void,              vlc_meta_SetStatus, ( vlc_meta_t *m, vlc_meta_status_e status ));
  87
  88 /**
  89  * Returns a localizes string describing the meta
  90  */
  91 VLC_EXPORT(const char *, vlc_meta_TypeToLocalizedString, ( vlc_meta_type_t meta_type ) );
  92
  93 enum {
  94     ALBUM_ART_WHEN_ASKED,
  95     ALBUM_ART_WHEN_PLAYED,
  96     ALBUM_ART_ALL
  97 };
  98
  99
 100 typedef struct meta_export_t
 101 {
 102     VLC_COMMON_MEMBERS
 103     input_item_t *p_item;
 104     const char *psz_file;
 105 } meta_export_t;
 106
 107 VLC_EXPORT( int, input_item_WriteMeta, (vlc_object_t *, input_item_t *) );
 108
 109 /* Setters for meta.
 110  * Warning: Make sure to use the input_item meta setters (defined in vlc_input.h)
 111  * instead of those one. */
 112 #define vlc_meta_SetTitle( meta, b )       vlc_meta_Set( meta, vlc_meta_Title, b )
 113 #define vlc_meta_SetArtist( meta, b )      vlc_meta_Set( meta, vlc_meta_Artist, b )
 114 #define vlc_meta_SetGenre( meta, b )       vlc_meta_Set( meta, vlc_meta_Genre, b )
 115 #define vlc_meta_SetCopyright( meta, b )   vlc_meta_Set( meta, vlc_meta_Copyright, b )
 116 #define vlc_meta_SetAlbum( meta, b )       vlc_meta_Set( meta, vlc_meta_Album, b )
 117 #define vlc_meta_SetTrackNum( meta, b )    vlc_meta_Set( meta, vlc_meta_TrackNumber, b )
 118 #define vlc_meta_SetDescription( meta, b ) vlc_meta_Set( meta, vlc_meta_Description, b )
 119 #define vlc_meta_SetRating( meta, b )      vlc_meta_Set( meta, vlc_meta_Rating, b )
 120 #define vlc_meta_SetDate( meta, b )        vlc_meta_Set( meta, vlc_meta_Date, b )
 121 #define vlc_meta_SetSetting( meta, b )     vlc_meta_Set( meta, vlc_meta_Setting, b )
 122 #define vlc_meta_SetURL( meta, b )         vlc_meta_Set( meta, vlc_meta_URL, b )
 123 #define vlc_meta_SetLanguage( meta, b )    vlc_meta_Set( meta, vlc_meta_Language, b )
 124 #define vlc_meta_SetNowPlaying( meta, b )  vlc_meta_Set( meta, vlc_meta_NowPlaying, b )
 125 #define vlc_meta_SetPublisher( meta, b )   vlc_meta_Set( meta, vlc_meta_Publisher, b )
 126 #define vlc_meta_SetEncodedBy( meta, b )   vlc_meta_Set( meta, vlc_meta_EncodedBy, b )
 127 #define vlc_meta_SetArtURL( meta, b )      vlc_meta_Set( meta, vlc_meta_ArtworkURL, b )
 128 #define vlc_meta_SetTrackID( meta, b )     vlc_meta_Set( meta, vlc_meta_TrackID, b )
 129
 130 #define VLC_META_TITLE              vlc_meta_TypeToLocalizedString( vlc_meta_Title )
 131 #define VLC_META_ARTIST             vlc_meta_TypeToLocalizedString( vlc_meta_Artist )
 132 #define VLC_META_GENRE              vlc_meta_TypeToLocalizedString( vlc_meta_Genre )
 133 #define VLC_META_COPYRIGHT          vlc_meta_TypeToLocalizedString( vlc_meta_Copyright )
 134 #define VLC_META_ALBUM              vlc_meta_TypeToLocalizedString( vlc_meta_Album )
 135 #define VLC_META_TRACK_NUMBER       vlc_meta_TypeToLocalizedString( vlc_meta_TrackNumber )
 136 #define VLC_META_DESCRIPTION        vlc_meta_TypeToLocalizedString( vlc_meta_Description )
 137 #define VLC_META_RATING             vlc_meta_TypeToLocalizedString( vlc_meta_Rating )
 138 #define VLC_META_DATE               vlc_meta_TypeToLocalizedString( vlc_meta_Date )
 139 #define VLC_META_SETTING            vlc_meta_TypeToLocalizedString( vlc_meta_Setting )
 140 #define VLC_META_URL                vlc_meta_TypeToLocalizedString( vlc_meta_URL )
 141 #define VLC_META_LANGUAGE           vlc_meta_TypeToLocalizedString( vlc_meta_Language )
 142 #define VLC_META_NOW_PLAYING        vlc_meta_TypeToLocalizedString( vlc_meta_NowPlaying )
 143 #define VLC_META_PUBLISHER          vlc_meta_TypeToLocalizedString( vlc_meta_Publisher )
 144 #define VLC_META_ENCODED_BY         vlc_meta_TypeToLocalizedString( vlc_meta_EncodedBy )
 145 #define VLC_META_ART_URL            vlc_meta_TypeToLocalizedString( vlc_meta_ArtworkURL )
 146 #define VLC_META_TRACKID            vlc_meta_TypeToLocalizedString( vlc_meta_TrackID )
 147
 148
 149 #endif