1 /*****************************************************************************
2 * item.c : Playlist item creation/deletion/add/removal functions
3 *****************************************************************************
4 * Copyright (C) 1999-2004 the VideoLAN team
7 * Authors: Samuel Hocevar <sam@zoy.org>
8 * Clément Stenac <zorglub@videolan.org>
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
23 *****************************************************************************/
25 #include <vlc/input.h>
27 #include <vlc_playlist.h>
28 #include "playlist_internal.h"
30 void AddItem( playlist_t *p_playlist, playlist_item_t *p_item,
31 playlist_item_t *p_node, int i_pos );
32 void GoAndPreparse( playlist_t *p_playlist, int i_mode,
33 playlist_item_t *, playlist_item_t * );
34 void ChangeToNode( playlist_t *p_playlist, playlist_item_t *p_item );
35 int DeleteInner( playlist_t * p_playlist, playlist_item_t *p_item,
38 /*****************************************************************************
39 * Playlist item creation
40 *****************************************************************************/
41 playlist_item_t * playlist_ItemNewWithType( vlc_object_t *p_obj,
45 const char **ppsz_options,
46 int i_duration, int i_type )
48 input_item_t *p_input;
49 if( psz_uri == NULL ) return NULL;
50 p_input = input_ItemNewWithType( p_obj, psz_uri,
51 psz_name, i_options, ppsz_options,
53 return playlist_ItemNewFromInput( p_obj, p_input );
56 playlist_item_t *__playlist_ItemNewFromInput( vlc_object_t *p_obj,
57 input_item_t *p_input )
59 DECMALLOC_NULL( p_item, playlist_item_t );
60 playlist_t *p_playlist = p_obj->p_libvlc->p_playlist;
61 vlc_object_yield( p_playlist );
63 p_item->p_input = p_input;
64 vlc_gc_incref( p_item->p_input );
66 p_item->i_id = ++p_playlist->i_last_playlist_id;
68 p_item->p_parent = NULL;
69 p_item->i_children = -1;
70 p_item->pp_children = NULL;
73 vlc_object_release( p_playlist );
78 /***************************************************************************
79 * Playlist item destruction
80 ***************************************************************************/
82 /** Delete a playlist item and detach its input item */
83 int playlist_ItemDelete( playlist_item_t *p_item )
85 vlc_gc_decref( p_item->p_input );
90 /** Remove an input item from ONELEVEL and CATEGORY */
91 int playlist_DeleteAllFromInput( playlist_t *p_playlist, int i_input_id )
93 playlist_DeleteFromInput( p_playlist, i_input_id,
94 p_playlist->p_root_category, VLC_TRUE );
95 playlist_DeleteFromInput( p_playlist, i_input_id,
96 p_playlist->p_root_onelevel, VLC_TRUE );
100 /** Remove an input item from ONELEVEL and CATEGORY.
101 * This function must be entered without the playlist lock */
102 int playlist_LockDeleteAllFromInput( playlist_t * p_playlist, int i_id )
105 vlc_mutex_lock( &p_playlist->object_lock );
106 i_ret = playlist_DeleteAllFromInput( p_playlist, i_id );
107 vlc_mutex_unlock( &p_playlist->object_lock );
111 /** Remove an input item when it appears from a root playlist item */
112 int playlist_DeleteFromInput( playlist_t *p_playlist, int i_input_id,
113 playlist_item_t *p_root, vlc_bool_t b_do_stop )
116 for( i = 0 ; i< p_root->i_children ; i++ )
118 if( p_root->pp_children[i]->i_children == -1 &&
119 p_root->pp_children[i]->p_input->i_id == i_input_id )
121 DeleteInner( p_playlist, p_root->pp_children[i], b_do_stop );
124 else if( p_root->pp_children[i]->i_children >= 0 )
126 int i_ret = playlist_DeleteFromInput( p_playlist, i_input_id,
127 p_root->pp_children[i], b_do_stop );
128 if( i_ret == VLC_SUCCESS ) return VLC_SUCCESS;
134 /** Remove a playlist item from the playlist, given its id */
135 int playlist_DeleteFromItemId( playlist_t *p_playlist, int i_id )
137 playlist_item_t *p_item = playlist_ItemGetById( p_playlist, i_id );
138 if( !p_item ) return VLC_EGENERIC;
139 return DeleteInner( p_playlist, p_item, VLC_TRUE );
142 /** Remove a playlist item from the playlist, given its id
143 * This function should be entered without the playlist lock */
144 int playlist_LockDelete( playlist_t * p_playlist, int i_id )
147 vlc_mutex_lock( &p_playlist->object_lock );
148 i_ret = playlist_DeleteFromItemId( p_playlist, i_id );
149 vlc_mutex_unlock( &p_playlist->object_lock );
153 /** Clear the playlist */
154 void playlist_Clear( playlist_t * p_playlist )
156 playlist_NodeEmpty( p_playlist, p_playlist->p_root_category, VLC_TRUE );
157 playlist_NodeEmpty( p_playlist, p_playlist->p_root_onelevel, VLC_TRUE );
159 /** Clear the playlist. This function must be entered without the lock */
160 void playlist_LockClear( playlist_t *p_playlist )
162 vlc_mutex_lock( &p_playlist->object_lock );
163 playlist_Clear( p_playlist );
164 vlc_mutex_unlock( &p_playlist->object_lock );
167 /***************************************************************************
168 * Playlist item addition
169 ***************************************************************************/
170 /** Add an item to the playlist or the media library
171 * \param p_playlist the playlist to add into
172 * \param psz_uri the mrl to add to the playlist
173 * \param psz_name a text giving a name or description of this item
174 * \param i_mode the mode used when adding
175 * \param i_pos the position in the playlist where to add. If this is
176 * PLAYLIST_END the item will be added at the end of the playlist
177 * regardless of its size
178 * \param b_playlist TRUE for playlist, FALSE for media library
179 * \return The id of the playlist item
181 int playlist_Add( playlist_t *p_playlist, const char *psz_uri,
182 const char *psz_name, int i_mode, int i_pos,
183 vlc_bool_t b_playlist )
185 return playlist_AddExt( p_playlist, psz_uri, psz_name,
186 i_mode, i_pos, -1, NULL, 0, b_playlist );
190 * Add a MRL into the playlist or the media library, duration and options given
192 * \param p_playlist the playlist to add into
193 * \param psz_uri the mrl to add to the playlist
194 * \param psz_name a text giving a name or description of this item
195 * \param i_mode the mode used when adding
196 * \param i_pos the position in the playlist where to add. If this is
197 * PLAYLIST_END the item will be added at the end of the playlist
198 * regardless of its size
199 * \param i_duration length of the item in milliseconds.
200 * \param ppsz_options an array of options
201 * \param i_options the number of options
202 * \param b_playlist TRUE for playlist, FALSE for media library
203 * \return The id of the playlist item
205 int playlist_AddExt( playlist_t *p_playlist, const char * psz_uri,
206 const char *psz_name, int i_mode, int i_pos,
207 mtime_t i_duration, const char **ppsz_options,
208 int i_options, vlc_bool_t b_playlist )
210 input_item_t *p_input = input_ItemNewExt( p_playlist, psz_uri, psz_name,
211 i_options, ppsz_options,
214 return playlist_AddInput( p_playlist, p_input, i_mode, i_pos, b_playlist );
217 /** Add an input item to the playlist node */
218 int playlist_AddInput( playlist_t* p_playlist, input_item_t *p_input,
219 int i_mode, int i_pos, vlc_bool_t b_playlist )
221 playlist_item_t *p_item_cat, *p_item_one;
223 if( !p_playlist->b_doing_ml )
224 PL_DEBUG( "adding item `%s' ( %s )", p_input->psz_name,
227 vlc_mutex_lock( &p_playlist->object_lock );
229 /* Add to ONELEVEL */
230 p_item_one = playlist_ItemNewFromInput( p_playlist, p_input );
231 if( p_item_one == NULL ) return VLC_EGENERIC;
232 AddItem( p_playlist, p_item_one,
233 b_playlist ? p_playlist->p_local_onelevel :
234 p_playlist->p_ml_onelevel , i_pos );
236 /* Add to CATEGORY */
237 p_item_cat = playlist_ItemNewFromInput( p_playlist, p_input );
238 if( p_item_cat == NULL ) return VLC_EGENERIC;
239 AddItem( p_playlist, p_item_cat,
240 b_playlist ? p_playlist->p_local_category :
241 p_playlist->p_ml_category , i_pos );
243 GoAndPreparse( p_playlist, i_mode, p_item_cat, p_item_one );
245 vlc_mutex_unlock( &p_playlist->object_lock );
249 /** Add an input item to p_direct_parent in the category tree, and to the
250 * matching top category in onelevel **/
251 int playlist_BothAddInput( playlist_t *p_playlist,
252 input_item_t *p_input,
253 playlist_item_t *p_direct_parent,
254 int i_mode, int i_pos )
256 playlist_item_t *p_item_cat, *p_item_one, *p_up;
259 vlc_mutex_lock( & p_playlist->object_lock );
261 /* Add to category */
262 p_item_cat = playlist_ItemNewFromInput( p_playlist, p_input );
263 if( p_item_cat == NULL ) return VLC_EGENERIC;
264 AddItem( p_playlist, p_item_cat, p_direct_parent, i_pos );
266 /* Add to onelevel */
267 /**Â \todo make a faster case for ml import */
268 p_item_one = playlist_ItemNewFromInput( p_playlist, p_input );
269 if( p_item_one == NULL ) return VLC_EGENERIC;
271 p_up = p_direct_parent;
272 while( p_up->p_parent != p_playlist->p_root_category )
274 p_up = p_up->p_parent;
276 for( i_top = 0 ; i_top < p_playlist->p_root_onelevel->i_children; i_top++ )
278 if( p_playlist->p_root_onelevel->pp_children[i_top]->p_input->i_id == p_up->p_input->i_id )
280 AddItem( p_playlist, p_item_one,
281 p_playlist->p_root_onelevel->pp_children[i_top], i_pos );
285 GoAndPreparse( p_playlist, i_mode, p_item_cat, p_item_one );
287 vlc_mutex_unlock( &p_playlist->object_lock );
292 * Add an item where it should be added, when adding from a node
293 * (ex: directory access, playlist demuxers, services discovery, ... )
294 * \param p_playlist the playlist
295 * \param p_input the input to add
296 * \param p_parent the direct node
297 * \param p_item_in_category the item within category root (as returned by playlist_ItemToNode)
298 * \param b_forced_parent Are we forced to add only to p_parent ?
300 void playlist_AddWhereverNeeded( playlist_t *p_playlist, input_item_t *p_input,
301 playlist_item_t *p_parent,
302 playlist_item_t *p_item_in_category,
303 vlc_bool_t b_forced_parent, int i_mode )
305 /* If we have forced a parent :
306 * - Just add the input to the forced parent (which should be p_parent)
308 * - If we have item in category, add to it, and to onelevel (bothadd)
309 * - If we don't, just add to p_parent
311 if( b_forced_parent == VLC_TRUE || !p_item_in_category )
313 playlist_NodeAddInput( p_playlist, p_input, p_parent, i_mode,
318 playlist_BothAddInput( p_playlist, p_input, p_item_in_category,
319 i_mode, PLAYLIST_END );
324 /** Add an input item to a given node */
325 playlist_item_t * playlist_NodeAddInput( playlist_t *p_playlist,
326 input_item_t *p_input,
327 playlist_item_t *p_parent,
328 int i_mode, int i_pos )
330 playlist_item_t *p_item;
332 assert( p_parent && p_parent->i_children != -1 );
334 vlc_mutex_lock( &p_playlist->object_lock );
336 p_item = playlist_ItemNewFromInput( p_playlist, p_input );
337 if( p_item == NULL ) return NULL;
338 AddItem( p_playlist, p_item, p_parent, i_pos );
340 vlc_mutex_unlock( &p_playlist->object_lock );
345 /** Add a playlist item to a given node */
346 void playlist_NodeAddItem( playlist_t *p_playlist, playlist_item_t *p_item,
347 playlist_item_t *p_parent, int i_mode, int i_pos )
349 vlc_mutex_lock( &p_playlist->object_lock );
350 AddItem( p_playlist, p_item, p_parent, i_pos );
351 vlc_mutex_unlock( &p_playlist->object_lock );
354 /*****************************************************************************
355 * Playlist item misc operations
356 *****************************************************************************/
359 * Transform an item to a node. Return the node in the category tree, or NULL
361 * This function must be entered without the playlist lock
363 playlist_item_t *playlist_ItemToNode( playlist_t *p_playlist,
364 playlist_item_t *p_item )
367 playlist_item_t *p_item_in_category;
369 * Find the input in CATEGORY.
371 * - change it to node
372 * - we'll return it at the end
373 * - If we are a direct child of onelevel root, change to node, else
374 * delete the input from ONELEVEL
375 * - If we don't find it, just change to node (we are probably in VLM)
378 * If we were in ONELEVEL, we thus retrieve the node in CATEGORY (will be
379 * useful for later BothAddInput )
382 /* Fast track the media library, no time to loose */
383 if( p_item == p_playlist->p_ml_category )
386 /** \todo First look if we don't already have it */
387 p_item_in_category = playlist_ItemFindFromInputAndRoot(
388 p_playlist, p_item->p_input->i_id,
389 p_playlist->p_root_category,
392 if( p_item_in_category )
394 playlist_item_t *p_item_in_one = playlist_ItemFindFromInputAndRoot(
395 p_playlist, p_item->p_input->i_id,
396 p_playlist->p_root_onelevel,
398 ChangeToNode( p_playlist, p_item_in_category );
399 if( p_item_in_one->p_parent == p_playlist->p_root_onelevel )
400 ChangeToNode( p_playlist, p_item_in_one );
403 playlist_DeleteFromInput( p_playlist, p_item_in_one->p_input->i_id,
404 p_playlist->p_root_onelevel, VLC_FALSE );
406 p_playlist->b_reset_random = VLC_TRUE;
407 var_SetInteger( p_playlist, "item-change", p_item_in_category->
409 return p_item_in_category;
413 ChangeToNode( p_playlist, p_item );
418 /** Transform an item to a node
419 * This function must be entered without the playlist lock
420 * \see playlist_ItemToNode
422 playlist_item_t * playlist_LockItemToNode( playlist_t *p_playlist,
423 playlist_item_t *p_item )
425 playlist_item_t *p_ret;
426 vlc_mutex_lock( &p_playlist->object_lock );
427 p_ret = playlist_ItemToNode( p_playlist, p_item );
428 vlc_mutex_unlock( &p_playlist->object_lock );
432 /** Find an item within a root, given its input id.
433 * \return the first found item, or NULL if not found
435 playlist_item_t *playlist_ItemFindFromInputAndRoot( playlist_t *p_playlist,
437 playlist_item_t *p_root,
438 vlc_bool_t b_items_only )
441 for( i = 0 ; i< p_root->i_children ; i++ )
443 if( ( b_items_only ? p_root->pp_children[i]->i_children == -1 : 1 ) &&
444 p_root->pp_children[i]->p_input->i_id == i_input_id )
446 return p_root->pp_children[i];
448 else if( p_root->pp_children[i]->i_children >= 0 )
450 playlist_item_t *p_search =
451 playlist_ItemFindFromInputAndRoot( p_playlist, i_input_id,
452 p_root->pp_children[i],
454 if( p_search ) return p_search;
461 static int TreeMove( playlist_t *p_playlist, playlist_item_t *p_item,
462 playlist_item_t *p_node, int i_newpos )
465 playlist_item_t *p_detach = p_item->p_parent;
466 if( p_node->i_children == -1 ) return VLC_EGENERIC;
468 for( j = 0; j < p_detach->i_children; j++ )
470 if( p_detach->pp_children[j] == p_item ) break;
472 REMOVE_ELEM( p_detach->pp_children, p_detach->i_children, j );
474 /* Attach to new parent */
475 INSERT_ELEM( p_node->pp_children, p_node->i_children, i_newpos, p_item );
476 p_item->p_parent = p_node;
484 * This function must be entered with the playlist lock
486 * \param p_playlist the playlist
487 * \param p_item the item to move
488 * \param p_node the new parent of the item
489 * \param i_newpos the new position under this new parent
490 * \return VLC_SUCCESS or an error
492 int playlist_TreeMove( playlist_t * p_playlist, playlist_item_t *p_item,
493 playlist_item_t *p_node, int i_newpos )
495 /* Drop on a top level node. Move in the two trees */
496 if( p_node->p_parent == p_playlist->p_root_category ||
497 p_node->p_parent == p_playlist->p_root_onelevel )
499 /* Fixme: avoid useless lookups but we need some clean helpers */
501 /* Fixme: if we try to move a node on a top-level node, it will
502 * fail because the node doesn't exist in onelevel and we will
503 * do some shit in onelevel. We should recursively move all items
505 playlist_item_t *p_node_onelevel;
506 playlist_item_t *p_item_onelevel;
507 p_node_onelevel = playlist_ItemFindFromInputAndRoot( p_playlist,
508 p_node->p_input->i_id,
509 p_playlist->p_root_onelevel,
511 p_item_onelevel = playlist_ItemFindFromInputAndRoot( p_playlist,
512 p_item->p_input->i_id,
513 p_playlist->p_root_onelevel,
515 if( p_node_onelevel && p_item_onelevel )
516 TreeMove( p_playlist, p_item_onelevel, p_node_onelevel, 0 );
519 playlist_item_t *p_node_category;
520 playlist_item_t *p_item_category;
521 p_node_category = playlist_ItemFindFromInputAndRoot( p_playlist,
522 p_node->p_input->i_id,
523 p_playlist->p_root_category,
525 p_item_category = playlist_ItemFindFromInputAndRoot( p_playlist,
526 p_item->p_input->i_id,
527 p_playlist->p_root_category,
529 if( p_node_category && p_item_category )
530 TreeMove( p_playlist, p_item_category, p_node_category, 0 );
535 return TreeMove( p_playlist, p_item, p_node, i_newpos );
538 /** Send a notification that an item has been added to a node */
539 void playlist_SendAddNotify( playlist_t *p_playlist, int i_item_id,
543 playlist_add_t *p_add = (playlist_add_t *)malloc(sizeof( playlist_add_t));
544 p_add->i_item = i_item_id;
545 p_add->i_node = i_node_id;
546 val.p_address = p_add;
547 p_playlist->b_reset_random = VLC_TRUE;
548 var_Set( p_playlist, "item-append", val );
552 /*****************************************************************************
553 * Playlist item accessors
554 *****************************************************************************/
556 /** Set the name of a playlist item */
557 int playlist_ItemSetName( playlist_item_t *p_item, char *psz_name )
559 if( psz_name && p_item )
561 if( p_item->p_input->psz_name ) free( p_item->p_input->psz_name );
562 p_item->p_input->psz_name = strdup( psz_name );
568 /***************************************************************************
569 * The following functions are local
570 ***************************************************************************/
572 /* Enqueue an item for preparsing, and play it, if needed */
573 void GoAndPreparse( playlist_t *p_playlist, int i_mode,
574 playlist_item_t *p_item_cat, playlist_item_t *p_item_one )
576 if( (i_mode & PLAYLIST_GO ) )
578 playlist_item_t *p_parent = p_item_one;
579 playlist_item_t *p_toplay = NULL;
582 if( p_parent == p_playlist->p_root_category )
584 p_toplay = p_item_cat; break;
586 else if( p_parent == p_playlist->p_root_onelevel )
588 p_toplay = p_item_one; break;
590 p_parent = p_parent->p_parent;
593 p_playlist->request.b_request = VLC_TRUE;
594 p_playlist->request.i_skip = 0;
595 p_playlist->request.p_item = p_toplay;
596 if( p_playlist->p_input )
598 input_StopThread( p_playlist->p_input );
600 p_playlist->request.i_status = PLAYLIST_RUNNING;
602 if( i_mode & PLAYLIST_PREPARSE &&
603 var_CreateGetBool( p_playlist, "auto-preparse" ) )
605 playlist_PreparseEnqueue( p_playlist, p_item_cat->p_input );
609 /* Add the playlist item to the requested node and fire a notification */
610 void AddItem( playlist_t *p_playlist, playlist_item_t *p_item,
611 playlist_item_t *p_node, int i_pos )
613 INSERT_ELEM( p_playlist->pp_items, p_playlist->i_size,
614 p_playlist->i_size, p_item );
615 INSERT_ELEM( p_playlist->pp_all_items, p_playlist->i_all_size,
616 p_playlist->i_all_size, p_item );
617 p_playlist->i_enabled ++;
619 if( i_pos == PLAYLIST_END )
621 playlist_NodeAppend( p_playlist, p_item, p_node );
625 playlist_NodeInsert( p_playlist, p_item, p_node, i_pos );
627 if( !p_playlist->b_doing_ml )
628 playlist_SendAddNotify( p_playlist, p_item->i_id, p_node->i_id );
631 /* Actually convert an item to a node */
632 void ChangeToNode( playlist_t *p_playlist, playlist_item_t *p_item )
635 if( p_item->i_children == -1 )
636 p_item->i_children = 0;
638 /* Remove it from the array of available items */
639 for( i = 0 ; i < p_playlist->i_size ; i++ )
641 if( p_item == p_playlist->pp_items[i] )
643 REMOVE_ELEM( p_playlist->pp_items, p_playlist->i_size, i );
648 /* Do the actual removal */
649 int DeleteInner( playlist_t * p_playlist, playlist_item_t *p_item,
652 int i, i_top, i_bottom;
653 int i_id = p_item->i_id;
654 vlc_bool_t b_flag = VLC_FALSE;
656 if( p_item->i_children > -1 )
658 return playlist_NodeDelete( p_playlist, p_item, VLC_TRUE, VLC_FALSE );
660 p_playlist->b_reset_random = VLC_TRUE;
661 var_SetInteger( p_playlist, "item-deleted", i_id );
663 /* Remove the item from the bank */
664 i_bottom = 0; i_top = p_playlist->i_all_size - 1;
666 while( p_playlist->pp_all_items[i]->i_id != i_id &&
669 if( p_playlist->pp_all_items[i]->i_id < i_id )
677 i = i_bottom + ( i_top - i_bottom ) / 2;
679 if( p_playlist->pp_all_items[i]->i_id == i_id )
681 REMOVE_ELEM( p_playlist->pp_all_items, p_playlist->i_all_size, i );
684 /* Check if it is the current item */
685 if( p_playlist->status.p_item == p_item )
687 /* Hack we don't call playlist_Control for lock reasons */
690 p_playlist->request.i_status = PLAYLIST_STOPPED;
691 p_playlist->request.b_request = VLC_TRUE;
692 p_playlist->request.p_item = NULL;
693 msg_Info( p_playlist, "stopping playback" );
698 PL_DEBUG( "deleting item `%s'", p_item->p_input->psz_name );
700 /* Remove the item from its parent */
701 playlist_NodeRemoveItem( p_playlist, p_item, p_item->p_parent );
703 if( b_flag == VLC_FALSE )
704 playlist_ItemDelete( p_item );
707 PL_DEBUG( "marking %s for further deletion", PLI_NAME( p_item ) );
708 p_item->i_flags |= PLAYLIST_REMOVE_FLAG;