This file defines functions and structures for stream meta-data in vlc. More...

Data Structures
struct	meta_export_t
Defines
#define	VLC_META_TYPE_COUNT 17
#define	ITEM_PREPARSED 1
#define	ITEM_ARTURL_FETCHED 2
#define	ITEM_ART_FETCHED 4
#define	ITEM_ART_NOTFOUND 8
#define	vlc_meta_SetTitle(meta, b) vlc_meta_Set( meta, vlc_meta_Title, b )
#define	vlc_meta_SetArtist(meta, b) vlc_meta_Set( meta, vlc_meta_Artist, b )
#define	vlc_meta_SetGenre(meta, b) vlc_meta_Set( meta, vlc_meta_Genre, b )
#define	vlc_meta_SetCopyright(meta, b) vlc_meta_Set( meta, vlc_meta_Copyright, b )
#define	vlc_meta_SetAlbum(meta, b) vlc_meta_Set( meta, vlc_meta_Album, b )
#define	vlc_meta_SetTrackNum(meta, b) vlc_meta_Set( meta, vlc_meta_TrackNumber, b )
#define	vlc_meta_SetDescription(meta, b) vlc_meta_Set( meta, vlc_meta_Description, b )
#define	vlc_meta_SetRating(meta, b) vlc_meta_Set( meta, vlc_meta_Rating, b )
#define	vlc_meta_SetDate(meta, b) vlc_meta_Set( meta, vlc_meta_Date, b )
#define	vlc_meta_SetSetting(meta, b) vlc_meta_Set( meta, vlc_meta_Setting, b )
#define	vlc_meta_SetURL(meta, b) vlc_meta_Set( meta, vlc_meta_URL, b )
#define	vlc_meta_SetLanguage(meta, b) vlc_meta_Set( meta, vlc_meta_Language, b )
#define	vlc_meta_SetNowPlaying(meta, b) vlc_meta_Set( meta, vlc_meta_NowPlaying, b )
#define	vlc_meta_SetPublisher(meta, b) vlc_meta_Set( meta, vlc_meta_Publisher, b )
#define	vlc_meta_SetEncodedBy(meta, b) vlc_meta_Set( meta, vlc_meta_EncodedBy, b )
#define	vlc_meta_SetArtURL(meta, b) vlc_meta_Set( meta, vlc_meta_ArtworkURL, b )
#define	vlc_meta_SetTrackID(meta, b) vlc_meta_Set( meta, vlc_meta_TrackID, b )
#define	VLC_META_TITLE vlc_meta_TypeToLocalizedString( vlc_meta_Title )
#define	VLC_META_ARTIST vlc_meta_TypeToLocalizedString( vlc_meta_Artist )
#define	VLC_META_GENRE vlc_meta_TypeToLocalizedString( vlc_meta_Genre )
#define	VLC_META_COPYRIGHT vlc_meta_TypeToLocalizedString( vlc_meta_Copyright )
#define	VLC_META_ALBUM vlc_meta_TypeToLocalizedString( vlc_meta_Album )
#define	VLC_META_TRACK_NUMBER vlc_meta_TypeToLocalizedString( vlc_meta_TrackNumber )
#define	VLC_META_DESCRIPTION vlc_meta_TypeToLocalizedString( vlc_meta_Description )
#define	VLC_META_RATING vlc_meta_TypeToLocalizedString( vlc_meta_Rating )
#define	VLC_META_DATE vlc_meta_TypeToLocalizedString( vlc_meta_Date )
#define	VLC_META_SETTING vlc_meta_TypeToLocalizedString( vlc_meta_Setting )
#define	VLC_META_URL vlc_meta_TypeToLocalizedString( vlc_meta_URL )
#define	VLC_META_LANGUAGE vlc_meta_TypeToLocalizedString( vlc_meta_Language )
#define	VLC_META_NOW_PLAYING vlc_meta_TypeToLocalizedString( vlc_meta_NowPlaying )
#define	VLC_META_PUBLISHER vlc_meta_TypeToLocalizedString( vlc_meta_Publisher )
#define	VLC_META_ENCODED_BY vlc_meta_TypeToLocalizedString( vlc_meta_EncodedBy )
#define	VLC_META_ART_URL vlc_meta_TypeToLocalizedString( vlc_meta_ArtworkURL )
#define	VLC_META_TRACKID vlc_meta_TypeToLocalizedString( vlc_meta_TrackID )
Typedefs
typedef enum vlc_meta_type_t	vlc_meta_type_t
typedef struct meta_export_t	meta_export_t
Enumerations
enum	vlc_meta_type_t { vlc_meta_Title, vlc_meta_Artist, vlc_meta_Genre, vlc_meta_Copyright, vlc_meta_Album, vlc_meta_TrackNumber, vlc_meta_Description, vlc_meta_Rating, vlc_meta_Date, vlc_meta_Setting, vlc_meta_URL, vlc_meta_Language, vlc_meta_NowPlaying, vlc_meta_Publisher, vlc_meta_EncodedBy, vlc_meta_ArtworkURL, vlc_meta_TrackID }
enum	{ ALBUM_ART_WHEN_ASKED, ALBUM_ART_WHEN_PLAYED, ALBUM_ART_ALL }
Functions
VLC_API vlc_meta_t *	vlc_meta_New (void) VLC_USED
	vlc_meta contructor.
