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

   1 /*****************************************************************************
   2  * media_instance.c: Libvlc API Media Instance management functions
   3  *****************************************************************************
   4  * Copyright (C) 2005 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 #include <vlc/libvlc.h>
  25 #include <vlc_demux.h>
  26 #include <vlc_input.h>
  27 #include "libvlc_internal.h"
  28 #include "libvlc.h"
  29
  30 static const libvlc_state_t vlc_to_libvlc_state_array[] =
  31 {
  32     [INIT_S]        = libvlc_Opening,
  33     [OPENING_S]     = libvlc_Opening,
  34     [BUFFERING_S]   = libvlc_Buffering,
  35     [PLAYING_S]     = libvlc_Playing,
  36     [PAUSE_S]       = libvlc_Paused,
  37     [END_S]         = libvlc_Ended,
  38     [ERROR_S]       = libvlc_Error,
  39 };
  40 static inline libvlc_state_t vlc_to_libvlc_state( int vlc_state )
  41 {
  42     if( vlc_state < 0 || vlc_state > 6 )
  43         return libvlc_Stopped;
  44
  45     return vlc_to_libvlc_state_array[vlc_state];
  46 }
  47
  48 /*
  49  * Release the associated input thread
  50  *
  51  * Object lock is NOT held.
  52  */
  53 static void release_input_thread( libvlc_media_instance_t *p_mi )
  54 {
  55     input_thread_t *p_input_thread;
  56
  57     if( !p_mi || p_mi->i_input_id == -1 )
  58         return;
  59
  60     p_input_thread = (input_thread_t*)vlc_object_get(
  61                                              p_mi->p_libvlc_instance->p_libvlc_int,
  62                                              p_mi->i_input_id );
  63
  64     p_mi->i_input_id = -1;
  65
  66     if( !p_input_thread )
  67         return;
  68
  69     /* release for previous vlc_object_get */
  70     vlc_object_release( p_input_thread );
  71
  72     /* release for initial p_input_thread yield (see _new()) */
  73     vlc_object_release( p_input_thread );
  74
  75     /* No one is tracking this input_thread appart us. Destroy it */
  76     if( p_mi->b_own_its_input_thread )
  77     {
  78         /* We owned this one */
  79         input_StopThread( p_input_thread );
  80         var_Destroy( p_input_thread, "drawable" );
  81         input_DestroyThread( p_input_thread );
  82     }
  83     else
  84     {
  85         /* XXX: hack the playlist doesn't retain the input thread,
  86          * so we did it for the playlist (see _new_from_input_thread),
  87          * revert that here. This will be deleted with the playlist API */
  88         vlc_object_release( p_input_thread );
  89     }
  90 }
  91
  92 /*
  93  * Retrieve the input thread. Be sure to release the object
  94  * once you are done with it. (libvlc Internal)
  95  *
  96  * Object lock is held.
  97  */
  98 input_thread_t *libvlc_get_input_thread( libvlc_media_instance_t *p_mi,
  99                                          libvlc_exception_t *p_e )
 100 {
 101     input_thread_t *p_input_thread;
 102
 103     vlc_mutex_lock( &p_mi->object_lock );
 104
 105     if( !p_mi || p_mi->i_input_id == -1 )
 106     {
 107         vlc_mutex_unlock( &p_mi->object_lock );
 108         RAISENULL( "Input is NULL" );
 109     }
 110
 111     p_input_thread = (input_thread_t*)vlc_object_get(
 112                                              p_mi->p_libvlc_instance->p_libvlc_int,
 113                                              p_mi->i_input_id );
 114     if( !p_input_thread )
 115     {
 116         vlc_mutex_unlock( &p_mi->object_lock );
 117         RAISENULL( "Input does not exist" );
 118     }
 119
 120     vlc_mutex_unlock( &p_mi->object_lock );
 121     return p_input_thread;
 122 }
 123
 124 /*
 125  * input_state_changed (Private) (input var "state" Callback)
 126  */
 127 static int
 128 input_state_changed( vlc_object_t * p_this, char const * psz_cmd,
 129                      vlc_value_t oldval, vlc_value_t newval,
 130                      void * p_userdata )
 131 {
 132     libvlc_media_instance_t * p_mi = p_userdata;
 133     libvlc_event_t event;
 134
 135     if( newval.i_int == oldval.i_int )
 136         return VLC_SUCCESS; /* No change since last time, don't propagate */
 137
 138     switch ( newval.i_int )
 139     {
 140         case END_S:
 141             libvlc_media_descriptor_set_state( p_mi->p_md, libvlc_NothingSpecial, NULL);
 142             event.type = libvlc_MediaInstanceReachedEnd;
 143             break;
 144         case PAUSE_S:
 145             libvlc_media_descriptor_set_state( p_mi->p_md, libvlc_Playing, NULL);
 146             event.type = libvlc_MediaInstancePaused;
 147             break;
 148         case PLAYING_S:
 149             libvlc_media_descriptor_set_state( p_mi->p_md, libvlc_Playing, NULL);
 150             event.type = libvlc_MediaInstancePlayed;
 151             break;
 152         case ERROR_S:
 153             libvlc_media_descriptor_set_state( p_mi->p_md, libvlc_Error, NULL);
 154             event.type = libvlc_MediaInstanceReachedEnd; /* Because ERROR_S is buggy */
 155             break;
 156         default:
 157             return VLC_SUCCESS;
 158     }
 159
 160     libvlc_event_send( p_mi->p_event_manager, &event );
 161     return VLC_SUCCESS;
 162 }
 163
 164 /*
 165  * input_position_changed (Private) (input var "intf-change" Callback)
 166  */
 167 static int
 168 input_position_changed( vlc_object_t * p_this, char const * psz_cmd,
 169                      vlc_value_t oldval, vlc_value_t newval,
 170                      void * p_userdata )
 171 {
 172     libvlc_media_instance_t * p_mi = p_userdata;
 173     vlc_value_t val;
 174
 175     if (!strncmp(psz_cmd, "intf", 4 /* "-change" no need to go further */))
 176     {
 177         input_thread_t * p_input = (input_thread_t *)p_this;
 178
 179         var_Get( p_input, "state", &val );
 180         if( val.i_int != PLAYING_S )
 181             return VLC_SUCCESS; /* Don't send the position while stopped */
 182
 183         var_Get( p_input, "position", &val );
 184     }
 185     else
 186         val.i_time = newval.i_time;
 187
 188     libvlc_event_t event;
 189     event.type = libvlc_MediaInstancePositionChanged;
 190     event.u.media_instance_position_changed.new_position = val.f_float;
 191
 192     libvlc_event_send( p_mi->p_event_manager, &event );
 193     return VLC_SUCCESS;
 194 }
 195
 196 /*
 197  * input_time_changed (Private) (input var "intf-change" Callback)
 198  */
 199 static int
 200 input_time_changed( vlc_object_t * p_this, char const * psz_cmd,
 201                      vlc_value_t oldval, vlc_value_t newval,
 202                      void * p_userdata )
 203 {
 204     libvlc_media_instance_t * p_mi = p_userdata;
 205     vlc_value_t val;
 206
 207     if (!strncmp(psz_cmd, "intf", 4 /* "-change" no need to go further */))
 208     {
 209         input_thread_t * p_input = (input_thread_t *)p_this;
 210
 211         var_Get( p_input, "state", &val );
 212         if( val.i_int != PLAYING_S )
 213             return VLC_SUCCESS; /* Don't send the position while stopped */
 214
 215         var_Get( p_input, "time", &val );
 216     }
 217     else
 218         val.i_time = newval.i_time;
 219
 220     libvlc_event_t event;
 221     event.type = libvlc_MediaInstanceTimeChanged;
 222     event.u.media_instance_time_changed.new_time = val.i_time;
 223
 224     libvlc_event_send( p_mi->p_event_manager, &event );
 225     return VLC_SUCCESS;
 226 }
 227
 228 /**************************************************************************
 229  * Create a Media Instance object
 230  **************************************************************************/
 231 libvlc_media_instance_t *
 232 libvlc_media_instance_new( libvlc_instance_t * p_libvlc_instance,
 233                            libvlc_exception_t * p_e )
 234 {
 235     libvlc_media_instance_t * p_mi;
 236
 237     if( !p_libvlc_instance )
 238     {
 239         libvlc_exception_raise( p_e, "invalid libvlc instance" );
 240         return NULL;
 241     }
 242
 243     p_mi = malloc( sizeof(libvlc_media_instance_t) );
 244     p_mi->p_md = NULL;
 245     p_mi->drawable = 0;
 246     p_mi->p_libvlc_instance = p_libvlc_instance;
 247     p_mi->i_input_id = -1;
 248     /* refcount strategy:
 249      * - All items created by _new start with a refcount set to 1
 250      * - Accessor _release decrease the refcount by 1, if after that
 251      *   operation the refcount is 0, the object is destroyed.
 252      * - Accessor _retain increase the refcount by 1 (XXX: to implement) */
 253     p_mi->i_refcount = 1;
 254     p_mi->b_own_its_input_thread = VLC_TRUE;
 255     /* object_lock strategy:
 256      * - No lock held in constructor
 257      * - Lock when accessing all variable this lock is held
 258      * - Lock when attempting to destroy the object the lock is also held */
 259     vlc_mutex_init( p_mi->p_libvlc_instance->p_libvlc_int,
 260                     &p_mi->object_lock );
 261     p_mi->p_event_manager = libvlc_event_manager_new( p_mi,
 262             p_libvlc_instance, p_e );
 263     if( libvlc_exception_raised( p_e ) )
 264     {
 265         free( p_mi );
 266         return NULL;
 267     }
 268
 269     libvlc_event_manager_register_event_type( p_mi->p_event_manager,
 270             libvlc_MediaInstanceReachedEnd, p_e );
 271     libvlc_event_manager_register_event_type( p_mi->p_event_manager,
 272             libvlc_MediaInstancePaused, p_e );
 273     libvlc_event_manager_register_event_type( p_mi->p_event_manager,
 274             libvlc_MediaInstancePlayed, p_e );
 275     libvlc_event_manager_register_event_type( p_mi->p_event_manager,
 276             libvlc_MediaInstancePositionChanged, p_e );
 277     libvlc_event_manager_register_event_type( p_mi->p_event_manager,
 278             libvlc_MediaInstanceTimeChanged, p_e );
 279
 280     return p_mi;
 281 }
 282
 283 /**************************************************************************
 284  * Create a Media Instance object with a media descriptor
 285  **************************************************************************/
 286 libvlc_media_instance_t *
 287 libvlc_media_instance_new_from_media_descriptor(
 288                                     libvlc_media_descriptor_t * p_md,
 289                                     libvlc_exception_t *p_e )
 290 {
 291     libvlc_media_instance_t * p_mi;
 292     p_mi = libvlc_media_instance_new( p_md->p_libvlc_instance, p_e );
 293
 294     if( !p_mi )
 295         return NULL;
 296
 297     libvlc_media_descriptor_retain( p_md );
 298     p_mi->p_md = p_md;
 299
 300     return p_mi;
 301 }
 302
 303 /**************************************************************************
 304  * Create a new media instance object from an input_thread (Libvlc Internal)
 305  **************************************************************************/
 306 libvlc_media_instance_t * libvlc_media_instance_new_from_input_thread(
 307                                    struct libvlc_instance_t *p_libvlc_instance,
 308                                    input_thread_t *p_input,
 309                                    libvlc_exception_t *p_e )
 310 {
 311     libvlc_media_instance_t * p_mi;
 312
 313     if( !p_input )
 314     {
 315         libvlc_exception_raise( p_e, "invalid input thread" );
 316         return NULL;
 317     }
 318
 319     p_mi = libvlc_media_instance_new( p_libvlc_instance, p_e );
 320
 321     if( !p_mi )
 322         return NULL;
 323
 324     p_mi->p_md = libvlc_media_descriptor_new_from_input_item(
 325                     p_libvlc_instance,
 326                     input_GetItem( p_input ), p_e );
 327
 328     if( !p_mi->p_md )
 329     {
 330         libvlc_media_instance_destroy( p_mi );
 331         return NULL;
 332     }
 333
 334     p_mi->i_input_id = p_input->i_object_id;
 335     p_mi->b_own_its_input_thread = VLC_FALSE;
 336
 337     /* will be released in media_instance_release() */
 338     vlc_object_yield( p_input );
 339
 340     /* XXX: Hack as the playlist doesn't yield the input thread we retain
 341      * the input for the playlist. (see corresponding hack in _release) */
 342     vlc_object_yield( p_input );
 343
 344     return p_mi;
 345 }
 346
 347 /**************************************************************************
 348  * Destroy a Media Instance object (libvlc internal)
 349  *
 350  * Warning: No lock held here, but hey, this is internal.
 351  **************************************************************************/
 352 void libvlc_media_instance_destroy( libvlc_media_instance_t *p_mi )
 353 {
 354     input_thread_t *p_input_thread;
 355     libvlc_exception_t p_e;
 356
 357     libvlc_exception_init( &p_e );
 358
 359     if( !p_mi )
 360         return;
 361
 362     p_input_thread = libvlc_get_input_thread( p_mi, &p_e );
 363
 364     if( libvlc_exception_raised( &p_e ) )
 365     {
 366         libvlc_event_manager_release( p_mi->p_event_manager );
 367         libvlc_exception_clear( &p_e );
 368         free( p_mi );
 369         return; /* no need to worry about no input thread */
 370     }
 371     vlc_mutex_destroy( &p_mi->object_lock );
 372
 373     input_DestroyThread( p_input_thread );
 374
 375     libvlc_media_descriptor_release( p_mi->p_md );
 376
 377     free( p_mi );
 378 }
 379
 380 /**************************************************************************
 381  * Release a Media Instance object
 382  **************************************************************************/
 383 void libvlc_media_instance_release( libvlc_media_instance_t *p_mi )
 384 {
 385     if( !p_mi )
 386         return;
 387
 388     vlc_mutex_lock( &p_mi->object_lock );
 389
 390     p_mi->i_refcount--;
 391
 392     if( p_mi->i_refcount > 0 )
 393     {
 394         vlc_mutex_unlock( &p_mi->object_lock );
 395         return;
 396     }
 397     vlc_mutex_unlock( &p_mi->object_lock );
 398     vlc_mutex_destroy( &p_mi->object_lock );
 399
 400     release_input_thread( p_mi );
 401
 402     libvlc_event_manager_release( p_mi->p_event_manager );
 403
 404     libvlc_media_descriptor_release( p_mi->p_md );
 405
 406     free( p_mi );
 407 }
 408
 409 /**************************************************************************
 410  * Retain a Media Instance object
 411  **************************************************************************/
 412 void libvlc_media_instance_retain( libvlc_media_instance_t *p_mi )
 413 {
 414     if( !p_mi )
 415         return;
 416
 417     p_mi->i_refcount++;
 418 }
 419
 420 /**************************************************************************
 421  * Set the Media descriptor associated with the instance
 422  **************************************************************************/
 423 void libvlc_media_instance_set_media_descriptor(
 424                             libvlc_media_instance_t *p_mi,
 425                             libvlc_media_descriptor_t *p_md,
 426                             libvlc_exception_t *p_e )
 427 {
 428     (void)p_e;
 429
 430     if( !p_mi )
 431         return;
 432
 433     vlc_mutex_lock( &p_mi->object_lock );
 434
 435     release_input_thread( p_mi );
 436
 437     libvlc_media_descriptor_release( p_mi->p_md );
 438
 439     if( !p_md )
 440     {
 441         p_mi->p_md = NULL;
 442         vlc_mutex_unlock( &p_mi->object_lock );
 443         return; /* It is ok to pass a NULL md */
 444     }
 445
 446     libvlc_media_descriptor_retain( p_md );
 447     p_mi->p_md = p_md;
 448
 449     /* The policy here is to ignore that we were created using a different
 450      * libvlc_instance, because we don't really care */
 451     p_mi->p_libvlc_instance = p_md->p_libvlc_instance;
 452
 453     vlc_mutex_unlock( &p_mi->object_lock );
 454 }
 455
 456 /**************************************************************************
 457  * Get the Media descriptor associated with the instance
 458  **************************************************************************/
 459 libvlc_media_descriptor_t *
 460 libvlc_media_instance_get_media_descriptor(
 461                             libvlc_media_instance_t *p_mi,
 462                             libvlc_exception_t *p_e )
 463 {
 464     (void)p_e;
 465
 466     if( !p_mi->p_md )
 467         return NULL;
 468
 469     libvlc_media_descriptor_retain( p_mi->p_md );
 470     return p_mi->p_md;
 471 }
 472
 473 /**************************************************************************
 474  * Get the event Manager
 475  **************************************************************************/
 476 libvlc_event_manager_t *
 477 libvlc_media_instance_event_manager(
 478                             libvlc_media_instance_t *p_mi,
 479                             libvlc_exception_t *p_e )
 480 {
 481     (void)p_e;
 482
 483     return p_mi->p_event_manager;
 484 }
 485
 486 /**************************************************************************
 487  * Play
 488  **************************************************************************/
 489 void libvlc_media_instance_play( libvlc_media_instance_t *p_mi,
 490                                  libvlc_exception_t *p_e )
 491 {
 492     input_thread_t * p_input_thread;
 493
 494     if( (p_input_thread = libvlc_get_input_thread( p_mi, p_e )) )
 495     {
 496         /* A thread alread exists, send it a play message */
 497         input_Control( p_input_thread, INPUT_SET_STATE, PLAYING_S );
 498         vlc_object_release( p_input_thread );
 499         return;
 500     }
 501
 502     /* Ignore previous exception */
 503     libvlc_exception_clear( p_e );
 504
 505     vlc_mutex_lock( &p_mi->object_lock );
 506
 507     if( !p_mi->p_md )
 508     {
 509         libvlc_exception_raise( p_e, "no associated media descriptor" );
 510         vlc_mutex_unlock( &p_mi->object_lock );
 511         return;
 512     }
 513
 514     p_input_thread = input_CreateThread( p_mi->p_libvlc_instance->p_libvlc_int,
 515                                          p_mi->p_md->p_input_item );
 516     p_mi->i_input_id = p_input_thread->i_object_id;
 517
 518     if( p_mi->drawable )
 519     {
 520         vlc_value_t val;
 521         val.i_int = p_mi->drawable;
 522         var_Create( p_input_thread, "drawable", VLC_VAR_DOINHERIT );
 523         var_Set( p_input_thread, "drawable", val );
 524     }
 525     var_AddCallback( p_input_thread, "state", input_state_changed, p_mi );
 526     var_AddCallback( p_input_thread, "intf-change", input_position_changed, p_mi );
 527     var_AddCallback( p_input_thread, "intf-change", input_time_changed, p_mi );
 528
 529     /* will be released in media_instance_release() */
 530     vlc_object_yield( p_input_thread );
 531
 532     vlc_mutex_unlock( &p_mi->object_lock );
 533 }
 534
 535 /**************************************************************************
 536  * Pause
 537  **************************************************************************/
 538 void libvlc_media_instance_pause( libvlc_media_instance_t *p_mi,
 539                                   libvlc_exception_t *p_e )
 540 {
 541     input_thread_t * p_input_thread = libvlc_get_input_thread( p_mi, p_e );
 542
 543     if( !p_input_thread )
 544         return;
 545
 546     input_Control( p_input_thread, INPUT_SET_STATE, PAUSE_S );
 547     vlc_object_release( p_input_thread );
 548 }
 549
 550 /**************************************************************************
 551  * Stop
 552  **************************************************************************/
 553 void libvlc_media_instance_stop( libvlc_media_instance_t *p_mi,
 554                                  libvlc_exception_t *p_e )
 555 {
 556     if( p_mi->b_own_its_input_thread )
 557         release_input_thread( p_mi ); /* This will stop the input thread */
 558     else
 559     {
 560         input_thread_t * p_input_thread = libvlc_get_input_thread( p_mi, p_e );
 561
 562         if( !p_input_thread )
 563             return;
 564
 565         input_StopThread( p_input_thread );
 566         vlc_object_release( p_input_thread );
 567     }
 568 }
 569
 570 /**************************************************************************
 571  * Set Drawable
 572  **************************************************************************/
 573 void libvlc_media_instance_set_drawable( libvlc_media_instance_t *p_mi,
 574                                          libvlc_drawable_t drawable,
 575                                          libvlc_exception_t *p_e )
 576 {
 577     p_mi->drawable = drawable;
 578 }
 579
 580 /**************************************************************************
 581  * Getters for stream information
 582  **************************************************************************/
 583 vlc_int64_t libvlc_media_instance_get_length(
 584                              libvlc_media_instance_t *p_mi,
 585                              libvlc_exception_t *p_e )
 586 {
 587     input_thread_t *p_input_thread;
 588     vlc_value_t val;
 589
 590     p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
 591     if( !p_input_thread )
 592         return -1;
 593
 594     var_Get( p_input_thread, "length", &val );
 595     vlc_object_release( p_input_thread );
 596
 597     return (val.i_time+500LL)/1000LL;
 598 }
 599
 600 vlc_int64_t libvlc_media_instance_get_time(
 601                                    libvlc_media_instance_t *p_mi,
 602                                    libvlc_exception_t *p_e )
 603 {
 604     input_thread_t *p_input_thread;
 605     vlc_value_t val;
 606
 607     p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
 608     if( !p_input_thread )
 609         return -1;
 610
 611     var_Get( p_input_thread , "time", &val );
 612     vlc_object_release( p_input_thread );
 613     return (val.i_time+500LL)/1000LL;
 614 }
 615
 616 void libvlc_media_instance_set_time(
 617                                  libvlc_media_instance_t *p_mi,
 618                                  vlc_int64_t time,
 619                                  libvlc_exception_t *p_e )
 620 {
 621     input_thread_t *p_input_thread;
 622     vlc_value_t value;
 623
 624     p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
 625     if( !p_input_thread )
 626         return;
 627
 628     value.i_time = time*1000LL;
 629     var_Set( p_input_thread, "time", value );
 630     vlc_object_release( p_input_thread );
 631 }
 632
 633 void libvlc_media_instance_set_position(
 634                                 libvlc_media_instance_t *p_mi,
 635                                 float position,
 636                                 libvlc_exception_t *p_e )
 637 {
 638     input_thread_t *p_input_thread;
 639     vlc_value_t val;
 640     val.f_float = position;
 641
 642     p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
 643     if( !p_input_thread )
 644         return;
 645
 646     var_Set( p_input_thread, "position", val );
 647     vlc_object_release( p_input_thread );
 648 }
 649
 650 float libvlc_media_instance_get_position(
 651                                  libvlc_media_instance_t *p_mi,
 652                                  libvlc_exception_t *p_e )
 653 {
 654     input_thread_t *p_input_thread;
 655     vlc_value_t val;
 656
 657     p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
 658     if( !p_input_thread )
 659         return -1.0;
 660
 661     var_Get( p_input_thread, "position", &val );
 662     vlc_object_release( p_input_thread );
 663
 664     return val.f_float;
 665 }
 666
 667 void libvlc_media_instance_set_chapter(
 668                                  libvlc_media_instance_t *p_mi,
 669                                  int chapter,
 670                                  libvlc_exception_t *p_e )
 671 {
 672     input_thread_t *p_input_thread;
 673     vlc_value_t val;
 674     val.i_int = chapter;
 675
 676     p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
 677     if( !p_input_thread )
 678         return;
 679
 680     var_Set( p_input_thread, "chapter", val );
 681     vlc_object_release( p_input_thread );
 682 }
 683
 684 int libvlc_media_instance_get_chapter(
 685                                  libvlc_media_instance_t *p_mi,
 686                                  libvlc_exception_t *p_e )
 687 {
 688     input_thread_t *p_input_thread;
 689     vlc_value_t val;
 690
 691     p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
 692     if( !p_input_thread )
 693         return -1.0;
 694
 695     var_Get( p_input_thread, "chapter", &val );
 696     vlc_object_release( p_input_thread );
 697
 698     return val.i_int;
 699 }
 700
 701 int libvlc_media_instance_get_chapter_count(
 702                                  libvlc_media_instance_t *p_mi,
 703                                  libvlc_exception_t *p_e )
 704 {
 705     input_thread_t *p_input_thread;
 706     vlc_value_t val;
 707
 708     p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
 709     if( !p_input_thread )
 710         return -1.0;
 711
 712     var_Change( p_input_thread, "chapter", VLC_VAR_CHOICESCOUNT, &val, NULL );
 713     vlc_object_release( p_input_thread );
 714
 715     return val.i_int;
 716 }
 717
 718 float libvlc_media_instance_get_fps(
 719                                  libvlc_media_instance_t *p_mi,
 720                                  libvlc_exception_t *p_e)
 721 {
 722     input_thread_t *p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
 723     double f_fps = 0.0;
 724
 725     if( p_input_thread )
 726     {
 727         if( input_Control( p_input_thread, INPUT_GET_VIDEO_FPS, &f_fps ) )
 728             f_fps = 0.0;
 729         vlc_object_release( p_input_thread );
 730     }
 731     return f_fps;
 732 }
 733
 734 vlc_bool_t libvlc_media_instance_will_play(
 735                                  libvlc_media_instance_t *p_mi,
 736                                  libvlc_exception_t *p_e)
 737 {
 738     input_thread_t *p_input_thread =
 739                             libvlc_get_input_thread ( p_mi, p_e);
 740     if ( !p_input_thread )
 741         return VLC_FALSE;
 742
 743     if ( !p_input_thread->b_die && !p_input_thread->b_dead )
 744     {
 745         vlc_object_release( p_input_thread );
 746         return VLC_TRUE;
 747     }
 748     vlc_object_release( p_input_thread );
 749     return VLC_FALSE;
 750 }
 751
 752 void libvlc_media_instance_set_rate(
 753                                  libvlc_media_instance_t *p_mi,
 754                                  float rate,
 755                                  libvlc_exception_t *p_e )
 756 {
 757     input_thread_t *p_input_thread;
 758     vlc_value_t val;
 759
 760     if( rate <= 0 )
 761         RAISEVOID( "Rate value is invalid" );
 762
 763     val.i_int = 1000.0f/rate;
 764
 765     p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
 766     if ( !p_input_thread )
 767         return;
 768
 769     var_Set( p_input_thread, "rate", val );
 770     vlc_object_release( p_input_thread );
 771 }
 772
 773 float libvlc_media_instance_get_rate(
 774                                  libvlc_media_instance_t *p_mi,
 775                                  libvlc_exception_t *p_e )
 776 {
 777     input_thread_t *p_input_thread;
 778     vlc_value_t val;
 779
 780     p_input_thread = libvlc_get_input_thread ( p_mi, p_e);
 781     if ( !p_input_thread )
 782         return -1.0;
 783
 784     var_Get( p_input_thread, "rate", &val );
 785     vlc_object_release( p_input_thread );
 786
 787     return (float)1000.0f/val.i_int;
 788 }
 789
 790 libvlc_state_t libvlc_media_instance_get_state(
 791                                  libvlc_media_instance_t *p_mi,
 792                                  libvlc_exception_t *p_e )
 793 {
 794     input_thread_t *p_input_thread;
 795     vlc_value_t val;
 796
 797     p_input_thread = libvlc_get_input_thread ( p_mi, p_e );
 798     if ( !p_input_thread )
 799         return libvlc_Stopped;
 800
 801     var_Get( p_input_thread, "state", &val );
 802     vlc_object_release( p_input_thread );
 803
 804     return vlc_to_libvlc_state(val.i_int);
 805 }