libvlc.c 41.1 KB
Newer Older
1 2 3
/*****************************************************************************
 * libvlc.c: main libvlc source
 *****************************************************************************
4
 * Copyright (C) 1998-2002 VideoLAN
5
 * $Id: libvlc.c,v 1.60 2003/01/31 13:52:26 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
#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 171 172 173 174
        /* Set language now, otherwise the main module's strings will not
         * be translated. FIXME: this is a hack, the correct way is to have
         * SetLanguage dynamically retranslate all module strings. */
        SetLanguage( "" );

175
        /* Initialize the module bank and load the configuration of the
176 177 178 179 180
         * 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 );
181 182

        libvlc.b_ready = VLC_TRUE;
183
    }
184 185
    vlc_mutex_unlock( lockval.p_address );
    var_Destroy( &libvlc, "libvlc" );
186 187 188

    /* Allocate a vlc object */
    p_vlc = vlc_object_create( &libvlc, VLC_OBJECT_VLC );
189 190
    if( p_vlc == NULL )
    {
Sam Hocevar's avatar
Sam Hocevar committed
191
        return VLC_EGENERIC;
192 193 194 195 196
    }

    p_vlc->psz_object_name = "root";

    /* Initialize mutexes */
197
    vlc_mutex_init( p_vlc, &p_vlc->config_lock );
198 199

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

Sam Hocevar's avatar
Sam Hocevar committed
202 203 204 205
    /* Store data for the non-reentrant API */
    p_static_vlc = p_vlc;

    return p_vlc->i_object_id;
206 207 208
}

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

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

230
    if( !p_vlc )
231
    {
232
        return VLC_ENOOBJ;
233 234 235
    }

    /*
236
     * System specific initialization code
237
     */
238
    system_Init( p_vlc, &i_argc, ppsz_argv );
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";
    }

255 256 257 258
    /*
     * Support for gettext
     */
    SetLanguage( "" );
Sam Hocevar's avatar
Sam Hocevar committed
259 260

    /* Translate "C" to the language code: "fr", "en_GB", "nl", "ru"... */
261 262
    msg_Dbg( p_vlc, "translation test: code is \"%s\"", _("C") );

263 264 265 266
    /* Hack: insert the help module here */
    p_help_module = vlc_object_create( p_vlc, VLC_OBJECT_MODULE );
    if( p_help_module == NULL )
    {
267
        //module_EndBank( p_vlc );
Gildas Bazin's avatar
 
Gildas Bazin committed
268
        if( i_object ) vlc_object_release( p_vlc );
269 270 271 272
        return VLC_EGENERIC;
    }
    p_help_module->psz_object_name = "help";
    config_Duplicate( p_help_module, p_help_config );
273
    vlc_object_attach( p_help_module, libvlc.p_module_bank );
274 275
    /* End hack */

Sam Hocevar's avatar
Sam Hocevar committed
276
    if( config_LoadCmdLine( p_vlc, &i_argc, ppsz_argv, VLC_TRUE ) )
277
    {
278
        vlc_object_detach( p_help_module );
279 280
        config_Free( p_help_module );
        vlc_object_destroy( p_help_module );
281
        //module_EndBank( p_vlc );
Gildas Bazin's avatar
 
Gildas Bazin committed
282
        if( i_object ) vlc_object_release( p_vlc );
283 284 285
        return VLC_EGENERIC;
    }

286 287
    b_exit = VLC_FALSE;

288 289 290
    /* Check for short help option */
    if( config_GetInt( p_vlc, "help" ) )
    {
291
        fprintf( stdout, _("Usage: %s [options] [items]...\n\n"),
292
                         p_vlc->psz_object_name );
293
        Usage( p_vlc, "main" );
294 295
        Usage( p_vlc, "help" );
        b_exit = VLC_TRUE;
296 297
    }
    /* Check for version option */
