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 *****************************************************************************/
30 #include <vlc/libvlc.h>
31 #include <vlc/libvlc_media.h>
32 #include <vlc/libvlc_events.h>
34 #include <vlc_demux.h>
35 #include <vlc_input.h>
40 #include "libvlc_internal.h"
41 #include "media_internal.h" // libvlc_media_set_state()
42 #include "media_player_internal.h"
45 input_seekable_changed( vlc_object_t * p_this, char const * psz_cmd,
46 vlc_value_t oldval, vlc_value_t newval,
49 input_pausable_changed( vlc_object_t * p_this, char const * psz_cmd,
50 vlc_value_t oldval, vlc_value_t newval,
53 input_event_changed( vlc_object_t * p_this, char const * psz_cmd,
54 vlc_value_t oldval, vlc_value_t newval,
58 snapshot_was_taken( vlc_object_t *p_this, char const *psz_cmd,
59 vlc_value_t oldval, vlc_value_t newval, void *p_data );
61 static void libvlc_media_player_destroy( libvlc_media_player_t *p_mi );
67 #define register_event(a, b) __register_event(a, libvlc_MediaPlayer ## b)
68 static inline void __register_event(libvlc_media_player_t *mp, libvlc_event_type_t type)
70 libvlc_event_manager_register_event_type(mp->p_event_manager, type);
73 static inline void lock(libvlc_media_player_t *mp)
75 vlc_mutex_lock(&mp->object_lock);
78 static inline void unlock(libvlc_media_player_t *mp)
80 vlc_mutex_unlock(&mp->object_lock);
84 * Release the associated input thread.
86 * Object lock is NOT held.
88 static void release_input_thread( libvlc_media_player_t *p_mi, bool b_input_abort )
90 input_thread_t * p_input_thread;
92 if( !p_mi || !p_mi->p_input_thread )
95 p_input_thread = p_mi->p_input_thread;
97 var_DelCallback( p_input_thread, "can-seek",
98 input_seekable_changed, p_mi );
99 var_DelCallback( p_input_thread, "can-pause",
100 input_pausable_changed, p_mi );
101 var_DelCallback( p_input_thread, "intf-event",
102 input_event_changed, p_mi );
104 /* We owned this one */
105 input_Stop( p_input_thread, b_input_abort );
107 vlc_thread_join( p_input_thread );
109 assert( p_mi->p_input_resource == NULL );
110 assert( p_input_thread->b_dead );
111 /* Store the input resource for future use. */
112 p_mi->p_input_resource = input_DetachResource( p_input_thread );
114 vlc_object_release( p_input_thread );
116 p_mi->p_input_thread = NULL;
120 * Retrieve the input thread. Be sure to release the object
121 * once you are done with it. (libvlc Internal)
123 * Function will lock the object.
125 input_thread_t *libvlc_get_input_thread( libvlc_media_player_t *p_mi )
127 input_thread_t *p_input_thread;
132 p_input_thread = p_mi->p_input_thread;
134 vlc_object_hold( p_input_thread );
136 libvlc_printerr( "No active input" );
139 return p_input_thread;
143 * Set the internal state of the media_player. (media player Internal)
145 * Function will lock the media_player.
147 static void set_state( libvlc_media_player_t *p_mi, libvlc_state_t state,
153 libvlc_media_t *media = p_mi->p_md;
155 libvlc_media_retain(media);
161 // Also set the state of the corresponding media
162 // This is strictly for convenience.
163 libvlc_media_set_state(media, state);
165 libvlc_media_release(media);
170 input_seekable_changed( vlc_object_t * p_this, char const * psz_cmd,
171 vlc_value_t oldval, vlc_value_t newval,
177 libvlc_media_player_t * p_mi = p_userdata;
178 libvlc_event_t event;
180 event.type = libvlc_MediaPlayerSeekableChanged;
181 event.u.media_player_seekable_changed.new_seekable = newval.b_bool;
183 libvlc_event_send( p_mi->p_event_manager, &event );
188 input_pausable_changed( vlc_object_t * p_this, char const * psz_cmd,
189 vlc_value_t oldval, vlc_value_t newval,
195 libvlc_media_player_t * p_mi = p_userdata;
196 libvlc_event_t event;
198 event.type = libvlc_MediaPlayerPausableChanged;
199 event.u.media_player_pausable_changed.new_pausable = newval.b_bool;
201 libvlc_event_send( p_mi->p_event_manager, &event );
206 input_event_changed( vlc_object_t * p_this, char const * psz_cmd,
207 vlc_value_t oldval, vlc_value_t newval,
211 input_thread_t * p_input = (input_thread_t *)p_this;
212 libvlc_media_player_t * p_mi = p_userdata;
213 libvlc_event_t event;
215 assert( !strcmp( psz_cmd, "intf-event" ) );
217 if( newval.i_int == INPUT_EVENT_STATE )
219 libvlc_state_t libvlc_state;
221 switch ( var_GetInteger( p_input, "state" ) )
224 libvlc_state = libvlc_NothingSpecial;
225 event.type = libvlc_MediaPlayerNothingSpecial;
228 libvlc_state = libvlc_Opening;
229 event.type = libvlc_MediaPlayerOpening;
232 libvlc_state = libvlc_Playing;
233 event.type = libvlc_MediaPlayerPlaying;
236 libvlc_state = libvlc_Paused;
237 event.type = libvlc_MediaPlayerPaused;
240 libvlc_state = libvlc_Ended;
241 event.type = libvlc_MediaPlayerEndReached;
244 libvlc_state = libvlc_Error;
245 event.type = libvlc_MediaPlayerEncounteredError;
252 set_state( p_mi, libvlc_state, false );
253 libvlc_event_send( p_mi->p_event_manager, &event );
255 else if( newval.i_int == INPUT_EVENT_ABORT )
257 libvlc_state_t libvlc_state = libvlc_Stopped;
258 event.type = libvlc_MediaPlayerStopped;
260 set_state( p_mi, libvlc_state, false );
261 libvlc_event_send( p_mi->p_event_manager, &event );
263 else if( newval.i_int == INPUT_EVENT_POSITION )
265 if( var_GetInteger( p_input, "state" ) != PLAYING_S )
266 return VLC_SUCCESS; /* Don't send the position while stopped */
269 event.type = libvlc_MediaPlayerPositionChanged;
270 event.u.media_player_position_changed.new_position =
271 var_GetFloat( p_input, "position" );
272 libvlc_event_send( p_mi->p_event_manager, &event );
275 event.type = libvlc_MediaPlayerTimeChanged;
276 event.u.media_player_time_changed.new_time =
277 from_mtime(var_GetTime( p_input, "time" ));
278 libvlc_event_send( p_mi->p_event_manager, &event );
280 else if( newval.i_int == INPUT_EVENT_LENGTH )
282 event.type = libvlc_MediaPlayerLengthChanged;
283 event.u.media_player_length_changed.new_length =
284 from_mtime(var_GetTime( p_input, "length" ));
285 libvlc_event_send( p_mi->p_event_manager, &event );
292 /**************************************************************************
293 * Snapshot Taken Event.
295 * FIXME: This snapshot API interface makes no sense in media_player.
296 *************************************************************************/
297 static int snapshot_was_taken(vlc_object_t *p_this, char const *psz_cmd,
298 vlc_value_t oldval, vlc_value_t newval, void *p_data )
300 VLC_UNUSED(psz_cmd); VLC_UNUSED(oldval); VLC_UNUSED(p_this);
302 libvlc_media_player_t *mp = p_data;
303 libvlc_event_t event;
304 event.type = libvlc_MediaPlayerSnapshotTaken;
305 event.u.media_player_snapshot_taken.psz_filename = newval.psz_string;
306 libvlc_event_send(mp->p_event_manager, &event);
312 static void libvlc_media_player_destroy( libvlc_media_player_t * );
315 /**************************************************************************
316 * Create a Media Instance object.
319 * - All items created by _new start with a refcount set to 1.
320 * - Accessor _release decrease the refcount by 1, if after that
321 * operation the refcount is 0, the object is destroyed.
322 * - Accessor _retain increase the refcount by 1 (XXX: to implement)
324 * Object locking strategy:
325 * - No lock held while in constructor.
326 * - When accessing any member variable this lock is held. (XXX who locks?)
327 * - When attempting to destroy the object the lock is also held.
328 **************************************************************************/
329 libvlc_media_player_t *
330 libvlc_media_player_new( libvlc_instance_t *instance )
332 libvlc_media_player_t * mp;
336 mp = vlc_object_create (instance->p_libvlc_int, sizeof(*mp));
337 if (unlikely(mp == NULL))
339 libvlc_printerr("Not enough memory");
342 vlc_object_attach (mp, mp->p_libvlc);
345 var_Create (mp, "drawable-xid", VLC_VAR_INTEGER);
347 var_Create (mp, "drawable-hwnd", VLC_VAR_ADDRESS);
350 var_Create (mp, "drawable-agl", VLC_VAR_INTEGER);
351 var_Create (mp, "drawable-nsobject", VLC_VAR_ADDRESS);
354 var_Create (mp, "keyboard-events", VLC_VAR_BOOL);
355 var_SetBool (mp, "keyboard-events", true);
356 var_Create (mp, "mouse-events", VLC_VAR_BOOL);
357 var_SetBool (mp, "mouse-events", true);
359 var_Create (mp, "fullscreen", VLC_VAR_BOOL);
360 var_Create (mp, "autoscale", VLC_VAR_BOOL);
361 var_SetBool (mp, "autoscale", true);
362 var_Create (mp, "scale", VLC_VAR_FLOAT);
363 var_SetFloat (mp, "scale", 1.);
364 var_Create (mp, "aspect-ratio", VLC_VAR_STRING);
365 var_Create (mp, "crop", VLC_VAR_STRING);
366 var_Create (mp, "deinterlace", VLC_VAR_INTEGER);
367 var_Create (mp, "deinterlace-mode", VLC_VAR_STRING);
370 var_Create (mp, "aout", VLC_VAR_STRING | VLC_VAR_DOINHERIT);
373 mp->state = libvlc_NothingSpecial;
374 mp->p_libvlc_instance = instance;
375 mp->p_input_thread = NULL;
376 mp->p_input_resource = NULL;
378 mp->p_event_manager = libvlc_event_manager_new(mp, instance);
379 if (unlikely(mp->p_event_manager == NULL))
381 vlc_object_release(mp);
384 vlc_mutex_init(&mp->object_lock);
386 register_event(mp, NothingSpecial);
387 register_event(mp, Opening);
388 register_event(mp, Buffering);
389 register_event(mp, Playing);
390 register_event(mp, Paused);
391 register_event(mp, Stopped);
392 register_event(mp, Forward);
393 register_event(mp, Backward);
394 register_event(mp, EndReached);
395 register_event(mp, EncounteredError);
396 register_event(mp, SeekableChanged);
398 register_event(mp, PositionChanged);
399 register_event(mp, TimeChanged);
400 register_event(mp, LengthChanged);
401 register_event(mp, TitleChanged);
402 register_event(mp, PausableChanged);
404 /* Snapshot initialization */
405 register_event(mp, SnapshotTaken);
407 register_event(mp, MediaChanged);
409 /* Attach a var callback to the global object to provide the glue between
410 * vout_thread that generates the event and media_player that re-emits it
411 * with its own event manager
413 * FIXME: It's unclear why we want to put this in public API, and why we
414 * want to expose it in such a limiting and ugly way.
416 var_AddCallback(mp->p_libvlc, "snapshot-file", snapshot_was_taken, mp);
418 libvlc_retain(instance);
422 /**************************************************************************
423 * Create a Media Instance object with a media descriptor.
424 **************************************************************************/
425 libvlc_media_player_t *
426 libvlc_media_player_new_from_media( libvlc_media_t * p_md )
428 libvlc_media_player_t * p_mi;
430 p_mi = libvlc_media_player_new( p_md->p_libvlc_instance );
434 libvlc_media_retain( p_md );
440 /**************************************************************************
441 * Destroy a Media Instance object (libvlc internal)
443 * Warning: No lock held here, but hey, this is internal. Caller must lock.
444 **************************************************************************/
445 static void libvlc_media_player_destroy( libvlc_media_player_t *p_mi )
449 /* Detach Callback from the main libvlc object */
450 var_DelCallback( p_mi->p_libvlc,
451 "snapshot-file", snapshot_was_taken, p_mi );
453 /* If the input thread hasn't been already deleted it means
454 * that the owners didn't stop the thread before releasing it. */
455 assert(!p_mi->p_input_thread);
457 /* Fallback for those who don't use NDEBUG */
458 if (p_mi->p_input_thread)
459 release_input_thread(p_mi, true);
461 if( p_mi->p_input_resource )
463 input_resource_Delete( p_mi->p_input_resource );
464 p_mi->p_input_resource = NULL;
467 libvlc_event_manager_release( p_mi->p_event_manager );
468 libvlc_media_release( p_mi->p_md );
469 vlc_mutex_destroy( &p_mi->object_lock );
471 libvlc_instance_t *instance = p_mi->p_libvlc_instance;
472 vlc_object_release( p_mi );
473 libvlc_release(instance);
476 /**************************************************************************
477 * Release a Media Instance object.
479 * Function does the locking.
480 **************************************************************************/
481 void libvlc_media_player_release( libvlc_media_player_t *p_mi )
487 destroy = !--p_mi->i_refcount;
491 libvlc_media_player_destroy( p_mi );
494 /**************************************************************************
495 * Retain a Media Instance object.
497 * Caller must hold the lock.
498 **************************************************************************/
499 void libvlc_media_player_retain( libvlc_media_player_t *p_mi )
508 /**************************************************************************
509 * Set the Media descriptor associated with the instance.
511 * Enter without lock -- function will lock the object.
512 **************************************************************************/
513 void libvlc_media_player_set_media(
514 libvlc_media_player_t *p_mi,
515 libvlc_media_t *p_md )
519 /* FIXME I am not sure if it is a user request or on die(eof/error)
521 release_input_thread( p_mi,
522 p_mi->p_input_thread &&
523 !p_mi->p_input_thread->b_eof &&
524 !p_mi->p_input_thread->b_error );
526 set_state( p_mi, libvlc_NothingSpecial, true );
528 libvlc_media_release( p_mi->p_md );
534 return; /* It is ok to pass a NULL md */
537 libvlc_media_retain( p_md );
540 /* The policy here is to ignore that we were created using a different
541 * libvlc_instance, because we don't really care */
542 p_mi->p_libvlc_instance = p_md->p_libvlc_instance;
546 /* Send an event for the newly available media */
547 libvlc_event_t event;
548 event.type = libvlc_MediaPlayerMediaChanged;
549 event.u.media_player_media_changed.new_media = p_md;
550 libvlc_event_send( p_mi->p_event_manager, &event );
554 /**************************************************************************
555 * Get the Media descriptor associated with the instance.
556 **************************************************************************/
558 libvlc_media_player_get_media( libvlc_media_player_t *p_mi )
565 libvlc_media_retain( p_mi->p_md );
570 /**************************************************************************
571 * Get the event Manager.
572 **************************************************************************/
573 libvlc_event_manager_t *
574 libvlc_media_player_event_manager( libvlc_media_player_t *p_mi )
576 return p_mi->p_event_manager;
579 /**************************************************************************
580 * Tell media player to start playing.
581 **************************************************************************/
582 int libvlc_media_player_play( libvlc_media_player_t *p_mi )
584 input_thread_t * p_input_thread;
586 if( (p_input_thread = libvlc_get_input_thread( p_mi )) )
588 /* A thread already exists, send it a play message */
589 input_Control( p_input_thread, INPUT_SET_STATE, PLAYING_S );
590 vlc_object_release( p_input_thread );
594 /* Ignore previous exception */
600 libvlc_printerr( "No associated media descriptor" );
604 p_mi->p_input_thread = input_Create( p_mi,
605 p_mi->p_md->p_input_item, NULL,
606 p_mi->p_input_resource );
607 if( !p_mi->p_input_thread )
610 libvlc_printerr( "Not enough memory" );
614 p_mi->p_input_resource = NULL;
615 p_input_thread = p_mi->p_input_thread;
617 var_AddCallback( p_input_thread, "can-seek", input_seekable_changed, p_mi );
618 var_AddCallback( p_input_thread, "can-pause", input_pausable_changed, p_mi );
619 var_AddCallback( p_input_thread, "intf-event", input_event_changed, p_mi );
621 if( input_Start( p_input_thread ) )
623 vlc_object_release( p_input_thread );
624 p_mi->p_input_thread = NULL;
631 /**************************************************************************
633 **************************************************************************/
634 void libvlc_media_player_pause( libvlc_media_player_t *p_mi )
636 input_thread_t * p_input_thread = libvlc_get_input_thread( p_mi );
637 if( !p_input_thread )
640 libvlc_state_t state = libvlc_media_player_get_state( p_mi );
641 if( state == libvlc_Playing || state == libvlc_Buffering )
643 if( libvlc_media_player_can_pause( p_mi ) )
644 input_Control( p_input_thread, INPUT_SET_STATE, PAUSE_S );
646 libvlc_media_player_stop( p_mi );
649 input_Control( p_input_thread, INPUT_SET_STATE, PLAYING_S );
651 vlc_object_release( p_input_thread );
654 /**************************************************************************
655 * Tells whether the media player is currently playing.
657 * Enter with lock held.
658 **************************************************************************/
659 int libvlc_media_player_is_playing( libvlc_media_player_t *p_mi )
661 libvlc_state_t state = libvlc_media_player_get_state( p_mi );
662 return (libvlc_Playing == state) || (libvlc_Buffering == state);
665 /**************************************************************************
667 **************************************************************************/
668 void libvlc_media_player_stop( libvlc_media_player_t *p_mi )
670 libvlc_state_t state = libvlc_media_player_get_state( p_mi );
673 release_input_thread( p_mi, true ); /* This will stop the input thread */
676 /* Force to go to stopped state, in case we were in Ended, or Error
678 if( state != libvlc_Stopped )
680 set_state( p_mi, libvlc_Stopped, false );
682 /* Construct and send the event */
683 libvlc_event_t event;
684 event.type = libvlc_MediaPlayerStopped;
685 libvlc_event_send( p_mi->p_event_manager, &event );
689 /**************************************************************************
691 **************************************************************************/
692 void libvlc_media_player_set_nsobject( libvlc_media_player_t *p_mi,
695 assert (p_mi != NULL);
697 var_SetAddress (p_mi, "drawable-nsobject", drawable);
699 (void) p_mi; (void)drawable;
703 /**************************************************************************
705 **************************************************************************/
706 void * libvlc_media_player_get_nsobject( libvlc_media_player_t *p_mi )
708 assert (p_mi != NULL);
710 return var_GetAddress (p_mi, "drawable-nsobject");
716 /**************************************************************************
718 **************************************************************************/
719 void libvlc_media_player_set_agl( libvlc_media_player_t *p_mi,
723 var_SetInteger (p_mi, "drawable-agl", drawable);
725 (void) p_mi; (void)drawable;
729 /**************************************************************************
731 **************************************************************************/
732 uint32_t libvlc_media_player_get_agl( libvlc_media_player_t *p_mi )
734 assert (p_mi != NULL);
736 return var_GetInteger (p_mi, "drawable-agl");
742 /**************************************************************************
744 **************************************************************************/
745 void libvlc_media_player_set_xwindow( libvlc_media_player_t *p_mi,
748 assert (p_mi != NULL);
749 var_SetInteger (p_mi, "drawable-xid", drawable);
752 /**************************************************************************
754 **************************************************************************/
755 uint32_t libvlc_media_player_get_xwindow( libvlc_media_player_t *p_mi )
757 return var_GetInteger (p_mi, "drawable-xid");
760 /**************************************************************************
762 **************************************************************************/
763 void libvlc_media_player_set_hwnd( libvlc_media_player_t *p_mi,
766 assert (p_mi != NULL);
768 var_SetAddress (p_mi, "drawable-hwnd", drawable);
770 (void) p_mi; (void) drawable;
774 /**************************************************************************
776 **************************************************************************/
777 void *libvlc_media_player_get_hwnd( libvlc_media_player_t *p_mi )
779 assert (p_mi != NULL);
781 return var_GetAddress (p_mi, "drawable-hwnd");
787 /**************************************************************************
788 * Getters for stream information
789 **************************************************************************/
790 libvlc_time_t libvlc_media_player_get_length(
791 libvlc_media_player_t *p_mi )
793 input_thread_t *p_input_thread;
794 libvlc_time_t i_time;
796 p_input_thread = libvlc_get_input_thread ( p_mi );
797 if( !p_input_thread )
800 i_time = from_mtime(var_GetTime( p_input_thread, "length" ));
801 vlc_object_release( p_input_thread );
806 libvlc_time_t libvlc_media_player_get_time( libvlc_media_player_t *p_mi )
808 input_thread_t *p_input_thread;
809 libvlc_time_t i_time;
811 p_input_thread = libvlc_get_input_thread ( p_mi );
812 if( !p_input_thread )
815 i_time = from_mtime(var_GetTime( p_input_thread , "time" ));
816 vlc_object_release( p_input_thread );
820 void libvlc_media_player_set_time( libvlc_media_player_t *p_mi,
821 libvlc_time_t i_time )
823 input_thread_t *p_input_thread;
825 p_input_thread = libvlc_get_input_thread ( p_mi );
826 if( !p_input_thread )
829 var_SetTime( p_input_thread, "time", to_mtime(i_time) );
830 vlc_object_release( p_input_thread );
833 void libvlc_media_player_set_position( libvlc_media_player_t *p_mi,
836 input_thread_t *p_input_thread;
838 p_input_thread = libvlc_get_input_thread ( p_mi );
839 if( !p_input_thread )
842 var_SetFloat( p_input_thread, "position", position );
843 vlc_object_release( p_input_thread );
846 float libvlc_media_player_get_position( libvlc_media_player_t *p_mi )
848 input_thread_t *p_input_thread;
851 p_input_thread = libvlc_get_input_thread ( p_mi );
852 if( !p_input_thread )
855 f_position = var_GetFloat( p_input_thread, "position" );
856 vlc_object_release( p_input_thread );
861 void libvlc_media_player_set_chapter( libvlc_media_player_t *p_mi,
864 input_thread_t *p_input_thread;
866 p_input_thread = libvlc_get_input_thread ( p_mi );
867 if( !p_input_thread )
870 var_SetInteger( p_input_thread, "chapter", chapter );
871 vlc_object_release( p_input_thread );
874 int libvlc_media_player_get_chapter( libvlc_media_player_t *p_mi )
876 input_thread_t *p_input_thread;
879 p_input_thread = libvlc_get_input_thread ( p_mi );
880 if( !p_input_thread )
883 i_chapter = var_GetInteger( p_input_thread, "chapter" );
884 vlc_object_release( p_input_thread );
889 int libvlc_media_player_get_chapter_count( libvlc_media_player_t *p_mi )
891 input_thread_t *p_input_thread;
894 p_input_thread = libvlc_get_input_thread ( p_mi );
895 if( !p_input_thread )
898 var_Change( p_input_thread, "chapter", VLC_VAR_CHOICESCOUNT, &val, NULL );
899 vlc_object_release( p_input_thread );
904 int libvlc_media_player_get_chapter_count_for_title(
905 libvlc_media_player_t *p_mi,
908 input_thread_t *p_input_thread;
911 p_input_thread = libvlc_get_input_thread ( p_mi );
912 if( !p_input_thread )
916 if( asprintf( &psz_name, "title %2i", i_title ) == -1 )
918 vlc_object_release( p_input_thread );
921 var_Change( p_input_thread, psz_name, VLC_VAR_CHOICESCOUNT, &val, NULL );
922 vlc_object_release( p_input_thread );
928 void libvlc_media_player_set_title( libvlc_media_player_t *p_mi,
931 input_thread_t *p_input_thread;
933 p_input_thread = libvlc_get_input_thread ( p_mi );
934 if( !p_input_thread )
937 var_SetInteger( p_input_thread, "title", i_title );
938 vlc_object_release( p_input_thread );
941 libvlc_event_t event;
942 event.type = libvlc_MediaPlayerTitleChanged;
943 event.u.media_player_title_changed.new_title = i_title;
944 libvlc_event_send( p_mi->p_event_manager, &event );
947 int libvlc_media_player_get_title( libvlc_media_player_t *p_mi )
949 input_thread_t *p_input_thread;
952 p_input_thread = libvlc_get_input_thread ( p_mi );
953 if( !p_input_thread )
956 i_title = var_GetInteger( p_input_thread, "title" );
957 vlc_object_release( p_input_thread );
962 int libvlc_media_player_get_title_count( libvlc_media_player_t *p_mi )
964 input_thread_t *p_input_thread;
967 p_input_thread = libvlc_get_input_thread ( p_mi );
968 if( !p_input_thread )
971 var_Change( p_input_thread, "title", VLC_VAR_CHOICESCOUNT, &val, NULL );
972 vlc_object_release( p_input_thread );
977 void libvlc_media_player_next_chapter( libvlc_media_player_t *p_mi )
979 input_thread_t *p_input_thread;
981 p_input_thread = libvlc_get_input_thread ( p_mi );
982 if( !p_input_thread )
985 int i_type = var_Type( p_input_thread, "next-chapter" );
986 var_SetBool( p_input_thread, (i_type & VLC_VAR_TYPE) != 0 ?
987 "next-chapter":"next-title", true );
989 vlc_object_release( p_input_thread );
992 void libvlc_media_player_previous_chapter( libvlc_media_player_t *p_mi )
994 input_thread_t *p_input_thread;
996 p_input_thread = libvlc_get_input_thread ( p_mi );
997 if( !p_input_thread )
1000 int i_type = var_Type( p_input_thread, "next-chapter" );
1001 var_SetBool( p_input_thread, (i_type & VLC_VAR_TYPE) != 0 ?
1002 "prev-chapter":"prev-title", true );
1004 vlc_object_release( p_input_thread );
1007 float libvlc_media_player_get_fps( libvlc_media_player_t *p_mi )
1009 input_thread_t *p_input_thread = libvlc_get_input_thread ( p_mi );
1012 if( p_input_thread )
1014 if( input_Control( p_input_thread, INPUT_GET_VIDEO_FPS, &f_fps ) )
1016 vlc_object_release( p_input_thread );
1021 int libvlc_media_player_will_play( libvlc_media_player_t *p_mi )
1024 input_thread_t *p_input_thread =
1025 libvlc_get_input_thread ( p_mi );
1026 if ( !p_input_thread )
1029 b_will_play = !p_input_thread->b_die && !p_input_thread->b_dead;
1030 vlc_object_release( p_input_thread );
1035 int libvlc_media_player_set_rate( libvlc_media_player_t *p_mi, float rate )
1037 input_thread_t *p_input_thread;
1040 p_input_thread = libvlc_get_input_thread ( p_mi );
1041 if( !p_input_thread )
1044 b_can_rewind = var_GetBool( p_input_thread, "can-rewind" );
1045 if( (rate < 0.0) && !b_can_rewind )
1047 vlc_object_release( p_input_thread );
1048 libvlc_printerr( "Invalid playback rate" );
1052 var_SetFloat( p_input_thread, "rate", rate );
1053 vlc_object_release( p_input_thread );
1057 float libvlc_media_player_get_rate( libvlc_media_player_t *p_mi )
1059 input_thread_t *p_input_thread;
1063 p_input_thread = libvlc_get_input_thread ( p_mi );
1064 if( !p_input_thread )
1065 return 0.0; /* rate < 0 indicates rewind */
1067 f_rate = var_GetFloat( p_input_thread, "rate" );
1068 b_can_rewind = var_GetBool( p_input_thread, "can-rewind" );
1069 /* FIXME: why are negative values forbidden ?? (rewinding) */
1070 if( f_rate < 0 && !b_can_rewind )
1072 vlc_object_release( p_input_thread );
1075 vlc_object_release( p_input_thread );
1080 libvlc_state_t libvlc_media_player_get_state( libvlc_media_player_t *p_mi )
1083 libvlc_state_t state = p_mi->state;
1088 int libvlc_media_player_is_seekable( libvlc_media_player_t *p_mi )
1090 input_thread_t *p_input_thread;
1093 p_input_thread = libvlc_get_input_thread ( p_mi );
1094 if ( !p_input_thread )
1096 b_seekable = var_GetBool( p_input_thread, "can-seek" );
1097 vlc_object_release( p_input_thread );
1102 /* internal function, used by audio, video */
1103 libvlc_track_description_t *
1104 libvlc_get_track_description( libvlc_media_player_t *p_mi,
1105 const char *psz_variable )
1107 input_thread_t *p_input = libvlc_get_input_thread( p_mi );
1108 libvlc_track_description_t *p_track_description = NULL,
1109 *p_actual, *p_previous;
1114 vlc_value_t val_list, text_list;
1115 var_Change( p_input, psz_variable, VLC_VAR_GETLIST, &val_list, &text_list);
1118 if( val_list.p_list->i_count <= 0 )
1121 p_track_description = ( libvlc_track_description_t * )
1122 malloc( sizeof( libvlc_track_description_t ) );
1123 if ( !p_track_description )
1125 libvlc_printerr( "Not enough memory" );
1128 p_actual = p_track_description;
1130 for( int i = 0; i < val_list.p_list->i_count; i++ )
1134 p_actual = ( libvlc_track_description_t * )
1135 malloc( sizeof( libvlc_track_description_t ) );
1138 libvlc_track_description_release( p_track_description );
1139 libvlc_printerr( "Not enough memory" );
1143 p_actual->i_id = val_list.p_list->p_values[i].i_int;
1144 p_actual->psz_name = strdup( text_list.p_list->p_values[i].psz_string );
1145 p_actual->p_next = NULL;
1147 p_previous->p_next = p_actual;
1148 p_previous = p_actual;
1153 var_FreeList( &val_list, &text_list );
1154 vlc_object_release( p_input );
1156 return p_track_description;
1159 void libvlc_track_description_release( libvlc_track_description_t *p_td )
1161 libvlc_track_description_t *p_actual, *p_before;
1166 free( p_actual->psz_name );
1167 p_before = p_actual;
1168 p_actual = p_before->p_next;
1173 int libvlc_media_player_can_pause( libvlc_media_player_t *p_mi )
1175 input_thread_t *p_input_thread;
1178 p_input_thread = libvlc_get_input_thread ( p_mi );
1179 if ( !p_input_thread )
1181 b_can_pause = var_GetBool( p_input_thread, "can-pause" );
1182 vlc_object_release( p_input_thread );
1187 void libvlc_media_player_next_frame( libvlc_media_player_t *p_mi )
1189 input_thread_t *p_input_thread = libvlc_get_input_thread ( p_mi );
1190 if( p_input_thread != NULL )
1192 var_TriggerCallback( p_input_thread, "frame-next" );
1193 vlc_object_release( p_input_thread );