src/playlist/playlist_internal.h

   1 /*****************************************************************************
   2  * playlist_internal.h : Playlist internals
   3  *****************************************************************************
   4  * Copyright (C) 1999-2008 VLC authors and VideoLAN
   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 it
  11  * under the terms of the GNU Lesser General Public License as published by
  12  * the Free Software Foundation; either version 2.1 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 Lesser General Public License for more details.
  19  *
  20  * You should have received a copy of the GNU Lesser General Public License
  21  * along with this program; if not, write to the Free Software Foundation,
  22  * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  23  *****************************************************************************/
  24
  25 #ifndef __LIBVLC_PLAYLIST_INTERNAL_H
  26 # define __LIBVLC_PLAYLIST_INTERNAL_H 1
  27
  28 /**
  29  * \defgroup playlist_internals VLC playlist internals
  30  * \ingroup playlist
  31  *
  32  * @{
  33  * \file
  34  * VLC playlist internal interface
  35  */
  36
  37 #include "input/input_interface.h"
  38 #include <assert.h>
  39
  40 #include "art.h"
  41 #include "preparser.h"
  42
  43 typedef struct vlc_sd_internal_t vlc_sd_internal_t;
  44
  45 void playlist_ServicesDiscoveryKillAll( playlist_t *p_playlist );
  46
  47 typedef struct playlist_private_t
  48 {
  49     playlist_t           public_data;
  50     struct intf_thread_t *interface; /**< Linked-list of interfaces */
  51
  52     void *input_tree; /**< Search tree for input item
  53                            to playlist item mapping */
  54     void *id_tree; /**< Search tree for item ID to item mapping */
  55
  56     vlc_sd_internal_t   **pp_sds;
  57     int                   i_sds;   /**< Number of service discovery modules */
  58     input_thread_t *      p_input;  /**< the input thread associated
  59                                      * with the current item */
  60     input_resource_t *   p_input_resource; /**< input resources */
  61     vlc_renderer_item_t *p_renderer;
  62     struct {
  63         /* Current status. These fields are readonly, only the playlist
  64          * main loop can touch it*/
  65         playlist_item_t *   p_item; /**< Currently playing/active item */
  66         playlist_item_t *   p_node; /**< Current node to play from */
  67     } status;
  68
  69     struct {
  70         /* Request. Use this to give orders to the playlist main loop  */
  71         playlist_item_t *   p_node;   /**< requested node to play from */
  72         playlist_item_t *   p_item;   /**< requested item to play in the node */
  73
  74         int                 i_skip;   /**< Number of items to skip */
  75
  76         bool          b_request;/**< Set to true by the requester
  77                                            The playlist sets it back to false
  78                                            when processing the request */
  79         bool input_dead; /**< Set when input has finished. */
  80     } request;
  81
  82     vlc_thread_t thread; /**< engine thread */
  83     vlc_mutex_t lock; /**< dah big playlist global lock */
  84     vlc_cond_t signal; /**< wakes up the playlist engine thread */
  85     bool     killed; /**< playlist is shutting down */
  86
  87     int      i_last_playlist_id; /**< Last id to an item */
  88     bool     b_reset_currently_playing; /** Reset current item array */
  89
  90     bool     b_tree; /**< Display as a tree */
  91     bool     b_preparse; /**< Preparse items */
  92 } playlist_private_t;
  93
  94 #define pl_priv( pl ) container_of(pl, playlist_private_t, public_data)
  95
  96 /*****************************************************************************
  97  * Prototypes
  98  *****************************************************************************/
  99
 100 /* Creation/Deletion */
 101 playlist_t *playlist_Create( vlc_object_t * );
 102 void playlist_Destroy( playlist_t * );
 103 void playlist_Activate( playlist_t * );
 104
 105 /* */
 106 playlist_item_t *playlist_ItemNewFromInput( playlist_t *p_playlist,
 107                                             input_item_t *p_input );
 108
 109 /* Engine */
 110 playlist_item_t * get_current_status_item( playlist_t * p_playlist);
 111 playlist_item_t * get_current_status_node( playlist_t * p_playlist );
 112 void set_current_status_item( playlist_t *, playlist_item_t * );
 113 void set_current_status_node( playlist_t *, playlist_item_t * );
 114
 115 /* Load/Save */
 116 int playlist_MLLoad( playlist_t *p_playlist );
 117 int playlist_MLDump( playlist_t *p_playlist );
 118
 119 /**********************************************************************
 120  * Item management
 121  **********************************************************************/
 122
 123 void playlist_SendAddNotify( playlist_t *p_playlist, playlist_item_t *item );
 124
 125 int playlist_InsertInputItemTree ( playlist_t *,
 126         playlist_item_t *, input_item_node_t *, int, bool );
 127
 128 /* Tree walking */
 129 int playlist_NodeInsert(playlist_item_t*, playlist_item_t *, int);
 130
 131 /**
 132  * Flags for playlist_NodeDeleteExplicit
 133  * \defgroup playlist_NodeDeleteExplicit_flags
 134  * @{
 135  **/
 136 #define PLAYLIST_DELETE_FORCE 0x01 /**< delete node even if read-only */
 137 #define PLAYLIST_DELETE_STOP_IF_CURRENT 0x02 /**< stop playlist playback if
 138                                                   node is currently the one
 139                                                   played */
 140 /** @} */
 141
 142 /**
 143  * Delete a node with explicit semantics
 144  *
 145  * This function acts like \ref playlist_NodeDelete with the advantage of the
 146  * caller being able control some of the semantics of the function.
 147  *
 148  * \ref p_playlist the playlist where the node is to be deleted
 149  * \ref p_node the node to delete
 150  * \ref flags a bitfield consisting of \ref playlist_NodeDeleteExplicit_flags
 151  **/
 152 void playlist_NodeDeleteExplicit(playlist_t*, playlist_item_t*,
 153     int flags);
 154
 155 void playlist_ItemRelease( playlist_t *, playlist_item_t * );
 156
 157 void ResetCurrentlyPlaying( playlist_t *p_playlist, playlist_item_t *p_cur );
 158 void ResyncCurrentIndex( playlist_t *p_playlist, playlist_item_t *p_cur );
 159
 160 playlist_item_t * playlist_GetNextLeaf( playlist_t *, playlist_item_t *p_root,
 161     playlist_item_t *p_item, bool b_ena, bool b_unplayed ) VLC_USED;
 162
 163 #define PLAYLIST_DEBUG 1
 164 //#undef PLAYLIST_DEBUG2
 165
 166 #ifdef PLAYLIST_DEBUG
 167  #define PL_DEBUG( ... ) msg_Dbg( p_playlist, __VA_ARGS__ )
 168  #ifdef PLAYLIST_DEBUG2
 169   #define PL_DEBUG2( msg, ... ) msg_Dbg( p_playlist, __VA_ARGS__ )
 170  #else
 171   #define PL_DEBUG2( msg, ... ) {}
 172  #endif
 173 #else
 174  #define PL_DEBUG( msg, ... ) {}
 175  #define PL_DEBUG2( msg, ... ) {}
 176 #endif
 177
 178 #define PLI_NAME( p ) p && p->p_input ? p->p_input->psz_name : "null"
 179
 180 #define PL_LOCK_IF( cond ) pl_lock_if( p_playlist, cond )
 181 static inline void pl_lock_if( playlist_t * p_playlist, bool cond )
 182 {
 183     if( cond ) PL_LOCK; else PL_ASSERT_LOCKED;
 184 }
 185
 186 #define PL_UNLOCK_IF( cond ) pl_unlock_if( p_playlist, cond )
 187 static inline void pl_unlock_if( playlist_t * p_playlist, bool cond )
 188 {
 189     if( cond ) PL_UNLOCK;
 190 }
 191
 192 /** @} */
 193 #endif /* !__LIBVLC_PLAYLIST_INTERNAL_H */