libvlc.c 38.8 KB
Newer Older
1 2 3
/*****************************************************************************
 * libvlc.c: main libvlc source
 *****************************************************************************
4
 * Copyright (C) 1998-2002 VideoLAN
Gildas Bazin's avatar
 
Gildas Bazin committed
5
 * $Id: libvlc.c,v 1.51 2002/12/13 01:56:30 gbazin 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
#define __BUILTIN__

/*****************************************************************************
 * Preamble
 *****************************************************************************/
36 37 38 39 40
#include <vlc/vlc.h>

#ifdef HAVE_ERRNO_H
#   include <errno.h>                                              /* ENOMEM */
#endif
41 42 43 44 45 46 47 48 49 50
#include <stdio.h>                                              /* sprintf() */
#include <string.h>                                            /* strerror() */
#include <stdlib.h>                                                /* free() */

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

#ifdef HAVE_UNISTD_H
#   include <unistd.h>
51
#elif defined( _MSC_VER ) && defined( _WIN32 ) && !defined( UNDER_CE )
52 53 54
#   include <io.h>
#endif

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

59 60 61 62 63
#ifdef HAVE_LOCALE_H
#   include <locale.h>
#endif

#include "vlc_cpu.h"                                        /* CPU detection */
64
#include "os_specific.h"
65

66
#include "error.h"
67 68 69 70 71
#include "netutils.h"                                 /* network_ChannelJoin */

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

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

#include "audio_output.h"

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

#include "libvlc.h"

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

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

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

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

111 112 113 114 115 116 117 118 119 120
/*****************************************************************************
 * 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
121 122 123 124 125 126 127
/*****************************************************************************
 * 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 )
128
{
129
    int i_ret;
130
    vlc_t * p_vlc = NULL;
131
    vlc_value_t lockval;
132

133 134 135
    /* 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
136
    if( i_ret < 0 )
137
    {
Sam Hocevar's avatar
Sam Hocevar committed
138
        return i_ret;
139 140 141
    }

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

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

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

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

163 164 165 166 167 168 169
        /* 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 );

170
        /* Initialize the module bank and load the configuration of the
171 172 173 174 175
         * 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 );
176 177

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

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

    p_vlc->psz_object_name = "root";

    /* Initialize mutexes */
192
    vlc_mutex_init( p_vlc, &p_vlc->config_lock );
193 194

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

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

    return p_vlc->i_object_id;
201 202 203
}

/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
204
 * VLC_Init: initialize a vlc_t structure.
205 206 207 208 209 210 211
 *****************************************************************************
 * 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
