media_player.c 43.9 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
 *****************************************************************************
Jean-Baptiste Kempf's avatar
LGPL  
Jean-Baptiste Kempf committed
4
 * Copyright (C) 2005-2011 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 31 32
#include <vlc/libvlc_media.h>
#include <vlc/libvlc_events.h>

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

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

42
static int
43 44 45 46 47 48 49 50
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
Laurent Aimar's avatar
Laurent Aimar committed
51
input_event_changed( vlc_object_t * p_this, char const * psz_cmd,
52 53 54
                     vlc_value_t oldval, vlc_value_t newval,
                     void * p_userdata );

55 56 57
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 );
58

59
static void libvlc_media_player_destroy( libvlc_media_player_t *p_mi );
60

61 62 63 64 65 66 67
/*
 * Shortcuts
 */

#define register_event(a, b) __register_event(a, libvlc_MediaPlayer ## b)
static inline void __register_event(libvlc_media_player_t *mp, libvlc_event_type_t type)
{
68
    libvlc_event_manager_register_event_type(mp->p_event_manager, type);
69 70
}

71 72 73 74 75 76 77 78 79
/*
 * 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.
 */
80 81 82 83 84 85 86 87 88 89
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);
}

90 91 92 93 94 95 96 97 98 99
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);
}

100
/*
JP Dinger's avatar
JP Dinger committed
101
 * Release the associated input thread.
102 103
 *
 * Object lock is NOT held.
104
 * Input lock is held or instance is being destroyed.
105
 */
106
static void release_input_thread( libvlc_media_player_t *p_mi, bool b_input_abort )
107
{
108
    assert( p_mi );
109

110
    input_thread_t *p_input_thread = p_mi->input.p_thread;
111
    if( !p_input_thread )
112
        return;
113
    p_mi->input.p_thread = NULL;
114

115 116 117 118 119 120 121 122 123
    var_DelCallback( p_input_thread, "can-seek",
                     input_seekable_changed, p_mi );
    var_DelCallback( p_input_thread, "can-pause",
                    input_pausable_changed, p_mi );
    var_DelCallback( p_input_thread, "intf-event",
                     input_event_changed, p_mi );

    /* We owned this one */
    input_Stop( p_input_thread, b_input_abort );
124
    input_Close( p_input_thread );
125 126
}

127 128
/*
 * Retrieve the input thread. Be sure to release the object
129
 * once you are done with it. (libvlc Internal)
130
 */
131
input_thread_t *libvlc_get_input_thread( libvlc_media_player_t *p_mi )
Clément Stenac's avatar
Clément Stenac committed
132 133 134
{
    input_thread_t *p_input_thread;

135
    assert( p_mi );
136

137 138
    lock_input(p_mi);
    p_input_thread = p_mi->input.p_thread;
139 140
    if( p_input_thread )
        vlc_object_hold( p_input_thread );
141 142
    else
        libvlc_printerr( "No active input" );
143
    unlock_input(p_mi);
144

145 146 147
    return p_input_thread;
}

148 149 150 151 152
/*
 * Set the internal state of the media_player. (media player Internal)
 *
 * Function will lock the media_player.
 */
153 154 155 156 157
static void set_state( libvlc_media_player_t *p_mi, libvlc_state_t state,
    bool b_locked )
{
    if(!b_locked)
        lock(p_mi);
158
    p_mi->state = state;
159

160 161 162
    libvlc_media_t *media = p_mi->p_md;
    if (media)
        libvlc_media_retain(media);
163

164 165
    if(!b_locked)
        unlock(p_mi);
166

167 168
    if (media)
    {
169 170 171
        // Also set the state of the corresponding media
        // This is strictly for convenience.
        libvlc_media_set_state(media, state);
172 173

        libvlc_media_release(media);
174 175 176
    }
}

177
static int
178
input_seekable_changed( vlc_object_t * p_this, char const * psz_cmd,
179 180 181 182
                        vlc_value_t oldval, vlc_value_t newval,
                        void * p_userdata )
{
    VLC_UNUSED(oldval);
183 184
    VLC_UNUSED(p_this);
    VLC_UNUSED(psz_cmd);
185
    libvlc_media_player_t * p_mi = p_userdata;
186 187
    libvlc_event_t event;

188
    event.type = libvlc_MediaPlayerSeekableChanged;
189
    event.u.media_player_seekable_changed.new_seekable = newval.b_bool;
190 191 192 193 194 195 196 197 198 199 200

    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);
201 202
    VLC_UNUSED(p_this);
    VLC_UNUSED(psz_cmd);
203
    libvlc_media_player_t * p_mi = p_userdata;
204 205
    libvlc_event_t event;

206
    event.type = libvlc_MediaPlayerPausableChanged;
207
    event.u.media_player_pausable_changed.new_pausable = newval.b_bool;
208 209 210 211 212

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

213
static int
Laurent Aimar's avatar
Laurent Aimar committed
214
input_event_changed( vlc_object_t * p_this, char const * psz_cmd,
215 216 217
                     vlc_value_t oldval, vlc_value_t newval,
                     void * p_userdata )
{
218
    VLC_UNUSED(oldval);
Laurent Aimar's avatar
Laurent Aimar committed
219
    input_thread_t * p_input = (input_thread_t *)p_this;
220
    libvlc_media_player_t * p_mi = p_userdata;
Laurent Aimar's avatar
Laurent Aimar committed
221
    libvlc_event_t event;
222

223
    assert( !strcmp( psz_cmd, "intf-event" ) );
224

225 226
    if( newval.i_int == INPUT_EVENT_STATE )
    {
227
        libvlc_state_t libvlc_state;
228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258

        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;
        }
259

260
        set_state( p_mi, libvlc_state, false );
261 262
        libvlc_event_send( p_mi->p_event_manager, &event );
    }
263 264 265 266 267
    else if( newval.i_int == INPUT_EVENT_ABORT )
    {
        libvlc_state_t libvlc_state = libvlc_Stopped;
        event.type = libvlc_MediaPlayerStopped;

268
        set_state( p_mi, libvlc_state, false );
269 270
        libvlc_event_send( p_mi->p_event_manager, &event );
    }
271
    else if( newval.i_int == INPUT_EVENT_POSITION )
272 273 274 275 276 277
    {
        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
278 279
        event.u.media_player_position_changed.new_position =
                                          var_GetFloat( p_input, "position" );
280 281 282 283
        libvlc_event_send( p_mi->p_event_manager, &event );

        /* */
        event.type = libvlc_MediaPlayerTimeChanged;
JP Dinger's avatar
JP Dinger committed
284
        event.u.media_player_time_changed.new_time =
285
           from_mtime(var_GetTime( p_input, "time" ));
286 287
        libvlc_event_send( p_mi->p_event_manager, &event );
    }
288 289 290 291
    else if( newval.i_int == INPUT_EVENT_LENGTH )
    {
        event.type = libvlc_MediaPlayerLengthChanged;
        event.u.media_player_length_changed.new_length =
292
           from_mtime(var_GetTime( p_input, "length" ));
293 294
        libvlc_event_send( p_mi->p_event_manager, &event );
    }
295 296 297 298 299 300 301
    else if( newval.i_int == INPUT_EVENT_CACHE )
    {
        event.type = libvlc_MediaPlayerBuffering;
        event.u.media_player_buffering.new_cache = (int)(100 *
            var_GetFloat( p_input, "cache" ));
        libvlc_event_send( p_mi->p_event_manager, &event );
    }
302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320
    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 );
    }
Laurent Aimar's avatar
Laurent Aimar committed
321

322 323 324
    return VLC_SUCCESS;
}

325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343
/**************************************************************************
 * 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;
}

344
/* */
345 346
static void libvlc_media_player_destroy( libvlc_media_player_t * );

347

348
/**************************************************************************
JP Dinger's avatar
JP Dinger committed
349 350 351 352 353 354 355 356 357 358 359 360
 * 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.
361
 **************************************************************************/