298
    else if( config_GetInt( p_vlc, "version" ) )
299 300
    {
        Version();
301 302 303 304 305 306 307 308 309
        b_exit = VLC_TRUE;
    }

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

    if( b_exit )
    {
310 311
        config_Free( p_help_module );
        vlc_object_destroy( p_help_module );
312
        //module_EndBank( p_vlc );
Gildas Bazin's avatar
 
Gildas Bazin committed
313
        if( i_object ) vlc_object_release( p_vlc );
314 315 316 317 318 319 320 321 322
        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.
     */
323 324
    module_LoadBuiltins( &libvlc );
    module_LoadPlugins( &libvlc );
325
    msg_Dbg( p_vlc, "module bank initialized, found %i modules",
326
                    libvlc.p_module_bank->i_children );
327 328

    /* Hack: insert the help module here */
329
    vlc_object_attach( p_help_module, libvlc.p_module_bank );
330 331 332 333 334
    /* End hack */

    /* Check for help on modules */
    if( (p_tmp = config_GetPsz( p_vlc, "module" )) )
    {
335
        Usage( p_vlc, p_tmp );
336
        free( p_tmp );
337
        b_exit = VLC_TRUE;
338 339
    }
    /* Check for long help option */
340
    else if( config_GetInt( p_vlc, "longhelp" ) )
341
    {
342
        Usage( p_vlc, NULL );
343
        b_exit = VLC_TRUE;
344 345
    }
    /* Check for module list option */
346
    else if( config_GetInt( p_vlc, "list" ) )
347
    {
348
        ListModules( p_vlc );
349
        b_exit = VLC_TRUE;
350 351 352
    }

    /* Hack: remove the help module here */
353
    vlc_object_detach( p_help_module );
354 355 356 357
    config_Free( p_help_module );
    vlc_object_destroy( p_help_module );
    /* End hack */

358 359
    if( b_exit )
    {
360
        //module_EndBank( p_vlc );
Gildas Bazin's avatar
 
Gildas Bazin committed
361
        if( i_object ) vlc_object_release( p_vlc );
362 363 364
        return VLC_EEXIT;
    }

365 366 367 368
    /*
     * Override default configuration with config file settings
     */
    p_vlc->psz_homedir = config_GetHomeDir();
369
    config_LoadConfigFile( p_vlc, NULL );
370 371 372 373

    /*
     * Override configuration with command line settings
     */
Sam Hocevar's avatar
Sam Hocevar committed
374
    if( config_LoadCmdLine( p_vlc, &i_argc, ppsz_argv, VLC_FALSE ) )
375 376 377 378 379 380 381 382
    {
#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
383
        //module_EndBank( p_vlc );
Gildas Bazin's avatar
 
Gildas Bazin committed
384
        if( i_object ) vlc_object_release( p_vlc );
385 386 387 388 389 390
        return VLC_EGENERIC;
    }

    /*
     * System specific configuration
     */
391
    system_Configure( p_vlc );
392

393 394 395 396 397
    /*
     * Message queue options
     */
    if( config_GetInt( p_vlc, "quiet" ) )
    {
398
        libvlc.i_verbose = -1;
399 400 401 402
    }
    else
    {
        int i_tmp = config_GetInt( p_vlc, "verbose" );
403
        if( i_tmp >= 0 )
404
        {
405
            libvlc.i_verbose = __MIN( i_tmp, 2 );
406 407 408 409
        }
    }
    libvlc.b_color = libvlc.b_color || config_GetInt( p_vlc, "color" );

410 411 412 413 414 415 416
    /*
     * 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;
417

418
#if defined( __i386__ )
419
    if( !config_GetInt( p_vlc, "mmx" ) )
420
        libvlc.i_cpu &= ~CPU_CAPABILITY_MMX;
421
    if( !config_GetInt( p_vlc, "3dn" ) )
422
        libvlc.i_cpu &= ~CPU_CAPABILITY_3DNOW;
423
    if( !config_GetInt( p_vlc, "mmxext" ) )
424
        libvlc.i_cpu &= ~CPU_CAPABILITY_MMXEXT;
425
    if( !config_GetInt( p_vlc, "sse" ) )
426
        libvlc.i_cpu &= ~CPU_CAPABILITY_SSE;
427 428
#endif
#if defined( __powerpc__ ) || defined( SYS_DARWIN )
429
    if( !config_GetInt( p_vlc, "altivec" ) )
430
        libvlc.i_cpu &= ~CPU_CAPABILITY_ALTIVEC;
431
#endif
432 433

#define PRINT_CAPABILITY( capability, string )                              \
434
    if( libvlc.i_cpu & capability )                                         \
435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455
    {                                                                       \
        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
     */
456
    p_vlc->p_memcpy_module = module_Need( p_vlc, "memcpy", "$memcpy" );
457

458
    if( p_vlc->pf_memcpy == NULL )
459 460 461
    {
        p_vlc->pf_memcpy = memcpy;
    }
462 463 464 465 466

    if( p_vlc->pf_memset == NULL )
    {
        p_vlc->pf_memset = memset;
    }
467 468 469 470 471

    /*
     * Initialize shared resources and libraries
     */
    if( config_GetInt( p_vlc, "network-channel" )
472
         && network_ChannelCreate( p_vlc ) )
473 474
    {
        /* On error during Channels initialization, switch off channels */
475 476
        msg_Warn( p_vlc,
                  "channels initialization failed, deactivating channels" );
Sam Hocevar's avatar
Sam Hocevar committed
477
        config_PutInt( p_vlc, "network-channel", VLC_FALSE );
478 479 480 481 482
    }

    /*
     * Initialize playlist and get commandline files
     */
483
    p_playlist = playlist_Create( p_vlc );
484 485 486
    if( !p_playlist )
    {
        msg_Err( p_vlc, "playlist initialization failed" );
487 488
        if( p_vlc->p_memcpy_module != NULL )
        {
489
            module_Unneed( p_vlc, p_vlc->p_memcpy_module );
490
        }
491
        //module_EndBank( p_vlc );
Gildas Bazin's avatar
 
Gildas Bazin committed
492
        if( i_object ) vlc_object_release( p_vlc );
493 494 495
        return VLC_EGENERIC;
    }

496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516
    /*
     * Load background interfaces
     */
    psz_modules = config_GetPsz( p_vlc, "extraintf" );
    psz_parser = psz_modules;
    while ( psz_parser && *psz_parser )
    {
        char *psz_module;
        psz_module = psz_parser;
        psz_parser = strchr( psz_module, ',' );
        if ( psz_parser )
        {
            *psz_parser = '\0';
            psz_parser++;
        }
        VLC_AddIntf( 0, psz_module, VLC_FALSE );
    }
    if ( psz_modules )
    {
        free( psz_modules );
    }
517

518 519 520 521 522
    /*
     * Get input filenames given as commandline arguments
     */
    GetFilenames( p_vlc, i_argc, ppsz_argv );

Gildas Bazin's avatar
 
Gildas Bazin committed
523
    if( i_object ) vlc_object_release( p_vlc );
524 525 526 527
    return VLC_SUCCESS;
}

