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     } request;
  80
  81     vlc_thread_t thread; /**< engine thread */
  82     vlc_mutex_t lock; /**< dah big playlist global lock */
  83     vlc_cond_t signal; /**< wakes up the playlist engine thread */
  84     bool     killed; /**< playlist is shutting down */
  85
  86     int      i_last_playlist_id; /**< Last id to an item */
  87     bool     b_reset_currently_playing; /** Reset current item array */
  88
  89     bool     b_tree; /**< Display as a tree */
  90     bool     b_preparse; /**< Preparse items */
  91 } playlist_private_t;
  92
  93 #define pl_priv( pl ) container_of(pl, playlist_private_t, public_data)
  94
  95 /*****************************************************************************
  96  * Prototypes
  97  *****************************************************************************/
  98
  99 /* Creation/Deletion */
 100 playlist_t *playlist_Create( vlc_object_t * );
 101 void playlist_Destroy( playlist_t * );
 102 void playlist_Activate( playlist_t * );
 103
 104 /* */
 105 playlist_item_t *playlist_ItemNewFromInput( playlist_t *p_playlist,
 106                                             input_item_t *p_input );
 107
 108 /* Engine */
 109 playlist_item_t * get_current_status_item( playlist_t * p_playlist);
 110 playlist_item_t * get_current_status_node( playlist_t * p_playlist );
 111 void set_current_status_item( playlist_t *, playlist_item_t * );
 112 void set_current_status_node( playlist_t *, playlist_item_t * );
 113
 114 /* Load/Save */
 115 int playlist_MLLoad( playlist_t *p_playlist );
 116 int playlist_MLDump( playlist_t *p_playlist );
 117
 118 /**********************************************************************
 119  * Item management
 120  **********************************************************************/
 121
 122 void playlist_SendAddNotify( playlist_t *p_playlist, playlist_item_t *item );
 123
 124 int playlist_InsertInputItemTree ( playlist_t *,
 125         playlist_item_t *, input_item_node_t *, int, bool );
 126
 127 /* Tree walking */
 128 int playlist_NodeInsert(playlist_item_t*, playlist_item_t *, int);
 129
 130 /**
 131  * Flags for playlist_NodeDeleteExplicit
 132  * \defgroup playlist_NodeDeleteExplicit_flags
 133  * @{
 134  **/
 135 #define PLAYLIST_DELETE_FORCE 0x01 /**< delete node even if read-only */
 136 #define PLAYLIST_DELETE_STOP_IF_CURRENT 0x02 /**< stop playlist playback if
 137                                                   node is currently the one
 138                                                   played */
 139 /** @} */
 140
 141 /**
 142  * Delete a node with explicit semantics
 143  *
 144  * This function acts like \ref playlist_NodeDelete with the advantage of the
 145  * caller being able control some of the semantics of the function.
 146  *
 147  * \ref p_playlist the playlist where the node is to be deleted
 148  * \ref p_node the node to delete
 149  * \ref flags a bitfield consisting of \ref playlist_NodeDeleteExplicit_flags
 150  **/
 151 void playlist_NodeDeleteExplicit(playlist_t*, playlist_item_t*,
 152     int flags);
 153
 154 void playlist_ItemRelease( playlist_t *, playlist_item_t * );
 155
 156 void ResetCurrentlyPlaying( playlist_t *p_playlist, playlist_item_t *p_cur );
 157 void ResyncCurrentIndex( playlist_t *p_playlist, playlist_item_t *p_cur );
 158
 159 playlist_item_t * playlist_GetNextLeaf( playlist_t *, playlist_item_t *p_root,
 160     playlist_item_t *p_item, bool b_ena, bool b_unplayed ) VLC_USED;
 161
 162 #define PLAYLIST_DEBUG 1
 163 //#undef PLAYLIST_DEBUG2
 164
 165 #ifdef PLAYLIST_DEBUG
 166  #define PL_DEBUG( ... ) msg_Dbg( p_playlist, __VA_ARGS__ )
 167  #ifdef PLAYLIST_DEBUG2
 168   #define PL_DEBUG2( msg, ... ) msg_Dbg( p_playlist, __VA_ARGS__ )
 169  #else
 170   #define PL_DEBUG2( msg, ... ) {}
 171  #endif
 172 #else
 173  #define PL_DEBUG( msg, ... ) {}
 174  #define PL_DEBUG2( msg, ... ) {}
 175 #endif
 176
 177 #define PLI_NAME( p ) p && p->p_input ? p->p_input->psz_name : "null"
 178
 179 #define PL_LOCK_IF( cond ) pl_lock_if( p_playlist, cond )
 180 static inline void pl_lock_if( playlist_t * p_playlist, bool cond )
 181 {
 182     if( cond ) PL_LOCK; else PL_ASSERT_LOCKED;
 183 }
 184
 185 #define PL_UNLOCK_IF( cond ) pl_unlock_if( p_playlist, cond )
 186 static inline void pl_unlock_if( playlist_t * p_playlist, bool cond )
 187 {
 188     if( cond ) PL_UNLOCK;
 189 }
 190
 191 /** @} */
 192 #endif /* !__LIBVLC_PLAYLIST_INTERNAL_H */