362
libvlc_media_player_t *
Rémi Denis-Courmont's avatar
good  
Rémi Denis-Courmont committed
363
libvlc_media_player_new( libvlc_instance_t *instance )
364
{
365
    libvlc_media_player_t * mp;
366

367
    assert(instance);
368

369 370
    mp = vlc_object_create (instance->p_libvlc_int, sizeof(*mp));
    if (unlikely(mp == NULL))
371
    {
372
        libvlc_printerr("Not enough memory");
373 374
        return NULL;
    }
375

376 377 378
    /* Input */
    var_Create (mp, "rate", VLC_VAR_FLOAT|VLC_VAR_DOINHERIT);

379
    /* Video */
380
    var_Create (mp, "vout", VLC_VAR_STRING|VLC_VAR_DOINHERIT);
381
    var_Create (mp, "window", VLC_VAR_STRING);
382 383 384 385
    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);
386 387
    var_Create (mp, "vmem-setup", VLC_VAR_ADDRESS);
    var_Create (mp, "vmem-cleanup", VLC_VAR_ADDRESS);
388 389 390
    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);
391
    var_Create (mp, "vmem-pitch", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
392
    var_Create (mp, "drawable-xid", VLC_VAR_INTEGER);
393
#if defined (_WIN32) || defined (__OS2__)
394
    var_Create (mp, "drawable-hwnd", VLC_VAR_INTEGER);
395 396 397 398 399 400 401 402 403
#endif
#ifdef __APPLE__
    var_Create (mp, "drawable-agl", VLC_VAR_INTEGER);
    var_Create (mp, "drawable-nsobject", VLC_VAR_ADDRESS);
#endif

    var_Create (mp, "keyboard-events", VLC_VAR_BOOL);
    var_SetBool (mp, "keyboard-events", true);
    var_Create (mp, "mouse-events", VLC_VAR_BOOL);
404
    var_SetBool (mp, "mouse-events", true);
405

406 407 408 409 410 411 412 413 414
    var_Create (mp, "fullscreen", VLC_VAR_BOOL);
    var_Create (mp, "autoscale", VLC_VAR_BOOL);
    var_SetBool (mp, "autoscale", true);
    var_Create (mp, "scale", VLC_VAR_FLOAT);
    var_SetFloat (mp, "scale", 1.);
    var_Create (mp, "aspect-ratio", VLC_VAR_STRING);
    var_Create (mp, "crop", VLC_VAR_STRING);
    var_Create (mp, "deinterlace", VLC_VAR_INTEGER);
    var_Create (mp, "deinterlace-mode", VLC_VAR_STRING);
415

416
    var_Create (mp, "vbi-page", VLC_VAR_INTEGER);
417

418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435
    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);

436 437 438 439 440 441
    var_Create (mp, "contrast", VLC_VAR_FLOAT | VLC_VAR_DOINHERIT);
    var_Create (mp, "brightness", VLC_VAR_FLOAT | VLC_VAR_DOINHERIT);
    var_Create (mp, "hue", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT);
    var_Create (mp, "saturation", VLC_VAR_FLOAT | VLC_VAR_DOINHERIT);
    var_Create (mp, "gamma", VLC_VAR_FLOAT | VLC_VAR_DOINHERIT);

442
     /* Audio */
443
    var_Create (mp, "aout", VLC_VAR_STRING | VLC_VAR_DOINHERIT);
444
    var_Create (mp, "mute", VLC_VAR_BOOL);
445
    var_Create (mp, "volume", VLC_VAR_FLOAT);
446
    var_Create (mp, "corks", VLC_VAR_INTEGER);
447 448
    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
449
    var_Create (mp, "amem-cleanup", VLC_VAR_ADDRESS);
450
    var_Create (mp, "amem-play", VLC_VAR_ADDRESS);
451 452 453 454
    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);
455 456 457 458
    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);
459

460 461 462 463 464
    /* 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);

465
    mp->p_md = NULL;
466
    mp->state = libvlc_NothingSpecial;
467
    mp->p_libvlc_instance = instance;
468
    mp->input.p_thread = NULL;
469 470 471 472 473 474
    mp->input.p_resource = input_resource_New(VLC_OBJECT(mp));
    if (unlikely(mp->input.p_resource == NULL))
    {
        vlc_object_release(mp);
        return NULL;
    }
475
    vlc_mutex_init (&mp->input.lock);
476
    mp->i_refcount = 1;
477 478
    mp->p_event_manager = libvlc_event_manager_new(mp, instance);
    if (unlikely(mp->p_event_manager == NULL))
479
    {
480
        input_resource_Release(mp->input.p_resource);
481
        vlc_object_release(mp);
482 483
        return NULL;
    }
484
    vlc_mutex_init(&mp->object_lock);
485

486 487 488 489 490 491 492 493 494 495
    register_event(mp, NothingSpecial);
    register_event(mp, Opening);
    register_event(mp, Buffering);
    register_event(mp, Playing);
    register_event(mp, Paused);
    register_event(mp, Stopped);
    register_event(mp, Forward);
    register_event(mp, Backward);
    register_event(mp, EndReached);
    register_event(mp, EncounteredError);
496
    register_event(mp, SeekableChanged);
497 498 499 500 501 502

    register_event(mp, PositionChanged);
    register_event(mp, TimeChanged);
    register_event(mp, LengthChanged);
    register_event(mp, TitleChanged);
    register_event(mp, PausableChanged);
503

504 505
    register_event(mp, Vout);

506
    /* Snapshot initialization */
507
    register_event(mp, SnapshotTaken);
Jean-Paul Saman's avatar
Jean-Paul Saman committed
508

509 510
    register_event(mp, MediaChanged);

511
    /* Attach a var callback to the global object to provide the glue between
512 513 514 515 516 517
     * 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.
     */
518
    var_AddCallback(mp->p_libvlc, "snapshot-file", snapshot_was_taken, mp);
519

520
    libvlc_retain(instance);
521
    return mp;
522 523 524
}

/**************************************************************************
JP Dinger's avatar
JP Dinger committed
525
 * Create a Media Instance object with a media descriptor.
526
 **************************************************************************/
527
libvlc_media_player_t *
Rémi Denis-Courmont's avatar
good  
Rémi Denis-Courmont committed
528
libvlc_media_player_new_from_media( libvlc_media_t * p_md )
529
{
530
    libvlc_media_player_t * p_mi;
531

Rémi Denis-Courmont's avatar
good  
Rémi Denis-Courmont committed
532
    p_mi = libvlc_media_player_new( p_md->p_libvlc_instance );
533
    if( !p_mi )
534 535
        return NULL;

536
    libvlc_media_retain( p_md );
537
    p_mi->p_md = p_md;
538 539 540 541 542

    return p_mi;
}

/**************************************************************************
543
 * Destroy a Media Instance object (libvlc internal)
544
 *
JP Dinger's avatar
JP Dinger committed
545
 * Warning: No lock held here, but hey, this is internal. Caller must lock.
546
 **************************************************************************/
547
static void libvlc_media_player_destroy( libvlc_media_player_t *p_mi )
548
{
549
    assert( p_mi );
Jean-Paul Saman's avatar
Jean-Paul Saman committed
550

551
    /* Detach Callback from the main libvlc object */
552
    var_DelCallback( p_mi->p_libvlc,
553
                     "snapshot-file", snapshot_was_taken, p_mi );
554

555 556
    /* No need for lock_input() because no other threads knows us anymore */
    if( p_mi->input.p_thread )
557
        release_input_thread(p_mi, true);
558 559
    input_resource_Terminate( p_mi->input.p_resource );
    input_resource_Release( p_mi->input.p_resource );
560
    vlc_mutex_destroy( &p_mi->input.lock );
561

562
    libvlc_event_manager_release( p_mi->p_event_manager );
563
    libvlc_media_release( p_mi->p_md );
564
    vlc_mutex_destroy( &p_mi->object_lock );
565 566

    libvlc_instance_t *instance = p_mi->p_libvlc_instance;
567
    vlc_object_release( p_mi );
568
    libvlc_release(instance);
569 570 571
}

/**************************************************************************
JP Dinger's avatar
JP Dinger committed
572 573 574
 * Release a Media Instance object.
 *
 * Function does the locking.
575
 **************************************************************************/
576
void libvlc_media_player_release( libvlc_media_player_t *p_mi )
577
{
578
    bool destroy;
579

580
    assert( p_mi );
581
    lock(p_mi);
582
    destroy = !--p_mi->i_refcount;
583
    unlock(p_mi);
584

585 586
    if( destroy )
        libvlc_media_player_destroy( p_mi );
587
}
588

589
/**************************************************************************
JP Dinger's avatar
JP Dinger committed
590 591 592
 * Retain a Media Instance object.
 *
 * Caller must hold the lock.
593
 **************************************************************************/
594
void libvlc_media_player_retain( libvlc_media_player_t *p_mi )
595
{
596
    assert( p_mi );
597

598
    lock(p_mi);
599
    p_mi->i_refcount++;
600
    unlock(p_mi);
601
}
602

603
/**************************************************************************
JP Dinger's avatar
JP Dinger committed
604 605 606
 * Set the Media descriptor associated with the instance.
 *
 * Enter without lock -- function will lock the object.
607
 **************************************************************************/
608 609
void libvlc_media_player_set_media(
                            libvlc_media_player_t *p_mi,
610
                            libvlc_media_t *p_md )
611
{
612
    lock_input(p_mi);
613

614 615 616
    /* FIXME I am not sure if it is a user request or on die(eof/error)
     * request here */
    release_input_thread( p_mi,
617 618 619
                          p_mi->input.p_thread &&
                          !p_mi->input.p_thread->b_eof &&
                          !p_mi->input.p_thread->b_error );
620

621
    lock( p_mi );
622
    set_state( p_mi, libvlc_NothingSpecial, true );
623
    unlock_input( p_mi );
624

625
    libvlc_media_release( p_mi->p_md );
626

627 628 629
    if( !p_md )
    {
        p_mi->p_md = NULL;
630
        unlock(p_mi);
631 632 633
        return; /* It is ok to pass a NULL md */
    }

634
    libvlc_media_retain( p_md );
635
    p_mi->p_md = p_md;
636

637 638 639 640
    /* 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;

641
    unlock(p_mi);
642 643 644 645 646 647

    /* 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 );
648

649 650 651
}

/**************************************************************************
JP Dinger's avatar
JP Dinger committed
652
 * Get the Media descriptor associated with the instance.
653
 **************************************************************************/
654
libvlc_media_t *
655
libvlc_media_player_get_media( libvlc_media_player_t *p_mi )
656
{
657
    libvlc_media_t *p_m;
658

659
    lock(p_mi);
660 661 662
    p_m = p_mi->p_md;
    if( p_m )
        libvlc_media_retain( p_mi->p_md );
663
    unlock(p_mi);
664
    return p_mi->p_md;
665 666
}

667
/**************************************************************************
JP Dinger's avatar
JP Dinger committed
668
 * Get the event Manager.
669 670
 **************************************************************************/
libvlc_event_manager_t *
671
libvlc_media_player_event_manager( libvlc_media_player_t *p_mi )
672 673 674 675
{
    return p_mi->p_event_manager;
}

676
/**************************************************************************
JP Dinger's avatar
JP Dinger committed
677
 * Tell media player to start playing.
678
 **************************************************************************/
Rémi Denis-Courmont's avatar
good  
Rémi Denis-Courmont committed
679
int libvlc_media_player_play( libvlc_media_player_t *p_mi )
680
{
681
    lock_input( p_mi );
682

683 684
    input_thread_t *p_input_thread = p_mi->input.p_thread;
    if( p_input_thread )
685
    {
Sam Hocevar's avatar
Sam Hocevar committed
686
        /* A thread already exists, send it a play message */
687
        input_Control( p_input_thread, INPUT_SET_STATE, PLAYING_S );
688
        unlock_input( p_mi );
Rémi Denis-Courmont's avatar
good  
Rémi Denis-Courmont committed
689
        return 0;
690 691
    }

692
    /* Ignore previous exception */
693
    lock(p_mi);
694

695 696
    if( !p_mi->p_md )
    {
697
        unlock(p_mi);
698
        unlock_input( p_mi );
699
        libvlc_printerr( "No associated media descriptor" );
Rémi Denis-Courmont's avatar
good  
Rémi Denis-Courmont committed
700
        return -1;
701 702
    }

703 704 705 706
    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 )
707
    {
708
        unlock_input(p_mi);
Rémi Denis-Courmont's avatar
good  
Rémi Denis-Courmont committed
709 710
        libvlc_printerr( "Not enough memory" );
        return -1;
711
    }
712

713 714
    var_AddCallback( p_input_thread, "can-seek", input_seekable_changed, p_mi );
    var_AddCallback( p_input_thread, "can-pause", input_pausable_changed, p_mi );
Laurent Aimar's avatar
Laurent Aimar committed
715
    var_AddCallback( p_input_thread, "intf-event", input_event_changed, p_mi );
716

717 718
    if( input_Start( p_input_thread ) )
    {
719 720 721 722
        unlock_input(p_mi);
        var_DelCallback( p_input_thread, "intf-event", input_event_changed, p_mi );
        var_DelCallback( p_input_thread, "can-pause", input_pausable_changed, p_mi );
        var_DelCallback( p_input_thread, "can-seek", input_seekable_changed, p_mi );
723
        vlc_object_release( p_input_thread );
724 725
        libvlc_printerr( "Input initialization failure" );
        return -1;
726
    }
727 728
    p_mi->input.p_thread = p_input_thread;
    unlock_input(p_mi);
Rémi Denis-Courmont's avatar
good  
Rémi Denis-Courmont committed
729
    return 0;
730 731
}

732
void libvlc_media_player_set_pause( libvlc_media_player_t *p_mi, int paused )
733
{
734
    input_thread_t * p_input_thread = libvlc_get_input_thread( p_mi );
735
    if( !p_input_thread )
736 737
        return;

738
    libvlc_state_t state = libvlc_media_player_get_state( p_mi );
739
    if( state == libvlc_Playing || state == libvlc_Buffering )
740
    {
741 742 743 744 745 746 747
        if( paused )
        {
            if( libvlc_media_player_can_pause( p_mi ) )
                input_Control( p_input_thread, INPUT_SET_STATE, PAUSE_S );
            else
                libvlc_media_player_stop( p_mi );
        }
748
    }
749
    else
750 751 752 753
    {
        if( !paused )
            input_Control( p_input_thread, INPUT_SET_STATE, PLAYING_S );
    }
754

755
    vlc_object_release( p_input_thread );
756
}
757

758 759 760 761 762 763 764 765 766 767 768
/**************************************************************************
 * Toggle pause.
 **************************************************************************/
void libvlc_media_player_pause( libvlc_media_player_t *p_mi )
{
    libvlc_state_t state = libvlc_media_player_get_state( p_mi );
    bool playing = (state == libvlc_Playing || state == libvlc_Buffering);

    libvlc_media_player_set_pause( p_mi, playing );
}

769
/**************************************************************************
JP Dinger's avatar
JP Dinger committed
770 771 772
 * Tells whether the media player is currently playing.
 *
 * Enter with lock held.
773
 **************************************************************************/
774
int libvlc_media_player_is_playing( libvlc_media_player_t *p_mi )
775
{
776
    libvlc_state_t state = libvlc_media_player_get_state( p_mi );
777
    return (libvlc_Playing == state) || (libvlc_Buffering == state);
778 779
}

780
/**************************************************************************
JP Dinger's avatar
JP Dinger committed
781
 * Stop playing.
782
 **************************************************************************/
783
void libvlc_media_player_stop( libvlc_media_player_t *p_mi )
784
{
785
    libvlc_state_t state = libvlc_media_player_get_state( p_mi );
786

787
    lock_input(p_mi);
788 789 790 791 792
    release_input_thread( p_mi, true ); /* This will stop the input thread */

    /* Force to go to stopped state, in case we were in Ended, or Error
     * state. */
    if( state != libvlc_Stopped )
793
    {
794
        set_state( p_mi, libvlc_Stopped, false );
795 796 797

        /* Construct and send the event */
        libvlc_event_t event;
798
        event.type = libvlc_MediaPlayerStopped;
799 800
        libvlc_event_send( p_mi->p_event_manager, &event );
    }
801

802
    input_resource_Terminate( p_mi->input.p_resource );
803
    unlock_input(p_mi);
804 805
}

806 807 808 809 810 811 812 813 814 815 816 817 818 819

void libvlc_video_set_callbacks( libvlc_media_player_t *mp,
    void *(*lock_cb) (void *, void **),
    void (*unlock_cb) (void *, void *, void *const *),
    void (*display_cb) (void *, void *),
    void *opaque )
{
    var_SetAddress( mp, "vmem-lock", lock_cb );
    var_SetAddress( mp, "vmem-unlock", unlock_cb );
    var_SetAddress( mp, "vmem-display", display_cb );
    var_SetAddress( mp, "vmem-data", opaque );
    var_SetString( mp, "vout", "vmem" );
}

820 821 822 823 824 825 826 827
void libvlc_video_set_format_callbacks( libvlc_media_player_t *mp,
                                        libvlc_video_format_cb setup,
                                        libvlc_video_cleanup_cb cleanup )
{
    var_SetAddress( mp, "vmem-setup", setup );
    var_SetAddress( mp, "vmem-cleanup", cleanup );
}

828 829 830 831 832 833 834 835 836
void libvlc_video_set_format( libvlc_media_player_t *mp, const char *chroma,
                              unsigned width, unsigned height, unsigned pitch )
{
    var_SetString( mp, "vmem-chroma", chroma );
    var_SetInteger( mp, "vmem-width", width );
    var_SetInteger( mp, "vmem-height", height );
    var_SetInteger( mp, "vmem-pitch", pitch );
}

837 838 839 840
/**************************************************************************
 * set_nsobject
 **************************************************************************/
void libvlc_media_player_set_nsobject( libvlc_media_player_t *p_mi,
841
                                        void * drawable )
842
{
843 844 845 846 847 848
    assert (p_mi != NULL);
#ifdef __APPLE__
    var_SetAddress (p_mi, "drawable-nsobject", drawable);
#else
    (void) p_mi; (void)drawable;
#endif
849 850 851
}

/**************************************************************************
852
 * get_nsobject
853
 **************************************************************************/
Pierre's avatar
Pierre committed
854
void * libvlc_media_player_get_nsobject( libvlc_media_player_t *p_mi )
855
{
856 857 858 859 860 861
    assert (p_mi != NULL);
#ifdef __APPLE__
    return var_GetAddress (p_mi, "drawable-nsobject");
#else
    return NULL;
#endif
862 863
}

864 865 866 867
/**************************************************************************
 * set_agl
 **************************************************************************/
void libvlc_media_player_set_agl( libvlc_media_player_t *p_mi,
868
                                  uint32_t drawable )
869
{
870 871 872 873 874
#ifdef __APPLE__
    var_SetInteger (p_mi, "drawable-agl", drawable);
#else
    (void) p_mi; (void)drawable;
#endif
875 876 877 878 879 880 881
}

/**************************************************************************
 * get_agl
 **************************************************************************/
uint32_t libvlc_media_player_get_agl( libvlc_media_player_t *p_mi )
{
882 883 884 885 886 887
    assert (p_mi != NULL);
#ifdef __APPLE__
    return var_GetInteger (p_mi, "drawable-agl");
#else
    return 0;
#endif
888 889
}

JP Dinger's avatar
JP Dinger committed
890 891 892
/**************************************************************************
 * set_xwindow
 **************************************************************************/
893
void libvlc_media_player_set_xwindow( libvlc_media_player_t *p_mi,
894
                                      uint32_t drawable )
895
{
896
    assert (p_mi != NULL);
897 898

    var_SetString (p_mi, "vout", drawable ? "xid" : "any");
899
    var_SetString (p_mi, "window", drawable ? "embed-xid,any" : "any");
900
    var_SetInteger (p_mi, "drawable-xid", drawable);
901 902
}

JP Dinger's avatar
JP Dinger committed
903 904 905
/**************************************************************************
 * get_xwindow
 **************************************************************************/
906 907
uint32_t libvlc_media_player_get_xwindow( libvlc_media_player_t *p_mi )
{
908
    return var_GetInteger (p_mi, "drawable-xid");
909 910
}

JP Dinger's avatar
JP Dinger committed
911 912 913
/**************************************************************************
 * set_hwnd
 **************************************************************************/
914
void libvlc_media_player_set_hwnd( libvlc_media_player_t *p_mi,
915
                                   void *drawable )
916
{
917
    assert (p_mi != NULL);
918
#if defined (_WIN32) || defined (__OS2__)
919 920
    var_SetString (p_mi, "window",
                   (drawable != NULL) ? "embed-hwnd,any" : "");
921
    var_SetInteger (p_mi, "drawable-hwnd", (uintptr_t)drawable);
922 923 924
#else
    (void) p_mi; (void) drawable;
#endif
925 926
}

JP Dinger's avatar
JP Dinger committed
927 928 929
/**************************************************************************
 * get_hwnd
 **************************************************************************/
930 931
void *libvlc_media_player_get_hwnd( libvlc_media_player_t *p_mi )
{
932
    assert (p_mi != NULL);
933
#if defined (_WIN32) || defined (__OS2__)
934
    return (void *)(uintptr_t)var_GetInteger (p_mi, "drawable-hwnd");
935 936 937
#else
    return NULL;
#endif
938 939
}

940 941
void libvlc_audio_set_callbacks( libvlc_media_player_t *mp,
                                 libvlc_audio_play_cb play_cb,
942 943 944 945
                                 libvlc_audio_pause_cb pause_cb,
                                 libvlc_audio_resume_cb resume_cb,
                                 libvlc_audio_flush_cb flush_cb,
                                 libvlc_audio_drain_cb drain_cb,
946 947 948
                                 void *opaque )
{
    var_SetAddress( mp, "amem-play", play_cb );
949 950 951 952
    var_SetAddress( mp, "amem-pause", pause_cb );
    var_SetAddress( mp, "amem-resume", resume_cb );
    var_SetAddress( mp, "amem-flush", flush_cb );
    var_SetAddress( mp, "amem-drain", drain_cb );
953
    var_SetAddress( mp, "amem-data", opaque );
Rémi Denis-Courmont's avatar
Rémi Denis-Courmont committed
954
    var_SetString( mp, "aout", "amem,none" );
955 956
}

957 958 959 960 961 962
void libvlc_audio_set_volume_callback( libvlc_media_player_t *mp,
                                       libvlc_audio_set_volume_cb cb )
{
    var_SetAddress( mp, "amem-set-volume", cb );
}

963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979
void libvlc_audio_set_format_callbacks( libvlc_media_player_t *mp,
                                        libvlc_audio_setup_cb setup,
                                        libvlc_audio_cleanup_cb cleanup )
{
    var_SetAddress( mp, "amem-setup", setup );
    var_SetAddress( mp, "amem-cleanup", cleanup );
}

void libvlc_audio_set_format( libvlc_media_player_t *mp, const char *format,
                              unsigned rate, unsigned channels )
{
    var_SetString( mp, "amem-format", format );
    var_SetInteger( mp, "amem-rate", rate );
    var_SetInteger( mp, "amem-channels", channels );
}


980 981 982
/**************************************************************************
 * Getters for stream information
 **************************************************************************/
983
libvlc_time_t libvlc_media_player_get_length(
Rémi Denis-Courmont's avatar
good  
Rémi Denis-Courmont committed
984
                             libvlc_media_player_t *p_mi )
985 986
{
    input_thread_t *p_input_thread;
987
    libvlc_time_t i_time;
988

989
    p_input_thread = libvlc_get_input_thread ( p_mi );
990
    if( !p_input_thread )
Jean-Paul Saman's avatar
Jean-Paul Saman committed
991 992
        return -1;

993
    i_time = from_mtime(var_GetTime( p_input_thread, "length" ));
Clément Stenac's avatar
Clément Stenac committed
994 995
    vlc_object_release( p_input_thread );

996
    return i_time;
Clément Stenac's avatar
Clément Stenac committed
997 998
}

Rémi Denis-Courmont's avatar
good  
Rémi Denis-Courmont committed
999
libvlc_time_t libvlc_media_player_get_time( libvlc_media_player_t *p_mi )
Clément Stenac's avatar
Clément Stenac committed
1000 1001
{
    input_thread_t *p_input_thread;
1002
    libvlc_time_t i_time;
Clément Stenac's avatar
Clément Stenac committed
1003

1004
    p_input_thread = libvlc_get_input_thread ( p_mi );
Damien Fouilleul's avatar