media_player.c 64.5 KB
Newer Older
Clément Stenac's avatar
Clément Stenac committed
1
/*****************************************************************************
2
 * media_player.c: Libvlc API Media Instance management functions
Clément Stenac's avatar
Clément Stenac committed
3
 *****************************************************************************
4
 * Copyright (C) 2005-2015 VLC authors and VideoLAN
Clément Stenac's avatar
Clément Stenac committed
5
 *
6
 * Authors: Clément Stenac <zorglub@videolan.org>
Clément Stenac's avatar
Clément Stenac committed
7
 *
Jean-Baptiste Kempf's avatar
LGPL  
Jean-Baptiste Kempf committed
8 9 10
 * This program is free software; you can redistribute it and/or modify it
 * under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation; either version 2.1 of the License, or
Clément Stenac's avatar
Clément Stenac committed
11 12 13 14
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
Jean-Baptiste Kempf's avatar
LGPL  
Jean-Baptiste Kempf committed
15 16
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU Lesser General Public License for more details.
Clément Stenac's avatar
Clément Stenac committed
17
 *
Jean-Baptiste Kempf's avatar
LGPL  
Jean-Baptiste Kempf committed
18 19 20
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
Clément Stenac's avatar
Clément Stenac committed
21 22
 *****************************************************************************/

Geoffroy Couprie's avatar
Geoffroy Couprie committed
23 24 25 26
#ifdef HAVE_CONFIG_H
# include "config.h"
#endif

27
#include <assert.h>
28

Clément Stenac's avatar
Clément Stenac committed
29
#include <vlc/libvlc.h>
30
#include <vlc/libvlc_renderer_discoverer.h>
31 32 33
#include <vlc/libvlc_media.h>
#include <vlc/libvlc_events.h>

Clément Stenac's avatar
Clément Stenac committed
34 35
#include <vlc_demux.h>
#include <vlc_input.h>
36
#include <vlc_vout.h>
Mark Lee's avatar
Mark Lee committed
37
#include <vlc_aout.h>
38
#include <vlc_keys.h>
39 40 41 42

#include "libvlc_internal.h"
#include "media_internal.h" // libvlc_media_set_state()
#include "media_player_internal.h"
43
#include "renderer_discoverer_internal.h"
Clément Stenac's avatar
Clément Stenac committed
44

45
static int
46 47 48 49 50 51 52 53
input_seekable_changed( vlc_object_t * p_this, char const * psz_cmd,
                        vlc_value_t oldval, vlc_value_t newval,
                        void * p_userdata );
static int
input_pausable_changed( vlc_object_t * p_this, char const * psz_cmd,
                        vlc_value_t oldval, vlc_value_t newval,
                        void * p_userdata );
static int
54 55 56 57
input_scrambled_changed( vlc_object_t * p_this, char const * psz_cmd,
                        vlc_value_t oldval, vlc_value_t newval,
                        void * p_userdata );
static int
Laurent Aimar's avatar
Laurent Aimar committed
58
input_event_changed( vlc_object_t * p_this, char const * psz_cmd,
59 60 61
                     vlc_value_t oldval, vlc_value_t newval,
                     void * p_userdata );

62 63 64 65 66 67 68 69 70 71
static int
input_es_changed( vlc_object_t * p_this, char const * psz_cmd,
                  int action, vlc_value_t *p_val,
                  void *p_userdata);

static int
input_es_selected( vlc_object_t * p_this, char const * psz_cmd,
                   vlc_value_t oldval, vlc_value_t newval,
                   void * p_userdata );

72 73 74 75
static int
corks_changed(vlc_object_t *obj, const char *name, vlc_value_t old,
              vlc_value_t cur, void *opaque);

76 77 78 79
static int
mute_changed(vlc_object_t *obj, const char *name, vlc_value_t old,
             vlc_value_t cur, void *opaque);

80 81 82 83
static int
volume_changed(vlc_object_t *obj, const char *name, vlc_value_t old,
               vlc_value_t cur, void *opaque);

84 85 86 87 88 89
static void
add_es_callbacks( input_thread_t *p_input_thread, libvlc_media_player_t *p_mi );

static void
del_es_callbacks( input_thread_t *p_input_thread, libvlc_media_player_t *p_mi );

90 91 92
static int
snapshot_was_taken( vlc_object_t *p_this, char const *psz_cmd,
                    vlc_value_t oldval, vlc_value_t newval, void *p_data );
93

94
static void libvlc_media_player_destroy( libvlc_media_player_t *p_mi );
95

96 97 98 99
/*
 * Shortcuts
 */

100 101 102 103 104 105 106 107 108
/*
 * The input lock protects the input and input resource pointer.
 * It MUST NOT be used from callbacks.
 *
 * The object lock protects the reset, namely the media and the player state.
 * It can, and usually needs to be taken from callbacks.
 * The object lock can be acquired under the input lock... and consequently
 * the opposite order is STRICTLY PROHIBITED.
 */
109 110 111 112 113 114 115 116 117 118
static inline void lock(libvlc_media_player_t *mp)
{
    vlc_mutex_lock(&mp->object_lock);
}

static inline void unlock(libvlc_media_player_t *mp)
{
    vlc_mutex_unlock(&mp->object_lock);
}

119 120 121 122 123 124 125 126 127 128
static inline void lock_input(libvlc_media_player_t *mp)
{
    vlc_mutex_lock(&mp->input.lock);
}

static inline void unlock_input(libvlc_media_player_t *mp)
{
    vlc_mutex_unlock(&mp->input.lock);
}

