1
mirror of https://code.videolan.org/videolan/vlc synced 2024-09-28 23:09:59 +02:00
vlc/lib/media.c

1358 lines
42 KiB
C

/*****************************************************************************
* media.c: Libvlc API media descripor management
*****************************************************************************
* Copyright (C) 2007 VLC authors and VideoLAN
*
* Authors: Pierre d'Herbemont <pdherbemont@videolan.org>
*
* This program is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2.1 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 Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser 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 <assert.h>
#include <errno.h>
#include <vlc/libvlc.h>
#include <vlc/libvlc_picture.h>
#include <vlc/libvlc_media.h>
#include <vlc/libvlc_media_list.h> // For the subitems, here for convenience
#include <vlc/libvlc_events.h>
#include <vlc_common.h>
#include <vlc_meta.h>
#include <vlc_url.h>
#include <vlc_thumbnailer.h>
#include <vlc_atomic.h>
#include "../src/libvlc.h"
#include "libvlc_internal.h"
#include "media_internal.h"
#include "media_list_internal.h"
#include "picture_internal.h"
static const vlc_meta_type_t libvlc_to_vlc_meta[] =
{
[libvlc_meta_Title] = vlc_meta_Title,
[libvlc_meta_Artist] = vlc_meta_Artist,
[libvlc_meta_Genre] = vlc_meta_Genre,
[libvlc_meta_Copyright] = vlc_meta_Copyright,
[libvlc_meta_Album] = vlc_meta_Album,
[libvlc_meta_TrackNumber] = vlc_meta_TrackNumber,
[libvlc_meta_Description] = vlc_meta_Description,
[libvlc_meta_Rating] = vlc_meta_Rating,
[libvlc_meta_Date] = vlc_meta_Date,
[libvlc_meta_Setting] = vlc_meta_Setting,
[libvlc_meta_URL] = vlc_meta_URL,
[libvlc_meta_Language] = vlc_meta_Language,
[libvlc_meta_NowPlaying] = vlc_meta_NowPlaying,
[libvlc_meta_Publisher] = vlc_meta_Publisher,
[libvlc_meta_EncodedBy] = vlc_meta_EncodedBy,
[libvlc_meta_ArtworkURL] = vlc_meta_ArtworkURL,
[libvlc_meta_TrackID] = vlc_meta_TrackID,
[libvlc_meta_TrackTotal] = vlc_meta_TrackTotal,
[libvlc_meta_Director] = vlc_meta_Director,
[libvlc_meta_Season] = vlc_meta_Season,
[libvlc_meta_Episode] = vlc_meta_Episode,
[libvlc_meta_ShowName] = vlc_meta_ShowName,
[libvlc_meta_Actors] = vlc_meta_Actors,
[libvlc_meta_AlbumArtist] = vlc_meta_AlbumArtist,
[libvlc_meta_DiscNumber] = vlc_meta_DiscNumber,
[libvlc_meta_DiscTotal] = vlc_meta_DiscTotal
};
static const libvlc_meta_t vlc_to_libvlc_meta[] =
{
[vlc_meta_Title] = libvlc_meta_Title,
[vlc_meta_Artist] = libvlc_meta_Artist,
[vlc_meta_Genre] = libvlc_meta_Genre,
[vlc_meta_Copyright] = libvlc_meta_Copyright,
[vlc_meta_Album] = libvlc_meta_Album,
[vlc_meta_TrackNumber] = libvlc_meta_TrackNumber,
[vlc_meta_Description] = libvlc_meta_Description,
[vlc_meta_Rating] = libvlc_meta_Rating,
[vlc_meta_Date] = libvlc_meta_Date,
[vlc_meta_Setting] = libvlc_meta_Setting,
[vlc_meta_URL] = libvlc_meta_URL,
[vlc_meta_Language] = libvlc_meta_Language,
[vlc_meta_NowPlaying] = libvlc_meta_NowPlaying,
[vlc_meta_ESNowPlaying] = libvlc_meta_NowPlaying,
[vlc_meta_Publisher] = libvlc_meta_Publisher,
[vlc_meta_EncodedBy] = libvlc_meta_EncodedBy,
[vlc_meta_ArtworkURL] = libvlc_meta_ArtworkURL,
[vlc_meta_TrackID] = libvlc_meta_TrackID,
[vlc_meta_TrackTotal] = libvlc_meta_TrackTotal,
[vlc_meta_Director] = libvlc_meta_Director,
[vlc_meta_Season] = libvlc_meta_Season,
[vlc_meta_Episode] = libvlc_meta_Episode,
[vlc_meta_ShowName] = libvlc_meta_ShowName,
[vlc_meta_Actors] = libvlc_meta_Actors,
[vlc_meta_AlbumArtist] = libvlc_meta_AlbumArtist,
[vlc_meta_DiscNumber] = libvlc_meta_DiscNumber,
[vlc_meta_DiscTotal] = libvlc_meta_DiscTotal
};
static_assert(
ORIENT_TOP_LEFT == (int) libvlc_video_orient_top_left &&
ORIENT_TOP_RIGHT == (int) libvlc_video_orient_top_right &&
ORIENT_BOTTOM_LEFT == (int) libvlc_video_orient_bottom_left &&
ORIENT_BOTTOM_RIGHT == (int) libvlc_video_orient_bottom_right &&
ORIENT_LEFT_TOP == (int) libvlc_video_orient_left_top &&
ORIENT_LEFT_BOTTOM == (int) libvlc_video_orient_left_bottom &&
ORIENT_RIGHT_TOP == (int) libvlc_video_orient_right_top &&
ORIENT_RIGHT_BOTTOM == (int) libvlc_video_orient_right_bottom,
"Mismatch between libvlc_video_orient_t and video_orientation_t" );
static_assert(
PROJECTION_MODE_RECTANGULAR == (int) libvlc_video_projection_rectangular &&
PROJECTION_MODE_EQUIRECTANGULAR == (int) libvlc_video_projection_equirectangular &&
PROJECTION_MODE_CUBEMAP_LAYOUT_STANDARD == (int) libvlc_video_projection_cubemap_layout_standard,
"Mismatch between libvlc_video_projection_t and video_projection_mode_t" );
static_assert(
MULTIVIEW_2D == (int) libvlc_video_multiview_2d &&
MULTIVIEW_STEREO_SBS == (int) libvlc_video_multiview_stereo_sbs &&
MULTIVIEW_STEREO_TB == (int) libvlc_video_multiview_stereo_tb &&
MULTIVIEW_STEREO_ROW == (int) libvlc_video_multiview_stereo_row &&
MULTIVIEW_STEREO_COL == (int) libvlc_video_multiview_stereo_col &&
MULTIVIEW_STEREO_FRAME == (int) libvlc_video_multiview_stereo_frame &&
MULTIVIEW_STEREO_CHECKERBOARD == (int) libvlc_video_multiview_stereo_checkerboard,
"Mismatch between libvlc_video_multiview_t and video_multiview_mode_t");
static libvlc_media_list_t *media_get_subitems( libvlc_media_t * p_md,
bool b_create )
{
libvlc_media_list_t *p_subitems = NULL;
vlc_mutex_lock( &p_md->subitems_lock );
if( p_md->p_subitems == NULL && b_create )
{
p_md->p_subitems = libvlc_media_list_new();
if( p_md->p_subitems != NULL )
{
p_md->p_subitems->b_read_only = true;
p_md->p_subitems->p_internal_md = p_md;
}
}
p_subitems = p_md->p_subitems;
vlc_mutex_unlock( &p_md->subitems_lock );
return p_subitems;
}
static libvlc_media_t *input_item_add_subitem( libvlc_media_t *p_md,
input_item_t *item )
{
libvlc_media_t * p_md_child;
libvlc_media_list_t *p_subitems;
libvlc_event_t event;
p_md_child = libvlc_media_new_from_input_item( p_md->p_libvlc_instance,
item );
/* Add this to our media list */
p_subitems = media_get_subitems( p_md, true );
if( p_subitems != NULL )
{
libvlc_media_list_lock( p_subitems );
libvlc_media_list_internal_add_media( p_subitems, p_md_child );
libvlc_media_list_unlock( p_subitems );
}
/* Construct the event */
event.type = libvlc_MediaSubItemAdded;
event.u.media_subitem_added.new_child = p_md_child;
/* Send the event */
libvlc_event_send( &p_md->event_manager, &event );
return p_md_child;
}
struct vlc_item_list
{
struct vlc_list node;
input_item_node_t *item;
libvlc_media_t *media;
};
static struct vlc_item_list *
wrap_item_in_list( libvlc_media_t *media, input_item_node_t *item )
{
struct vlc_item_list *node = malloc( sizeof *node );
if( node == NULL )
return NULL;
node->item = item;
node->media = media;
return node;
}
static void input_item_add_subnode( libvlc_media_t *md,
input_item_node_t *root )
{
struct vlc_list list;
vlc_list_init( &list );
/* Retain the media because we don't want the search algorithm to release
* it when its subitems get parsed. */
libvlc_media_retain(md);
struct vlc_item_list *node_root = wrap_item_in_list( md, root );
if( node_root == NULL )
{
libvlc_media_release(md);
goto error;
}
/* This is a depth-first search algorithm, so stash the root of the tree
* first, then stash its children and loop back on the last item in the
* list until the full subtree is parsed, and eventually the full tree is
* parsed. */
vlc_list_append( &node_root->node, &list );
while( !vlc_list_is_empty( &list ) )
{
/* Pop last item in the list. */
struct vlc_item_list *node =
vlc_list_last_entry_or_null( &list, struct vlc_item_list, node );
vlc_list_remove(&node->node);
for( int i = 0; i < node->item->i_children; i++ )
{
input_item_node_t *child = node->item->pp_children[i];
/* The media will be released when its children will be added to
* the list. */
libvlc_media_t *md_child = input_item_add_subitem( node->media, child->p_item );
if( md_child == NULL )
goto error;
struct vlc_item_list *submedia =
wrap_item_in_list( md_child, child );
if (submedia == NULL)
{
libvlc_media_release( md_child );
goto error;
}
/* Stash a request to parse this subtree. */
vlc_list_append( &submedia->node, &list );
}
libvlc_media_release( node->media );
free( node );
}
return;
error:
libvlc_printerr( "Not enough memory" );
struct vlc_item_list *node;
vlc_list_foreach( node, &list, node )
{
if( node->media != NULL )
libvlc_media_release( node->media );
free( node );
}
}
/**
* \internal
* input_item_subitemtree_added (Private) (vlc event Callback)
*/
static void input_item_subtree_added(input_item_t *item,
input_item_node_t *node,
void *user_data)
{
VLC_UNUSED(item);
libvlc_media_t * p_md = user_data;
libvlc_media_add_subtree(p_md, node);
}
void libvlc_media_add_subtree(libvlc_media_t *p_md, input_item_node_t *node)
{
input_item_add_subnode( p_md, node );
/* Construct the event */
libvlc_event_t event;
event.type = libvlc_MediaSubItemTreeAdded;
event.u.media_subitemtree_added.item = p_md;
/* Send the event */
libvlc_event_send( &p_md->event_manager, &event );
}
/**
* \internal
* input_item_meta_changed (Private) (vlc event Callback)
*/
static void input_item_meta_changed( const vlc_event_t *p_event,
void * user_data )
{
libvlc_media_t * p_md = user_data;
libvlc_event_t event;
/* Construct the event */
event.type = libvlc_MediaMetaChanged;
event.u.media_meta_changed.meta_type =
vlc_to_libvlc_meta[p_event->u.input_item_meta_changed.meta_type];
/* Send the event */
libvlc_event_send( &p_md->event_manager, &event );
}
/**
* \internal
* input_item_duration_changed (Private) (vlc event Callback)
*/
static void input_item_duration_changed( const vlc_event_t *p_event,
void * user_data )
{
libvlc_media_t * p_md = user_data;
libvlc_event_t event;
/* Construct the event */
event.type = libvlc_MediaDurationChanged;
event.u.media_duration_changed.new_duration =
from_mtime(p_event->u.input_item_duration_changed.new_duration);
/* Send the event */
libvlc_event_send( &p_md->event_manager, &event );
}
static void input_item_attachments_found( const vlc_event_t *p_event,
void * user_data )
{
libvlc_media_t * p_md = user_data;
libvlc_event_t event;
libvlc_picture_list_t* list = libvlc_picture_list_from_attachments(
p_event->u.input_item_attachments_found.attachments,
p_event->u.input_item_attachments_found.count );
if( !list )
return;
if( !libvlc_picture_list_count(list) )
{
libvlc_picture_list_destroy( list );
return;
}
/* Construct the event */
event.type = libvlc_MediaAttachedThumbnailsFound;
event.u.media_attached_thumbnails_found.thumbnails = list;
/* Send the event */
libvlc_event_send( &p_md->event_manager, &event );
libvlc_picture_list_destroy( list );
}
static void send_parsed_changed( libvlc_media_t *p_md,
libvlc_media_parsed_status_t new_status )
{
libvlc_event_t event;
vlc_mutex_lock( &p_md->parsed_lock );
if( p_md->parsed_status == new_status )
{
vlc_mutex_unlock( &p_md->parsed_lock );
return;
}
/* Legacy: notify libvlc_media_parse */
if( !p_md->is_parsed )
{
p_md->is_parsed = true;
vlc_cond_broadcast( &p_md->parsed_cond );
}
p_md->parsed_status = new_status;
if( p_md->parsed_status != libvlc_media_parsed_status_done )
p_md->has_asked_preparse = false;
vlc_mutex_unlock( &p_md->parsed_lock );
/* Construct the event */
event.type = libvlc_MediaParsedChanged;
event.u.media_parsed_changed.new_status = new_status;
/* Send the event */
libvlc_event_send( &p_md->event_manager, &event );
libvlc_media_list_t *p_subitems = media_get_subitems( p_md, false );
if( p_subitems != NULL )
{
/* notify the media list */
libvlc_media_list_lock( p_subitems );
libvlc_media_list_internal_end_reached( p_subitems );
libvlc_media_list_unlock( p_subitems );
}
}
/**
* \internal
* input_item_preparse_ended (Private) (vlc event Callback)
*/
static void input_item_preparse_ended(input_item_t *item,
enum input_item_preparse_status status,
void *user_data)
{
VLC_UNUSED(item);
libvlc_media_t * p_md = user_data;
libvlc_media_parsed_status_t new_status;
switch( status )
{
case ITEM_PREPARSE_SKIPPED:
new_status = libvlc_media_parsed_status_skipped;
break;
case ITEM_PREPARSE_FAILED:
new_status = libvlc_media_parsed_status_failed;
break;
case ITEM_PREPARSE_TIMEOUT:
new_status = libvlc_media_parsed_status_timeout;
break;
case ITEM_PREPARSE_DONE:
new_status = libvlc_media_parsed_status_done;
break;
default:
return;
}
send_parsed_changed( p_md, new_status );
vlc_mutex_lock(&p_md->parsed_lock);
assert(p_md->worker_count > 0);
p_md->worker_count--;
vlc_cond_signal(&p_md->idle_cond);
vlc_mutex_unlock(&p_md->parsed_lock);
}
/**
* \internal
* Install event handler (Private)
*/
static void install_input_item_observer( libvlc_media_t *p_md )
{
vlc_event_attach( &p_md->p_input_item->event_manager,
vlc_InputItemMetaChanged,
input_item_meta_changed,
p_md );
vlc_event_attach( &p_md->p_input_item->event_manager,
vlc_InputItemDurationChanged,
input_item_duration_changed,
p_md );
vlc_event_attach( &p_md->p_input_item->event_manager,
vlc_InputItemAttachmentsFound,
input_item_attachments_found,
p_md );
}
/**
* \internal
* Uninstall event handler (Private)
*/
static void uninstall_input_item_observer( libvlc_media_t *p_md )
{
vlc_event_detach( &p_md->p_input_item->event_manager,
vlc_InputItemMetaChanged,
input_item_meta_changed,
p_md );
vlc_event_detach( &p_md->p_input_item->event_manager,
vlc_InputItemDurationChanged,
input_item_duration_changed,
p_md );
vlc_event_detach( &p_md->p_input_item->event_manager,
vlc_InputItemAttachmentsFound,
input_item_attachments_found,
p_md );
}
/**
* \internal
* Create a new media descriptor object from an input_item (Private)
*
* That's the generic constructor
*/
libvlc_media_t * libvlc_media_new_from_input_item(
libvlc_instance_t *p_instance,
input_item_t *p_input_item )
{
libvlc_media_t * p_md;
if (!p_input_item)
{
libvlc_printerr( "No input item given" );
return NULL;
}
p_md = calloc( 1, sizeof(libvlc_media_t) );
if( !p_md )
{
libvlc_printerr( "Not enough memory" );
return NULL;
}
p_md->p_libvlc_instance = p_instance;
p_md->p_input_item = p_input_item;
vlc_atomic_rc_init(&p_md->rc);
vlc_cond_init(&p_md->parsed_cond);
vlc_mutex_init(&p_md->parsed_lock);
vlc_mutex_init(&p_md->subitems_lock);
vlc_cond_init(&p_md->idle_cond);
p_md->worker_count = 0;
p_md->state = libvlc_NothingSpecial;
/* A media descriptor can be a playlist. When you open a playlist
* It can give a bunch of item to read. */
p_md->p_subitems = NULL;
p_md->p_input_item->libvlc_owner = p_md;
libvlc_event_manager_init( &p_md->event_manager, p_md );
input_item_Hold( p_md->p_input_item );
install_input_item_observer( p_md );
libvlc_retain( p_instance );
return p_md;
}
// Create a media with a certain given media resource location
libvlc_media_t *libvlc_media_new_location( libvlc_instance_t *p_instance,
const char * psz_mrl )
{
input_item_t * p_input_item;
libvlc_media_t * p_md;
p_input_item = input_item_New( psz_mrl, NULL );
if (!p_input_item)
{
libvlc_printerr( "Not enough memory" );
return NULL;
}
p_md = libvlc_media_new_from_input_item( p_instance, p_input_item );
/* The p_input_item is retained in libvlc_media_new_from_input_item */
input_item_Release( p_input_item );
return p_md;
}
// Create a media for a certain file path
libvlc_media_t *libvlc_media_new_path( libvlc_instance_t *p_instance,
const char *path )
{
char *mrl = vlc_path2uri( path, NULL );
if( unlikely(mrl == NULL) )
{
libvlc_printerr( "%s", vlc_strerror_c(errno) );
return NULL;
}
libvlc_media_t *m = libvlc_media_new_location( p_instance, mrl );
free( mrl );
return m;
}
// Create a media for an already open file descriptor
libvlc_media_t *libvlc_media_new_fd( libvlc_instance_t *p_instance, int fd )
{
char mrl[16];
snprintf( mrl, sizeof(mrl), "fd://%d", fd );
return libvlc_media_new_location( p_instance, mrl );
}
// Create a media with custom callbacks to read the data from
libvlc_media_t *libvlc_media_new_callbacks(libvlc_instance_t *p_instance,
libvlc_media_open_cb open_cb,
libvlc_media_read_cb read_cb,
libvlc_media_seek_cb seek_cb,
libvlc_media_close_cb close_cb,
void *opaque)
{
libvlc_media_t *m = libvlc_media_new_location(p_instance, "imem://");
if (unlikely(m == NULL))
return NULL;
assert(read_cb != NULL);
input_item_AddOpaque(m->p_input_item, "imem-data", opaque);
input_item_AddOpaque(m->p_input_item, "imem-open", open_cb);
input_item_AddOpaque(m->p_input_item, "imem-read", read_cb);
input_item_AddOpaque(m->p_input_item, "imem-seek", seek_cb);
input_item_AddOpaque(m->p_input_item, "imem-close", close_cb);
return m;
}
// Create a media as an empty node with a given name
libvlc_media_t * libvlc_media_new_as_node( libvlc_instance_t *p_instance,
const char * psz_name )
{
input_item_t * p_input_item;
libvlc_media_t * p_md;
libvlc_media_list_t * p_subitems;
p_input_item = input_item_New( INPUT_ITEM_URI_NOP, psz_name );
if (!p_input_item)
{
libvlc_printerr( "Not enough memory" );
return NULL;
}
p_md = libvlc_media_new_from_input_item( p_instance, p_input_item );
input_item_Release( p_input_item );
p_subitems = media_get_subitems( p_md, true );
if( p_subitems == NULL) {
libvlc_media_release( p_md );
return NULL;
}
return p_md;
}
// Add an option to the media descriptor
void libvlc_media_add_option( libvlc_media_t * p_md,
const char * psz_option )
{
libvlc_media_add_option_flag( p_md, psz_option,
VLC_INPUT_OPTION_UNIQUE|VLC_INPUT_OPTION_TRUSTED );
}
// Same as libvlc_media_add_option but with configurable flags
void libvlc_media_add_option_flag( libvlc_media_t * p_md,
const char * ppsz_option,
unsigned i_flags )
{
input_item_AddOption( p_md->p_input_item, ppsz_option, i_flags );
}
// Delete a media descriptor object
void libvlc_media_release( libvlc_media_t *p_md )
{
if (!p_md)
return;
if( !vlc_atomic_rc_dec(&p_md->rc) )
return;
uninstall_input_item_observer( p_md );
/* Cancel asynchronous parsing (if any) */
libvlc_MetadataCancel( p_md->p_libvlc_instance->p_libvlc_int, p_md );
/* Wait for all async tasks to stop. */
vlc_mutex_lock( &p_md->parsed_lock );
while( p_md->worker_count > 0 )
vlc_cond_wait( &p_md->idle_cond, &p_md->parsed_lock );
vlc_mutex_unlock( &p_md->parsed_lock );
if( p_md->p_subitems )
libvlc_media_list_release( p_md->p_subitems );
input_item_Release( p_md->p_input_item );
libvlc_event_manager_destroy( &p_md->event_manager );
libvlc_release( p_md->p_libvlc_instance );
free( p_md );
}
// Retain a media descriptor object
void libvlc_media_retain( libvlc_media_t *p_md )
{
assert (p_md);
vlc_atomic_rc_inc( &p_md->rc );
}
// Duplicate a media descriptor object
libvlc_media_t *
libvlc_media_duplicate( libvlc_media_t *p_md_orig )
{
input_item_t *dup = input_item_Copy( p_md_orig->p_input_item );
if( dup == NULL )
return NULL;
return libvlc_media_new_from_input_item( p_md_orig->p_libvlc_instance, dup );
}
// Get mrl from a media descriptor object
char *
libvlc_media_get_mrl( libvlc_media_t * p_md )
{
assert( p_md );
return input_item_GetURI( p_md->p_input_item );
}
// Getter for meta information
char *libvlc_media_get_meta( libvlc_media_t *p_md, libvlc_meta_t e_meta )
{
char *psz_meta = NULL;
if( e_meta == libvlc_meta_NowPlaying )
{
psz_meta = input_item_GetNowPlayingFb( p_md->p_input_item );
}
else
{
psz_meta = input_item_GetMeta( p_md->p_input_item,
libvlc_to_vlc_meta[e_meta] );
/* Should be integrated in core */
if( psz_meta == NULL && e_meta == libvlc_meta_Title
&& p_md->p_input_item->psz_name != NULL )
psz_meta = strdup( p_md->p_input_item->psz_name );
}
return psz_meta;
}
// Set the meta of the media
void libvlc_media_set_meta( libvlc_media_t *p_md, libvlc_meta_t e_meta, const char *psz_value )
{
assert( p_md );
input_item_SetMeta( p_md->p_input_item, libvlc_to_vlc_meta[e_meta], psz_value );
}
// Save the meta previously set
int libvlc_media_save_meta( libvlc_media_t *p_md )
{
assert( p_md );
vlc_object_t *p_obj = VLC_OBJECT(p_md->p_libvlc_instance->p_libvlc_int);
return input_item_WriteMeta( p_obj, p_md->p_input_item ) == VLC_SUCCESS;
}
// Getter for state information
libvlc_state_t
libvlc_media_get_state( libvlc_media_t *p_md )
{
assert( p_md );
return p_md->state;
}
// Setter for state information (LibVLC Internal)
void
libvlc_media_set_state( libvlc_media_t *p_md,
libvlc_state_t state )
{
libvlc_event_t event;
p_md->state = state;
/* Construct the event */
event.type = libvlc_MediaStateChanged;
event.u.media_state_changed.new_state = state;
/* Send the event */
libvlc_event_send( &p_md->event_manager, &event );
}
// Get subitems of media descriptor object.
libvlc_media_list_t *
libvlc_media_subitems( libvlc_media_t * p_md )
{
libvlc_media_list_t *p_subitems = media_get_subitems( p_md, true );
if( p_subitems )
libvlc_media_list_retain( p_subitems );
return p_subitems;
}
// Getter for statistics information
bool libvlc_media_get_stats(libvlc_media_t *p_md,
libvlc_media_stats_t *p_stats)
{
input_item_t *item = p_md->p_input_item;
if( !p_md->p_input_item )
return false;
vlc_mutex_lock( &item->lock );
input_stats_t *p_itm_stats = p_md->p_input_item->p_stats;
if( p_itm_stats == NULL )
{
vlc_mutex_unlock( &item->lock );
return false;
}
p_stats->i_read_bytes = p_itm_stats->i_read_bytes;
p_stats->f_input_bitrate = p_itm_stats->f_input_bitrate;
p_stats->i_demux_read_bytes = p_itm_stats->i_demux_read_bytes;
p_stats->f_demux_bitrate = p_itm_stats->f_demux_bitrate;
p_stats->i_demux_corrupted = p_itm_stats->i_demux_corrupted;
p_stats->i_demux_discontinuity = p_itm_stats->i_demux_discontinuity;
p_stats->i_decoded_video = p_itm_stats->i_decoded_video;
p_stats->i_decoded_audio = p_itm_stats->i_decoded_audio;
p_stats->i_displayed_pictures = p_itm_stats->i_displayed_pictures;
p_stats->i_late_pictures = p_itm_stats->i_late_pictures;
p_stats->i_lost_pictures = p_itm_stats->i_lost_pictures;
p_stats->i_played_abuffers = p_itm_stats->i_played_abuffers;
p_stats->i_lost_abuffers = p_itm_stats->i_lost_abuffers;
vlc_mutex_unlock( &item->lock );
return true;
}
// Get event manager from a media descriptor object
libvlc_event_manager_t *
libvlc_media_event_manager( libvlc_media_t * p_md )
{
assert( p_md );
return &p_md->event_manager;
}
// Get duration of media object (in ms)
int64_t
libvlc_media_get_duration( libvlc_media_t * p_md )
{
assert( p_md );
if( !p_md->p_input_item )
{
libvlc_printerr( "No input item" );
return -1;
}
if (!input_item_IsPreparsed( p_md->p_input_item ))
return -1;
return from_mtime(input_item_GetDuration( p_md->p_input_item ));
}
static const input_preparser_callbacks_t input_preparser_callbacks = {
.on_preparse_ended = input_item_preparse_ended,
.on_subtree_added = input_item_subtree_added,
};
static int media_parse(libvlc_media_t *media, bool b_async,
libvlc_media_parse_flag_t parse_flag, int timeout)
{
bool needed;
vlc_mutex_lock(&media->parsed_lock);
needed = !media->has_asked_preparse;
media->has_asked_preparse = true;
if (needed)
{
media->is_parsed = false;
media->parsed_status = 0;
}
vlc_mutex_unlock(&media->parsed_lock);
if (needed)
{
libvlc_int_t *libvlc = media->p_libvlc_instance->p_libvlc_int;
input_item_t *item = media->p_input_item;
input_item_meta_request_option_t parse_scope = META_REQUEST_OPTION_SCOPE_LOCAL;
int ret;
if (parse_flag & libvlc_media_parse_network)
parse_scope |= META_REQUEST_OPTION_SCOPE_NETWORK;
if (parse_flag & libvlc_media_fetch_local)
parse_scope |= META_REQUEST_OPTION_FETCH_LOCAL;
if (parse_flag & libvlc_media_fetch_network)
parse_scope |= META_REQUEST_OPTION_FETCH_NETWORK;
if (parse_flag & libvlc_media_do_interact)
parse_scope |= META_REQUEST_OPTION_DO_INTERACT;
/* Note: we cannot keep parsed_lock when calling libvlc_MetadataRequest
* because it might also be used to submit the state synchronously
* which would result in recursive lock. */
vlc_mutex_lock(&media->parsed_lock);
media->worker_count++;
vlc_mutex_unlock(&media->parsed_lock);
ret = libvlc_MetadataRequest(libvlc, item, parse_scope,
&input_preparser_callbacks, media,
timeout, media);
if (ret != VLC_SUCCESS)
{
vlc_mutex_lock(&media->parsed_lock);
assert(media->worker_count > 0);
media->worker_count--;
vlc_mutex_unlock(&media->parsed_lock);
return ret;
}
}
else
return VLC_EGENERIC;
if (!b_async)
{
vlc_mutex_lock(&media->parsed_lock);
while (!media->is_parsed)
vlc_cond_wait(&media->parsed_cond, &media->parsed_lock);
vlc_mutex_unlock(&media->parsed_lock);
}
return VLC_SUCCESS;
}
// Parse the media and wait
void
libvlc_media_parse(libvlc_media_t *media)
{
media_parse( media, false, libvlc_media_fetch_local, -1 );
}
// Parse the media but do not wait
void
libvlc_media_parse_async(libvlc_media_t *media)
{
media_parse( media, true, libvlc_media_fetch_local, -1 );
}
// Parse the media asynchronously with options
int
libvlc_media_parse_with_options( libvlc_media_t *media,
libvlc_media_parse_flag_t parse_flag,
int timeout )
{
return media_parse( media, true, parse_flag, timeout ) == VLC_SUCCESS ? 0 : -1;
}
// Stop parsing of the media
void
libvlc_media_parse_stop( libvlc_media_t *media )
{
libvlc_MetadataCancel( media->p_libvlc_instance->p_libvlc_int, media );
}
// Get parsed status for media object (deprecated)
bool libvlc_media_is_parsed(libvlc_media_t *media)
{
bool parsed;
vlc_mutex_lock(&media->parsed_lock);
parsed = media->is_parsed;
vlc_mutex_unlock(&media->parsed_lock);
return parsed;
}
// Get Parsed status for media descriptor object
libvlc_media_parsed_status_t
libvlc_media_get_parsed_status(libvlc_media_t *media)
{
libvlc_media_parsed_status_t status;
vlc_mutex_lock(&media->parsed_lock);
status = media->parsed_status;
vlc_mutex_unlock(&media->parsed_lock);
return status;
}
// Sets media descriptor's user_data
void
libvlc_media_set_user_data( libvlc_media_t * p_md, void * p_new_user_data )
{
assert( p_md );
p_md->p_user_data = p_new_user_data;
}
// Get media descriptor's user_data
void *
libvlc_media_get_user_data( libvlc_media_t * p_md )
{
assert( p_md );
return p_md->p_user_data;
}
// Get media descriptor's elementary streams description
unsigned
libvlc_media_tracks_get( libvlc_media_t *p_md, libvlc_media_track_t *** pp_es )
{
assert( p_md );
input_item_t *p_input_item = p_md->p_input_item;
vlc_mutex_lock( &p_input_item->lock );
const int i_es = p_input_item->i_es;
*pp_es = (i_es > 0) ? calloc( i_es, sizeof(**pp_es) ) : NULL;
if( !*pp_es ) /* no ES, or OOM */
{
vlc_mutex_unlock( &p_input_item->lock );
return 0;
}
/* Fill array */
for( int i = 0; i < i_es; i++ )
{
libvlc_media_trackpriv_t *p_trackpriv = calloc( 1, sizeof(*p_trackpriv) );
if ( !p_trackpriv )
{
libvlc_media_tracks_release( *pp_es, i_es );
*pp_es = NULL;
vlc_mutex_unlock( &p_input_item->lock );
return 0;
}
libvlc_media_track_t *p_mes = &p_trackpriv->t;
(*pp_es)[i] = p_mes;
const es_format_t *p_es = p_input_item->es[i];
libvlc_media_trackpriv_from_es( p_trackpriv, p_es );
}
vlc_mutex_unlock( &p_input_item->lock );
return i_es;
}
libvlc_media_tracklist_t *
libvlc_media_get_tracklist( libvlc_media_t *p_md, libvlc_track_type_t type )
{
assert( p_md );
input_item_t *p_input_item = p_md->p_input_item;
vlc_mutex_lock( &p_input_item->lock );
libvlc_media_tracklist_t *list =
libvlc_media_tracklist_from_es_array( p_input_item->es,
p_input_item->i_es, type );
vlc_mutex_unlock( &p_input_item->lock );
return list;
}
// Get codec description from media elementary stream
const char *
libvlc_media_get_codec_description( libvlc_track_type_t i_type,
uint32_t i_codec )
{
return vlc_fourcc_GetDescription( libvlc_track_type_to_escat( i_type),
i_codec );
}
// Release media descriptor's elementary streams description array
void libvlc_media_tracks_release( libvlc_media_track_t **p_tracks, unsigned i_count )
{
for( unsigned i = 0; i < i_count; ++i )
{
if ( !p_tracks[i] )
continue;
libvlc_media_track_clean( p_tracks[i] );
free( p_tracks[i] );
}
free( p_tracks );
}
// Get the media type of the media descriptor object
libvlc_media_type_t libvlc_media_get_type( libvlc_media_t *p_md )
{
assert( p_md );
enum input_item_type_e i_type;
input_item_t *p_input_item = p_md->p_input_item;
vlc_mutex_lock( &p_input_item->lock );
i_type = p_md->p_input_item->i_type;
vlc_mutex_unlock( &p_input_item->lock );
switch( i_type )
{
case ITEM_TYPE_FILE:
return libvlc_media_type_file;
case ITEM_TYPE_NODE:
case ITEM_TYPE_DIRECTORY:
return libvlc_media_type_directory;
case ITEM_TYPE_DISC:
return libvlc_media_type_disc;
case ITEM_TYPE_STREAM:
return libvlc_media_type_stream;
case ITEM_TYPE_PLAYLIST:
return libvlc_media_type_playlist;
default:
return libvlc_media_type_unknown;
}
}
struct libvlc_media_thumbnail_request_t
{
libvlc_media_t *md;
unsigned int width;
unsigned int height;
bool crop;
libvlc_picture_type_t type;
vlc_thumbnailer_request_t* req;
};
static void media_on_thumbnail_ready( void* data, picture_t* thumbnail )
{
libvlc_media_thumbnail_request_t *req = data;
libvlc_media_t *p_media = req->md;
libvlc_event_t event;
event.type = libvlc_MediaThumbnailGenerated;
libvlc_picture_t* pic = NULL;
if ( thumbnail != NULL )
pic = libvlc_picture_new( VLC_OBJECT(p_media->p_libvlc_instance->p_libvlc_int),
thumbnail, req->type, req->width, req->height,
req->crop );
event.u.media_thumbnail_generated.p_thumbnail = pic;
libvlc_event_send( &p_media->event_manager, &event );
if ( pic != NULL )
libvlc_picture_release( pic );
}
// Start an asynchronous thumbnail generation
libvlc_media_thumbnail_request_t*
libvlc_media_thumbnail_request_by_time( libvlc_media_t *md, libvlc_time_t time,
libvlc_thumbnailer_seek_speed_t speed,
unsigned int width, unsigned int height,
bool crop, libvlc_picture_type_t picture_type,
libvlc_time_t timeout )
{
assert( md );
libvlc_priv_t *p_priv = libvlc_priv(md->p_libvlc_instance->p_libvlc_int);
if( unlikely( p_priv->p_thumbnailer == NULL ) )
return NULL;
libvlc_media_thumbnail_request_t *req = malloc( sizeof( *req ) );
if ( unlikely( req == NULL ) )
return NULL;
req->md = md;
req->width = width;
req->height = height;
req->type = picture_type;
req->crop = crop;
libvlc_media_retain( md );
req->req = vlc_thumbnailer_RequestByTime( p_priv->p_thumbnailer,
VLC_TICK_FROM_MS( time ),
speed == libvlc_media_thumbnail_seek_fast ?
VLC_THUMBNAILER_SEEK_FAST : VLC_THUMBNAILER_SEEK_PRECISE,
md->p_input_item,
timeout > 0 ? VLC_TICK_FROM_MS( timeout ) : VLC_TICK_INVALID,
media_on_thumbnail_ready, req );
if ( req->req == NULL )
{
free( req );
libvlc_media_release( md );
return NULL;
}
return req;
}
// Start an asynchronous thumbnail generation
libvlc_media_thumbnail_request_t*
libvlc_media_thumbnail_request_by_pos( libvlc_media_t *md, float pos,
libvlc_thumbnailer_seek_speed_t speed,
unsigned int width, unsigned int height,
bool crop, libvlc_picture_type_t picture_type,
libvlc_time_t timeout )
{
assert( md );
libvlc_priv_t *priv = libvlc_priv(md->p_libvlc_instance->p_libvlc_int);
if( unlikely( priv->p_thumbnailer == NULL ) )
return NULL;
libvlc_media_thumbnail_request_t *req = malloc( sizeof( *req ) );
if ( unlikely( req == NULL ) )
return NULL;
req->md = md;
req->width = width;
req->height = height;
req->crop = crop;
req->type = picture_type;
libvlc_media_retain( md );
req->req = vlc_thumbnailer_RequestByPos( priv->p_thumbnailer, pos,
speed == libvlc_media_thumbnail_seek_fast ?
VLC_THUMBNAILER_SEEK_FAST : VLC_THUMBNAILER_SEEK_PRECISE,
md->p_input_item,
timeout > 0 ? VLC_TICK_FROM_MS( timeout ) : VLC_TICK_INVALID,
media_on_thumbnail_ready, req );
if ( req->req == NULL )
{
free( req );
libvlc_media_release( md );
return NULL;
}
return req;
}
// Cancel a thumbnail request
void libvlc_media_thumbnail_request_cancel( libvlc_media_thumbnail_request_t *req )
{
libvlc_priv_t *p_priv = libvlc_priv(req->md->p_libvlc_instance->p_libvlc_int);
assert( p_priv->p_thumbnailer != NULL );
vlc_thumbnailer_Cancel( p_priv->p_thumbnailer, req->req );
}
// Destroy a thumbnail request
void libvlc_media_thumbnail_request_destroy( libvlc_media_thumbnail_request_t *req )
{
libvlc_media_release( req->md );
free( req );
}
// Add a slave to the media descriptor
int libvlc_media_slaves_add( libvlc_media_t *p_md,
libvlc_media_slave_type_t i_type,
unsigned int i_priority,
const char *psz_uri )
{
assert( p_md && psz_uri );
input_item_t *p_input_item = p_md->p_input_item;
enum slave_type i_input_slave_type;
switch( i_type )
{
case libvlc_media_slave_type_subtitle:
i_input_slave_type = SLAVE_TYPE_SPU;
break;
case libvlc_media_slave_type_generic:
i_input_slave_type = SLAVE_TYPE_GENERIC;
break;
default:
vlc_assert_unreachable();
return -1;
}
enum slave_priority i_input_slave_priority;
switch( i_priority )
{
case 0:
i_input_slave_priority = SLAVE_PRIORITY_MATCH_NONE;
break;
case 1:
i_input_slave_priority = SLAVE_PRIORITY_MATCH_RIGHT;
break;
case 2:
i_input_slave_priority = SLAVE_PRIORITY_MATCH_LEFT;
break;
case 3:
i_input_slave_priority = SLAVE_PRIORITY_MATCH_ALL;
break;
default:
case 4:
i_input_slave_priority = SLAVE_PRIORITY_USER;
break;
}
input_item_slave_t *p_slave = input_item_slave_New( psz_uri,
i_input_slave_type,
i_input_slave_priority );
if( p_slave == NULL )
return -1;
return input_item_AddSlave( p_input_item, p_slave ) == VLC_SUCCESS ? 0 : -1;
}
// Clear all slaves of the media descriptor
void libvlc_media_slaves_clear( libvlc_media_t *p_md )
{
assert( p_md );
input_item_t *p_input_item = p_md->p_input_item;
vlc_mutex_lock( &p_input_item->lock );
for( int i = 0; i < p_input_item->i_slaves; i++ )
input_item_slave_Delete( p_input_item->pp_slaves[i] );
TAB_CLEAN( p_input_item->i_slaves, p_input_item->pp_slaves );
vlc_mutex_unlock( &p_input_item->lock );
}
// Get a media descriptor's slave list
unsigned int libvlc_media_slaves_get( libvlc_media_t *p_md,
libvlc_media_slave_t ***ppp_slaves )
{
assert( p_md && ppp_slaves );
input_item_t *p_input_item = p_md->p_input_item;
*ppp_slaves = NULL;
vlc_mutex_lock( &p_input_item->lock );
int i_count = p_input_item->i_slaves;
if( i_count <= 0 )
return vlc_mutex_unlock( &p_input_item->lock ), 0;
libvlc_media_slave_t **pp_slaves = calloc( i_count, sizeof(*pp_slaves) );
if( pp_slaves == NULL )
return vlc_mutex_unlock( &p_input_item->lock ), 0;
for( int i = 0; i < i_count; ++i )
{
input_item_slave_t *p_item_slave = p_input_item->pp_slaves[i];
assert( p_item_slave->i_priority >= SLAVE_PRIORITY_MATCH_NONE );
/* also allocate psz_uri buffer at the end of the struct */
libvlc_media_slave_t *p_slave = malloc( sizeof(*p_slave) +
strlen( p_item_slave->psz_uri )
+ 1 );
if( p_slave == NULL )
{
libvlc_media_slaves_release(pp_slaves, i);
return vlc_mutex_unlock( &p_input_item->lock ), 0;
}
p_slave->psz_uri = (char *) ((uint8_t *)p_slave) + sizeof(*p_slave);
strcpy( p_slave->psz_uri, p_item_slave->psz_uri );
switch( p_item_slave->i_type )
{
case SLAVE_TYPE_SPU:
p_slave->i_type = libvlc_media_slave_type_subtitle;
break;
case SLAVE_TYPE_GENERIC:
p_slave->i_type = libvlc_media_slave_type_generic;
break;
default:
vlc_assert_unreachable();
}
switch( p_item_slave->i_priority )
{
case SLAVE_PRIORITY_MATCH_NONE:
p_slave->i_priority = 0;
break;
case SLAVE_PRIORITY_MATCH_RIGHT:
p_slave->i_priority = 1;
break;
case SLAVE_PRIORITY_MATCH_LEFT:
p_slave->i_priority = 2;
break;
case SLAVE_PRIORITY_MATCH_ALL:
p_slave->i_priority = 3;
break;
case SLAVE_PRIORITY_USER:
p_slave->i_priority = 4;
break;
default:
vlc_assert_unreachable();
}
pp_slaves[i] = p_slave;
}
vlc_mutex_unlock( &p_input_item->lock );
*ppp_slaves = pp_slaves;
return i_count;
}
// Release a media descriptor's slave list
void libvlc_media_slaves_release( libvlc_media_slave_t **pp_slaves,
unsigned int i_count )
{
if( i_count > 0 )
{
assert( pp_slaves );
for( unsigned int i = 0; i < i_count; ++i )
free( pp_slaves[i] );
}
free( pp_slaves );
}