libvlc.c 68.3 KB
Newer Older
1 2 3
/*****************************************************************************
 * libvlc.c: main libvlc source
 *****************************************************************************
4
 * Copyright (C) 1998-2004 VideoLAN
5
 * $Id$
6 7 8
 *
 * Authors: Vincent Seguin <seguin@via.ecp.fr>
 *          Samuel Hocevar <sam@zoy.org>
9
 *          Gildas Bazin <gbazin@videolan.org>
10
 *          Derk-Jan Hartman <hartman at videolan dot org>
11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
 *
 * 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
31
#define MODULE_PATH main
32 33 34 35 36
#define __BUILTIN__

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

40
#include <errno.h>                                                 /* ENOMEM */
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>
Gildas Bazin's avatar
 
Gildas Bazin committed
51
#elif 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
#ifdef HAVE_LOCALE_H
#   include <locale.h>
#endif

63 64 65 66
#ifdef HAVE_HAL
#   include <hal/libhal.h>
#endif

67
#include "vlc_cpu.h"                                        /* CPU detection */
68
#include "os_specific.h"
69

70
#include "vlc_error.h"
71

72
#include "vlc_playlist.h"
73
#include "vlc_interface.h"
74 75 76

#include "audio_output.h"

77
#include "vlc_video.h"
78 79
#include "video_output.h"

80 81
#include "stream_output.h"

82 83 84
#include "libvlc.h"

/*****************************************************************************
85
 * The evil global variable. We handle it with care, don't worry.
86
 *****************************************************************************/
87 88 89
static libvlc_t   libvlc;
static libvlc_t * p_libvlc;
static vlc_t *    p_static_vlc;
90 91 92 93

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

#ifdef WIN32
static void ShowConsole   ( void );
102
static void PauseConsole  ( void );
103
#endif
104
static int  ConsoleWidth  ( void );
105

Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
106 107
static int  VerboseCallback( vlc_object_t *, char const *,
                             vlc_value_t, vlc_value_t, void * );
108

109 110
static void InitDeviceValues( vlc_t * );

111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126
/*****************************************************************************
 * vlc_current_object: return the current object.
 *****************************************************************************
 * If i_object is non-zero, return the corresponding object. Otherwise,
 * return the statically allocated p_vlc object.
 *****************************************************************************/
vlc_t * vlc_current_object( int i_object )
{
    if( i_object )
    {
         return vlc_object_get( p_libvlc, i_object );
    }

    return p_static_vlc;
}

127
/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
128
 * VLC_Version: return the libvlc version.
129
 *****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
130
 * This function returns full version string (numeric version and codename).
131
 *****************************************************************************/
132
char const * VLC_Version( void )
133
{
Sam Hocevar's avatar
Sam Hocevar committed
134
    return VERSION_MESSAGE;
135 136
}

137 138 139 140 141 142 143 144 145 146
/*****************************************************************************
 * 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
147 148 149 150 151 152 153
/*****************************************************************************
 * 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 )
154
{
155
    int i_ret;
156
    vlc_t * p_vlc = NULL;
157
    vlc_value_t lockval;
158

159 160 161
    /* &libvlc never changes, so we can safely call this multiple times. */
    p_libvlc = &libvlc;

162 163
    /* vlc_threads_init *must* be the first internal call! No other call is
     * allowed before the thread system has been initialized. */
164
    i_ret = vlc_threads_init( p_libvlc );
Sam Hocevar's avatar
Sam Hocevar committed
165
    if( i_ret < 0 )
166
    {
Sam Hocevar's avatar
Sam Hocevar committed
167
        return i_ret;
168 169 170
    }

    /* Now that the thread system is initialized, we don't have much, but
171
     * at least we have var_Create */
172 173
    var_Create( p_libvlc, "libvlc", VLC_VAR_MUTEX );
    var_Get( p_libvlc, "libvlc", &lockval );
174
    vlc_mutex_lock( lockval.p_address );
175 176
    if( !libvlc.b_ready )
    {
177 178
        char *psz_env;

179 180 181
        /* Guess what CPU we have */
        libvlc.i_cpu = CPUCapabilities();

182 183
        /* Find verbosity from VLC_VERBOSE environment variable */
        psz_env = getenv( "VLC_VERBOSE" );
184
        libvlc.i_verbose = psz_env ? atoi( psz_env ) : -1;
185

Gildas Bazin's avatar
 
Gildas Bazin committed
186
#if defined( HAVE_ISATTY ) && !defined( WIN32 )
187 188 189 190 191
        libvlc.b_color = isatty( 2 ); /* 2 is for stderr */
#else
        libvlc.b_color = VLC_FALSE;
#endif

192
        /* Initialize message queue */
193
        msg_Create( p_libvlc );
194 195

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

199 200
        /* The module bank will be initialized later */
        libvlc.p_module_bank = NULL;
201 202

        libvlc.b_ready = VLC_TRUE;
203
    }
204
    vlc_mutex_unlock( lockval.p_address );
205
    var_Destroy( p_libvlc, "libvlc" );
206 207

    /* Allocate a vlc object */
