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