1 /*****************************************************************************
2 * media_player.c: Libvlc API Media Instance management functions
3 *****************************************************************************
4 * Copyright (C) 2005-2009 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 );
244 /**************************************************************************
245 * Create a Media Instance object.
248 * - All items created by _new start with a refcount set to 1.
249 * - Accessor _release decrease the refcount by 1, if after that
250 * operation the refcount is 0, the object is destroyed.
251 * - Accessor _retain increase the refcount by 1 (XXX: to implement)
253 * Object locking strategy:
254 * - No lock held while in constructor.
255 * - When accessing any member variable this lock is held. (XXX who locks?)
256 * - When attempting to destroy the object the lock is also held.
257 **************************************************************************/
258 libvlc_media_player_t *
259 libvlc_media_player_new( libvlc_instance_t * p_libvlc_instance,
260 libvlc_exception_t * p_e )
262 libvlc_media_player_t * p_mi;
264 if( !p_libvlc_instance )
266 libvlc_exception_raise( p_e, "invalid libvlc instance" );
270 p_mi = malloc( sizeof(libvlc_media_player_t) );
273 libvlc_exception_raise( p_e, "Not enough memory" );
277 p_mi->drawable.agl = 0;
278 p_mi->drawable.xid = 0;
279 p_mi->drawable.hwnd = NULL;
280 p_mi->p_libvlc_instance = p_libvlc_instance;
281 p_mi->p_input_thread = NULL;
282 p_mi->i_refcount = 1;
283 p_mi->b_own_its_input_thread = true;
284 vlc_mutex_init( &p_mi->object_lock );
285 p_mi->p_event_manager = libvlc_event_manager_new( p_mi,
286 p_libvlc_instance, p_e );
287 if( libvlc_exception_raised( p_e ) )
289 vlc_mutex_destroy( &p_mi->object_lock );
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_Create( p_input_thread, "drawable-nsobject", VLC_VAR_ADDRESS );
636 if( p_mi->drawable.nsobject != NULL )
638 vlc_value_t val = { .p_address = p_mi->drawable.nsobject };
639 var_Set( p_input_thread, "drawable-nsobject", val );
642 var_AddCallback( p_input_thread, "can-seek", input_seekable_changed, p_mi );
643 var_AddCallback( p_input_thread, "can-pause", input_pausable_changed, p_mi );
644 var_AddCallback( p_input_thread, "intf-event", input_event_changed, p_mi );
646 vlc_mutex_unlock( &p_mi->object_lock );
649 /**************************************************************************
651 **************************************************************************/
652 void libvlc_media_player_pause( libvlc_media_player_t *p_mi,
653 libvlc_exception_t *p_e )
655 input_thread_t * p_input_thread = libvlc_get_input_thread( p_mi, p_e );
657 if( !p_input_thread )
660 libvlc_state_t state = libvlc_media_player_get_state( p_mi, p_e );
662 if( state == libvlc_Playing )
664 if( libvlc_media_player_can_pause( p_mi, p_e ) )
665 input_Control( p_input_thread, INPUT_SET_STATE, PAUSE_S );
667 libvlc_media_player_stop( p_mi, p_e );
670 input_Control( p_input_thread, INPUT_SET_STATE, PLAYING_S );
672 vlc_object_release( p_input_thread );
675 /**************************************************************************
676 * Tells whether the media player is currently playing.
678 * Enter with lock held.
679 **************************************************************************/
680 int libvlc_media_player_is_playing( libvlc_media_player_t *p_mi,
681 libvlc_exception_t *p_e )
683 libvlc_state_t state = libvlc_media_player_get_state( p_mi, p_e );
684 return libvlc_Playing == state;
687 /**************************************************************************
689 **************************************************************************/
690 void libvlc_media_player_stop( libvlc_media_player_t *p_mi,
691 libvlc_exception_t *p_e )
693 libvlc_state_t state = libvlc_media_player_get_state( p_mi, p_e );
695 if( state == libvlc_Playing || state == libvlc_Paused )
697 /* Send a stop notification event only if we are in playing or
699 libvlc_media_set_state( p_mi->p_md, libvlc_Ended, p_e );
701 /* Construct and send the event */
702 libvlc_event_t event;
703 event.type = libvlc_MediaPlayerStopped;
704 libvlc_event_send( p_mi->p_event_manager, &event );
707 if( p_mi->b_own_its_input_thread )
709 vlc_mutex_lock( &p_mi->object_lock );
710 release_input_thread( p_mi, true ); /* This will stop the input thread */
711 vlc_mutex_unlock( &p_mi->object_lock );
715 input_thread_t * p_input_thread = libvlc_get_input_thread( p_mi, p_e );
717 if( !p_input_thread )
720 input_StopThread( p_input_thread, true );
721 vlc_object_release( p_input_thread );
722 p_mi->p_input_thread = NULL;
726 /**************************************************************************
728 **************************************************************************/
729 void libvlc_media_player_set_nsobject( libvlc_media_player_t *p_mi,
731 libvlc_exception_t *p_e )
734 p_mi->drawable.nsobject = drawable;
737 /**************************************************************************
739 **************************************************************************/
740 uint32_t libvlc_media_player_get_nsobject( libvlc_media_player_t *p_mi )
742 return p_mi->drawable.nsobject;
745 /**************************************************************************
747 **************************************************************************/
748 void libvlc_media_player_set_agl( libvlc_media_player_t *p_mi,
750 libvlc_exception_t *p_e )
753 p_mi->drawable.agl = drawable;
756 /**************************************************************************
758 **************************************************************************/
759 uint32_t libvlc_media_player_get_agl( libvlc_media_player_t *p_mi )
761 return p_mi->drawable.agl;
764 /**************************************************************************
766 **************************************************************************/
767 void libvlc_media_player_set_xwindow( libvlc_media_player_t *p_mi,
769 libvlc_exception_t *p_e )
772 p_mi->drawable.xid = drawable;
775 /**************************************************************************
777 **************************************************************************/
778 uint32_t libvlc_media_player_get_xwindow( libvlc_media_player_t *p_mi )
780 return p_mi->drawable.xid;
783 /**************************************************************************
785 **************************************************************************/
786 void libvlc_media_player_set_hwnd( libvlc_media_player_t *p_mi,
788 libvlc_exception_t *p_e )
791 p_mi->drawable.hwnd = drawable;
794 /**************************************************************************
796 **************************************************************************/
797 void *libvlc_media_player_get_hwnd( libvlc_media_player_t *p_mi )
799 return p_mi->drawable.hwnd;
802 /**************************************************************************
804 **************************************************************************/
805 void libvlc_media_player_set_drawable( libvlc_media_player_t *p_mi,
806 libvlc_drawable_t drawable,
807 libvlc_exception_t *p_e )
810 if (sizeof (HWND) <= sizeof (libvlc_drawable_t))
811 p_mi->drawable.hwnd = (HWND)drawable;
813 libvlc_exception_raise(p_e, "Operation not supported");
814 #elif defined(__APPLE__)
815 p_mi->drawable.agl = drawable;
818 p_mi->drawable.xid = drawable;
823 /**************************************************************************
825 **************************************************************************/
827 libvlc_media_player_get_drawable ( libvlc_media_player_t *p_mi,
828 libvlc_exception_t *p_e )
833 if (sizeof (HWND) <= sizeof (libvlc_drawable_t))
834 return (libvlc_drawable_t)p_mi->drawable.hwnd;
837 #elif defined(__APPLE__)
838 return p_mi->drawable.agl;
840 return p_mi->drawable.xid;
844 /**************************************************************************
845 * Getters for stream information
846 **************************************************************************/
847 libvlc_time_t libvlc_media_player_get_length(
848 libvlc_media_player_t *p_mi,
849 libvlc_exception_t *p_e )
851 input_thread_t *p_input_thread;
854 p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
855 if( !p_input_thread )
858 var_Get( p_input_thread, "length", &val );
859 vlc_object_release( p_input_thread );
861 return (val.i_time+500LL)/1000LL;
864 libvlc_time_t libvlc_media_player_get_time(
865 libvlc_media_player_t *p_mi,
866 libvlc_exception_t *p_e )
868 input_thread_t *p_input_thread;
871 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
872 if( !p_input_thread )
875 var_Get( p_input_thread , "time", &val );
876 vlc_object_release( p_input_thread );
877 return (val.i_time+500LL)/1000LL;
880 void libvlc_media_player_set_time(
881 libvlc_media_player_t *p_mi,
883 libvlc_exception_t *p_e )
885 input_thread_t *p_input_thread;
887 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
888 if( !p_input_thread )
891 var_SetTime( p_input_thread, "time", time*1000LL );
892 vlc_object_release( p_input_thread );
895 void libvlc_media_player_set_position(
896 libvlc_media_player_t *p_mi,
898 libvlc_exception_t *p_e )
900 input_thread_t *p_input_thread;
902 p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
903 if( !p_input_thread )
906 var_SetFloat( p_input_thread, "position", position );
907 vlc_object_release( p_input_thread );
910 float libvlc_media_player_get_position(
911 libvlc_media_player_t *p_mi,
912 libvlc_exception_t *p_e )
914 input_thread_t *p_input_thread;
917 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
918 if( !p_input_thread )
921 var_Get( p_input_thread, "position", &val );
922 vlc_object_release( p_input_thread );
927 void libvlc_media_player_set_chapter(
928 libvlc_media_player_t *p_mi,
930 libvlc_exception_t *p_e )
932 input_thread_t *p_input_thread;
934 p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
935 if( !p_input_thread )
938 var_SetInteger( p_input_thread, "chapter", chapter );
939 vlc_object_release( p_input_thread );
942 int libvlc_media_player_get_chapter(
943 libvlc_media_player_t *p_mi,
944 libvlc_exception_t *p_e )
946 input_thread_t *p_input_thread;
949 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
950 if( !p_input_thread )
953 var_Get( p_input_thread, "chapter", &val );
954 vlc_object_release( p_input_thread );
959 int libvlc_media_player_get_chapter_count(
960 libvlc_media_player_t *p_mi,
961 libvlc_exception_t *p_e )
963 input_thread_t *p_input_thread;
966 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
967 if( !p_input_thread )
970 var_Change( p_input_thread, "chapter", VLC_VAR_CHOICESCOUNT, &val, NULL );
971 vlc_object_release( p_input_thread );
976 int libvlc_media_player_get_chapter_count_for_title(
977 libvlc_media_player_t *p_mi,
979 libvlc_exception_t *p_e )
981 input_thread_t *p_input_thread;
984 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
985 if( !p_input_thread )
989 if( asprintf( &psz_name, "title %2i", i_title ) == -1 )
991 vlc_object_release( p_input_thread );
994 var_Change( p_input_thread, psz_name, VLC_VAR_CHOICESCOUNT, &val, NULL );
995 vlc_object_release( p_input_thread );
1001 void libvlc_media_player_set_title(
1002 libvlc_media_player_t *p_mi,
1004 libvlc_exception_t *p_e )
1006 input_thread_t *p_input_thread;
1008 p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
1009 if( !p_input_thread )
1012 var_SetInteger( p_input_thread, "title", i_title );
1013 vlc_object_release( p_input_thread );
1016 libvlc_event_t event;
1017 event.type = libvlc_MediaPlayerTitleChanged;
1018 event.u.media_player_title_changed.new_title = i_title;
1019 libvlc_event_send( p_mi->p_event_manager, &event );
1022 int libvlc_media_player_get_title(
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_Get( p_input_thread, "title", &val );
1034 vlc_object_release( p_input_thread );
1039 int libvlc_media_player_get_title_count(
1040 libvlc_media_player_t *p_mi,
1041 libvlc_exception_t *p_e )
1043 input_thread_t *p_input_thread;
1046 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1047 if( !p_input_thread )
1050 var_Change( p_input_thread, "title", VLC_VAR_CHOICESCOUNT, &val, NULL );
1051 vlc_object_release( p_input_thread );
1056 void libvlc_media_player_next_chapter(
1057 libvlc_media_player_t *p_mi,
1058 libvlc_exception_t *p_e )
1060 input_thread_t *p_input_thread;
1062 p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
1063 if( !p_input_thread )
1066 int i_type = var_Type( p_input_thread, "next-chapter" );
1067 var_SetBool( p_input_thread, (i_type & VLC_VAR_TYPE) != 0 ?
1068 "next-chapter":"next-title", true );
1070 vlc_object_release( p_input_thread );
1073 void libvlc_media_player_previous_chapter(
1074 libvlc_media_player_t *p_mi,
1075 libvlc_exception_t *p_e )
1077 input_thread_t *p_input_thread;
1079 p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
1080 if( !p_input_thread )
1083 int i_type = var_Type( p_input_thread, "next-chapter" );
1084 var_SetBool( p_input_thread, (i_type & VLC_VAR_TYPE) != 0 ?
1085 "prev-chapter":"prev-title", true );
1087 vlc_object_release( p_input_thread );
1090 float libvlc_media_player_get_fps(
1091 libvlc_media_player_t *p_mi,
1092 libvlc_exception_t *p_e)
1094 input_thread_t *p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1097 if( p_input_thread )
1099 if( input_Control( p_input_thread, INPUT_GET_VIDEO_FPS, &f_fps ) )
1101 vlc_object_release( p_input_thread );
1106 int libvlc_media_player_will_play( libvlc_media_player_t *p_mi,
1107 libvlc_exception_t *p_e)
1109 input_thread_t *p_input_thread =
1110 libvlc_get_input_thread ( p_mi, p_e);
1111 if ( !p_input_thread )
1114 if ( !p_input_thread->b_die && !p_input_thread->b_dead )
1116 vlc_object_release( p_input_thread );
1119 vlc_object_release( p_input_thread );
1123 void libvlc_media_player_set_rate(
1124 libvlc_media_player_t *p_mi,
1126 libvlc_exception_t *p_e )
1128 input_thread_t *p_input_thread;
1131 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1132 if( !p_input_thread )
1135 b_can_rewind = var_GetBool( p_input_thread, "can-rewind" );
1136 if( (rate < 0.0) && !b_can_rewind )
1138 vlc_object_release( p_input_thread );
1139 libvlc_exception_raise( p_e, "Rate value is invalid" );
1143 var_SetInteger( p_input_thread, "rate", 1000.0f/rate );
1144 vlc_object_release( p_input_thread );
1147 float libvlc_media_player_get_rate(
1148 libvlc_media_player_t *p_mi,
1149 libvlc_exception_t *p_e )
1151 input_thread_t *p_input_thread;
1155 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1156 if( !p_input_thread )
1157 return 0.0; /* rate < 0 indicates rewind */
1159 var_Get( p_input_thread, "rate", &val );
1160 b_can_rewind = var_GetBool( p_input_thread, "can-rewind" );
1161 if( (val.i_int < 0) && !b_can_rewind )
1163 libvlc_exception_raise( p_e, "invalid rate" );
1166 vlc_object_release( p_input_thread );
1168 return (float)1000.0f/val.i_int;
1171 libvlc_state_t libvlc_media_player_get_state(
1172 libvlc_media_player_t *p_mi,
1173 libvlc_exception_t *p_e )
1175 input_thread_t *p_input_thread;
1176 libvlc_state_t state = libvlc_Ended;
1179 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1180 if( !p_input_thread )
1182 /* We do return the right value, no need to throw an exception */
1183 if( libvlc_exception_raised( p_e ) )
1184 libvlc_exception_clear( p_e );
1188 var_Get( p_input_thread, "state", &val );
1189 state = vlc_to_libvlc_state(val.i_int);
1191 if( state == libvlc_Playing )
1194 caching = var_GetFloat( p_input_thread, "cache" );
1195 if( caching > 0.0 && caching < 1.0 )
1196 state = libvlc_Buffering;
1198 vlc_object_release( p_input_thread );
1202 int libvlc_media_player_is_seekable( libvlc_media_player_t *p_mi,
1203 libvlc_exception_t *p_e )
1205 input_thread_t *p_input_thread;
1208 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1209 if ( !p_input_thread )
1211 /* We do return the right value, no need to throw an exception */
1212 if( libvlc_exception_raised( p_e ) )
1213 libvlc_exception_clear( p_e );
1216 var_Get( p_input_thread, "can-seek", &val );
1217 vlc_object_release( p_input_thread );
1222 /* internal function, used by audio, video */
1223 libvlc_track_description_t *
1224 libvlc_get_track_description( libvlc_media_player_t *p_mi,
1225 const char *psz_variable,
1226 libvlc_exception_t *p_e )
1228 input_thread_t *p_input = libvlc_get_input_thread( p_mi, p_e );
1233 vlc_value_t val_list, text_list;
1234 var_Change( p_input, psz_variable, VLC_VAR_GETLIST, &val_list, &text_list);
1236 if( val_list.p_list->i_count <= 0 ) /* no tracks */
1239 libvlc_track_description_t *p_track_description, *p_actual, *p_previous;
1240 p_track_description = ( libvlc_track_description_t * )
1241 malloc( sizeof( libvlc_track_description_t ) );
1242 if ( !p_track_description )
1244 var_Change( p_input, psz_variable, VLC_VAR_FREELIST,
1245 &val_list, &text_list);
1246 vlc_object_release( p_input );
1247 libvlc_exception_raise( p_e, "no enough memory" );
1250 p_actual = p_track_description;
1252 for( int i = 0; i < val_list.p_list->i_count; i++ )
1256 p_actual = ( libvlc_track_description_t * )
1257 malloc( sizeof( libvlc_track_description_t ) );
1260 libvlc_track_description_release( p_track_description );
1261 var_Change( p_input, psz_variable, VLC_VAR_FREELIST,
1262 &val_list, &text_list);
1263 vlc_object_release( p_input );
1264 libvlc_exception_raise( p_e, "no enough memory" );
1268 p_actual->i_id = val_list.p_list->p_values[i].i_int;
1269 p_actual->psz_name = strdup( text_list.p_list->p_values[i].psz_string );
1270 p_actual->p_next = NULL;
1272 p_previous->p_next = p_actual;
1273 p_previous = p_actual;
1276 var_Change( p_input, psz_variable, VLC_VAR_FREELIST, &val_list, &text_list);
1277 vlc_object_release( p_input );
1279 return p_track_description;
1282 void libvlc_track_description_release( libvlc_track_description_t *p_td )
1284 libvlc_track_description_t *p_actual, *p_before;
1289 free( p_actual->psz_name );
1290 p_before = p_actual;
1291 p_actual = p_before->p_next;
1296 int libvlc_media_player_can_pause( libvlc_media_player_t *p_mi,
1297 libvlc_exception_t *p_e )
1299 input_thread_t *p_input_thread;
1302 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1303 if ( !p_input_thread )
1305 /* We do return the right value, no need to throw an exception */
1306 if( libvlc_exception_raised( p_e ) )
1307 libvlc_exception_clear( p_e );
1310 var_Get( p_input_thread, "can-pause", &val );
1311 vlc_object_release( p_input_thread );