VLC_API void	vlc_meta_Delete (vlc_meta_t *m)
VLC_API void	vlc_meta_Set (vlc_meta_t p_meta, vlc_meta_type_t meta_type, const char psz_val)
	vlc_meta has two kinds of meta, the one in a table, and the one in a dictionary.
VLC_API const char *	vlc_meta_Get (const vlc_meta_t *p_meta, vlc_meta_type_t meta_type)
VLC_API void	vlc_meta_AddExtra (vlc_meta_t m, const char psz_name, const char *psz_value)
VLC_API const char *	vlc_meta_GetExtra (const vlc_meta_t m, const char psz_name)
VLC_API unsigned	vlc_meta_GetExtraCount (const vlc_meta_t *m)
VLC_API char **	vlc_meta_CopyExtraNames (const vlc_meta_t *m) VLC_USED
	Allocate a copy of all extra meta names and a table with it.
VLC_API void	vlc_meta_Merge (vlc_meta_t dst, const vlc_meta_t src)
	Merging meta.
VLC_API int	vlc_meta_GetStatus (vlc_meta_t *m)
	vlc_meta status (see vlc_meta_status_e)
VLC_API void	vlc_meta_SetStatus (vlc_meta_t *m, int status)
VLC_API const char *	vlc_meta_TypeToLocalizedString (vlc_meta_type_t meta_type)
	Returns a localizes string describing the meta.
VLC_API int	input_item_WriteMeta (vlc_object_t , input_item_t )

Detailed Description

This file defines functions and structures for stream meta-data in vlc.

Define Documentation

#define ITEM_ART_FETCHED 4

#define ITEM_ART_NOTFOUND 8

#define ITEM_ARTURL_FETCHED 2

#define ITEM_PREPARSED 1

#define VLC_META_ALBUM vlc_meta_TypeToLocalizedString( vlc_meta_Album )

#define VLC_META_ART_URL vlc_meta_TypeToLocalizedString( vlc_meta_ArtworkURL )

#define VLC_META_ARTIST vlc_meta_TypeToLocalizedString( vlc_meta_Artist )

#define VLC_META_COPYRIGHT vlc_meta_TypeToLocalizedString( vlc_meta_Copyright )

#define VLC_META_DATE vlc_meta_TypeToLocalizedString( vlc_meta_Date )

#define VLC_META_DESCRIPTION vlc_meta_TypeToLocalizedString( vlc_meta_Description )

#define VLC_META_ENCODED_BY vlc_meta_TypeToLocalizedString( vlc_meta_EncodedBy )

#define VLC_META_GENRE vlc_meta_TypeToLocalizedString( vlc_meta_Genre )

#define VLC_META_LANGUAGE vlc_meta_TypeToLocalizedString( vlc_meta_Language )

#define VLC_META_NOW_PLAYING vlc_meta_TypeToLocalizedString( vlc_meta_NowPlaying )

#define VLC_META_PUBLISHER vlc_meta_TypeToLocalizedString( vlc_meta_Publisher )

#define VLC_META_RATING vlc_meta_TypeToLocalizedString( vlc_meta_Rating )

#define vlc_meta_SetAlbum	(	meta,
		b
	)		vlc_meta_Set( meta, vlc_meta_Album, b )

#define vlc_meta_SetArtist	(	meta,
		b
	)		vlc_meta_Set( meta, vlc_meta_Artist, b )

#define vlc_meta_SetArtURL	(	meta,
		b
	)		vlc_meta_Set( meta, vlc_meta_ArtworkURL, b )

