1 /*****************************************************************************
2 * vlc_playlist.h : Playlist functions
3 *****************************************************************************
4 * Copyright (C) 1999-2004 the VideoLAN team
7 * Authors: Samuel Hocevar <sam@zoy.org>
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.
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.
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 *****************************************************************************/
24 #ifndef _VLC_PLAYLIST_H_
25 #define _VLC_PLAYLIST_H_
29 TYPEDEF_ARRAY(playlist_item_t
*, playlist_item_array_t
);
30 TYPEDEF_ARRAY(input_item_t
*, input_item_array_t
);
33 * This file contain structures and function prototypes related
34 * to the playlist in vlc
36 * \defgroup vlc_playlist Playlist
41 * playlist export helper structure
43 struct playlist_export_t
47 playlist_item_t
*p_root
;
51 * playlist item / node
54 struct playlist_item_t
56 input_item_t
*p_input
; /**< input item descriptor */
58 /* Tree specific fields */
59 int i_children
; /**< Number of children
61 playlist_item_t
**pp_children
; /**< Children nodes/items */
62 playlist_item_t
*p_parent
; /**< Item parent */
64 int i_id
; /**< Playlist item specific id */
66 uint8_t i_flags
; /**< Flags */
69 #define PLAYLIST_SAVE_FLAG 0x0001 /**< Must it be saved */
70 #define PLAYLIST_SKIP_FLAG 0x0002 /**< Must playlist skip after it ? */
71 #define PLAYLIST_DBL_FLAG 0x0004 /**< Is it disabled ? */
72 #define PLAYLIST_RO_FLAG 0x0008 /**< Write-enabled ? */
73 #define PLAYLIST_REMOVE_FLAG 0x0010 /**< Remove this item at the end */
74 #define PLAYLIST_EXPANDED_FLAG 0x0020 /**< Expanded node */
80 { PLAYLIST_STOPPED
,PLAYLIST_RUNNING
,PLAYLIST_PAUSED
} playlist_status_t
;
83 struct services_discovery_t
90 services_discovery_sys_t
*p_sys
;
91 void (*pf_run
) ( services_discovery_t
*);
94 /** Structure containing information about the playlist */
100 These members are uniq to playlist_t
103 int i_enabled
; /**< How many items are enabled ? */
105 playlist_item_array_t items
; /**< Arrays of items */
106 playlist_item_array_t all_items
; /**< Array of items and nodes */
108 input_item_array_t input_items
; /**< Array of input items */
110 playlist_item_array_t current
; /**< Items currently being played */
111 int i_current_index
; /**< Index in current array */
112 /** Reset current item ? */
113 vlc_bool_t b_reset_currently_playing
;
114 mtime_t last_rebuild_date
;
116 int i_last_playlist_id
; /**< Last id to an item */
117 int i_last_input_id
; /**< Last id on an input */
119 services_discovery_t
**pp_sds
;
122 /* Predefined items */
123 playlist_item_t
* p_root_category
;
124 playlist_item_t
* p_root_onelevel
;
125 playlist_item_t
* p_local_category
; /** < "Playlist" in CATEGORY view */
126 playlist_item_t
* p_ml_category
; /** < "Library" in CATEGORY view */
127 playlist_item_t
* p_local_onelevel
; /** < "Playlist" in ONELEVEL view */
128 playlist_item_t
* p_ml_onelevel
; /** < "Library" in ONELEVEL iew */
130 vlc_bool_t b_always_tree
;/**< Always display as tree */
131 vlc_bool_t b_never_tree
;/**< Never display as tree */
133 vlc_bool_t b_doing_ml
; /**< Doing media library stuff, */
137 input_thread_t
* p_input
; /**< the input thread associated
138 * with the current item */
139 int i_sort
; /**< Last sorting applied to the playlist */
140 int i_order
; /**< Last ordering applied to the playlist */
142 vlc_bool_t b_cant_sleep
;
143 playlist_preparse_t
*p_preparse
; /**< Preparser object */
144 playlist_fetcher_t
*p_fetcher
;/**< Meta and art fetcher object */
146 vlc_mutex_t gc_lock
; /**< Lock to protect the garbage collection */
149 /* Current status. These fields are readonly, only the playlist
150 * main loop can touch it*/
151 playlist_status_t i_status
; /**< Current status of playlist */
152 playlist_item_t
* p_item
; /**< Currently playing/active item */
153 playlist_item_t
* p_node
; /**< Current node to play from */
157 /* Request. Use this to give orders to the playlist main loop */
158 int i_status
; /**< requested playlist status */
159 playlist_item_t
* p_node
; /**< requested node to play from */
160 playlist_item_t
* p_item
; /**< requested item to play in the node */
162 int i_skip
; /**< Number of items to skip */
164 vlc_bool_t b_request
;/**< Set to true by the requester
165 The playlist sets it back to false
166 when processing the request */
167 vlc_mutex_t lock
; /**< Lock to protect request */
170 // Playlist-unrelated fields
171 interaction_t
*p_interaction
; /**< Interaction manager */
172 /** The input thread computing stats */
173 input_thread_t
*p_stats_computer
;
174 global_stats_t
*p_stats
; /**< Global statistics */
178 /* Helper to add an item */
179 struct playlist_add_t
188 #define SORT_TITLE_NODES_FIRST 2
189 #define SORT_ARTIST 3
191 #define SORT_RANDOM 5
192 #define SORT_DURATION 6
193 #define SORT_TITLE_NUMERIC 7
196 #define ORDER_NORMAL 0
197 #define ORDER_REVERSE 1
199 /*****************************************************************************
201 *****************************************************************************/
204 #define playlist_ThreadCreate(a) __playlist_ThreadCreate(VLC_OBJECT(a))
205 void __playlist_ThreadCreate ( vlc_object_t
* );
206 int playlist_ThreadDestroy ( playlist_t
* );
209 #define PL_LOCK vlc_mutex_lock( &p_playlist->object_lock );
210 #define PL_UNLOCK vlc_mutex_unlock( &p_playlist->object_lock );
212 #define pl_Get( a ) a->p_libvlc->p_playlist
213 #define pl_Yield( a ) __pl_Yield( VLC_OBJECT(a) )
214 static inline playlist_t
*__pl_Yield( vlc_object_t
*p_this
)
216 assert( p_this
->p_libvlc
->p_playlist
);
217 vlc_object_yield( p_this
->p_libvlc
->p_playlist
);
218 return p_this
->p_libvlc
->p_playlist
;
220 #define pl_Release(a) vlc_object_release( a->p_libvlc->p_playlist );
222 /* Playlist control */
223 #define playlist_Play(p) playlist_LockControl(p,PLAYLIST_PLAY )
224 #define playlist_Pause(p) playlist_LockControl(p,PLAYLIST_PAUSE )
225 #define playlist_Stop(p) playlist_LockControl(p,PLAYLIST_STOP )
226 #define playlist_Next(p) playlist_LockControl(p,PLAYLIST_SKIP, 1)
227 #define playlist_Prev(p) playlist_LockControl(p,PLAYLIST_SKIP, -1)
228 #define playlist_Skip(p,i) playlist_LockControl(p,PLAYLIST_SKIP, i)
230 VLC_EXPORT( int, playlist_Control
, ( playlist_t
*, int, ... ) );
231 VLC_EXPORT( int, playlist_LockControl
, ( playlist_t
*, int, ... ) );
233 VLC_EXPORT( void, playlist_Clear
, ( playlist_t
* ) );
234 VLC_EXPORT( void, playlist_LockClear
, ( playlist_t
* ) );
236 VLC_EXPORT( int, playlist_PreparseEnqueue
, (playlist_t
*, input_item_t
*) );
237 VLC_EXPORT( int, playlist_PreparseEnqueueItem
, (playlist_t
*, playlist_item_t
*) );
238 VLC_EXPORT( int, playlist_AskForArtEnqueue
, (playlist_t
*, input_item_t
*) );
240 /* Services discovery */
242 VLC_EXPORT( int, playlist_ServicesDiscoveryAdd
, (playlist_t
*, const char *));
243 VLC_EXPORT( int, playlist_ServicesDiscoveryRemove
, (playlist_t
*, const char *));
244 VLC_EXPORT( int, playlist_AddSDModules
, (playlist_t
*, char *));
245 VLC_EXPORT( vlc_bool_t
, playlist_IsServicesDiscoveryLoaded
, ( playlist_t
*,const char *));
247 /* Playlist sorting */
248 VLC_EXPORT( int, playlist_TreeMove
, ( playlist_t
*, playlist_item_t
*, playlist_item_t
*, int ) );
249 VLC_EXPORT( int, playlist_NodeSort
, ( playlist_t
*, playlist_item_t
*,int, int ) );
250 VLC_EXPORT( int, playlist_RecursiveNodeSort
, ( playlist_t
*, playlist_item_t
*,int, int ) );
253 VLC_EXPORT( int, playlist_Import
, ( playlist_t
*, const char *, playlist_item_t
*, vlc_bool_t
) );
254 VLC_EXPORT( int, playlist_Export
, ( playlist_t
*, const char *, playlist_item_t
*, const char * ) );
256 /********************************************************
258 ********************************************************/
260 /*************************** Item creation **************************/
262 VLC_EXPORT( playlist_item_t
* , playlist_ItemNewWithType
, ( vlc_object_t
*,const char *,const char *, int , const char **, int, int) );
264 #define playlist_ItemNew( a , b, c ) __playlist_ItemNew(VLC_OBJECT(a) , b , c )
265 /** Create a new item, without adding it to the playlist
266 * \param p_obj a vlc object (anyone will do)
267 * \param psz_uri the mrl of the item
268 * \param psz_name a text giving a name or description of the item
269 * \return the new item or NULL on failure
271 static inline playlist_item_t
* __playlist_ItemNew( vlc_object_t
*p_obj
,
272 const char *psz_uri
, const char *psz_name
)
274 /* 0 = ITEM_TYPE_UNKNOWN */
275 return playlist_ItemNewWithType( p_obj
, psz_uri
, psz_name
, 0, NULL
, -1,0);
278 #define playlist_ItemNewFromInput(a,b) __playlist_ItemNewFromInput(VLC_OBJECT(a),b)
279 VLC_EXPORT( playlist_item_t
*, __playlist_ItemNewFromInput
, ( vlc_object_t
*p_obj
,input_item_t
*p_input
) );
281 /*************************** Item deletion **************************/
282 VLC_EXPORT( int, playlist_ItemDelete
, ( playlist_item_t
* ) );
283 VLC_EXPORT( int, playlist_DeleteAllFromInput
, ( playlist_t
*, int ) );
284 VLC_EXPORT( int, playlist_DeleteFromInput
, ( playlist_t
*, int, playlist_item_t
*, vlc_bool_t
) );
285 VLC_EXPORT( int, playlist_DeleteFromItemId
, ( playlist_t
*, int ) );
286 VLC_EXPORT( int, playlist_LockDelete
, ( playlist_t
*, int ) );
287 VLC_EXPORT( int, playlist_LockDeleteAllFromInput
, ( playlist_t
*, int ) );
289 /*************************** Item fields accessors **************************/
290 VLC_EXPORT( int, playlist_ItemSetName
, (playlist_item_t
*, char * ) );
292 /******************** Item addition ********************/
293 VLC_EXPORT( int, playlist_Add
, ( playlist_t
*, const char *, const char *, int, int, vlc_bool_t
) );
294 VLC_EXPORT( int, playlist_AddExt
, ( playlist_t
*, const char *, const char *, int, int, mtime_t
, const char **,int, vlc_bool_t
) );
295 VLC_EXPORT( int, playlist_AddInput
, ( playlist_t
*, input_item_t
*,int , int, vlc_bool_t
) );
296 VLC_EXPORT( playlist_item_t
*, playlist_NodeAddInput
, ( playlist_t
*, input_item_t
*,playlist_item_t
*,int , int ) );
297 VLC_EXPORT( void, playlist_NodeAddItem
, ( playlist_t
*, playlist_item_t
*, playlist_item_t
*,int , int ) );
298 VLC_EXPORT( int, playlist_BothAddInput
, ( playlist_t
*, input_item_t
*,playlist_item_t
*,int , int ) );
299 VLC_EXPORT( void, playlist_AddWhereverNeeded
, (playlist_t
* , input_item_t
*, playlist_item_t
*,playlist_item_t
*,vlc_bool_t
, int ) );
301 /** Add a MRL into the playlist.
304 static inline int playlist_PlaylistAdd( playlist_t
*p_playlist
,
305 const char *psz_uri
, const char *psz_name
,
306 int i_mode
, int i_pos
)
308 return playlist_Add( p_playlist
, psz_uri
, psz_name
, i_mode
, i_pos
,
312 /** Add a MRL to the media library
315 static inline int playlist_MLAdd( playlist_t
*p_playlist
, const char *psz_uri
,
316 const char *psz_name
, int i_mode
, int i_pos
)
318 return playlist_Add( p_playlist
, psz_uri
, psz_name
, i_mode
, i_pos
,
322 /** Add a MRL to the playlist, with duration and options given
323 * \see playlist_AddExt
325 static inline int playlist_PlaylistAddExt( playlist_t
*p_playlist
,
326 const char * psz_uri
, const char *psz_name
, int i_mode
, int i_pos
,
327 mtime_t i_duration
, const char **ppsz_options
, int i_options
)
329 return playlist_AddExt( p_playlist
, psz_uri
, psz_name
, i_mode
, i_pos
,
330 i_duration
, ppsz_options
, i_options
, VLC_TRUE
);
333 /** Add a MRL to the media library, with duration and options given
334 * \see playlist_AddExt
336 static inline int playlist_MLAddExt( playlist_t
*p_playlist
,
337 const char * psz_uri
, const char *psz_name
, int i_mode
, int i_pos
,
338 mtime_t i_duration
, const char **ppsz_options
, int i_options
)
340 return playlist_AddExt( p_playlist
, psz_uri
, psz_name
, i_mode
, i_pos
,
341 i_duration
, ppsz_options
, i_options
, VLC_FALSE
);
344 /** Add an input item to the playlist node
345 * \see playlist_AddInput
347 static inline int playlist_PlaylistAddInput( playlist_t
* p_playlist
,
348 input_item_t
*p_input
, int i_mode
, int i_pos
)
350 return playlist_AddInput( p_playlist
, p_input
, i_mode
, i_pos
, VLC_TRUE
);
353 /** Add an input item to the media library
354 * \see playlist_AddInput
356 static inline int playlist_MLAddInput( playlist_t
* p_playlist
,
357 input_item_t
*p_input
, int i_mode
, int i_pos
)
359 return playlist_AddInput( p_playlist
, p_input
, i_mode
, i_pos
, VLC_FALSE
);
362 /********************** Misc item operations **********************/
363 VLC_EXPORT( playlist_item_t
*, playlist_ItemToNode
, (playlist_t
*,playlist_item_t
*) );
364 VLC_EXPORT( playlist_item_t
*, playlist_LockItemToNode
, (playlist_t
*,playlist_item_t
*) );
366 playlist_item_t
*playlist_ItemFindFromInputAndRoot( playlist_t
*p_playlist
,
367 int i_input_id
, playlist_item_t
*p_root
,
370 /********************************** Item search *************************/
371 VLC_EXPORT( playlist_item_t
*, playlist_ItemGetById
, (playlist_t
*, int) );
372 VLC_EXPORT( playlist_item_t
*, playlist_ItemGetByInput
, (playlist_t
*,input_item_t
* ) );
374 static inline playlist_item_t
*playlist_LockItemGetById( playlist_t
*p_playlist
,
377 playlist_item_t
*p_ret
;
378 vlc_mutex_lock( &p_playlist
->object_lock
);
379 p_ret
= playlist_ItemGetById( p_playlist
, i_id
);
380 vlc_mutex_unlock( &p_playlist
->object_lock
);
384 static inline playlist_item_t
*playlist_LockItemGetByInput(
385 playlist_t
*p_playlist
, input_item_t
*p_item
)
387 playlist_item_t
*p_ret
;
388 vlc_mutex_lock( &p_playlist
->object_lock
);
389 p_ret
= playlist_ItemGetByInput( p_playlist
, p_item
);
390 vlc_mutex_unlock( &p_playlist
->object_lock
);
394 VLC_EXPORT( int, playlist_LiveSearchUpdate
, (playlist_t
*, playlist_item_t
*, const char *) );
396 /********************************************************
398 ********************************************************/
399 VLC_EXPORT(void, playlist_NodeDump
, ( playlist_t
*p_playlist
, playlist_item_t
*p_item
, int i_level
) );
400 VLC_EXPORT( int, playlist_NodeChildrenCount
, (playlist_t
*,playlist_item_t
* ) );
402 /* Node management */
403 VLC_EXPORT( playlist_item_t
*, playlist_NodeCreate
, ( playlist_t
*, char *, playlist_item_t
* p_parent
) );
404 VLC_EXPORT( int, playlist_NodeAppend
, (playlist_t
*,playlist_item_t
*,playlist_item_t
*) );
405 VLC_EXPORT( int, playlist_NodeInsert
, (playlist_t
*,playlist_item_t
*,playlist_item_t
*, int) );
406 VLC_EXPORT( int, playlist_NodeRemoveItem
, (playlist_t
*,playlist_item_t
*,playlist_item_t
*) );
407 VLC_EXPORT( playlist_item_t
*, playlist_ChildSearchName
, (playlist_item_t
*, const char* ) );
408 VLC_EXPORT( int, playlist_NodeDelete
, ( playlist_t
*, playlist_item_t
*, vlc_bool_t
, vlc_bool_t
) );
409 VLC_EXPORT( int, playlist_NodeEmpty
, ( playlist_t
*, playlist_item_t
*, vlc_bool_t
) );
410 VLC_EXPORT( void, playlist_NodesPairCreate
, (playlist_t
*, char *, playlist_item_t
**, playlist_item_t
**, vlc_bool_t
) );
411 VLC_EXPORT( playlist_item_t
*, playlist_GetPreferredNode
, ( playlist_t
*p_playlist
, playlist_item_t
*p_node
) );
413 /***********************************************************************
415 ***********************************************************************/
417 /** Tell if the playlist is currently running */
418 static inline vlc_bool_t
playlist_IsPlaying( playlist_t
* p_playlist
)
420 vlc_bool_t b_playing
;
421 vlc_mutex_lock( &p_playlist
->object_lock
);
422 b_playing
= p_playlist
->status
.i_status
== PLAYLIST_RUNNING
;
423 vlc_mutex_unlock( &p_playlist
->object_lock
);
427 /** Tell if the playlist is empty */
428 static inline vlc_bool_t
playlist_IsEmpty( playlist_t
* p_playlist
)
431 vlc_mutex_lock( &p_playlist
->object_lock
);
432 b_empty
= p_playlist
->items
.i_size
== 0;
433 vlc_mutex_unlock( &p_playlist
->object_lock
);
437 /** Tell the number of items in the current playing context */
438 static inline int playlist_CurrentSize( vlc_object_t
*p_this
)
440 return p_this
->p_libvlc
->p_playlist
->current
.i_size
;
443 /** Ask the playlist to do some work */
444 static inline void playlist_Signal( playlist_t
*p_playlist
)
447 vlc_cond_signal( &p_playlist
->object_wait
);