/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
528
 * VLC_AddIntf: add an interface
529 530
 *****************************************************************************
 * This function opens an interface plugin and runs it. If b_block is set
Sam Hocevar's avatar
Sam Hocevar committed
531 532
 * 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
533 534
 * user requests to quit.
 *****************************************************************************/
535
int VLC_AddIntf( int i_object, char const *psz_module, vlc_bool_t b_block )
536
{
Sam Hocevar's avatar
Sam Hocevar committed
537
    int i_err;
538
    intf_thread_t *p_intf;
Sam Hocevar's avatar
Sam Hocevar committed
539
    vlc_t *p_vlc;
540 541
    char *psz_oldmodule = NULL;

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

544
    if( !p_vlc )
545
    {
546
        return VLC_ENOOBJ;
547 548 549 550 551 552 553 554 555
    }

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

    /* Try to create the interface */
556
    p_intf = intf_Create( p_vlc );
557 558 559 560 561 562 563 564 565 566 567 568 569

    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" );
Gildas Bazin's avatar
 
Gildas Bazin committed
570
        if( i_object ) vlc_object_release( p_vlc );
571 572 573 574 575
        return VLC_EGENERIC;
    }

    /* Try to run the interface */
    p_intf->b_block = b_block;
Sam Hocevar's avatar
Sam Hocevar committed
576 577
    i_err = intf_RunThread( p_intf );
    if( i_err )
