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     var_Create (mp, "vbi-page", VLC_VAR_INTEGER);
 369
 370      /* Audio */
 371     var_Create (mp, "aout", VLC_VAR_STRING | VLC_VAR_DOINHERIT);
 372
 373     mp->p_md = NULL;
 374     mp->state = libvlc_NothingSpecial;
 375     mp->p_libvlc_instance = instance;
 376     mp->p_input_thread = NULL;
 377     mp->p_input_resource = NULL;
 378     mp->i_refcount = 1;
 379     mp->p_event_manager = libvlc_event_manager_new(mp, instance);
 380     if (unlikely(mp->p_event_manager == NULL))
 381     {
 382         vlc_object_release(mp);
 383         return NULL;
 384     }
 385     vlc_mutex_init(&mp->object_lock);
 386
 387     register_event(mp, NothingSpecial);
 388     register_event(mp, Opening);
 389     register_event(mp, Buffering);
 390     register_event(mp, Playing);
 391     register_event(mp, Paused);
 392     register_event(mp, Stopped);
 393     register_event(mp, Forward);
 394     register_event(mp, Backward);
 395     register_event(mp, EndReached);
 396     register_event(mp, EncounteredError);
 397     register_event(mp, SeekableChanged);
 398
 399     register_event(mp, PositionChanged);
 400     register_event(mp, TimeChanged);
 401     register_event(mp, LengthChanged);
 402     register_event(mp, TitleChanged);
 403     register_event(mp, PausableChanged);
 404
 405     /* Snapshot initialization */
 406     register_event(mp, SnapshotTaken);
 407
 408     register_event(mp, MediaChanged);
 409
 410     /* Attach a var callback to the global object to provide the glue between
 411      * vout_thread that generates the event and media_player that re-emits it
 412      * with its own event manager
 413      *
 414      * FIXME: It's unclear why we want to put this in public API, and why we
 415      * want to expose it in such a limiting and ugly way.
 416      */
 417     var_AddCallback(mp->p_libvlc, "snapshot-file", snapshot_was_taken, mp);
 418
 419     libvlc_retain(instance);
 420     return mp;
 421 }
 422
 423 /**************************************************************************
 424  * Create a Media Instance object with a media descriptor.
 425  **************************************************************************/
 426 libvlc_media_player_t *
 427 libvlc_media_player_new_from_media( libvlc_media_t * p_md )
 428 {
 429     libvlc_media_player_t * p_mi;
 430
 431     p_mi = libvlc_media_player_new( p_md->p_libvlc_instance );
 432     if( !p_mi )
 433         return NULL;
 434
 435     libvlc_media_retain( p_md );
 436     p_mi->p_md = p_md;
 437
 438     return p_mi;
 439 }
 440
 441 /**************************************************************************
 442  * Destroy a Media Instance object (libvlc internal)
 443  *
 444  * Warning: No lock held here, but hey, this is internal. Caller must lock.
 445  **************************************************************************/
 446 static void libvlc_media_player_destroy( libvlc_media_player_t *p_mi )
 447 {
 448     assert( p_mi );
 449
 450     /* Detach Callback from the main libvlc object */
 451     var_DelCallback( p_mi->p_libvlc,
 452                      "snapshot-file", snapshot_was_taken, p_mi );
 453
 454     /* If the input thread hasn't been already deleted it means
 455      * that the owners didn't stop the thread before releasing it. */
 456     assert(!p_mi->p_input_thread);
 457
 458     /* Fallback for those who don't use NDEBUG */
 459     if (p_mi->p_input_thread)
 460         release_input_thread(p_mi, true);
 461
 462     if( p_mi->p_input_resource )
 463     {
 464         input_resource_Delete( p_mi->p_input_resource );
 465         p_mi->p_input_resource = NULL;
 466     }
 467
 468     libvlc_event_manager_release( p_mi->p_event_manager );
 469     libvlc_media_release( p_mi->p_md );
 470     vlc_mutex_destroy( &p_mi->object_lock );
 471
 472     libvlc_instance_t *instance = p_mi->p_libvlc_instance;
 473     vlc_object_release( p_mi );
 474     libvlc_release(instance);
 475 }
 476
 477 /**************************************************************************
 478  * Release a Media Instance object.
 479  *
 480  * Function does the locking.
 481  **************************************************************************/
 482 void libvlc_media_player_release( libvlc_media_player_t *p_mi )
 483 {
 484     bool destroy;
 485
 486     assert( p_mi );
 487     lock(p_mi);
 488     destroy = !--p_mi->i_refcount;
 489     unlock(p_mi);
 490
 491     if( destroy )
 492         libvlc_media_player_destroy( p_mi );
 493 }
 494
 495 /**************************************************************************
 496  * Retain a Media Instance object.
 497  *
 498  * Caller must hold the lock.
 499  **************************************************************************/
 500 void libvlc_media_player_retain( libvlc_media_player_t *p_mi )
 501 {
 502     assert( p_mi );
 503
 504     lock(p_mi);
 505     p_mi->i_refcount++;
 506     unlock(p_mi);
 507 }
 508
 509 /**************************************************************************
 510  * Set the Media descriptor associated with the instance.
 511  *
 512  * Enter without lock -- function will lock the object.
 513  **************************************************************************/
 514 void libvlc_media_player_set_media(
 515                             libvlc_media_player_t *p_mi,
 516                             libvlc_media_t *p_md )
 517 {
 518     lock(p_mi);
 519
 520     /* FIXME I am not sure if it is a user request or on die(eof/error)
 521      * request here */
 522     release_input_thread( p_mi,
 523                           p_mi->p_input_thread &&
 524                           !p_mi->p_input_thread->b_eof &&
 525                           !p_mi->p_input_thread->b_error );
 526
 527     set_state( p_mi, libvlc_NothingSpecial, true );
 528
 529     libvlc_media_release( p_mi->p_md );
 530
 531     if( !p_md )
 532     {
 533         p_mi->p_md = NULL;
 534         unlock(p_mi);
 535         return; /* It is ok to pass a NULL md */
 536     }
 537
 538     libvlc_media_retain( p_md );
 539     p_mi->p_md = p_md;
 540
 541     /* The policy here is to ignore that we were created using a different
 542      * libvlc_instance, because we don't really care */
 543     p_mi->p_libvlc_instance = p_md->p_libvlc_instance;
 544
 545     unlock(p_mi);
 546
 547     /* Send an event for the newly available media */
 548     libvlc_event_t event;
 549     event.type = libvlc_MediaPlayerMediaChanged;
 550     event.u.media_player_media_changed.new_media = p_md;
 551     libvlc_event_send( p_mi->p_event_manager, &event );
 552
 553 }
 554
 555 /**************************************************************************
 556  * Get the Media descriptor associated with the instance.
 557  **************************************************************************/
 558 libvlc_media_t *
 559 libvlc_media_player_get_media( libvlc_media_player_t *p_mi )
 560 {
 561     libvlc_media_t *p_m;
 562
 563     lock(p_mi);
 564     p_m = p_mi->p_md;
 565     if( p_m )
 566         libvlc_media_retain( p_mi->p_md );
 567     unlock(p_mi);
 568     return p_mi->p_md;
 569 }
 570
 571 /**************************************************************************
 572  * Get the event Manager.
 573  **************************************************************************/
 574 libvlc_event_manager_t *
 575 libvlc_media_player_event_manager( libvlc_media_player_t *p_mi )
 576 {
 577     return p_mi->p_event_manager;
 578 }
 579
 580 /**************************************************************************
 581  * Tell media player to start playing.
 582  **************************************************************************/
 583 int libvlc_media_player_play( libvlc_media_player_t *p_mi )
 584 {
 585     input_thread_t * p_input_thread;
 586
 587     if( (p_input_thread = libvlc_get_input_thread( p_mi )) )
 588     {
 589         /* A thread already exists, send it a play message */
 590         input_Control( p_input_thread, INPUT_SET_STATE, PLAYING_S );
 591         vlc_object_release( p_input_thread );
 592         return 0;
 593     }
 594
 595     /* Ignore previous exception */
 596     lock(p_mi);
 597
 598     if( !p_mi->p_md )
 599     {
 600         unlock(p_mi);
 601         libvlc_printerr( "No associated media descriptor" );
 602         return -1;
 603     }
 604
 605     p_mi->p_input_thread = input_Create( p_mi,
 606                                          p_mi->p_md->p_input_item, NULL,
 607                                          p_mi->p_input_resource );
 608     if( !p_mi->p_input_thread )
 609     {
 610         unlock(p_mi);
 611         libvlc_printerr( "Not enough memory" );
 612         return -1;
 613     }
 614
 615     p_mi->p_input_resource = NULL;
 616     p_input_thread = p_mi->p_input_thread;
 617
 618     var_AddCallback( p_input_thread, "can-seek", input_seekable_changed, p_mi );
 619     var_AddCallback( p_input_thread, "can-pause", input_pausable_changed, p_mi );
 620     var_AddCallback( p_input_thread, "intf-event", input_event_changed, p_mi );
 621
 622     if( input_Start( p_input_thread ) )
 623     {
 624         vlc_object_release( p_input_thread );
 625         p_mi->p_input_thread = NULL;
 626     }
 627
 628     unlock(p_mi);
 629     return 0;
 630 }
 631
 632 /**************************************************************************
 633  * Pause.
 634  **************************************************************************/
 635 void libvlc_media_player_pause( libvlc_media_player_t *p_mi )
 636 {
 637     input_thread_t * p_input_thread = libvlc_get_input_thread( p_mi );
 638     if( !p_input_thread )
 639         return;
 640
 641     libvlc_state_t state = libvlc_media_player_get_state( p_mi );
 642     if( state == libvlc_Playing || state == libvlc_Buffering )
 643     {
 644         if( libvlc_media_player_can_pause( p_mi ) )
 645             input_Control( p_input_thread, INPUT_SET_STATE, PAUSE_S );
 646         else
 647             libvlc_media_player_stop( p_mi );
 648     }
 649     else
 650         input_Control( p_input_thread, INPUT_SET_STATE, PLAYING_S );
 651
 652     vlc_object_release( p_input_thread );
 653 }
 654
 655 /**************************************************************************
 656  * Tells whether the media player is currently playing.
 657  *
 658  * Enter with lock held.
 659  **************************************************************************/
 660 int libvlc_media_player_is_playing( libvlc_media_player_t *p_mi )
 661 {
 662     libvlc_state_t state = libvlc_media_player_get_state( p_mi );
 663     return (libvlc_Playing == state) || (libvlc_Buffering == state);
 664 }
 665
 666 /**************************************************************************
 667  * Stop playing.
 668  **************************************************************************/
 669 void libvlc_media_player_stop( libvlc_media_player_t *p_mi )
 670 {
 671     libvlc_state_t state = libvlc_media_player_get_state( p_mi );
 672
 673     lock(p_mi);
 674     release_input_thread( p_mi, true ); /* This will stop the input thread */
 675     unlock(p_mi);
 676
 677     /* Force to go to stopped state, in case we were in Ended, or Error
 678      * state. */
 679     if( state != libvlc_Stopped )
 680     {
 681         set_state( p_mi, libvlc_Stopped, false );
 682
 683         /* Construct and send the event */
 684         libvlc_event_t event;
 685         event.type = libvlc_MediaPlayerStopped;
 686         libvlc_event_send( p_mi->p_event_manager, &event );
 687     }
 688 }
 689
 690 /**************************************************************************
 691  * set_nsobject
 692  **************************************************************************/
 693 void libvlc_media_player_set_nsobject( libvlc_media_player_t *p_mi,
 694                                         void * drawable )
 695 {
 696     assert (p_mi != NULL);
 697 #ifdef __APPLE__
 698     var_SetAddress (p_mi, "drawable-nsobject", drawable);
 699 #else
 700     (void) p_mi; (void)drawable;
 701 #endif
 702 }
 703
 704 /**************************************************************************
 705  * get_nsobject
 706  **************************************************************************/
 707 void * libvlc_media_player_get_nsobject( libvlc_media_player_t *p_mi )
 708 {
 709     assert (p_mi != NULL);
 710 #ifdef __APPLE__
 711     return var_GetAddress (p_mi, "drawable-nsobject");
 712 #else
 713     return NULL;
 714 #endif
 715 }
 716
 717 /**************************************************************************
 718  * set_agl
 719  **************************************************************************/
 720 void libvlc_media_player_set_agl( libvlc_media_player_t *p_mi,
 721                                   uint32_t drawable )
 722 {
 723 #ifdef __APPLE__
 724     var_SetInteger (p_mi, "drawable-agl", drawable);
 725 #else
 726     (void) p_mi; (void)drawable;
 727 #endif
 728 }
 729
 730 /**************************************************************************
 731  * get_agl
 732  **************************************************************************/
 733 uint32_t libvlc_media_player_get_agl( libvlc_media_player_t *p_mi )
 734 {
 735     assert (p_mi != NULL);
 736 #ifdef __APPLE__
 737     return var_GetInteger (p_mi, "drawable-agl");
 738 #else
 739     return 0;
 740 #endif
 741 }
 742
 743 /**************************************************************************
 744  * set_xwindow
 745  **************************************************************************/
 746 void libvlc_media_player_set_xwindow( libvlc_media_player_t *p_mi,
 747                                       uint32_t drawable )
 748 {
 749     assert (p_mi != NULL);
 750     var_SetInteger (p_mi, "drawable-xid", drawable);
 751 }
 752
 753 /**************************************************************************
 754  * get_xwindow
 755  **************************************************************************/
 756 uint32_t libvlc_media_player_get_xwindow( libvlc_media_player_t *p_mi )
 757 {
 758     return var_GetInteger (p_mi, "drawable-xid");
 759 }
 760
 761 /**************************************************************************
 762  * set_hwnd
 763  **************************************************************************/
 764 void libvlc_media_player_set_hwnd( libvlc_media_player_t *p_mi,
 765                                    void *drawable )
 766 {
 767     assert (p_mi != NULL);
 768 #ifdef WIN32
 769     var_SetAddress (p_mi, "drawable-hwnd", drawable);
 770 #else
 771     (void) p_mi; (void) drawable;
 772 #endif
 773 }
 774
 775 /**************************************************************************
 776  * get_hwnd
 777  **************************************************************************/
 778 void *libvlc_media_player_get_hwnd( libvlc_media_player_t *p_mi )
 779 {
 780     assert (p_mi != NULL);
 781 #ifdef WIN32
 782     return var_GetAddress (p_mi, "drawable-hwnd");
 783 #else
 784     return NULL;
 785 #endif
 786 }
 787
 788 /**************************************************************************
 789  * Getters for stream information
 790  **************************************************************************/
 791 libvlc_time_t libvlc_media_player_get_length(
 792                              libvlc_media_player_t *p_mi )
 793 {
 794     input_thread_t *p_input_thread;
 795     libvlc_time_t i_time;
 796
 797     p_input_thread = libvlc_get_input_thread ( p_mi );
 798     if( !p_input_thread )
 799         return -1;
 800
 801     i_time = from_mtime(var_GetTime( p_input_thread, "length" ));
 802     vlc_object_release( p_input_thread );
 803
 804     return i_time;
 805 }
 806
 807 libvlc_time_t libvlc_media_player_get_time( libvlc_media_player_t *p_mi )
 808 {
 809     input_thread_t *p_input_thread;
 810     libvlc_time_t i_time;
 811
 812     p_input_thread = libvlc_get_input_thread ( p_mi );
 813     if( !p_input_thread )
 814         return -1;
 815
 816     i_time = from_mtime(var_GetTime( p_input_thread , "time" ));
 817     vlc_object_release( p_input_thread );
 818     return i_time;
 819 }
 820
 821 void libvlc_media_player_set_time( libvlc_media_player_t *p_mi,
 822                                    libvlc_time_t i_time )
 823 {
 824     input_thread_t *p_input_thread;
 825
 826     p_input_thread = libvlc_get_input_thread ( p_mi );
 827     if( !p_input_thread )
 828         return;
 829
 830     var_SetTime( p_input_thread, "time", to_mtime(i_time) );
 831     vlc_object_release( p_input_thread );
 832 }
 833
 834 void libvlc_media_player_set_position( libvlc_media_player_t *p_mi,
 835                                        float position )
 836 {
 837     input_thread_t *p_input_thread;
 838
 839     p_input_thread = libvlc_get_input_thread ( p_mi );
 840     if( !p_input_thread )
 841         return;
 842
 843     var_SetFloat( p_input_thread, "position", position );
 844     vlc_object_release( p_input_thread );
 845 }
 846
 847 float libvlc_media_player_get_position( libvlc_media_player_t *p_mi )
 848 {
 849     input_thread_t *p_input_thread;
 850     float f_position;
 851
 852     p_input_thread = libvlc_get_input_thread ( p_mi );
 853     if( !p_input_thread )
 854         return -1.0;
 855
 856     f_position = var_GetFloat( p_input_thread, "position" );
 857     vlc_object_release( p_input_thread );
 858
 859     return f_position;
 860 }
 861
 862 void libvlc_media_player_set_chapter( libvlc_media_player_t *p_mi,
 863                                       int chapter )
 864 {
 865     input_thread_t *p_input_thread;
 866
 867     p_input_thread = libvlc_get_input_thread ( p_mi );
 868     if( !p_input_thread )
 869         return;
 870
 871     var_SetInteger( p_input_thread, "chapter", chapter );
 872     vlc_object_release( p_input_thread );
 873 }
 874
 875 int libvlc_media_player_get_chapter( libvlc_media_player_t *p_mi )
 876 {
 877     input_thread_t *p_input_thread;
 878     int i_chapter;
 879
 880     p_input_thread = libvlc_get_input_thread ( p_mi );
 881     if( !p_input_thread )
 882         return -1;
 883
 884     i_chapter = var_GetInteger( p_input_thread, "chapter" );
 885     vlc_object_release( p_input_thread );
 886
 887     return i_chapter;
 888 }
 889
 890 int libvlc_media_player_get_chapter_count( libvlc_media_player_t *p_mi )
 891 {
 892     input_thread_t *p_input_thread;
 893     vlc_value_t val;
 894
 895     p_input_thread = libvlc_get_input_thread ( p_mi );
 896     if( !p_input_thread )
 897         return -1;
 898
 899     var_Change( p_input_thread, "chapter", VLC_VAR_CHOICESCOUNT, &val, NULL );
 900     vlc_object_release( p_input_thread );
 901
 902     return val.i_int;
 903 }
 904
 905 int libvlc_media_player_get_chapter_count_for_title(
 906                                  libvlc_media_player_t *p_mi,
 907                                  int i_title )
 908 {
 909     input_thread_t *p_input_thread;
 910     vlc_value_t val;
 911
 912     p_input_thread = libvlc_get_input_thread ( p_mi );
 913     if( !p_input_thread )
 914         return -1;
 915
 916     char *psz_name;
 917     if( asprintf( &psz_name,  "title %2i", i_title ) == -1 )
 918     {
 919         vlc_object_release( p_input_thread );
 920         return -1;
 921     }
 922     var_Change( p_input_thread, psz_name, VLC_VAR_CHOICESCOUNT, &val, NULL );
 923     vlc_object_release( p_input_thread );
 924     free( psz_name );
 925
 926     return val.i_int;
 927 }
 928
 929 void libvlc_media_player_set_title( libvlc_media_player_t *p_mi,
 930                                     int i_title )
 931 {
 932     input_thread_t *p_input_thread;
 933
 934     p_input_thread = libvlc_get_input_thread ( p_mi );
 935     if( !p_input_thread )
 936         return;
 937
 938     var_SetInteger( p_input_thread, "title", i_title );
 939     vlc_object_release( p_input_thread );
 940
 941     //send event
 942     libvlc_event_t event;
 943     event.type = libvlc_MediaPlayerTitleChanged;
 944     event.u.media_player_title_changed.new_title = i_title;
 945     libvlc_event_send( p_mi->p_event_manager, &event );
 946 }
 947
 948 int libvlc_media_player_get_title( libvlc_media_player_t *p_mi )
 949 {
 950     input_thread_t *p_input_thread;
 951     int i_title;
 952
 953     p_input_thread = libvlc_get_input_thread ( p_mi );
 954     if( !p_input_thread )
 955         return -1;
 956
 957     i_title = var_GetInteger( p_input_thread, "title" );
 958     vlc_object_release( p_input_thread );
 959
 960     return i_title;
 961 }
 962
 963 int libvlc_media_player_get_title_count( libvlc_media_player_t *p_mi )
 964 {
 965     input_thread_t *p_input_thread;
 966     vlc_value_t val;
 967
 968     p_input_thread = libvlc_get_input_thread ( p_mi );
 969     if( !p_input_thread )
 970         return -1;
 971
 972     var_Change( p_input_thread, "title", VLC_VAR_CHOICESCOUNT, &val, NULL );
 973     vlc_object_release( p_input_thread );
 974
 975     return val.i_int;
 976 }
 977
 978 void libvlc_media_player_next_chapter( libvlc_media_player_t *p_mi )
 979 {
 980     input_thread_t *p_input_thread;
 981
 982     p_input_thread = libvlc_get_input_thread ( p_mi );
 983     if( !p_input_thread )
 984         return;
 985
 986     int i_type = var_Type( p_input_thread, "next-chapter" );
 987     var_SetBool( p_input_thread, (i_type & VLC_VAR_TYPE) != 0 ?
 988                             "next-chapter":"next-title", true );
 989
 990     vlc_object_release( p_input_thread );
 991 }
 992
 993 void libvlc_media_player_previous_chapter( libvlc_media_player_t *p_mi )
 994 {
 995     input_thread_t *p_input_thread;
 996
 997     p_input_thread = libvlc_get_input_thread ( p_mi );
 998     if( !p_input_thread )
 999         return;
1000
1001     int i_type = var_Type( p_input_thread, "next-chapter" );
1002     var_SetBool( p_input_thread, (i_type & VLC_VAR_TYPE) != 0 ?
1003                             "prev-chapter":"prev-title", true );
1004
1005     vlc_object_release( p_input_thread );
1006 }
1007
1008 float libvlc_media_player_get_fps( libvlc_media_player_t *p_mi )
1009 {
1010     input_thread_t *p_input_thread = libvlc_get_input_thread ( p_mi );
1011     double f_fps = 0.0;
1012
1013     if( p_input_thread )
1014     {
1015         if( input_Control( p_input_thread, INPUT_GET_VIDEO_FPS, &f_fps ) )
1016             f_fps = 0.0;
1017         vlc_object_release( p_input_thread );
1018     }
1019     return f_fps;
1020 }
1021
1022 int libvlc_media_player_will_play( libvlc_media_player_t *p_mi )
1023 {
1024     bool b_will_play;
1025     input_thread_t *p_input_thread =
1026                             libvlc_get_input_thread ( p_mi );
1027     if ( !p_input_thread )
1028         return false;
1029
1030     b_will_play = !p_input_thread->b_die && !p_input_thread->b_dead;
1031     vlc_object_release( p_input_thread );
1032
1033     return b_will_play;
1034 }
1035
1036 int libvlc_media_player_set_rate( libvlc_media_player_t *p_mi, float rate )
1037 {
1038     input_thread_t *p_input_thread;
1039     bool b_can_rewind;
1040
1041     p_input_thread = libvlc_get_input_thread ( p_mi );
1042     if( !p_input_thread )
1043         return -1;
1044
1045     b_can_rewind = var_GetBool( p_input_thread, "can-rewind" );
1046     if( (rate < 0.0) && !b_can_rewind )
1047     {
1048         vlc_object_release( p_input_thread );
1049         libvlc_printerr( "Invalid playback rate" );
1050         return -1;
1051     }
1052
1053     var_SetFloat( p_input_thread, "rate", rate );
1054     vlc_object_release( p_input_thread );
1055     return 0;
1056 }
1057
1058 float libvlc_media_player_get_rate( libvlc_media_player_t *p_mi )
1059 {
1060     input_thread_t *p_input_thread;
1061     float f_rate;
1062     bool b_can_rewind;
1063
1064     p_input_thread = libvlc_get_input_thread ( p_mi );
1065     if( !p_input_thread )
1066         return 0.0;  /* rate < 0 indicates rewind */
1067
1068     f_rate = var_GetFloat( p_input_thread, "rate" );
1069     b_can_rewind = var_GetBool( p_input_thread, "can-rewind" );
1070     /* FIXME: why are negative values forbidden ?? (rewinding) */
1071     if( f_rate < 0 && !b_can_rewind )
1072     {
1073         vlc_object_release( p_input_thread );
1074         return 0.0;
1075     }
1076     vlc_object_release( p_input_thread );
1077
1078     return f_rate;
1079 }
1080
1081 libvlc_state_t libvlc_media_player_get_state( libvlc_media_player_t *p_mi )
1082 {
1083     lock(p_mi);
1084     libvlc_state_t state = p_mi->state;
1085     unlock(p_mi);
1086     return state;
1087 }
1088
1089 int libvlc_media_player_is_seekable( libvlc_media_player_t *p_mi )
1090 {
1091     input_thread_t *p_input_thread;
1092     bool b_seekable;
1093
1094     p_input_thread = libvlc_get_input_thread ( p_mi );
1095     if ( !p_input_thread )
1096         return false;
1097     b_seekable = var_GetBool( p_input_thread, "can-seek" );
1098     vlc_object_release( p_input_thread );
1099
1100     return b_seekable;
1101 }
1102
1103 /* internal function, used by audio, video */
1104 libvlc_track_description_t *
1105         libvlc_get_track_description( libvlc_media_player_t *p_mi,
1106                                       const char *psz_variable )
1107 {
1108     input_thread_t *p_input = libvlc_get_input_thread( p_mi );
1109     libvlc_track_description_t *p_track_description = NULL,
1110                                *p_actual, *p_previous;
1111
1112     if( !p_input )
1113         return NULL;
1114
1115     vlc_value_t val_list, text_list;
1116     var_Change( p_input, psz_variable, VLC_VAR_GETLIST, &val_list, &text_list);
1117
1118     /* no tracks */
1119     if( val_list.p_list->i_count <= 0 )
1120         goto end;
1121
1122     p_track_description = ( libvlc_track_description_t * )
1123         malloc( sizeof( libvlc_track_description_t ) );
1124     if ( !p_track_description )
1125     {
1126         libvlc_printerr( "Not enough memory" );
1127         goto end;
1128     }
1129     p_actual = p_track_description;
1130     p_previous = NULL;
1131     for( int i = 0; i < val_list.p_list->i_count; i++ )
1132     {
1133         if( !p_actual )
1134         {
1135             p_actual = ( libvlc_track_description_t * )
1136                 malloc( sizeof( libvlc_track_description_t ) );
1137             if ( !p_actual )
1138             {
1139                 libvlc_track_description_release( p_track_description );
1140                 libvlc_printerr( "Not enough memory" );
1141                 goto end;
1142             }
1143         }
1144         p_actual->i_id = val_list.p_list->p_values[i].i_int;
1145         p_actual->psz_name = strdup( text_list.p_list->p_values[i].psz_string );
1146         p_actual->p_next = NULL;
1147         if( p_previous )
1148             p_previous->p_next = p_actual;
1149         p_previous = p_actual;
1150         p_actual =  NULL;
1151     }
1152
1153 end:
1154     var_FreeList( &val_list, &text_list );
1155     vlc_object_release( p_input );
1156
1157     return p_track_description;
1158 }
1159
1160 void libvlc_track_description_release( libvlc_track_description_t *p_td )
1161 {
1162     libvlc_track_description_t *p_actual, *p_before;
1163     p_actual = p_td;
1164
1165     while ( p_actual )
1166     {
1167         free( p_actual->psz_name );
1168         p_before = p_actual;
1169         p_actual = p_before->p_next;
1170         free( p_before );
1171     }
1172 }
1173
1174 int libvlc_media_player_can_pause( libvlc_media_player_t *p_mi )
1175 {
1176     input_thread_t *p_input_thread;
1177     bool b_can_pause;
1178
1179     p_input_thread = libvlc_get_input_thread ( p_mi );
1180     if ( !p_input_thread )
1181         return false;
1182     b_can_pause = var_GetBool( p_input_thread, "can-pause" );
1183     vlc_object_release( p_input_thread );
1184
1185     return b_can_pause;
1186 }
1187
1188 void libvlc_media_player_next_frame( libvlc_media_player_t *p_mi )
1189 {
1190     input_thread_t *p_input_thread = libvlc_get_input_thread ( p_mi );
1191     if( p_input_thread != NULL )
1192     {
1193         var_TriggerCallback( p_input_thread, "frame-next" );
1194         vlc_object_release( p_input_thread );
1195     }
1196 }