208
    p_vlc = vlc_object_create( p_libvlc, VLC_OBJECT_VLC );
209 210
    if( p_vlc == NULL )
    {
Sam Hocevar's avatar
Sam Hocevar committed
211
        return VLC_EGENERIC;
212
    }
213
    p_vlc->thread_id = 0;
214 215 216 217

    p_vlc->psz_object_name = "root";

    /* Initialize mutexes */
218
    vlc_mutex_init( p_vlc, &p_vlc->config_lock );
Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
219 220
#ifdef SYS_DARWIN
    vlc_mutex_init( p_vlc, &p_vlc->quicktime_lock );
221
    vlc_thread_set_priority( p_vlc, VLC_THREAD_PRIORITY_LOW );
Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
222
#endif
223 224

    /* Store our newly allocated structure in the global list */
225
    vlc_object_attach( p_vlc, p_libvlc );
226

Sam Hocevar's avatar
Sam Hocevar committed
227 228 229 230
    /* Store data for the non-reentrant API */
    p_static_vlc = p_vlc;

    return p_vlc->i_object_id;
231 232 233
}

/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
234
 * VLC_Init: initialize a vlc_t structure.
235 236 237 238 239 240 241
 *****************************************************************************
 * 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
242
int VLC_Init( int i_object, int i_argc, char *ppsz_argv[] )
243
{
244 245
    char         p_capabilities[200];
    char *       p_tmp;
246 247
    char *       psz_modules;
    char *       psz_parser;
248
    char *       psz_control;
249
    char *       psz_language;
250
    vlc_bool_t   b_exit = VLC_FALSE;
251
    vlc_t *      p_vlc = vlc_current_object( i_object );
252 253
    module_t    *p_help_module;
    playlist_t  *p_playlist;
254

255
    if( !p_vlc )
256
    {
257
        return VLC_ENOOBJ;
258 259 260
    }

    /*
261
     * System specific initialization code
262
     */
263
    system_Init( p_vlc, &i_argc, ppsz_argv );
264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279

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

280 281 282 283
    /*
     * Support for gettext
     */
    SetLanguage( "" );
Sam Hocevar's avatar
Sam Hocevar committed
284 285

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

288 289 290 291
    /* Initialize the module bank and load the configuration of the
     * 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) */
292
    module_InitBank( p_vlc );
293

294 295 296 297
    /* Hack: insert the help module here */
    p_help_module = vlc_object_create( p_vlc, VLC_OBJECT_MODULE );
    if( p_help_module == NULL )
    {
298
        module_EndBank( p_vlc );
Gildas Bazin's avatar
 
Gildas Bazin committed
299
        if( i_object ) vlc_object_release( p_vlc );
300 301 302
        return VLC_EGENERIC;
    }
    p_help_module->psz_object_name = "help";
Gildas Bazin's avatar
 
Gildas Bazin committed
303
    p_help_module->psz_longname = N_("Help options");
304
    config_Duplicate( p_help_module, p_help_config );
305
    vlc_object_attach( p_help_module, libvlc.p_module_bank );
306 307
    /* End hack */

Sam Hocevar's avatar
Sam Hocevar committed
308
    if( config_LoadCmdLine( p_vlc, &i_argc, ppsz_argv, VLC_TRUE ) )
309
    {
310
        vlc_object_detach( p_help_module );
311 312
        config_Free( p_help_module );
        vlc_object_destroy( p_help_module );
313
        module_EndBank( p_vlc );
Gildas Bazin's avatar
 
Gildas Bazin committed
314
        if( i_object ) vlc_object_release( p_vlc );
315 316 317 318 319 320
        return VLC_EGENERIC;
    }

    /* Check for short help option */
    if( config_GetInt( p_vlc, "help" ) )
    {
Gildas Bazin's avatar
 
Gildas Bazin committed
321
        fprintf( stdout, _("Usage: %s [options] [items]...\n"),
322
                         p_vlc->psz_object_name );
323
        Usage( p_vlc, "main" );
324 325
        Usage( p_vlc, "help" );
        b_exit = VLC_TRUE;
326 327
    }
    /* Check for version option */
328
    else if( config_GetInt( p_vlc, "version" ) )
329 330
    {
        Version();
331 332 333
        b_exit = VLC_TRUE;
    }

Gildas Bazin's avatar
 
Gildas Bazin committed
334 335 336 337
    /* Set the config file stuff */
    p_vlc->psz_homedir = config_GetHomeDir();
    p_vlc->psz_configfile = config_GetPsz( p_vlc, "config" );

338 339 340 341 342 343
    /* Check for plugins cache options */
    if( config_GetInt( p_vlc, "reset-plugins-cache" ) )
    {
        libvlc.p_module_bank->b_cache_delete = VLC_TRUE;
    }

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

Gildas Bazin's avatar
Gildas Bazin committed
348 349 350 351 352 353 354
    /* Will be re-done properly later on */
    p_vlc->p_libvlc->i_verbose = config_GetInt( p_vlc, "verbose" );

    /* Check for daemon mode */
#ifndef WIN32
    if( config_GetInt( p_vlc, "daemon" ) )
    {
355 356 357 358 359 360 361 362 363 364 365
#if HAVE_DAEMON
        if( daemon( 0, 0) != 0 )
        {
            msg_Err( p_vlc, "Unable to fork vlc to daemon mode" );
            b_exit = VLC_TRUE;
        }

        p_vlc->p_libvlc->b_daemon = VLC_TRUE;

#else
        pid_t i_pid;
Gildas Bazin's avatar
Gildas Bazin committed
366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381

        if( ( i_pid = fork() ) < 0 )
        {
            msg_Err( p_vlc, "Unable to fork vlc to daemon mode" );
            b_exit = VLC_TRUE;
        }
        else if( i_pid )
        {
            /* This is the parent, exit right now */
            msg_Dbg( p_vlc, "closing parent process" );
            b_exit = VLC_TRUE;
        }
        else
        {
            /* We are the child */
            msg_Dbg( p_vlc, "daemon spawned" );
382 383 384
            close( STDIN_FILENO );
            close( STDOUT_FILENO );
            close( STDERR_FILENO );
Gildas Bazin's avatar
Gildas Bazin committed
385 386 387

            p_vlc->p_libvlc->b_daemon = VLC_TRUE;
        }
388
#endif
Gildas Bazin's avatar
Gildas Bazin committed
389 390 391
    }
#endif

392 393
    if( b_exit )
    {
394 395
        config_Free( p_help_module );
        vlc_object_destroy( p_help_module );
396
        module_EndBank( p_vlc );
Gildas Bazin's avatar
 
Gildas Bazin committed
397
        if( i_object ) vlc_object_release( p_vlc );
398 399 400
        return VLC_EEXIT;
    }

Gildas Bazin's avatar
 
Gildas Bazin committed
401
    /* Check for translation config option */
Gildas Bazin's avatar
 
Gildas Bazin committed
402 403 404 405 406 407 408 409
#if defined( ENABLE_NLS ) \
     && ( defined( HAVE_GETTEXT ) || defined( HAVE_INCLUDED_GETTEXT ) )

    /* This ain't really nice to have to reload the config here but it seems
     * the only way to do it. */
    config_LoadConfigFile( p_vlc, "main" );
    config_LoadCmdLine( p_vlc, &i_argc, ppsz_argv, VLC_TRUE );

410 411 412
    /* Check if the user specified a custom language */
    psz_language = config_GetPsz( p_vlc, "language" );
    if( psz_language && *psz_language && strcmp( psz_language, "auto" ) )
Gildas Bazin's avatar
 
Gildas Bazin committed
413
    {
414 415
        vlc_bool_t b_cache_delete = libvlc.p_module_bank->b_cache_delete;

Gildas Bazin's avatar
 
Gildas Bazin committed
416
        /* Reset the default domain */
417
        SetLanguage( psz_language );
Gildas Bazin's avatar
 
Gildas Bazin committed
418

Gildas Bazin's avatar
 
Gildas Bazin committed
419 420 421
        /* Translate "C" to the language code: "fr", "en_GB", "nl", "ru"... */
        msg_Dbg( p_vlc, "translation test: code is \"%s\"", _("C") );

Sam Hocevar's avatar
Sam Hocevar committed
422
        textdomain( PACKAGE_NAME );
Gildas Bazin's avatar
 
Gildas Bazin committed
423

Gildas Bazin's avatar
 
Gildas Bazin committed
424
#if defined( ENABLE_UTF8 )
Sam Hocevar's avatar
Sam Hocevar committed
425
        bind_textdomain_codeset( PACKAGE_NAME, "UTF-8" );
426 427
#endif

Gildas Bazin's avatar
 
Gildas Bazin committed
428
        module_EndBank( p_vlc );
429
        module_InitBank( p_vlc );
430
        config_LoadConfigFile( p_vlc, "main" );
Gildas Bazin's avatar
 
Gildas Bazin committed
431
        config_LoadCmdLine( p_vlc, &i_argc, ppsz_argv, VLC_TRUE );
432
        libvlc.p_module_bank->b_cache_delete = b_cache_delete;
Gildas Bazin's avatar
 
Gildas Bazin committed
433
    }
434
    if( psz_language ) free( psz_language );
435
#endif
Gildas Bazin's avatar
 
Gildas Bazin committed
436

437 438 439 440 441 442
    /*
     * 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.
     */
443 444 445 446 447 448 449
    module_LoadBuiltins( p_vlc );
    module_LoadPlugins( p_vlc );
    if( p_vlc->b_die )
    {
        b_exit = VLC_TRUE;
    }

450
    msg_Dbg( p_vlc, "module bank initialized, found %i modules",
451
                    libvlc.p_module_bank->i_children );
452 453

    /* Hack: insert the help module here */
454
    vlc_object_attach( p_help_module, libvlc.p_module_bank );
455 456 457 458 459
    /* End hack */

    /* Check for help on modules */
    if( (p_tmp = config_GetPsz( p_vlc, "module" )) )
    {
460
        Usage( p_vlc, p_tmp );
461
        free( p_tmp );
462
        b_exit = VLC_TRUE;
463 464
    }
    /* Check for long help option */
465
    else if( config_GetInt( p_vlc, "longhelp" ) )
466
    {
467
        Usage( p_vlc, NULL );
468
        b_exit = VLC_TRUE;
469 470
    }
    /* Check for module list option */
471
    else if( config_GetInt( p_vlc, "list" ) )
472
    {
473
        ListModules( p_vlc );
474
        b_exit = VLC_TRUE;
475 476
    }

Gildas Bazin's avatar
 
Gildas Bazin committed
477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494
    /* Check for config file options */
    if( config_GetInt( p_vlc, "reset-config" ) )
    {
        vlc_object_detach( p_help_module );
        config_ResetAll( p_vlc );
        config_LoadCmdLine( p_vlc, &i_argc, ppsz_argv, VLC_TRUE );
        config_SaveConfigFile( p_vlc, NULL );
        vlc_object_attach( p_help_module, libvlc.p_module_bank );
    }
    if( config_GetInt( p_vlc, "save-config" ) )
    {
        vlc_object_detach( p_help_module );
        config_LoadConfigFile( p_vlc, NULL );
        config_LoadCmdLine( p_vlc, &i_argc, ppsz_argv, VLC_TRUE );
        config_SaveConfigFile( p_vlc, NULL );
        vlc_object_attach( p_help_module, libvlc.p_module_bank );
    }

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

499 500
    if( b_exit )
    {
Gildas Bazin's avatar
 
Gildas Bazin committed
501 502
        config_Free( p_help_module );
        vlc_object_destroy( p_help_module );
503
        module_EndBank( p_vlc );
Gildas Bazin's avatar
 
Gildas Bazin committed
504
        if( i_object ) vlc_object_release( p_vlc );
505 506 507
        return VLC_EEXIT;
    }

508 509 510 511 512
    /*
     * Init device values
     */
    InitDeviceValues( p_vlc );

513 514 515
    /*
     * Override default configuration with config file settings
     */
516
    config_LoadConfigFile( p_vlc, NULL );
517

Gildas Bazin's avatar
 
Gildas Bazin committed
518 519 520 521
    /* Hack: insert the help module here */
    vlc_object_attach( p_help_module, libvlc.p_module_bank );
    /* End hack */

522 523 524
    /*
     * Override configuration with command line settings
     */
Sam Hocevar's avatar
Sam Hocevar committed
525
    if( config_LoadCmdLine( p_vlc, &i_argc, ppsz_argv, VLC_FALSE ) )
526 527 528 529 530
    {
#ifdef WIN32
        ShowConsole();
        /* Pause the console because it's destroyed when we exit */
        fprintf( stderr, "The command line options couldn't be loaded, check "
531 532
                 "that they are valid.\n" );
        PauseConsole();
533
#endif
Gildas Bazin's avatar
 
Gildas Bazin committed
534 535 536
        vlc_object_detach( p_help_module );
        config_Free( p_help_module );
        vlc_object_destroy( p_help_module );
537
        module_EndBank( p_vlc );
Gildas Bazin's avatar
 
Gildas Bazin committed
538
        if( i_object ) vlc_object_release( p_vlc );
539 540 541
        return VLC_EGENERIC;
    }

Gildas Bazin's avatar
 
Gildas Bazin committed
542 543 544 545 546 547
    /* Hack: remove the help module here */
    vlc_object_detach( p_help_module );
    config_Free( p_help_module );
    vlc_object_destroy( p_help_module );
    /* End hack */

548 549 550
    /*
     * System specific configuration
     */
Gildas Bazin's avatar
 
Gildas Bazin committed
551
    system_Configure( p_vlc, &i_argc, ppsz_argv );
552

553 554 555
    /*
     * Message queue options
     */
Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
556 557

    var_Create( p_vlc, "verbose", VLC_VAR_INTEGER | VLC_VAR_DOINHERIT );
558 559
    if( config_GetInt( p_vlc, "quiet" ) )
    {
Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
560 561 562
        vlc_value_t val;
        val.i_int = -1;
        var_Set( p_vlc, "verbose", val );
563
    }
Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
564 565
    var_AddCallback( p_vlc, "verbose", VerboseCallback, NULL );
    var_Change( p_vlc, "verbose", VLC_VAR_TRIGGER_CALLBACKS, NULL, NULL );
Clément Stenac's avatar
Clément Stenac committed
566

Gildas Bazin's avatar
 
Gildas Bazin committed
567
    libvlc.b_color = libvlc.b_color && config_GetInt( p_vlc, "color" );
568

569 570 571 572 573
    /*
     * Output messages that may still be in the queue
     */
    msg_Flush( p_vlc );

574
    /* p_vlc initialization. FIXME ? */
575

576
#if defined( __i386__ )
577
    if( !config_GetInt( p_vlc, "mmx" ) )
578
        libvlc.i_cpu &= ~CPU_CAPABILITY_MMX;
579
    if( !config_GetInt( p_vlc, "3dn" ) )
580
        libvlc.i_cpu &= ~CPU_CAPABILITY_3DNOW;
581
    if( !config_GetInt( p_vlc, "mmxext" ) )
582
        libvlc.i_cpu &= ~CPU_CAPABILITY_MMXEXT;
583
    if( !config_GetInt( p_vlc, "sse" ) )
584
        libvlc.i_cpu &= ~CPU_CAPABILITY_SSE;
585 586
    if( !config_GetInt( p_vlc, "sse2" ) )
        libvlc.i_cpu &= ~CPU_CAPABILITY_SSE2;
587 588
#endif
#if defined( __powerpc__ ) || defined( SYS_DARWIN )
589
    if( !config_GetInt( p_vlc, "altivec" ) )
590
        libvlc.i_cpu &= ~CPU_CAPABILITY_ALTIVEC;
591
#endif
592 593

#define PRINT_CAPABILITY( capability, string )                              \
594
    if( libvlc.i_cpu & capability )                                         \
595 596 597 598 599 600 601 602 603 604 605 606 607 608
    {                                                                       \
        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" );
609
    PRINT_CAPABILITY( CPU_CAPABILITY_SSE2, "SSE2" );
610 611 612 613 614 615 616
    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
     */
Gildas Bazin's avatar
 
Gildas Bazin committed
617
    p_vlc->p_memcpy_module = module_Need( p_vlc, "memcpy", "$memcpy", 0 );
618

619
    if( p_vlc->pf_memcpy == NULL )
620 621 622
    {
        p_vlc->pf_memcpy = memcpy;
    }
623 624 625 626 627

    if( p_vlc->pf_memset == NULL )
    {
        p_vlc->pf_memset = memset;
    }
628

Sigmund Augdal Helberg's avatar
Sigmund Augdal Helberg committed
629 630 631 632
    /*
     * Initialize hotkey handling
     */
    var_Create( p_vlc, "key-pressed", VLC_VAR_INTEGER );
Gildas Bazin's avatar
 
Gildas Bazin committed
633 634
    p_vlc->p_hotkeys = malloc( sizeof(p_hotkeys) );
    /* Do a copy (we don't need to modify the strings) */
635
    memcpy( p_vlc->p_hotkeys, p_hotkeys, sizeof(p_hotkeys) );
Gildas Bazin's avatar
 
Gildas Bazin committed
636

637 638 639
    /*
     * Initialize playlist and get commandline files
     */
640
    p_playlist = playlist_Create( p_vlc );
641 642 643
    if( !p_playlist )
    {
        msg_Err( p_vlc, "playlist initialization failed" );
644 645
        if( p_vlc->p_memcpy_module != NULL )
        {
646
            module_Unneed( p_vlc, p_vlc->p_memcpy_module );
647
        }
648
        module_EndBank( p_vlc );
Gildas Bazin's avatar
 
Gildas Bazin committed
649
        if( i_object ) vlc_object_release( p_vlc );
650 651 652
        return VLC_EGENERIC;
    }

653 654 655 656 657 658 659
    psz_modules = config_GetPsz( p_playlist, "services-discovery" );
    if( psz_modules && *psz_modules )
    {
        /* Add service discovery modules */
        playlist_AddSDModules( p_playlist, psz_modules );
    }
    if( psz_modules ) free( psz_modules );
660

661 662 663 664
    /*
     * Load background interfaces
     */
    psz_modules = config_GetPsz( p_vlc, "extraintf" );
665 666 667 668 669 670 671 672 673 674 675 676 677 678
    psz_control = config_GetPsz( p_vlc, "control" );

    if( psz_modules && *psz_modules && psz_control && *psz_control )
    {
        psz_modules = (char *)realloc( psz_modules, strlen( psz_modules ) +
                                                    strlen( psz_control ) + 1 );
        sprintf( psz_modules, "%s,%s", psz_modules, psz_control );
    }
    else if( psz_control && *psz_control )
    {
        if( psz_modules ) free( psz_modules );
        psz_modules = strdup( psz_control );
    }

679 680 681
    psz_parser = psz_modules;
    while ( psz_parser && *psz_parser )
    {
Gildas Bazin's avatar
 
Gildas Bazin committed
682
        char *psz_module, *psz_temp;
683 684 685 686 687 688 689
        psz_module = psz_parser;
        psz_parser = strchr( psz_module, ',' );
        if ( psz_parser )
        {
            *psz_parser = '\0';
            psz_parser++;
        }
Gildas Bazin's avatar
 
Gildas Bazin committed
690 691 692 693
        psz_temp = (char *)malloc( strlen(psz_module) + sizeof(",none") );
        if( psz_temp )
        {
            sprintf( psz_temp, "%s,none", psz_module );
694
            VLC_AddIntf( 0, psz_temp, VLC_FALSE, VLC_FALSE );
Gildas Bazin's avatar
 
Gildas Bazin committed
695 696
            free( psz_temp );
        }
697 698 699 700 701
    }
    if ( psz_modules )
    {
        free( psz_modules );
    }
702

Sigmund Augdal Helberg's avatar
Sigmund Augdal Helberg committed
703 704 705
    /*
     * Allways load the hotkeys interface if it exists
     */
706
    VLC_AddIntf( 0, "hotkeys,none", VLC_FALSE, VLC_FALSE );
Sigmund Augdal Helberg's avatar
Sigmund Augdal Helberg committed
707

708 709 710 711
    /*
     * FIXME: kludge to use a p_vlc-local variable for the Mozilla plugin
     */
    var_Create( p_vlc, "drawable", VLC_VAR_INTEGER );
712 713 714 715 716 717 718 719 720 721 722
    var_Create( p_vlc, "drawableredraw", VLC_VAR_INTEGER );
    var_Create( p_vlc, "drawablet", VLC_VAR_INTEGER );
    var_Create( p_vlc, "drawablel", VLC_VAR_INTEGER );
    var_Create( p_vlc, "drawableb", VLC_VAR_INTEGER );
    var_Create( p_vlc, "drawabler", VLC_VAR_INTEGER );
    var_Create( p_vlc, "drawablex", VLC_VAR_INTEGER );
    var_Create( p_vlc, "drawabley", VLC_VAR_INTEGER );
    var_Create( p_vlc, "drawablew", VLC_VAR_INTEGER );
    var_Create( p_vlc, "drawableh", VLC_VAR_INTEGER );
    var_Create( p_vlc, "drawableportx", VLC_VAR_INTEGER );
    var_Create( p_vlc, "drawableporty", VLC_VAR_INTEGER );
723

724 725 726 727 728
    /*
     * Get input filenames given as commandline arguments
     */
    GetFilenames( p_vlc, i_argc, ppsz_argv );

Gildas Bazin's avatar
 
Gildas Bazin committed
729
    if( i_object ) vlc_object_release( p_vlc );
730 731 732 733
    return VLC_SUCCESS;
}

/*****************************************************************************
Sam Hocevar's avatar
Sam Hocevar committed
734
 * VLC_AddIntf: add an interface
735 736
 *****************************************************************************
 * This function opens an interface plugin and runs it. If b_block is set
Sam Hocevar's avatar
Sam Hocevar committed
737 738
 * 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
739 740
 * user requests to quit. If b_play is set to 1, VLC_AddIntf will start playing
 * the playlist when it is completely initialised.
741
 *****************************************************************************/
742 743
int VLC_AddIntf( int i_object, char const *psz_module,
                 vlc_bool_t b_block, vlc_bool_t b_play )
744
{
Sam Hocevar's avatar
Sam Hocevar committed
745
    int i_err;
746
    intf_thread_t *p_intf;
747
    vlc_t *p_vlc = vlc_current_object( i_object );
Sam Hocevar's avatar
Sam Hocevar committed
748

749
    if( !p_vlc )
750
    {
751
        return VLC_ENOOBJ;
752 753
    }

Gildas Bazin's avatar
Gildas Bazin committed
754 755 756 757 758 759 760 761 762 763 764
#ifndef WIN32
    if( p_vlc->p_libvlc->b_daemon && b_block && !psz_module )
    {
        /* Daemon mode hack.
         * We prefer the dummy interface if none is specified. */
        char *psz_interface = config_GetPsz( p_vlc, "intf" );
        if( !psz_interface || !*psz_interface ) psz_module = "dummy";
        if( psz_interface ) free( psz_interface );
    }
#endif

765
    /* Try to create the interface */
766
    p_intf = intf_Create( p_vlc, psz_module ? psz_module : "$intf" );
767 768 769

    if( p_intf == NULL )
    {
Gildas Bazin's avatar
 
Gildas Bazin committed
770
        msg_Err( p_vlc, "interface \"%s\" initialization failed", psz_module );
Gildas Bazin's avatar
 
Gildas Bazin committed
771
        if( i_object ) vlc_object_release( p_vlc );
772 773 774
        return VLC_EGENERIC;
    }

775 776 777
    /* Interface doesn't handle play on start so do it ourselves */
    if( !p_intf->b_play && b_play ) VLC_Play( i_object );

778
    /* Try to run the interface */
779
    p_intf->b_play = b_play;
780
    p_intf->b_block = b_block;
Sam Hocevar's avatar
Sam Hocevar committed
781 782
    i_err = intf_RunThread( p_intf );
    if( i_err )
783
    {
784
        vlc_object_detach( p_intf );
785
        intf_Destroy( p_intf );
Gildas Bazin's avatar
 
Gildas Bazin committed
786
        if( i_object ) vlc_object_release( p_vlc );
Sam Hocevar's avatar
Sam Hocevar committed
787
        return i_err;
788 789
    }

Gildas Bazin's avatar
 
Gildas Bazin committed
790
    if( i_object ) vlc_object_release( p_vlc );
791 792 793 794
    return VLC_SUCCESS;
}

/*****************************************************************************
Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 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 892 893 894 895 896
 * VLC_Die: ask vlc to die.
 *****************************************************************************
 * This function sets p_vlc->b_die to VLC_TRUE, but does not do any other
 * task. It is your duty to call VLC_CleanUp and VLC_Destroy afterwards.
 *****************************************************************************/
int VLC_Die( int i_object )
{
    vlc_t *p_vlc = vlc_current_object( i_object );

    if( !p_vlc )
    {
        return VLC_ENOOBJ;
    }

    p_vlc->b_die = VLC_TRUE;

    if( i_object ) vlc_object_release( p_vlc );
    return VLC_SUCCESS;
}

/*****************************************************************************
 * VLC_CleanUp: CleanUp all the intf, playlist, vout, aout
 *****************************************************************************/
int VLC_CleanUp( int i_object )
{
    intf_thread_t      * p_intf;
    playlist_t         * p_playlist;
    vout_thread_t      * p_vout;
    aout_instance_t    * p_aout;
    announce_handler_t * p_announce;
    vlc_t *p_vlc = vlc_current_object( i_object );

    /* Check that the handle is valid */
    if( !p_vlc )
    {
        return VLC_ENOOBJ;
    }

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

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

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

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

    /*
     * Free announce handler(s?)
     */
    msg_Dbg( p_vlc, "removing announce handler" );
    while( (p_announce = vlc_object_find( p_vlc, VLC_OBJECT_ANNOUNCE,
                                                 FIND_CHILD ) ) )
   {
        vlc_object_detach( p_announce );
        vlc_object_release( p_announce );
        announce_HandlerDestroy( p_announce );
   }

    if( i_object ) vlc_object_release( p_vlc );
    return VLC_SUCCESS;
}

/*****************************************************************************
 * VLC_Destroy: Destroy everything.
897
 *****************************************************************************
898
 * This function requests the running threads to finish, waits for their
899 900
 * termination, and destroys their structure.
 *****************************************************************************/
Sam Hocevar's avatar
Sam Hocevar committed
901
int VLC_Destroy( int i_object )
902
{
903
    vlc_t *p_vlc = vlc_current_object( i_object );
904

905
    if( !p_vlc )
906
    {
907
        return VLC_ENOOBJ;
908 909
    }

910 911 912 913 914 915 916
    /*
     * Free allocated memory
     */
    if( p_vlc->p_memcpy_module )
    {
        module_Unneed( p_vlc, p_vlc->p_memcpy_module );
        p_vlc->p_memcpy_module = NULL;
917 918
    }

919
    /*
920
     * Free module bank !
921 922 923
     */
    module_EndBank( p_vlc );

924 925 926 927 928
    if( p_vlc->psz_homedir )
    {
        free( p_vlc->psz_homedir );
        p_vlc->psz_homedir = NULL;
    }
929

Gildas Bazin's avatar
 
Gildas Bazin committed
930 931 932 933 934 935
    if( p_vlc->psz_configfile )
    {
        free( p_vlc->psz_configfile );
        p_vlc->psz_configfile = NULL;
    }

936 937 938 939 940 941
    if( p_vlc->p_hotkeys )
    {
        free( p_vlc->p_hotkeys );
        p_vlc->p_hotkeys = NULL;
    }

942 943 944 945
    /*
     * System specific cleaning code
     */
    system_End( p_vlc );
946

947 948 949
    /* Destroy mutexes */
    vlc_mutex_destroy( &p_vlc->config_lock );

950 951
    vlc_object_detach( p_vlc );

952 953 954
    /* Release object before destroying it */
    if( i_object ) vlc_object_release( p_vlc );

955 956
    vlc_object_destroy( p_vlc );

957
    /* Stop thread system: last one out please shut the door! */
958
    vlc_threads_end( p_libvlc );
959

960 961 962
    return VLC_SUCCESS;
}

963
/*****************************************************************************
964
 * VLC_VariableSet: set a vlc variable
965
 *****************************************************************************/
966
int VLC_VariableSet( int i_object, char const *psz_var, vlc_value_t value )
967
{
968
    vlc_t *p_vlc = vlc_current_object( i_object );
Gildas Bazin's avatar
 
Gildas Bazin committed
969
    int i_ret;
970 971 972

    if( !p_vlc )
    {
973
        return VLC_ENOOBJ;
974 975
    }

Sam Hocevar's avatar
Sam Hocevar committed
976 977 978
    /* 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 ) )
979
    {
Sam Hocevar's avatar
Sam Hocevar committed
980
        module_config_t *p_item;
981
        char const *psz_newvar = psz_var + 6;
982

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

Sam Hocevar's avatar
Sam Hocevar committed
985
        if( p_item )
986
        {
Sam Hocevar's avatar
Sam Hocevar committed
987
            switch( p_item->i_type )
988
            {
Sam Hocevar's avatar
Sam Hocevar committed
989 990 991 992 993 994 995 996 997 998 999 1000
                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;
1001
            }
Gildas Bazin's avatar
 
Gildas Bazin committed
1002
            if( i_object ) vlc_object_release( p_vlc );
Sam Hocevar's avatar
Sam Hocevar committed
1003
            return VLC_SUCCESS;
1004 1005 1006
        }
    }

Gildas Bazin's avatar
 
Gildas Bazin committed
1007 1008 1009 1010
    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
1011 1012 1013
}

/*****************************************************************************
1014
 * VLC_VariableGet: get a vlc variable
Sam Hocevar's avatar
Sam Hocevar committed
1015
 *****************************************************************************/
1016
int VLC_VariableGet( int i_object, char const *psz_var, vlc_value_t *p_value )
Sam Hocevar's avatar
Sam Hocevar committed
1017
{
1018
    vlc_t *p_vlc = vlc_current_object( i_object );
Gildas Bazin's avatar
 
Gildas Bazin committed
1019
    int i_ret;
Sam Hocevar's avatar
Sam Hocevar committed
1020 1021

    if( !p_vlc )
1022
    {
1023
        return VLC_ENOOBJ;
1024 1025
    }

1026
    i_ret = var_Get( p_vlc , psz_var, p_value );
Gildas Bazin's avatar
 
Gildas Bazin committed
1027 1028 1029

    if( i_object ) vlc_object_release( p_vlc );
    return i_ret;
1030 1031
}

1032
/*****************************************************************************
Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
1033 1034 1035 1036
 * VLC_AddTarget: adds a target for playing.
 *****************************************************************************
 * This function adds psz_target to the current playlist. If a playlist does
 * not exist, it will create one.
1037
 *****************************************************************************/
Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
1038 1039 1040
int VLC_AddTarget( int i_object, char const *psz_target,
                   char const **ppsz_options, int i_options,
                   int i_mode, int i_pos )
1041
{
Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
1042 1043
    int i_err;
    playlist_t *p_playlist;
1044 1045 1046 1047 1048 1049 1050
    vlc_t *p_vlc = vlc_current_object( i_object );

    if( !p_vlc )
    {
        return VLC_ENOOBJ;
    }

Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
1051
    p_playlist = vlc_object_find( p_vlc, VLC_OBJECT_PLAYLIST, FIND_ANYWHERE );
1052

Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
1053
    if( p_playlist == NULL )
1054
    {
Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
1055 1056 1057 1058 1059 1060 1061 1062 1063 1064
        msg_Dbg( p_vlc, "no playlist present, creating one" );
        p_playlist = playlist_Create( p_vlc );

        if( p_playlist == NULL )
        {
            if( i_object ) vlc_object_release( p_vlc );
            return VLC_EGENERIC;
        }

        vlc_object_yield( p_playlist );
1065 1066
    }

Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
1067 1068
    i_err = playlist_AddExt( p_playlist, psz_target, psz_target,
                             i_mode, i_pos, -1, ppsz_options, i_options);
1069 1070 1071 1072

    vlc_object_release( p_playlist );

    if( i_object ) vlc_object_release( p_vlc );
Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
1073
    return i_err;
1074 1075 1076
}

/*****************************************************************************
Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
1077
 * VLC_Play: play
1078
 *****************************************************************************/
Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
1079
int VLC_Play( int i_object )
1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097
{
    playlist_t * p_playlist;
    vlc_t *p_vlc = vlc_current_object( i_object );

    /* Check that the handle is valid */
    if( !p_vlc )
    {
        return VLC_ENOOBJ;
    }

    p_playlist = vlc_object_find( p_vlc, VLC_OBJECT_PLAYLIST, FIND_CHILD );

    if( !p_playlist )
    {
        if( i_object ) vlc_object_release( p_vlc );
        return VLC_ENOOBJ;
    }

Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
1098
    playlist_Play( p_playlist );
1099 1100 1101
    vlc_object_release( p_playlist );

    if( i_object ) vlc_object_release( p_vlc );
Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
1102
    return VLC_SUCCESS;
1103 1104
}

1105
/*****************************************************************************
Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
1106
 * VLC_Pause: toggle pause
1107
 *****************************************************************************/
Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
1108
int VLC_Pause( int i_object )
1109 1110
{
    playlist_t * p_playlist;
1111
    vlc_t *p_vlc = vlc_current_object( i_object );
1112 1113

    /* Check that the handle is valid */
1114
    if( !p_vlc )
1115
    {
1116
        return VLC_ENOOBJ;
1117
    }
1118

1119 1120 1121 1122
    p_playlist = vlc_object_find( p_vlc, VLC_OBJECT_PLAYLIST, FIND_CHILD );

    if( !p_playlist )
    {
Gildas Bazin's avatar
 
Gildas Bazin committed
1123
        if( i_object ) vlc_object_release( p_vlc );
1124
        return VLC_ENOOBJ;
1125 1126
    }

Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
1127
    playlist_Pause( p_playlist );
1128 1129
    vlc_object_release( p_playlist );

Gildas Bazin's avatar
 
Gildas Bazin committed
1130
    if( i_object ) vlc_object_release( p_vlc );
Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
1131
    return VLC_SUCCESS;
1132 1133 1134
}

/*****************************************************************************
Derk-Jan Hartman's avatar
Derk-Jan Hartman committed
1135
 * VLC_Pause: toggle pause
1136
 *****************************************************************************/
Sam Hocevar's avatar
Sam Hocevar committed
1137
int VLC_Stop( int i_object )