#define vlc_meta_SetCopyright	(	meta,
		b
	)		vlc_meta_Set( meta, vlc_meta_Copyright, b )

#define vlc_meta_SetDate	(	meta,
		b
	)		vlc_meta_Set( meta, vlc_meta_Date, b )

#define vlc_meta_SetDescription	(	meta,
		b
	)		vlc_meta_Set( meta, vlc_meta_Description, b )

#define vlc_meta_SetEncodedBy	(	meta,
		b
	)		vlc_meta_Set( meta, vlc_meta_EncodedBy, b )

#define vlc_meta_SetGenre	(	meta,
		b
	)		vlc_meta_Set( meta, vlc_meta_Genre, b )

#define vlc_meta_SetLanguage	(	meta,
		b
	)		vlc_meta_Set( meta, vlc_meta_Language, b )

#define vlc_meta_SetNowPlaying	(	meta,
		b
	)		vlc_meta_Set( meta, vlc_meta_NowPlaying, b )

#define vlc_meta_SetPublisher	(	meta,
		b
	)		vlc_meta_Set( meta, vlc_meta_Publisher, b )

#define vlc_meta_SetRating	(	meta,
		b
	)		vlc_meta_Set( meta, vlc_meta_Rating, b )

#define vlc_meta_SetSetting	(	meta,
		b
	)		vlc_meta_Set( meta, vlc_meta_Setting, b )

#define VLC_META_SETTING vlc_meta_TypeToLocalizedString( vlc_meta_Setting )

#define vlc_meta_SetTitle	(	meta,
		b
	)		vlc_meta_Set( meta, vlc_meta_Title, b )

#define vlc_meta_SetTrackID	(	meta,
		b
	)		vlc_meta_Set( meta, vlc_meta_TrackID, b )

#define vlc_meta_SetTrackNum	(	meta,
		b
	)		vlc_meta_Set( meta, vlc_meta_TrackNumber, b )

#define vlc_meta_SetURL	(	meta,
		b
	)		vlc_meta_Set( meta, vlc_meta_URL, b )

#define VLC_META_TITLE vlc_meta_TypeToLocalizedString( vlc_meta_Title )

#define VLC_META_TRACK_NUMBER vlc_meta_TypeToLocalizedString( vlc_meta_TrackNumber )

#define VLC_META_TRACKID vlc_meta_TypeToLocalizedString( vlc_meta_TrackID )

#define VLC_META_TYPE_COUNT 17

#define VLC_META_URL vlc_meta_TypeToLocalizedString( vlc_meta_URL )

Typedef Documentation

typedef struct meta_export_t meta_export_t

typedef enum vlc_meta_type_t vlc_meta_type_t

Enumeration Type Documentation

anonymous enum

Enumerator:

ALBUM_ART_WHEN_ASKED
ALBUM_ART_WHEN_PLAYED
ALBUM_ART_ALL

enum vlc_meta_type_t

Enumerator:

vlc_meta_Title
vlc_meta_Artist
vlc_meta_Genre
vlc_meta_Copyright
vlc_meta_Album
vlc_meta_TrackNumber
vlc_meta_Description
vlc_meta_Rating
vlc_meta_Date
vlc_meta_Setting
vlc_meta_URL
vlc_meta_Language
vlc_meta_NowPlaying
vlc_meta_Publisher
vlc_meta_EncodedBy
vlc_meta_ArtworkURL
vlc_meta_TrackID

Function Documentation

VLC_API int input_item_WriteMeta	(	vlc_object_t *	,
		input_item_t *
	)

References input_item_t::i_type, input_item_GetURI(), ITEM_TYPE_FILE, input_item_t::lock, make_path(), module_need, module_unneed, msg_Err, meta_export_t::p_item, meta_export_t::psz_file, vlc_custom_create, vlc_mutex_lock(), vlc_mutex_unlock(), and vlc_object_release.

VLC_API void vlc_meta_AddExtra	(	vlc_meta_t *	m,
		const char *	psz_name,
		const char *	psz_value
	)

References vlc_meta_t::extra_tags, kVLCDictionaryNotFound, strdup(), vlc_dictionary_insert(), vlc_dictionary_remove_value_for_key(), vlc_dictionary_value_for_key(), and vlc_meta_FreeExtraKey().

VLC_API char** vlc_meta_CopyExtraNames ( const vlc_meta_t * m )

Allocate a copy of all extra meta names and a table with it.

