libvlc.c 37.7 KB
Newer Older
1 2 3
/*****************************************************************************
 * libvlc.c: main libvlc source
 *****************************************************************************
4
 * Copyright (C) 1998-2002 VideoLAN
Sam Hocevar's avatar
Sam Hocevar committed
5
 * $Id: libvlc.c,v 1.41 2002/10/15 12:30:00 sam Exp $
6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29
 *
 * Authors: Vincent Seguin <seguin@via.ecp.fr>
 *          Samuel Hocevar <sam@zoy.org>
 *          Gildas Bazin <gbazin@netcourrier.com>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (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
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
 *****************************************************************************/

/*****************************************************************************
 * Pretend we are a builtin module
 *****************************************************************************/
#define MODULE_NAME main
30
#define MODULE_PATH main
31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52
#define __BUILTIN__

/*****************************************************************************
 * Preamble
 *****************************************************************************/
#include <errno.h>                                                 /* ENOMEM */
#include <stdio.h>                                              /* sprintf() */
#include <string.h>                                            /* strerror() */
#include <stdlib.h>                                                /* free() */

#include <vlc/vlc.h>

#ifndef WIN32
#   include <netinet/in.h>                            /* BSD: struct in_addr */
#endif

#ifdef HAVE_UNISTD_H
#   include <unistd.h>
#elif defined( _MSC_VER ) && defined( _WIN32 )
#   include <io.h>
#endif

53
#ifdef WIN32                       /* optind, getopt(), included in unistd.h */
54
#   include "extras/GNUgetopt/getopt.h"
55 56
#endif

57 58 59 60 61
#ifdef HAVE_LOCALE_H
#   include <locale.h>
#endif

#include "vlc_cpu.h"                                        /* CPU detection */
62
#include "os_specific.h"
63

64
#include "error.h"
65 66 67 68 69
#include "netutils.h"                                 /* network_ChannelJoin */

#include "stream_control.h"
#include "input_ext-intf.h"

70
#include "vlc_playlist.h"
71 72 73 74 75 76 77 78 79 80
#include "interface.h"

#include "audio_output.h"

#include "video.h"
#include "video_output.h"

#include "libvlc.h"

/*****************************************************************************
81
 * The evil global variable. We handle it with care, don't worry.
82
 *****************************************************************************/
83
static libvlc_t libvlc;
Sam Hocevar's avatar
Sam Hocevar committed
84
static vlc_t *  p_static_vlc;
85 86 87 88

/*****************************************************************************
 * Local prototypes
 *****************************************************************************/
Sam Hocevar's avatar
Sam Hocevar committed
89
static void SetLanguage   ( char const * );
90
static int  GetFilenames  ( vlc_t *, int, char *[] );
91
static void Usage         ( vlc_t *, char const *psz_module_name );
92
static void ListModules   ( vlc_t * );
93 94 95 96 97 98 99
static void Version       ( void );

#ifdef WIN32
static void ShowConsole   ( void );
#endif

/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
100
 * VLC_Version: return the libvlc version.
101
 *****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
102
 * This function returns full version string (numeric version and codename).
103
 *****************************************************************************/
104
char const * VLC_Version( void )
105
{
Sam Hocevar's avatar
Sam Hocevar committed
106
    return VERSION_MESSAGE;
107 108
}

109 110 111 112 113 114 115 116 117 118
/*****************************************************************************
 * VLC_Error: strerror() equivalent
 *****************************************************************************
 * This function returns full version string (numeric version and codename).
 *****************************************************************************/
char const * VLC_Error( int i_err )
{
    return vlc_error( i_err );
}

Sam Hocevar's avatar
Sam Hocevar committed
119 120 121 122 123 124 125
/*****************************************************************************
 * VLC_Create: allocate a vlc_t structure, and initialize libvlc if needed.
 *****************************************************************************
 * This function allocates a vlc_t structure and returns a negative value
 * in case of failure. Also, the thread system is initialized.
 *****************************************************************************/
int VLC_Create( void )
126
{
127
    int i_ret;
128
    vlc_t * p_vlc = NULL;
129
    vlc_value_t lockval;
130

131 132 133
    /* vlc_threads_init *must* be the first internal call! No other call is
     * allowed before the thread system has been initialized. */
    i_ret = vlc_threads_init( &libvlc );
Sam Hocevar's avatar
Sam Hocevar committed
134
    if( i_ret < 0 )
135
    {
Sam Hocevar's avatar
Sam Hocevar committed
136
        return i_ret;
137 138 139
    }

    /* Now that the thread system is initialized, we don't have much, but
140 141 142 143
     * at least we have var_Create */
    var_Create( &libvlc, "libvlc", VLC_VAR_MUTEX );
    var_Get( &libvlc, "libvlc", &lockval );
    vlc_mutex_lock( lockval.p_address );
144 145
    if( !libvlc.b_ready )
    {
146 147
        char *psz_env;

148 149 150
        /* Guess what CPU we have */
        libvlc.i_cpu = CPUCapabilities();

151 152
        /* Find verbosity from VLC_VERBOSE environment variable */
        psz_env = getenv( "VLC_VERBOSE" );
153
        libvlc.i_verbose = psz_env ? atoi( psz_env ) : -1;
154 155 156 157 158 159 160

#ifdef HAVE_ISATTY
        libvlc.b_color = isatty( 2 ); /* 2 is for stderr */
#else
        libvlc.b_color = VLC_FALSE;
#endif

161 162 163 164 165 166 167
        /* Initialize message queue */
        msg_Create( &libvlc );

        /* Announce who we are */
        msg_Dbg( &libvlc, COPYRIGHT_MESSAGE );
        msg_Dbg( &libvlc, "libvlc was configured with %s", CONFIGURE_LINE );

168
        /* Initialize the module bank and load the configuration of the
169 170 171 172 173
         * main module. We need to do this at this stage to be able to display
         * a short help if required by the user. (short help == main module
         * options) */
        module_InitBank( &libvlc );
        module_LoadMain( &libvlc );
174 175

        libvlc.b_ready = VLC_TRUE;
176
    }
177 178
    vlc_mutex_unlock( lockval.p_address );
    var_Destroy( &libvlc, "libvlc" );
179 180 181

    /* Allocate a vlc object */
    p_vlc = vlc_object_create( &libvlc, VLC_OBJECT_VLC );
182 183
    if( p_vlc == NULL )
    {
Sam Hocevar's avatar
Sam Hocevar committed
184
        return VLC_EGENERIC;
185 186 187 188 189
    }

    p_vlc->psz_object_name = "root";

    /* Initialize mutexes */
190
    vlc_mutex_init( p_vlc, &p_vlc->config_lock );
191 192

    /* Store our newly allocated structure in the global list */
193
    vlc_object_attach( p_vlc, &libvlc );
194

Sam Hocevar's avatar
Sam Hocevar committed
195 196 197 198
    /* Store data for the non-reentrant API */
    p_static_vlc = p_vlc;

    return p_vlc->i_object_id;
199 200 201
}

