/*****************************************************************************
* tree.c : Playlist tree walking functions
*****************************************************************************
* Copyright (C) 1999-2007 the VideoLAN team
* $Id$
*
* Authors: Clément Stenac <zorglub@videolan.org>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
*****************************************************************************/
#ifdef HAVE_CONFIG_H
# include "config.h"
#endif
#include "vlc_common.h"
#include <assert.h>
#include "vlc_playlist.h"
#include "playlist_internal.h"
/************************************************************************
* Local prototypes
************************************************************************/
playlist_item_t *GetNextUncle( playlist_t *p_playlist, playlist_item_t *p_item,
playlist_item_t *p_root );
playlist_item_t *GetPrevUncle( playlist_t *p_playlist, playlist_item_t *p_item,
playlist_item_t *p_root );
playlist_item_t *GetNextItem( playlist_t *p_playlist,
playlist_item_t *p_root,
playlist_item_t *p_item );
playlist_item_t *GetPrevItem( playlist_t *p_playlist,
playlist_item_t *p_item,
playlist_item_t *p_root );
/**
* Create a playlist node
*
* \param p_playlist the playlist
* \param psz_name the name of the node
* \param p_parent the parent node to attach to or NULL if no attach
* \param p_flags miscellaneous flags
* \param p_input the input_item to attach to or NULL if it has to be created
* \return the new node
*/
playlist_item_t * playlist_NodeCreate( playlist_t *p_playlist,
const char *psz_name,
playlist_item_t *p_parent, int i_flags,
input_item_t *p_input )
{
input_item_t *p_new_input = NULL;
playlist_item_t *p_item;
PL_ASSERT_LOCKED;
if( !psz_name ) psz_name = _("Undefined");
if( !p_input )
p_new_input = input_item_NewWithType( VLC_OBJECT(p_playlist), NULL,
psz_name, 0, NULL, -1, ITEM_TYPE_NODE );
p_item = playlist_ItemNewFromInput( p_playlist,
p_input ? p_input : p_new_input );
if( p_new_input )
vlc_gc_decref( p_new_input );
if( p_item == NULL ) return NULL;
p_item->i_children = 0;
ARRAY_APPEND(p_playlist->all_items, p_item);
if( p_parent != NULL )
playlist_NodeAppend( p_playlist, p_item, p_parent );
playlist_SendAddNotify( p_playlist, p_item->i_id,
p_parent ? p_parent->i_id : -1,
!( i_flags & PLAYLIST_NO_REBUILD ));
return p_item;
}
/**
* Remove all the children of a node
*
* This function must be entered with the playlist lock
*
* \param p_playlist the playlist
* \param p_root the node
* \param b_delete_items do we have to delete the children items ?
* \return VLC_SUCCESS or an error
*/
int playlist_NodeEmpty( playlist_t *p_playlist, playlist_item_t *p_root,
bool b_delete_items )
{
PL_ASSERT_LOCKED;
int i;
if( p_root->i_children == -1 )
{
return VLC_EGENERIC;
}
/* Delete the children */
for( i = p_root->i_children-1 ; i >= 0 ;i-- )
{
if( p_root->pp_children[i]->i_children > -1 )
{
playlist_NodeDelete( p_playlist, p_root->pp_children[i],
b_delete_items , false );
}
else if( b_delete_items )
{
/* Delete the item here */
playlist_DeleteFromItemId( p_playlist,
p_root->pp_children[i]->i_id );
}
}
return VLC_SUCCESS;
}
/**
* Remove all the children of a node and removes the node
*
* \param p_playlist the playlist
* \param p_root the node
* \param b_delete_items do we have to delete the children items ?
* \return VLC_SUCCESS or an error
*/
int playlist_NodeDelete( playlist_t *p_playlist, playlist_item_t *p_root,
bool b_delete_items, bool b_force )
{
PL_ASSERT_LOCKED;
int i;
if( p_root->i_children == -1 )
{
return VLC_EGENERIC;
}
/* Delete the children */
for( i = p_root->i_children - 1 ; i >= 0; i-- )
{
if( p_root->pp_children[i]->i_children > -1 )
{
playlist_NodeDelete( p_playlist, p_root->pp_children[i],
b_delete_items , b_force );
}
else if( b_delete_items )
{
playlist_DeleteFromItemId( p_playlist,
p_root->pp_children[i]->i_id );
}
}
/* Delete the node */
if( p_root->i_flags & PLAYLIST_RO_FLAG && !b_force )
{
}
else
{
int i;
var_SetInteger( p_playlist, "item-deleted", p_root->i_id );
ARRAY_BSEARCH( p_playlist->all_items, ->i_id, int,
p_root->i_id, i );
if( i != -1 )
ARRAY_REMOVE( p_playlist->all_items, i );
/* Remove the item from its parent */
if( p_root->p_parent )
playlist_NodeRemoveItem( p_playlist, p_root, p_root->p_parent );
playlist_ItemRelease( p_root );
}
return VLC_SUCCESS;
}
/**
* Adds an item to the children of a node
*
* \param p_playlist the playlist
* \param p_item the item to append
* \param p_parent the parent node
* \return VLC_SUCCESS or an error
*/
int playlist_NodeAppend( playlist_t *p_playlist,
playlist_item_t *p_item,
playlist_item_t *p_parent )
{
return playlist_NodeInsert( p_playlist, p_item, p_parent, -1 );
}
int playlist_NodeInsert( playlist_t *p_playlist,
playlist_item_t *p_item,
playlist_item_t *p_parent,
int i_position )
{
PL_ASSERT_LOCKED;
(void)p_playlist;
assert( p_parent && p_parent->i_children != -1 );
if( i_position == -1 ) i_position = p_parent->i_children ;
INSERT_ELEM( p_parent->pp_children,
p_parent->i_children,
i_position,
p_item );
p_item->p_parent = p_parent;
return VLC_SUCCESS;
}
/**
* Deletes an item from the children of a node
*
* \param p_playlist the playlist
* \param p_item the item to remove
* \param p_parent the parent node
* \return VLC_SUCCESS or an error
*/
int playlist_NodeRemoveItem( playlist_t *p_playlist,
playlist_item_t *p_item,
playlist_item_t *p_parent )
{
PL_ASSERT_LOCKED;
(void)p_playlist;
for(int i= 0; i< p_parent->i_children ; i++ )
{
if( p_parent->pp_children[i] == p_item )
{
REMOVE_ELEM( p_parent->pp_children, p_parent->i_children, i );
}
}
return VLC_SUCCESS;
}
/**
* Count the children of a node
*
* \param p_playlist the playlist
* \param p_node the node
* \return the number of children
*/
int playlist_NodeChildrenCount( playlist_t *p_playlist, playlist_item_t*p_node)
{
PL_ASSERT_LOCKED;
int i;
int i_nb = 0;
if( p_node->i_children == -1 )
return 0;
i_nb = p_node->i_children;
for( i=0 ; i< p_node->i_children;i++ )
{
if( p_node->pp_children[i]->i_children == -1 )
break;
else
i_nb += playlist_NodeChildrenCount( p_playlist,
p_node->pp_children[i] );
}
return i_nb;
}
/**
* Search a child of a node by its name
*
* \param p_node the node
* \param psz_search the name of the child to search
* \return the child item or NULL if not found or error
*/
playlist_item_t *playlist_ChildSearchName( playlist_item_t *p_node,
const char *psz_search )
{
playlist_t * p_playlist = p_node->p_playlist; /* For assert_locked */
PL_ASSERT_LOCKED;
int i;
if( p_node->i_children < 0 )
{
return NULL;
}
for( i = 0 ; i< p_node->i_children; i++ )
{
if( !strcmp( p_node->pp_children[i]->p_input->psz_name, psz_search ) )
{
return p_node->pp_children[i];
}
}
return NULL;
}
/**
* Create a pair of nodes in the category and onelevel trees.
* They share the same input item.
* \param p_playlist the playlist
* \param psz_name the name of the nodes
* \param pp_node_cat pointer to return the node in category tree
* \param pp_node_one pointer to return the node in onelevel tree
* \param b_for_sd For Services Discovery ? (make node read-only and unskipping)
*/
void playlist_NodesPairCreate( playlist_t *p_playlist, const char *psz_name,
playlist_item_t **pp_node_cat,
playlist_item_t **pp_node_one,
bool b_for_sd )
{
PL_ASSERT_LOCKED;
*pp_node_cat = playlist_NodeCreate( p_playlist, psz_name,
p_playlist->p_root_category, 0, NULL );
*pp_node_one = playlist_NodeCreate( p_playlist, psz_name,
p_playlist->p_root_onelevel, 0,
(*pp_node_cat)->p_input );
if( b_for_sd )
{
(*pp_node_cat)->i_flags |= PLAYLIST_RO_FLAG;
(*pp_node_cat)->i_flags |= PLAYLIST_SKIP_FLAG;
(*pp_node_one)->i_flags |= PLAYLIST_RO_FLAG;
(*pp_node_one)->i_flags |= PLAYLIST_SKIP_FLAG;
}
}
/**
* Get the node in the preferred tree from a node in one of category
* or onelevel tree.
*/
playlist_item_t * playlist_GetPreferredNode( playlist_t *p_playlist,
playlist_item_t *p_node )
{
PL_ASSERT_LOCKED;
int i;
if( p_node->p_parent == p_playlist->p_root_category )
{
if( p_playlist->b_tree || p_node->p_input->b_prefers_tree )
return p_node;
for( i = 0 ; i< p_playlist->p_root_onelevel->i_children; i++ )
{
if( p_playlist->p_root_onelevel->pp_children[i]->p_input->i_id ==
p_node->p_input->i_id )
return p_playlist->p_root_onelevel->pp_children[i];
}
}
else if( p_node->p_parent == p_playlist->p_root_onelevel )
{
if( !p_playlist->b_tree || !p_node->p_input->b_prefers_tree )
return p_node;
for( i = 0 ; i< p_playlist->p_root_category->i_children; i++ )
{
if( p_playlist->p_root_category->pp_children[i]->p_input->i_id ==
p_node->p_input->i_id )
return p_playlist->p_root_category->pp_children[i];
}
}
return NULL;
}
/**********************************************************************
* Tree walking functions
**********************************************************************/
playlist_item_t *playlist_GetLastLeaf(playlist_t *p_playlist,
playlist_item_t *p_root )
{
PL_ASSERT_LOCKED;
int i;
playlist_item_t *p_item;
for ( i = p_root->i_children - 1; i >= 0; i-- )
{
if( p_root->pp_children[i]->i_children == -1 )
return p_root->pp_children[i];
else if( p_root->pp_children[i]->i_children > 0)
{
p_item = playlist_GetLastLeaf( p_playlist,
p_root->pp_children[i] );
if ( p_item != NULL )
return p_item;
}
else if( i == 0 )
return NULL;
}
return NULL;
}
/**
* Finds the next item to play
*
* \param p_playlist the playlist
* \param p_root the root node
* \param p_item the previous item (NULL if none )
* \return the next item to play, or NULL if none found
*/
playlist_item_t *playlist_GetNextLeaf( playlist_t *p_playlist,
playlist_item_t *p_root,
playlist_item_t *p_item,
bool b_ena, bool b_unplayed )
{
PL_ASSERT_LOCKED;
playlist_item_t *p_next;
assert( p_root && p_root->i_children != -1 );
PL_DEBUG2( "finding next of %s within %s",
PLI_NAME( p_item ), PLI_NAME( p_root ) );
/* Now, walk the tree until we find a suitable next item */
p_next = p_item;
while( 1 )
{
bool b_ena_ok = true, b_unplayed_ok = true;
p_next = GetNextItem( p_playlist, p_root, p_next );
if( !p_next || p_next == p_root )
break;
if( p_next->i_children == -1 )
{
if( b_ena && p_next->i_flags & PLAYLIST_DBL_FLAG )
b_ena_ok = false;
if( b_unplayed && p_next->p_input->i_nb_played != 0 )
b_unplayed_ok = false;
if( b_ena_ok && b_unplayed_ok ) break;
}
}
if( p_next == NULL ) PL_DEBUG2( "at end of node" );
return p_next;
}
/**
* Finds the previous item to play
*
* \param p_playlist the playlist
* \param p_root the root node
* \param p_item the previous item (NULL if none )
* \return the next item to play, or NULL if none found
*/
playlist_item_t *playlist_GetPrevLeaf( playlist_t *p_playlist,
playlist_item_t *p_root,
playlist_item_t *p_item,
bool b_ena, bool b_unplayed )
{
PL_ASSERT_LOCKED;
playlist_item_t *p_prev;
PL_DEBUG2( "finding previous os %s within %s", PLI_NAME( p_item ),
PLI_NAME( p_root ) );
assert( p_root && p_root->i_children != -1 );
/* Now, walk the tree until we find a suitable previous item */
p_prev = p_item;
while( 1 )
{
bool b_ena_ok = true, b_unplayed_ok = true;
p_prev = GetPrevItem( p_playlist, p_root, p_prev );
if( !p_prev || p_prev == p_root )
break;
if( p_prev->i_children == -1 )
{
if( b_ena && p_prev->i_flags & PLAYLIST_DBL_FLAG )
b_ena_ok = false;
if( b_unplayed && p_prev->p_input->i_nb_played != 0 )
b_unplayed_ok = false;
if( b_ena_ok && b_unplayed_ok ) break;
}
}
if( p_prev == NULL ) PL_DEBUG2( "at beginning of node" );
return p_prev;
}
/************************************************************************
* Following functions are local
***********************************************************************/
/**
* Get the next item in the tree
* If p_item is NULL, return the first child of root
**/
playlist_item_t *GetNextItem( playlist_t *p_playlist,
playlist_item_t *p_root,
playlist_item_t *p_item )
{
playlist_item_t *p_parent;
int i;
/* Node with children, get the first one */
if( p_item && p_item->i_children > 0 )
return p_item->pp_children[0];
if( p_item != NULL )
p_parent = p_item->p_parent;
else
p_parent = p_root;
for( i= 0 ; i < p_parent->i_children ; i++ )
{
if( p_item == NULL || p_parent->pp_children[i] == p_item )
{
if( p_item == NULL )
i = -1;
if( i+1 >= p_parent->i_children )
{
/* Was already the last sibling. Look for uncles */
PL_DEBUG2( "Current item is the last of the node,"
"looking for uncle from %s",
p_parent->p_input->psz_name );
if( p_parent == p_root )
{
PL_DEBUG2( "already at root" );
return NULL;
}
return GetNextUncle( p_playlist, p_item, p_root );
}
else
{
return p_parent->pp_children[i+1];
}
}
}
return NULL;
}
playlist_item_t *GetNextUncle( playlist_t *p_playlist, playlist_item_t *p_item,
playlist_item_t *p_root )
{
playlist_item_t *p_parent = p_item->p_parent;
playlist_item_t *p_grandparent;
bool b_found = false;
(void)p_playlist;
if( p_parent != NULL )
{
p_grandparent = p_parent->p_parent;
while( p_grandparent )
{
int i;
for( i = 0 ; i< p_grandparent->i_children ; i++ )
{
if( p_parent == p_grandparent->pp_children[i] )
{
PL_DEBUG2( "parent %s found as child %i of grandparent %s",
p_parent->p_input->psz_name, i,
p_grandparent->p_input->psz_name );
b_found = true;
break;
}
}
if( b_found && i + 1 < p_grandparent->i_children )
{
return p_grandparent->pp_children[i+1];
}
/* Not found at root */
if( p_grandparent == p_root )
{
return NULL;
}
else
{
p_parent = p_grandparent;
p_grandparent = p_parent->p_parent;
}
}
}
/* We reached root */
return NULL;
}
playlist_item_t *GetPrevUncle( playlist_t *p_playlist, playlist_item_t *p_item,
playlist_item_t *p_root )
{
playlist_item_t *p_parent = p_item->p_parent;
playlist_item_t *p_grandparent;
bool b_found = false;
(void)p_playlist;
if( p_parent != NULL )
{
p_grandparent = p_parent->p_parent;
while( 1 )
{
int i;
for( i = p_grandparent->i_children -1 ; i >= 0; i-- )
{
if( p_parent == p_grandparent->pp_children[i] )
{
b_found = true;
break;
}
}
if( b_found && i - 1 > 0 )
{
return p_grandparent->pp_children[i-1];
}
/* Not found at root */
if( p_grandparent == p_root )
{
return NULL;
}
else
{
p_parent = p_grandparent;
p_grandparent = p_parent->p_parent;
}
}
}
/* We reached root */
return NULL;
}
/* Recursively search the tree for previous item */
playlist_item_t *GetPrevItem( playlist_t *p_playlist,
playlist_item_t *p_root,
playlist_item_t *p_item )
{
playlist_item_t *p_parent;
int i;
/* Node with children, get the last one */
if( p_item && p_item->i_children > 0 )
return p_item->pp_children[p_item->i_children - 1];
/* Last child of its parent ? */
if( p_item != NULL )
p_parent = p_item->p_parent;
else
{
msg_Err( p_playlist, "Get the last one" );
abort();
};
for( i = p_parent->i_children -1 ; i >= 0 ; i-- )
{
if( p_parent->pp_children[i] == p_item )
{
if( i-1 < 0 )
{
/* Was already the first sibling. Look for uncles */
PL_DEBUG2( "current item is the first of its node,"
"looking for uncle from %s",
p_parent->p_input->psz_name );
if( p_parent == p_root )
{
PL_DEBUG2( "already at root" );
return NULL;
}
return GetPrevUncle( p_playlist, p_item, p_root );
}
else
{
return p_parent->pp_children[i-1];
}
}
}
return NULL;
}