578
    {
579
        vlc_object_detach( p_intf );
580
        intf_Destroy( p_intf );
Gildas Bazin's avatar
 
Gildas Bazin committed
581
        if( i_object ) vlc_object_release( p_vlc );
Sam Hocevar's avatar
Sam Hocevar committed
582
        return i_err;
583 584
    }

Gildas Bazin's avatar
 
Gildas Bazin committed
585
    if( i_object ) vlc_object_release( p_vlc );
586 587 588 589
    return VLC_SUCCESS;
}

/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
590
 * VLC_Destroy: stop playing and destroy everything.
591
 *****************************************************************************
592
 * This function requests the running threads to finish, waits for their
593 594
 * termination, and destroys their structure.
 *****************************************************************************/
Sam Hocevar's avatar
Sam Hocevar committed
595
int VLC_Destroy( int i_object )
596
{
Sam Hocevar's avatar
Sam Hocevar committed
597 598 599
    vlc_t *p_vlc;

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

601
    if( !p_vlc )
602
    {
603
        return VLC_ENOOBJ;
604 605
    }

606 607 608 609
    /*
     * Go back into channel 0 which is the network
     */
    if( config_GetInt( p_vlc, "network-channel" ) && p_vlc->p_channel )
610
    {
611 612
        network_ChannelJoin( p_vlc, COMMON_CHANNEL );
    }
613

614 615 616 617 618 619 620
    /*
     * Free allocated memory
     */
    if( p_vlc->p_memcpy_module )
    {
        module_Unneed( p_vlc, p_vlc->p_memcpy_module );
        p_vlc->p_memcpy_module = NULL;
621 622
    }

623 624 625 626 627
    if( p_vlc->psz_homedir )
    {
        free( p_vlc->psz_homedir );
        p_vlc->psz_homedir = NULL;
    }
628

629 630 631 632
    /*
     * XXX: Free module bank !
     */
    //module_EndBank( p_vlc );
633

634 635 636 637
    /*
     * System specific cleaning code
     */
    system_End( p_vlc );
638

639 640 641
    /* Destroy mutexes */
    vlc_mutex_destroy( &p_vlc->config_lock );

642 643
    vlc_object_detach( p_vlc );

644 645
    vlc_object_destroy( p_vlc );

646 647 648
    /* Stop thread system: last one out please shut the door! */
    vlc_threads_end( &libvlc );

Gildas Bazin's avatar
 
Gildas Bazin committed
649
    if( i_object ) vlc_object_release( p_vlc );
650 651 652
    return VLC_SUCCESS;
}

653
/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
654
 * VLC_Die: ask vlc to die.
655 656
 *****************************************************************************
 * This function sets p_vlc->b_die to VLC_TRUE, but does not do any other
Sam Hocevar's avatar
Sam Hocevar committed
657
 * task. It is your duty to call vlc_end and VLC_Destroy afterwards.
658
 *****************************************************************************/
