1 /*****************************************************************************
2 * media_player.c: Libvlc API Media Instance management functions
3 *****************************************************************************
4 * Copyright (C) 2005 the VideoLAN team
7 * Authors: Clément Stenac <zorglub@videolan.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 #include "libvlc_internal.h"
26 #include <vlc/libvlc.h>
27 #include <vlc_demux.h>
28 #include <vlc_input.h>
34 input_seekable_changed( vlc_object_t * p_this, char const * psz_cmd,
35 vlc_value_t oldval, vlc_value_t newval,
38 input_pausable_changed( vlc_object_t * p_this, char const * psz_cmd,
39 vlc_value_t oldval, vlc_value_t newval,
42 input_event_changed( vlc_object_t * p_this, char const * psz_cmd,
43 vlc_value_t oldval, vlc_value_t newval,
46 static int SnapshotTakenCallback( vlc_object_t *p_this, char const *psz_cmd,
47 vlc_value_t oldval, vlc_value_t newval, void *p_data );
49 static const libvlc_state_t vlc_to_libvlc_state_array[] =
51 [INIT_S] = libvlc_NothingSpecial,
52 [OPENING_S] = libvlc_Opening,
53 [PLAYING_S] = libvlc_Playing,
54 [PAUSE_S] = libvlc_Paused,
55 [END_S] = libvlc_Ended,
56 [ERROR_S] = libvlc_Error,
59 static inline libvlc_state_t vlc_to_libvlc_state( int vlc_state )
61 if( vlc_state < 0 || vlc_state > 6 )
64 return vlc_to_libvlc_state_array[vlc_state];
68 * Release the associated input thread.
70 * Object lock is NOT held.
72 static void release_input_thread( libvlc_media_player_t *p_mi, bool b_input_abort )
74 input_thread_t * p_input_thread;
76 if( !p_mi || !p_mi->p_input_thread )
79 p_input_thread = p_mi->p_input_thread;
81 /* No one is tracking this input_thread apart from us. Destroy it. */
82 if( p_mi->b_own_its_input_thread )
84 var_DelCallback( p_input_thread, "can-seek",
85 input_seekable_changed, p_mi );
86 var_DelCallback( p_input_thread, "can-pause",
87 input_pausable_changed, p_mi );
88 var_DelCallback( p_input_thread, "intf-event",
89 input_event_changed, p_mi );
91 /* We owned this one */
92 input_StopThread( p_input_thread, b_input_abort );
93 vlc_thread_join( p_input_thread );
95 var_Destroy( p_input_thread, "drawable-hwnd" );
96 var_Destroy( p_input_thread, "drawable-xid" );
97 var_Destroy( p_input_thread, "drawable-agl" );
100 vlc_object_release( p_input_thread );
102 p_mi->p_input_thread = NULL;
106 * Retrieve the input thread. Be sure to release the object
107 * once you are done with it. (libvlc Internal)
109 * Function will lock the object.
111 input_thread_t *libvlc_get_input_thread( libvlc_media_player_t *p_mi,
112 libvlc_exception_t *p_e )
114 input_thread_t *p_input_thread;
116 if( !p_mi ) RAISENULL( "Media Instance is NULL" );
118 vlc_mutex_lock( &p_mi->object_lock );
120 if( !p_mi->p_input_thread )
122 vlc_mutex_unlock( &p_mi->object_lock );
123 RAISENULL( "Input is NULL" );
126 p_input_thread = p_mi->p_input_thread;
127 vlc_object_hold( p_input_thread );
129 vlc_mutex_unlock( &p_mi->object_lock );
131 return p_input_thread;
135 input_seekable_changed( vlc_object_t * p_this, char const * psz_cmd,
136 vlc_value_t oldval, vlc_value_t newval,
142 libvlc_media_player_t * p_mi = p_userdata;
143 libvlc_event_t event;
145 libvlc_media_set_state( p_mi->p_md, libvlc_NothingSpecial, NULL);
146 event.type = libvlc_MediaPlayerSeekableChanged;
147 event.u.media_player_seekable_changed.new_seekable = newval.b_bool;
149 libvlc_event_send( p_mi->p_event_manager, &event );
154 input_pausable_changed( vlc_object_t * p_this, char const * psz_cmd,
155 vlc_value_t oldval, vlc_value_t newval,
161 libvlc_media_player_t * p_mi = p_userdata;
162 libvlc_event_t event;
164 libvlc_media_set_state( p_mi->p_md, libvlc_NothingSpecial, NULL);
165 event.type = libvlc_MediaPlayerPausableChanged;
166 event.u.media_player_pausable_changed.new_pausable = newval.b_bool;
168 libvlc_event_send( p_mi->p_event_manager, &event );
173 input_event_changed( vlc_object_t * p_this, char const * psz_cmd,
174 vlc_value_t oldval, vlc_value_t newval,
178 input_thread_t * p_input = (input_thread_t *)p_this;
179 libvlc_media_player_t * p_mi = p_userdata;
180 libvlc_event_t event;
182 assert( !strcmp( psz_cmd, "intf-event" ) );
184 if( newval.i_int == INPUT_EVENT_STATE )
186 libvlc_state_t libvlc_state;
188 switch ( var_GetInteger( p_input, "state" ) )
191 libvlc_state = libvlc_NothingSpecial;
192 event.type = libvlc_MediaPlayerNothingSpecial;
195 libvlc_state = libvlc_Opening;
196 event.type = libvlc_MediaPlayerOpening;
199 libvlc_state = libvlc_Playing;
200 event.type = libvlc_MediaPlayerPlaying;
203 libvlc_state = libvlc_Paused;
204 event.type = libvlc_MediaPlayerPaused;
207 libvlc_state = libvlc_Ended;
208 event.type = libvlc_MediaPlayerEndReached;
211 libvlc_state = libvlc_Error;
212 event.type = libvlc_MediaPlayerEncounteredError;
219 libvlc_media_set_state( p_mi->p_md, libvlc_state, NULL );
220 libvlc_event_send( p_mi->p_event_manager, &event );
222 else if( newval.i_int == INPUT_EVENT_TIMES )
224 if( var_GetInteger( p_input, "state" ) != PLAYING_S )
225 return VLC_SUCCESS; /* Don't send the position while stopped */
228 event.type = libvlc_MediaPlayerPositionChanged;
229 event.u.media_player_position_changed.new_position =
230 var_GetFloat( p_input, "position" );
231 libvlc_event_send( p_mi->p_event_manager, &event );
234 event.type = libvlc_MediaPlayerTimeChanged;
235 event.u.media_player_time_changed.new_time =
236 var_GetTime( p_input, "time" );
237 libvlc_event_send( p_mi->p_event_manager, &event );
245 /**************************************************************************
246 * Create a Media Instance object.
249 * - All items created by _new start with a refcount set to 1.
250 * - Accessor _release decrease the refcount by 1, if after that
251 * operation the refcount is 0, the object is destroyed.
252 * - Accessor _retain increase the refcount by 1 (XXX: to implement)
254 * Object locking strategy:
255 * - No lock held while in constructor.
256 * - When accessing any member variable this lock is held. (XXX who locks?)
257 * - When attempting to destroy the object the lock is also held.
258 **************************************************************************/
259 libvlc_media_player_t *
260 libvlc_media_player_new( libvlc_instance_t * p_libvlc_instance,
261 libvlc_exception_t * p_e )
263 libvlc_media_player_t * p_mi;
265 if( !p_libvlc_instance )
267 libvlc_exception_raise( p_e, "invalid libvlc instance" );
271 p_mi = malloc( sizeof(libvlc_media_player_t) );
274 libvlc_exception_raise( p_e, "Not enough memory" );
278 p_mi->drawable.agl = 0;
279 p_mi->drawable.xid = 0;
280 p_mi->drawable.hwnd = NULL;
281 p_mi->p_libvlc_instance = p_libvlc_instance;
282 p_mi->p_input_thread = NULL;
283 p_mi->i_refcount = 1;
284 p_mi->b_own_its_input_thread = true;
285 vlc_mutex_init( &p_mi->object_lock );
286 p_mi->p_event_manager = libvlc_event_manager_new( p_mi,
287 p_libvlc_instance, p_e );
288 if( libvlc_exception_raised( p_e ) )
294 libvlc_event_manager_register_event_type( p_mi->p_event_manager,
295 libvlc_MediaPlayerNothingSpecial, p_e );
296 libvlc_event_manager_register_event_type( p_mi->p_event_manager,
297 libvlc_MediaPlayerOpening, p_e );
298 libvlc_event_manager_register_event_type( p_mi->p_event_manager,
299 libvlc_MediaPlayerBuffering, p_e );
300 libvlc_event_manager_register_event_type( p_mi->p_event_manager,
301 libvlc_MediaPlayerPlaying, p_e );
302 libvlc_event_manager_register_event_type( p_mi->p_event_manager,
303 libvlc_MediaPlayerPaused, p_e );
304 libvlc_event_manager_register_event_type( p_mi->p_event_manager,
305 libvlc_MediaPlayerStopped, p_e );
306 libvlc_event_manager_register_event_type( p_mi->p_event_manager,
307 libvlc_MediaPlayerForward, p_e );
308 libvlc_event_manager_register_event_type( p_mi->p_event_manager,
309 libvlc_MediaPlayerBackward, p_e );
310 libvlc_event_manager_register_event_type( p_mi->p_event_manager,
311 libvlc_MediaPlayerEndReached, p_e );
312 libvlc_event_manager_register_event_type( p_mi->p_event_manager,
313 libvlc_MediaPlayerEncounteredError, p_e );
315 libvlc_event_manager_register_event_type( p_mi->p_event_manager,
316 libvlc_MediaPlayerPositionChanged, p_e );
317 libvlc_event_manager_register_event_type( p_mi->p_event_manager,
318 libvlc_MediaPlayerTimeChanged, p_e );
319 libvlc_event_manager_register_event_type( p_mi->p_event_manager,
320 libvlc_MediaPlayerTitleChanged, p_e );
321 libvlc_event_manager_register_event_type( p_mi->p_event_manager,
322 libvlc_MediaPlayerSeekableChanged, p_e );
323 libvlc_event_manager_register_event_type( p_mi->p_event_manager,
324 libvlc_MediaPlayerPausableChanged, p_e );
326 /* Snapshot initialization */
327 libvlc_event_manager_register_event_type( p_mi->p_event_manager,
328 libvlc_MediaPlayerSnapshotTaken, p_e );
329 /* Attach a var callback to the global object to provide the glue between
330 vout_thread that generates the event and media_player that re-emits it
331 with its own event manager
333 var_Create( p_libvlc_instance->p_libvlc_int, "vout-snapshottaken",
334 VLC_VAR_STRING | VLC_VAR_ISCOMMAND );
335 var_AddCallback( p_libvlc_instance->p_libvlc_int, "vout-snapshottaken",
336 SnapshotTakenCallback, p_mi );
341 /**************************************************************************
342 * Create a Media Instance object with a media descriptor.
343 **************************************************************************/
344 libvlc_media_player_t *
345 libvlc_media_player_new_from_media(
346 libvlc_media_t * p_md,
347 libvlc_exception_t *p_e )
349 libvlc_media_player_t * p_mi;
350 p_mi = libvlc_media_player_new( p_md->p_libvlc_instance, p_e );
355 libvlc_media_retain( p_md );
361 /**************************************************************************
362 * Create a new media instance object from an input_thread (Libvlc Internal).
363 **************************************************************************/
364 libvlc_media_player_t * libvlc_media_player_new_from_input_thread(
365 struct libvlc_instance_t *p_libvlc_instance,
366 input_thread_t *p_input,
367 libvlc_exception_t *p_e )
369 libvlc_media_player_t * p_mi;
373 libvlc_exception_raise( p_e, "invalid input thread" );
377 p_mi = libvlc_media_player_new( p_libvlc_instance, p_e );
382 p_mi->p_md = libvlc_media_new_from_input_item(
384 input_GetItem( p_input ), p_e );
388 libvlc_media_player_destroy( p_mi );
392 /* will be released in media_player_release() */
393 vlc_object_hold( p_input );
395 p_mi->p_input_thread = p_input;
396 p_mi->b_own_its_input_thread = false;
401 /**************************************************************************
402 * Destroy a Media Instance object (libvlc internal)
404 * Warning: No lock held here, but hey, this is internal. Caller must lock.
405 **************************************************************************/
406 void libvlc_media_player_destroy( libvlc_media_player_t *p_mi )
408 input_thread_t *p_input_thread;
409 libvlc_exception_t p_e;
411 libvlc_exception_init( &p_e );
416 /* Detach Callback from the main libvlc object */
417 var_DelCallback( p_mi->p_libvlc_instance->p_libvlc_int,
418 "vout-snapshottaken", SnapshotTakenCallback, p_mi );
420 p_input_thread = libvlc_get_input_thread( p_mi, &p_e );
422 if( libvlc_exception_raised( &p_e ) )
424 libvlc_event_manager_release( p_mi->p_event_manager );
425 libvlc_exception_clear( &p_e );
427 return; /* no need to worry about no input thread */
429 vlc_mutex_destroy( &p_mi->object_lock );
431 vlc_object_release( p_input_thread );
433 libvlc_media_release( p_mi->p_md );
438 /**************************************************************************
439 * Release a Media Instance object.
441 * Function does the locking.
442 **************************************************************************/
443 void libvlc_media_player_release( libvlc_media_player_t *p_mi )
448 vlc_mutex_lock( &p_mi->object_lock );
452 if( p_mi->i_refcount > 0 )
454 vlc_mutex_unlock( &p_mi->object_lock );
457 vlc_mutex_unlock( &p_mi->object_lock );
458 vlc_mutex_destroy( &p_mi->object_lock );
460 release_input_thread( p_mi, true );
462 libvlc_event_manager_release( p_mi->p_event_manager );
464 libvlc_media_release( p_mi->p_md );
469 /**************************************************************************
470 * Retain a Media Instance object.
472 * Caller must hold the lock.
473 **************************************************************************/
474 void libvlc_media_player_retain( libvlc_media_player_t *p_mi )
482 /**************************************************************************
483 * Set the Media descriptor associated with the instance.
485 * Enter without lock -- function will lock the object.
486 **************************************************************************/
487 void libvlc_media_player_set_media(
488 libvlc_media_player_t *p_mi,
489 libvlc_media_t *p_md,
490 libvlc_exception_t *p_e )
497 vlc_mutex_lock( &p_mi->object_lock );
499 /* FIXME I am not sure if it is a user request or on die(eof/error)
501 release_input_thread( p_mi,
502 p_mi->p_input_thread &&
503 !p_mi->p_input_thread->b_eof &&
504 !p_mi->p_input_thread->b_error );
507 libvlc_media_set_state( p_mi->p_md, libvlc_NothingSpecial, p_e );
509 libvlc_media_release( p_mi->p_md );
514 vlc_mutex_unlock( &p_mi->object_lock );
515 return; /* It is ok to pass a NULL md */
518 libvlc_media_retain( p_md );
521 /* The policy here is to ignore that we were created using a different
522 * libvlc_instance, because we don't really care */
523 p_mi->p_libvlc_instance = p_md->p_libvlc_instance;
525 vlc_mutex_unlock( &p_mi->object_lock );
528 /**************************************************************************
529 * Get the Media descriptor associated with the instance.
530 **************************************************************************/
532 libvlc_media_player_get_media(
533 libvlc_media_player_t *p_mi,
534 libvlc_exception_t *p_e )
541 libvlc_media_retain( p_mi->p_md );
545 /**************************************************************************
546 * Get the event Manager.
547 **************************************************************************/
548 libvlc_event_manager_t *
549 libvlc_media_player_event_manager(
550 libvlc_media_player_t *p_mi,
551 libvlc_exception_t *p_e )
555 return p_mi->p_event_manager;
558 /**************************************************************************
559 * Trigger a snapshot Taken Event.
560 *************************************************************************/
561 static int SnapshotTakenCallback( vlc_object_t *p_this, char const *psz_cmd,
562 vlc_value_t oldval, vlc_value_t newval, void *p_data )
564 VLC_UNUSED(psz_cmd); VLC_UNUSED(oldval);
567 libvlc_media_player_t* p_mi = (libvlc_media_player_t*) p_data ;
568 libvlc_event_t event ;
569 event.type = libvlc_MediaPlayerSnapshotTaken ;
570 event.u.media_player_snapshot_taken.psz_filename = newval.psz_string ;
571 /* Snapshot psz data is a vlc_variable owned by libvlc object .
572 Its memmory management is taken care by the obj*/
573 msg_Dbg( p_this, "about to emit libvlc_snapshot_taken.make psz_str=0x%p"
574 " (%s)", event.u.media_player_snapshot_taken.psz_filename,
575 event.u.media_player_snapshot_taken.psz_filename );
576 libvlc_event_send( p_mi->p_event_manager, &event );
581 /**************************************************************************
582 * Tell media player to start playing.
583 **************************************************************************/
584 void libvlc_media_player_play( libvlc_media_player_t *p_mi,
585 libvlc_exception_t *p_e )
587 input_thread_t * p_input_thread;
589 if( (p_input_thread = libvlc_get_input_thread( p_mi, p_e )) )
591 /* A thread already exists, send it a play message */
592 input_Control( p_input_thread, INPUT_SET_STATE, PLAYING_S );
593 vlc_object_release( p_input_thread );
597 /* Ignore previous exception */
598 libvlc_exception_clear( p_e );
600 vlc_mutex_lock( &p_mi->object_lock );
604 libvlc_exception_raise( p_e, "no associated media descriptor" );
605 vlc_mutex_unlock( &p_mi->object_lock );
609 p_mi->p_input_thread = input_CreateThread(
610 p_mi->p_libvlc_instance->p_libvlc_int, p_mi->p_md->p_input_item );
612 if( !p_mi->p_input_thread )
614 vlc_mutex_unlock( &p_mi->object_lock );
618 p_input_thread = p_mi->p_input_thread;
620 var_Create( p_input_thread, "drawable-agl", VLC_VAR_INTEGER );
621 if( p_mi->drawable.agl )
622 var_SetInteger( p_input_thread, "drawable-agl", p_mi->drawable.agl );
624 var_Create( p_input_thread, "drawable-xid", VLC_VAR_INTEGER );
625 if( p_mi->drawable.xid )
626 var_SetInteger( p_input_thread, "drawable-xid", p_mi->drawable.xid );
628 var_Create( p_input_thread, "drawable-hwnd", VLC_VAR_ADDRESS );
629 if( p_mi->drawable.hwnd != NULL )
631 vlc_value_t val = { .p_address = p_mi->drawable.hwnd };
632 var_Set( p_input_thread, "drawable-hwnd", val );
635 var_AddCallback( p_input_thread, "can-seek", input_seekable_changed, p_mi );
636 var_AddCallback( p_input_thread, "can-pause", input_pausable_changed, p_mi );
637 var_AddCallback( p_input_thread, "intf-event", input_event_changed, p_mi );
639 vlc_mutex_unlock( &p_mi->object_lock );
642 /**************************************************************************
644 **************************************************************************/
645 void libvlc_media_player_pause( libvlc_media_player_t *p_mi,
646 libvlc_exception_t *p_e )
648 input_thread_t * p_input_thread = libvlc_get_input_thread( p_mi, p_e );
650 if( !p_input_thread )
653 libvlc_state_t state = libvlc_media_player_get_state( p_mi, p_e );
655 if( state == libvlc_Playing )
657 if( libvlc_media_player_can_pause( p_mi, p_e ) )
658 input_Control( p_input_thread, INPUT_SET_STATE, PAUSE_S );
660 libvlc_media_player_stop( p_mi, p_e );
663 input_Control( p_input_thread, INPUT_SET_STATE, PLAYING_S );
665 vlc_object_release( p_input_thread );
668 /**************************************************************************
669 * Tells whether the media player is currently playing.
671 * Enter with lock held.
672 **************************************************************************/
673 int libvlc_media_player_is_playing( libvlc_media_player_t *p_mi,
674 libvlc_exception_t *p_e )
676 libvlc_state_t state = libvlc_media_player_get_state( p_mi, p_e );
677 return libvlc_Playing == state;
681 /**************************************************************************
683 **************************************************************************/
684 void libvlc_media_player_stop( libvlc_media_player_t *p_mi,
685 libvlc_exception_t *p_e )
687 libvlc_state_t state = libvlc_media_player_get_state( p_mi, p_e );
689 if( state == libvlc_Playing || state == libvlc_Paused )
691 /* Send a stop notification event only if we are in playing or
693 libvlc_media_set_state( p_mi->p_md, libvlc_Ended, p_e );
695 /* Construct and send the event */
696 libvlc_event_t event;
697 event.type = libvlc_MediaPlayerStopped;
698 libvlc_event_send( p_mi->p_event_manager, &event );
701 if( p_mi->b_own_its_input_thread )
703 vlc_mutex_lock( &p_mi->object_lock );
704 release_input_thread( p_mi, true ); /* This will stop the input thread */
705 vlc_mutex_unlock( &p_mi->object_lock );
709 input_thread_t * p_input_thread = libvlc_get_input_thread( p_mi, p_e );
711 if( !p_input_thread )
714 input_StopThread( p_input_thread, true );
715 vlc_object_release( p_input_thread );
716 p_mi->p_input_thread = NULL;
720 /**************************************************************************
722 **************************************************************************/
723 void libvlc_media_player_set_agl( libvlc_media_player_t *p_mi,
725 libvlc_exception_t *p_e )
728 p_mi->drawable.agl = drawable;
731 /**************************************************************************
733 **************************************************************************/
734 uint32_t libvlc_media_player_get_agl( libvlc_media_player_t *p_mi )
736 return p_mi->drawable.agl;
739 /**************************************************************************
741 **************************************************************************/
742 void libvlc_media_player_set_xwindow( libvlc_media_player_t *p_mi,
744 libvlc_exception_t *p_e )
747 p_mi->drawable.xid = drawable;
750 /**************************************************************************
752 **************************************************************************/
753 uint32_t libvlc_media_player_get_xwindow( libvlc_media_player_t *p_mi )
755 return p_mi->drawable.xid;
758 /**************************************************************************
760 **************************************************************************/
761 void libvlc_media_player_set_hwnd( libvlc_media_player_t *p_mi,
763 libvlc_exception_t *p_e )
766 p_mi->drawable.hwnd = drawable;
769 /**************************************************************************
771 **************************************************************************/
772 void *libvlc_media_player_get_hwnd( libvlc_media_player_t *p_mi )
774 return p_mi->drawable.hwnd;
777 /**************************************************************************
779 **************************************************************************/
780 void libvlc_media_player_set_drawable( libvlc_media_player_t *p_mi,
781 libvlc_drawable_t drawable,
782 libvlc_exception_t *p_e )
785 if (sizeof (HWND) <= sizeof (libvlc_drawable_t))
786 p_mi->drawable.hwnd = (HWND)drawable;
788 libvlc_exception_raise(p_e, "Operation not supported");
789 #elif defined(__APPLE__)
790 p_mi->drawable.agl = drawable;
793 p_mi->drawable.xid = drawable;
798 /**************************************************************************
800 **************************************************************************/
802 libvlc_media_player_get_drawable ( libvlc_media_player_t *p_mi,
803 libvlc_exception_t *p_e )
808 if (sizeof (HWND) <= sizeof (libvlc_drawable_t))
809 return (libvlc_drawable_t)p_mi->drawable.hwnd;
812 #elif defined(__APPLE__)
813 return p_mi->drawable.agl;
815 return p_mi->drawable.xid;
819 /**************************************************************************
820 * Getters for stream information
821 **************************************************************************/
822 libvlc_time_t libvlc_media_player_get_length(
823 libvlc_media_player_t *p_mi,
824 libvlc_exception_t *p_e )
826 input_thread_t *p_input_thread;
829 p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
830 if( !p_input_thread )
833 var_Get( p_input_thread, "length", &val );
834 vlc_object_release( p_input_thread );
836 return (val.i_time+500LL)/1000LL;
839 libvlc_time_t libvlc_media_player_get_time(
840 libvlc_media_player_t *p_mi,
841 libvlc_exception_t *p_e )
843 input_thread_t *p_input_thread;
846 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
847 if( !p_input_thread )
850 var_Get( p_input_thread , "time", &val );
851 vlc_object_release( p_input_thread );
852 return (val.i_time+500LL)/1000LL;
855 void libvlc_media_player_set_time(
856 libvlc_media_player_t *p_mi,
858 libvlc_exception_t *p_e )
860 input_thread_t *p_input_thread;
863 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
864 if( !p_input_thread )
867 value.i_time = time*1000LL;
868 var_Set( p_input_thread, "time", value );
869 vlc_object_release( p_input_thread );
872 void libvlc_media_player_set_position(
873 libvlc_media_player_t *p_mi,
875 libvlc_exception_t *p_e )
877 input_thread_t *p_input_thread;
879 val.f_float = position;
881 p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
882 if( !p_input_thread )
885 var_Set( p_input_thread, "position", val );
886 vlc_object_release( p_input_thread );
889 float libvlc_media_player_get_position(
890 libvlc_media_player_t *p_mi,
891 libvlc_exception_t *p_e )
893 input_thread_t *p_input_thread;
896 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
897 if( !p_input_thread )
900 var_Get( p_input_thread, "position", &val );
901 vlc_object_release( p_input_thread );
906 void libvlc_media_player_set_chapter(
907 libvlc_media_player_t *p_mi,
909 libvlc_exception_t *p_e )
911 input_thread_t *p_input_thread;
915 p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
916 if( !p_input_thread )
919 var_Set( p_input_thread, "chapter", val );
920 vlc_object_release( p_input_thread );
923 int libvlc_media_player_get_chapter(
924 libvlc_media_player_t *p_mi,
925 libvlc_exception_t *p_e )
927 input_thread_t *p_input_thread;
930 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
931 if( !p_input_thread )
934 var_Get( p_input_thread, "chapter", &val );
935 vlc_object_release( p_input_thread );
940 int libvlc_media_player_get_chapter_count(
941 libvlc_media_player_t *p_mi,
942 libvlc_exception_t *p_e )
944 input_thread_t *p_input_thread;
947 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
948 if( !p_input_thread )
951 var_Change( p_input_thread, "chapter", VLC_VAR_CHOICESCOUNT, &val, NULL );
952 vlc_object_release( p_input_thread );
957 int libvlc_media_player_get_chapter_count_for_title(
958 libvlc_media_player_t *p_mi,
960 libvlc_exception_t *p_e )
962 input_thread_t *p_input_thread;
965 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
966 if( !p_input_thread )
970 if( asprintf( &psz_name, "title %2i", i_title ) == -1 )
972 vlc_object_release( p_input_thread );
975 var_Change( p_input_thread, psz_name, VLC_VAR_CHOICESCOUNT, &val, NULL );
976 vlc_object_release( p_input_thread );
982 void libvlc_media_player_set_title(
983 libvlc_media_player_t *p_mi,
985 libvlc_exception_t *p_e )
987 input_thread_t *p_input_thread;
991 p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
992 if( !p_input_thread )
995 var_Set( p_input_thread, "title", val );
996 vlc_object_release( p_input_thread );
999 libvlc_event_t event;
1000 event.type = libvlc_MediaPlayerTitleChanged;
1001 event.u.media_player_title_changed.new_title = i_title;
1002 libvlc_event_send( p_mi->p_event_manager, &event );
1005 int libvlc_media_player_get_title(
1006 libvlc_media_player_t *p_mi,
1007 libvlc_exception_t *p_e )
1009 input_thread_t *p_input_thread;
1012 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1013 if( !p_input_thread )
1016 var_Get( p_input_thread, "title", &val );
1017 vlc_object_release( p_input_thread );
1022 int libvlc_media_player_get_title_count(
1023 libvlc_media_player_t *p_mi,
1024 libvlc_exception_t *p_e )
1026 input_thread_t *p_input_thread;
1029 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1030 if( !p_input_thread )
1033 var_Change( p_input_thread, "title", VLC_VAR_CHOICESCOUNT, &val, NULL );
1034 vlc_object_release( p_input_thread );
1039 void libvlc_media_player_next_chapter(
1040 libvlc_media_player_t *p_mi,
1041 libvlc_exception_t *p_e )
1043 input_thread_t *p_input_thread;
1045 p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
1046 if( !p_input_thread )
1049 int i_type = var_Type( p_input_thread, "next-chapter" );
1052 var_Set( p_input_thread, (i_type & VLC_VAR_TYPE) != 0 ?
1053 "next-chapter":"next-title", val );
1055 vlc_object_release( p_input_thread );
1058 void libvlc_media_player_previous_chapter(
1059 libvlc_media_player_t *p_mi,
1060 libvlc_exception_t *p_e )
1062 input_thread_t *p_input_thread;
1064 p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
1065 if( !p_input_thread )
1068 int i_type = var_Type( p_input_thread, "next-chapter" );
1071 var_Set( p_input_thread, (i_type & VLC_VAR_TYPE) != 0 ?
1072 "prev-chapter":"prev-title", val );
1074 vlc_object_release( p_input_thread );
1077 float libvlc_media_player_get_fps(
1078 libvlc_media_player_t *p_mi,
1079 libvlc_exception_t *p_e)
1081 input_thread_t *p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1084 if( p_input_thread )
1086 if( input_Control( p_input_thread, INPUT_GET_VIDEO_FPS, &f_fps ) )
1088 vlc_object_release( p_input_thread );
1093 int libvlc_media_player_will_play( libvlc_media_player_t *p_mi,
1094 libvlc_exception_t *p_e)
1096 input_thread_t *p_input_thread =
1097 libvlc_get_input_thread ( p_mi, p_e);
1098 if ( !p_input_thread )
1101 if ( !p_input_thread->b_die && !p_input_thread->b_dead )
1103 vlc_object_release( p_input_thread );
1106 vlc_object_release( p_input_thread );
1110 void libvlc_media_player_set_rate(
1111 libvlc_media_player_t *p_mi,
1113 libvlc_exception_t *p_e )
1115 input_thread_t *p_input_thread;
1119 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1120 if( !p_input_thread )
1123 b_can_rewind = var_GetBool( p_input_thread, "can-rewind" );
1124 if( (rate < 0.0) && !b_can_rewind )
1126 vlc_object_release( p_input_thread );
1127 libvlc_exception_raise( p_e, "Rate value is invalid" );
1131 val.i_int = 1000.0f/rate;
1132 var_Set( p_input_thread, "rate", val );
1133 vlc_object_release( p_input_thread );
1136 float libvlc_media_player_get_rate(
1137 libvlc_media_player_t *p_mi,
1138 libvlc_exception_t *p_e )
1140 input_thread_t *p_input_thread;
1144 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1145 if( !p_input_thread )
1146 return 0.0; /* rate < 0 indicates rewind */
1148 var_Get( p_input_thread, "rate", &val );
1149 b_can_rewind = var_GetBool( p_input_thread, "can-rewind" );
1150 if( (val.i_int < 0) && !b_can_rewind )
1152 libvlc_exception_raise( p_e, "invalid rate" );
1155 vlc_object_release( p_input_thread );
1157 return (float)1000.0f/val.i_int;
1160 libvlc_state_t libvlc_media_player_get_state(
1161 libvlc_media_player_t *p_mi,
1162 libvlc_exception_t *p_e )
1164 input_thread_t *p_input_thread;
1165 libvlc_state_t state = libvlc_Ended;
1168 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1169 if( !p_input_thread )
1171 /* We do return the right value, no need to throw an exception */
1172 if( libvlc_exception_raised( p_e ) )
1173 libvlc_exception_clear( p_e );
1177 var_Get( p_input_thread, "state", &val );
1178 state = vlc_to_libvlc_state(val.i_int);
1180 if( state == libvlc_Playing )
1183 caching = var_GetFloat( p_input_thread, "cache" );
1184 if( caching > 0.0 && caching < 1.0 )
1185 state = libvlc_Buffering;
1187 vlc_object_release( p_input_thread );
1191 int libvlc_media_player_is_seekable( libvlc_media_player_t *p_mi,
1192 libvlc_exception_t *p_e )
1194 input_thread_t *p_input_thread;
1197 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1198 if ( !p_input_thread )
1200 /* We do return the right value, no need to throw an exception */
1201 if( libvlc_exception_raised( p_e ) )
1202 libvlc_exception_clear( p_e );
1205 var_Get( p_input_thread, "can-seek", &val );
1206 vlc_object_release( p_input_thread );
1211 /* internal function, used by audio, video */
1212 libvlc_track_description_t *
1213 libvlc_get_track_description( libvlc_media_player_t *p_mi,
1214 const char *psz_variable,
1215 libvlc_exception_t *p_e )
1217 input_thread_t *p_input = libvlc_get_input_thread( p_mi, p_e );
1222 vlc_value_t val_list, text_list;
1223 var_Change( p_input, psz_variable, VLC_VAR_GETLIST, &val_list, &text_list);
1225 if( val_list.p_list->i_count <= 0 ) /* no tracks */
1228 libvlc_track_description_t *p_track_description, *p_actual, *p_previous;
1229 p_track_description = ( libvlc_track_description_t * )
1230 malloc( sizeof( libvlc_track_description_t ) );
1231 if ( !p_track_description )
1233 var_Change( p_input, psz_variable, VLC_VAR_FREELIST,
1234 &val_list, &text_list);
1235 vlc_object_release( p_input );
1236 libvlc_exception_raise( p_e, "no enough memory" );
1239 p_actual = p_track_description;
1241 for( int i = 0; i < val_list.p_list->i_count; i++ )
1245 p_actual = ( libvlc_track_description_t * )
1246 malloc( sizeof( libvlc_track_description_t ) );
1249 libvlc_track_description_release( p_track_description );
1250 var_Change( p_input, psz_variable, VLC_VAR_FREELIST,
1251 &val_list, &text_list);
1252 vlc_object_release( p_input );
1253 libvlc_exception_raise( p_e, "no enough memory" );
1257 p_actual->i_id = val_list.p_list->p_values[i].i_int;
1258 p_actual->psz_name = strdup( text_list.p_list->p_values[i].psz_string );
1259 p_actual->p_next = NULL;
1261 p_previous->p_next = p_actual;
1262 p_previous = p_actual;
1265 var_Change( p_input, psz_variable, VLC_VAR_FREELIST, &val_list, &text_list);
1266 vlc_object_release( p_input );
1268 return p_track_description;
1271 void libvlc_track_description_release( libvlc_track_description_t *p_td )
1273 libvlc_track_description_t *p_actual, *p_before;
1278 free( p_actual->psz_name );
1279 p_before = p_actual;
1280 p_actual = p_before->p_next;
1285 int libvlc_media_player_can_pause( libvlc_media_player_t *p_mi,
1286 libvlc_exception_t *p_e )
1288 input_thread_t *p_input_thread;
1291 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1292 if ( !p_input_thread )
1294 /* We do return the right value, no need to throw an exception */
1295 if( libvlc_exception_raised( p_e ) )
1296 libvlc_exception_clear( p_e );
1299 var_Get( p_input_thread, "can-pause", &val );
1300 vlc_object_release( p_input_thread );