git.sesse.net Git - vlc/blob - src/control/media_player.c

   1 /*****************************************************************************
   2  * media_player.c: Libvlc API Media Instance management functions
   3  *****************************************************************************
   4  * Copyright (C) 2005-2009 the VideoLAN team
   5  * $Id$
   6  *
   7  * Authors: Clément Stenac <zorglub@videolan.org>
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License as published by
  11  * the Free Software Foundation; either version 2 of the License, or
  12  * (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public License
  20  * along with this program; if not, write to the Free Software
  21  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
  22  *****************************************************************************/
  23
  24 #ifdef HAVE_CONFIG_H
  25 # include "config.h"
  26 #endif
  27
  28 #include <assert.h>
  29
  30 #include <vlc/libvlc.h>
  31 #include <vlc/libvlc_media.h>
  32 #include <vlc/libvlc_events.h>
  33
  34 #include <vlc_demux.h>
  35 #include <vlc_input.h>
  36 #include <vlc_vout.h>
  37
  38 #include "libvlc.h"
  39
  40 #include "libvlc_internal.h"
  41 #include "media_internal.h" // libvlc_media_set_state()
  42 #include "media_player_internal.h"
  43
  44 static int
  45 input_seekable_changed( vlc_object_t * p_this, char const * psz_cmd,
  46                         vlc_value_t oldval, vlc_value_t newval,
  47                         void * p_userdata );
  48 static int
  49 input_pausable_changed( vlc_object_t * p_this, char const * psz_cmd,
  50                         vlc_value_t oldval, vlc_value_t newval,
  51                         void * p_userdata );
  52 static int
  53 input_event_changed( vlc_object_t * p_this, char const * psz_cmd,
  54                      vlc_value_t oldval, vlc_value_t newval,
  55                      void * p_userdata );
  56
  57 static int
  58 snapshot_was_taken( vlc_object_t *p_this, char const *psz_cmd,
  59                     vlc_value_t oldval, vlc_value_t newval, void *p_data );
  60
  61 /* Mouse events */
  62 static int
  63 mouse_moved( vlc_object_t *p_this, char const *psz_cmd,
  64                     vlc_value_t oldval, vlc_value_t newval, void *p_data );
  65 static int
  66 mouse_button( vlc_object_t *p_this, char const *psz_cmd,
  67                     vlc_value_t oldval, vlc_value_t newval, void *p_data );
  68 static int
  69 mouse_clicked( vlc_object_t *p_this, char const *psz_cmd,
  70                     vlc_value_t oldval, vlc_value_t newval, void *p_data );
  71 static int
  72 mouse_object( vlc_object_t *p_this, char const *psz_cmd,
  73                     vlc_value_t oldval, vlc_value_t newval, void *p_data );
  74
  75 /* */
  76 static void libvlc_media_player_destroy( libvlc_media_player_t *p_mi );
  77
  78 /*
  79  * Shortcuts
  80  */
  81
  82 #define register_event(a, b) __register_event(a, libvlc_MediaPlayer ## b)
  83 static inline void __register_event(libvlc_media_player_t *mp, libvlc_event_type_t type)
  84 {
  85     libvlc_event_manager_register_event_type(mp->p_event_manager, type);
  86 }
  87
  88 static inline void lock(libvlc_media_player_t *mp)
  89 {
  90     vlc_mutex_lock(&mp->object_lock);
  91 }
  92
  93 static inline void unlock(libvlc_media_player_t *mp)
  94 {
  95     vlc_mutex_unlock(&mp->object_lock);
  96 }
  97
  98 /*
  99  * Release the associated input thread.
 100  *
 101  * Object lock is NOT held.
 102  */
 103 static void release_input_thread( libvlc_media_player_t *p_mi, bool b_input_abort )
 104 {
 105     input_thread_t * p_input_thread;
 106
 107     if( !p_mi || !p_mi->p_input_thread )
 108         return;
 109
 110     p_input_thread = p_mi->p_input_thread;
 111
 112     var_DelCallback( p_input_thread, "can-seek",
 113                      input_seekable_changed, p_mi );
 114     var_DelCallback( p_input_thread, "can-pause",
 115                     input_pausable_changed, p_mi );
 116     var_DelCallback( p_input_thread, "intf-event",
 117                      input_event_changed, p_mi );
 118
 119     /* We owned this one */
 120     input_Stop( p_input_thread, b_input_abort );
 121
 122     vlc_thread_join( p_input_thread );
 123
 124     assert( p_mi->p_input_resource == NULL );
 125     assert( p_input_thread->b_dead );
 126     /* Store the input resource for future use. */
 127     p_mi->p_input_resource = input_DetachResource( p_input_thread );
 128
 129     vlc_object_release( p_input_thread );
 130
 131     p_mi->p_input_thread = NULL;
 132 }
 133
 134 /*
 135  * Retrieve the input thread. Be sure to release the object
 136  * once you are done with it. (libvlc Internal)
 137  *
 138  * Function will lock the object.
 139  */
 140 input_thread_t *libvlc_get_input_thread( libvlc_media_player_t *p_mi )
 141 {
 142     input_thread_t *p_input_thread;
 143
 144     assert( p_mi );
 145
 146     lock(p_mi);
 147     p_input_thread = p_mi->p_input_thread;
 148     if( p_input_thread )
 149         vlc_object_hold( p_input_thread );
 150     else
 151         libvlc_printerr( "No active input" );
 152     unlock(p_mi);
 153
 154     return p_input_thread;
 155 }
 156
 157 /*
 158  * Get vout thread from current input
 159  *
 160  * Object lock is NOT held.
 161  */
 162 static vout_thread_t *get_vout_thread( libvlc_media_player_t *p_mi )
 163 {
 164     vout_thread_t *p_vout_thread;
 165
 166     p_vout_thread = input_GetVout( p_mi->p_input_thread );
 167     if( p_vout_thread )
 168     {
 169         var_AddCallback( p_vout_thread, "mouse-button-down", mouse_button, p_mi );
 170         var_AddCallback( p_vout_thread, "mouse-moved", mouse_moved, p_mi );
 171         var_AddCallback( p_vout_thread, "mouse-clicked", mouse_clicked, p_mi );
 172         var_AddCallback( p_vout_thread, "mouse-object", mouse_object, p_mi );
 173     }
 174
 175     return p_vout_thread;
 176 }
 177
 178 /*
 179  * Release the associated vout thread.
 180  *
 181  * Object lock is NOT held.
 182  */
 183 static void release_vout_thread( libvlc_media_player_t *p_mi )
 184 {
 185     vout_thread_t *p_vout_thread;
 186
 187     if( !p_mi || !p_mi->p_vout_thread )
 188         return;
 189
 190     p_vout_thread = p_mi->p_vout_thread;
 191
 192     var_DelCallback( p_vout_thread, "mouse-button-down", mouse_button, p_mi );
 193     var_DelCallback( p_vout_thread, "mouse-moved", mouse_moved, p_mi );
 194     var_DelCallback( p_vout_thread, "mouse-clicked", mouse_clicked, p_mi );
 195     var_DelCallback( p_vout_thread, "mouse-object", mouse_object, p_mi );
 196
 197     vlc_object_release( p_vout_thread );
 198     p_mi->p_vout_thread = NULL;
 199 }
 200
 201 /*
 202  * Set the internal state of the media_player. (media player Internal)
 203  *
 204  * Function will lock the media_player.
 205  */
 206 static void set_state( libvlc_media_player_t *p_mi, libvlc_state_t state,
 207     bool b_locked )
 208 {
 209     if(!b_locked)
 210         lock(p_mi);
 211     p_mi->state = state;
 212
 213     libvlc_media_t *media = p_mi->p_md;
 214     if (media)
 215         libvlc_media_retain(media);
 216
 217     if(!b_locked)
 218         unlock(p_mi);
 219
 220     if (media)
 221     {
 222         // Also set the state of the corresponding media
 223         // This is strictly for convenience.
 224         libvlc_media_set_state(media, state);
 225
 226         libvlc_media_release(media);
 227     }
 228 }
 229
 230 static int
 231 input_seekable_changed( vlc_object_t * p_this, char const * psz_cmd,
 232                         vlc_value_t oldval, vlc_value_t newval,
 233                         void * p_userdata )
 234 {
 235     VLC_UNUSED(oldval);
 236     VLC_UNUSED(p_this);
 237     VLC_UNUSED(psz_cmd);
 238     libvlc_media_player_t * p_mi = p_userdata;
 239     libvlc_event_t event;
 240
 241     event.type = libvlc_MediaPlayerSeekableChanged;
 242     event.u.media_player_seekable_changed.new_seekable = newval.b_bool;
 243
 244     libvlc_event_send( p_mi->p_event_manager, &event );
 245     return VLC_SUCCESS;
 246 }
 247
 248 static int
 249 input_pausable_changed( vlc_object_t * p_this, char const * psz_cmd,
 250                         vlc_value_t oldval, vlc_value_t newval,
 251                         void * p_userdata )
 252 {
 253     VLC_UNUSED(oldval);
 254     VLC_UNUSED(p_this);
 255     VLC_UNUSED(psz_cmd);
 256     libvlc_media_player_t * p_mi = p_userdata;
 257     libvlc_event_t event;
 258
 259     event.type = libvlc_MediaPlayerPausableChanged;
 260     event.u.media_player_pausable_changed.new_pausable = newval.b_bool;
 261
 262     libvlc_event_send( p_mi->p_event_manager, &event );
 263     return VLC_SUCCESS;
 264 }
 265
 266 static int
 267 input_event_changed( vlc_object_t * p_this, char const * psz_cmd,
 268                      vlc_value_t oldval, vlc_value_t newval,
 269                      void * p_userdata )
 270 {
 271     VLC_UNUSED(oldval);
 272     input_thread_t * p_input = (input_thread_t *)p_this;
 273     libvlc_media_player_t * p_mi = p_userdata;
 274     libvlc_event_t event;
 275
 276     assert( !strcmp( psz_cmd, "intf-event" ) );
 277
 278     if( newval.i_int == INPUT_EVENT_STATE )
 279     {
 280         libvlc_state_t libvlc_state;
 281
 282         switch ( var_GetInteger( p_input, "state" ) )
 283         {
 284             case INIT_S:
 285                 libvlc_state = libvlc_NothingSpecial;
 286                 event.type = libvlc_MediaPlayerNothingSpecial;
 287                 break;
 288             case OPENING_S:
 289                 libvlc_state = libvlc_Opening;
 290                 event.type = libvlc_MediaPlayerOpening;
 291                 break;
 292             case PLAYING_S:
 293                 libvlc_state = libvlc_Playing;
 294                 event.type = libvlc_MediaPlayerPlaying;
 295                 break;
 296             case PAUSE_S:
 297                 libvlc_state = libvlc_Paused;
 298                 event.type = libvlc_MediaPlayerPaused;
 299                 break;
 300             case END_S:
 301                 libvlc_state = libvlc_Ended;
 302                 event.type = libvlc_MediaPlayerEndReached;
 303                 break;
 304             case ERROR_S:
 305                 libvlc_state = libvlc_Error;
 306                 event.type = libvlc_MediaPlayerEncounteredError;
 307                 break;
 308
 309             default:
 310                 return VLC_SUCCESS;
 311         }
 312
 313         set_state( p_mi, libvlc_state, false );
 314         libvlc_event_send( p_mi->p_event_manager, &event );
 315     }
 316     else if( newval.i_int == INPUT_EVENT_ABORT )
 317     {
 318         libvlc_state_t libvlc_state = libvlc_Stopped;
 319         event.type = libvlc_MediaPlayerStopped;
 320
 321         set_state( p_mi, libvlc_state, false );
 322         libvlc_event_send( p_mi->p_event_manager, &event );
 323     }
 324     else if( newval.i_int == INPUT_EVENT_POSITION )
 325     {
 326         if( var_GetInteger( p_input, "state" ) != PLAYING_S )
 327             return VLC_SUCCESS; /* Don't send the position while stopped */
 328
 329         /* */
 330         event.type = libvlc_MediaPlayerPositionChanged;
 331         event.u.media_player_position_changed.new_position =
 332                                           var_GetFloat( p_input, "position" );
 333         libvlc_event_send( p_mi->p_event_manager, &event );
 334
 335         /* */
 336         event.type = libvlc_MediaPlayerTimeChanged;
 337         event.u.media_player_time_changed.new_time =
 338            from_mtime(var_GetTime( p_input, "time" ));
 339         libvlc_event_send( p_mi->p_event_manager, &event );
 340     }
 341     else if( newval.i_int == INPUT_EVENT_LENGTH )
 342     {
 343         event.type = libvlc_MediaPlayerLengthChanged;
 344         event.u.media_player_length_changed.new_length =
 345            from_mtime(var_GetTime( p_input, "length" ));
 346         libvlc_event_send( p_mi->p_event_manager, &event );
 347     }
 348     else if( newval.i_int == INPUT_EVENT_VOUT )
 349     {
 350         lock( p_mi );
 351         /* release old vout */
 352         if( p_mi->p_vout_thread )
 353             release_vout_thread( p_mi );
 354         /* remember new vout */
 355         p_mi->p_vout_thread = get_vout_thread( p_mi );
 356         unlock( p_mi );
 357     }
 358
 359     return VLC_SUCCESS;
 360
 361 }
 362
 363 /**************************************************************************
 364  * Snapshot Taken Event.
 365  *
 366  * FIXME: This snapshot API interface makes no sense in media_player.
 367  *************************************************************************/
 368 static int snapshot_was_taken(vlc_object_t *p_this, char const *psz_cmd,
 369                               vlc_value_t oldval, vlc_value_t newval, void *p_data )
 370 {
 371     VLC_UNUSED(psz_cmd); VLC_UNUSED(oldval); VLC_UNUSED(p_this);
 372
 373     libvlc_media_player_t *mp = p_data;
 374     libvlc_event_t event;
 375     event.type = libvlc_MediaPlayerSnapshotTaken;
 376     event.u.media_player_snapshot_taken.psz_filename = newval.psz_string;
 377     libvlc_event_send(mp->p_event_manager, &event);
 378
 379     return VLC_SUCCESS;
 380 }
 381
 382 /**************************************************************************
 383  * Mouse  Events.
 384  *************************************************************************/
 385
 386 static int
 387 mouse_moved( vlc_object_t *p_this, char const *psz_cmd,
 388                     vlc_value_t oldval, vlc_value_t newval, void *p_data )
 389 {
 390     VLC_UNUSED(psz_cmd); VLC_UNUSED(oldval); VLC_UNUSED(p_this);
 391
 392     libvlc_media_player_t *mp = p_data;
 393     libvlc_event_t event;
 394     event.type = libvlc_MediaPlayerMouseMoved;
 395     event.u.media_player_mouse_moved.x = newval.coords.x;
 396     event.u.media_player_mouse_moved.y = newval.coords.y;
 397     libvlc_event_send(mp->p_event_manager, &event);
 398
 399     return VLC_SUCCESS;
 400 }
 401
 402 static int
 403 mouse_button( vlc_object_t *p_this, char const *psz_cmd,
 404                     vlc_value_t oldval, vlc_value_t newval, void *p_data )
 405 {
 406     VLC_UNUSED(psz_cmd); VLC_UNUSED(oldval); VLC_UNUSED(p_this);
 407
 408     libvlc_media_player_t *mp = p_data;
 409     libvlc_event_t event;
 410     int pressed = newval.i_int;
 411
 412     event.type = libvlc_MediaPlayerMouseButton;
 413     event.u.media_player_mouse_button.mb_left = (pressed & (1<<MOUSE_BUTTON_LEFT));
 414     event.u.media_player_mouse_button.mb_center = (pressed & (1<<MOUSE_BUTTON_CENTER));
 415     event.u.media_player_mouse_button.mb_right = (pressed & (1<<MOUSE_BUTTON_RIGHT));
 416     event.u.media_player_mouse_button.mb_wheel_up = (pressed & (1<<MOUSE_BUTTON_WHEEL_UP));
 417     event.u.media_player_mouse_button.mb_wheel_down = (pressed & (1<<MOUSE_BUTTON_WHEEL_DOWN));
 418     libvlc_event_send(mp->p_event_manager, &event);
 419
 420     return VLC_SUCCESS;
 421 }
 422
 423 static int
 424 mouse_clicked( vlc_object_t *p_this, char const *psz_cmd,
 425                     vlc_value_t oldval, vlc_value_t newval, void *p_data )
 426 {
 427     VLC_UNUSED(psz_cmd); VLC_UNUSED(oldval); VLC_UNUSED(p_this);
 428
 429     libvlc_media_player_t *mp = p_data;
 430     libvlc_event_t event;
 431     event.type = libvlc_MediaPlayerMouseClick;
 432     event.u.media_player_mouse_clicked.clicked = newval.b_bool ? 1 : 0;
 433     libvlc_event_send(mp->p_event_manager, &event);
 434
 435     return VLC_SUCCESS;
 436 }
 437
 438 static int
 439 mouse_object( vlc_object_t *p_this, char const *psz_cmd,
 440                     vlc_value_t oldval, vlc_value_t newval, void *p_data )
 441 {
 442     VLC_UNUSED(psz_cmd); VLC_UNUSED(oldval); VLC_UNUSED(p_this);
 443
 444     libvlc_media_player_t *mp = p_data;
 445     libvlc_event_t event;
 446     event.type = libvlc_MediaPlayerMouseObject;
 447     event.u.media_player_mouse_object.moved = (newval.b_bool ? 1 : 0);
 448     libvlc_event_send(mp->p_event_manager, &event);
 449
 450     return VLC_SUCCESS;
 451 }
 452
 453 static input_thread_t *find_input (vlc_object_t *obj)
 454 {
 455     libvlc_media_player_t *mp = (libvlc_media_player_t *)obj;
 456     input_thread_t *p_input;
 457
 458     lock (mp);
 459     p_input = mp->p_input_thread;
 460     if (p_input)
 461         vlc_object_hold (p_input);
 462     unlock (mp);
 463     return p_input;
 464 }
 465
 466 /* */
 467 static void libvlc_media_player_destroy( libvlc_media_player_t * );
 468
 469
 470 /**************************************************************************
 471  * Create a Media Instance object.
 472  *
 473  * Refcount strategy:
 474  * - All items created by _new start with a refcount set to 1.
 475  * - Accessor _release decrease the refcount by 1, if after that
 476  *   operation the refcount is 0, the object is destroyed.
 477  * - Accessor _retain increase the refcount by 1 (XXX: to implement)
 478  *
 479  * Object locking strategy:
 480  * - No lock held while in constructor.
 481  * - When accessing any member variable this lock is held. (XXX who locks?)
 482  * - When attempting to destroy the object the lock is also held.
 483  **************************************************************************/
 484 libvlc_media_player_t *
 485 libvlc_media_player_new( libvlc_instance_t *instance )
 486 {
 487     libvlc_media_player_t * mp;
 488
 489     assert(instance);
 490
 491     mp = vlc_object_create (instance->p_libvlc_int, sizeof(*mp));
 492     if (unlikely(mp == NULL))
 493     {
 494         libvlc_printerr("Not enough memory");
 495         return NULL;
 496     }
 497     vlc_object_attach (mp, mp->p_libvlc);
 498
 499     /* Input */
 500     var_Create (mp, "rate", VLC_VAR_FLOAT|VLC_VAR_DOINHERIT);
 501
 502     /* Video */
 503     var_Create (mp, "drawable-xid", VLC_VAR_INTEGER);
 504 #ifdef WIN32
 505     var_Create (mp, "drawable-hwnd", VLC_VAR_ADDRESS);
 506 #endif
 507 #ifdef __APPLE__
 508     var_Create (mp, "drawable-agl", VLC_VAR_INTEGER);
 509     var_Create (mp, "drawable-nsobject", VLC_VAR_ADDRESS);
 510 #endif
 511
 512     var_Create (mp, "keyboard-events", VLC_VAR_BOOL);
 513     var_SetBool (mp, "keyboard-events", true);
 514     var_Create (mp, "mouse-events", VLC_VAR_BOOL);
 515     var_SetBool (mp, "mouse-events", true);
 516
 517     var_Create (mp, "fullscreen", VLC_VAR_BOOL);
 518     var_Create (mp, "autoscale", VLC_VAR_BOOL);
 519     var_SetBool (mp, "autoscale", true);
 520     var_Create (mp, "scale", VLC_VAR_FLOAT);
 521     var_SetFloat (mp, "scale", 1.);
 522     var_Create (mp, "aspect-ratio", VLC_VAR_STRING);
 523     var_Create (mp, "crop", VLC_VAR_STRING);
 524     var_Create (mp, "deinterlace", VLC_VAR_INTEGER);
 525     var_Create (mp, "deinterlace-mode", VLC_VAR_STRING);
 526
 527     var_Create (mp, "vbi-page", VLC_VAR_INTEGER);
 528
 529     var_Create (mp, "marq-marquee", VLC_VAR_STRING);
 530     var_Create (mp, "marq-color", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
 531     var_Create (mp, "marq-opacity", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
 532     var_Create (mp, "marq-position", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
 533     var_Create (mp, "marq-refresh", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
 534     var_Create (mp, "marq-size", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
 535     var_Create (mp, "marq-timeout", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
 536     var_Create (mp, "marq-x", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
 537     var_Create (mp, "marq-y", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
 538
 539     var_Create (mp, "logo-file", VLC_VAR_STRING);
 540     var_Create (mp, "logo-x", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
 541     var_Create (mp, "logo-y", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
 542     var_Create (mp, "logo-delay", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
 543     var_Create (mp, "logo-repeat", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
 544     var_Create (mp, "logo-opacity", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
 545     var_Create (mp, "logo-position", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
 546
 547      /* Audio */
 548     var_Create (mp, "aout", VLC_VAR_STRING | VLC_VAR_DOINHERIT);
 549     var_Create (mp, "find-input-callback", VLC_VAR_ADDRESS);
 550     var_SetAddress (mp, "find-input-callback", find_input);
 551
 552     mp->p_md = NULL;
 553     mp->state = libvlc_NothingSpecial;
 554     mp->p_libvlc_instance = instance;
 555     mp->p_input_thread = NULL;
 556     mp->p_input_resource = NULL;
 557     mp->p_vout_thread = NULL;
 558     mp->i_refcount = 1;
 559     mp->p_event_manager = libvlc_event_manager_new(mp, instance);
 560     if (unlikely(mp->p_event_manager == NULL))
 561     {
 562         vlc_object_release(mp);
 563         return NULL;
 564     }
 565     vlc_mutex_init(&mp->object_lock);
 566
 567     register_event(mp, NothingSpecial);
 568     register_event(mp, Opening);
 569     register_event(mp, Buffering);
 570     register_event(mp, Playing);
 571     register_event(mp, Paused);
 572     register_event(mp, Stopped);
 573     register_event(mp, Forward);
 574     register_event(mp, Backward);
 575     register_event(mp, EndReached);
 576     register_event(mp, EncounteredError);
 577     register_event(mp, SeekableChanged);
 578
 579     register_event(mp, PositionChanged);
 580     register_event(mp, TimeChanged);
 581     register_event(mp, LengthChanged);
 582     register_event(mp, TitleChanged);
 583     register_event(mp, PausableChanged);
 584
 585     /* Snapshot initialization */
 586     register_event(mp, SnapshotTaken);
 587
 588     register_event(mp, MediaChanged);
 589
 590     /* mouse events */
 591     register_event(mp, MouseMoved);
 592     register_event(mp, MouseButton);
 593     register_event(mp, MouseClick);
 594     register_event(mp, MouseObject);
 595
 596     /* Attach a var callback to the global object to provide the glue between
 597      * vout_thread that generates the event and media_player that re-emits it
 598      * with its own event manager
 599      *
 600      * FIXME: It's unclear why we want to put this in public API, and why we
 601      * want to expose it in such a limiting and ugly way.
 602      */
 603     var_AddCallback(mp->p_libvlc, "snapshot-file", snapshot_was_taken, mp);
 604
 605     libvlc_retain(instance);
 606     return mp;
 607 }
 608
 609 /**************************************************************************
 610  * Create a Media Instance object with a media descriptor.
 611  **************************************************************************/
 612 libvlc_media_player_t *
 613 libvlc_media_player_new_from_media( libvlc_media_t * p_md )
 614 {
 615     libvlc_media_player_t * p_mi;
 616
 617     p_mi = libvlc_media_player_new( p_md->p_libvlc_instance );
 618     if( !p_mi )
 619         return NULL;
 620
 621     libvlc_media_retain( p_md );
 622     p_mi->p_md = p_md;
 623
 624     return p_mi;
 625 }
 626
 627 /**************************************************************************
 628  * Destroy a Media Instance object (libvlc internal)
 629  *
 630  * Warning: No lock held here, but hey, this is internal. Caller must lock.
 631  **************************************************************************/
 632 static void libvlc_media_player_destroy( libvlc_media_player_t *p_mi )
 633 {
 634     assert( p_mi );
 635
 636     /* Detach Callback from the main libvlc object */
 637     var_DelCallback( p_mi->p_libvlc,
 638                      "snapshot-file", snapshot_was_taken, p_mi );
 639
 640     /* If the input thread hasn't been already deleted it means
 641      * that the owners didn't stop the thread before releasing it. */
 642     assert(!p_mi->p_input_thread);
 643
 644     /* Fallback for those who don't use NDEBUG */
 645     if( p_mi->p_vout_thread )
 646         release_vout_thread( p_mi );
 647
 648     if(p_mi->p_input_thread )
 649         release_input_thread(p_mi, true);
 650
 651     if( p_mi->p_input_resource )
 652     {
 653         input_resource_Delete( p_mi->p_input_resource );
 654         p_mi->p_input_resource = NULL;
 655     }
 656
 657     libvlc_event_manager_release( p_mi->p_event_manager );
 658     libvlc_media_release( p_mi->p_md );
 659     vlc_mutex_destroy( &p_mi->object_lock );
 660
 661     libvlc_instance_t *instance = p_mi->p_libvlc_instance;
 662     vlc_object_release( p_mi );
 663     libvlc_release(instance);
 664 }
 665
 666 /**************************************************************************
 667  * Release a Media Instance object.
 668  *
 669  * Function does the locking.
 670  **************************************************************************/
 671 void libvlc_media_player_release( libvlc_media_player_t *p_mi )
 672 {
 673     bool destroy;
 674
 675     assert( p_mi );
 676     lock(p_mi);
 677     destroy = !--p_mi->i_refcount;
 678     unlock(p_mi);
 679
 680     if( destroy )
 681         libvlc_media_player_destroy( p_mi );
 682 }
 683
 684 /**************************************************************************
 685  * Retain a Media Instance object.
 686  *
 687  * Caller must hold the lock.
 688  **************************************************************************/
 689 void libvlc_media_player_retain( libvlc_media_player_t *p_mi )
 690 {
 691     assert( p_mi );
 692
 693     lock(p_mi);
 694     p_mi->i_refcount++;
 695     unlock(p_mi);
 696 }
 697
 698 /**************************************************************************
 699  * Set the Media descriptor associated with the instance.
 700  *
 701  * Enter without lock -- function will lock the object.
 702  **************************************************************************/
 703 void libvlc_media_player_set_media(
 704                             libvlc_media_player_t *p_mi,
 705                             libvlc_media_t *p_md )
 706 {
 707     lock(p_mi);
 708
 709     /* FIXME I am not sure if it is a user request or on die(eof/error)
 710      * request here */
 711     release_input_thread( p_mi,
 712                           p_mi->p_input_thread &&
 713                           !p_mi->p_input_thread->b_eof &&
 714                           !p_mi->p_input_thread->b_error );
 715
 716     set_state( p_mi, libvlc_NothingSpecial, true );
 717
 718     libvlc_media_release( p_mi->p_md );
 719
 720     if( !p_md )
 721     {
 722         p_mi->p_md = NULL;
 723         unlock(p_mi);
 724         return; /* It is ok to pass a NULL md */
 725     }
 726
 727     libvlc_media_retain( p_md );
 728     p_mi->p_md = p_md;
 729
 730     /* The policy here is to ignore that we were created using a different
 731      * libvlc_instance, because we don't really care */
 732     p_mi->p_libvlc_instance = p_md->p_libvlc_instance;
 733
 734     unlock(p_mi);
 735
 736     /* Send an event for the newly available media */
 737     libvlc_event_t event;
 738     event.type = libvlc_MediaPlayerMediaChanged;
 739     event.u.media_player_media_changed.new_media = p_md;
 740     libvlc_event_send( p_mi->p_event_manager, &event );
 741
 742 }
 743
 744 /**************************************************************************
 745  * Get the Media descriptor associated with the instance.
 746  **************************************************************************/
 747 libvlc_media_t *
 748 libvlc_media_player_get_media( libvlc_media_player_t *p_mi )
 749 {
 750     libvlc_media_t *p_m;
 751
 752     lock(p_mi);
 753     p_m = p_mi->p_md;
 754     if( p_m )
 755         libvlc_media_retain( p_mi->p_md );
 756     unlock(p_mi);
 757     return p_mi->p_md;
 758 }
 759
 760 /**************************************************************************
 761  * Get the event Manager.
 762  **************************************************************************/
 763 libvlc_event_manager_t *
 764 libvlc_media_player_event_manager( libvlc_media_player_t *p_mi )
 765 {
 766     return p_mi->p_event_manager;
 767 }
 768
 769 /**************************************************************************
 770  * Tell media player to start playing.
 771  **************************************************************************/
 772 int libvlc_media_player_play( libvlc_media_player_t *p_mi )
 773 {
 774     input_thread_t * p_input_thread;
 775
 776     if( (p_input_thread = libvlc_get_input_thread( p_mi )) )
 777     {
 778         /* A thread already exists, send it a play message */
 779         input_Control( p_input_thread, INPUT_SET_STATE, PLAYING_S );
 780         vlc_object_release( p_input_thread );
 781         return 0;
 782     }
 783
 784     /* Ignore previous exception */
 785     lock(p_mi);
 786
 787     if( !p_mi->p_md )
 788     {
 789         unlock(p_mi);
 790         libvlc_printerr( "No associated media descriptor" );
 791         return -1;
 792     }
 793
 794     p_mi->p_input_thread = input_Create( p_mi,
 795                                          p_mi->p_md->p_input_item, NULL,
 796                                          p_mi->p_input_resource );
 797     if( !p_mi->p_input_thread )
 798     {
 799         unlock(p_mi);
 800         libvlc_printerr( "Not enough memory" );
 801         return -1;
 802     }
 803
 804     p_mi->p_input_resource = NULL;
 805     p_input_thread = p_mi->p_input_thread;
 806
 807     var_AddCallback( p_input_thread, "can-seek", input_seekable_changed, p_mi );
 808     var_AddCallback( p_input_thread, "can-pause", input_pausable_changed, p_mi );
 809     var_AddCallback( p_input_thread, "intf-event", input_event_changed, p_mi );
 810
 811     if( input_Start( p_input_thread ) )
 812     {
 813         vlc_object_release( p_input_thread );
 814         p_mi->p_input_thread = NULL;
 815     }
 816
 817     unlock(p_mi);
 818     return 0;
 819 }
 820
 821 /**************************************************************************
 822  * Pause.
 823  **************************************************************************/
 824 void libvlc_media_player_pause( libvlc_media_player_t *p_mi )
 825 {
 826     input_thread_t * p_input_thread = libvlc_get_input_thread( p_mi );
 827     if( !p_input_thread )
 828         return;
 829
 830     libvlc_state_t state = libvlc_media_player_get_state( p_mi );
 831     if( state == libvlc_Playing || state == libvlc_Buffering )
 832     {
 833         if( libvlc_media_player_can_pause( p_mi ) )
 834             input_Control( p_input_thread, INPUT_SET_STATE, PAUSE_S );
 835         else
 836             libvlc_media_player_stop( p_mi );
 837     }
 838     else
 839         input_Control( p_input_thread, INPUT_SET_STATE, PLAYING_S );
 840
 841     vlc_object_release( p_input_thread );
 842 }
 843
 844 /**************************************************************************
 845  * Tells whether the media player is currently playing.
 846  *
 847  * Enter with lock held.
 848  **************************************************************************/
 849 int libvlc_media_player_is_playing( libvlc_media_player_t *p_mi )
 850 {
 851     libvlc_state_t state = libvlc_media_player_get_state( p_mi );
 852     return (libvlc_Playing == state) || (libvlc_Buffering == state);
 853 }
 854
 855 /**************************************************************************
 856  * Stop playing.
 857  **************************************************************************/
 858 void libvlc_media_player_stop( libvlc_media_player_t *p_mi )
 859 {
 860     libvlc_state_t state = libvlc_media_player_get_state( p_mi );
 861
 862     lock(p_mi);
 863     release_input_thread( p_mi, true ); /* This will stop the input thread */
 864     unlock(p_mi);
 865
 866     /* Force to go to stopped state, in case we were in Ended, or Error
 867      * state. */
 868     if( state != libvlc_Stopped )
 869     {
 870         set_state( p_mi, libvlc_Stopped, false );
 871
 872         /* Construct and send the event */
 873         libvlc_event_t event;
 874         event.type = libvlc_MediaPlayerStopped;
 875         libvlc_event_send( p_mi->p_event_manager, &event );
 876     }
 877 }
 878
 879 /**************************************************************************
 880  * set_nsobject
 881  **************************************************************************/
 882 void libvlc_media_player_set_nsobject( libvlc_media_player_t *p_mi,
 883                                         void * drawable )
 884 {
 885     assert (p_mi != NULL);
 886 #ifdef __APPLE__
 887     var_SetAddress (p_mi, "drawable-nsobject", drawable);
 888 #else
 889     (void) p_mi; (void)drawable;
 890 #endif
 891 }
 892
 893 /**************************************************************************
 894  * get_nsobject
 895  **************************************************************************/
 896 void * libvlc_media_player_get_nsobject( libvlc_media_player_t *p_mi )
 897 {
 898     assert (p_mi != NULL);
 899 #ifdef __APPLE__
 900     return var_GetAddress (p_mi, "drawable-nsobject");
 901 #else
 902     return NULL;
 903 #endif
 904 }
 905
 906 /**************************************************************************
 907  * set_agl
 908  **************************************************************************/
 909 void libvlc_media_player_set_agl( libvlc_media_player_t *p_mi,
 910                                   uint32_t drawable )
 911 {
 912 #ifdef __APPLE__
 913     var_SetInteger (p_mi, "drawable-agl", drawable);
 914 #else
 915     (void) p_mi; (void)drawable;
 916 #endif
 917 }
 918
 919 /**************************************************************************
 920  * get_agl
 921  **************************************************************************/
 922 uint32_t libvlc_media_player_get_agl( libvlc_media_player_t *p_mi )
 923 {
 924     assert (p_mi != NULL);
 925 #ifdef __APPLE__
 926     return var_GetInteger (p_mi, "drawable-agl");
 927 #else
 928     return 0;
 929 #endif
 930 }
 931
 932 /**************************************************************************
 933  * set_xwindow
 934  **************************************************************************/
 935 void libvlc_media_player_set_xwindow( libvlc_media_player_t *p_mi,
 936                                       uint32_t drawable )
 937 {
 938     assert (p_mi != NULL);
 939     var_SetInteger (p_mi, "drawable-xid", drawable);
 940 }
 941
 942 /**************************************************************************
 943  * get_xwindow
 944  **************************************************************************/
 945 uint32_t libvlc_media_player_get_xwindow( libvlc_media_player_t *p_mi )
 946 {
 947     return var_GetInteger (p_mi, "drawable-xid");
 948 }
 949
 950 /**************************************************************************
 951  * set_hwnd
 952  **************************************************************************/
 953 void libvlc_media_player_set_hwnd( libvlc_media_player_t *p_mi,
 954                                    void *drawable )
 955 {
 956     assert (p_mi != NULL);
 957 #ifdef WIN32
 958     var_SetAddress (p_mi, "drawable-hwnd", drawable);
 959 #else
 960     (void) p_mi; (void) drawable;
 961 #endif
 962 }
 963
 964 /**************************************************************************
 965  * get_hwnd
 966  **************************************************************************/
 967 void *libvlc_media_player_get_hwnd( libvlc_media_player_t *p_mi )
 968 {
 969     assert (p_mi != NULL);
 970 #ifdef WIN32
 971     return var_GetAddress (p_mi, "drawable-hwnd");
 972 #else
 973     return NULL;
 974 #endif
 975 }
 976
 977 /**************************************************************************
 978  * Getters for stream information
 979  **************************************************************************/
 980 libvlc_time_t libvlc_media_player_get_length(
 981                              libvlc_media_player_t *p_mi )
 982 {
 983     input_thread_t *p_input_thread;
 984     libvlc_time_t i_time;
 985
 986     p_input_thread = libvlc_get_input_thread ( p_mi );
 987     if( !p_input_thread )
 988         return -1;
 989
 990     i_time = from_mtime(var_GetTime( p_input_thread, "length" ));
 991     vlc_object_release( p_input_thread );
 992
 993     return i_time;
 994 }
 995
 996 libvlc_time_t libvlc_media_player_get_time( libvlc_media_player_t *p_mi )
 997 {
 998     input_thread_t *p_input_thread;
 999     libvlc_time_t i_time;
1000
1001     p_input_thread = libvlc_get_input_thread ( p_mi );
1002     if( !p_input_thread )
1003         return -1;
1004
1005     i_time = from_mtime(var_GetTime( p_input_thread , "time" ));
1006     vlc_object_release( p_input_thread );
1007     return i_time;
1008 }
1009
1010 void libvlc_media_player_set_time( libvlc_media_player_t *p_mi,
1011                                    libvlc_time_t i_time )
1012 {
1013     input_thread_t *p_input_thread;
1014
1015     p_input_thread = libvlc_get_input_thread ( p_mi );
1016     if( !p_input_thread )
1017         return;
1018
1019     var_SetTime( p_input_thread, "time", to_mtime(i_time) );
1020     vlc_object_release( p_input_thread );
1021 }
1022
1023 void libvlc_media_player_set_position( libvlc_media_player_t *p_mi,
1024                                        float position )
1025 {
1026     input_thread_t *p_input_thread;
1027
1028     p_input_thread = libvlc_get_input_thread ( p_mi );
1029     if( !p_input_thread )
1030         return;
1031
1032     var_SetFloat( p_input_thread, "position", position );
1033     vlc_object_release( p_input_thread );
1034 }
1035
1036 float libvlc_media_player_get_position( libvlc_media_player_t *p_mi )
1037 {
1038     input_thread_t *p_input_thread;
1039     float f_position;
1040
1041     p_input_thread = libvlc_get_input_thread ( p_mi );
1042     if( !p_input_thread )
1043         return -1.0;
1044
1045     f_position = var_GetFloat( p_input_thread, "position" );
1046     vlc_object_release( p_input_thread );
1047
1048     return f_position;
1049 }
1050
1051 void libvlc_media_player_set_chapter( libvlc_media_player_t *p_mi,
1052                                       int chapter )
1053 {
1054     input_thread_t *p_input_thread;
1055
1056     p_input_thread = libvlc_get_input_thread ( p_mi );
1057     if( !p_input_thread )
1058         return;
1059
1060     var_SetInteger( p_input_thread, "chapter", chapter );
1061     vlc_object_release( p_input_thread );
1062 }
1063
1064 int libvlc_media_player_get_chapter( libvlc_media_player_t *p_mi )
1065 {
1066     input_thread_t *p_input_thread;
1067     int i_chapter;
1068
1069     p_input_thread = libvlc_get_input_thread ( p_mi );
1070     if( !p_input_thread )
1071         return -1;
1072
1073     i_chapter = var_GetInteger( p_input_thread, "chapter" );
1074     vlc_object_release( p_input_thread );
1075
1076     return i_chapter;
1077 }
1078
1079 int libvlc_media_player_get_chapter_count( libvlc_media_player_t *p_mi )
1080 {
1081     input_thread_t *p_input_thread;
1082     vlc_value_t val;
1083
1084     p_input_thread = libvlc_get_input_thread ( p_mi );
1085     if( !p_input_thread )
1086         return -1;
1087
1088     var_Change( p_input_thread, "chapter", VLC_VAR_CHOICESCOUNT, &val, NULL );
1089     vlc_object_release( p_input_thread );
1090
1091     return val.i_int;
1092 }
1093
1094 int libvlc_media_player_get_chapter_count_for_title(
1095                                  libvlc_media_player_t *p_mi,
1096                                  int i_title )
1097 {
1098     input_thread_t *p_input_thread;
1099     vlc_value_t val;
1100
1101     p_input_thread = libvlc_get_input_thread ( p_mi );
1102     if( !p_input_thread )
1103         return -1;
1104
1105     char *psz_name;
1106     if( asprintf( &psz_name,  "title %2i", i_title ) == -1 )
1107     {
1108         vlc_object_release( p_input_thread );
1109         return -1;
1110     }
1111     var_Change( p_input_thread, psz_name, VLC_VAR_CHOICESCOUNT, &val, NULL );
1112     vlc_object_release( p_input_thread );
1113     free( psz_name );
1114
1115     return val.i_int;
1116 }
1117
1118 void libvlc_media_player_set_title( libvlc_media_player_t *p_mi,
1119                                     int i_title )
1120 {
1121     input_thread_t *p_input_thread;
1122
1123     p_input_thread = libvlc_get_input_thread ( p_mi );
1124     if( !p_input_thread )
1125         return;
1126
1127     var_SetInteger( p_input_thread, "title", i_title );
1128     vlc_object_release( p_input_thread );
1129
1130     //send event
1131     libvlc_event_t event;
1132     event.type = libvlc_MediaPlayerTitleChanged;
1133     event.u.media_player_title_changed.new_title = i_title;
1134     libvlc_event_send( p_mi->p_event_manager, &event );
1135 }
1136
1137 int libvlc_media_player_get_title( libvlc_media_player_t *p_mi )
1138 {
1139     input_thread_t *p_input_thread;
1140     int i_title;
1141
1142     p_input_thread = libvlc_get_input_thread ( p_mi );
1143     if( !p_input_thread )
1144         return -1;
1145
1146     i_title = var_GetInteger( p_input_thread, "title" );
1147     vlc_object_release( p_input_thread );
1148
1149     return i_title;
1150 }
1151
1152 int libvlc_media_player_get_title_count( libvlc_media_player_t *p_mi )
1153 {
1154     input_thread_t *p_input_thread;
1155     vlc_value_t val;
1156
1157     p_input_thread = libvlc_get_input_thread ( p_mi );
1158     if( !p_input_thread )
1159         return -1;
1160
1161     var_Change( p_input_thread, "title", VLC_VAR_CHOICESCOUNT, &val, NULL );
1162     vlc_object_release( p_input_thread );
1163
1164     return val.i_int;
1165 }
1166
1167 void libvlc_media_player_next_chapter( libvlc_media_player_t *p_mi )
1168 {
1169     input_thread_t *p_input_thread;
1170
1171     p_input_thread = libvlc_get_input_thread ( p_mi );
1172     if( !p_input_thread )
1173         return;
1174
1175     int i_type = var_Type( p_input_thread, "next-chapter" );
1176     var_SetBool( p_input_thread, (i_type & VLC_VAR_TYPE) != 0 ?
1177                             "next-chapter":"next-title", true );
1178
1179     vlc_object_release( p_input_thread );
1180 }
1181
1182 void libvlc_media_player_previous_chapter( libvlc_media_player_t *p_mi )
1183 {
1184     input_thread_t *p_input_thread;
1185
1186     p_input_thread = libvlc_get_input_thread ( p_mi );
1187     if( !p_input_thread )
1188         return;
1189
1190     int i_type = var_Type( p_input_thread, "next-chapter" );
1191     var_SetBool( p_input_thread, (i_type & VLC_VAR_TYPE) != 0 ?
1192                             "prev-chapter":"prev-title", true );
1193
1194     vlc_object_release( p_input_thread );
1195 }
1196
1197 float libvlc_media_player_get_fps( libvlc_media_player_t *p_mi )
1198 {
1199     input_thread_t *p_input_thread = libvlc_get_input_thread ( p_mi );
1200     double f_fps = 0.0;
1201
1202     if( p_input_thread )
1203     {
1204         if( input_Control( p_input_thread, INPUT_GET_VIDEO_FPS, &f_fps ) )
1205             f_fps = 0.0;
1206         vlc_object_release( p_input_thread );
1207     }
1208     return f_fps;
1209 }
1210
1211 int libvlc_media_player_will_play( libvlc_media_player_t *p_mi )
1212 {
1213     bool b_will_play;
1214     input_thread_t *p_input_thread =
1215                             libvlc_get_input_thread ( p_mi );
1216     if ( !p_input_thread )
1217         return false;
1218
1219     b_will_play = !p_input_thread->b_die && !p_input_thread->b_dead;
1220     vlc_object_release( p_input_thread );
1221
1222     return b_will_play;
1223 }
1224
1225 int libvlc_media_player_set_rate( libvlc_media_player_t *p_mi, float rate )
1226 {
1227     if (rate < 0.)
1228     {
1229         libvlc_printerr ("Playing backward not supported");
1230         return -1;
1231     }
1232
1233     var_SetFloat (p_mi, "rate", rate);
1234
1235     input_thread_t *p_input_thread = libvlc_get_input_thread ( p_mi );
1236     if( !p_input_thread )
1237         return 0;
1238     var_SetFloat( p_input_thread, "rate", rate );
1239     vlc_object_release( p_input_thread );
1240     return 0;
1241 }
1242
1243 float libvlc_media_player_get_rate( libvlc_media_player_t *p_mi )
1244 {
1245     return var_GetFloat (p_mi, "rate");
1246 }
1247
1248 libvlc_state_t libvlc_media_player_get_state( libvlc_media_player_t *p_mi )
1249 {
1250     lock(p_mi);
1251     libvlc_state_t state = p_mi->state;
1252     unlock(p_mi);
1253     return state;
1254 }
1255
1256 int libvlc_media_player_is_seekable( libvlc_media_player_t *p_mi )
1257 {
1258     input_thread_t *p_input_thread;
1259     bool b_seekable;
1260
1261     p_input_thread = libvlc_get_input_thread ( p_mi );
1262     if ( !p_input_thread )
1263         return false;
1264     b_seekable = var_GetBool( p_input_thread, "can-seek" );
1265     vlc_object_release( p_input_thread );
1266
1267     return b_seekable;
1268 }
1269
1270 /* internal function, used by audio, video */
1271 libvlc_track_description_t *
1272         libvlc_get_track_description( libvlc_media_player_t *p_mi,
1273                                       const char *psz_variable )
1274 {
1275     input_thread_t *p_input = libvlc_get_input_thread( p_mi );
1276     libvlc_track_description_t *p_track_description = NULL,
1277                                *p_actual, *p_previous;
1278
1279     if( !p_input )
1280         return NULL;
1281
1282     vlc_value_t val_list, text_list;
1283     var_Change( p_input, psz_variable, VLC_VAR_GETLIST, &val_list, &text_list);
1284
1285     /* no tracks */
1286     if( val_list.p_list->i_count <= 0 )
1287         goto end;
1288
1289     p_track_description = ( libvlc_track_description_t * )
1290         malloc( sizeof( libvlc_track_description_t ) );
1291     if ( !p_track_description )
1292     {
1293         libvlc_printerr( "Not enough memory" );
1294         goto end;
1295     }
1296     p_actual = p_track_description;
1297     p_previous = NULL;
1298     for( int i = 0; i < val_list.p_list->i_count; i++ )
1299     {
1300         if( !p_actual )
1301         {
1302             p_actual = ( libvlc_track_description_t * )
1303                 malloc( sizeof( libvlc_track_description_t ) );
1304             if ( !p_actual )
1305             {
1306                 libvlc_track_description_release( p_track_description );
1307                 libvlc_printerr( "Not enough memory" );
1308                 goto end;
1309             }
1310         }
1311         p_actual->i_id = val_list.p_list->p_values[i].i_int;
1312         p_actual->psz_name = strdup( text_list.p_list->p_values[i].psz_string );
1313         p_actual->p_next = NULL;
1314         if( p_previous )
1315             p_previous->p_next = p_actual;
1316         p_previous = p_actual;
1317         p_actual =  NULL;
1318     }
1319
1320 end:
1321     var_FreeList( &val_list, &text_list );
1322     vlc_object_release( p_input );
1323
1324     return p_track_description;
1325 }
1326
1327 void libvlc_track_description_release( libvlc_track_description_t *p_td )
1328 {
1329     libvlc_track_description_t *p_actual, *p_before;
1330     p_actual = p_td;
1331
1332     while ( p_actual )
1333     {
1334         free( p_actual->psz_name );
1335         p_before = p_actual;
1336         p_actual = p_before->p_next;
1337         free( p_before );
1338     }
1339 }
1340
1341 int libvlc_media_player_can_pause( libvlc_media_player_t *p_mi )
1342 {
1343     input_thread_t *p_input_thread;
1344     bool b_can_pause;
1345
1346     p_input_thread = libvlc_get_input_thread ( p_mi );
1347     if ( !p_input_thread )
1348         return false;
1349     b_can_pause = var_GetBool( p_input_thread, "can-pause" );
1350     vlc_object_release( p_input_thread );
1351
1352     return b_can_pause;
1353 }
1354
1355 void libvlc_media_player_next_frame( libvlc_media_player_t *p_mi )
1356 {
1357     input_thread_t *p_input_thread = libvlc_get_input_thread ( p_mi );
1358     if( p_input_thread != NULL )
1359     {
1360         var_TriggerCallback( p_input_thread, "frame-next" );
1361         vlc_object_release( p_input_thread );
1362     }
1363 }