/******************************************************************************
- * Copyright (C) 2006 Daniel Stränger <vlc at schmaller dot de>
+ * xspf.c : XSPF playlist export functions
+ ******************************************************************************
+ * Copyright (C) 2006 the VideoLAN team
+ * $Id$
+ *
+ * Authors: Daniel Stränger <vlc at schmaller dot de>
+ * Yoann Peronneau <yoann@videolan.org>
*
* 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
* \file modules/misc/playlist/xspf.c
* \brief XSPF playlist export functions
*/
-#include <stdio.h>
-#include <vlc/vlc.h>
-#include <vlc/intf.h>
-#include "vlc_meta.h"
-#include "vlc_strings.h"
+#ifdef HAVE_CONFIG_H
+# include "config.h"
+#endif
+
+#include <vlc_common.h>
+#include <vlc_interface.h>
+#include <vlc_playlist.h>
+#include <vlc_input.h>
+#include <vlc_meta.h>
+#include <vlc_strings.h>
+#include <vlc_url.h>
+#include <vlc_charset.h>
#include "xspf.h"
+#include <assert.h>
+
/**
* \brief Prints the XSPF header to file, writes each item by xspf_export_item()
* and closes the open xml elements
* \param p_this the VLC playlist object
* \return VLC_SUCCESS if some memory is available, otherwise VLC_ENONMEM
*/
-int E_(xspf_export_playlist)( vlc_object_t *p_this )
+int xspf_export_playlist( vlc_object_t *p_this )
{
const playlist_t *p_playlist = (playlist_t *)p_this;
const playlist_export_t *p_export =
(playlist_export_t *)p_playlist->p_private;
- int i;
- char *psz;
+ int i, i_count;
char *psz_temp;
- playlist_item_t **pp_items = NULL;
- int i_size;
- playlist_item_t *p_node;
+ playlist_item_t *p_node = p_export->p_root;
- /* write XSPF XML header - since we don't use <extension>,
- * we get by with version 0 */
+ /* write XSPF XML header */
fprintf( p_export->p_file, "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" );
fprintf( p_export->p_file,
- "<playlist version=\"0\" xmlns=\"http://xspf.org/ns/0/\">\n" );
+ "<playlist version=\"1\" xmlns=\"http://xspf.org/ns/0/\">\n" );
+
+ if( !p_node ) return VLC_SUCCESS;
- /* save tho whole playlist or only the current node */
-#define p_item p_playlist->status.p_item
- if ( p_item )
+ /* save name of the playlist node */
+ psz_temp = convert_xml_special_chars( p_node->p_input->psz_name );
+ if( *psz_temp )
{
- for (i = 0; i < p_item->i_parents; i++ )
- {
- if ( p_item->pp_parents[i]->p_parent->input.i_type
- == ITEM_TYPE_PLAYLIST )
- {
- /* set the current node and its children */
- p_node = p_item->pp_parents[i]->p_parent;
- pp_items = p_node->pp_children;
- i_size = p_node->i_children;
-#undef p_item
-
- /* save name of the playlist node */
- psz_temp = convert_xml_special_chars( p_node->input.psz_name );
- if ( *psz_temp )
- fprintf( p_export->p_file, "\t<title>%s</title>\n",
- psz_temp );
- free( psz_temp );
-
- /* save the creator of the playlist node */
- psz = vlc_input_item_GetInfo( &p_node->input,
- _(VLC_META_INFO_CAT),
- _(VLC_META_ARTIST) );
- if ( psz && !*psz )
- {
- free ( psz );
- psz = NULL;
- }
-
- if ( !psz )
- psz = vlc_input_item_GetInfo( &p_node->input,
- _(VLC_META_INFO_CAT),
- _(VLC_META_AUTHOR) );
-
- psz_temp = convert_xml_special_chars( psz );
-
- if ( psz ) free( psz );
- if ( *psz_temp )
- fprintf( p_export->p_file, "\t<creator>%s</creator>\n",
- psz_temp );
- free( psz_temp );
-
- /* save location of the playlist node */
- psz = assertUTF8URI( p_export->psz_filename );
- if ( psz && *psz )
- {
- fprintf( p_export->p_file, "\t<location>%s</location>\n",
- psz );
- free( psz );
- }
- break;
- }
- }
+ fprintf( p_export->p_file, "\t<title>%s</title>\n", psz_temp );
}
+ free( psz_temp );
- /* prepare all the playlist children for export */
- if ( !pp_items )
+ /* save location of the playlist node */
+ psz_temp = assertUTF8URI( p_export->psz_filename );
+ if( psz_temp && *psz_temp )
{
- pp_items = p_playlist->pp_items;
- i_size = p_playlist->i_size;
+ fprintf( p_export->p_file, "\t<location>%s</location>\n", psz_temp );
}
+ free( psz_temp );
- /* export all items */
+ /* export all items in a flat format */
fprintf( p_export->p_file, "\t<trackList>\n" );
- for ( i = 0; i < i_size; i++ )
+ i_count = 0;
+ for( i = 0; i < p_node->i_children; i++ )
{
- xspf_export_item( pp_items[i], p_export->p_file );
+ xspf_export_item( p_node->pp_children[i], p_export->p_file,
+ &i_count );
}
+ fprintf( p_export->p_file, "\t</trackList>\n" );
+
+ /* export the tree structure in <extension> */
+ fprintf( p_export->p_file, "\t<extension application=\"http://www.videolan.org/vlc/playlist/0\">\n" );
+ i_count = 0;
+ for( i = 0; i < p_node->i_children; i++ )
+ {
+ xspf_extension_item( p_node->pp_children[i], p_export->p_file,
+ &i_count );
+ }
+ fprintf( p_export->p_file, "\t</extension>\n" );
/* close the header elements */
- fprintf( p_export->p_file, "\t</trackList>\n" );
fprintf( p_export->p_file, "</playlist>\n" );
return VLC_SUCCESS;
* \brief exports one item to file or traverse if item is a node
* \param p_item playlist item to export
* \param p_file file to write xml-converted item to
+ * \param p_i_count counter for track identifiers
*/
-static void xspf_export_item( playlist_item_t *p_item, FILE *p_file )
+static void xspf_export_item( playlist_item_t *p_item, FILE *p_file,
+ int *p_i_count )
{
- int i; /**< iterator for all children if the current item is a node */
char *psz;
char *psz_temp;
+ int i;
+ mtime_t i_duration;
- if ( !p_item )
- return;
+ if( !p_item ) return;
- /** \todo only "flat" playlists supported at this time.
- * extend to save the tree structure.
- */
/* if we get a node here, we must traverse it */
- if ( p_item->i_children > 0 )
+ if( p_item->i_children > 0 )
{
- for ( i = 0; i < p_item->i_children; i++ )
+ int i;
+ for( i = 0; i < p_item->i_children; i++ )
{
- xspf_export_item( p_item->pp_children[i], p_file );
+ xspf_export_item( p_item->pp_children[i], p_file, p_i_count );
}
return;
}
+ /* don't write empty nodes */
+ if( p_item->i_children == 0 )
+ {
+ return;
+ }
+
/* leaves can be written directly */
fprintf( p_file, "\t\t<track>\n" );
+ /* print identifier and increase the counter */
+ fprintf( p_file, "\t\t\t<identifier>%i</identifier>\n", *p_i_count );
+ ( *p_i_count )++;
+
/* -> the location */
- if ( p_item->input.psz_uri && *p_item->input.psz_uri )
+
+ char *psz_uri = input_item_GetURI( p_item->p_input );
+
+ if( psz_uri && *psz_uri )
{
- psz = assertUTF8URI( p_item->input.psz_uri );
+ psz = assertUTF8URI( psz_uri );
fprintf( p_file, "\t\t\t<location>%s</location>\n", psz );
free( psz );
}
/* -> the name/title (only if different from uri)*/
- if ( p_item->input.psz_name &&
- p_item->input.psz_uri &&
- strcmp( p_item->input.psz_uri, p_item->input.psz_name ) )
+ char *psz_name = input_item_GetTitle( p_item->p_input );
+ if( psz_name && psz_uri && strcmp( psz_uri, psz_name ) )
{
- psz_temp = convert_xml_special_chars( p_item->input.psz_name );
- if ( *psz_temp )
+ psz_temp = convert_xml_special_chars( psz_name );
+ if( *psz_temp )
fprintf( p_file, "\t\t\t<title>%s</title>\n", psz_temp );
free( psz_temp );
}
+ free( psz_name );
+ free( psz_uri );
- /* -> the artist/creator */
- psz = vlc_input_item_GetInfo( &p_item->input,
- _(VLC_META_INFO_CAT),
- _(VLC_META_ARTIST) );
- if ( psz && !*psz )
+ if( p_item->p_input->p_meta == NULL )
{
- free ( psz );
- psz = NULL;
+ goto xspfexportitem_end;
}
- if ( !psz )
- psz = vlc_input_item_GetInfo( &p_item->input,
- _(VLC_META_INFO_CAT),
- _(VLC_META_AUTHOR) );
+
+ /* -> the artist/creator */
+ psz = input_item_GetArtist( p_item->p_input );
+ if( psz == NULL ) psz = strdup( "" );
psz_temp = convert_xml_special_chars( psz );
- if ( psz ) free( psz );
- if ( *psz_temp )
+ free( psz );
+ if( *psz_temp )
+ {
fprintf( p_file, "\t\t\t<creator>%s</creator>\n", psz_temp );
+ }
free( psz_temp );
/* -> the album */
- psz = vlc_input_item_GetInfo( &p_item->input,
- _(VLC_META_INFO_CAT),
- _(VLC_META_COLLECTION) );
+ psz = input_item_GetAlbum( p_item->p_input );
+ if( psz == NULL ) psz = strdup( "" );
psz_temp = convert_xml_special_chars( psz );
- if ( psz ) free( psz );
- if ( *psz_temp )
+ free( psz );
+ if( *psz_temp )
+ {
fprintf( p_file, "\t\t\t<album>%s</album>\n", psz_temp );
+ }
free( psz_temp );
/* -> the track number */
- psz = vlc_input_item_GetInfo( &p_item->input,
- _(VLC_META_INFO_CAT),
- _(VLC_META_SEQ_NUM) );
- if ( psz )
+ psz = input_item_GetTrackNum( p_item->p_input );
+ if( psz == NULL ) psz = strdup( "" );
+ if( psz && *psz )
{
- if ( *psz )
- fprintf( p_file, "\t\t\t<trackNum>%i</trackNum>\n", atoi( psz ) );
- free( psz );
+ int i_tracknum = atoi( psz );
+ if( i_tracknum > 0 )
+ fprintf( p_file, "\t\t\t<trackNum>%i</trackNum>\n", i_tracknum );
+ }
+ free( psz );
+
+ /* -> the description */
+ psz = input_item_GetDescription( p_item->p_input );
+ if( psz == NULL ) psz = strdup( "" );
+ psz_temp = convert_xml_special_chars( psz );
+ free( psz );
+ if( *psz_temp )
+ {
+ fprintf( p_file, "\t\t\t<annotation>%s</annotation>\n", psz_temp );
}
+ free( psz_temp );
+ psz = input_item_GetArtURL( p_item->p_input );
+ if( psz == NULL ) psz = strdup( "" );
+ if( !EMPTY_STR( psz ) )
+ {
+ psz_uri = assertUTF8URI( psz );
+ fprintf( p_file, "\t\t\t<image>%s</image>\n", psz_uri );
+ free( psz_uri );
+ }
+ free( psz );
+
+ /* export the input's options (bookmarks, ...) in <extension> */
+ fprintf( p_file, "\t\t\t<extension application=\"http://www.videolan.org/vlc/playlist/0\">\n" );
+ for( i = 0; i < p_item->p_input->i_options; i++ )
+ {
+ fprintf( p_file, "\t\t\t\t<option>%s</option>\n",
+ p_item->p_input->ppsz_options[i][0] == ':' ?
+ p_item->p_input->ppsz_options[i] + 1 :
+ p_item->p_input->ppsz_options[i] );
+ }
+ fprintf( p_file, "\t\t\t</extension>\n" );
+
+xspfexportitem_end:
/* -> the duration */
- if ( p_item->input.i_duration > 0 )
+ i_duration = input_item_GetDuration( p_item->p_input );
+ if( i_duration > 0 )
{
fprintf( p_file, "\t\t\t<duration>%ld</duration>\n",
- (long)(p_item->input.i_duration / 1000) );
+ (long)(i_duration / 1000) );
}
fprintf( p_file, "\t\t</track>\n" );
return;
}
+/**
+ * \brief exports one item in extension to file and traverse if item is a node
+ * \param p_item playlist item to export
+ * \param p_file file to write xml-converted item to
+ * \param p_i_count counter for track identifiers
+ */
+static void xspf_extension_item( playlist_item_t *p_item, FILE *p_file,
+ int *p_i_count )
+{
+ if( !p_item ) return;
+
+ /* if we get a node here, we must traverse it */
+ if( p_item->i_children >= 0 )
+ {
+ int i;
+ char *psz_temp;
+ psz_temp = convert_xml_special_chars( p_item->p_input->psz_name );
+ fprintf( p_file, "\t\t<node title=\"%s\">\n",
+ *psz_temp ? psz_temp : "" );
+ free( psz_temp );
+
+ for( i = 0; i < p_item->i_children; i++ )
+ {
+ xspf_extension_item( p_item->pp_children[i], p_file, p_i_count );
+ }
+
+ fprintf( p_file, "\t\t</node>\n" );
+ return;
+ }
+
+
+ /* print leaf and increase the counter */
+ fprintf( p_file, "\t\t\t<item href=\"%i\" />\n", *p_i_count );
+ ( *p_i_count )++;
+
+ return;
+}
+
/**
* \param psz_name the location of the media ressource (e.g. local file,
* device, network stream, etc.)
{
char *psz_ret = NULL; /**< the new result buffer to return */
char *psz_s = NULL, *psz_d = NULL; /**< src & dest pointers for URI conversion */
- vlc_bool_t b_name_is_uri = VLC_FALSE;
+ bool b_uri_is_file = false; /**< we do additional %-encoding if the URI is a file:// one */
- if ( !psz_name || !*psz_name )
+ if( !psz_name || !*psz_name )
return NULL;
/* check that string is valid UTF-8 */
/* max. 3x for URI conversion (percent escaping) and
8 bytes for "file://" and NULL-termination */
psz_ret = (char *)malloc( sizeof(char)*strlen(psz_name)*6*3+8 );
- if ( !psz_ret )
+ if( !psz_ret )
return NULL;
/** \todo check for a valid scheme part preceding the colon */
- if ( strchr( psz_s, ':' ) )
+ size_t i_delim = strcspn( psz_s, ":" );
+ if( i_delim != strlen( psz_s ) )
{
- psz_d = psz_ret;
- b_name_is_uri = VLC_TRUE;
+ i_delim++; /* skip the ':' */
+ strncpy( psz_ret, psz_s, i_delim );
+ psz_d = psz_ret + i_delim;
+
+ if( !strncmp( psz_s, "file://", 7 ) )
+ b_uri_is_file = true;
+
+ psz_s += i_delim;
}
/* assume "file" scheme if no scheme-part is included */
else
{
strcpy( psz_ret, "file://" );
psz_d = psz_ret + 7;
+ b_uri_is_file = true;
}
- while ( *psz_s )
+ while( *psz_s )
{
/* percent-encode all non-ASCII and the XML special characters and the percent sign itself */
- if ( *psz_s & B10000000 ||
- *psz_s == '<' ||
- *psz_s == '>' ||
- *psz_s == '&' ||
- *psz_s == ' ' ||
- ( *psz_s == '%' && !b_name_is_uri ) )
+ if( *psz_s & B10000000 ||
+ *psz_s == '<' ||
+ *psz_s == '>' ||
+ *psz_s == '&' ||
+ *psz_s == ' ' ||
+ *psz_s == '+' ||
+ *psz_s == '%' ||
+ ( b_uri_is_file && (
+ *psz_s == ':' ||
+ *psz_s == '"' ||
+ *psz_s == '?' ||
+ *psz_s == '#' ||
+ *psz_s == '[' ||
+ *psz_s == ']' ||
+ *psz_s == '@' )
+ )
+ )
{
*psz_d++ = '%';
*psz_d++ = hexchars[(*psz_s >> 4) & B00001111];
*psz_d++ = hexchars[*psz_s & B00001111];
- } else
+ }
+ else
+ {
*psz_d++ = *psz_s;
+ }
psz_s++;
}