Sam Hocevar's avatar
Sam Hocevar committed
659
int VLC_Die( int i_object )
660
{
Sam Hocevar's avatar
Sam Hocevar committed
661 662 663
    vlc_t *p_vlc;

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

    if( !p_vlc )
    {
667
        return VLC_ENOOBJ;
668 669 670 671
    }

    p_vlc->b_die = VLC_TRUE;

Gildas Bazin's avatar
 
Gildas Bazin committed
672
    if( i_object ) vlc_object_release( p_vlc );
673 674 675 676
    return VLC_SUCCESS;
}

/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
677
 * VLC_AddTarget: adds a target for playing.
678 679 680 681
 *****************************************************************************
 * This function adds psz_target to the current playlist. If a playlist does
 * not exist, it will create one.
 *****************************************************************************/
682
int VLC_AddTarget( int i_object, char const *psz_target, int i_mode, int i_pos )
683
{
Sam Hocevar's avatar
Sam Hocevar committed
684
    int i_err;
Sam Hocevar's avatar
Sam Hocevar committed
685
    playlist_t *p_playlist;
Sam Hocevar's avatar
Sam Hocevar committed
686 687 688
    vlc_t *p_vlc;

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

690
    if( !p_vlc )
691
    {
692
        return VLC_ENOOBJ;
693 694
    }

Sam Hocevar's avatar
Sam Hocevar committed
695 696 697 698 699 700 701 702 703
    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 )
        {
Gildas Bazin's avatar
 
Gildas Bazin committed
704
            if( i_object ) vlc_object_release( p_vlc );
Sam Hocevar's avatar
Sam Hocevar committed
705 706 707 708 709 710
            return VLC_EGENERIC;
        }

        vlc_object_yield( p_playlist );
    }

Sam Hocevar's avatar
Sam Hocevar committed
711
    i_err = playlist_Add( p_playlist, psz_target, i_mode, i_pos );
Sam Hocevar's avatar
Sam Hocevar committed
712 713

    vlc_object_release( p_playlist );
714

Gildas Bazin's avatar
 
Gildas Bazin committed
715
    if( i_object ) vlc_object_release( p_vlc );
Sam Hocevar's avatar
Sam Hocevar committed
716
    return i_err;
717 718
}

719
/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
720
 * VLC_Set: set a vlc variable
721 722 723
 *****************************************************************************
 *
 *****************************************************************************/