Be sure to free both the returned pointers and its name.

References vlc_meta_t::extra_tags, and vlc_dictionary_all_keys().

Referenced by EsOutProgramMeta(), and EsOutUpdateInfo().

VLC_API void vlc_meta_Delete ( vlc_meta_t * m )

References vlc_meta_t::extra_tags, vlc_meta_t::ppsz_meta, vlc_dictionary_clear(), and vlc_meta_FreeExtraKey().

Referenced by CmdCleanControl(), DecoderUpdateFormatLocked(), DeleteDecoder(), demux_PacketizerDestroy(), EsOutSend(), input_item_Clean(), InputSourceMeta(), InputUpdateMeta(), and sout_DeleteInstance().

VLC_API const char* vlc_meta_Get	(	const vlc_meta_t *	p_meta,
		vlc_meta_type_t	meta_type
	)

References vlc_meta_t::ppsz_meta.

Referenced by Art(), ArtCachePath(), EsOutMeta(), EsOutProgramMeta(), input_item_GetMeta(), input_item_GetTitleFbName(), input_item_MetaMatch(), and playlist_LiveSearchUpdateInternal().

VLC_API const char* vlc_meta_GetExtra	(	const vlc_meta_t *	m,
		const char *	psz_name
	)

References vlc_meta_t::extra_tags, and vlc_dictionary_value_for_key().

Referenced by EsOutProgramMeta(), EsOutUpdateInfo(), and vlc_audio_replay_gain_MergeFromMeta().

VLC_API unsigned vlc_meta_GetExtraCount ( const vlc_meta_t * m )

References vlc_meta_t::extra_tags, and vlc_dictionary_keys_count().

Referenced by EsOutProgramMeta().

VLC_API int vlc_meta_GetStatus ( vlc_meta_t * m )

vlc_meta status (see vlc_meta_status_e)

References vlc_meta_t::i_status.

Referenced by input_item_IsArtFetched(), input_item_IsPreparsed(), input_item_SetArtFetched(), input_item_SetArtNotFound(), and input_item_SetPreparsed().

VLC_API void vlc_meta_Merge	(	vlc_meta_t *	dst,
		const vlc_meta_t *	src
	)

Merging meta.

References vlc_meta_t::extra_tags, vlc_meta_t::ppsz_meta, strdup(), vlc_dictionary_all_keys(), vlc_dictionary_insert(), vlc_dictionary_remove_value_for_key(), vlc_dictionary_value_for_key(), and vlc_meta_FreeExtraKey().

Referenced by CmdInitControl(), EsOutMeta(), input_DecoderHasFormatChanged(), input_item_Copy(), and InputSourceMeta().

VLC_API vlc_meta_t* vlc_meta_New ( void )

vlc_meta contructor.

vlc_meta_Delete() will free the returned pointer.

References vlc_meta_t::extra_tags, vlc_meta_t::i_status, vlc_meta_t::ppsz_meta, and vlc_dictionary_init().

Referenced by ArtCachePath(), CmdInitControl(), Control(), Init(), input_DecoderHasFormatChanged(), input_item_Copy(), input_item_SetArtFetched(), input_item_SetArtNotFound(), input_item_SetMeta(), input_item_SetPreparsed(), UpdateGenericFromAccess(), and UpdateGenericFromDemux().

VLC_API void vlc_meta_Set	(	vlc_meta_t *	p_meta,
		vlc_meta_type_t	meta_type,
		const char *	psz_val
	)

vlc_meta has two kinds of meta, the one in a table, and the one in a dictionary.

FIXME - Why don't we merge those two?

References vlc_meta_t::ppsz_meta, and strdup().

Referenced by input_item_SetMeta(), and InputMetaUser().

VLC_API void vlc_meta_SetStatus	(	vlc_meta_t *	m,
		int	status
	)

References vlc_meta_t::i_status.

Referenced by input_item_SetArtFetched(), input_item_SetArtNotFound(), and input_item_SetPreparsed().

VLC_API const char* vlc_meta_TypeToLocalizedString ( vlc_meta_type_t meta_type )

Returns a localizes string describing the meta.

References N_, and vlc_gettext().

Referenced by EsOutProgramEpg(), and EsOutProgramMeta().

vlc_meta.h File Reference

Data Structures

Defines

Typedefs

Enumerations

Functions

Detailed Description

Define Documentation

Typedef Documentation

Enumeration Type Documentation

Function Documentation