212
int VLC_Init( int i_object, int i_argc, char *ppsz_argv[] )
213
{
214 215 216
    char         p_capabilities[200];
    char *       p_tmp;
    vlc_bool_t   b_exit;
Sam Hocevar's avatar
Sam Hocevar committed
217
    vlc_t *      p_vlc;
218 219
    module_t    *p_help_module;
    playlist_t  *p_playlist;
220

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

223
    if( !p_vlc )
224
    {
225
        return VLC_ENOOBJ;
226 227
    }

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

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

    /* 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 )
    {
257
        //module_EndBank( p_vlc );
258 259 260 261
        return VLC_EGENERIC;
    }
    p_help_module->psz_object_name = "help";
    config_Duplicate( p_help_module, p_help_config );
262
    vlc_object_attach( p_help_module, libvlc.p_module_bank );
263 264
    /* End hack */

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

274 275
    b_exit = VLC_FALSE;

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

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

    if( b_exit )
    {
298 299
        config_Free( p_help_module );
        vlc_object_destroy( p_help_module );
300
        //module_EndBank( p_vlc );
301 302 303 304 305 306 307 308 309
        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.
     */
310 311
    module_LoadBuiltins( &libvlc );
    module_LoadPlugins( &libvlc );
312
    msg_Dbg( p_vlc, "module bank initialized, found %i modules",
313
                    libvlc.p_module_bank->i_children );
314 315

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

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

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

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

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

    /*
     * Override configuration with command line settings
     */
Sam Hocevar's avatar
Sam Hocevar committed
360
    if( config_LoadCmdLine( p_vlc, &i_argc, ppsz_argv, VLC_FALSE ) )
361 362 363 364 365 366 367 368
    {
#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
369
        //module_EndBank( p_vlc );
370 371 372 373 374 375
        return VLC_EGENERIC;
    }

    /*
     * System specific configuration
     */
376
    system_Configure( p_vlc );
377

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

395 396 397 398 399 400 401
    /*
     * 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;
402

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

#define PRINT_CAPABILITY( capability, string )                              \
419
    if( libvlc.i_cpu & capability )                                         \
420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440
    {                                                                       \
        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
     */
441
    p_vlc->p_memcpy_module = module_Need( p_vlc, "memcpy", "$memcpy" );
442

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

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

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

    /*
     * Initialize playlist and get commandline files
     */
468
    p_playlist = playlist_Create( p_vlc );
469 470 471
    if( !p_playlist )
    {
        msg_Err( p_vlc, "playlist initialization failed" );
472 473
        if( p_vlc->p_memcpy_module != NULL )
        {
474
            module_Unneed( p_vlc, p_vlc->p_memcpy_module );
475
        }
476
        //module_EndBank( p_vlc );
477 478 479 480 481 482 483 484 485 486 487 488
        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
489
 * VLC_AddIntf: add an interface
490 491
 *****************************************************************************
 * This function opens an interface plugin and runs it. If b_block is set
Sam Hocevar's avatar
Sam Hocevar committed
492 493
 * 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
494 495
 * user requests to quit.
 *****************************************************************************/
496
int VLC_AddIntf( int i_object, char const *psz_module, vlc_bool_t b_block )
497
{
Sam Hocevar's avatar
Sam Hocevar committed
498
    int i_err;
499
    intf_thread_t *p_intf;
Sam Hocevar's avatar
Sam Hocevar committed
500
    vlc_t *p_vlc;
501 502
    char *psz_oldmodule = NULL;

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

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

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

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

    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
536 537
    i_err = intf_RunThread( p_intf );
    if( i_err )
538
    {
539
        vlc_object_detach( p_intf );
540
        intf_Destroy( p_intf );
Sam Hocevar's avatar
Sam Hocevar committed
541
        return i_err;
542 543 544 545 546 547
    }

    return VLC_SUCCESS;
}

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

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

559
    if( !p_vlc )
560
    {
561
        return VLC_ENOOBJ;
562 563
    }

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

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

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

600 601
    vlc_object_detach( p_vlc );

602 603
    vlc_object_destroy( p_vlc );

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

607 608 609
    return VLC_SUCCESS;
}

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

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

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

    p_vlc->b_die = VLC_TRUE;

    return VLC_SUCCESS;
}

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

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

646
    if( !p_vlc )
647
    {
648
        return VLC_ENOOBJ;
649 650
    }

Sam Hocevar's avatar
Sam Hocevar committed
651 652 653 654 655 656 657 658 659 660 661 662 663 664 665
    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
666
    i_err = playlist_Add( p_playlist, psz_target, i_mode, i_pos );
Sam Hocevar's avatar
Sam Hocevar committed
667 668

    vlc_object_release( p_playlist );
669

Sam Hocevar's avatar
Sam Hocevar committed
670
    return i_err;
671 672
}

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

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

    if( !p_vlc )
    {
686
        return VLC_ENOOBJ;
687 688
    }

Sam Hocevar's avatar
Sam Hocevar committed
689 690 691
    /* 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 ) )
692
    {
Sam Hocevar's avatar
Sam Hocevar committed
693
        module_config_t *p_item;
694
        char const *psz_newvar = psz_var + 6;
695

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

Sam Hocevar's avatar
Sam Hocevar committed
698
        if( p_item )
699
        {
Sam Hocevar's avatar
Sam Hocevar committed
700
            switch( p_item->i_type )
701
            {
Sam Hocevar's avatar
Sam Hocevar committed
702 703 704 705 706 707 708 709 710 711 712 713
                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;
714
            }
Sam Hocevar's avatar
Sam Hocevar committed
715
            return VLC_SUCCESS;
716 717 718
        }
    }

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

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

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

    if( !p_vlc )
734
    {
735
        return VLC_ENOOBJ;
736 737
    }

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

Sam Hocevar's avatar
Sam Hocevar committed
741
/* FIXME: temporary hacks */
742 743

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

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

    /* Check that the handle is valid */
754
    if( !p_vlc )
755
    {
756
        return VLC_ENOOBJ;
757
    }
758 759 760 761 762 763 764
    
    /* add pseudo sap interface; non blocking */
    if( config_GetInt( p_vlc, "sap" ) )
    {
        msg_Dbg( p_vlc, "adding sap interface" );
        VLC_AddIntf( 0, "sap", VLC_FALSE );
    }