724
int VLC_Set( int i_object, char const *psz_var, vlc_value_t value )
725
{
Sam Hocevar's avatar
Sam Hocevar committed
726
    vlc_t *p_vlc;
Gildas Bazin's avatar
 
Gildas Bazin committed
727
    int i_ret;
728

Sam Hocevar's avatar
Sam Hocevar committed
729
    p_vlc = i_object ? vlc_object_get( &libvlc, i_object ) : p_static_vlc;
730 731 732

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

Sam Hocevar's avatar
Sam Hocevar committed
736 737 738
    /* 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 ) )
739
    {
Sam Hocevar's avatar
Sam Hocevar committed
740
        module_config_t *p_item;
741
        char const *psz_newvar = psz_var + 6;
742

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

Sam Hocevar's avatar
Sam Hocevar committed
745
        if( p_item )
746
        {
Sam Hocevar's avatar
Sam Hocevar committed
747
            switch( p_item->i_type )
748
            {
Sam Hocevar's avatar
Sam Hocevar committed
749 750 751 752 753 754 755 756 757 758 759 760
                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;
761
            }
Gildas Bazin's avatar
 
Gildas Bazin committed
762
            if( i_object ) vlc_object_release( p_vlc );
Sam Hocevar's avatar
Sam Hocevar committed
763
            return VLC_SUCCESS;
764 765 766
        }
    }

Gildas Bazin's avatar
 
Gildas Bazin committed
767 768 769 770
    i_ret = var_Set( p_vlc, psz_var, value );

    if( i_object ) vlc_object_release( p_vlc );
    return i_ret;
Sam Hocevar's avatar
Sam Hocevar committed
771 772 773 774 775 776 777
}

/*****************************************************************************
 * VLC_Get: get a vlc variable
 *****************************************************************************
 *
 *****************************************************************************/
778
int VLC_Get( int i_object, char const *psz_var, vlc_value_t *p_value )
Sam Hocevar's avatar
Sam Hocevar committed
779 780
{
    vlc_t *p_vlc;
Gildas Bazin's avatar
 
Gildas Bazin committed
781
    int i_ret;
Sam Hocevar's avatar
Sam Hocevar committed
782 783 784 785

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

    if( !p_vlc )
786
    {
787
        return VLC_ENOOBJ;
788 789
    }

Gildas Bazin's avatar
 
Gildas Bazin committed
790 791 792 793
    i_ret = var_Get( p_vlc, psz_var, p_value );

    if( i_object ) vlc_object_release( p_vlc );
    return i_ret;
794 795
}

Sam Hocevar's avatar
Sam Hocevar committed
796
/* FIXME: temporary hacks */
797 798

/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
799
 * VLC_Play: play
800
 *****************************************************************************/
Sam Hocevar's avatar
Sam Hocevar committed
801
int VLC_Play( int i_object )
802 803
{
    playlist_t * p_playlist;
Sam Hocevar's avatar
Sam Hocevar committed
804 805 806
    vlc_t *p_vlc;

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

    /* Check that the handle is valid */
809
    if( !p_vlc )
810
    {
811
        return VLC_ENOOBJ;
812
    }
813

814 815
    vlc_thread_set_priority( p_vlc, VLC_THREAD_PRIORITY_LOW );

816 817 818 819
    p_playlist = vlc_object_find( p_vlc, VLC_OBJECT_PLAYLIST, FIND_CHILD );

    if( !p_playlist )
    {
Gildas Bazin's avatar
 
Gildas Bazin committed
820
        if( i_object ) vlc_object_release( p_vlc );
821
        return VLC_ENOOBJ;
822 823 824 825 826 827 828 829 830 831 832 833 834 835 836
    }

    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 );

Gildas Bazin's avatar
 
Gildas Bazin committed
837
    if( i_object ) vlc_object_release( p_vlc );
838 839 840 841
    return VLC_SUCCESS;
}

/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
842
 * VLC_Stop: stop
843
 *****************************************************************************/
