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_Stop( 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_POSITION )
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 );
330 /* Attach a var callback to the global object to provide the glue between
331 vout_thread that generates the event and media_player that re-emits it
332 with its own event manager
334 var_Create( p_libvlc_instance->p_libvlc_int, "vout-snapshottaken",
335 VLC_VAR_STRING | VLC_VAR_ISCOMMAND );
336 var_AddCallback( p_libvlc_instance->p_libvlc_int, "vout-snapshottaken",
337 SnapshotTakenCallback, p_mi );
342 /**************************************************************************
343 * Create a Media Instance object with a media descriptor.
344 **************************************************************************/
345 libvlc_media_player_t *
346 libvlc_media_player_new_from_media(
347 libvlc_media_t * p_md,
348 libvlc_exception_t *p_e )
350 libvlc_media_player_t * p_mi;
352 p_mi = libvlc_media_player_new( p_md->p_libvlc_instance, p_e );
356 libvlc_media_retain( p_md );
362 /**************************************************************************
363 * Create a new media instance object from an input_thread (Libvlc Internal).
364 **************************************************************************/
365 libvlc_media_player_t * libvlc_media_player_new_from_input_thread(
366 struct libvlc_instance_t *p_libvlc_instance,
367 input_thread_t *p_input,
368 libvlc_exception_t *p_e )
370 libvlc_media_player_t * p_mi;
374 libvlc_exception_raise( p_e, "invalid input thread" );
378 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 );
387 libvlc_media_player_destroy( p_mi );
391 /* will be released in media_player_release() */
392 vlc_object_hold( p_input );
394 p_mi->p_input_thread = p_input;
395 p_mi->b_own_its_input_thread = false;
400 /**************************************************************************
401 * Destroy a Media Instance object (libvlc internal)
403 * Warning: No lock held here, but hey, this is internal. Caller must lock.
404 **************************************************************************/
405 void libvlc_media_player_destroy( libvlc_media_player_t *p_mi )
407 input_thread_t *p_input_thread;
408 libvlc_exception_t p_e;
413 libvlc_exception_init( &p_e );
415 /* Detach Callback from the main libvlc object */
416 var_DelCallback( p_mi->p_libvlc_instance->p_libvlc_int,
417 "vout-snapshottaken", SnapshotTakenCallback, p_mi );
419 p_input_thread = libvlc_get_input_thread( p_mi, &p_e );
421 if( libvlc_exception_raised( &p_e ) )
423 libvlc_event_manager_release( p_mi->p_event_manager );
424 libvlc_exception_clear( &p_e );
426 return; /* no need to worry about no input thread */
428 vlc_mutex_destroy( &p_mi->object_lock );
430 vlc_object_release( p_input_thread );
432 libvlc_media_release( p_mi->p_md );
437 /**************************************************************************
438 * Release a Media Instance object.
440 * Function does the locking.
441 **************************************************************************/
442 void libvlc_media_player_release( libvlc_media_player_t *p_mi )
447 vlc_mutex_lock( &p_mi->object_lock );
451 if( p_mi->i_refcount > 0 )
453 vlc_mutex_unlock( &p_mi->object_lock );
456 vlc_mutex_unlock( &p_mi->object_lock );
457 vlc_mutex_destroy( &p_mi->object_lock );
459 release_input_thread( p_mi, true );
461 libvlc_event_manager_release( p_mi->p_event_manager );
463 libvlc_media_release( p_mi->p_md );
468 /**************************************************************************
469 * Retain a Media Instance object.
471 * Caller must hold the lock.
472 **************************************************************************/
473 void libvlc_media_player_retain( libvlc_media_player_t *p_mi )
481 /**************************************************************************
482 * Set the Media descriptor associated with the instance.
484 * Enter without lock -- function will lock the object.
485 **************************************************************************/
486 void libvlc_media_player_set_media(
487 libvlc_media_player_t *p_mi,
488 libvlc_media_t *p_md,
489 libvlc_exception_t *p_e )
496 vlc_mutex_lock( &p_mi->object_lock );
498 /* FIXME I am not sure if it is a user request or on die(eof/error)
500 release_input_thread( p_mi,
501 p_mi->p_input_thread &&
502 !p_mi->p_input_thread->b_eof &&
503 !p_mi->p_input_thread->b_error );
506 libvlc_media_set_state( p_mi->p_md, libvlc_NothingSpecial, p_e );
508 libvlc_media_release( p_mi->p_md );
513 vlc_mutex_unlock( &p_mi->object_lock );
514 return; /* It is ok to pass a NULL md */
517 libvlc_media_retain( p_md );
520 /* The policy here is to ignore that we were created using a different
521 * libvlc_instance, because we don't really care */
522 p_mi->p_libvlc_instance = p_md->p_libvlc_instance;
524 vlc_mutex_unlock( &p_mi->object_lock );
527 /**************************************************************************
528 * Get the Media descriptor associated with the instance.
529 **************************************************************************/
531 libvlc_media_player_get_media(
532 libvlc_media_player_t *p_mi,
533 libvlc_exception_t *p_e )
540 libvlc_media_retain( p_mi->p_md );
544 /**************************************************************************
545 * Get the event Manager.
546 **************************************************************************/
547 libvlc_event_manager_t *
548 libvlc_media_player_event_manager(
549 libvlc_media_player_t *p_mi,
550 libvlc_exception_t *p_e )
554 return p_mi->p_event_manager;
557 /**************************************************************************
558 * Trigger a snapshot Taken Event.
559 *************************************************************************/
560 static int SnapshotTakenCallback( vlc_object_t *p_this, char const *psz_cmd,
561 vlc_value_t oldval, vlc_value_t newval, void *p_data )
563 VLC_UNUSED(psz_cmd); VLC_UNUSED(oldval);
566 libvlc_media_player_t* p_mi = (libvlc_media_player_t*) p_data ;
567 libvlc_event_t event ;
568 event.type = libvlc_MediaPlayerSnapshotTaken ;
569 event.u.media_player_snapshot_taken.psz_filename = newval.psz_string ;
570 /* Snapshot psz data is a vlc_variable owned by libvlc object .
571 Its memmory management is taken care by the obj*/
572 msg_Dbg( p_this, "about to emit libvlc_snapshot_taken.make psz_str=0x%p"
573 " (%s)", event.u.media_player_snapshot_taken.psz_filename,
574 event.u.media_player_snapshot_taken.psz_filename );
575 libvlc_event_send( p_mi->p_event_manager, &event );
580 /**************************************************************************
581 * Tell media player to start playing.
582 **************************************************************************/
583 void libvlc_media_player_play( libvlc_media_player_t *p_mi,
584 libvlc_exception_t *p_e )
586 input_thread_t * p_input_thread;
588 if( (p_input_thread = libvlc_get_input_thread( p_mi, p_e )) )
590 /* A thread already exists, send it a play message */
591 input_Control( p_input_thread, INPUT_SET_STATE, PLAYING_S );
592 vlc_object_release( p_input_thread );
596 /* Ignore previous exception */
597 libvlc_exception_clear( p_e );
599 vlc_mutex_lock( &p_mi->object_lock );
603 libvlc_exception_raise( p_e, "no associated media descriptor" );
604 vlc_mutex_unlock( &p_mi->object_lock );
608 p_mi->p_input_thread = input_Create( p_mi->p_libvlc_instance->p_libvlc_int,
609 p_mi->p_md->p_input_item, NULL, NULL );
611 if( !p_mi->p_input_thread )
613 vlc_mutex_unlock( &p_mi->object_lock );
617 p_input_thread = p_mi->p_input_thread;
619 var_Create( p_input_thread, "drawable-agl", VLC_VAR_INTEGER );
620 if( p_mi->drawable.agl )
621 var_SetInteger( p_input_thread, "drawable-agl", p_mi->drawable.agl );
623 var_Create( p_input_thread, "drawable-xid", VLC_VAR_INTEGER );
624 if( p_mi->drawable.xid )
625 var_SetInteger( p_input_thread, "drawable-xid", p_mi->drawable.xid );
627 var_Create( p_input_thread, "drawable-hwnd", VLC_VAR_ADDRESS );
628 if( p_mi->drawable.hwnd != NULL )
630 vlc_value_t val = { .p_address = p_mi->drawable.hwnd };
631 var_Set( p_input_thread, "drawable-hwnd", val );
634 var_Create( p_input_thread, "drawable-nsobject", VLC_VAR_ADDRESS );
635 if( p_mi->drawable.nsobject != NULL )
637 vlc_value_t val = { .p_address = p_mi->drawable.nsobject };
638 var_Set( p_input_thread, "drawable-nsobject", val );
641 var_AddCallback( p_input_thread, "can-seek", input_seekable_changed, p_mi );
642 var_AddCallback( p_input_thread, "can-pause", input_pausable_changed, p_mi );
643 var_AddCallback( p_input_thread, "intf-event", input_event_changed, p_mi );
645 if( input_Start( p_input_thread ) )
647 vlc_object_release( p_input_thread );
648 p_mi->p_input_thread = NULL;
651 vlc_mutex_unlock( &p_mi->object_lock );
654 /**************************************************************************
656 **************************************************************************/
657 void libvlc_media_player_pause( libvlc_media_player_t *p_mi,
658 libvlc_exception_t *p_e )
660 input_thread_t * p_input_thread = libvlc_get_input_thread( p_mi, p_e );
661 if( !p_input_thread )
664 libvlc_state_t state = libvlc_media_player_get_state( p_mi, p_e );
665 if( state == libvlc_Playing || state == libvlc_Buffering )
667 if( libvlc_media_player_can_pause( p_mi, p_e ) )
668 input_Control( p_input_thread, INPUT_SET_STATE, PAUSE_S );
670 libvlc_media_player_stop( p_mi, p_e );
673 input_Control( p_input_thread, INPUT_SET_STATE, PLAYING_S );
675 vlc_object_release( p_input_thread );
678 /**************************************************************************
679 * Tells whether the media player is currently playing.
681 * Enter with lock held.
682 **************************************************************************/
683 int libvlc_media_player_is_playing( libvlc_media_player_t *p_mi,
684 libvlc_exception_t *p_e )
686 libvlc_state_t state = libvlc_media_player_get_state( p_mi, p_e );
687 return (libvlc_Playing == state) || (libvlc_Buffering == state);
690 /**************************************************************************
692 **************************************************************************/
693 void libvlc_media_player_stop( libvlc_media_player_t *p_mi,
694 libvlc_exception_t *p_e )
696 libvlc_state_t state = libvlc_media_player_get_state( p_mi, p_e );
698 if( state == libvlc_Playing ||
699 state == libvlc_Paused ||
700 state == libvlc_Buffering )
702 /* Send a stop notification event only if we are in playing,
703 * buffering or paused states */
704 libvlc_media_set_state( p_mi->p_md, libvlc_Ended, p_e );
706 /* Construct and send the event */
707 libvlc_event_t event;
708 event.type = libvlc_MediaPlayerStopped;
709 libvlc_event_send( p_mi->p_event_manager, &event );
712 if( p_mi->b_own_its_input_thread )
714 vlc_mutex_lock( &p_mi->object_lock );
715 release_input_thread( p_mi, true ); /* This will stop the input thread */
716 vlc_mutex_unlock( &p_mi->object_lock );
720 input_thread_t * p_input_thread = libvlc_get_input_thread( p_mi, p_e );
721 if( !p_input_thread )
724 input_Stop( p_input_thread, true );
725 vlc_object_release( p_input_thread );
726 p_mi->p_input_thread = NULL;
730 /**************************************************************************
732 **************************************************************************/
733 void libvlc_media_player_set_nsobject( libvlc_media_player_t *p_mi,
735 libvlc_exception_t *p_e )
738 p_mi->drawable.nsobject = drawable;
741 /**************************************************************************
743 **************************************************************************/
744 uint32_t libvlc_media_player_get_nsobject( libvlc_media_player_t *p_mi )
746 return p_mi->drawable.nsobject;
749 /**************************************************************************
751 **************************************************************************/
752 void libvlc_media_player_set_agl( libvlc_media_player_t *p_mi,
754 libvlc_exception_t *p_e )
757 p_mi->drawable.agl = drawable;
760 /**************************************************************************
762 **************************************************************************/
763 uint32_t libvlc_media_player_get_agl( libvlc_media_player_t *p_mi )
765 return p_mi->drawable.agl;
768 /**************************************************************************
770 **************************************************************************/
771 void libvlc_media_player_set_xwindow( libvlc_media_player_t *p_mi,
773 libvlc_exception_t *p_e )
776 p_mi->drawable.xid = drawable;
779 /**************************************************************************
781 **************************************************************************/
782 uint32_t libvlc_media_player_get_xwindow( libvlc_media_player_t *p_mi )
784 return p_mi->drawable.xid;
787 /**************************************************************************
789 **************************************************************************/
790 void libvlc_media_player_set_hwnd( libvlc_media_player_t *p_mi,
792 libvlc_exception_t *p_e )
795 p_mi->drawable.hwnd = drawable;
798 /**************************************************************************
800 **************************************************************************/
801 void *libvlc_media_player_get_hwnd( libvlc_media_player_t *p_mi )
803 return p_mi->drawable.hwnd;
806 /**************************************************************************
808 **************************************************************************/
809 void libvlc_media_player_set_drawable( libvlc_media_player_t *p_mi,
810 libvlc_drawable_t drawable,
811 libvlc_exception_t *p_e )
814 if (sizeof (HWND) <= sizeof (libvlc_drawable_t))
815 p_mi->drawable.hwnd = (HWND)drawable;
817 libvlc_exception_raise(p_e, "Operation not supported");
818 #elif defined(__APPLE__)
819 p_mi->drawable.agl = drawable;
822 p_mi->drawable.xid = drawable;
827 /**************************************************************************
829 **************************************************************************/
831 libvlc_media_player_get_drawable ( libvlc_media_player_t *p_mi,
832 libvlc_exception_t *p_e )
837 if (sizeof (HWND) <= sizeof (libvlc_drawable_t))
838 return (libvlc_drawable_t)p_mi->drawable.hwnd;
841 #elif defined(__APPLE__)
842 return p_mi->drawable.agl;
844 return p_mi->drawable.xid;
848 /**************************************************************************
849 * Getters for stream information
850 **************************************************************************/
851 libvlc_time_t libvlc_media_player_get_length(
852 libvlc_media_player_t *p_mi,
853 libvlc_exception_t *p_e )
855 input_thread_t *p_input_thread;
858 p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
859 if( !p_input_thread )
862 var_Get( p_input_thread, "length", &val );
863 vlc_object_release( p_input_thread );
865 return (val.i_time+500LL)/1000LL;
868 libvlc_time_t libvlc_media_player_get_time(
869 libvlc_media_player_t *p_mi,
870 libvlc_exception_t *p_e )
872 input_thread_t *p_input_thread;
875 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
876 if( !p_input_thread )
879 var_Get( p_input_thread , "time", &val );
880 vlc_object_release( p_input_thread );
881 return (val.i_time+500LL)/1000LL;
884 void libvlc_media_player_set_time(
885 libvlc_media_player_t *p_mi,
887 libvlc_exception_t *p_e )
889 input_thread_t *p_input_thread;
891 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
892 if( !p_input_thread )
895 var_SetTime( p_input_thread, "time", time*1000LL );
896 vlc_object_release( p_input_thread );
899 void libvlc_media_player_set_position(
900 libvlc_media_player_t *p_mi,
902 libvlc_exception_t *p_e )
904 input_thread_t *p_input_thread;
906 p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
907 if( !p_input_thread )
910 var_SetFloat( p_input_thread, "position", position );
911 vlc_object_release( p_input_thread );
914 float libvlc_media_player_get_position(
915 libvlc_media_player_t *p_mi,
916 libvlc_exception_t *p_e )
918 input_thread_t *p_input_thread;
921 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
922 if( !p_input_thread )
925 var_Get( p_input_thread, "position", &val );
926 vlc_object_release( p_input_thread );
931 void libvlc_media_player_set_chapter(
932 libvlc_media_player_t *p_mi,
934 libvlc_exception_t *p_e )
936 input_thread_t *p_input_thread;
938 p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
939 if( !p_input_thread )
942 var_SetInteger( p_input_thread, "chapter", chapter );
943 vlc_object_release( p_input_thread );
946 int libvlc_media_player_get_chapter(
947 libvlc_media_player_t *p_mi,
948 libvlc_exception_t *p_e )
950 input_thread_t *p_input_thread;
953 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
954 if( !p_input_thread )
957 var_Get( p_input_thread, "chapter", &val );
958 vlc_object_release( p_input_thread );
963 int libvlc_media_player_get_chapter_count(
964 libvlc_media_player_t *p_mi,
965 libvlc_exception_t *p_e )
967 input_thread_t *p_input_thread;
970 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
971 if( !p_input_thread )
974 var_Change( p_input_thread, "chapter", VLC_VAR_CHOICESCOUNT, &val, NULL );
975 vlc_object_release( p_input_thread );
980 int libvlc_media_player_get_chapter_count_for_title(
981 libvlc_media_player_t *p_mi,
983 libvlc_exception_t *p_e )
985 input_thread_t *p_input_thread;
988 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
989 if( !p_input_thread )
993 if( asprintf( &psz_name, "title %2i", i_title ) == -1 )
995 vlc_object_release( p_input_thread );
998 var_Change( p_input_thread, psz_name, VLC_VAR_CHOICESCOUNT, &val, NULL );
999 vlc_object_release( p_input_thread );
1005 void libvlc_media_player_set_title(
1006 libvlc_media_player_t *p_mi,
1008 libvlc_exception_t *p_e )
1010 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_SetInteger( p_input_thread, "title", i_title );
1017 vlc_object_release( p_input_thread );
1020 libvlc_event_t event;
1021 event.type = libvlc_MediaPlayerTitleChanged;
1022 event.u.media_player_title_changed.new_title = i_title;
1023 libvlc_event_send( p_mi->p_event_manager, &event );
1026 int libvlc_media_player_get_title(
1027 libvlc_media_player_t *p_mi,
1028 libvlc_exception_t *p_e )
1030 input_thread_t *p_input_thread;
1033 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1034 if( !p_input_thread )
1037 var_Get( p_input_thread, "title", &val );
1038 vlc_object_release( p_input_thread );
1043 int libvlc_media_player_get_title_count(
1044 libvlc_media_player_t *p_mi,
1045 libvlc_exception_t *p_e )
1047 input_thread_t *p_input_thread;
1050 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1051 if( !p_input_thread )
1054 var_Change( p_input_thread, "title", VLC_VAR_CHOICESCOUNT, &val, NULL );
1055 vlc_object_release( p_input_thread );
1060 void libvlc_media_player_next_chapter(
1061 libvlc_media_player_t *p_mi,
1062 libvlc_exception_t *p_e )
1064 input_thread_t *p_input_thread;
1066 p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
1067 if( !p_input_thread )
1070 int i_type = var_Type( p_input_thread, "next-chapter" );
1071 var_SetBool( p_input_thread, (i_type & VLC_VAR_TYPE) != 0 ?
1072 "next-chapter":"next-title", true );
1074 vlc_object_release( p_input_thread );
1077 void libvlc_media_player_previous_chapter(
1078 libvlc_media_player_t *p_mi,
1079 libvlc_exception_t *p_e )
1081 input_thread_t *p_input_thread;
1083 p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
1084 if( !p_input_thread )
1087 int i_type = var_Type( p_input_thread, "next-chapter" );
1088 var_SetBool( p_input_thread, (i_type & VLC_VAR_TYPE) != 0 ?
1089 "prev-chapter":"prev-title", true );
1091 vlc_object_release( p_input_thread );
1094 float libvlc_media_player_get_fps(
1095 libvlc_media_player_t *p_mi,
1096 libvlc_exception_t *p_e)
1098 input_thread_t *p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1101 if( p_input_thread )
1103 if( input_Control( p_input_thread, INPUT_GET_VIDEO_FPS, &f_fps ) )
1105 vlc_object_release( p_input_thread );
1110 int libvlc_media_player_will_play( libvlc_media_player_t *p_mi,
1111 libvlc_exception_t *p_e)
1113 input_thread_t *p_input_thread =
1114 libvlc_get_input_thread ( p_mi, p_e);
1115 if ( !p_input_thread )
1118 if ( !p_input_thread->b_die && !p_input_thread->b_dead )
1120 vlc_object_release( p_input_thread );
1123 vlc_object_release( p_input_thread );
1127 void libvlc_media_player_set_rate(
1128 libvlc_media_player_t *p_mi,
1130 libvlc_exception_t *p_e )
1132 input_thread_t *p_input_thread;
1135 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1136 if( !p_input_thread )
1139 b_can_rewind = var_GetBool( p_input_thread, "can-rewind" );
1140 if( (rate < 0.0) && !b_can_rewind )
1142 vlc_object_release( p_input_thread );
1143 libvlc_exception_raise( p_e, "Rate value is invalid" );
1147 var_SetInteger( p_input_thread, "rate", 1000.0f/rate );
1148 vlc_object_release( p_input_thread );
1151 float libvlc_media_player_get_rate(
1152 libvlc_media_player_t *p_mi,
1153 libvlc_exception_t *p_e )
1155 input_thread_t *p_input_thread;
1159 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1160 if( !p_input_thread )
1161 return 0.0; /* rate < 0 indicates rewind */
1163 var_Get( p_input_thread, "rate", &val );
1164 b_can_rewind = var_GetBool( p_input_thread, "can-rewind" );
1165 if( (val.i_int < 0) && !b_can_rewind )
1167 libvlc_exception_raise( p_e, "invalid rate" );
1170 vlc_object_release( p_input_thread );
1172 return (float)1000.0f/val.i_int;
1175 libvlc_state_t libvlc_media_player_get_state(
1176 libvlc_media_player_t *p_mi,
1177 libvlc_exception_t *p_e )
1179 input_thread_t *p_input_thread;
1180 libvlc_state_t state = libvlc_Ended;
1183 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1184 if( !p_input_thread )
1186 /* We do return the right value, no need to throw an exception */
1187 if( libvlc_exception_raised( p_e ) )
1188 libvlc_exception_clear( p_e );
1192 var_Get( p_input_thread, "state", &val );
1193 state = vlc_to_libvlc_state(val.i_int);
1195 if( state == libvlc_Playing )
1198 caching = var_GetFloat( p_input_thread, "cache" );
1199 if( caching > 0.0 && caching < 1.0 )
1200 state = libvlc_Buffering;
1202 vlc_object_release( p_input_thread );
1206 int libvlc_media_player_is_seekable( libvlc_media_player_t *p_mi,
1207 libvlc_exception_t *p_e )
1209 input_thread_t *p_input_thread;
1212 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1213 if ( !p_input_thread )
1215 /* We do return the right value, no need to throw an exception */
1216 if( libvlc_exception_raised( p_e ) )
1217 libvlc_exception_clear( p_e );
1220 var_Get( p_input_thread, "can-seek", &val );
1221 vlc_object_release( p_input_thread );
1226 /* internal function, used by audio, video */
1227 libvlc_track_description_t *
1228 libvlc_get_track_description( libvlc_media_player_t *p_mi,
1229 const char *psz_variable,
1230 libvlc_exception_t *p_e )
1232 input_thread_t *p_input = libvlc_get_input_thread( p_mi, p_e );
1237 vlc_value_t val_list, text_list;
1238 var_Change( p_input, psz_variable, VLC_VAR_GETLIST, &val_list, &text_list);
1240 if( val_list.p_list->i_count <= 0 ) /* no tracks */
1243 libvlc_track_description_t *p_track_description, *p_actual, *p_previous;
1244 p_track_description = ( libvlc_track_description_t * )
1245 malloc( sizeof( libvlc_track_description_t ) );
1246 if ( !p_track_description )
1248 var_Change( p_input, psz_variable, VLC_VAR_FREELIST,
1249 &val_list, &text_list);
1250 vlc_object_release( p_input );
1251 libvlc_exception_raise( p_e, "no enough memory" );
1254 p_actual = p_track_description;
1256 for( int i = 0; i < val_list.p_list->i_count; i++ )
1260 p_actual = ( libvlc_track_description_t * )
1261 malloc( sizeof( libvlc_track_description_t ) );
1264 libvlc_track_description_release( p_track_description );
1265 var_Change( p_input, psz_variable, VLC_VAR_FREELIST,
1266 &val_list, &text_list);
1267 vlc_object_release( p_input );
1268 libvlc_exception_raise( p_e, "no enough memory" );
1272 p_actual->i_id = val_list.p_list->p_values[i].i_int;
1273 p_actual->psz_name = strdup( text_list.p_list->p_values[i].psz_string );
1274 p_actual->p_next = NULL;
1276 p_previous->p_next = p_actual;
1277 p_previous = p_actual;
1280 var_Change( p_input, psz_variable, VLC_VAR_FREELIST, &val_list, &text_list);
1281 vlc_object_release( p_input );
1283 return p_track_description;
1286 void libvlc_track_description_release( libvlc_track_description_t *p_td )
1288 libvlc_track_description_t *p_actual, *p_before;
1293 free( p_actual->psz_name );
1294 p_before = p_actual;
1295 p_actual = p_before->p_next;
1300 int libvlc_media_player_can_pause( libvlc_media_player_t *p_mi,
1301 libvlc_exception_t *p_e )
1303 input_thread_t *p_input_thread;
1306 p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
1307 if ( !p_input_thread )
1309 /* We do return the right value, no need to throw an exception */
1310 if( libvlc_exception_raised( p_e ) )
1311 libvlc_exception_clear( p_e );
1314 var_Get( p_input_thread, "can-pause", &val );
1315 vlc_object_release( p_input_thread );