e8179b15c377e9a9fea608160807be7dec9966a6
[vlc.git] / src / playlist / item.c
1 /*****************************************************************************
2  * item.c : Playlist item creation/deletion/add/removal functions
3  *****************************************************************************
4  * Copyright (C) 1999-2007 the VideoLAN team
5  * $Id$
6  *
7  * Authors: Samuel Hocevar <sam@zoy.org>
8  *          Clément Stenac <zorglub@videolan.org>
9  *
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.
14  *
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.
19  *
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  *****************************************************************************/
24 #ifdef HAVE_CONFIG_H
25 # include "config.h"
26 #endif
27
28 #include <vlc_common.h>
29 #include <assert.h>
30 #include <vlc_playlist.h>
31 #include "playlist_internal.h"
32
33 static void AddItem( playlist_t *p_playlist, playlist_item_t *p_item,
34                      playlist_item_t *p_node, int i_mode, int i_pos );
35 static void GoAndPreparse( playlist_t *p_playlist, int i_mode,
36                            playlist_item_t *, playlist_item_t * );
37 static void ChangeToNode( playlist_t *p_playlist, playlist_item_t *p_item );
38 static int DeleteInner( playlist_t * p_playlist, playlist_item_t *p_item,
39                         bool b_stop );
40
41 static playlist_item_t *ItemToNode( playlist_t *, playlist_item_t *, bool );
42
43 /*****************************************************************************
44  * An input item has gained a subitem (Event Callback)
45  *****************************************************************************/
46 static void input_item_subitem_added( const vlc_event_t * p_event,
47                                       void * user_data )
48 {
49     playlist_item_t *p_parent_playlist_item = user_data;
50     playlist_t * p_playlist = p_parent_playlist_item->p_playlist;
51     input_item_t * p_parent, * p_child;
52     playlist_item_t * p_child_in_category;
53     playlist_item_t * p_item_in_category;
54     bool b_play;
55
56     p_parent = p_event->p_obj;
57     p_child = p_event->u.input_item_subitem_added.p_new_child;
58
59     PL_LOCK;
60     b_play = var_CreateGetBool( p_playlist, "playlist-autostart" );
61
62     /* This part is really hakish, but this playlist system isn't simple */
63     /* First check if we haven't already added the item as we are
64      * listening using the onelevel and the category representent
65      * (Because of the playlist design) */
66     p_child_in_category = playlist_ItemFindFromInputAndRoot(
67                             p_playlist, p_child->i_id,
68                             p_playlist->p_root_category,
69                             false /* Only non-node */ );
70
71     if( !p_child_in_category )
72     {
73         /* Then, transform to a node if needed */
74         p_item_in_category = playlist_ItemFindFromInputAndRoot(
75                                 p_playlist, p_parent->i_id,
76                                 p_playlist->p_root_category,
77                                 false /* Only non-node */ );
78         if( !p_item_in_category )
79         {
80             /* Item may have been removed */
81             PL_UNLOCK;
82             return;
83         }
84
85         b_play = b_play &&
86             p_item_in_category == get_current_status_item( p_playlist );
87
88         /* If this item is already a node don't transform it */
89         if( p_item_in_category->i_children == -1 )
90         {
91             p_item_in_category = ItemToNode( p_playlist,
92                     p_item_in_category, pl_Locked );
93             p_item_in_category->p_input->i_type = ITEM_TYPE_PLAYLIST;
94         }
95
96         int i_ret = playlist_BothAddInput( p_playlist, p_child,
97                 p_item_in_category,
98                 PLAYLIST_APPEND | PLAYLIST_SPREPARSE , PLAYLIST_END,
99                 NULL, NULL, pl_Locked );
100
101         if( i_ret == VLC_SUCCESS && b_play )
102         {
103             playlist_Control( p_playlist, PLAYLIST_VIEWPLAY,
104                           pl_Locked, p_item_in_category, NULL );
105         }
106     }
107
108     PL_UNLOCK;
109
110 }
111
112 /*****************************************************************************
113  * An input item's meta or duration has changed (Event Callback)
114  *****************************************************************************/
115 static void input_item_changed( const vlc_event_t * p_event,
116                                 void * user_data )
117 {
118     (void)p_event;
119     playlist_item_t * p_item = user_data;
120     var_SetInteger( p_item->p_playlist, "item-change", p_item->i_id );
121 }
122
123 /*****************************************************************************
124  * Listen to vlc_InputItemAddSubItem event
125  *****************************************************************************/
126 static void install_input_item_observer( playlist_item_t * p_item )
127 {
128     vlc_event_manager_t * p_em = &p_item->p_input->event_manager;
129     vlc_event_attach( p_em, vlc_InputItemSubItemAdded,
130                       input_item_subitem_added, p_item );
131     vlc_event_attach( p_em, vlc_InputItemDurationChanged,
132                       input_item_changed, p_item );
133     vlc_event_attach( p_em, vlc_InputItemMetaChanged,
134                       input_item_changed, p_item );
135     vlc_event_attach( p_em, vlc_InputItemNameChanged,
136                       input_item_changed, p_item );
137     vlc_event_attach( p_em, vlc_InputItemInfoChanged,
138                       input_item_changed, p_item );
139     vlc_event_attach( p_em, vlc_InputItemErrorWhenReadingChanged,
140                       input_item_changed, p_item );
141 }
142
143 static void uninstall_input_item_observer( playlist_item_t * p_item )
144 {
145     vlc_event_manager_t * p_em = &p_item->p_input->event_manager;
146     vlc_event_detach( p_em, vlc_InputItemSubItemAdded,
147                       input_item_subitem_added, p_item );
148     vlc_event_detach( p_em, vlc_InputItemMetaChanged,
149                       input_item_changed, p_item );
150     vlc_event_detach( p_em, vlc_InputItemDurationChanged,
151                       input_item_changed, p_item );
152     vlc_event_detach( p_em, vlc_InputItemNameChanged,
153                       input_item_changed, p_item );
154     vlc_event_detach( p_em, vlc_InputItemInfoChanged,
155                       input_item_changed, p_item );
156     vlc_event_detach( p_em, vlc_InputItemErrorWhenReadingChanged,
157                       input_item_changed, p_item );
158 }
159
160 /*****************************************************************************
161  * Playlist item creation
162  *****************************************************************************/
163 playlist_item_t *playlist_ItemNewFromInput( playlist_t *p_playlist,
164                                               input_item_t *p_input )
165 {
166     playlist_item_t* p_item = malloc( sizeof( playlist_item_t ) );
167     if( !p_item )
168         return NULL;
169
170     assert( p_input );
171
172     p_item->p_input = p_input;
173     vlc_gc_incref( p_item->p_input );
174
175     p_item->i_id = ++pl_priv(p_playlist)->i_last_playlist_id;
176
177     p_item->p_parent = NULL;
178     p_item->i_children = -1;
179     p_item->pp_children = NULL;
180     p_item->i_flags = 0;
181     p_item->p_playlist = p_playlist;
182
183     install_input_item_observer( p_item );
184
185     return p_item;
186 }
187
188 /***************************************************************************
189  * Playlist item destruction
190  ***************************************************************************/
191
192 /**
193  * Release an item
194  *
195  * \param p_item item to delete
196  * \return VLC_SUCCESS
197 */
198 int playlist_ItemRelease( playlist_item_t *p_item )
199 {
200     /* For the assert */
201     playlist_t *p_playlist = p_item->p_playlist;
202     PL_ASSERT_LOCKED;
203
204     /* Surprise, we can't actually do more because we
205      * don't do refcounting, or eauivalent.
206      * Because item are not only accessed by their id
207      * using playlist_item outside the PL_LOCK isn't safe.
208      * Most of the modules does that.
209      *
210      * Who wants to add proper memory management? */
211     uninstall_input_item_observer( p_item );
212     ARRAY_APPEND( pl_priv(p_playlist)->items_to_delete, p_item);
213     return VLC_SUCCESS;
214 }
215
216 /**
217  * Delete input item
218  *
219  * Remove an input item when it appears from a root playlist item
220  * \param p_playlist playlist object
221  * \param i_input_id id of the input to delete
222  * \param p_root root playlist item
223  * \param b_do_stop must stop or not the playlist
224  * \return VLC_SUCCESS or VLC_EGENERIC
225 */
226 static int DeleteFromInput( playlist_t *p_playlist, int i_input_id,
227                             playlist_item_t *p_root, bool b_do_stop )
228 {
229     int i;
230     PL_ASSERT_LOCKED;
231     for( i = 0 ; i< p_root->i_children ; i++ )
232     {
233         if( p_root->pp_children[i]->i_children == -1 &&
234             p_root->pp_children[i]->p_input->i_id == i_input_id )
235         {
236             DeleteInner( p_playlist, p_root->pp_children[i], b_do_stop );
237             return VLC_SUCCESS;
238         }
239         else if( p_root->pp_children[i]->i_children >= 0 )
240         {
241             int i_ret = DeleteFromInput( p_playlist, i_input_id,
242                                          p_root->pp_children[i], b_do_stop );
243             if( i_ret == VLC_SUCCESS ) return VLC_SUCCESS;
244         }
245     }
246     return VLC_EGENERIC;
247 }
248
249 /**
250  * Delete input item
251  *
252  * Remove an input item when it appears from a root playlist item
253  * \param p_playlist playlist object
254  * \param i_input_id id of the input to delete
255  * \param p_root root playlist item
256  * \param b_locked TRUE if the playlist is locked
257  * \return VLC_SUCCESS or VLC_EGENERIC
258  */
259 int playlist_DeleteFromInputInParent( playlist_t *p_playlist, int i_input_id,
260                                       playlist_item_t *p_root, bool b_locked )
261 {
262     int i_ret;
263     PL_LOCK_IF( !b_locked );
264     i_ret = DeleteFromInput( p_playlist, i_input_id,
265                              p_root, true );
266     PL_UNLOCK_IF( !b_locked );
267     return i_ret;
268 }
269
270 /**
271  * Delete from input
272  *
273  * Remove an input item from ONELEVEL and CATEGORY
274  * \param p_playlist playlist object
275  * \param i_input_id id of the input to delete
276  * \param b_locked TRUE if the playlist is locked
277  * \return VLC_SUCCESS or VLC_ENOITEM
278  */
279 int playlist_DeleteFromInput( playlist_t *p_playlist, int i_input_id,
280                               bool b_locked )
281 {
282     int i_ret1, i_ret2;
283     PL_LOCK_IF( !b_locked );
284     i_ret1 = DeleteFromInput( p_playlist, i_input_id,
285                              p_playlist->p_root_category, true );
286     i_ret2 = DeleteFromInput( p_playlist, i_input_id,
287                      p_playlist->p_root_onelevel, true );
288     PL_UNLOCK_IF( !b_locked );
289     return ( i_ret1 == VLC_SUCCESS || i_ret2 == VLC_SUCCESS ) ?
290                             VLC_SUCCESS : VLC_ENOITEM;
291 }
292
293 /**
294  * Clear the playlist
295  *
296  * \param p_playlist playlist object
297  * \param b_locked TRUE if the playlist is locked
298  * \return nothing
299  */
300 void playlist_Clear( playlist_t * p_playlist, bool b_locked )
301 {
302     PL_LOCK_IF( !b_locked );
303     playlist_NodeEmpty( p_playlist, p_playlist->p_local_category, true );
304     playlist_NodeEmpty( p_playlist, p_playlist->p_local_onelevel, true );
305     PL_UNLOCK_IF( !b_locked );
306 }
307
308 /**
309  * Delete playlist item
310  *
311  * Remove a playlist item from the playlist, given its id
312  * This function is to be used only by the playlist
313  * \param p_playlist playlist object
314  * \param i_id id of the item do delete
315  * \return VLC_SUCCESS or an error
316  */
317 int playlist_DeleteFromItemId( playlist_t *p_playlist, int i_id )
318 {
319     PL_ASSERT_LOCKED;
320     playlist_item_t *p_item = playlist_ItemGetById( p_playlist, i_id );
321     if( !p_item ) return VLC_EGENERIC;
322     return DeleteInner( p_playlist, p_item, true );
323 }
324
325 /***************************************************************************
326  * Playlist item addition
327  ***************************************************************************/
328 /**
329  * Playlist add
330  *
331  * Add an item to the playlist or the media library
332  * \param p_playlist the playlist to add into
333  * \param psz_uri the mrl to add to the playlist
334  * \param psz_name a text giving a name or description of this item
335  * \param i_mode the mode used when adding
336  * \param i_pos the position in the playlist where to add. If this is
337  *        PLAYLIST_END the item will be added at the end of the playlist
338  *        regardless of its size
339  * \param b_playlist TRUE for playlist, FALSE for media library
340  * \param b_locked TRUE if the playlist is locked
341  * \return The id of the playlist item
342  */
343 int playlist_Add( playlist_t *p_playlist, const char *psz_uri,
344                   const char *psz_name, int i_mode, int i_pos,
345                   bool b_playlist, bool b_locked )
346 {
347     return playlist_AddExt( p_playlist, psz_uri, psz_name,
348                             i_mode, i_pos, -1, 0, NULL, 0, b_playlist, b_locked );
349 }
350
351 /**
352  * Add a MRL into the playlist or the media library, duration and options given
353  *
354  * \param p_playlist the playlist to add into
355  * \param psz_uri the mrl to add to the playlist
356  * \param psz_name a text giving a name or description of this item
357  * \param i_mode the mode used when adding
358  * \param i_pos the position in the playlist where to add. If this is
359  *        PLAYLIST_END the item will be added at the end of the playlist
360  *        regardless of its size
361  * \param i_duration length of the item in milliseconds.
362  * \param i_options the number of options
363  * \param ppsz_options an array of options
364  * \param i_option_flags options flags
365  * \param b_playlist TRUE for playlist, FALSE for media library
366  * \param b_locked TRUE if the playlist is locked
367  * \return The id of the playlist item
368 */
369 int playlist_AddExt( playlist_t *p_playlist, const char * psz_uri,
370                      const char *psz_name, int i_mode, int i_pos,
371                      mtime_t i_duration,
372                      int i_options, const char *const *ppsz_options, unsigned i_option_flags,
373                      bool b_playlist, bool b_locked )
374 {
375     int i_ret;
376     input_item_t *p_input = input_item_NewExt( p_playlist, psz_uri, psz_name,
377                                               i_options, ppsz_options, i_option_flags,
378                                               i_duration );
379
380     i_ret = playlist_AddInput( p_playlist, p_input, i_mode, i_pos, b_playlist,
381                                b_locked );
382     int i_id = (i_ret == VLC_SUCCESS) ? p_input->i_id : -1;
383
384     vlc_gc_decref( p_input );
385
386     return i_id;
387 }
388
389 /**
390  * Add an input item to the playlist node
391  *
392  * \param p_playlist the playlist to add into
393  * \param p_input the input item to add
394  * \param i_mode the mode used when adding
395  * \param i_pos the position in the playlist where to add. If this is
396  *        PLAYLIST_END the item will be added at the end of the playlist
397  *        regardless of its size
398  * \param b_playlist TRUE for playlist, FALSE for media library
399  * \param b_locked TRUE if the playlist is locked
400  * \return VLC_SUCCESS or VLC_ENOMEM or VLC_EGENERIC
401 */
402 int playlist_AddInput( playlist_t* p_playlist, input_item_t *p_input,
403                        int i_mode, int i_pos, bool b_playlist,
404                        bool b_locked )
405 {
406     playlist_item_t *p_item_cat, *p_item_one;
407     if( p_playlist->b_die ) return VLC_EGENERIC;
408     if( !pl_priv(p_playlist)->b_doing_ml )
409         PL_DEBUG( "adding item `%s' ( %s )", p_input->psz_name,
410                                              p_input->psz_uri );
411
412     PL_LOCK_IF( !b_locked );
413
414     /* Add to ONELEVEL */
415     p_item_one = playlist_ItemNewFromInput( p_playlist, p_input );
416     if( p_item_one == NULL ) return VLC_ENOMEM;
417     AddItem( p_playlist, p_item_one,
418              b_playlist ? p_playlist->p_local_onelevel :
419                           p_playlist->p_ml_onelevel , i_mode, i_pos );
420
421     /* Add to CATEGORY */
422     p_item_cat = playlist_ItemNewFromInput( p_playlist, p_input );
423     if( p_item_cat == NULL ) return VLC_ENOMEM;
424     AddItem( p_playlist, p_item_cat,
425              b_playlist ? p_playlist->p_local_category :
426                           p_playlist->p_ml_category , i_mode, i_pos );
427
428     GoAndPreparse( p_playlist, i_mode, p_item_cat, p_item_one );
429
430     PL_UNLOCK_IF( !b_locked );
431     return VLC_SUCCESS;
432 }
433
434 /**
435  * Add input
436  *
437  * Add an input item to p_direct_parent in the category tree, and to the
438  * matching top category in onelevel
439  * \param p_playlist the playlist to add into
440  * \param p_input the input item to add
441  * \param p_direct_parent the parent item to add into
442  * \param i_mode the mode used when adding
443  * \param i_pos the position in the playlist where to add. If this is
444  *        PLAYLIST_END the item will be added at the end of the playlist
445  *        regardless of its size
446  * \param i_cat id of the items category
447  * \param i_one id of the item onelevel category
448  * \param b_locked TRUE if the playlist is locked
449  * \return VLC_SUCCESS if success, VLC_EGENERIC if fail, VLC_ENOMEM if OOM
450  */
451 int playlist_BothAddInput( playlist_t *p_playlist,
452                            input_item_t *p_input,
453                            playlist_item_t *p_direct_parent,
454                            int i_mode, int i_pos,
455                            int *i_cat, int *i_one, bool b_locked )
456 {
457     playlist_item_t *p_item_cat, *p_item_one, *p_up;
458     int i_top;
459     assert( p_input );
460
461     if( !vlc_object_alive( p_playlist ) )
462         return VLC_EGENERIC;
463
464     PL_LOCK_IF( !b_locked );
465
466     /* Add to category */
467     p_item_cat = playlist_ItemNewFromInput( p_playlist, p_input );
468     if( p_item_cat == NULL ) return VLC_ENOMEM;
469     AddItem( p_playlist, p_item_cat, p_direct_parent, i_mode, i_pos );
470
471     /* Add to onelevel */
472     /** \todo make a faster case for ml import */
473     p_item_one = playlist_ItemNewFromInput( p_playlist, p_input );
474     if( p_item_one == NULL ) return VLC_ENOMEM;
475
476     p_up = p_direct_parent;
477     while( p_up->p_parent != p_playlist->p_root_category )
478     {
479         p_up = p_up->p_parent;
480     }
481     for( i_top = 0 ; i_top < p_playlist->p_root_onelevel->i_children; i_top++ )
482     {
483         if( p_playlist->p_root_onelevel->pp_children[i_top]->p_input->i_id ==
484                              p_up->p_input->i_id )
485         {
486             AddItem( p_playlist, p_item_one,
487                      p_playlist->p_root_onelevel->pp_children[i_top],
488                      i_mode, i_pos );
489             break;
490         }
491     }
492     GoAndPreparse( p_playlist, i_mode, p_item_cat, p_item_one );
493
494     if( i_cat ) *i_cat = p_item_cat->i_id;
495     if( i_one ) *i_one = p_item_one->i_id;
496
497     PL_UNLOCK_IF( !b_locked );
498     return VLC_SUCCESS;
499 }
500
501 /**
502  * Add an input item to a given node
503  *
504  * \param p_playlist the playlist to add into
505  * \param p_input the input item to add
506  * \param p_parent the parent item to add into
507  * \param i_mode the mode used when addin
508  * \param i_pos the position in the playlist where to add. If this is
509  *        PLAYLIST_END the item will be added at the end of the playlist
510  *        regardless of its size
511  * \param b_locked TRUE if the playlist is locked
512  * \return the new playlist item
513  */
514 playlist_item_t * playlist_NodeAddInput( playlist_t *p_playlist,
515                                          input_item_t *p_input,
516                                          playlist_item_t *p_parent,
517                                          int i_mode, int i_pos,
518                                          bool b_locked )
519 {
520     playlist_item_t *p_item;
521     assert( p_input );
522     assert( p_parent && p_parent->i_children != -1 );
523
524     if( p_playlist->b_die )
525         return NULL;
526     PL_LOCK_IF( !b_locked );
527
528     p_item = playlist_ItemNewFromInput( p_playlist, p_input );
529     if( p_item == NULL ) return NULL;
530     AddItem( p_playlist, p_item, p_parent, i_mode, i_pos );
531
532     PL_UNLOCK_IF( !b_locked );
533
534     return p_item;
535 }
536
537 /*****************************************************************************
538  * Playlist item misc operations
539  *****************************************************************************/
540
541 /**
542  * Item to node
543  *
544  * Transform an item to a node. Return the node in the category tree, or NULL
545  * if not found there
546  * This function must be entered without the playlist lock
547  * \param p_playlist the playlist object
548  * \param p_item the item to transform
549  * \param b_locked TRUE if the playlist is locked
550  * \return the item transform in a node
551  */
552 static playlist_item_t *ItemToNode( playlist_t *p_playlist,
553                                     playlist_item_t *p_item,
554                                     bool b_locked )
555 {
556
557     playlist_item_t *p_item_in_category;
558     /* What we do
559      * Find the input in CATEGORY.
560      *  - If we find it
561      *    - change it to node
562      *    - we'll return it at the end
563      *    - If we are a direct child of onelevel root, change to node, else
564      *      delete the input from ONELEVEL
565      *  - If we don't find it, just change to node (we are probably in VLM)
566      *    and return NULL
567      *
568      * If we were in ONELEVEL, we thus retrieve the node in CATEGORY (will be
569      * useful for later BothAddInput )
570      */
571
572     PL_LOCK_IF( !b_locked );
573
574     /* Fast track the media library, no time to loose */
575     if( p_item == p_playlist->p_ml_category ) {
576         PL_UNLOCK_IF( !b_locked );
577         return p_item;
578     }
579
580     /** \todo First look if we don't already have it */
581     p_item_in_category = playlist_ItemFindFromInputAndRoot(
582                                             p_playlist, p_item->p_input->i_id,
583                                             p_playlist->p_root_category,
584                                             true );
585
586     if( p_item_in_category )
587     {
588         playlist_item_t *p_item_in_one = playlist_ItemFindFromInputAndRoot(
589                                             p_playlist, p_item->p_input->i_id,
590                                             p_playlist->p_root_onelevel,
591                                             true );
592         assert( p_item_in_one );
593
594         /* We already have it, and there is nothing more to do */
595         ChangeToNode( p_playlist, p_item_in_category );
596
597         /* Item in one is a root, change it to node */
598         if( p_item_in_one->p_parent == p_playlist->p_root_onelevel )
599             ChangeToNode( p_playlist, p_item_in_one );
600         else
601         {
602             playlist_item_t *p_status_item = get_current_status_item( p_playlist );
603             playlist_item_t *p_status_node = get_current_status_node( p_playlist );
604             if( p_item_in_one == p_status_item )
605             {
606                 /* We're deleting the current playlist item. Update
607                  * the playlist object to point at the previous item
608                  * so the playlist won't be restarted */
609                 playlist_item_t *p_prev_status_item = NULL;
610                 int i = 0;
611                 while( i < p_status_node->i_children &&
612                        p_status_node->pp_children[i] != p_status_item )
613                 {
614                     p_prev_status_item = p_status_node->pp_children[i];
615                     i++;
616                 }
617                 if( i == p_status_node->i_children )
618                     p_prev_status_item = NULL;
619                 if( p_prev_status_item )
620                     set_current_status_item( p_playlist, p_prev_status_item );
621             }
622             DeleteFromInput( p_playlist, p_item_in_one->p_input->i_id,
623                              p_playlist->p_root_onelevel, false );
624         }
625         pl_priv(p_playlist)->b_reset_currently_playing = true;
626         vlc_cond_signal( &pl_priv(p_playlist)->signal );
627         var_SetInteger( p_playlist, "item-change", p_item_in_category->
628                                                         p_input->i_id );
629         PL_UNLOCK_IF( !b_locked );
630         return p_item_in_category;
631     }
632     else
633     {
634         ChangeToNode( p_playlist, p_item );
635         PL_UNLOCK_IF( !b_locked );
636         return p_item;
637     }
638 }
639
640 /**
641  * Find an item within a root, given its input id.
642  *
643  * \param p_playlist the playlist object
644  * \param i_input_id id of the input
645  * \param p_root root playlist item
646  * \param b_items_only TRUE if we want the item himself
647  * \return the first found item, or NULL if not found
648  */
649 playlist_item_t *playlist_ItemFindFromInputAndRoot( playlist_t *p_playlist,
650                                                     int i_input_id,
651                                                     playlist_item_t *p_root,
652                                                     bool b_items_only )
653 {
654     int i;
655     for( i = 0 ; i< p_root->i_children ; i++ )
656     {
657         if( ( b_items_only ? p_root->pp_children[i]->i_children == -1 : 1 ) &&
658             p_root->pp_children[i]->p_input->i_id == i_input_id )
659         {
660             return p_root->pp_children[i];
661         }
662         else if( p_root->pp_children[i]->i_children >= 0 )
663         {
664             playlist_item_t *p_search =
665                  playlist_ItemFindFromInputAndRoot( p_playlist, i_input_id,
666                                                     p_root->pp_children[i],
667                                                     b_items_only );
668             if( p_search ) return p_search;
669         }
670     }
671     return NULL;
672 }
673
674
675 static int TreeMove( playlist_t *p_playlist, playlist_item_t *p_item,
676                      playlist_item_t *p_node, int i_newpos )
677 {
678     int j;
679     playlist_item_t *p_detach = p_item->p_parent;
680     (void)p_playlist;
681
682     if( p_node->i_children == -1 ) return VLC_EGENERIC;
683
684     for( j = 0; j < p_detach->i_children; j++ )
685     {
686          if( p_detach->pp_children[j] == p_item ) break;
687     }
688     REMOVE_ELEM( p_detach->pp_children, p_detach->i_children, j );
689
690     /* If j < i_newpos, we are moving the element from the top to the
691      * down of the playlist. So when removing the element we have
692      * to change the position as we loose one element
693      */
694     if( j < i_newpos )
695         i_newpos--;
696
697     /* Attach to new parent */
698     INSERT_ELEM( p_node->pp_children, p_node->i_children, i_newpos, p_item );
699     p_item->p_parent = p_node;
700
701     return VLC_SUCCESS;
702 }
703
704 /**
705  * Moves an item
706  *
707  * This function must be entered with the playlist lock
708  *
709  * \param p_playlist the playlist
710  * \param p_item the item to move
711  * \param p_node the new parent of the item
712  * \param i_newpos the new position under this new parent
713  * \return VLC_SUCCESS or an error
714  */
715 int playlist_TreeMove( playlist_t * p_playlist, playlist_item_t *p_item,
716                        playlist_item_t *p_node, int i_newpos )
717 {
718     int i_ret;
719     PL_ASSERT_LOCKED;
720
721     /* Drop on a top level node. Move in the two trees */
722     if( p_node->p_parent == p_playlist->p_root_category ||
723         p_node->p_parent == p_playlist->p_root_onelevel )
724     {
725         /* Fixme: avoid useless lookups but we need some clean helpers */
726         {
727             /* Fixme: if we try to move a node on a top-level node, it will
728              * fail because the node doesn't exist in onelevel and we will
729              * do some shit in onelevel. We should recursively move all items
730              * within the node */
731             playlist_item_t *p_node_onelevel;
732             playlist_item_t *p_item_onelevel;
733             p_node_onelevel = playlist_ItemFindFromInputAndRoot( p_playlist,
734                                                 p_node->p_input->i_id,
735                                                 p_playlist->p_root_onelevel,
736                                                 false );
737             p_item_onelevel = playlist_ItemFindFromInputAndRoot( p_playlist,
738                                                 p_item->p_input->i_id,
739                                                 p_playlist->p_root_onelevel,
740                                                 false );
741             if( p_node_onelevel && p_item_onelevel )
742                 TreeMove( p_playlist, p_item_onelevel, p_node_onelevel, i_newpos );
743         }
744         {
745             playlist_item_t *p_node_category;
746             playlist_item_t *p_item_category;
747             p_node_category = playlist_ItemFindFromInputAndRoot( p_playlist,
748                                                 p_node->p_input->i_id,
749                                                 p_playlist->p_root_category,
750                                                 false );
751             p_item_category = playlist_ItemFindFromInputAndRoot( p_playlist,
752                                                 p_item->p_input->i_id,
753                                                 p_playlist->p_root_category,
754                                                 false );
755             if( p_node_category && p_item_category )
756                 TreeMove( p_playlist, p_item_category, p_node_category, 0 );
757         }
758         i_ret = VLC_SUCCESS;
759     }
760     else
761         i_ret = TreeMove( p_playlist, p_item, p_node, i_newpos );
762     pl_priv(p_playlist)->b_reset_currently_playing = true;
763     vlc_cond_signal( &pl_priv(p_playlist)->signal );
764     return i_ret;
765 }
766
767 /**
768  * Send a notification that an item has been added to a node
769  *
770  * \param p_playlist the playlist object
771  * \param i_item_id id of the item added
772  * \param i_node_id id of the node in wich the item was added
773  * \param b_signal TRUE if the function must send a signal
774  * \return nothing
775  */
776 void playlist_SendAddNotify( playlist_t *p_playlist, int i_item_id,
777                              int i_node_id, bool b_signal )
778 {
779     vlc_value_t val;
780     PL_ASSERT_LOCKED;
781
782     playlist_add_t *p_add = (playlist_add_t *)malloc( sizeof( playlist_add_t) );
783     if( !p_add )
784         return;
785
786     p_add->i_item = i_item_id;
787     p_add->i_node = i_node_id;
788     val.p_address = p_add;
789     pl_priv(p_playlist)->b_reset_currently_playing = true;
790     if( b_signal )
791         vlc_cond_signal( &pl_priv(p_playlist)->signal );
792
793     var_Set( p_playlist, "item-append", val );
794     free( p_add );
795 }
796
797 /***************************************************************************
798  * The following functions are local
799  ***************************************************************************/
800
801 /* Enqueue an item for preparsing, and play it, if needed */
802 static void GoAndPreparse( playlist_t *p_playlist, int i_mode,
803                            playlist_item_t *p_item_cat,
804                            playlist_item_t *p_item_one )
805 {
806     PL_ASSERT_LOCKED;
807     if( (i_mode & PLAYLIST_GO ) )
808     {
809         playlist_item_t *p_parent = p_item_one;
810         playlist_item_t *p_toplay = NULL;
811         while( p_parent )
812         {
813             if( p_parent == p_playlist->p_root_category )
814             {
815                 p_toplay = p_item_cat; break;
816             }
817             else if( p_parent == p_playlist->p_root_onelevel )
818             {
819                 p_toplay = p_item_one; break;
820             }
821             p_parent = p_parent->p_parent;
822         }
823         assert( p_toplay );
824         pl_priv(p_playlist)->request.b_request = true;
825         pl_priv(p_playlist)->request.i_skip = 0;
826         pl_priv(p_playlist)->request.p_item = p_toplay;
827         if( pl_priv(p_playlist)->p_input )
828             input_StopThread( pl_priv(p_playlist)->p_input );
829         pl_priv(p_playlist)->request.i_status = PLAYLIST_RUNNING;
830         vlc_cond_signal( &pl_priv(p_playlist)->signal );
831     }
832     /* Preparse if PREPARSE or SPREPARSE & not enough meta */
833     char *psz_artist = input_item_GetArtist( p_item_cat->p_input );
834     char *psz_album = input_item_GetAlbum( p_item_cat->p_input );
835     if( pl_priv(p_playlist)->b_auto_preparse &&
836           (i_mode & PLAYLIST_PREPARSE ||
837           ( i_mode & PLAYLIST_SPREPARSE &&
838             ( EMPTY_STR( psz_artist ) || ( EMPTY_STR( psz_album ) ) )
839           ) ) )
840         playlist_PreparseEnqueue( p_playlist, p_item_cat->p_input, pl_Locked );
841     /* If we already have it, signal it */
842     else if( !EMPTY_STR( psz_artist ) && !EMPTY_STR( psz_album ) )
843         input_item_SetPreparsed( p_item_cat->p_input, true );
844     free( psz_artist );
845     free( psz_album );
846 }
847
848 /* Add the playlist item to the requested node and fire a notification */
849 static void AddItem( playlist_t *p_playlist, playlist_item_t *p_item,
850                      playlist_item_t *p_node, int i_mode, int i_pos )
851 {
852     PL_ASSERT_LOCKED;
853     ARRAY_APPEND(p_playlist->items, p_item);
854     ARRAY_APPEND(p_playlist->all_items, p_item);
855
856     if( i_pos == PLAYLIST_END )
857         playlist_NodeAppend( p_playlist, p_item, p_node );
858     else
859         playlist_NodeInsert( p_playlist, p_item, p_node, i_pos );
860
861     if( !pl_priv(p_playlist)->b_doing_ml )
862         playlist_SendAddNotify( p_playlist, p_item->i_id, p_node->i_id,
863                                  !( i_mode & PLAYLIST_NO_REBUILD ) );
864 }
865
866 /* Actually convert an item to a node */
867 static void ChangeToNode( playlist_t *p_playlist, playlist_item_t *p_item )
868 {
869     int i;
870     if( p_item->i_children == -1 )
871         p_item->i_children = 0;
872
873     /* Remove it from the array of available items */
874     ARRAY_BSEARCH( p_playlist->items,->i_id, int, p_item->i_id, i );
875     if( i != -1 )
876         ARRAY_REMOVE( p_playlist->items, i );
877 }
878
879 /* Do the actual removal */
880 static int DeleteInner( playlist_t * p_playlist, playlist_item_t *p_item,
881                         bool b_stop )
882 {
883     int i;
884     int i_id = p_item->i_id;
885     PL_ASSERT_LOCKED;
886
887     if( p_item->i_children > -1 )
888     {
889         return playlist_NodeDelete( p_playlist, p_item, true, false );
890     }
891     pl_priv(p_playlist)->b_reset_currently_playing = true;
892     var_SetInteger( p_playlist, "item-deleted", i_id );
893
894     /* Remove the item from the bank */
895     ARRAY_BSEARCH( p_playlist->all_items,->i_id, int, i_id, i );
896     if( i != -1 )
897         ARRAY_REMOVE( p_playlist->all_items, i );
898
899     ARRAY_BSEARCH( p_playlist->items,->i_id, int, i_id, i );
900     if( i != -1 )
901         ARRAY_REMOVE( p_playlist->items, i );
902
903     /* Check if it is the current item */
904     if( get_current_status_item( p_playlist ) == p_item )
905     {
906         /* Hack we don't call playlist_Control for lock reasons */
907         if( b_stop )
908         {
909             pl_priv(p_playlist)->request.i_status = PLAYLIST_STOPPED;
910             pl_priv(p_playlist)->request.b_request = true;
911             pl_priv(p_playlist)->request.p_item = NULL;
912             msg_Info( p_playlist, "stopping playback" );
913             vlc_cond_signal( &pl_priv(p_playlist)->signal );
914         }
915     }
916
917     PL_DEBUG( "deleting item `%s'", p_item->p_input->psz_name );
918
919     /* Remove the item from its parent */
920     playlist_NodeRemoveItem( p_playlist, p_item, p_item->p_parent );
921
922     playlist_ItemRelease( p_item );
923
924     return VLC_SUCCESS;
925 }