765

766 767
    vlc_thread_set_priority( p_vlc, VLC_THREAD_PRIORITY_LOW );

768 769 770 771
    p_playlist = vlc_object_find( p_vlc, VLC_OBJECT_PLAYLIST, FIND_CHILD );

    if( !p_playlist )
    {
772
        return VLC_ENOOBJ;
773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791
    }

    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
792
 * VLC_Stop: stop
793
 *****************************************************************************/
Sam Hocevar's avatar
Sam Hocevar committed
794
int VLC_Stop( int i_object )
795 796 797 798 799
{
    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
800 801 802
    vlc_t *p_vlc;

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

    /* Check that the handle is valid */
805
    if( !p_vlc )
806
    {
807
        return VLC_ENOOBJ;
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
    }

    /*
     * 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 );
842
        vout_Destroy( p_vout );
843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859
    }

    /*
     * 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
860
 * VLC_Pause: toggle pause
861
 *****************************************************************************/
Sam Hocevar's avatar
Sam Hocevar committed
862
int VLC_Pause( int i_object )
863 864
{
    input_thread_t *p_input;
Sam Hocevar's avatar
Sam Hocevar committed
865 866 867 868 869 870
    vlc_t *p_vlc;

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

    if( !p_vlc )
    {
871
        return VLC_ENOOBJ;
Sam Hocevar's avatar
Sam Hocevar committed
872
    }
873 874 875 876 877

    p_input = vlc_object_find( p_vlc, VLC_OBJECT_INPUT, FIND_CHILD );

    if( !p_input )
    {
878
        return VLC_ENOOBJ;
879 880 881 882 883 884 885 886 887
    }

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

    return VLC_SUCCESS;
}

/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
888
 * VLC_FullScreen: toggle fullscreen mode
889
 *****************************************************************************/
Sam Hocevar's avatar
Sam Hocevar committed
890
int VLC_FullScreen( int i_object )
891 892
{
    vout_thread_t *p_vout;
Sam Hocevar's avatar
Sam Hocevar committed
893 894 895 896 897 898
    vlc_t *p_vlc;

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

    if( !p_vlc )
    {
899
        return VLC_ENOOBJ;
Sam Hocevar's avatar
Sam Hocevar committed
900
    }
901 902 903 904 905

    p_vout = vlc_object_find( p_vlc, VLC_OBJECT_VOUT, FIND_CHILD );

    if( !p_vout )
    {
906
        return VLC_ENOOBJ;
907 908 909 910 911 912 913 914
    }

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

    return VLC_SUCCESS;
}

915 916
/* following functions are local */

Sam Hocevar's avatar
Sam Hocevar committed
917 918 919 920 921 922 923 924 925
/*****************************************************************************
 * 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 )
{
926 927 928 929 930
#if defined( ENABLE_NLS ) \
     && ( defined( HAVE_GETTEXT ) || defined( HAVE_INCLUDED_GETTEXT ) )

#   if defined( HAVE_INCLUDED_GETTEXT ) && !defined( HAVE_LC_MESSAGES )
    if( *psz_lang )
Sam Hocevar's avatar
Sam Hocevar committed
931
    {
932 933 934 935 936 937 938 939
        /* We set LC_ALL manually because it is the only way to set
         * the language at runtime under eg. Windows. Beware that this
         * makes the environment unconsistent when libvlc is unloaded and
         * should probably be moved to a safer place like vlc.c. */
        static char psz_lcall[20];
        snprintf( psz_lcall, 19, "LC_ALL=%s", psz_lang );
        psz_lcall[19] = '\0';
        putenv( psz_lcall );
Sam Hocevar's avatar
Sam Hocevar committed
940
    }
941
#   endif
Sam Hocevar's avatar
Sam Hocevar committed
942

943 944
#   if defined( HAVE_LC_MESSAGES )
    setlocale( LC_MESSAGES, psz_lang );
Sam Hocevar's avatar
Sam Hocevar committed
945
#   endif
946
    setlocale( LC_CTYPE, psz_lang );
Sam Hocevar's avatar
Sam Hocevar committed
947

948
    /* Specify where to find the locales for current domain */
Sam Hocevar's avatar
Sam Hocevar committed
949 950 951 952 953 954
    if( !bindtextdomain( PACKAGE, LOCALEDIR ) )
    {
        fprintf( stderr, "warning: no domain %s in directory %s\n",
                 PACKAGE, LOCALEDIR );
    }

955
    /* Set the default domain */