/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
202
 * VLC_Init: initialize a vlc_t structure.
203 204 205 206 207 208 209
 *****************************************************************************
 * This function initializes a previously allocated vlc_t structure:
 *  - CPU detection
 *  - gettext initialization
 *  - message queue, module bank and playlist initialization
 *  - configuration and commandline parsing
 *****************************************************************************/
Sam Hocevar's avatar
Sam Hocevar committed
210
int VLC_Init( int i_object, int i_argc, char *ppsz_argv[] )
211
{
212 213 214
    char         p_capabilities[200];
    char *       p_tmp;
    vlc_bool_t   b_exit;
Sam Hocevar's avatar
Sam Hocevar committed
215
    vlc_t *      p_vlc;
216 217
    module_t    *p_help_module;
    playlist_t  *p_playlist;
218

Sam Hocevar's avatar
Sam Hocevar committed
219 220
    p_vlc = i_object ? vlc_object_get( &libvlc, i_object ) : p_static_vlc;

221
    if( !p_vlc )
222
    {
223
        return VLC_ENOOBJ;
224 225
    }

Sam Hocevar's avatar
Sam Hocevar committed
226 227 228 229
    /*
     * Support for gettext
     */
    SetLanguage( "" );
230 231

    /*
232
     * System specific initialization code
233
     */
234
    system_Init( p_vlc, &i_argc, ppsz_argv );
235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254

    /* Get the executable name (similar to the basename command) */
    if( i_argc > 0 )
    {
        p_vlc->psz_object_name = p_tmp = ppsz_argv[ 0 ];
        while( *p_tmp )
        {
            if( *p_tmp == '/' ) p_vlc->psz_object_name = ++p_tmp;
            else ++p_tmp;
        }
    }
    else
    {
        p_vlc->psz_object_name = "vlc";
    }

    /* Hack: insert the help module here */
    p_help_module = vlc_object_create( p_vlc, VLC_OBJECT_MODULE );
    if( p_help_module == NULL )
    {
255
        //module_EndBank( p_vlc );
256 257 258 259
        return VLC_EGENERIC;
    }
    p_help_module->psz_object_name = "help";
    config_Duplicate( p_help_module, p_help_config );
260
    vlc_object_attach( p_help_module, libvlc.p_module_bank );
261 262
    /* End hack */

Sam Hocevar's avatar
Sam Hocevar committed
263
    if( config_LoadCmdLine( p_vlc, &i_argc, ppsz_argv, VLC_TRUE ) )
264
    {
265
        vlc_object_detach( p_help_module );
266 267
        config_Free( p_help_module );
        vlc_object_destroy( p_help_module );
268
        //module_EndBank( p_vlc );
269 270 271
        return VLC_EGENERIC;
    }

272 273
    b_exit = VLC_FALSE;

274 275 276
    /* Check for short help option */
    if( config_GetInt( p_vlc, "help" ) )
    {
277
        fprintf( stderr, _("Usage: %s [options] [items]...\n\n"),
278
                         p_vlc->psz_object_name );
279
        Usage( p_vlc, "main" );
280 281
        Usage( p_vlc, "help" );
        b_exit = VLC_TRUE;
282 283
    }
    /* Check for version option */
284
    else if( config_GetInt( p_vlc, "version" ) )
285 286
    {
        Version();
287 288 289 290 291 292 293 294 295
        b_exit = VLC_TRUE;
    }

    /* Hack: remove the help module here */
    vlc_object_detach( p_help_module );
    /* End hack */

    if( b_exit )
    {
296 297
        config_Free( p_help_module );
        vlc_object_destroy( p_help_module );
298
        //module_EndBank( p_vlc );
299 300 301 302 303 304 305 306 307
        return VLC_EEXIT;
    }

    /*
     * Load the builtins and plugins into the module_bank.
     * We have to do it before config_Load*() because this also gets the
     * list of configuration options exported by each module and loads their
     * default values.
     */
308 309
    module_LoadBuiltins( &libvlc );
    module_LoadPlugins( &libvlc );
310
    msg_Dbg( p_vlc, "module bank initialized, found %i modules",
311
                    libvlc.p_module_bank->i_children );
312 313

    /* Hack: insert the help module here */
314
    vlc_object_attach( p_help_module, libvlc.p_module_bank );
315 316 317 318 319
    /* End hack */

    /* Check for help on modules */
    if( (p_tmp = config_GetPsz( p_vlc, "module" )) )
    {
320
        Usage( p_vlc, p_tmp );
321
        free( p_tmp );
322
        b_exit = VLC_TRUE;
323 324
    }
    /* Check for long help option */
325
    else if( config_GetInt( p_vlc, "longhelp" ) )
326
    {
327
        Usage( p_vlc, NULL );
328
        b_exit = VLC_TRUE;
329 330
    }
    /* Check for module list option */
331
    else if( config_GetInt( p_vlc, "list" ) )
332
    {
333
        ListModules( p_vlc );
334
        b_exit = VLC_TRUE;
335 336 337
    }

    /* Hack: remove the help module here */
338
    vlc_object_detach( p_help_module );
339 340 341 342
    config_Free( p_help_module );
    vlc_object_destroy( p_help_module );
    /* End hack */

343 344
    if( b_exit )
    {
345
        //module_EndBank( p_vlc );
346 347 348
        return VLC_EEXIT;
    }

349 350 351 352
    /*
     * Override default configuration with config file settings
     */
    p_vlc->psz_homedir = config_GetHomeDir();
353
    config_LoadConfigFile( p_vlc, NULL );
354 355 356 357

    /*
     * Override configuration with command line settings
     */
Sam Hocevar's avatar
Sam Hocevar committed
358
    if( config_LoadCmdLine( p_vlc, &i_argc, ppsz_argv, VLC_FALSE ) )
359 360 361 362 363 364 365 366
    {
#ifdef WIN32
        ShowConsole();
        /* Pause the console because it's destroyed when we exit */
        fprintf( stderr, "The command line options couldn't be loaded, check "
                 "that they are valid.\nPress the RETURN key to continue..." );
        getchar();
#endif
367
        //module_EndBank( p_vlc );
368 369 370 371 372 373
        return VLC_EGENERIC;
    }

    /*
     * System specific configuration
     */
374
    system_Configure( p_vlc );
375

376 377 378 379 380
    /*
     * Message queue options
     */
    if( config_GetInt( p_vlc, "quiet" ) )
    {
381
        libvlc.i_verbose = -1;
382 383 384 385
    }
    else
    {
        int i_tmp = config_GetInt( p_vlc, "verbose" );
386
        if( i_tmp >= 0 )
387
        {
388
            libvlc.i_verbose = __MIN( i_tmp, 2 );
389 390 391 392
        }
    }
    libvlc.b_color = libvlc.b_color || config_GetInt( p_vlc, "color" );

393 394 395 396 397 398 399
    /*
     * Output messages that may still be in the queue
     */
    msg_Flush( p_vlc );

    /* p_vlc inititalization. FIXME ? */
    p_vlc->i_desync = config_GetInt( p_vlc, "desync" ) * (mtime_t)1000;
400

401
#if defined( __i386__ )
402
    if( !config_GetInt( p_vlc, "mmx" ) )
403
        libvlc.i_cpu &= ~CPU_CAPABILITY_MMX;
404
    if( !config_GetInt( p_vlc, "3dn" ) )
405
        libvlc.i_cpu &= ~CPU_CAPABILITY_3DNOW;
406
    if( !config_GetInt( p_vlc, "mmxext" ) )
407
        libvlc.i_cpu &= ~CPU_CAPABILITY_MMXEXT;
408
    if( !config_GetInt( p_vlc, "sse" ) )
409
        libvlc.i_cpu &= ~CPU_CAPABILITY_SSE;
410 411
#endif
#if defined( __powerpc__ ) || defined( SYS_DARWIN )
412
    if( !config_GetInt( p_vlc, "altivec" ) )
413
        libvlc.i_cpu &= ~CPU_CAPABILITY_ALTIVEC;
414
#endif
415 416

#define PRINT_CAPABILITY( capability, string )                              \
417
    if( libvlc.i_cpu & capability )                                         \
418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438
    {                                                                       \
        strncat( p_capabilities, string " ",                                \
                 sizeof(p_capabilities) - strlen(p_capabilities) );         \
        p_capabilities[sizeof(p_capabilities) - 1] = '\0';                  \
    }

    p_capabilities[0] = '\0';
    PRINT_CAPABILITY( CPU_CAPABILITY_486, "486" );
    PRINT_CAPABILITY( CPU_CAPABILITY_586, "586" );
    PRINT_CAPABILITY( CPU_CAPABILITY_PPRO, "Pentium Pro" );
    PRINT_CAPABILITY( CPU_CAPABILITY_MMX, "MMX" );
    PRINT_CAPABILITY( CPU_CAPABILITY_3DNOW, "3DNow!" );
    PRINT_CAPABILITY( CPU_CAPABILITY_MMXEXT, "MMXEXT" );
    PRINT_CAPABILITY( CPU_CAPABILITY_SSE, "SSE" );
    PRINT_CAPABILITY( CPU_CAPABILITY_ALTIVEC, "AltiVec" );
    PRINT_CAPABILITY( CPU_CAPABILITY_FPU, "FPU" );
    msg_Dbg( p_vlc, "CPU has capabilities %s", p_capabilities );

    /*
     * Choose the best memcpy module
     */
439
    p_vlc->p_memcpy_module = module_Need( p_vlc, "memcpy", "$memcpy" );
440

441
    if( p_vlc->pf_memcpy == NULL )
442 443 444
    {
        p_vlc->pf_memcpy = memcpy;
    }
445 446 447 448 449

    if( p_vlc->pf_memset == NULL )
    {
        p_vlc->pf_memset = memset;
    }
450 451 452 453 454

    /*
     * Initialize shared resources and libraries
     */
    if( config_GetInt( p_vlc, "network-channel" )
455
         && network_ChannelCreate( p_vlc ) )
456 457
    {
        /* On error during Channels initialization, switch off channels */
458 459
        msg_Warn( p_vlc,
                  "channels initialization failed, deactivating channels" );
Sam Hocevar's avatar
Sam Hocevar committed
460
        config_PutInt( p_vlc, "network-channel", VLC_FALSE );
461 462 463 464 465
    }

    /*
     * Initialize playlist and get commandline files
     */
466
    p_playlist = playlist_Create( p_vlc );
467 468 469
    if( !p_playlist )
    {
        msg_Err( p_vlc, "playlist initialization failed" );
470 471
        if( p_vlc->p_memcpy_module != NULL )
        {
472
            module_Unneed( p_vlc, p_vlc->p_memcpy_module );
473
        }
474
        //module_EndBank( p_vlc );
475 476 477 478 479 480 481 482 483 484 485 486
        return VLC_EGENERIC;
    }

    /*
     * Get input filenames given as commandline arguments
     */
    GetFilenames( p_vlc, i_argc, ppsz_argv );

    return VLC_SUCCESS;
}

/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
487
 * VLC_AddIntf: add an interface
488 489
 *****************************************************************************
 * This function opens an interface plugin and runs it. If b_block is set
Sam Hocevar's avatar
Sam Hocevar committed
490 491
 * to 0, VLC_AddIntf will return immediately and let the interface run in a
 * separate thread. If b_block is set to 1, VLC_AddIntf will continue until
492 493
 * user requests to quit.
 *****************************************************************************/
494
int VLC_AddIntf( int i_object, char const *psz_module, vlc_bool_t b_block )
495
{
Sam Hocevar's avatar
Sam Hocevar committed
496
    int i_err;
497
    intf_thread_t *p_intf;
Sam Hocevar's avatar
Sam Hocevar committed
498
    vlc_t *p_vlc;
499 500
    char *psz_oldmodule = NULL;

Sam Hocevar's avatar
Sam Hocevar committed
501 502
    p_vlc = i_object ? vlc_object_get( &libvlc, i_object ) : p_static_vlc;

503
    if( !p_vlc )
504
    {
505
        return VLC_ENOOBJ;
506 507 508 509 510 511 512 513 514
    }

    if( psz_module )
    {
        psz_oldmodule = config_GetPsz( p_vlc, "intf" );
        config_PutPsz( p_vlc, "intf", psz_module );
    }

    /* Try to create the interface */
515
    p_intf = intf_Create( p_vlc );
516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533

    if( psz_module )
    {
        config_PutPsz( p_vlc, "intf", psz_oldmodule );
        if( psz_oldmodule )
        {
            free( psz_oldmodule );
        }
    }

    if( p_intf == NULL )
    {
        msg_Err( p_vlc, "interface initialization failed" );
        return VLC_EGENERIC;
    }

    /* Try to run the interface */
    p_intf->b_block = b_block;
Sam Hocevar's avatar
Sam Hocevar committed
534 535
    i_err = intf_RunThread( p_intf );
    if( i_err )
536
    {
537
        vlc_object_detach( p_intf );
538
        intf_Destroy( p_intf );
Sam Hocevar's avatar
Sam Hocevar committed
539
        return i_err;
540 541 542 543 544 545
    }

    return VLC_SUCCESS;
}

/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
546
 * VLC_Destroy: stop playing and destroy everything.
547
 *****************************************************************************
548
 * This function requests the running threads to finish, waits for their
549 550
 * termination, and destroys their structure.
 *****************************************************************************/
Sam Hocevar's avatar
Sam Hocevar committed
551
int VLC_Destroy( int i_object )
552
{
Sam Hocevar's avatar
Sam Hocevar committed
553 554 555
    vlc_t *p_vlc;

    p_vlc = i_object ? vlc_object_get( &libvlc, i_object ) : p_static_vlc;
556

557
    if( !p_vlc )
558
    {
559
        return VLC_ENOOBJ;
560 561
    }

562 563 564 565
    /*
     * Go back into channel 0 which is the network
     */
    if( config_GetInt( p_vlc, "network-channel" ) && p_vlc->p_channel )
566
    {
567 568
        network_ChannelJoin( p_vlc, COMMON_CHANNEL );
    }
569
    
570 571 572 573 574 575 576
    /*
     * Free allocated memory
     */
    if( p_vlc->p_memcpy_module )
    {
        module_Unneed( p_vlc, p_vlc->p_memcpy_module );
        p_vlc->p_memcpy_module = NULL;
577 578
    }

579 580 581 582 583
    if( p_vlc->psz_homedir )
    {
        free( p_vlc->psz_homedir );
        p_vlc->psz_homedir = NULL;
    }
584

585 586 587 588 589 590 591 592 593 594
    /*
     * XXX: Free module bank !
     */
    //module_EndBank( p_vlc );
    
    /*
     * System specific cleaning code
     */
    system_End( p_vlc );
    
595 596 597
    /* Destroy mutexes */
    vlc_mutex_destroy( &p_vlc->config_lock );

598 599
    vlc_object_detach( p_vlc );

600 601
    vlc_object_destroy( p_vlc );

602 603 604
    /* Stop thread system: last one out please shut the door! */
    vlc_threads_end( &libvlc );

605 606 607
    return VLC_SUCCESS;
}

608
/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
609
 * VLC_Die: ask vlc to die.
610 611
 *****************************************************************************
 * This function sets p_vlc->b_die to VLC_TRUE, but does not do any other
Sam Hocevar's avatar
Sam Hocevar committed
612
 * task. It is your duty to call vlc_end and VLC_Destroy afterwards.
613
 *****************************************************************************/
Sam Hocevar's avatar
Sam Hocevar committed
614
int VLC_Die( int i_object )
615
{
Sam Hocevar's avatar
Sam Hocevar committed
616 617 618
    vlc_t *p_vlc;

    p_vlc = i_object ? vlc_object_get( &libvlc, i_object ) : p_static_vlc;
619 620 621

    if( !p_vlc )
    {
622
        return VLC_ENOOBJ;
623 624 625 626 627 628 629 630
    }

    p_vlc->b_die = VLC_TRUE;

    return VLC_SUCCESS;
}

/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
631
 * VLC_AddTarget: adds a target for playing.
632 633 634 635
 *****************************************************************************
 * This function adds psz_target to the current playlist. If a playlist does
 * not exist, it will create one.
 *****************************************************************************/
636
int VLC_AddTarget( int i_object, char const *psz_target, int i_mode, int i_pos )
637
{
Sam Hocevar's avatar
Sam Hocevar committed
638
    int i_err;
Sam Hocevar's avatar
Sam Hocevar committed
639
    playlist_t *p_playlist;
Sam Hocevar's avatar
Sam Hocevar committed
640 641 642
    vlc_t *p_vlc;

    p_vlc = i_object ? vlc_object_get( &libvlc, i_object ) : p_static_vlc;
Sam Hocevar's avatar
Sam Hocevar committed
643

644
    if( !p_vlc )
645
    {
646
        return VLC_ENOOBJ;
647 648
    }

Sam Hocevar's avatar
Sam Hocevar committed
649 650 651 652 653 654 655 656 657 658 659 660 661 662 663
    p_playlist = vlc_object_find( p_vlc, VLC_OBJECT_PLAYLIST, FIND_ANYWHERE );

    if( p_playlist == NULL )
    {
        msg_Dbg( p_vlc, "no playlist present, creating one" );
        p_playlist = playlist_Create( p_vlc );

        if( p_playlist == NULL )
        {
            return VLC_EGENERIC;
        }

        vlc_object_yield( p_playlist );
    }

Sam Hocevar's avatar
Sam Hocevar committed
664
    i_err = playlist_Add( p_playlist, psz_target, i_mode, i_pos );
Sam Hocevar's avatar
Sam Hocevar committed
665 666

    vlc_object_release( p_playlist );
667

Sam Hocevar's avatar
Sam Hocevar committed
668
    return i_err;
669 670
}

671
/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
672
 * VLC_Set: set a vlc variable
673 674 675
 *****************************************************************************
 *
 *****************************************************************************/
676
int VLC_Set( int i_object, char const *psz_var, vlc_value_t value )
677
{
Sam Hocevar's avatar
Sam Hocevar committed
678
    vlc_t *p_vlc;
679

Sam Hocevar's avatar
Sam Hocevar committed
680
    p_vlc = i_object ? vlc_object_get( &libvlc, i_object ) : p_static_vlc;
681 682 683

    if( !p_vlc )
    {
684
        return VLC_ENOOBJ;
685 686
    }

Sam Hocevar's avatar
Sam Hocevar committed
687 688 689
    /* FIXME: Temporary hack for Mozilla, if variable starts with conf:: then
     * we handle it as a configuration variable. Don't tell Gildas :) -- sam */
    if( !strncmp( psz_var, "conf::", 6 ) )
690
    {
Sam Hocevar's avatar
Sam Hocevar committed
691
        module_config_t *p_item;
692
        char const *psz_newvar = psz_var + 6;
693

Sam Hocevar's avatar
Sam Hocevar committed
694
        p_item = config_FindConfig( VLC_OBJECT(p_vlc), psz_newvar );
695

Sam Hocevar's avatar
Sam Hocevar committed
696
        if( p_item )
697
        {
Sam Hocevar's avatar
Sam Hocevar committed
698
            switch( p_item->i_type )
699
            {
Sam Hocevar's avatar
Sam Hocevar committed
700 701 702 703 704 705 706 707 708 709 710 711
                case CONFIG_ITEM_BOOL:
                    config_PutInt( p_vlc, psz_newvar, value.b_bool );
                    break;
                case CONFIG_ITEM_INTEGER:
                    config_PutInt( p_vlc, psz_newvar, value.i_int );
                    break;
                case CONFIG_ITEM_FLOAT:
                    config_PutFloat( p_vlc, psz_newvar, value.f_float );
                    break;
                default:
                    config_PutPsz( p_vlc, psz_newvar, value.psz_string );
                    break;
712
            }
Sam Hocevar's avatar
Sam Hocevar committed
713
            return VLC_SUCCESS;
714 715 716
        }
    }

Sam Hocevar's avatar
Sam Hocevar committed
717 718 719 720 721 722 723 724
    return var_Set( p_vlc, psz_var, value );
}

/*****************************************************************************
 * VLC_Get: get a vlc variable
 *****************************************************************************
 *
 *****************************************************************************/
725
int VLC_Get( int i_object, char const *psz_var, vlc_value_t *p_value )
Sam Hocevar's avatar
Sam Hocevar committed
726 727 728 729 730 731
{
    vlc_t *p_vlc;

    p_vlc = i_object ? vlc_object_get( &libvlc, i_object ) : p_static_vlc;

    if( !p_vlc )
732
    {
733
        return VLC_ENOOBJ;
734 735
    }

Sam Hocevar's avatar
Sam Hocevar committed
736
    return var_Get( p_vlc, psz_var, p_value );
737 738
}

Sam Hocevar's avatar
Sam Hocevar committed
739
/* FIXME: temporary hacks */
740 741

/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
742
 * VLC_Play: play
743
 *****************************************************************************/
Sam Hocevar's avatar
Sam Hocevar committed
744
int VLC_Play( int i_object )
745 746
{
    playlist_t * p_playlist;
Sam Hocevar's avatar
Sam Hocevar committed
747 748 749
    vlc_t *p_vlc;

    p_vlc = i_object ? vlc_object_get( &libvlc, i_object ) : p_static_vlc;
750 751

    /* Check that the handle is valid */
752
    if( !p_vlc )
753
    {
754
        return VLC_ENOOBJ;
755 756 757 758 759 760
    }

    p_playlist = vlc_object_find( p_vlc, VLC_OBJECT_PLAYLIST, FIND_CHILD );

    if( !p_playlist )
    {
761
        return VLC_ENOOBJ;
762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780
    }

    vlc_mutex_lock( &p_playlist->object_lock );
    if( p_playlist->i_size )
    {
        vlc_mutex_unlock( &p_playlist->object_lock );
        playlist_Play( p_playlist );
    }
    else
    {
        vlc_mutex_unlock( &p_playlist->object_lock );
    }

    vlc_object_release( p_playlist );

    return VLC_SUCCESS;
}

/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
781
 * VLC_Stop: stop
782
 *****************************************************************************/
