1 /*****************************************************************************
2 * media_player.c: Libvlc API Media Instance management functions
3 *****************************************************************************
4 * Copyright (C) 2005-2011 VLC authors and VideoLAN
6 * Authors: Clément Stenac <zorglub@videolan.org>
8 * This program is free software; you can redistribute it and/or modify it
9 * under the terms of the GNU Lesser General Public License as published by
10 * the Free Software Foundation; either version 2.1 of the License, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public License
19 * along with this program; if not, write to the Free Software Foundation,
20 * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
21 *****************************************************************************/
29 #include <vlc/libvlc.h>
30 #include <vlc/libvlc_media.h>
31 #include <vlc/libvlc_events.h>
33 #include <vlc_demux.h>
34 #include <vlc_input.h>
39 #include "libvlc_internal.h"
40 #include "media_internal.h" // libvlc_media_set_state()
41 #include "media_player_internal.h"
44 input_seekable_changed( vlc_object_t * p_this, char const * psz_cmd,
45 vlc_value_t oldval, vlc_value_t newval,
48 input_pausable_changed( vlc_object_t * p_this, char const * psz_cmd,
49 vlc_value_t oldval, vlc_value_t newval,
52 input_scrambled_changed( vlc_object_t * p_this, char const * psz_cmd,
53 vlc_value_t oldval, vlc_value_t newval,
56 input_event_changed( vlc_object_t * p_this, char const * psz_cmd,
57 vlc_value_t oldval, vlc_value_t newval,
61 input_es_changed( vlc_object_t * p_this, char const * psz_cmd,
62 int action, vlc_value_t *p_val,
66 input_es_selected( vlc_object_t * p_this, char const * psz_cmd,
67 vlc_value_t oldval, vlc_value_t newval,
71 add_es_callbacks( input_thread_t *p_input_thread, libvlc_media_player_t *p_mi );
74 del_es_callbacks( input_thread_t *p_input_thread, libvlc_media_player_t *p_mi );
77 snapshot_was_taken( vlc_object_t *p_this, char const *psz_cmd,
78 vlc_value_t oldval, vlc_value_t newval, void *p_data );
80 static void libvlc_media_player_destroy( libvlc_media_player_t *p_mi );
86 #define register_event(a, b) __register_event(a, libvlc_MediaPlayer ## b)
87 static inline void __register_event(libvlc_media_player_t *mp, libvlc_event_type_t type)
89 libvlc_event_manager_register_event_type(mp->p_event_manager, type);
93 * The input lock protects the input and input resource pointer.
94 * It MUST NOT be used from callbacks.
96 * The object lock protects the reset, namely the media and the player state.
97 * It can, and usually needs to be taken from callbacks.
98 * The object lock can be acquired under the input lock... and consequently
99 * the opposite order is STRICTLY PROHIBITED.
101 static inline void lock(libvlc_media_player_t *mp)
103 vlc_mutex_lock(&mp->object_lock);
106 static inline void unlock(libvlc_media_player_t *mp)
108 vlc_mutex_unlock(&mp->object_lock);
111 static inline void lock_input(libvlc_media_player_t *mp)
113 vlc_mutex_lock(&mp->input.lock);
116 static inline void unlock_input(libvlc_media_player_t *mp)
118 vlc_mutex_unlock(&mp->input.lock);
122 * Release the associated input thread.
124 * Object lock is NOT held.
125 * Input lock is held or instance is being destroyed.
127 static void release_input_thread( libvlc_media_player_t *p_mi, bool b_input_abort )
131 input_thread_t *p_input_thread = p_mi->input.p_thread;
132 if( !p_input_thread )
134 p_mi->input.p_thread = NULL;
136 var_DelCallback( p_input_thread, "can-seek",
137 input_seekable_changed, p_mi );
138 var_DelCallback( p_input_thread, "can-pause",
139 input_pausable_changed, p_mi );
140 var_DelCallback( p_input_thread, "program-scrambled",
141 input_scrambled_changed, p_mi );
142 var_DelCallback( p_input_thread, "intf-event",
143 input_event_changed, p_mi );
144 del_es_callbacks( p_input_thread, p_mi );
146 /* We owned this one */
147 input_Stop( p_input_thread, b_input_abort );
148 input_Close( p_input_thread );
152 * Retrieve the input thread. Be sure to release the object
153 * once you are done with it. (libvlc Internal)
155 input_thread_t *libvlc_get_input_thread( libvlc_media_player_t *p_mi )
157 input_thread_t *p_input_thread;
162 p_input_thread = p_mi->input.p_thread;
164 vlc_object_hold( p_input_thread );
166 libvlc_printerr( "No active input" );
169 return p_input_thread;
173 * Set the internal state of the media_player. (media player Internal)
175 * Function will lock the media_player.
177 static void set_state( libvlc_media_player_t *p_mi, libvlc_state_t state,
184 libvlc_media_t *media = p_mi->p_md;
186 libvlc_media_retain(media);
193 // Also set the state of the corresponding media
194 // This is strictly for convenience.
195 libvlc_media_set_state(media, state);
197 libvlc_media_release(media);
202 input_seekable_changed( vlc_object_t * p_this, char const * psz_cmd,
203 vlc_value_t oldval, vlc_value_t newval,
209 libvlc_media_player_t * p_mi = p_userdata;
210 libvlc_event_t event;
212 event.type = libvlc_MediaPlayerSeekableChanged;
213 event.u.media_player_seekable_changed.new_seekable = newval.b_bool;
215 libvlc_event_send( p_mi->p_event_manager, &event );
220 input_pausable_changed( vlc_object_t * p_this, char const * psz_cmd,
221 vlc_value_t oldval, vlc_value_t newval,
227 libvlc_media_player_t * p_mi = p_userdata;
228 libvlc_event_t event;
230 event.type = libvlc_MediaPlayerPausableChanged;
231 event.u.media_player_pausable_changed.new_pausable = newval.b_bool;
233 libvlc_event_send( p_mi->p_event_manager, &event );
238 input_scrambled_changed( vlc_object_t * p_this, char const * psz_cmd,
239 vlc_value_t oldval, vlc_value_t newval,
245 libvlc_media_player_t * p_mi = p_userdata;
246 libvlc_event_t event;
248 event.type = libvlc_MediaPlayerScrambledChanged;
249 event.u.media_player_scrambled_changed.new_scrambled = newval.b_bool;
251 libvlc_event_send( p_mi->p_event_manager, &event );
256 input_event_changed( vlc_object_t * p_this, char const * psz_cmd,
257 vlc_value_t oldval, vlc_value_t newval,
261 input_thread_t * p_input = (input_thread_t *)p_this;
262 libvlc_media_player_t * p_mi = p_userdata;
263 libvlc_event_t event;
265 assert( !strcmp( psz_cmd, "intf-event" ) );
267 if( newval.i_int == INPUT_EVENT_STATE )
269 libvlc_state_t libvlc_state;
271 switch ( var_GetInteger( p_input, "state" ) )
274 libvlc_state = libvlc_NothingSpecial;
275 event.type = libvlc_MediaPlayerNothingSpecial;
278 libvlc_state = libvlc_Opening;
279 event.type = libvlc_MediaPlayerOpening;
282 libvlc_state = libvlc_Playing;
283 event.type = libvlc_MediaPlayerPlaying;
286 libvlc_state = libvlc_Paused;
287 event.type = libvlc_MediaPlayerPaused;
290 libvlc_state = libvlc_Ended;
291 event.type = libvlc_MediaPlayerEndReached;
294 libvlc_state = libvlc_Error;
295 event.type = libvlc_MediaPlayerEncounteredError;
302 set_state( p_mi, libvlc_state, false );
303 libvlc_event_send( p_mi->p_event_manager, &event );
305 else if( newval.i_int == INPUT_EVENT_ABORT )
307 libvlc_state_t libvlc_state = libvlc_Stopped;
308 event.type = libvlc_MediaPlayerStopped;
310 set_state( p_mi, libvlc_state, false );
311 libvlc_event_send( p_mi->p_event_manager, &event );
313 else if( newval.i_int == INPUT_EVENT_POSITION )
315 if( var_GetInteger( p_input, "state" ) != PLAYING_S )
316 return VLC_SUCCESS; /* Don't send the position while stopped */
319 event.type = libvlc_MediaPlayerPositionChanged;
320 event.u.media_player_position_changed.new_position =
321 var_GetFloat( p_input, "position" );
322 libvlc_event_send( p_mi->p_event_manager, &event );
325 event.type = libvlc_MediaPlayerTimeChanged;
326 event.u.media_player_time_changed.new_time =
327 from_mtime(var_GetTime( p_input, "time" ));
328 libvlc_event_send( p_mi->p_event_manager, &event );
330 else if( newval.i_int == INPUT_EVENT_LENGTH )
332 event.type = libvlc_MediaPlayerLengthChanged;
333 event.u.media_player_length_changed.new_length =
334 from_mtime(var_GetTime( p_input, "length" ));
335 libvlc_event_send( p_mi->p_event_manager, &event );
337 else if( newval.i_int == INPUT_EVENT_CACHE )
339 event.type = libvlc_MediaPlayerBuffering;
340 event.u.media_player_buffering.new_cache = (int)(100 *
341 var_GetFloat( p_input, "cache" ));
342 libvlc_event_send( p_mi->p_event_manager, &event );
344 else if( newval.i_int == INPUT_EVENT_VOUT )
346 vout_thread_t **pp_vout;
348 if( input_Control( p_input, INPUT_GET_VOUTS, &pp_vout, &i_vout ) )
354 for( size_t i = 0; i < i_vout; i++ )
355 vlc_object_release( pp_vout[i] );
359 event.type = libvlc_MediaPlayerVout;
360 event.u.media_player_vout.new_count = i_vout;
361 libvlc_event_send( p_mi->p_event_manager, &event );
367 static int track_type_from_name(const char *psz_name)
369 if( !strcmp( psz_name, "video-es" ) )
370 return libvlc_track_video;
371 else if( !strcmp( psz_name, "audio-es" ) )
372 return libvlc_track_audio;
373 else if( !strcmp( psz_name, "spu-es" ) )
374 return libvlc_track_text;
376 return libvlc_track_unknown;
379 static int input_es_changed( vlc_object_t *p_this,
386 libvlc_media_player_t *mp = p_userdata;
387 libvlc_event_t event;
389 /* Ignore the "Disable" element */
390 if (p_val && p_val->i_int < 0)
395 case VLC_VAR_ADDCHOICE:
396 event.type = libvlc_MediaPlayerESAdded;
398 case VLC_VAR_DELCHOICE:
399 case VLC_VAR_CLEARCHOICES:
400 event.type = libvlc_MediaPlayerESDeleted;
406 event.u.media_player_es_changed.i_type = track_type_from_name(psz_cmd);
409 if (action != VLC_VAR_CLEARCHOICES)
417 /* -1 means all ES tracks of this type were deleted. */
420 event.u.media_player_es_changed.i_id = i_id;
422 libvlc_event_send(mp->p_event_manager, &event);
428 input_es_selected( vlc_object_t * p_this, char const * psz_cmd,
429 vlc_value_t oldval, vlc_value_t newval,
434 libvlc_media_player_t *mp = p_userdata;
435 libvlc_event_t event;
437 event.type = libvlc_MediaPlayerESSelected;
438 event.u.media_player_es_changed.i_type = track_type_from_name(psz_cmd);
439 event.u.media_player_es_changed.i_id = newval.i_int;
441 libvlc_event_send(mp->p_event_manager, &event);
446 /**************************************************************************
447 * Snapshot Taken Event.
449 * FIXME: This snapshot API interface makes no sense in media_player.
450 *************************************************************************/
451 static int snapshot_was_taken(vlc_object_t *p_this, char const *psz_cmd,
452 vlc_value_t oldval, vlc_value_t newval, void *p_data )
454 VLC_UNUSED(psz_cmd); VLC_UNUSED(oldval); VLC_UNUSED(p_this);
456 libvlc_media_player_t *mp = p_data;
457 libvlc_event_t event;
458 event.type = libvlc_MediaPlayerSnapshotTaken;
459 event.u.media_player_snapshot_taken.psz_filename = newval.psz_string;
460 libvlc_event_send(mp->p_event_manager, &event);
466 static void libvlc_media_player_destroy( libvlc_media_player_t * );
469 /**************************************************************************
470 * Create a Media Instance object.
473 * - All items created by _new start with a refcount set to 1.
474 * - Accessor _release decrease the refcount by 1, if after that
475 * operation the refcount is 0, the object is destroyed.
476 * - Accessor _retain increase the refcount by 1 (XXX: to implement)
478 * Object locking strategy:
479 * - No lock held while in constructor.
480 * - When accessing any member variable this lock is held. (XXX who locks?)
481 * - When attempting to destroy the object the lock is also held.
482 **************************************************************************/
483 libvlc_media_player_t *
484 libvlc_media_player_new( libvlc_instance_t *instance )
486 libvlc_media_player_t * mp;
490 mp = vlc_object_create (instance->p_libvlc_int, sizeof(*mp));
491 if (unlikely(mp == NULL))
493 libvlc_printerr("Not enough memory");
498 var_Create (mp, "rate", VLC_VAR_FLOAT|VLC_VAR_DOINHERIT);
501 var_Create (mp, "vout", VLC_VAR_STRING|VLC_VAR_DOINHERIT);
502 var_Create (mp, "window", VLC_VAR_STRING);
503 var_Create (mp, "vmem-lock", VLC_VAR_ADDRESS);
504 var_Create (mp, "vmem-unlock", VLC_VAR_ADDRESS);
505 var_Create (mp, "vmem-display", VLC_VAR_ADDRESS);
506 var_Create (mp, "vmem-data", VLC_VAR_ADDRESS);
507 var_Create (mp, "vmem-setup", VLC_VAR_ADDRESS);
508 var_Create (mp, "vmem-cleanup", VLC_VAR_ADDRESS);
509 var_Create (mp, "vmem-chroma", VLC_VAR_STRING | VLC_VAR_DOINHERIT);
510 var_Create (mp, "vmem-width", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
511 var_Create (mp, "vmem-height", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
512 var_Create (mp, "vmem-pitch", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
513 var_Create (mp, "avcodec-hw", VLC_VAR_STRING);
514 var_Create (mp, "drawable-xid", VLC_VAR_INTEGER);
515 #if defined (_WIN32) || defined (__OS2__)
516 var_Create (mp, "drawable-hwnd", VLC_VAR_INTEGER);
519 var_Create (mp, "drawable-agl", VLC_VAR_INTEGER);
520 var_Create (mp, "drawable-nsobject", VLC_VAR_ADDRESS);
523 var_Create (mp, "keyboard-events", VLC_VAR_BOOL);
524 var_SetBool (mp, "keyboard-events", true);
525 var_Create (mp, "mouse-events", VLC_VAR_BOOL);
526 var_SetBool (mp, "mouse-events", true);
528 var_Create (mp, "fullscreen", VLC_VAR_BOOL);
529 var_Create (mp, "autoscale", VLC_VAR_BOOL | VLC_VAR_DOINHERIT);
530 var_Create (mp, "zoom", VLC_VAR_FLOAT | VLC_VAR_DOINHERIT);
531 var_Create (mp, "aspect-ratio", VLC_VAR_STRING);
532 var_Create (mp, "crop", VLC_VAR_STRING);
533 var_Create (mp, "deinterlace", VLC_VAR_INTEGER);
534 var_Create (mp, "deinterlace-mode", VLC_VAR_STRING);
536 var_Create (mp, "vbi-page", VLC_VAR_INTEGER);
538 var_Create (mp, "marq-marquee", VLC_VAR_STRING);
539 var_Create (mp, "marq-color", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
540 var_Create (mp, "marq-opacity", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
541 var_Create (mp, "marq-position", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
542 var_Create (mp, "marq-refresh", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
543 var_Create (mp, "marq-size", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
544 var_Create (mp, "marq-timeout", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
545 var_Create (mp, "marq-x", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
546 var_Create (mp, "marq-y", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
548 var_Create (mp, "logo-file", VLC_VAR_STRING);
549 var_Create (mp, "logo-x", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
550 var_Create (mp, "logo-y", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
551 var_Create (mp, "logo-delay", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
552 var_Create (mp, "logo-repeat", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
553 var_Create (mp, "logo-opacity", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
554 var_Create (mp, "logo-position", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
556 var_Create (mp, "contrast", VLC_VAR_FLOAT | VLC_VAR_DOINHERIT);
557 var_Create (mp, "brightness", VLC_VAR_FLOAT | VLC_VAR_DOINHERIT);
558 var_Create (mp, "hue", VLC_VAR_FLOAT | VLC_VAR_DOINHERIT);
559 var_Create (mp, "saturation", VLC_VAR_FLOAT | VLC_VAR_DOINHERIT);
560 var_Create (mp, "gamma", VLC_VAR_FLOAT | VLC_VAR_DOINHERIT);
563 var_Create (mp, "aout", VLC_VAR_STRING | VLC_VAR_DOINHERIT);
564 var_Create (mp, "mute", VLC_VAR_BOOL);
565 var_Create (mp, "volume", VLC_VAR_FLOAT);
566 var_Create (mp, "corks", VLC_VAR_INTEGER);
567 var_Create (mp, "audio-filter", VLC_VAR_STRING);
568 var_Create (mp, "amem-data", VLC_VAR_ADDRESS);
569 var_Create (mp, "amem-setup", VLC_VAR_ADDRESS);
570 var_Create (mp, "amem-cleanup", VLC_VAR_ADDRESS);
571 var_Create (mp, "amem-play", VLC_VAR_ADDRESS);
572 var_Create (mp, "amem-pause", VLC_VAR_ADDRESS);
573 var_Create (mp, "amem-resume", VLC_VAR_ADDRESS);
574 var_Create (mp, "amem-flush", VLC_VAR_ADDRESS);
575 var_Create (mp, "amem-drain", VLC_VAR_ADDRESS);
576 var_Create (mp, "amem-set-volume", VLC_VAR_ADDRESS);
577 var_Create (mp, "amem-format", VLC_VAR_STRING | VLC_VAR_DOINHERIT);
578 var_Create (mp, "amem-rate", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
579 var_Create (mp, "amem-channels", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
582 var_Create (mp, "video-title-show", VLC_VAR_BOOL);
583 var_Create (mp, "video-title-position", VLC_VAR_INTEGER);
584 var_Create (mp, "video-title-timeout", VLC_VAR_INTEGER);
587 var_Create (mp, "equalizer-preamp", VLC_VAR_FLOAT);
588 var_Create (mp, "equalizer-vlcfreqs", VLC_VAR_BOOL);
589 var_Create (mp, "equalizer-bands", VLC_VAR_STRING);
592 mp->state = libvlc_NothingSpecial;
593 mp->p_libvlc_instance = instance;
594 mp->input.p_thread = NULL;
595 mp->input.p_resource = input_resource_New(VLC_OBJECT(mp));
596 if (unlikely(mp->input.p_resource == NULL))
598 vlc_object_release(mp);
601 audio_output_t *aout = input_resource_GetAout(mp->input.p_resource);
603 input_resource_PutAout(mp->input.p_resource, aout);
605 vlc_mutex_init (&mp->input.lock);
607 mp->p_event_manager = libvlc_event_manager_new(mp, instance);
608 if (unlikely(mp->p_event_manager == NULL))
610 input_resource_Release(mp->input.p_resource);
611 vlc_object_release(mp);
614 vlc_mutex_init(&mp->object_lock);
616 register_event(mp, NothingSpecial);
617 register_event(mp, Opening);
618 register_event(mp, Buffering);
619 register_event(mp, Playing);
620 register_event(mp, Paused);
621 register_event(mp, Stopped);
622 register_event(mp, Forward);
623 register_event(mp, Backward);
624 register_event(mp, EndReached);
625 register_event(mp, EncounteredError);
626 register_event(mp, SeekableChanged);
628 register_event(mp, PositionChanged);
629 register_event(mp, TimeChanged);
630 register_event(mp, LengthChanged);
631 register_event(mp, TitleChanged);
632 register_event(mp, PausableChanged);
634 register_event(mp, Vout);
635 register_event(mp, ScrambledChanged);
636 register_event(mp, ESAdded);
637 register_event(mp, ESDeleted);
638 register_event(mp, ESSelected);
640 /* Snapshot initialization */
641 register_event(mp, SnapshotTaken);
643 register_event(mp, MediaChanged);
645 /* Attach a var callback to the global object to provide the glue between
646 * vout_thread that generates the event and media_player that re-emits it
647 * with its own event manager
649 * FIXME: It's unclear why we want to put this in public API, and why we
650 * want to expose it in such a limiting and ugly way.
652 var_AddCallback(mp->p_libvlc, "snapshot-file", snapshot_was_taken, mp);
654 libvlc_retain(instance);
658 /**************************************************************************
659 * Create a Media Instance object with a media descriptor.
660 **************************************************************************/
661 libvlc_media_player_t *
662 libvlc_media_player_new_from_media( libvlc_media_t * p_md )
664 libvlc_media_player_t * p_mi;
666 p_mi = libvlc_media_player_new( p_md->p_libvlc_instance );
670 libvlc_media_retain( p_md );
676 /**************************************************************************
677 * Destroy a Media Instance object (libvlc internal)
679 * Warning: No lock held here, but hey, this is internal. Caller must lock.
680 **************************************************************************/
681 static void libvlc_media_player_destroy( libvlc_media_player_t *p_mi )
685 /* Detach Callback from the main libvlc object */
686 var_DelCallback( p_mi->p_libvlc,
687 "snapshot-file", snapshot_was_taken, p_mi );
689 /* No need for lock_input() because no other threads knows us anymore */
690 if( p_mi->input.p_thread )
691 release_input_thread(p_mi, true);
692 input_resource_Terminate( p_mi->input.p_resource );
693 input_resource_Release( p_mi->input.p_resource );
694 vlc_mutex_destroy( &p_mi->input.lock );
696 libvlc_event_manager_release( p_mi->p_event_manager );
697 libvlc_media_release( p_mi->p_md );
698 vlc_mutex_destroy( &p_mi->object_lock );
700 libvlc_instance_t *instance = p_mi->p_libvlc_instance;
701 vlc_object_release( p_mi );
702 libvlc_release(instance);
705 /**************************************************************************
706 * Release a Media Instance object.
708 * Function does the locking.
709 **************************************************************************/
710 void libvlc_media_player_release( libvlc_media_player_t *p_mi )
716 destroy = !--p_mi->i_refcount;
720 libvlc_media_player_destroy( p_mi );
723 /**************************************************************************
724 * Retain a Media Instance object.
726 * Caller must hold the lock.
727 **************************************************************************/
728 void libvlc_media_player_retain( libvlc_media_player_t *p_mi )
737 /**************************************************************************
738 * Set the Media descriptor associated with the instance.
740 * Enter without lock -- function will lock the object.
741 **************************************************************************/
742 void libvlc_media_player_set_media(
743 libvlc_media_player_t *p_mi,
744 libvlc_media_t *p_md )
748 /* FIXME I am not sure if it is a user request or on die(eof/error)
750 release_input_thread( p_mi,
751 p_mi->input.p_thread &&
752 !p_mi->input.p_thread->b_eof &&
753 !p_mi->input.p_thread->b_error );
756 set_state( p_mi, libvlc_NothingSpecial, true );
757 unlock_input( p_mi );
759 libvlc_media_release( p_mi->p_md );
765 return; /* It is ok to pass a NULL md */
768 libvlc_media_retain( p_md );
771 /* The policy here is to ignore that we were created using a different
772 * libvlc_instance, because we don't really care */
773 p_mi->p_libvlc_instance = p_md->p_libvlc_instance;
777 /* Send an event for the newly available media */
778 libvlc_event_t event;
779 event.type = libvlc_MediaPlayerMediaChanged;
780 event.u.media_player_media_changed.new_media = p_md;
781 libvlc_event_send( p_mi->p_event_manager, &event );
785 /**************************************************************************
786 * Get the Media descriptor associated with the instance.
787 **************************************************************************/
789 libvlc_media_player_get_media( libvlc_media_player_t *p_mi )
796 libvlc_media_retain( p_m );
802 /**************************************************************************
803 * Get the event Manager.
804 **************************************************************************/
805 libvlc_event_manager_t *
806 libvlc_media_player_event_manager( libvlc_media_player_t *p_mi )
808 return p_mi->p_event_manager;
811 static void add_es_callbacks( input_thread_t *p_input_thread, libvlc_media_player_t *p_mi )
813 var_AddListCallback( p_input_thread, "video-es", input_es_changed, p_mi );
814 var_AddListCallback( p_input_thread, "audio-es", input_es_changed, p_mi );
815 var_AddListCallback( p_input_thread, "spu-es", input_es_changed, p_mi );
816 var_AddCallback( p_input_thread, "video-es", input_es_selected, p_mi );
817 var_AddCallback( p_input_thread, "audio-es", input_es_selected, p_mi );
818 var_AddCallback( p_input_thread, "spu-es", input_es_selected, p_mi );
821 static void del_es_callbacks( input_thread_t *p_input_thread, libvlc_media_player_t *p_mi )
823 var_DelListCallback( p_input_thread, "video-es", input_es_changed, p_mi );
824 var_DelListCallback( p_input_thread, "audio-es", input_es_changed, p_mi );
825 var_DelListCallback( p_input_thread, "spu-es", input_es_changed, p_mi );
826 var_DelCallback( p_input_thread, "video-es", input_es_selected, p_mi );
827 var_DelCallback( p_input_thread, "audio-es", input_es_selected, p_mi );
828 var_DelCallback( p_input_thread, "spu-es", input_es_selected, p_mi );
831 /**************************************************************************
832 * Tell media player to start playing.
833 **************************************************************************/
834 int libvlc_media_player_play( libvlc_media_player_t *p_mi )
838 input_thread_t *p_input_thread = p_mi->input.p_thread;
841 /* A thread already exists, send it a play message */
842 input_Control( p_input_thread, INPUT_SET_STATE, PLAYING_S );
843 unlock_input( p_mi );
847 /* Ignore previous exception */
853 unlock_input( p_mi );
854 libvlc_printerr( "No associated media descriptor" );
858 p_input_thread = input_Create( p_mi, p_mi->p_md->p_input_item, NULL,
859 p_mi->input.p_resource );
861 if( !p_input_thread )
864 libvlc_printerr( "Not enough memory" );
868 var_AddCallback( p_input_thread, "can-seek", input_seekable_changed, p_mi );
869 var_AddCallback( p_input_thread, "can-pause", input_pausable_changed, p_mi );
870 var_AddCallback( p_input_thread, "program-scrambled", input_scrambled_changed, p_mi );
871 var_AddCallback( p_input_thread, "intf-event", input_event_changed, p_mi );
872 add_es_callbacks( p_input_thread, p_mi );
874 if( input_Start( p_input_thread ) )
877 del_es_callbacks( p_input_thread, p_mi );
878 var_DelCallback( p_input_thread, "intf-event", input_event_changed, p_mi );
879 var_DelCallback( p_input_thread, "can-pause", input_pausable_changed, p_mi );
880 var_DelCallback( p_input_thread, "program-scrambled", input_scrambled_changed, p_mi );
881 var_DelCallback( p_input_thread, "can-seek", input_seekable_changed, p_mi );
882 vlc_object_release( p_input_thread );
883 libvlc_printerr( "Input initialization failure" );
886 p_mi->input.p_thread = p_input_thread;
891 void libvlc_media_player_set_pause( libvlc_media_player_t *p_mi, int paused )
893 input_thread_t * p_input_thread = libvlc_get_input_thread( p_mi );
894 if( !p_input_thread )
897 libvlc_state_t state = libvlc_media_player_get_state( p_mi );
898 if( state == libvlc_Playing || state == libvlc_Buffering )
902 if( libvlc_media_player_can_pause( p_mi ) )
903 input_Control( p_input_thread, INPUT_SET_STATE, PAUSE_S );
905 input_Stop( p_input_thread, true );
911 input_Control( p_input_thread, INPUT_SET_STATE, PLAYING_S );
914 vlc_object_release( p_input_thread );
917 /**************************************************************************
919 **************************************************************************/
920 void libvlc_media_player_pause( libvlc_media_player_t *p_mi )
922 libvlc_state_t state = libvlc_media_player_get_state( p_mi );
923 bool playing = (state == libvlc_Playing || state == libvlc_Buffering);
925 libvlc_media_player_set_pause( p_mi, playing );
928 /**************************************************************************
929 * Tells whether the media player is currently playing.
931 * Enter with lock held.
932 **************************************************************************/
933 int libvlc_media_player_is_playing( libvlc_media_player_t *p_mi )
935 libvlc_state_t state = libvlc_media_player_get_state( p_mi );
936 return (libvlc_Playing == state) || (libvlc_Buffering == state);
939 /**************************************************************************
941 **************************************************************************/
942 void libvlc_media_player_stop( libvlc_media_player_t *p_mi )
944 libvlc_state_t state = libvlc_media_player_get_state( p_mi );
947 release_input_thread( p_mi, true ); /* This will stop the input thread */
949 /* Force to go to stopped state, in case we were in Ended, or Error
951 if( state != libvlc_Stopped )
953 set_state( p_mi, libvlc_Stopped, false );
955 /* Construct and send the event */
956 libvlc_event_t event;
957 event.type = libvlc_MediaPlayerStopped;
958 libvlc_event_send( p_mi->p_event_manager, &event );
961 input_resource_Terminate( p_mi->input.p_resource );
966 void libvlc_video_set_callbacks( libvlc_media_player_t *mp,
967 void *(*lock_cb) (void *, void **),
968 void (*unlock_cb) (void *, void *, void *const *),
969 void (*display_cb) (void *, void *),
972 var_SetAddress( mp, "vmem-lock", lock_cb );
973 var_SetAddress( mp, "vmem-unlock", unlock_cb );
974 var_SetAddress( mp, "vmem-display", display_cb );
975 var_SetAddress( mp, "vmem-data", opaque );
976 var_SetString( mp, "vout", "vmem" );
977 var_SetString( mp, "avcodec-hw", "none" );
980 void libvlc_video_set_format_callbacks( libvlc_media_player_t *mp,
981 libvlc_video_format_cb setup,
982 libvlc_video_cleanup_cb cleanup )
984 var_SetAddress( mp, "vmem-setup", setup );
985 var_SetAddress( mp, "vmem-cleanup", cleanup );
988 void libvlc_video_set_format( libvlc_media_player_t *mp, const char *chroma,
989 unsigned width, unsigned height, unsigned pitch )
991 var_SetString( mp, "vmem-chroma", chroma );
992 var_SetInteger( mp, "vmem-width", width );
993 var_SetInteger( mp, "vmem-height", height );
994 var_SetInteger( mp, "vmem-pitch", pitch );
997 /**************************************************************************
999 **************************************************************************/
1000 void libvlc_media_player_set_nsobject( libvlc_media_player_t *p_mi,
1003 assert (p_mi != NULL);
1005 var_SetAddress (p_mi, "drawable-nsobject", drawable);
1007 (void) p_mi; (void)drawable;
1011 /**************************************************************************
1013 **************************************************************************/
1014 void * libvlc_media_player_get_nsobject( libvlc_media_player_t *p_mi )
1016 assert (p_mi != NULL);
1018 return var_GetAddress (p_mi, "drawable-nsobject");
1024 /**************************************************************************
1026 **************************************************************************/
1027 void libvlc_media_player_set_agl( libvlc_media_player_t *p_mi,
1031 var_SetInteger (p_mi, "drawable-agl", drawable);
1033 (void) p_mi; (void)drawable;
1037 /**************************************************************************
1039 **************************************************************************/
1040 uint32_t libvlc_media_player_get_agl( libvlc_media_player_t *p_mi )
1042 assert (p_mi != NULL);
1044 return var_GetInteger (p_mi, "drawable-agl");
1050 /**************************************************************************
1052 **************************************************************************/
1053 void libvlc_media_player_set_xwindow( libvlc_media_player_t *p_mi,
1056 assert (p_mi != NULL);
1058 var_SetString (p_mi, "avcodec-hw", "");
1059 var_SetString (p_mi, "vout", drawable ? "xid" : "any");
1060 var_SetString (p_mi, "window", drawable ? "embed-xid,any" : "any");
1061 var_SetInteger (p_mi, "drawable-xid", drawable);
1064 /**************************************************************************
1066 **************************************************************************/
1067 uint32_t libvlc_media_player_get_xwindow( libvlc_media_player_t *p_mi )
1069 return var_GetInteger (p_mi, "drawable-xid");
1072 /**************************************************************************
1074 **************************************************************************/
1075 void libvlc_media_player_set_hwnd( libvlc_media_player_t *p_mi,
1078 assert (p_mi != NULL);
1079 #if defined (_WIN32) || defined (__OS2__)
1080 var_SetString (p_mi, "window",
1081 (drawable != NULL) ? "embed-hwnd,any" : "");
1082 var_SetInteger (p_mi, "drawable-hwnd", (uintptr_t)drawable);
1084 (void) p_mi; (void) drawable;
1088 /**************************************************************************
1090 **************************************************************************/
1091 void *libvlc_media_player_get_hwnd( libvlc_media_player_t *p_mi )
1093 assert (p_mi != NULL);
1094 #if defined (_WIN32) || defined (__OS2__)
1095 return (void *)(uintptr_t)var_GetInteger (p_mi, "drawable-hwnd");
1101 void libvlc_audio_set_callbacks( libvlc_media_player_t *mp,
1102 libvlc_audio_play_cb play_cb,
1103 libvlc_audio_pause_cb pause_cb,
1104 libvlc_audio_resume_cb resume_cb,
1105 libvlc_audio_flush_cb flush_cb,
1106 libvlc_audio_drain_cb drain_cb,
1109 var_SetAddress( mp, "amem-play", play_cb );
1110 var_SetAddress( mp, "amem-pause", pause_cb );
1111 var_SetAddress( mp, "amem-resume", resume_cb );
1112 var_SetAddress( mp, "amem-flush", flush_cb );
1113 var_SetAddress( mp, "amem-drain", drain_cb );
1114 var_SetAddress( mp, "amem-data", opaque );
1115 var_SetString( mp, "aout", "amem,none" );
1117 input_resource_ResetAout(mp->input.p_resource);
1120 void libvlc_audio_set_volume_callback( libvlc_media_player_t *mp,
1121 libvlc_audio_set_volume_cb cb )
1123 var_SetAddress( mp, "amem-set-volume", cb );
1125 input_resource_ResetAout(mp->input.p_resource);
1128 void libvlc_audio_set_format_callbacks( libvlc_media_player_t *mp,
1129 libvlc_audio_setup_cb setup,
1130 libvlc_audio_cleanup_cb cleanup )
1132 var_SetAddress( mp, "amem-setup", setup );
1133 var_SetAddress( mp, "amem-cleanup", cleanup );
1135 input_resource_ResetAout(mp->input.p_resource);
1138 void libvlc_audio_set_format( libvlc_media_player_t *mp, const char *format,
1139 unsigned rate, unsigned channels )
1141 var_SetString( mp, "amem-format", format );
1142 var_SetInteger( mp, "amem-rate", rate );
1143 var_SetInteger( mp, "amem-channels", channels );
1145 input_resource_ResetAout(mp->input.p_resource);
1149 /**************************************************************************
1150 * Getters for stream information
1151 **************************************************************************/
1152 libvlc_time_t libvlc_media_player_get_length(
1153 libvlc_media_player_t *p_mi )
1155 input_thread_t *p_input_thread;
1156 libvlc_time_t i_time;
1158 p_input_thread = libvlc_get_input_thread ( p_mi );
1159 if( !p_input_thread )
1162 i_time = from_mtime(var_GetTime( p_input_thread, "length" ));
1163 vlc_object_release( p_input_thread );
1168 libvlc_time_t libvlc_media_player_get_time( libvlc_media_player_t *p_mi )
1170 input_thread_t *p_input_thread;
1171 libvlc_time_t i_time;
1173 p_input_thread = libvlc_get_input_thread ( p_mi );
1174 if( !p_input_thread )
1177 i_time = from_mtime(var_GetTime( p_input_thread , "time" ));
1178 vlc_object_release( p_input_thread );
1182 void libvlc_media_player_set_time( libvlc_media_player_t *p_mi,
1183 libvlc_time_t i_time )
1185 input_thread_t *p_input_thread;
1187 p_input_thread = libvlc_get_input_thread ( p_mi );
1188 if( !p_input_thread )
1191 var_SetTime( p_input_thread, "time", to_mtime(i_time) );
1192 vlc_object_release( p_input_thread );
1195 void libvlc_media_player_set_position( libvlc_media_player_t *p_mi,
1198 input_thread_t *p_input_thread;
1200 p_input_thread = libvlc_get_input_thread ( p_mi );
1201 if( !p_input_thread )
1204 var_SetFloat( p_input_thread, "position", position );
1205 vlc_object_release( p_input_thread );
1208 float libvlc_media_player_get_position( libvlc_media_player_t *p_mi )
1210 input_thread_t *p_input_thread;
1213 p_input_thread = libvlc_get_input_thread ( p_mi );
1214 if( !p_input_thread )
1217 f_position = var_GetFloat( p_input_thread, "position" );
1218 vlc_object_release( p_input_thread );
1223 void libvlc_media_player_set_chapter( libvlc_media_player_t *p_mi,
1226 input_thread_t *p_input_thread;
1228 p_input_thread = libvlc_get_input_thread ( p_mi );
1229 if( !p_input_thread )
1232 var_SetInteger( p_input_thread, "chapter", chapter );
1233 vlc_object_release( p_input_thread );
1236 int libvlc_media_player_get_chapter( libvlc_media_player_t *p_mi )
1238 input_thread_t *p_input_thread;
1241 p_input_thread = libvlc_get_input_thread ( p_mi );
1242 if( !p_input_thread )
1245 i_chapter = var_GetInteger( p_input_thread, "chapter" );
1246 vlc_object_release( p_input_thread );
1251 int libvlc_media_player_get_chapter_count( libvlc_media_player_t *p_mi )
1253 input_thread_t *p_input_thread;
1256 p_input_thread = libvlc_get_input_thread ( p_mi );
1257 if( !p_input_thread )
1260 int i_ret = var_Change( p_input_thread, "chapter", VLC_VAR_CHOICESCOUNT, &val, NULL );
1261 vlc_object_release( p_input_thread );
1263 return i_ret == VLC_SUCCESS ? val.i_int : -1;
1266 int libvlc_media_player_get_chapter_count_for_title(
1267 libvlc_media_player_t *p_mi,
1270 input_thread_t *p_input_thread;
1273 p_input_thread = libvlc_get_input_thread ( p_mi );
1274 if( !p_input_thread )
1278 if( asprintf( &psz_name, "title %2i", i_title ) == -1 )
1280 vlc_object_release( p_input_thread );
1283 int i_ret = var_Change( p_input_thread, psz_name, VLC_VAR_CHOICESCOUNT, &val, NULL );
1284 vlc_object_release( p_input_thread );
1287 return i_ret == VLC_SUCCESS ? val.i_int : -1;
1290 void libvlc_media_player_set_title( libvlc_media_player_t *p_mi,
1293 input_thread_t *p_input_thread;
1295 p_input_thread = libvlc_get_input_thread ( p_mi );
1296 if( !p_input_thread )
1299 var_SetInteger( p_input_thread, "title", i_title );
1300 vlc_object_release( p_input_thread );
1303 libvlc_event_t event;
1304 event.type = libvlc_MediaPlayerTitleChanged;
1305 event.u.media_player_title_changed.new_title = i_title;
1306 libvlc_event_send( p_mi->p_event_manager, &event );
1309 int libvlc_media_player_get_title( libvlc_media_player_t *p_mi )
1311 input_thread_t *p_input_thread;
1314 p_input_thread = libvlc_get_input_thread ( p_mi );
1315 if( !p_input_thread )
1318 i_title = var_GetInteger( p_input_thread, "title" );
1319 vlc_object_release( p_input_thread );
1324 int libvlc_media_player_get_title_count( libvlc_media_player_t *p_mi )
1326 input_thread_t *p_input_thread;
1329 p_input_thread = libvlc_get_input_thread ( p_mi );
1330 if( !p_input_thread )
1333 int i_ret = var_Change( p_input_thread, "title", VLC_VAR_CHOICESCOUNT, &val, NULL );
1334 vlc_object_release( p_input_thread );
1336 return i_ret == VLC_SUCCESS ? val.i_int : -1;
1339 void libvlc_media_player_next_chapter( libvlc_media_player_t *p_mi )
1341 input_thread_t *p_input_thread;
1343 p_input_thread = libvlc_get_input_thread ( p_mi );
1344 if( !p_input_thread )
1347 int i_type = var_Type( p_input_thread, "next-chapter" );
1348 var_TriggerCallback( p_input_thread, (i_type & VLC_VAR_TYPE) != 0 ?
1349 "next-chapter":"next-title" );
1351 vlc_object_release( p_input_thread );
1354 void libvlc_media_player_previous_chapter( libvlc_media_player_t *p_mi )
1356 input_thread_t *p_input_thread;
1358 p_input_thread = libvlc_get_input_thread ( p_mi );
1359 if( !p_input_thread )
1362 int i_type = var_Type( p_input_thread, "next-chapter" );
1363 var_TriggerCallback( p_input_thread, (i_type & VLC_VAR_TYPE) != 0 ?
1364 "prev-chapter":"prev-title" );
1366 vlc_object_release( p_input_thread );
1369 float libvlc_media_player_get_fps( libvlc_media_player_t *p_mi )
1371 input_thread_t *p_input_thread = libvlc_get_input_thread ( p_mi );
1374 if( p_input_thread )
1376 if( input_Control( p_input_thread, INPUT_GET_VIDEO_FPS, &f_fps ) )
1378 vlc_object_release( p_input_thread );
1383 int libvlc_media_player_will_play( libvlc_media_player_t *p_mi )
1386 input_thread_t *p_input_thread =
1387 libvlc_get_input_thread ( p_mi );
1388 if ( !p_input_thread )
1391 b_will_play = !p_input_thread->b_dead;
1392 vlc_object_release( p_input_thread );
1397 int libvlc_media_player_set_rate( libvlc_media_player_t *p_mi, float rate )
1399 var_SetFloat (p_mi, "rate", rate);
1401 input_thread_t *p_input_thread = libvlc_get_input_thread ( p_mi );
1402 if( !p_input_thread )
1404 var_SetFloat( p_input_thread, "rate", rate );
1405 vlc_object_release( p_input_thread );
1409 float libvlc_media_player_get_rate( libvlc_media_player_t *p_mi )
1411 return var_GetFloat (p_mi, "rate");
1414 libvlc_state_t libvlc_media_player_get_state( libvlc_media_player_t *p_mi )
1417 libvlc_state_t state = p_mi->state;
1422 int libvlc_media_player_is_seekable( libvlc_media_player_t *p_mi )
1424 input_thread_t *p_input_thread;
1427 p_input_thread = libvlc_get_input_thread ( p_mi );
1428 if ( !p_input_thread )
1430 b_seekable = var_GetBool( p_input_thread, "can-seek" );
1431 vlc_object_release( p_input_thread );
1436 void libvlc_media_player_navigate( libvlc_media_player_t* p_mi,
1439 static const vlc_action_t map[] =
1441 INPUT_NAV_ACTIVATE, INPUT_NAV_UP, INPUT_NAV_DOWN,
1442 INPUT_NAV_LEFT, INPUT_NAV_RIGHT,
1445 if( navigate >= sizeof(map) / sizeof(map[0]) )
1448 input_thread_t *p_input = libvlc_get_input_thread ( p_mi );
1449 if ( p_input == NULL )
1452 input_Control( p_input, map[navigate], NULL );
1453 vlc_object_release( p_input );
1456 /* internal function, used by audio, video */
1457 libvlc_track_description_t *
1458 libvlc_get_track_description( libvlc_media_player_t *p_mi,
1459 const char *psz_variable )
1461 input_thread_t *p_input = libvlc_get_input_thread( p_mi );
1462 libvlc_track_description_t *p_track_description = NULL,
1463 *p_actual, *p_previous;
1468 vlc_value_t val_list, text_list;
1469 int i_ret = var_Change( p_input, psz_variable, VLC_VAR_GETCHOICES, &val_list, &text_list );
1470 if( i_ret != VLC_SUCCESS )
1474 if( val_list.p_list->i_count <= 0 )
1477 p_track_description = ( libvlc_track_description_t * )
1478 malloc( sizeof( libvlc_track_description_t ) );
1479 if ( !p_track_description )
1481 libvlc_printerr( "Not enough memory" );
1484 p_actual = p_track_description;
1486 for( int i = 0; i < val_list.p_list->i_count; i++ )
1490 p_actual = ( libvlc_track_description_t * )
1491 malloc( sizeof( libvlc_track_description_t ) );
1494 libvlc_track_description_list_release( p_track_description );
1495 libvlc_printerr( "Not enough memory" );
1499 p_actual->i_id = val_list.p_list->p_values[i].i_int;
1500 p_actual->psz_name = strdup( text_list.p_list->p_values[i].psz_string );
1501 p_actual->p_next = NULL;
1503 p_previous->p_next = p_actual;
1504 p_previous = p_actual;
1509 var_FreeList( &val_list, &text_list );
1510 vlc_object_release( p_input );
1512 return p_track_description;
1515 // Deprecated alias for libvlc_track_description_list_release
1516 void libvlc_track_description_release( libvlc_track_description_t *p_td )
1518 libvlc_track_description_list_release( p_td );
1521 void libvlc_track_description_list_release( libvlc_track_description_t *p_td )
1523 libvlc_track_description_t *p_actual, *p_before;
1528 free( p_actual->psz_name );
1529 p_before = p_actual;
1530 p_actual = p_before->p_next;
1535 int libvlc_media_player_can_pause( libvlc_media_player_t *p_mi )
1537 input_thread_t *p_input_thread;
1540 p_input_thread = libvlc_get_input_thread ( p_mi );
1541 if ( !p_input_thread )
1543 b_can_pause = var_GetBool( p_input_thread, "can-pause" );
1544 vlc_object_release( p_input_thread );
1549 int libvlc_media_player_program_scrambled( libvlc_media_player_t *p_mi )
1551 input_thread_t *p_input_thread;
1552 bool b_program_scrambled;
1554 p_input_thread = libvlc_get_input_thread ( p_mi );
1555 if ( !p_input_thread )
1557 b_program_scrambled = var_GetBool( p_input_thread, "program-scrambled" );
1558 vlc_object_release( p_input_thread );
1560 return b_program_scrambled;
1563 void libvlc_media_player_next_frame( libvlc_media_player_t *p_mi )
1565 input_thread_t *p_input_thread = libvlc_get_input_thread ( p_mi );
1566 if( p_input_thread != NULL )
1568 var_TriggerCallback( p_input_thread, "frame-next" );
1569 vlc_object_release( p_input_thread );
1574 * Private lookup table to get subpicture alignment flag values corresponding
1575 * to a libvlc_position_t enumerated value.
1577 static const unsigned char position_subpicture_alignment[] = {
1578 [libvlc_position_center] = 0,
1579 [libvlc_position_left] = SUBPICTURE_ALIGN_LEFT,
1580 [libvlc_position_right] = SUBPICTURE_ALIGN_RIGHT,
1581 [libvlc_position_top] = SUBPICTURE_ALIGN_TOP,
1582 [libvlc_position_top_left] = SUBPICTURE_ALIGN_TOP | SUBPICTURE_ALIGN_LEFT,
1583 [libvlc_position_top_right] = SUBPICTURE_ALIGN_TOP | SUBPICTURE_ALIGN_RIGHT,
1584 [libvlc_position_bottom] = SUBPICTURE_ALIGN_BOTTOM,
1585 [libvlc_position_bottom_left] = SUBPICTURE_ALIGN_BOTTOM | SUBPICTURE_ALIGN_LEFT,
1586 [libvlc_position_bottom_right] = SUBPICTURE_ALIGN_BOTTOM | SUBPICTURE_ALIGN_RIGHT
1589 void libvlc_media_player_set_video_title_display( libvlc_media_player_t *p_mi, libvlc_position_t position, unsigned timeout )
1591 assert( position >= libvlc_position_disable && position <= libvlc_position_bottom_right );
1593 if ( position != libvlc_position_disable )
1595 var_SetBool( p_mi, "video-title-show", true );
1596 var_SetInteger( p_mi, "video-title-position", position_subpicture_alignment[position] );
1597 var_SetInteger( p_mi, "video-title-timeout", timeout );
1601 var_SetBool( p_mi, "video-title-show", false );
1606 * Maximum size of a formatted equalizer amplification band frequency value.
1608 * The allowed value range is supposed to be constrained from -20.0 to 20.0.
1610 * The format string " %.07f" with a minimum value of "-20" gives a maximum
1611 * string length of e.g. " -19.1234567", i.e. 12 bytes (not including the null
1614 #define EQZ_BAND_VALUE_SIZE 12
1616 int libvlc_media_player_set_equalizer( libvlc_media_player_t *p_mi, libvlc_equalizer_t *p_equalizer )
1618 char bands[EQZ_BANDS_MAX * EQZ_BAND_VALUE_SIZE + 1];
1620 if( p_equalizer != NULL )
1622 for( unsigned i = 0, c = 0; i < EQZ_BANDS_MAX; i++ )
1624 c += snprintf( bands + c, sizeof(bands) - c, " %.07f",
1625 p_equalizer->f_amp[i] );
1626 if( unlikely(c >= sizeof(bands)) )
1630 var_SetFloat( p_mi, "equalizer-preamp", p_equalizer->f_preamp );
1631 var_SetString( p_mi, "equalizer-bands", bands );
1633 var_SetString( p_mi, "audio-filter", p_equalizer ? "equalizer" : "" );
1635 audio_output_t *p_aout = input_resource_HoldAout( p_mi->input.p_resource );
1636 if( p_aout != NULL )
1638 if( p_equalizer != NULL )
1640 var_SetFloat( p_aout, "equalizer-preamp", p_equalizer->f_preamp );
1641 var_SetString( p_aout, "equalizer-bands", bands );
1644 var_SetString( p_aout, "audio-filter", p_equalizer ? "equalizer" : "" );
1645 vlc_object_release( p_aout );