Sam Hocevar's avatar
Sam Hocevar committed
956 957 958 959
    textdomain( PACKAGE );
#endif
}

960 961 962 963 964 965 966 967 968 969
/*****************************************************************************
 * 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 */
970
    for( i_opt = i_argc - 1; i_opt > optind; i_opt-- )
971
    {
Sam Hocevar's avatar
Sam Hocevar committed
972 973 974
        /* TODO: write an internal function of this one, to avoid
         *       unnecessary lookups. */
        VLC_AddTarget( p_vlc->i_object_id, ppsz_argv[ i_opt ],
975 976 977 978 979 980 981 982
                       PLAYLIST_INSERT, 0 );
    }

    /* If there is at least one target, play it */
    if( i_argc > optind )
    {
        VLC_AddTarget( p_vlc->i_object_id, ppsz_argv[ optind ],
                       PLAYLIST_INSERT | PLAYLIST_GO, 0 );
983 984 985 986 987 988 989 990 991 992
    }

    return VLC_SUCCESS;
}

/*****************************************************************************
 * Usage: print program usage
 *****************************************************************************
 * Print a short inline help. Message interface is initialized at this stage.
 *****************************************************************************/
993
static void Usage( vlc_t *p_this, char const *psz_module_name )
994
{
Sam Hocevar's avatar
Sam Hocevar committed
995 996 997 998 999 1000 1001 1002
#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 ---------------------------'
1003 1004 1005 1006 1007
     *
     * The purpose of having bra and ket is that we might i18n them as well.
     */
#define LINE_START 8
#define PADDING_SPACES 25
Gildas Bazin's avatar
 
Gildas Bazin committed
1008 1009
    vlc_list_t list;
    module_t *p_parser;
1010 1011 1012
    module_config_t *p_item;
    char psz_spaces[PADDING_SPACES+LINE_START+1];
    char psz_format[sizeof(FORMAT_STRING)];
Gildas Bazin's avatar
 
Gildas Bazin committed
1013
    int i_index;
1014 1015 1016 1017 1018 1019 1020 1021 1022 1023

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

    strcpy( psz_format, FORMAT_STRING );

#ifdef WIN32
    ShowConsole();
#endif

1024
    /* List all modules */
Gildas Bazin's avatar
 
Gildas Bazin committed
1025
    list = vlc_list_find( p_this, VLC_OBJECT_MODULE, FIND_ANYWHERE );
1026

1027
    /* Enumerate the config for each module */
Gildas Bazin's avatar
 
Gildas Bazin committed
1028
    for( i_index = 0; i_index < list.i_count; i_index++ )
1029
    {
1030
        vlc_bool_t b_help_module;
1031

Gildas Bazin's avatar
 
Gildas Bazin committed
1032 1033
        p_parser = (module_t *)list.p_values[i_index].p_object ;

1034
        if( psz_module_name && strcmp( psz_module_name,
Gildas Bazin's avatar
 
Gildas Bazin committed
1035
                                       p_parser->psz_object_name ) )
Sam Hocevar's avatar
Sam Hocevar committed
1036
        {
1037
            continue;
Sam Hocevar's avatar
Sam Hocevar committed
1038
        }
1039 1040

        /* Ignore modules without config options */
Gildas Bazin's avatar
 
Gildas Bazin committed
1041
        if( !p_parser->i_config_items )
Sam Hocevar's avatar
Sam Hocevar committed
1042 1043 1044
        {
            continue;
        }
1045

Gildas Bazin's avatar
 
Gildas Bazin committed
1046
        b_help_module = !strcmp( "help", p_parser->psz_object_name );
1047

1048
        /* Print module options */
Gildas Bazin's avatar
 
Gildas Bazin committed
1049
        for( p_item = p_parser->p_config;
Gildas Bazin's avatar
 
Gildas Bazin committed
1050
             p_item->i_type != CONFIG_HINT_END;
1051 1052 1053
             p_item++ )
        {
            char *psz_bra = NULL, *psz_type = NULL, *psz_ket = NULL;
Sam Hocevar's avatar
Sam Hocevar committed
1054
            char *psz_suf = "", *psz_prefix = NULL;
1055 1056 1057 1058
            int i;

            switch( p_item->i_type )
            {
Gildas Bazin's avatar
 
Gildas Bazin committed
1059 1060
            case CONFIG_HINT_CATEGORY:
            case CONFIG_HINT_USAGE:
1061
                fprintf( stdout, " %s\n", p_item->psz_text );
1062 1063
                break;

Gildas Bazin's avatar
 
Gildas Bazin committed
1064 1065 1066
            case CONFIG_ITEM_STRING:
            case CONFIG_ITEM_FILE:
            case CONFIG_ITEM_MODULE: /* We could also have "=<" here */
1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085
                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
1086
            case CONFIG_ITEM_INTEGER:
1087 1088
                psz_bra = " <"; psz_type = _("integer"); psz_ket = ">";
                break;
Gildas Bazin's avatar
 
Gildas Bazin committed
1089
            case CONFIG_ITEM_FLOAT:
1090 1091
                psz_bra = " <"; psz_type = _("float"); psz_ket = ">";
                break;
Gildas Bazin's avatar
 
Gildas Bazin committed
1092
            case CONFIG_ITEM_BOOL:
1093 1094 1095 1096 1097 1098 1099 1100 1101
                psz_bra = ""; psz_type = ""; psz_ket = "";
                if( !b_help_module )
                {
                    psz_suf = p_item->i_value ? _(" (default enabled)") :
                                                _(" (default disabled)");
                }
                break;
            }

1102
            /* Add short option if any */
1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120
            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
1121
                if( p_item->i_type == CONFIG_ITEM_BOOL
1122 1123
                     && !b_help_module )
                {
1124 1125 1126 1127
                    /* 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
1128
                    vlc_bool_t b_dash = VLC_FALSE;
Sam Hocevar's avatar
Sam Hocevar committed
1129 1130 1131 1132 1133
                    psz_prefix = p_item->psz_name;
                    while( *psz_prefix )
                    {
                        if( *psz_prefix++ == '-' )
                        {
Sam Hocevar's avatar
Sam Hocevar committed
1134
                            b_dash = VLC_TRUE;
Sam Hocevar's avatar
Sam Hocevar committed
1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148
                            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" );
                    }
1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160
                }

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

Gildas Bazin's avatar
 
Gildas Bazin committed
1161
                if( p_item->i_type == CONFIG_ITEM_BOOL &&
Sam Hocevar's avatar
Sam Hocevar committed
1162 1163
                    !b_help_module )
                {
1164
                    fprintf( stdout, psz_format, p_item->psz_name, psz_prefix,
Sam Hocevar's avatar
Sam Hocevar committed
1165 1166 1167 1168 1169
                             p_item->psz_name, psz_bra, psz_type, psz_ket,
                             psz_spaces, p_item->psz_text, psz_suf );
                }
                else
                {
1170
                    fprintf( stdout, psz_format, p_item->psz_name, "", "",
Sam Hocevar's avatar
Sam Hocevar committed
1171 1172 1173
                             psz_bra, psz_type, psz_ket, psz_spaces,
                             p_item->psz_text, psz_suf );
                }
1174
                psz_spaces[i] = ' ';
1175 1176 1177 1178
                if ( p_item->ppsz_list )
                {
                    free( psz_type );
                }
1179 1180 1181 1182
            }
        }
    }

1183
    /* Release the module list */
Gildas Bazin's avatar
 
Gildas Bazin committed
1184
    vlc_list_release( &list );
1185

1186
#ifdef WIN32        /* Pause the console because it's destroyed when we exit */
1187
        fprintf( stdout, _("\nPress the RETURN key to continue...\n") );
1188 1189 1190 1191 1192 1193 1194 1195 1196 1197
        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.
 *****************************************************************************/
1198
static void ListModules( vlc_t *p_this )
1199
{
Gildas Bazin's avatar
 
Gildas Bazin committed
1200 1201
    vlc_list_t list;
    module_t *p_parser;
1202
    char psz_spaces[22];
Gildas Bazin's avatar
 
Gildas Bazin committed
1203
    int i_index;
1204 1205 1206 1207 1208 1209 1210 1211

    memset( psz_spaces, ' ', 22 );

#ifdef WIN32
    ShowConsole();
#endif

    /* Usage */
1212
    fprintf( stdout, _("Usage: %s [options] [items]...\n\n"),
1213 1214
                     p_this->p_vlc->psz_object_name );

1215
    fprintf( stdout, _("[module]              [description]\n") );
1216

1217
    /* List all modules */
Gildas Bazin's avatar
 
Gildas Bazin committed
1218
    list = vlc_list_find( p_this, VLC_OBJECT_MODULE, FIND_ANYWHERE );
1219

1220
    /* Enumerate each module */