Sam Hocevar's avatar
Sam Hocevar committed
783
int VLC_Stop( int i_object )
784 785 786 787 788
{
    intf_thread_t *   p_intf;
    playlist_t    *   p_playlist;
    vout_thread_t *   p_vout;
    aout_instance_t * p_aout;
Sam Hocevar's avatar
Sam Hocevar committed
789 790 791
    vlc_t *p_vlc;

    p_vlc = i_object ? vlc_object_get( &libvlc, i_object ) : p_static_vlc;
792 793

    /* Check that the handle is valid */
794
    if( !p_vlc )
795
    {
796
        return VLC_ENOOBJ;
797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848
    }

    /*
     * Ask the interfaces to stop and destroy them
     */
    msg_Dbg( p_vlc, "removing all interfaces" );
    while( (p_intf = vlc_object_find( p_vlc, VLC_OBJECT_INTF, FIND_CHILD )) )
    {
        intf_StopThread( p_intf );
        vlc_object_detach( p_intf );
        vlc_object_release( p_intf );
        intf_Destroy( p_intf );
    }

    /*
     * Free playlists
     */
    msg_Dbg( p_vlc, "removing all playlists" );
    while( (p_playlist = vlc_object_find( p_vlc, VLC_OBJECT_PLAYLIST,
                                          FIND_CHILD )) )
    {
        vlc_object_detach( p_playlist );
        vlc_object_release( p_playlist );
        playlist_Destroy( p_playlist );
    }

    /*
     * Free video outputs
     */
    msg_Dbg( p_vlc, "removing all video outputs" );
    while( (p_vout = vlc_object_find( p_vlc, VLC_OBJECT_VOUT, FIND_CHILD )) )
    {
        vlc_object_detach( p_vout );
        vlc_object_release( p_vout );
        vout_DestroyThread( p_vout );
    }

    /*
     * Free audio outputs
     */
    msg_Dbg( p_vlc, "removing all audio outputs" );
    while( (p_aout = vlc_object_find( p_vlc, VLC_OBJECT_AOUT, FIND_CHILD )) )
    {
        vlc_object_detach( (vlc_object_t *)p_aout );
        vlc_object_release( (vlc_object_t *)p_aout );
        aout_Delete( p_aout );
    }

    return VLC_SUCCESS;
}

/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
849
 * VLC_Pause: toggle pause
850
 *****************************************************************************/
Sam Hocevar's avatar
Sam Hocevar committed
851
int VLC_Pause( int i_object )
852 853
{
    input_thread_t *p_input;
Sam Hocevar's avatar
Sam Hocevar committed
854 855 856 857 858 859
    vlc_t *p_vlc;

    p_vlc = i_object ? vlc_object_get( &libvlc, i_object ) : p_static_vlc;

    if( !p_vlc )
    {
860
        return VLC_ENOOBJ;
Sam Hocevar's avatar
Sam Hocevar committed
861
    }
862 863 864 865 866

    p_input = vlc_object_find( p_vlc, VLC_OBJECT_INPUT, FIND_CHILD );

    if( !p_input )
    {
867
        return VLC_ENOOBJ;
868 869 870 871 872 873 874 875 876
    }

    input_SetStatus( p_input, INPUT_STATUS_PAUSE );
    vlc_object_release( p_input );

    return VLC_SUCCESS;
}

/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
877
 * VLC_FullScreen: toggle fullscreen mode
878
 *****************************************************************************/
Sam Hocevar's avatar
Sam Hocevar committed
879
int VLC_FullScreen( int i_object )
880 881
{
    vout_thread_t *p_vout;
Sam Hocevar's avatar
Sam Hocevar committed
882 883 884 885 886 887
    vlc_t *p_vlc;

    p_vlc = i_object ? vlc_object_get( &libvlc, i_object ) : p_static_vlc;

    if( !p_vlc )
    {
888
        return VLC_ENOOBJ;
Sam Hocevar's avatar
Sam Hocevar committed
889
    }
890 891 892 893 894

    p_vout = vlc_object_find( p_vlc, VLC_OBJECT_VOUT, FIND_CHILD );

    if( !p_vout )
    {
895
        return VLC_ENOOBJ;
896 897 898 899 900 901 902 903
    }

    p_vout->i_changes |= VOUT_FULLSCREEN_CHANGE;
    vlc_object_release( p_vout );

    return VLC_SUCCESS;
}

904 905
/* following functions are local */

Sam Hocevar's avatar
Sam Hocevar committed
906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934
/*****************************************************************************
 * SetLanguage: set the interface language.
 *****************************************************************************
 * We set the LC_MESSAGES locale category for interface messages and buttons,
 * as well as the LC_CTYPE category for string sorting and possible wide
 * character support.
 *****************************************************************************/
static void SetLanguage ( char const *psz_lang )
{
#if defined( ENABLE_NLS ) && defined ( HAVE_GETTEXT )
#   if defined( HAVE_LOCALE_H ) && defined( HAVE_LC_MESSAGES )
    if( !setlocale( LC_MESSAGES, psz_lang ) )
    {
        fprintf( stderr, "warning: unsupported locale settings\n" );
    }

    setlocale( LC_CTYPE, psz_lang );
#   endif

    if( !bindtextdomain( PACKAGE, LOCALEDIR ) )
    {
        fprintf( stderr, "warning: no domain %s in directory %s\n",
                 PACKAGE, LOCALEDIR );
    }

    textdomain( PACKAGE );
#endif
}

935 936 937 938 939 940 941 942 943 944 945 946
/*****************************************************************************
 * GetFilenames: parse command line options which are not flags
 *****************************************************************************
 * Parse command line for input files.
 *****************************************************************************/
static int GetFilenames( vlc_t *p_vlc, int i_argc, char *ppsz_argv[] )
{
    int i_opt;

    /* We assume that the remaining parameters are filenames */
    for( i_opt = optind; i_opt < i_argc; i_opt++ )
    {
Sam Hocevar's avatar
Sam Hocevar committed
947 948 949
        /* TODO: write an internal function of this one, to avoid
         *       unnecessary lookups. */
        VLC_AddTarget( p_vlc->i_object_id, ppsz_argv[ i_opt ],
950
                          PLAYLIST_APPEND | PLAYLIST_GO, PLAYLIST_END );
951 952 953 954 955 956 957 958 959 960
    }

    return VLC_SUCCESS;
}

/*****************************************************************************
 * Usage: print program usage
 *****************************************************************************
 * Print a short inline help. Message interface is initialized at this stage.
 *****************************************************************************/
961
static void Usage( vlc_t *p_this, char const *psz_module_name )
962
{
Sam Hocevar's avatar
Sam Hocevar committed
963 964 965 966 967 968 969 970
#define FORMAT_STRING "      --%s%s%s%s%s%s%s %s%s\n"
    /* option name -------------'     | | | |  | |
     * <bra --------------------------' | | |  | |
     * option type or "" ---------------' | |  | |
     * ket> ------------------------------' |  | |
     * padding spaces ----------------------'  | |
     * comment --------------------------------' |
     * comment suffix ---------------------------'
971 972 973 974 975
     *
     * The purpose of having bra and ket is that we might i18n them as well.
     */
#define LINE_START 8
#define PADDING_SPACES 25
976 977
    vlc_list_t *p_list;
    module_t **pp_parser;
978 979 980 981 982 983 984 985 986 987 988 989 990
    module_config_t *p_item;
    char psz_spaces[PADDING_SPACES+LINE_START+1];
    char psz_format[sizeof(FORMAT_STRING)];

    memset( psz_spaces, ' ', PADDING_SPACES+LINE_START );
    psz_spaces[PADDING_SPACES+LINE_START] = '\0';

    strcpy( psz_format, FORMAT_STRING );

#ifdef WIN32
    ShowConsole();
#endif

991 992 993
    /* List all modules */
    p_list = vlc_list_find( p_this, VLC_OBJECT_MODULE, FIND_ANYWHERE );

994
    /* Enumerate the config for each module */
995 996 997
    for( pp_parser = (module_t **)p_list->pp_objects ;
         *pp_parser ;
         pp_parser++ )
998
    {
999
        vlc_bool_t b_help_module;
1000 1001

        if( psz_module_name && strcmp( psz_module_name,
1002
                                       (*pp_parser)->psz_object_name ) )
Sam Hocevar's avatar
Sam Hocevar committed
1003
        {
1004
            continue;
Sam Hocevar's avatar
Sam Hocevar committed
1005
        }
1006 1007

        /* Ignore modules without config options */
1008
        if( !(*pp_parser)->i_config_items )
Sam Hocevar's avatar
Sam Hocevar committed
1009 1010 1011
        {
            continue;
        }
1012

1013
        b_help_module = !strcmp( "help", (*pp_parser)->psz_object_name );
1014

1015
        /* Print module options */
1016
        for( p_item = (*pp_parser)->p_config;
Gildas Bazin's avatar
 
Gildas Bazin committed
1017
             p_item->i_type != CONFIG_HINT_END;
1018 1019 1020
             p_item++ )
        {
            char *psz_bra = NULL, *psz_type = NULL, *psz_ket = NULL;
Sam Hocevar's avatar
Sam Hocevar committed
1021
            char *psz_suf = "", *psz_prefix = NULL;
1022 1023 1024 1025
            int i;

            switch( p_item->i_type )
            {
Gildas Bazin's avatar
 
Gildas Bazin committed
1026 1027
            case CONFIG_HINT_CATEGORY:
            case CONFIG_HINT_USAGE:
1028 1029 1030
                fprintf( stderr, " %s\n", p_item->psz_text );
                break;

Gildas Bazin's avatar
 
Gildas Bazin committed
1031 1032 1033
            case CONFIG_ITEM_STRING:
            case CONFIG_ITEM_FILE:
            case CONFIG_ITEM_MODULE: /* We could also have "=<" here */
1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052
                if( !p_item->ppsz_list )
                {
                    psz_bra = " <"; psz_type = _("string"); psz_ket = ">";
                    break;
                }
                else
                {
                    psz_bra = " [";
                    psz_type = malloc( 1000 );
                    memset( psz_type, 0, 1000 );
                    for( i=0; p_item->ppsz_list[i]; i++ )
                    {
                        strcat( psz_type, p_item->ppsz_list[i] );
                        strcat( psz_type, "|" );
                    }
                    psz_type[ strlen( psz_type ) - 1 ] = '\0';
                    psz_ket = "]";
                    break;
                }
Gildas Bazin's avatar
 
Gildas Bazin committed
1053
            case CONFIG_ITEM_INTEGER:
1054 1055
                psz_bra = " <"; psz_type = _("integer"); psz_ket = ">";
                break;
Gildas Bazin's avatar
 
Gildas Bazin committed
1056
            case CONFIG_ITEM_FLOAT:
1057 1058
                psz_bra = " <"; psz_type = _("float"); psz_ket = ">";
                break;
Gildas Bazin's avatar
 
Gildas Bazin committed
1059
            case CONFIG_ITEM_BOOL:
1060 1061 1062 1063 1064 1065 1066 1067 1068
                psz_bra = ""; psz_type = ""; psz_ket = "";
                if( !b_help_module )
                {
                    psz_suf = p_item->i_value ? _(" (default enabled)") :
                                                _(" (default disabled)");
                }
                break;
            }

1069
            /* Add short option if any */
1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087
            if( p_item->i_short )
            {
                psz_format[2] = '-';
                psz_format[3] = p_item->i_short;
                psz_format[4] = ',';
            }
            else
            {
                psz_format[2] = ' ';
                psz_format[3] = ' ';
                psz_format[4] = ' ';
            }

            if( psz_type )
            {
                i = PADDING_SPACES - strlen( p_item->psz_name )
                     - strlen( psz_bra ) - strlen( psz_type )
                     - strlen( psz_ket ) - 1;
Gildas Bazin's avatar
 
Gildas Bazin committed
1088
                if( p_item->i_type == CONFIG_ITEM_BOOL
1089 1090
                     && !b_help_module )
                {
1091 1092 1093 1094
                    /* If option is of type --foo-bar, we print its counterpart
                     * as --no-foo-bar, but if it is of type --foobar (without
                     * dashes in the name) we print it as --nofoobar. Both
                     * values are of course valid, only the display changes. */
Sam Hocevar's avatar
Sam Hocevar committed
1095
                    vlc_bool_t b_dash = VLC_FALSE;
Sam Hocevar's avatar
Sam Hocevar committed
1096 1097 1098 1099 1100
                    psz_prefix = p_item->psz_name;
                    while( *psz_prefix )
                    {
                        if( *psz_prefix++ == '-' )
                        {
Sam Hocevar's avatar
Sam Hocevar committed
1101
                            b_dash = VLC_TRUE;
Sam Hocevar's avatar
Sam Hocevar committed
1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115
                            break;
                        }
                    }

                    if( b_dash )
                    {
                        psz_prefix = ", --no-";
                        i -= strlen( p_item->psz_name ) + strlen( ", --no-" );
                    }
                    else
                    {
                        psz_prefix = ", --no";
                        i -= strlen( p_item->psz_name ) + strlen( ", --no" );
                    }
1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127
                }

                if( i < 0 )
                {
                    i = 0;
                    psz_spaces[i] = '\n';
                }
                else
                {
                    psz_spaces[i] = '\0';
                }

Gildas Bazin's avatar
 
Gildas Bazin committed
1128
                if( p_item->i_type == CONFIG_ITEM_BOOL &&
Sam Hocevar's avatar
Sam Hocevar committed
1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140
                    !b_help_module )
                {
                    fprintf( stderr, psz_format, p_item->psz_name, psz_prefix,
                             p_item->psz_name, psz_bra, psz_type, psz_ket,
                             psz_spaces, p_item->psz_text, psz_suf );
                }
                else
                {
                    fprintf( stderr, psz_format, p_item->psz_name, "", "",
                             psz_bra, psz_type, psz_ket, psz_spaces,
                             p_item->psz_text, psz_suf );
                }
1141
                psz_spaces[i] = ' ';
1142 1143 1144 1145
                if ( p_item->ppsz_list )
                {
                    free( psz_type );
                }
1146 1147 1148 1149
            }
        }
    }

1150 1151 1152
    /* Release the module list */
    vlc_list_release( p_list );

1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164
#ifdef WIN32        /* Pause the console because it's destroyed when we exit */
        fprintf( stderr, _("\nPress the RETURN key to continue...\n") );
        getchar();
#endif
}

/*****************************************************************************
 * ListModules: list the available modules with their description
 *****************************************************************************
 * Print a list of all available modules (builtins and plugins) and a short
 * description for each one.
 *****************************************************************************/
1165
static void ListModules( vlc_t *p_this )
1166
{
1167 1168
    vlc_list_t *p_list;
    module_t **pp_parser;
1169 1170 1171 1172 1173 1174 1175 1176 1177
    char psz_spaces[22];

    memset( psz_spaces, ' ', 22 );

#ifdef WIN32
    ShowConsole();
#endif

    /* Usage */
1178
    fprintf( stderr, _("Usage: %s [options] [items]...\n\n"),
1179 1180 1181 1182
                     p_this->p_vlc->psz_object_name );

    fprintf( stderr, _("[module]              [description]\n") );

1183 1184 1185
    /* List all modules */
    p_list = vlc_list_find( p_this, VLC_OBJECT_MODULE, FIND_ANYWHERE );

1186
    /* Enumerate each module */
1187 1188 1189
    for( pp_parser = (module_t **)p_list->pp_objects ;
         *pp_parser ;
         pp_parser++ )
1190 1191 1192 1193 1194
    {
        int i;

        /* Nasty hack, but right now I'm too tired to think about a nice
         * solution */
1195
        i = 22 - strlen( (*pp_parser)->psz_object_name ) - 1;
1196 1197 1198
        if( i < 0 ) i = 0;
        psz_spaces[i] = 0;

1199 1200
        fprintf( stderr, "  %s%s %s\n", (*pp_parser)->psz_object_name,
                         psz_spaces, (*pp_parser)->psz_longname );
1201 1202 1203 1204

        psz_spaces[i] = ' ';
    }

1205 1206
    vlc_list_release( p_list );

1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251 1252
#ifdef WIN32        /* Pause the console because it's destroyed when we exit */
        fprintf( stderr, _("\nPress the RETURN key to continue...\n") );
        getchar();
#endif
}

/*****************************************************************************
 * Version: print complete program version
 *****************************************************************************
 * Print complete program version and build number.
 *****************************************************************************/
static void Version( void )
{
#ifdef WIN32
    ShowConsole();
#endif

    fprintf( stderr, VERSION_MESSAGE "\n" );
    fprintf( stderr,
      _("This program comes with NO WARRANTY, to the extent permitted by "
        "law.\nYou may redistribute it under the terms of the GNU General "
        "Public License;\nsee the file named COPYING for details.\n"
        "Written by the VideoLAN team at Ecole Centrale, Paris.\n") );

#ifdef WIN32        /* Pause the console because it's destroyed when we exit */
    fprintf( stderr, _("\nPress the RETURN key to continue...\n") );
    getchar();
#endif
}

/*****************************************************************************
 * ShowConsole: On Win32, create an output console for debug messages
 *****************************************************************************
 * This function is useful only on Win32.
 *****************************************************************************/
#ifdef WIN32 /*  */
static void ShowConsole( void )
{
    AllocConsole();
    freopen( "CONOUT$", "w", stdout );
    freopen( "CONOUT$", "w", stderr );
    freopen( "CONIN$", "r", stdin );
    return;
}
#endif