1 /*****************************************************************************
2 * media_player.c: Libvlc API Media Instance management functions
3 *****************************************************************************
4 * Copyright (C) 2005-2015 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_renderer_discoverer.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"
43 #include "renderer_discoverer_internal.h"
45 #define ES_INIT (-2) /* -1 is reserved for ES deselect */
48 input_seekable_changed( vlc_object_t
* p_this
, char const * psz_cmd
,
49 vlc_value_t oldval
, vlc_value_t newval
,
52 input_pausable_changed( vlc_object_t
* p_this
, char const * psz_cmd
,
53 vlc_value_t oldval
, vlc_value_t newval
,
56 input_scrambled_changed( vlc_object_t
* p_this
, char const * psz_cmd
,
57 vlc_value_t oldval
, vlc_value_t newval
,
60 input_event_changed( vlc_object_t
* p_this
, char const * psz_cmd
,
61 vlc_value_t oldval
, vlc_value_t newval
,
65 input_es_changed( vlc_object_t
* p_this
, char const * psz_cmd
,
66 int action
, vlc_value_t
*p_val
,
70 corks_changed(vlc_object_t
*obj
, const char *name
, vlc_value_t old
,
71 vlc_value_t cur
, void *opaque
);
74 mute_changed(vlc_object_t
*obj
, const char *name
, vlc_value_t old
,
75 vlc_value_t cur
, void *opaque
);
78 volume_changed(vlc_object_t
*obj
, const char *name
, vlc_value_t old
,
79 vlc_value_t cur
, void *opaque
);
82 add_es_callbacks( input_thread_t
*p_input_thread
, libvlc_media_player_t
*p_mi
);
85 del_es_callbacks( input_thread_t
*p_input_thread
, libvlc_media_player_t
*p_mi
);
88 snapshot_was_taken( vlc_object_t
*p_this
, char const *psz_cmd
,
89 vlc_value_t oldval
, vlc_value_t newval
, void *p_data
);
91 static void libvlc_media_player_destroy( libvlc_media_player_t
*p_mi
);
98 * The input lock protects the input and input resource pointer.
99 * It MUST NOT be used from callbacks.
101 * The object lock protects the reset, namely the media and the player state.
102 * It can, and usually needs to be taken from callbacks.
103 * The object lock can be acquired under the input lock... and consequently
104 * the opposite order is STRICTLY PROHIBITED.
106 static inline void lock(libvlc_media_player_t
*mp
)
108 vlc_mutex_lock(&mp
->object_lock
);
111 static inline void unlock(libvlc_media_player_t
*mp
)
113 vlc_mutex_unlock(&mp
->object_lock
);
116 static inline void lock_input(libvlc_media_player_t
*mp
)
118 vlc_mutex_lock(&mp
->input
.lock
);
121 static inline void unlock_input(libvlc_media_player_t
*mp
)
123 vlc_mutex_unlock(&mp
->input
.lock
);
126 static void input_item_preparsed_changed( const vlc_event_t
*p_event
,
129 libvlc_media_t
*p_md
= user_data
;
130 if( p_event
->u
.input_item_preparsed_changed
.new_status
& ITEM_PREPARSED
)
133 libvlc_event_t event
;
134 event
.type
= libvlc_MediaParsedChanged
;
135 event
.u
.media_parsed_changed
.new_status
= libvlc_media_parsed_status_done
;
136 libvlc_event_send( &p_md
->event_manager
, &event
);
140 static void media_attach_preparsed_event( libvlc_media_t
*p_md
)
142 vlc_event_attach( &p_md
->p_input_item
->event_manager
,
143 vlc_InputItemPreparsedChanged
,
144 input_item_preparsed_changed
, p_md
);
147 static void media_detach_preparsed_event( libvlc_media_t
*p_md
)
149 vlc_event_detach( &p_md
->p_input_item
->event_manager
,
150 vlc_InputItemPreparsedChanged
,
151 input_item_preparsed_changed
,
156 * Release the associated input thread.
158 * Object lock is NOT held.
159 * Input lock is held or instance is being destroyed.
161 static void release_input_thread( libvlc_media_player_t
*p_mi
)
165 input_thread_t
*p_input_thread
= p_mi
->input
.p_thread
;
166 if( !p_input_thread
)
168 p_mi
->input
.p_thread
= NULL
;
170 media_detach_preparsed_event( p_mi
->p_md
);
172 var_DelCallback( p_input_thread
, "can-seek",
173 input_seekable_changed
, p_mi
);
174 var_DelCallback( p_input_thread
, "can-pause",
175 input_pausable_changed
, p_mi
);
176 var_DelCallback( p_input_thread
, "program-scrambled",
177 input_scrambled_changed
, p_mi
);
178 var_DelCallback( p_input_thread
, "intf-event",
179 input_event_changed
, p_mi
);
180 del_es_callbacks( p_input_thread
, p_mi
);
182 /* We owned this one */
183 input_Stop( p_input_thread
);
184 input_Close( p_input_thread
);
188 * Retrieve the input thread. Be sure to release the object
189 * once you are done with it. (libvlc Internal)
191 input_thread_t
*libvlc_get_input_thread( libvlc_media_player_t
*p_mi
)
193 input_thread_t
*p_input_thread
;
198 p_input_thread
= p_mi
->input
.p_thread
;
200 vlc_object_hold( p_input_thread
);
202 libvlc_printerr( "No active input" );
205 return p_input_thread
;
209 * Set the internal state of the media_player. (media player Internal)
211 * Function will lock the media_player.
213 static void set_state( libvlc_media_player_t
*p_mi
, libvlc_state_t state
,
220 libvlc_media_t
*media
= p_mi
->p_md
;
222 libvlc_media_retain(media
);
229 // Also set the state of the corresponding media
230 // This is strictly for convenience.
231 libvlc_media_set_state(media
, state
);
233 libvlc_media_release(media
);
238 input_seekable_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_MediaPlayerSeekableChanged
;
249 event
.u
.media_player_seekable_changed
.new_seekable
= newval
.b_bool
;
251 libvlc_event_send( &p_mi
->event_manager
, &event
);
256 input_pausable_changed( vlc_object_t
* p_this
, char const * psz_cmd
,
257 vlc_value_t oldval
, vlc_value_t newval
,
263 libvlc_media_player_t
* p_mi
= p_userdata
;
264 libvlc_event_t event
;
266 event
.type
= libvlc_MediaPlayerPausableChanged
;
267 event
.u
.media_player_pausable_changed
.new_pausable
= newval
.b_bool
;
269 libvlc_event_send( &p_mi
->event_manager
, &event
);
274 input_scrambled_changed( vlc_object_t
* p_this
, char const * psz_cmd
,
275 vlc_value_t oldval
, vlc_value_t newval
,
281 libvlc_media_player_t
* p_mi
= p_userdata
;
282 libvlc_event_t event
;
284 event
.type
= libvlc_MediaPlayerScrambledChanged
;
285 event
.u
.media_player_scrambled_changed
.new_scrambled
= newval
.b_bool
;
287 libvlc_event_send( &p_mi
->event_manager
, &event
);
292 input_event_changed( vlc_object_t
* p_this
, char const * psz_cmd
,
293 vlc_value_t oldval
, vlc_value_t newval
,
296 VLC_UNUSED(oldval
); VLC_UNUSED(psz_cmd
);
297 input_thread_t
* p_input
= (input_thread_t
*)p_this
;
298 libvlc_media_player_t
* p_mi
= p_userdata
;
299 libvlc_event_t event
;
301 assert( !strcmp( psz_cmd
, "intf-event" ) );
303 if( newval
.i_int
== INPUT_EVENT_STATE
)
305 libvlc_state_t libvlc_state
;
307 switch ( var_GetInteger( p_input
, "state" ) )
310 libvlc_state
= libvlc_NothingSpecial
;
311 event
.type
= libvlc_MediaPlayerNothingSpecial
;
314 libvlc_state
= libvlc_Opening
;
315 event
.type
= libvlc_MediaPlayerOpening
;
318 libvlc_state
= libvlc_Playing
;
319 event
.type
= libvlc_MediaPlayerPlaying
;
322 libvlc_state
= libvlc_Paused
;
323 event
.type
= libvlc_MediaPlayerPaused
;
326 libvlc_state
= libvlc_Ended
;
327 event
.type
= libvlc_MediaPlayerEndReached
;
330 libvlc_state
= libvlc_Error
;
331 event
.type
= libvlc_MediaPlayerEncounteredError
;
338 set_state( p_mi
, libvlc_state
, false );
339 libvlc_event_send( &p_mi
->event_manager
, &event
);
341 else if( newval
.i_int
== INPUT_EVENT_DEAD
)
343 libvlc_state_t libvlc_state
= libvlc_Ended
;
344 event
.type
= libvlc_MediaPlayerStopped
;
346 set_state( p_mi
, libvlc_state
, false );
347 libvlc_event_send( &p_mi
->event_manager
, &event
);
349 else if( newval
.i_int
== INPUT_EVENT_POSITION
)
351 if( var_GetInteger( p_input
, "state" ) != PLAYING_S
)
352 return VLC_SUCCESS
; /* Don't send the position while stopped */
355 event
.type
= libvlc_MediaPlayerPositionChanged
;
356 event
.u
.media_player_position_changed
.new_position
=
357 var_GetFloat( p_input
, "position" );
358 libvlc_event_send( &p_mi
->event_manager
, &event
);
361 event
.type
= libvlc_MediaPlayerTimeChanged
;
362 event
.u
.media_player_time_changed
.new_time
=
363 from_mtime(var_GetInteger( p_input
, "time" ));
364 libvlc_event_send( &p_mi
->event_manager
, &event
);
366 else if( newval
.i_int
== INPUT_EVENT_LENGTH
)
368 event
.type
= libvlc_MediaPlayerLengthChanged
;
369 event
.u
.media_player_length_changed
.new_length
=
370 from_mtime(var_GetInteger( p_input
, "length" ));
371 libvlc_event_send( &p_mi
->event_manager
, &event
);
373 else if( newval
.i_int
== INPUT_EVENT_CACHE
)
375 event
.type
= libvlc_MediaPlayerBuffering
;
376 event
.u
.media_player_buffering
.new_cache
= (100 *
377 var_GetFloat( p_input
, "cache" ));
378 libvlc_event_send( &p_mi
->event_manager
, &event
);
380 else if( newval
.i_int
== INPUT_EVENT_VOUT
)
382 vout_thread_t
**pp_vout
;
384 if( input_Control( p_input
, INPUT_GET_VOUTS
, &pp_vout
, &i_vout
) )
390 for( size_t i
= 0; i
< i_vout
; i
++ )
391 vlc_object_release( pp_vout
[i
] );
395 event
.type
= libvlc_MediaPlayerVout
;
396 event
.u
.media_player_vout
.new_count
= i_vout
;
397 libvlc_event_send( &p_mi
->event_manager
, &event
);
399 else if ( newval
.i_int
== INPUT_EVENT_TITLE
)
401 event
.type
= libvlc_MediaPlayerTitleChanged
;
402 event
.u
.media_player_title_changed
.new_title
= var_GetInteger( p_input
, "title" );
403 libvlc_event_send( &p_mi
->event_manager
, &event
);
405 else if ( newval
.i_int
== INPUT_EVENT_CHAPTER
)
407 event
.type
= libvlc_MediaPlayerChapterChanged
;
408 event
.u
.media_player_chapter_changed
.new_chapter
= var_GetInteger( p_input
, "chapter" );
409 libvlc_event_send( &p_mi
->event_manager
, &event
);
411 else if ( newval
.i_int
== INPUT_EVENT_ES
)
413 /* Send ESSelected events from this callback ("intf-event") and not
414 * from "audio-es", "video-es", "spu-es" callbacks. Indeed, these
415 * callbacks are not triggered when the input_thread changes an ES
416 * while this callback is. */
418 const char *psz_name
;
419 const libvlc_track_type_t type
;
422 { "audio-es", libvlc_track_audio
, ES_INIT
},
423 { "video-es", libvlc_track_video
, ES_INIT
},
424 { "spu-es", libvlc_track_text
, ES_INIT
},
426 /* Check if an ES selection changed */
428 for( size_t i
= 0; i
< ARRAY_SIZE( es_list
); ++i
)
430 int current_es
= var_GetInteger( p_input
, es_list
[i
].psz_name
);
431 if( current_es
!= p_mi
->selected_es
[i
] )
432 es_list
[i
].new_es
= p_mi
->selected_es
[i
] = current_es
;
436 /* Send the ESSelected event for each ES that were newly selected */
437 for( size_t i
= 0; i
< ARRAY_SIZE( es_list
); ++i
)
439 if( es_list
[i
].new_es
!= ES_INIT
)
441 event
.type
= libvlc_MediaPlayerESSelected
;
442 event
.u
.media_player_es_changed
.i_type
= es_list
[i
].type
;
443 event
.u
.media_player_es_changed
.i_id
= es_list
[i
].new_es
;
444 libvlc_event_send( &p_mi
->event_manager
, &event
);
452 static int track_type_from_name(const char *psz_name
)
454 if( !strcmp( psz_name
, "video-es" ) )
455 return libvlc_track_video
;
456 else if( !strcmp( psz_name
, "audio-es" ) )
457 return libvlc_track_audio
;
458 else if( !strcmp( psz_name
, "spu-es" ) )
459 return libvlc_track_text
;
461 return libvlc_track_unknown
;
464 static int input_es_changed( vlc_object_t
*p_this
,
471 libvlc_media_player_t
*mp
= p_userdata
;
472 libvlc_event_t event
;
474 /* Ignore the "Disable" element */
475 if (p_val
&& p_val
->i_int
< 0)
480 case VLC_VAR_ADDCHOICE
:
481 event
.type
= libvlc_MediaPlayerESAdded
;
483 case VLC_VAR_DELCHOICE
:
484 case VLC_VAR_CLEARCHOICES
:
485 event
.type
= libvlc_MediaPlayerESDeleted
;
491 event
.u
.media_player_es_changed
.i_type
= track_type_from_name(psz_cmd
);
494 if (action
!= VLC_VAR_CLEARCHOICES
)
502 /* -1 means all ES tracks of this type were deleted. */
505 event
.u
.media_player_es_changed
.i_id
= i_id
;
507 libvlc_event_send(&mp
->event_manager
, &event
);
512 /**************************************************************************
513 * Snapshot Taken Event.
515 * FIXME: This snapshot API interface makes no sense in media_player.
516 *************************************************************************/
517 static int snapshot_was_taken(vlc_object_t
*p_this
, char const *psz_cmd
,
518 vlc_value_t oldval
, vlc_value_t newval
, void *p_data
)
520 VLC_UNUSED(psz_cmd
); VLC_UNUSED(oldval
); VLC_UNUSED(p_this
);
522 libvlc_media_player_t
*mp
= p_data
;
523 libvlc_event_t event
;
524 event
.type
= libvlc_MediaPlayerSnapshotTaken
;
525 event
.u
.media_player_snapshot_taken
.psz_filename
= newval
.psz_string
;
526 libvlc_event_send(&mp
->event_manager
, &event
);
531 static int corks_changed(vlc_object_t
*obj
, const char *name
, vlc_value_t old
,
532 vlc_value_t cur
, void *opaque
)
534 libvlc_media_player_t
*mp
= (libvlc_media_player_t
*)obj
;
536 if (!old
.i_int
!= !cur
.i_int
)
538 libvlc_event_t event
;
540 event
.type
= cur
.i_int
? libvlc_MediaPlayerCorked
541 : libvlc_MediaPlayerUncorked
;
542 libvlc_event_send(&mp
->event_manager
, &event
);
544 VLC_UNUSED(name
); VLC_UNUSED(opaque
);
548 static int audio_device_changed(vlc_object_t
*obj
, const char *name
,
549 vlc_value_t old
, vlc_value_t cur
, void *opaque
)
551 libvlc_media_player_t
*mp
= (libvlc_media_player_t
*)obj
;
552 libvlc_event_t event
;
554 event
.type
= libvlc_MediaPlayerAudioDevice
;
555 event
.u
.media_player_audio_device
.device
= cur
.psz_string
;
556 libvlc_event_send(&mp
->event_manager
, &event
);
557 VLC_UNUSED(name
); VLC_UNUSED(old
); VLC_UNUSED(opaque
);
561 static int mute_changed(vlc_object_t
*obj
, const char *name
, vlc_value_t old
,
562 vlc_value_t cur
, void *opaque
)
564 libvlc_media_player_t
*mp
= (libvlc_media_player_t
*)obj
;
566 if (old
.b_bool
!= cur
.b_bool
)
568 libvlc_event_t event
;
570 event
.type
= cur
.b_bool
? libvlc_MediaPlayerMuted
571 : libvlc_MediaPlayerUnmuted
;
572 libvlc_event_send(&mp
->event_manager
, &event
);
574 VLC_UNUSED(name
); VLC_UNUSED(opaque
);
578 static int volume_changed(vlc_object_t
*obj
, const char *name
, vlc_value_t old
,
579 vlc_value_t cur
, void *opaque
)
581 libvlc_media_player_t
*mp
= (libvlc_media_player_t
*)obj
;
582 libvlc_event_t event
;
584 event
.type
= libvlc_MediaPlayerAudioVolume
;
585 event
.u
.media_player_audio_volume
.volume
= cur
.f_float
;
586 libvlc_event_send(&mp
->event_manager
, &event
);
587 VLC_UNUSED(name
); VLC_UNUSED(old
); VLC_UNUSED(opaque
);
591 /**************************************************************************
592 * Create a Media Instance object.
595 * - All items created by _new start with a refcount set to 1.
596 * - Accessor _release decrease the refcount by 1, if after that
597 * operation the refcount is 0, the object is destroyed.
598 * - Accessor _retain increase the refcount by 1 (XXX: to implement)
600 * Object locking strategy:
601 * - No lock held while in constructor.
602 * - When accessing any member variable this lock is held. (XXX who locks?)
603 * - When attempting to destroy the object the lock is also held.
604 **************************************************************************/
605 libvlc_media_player_t
*
606 libvlc_media_player_new( libvlc_instance_t
*instance
)
608 libvlc_media_player_t
* mp
;
612 mp
= vlc_object_create (instance
->p_libvlc_int
, sizeof(*mp
));
613 if (unlikely(mp
== NULL
))
615 libvlc_printerr("Not enough memory");
620 var_Create (mp
, "rate", VLC_VAR_FLOAT
|VLC_VAR_DOINHERIT
);
621 var_Create (mp
, "sout", VLC_VAR_STRING
);
622 var_Create (mp
, "demux-filter", VLC_VAR_STRING
);
625 var_Create (mp
, "vout", VLC_VAR_STRING
|VLC_VAR_DOINHERIT
);
626 var_Create (mp
, "window", VLC_VAR_STRING
);
627 var_Create (mp
, "vmem-lock", VLC_VAR_ADDRESS
);
628 var_Create (mp
, "vmem-unlock", VLC_VAR_ADDRESS
);
629 var_Create (mp
, "vmem-display", VLC_VAR_ADDRESS
);
630 var_Create (mp
, "vmem-data", VLC_VAR_ADDRESS
);
631 var_Create (mp
, "vmem-setup", VLC_VAR_ADDRESS
);
632 var_Create (mp
, "vmem-cleanup", VLC_VAR_ADDRESS
);
633 var_Create (mp
, "vmem-chroma", VLC_VAR_STRING
| VLC_VAR_DOINHERIT
);
634 var_Create (mp
, "vmem-width", VLC_VAR_INTEGER
| VLC_VAR_DOINHERIT
);
635 var_Create (mp
, "vmem-height", VLC_VAR_INTEGER
| VLC_VAR_DOINHERIT
);
636 var_Create (mp
, "vmem-pitch", VLC_VAR_INTEGER
| VLC_VAR_DOINHERIT
);
637 var_Create (mp
, "avcodec-hw", VLC_VAR_STRING
);
638 var_Create (mp
, "drawable-xid", VLC_VAR_INTEGER
);
639 #if defined (_WIN32) || defined (__OS2__)
640 var_Create (mp
, "drawable-hwnd", VLC_VAR_INTEGER
);
643 var_Create (mp
, "drawable-nsobject", VLC_VAR_ADDRESS
);
646 var_Create (mp
, "drawable-androidwindow", VLC_VAR_ADDRESS
);
649 var_Create (mp
, "drawable-evasobject", VLC_VAR_ADDRESS
);
652 var_Create (mp
, "keyboard-events", VLC_VAR_BOOL
);
653 var_SetBool (mp
, "keyboard-events", true);
654 var_Create (mp
, "mouse-events", VLC_VAR_BOOL
);
655 var_SetBool (mp
, "mouse-events", true);
657 var_Create (mp
, "fullscreen", VLC_VAR_BOOL
);
658 var_Create (mp
, "autoscale", VLC_VAR_BOOL
| VLC_VAR_DOINHERIT
);
659 var_Create (mp
, "zoom", VLC_VAR_FLOAT
| VLC_VAR_DOINHERIT
);
660 var_Create (mp
, "aspect-ratio", VLC_VAR_STRING
);
661 var_Create (mp
, "crop", VLC_VAR_STRING
);
662 var_Create (mp
, "deinterlace", VLC_VAR_INTEGER
| VLC_VAR_DOINHERIT
);
663 var_Create (mp
, "deinterlace-mode", VLC_VAR_STRING
| VLC_VAR_DOINHERIT
);
665 var_Create (mp
, "vbi-page", VLC_VAR_INTEGER
);
666 var_SetInteger (mp
, "vbi-page", 0);
668 var_Create (mp
, "video-filter", VLC_VAR_STRING
| VLC_VAR_DOINHERIT
);
669 var_Create (mp
, "sub-source", VLC_VAR_STRING
| VLC_VAR_DOINHERIT
);
670 var_Create (mp
, "sub-filter", VLC_VAR_STRING
| VLC_VAR_DOINHERIT
);
672 var_Create (mp
, "marq-marquee", VLC_VAR_STRING
);
673 var_Create (mp
, "marq-color", VLC_VAR_INTEGER
| VLC_VAR_DOINHERIT
);
674 var_Create (mp
, "marq-opacity", VLC_VAR_INTEGER
| VLC_VAR_DOINHERIT
);
675 var_Create (mp
, "marq-position", VLC_VAR_INTEGER
| VLC_VAR_DOINHERIT
);
676 var_Create (mp
, "marq-refresh", VLC_VAR_INTEGER
| VLC_VAR_DOINHERIT
);
677 var_Create (mp
, "marq-size", VLC_VAR_INTEGER
| VLC_VAR_DOINHERIT
);
678 var_Create (mp
, "marq-timeout", VLC_VAR_INTEGER
| VLC_VAR_DOINHERIT
);
679 var_Create (mp
, "marq-x", VLC_VAR_INTEGER
| VLC_VAR_DOINHERIT
);
680 var_Create (mp
, "marq-y", VLC_VAR_INTEGER
| VLC_VAR_DOINHERIT
);
682 var_Create (mp
, "logo-file", VLC_VAR_STRING
);
683 var_Create (mp
, "logo-x", VLC_VAR_INTEGER
| VLC_VAR_DOINHERIT
);
684 var_Create (mp
, "logo-y", VLC_VAR_INTEGER
| VLC_VAR_DOINHERIT
);
685 var_Create (mp
, "logo-delay", VLC_VAR_INTEGER
| VLC_VAR_DOINHERIT
);
686 var_Create (mp
, "logo-repeat", VLC_VAR_INTEGER
| VLC_VAR_DOINHERIT
);
687 var_Create (mp
, "logo-opacity", VLC_VAR_INTEGER
| VLC_VAR_DOINHERIT
);
688 var_Create (mp
, "logo-position", VLC_VAR_INTEGER
| VLC_VAR_DOINHERIT
);
690 var_Create (mp
, "contrast", VLC_VAR_FLOAT
| VLC_VAR_DOINHERIT
);
691 var_Create (mp
, "brightness", VLC_VAR_FLOAT
| VLC_VAR_DOINHERIT
);
692 var_Create (mp
, "hue", VLC_VAR_FLOAT
| VLC_VAR_DOINHERIT
);
693 var_Create (mp
, "saturation", VLC_VAR_FLOAT
| VLC_VAR_DOINHERIT
);
694 var_Create (mp
, "gamma", VLC_VAR_FLOAT
| VLC_VAR_DOINHERIT
);
697 var_Create (mp
, "aout", VLC_VAR_STRING
| VLC_VAR_DOINHERIT
);
698 var_Create (mp
, "audio-device", VLC_VAR_STRING
);
699 var_Create (mp
, "mute", VLC_VAR_BOOL
);
700 var_Create (mp
, "volume", VLC_VAR_FLOAT
);
701 var_Create (mp
, "corks", VLC_VAR_INTEGER
);
702 var_Create (mp
, "audio-filter", VLC_VAR_STRING
);
703 var_Create (mp
, "role", VLC_VAR_STRING
| VLC_VAR_DOINHERIT
);
704 var_Create (mp
, "amem-data", VLC_VAR_ADDRESS
);
705 var_Create (mp
, "amem-setup", VLC_VAR_ADDRESS
);
706 var_Create (mp
, "amem-cleanup", VLC_VAR_ADDRESS
);
707 var_Create (mp
, "amem-play", VLC_VAR_ADDRESS
);
708 var_Create (mp
, "amem-pause", VLC_VAR_ADDRESS
);
709 var_Create (mp
, "amem-resume", VLC_VAR_ADDRESS
);
710 var_Create (mp
, "amem-flush", VLC_VAR_ADDRESS
);
711 var_Create (mp
, "amem-drain", VLC_VAR_ADDRESS
);
712 var_Create (mp
, "amem-set-volume", VLC_VAR_ADDRESS
);
713 var_Create (mp
, "amem-format", VLC_VAR_STRING
| VLC_VAR_DOINHERIT
);
714 var_Create (mp
, "amem-rate", VLC_VAR_INTEGER
| VLC_VAR_DOINHERIT
);
715 var_Create (mp
, "amem-channels", VLC_VAR_INTEGER
| VLC_VAR_DOINHERIT
);
718 var_Create (mp
, "video-title-show", VLC_VAR_BOOL
);
719 var_Create (mp
, "video-title-position", VLC_VAR_INTEGER
);
720 var_Create (mp
, "video-title-timeout", VLC_VAR_INTEGER
);
723 var_Create (mp
, "equalizer-preamp", VLC_VAR_FLOAT
);
724 var_Create (mp
, "equalizer-vlcfreqs", VLC_VAR_BOOL
);
725 var_Create (mp
, "equalizer-bands", VLC_VAR_STRING
);
728 mp
->state
= libvlc_NothingSpecial
;
729 mp
->p_libvlc_instance
= instance
;
730 mp
->input
.p_thread
= NULL
;
731 mp
->input
.p_resource
= input_resource_New(VLC_OBJECT(mp
));
732 if (unlikely(mp
->input
.p_resource
== NULL
))
734 vlc_object_release(mp
);
737 audio_output_t
*aout
= input_resource_GetAout(mp
->input
.p_resource
);
739 input_resource_PutAout(mp
->input
.p_resource
, aout
);
741 vlc_viewpoint_init(&mp
->viewpoint
);
743 var_Create (mp
, "viewpoint", VLC_VAR_ADDRESS
);
744 var_SetAddress( mp
, "viewpoint", &mp
->viewpoint
);
745 vlc_mutex_init (&mp
->input
.lock
);
747 libvlc_event_manager_init(&mp
->event_manager
, mp
);
748 vlc_mutex_init(&mp
->object_lock
);
750 var_AddCallback(mp
, "corks", corks_changed
, NULL
);
751 var_AddCallback(mp
, "audio-device", audio_device_changed
, NULL
);
752 var_AddCallback(mp
, "mute", mute_changed
, NULL
);
753 var_AddCallback(mp
, "volume", volume_changed
, NULL
);
755 /* Snapshot initialization */
756 /* Attach a var callback to the global object to provide the glue between
757 * vout_thread that generates the event and media_player that re-emits it
758 * with its own event manager
760 * FIXME: It's unclear why we want to put this in public API, and why we
761 * want to expose it in such a limiting and ugly way.
763 var_AddCallback(mp
->obj
.libvlc
, "snapshot-file", snapshot_was_taken
, mp
);
765 libvlc_retain(instance
);
769 /**************************************************************************
770 * Create a Media Instance object with a media descriptor.
771 **************************************************************************/
772 libvlc_media_player_t
*
773 libvlc_media_player_new_from_media( libvlc_media_t
* p_md
)
775 libvlc_media_player_t
* p_mi
;
777 p_mi
= libvlc_media_player_new( p_md
->p_libvlc_instance
);
781 libvlc_media_retain( p_md
);
787 /**************************************************************************
788 * Destroy a Media Instance object (libvlc internal)
790 * Warning: No lock held here, but hey, this is internal. Caller must lock.
791 **************************************************************************/
792 static void libvlc_media_player_destroy( libvlc_media_player_t
*p_mi
)
796 /* Detach Callback from the main libvlc object */
797 var_DelCallback( p_mi
->obj
.libvlc
,
798 "snapshot-file", snapshot_was_taken
, p_mi
);
800 /* Detach callback from the media player / input manager object */
801 var_DelCallback( p_mi
, "volume", volume_changed
, NULL
);
802 var_DelCallback( p_mi
, "mute", mute_changed
, NULL
);
803 var_DelCallback( p_mi
, "audio-device", audio_device_changed
, NULL
);
804 var_DelCallback( p_mi
, "corks", corks_changed
, NULL
);
806 /* No need for lock_input() because no other threads knows us anymore */
807 if( p_mi
->input
.p_thread
)
808 release_input_thread(p_mi
);
809 input_resource_Terminate( p_mi
->input
.p_resource
);
810 input_resource_Release( p_mi
->input
.p_resource
);
811 vlc_mutex_destroy( &p_mi
->input
.lock
);
813 libvlc_event_manager_destroy(&p_mi
->event_manager
);
814 libvlc_media_release( p_mi
->p_md
);
815 vlc_mutex_destroy( &p_mi
->object_lock
);
817 libvlc_instance_t
*instance
= p_mi
->p_libvlc_instance
;
818 vlc_object_release( p_mi
);
819 libvlc_release(instance
);
822 /**************************************************************************
823 * Release a Media Instance object.
825 * Function does the locking.
826 **************************************************************************/
827 void libvlc_media_player_release( libvlc_media_player_t
*p_mi
)
833 destroy
= !--p_mi
->i_refcount
;
837 libvlc_media_player_destroy( p_mi
);
840 /**************************************************************************
841 * Retain a Media Instance object.
843 * Caller must hold the lock.
844 **************************************************************************/
845 void libvlc_media_player_retain( libvlc_media_player_t
*p_mi
)
854 /**************************************************************************
855 * Set the Media descriptor associated with the instance.
857 * Enter without lock -- function will lock the object.
858 **************************************************************************/
859 void libvlc_media_player_set_media(
860 libvlc_media_player_t
*p_mi
,
861 libvlc_media_t
*p_md
)
865 release_input_thread( p_mi
);
868 set_state( p_mi
, libvlc_NothingSpecial
, true );
869 unlock_input( p_mi
);
871 libvlc_media_release( p_mi
->p_md
);
877 return; /* It is ok to pass a NULL md */
880 libvlc_media_retain( p_md
);
883 /* The policy here is to ignore that we were created using a different
884 * libvlc_instance, because we don't really care */
885 p_mi
->p_libvlc_instance
= p_md
->p_libvlc_instance
;
889 /* Send an event for the newly available media */
890 libvlc_event_t event
;
891 event
.type
= libvlc_MediaPlayerMediaChanged
;
892 event
.u
.media_player_media_changed
.new_media
= p_md
;
893 libvlc_event_send( &p_mi
->event_manager
, &event
);
897 /**************************************************************************
898 * Get the Media descriptor associated with the instance.
899 **************************************************************************/
901 libvlc_media_player_get_media( libvlc_media_player_t
*p_mi
)
908 libvlc_media_retain( p_m
);
914 /**************************************************************************
915 * Get the event Manager.
916 **************************************************************************/
917 libvlc_event_manager_t
*
918 libvlc_media_player_event_manager( libvlc_media_player_t
*p_mi
)
920 return &p_mi
->event_manager
;
923 static void add_es_callbacks( input_thread_t
*p_input_thread
, libvlc_media_player_t
*p_mi
)
925 var_AddListCallback( p_input_thread
, "video-es", input_es_changed
, p_mi
);
926 var_AddListCallback( p_input_thread
, "audio-es", input_es_changed
, p_mi
);
927 var_AddListCallback( p_input_thread
, "spu-es", input_es_changed
, p_mi
);
930 static void del_es_callbacks( input_thread_t
*p_input_thread
, libvlc_media_player_t
*p_mi
)
932 var_DelListCallback( p_input_thread
, "video-es", input_es_changed
, p_mi
);
933 var_DelListCallback( p_input_thread
, "audio-es", input_es_changed
, p_mi
);
934 var_DelListCallback( p_input_thread
, "spu-es", input_es_changed
, p_mi
);
937 /**************************************************************************
938 * Tell media player to start playing.
939 **************************************************************************/
940 int libvlc_media_player_play( libvlc_media_player_t
*p_mi
)
944 input_thread_t
*p_input_thread
= p_mi
->input
.p_thread
;
947 /* A thread already exists, send it a play message */
948 input_Control( p_input_thread
, INPUT_SET_STATE
, PLAYING_S
);
949 unlock_input( p_mi
);
953 /* Ignore previous exception */
959 unlock_input( p_mi
);
960 libvlc_printerr( "No associated media descriptor" );
964 for( size_t i
= 0; i
< ARRAY_SIZE( p_mi
->selected_es
); ++i
)
965 p_mi
->selected_es
[i
] = ES_INIT
;
967 media_attach_preparsed_event( p_mi
->p_md
);
969 p_input_thread
= input_Create( p_mi
, p_mi
->p_md
->p_input_item
, NULL
,
970 p_mi
->input
.p_resource
);
972 if( !p_input_thread
)
975 media_detach_preparsed_event( p_mi
->p_md
);
976 libvlc_printerr( "Not enough memory" );
980 var_AddCallback( p_input_thread
, "can-seek", input_seekable_changed
, p_mi
);
981 var_AddCallback( p_input_thread
, "can-pause", input_pausable_changed
, p_mi
);
982 var_AddCallback( p_input_thread
, "program-scrambled", input_scrambled_changed
, p_mi
);
983 var_AddCallback( p_input_thread
, "intf-event", input_event_changed
, p_mi
);
984 add_es_callbacks( p_input_thread
, p_mi
);
986 if( input_Start( p_input_thread
) )
989 del_es_callbacks( p_input_thread
, p_mi
);
990 var_DelCallback( p_input_thread
, "intf-event", input_event_changed
, p_mi
);
991 var_DelCallback( p_input_thread
, "can-pause", input_pausable_changed
, p_mi
);
992 var_DelCallback( p_input_thread
, "program-scrambled", input_scrambled_changed
, p_mi
);
993 var_DelCallback( p_input_thread
, "can-seek", input_seekable_changed
, p_mi
);
994 input_Close( p_input_thread
);
995 media_detach_preparsed_event( p_mi
->p_md
);
996 libvlc_printerr( "Input initialization failure" );
999 p_mi
->input
.p_thread
= p_input_thread
;
1004 void libvlc_media_player_set_pause( libvlc_media_player_t
*p_mi
, int paused
)
1006 input_thread_t
* p_input_thread
= libvlc_get_input_thread( p_mi
);
1007 if( !p_input_thread
)
1010 libvlc_state_t state
= libvlc_media_player_get_state( p_mi
);
1011 if( state
== libvlc_Playing
)
1015 if( libvlc_media_player_can_pause( p_mi
) )
1016 input_Control( p_input_thread
, INPUT_SET_STATE
, PAUSE_S
);
1018 input_Stop( p_input_thread
);
1024 input_Control( p_input_thread
, INPUT_SET_STATE
, PLAYING_S
);
1027 vlc_object_release( p_input_thread
);
1030 /**************************************************************************
1032 **************************************************************************/
1033 void libvlc_media_player_pause( libvlc_media_player_t
*p_mi
)
1035 libvlc_media_player_set_pause( p_mi
, libvlc_media_player_is_playing( p_mi
) );
1038 /**************************************************************************
1039 * Tells whether the media player is currently playing.
1040 **************************************************************************/
1041 int libvlc_media_player_is_playing( libvlc_media_player_t
*p_mi
)
1043 libvlc_state_t state
= libvlc_media_player_get_state( p_mi
);
1044 return libvlc_Playing
== state
;
1047 /**************************************************************************
1049 **************************************************************************/
1050 void libvlc_media_player_stop( libvlc_media_player_t
*p_mi
)
1053 release_input_thread( p_mi
); /* This will stop the input thread */
1055 /* Force to go to stopped state, in case we were in Ended, or Error
1057 if( p_mi
->state
!= libvlc_Stopped
)
1059 set_state( p_mi
, libvlc_Stopped
, false );
1061 /* Construct and send the event */
1062 libvlc_event_t event
;
1063 event
.type
= libvlc_MediaPlayerStopped
;
1064 libvlc_event_send( &p_mi
->event_manager
, &event
);
1067 input_resource_Terminate( p_mi
->input
.p_resource
);
1071 int libvlc_media_player_set_renderer( libvlc_media_player_t
*p_mi
,
1072 const libvlc_renderer_item_t
*p_litem
)
1074 const vlc_renderer_item_t
*p_item
= libvlc_renderer_item_to_vlc( p_litem
);
1076 if( asprintf( &psz_sout
, "#%s", vlc_renderer_item_sout( p_item
) ) == -1 )
1079 var_SetString( p_mi
, "sout", psz_sout
);
1080 var_SetString( p_mi
, "demux-filter", vlc_renderer_item_demux_filter( p_item
) );
1085 void libvlc_video_set_callbacks( libvlc_media_player_t
*mp
,
1086 void *(*lock_cb
) (void *, void **),
1087 void (*unlock_cb
) (void *, void *, void *const *),
1088 void (*display_cb
) (void *, void *),
1091 var_SetAddress( mp
, "vmem-lock", lock_cb
);
1092 var_SetAddress( mp
, "vmem-unlock", unlock_cb
);
1093 var_SetAddress( mp
, "vmem-display", display_cb
);
1094 var_SetAddress( mp
, "vmem-data", opaque
);
1095 var_SetString( mp
, "avcodec-hw", "none" );
1096 var_SetString( mp
, "vout", "vmem" );
1097 var_SetString( mp
, "window", "none" );
1100 void libvlc_video_set_format_callbacks( libvlc_media_player_t
*mp
,
1101 libvlc_video_format_cb setup
,
1102 libvlc_video_cleanup_cb cleanup
)
1104 var_SetAddress( mp
, "vmem-setup", setup
);
1105 var_SetAddress( mp
, "vmem-cleanup", cleanup
);
1108 void libvlc_video_set_format( libvlc_media_player_t
*mp
, const char *chroma
,
1109 unsigned width
, unsigned height
, unsigned pitch
)
1111 var_SetString( mp
, "vmem-chroma", chroma
);
1112 var_SetInteger( mp
, "vmem-width", width
);
1113 var_SetInteger( mp
, "vmem-height", height
);
1114 var_SetInteger( mp
, "vmem-pitch", pitch
);
1117 /**************************************************************************
1119 **************************************************************************/
1120 void libvlc_media_player_set_nsobject( libvlc_media_player_t
*p_mi
,
1123 assert (p_mi
!= NULL
);
1125 var_SetString (p_mi
, "avcodec-hw", "");
1126 var_SetString (p_mi
, "vout", "");
1127 var_SetString (p_mi
, "window", "");
1128 var_SetAddress (p_mi
, "drawable-nsobject", drawable
);
1131 libvlc_printerr ("can't set nsobject: APPLE build required");
1133 var_SetString (p_mi
, "vout", "none");
1134 var_SetString (p_mi
, "window", "none");
1138 /**************************************************************************
1140 **************************************************************************/
1141 void * libvlc_media_player_get_nsobject( libvlc_media_player_t
*p_mi
)
1143 assert (p_mi
!= NULL
);
1145 return var_GetAddress (p_mi
, "drawable-nsobject");
1152 /**************************************************************************
1154 **************************************************************************/
1155 void libvlc_media_player_set_agl( libvlc_media_player_t
*p_mi
,
1159 libvlc_printerr ("can't set agl: use libvlc_media_player_set_nsobject instead");
1161 var_SetString (p_mi
, "vout", "none");
1162 var_SetString (p_mi
, "window", "none");
1165 /**************************************************************************
1167 **************************************************************************/
1168 uint32_t libvlc_media_player_get_agl( libvlc_media_player_t
*p_mi
)
1174 /**************************************************************************
1176 **************************************************************************/
1177 void libvlc_media_player_set_xwindow( libvlc_media_player_t
*p_mi
,
1180 assert (p_mi
!= NULL
);
1182 var_SetString (p_mi
, "avcodec-hw", "");
1183 var_SetString (p_mi
, "vout", drawable
? "xid" : "");
1184 var_SetString (p_mi
, "window", drawable
? "embed-xid,any" : "");
1185 var_SetInteger (p_mi
, "drawable-xid", drawable
);
1188 /**************************************************************************
1190 **************************************************************************/
1191 uint32_t libvlc_media_player_get_xwindow( libvlc_media_player_t
*p_mi
)
1193 return var_GetInteger (p_mi
, "drawable-xid");
1196 /**************************************************************************
1198 **************************************************************************/
1199 void libvlc_media_player_set_hwnd( libvlc_media_player_t
*p_mi
,
1202 assert (p_mi
!= NULL
);
1203 #if defined (_WIN32) || defined (__OS2__)
1204 var_SetString (p_mi
, "avcodec-hw", "");
1205 var_SetString (p_mi
, "vout", "");
1206 var_SetString (p_mi
, "window",
1207 (drawable
!= NULL
) ? "embed-hwnd,any" : "");
1208 var_SetInteger (p_mi
, "drawable-hwnd", (uintptr_t)drawable
);
1211 libvlc_printerr ("can't set nsobject: WIN32 build required");
1213 var_SetString (p_mi
, "vout", "none");
1214 var_SetString (p_mi
, "window", "none");
1218 /**************************************************************************
1220 **************************************************************************/
1221 void *libvlc_media_player_get_hwnd( libvlc_media_player_t
*p_mi
)
1223 assert (p_mi
!= NULL
);
1224 #if defined (_WIN32) || defined (__OS2__)
1225 return (void *)(uintptr_t)var_GetInteger (p_mi
, "drawable-hwnd");
1232 /**************************************************************************
1233 * set_android_context
1234 **************************************************************************/
1235 void libvlc_media_player_set_android_context( libvlc_media_player_t
*p_mi
,
1236 void *p_awindow_handler
)
1238 assert (p_mi
!= NULL
);
1240 var_SetAddress (p_mi
, "drawable-androidwindow", p_awindow_handler
);
1242 (void) p_awindow_handler
;
1243 libvlc_printerr ("can't set android context: ANDROID build required");
1245 var_SetString (p_mi
, "vout", "none");
1246 var_SetString (p_mi
, "window", "none");
1250 /**************************************************************************
1252 **************************************************************************/
1253 int libvlc_media_player_set_evas_object( libvlc_media_player_t
*p_mi
,
1254 void *p_evas_object
)
1256 assert (p_mi
!= NULL
);
1258 var_SetString (p_mi
, "vout", "evas");
1259 var_SetString (p_mi
, "window", "none");
1260 var_SetAddress (p_mi
, "drawable-evasobject", p_evas_object
);
1263 (void) p_mi
; (void) p_evas_object
;
1268 void libvlc_audio_set_callbacks( libvlc_media_player_t
*mp
,
1269 libvlc_audio_play_cb play_cb
,
1270 libvlc_audio_pause_cb pause_cb
,
1271 libvlc_audio_resume_cb resume_cb
,
1272 libvlc_audio_flush_cb flush_cb
,
1273 libvlc_audio_drain_cb drain_cb
,
1276 var_SetAddress( mp
, "amem-play", play_cb
);
1277 var_SetAddress( mp
, "amem-pause", pause_cb
);
1278 var_SetAddress( mp
, "amem-resume", resume_cb
);
1279 var_SetAddress( mp
, "amem-flush", flush_cb
);
1280 var_SetAddress( mp
, "amem-drain", drain_cb
);
1281 var_SetAddress( mp
, "amem-data", opaque
);
1282 var_SetString( mp
, "aout", "amem,none" );
1284 input_resource_ResetAout(mp
->input
.p_resource
);
1287 void libvlc_audio_set_volume_callback( libvlc_media_player_t
*mp
,
1288 libvlc_audio_set_volume_cb cb
)
1290 var_SetAddress( mp
, "amem-set-volume", cb
);
1292 input_resource_ResetAout(mp
->input
.p_resource
);
1295 void libvlc_audio_set_format_callbacks( libvlc_media_player_t
*mp
,
1296 libvlc_audio_setup_cb setup
,
1297 libvlc_audio_cleanup_cb cleanup
)
1299 var_SetAddress( mp
, "amem-setup", setup
);
1300 var_SetAddress( mp
, "amem-cleanup", cleanup
);
1302 input_resource_ResetAout(mp
->input
.p_resource
);
1305 void libvlc_audio_set_format( libvlc_media_player_t
*mp
, const char *format
,
1306 unsigned rate
, unsigned channels
)
1308 var_SetString( mp
, "amem-format", format
);
1309 var_SetInteger( mp
, "amem-rate", rate
);
1310 var_SetInteger( mp
, "amem-channels", channels
);
1312 input_resource_ResetAout(mp
->input
.p_resource
);
1316 /**************************************************************************
1317 * Getters for stream information
1318 **************************************************************************/
1319 libvlc_time_t
libvlc_media_player_get_length(
1320 libvlc_media_player_t
*p_mi
)
1322 input_thread_t
*p_input_thread
;
1323 libvlc_time_t i_time
;
1325 p_input_thread
= libvlc_get_input_thread ( p_mi
);
1326 if( !p_input_thread
)
1329 i_time
= from_mtime(var_GetInteger( p_input_thread
, "length" ));
1330 vlc_object_release( p_input_thread
);
1335 libvlc_time_t
libvlc_media_player_get_time( libvlc_media_player_t
*p_mi
)
1337 input_thread_t
*p_input_thread
;
1338 libvlc_time_t i_time
;
1340 p_input_thread
= libvlc_get_input_thread ( p_mi
);
1341 if( !p_input_thread
)
1344 i_time
= from_mtime(var_GetInteger( p_input_thread
, "time" ));
1345 vlc_object_release( p_input_thread
);
1349 void libvlc_media_player_set_time( libvlc_media_player_t
*p_mi
,
1350 libvlc_time_t i_time
)
1352 input_thread_t
*p_input_thread
;
1354 p_input_thread
= libvlc_get_input_thread ( p_mi
);
1355 if( !p_input_thread
)
1358 var_SetInteger( p_input_thread
, "time", to_mtime(i_time
) );
1359 vlc_object_release( p_input_thread
);
1362 void libvlc_media_player_set_position( libvlc_media_player_t
*p_mi
,
1365 input_thread_t
*p_input_thread
;
1367 p_input_thread
= libvlc_get_input_thread ( p_mi
);
1368 if( !p_input_thread
)
1371 var_SetFloat( p_input_thread
, "position", position
);
1372 vlc_object_release( p_input_thread
);
1375 float libvlc_media_player_get_position( libvlc_media_player_t
*p_mi
)
1377 input_thread_t
*p_input_thread
;
1380 p_input_thread
= libvlc_get_input_thread ( p_mi
);
1381 if( !p_input_thread
)
1384 f_position
= var_GetFloat( p_input_thread
, "position" );
1385 vlc_object_release( p_input_thread
);
1390 void libvlc_media_player_set_chapter( libvlc_media_player_t
*p_mi
,
1393 input_thread_t
*p_input_thread
;
1395 p_input_thread
= libvlc_get_input_thread ( p_mi
);
1396 if( !p_input_thread
)
1399 var_SetInteger( p_input_thread
, "chapter", chapter
);
1400 vlc_object_release( p_input_thread
);
1403 int libvlc_media_player_get_chapter( libvlc_media_player_t
*p_mi
)
1405 input_thread_t
*p_input_thread
;
1408 p_input_thread
= libvlc_get_input_thread ( p_mi
);
1409 if( !p_input_thread
)
1412 i_chapter
= var_GetInteger( p_input_thread
, "chapter" );
1413 vlc_object_release( p_input_thread
);
1418 int libvlc_media_player_get_chapter_count( libvlc_media_player_t
*p_mi
)
1420 input_thread_t
*p_input_thread
;
1423 p_input_thread
= libvlc_get_input_thread ( p_mi
);
1424 if( !p_input_thread
)
1427 int i_ret
= var_Change( p_input_thread
, "chapter", VLC_VAR_CHOICESCOUNT
, &val
, NULL
);
1428 vlc_object_release( p_input_thread
);
1430 return i_ret
== VLC_SUCCESS
? val
.i_int
: -1;
1433 int libvlc_media_player_get_chapter_count_for_title(
1434 libvlc_media_player_t
*p_mi
,
1439 input_thread_t
*p_input_thread
= libvlc_get_input_thread ( p_mi
);
1440 if( !p_input_thread
)
1443 char psz_name
[sizeof ("title ") + 3 * sizeof (int)];
1444 sprintf( psz_name
, "title %2u", i_title
);
1446 int i_ret
= var_Change( p_input_thread
, psz_name
, VLC_VAR_CHOICESCOUNT
, &val
, NULL
);
1447 vlc_object_release( p_input_thread
);
1449 return i_ret
== VLC_SUCCESS
? val
.i_int
: -1;
1452 void libvlc_media_player_set_title( libvlc_media_player_t
*p_mi
,
1455 input_thread_t
*p_input_thread
;
1457 p_input_thread
= libvlc_get_input_thread ( p_mi
);
1458 if( !p_input_thread
)
1461 var_SetInteger( p_input_thread
, "title", i_title
);
1462 vlc_object_release( p_input_thread
);
1465 libvlc_event_t event
;
1466 event
.type
= libvlc_MediaPlayerTitleChanged
;
1467 event
.u
.media_player_title_changed
.new_title
= i_title
;
1468 libvlc_event_send( &p_mi
->event_manager
, &event
);
1471 int libvlc_media_player_get_title( libvlc_media_player_t
*p_mi
)
1473 input_thread_t
*p_input_thread
;
1476 p_input_thread
= libvlc_get_input_thread ( p_mi
);
1477 if( !p_input_thread
)
1480 i_title
= var_GetInteger( p_input_thread
, "title" );
1481 vlc_object_release( p_input_thread
);
1486 int libvlc_media_player_get_title_count( libvlc_media_player_t
*p_mi
)
1488 input_thread_t
*p_input_thread
;
1491 p_input_thread
= libvlc_get_input_thread ( p_mi
);
1492 if( !p_input_thread
)
1495 int i_ret
= var_Change( p_input_thread
, "title", VLC_VAR_CHOICESCOUNT
, &val
, NULL
);
1496 vlc_object_release( p_input_thread
);
1498 return i_ret
== VLC_SUCCESS
? val
.i_int
: -1;
1501 int libvlc_media_player_get_full_title_descriptions( libvlc_media_player_t
*p_mi
,
1502 libvlc_title_description_t
*** pp_titles
)
1506 input_thread_t
*p_input_thread
= libvlc_get_input_thread( p_mi
);
1508 if( !p_input_thread
)
1511 input_title_t
**p_input_title
;
1515 int ret
= input_Control( p_input_thread
, INPUT_GET_FULL_TITLE_INFO
,
1516 &p_input_title
, &count
);
1517 vlc_object_release( p_input_thread
);
1518 if( ret
!= VLC_SUCCESS
)
1521 libvlc_title_description_t
**titles
= malloc( count
* sizeof (*titles
) );
1522 if( count
> 0 && unlikely(titles
== NULL
) )
1526 for( int i
= 0; i
< count
; i
++)
1528 libvlc_title_description_t
*title
= malloc( sizeof (*title
) );
1529 if( unlikely(title
== NULL
) )
1531 libvlc_title_descriptions_release( titles
, i
);
1536 /* we want to return milliseconds to match the rest of the API */
1537 title
->i_duration
= p_input_title
[i
]->i_length
/ 1000;
1538 title
->i_flags
= p_input_title
[i
]->i_flags
;
1539 if( p_input_title
[i
]->psz_name
)
1540 title
->psz_name
= strdup( p_input_title
[i
]->psz_name
);
1542 title
->psz_name
= NULL
;
1543 vlc_input_title_Delete( p_input_title
[i
] );
1545 free( p_input_title
);
1547 *pp_titles
= titles
;
1551 void libvlc_title_descriptions_release( libvlc_title_description_t
**p_titles
,
1554 for (unsigned i
= 0; i
< i_count
; i
++ )
1559 free( p_titles
[i
]->psz_name
);
1560 free( p_titles
[i
] );
1565 int libvlc_media_player_get_full_chapter_descriptions( libvlc_media_player_t
*p_mi
,
1566 int i_chapters_of_title
,
1567 libvlc_chapter_description_t
*** pp_chapters
)
1571 input_thread_t
*p_input_thread
= libvlc_get_input_thread( p_mi
);
1573 if( !p_input_thread
)
1576 seekpoint_t
**p_seekpoint
= NULL
;
1579 int ret
= input_Control(p_input_thread
, INPUT_GET_SEEKPOINTS
, &p_seekpoint
, &i_chapters_of_title
);
1580 vlc_object_release( p_input_thread
);
1582 if( ret
!= VLC_SUCCESS
)
1587 if (i_chapters_of_title
== 0 || p_seekpoint
== NULL
)
1592 const int ci_chapter_count
= (const int)i_chapters_of_title
;
1594 *pp_chapters
= calloc( ci_chapter_count
, sizeof(**pp_chapters
) );
1601 for( int i
= 0; i
< ci_chapter_count
; i
++)
1603 libvlc_chapter_description_t
*p_chapter
= malloc( sizeof(*p_chapter
) );
1604 if( unlikely(p_chapter
== NULL
) )
1606 libvlc_chapter_descriptions_release( *pp_chapters
, ci_chapter_count
);
1609 (*pp_chapters
)[i
] = p_chapter
;
1611 p_chapter
->i_time_offset
= p_seekpoint
[i
]->i_time_offset
/ 1000;
1615 p_chapter
->i_duration
= p_chapter
->i_time_offset
- (*pp_chapters
)[i
-1]->i_time_offset
;
1619 p_chapter
->i_duration
= p_chapter
->i_time_offset
;
1622 if( p_seekpoint
[i
]->psz_name
)
1624 p_chapter
->psz_name
= strdup( p_seekpoint
[i
]->psz_name
);
1628 p_chapter
->psz_name
= NULL
;
1630 vlc_seekpoint_Delete( p_seekpoint
[i
] );
1633 return ci_chapter_count
;
1636 void libvlc_chapter_descriptions_release( libvlc_chapter_description_t
**p_chapters
,
1639 for (unsigned i
= 0; i
< i_count
; i
++ )
1641 if ( !p_chapters
[i
] )
1644 free( p_chapters
[i
]->psz_name
);
1645 free( p_chapters
[i
] );
1650 void libvlc_media_player_next_chapter( libvlc_media_player_t
*p_mi
)
1652 input_thread_t
*p_input_thread
;
1654 p_input_thread
= libvlc_get_input_thread ( p_mi
);
1655 if( !p_input_thread
)
1658 int i_type
= var_Type( p_input_thread
, "next-chapter" );
1659 var_TriggerCallback( p_input_thread
, (i_type
& VLC_VAR_TYPE
) != 0 ?
1660 "next-chapter":"next-title" );
1662 vlc_object_release( p_input_thread
);
1665 void libvlc_media_player_previous_chapter( libvlc_media_player_t
*p_mi
)
1667 input_thread_t
*p_input_thread
;
1669 p_input_thread
= libvlc_get_input_thread ( p_mi
);
1670 if( !p_input_thread
)
1673 int i_type
= var_Type( p_input_thread
, "next-chapter" );
1674 var_TriggerCallback( p_input_thread
, (i_type
& VLC_VAR_TYPE
) != 0 ?
1675 "prev-chapter":"prev-title" );
1677 vlc_object_release( p_input_thread
);
1680 float libvlc_media_player_get_fps( libvlc_media_player_t
*p_mi
)
1682 libvlc_media_t
*media
= libvlc_media_player_get_media( p_mi
);
1686 input_item_t
*item
= media
->p_input_item
;
1689 vlc_mutex_lock( &item
->lock
);
1690 for( int i
= 0; i
< item
->i_es
; i
++ )
1692 const es_format_t
*fmt
= item
->es
[i
];
1694 if( fmt
->i_cat
== VIDEO_ES
&& fmt
->video
.i_frame_rate_base
> 0 )
1695 fps
= (float)fmt
->video
.i_frame_rate
1696 / (float)fmt
->video
.i_frame_rate_base
;
1698 vlc_mutex_unlock( &item
->lock
);
1699 libvlc_media_release( media
);
1704 int libvlc_media_player_will_play( libvlc_media_player_t
*p_mi
)
1706 input_thread_t
*p_input_thread
=
1707 libvlc_get_input_thread ( p_mi
);
1708 if ( !p_input_thread
)
1711 int state
= var_GetInteger( p_input_thread
, "state" );
1712 vlc_object_release( p_input_thread
);
1714 return state
!= END_S
&& state
!= ERROR_S
;
1717 int libvlc_media_player_set_rate( libvlc_media_player_t
*p_mi
, float rate
)
1719 var_SetFloat (p_mi
, "rate", rate
);
1721 input_thread_t
*p_input_thread
= libvlc_get_input_thread ( p_mi
);
1722 if( !p_input_thread
)
1724 var_SetFloat( p_input_thread
, "rate", rate
);
1725 vlc_object_release( p_input_thread
);
1729 float libvlc_media_player_get_rate( libvlc_media_player_t
*p_mi
)
1731 return var_GetFloat (p_mi
, "rate");
1734 libvlc_state_t
libvlc_media_player_get_state( libvlc_media_player_t
*p_mi
)
1737 libvlc_state_t state
= p_mi
->state
;
1742 int libvlc_media_player_is_seekable( libvlc_media_player_t
*p_mi
)
1744 input_thread_t
*p_input_thread
;
1747 p_input_thread
= libvlc_get_input_thread ( p_mi
);
1748 if ( !p_input_thread
)
1750 b_seekable
= var_GetBool( p_input_thread
, "can-seek" );
1751 vlc_object_release( p_input_thread
);
1756 void libvlc_media_player_navigate( libvlc_media_player_t
* p_mi
,
1759 static const enum input_query_e map
[] =
1761 INPUT_NAV_ACTIVATE
, INPUT_NAV_UP
, INPUT_NAV_DOWN
,
1762 INPUT_NAV_LEFT
, INPUT_NAV_RIGHT
, INPUT_NAV_POPUP
,
1765 if( navigate
>= sizeof(map
) / sizeof(map
[0]) )
1768 input_thread_t
*p_input
= libvlc_get_input_thread ( p_mi
);
1769 if ( p_input
== NULL
)
1772 input_Control( p_input
, map
[navigate
], NULL
);
1773 vlc_object_release( p_input
);
1776 /* internal function, used by audio, video */
1777 libvlc_track_description_t
*
1778 libvlc_get_track_description( libvlc_media_player_t
*p_mi
,
1779 const char *psz_variable
)
1781 input_thread_t
*p_input
= libvlc_get_input_thread( p_mi
);
1782 libvlc_track_description_t
*p_track_description
= NULL
,
1783 *p_actual
, *p_previous
;
1788 vlc_value_t val_list
, text_list
;
1789 int i_ret
= var_Change( p_input
, psz_variable
, VLC_VAR_GETCHOICES
, &val_list
, &text_list
);
1790 if( i_ret
!= VLC_SUCCESS
)
1794 if( val_list
.p_list
->i_count
<= 0 )
1797 p_track_description
= malloc( sizeof *p_track_description
);
1798 if ( !p_track_description
)
1800 libvlc_printerr( "Not enough memory" );
1803 p_actual
= p_track_description
;
1805 for( int i
= 0; i
< val_list
.p_list
->i_count
; i
++ )
1809 p_actual
= malloc( sizeof *p_actual
);
1812 libvlc_track_description_list_release( p_track_description
);
1813 libvlc_printerr( "Not enough memory" );
1815 p_track_description
= NULL
;
1819 p_actual
->i_id
= val_list
.p_list
->p_values
[i
].i_int
;
1820 p_actual
->psz_name
= strdup( text_list
.p_list
->p_values
[i
].psz_string
);
1821 p_actual
->p_next
= NULL
;
1823 p_previous
->p_next
= p_actual
;
1824 p_previous
= p_actual
;
1829 var_FreeList( &val_list
, &text_list
);
1830 vlc_object_release( p_input
);
1832 return p_track_description
;
1835 // Deprecated alias for libvlc_track_description_list_release
1836 void libvlc_track_description_release( libvlc_track_description_t
*p_td
)
1838 libvlc_track_description_list_release( p_td
);
1841 void libvlc_track_description_list_release( libvlc_track_description_t
*p_td
)
1843 libvlc_track_description_t
*p_actual
, *p_before
;
1848 free( p_actual
->psz_name
);
1849 p_before
= p_actual
;
1850 p_actual
= p_before
->p_next
;
1855 int libvlc_media_player_can_pause( libvlc_media_player_t
*p_mi
)
1857 input_thread_t
*p_input_thread
;
1860 p_input_thread
= libvlc_get_input_thread ( p_mi
);
1861 if ( !p_input_thread
)
1863 b_can_pause
= var_GetBool( p_input_thread
, "can-pause" );
1864 vlc_object_release( p_input_thread
);
1869 int libvlc_media_player_program_scrambled( libvlc_media_player_t
*p_mi
)
1871 input_thread_t
*p_input_thread
;
1872 bool b_program_scrambled
;
1874 p_input_thread
= libvlc_get_input_thread ( p_mi
);
1875 if ( !p_input_thread
)
1877 b_program_scrambled
= var_GetBool( p_input_thread
, "program-scrambled" );
1878 vlc_object_release( p_input_thread
);
1880 return b_program_scrambled
;
1883 void libvlc_media_player_next_frame( libvlc_media_player_t
*p_mi
)
1885 input_thread_t
*p_input_thread
= libvlc_get_input_thread ( p_mi
);
1886 if( p_input_thread
!= NULL
)
1888 var_TriggerCallback( p_input_thread
, "frame-next" );
1889 vlc_object_release( p_input_thread
);
1894 * Private lookup table to get subpicture alignment flag values corresponding
1895 * to a libvlc_position_t enumerated value.
1897 static const unsigned char position_subpicture_alignment
[] = {
1898 [libvlc_position_center
] = 0,
1899 [libvlc_position_left
] = SUBPICTURE_ALIGN_LEFT
,
1900 [libvlc_position_right
] = SUBPICTURE_ALIGN_RIGHT
,
1901 [libvlc_position_top
] = SUBPICTURE_ALIGN_TOP
,
1902 [libvlc_position_top_left
] = SUBPICTURE_ALIGN_TOP
| SUBPICTURE_ALIGN_LEFT
,
1903 [libvlc_position_top_right
] = SUBPICTURE_ALIGN_TOP
| SUBPICTURE_ALIGN_RIGHT
,
1904 [libvlc_position_bottom
] = SUBPICTURE_ALIGN_BOTTOM
,
1905 [libvlc_position_bottom_left
] = SUBPICTURE_ALIGN_BOTTOM
| SUBPICTURE_ALIGN_LEFT
,
1906 [libvlc_position_bottom_right
] = SUBPICTURE_ALIGN_BOTTOM
| SUBPICTURE_ALIGN_RIGHT
1909 void libvlc_media_player_set_video_title_display( libvlc_media_player_t
*p_mi
, libvlc_position_t position
, unsigned timeout
)
1911 assert( position
>= libvlc_position_disable
&& position
<= libvlc_position_bottom_right
);
1913 if ( position
!= libvlc_position_disable
)
1915 var_SetBool( p_mi
, "video-title-show", true );
1916 var_SetInteger( p_mi
, "video-title-position", position_subpicture_alignment
[position
] );
1917 var_SetInteger( p_mi
, "video-title-timeout", timeout
);
1921 var_SetBool( p_mi
, "video-title-show", false );
1925 int libvlc_media_player_add_slave( libvlc_media_player_t
*p_mi
,
1926 libvlc_media_slave_type_t i_type
,
1927 const char *psz_uri
, bool b_select
)
1929 input_thread_t
*p_input_thread
= libvlc_get_input_thread ( p_mi
);
1931 if( p_input_thread
== NULL
)
1933 libvlc_media_t
*p_media
= libvlc_media_player_get_media( p_mi
);
1934 if( p_media
== NULL
)
1937 int i_ret
= libvlc_media_slaves_add( p_media
, i_type
, 4, psz_uri
);
1938 libvlc_media_release( p_media
);
1943 int i_ret
= input_AddSlave( p_input_thread
, (enum slave_type
) i_type
,
1944 psz_uri
, b_select
);
1945 vlc_object_release( p_input_thread
);
1947 return i_ret
== VLC_SUCCESS
? 0 : -1;
1952 * Maximum size of a formatted equalizer amplification band frequency value.
1954 * The allowed value range is supposed to be constrained from -20.0 to 20.0.
1956 * The format string " %.07f" with a minimum value of "-20" gives a maximum
1957 * string length of e.g. " -19.1234567", i.e. 12 bytes (not including the null
1960 #define EQZ_BAND_VALUE_SIZE 12
1962 int libvlc_media_player_set_equalizer( libvlc_media_player_t
*p_mi
, libvlc_equalizer_t
*p_equalizer
)
1964 char bands
[EQZ_BANDS_MAX
* EQZ_BAND_VALUE_SIZE
+ 1];
1966 if( p_equalizer
!= NULL
)
1968 for( unsigned i
= 0, c
= 0; i
< EQZ_BANDS_MAX
; i
++ )
1970 c
+= snprintf( bands
+ c
, sizeof(bands
) - c
, " %.07f",
1971 p_equalizer
->f_amp
[i
] );
1972 if( unlikely(c
>= sizeof(bands
)) )
1976 var_SetFloat( p_mi
, "equalizer-preamp", p_equalizer
->f_preamp
);
1977 var_SetString( p_mi
, "equalizer-bands", bands
);
1979 var_SetString( p_mi
, "audio-filter", p_equalizer
? "equalizer" : "" );
1981 audio_output_t
*p_aout
= input_resource_HoldAout( p_mi
->input
.p_resource
);
1982 if( p_aout
!= NULL
)
1984 if( p_equalizer
!= NULL
)
1986 var_SetFloat( p_aout
, "equalizer-preamp", p_equalizer
->f_preamp
);
1987 var_SetString( p_aout
, "equalizer-bands", bands
);
1990 var_SetString( p_aout
, "audio-filter", p_equalizer
? "equalizer" : "" );
1991 vlc_object_release( p_aout
);
1997 static const char roles
[][16] =
1999 [libvlc_role_Music
] = "music",
2000 [libvlc_role_Video
] = "video",
2001 [libvlc_role_Communication
] = "communication",
2002 [libvlc_role_Game
] = "game",
2003 [liblvc_role_Notification
] = "notification",
2004 [libvlc_role_Animation
] = "animation",
2005 [libvlc_role_Production
] = "production",
2006 [libvlc_role_Accessibility
] = "accessibility",
2007 [libvlc_role_Test
] = "test",
2010 int libvlc_media_player_set_role(libvlc_media_player_t
*mp
, unsigned role
)
2012 if (role
>= ARRAY_SIZE(roles
)
2013 || var_SetString(mp
, "role", roles
[role
]) != VLC_SUCCESS
)
2018 int libvlc_media_player_get_role(libvlc_media_player_t
*mp
)
2021 char *str
= var_GetString(mp
, "role");
2025 for (size_t i
= 0; i
< ARRAY_SIZE(roles
); i
++)
2026 if (!strcmp(roles
[i
], str
))