Sam Hocevar's avatar
Sam Hocevar committed
844
int VLC_Stop( int i_object )
845 846 847 848 849
{
    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
850 851 852
    vlc_t *p_vlc;

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

    /* Check that the handle is valid */
855
    if( !p_vlc )
856
    {
857
        return VLC_ENOOBJ;
858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891
    }

    /*
     * 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 );
892
        vout_Destroy( p_vout );
893 894 895 896 897 898 899 900 901 902 903 904 905
    }

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

Gildas Bazin's avatar
 
Gildas Bazin committed
906
    if( i_object ) vlc_object_release( p_vlc );
907 908 909 910
    return VLC_SUCCESS;
}

/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
911
 * VLC_Pause: toggle pause
912
 *****************************************************************************/
Sam Hocevar's avatar
Sam Hocevar committed
913
int VLC_Pause( int i_object )
914 915
{
    input_thread_t *p_input;
Sam Hocevar's avatar
Sam Hocevar committed
916 917 918 919 920 921
    vlc_t *p_vlc;

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

    if( !p_vlc )
    {
922
        return VLC_ENOOBJ;
Sam Hocevar's avatar
Sam Hocevar committed
923
    }
924 925 926 927 928

    p_input = vlc_object_find( p_vlc, VLC_OBJECT_INPUT, FIND_CHILD );

    if( !p_input )
    {
Gildas Bazin's avatar
 
Gildas Bazin committed
929
        if( i_object ) vlc_object_release( p_vlc );
930
        return VLC_ENOOBJ;
931 932 933 934 935
    }

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

Gildas Bazin's avatar
 
Gildas Bazin committed
936
    if( i_object ) vlc_object_release( p_vlc );
937 938 939 940
    return VLC_SUCCESS;
}

/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
941
 * VLC_FullScreen: toggle fullscreen mode
942
 *****************************************************************************/
Sam Hocevar's avatar
Sam Hocevar committed
943
int VLC_FullScreen( int i_object )
944 945
{
    vout_thread_t *p_vout;
Sam Hocevar's avatar
Sam Hocevar committed
946 947 948 949 950 951
    vlc_t *p_vlc;

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

    if( !p_vlc )
    {
952
        return VLC_ENOOBJ;
Sam Hocevar's avatar
Sam Hocevar committed
953
    }
954 955 956 957 958

    p_vout = vlc_object_find( p_vlc, VLC_OBJECT_VOUT, FIND_CHILD );

    if( !p_vout )
    {
Gildas Bazin's avatar
 
Gildas Bazin committed
959
        if( i_object ) vlc_object_release( p_vlc );
960
        return VLC_ENOOBJ;
961 962 963 964 965
    }

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

Gildas Bazin's avatar
 
Gildas Bazin committed
966
    if( i_object ) vlc_object_release( p_vlc );
967 968 969
    return VLC_SUCCESS;
}

970 971
/* following functions are local */

Sam Hocevar's avatar
Sam Hocevar committed
972 973 974 975 976 977 978 979 980
/*****************************************************************************
 * 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 )
{
981 982 983
#if defined( ENABLE_NLS ) \
     && ( defined( HAVE_GETTEXT ) || defined( HAVE_INCLUDED_GETTEXT ) )

984 985 986 987 988
    char *          psz_path;
#ifdef SYS_DARWIN
    char            psz_tmp[1024];
#endif

989 990
#   if defined( HAVE_INCLUDED_GETTEXT ) && !defined( HAVE_LC_MESSAGES )
    if( *psz_lang )
Sam Hocevar's avatar
Sam Hocevar committed
991
    {
992 993 994 995 996 997 998 999
        /* 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
1000
    }
1001
#   endif
Sam Hocevar's avatar
Sam Hocevar committed
1002

1003 1004
#   if defined( HAVE_LC_MESSAGES )
    setlocale( LC_MESSAGES, psz_lang );
Sam Hocevar's avatar
Sam Hocevar committed
1005
#   endif
1006
    setlocale( LC_CTYPE, psz_lang );
Sam Hocevar's avatar
Sam Hocevar committed
1007

1008
    /* Specify where to find the locales for current domain */
1009 1010 1011
#ifndef SYS_DARWIN
    psz_path = LOCALEDIR;
#else
1012
    snprintf( psz_tmp, sizeof(psz_tmp), "%s/%s", libvlc.psz_vlcpath,
1013 1014 1015 1016
              "locale" );
    psz_path = psz_tmp;
#endif
    if( !bindtextdomain( PACKAGE, psz_path ) )
Sam Hocevar's avatar
Sam Hocevar committed
1017 1018
    {
        fprintf( stderr, "warning: no domain %s in directory %s\n",
1019
                 PACKAGE, psz_path );
Sam Hocevar's avatar
Sam Hocevar committed
1020 1021
    }

1022
    /* Set the default domain */
Sam Hocevar's avatar
Sam Hocevar committed
1023 1024 1025 1026
    textdomain( PACKAGE );
#endif
}

1027 1028 1029 1030 1031 1032 1033 1034 1035 1036
/*****************************************************************************
 * 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 */
1037
    for( i_opt = i_argc - 1; i_opt > optind; i_opt-- )