129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157
static void input_item_preparsed_changed( const vlc_event_t *p_event,
                                          void * user_data )
{
    libvlc_media_t *p_md = user_data;
    if( p_event->u.input_item_preparsed_changed.new_status & ITEM_PREPARSED )
    {
        /* Send the event */
        libvlc_event_t event;
        event.type = libvlc_MediaParsedChanged;
        event.u.media_parsed_changed.new_status = libvlc_media_parsed_status_done;
        libvlc_event_send( p_md->p_event_manager, &event );
    }
}

static void media_attach_preparsed_event( libvlc_media_t *p_md )
{
    vlc_event_attach( &p_md->p_input_item->event_manager,
                      vlc_InputItemPreparsedChanged,
                      input_item_preparsed_changed, p_md );
}

static void media_detach_preparsed_event( libvlc_media_t *p_md )
{
    vlc_event_detach( &p_md->p_input_item->event_manager,
                      vlc_InputItemPreparsedChanged,
                      input_item_preparsed_changed,
                      p_md );
}

158
/*
JP Dinger's avatar
JP Dinger committed
159
 * Release the associated input thread.
160 161
 *
 * Object lock is NOT held.
162
 * Input lock is held or instance is being destroyed.
163
 */
164
static void release_input_thread( libvlc_media_player_t *p_mi )
165
{
166
    assert( p_mi );
167

168
    input_thread_t *p_input_thread = p_mi->input.p_thread;
169
    if( !p_input_thread )
170
        return;
171
    p_mi->input.p_thread = NULL;
172

173 174
    media_detach_preparsed_event( p_mi->p_md );

175 176 177 178
    var_DelCallback( p_input_thread, "can-seek",
                     input_seekable_changed, p_mi );
    var_DelCallback( p_input_thread, "can-pause",
                    input_pausable_changed, p_mi );
179 180
    var_DelCallback( p_input_thread, "program-scrambled",
                    input_scrambled_changed, p_mi );
181 182
    var_DelCallback( p_input_thread, "intf-event",
                     input_event_changed, p_mi );
183
    del_es_callbacks( p_input_thread, p_mi );
184 185

    /* We owned this one */
186
    input_Stop( p_input_thread );
187
    input_Close( p_input_thread );
188 189
}

190 191
/*
 * Retrieve the input thread. Be sure to release the object
192
 * once you are done with it. (libvlc Internal)
193
 */
194
input_thread_t *libvlc_get_input_thread( libvlc_media_player_t *p_mi )
Clément Stenac's avatar
Clément Stenac committed
195 196 197
{
    input_thread_t *p_input_thread;

198
    assert( p_mi );
199

200 201
    lock_input(p_mi);
    p_input_thread = p_mi->input.p_thread;
202 203
    if( p_input_thread )
        vlc_object_hold( p_input_thread );
204 205
    else
        libvlc_printerr( "No active input" );
206
    unlock_input(p_mi);
207

208 209 210
    return p_input_thread;
}

211 212 213 214 215
/*
 * Set the internal state of the media_player. (media player Internal)
 *
 * Function will lock the media_player.
 */
216 217 218 219 220
static void set_state( libvlc_media_player_t *p_mi, libvlc_state_t state,
    bool b_locked )
{
    if(!b_locked)
        lock(p_mi);
221
    p_mi->state = state;
222

223 224 225
    libvlc_media_t *media = p_mi->p_md;
    if (media)
        libvlc_media_retain(media);
226

227 228
    if(!b_locked)
        unlock(p_mi);
229

230 231
    if (media)
    {
232 233 234
        // Also set the state of the corresponding media
        // This is strictly for convenience.
        libvlc_media_set_state(media, state);
235 236

        libvlc_media_release(media);
237 238 239
    }
}

240
static int
241
input_seekable_changed( vlc_object_t * p_this, char const * psz_cmd,
242 243 244 245
                        vlc_value_t oldval, vlc_value_t newval,
                        void * p_userdata )
{
    VLC_UNUSED(oldval);
246 247
    VLC_UNUSED(p_this);
    VLC_UNUSED(psz_cmd);
248
    libvlc_media_player_t * p_mi = p_userdata;
249 250
    libvlc_event_t event;

251
    event.type = libvlc_MediaPlayerSeekableChanged;
252
    event.u.media_player_seekable_changed.new_seekable = newval.b_bool;
253 254 255 256 257 258 259 260 261 262 263

    libvlc_event_send( p_mi->p_event_manager, &event );
    return VLC_SUCCESS;
}

static int
input_pausable_changed( vlc_object_t * p_this, char const * psz_cmd,
                        vlc_value_t oldval, vlc_value_t newval,
                        void * p_userdata )
{
    VLC_UNUSED(oldval);
264 265
    VLC_UNUSED(p_this);
    VLC_UNUSED(psz_cmd);
266
    libvlc_media_player_t * p_mi = p_userdata;
267 268
    libvlc_event_t event;

269
    event.type = libvlc_MediaPlayerPausableChanged;
270
    event.u.media_player_pausable_changed.new_pausable = newval.b_bool;
271 272 273 274 275

    libvlc_event_send( p_mi->p_event_manager, &event );
    return VLC_SUCCESS;
}

276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293
static int
input_scrambled_changed( vlc_object_t * p_this, char const * psz_cmd,
                        vlc_value_t oldval, vlc_value_t newval,
                        void * p_userdata )
{
    VLC_UNUSED(oldval);
    VLC_UNUSED(p_this);
    VLC_UNUSED(psz_cmd);
    libvlc_media_player_t * p_mi = p_userdata;
    libvlc_event_t event;

    event.type = libvlc_MediaPlayerScrambledChanged;
    event.u.media_player_scrambled_changed.new_scrambled = newval.b_bool;

    libvlc_event_send( p_mi->p_event_manager, &event );
    return VLC_SUCCESS;
}

294
static int
Laurent Aimar's avatar
Laurent Aimar committed
295
input_event_changed( vlc_object_t * p_this, char const * psz_cmd,
296 297 298
                     vlc_value_t oldval, vlc_value_t newval,
                     void * p_userdata )
{
299
    VLC_UNUSED(oldval); VLC_UNUSED(psz_cmd);
Laurent Aimar's avatar
Laurent Aimar committed
300
    input_thread_t * p_input = (input_thread_t *)p_this;
301
    libvlc_media_player_t * p_mi = p_userdata;
Laurent Aimar's avatar
Laurent Aimar committed
302
    libvlc_event_t event;
303

304
    assert( !strcmp( psz_cmd, "intf-event" ) );
305

306 307
    if( newval.i_int == INPUT_EVENT_STATE )
    {
308
        libvlc_state_t libvlc_state;
309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339

        switch ( var_GetInteger( p_input, "state" ) )
        {
            case INIT_S:
                libvlc_state = libvlc_NothingSpecial;
                event.type = libvlc_MediaPlayerNothingSpecial;
                break;
            case OPENING_S:
                libvlc_state = libvlc_Opening;
                event.type = libvlc_MediaPlayerOpening;
                break;
            case PLAYING_S:
                libvlc_state = libvlc_Playing;
                event.type = libvlc_MediaPlayerPlaying;
                break;
            case PAUSE_S:
                libvlc_state = libvlc_Paused;
                event.type = libvlc_MediaPlayerPaused;
                break;
            case END_S:
                libvlc_state = libvlc_Ended;
                event.type = libvlc_MediaPlayerEndReached;
                break;
            case ERROR_S:
                libvlc_state = libvlc_Error;
                event.type = libvlc_MediaPlayerEncounteredError;
                break;

            default:
                return VLC_SUCCESS;
        }
340

341
        set_state( p_mi, libvlc_state, false );
342 343
        libvlc_event_send( p_mi->p_event_manager, &event );
    }
344
    else if( newval.i_int == INPUT_EVENT_DEAD )
345
    {
346
        libvlc_state_t libvlc_state = libvlc_Ended;
347 348
        event.type = libvlc_MediaPlayerStopped;

349
        set_state( p_mi, libvlc_state, false );
350 351
        libvlc_event_send( p_mi->p_event_manager, &event );
    }
352
    else if( newval.i_int == INPUT_EVENT_POSITION )
353 354 355 356 357 358
    {
        if( var_GetInteger( p_input, "state" ) != PLAYING_S )
            return VLC_SUCCESS; /* Don't send the position while stopped */

        /* */
        event.type = libvlc_MediaPlayerPositionChanged;
JP Dinger's avatar
JP Dinger committed
359 360
        event.u.media_player_position_changed.new_position =
                                          var_GetFloat( p_input, "position" );
361 362 363 364
        libvlc_event_send( p_mi->p_event_manager, &event );

        /* */
        event.type = libvlc_MediaPlayerTimeChanged;
JP Dinger's avatar
JP Dinger committed
365
        event.u.media_player_time_changed.new_time =
366
           from_mtime(var_GetInteger( p_input, "time" ));
367 368
        libvlc_event_send( p_mi->p_event_manager, &event );
    }
369 370 371 372
    else if( newval.i_int == INPUT_EVENT_LENGTH )
    {
        event.type = libvlc_MediaPlayerLengthChanged;
        event.u.media_player_length_changed.new_length =
373
           from_mtime(var_GetInteger( p_input, "length" ));
374 375
        libvlc_event_send( p_mi->p_event_manager, &event );
    }
376 377 378
    else if( newval.i_int == INPUT_EVENT_CACHE )
    {
        event.type = libvlc_MediaPlayerBuffering;
379
        event.u.media_player_buffering.new_cache = (100 *
380 381 382
            var_GetFloat( p_input, "cache" ));
        libvlc_event_send( p_mi->p_event_manager, &event );
    }
383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401
    else if( newval.i_int == INPUT_EVENT_VOUT )
    {
        vout_thread_t **pp_vout;
        size_t i_vout;
        if( input_Control( p_input, INPUT_GET_VOUTS, &pp_vout, &i_vout ) )
        {
            i_vout  = 0;
        }
        else
        {
            for( size_t i = 0; i < i_vout; i++ )
                vlc_object_release( pp_vout[i] );
            free( pp_vout );
        }

        event.type = libvlc_MediaPlayerVout;
        event.u.media_player_vout.new_count = i_vout;
        libvlc_event_send( p_mi->p_event_manager, &event );
    }
402 403 404 405 406 407
    else if ( newval.i_int == INPUT_EVENT_TITLE )
    {
        event.type = libvlc_MediaPlayerTitleChanged;
        event.u.media_player_title_changed.new_title = var_GetInteger( p_input, "title" );
        libvlc_event_send( p_mi->p_event_manager, &event );
    }
408 409 410 411 412 413
    else if ( newval.i_int == INPUT_EVENT_CHAPTER )
    {
        event.type = libvlc_MediaPlayerChapterChanged;
        event.u.media_player_chapter_changed.new_chapter = var_GetInteger( p_input, "chapter" );
        libvlc_event_send( p_mi->p_event_manager, &event );
    }
Laurent Aimar's avatar
Laurent Aimar committed
414

415 416 417
    return VLC_SUCCESS;
}

418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496
static int track_type_from_name(const char *psz_name)
{
   if( !strcmp( psz_name, "video-es" ) )
       return libvlc_track_video;
    else if( !strcmp( psz_name, "audio-es" ) )
        return libvlc_track_audio;
    else if( !strcmp( psz_name, "spu-es" ) )
        return libvlc_track_text;
    else
        return libvlc_track_unknown;
}

static int input_es_changed( vlc_object_t *p_this,
                             char const *psz_cmd,
                             int action,
                             vlc_value_t *p_val,
                             void *p_userdata )
{
    VLC_UNUSED(p_this);
    libvlc_media_player_t *mp = p_userdata;
    libvlc_event_t event;

    /* Ignore the "Disable" element */
    if (p_val && p_val->i_int < 0)
        return VLC_EGENERIC;

    switch (action)
    {
    case VLC_VAR_ADDCHOICE:
        event.type = libvlc_MediaPlayerESAdded;
        break;
    case VLC_VAR_DELCHOICE:
    case VLC_VAR_CLEARCHOICES:
        event.type = libvlc_MediaPlayerESDeleted;
        break;
    default:
        return VLC_EGENERIC;
    }

    event.u.media_player_es_changed.i_type = track_type_from_name(psz_cmd);

    int i_id;
    if (action != VLC_VAR_CLEARCHOICES)
    {
        if (!p_val)
            return VLC_EGENERIC;
        i_id = p_val->i_int;
    }
    else
    {
        /* -1 means all ES tracks of this type were deleted. */
        i_id = -1;
    }
    event.u.media_player_es_changed.i_id = i_id;

    libvlc_event_send(mp->p_event_manager, &event);

    return VLC_SUCCESS;
}

static int
input_es_selected( vlc_object_t * p_this, char const * psz_cmd,
                   vlc_value_t oldval, vlc_value_t newval,
                   void * p_userdata )
{
    VLC_UNUSED(p_this);
    VLC_UNUSED(oldval);
    libvlc_media_player_t *mp = p_userdata;
    libvlc_event_t event;

    event.type = libvlc_MediaPlayerESSelected;
    event.u.media_player_es_changed.i_type = track_type_from_name(psz_cmd);
    event.u.media_player_es_changed.i_id = newval.i_int;

    libvlc_event_send(mp->p_event_manager, &event);

    return VLC_SUCCESS;
}

497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515
/**************************************************************************
 * Snapshot Taken Event.
 *
 * FIXME: This snapshot API interface makes no sense in media_player.
 *************************************************************************/
static int snapshot_was_taken(vlc_object_t *p_this, char const *psz_cmd,
                              vlc_value_t oldval, vlc_value_t newval, void *p_data )
{
    VLC_UNUSED(psz_cmd); VLC_UNUSED(oldval); VLC_UNUSED(p_this);

    libvlc_media_player_t *mp = p_data;
    libvlc_event_t event;
    event.type = libvlc_MediaPlayerSnapshotTaken;
    event.u.media_player_snapshot_taken.psz_filename = newval.psz_string;
    libvlc_event_send(mp->p_event_manager, &event);

    return VLC_SUCCESS;
}

516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532
static int corks_changed(vlc_object_t *obj, const char *name, vlc_value_t old,
                         vlc_value_t cur, void *opaque)
{
    libvlc_media_player_t *mp = (libvlc_media_player_t *)obj;

    if (!old.i_int != !cur.i_int)
    {
        libvlc_event_t event;

        event.type = cur.i_int ? libvlc_MediaPlayerCorked
                               : libvlc_MediaPlayerUncorked;
        libvlc_event_send(mp->p_event_manager, &event);
    }
    VLC_UNUSED(name); VLC_UNUSED(opaque);
    return VLC_SUCCESS;
}

533 534 535 536 537 538 539 540 541 542 543 544 545
static int audio_device_changed(vlc_object_t *obj, const char *name,
                                vlc_value_t old, vlc_value_t cur, void *opaque)
{
    libvlc_media_player_t *mp = (libvlc_media_player_t *)obj;
    libvlc_event_t event;

    event.type = libvlc_MediaPlayerAudioDevice;
    event.u.media_player_audio_device.device = cur.psz_string;
    libvlc_event_send(mp->p_event_manager, &event);
    VLC_UNUSED(name); VLC_UNUSED(old); VLC_UNUSED(opaque);
    return VLC_SUCCESS;
}

546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562
static int mute_changed(vlc_object_t *obj, const char *name, vlc_value_t old,
                        vlc_value_t cur, void *opaque)
{
    libvlc_media_player_t *mp = (libvlc_media_player_t *)obj;

    if (old.b_bool != cur.b_bool)
    {
        libvlc_event_t event;

        event.type = cur.b_bool ? libvlc_MediaPlayerMuted
                                : libvlc_MediaPlayerUnmuted;
        libvlc_event_send(mp->p_event_manager, &event);
    }
    VLC_UNUSED(name); VLC_UNUSED(opaque);
    return VLC_SUCCESS;
}

563 564 565 566 567 568 569 570 571 572 573 574 575
static int volume_changed(vlc_object_t *obj, const char *name, vlc_value_t old,
                          vlc_value_t cur, void *opaque)
{
    libvlc_media_player_t *mp = (libvlc_media_player_t *)obj;
    libvlc_event_t event;

    event.type = libvlc_MediaPlayerAudioVolume;
    event.u.media_player_audio_volume.volume = cur.f_float;
    libvlc_event_send(mp->p_event_manager, &event);
    VLC_UNUSED(name); VLC_UNUSED(old); VLC_UNUSED(opaque);
    return VLC_SUCCESS;
}

576
/**************************************************************************
JP Dinger's avatar
JP Dinger committed
577 578 579 580 581 582 583 584 585 586 587 588
 * Create a Media Instance object.
 *
 * Refcount strategy:
 * - All items created by _new start with a refcount set to 1.
 * - Accessor _release decrease the refcount by 1, if after that
 *   operation the refcount is 0, the object is destroyed.
 * - Accessor _retain increase the refcount by 1 (XXX: to implement)
 *
 * Object locking strategy:
 * - No lock held while in constructor.
 * - When accessing any member variable this lock is held. (XXX who locks?)
 * - When attempting to destroy the object the lock is also held.
589
 **************************************************************************/
590
libvlc_media_player_t *
Rémi Denis-Courmont's avatar
good  
Rémi Denis-Courmont committed
591
libvlc_media_player_new( libvlc_instance_t *instance )
592
{
593
    libvlc_media_player_t * mp;
594

595
    assert(instance);
596

597 598
    mp = vlc_object_create (instance->p_libvlc_int, sizeof(*mp));
    if (unlikely(mp == NULL))
599
    {
600
        libvlc_printerr("Not enough memory");
601 602
        return NULL;
    }
603

604 605
    /* Input */
    var_Create (mp, "rate", VLC_VAR_FLOAT|VLC_VAR_DOINHERIT);
606 607
    var_Create (mp, "sout", VLC_VAR_STRING);
    var_Create (mp, "demux-filter", VLC_VAR_STRING);
608

609
    /* Video */
610
    var_Create (mp, "vout", VLC_VAR_STRING|VLC_VAR_DOINHERIT);
611
    var_Create (mp, "window", VLC_VAR_STRING);
612 613 614 615
    var_Create (mp, "vmem-lock", VLC_VAR_ADDRESS);
    var_Create (mp, "vmem-unlock", VLC_VAR_ADDRESS);
    var_Create (mp, "vmem-display", VLC_VAR_ADDRESS);
    var_Create (mp, "vmem-data", VLC_VAR_ADDRESS);
616 617
    var_Create (mp, "vmem-setup", VLC_VAR_ADDRESS);
    var_Create (mp, "vmem-cleanup", VLC_VAR_ADDRESS);
618 619 620
    var_Create (mp, "vmem-chroma", VLC_VAR_STRING | VLC_VAR_DOINHERIT);
    var_Create (mp, "vmem-width", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
    var_Create (mp, "vmem-height", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
621
    var_Create (mp, "vmem-pitch", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
622
    var_Create (mp, "avcodec-hw", VLC_VAR_STRING);
623
    var_Create (mp, "drawable-xid", VLC_VAR_INTEGER);
624
#if defined (_WIN32) || defined (__OS2__)
625
    var_Create (mp, "drawable-hwnd", VLC_VAR_INTEGER);
626 627 628 629
#endif
#ifdef __APPLE__
    var_Create (mp, "drawable-nsobject", VLC_VAR_ADDRESS);
#endif
630 631 632
#ifdef __ANDROID__
    var_Create (mp, "drawable-androidwindow", VLC_VAR_ADDRESS);
#endif
633 634 635
#ifdef HAVE_EVAS
    var_Create (mp, "drawable-evasobject", VLC_VAR_ADDRESS);
#endif
636 637 638 639

    var_Create (mp, "keyboard-events", VLC_VAR_BOOL);
    var_SetBool (mp, "keyboard-events", true);
    var_Create (mp, "mouse-events", VLC_VAR_BOOL);
640
    var_SetBool (mp, "mouse-events", true);
641

642
    var_Create (mp, "fullscreen", VLC_VAR_BOOL);
643 644
    var_Create (mp, "autoscale", VLC_VAR_BOOL | VLC_VAR_DOINHERIT);
    var_Create (mp, "zoom", VLC_VAR_FLOAT | VLC_VAR_DOINHERIT);
645 646
    var_Create (mp, "aspect-ratio", VLC_VAR_STRING);
    var_Create (mp, "crop", VLC_VAR_STRING);
647 648
    var_Create (mp, "deinterlace", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
    var_Create (mp, "deinterlace-mode", VLC_VAR_STRING | VLC_VAR_DOINHERIT);
649

650 651
    var_Create (mp, "vbi-page", VLC_VAR_INTEGER);
    var_SetInteger (mp, "vbi-page", 100);
652

653 654 655 656
    var_Create (mp, "video-filter", VLC_VAR_STRING | VLC_VAR_DOINHERIT);
    var_Create (mp, "sub-source", VLC_VAR_STRING | VLC_VAR_DOINHERIT);
    var_Create (mp, "sub-filter", VLC_VAR_STRING | VLC_VAR_DOINHERIT);

657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674
    var_Create (mp, "marq-marquee", VLC_VAR_STRING);
    var_Create (mp, "marq-color", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
    var_Create (mp, "marq-opacity", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
    var_Create (mp, "marq-position", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
    var_Create (mp, "marq-refresh", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
    var_Create (mp, "marq-size", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
    var_Create (mp, "marq-timeout", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
    var_Create (mp, "marq-x", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
    var_Create (mp, "marq-y", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);

    var_Create (mp, "logo-file", VLC_VAR_STRING);
    var_Create (mp, "logo-x", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
    var_Create (mp, "logo-y", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
    var_Create (mp, "logo-delay", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
    var_Create (mp, "logo-repeat", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
    var_Create (mp, "logo-opacity", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
    var_Create (mp, "logo-position", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);

675 676
    var_Create (mp, "contrast", VLC_VAR_FLOAT | VLC_VAR_DOINHERIT);
    var_Create (mp, "brightness", VLC_VAR_FLOAT | VLC_VAR_DOINHERIT);
677
    var_Create (mp, "hue", VLC_VAR_FLOAT | VLC_VAR_DOINHERIT);
678 679 680
    var_Create (mp, "saturation", VLC_VAR_FLOAT | VLC_VAR_DOINHERIT);
    var_Create (mp, "gamma", VLC_VAR_FLOAT | VLC_VAR_DOINHERIT);

681
     /* Audio */
682
    var_Create (mp, "aout", VLC_VAR_STRING | VLC_VAR_DOINHERIT);
683
    var_Create (mp, "audio-device", VLC_VAR_STRING);
684
    var_Create (mp, "mute", VLC_VAR_BOOL);
685
    var_Create (mp, "volume", VLC_VAR_FLOAT);
686
    var_Create (mp, "corks", VLC_VAR_INTEGER);
687
    var_Create (mp, "audio-filter", VLC_VAR_STRING);
688
    var_Create (mp, "role", VLC_VAR_STRING | VLC_VAR_DOINHERIT);
689 690
    var_Create (mp, "amem-data", VLC_VAR_ADDRESS);
    var_Create (mp, "amem-setup", VLC_VAR_ADDRESS);
Sébastien Toque's avatar
Sébastien Toque committed
691
    var_Create (mp, "amem-cleanup", VLC_VAR_ADDRESS);
692
    var_Create (mp, "amem-play", VLC_VAR_ADDRESS);
693 694 695 696
    var_Create (mp, "amem-pause", VLC_VAR_ADDRESS);
    var_Create (mp, "amem-resume", VLC_VAR_ADDRESS);
    var_Create (mp, "amem-flush", VLC_VAR_ADDRESS);
    var_Create (mp, "amem-drain", VLC_VAR_ADDRESS);
697 698 699 700
    var_Create (mp, "amem-set-volume", VLC_VAR_ADDRESS);
    var_Create (mp, "amem-format", VLC_VAR_STRING | VLC_VAR_DOINHERIT);
    var_Create (mp, "amem-rate", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
    var_Create (mp, "amem-channels", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
701

702 703 704 705 706
    /* Video Title */
    var_Create (mp, "video-title-show", VLC_VAR_BOOL);
    var_Create (mp, "video-title-position", VLC_VAR_INTEGER);
    var_Create (mp, "video-title-timeout", VLC_VAR_INTEGER);

Mark Lee's avatar
Mark Lee committed
707 708
    /* Equalizer */
    var_Create (mp, "equalizer-preamp", VLC_VAR_FLOAT);
709
    var_Create (mp, "equalizer-vlcfreqs", VLC_VAR_BOOL);
Mark Lee's avatar
Mark Lee committed
710 711
    var_Create (mp, "equalizer-bands", VLC_VAR_STRING);

712
    mp->p_md = NULL;
713
    mp->state = libvlc_NothingSpecial;
714
    mp->p_libvlc_instance = instance;
715
    mp->input.p_thread = NULL;
716 717 718 719 720 721
    mp->input.p_resource = input_resource_New(VLC_OBJECT(mp));
    if (unlikely(mp->input.p_resource == NULL))
    {
        vlc_object_release(mp);
        return NULL;
    }
722 723 724 725
    audio_output_t *aout = input_resource_GetAout(mp->input.p_resource);
    if( aout != NULL )
        input_resource_PutAout(mp->input.p_resource, aout);

726 727 728 729
    vlc_viewpoint_init(&mp->viewpoint);

    var_Create (mp, "viewpoint", VLC_VAR_ADDRESS);
    var_SetAddress( mp, "viewpoint", &mp->viewpoint );
730
    vlc_mutex_init (&mp->input.lock);
731
    mp->i_refcount = 1;
732
    mp->p_event_manager = libvlc_event_manager_new(mp);
733
    if (unlikely(mp->p_event_manager == NULL))
734
    {
735
        input_resource_Release(mp->input.p_resource);
736
        vlc_object_release(mp);
737 738
        return NULL;
    }
739
    vlc_mutex_init(&mp->object_lock);
740

741
    var_AddCallback(mp, "corks", corks_changed, NULL);
742
    var_AddCallback(mp, "audio-device", audio_device_changed, NULL);
743
    var_AddCallback(mp, "mute", mute_changed, NULL);
744
    var_AddCallback(mp, "volume", volume_changed, NULL);
745

746 747
    /* Snapshot initialization */
    /* Attach a var callback to the global object to provide the glue between
748 749 750 751 752 753
     * vout_thread that generates the event and media_player that re-emits it
     * with its own event manager
     *
     * FIXME: It's unclear why we want to put this in public API, and why we
     * want to expose it in such a limiting and ugly way.
     */
754
    var_AddCallback(mp->obj.libvlc, "snapshot-file", snapshot_was_taken, mp);
755

756
    libvlc_retain(instance);
757
    return mp;
758 759 760
}

/**************************************************************************
JP Dinger's avatar
JP Dinger committed
761
 * Create a Media Instance object with a media descriptor.
762
 **************************************************************************/
763
libvlc_media_player_t *
Rémi Denis-Courmont's avatar
good  
Rémi Denis-Courmont committed
764
libvlc_media_player_new_from_media( libvlc_media_t * p_md )
765
{
766
    libvlc_media_player_t * p_mi;
767

Rémi Denis-Courmont's avatar
good  
Rémi Denis-Courmont committed
768
    p_mi = libvlc_media_player_new( p_md->p_libvlc_instance );
769
    if( !p_mi )
770 771
        return NULL;

772
    libvlc_media_retain( p_md );
773
    p_mi->p_md = p_md;
774 775 776 777 778

    return p_mi;
}

/**************************************************************************
779
 * Destroy a Media Instance object (libvlc internal)
780
 *
JP Dinger's avatar
JP Dinger committed
781
 * Warning: No lock held here, but hey, this is internal. Caller must lock.
782
 **************************************************************************/
783
static void libvlc_media_player_destroy( libvlc_media_player_t *p_mi )
784
{
785
    assert( p_mi );
Jean-Paul Saman's avatar
Jean-Paul Saman committed
786

787
    /* Detach Callback from the main libvlc object */
788
    var_DelCallback( p_mi->obj.libvlc,
789
                     "snapshot-file", snapshot_was_taken, p_mi );
790

791
    /* Detach callback from the media player / input manager object */
792
    var_DelCallback( p_mi, "volume", volume_changed, NULL );
793
    var_DelCallback( p_mi, "mute", mute_changed, NULL );
794
    var_DelCallback( p_mi, "audio-device", audio_device_changed, NULL );
795 796
    var_DelCallback( p_mi, "corks", corks_changed, NULL );

797 798
    /* No need for lock_input() because no other threads knows us anymore */
    if( p_mi->input.p_thread )
799
        release_input_thread(p_mi);
800 801
    input_resource_Terminate( p_mi->input.p_resource );
    input_resource_Release( p_mi->input.p_resource );
802
    vlc_mutex_destroy( &p_mi->input.lock );
803

804
    libvlc_event_manager_release( p_mi->p_event_manager );
805
    libvlc_media_release( p_mi->p_md );
806
    vlc_mutex_destroy( &p_mi->object_lock );
807 808

    libvlc_instance_t *instance = p_mi->p_libvlc_instance;
809
    vlc_object_release( p_mi );
810
    libvlc_release(instance);
811 812 813
}

/**************************************************************************
JP Dinger's avatar
JP Dinger committed
814 815 816
 * Release a Media Instance object.
 *
 * Function does the locking.
817
 **************************************************************************/
818
void libvlc_media_player_release( libvlc_media_player_t *p_mi )
819
{
820
    bool destroy;
821

822
    assert( p_mi );
823
    lock(p_mi);
824
    destroy = !--p_mi->i_refcount;
825
    unlock(p_mi);
826

827 828
    if( destroy )
        libvlc_media_player_destroy( p_mi );
829
}
830

831
/**************************************************************************
JP Dinger's avatar
JP Dinger committed
832 833 834
 * Retain a Media Instance object.
 *
 * Caller must hold the lock.
835
 **************************************************************************/
836
void libvlc_media_player_retain( libvlc_media_player_t *p_mi )
837
{
838
    assert( p_mi );
839

840
    lock(p_mi);
841
    p_mi->i_refcount++;
842
    unlock(p_mi);
843
}
844

845
/**************************************************************************
JP Dinger's avatar
JP Dinger committed
846 847 848
 * Set the Media descriptor associated with the instance.
 *
 * Enter without lock -- function will lock the object.
849
 **************************************************************************/
850 851
void libvlc_media_player_set_media(
                            libvlc_media_player_t *p_mi,
852
                            libvlc_media_t *p_md )
853
{
854
    lock_input(p_mi);
855

856
    release_input_thread( p_mi );
857

858
    lock( p_mi );
859
    set_state( p_mi, libvlc_NothingSpecial, true );
860
    unlock_input( p_mi );
861

862
    libvlc_media_release( p_mi->p_md );
863

864 865 866
    if( !p_md )
    {
        p_mi->p_md = NULL;
867
        unlock(p_mi);
868 869 870
        return; /* It is ok to pass a NULL md */
    }

871
    libvlc_media_retain( p_md );
872
    p_mi->p_md = p_md;
873

874 875 876 877
    /* The policy here is to ignore that we were created using a different
     * libvlc_instance, because we don't really care */
    p_mi->p_libvlc_instance = p_md->p_libvlc_instance;

878
    unlock(p_mi);
879 880 881 882 883 884

    /* Send an event for the newly available media */
    libvlc_event_t event;
    event.type = libvlc_MediaPlayerMediaChanged;
    event.u.media_player_media_changed.new_media = p_md;
    libvlc_event_send( p_mi->p_event_manager, &event );
885

886 887 888
}

/**************************************************************************
JP Dinger's avatar
JP Dinger committed
889
 * Get the Media descriptor associated with the instance.
890
 **************************************************************************/
891
libvlc_media_t *
892
libvlc_media_player_get_media( libvlc_media_player_t *p_mi )
893
{
894
    libvlc_media_t *p_m;
895

896
    lock( p_mi );
897 898
    p_m = p_mi->p_md;
    if( p_m )
899 900 901 902
        libvlc_media_retain( p_m );
    unlock( p_mi );

    return p_m;
903 904
}

905
/**************************************************************************
JP Dinger's avatar
JP Dinger committed
906
 * Get the event Manager.
907 908
 **************************************************************************/
libvlc_event_manager_t *
909
libvlc_media_player_event_manager( libvlc_media_player_t *p_mi )
910 911 912 913
{
    return p_mi->p_event_manager;
}

914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933
static void add_es_callbacks( input_thread_t *p_input_thread, libvlc_media_player_t *p_mi )
{
    var_AddListCallback( p_input_thread, "video-es", input_es_changed, p_mi );
    var_AddListCallback( p_input_thread, "audio-es", input_es_changed, p_mi );
    var_AddListCallback( p_input_thread, "spu-es", input_es_changed, p_mi );
    var_AddCallback( p_input_thread, "video-es", input_es_selected, p_mi );
    var_AddCallback( p_input_thread, "audio-es", input_es_selected, p_mi );
    var_AddCallback( p_input_thread, "spu-es", input_es_selected, p_mi );
}

static void del_es_callbacks( input_thread_t *p_input_thread, libvlc_media_player_t *p_mi )
{
    var_DelListCallback( p_input_thread, "video-es", input_es_changed, p_mi );
    var_DelListCallback( p_input_thread, "audio-es", input_es_changed, p_mi );
    var_DelListCallback( p_input_thread, "spu-es", input_es_changed, p_mi );
    var_DelCallback( p_input_thread, "video-es", input_es_selected, p_mi );
    var_DelCallback( p_input_thread, "audio-es", input_es_selected, p_mi );
    var_DelCallback( p_input_thread, "spu-es", input_es_selected, p_mi );
}

934
/**************************************************************************
JP Dinger's avatar
JP Dinger committed
935
 * Tell media player to start playing.
936
 **************************************************************************/
Rémi Denis-Courmont's avatar
good  
Rémi Denis-Courmont committed
937
int libvlc_media_player_play( libvlc_media_player_t *p_mi )
938
{
939
    lock_input( p_mi );
940

941 942
    input_thread_t *p_input_thread = p_mi->input.p_thread;
    if( p_input_thread )
943
    {
Sam Hocevar's avatar
Sam Hocevar committed
944
        /* A thread already exists, send it a play message */
945
        input_Control( p_input_thread, INPUT_SET_STATE, PLAYING_S );
946
        unlock_input( p_mi );
Rémi Denis-Courmont's avatar
good  
Rémi Denis-Courmont committed
947
        return 0;
948 949
    }

950
    /* Ignore previous exception */
951
    lock(p_mi);
952

953 954
    if( !p_mi->p_md )
    {
955
        unlock(p_mi);
956
        unlock_input( p_mi );
957
        libvlc_printerr( "No associated media descriptor" );
Rémi Denis-Courmont's avatar
good  
Rémi Denis-Courmont committed
958
        return -1;
959 960
    }

961 962
    media_attach_preparsed_event( p_mi->p_md );

963 964 965 966
    p_input_thread = input_Create( p_mi, p_mi->p_md->p_input_item, NULL,
                                   p_mi->input.p_resource );
    unlock(p_mi);
    if( !p_input_thread )
967
    {
968
        unlock_input(p_mi);
969
        media_detach_preparsed_event( p_mi->p_md );
Rémi Denis-Courmont's avatar
good  
Rémi Denis-Courmont committed
970 971
        libvlc_printerr( "Not enough memory" );
        return -1;
972
    }
973

974 975
    var_AddCallback( p_input_thread, "can-seek", input_seekable_changed, p_mi );
    var_AddCallback( p_input_thread, "can-pause", input_pausable_changed, p_mi );
976
    var_AddCallback( p_input_thread, "program-scrambled", input_scrambled_changed, p_mi );
Laurent Aimar's avatar
Laurent Aimar committed
977
    var_AddCallback( p_input_thread, "intf-event", input_event_changed, p_mi );
978
    add_es_callbacks( p_input_thread, p_mi );
979

980 981
    if( input_Start( p_input_thread ) )
    {
982
        unlock_input(p_mi);
983
        del_es_callbacks( p_input_thread, p_mi );
984 985
        var_DelCallback( p_input_thread, "intf-event", input_event_changed, p_mi );
        var_DelCallback( p_input_thread, "can-pause", input_pausable_changed, p_mi );
986
        var_DelCallback( p_input_thread, "program-scrambled", input_scrambled_changed, p_mi );
987
        var_DelCallback( p_input_thread, "can-seek", input_seekable_changed, p_mi );
988
        input_Close( p_input_thread );
989
        media_detach_preparsed_event( p_mi->p_md );
990 991
        libvlc_printerr( "Input initialization failure" );
        return -1;
992
    }
993 994
    p_mi->input.p_thread = p_input_thread;
    unlock_input(p_mi);
Rémi Denis-Courmont's avatar
good  
Rémi Denis-Courmont committed
995
    return 0;
996 997
}

998
void libvlc_media_player_set_pause( libvlc_media_player_t *p_mi, int paused )
999
{
1000
    input_thread_t * p_input_thread = libvlc_get_input_thread( p_mi );
1001
    if( !p_input_thread )
1002 1003
        return;

1004
    libvlc_state_t state = libvlc_media_player_get_state( p_mi );
1005
    if( state == libvlc_Playing )
1006
    {
1007 1008 1009 1010 1011
        if( paused )
        {
            if( libvlc_media_player_can_pause( p_mi ) )
                input_Control( p_input_thread, INPUT_SET_STATE, PAUSE_S );
            else
1012
                input_Stop( p_input_thread );
1013
        }
1014
    }
1015
    else
1016 1017 1018 1019
    {
        if( !paused )
            input_Control( p_input_thread, INPUT_SET_STATE, PLAYING_S );
    }
1020

1021
    vlc_object_release( p_input_thread );
1022
}
1023

1024 1025 1026 1027 1028
/**************************************************************************
 * Toggle pause.
 **************************************************************************/
void libvlc_media_player_pause( libvlc_media_player_t *p_mi )
{
1029
    libvlc_media_player_set_pause( p_mi, libvlc_media_player_is_playing( p_mi ) );
1030 1031
}

1032
/**************************************************************************
JP Dinger's avatar
JP Dinger committed
1033
 * Tells whether the media player is currently playing.
1034
 **************************************************************************/
1035
int libvlc_media_player_is_playing( libvlc_media_player_t *p_mi )
1036
{
1037
    libvlc_state_t state = libvlc_media_player_get_state( p_mi );
1038
    return libvlc_Playing == state;
1039 1040
}

1041
/**************************************************************************
JP Dinger's avatar
JP Dinger committed
1042
 * Stop playing.
1043
 **************************************************************************/
1044
void libvlc_media_player_stop( libvlc_media_player_t *p_mi )
1045
{
1046
    lock_input(p_mi);
1047
    release_input_thread( p_mi ); /* This will stop the input thread */