1038
    {
Sam Hocevar's avatar
Sam Hocevar committed
1039 1040 1041
        /* TODO: write an internal function of this one, to avoid
         *       unnecessary lookups. */
        VLC_AddTarget( p_vlc->i_object_id, ppsz_argv[ i_opt ],
1042 1043 1044 1045 1046 1047 1048 1049
                       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 );
1050 1051 1052 1053 1054 1055 1056 1057 1058 1059
    }

    return VLC_SUCCESS;
}

/*****************************************************************************
 * Usage: print program usage
 *****************************************************************************
 * Print a short inline help. Message interface is initialized at this stage.
 *****************************************************************************/
1060
static void Usage( vlc_t *p_this, char const *psz_module_name )
1061
{
Sam Hocevar's avatar
Sam Hocevar committed
1062 1063 1064 1065 1066 1067 1068 1069
#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 ---------------------------'
1070 1071 1072 1073 1074
     *
     * The purpose of having bra and ket is that we might i18n them as well.
     */
#define LINE_START 8
#define PADDING_SPACES 25
1075
    vlc_list_t *p_list;
Gildas Bazin's avatar
 
Gildas Bazin committed
1076
    module_t *p_parser;
1077 1078 1079
    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
1080
    int i_index;
1081 1082 1083 1084 1085 1086 1087 1088 1089 1090

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

    strcpy( psz_format, FORMAT_STRING );

#ifdef WIN32
    ShowConsole();
#endif

1091
    /* List all modules */
1092
    p_list = vlc_list_find( p_this, VLC_OBJECT_MODULE, FIND_ANYWHERE );
1093

1094
    /* Enumerate the config for each module */
1095
    for( i_index = 0; i_index < p_list->i_count; i_index++ )
1096
    {
1097
        vlc_bool_t b_help_module;
1098

1099
        p_parser = (module_t *)p_list->p_values[i_index].p_object ;
Gildas Bazin's avatar
 
Gildas Bazin committed
1100

1101
        if( psz_module_name && strcmp( psz_module_name,
Gildas Bazin's avatar
 
Gildas Bazin committed
1102
                                       p_parser->psz_object_name ) )
Sam Hocevar's avatar
Sam Hocevar committed
1103
        {
1104
            continue;
Sam Hocevar's avatar
Sam Hocevar committed
1105
        }
1106 1107

        /* Ignore modules without config options */
Gildas Bazin's avatar
 
Gildas Bazin committed
1108
        if( !p_parser->i_config_items )
Sam Hocevar's avatar
Sam Hocevar committed
1109 1110 1111
        {
            continue;
        }
1112

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

1115
        /* Print module options */
Gildas Bazin's avatar
 
Gildas Bazin committed
1116
        for( p_item = p_parser->p_config;
Gildas Bazin's avatar
 
Gildas Bazin committed
1117
             p_item->i_type != CONFIG_HINT_END;
1118 1119 1120
             p_item++ )
        {
            char *psz_bra = NULL, *psz_type = NULL, *psz_ket = NULL;
Sam Hocevar's avatar
Sam Hocevar committed
1121
            char *psz_suf = "", *psz_prefix = NULL;
1122 1123 1124 1125
            int i;

            switch( p_item->i_type )
            {
Gildas Bazin's avatar
 
Gildas Bazin committed
1126 1127
            case CONFIG_HINT_CATEGORY:
            case CONFIG_HINT_USAGE:
1128
                fprintf( stdout, " %s\n", p_item->psz_text );
1129 1130
                break;

Gildas Bazin's avatar
 
Gildas Bazin committed
1131 1132 1133
            case CONFIG_ITEM_STRING:
            case CONFIG_ITEM_FILE:
            case CONFIG_ITEM_MODULE: /* We could also have "=<" here */
1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152
                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
1153
            case CONFIG_ITEM_INTEGER:
1154 1155
                psz_bra = " <"; psz_type = _("integer"); psz_ket = ">";
                break;
Gildas Bazin's avatar
 
Gildas Bazin committed
1156
            case CONFIG_ITEM_FLOAT: