* ALL: the first libvlc commit.
As for video output 4, this breaks almost everything, but I'll slowly
do what remains to be fixed during the weekend.
Changes in vlc:
===============
* vlc is now a very small program (20 lines) which uses the libvlc API;
it is quite simple for the moment but can be extended in the future.
* interfaces, decoders, video outputs, etc. are now almost the same
objects (yes, I know, this is C++ redone in C) and are structured in
a tree. More about this later, but basically it allows the following
nice features:
- several interfaces
- several playlists with several outputs
- input plugins spawning helper interfaces (will be used for DVD menus)
- anything spawning anything; I swear there are useful uses for this!
* libvlc can be used in other programs; I'm currently writing a Mozilla
plugin for my employer.
Things currently broken:
========================
* most interfaces, most ports
* the playlist handling (almost finished rewriting this though). This means
no file can be played from the GUI, you need to use the commandline. This
also means it segfaults at EOF, when exiting the program, and it sometimes
refuses to open a file when asked to.
2002-06-01 14:32:02 +02:00
|
|
|
/*****************************************************************************
|
2006-12-01 21:13:46 +01:00
|
|
|
* libvlc.h: Internal libvlc generic/misc declaration
|
* ALL: the first libvlc commit.
As for video output 4, this breaks almost everything, but I'll slowly
do what remains to be fixed during the weekend.
Changes in vlc:
===============
* vlc is now a very small program (20 lines) which uses the libvlc API;
it is quite simple for the moment but can be extended in the future.
* interfaces, decoders, video outputs, etc. are now almost the same
objects (yes, I know, this is C++ redone in C) and are structured in
a tree. More about this later, but basically it allows the following
nice features:
- several interfaces
- several playlists with several outputs
- input plugins spawning helper interfaces (will be used for DVD menus)
- anything spawning anything; I swear there are useful uses for this!
* libvlc can be used in other programs; I'm currently writing a Mozilla
plugin for my employer.
Things currently broken:
========================
* most interfaces, most ports
* the playlist handling (almost finished rewriting this though). This means
no file can be played from the GUI, you need to use the commandline. This
also means it segfaults at EOF, when exiting the program, and it sometimes
refuses to open a file when asked to.
2002-06-01 14:32:02 +02:00
|
|
|
*****************************************************************************
|
2007-05-20 15:35:37 +02:00
|
|
|
* Copyright (C) 1999, 2000, 2001, 2002 the VideoLAN team
|
2007-05-20 00:02:15 +02:00
|
|
|
* Copyright © 2006-2007 Rémi Denis-Courmont
|
2004-03-05 20:24:14 +01:00
|
|
|
* $Id$
|
* ALL: the first libvlc commit.
As for video output 4, this breaks almost everything, but I'll slowly
do what remains to be fixed during the weekend.
Changes in vlc:
===============
* vlc is now a very small program (20 lines) which uses the libvlc API;
it is quite simple for the moment but can be extended in the future.
* interfaces, decoders, video outputs, etc. are now almost the same
objects (yes, I know, this is C++ redone in C) and are structured in
a tree. More about this later, but basically it allows the following
nice features:
- several interfaces
- several playlists with several outputs
- input plugins spawning helper interfaces (will be used for DVD menus)
- anything spawning anything; I swear there are useful uses for this!
* libvlc can be used in other programs; I'm currently writing a Mozilla
plugin for my employer.
Things currently broken:
========================
* most interfaces, most ports
* the playlist handling (almost finished rewriting this though). This means
no file can be played from the GUI, you need to use the commandline. This
also means it segfaults at EOF, when exiting the program, and it sometimes
refuses to open a file when asked to.
2002-06-01 14:32:02 +02:00
|
|
|
*
|
2007-05-20 15:35:37 +02:00
|
|
|
* Authors: Vincent Seguin <seguin@via.ecp.fr>
|
|
|
|
*
|
* ALL: the first libvlc commit.
As for video output 4, this breaks almost everything, but I'll slowly
do what remains to be fixed during the weekend.
Changes in vlc:
===============
* vlc is now a very small program (20 lines) which uses the libvlc API;
it is quite simple for the moment but can be extended in the future.
* interfaces, decoders, video outputs, etc. are now almost the same
objects (yes, I know, this is C++ redone in C) and are structured in
a tree. More about this later, but basically it allows the following
nice features:
- several interfaces
- several playlists with several outputs
- input plugins spawning helper interfaces (will be used for DVD menus)
- anything spawning anything; I swear there are useful uses for this!
* libvlc can be used in other programs; I'm currently writing a Mozilla
plugin for my employer.
Things currently broken:
========================
* most interfaces, most ports
* the playlist handling (almost finished rewriting this though). This means
no file can be played from the GUI, you need to use the commandline. This
also means it segfaults at EOF, when exiting the program, and it sometimes
refuses to open a file when asked to.
2002-06-01 14:32:02 +02:00
|
|
|
* 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
|
2006-01-13 00:10:04 +01:00
|
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
|
* ALL: the first libvlc commit.
As for video output 4, this breaks almost everything, but I'll slowly
do what remains to be fixed during the weekend.
Changes in vlc:
===============
* vlc is now a very small program (20 lines) which uses the libvlc API;
it is quite simple for the moment but can be extended in the future.
* interfaces, decoders, video outputs, etc. are now almost the same
objects (yes, I know, this is C++ redone in C) and are structured in
a tree. More about this later, but basically it allows the following
nice features:
- several interfaces
- several playlists with several outputs
- input plugins spawning helper interfaces (will be used for DVD menus)
- anything spawning anything; I swear there are useful uses for this!
* libvlc can be used in other programs; I'm currently writing a Mozilla
plugin for my employer.
Things currently broken:
========================
* most interfaces, most ports
* the playlist handling (almost finished rewriting this though). This means
no file can be played from the GUI, you need to use the commandline. This
also means it segfaults at EOF, when exiting the program, and it sometimes
refuses to open a file when asked to.
2002-06-01 14:32:02 +02:00
|
|
|
*****************************************************************************/
|
|
|
|
|
2006-12-01 21:13:46 +01:00
|
|
|
#ifndef LIBVLC_LIBVLC_H
|
|
|
|
# define LIBVLC_LIBVLC_H 1
|
2002-06-01 19:09:25 +02:00
|
|
|
|
2006-12-01 21:13:46 +01:00
|
|
|
extern const char vlc_usage[];
|
2006-01-09 23:01:57 +01:00
|
|
|
|
2008-03-26 21:20:47 +01:00
|
|
|
/* Hotkey stuff */
|
2006-12-01 21:13:46 +01:00
|
|
|
extern const struct hotkey libvlc_hotkeys[];
|
|
|
|
extern const size_t libvlc_hotkeys_size;
|
2008-03-26 21:20:47 +01:00
|
|
|
extern int vlc_key_to_action (vlc_object_t *, const char *,
|
|
|
|
vlc_value_t, vlc_value_t, void *);
|
2007-08-16 21:34:26 +02:00
|
|
|
|
2008-02-25 20:48:50 +01:00
|
|
|
/*
|
|
|
|
* OS-specific initialization
|
|
|
|
*/
|
|
|
|
void system_Init ( libvlc_int_t *, int *, const char *[] );
|
|
|
|
void system_Configure ( libvlc_int_t *, int *, const char *[] );
|
|
|
|
void system_End ( libvlc_int_t * );
|
|
|
|
|
2007-08-16 21:34:26 +02:00
|
|
|
/*
|
|
|
|
* Threads subsystem
|
|
|
|
*/
|
2008-05-03 11:21:11 +02:00
|
|
|
int vlc_threads_init( void );
|
|
|
|
void vlc_threads_end( void );
|
2008-05-28 20:52:17 +02:00
|
|
|
vlc_object_t *vlc_threadobj (void);
|
2008-06-04 19:16:47 +02:00
|
|
|
#ifdef LIBVLC_REFCHECK
|
2008-05-28 21:32:25 +02:00
|
|
|
void vlc_refcheck (vlc_object_t *obj);
|
|
|
|
#else
|
|
|
|
# define vlc_refcheck( obj ) (void)0
|
|
|
|
#endif
|
2007-08-16 21:34:26 +02:00
|
|
|
|
|
|
|
/*
|
|
|
|
* CPU capabilities
|
|
|
|
*/
|
|
|
|
extern uint32_t cpu_flags;
|
|
|
|
uint32_t CPUCapabilities( void );
|
|
|
|
|
2008-05-04 20:09:09 +02:00
|
|
|
/*
|
|
|
|
* Message/logging stuff
|
|
|
|
*/
|
|
|
|
|
|
|
|
typedef struct msg_queue_t
|
|
|
|
{
|
|
|
|
/** Message queue lock */
|
|
|
|
vlc_mutex_t lock;
|
|
|
|
bool b_overflow;
|
|
|
|
|
|
|
|
/* Message queue */
|
|
|
|
msg_item_t msg[VLC_MSG_QSIZE]; /**< message queue */
|
|
|
|
int i_start;
|
|
|
|
int i_stop;
|
|
|
|
|
|
|
|
/* Subscribers */
|
|
|
|
int i_sub;
|
|
|
|
msg_subscription_t **pp_sub;
|
|
|
|
|
|
|
|
/* Logfile for WinCE */
|
|
|
|
#ifdef UNDER_CE
|
|
|
|
FILE *logfile;
|
|
|
|
#endif
|
|
|
|
} msg_queue_t;
|
|
|
|
|
|
|
|
/**
|
2008-05-10 11:29:25 +02:00
|
|
|
* Store all data required by messages interfaces.
|
2008-05-04 20:09:09 +02:00
|
|
|
*/
|
|
|
|
typedef struct msg_bank_t
|
|
|
|
{
|
|
|
|
vlc_mutex_t lock;
|
2008-05-10 11:57:12 +02:00
|
|
|
msg_queue_t queue;
|
2008-05-04 20:09:09 +02:00
|
|
|
} msg_bank_t;
|
|
|
|
|
2008-05-10 11:29:25 +02:00
|
|
|
void msg_Create (libvlc_int_t *);
|
|
|
|
void msg_Flush (libvlc_int_t *);
|
|
|
|
void msg_Destroy (libvlc_int_t *);
|
|
|
|
|
|
|
|
/** Internal message stack context */
|
|
|
|
typedef struct
|
|
|
|
{
|
|
|
|
int i_code;
|
|
|
|
char * psz_message;
|
|
|
|
} msg_context_t;
|
|
|
|
|
|
|
|
void msg_StackSet ( int, const char*, ... );
|
|
|
|
void msg_StackAdd ( const char*, ... );
|
|
|
|
const char* msg_StackMsg ( void );
|
2008-05-10 22:22:13 +02:00
|
|
|
/** The global thread var for msg stack context
|
|
|
|
* We store this as a static global variable so we don't need a vlc_object_t
|
|
|
|
* everywhere.
|
|
|
|
* This key is created in vlc_threads_init and is therefore ready to use at
|
|
|
|
* the very beginning of the universe */
|
|
|
|
extern vlc_threadvar_t msg_context_global_key;
|
|
|
|
void msg_StackDestroy (void *);
|
2008-05-10 11:29:25 +02:00
|
|
|
|
2007-08-16 21:59:55 +02:00
|
|
|
/*
|
|
|
|
* Unicode stuff
|
|
|
|
*/
|
2008-05-24 09:55:10 +02:00
|
|
|
char *vlc_fix_readdir (const char *);
|
2008-05-24 09:56:20 +02:00
|
|
|
bool vlc_current_charset (char **);
|
2007-08-16 21:34:26 +02:00
|
|
|
|
|
|
|
/*
|
|
|
|
* LibVLC objects stuff
|
|
|
|
*/
|
|
|
|
|
2008-03-25 22:08:20 +01:00
|
|
|
/**
|
|
|
|
* Creates a VLC object.
|
|
|
|
*
|
|
|
|
* Note that because the object name pointer must remain valid, potentially
|
|
|
|
* even after the destruction of the object (through the message queues), this
|
|
|
|
* function CANNOT be exported to plugins as is. In this case, the old
|
|
|
|
* vlc_object_create() must be used instead.
|
|
|
|
*
|
|
|
|
* @param p_this an existing VLC object
|
|
|
|
* @param i_size byte size of the object structure
|
|
|
|
* @param i_type object type, usually VLC_OBJECT_CUSTOM
|
|
|
|
* @param psz_type object type name
|
|
|
|
* @return the created object, or NULL.
|
|
|
|
*/
|
2008-03-29 10:27:56 +01:00
|
|
|
extern void *
|
2006-12-01 21:26:05 +01:00
|
|
|
vlc_custom_create (vlc_object_t *p_this, size_t i_size, int i_type,
|
|
|
|
const char *psz_type);
|
|
|
|
|
2008-05-04 18:48:59 +02:00
|
|
|
/**
|
2007-05-20 00:02:15 +02:00
|
|
|
* libvlc_global_data_t (global variable)
|
2008-05-04 18:48:59 +02:00
|
|
|
*
|
|
|
|
* This structure has an unique instance, statically allocated in libvlc and
|
|
|
|
* never accessed from the outside. It stores process-wide VLC variables,
|
|
|
|
* mostly process-wide locks, and (currently) the module bank and objects tree.
|
|
|
|
*/
|
|
|
|
typedef struct libvlc_global_data_t
|
2007-05-20 00:02:15 +02:00
|
|
|
{
|
|
|
|
VLC_COMMON_MEMBERS
|
|
|
|
|
2008-05-22 17:52:50 +02:00
|
|
|
/* Object structure data */
|
2007-05-20 00:02:15 +02:00
|
|
|
int i_counter; ///< object counter
|
|
|
|
|
|
|
|
module_bank_t * p_module_bank; ///< The module bank
|
|
|
|
|
|
|
|
char * psz_vlcpath;
|
2008-05-04 18:48:59 +02:00
|
|
|
} libvlc_global_data_t;
|
2007-05-20 00:02:15 +02:00
|
|
|
|
2007-08-16 21:59:55 +02:00
|
|
|
|
2007-08-16 19:42:35 +02:00
|
|
|
libvlc_global_data_t *vlc_global (void);
|
2007-05-20 00:02:15 +02:00
|
|
|
|
2008-05-04 19:26:07 +02:00
|
|
|
/**
|
|
|
|
* Private LibVLC data for each object.
|
|
|
|
*/
|
2007-08-16 17:43:28 +02:00
|
|
|
struct vlc_object_internals_t
|
|
|
|
{
|
2007-08-16 20:01:01 +02:00
|
|
|
/* Object variables */
|
2007-08-16 21:21:41 +02:00
|
|
|
variable_t * p_vars;
|
2007-08-16 20:01:01 +02:00
|
|
|
vlc_mutex_t var_lock;
|
|
|
|
int i_vars;
|
2007-08-16 21:21:41 +02:00
|
|
|
|
|
|
|
/* Thread properties, if any */
|
2007-09-16 12:49:43 +02:00
|
|
|
vlc_thread_t thread_id;
|
2008-05-03 08:54:59 +02:00
|
|
|
bool b_thread;
|
2007-08-19 19:15:11 +02:00
|
|
|
|
2007-09-30 21:31:08 +02:00
|
|
|
/* Objects thread synchronization */
|
2008-06-17 21:33:26 +02:00
|
|
|
vlc_mutex_t lock;
|
|
|
|
vlc_cond_t wait;
|
2007-09-30 21:31:08 +02:00
|
|
|
int pipes[2];
|
2008-01-21 21:22:46 +01:00
|
|
|
vlc_spinlock_t spin;
|
2007-09-30 21:31:08 +02:00
|
|
|
|
2007-08-19 19:15:11 +02:00
|
|
|
/* Objects management */
|
2008-05-07 22:12:52 +02:00
|
|
|
vlc_spinlock_t ref_spin;
|
2008-03-18 23:23:23 +01:00
|
|
|
unsigned i_refcount;
|
|
|
|
vlc_destructor_t pf_destructor;
|
2008-06-04 19:16:47 +02:00
|
|
|
#ifndef LIBVLC_REFCHECK
|
2008-05-30 17:14:25 +02:00
|
|
|
vlc_thread_t creator_id;
|
|
|
|
#endif
|
2008-05-16 16:59:03 +02:00
|
|
|
|
2008-05-28 19:22:34 +02:00
|
|
|
/* Objects tree structure */
|
|
|
|
vlc_object_t *prev, *next;
|
2008-05-16 16:59:03 +02:00
|
|
|
vlc_object_t **pp_children;
|
|
|
|
int i_children;
|
2007-08-16 17:43:28 +02:00
|
|
|
};
|
|
|
|
|
2008-02-29 15:29:40 +01:00
|
|
|
#define ZOOM_SECTION N_("Zoom")
|
|
|
|
#define ZOOM_QUARTER_KEY_TEXT N_("1:4 Quarter")
|
|
|
|
#define ZOOM_HALF_KEY_TEXT N_("1:2 Half")
|
|
|
|
#define ZOOM_ORIGINAL_KEY_TEXT N_("1:1 Original")
|
|
|
|
#define ZOOM_DOUBLE_KEY_TEXT N_("2:1 Double")
|
2007-08-16 20:01:01 +02:00
|
|
|
|
2008-05-28 19:21:27 +02:00
|
|
|
#define vlc_internals( obj ) (((vlc_object_internals_t*)(VLC_OBJECT(obj)))-1)
|
2007-08-16 17:43:28 +02:00
|
|
|
|
2008-06-17 21:33:26 +02:00
|
|
|
/* Signal an object without checking for locking consistency. This is wrong. */
|
|
|
|
#ifdef __GNUC__
|
|
|
|
__attribute__((deprecated))
|
|
|
|
#endif
|
|
|
|
static inline void
|
|
|
|
vlc_object_signal_maybe (vlc_object_t *p_this)
|
|
|
|
{
|
|
|
|
vlc_cond_signal (&(vlc_internals(p_this)->wait));
|
|
|
|
}
|
|
|
|
|
2008-05-04 19:26:07 +02:00
|
|
|
/**
|
|
|
|
* Private LibVLC instance data.
|
|
|
|
*/
|
|
|
|
typedef struct libvlc_priv_t
|
|
|
|
{
|
2008-05-04 20:17:04 +02:00
|
|
|
/* Configuration */
|
2008-05-04 19:26:07 +02:00
|
|
|
vlc_mutex_t config_lock; ///< config file lock
|
2008-05-04 20:17:04 +02:00
|
|
|
char * psz_configfile; ///< location of config file
|
2008-05-04 19:26:07 +02:00
|
|
|
|
2008-05-05 21:17:20 +02:00
|
|
|
/* There is no real reason to keep a list of items, but not to break
|
|
|
|
* everything, let's keep it */
|
|
|
|
input_item_array_t input_items; ///< Array of all created input items
|
|
|
|
int i_last_input_id ; ///< Last id of input item
|
|
|
|
|
2008-05-04 20:09:09 +02:00
|
|
|
/* Messages */
|
|
|
|
msg_bank_t msg_bank; ///< The message bank
|
|
|
|
int i_verbose; ///< info messages
|
|
|
|
bool b_color; ///< color messages?
|
|
|
|
|
|
|
|
/* Timer stats */
|
2008-05-04 19:26:07 +02:00
|
|
|
vlc_mutex_t timer_lock; ///< Lock to protect timers
|
|
|
|
counter_t **pp_timers; ///< Array of all timers
|
|
|
|
int i_timers; ///< Number of timers
|
|
|
|
bool b_stats; ///< Whether to collect stats
|
2008-05-04 19:34:54 +02:00
|
|
|
|
2008-05-04 20:36:25 +02:00
|
|
|
void *p_stats_computer; ///< Input thread computing stats
|
|
|
|
/// (needs cleanup)
|
|
|
|
|
2008-05-04 19:34:54 +02:00
|
|
|
module_t *p_memcpy_module; ///< Fast memcpy plugin used
|
2008-05-07 21:26:56 +02:00
|
|
|
playlist_t *p_playlist; //< the playlist singleton
|
|
|
|
vlm_t *p_vlm; ///< the VLM singleton (or NULL)
|
2008-06-21 10:57:48 +02:00
|
|
|
interaction_t *p_interaction; ///< interface interaction object
|
2008-05-04 19:37:05 +02:00
|
|
|
httpd_t *p_httpd; ///< HTTP daemon (src/network/httpd.c)
|
2008-06-04 20:13:47 +02:00
|
|
|
|
|
|
|
/* Private playlist data (FIXME - playlist_t is too public...) */
|
|
|
|
sout_instance_t *p_sout; ///< kept sout instance (for playlist)
|
2008-05-04 19:26:07 +02:00
|
|
|
} libvlc_priv_t;
|
|
|
|
|
|
|
|
static inline libvlc_priv_t *libvlc_priv (libvlc_int_t *libvlc)
|
|
|
|
{
|
|
|
|
return (libvlc_priv_t *)(libvlc + 1);
|
|
|
|
}
|
|
|
|
|
2008-06-12 21:01:16 +02:00
|
|
|
void playlist_ServicesDiscoveryKillAll( playlist_t *p_playlist );
|
|
|
|
|
2008-05-07 19:58:25 +02:00
|
|
|
#define libvlc_stats( o ) (libvlc_priv((VLC_OBJECT(o))->p_libvlc)->b_stats)
|
2008-05-04 19:26:07 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* LibVLC "main module" configuration settings array.
|
|
|
|
*/
|
2007-12-18 19:56:58 +01:00
|
|
|
extern module_config_t libvlc_config[];
|
2007-12-09 20:55:16 +01:00
|
|
|
extern const size_t libvlc_config_count;
|
|
|
|
|
2008-02-21 19:46:02 +01:00
|
|
|
/*
|
|
|
|
* Variables stuff
|
|
|
|
*/
|
2008-03-17 18:57:33 +01:00
|
|
|
void var_OptionParse (vlc_object_t *, const char *, bool trusted);
|
2008-02-21 19:46:02 +01:00
|
|
|
|
2008-05-24 10:04:59 +02:00
|
|
|
/*
|
|
|
|
* Replacement functions
|
|
|
|
*/
|
|
|
|
# ifndef HAVE_DIRENT_H
|
|
|
|
typedef void DIR;
|
|
|
|
# ifndef FILENAME_MAX
|
|
|
|
# define FILENAME_MAX (260)
|
|
|
|
# endif
|
|
|
|
struct dirent
|
|
|
|
{
|
|
|
|
long d_ino; /* Always zero. */
|
|
|
|
unsigned short d_reclen; /* Always zero. */
|
|
|
|
unsigned short d_namlen; /* Length of name in d_name. */
|
|
|
|
char d_name[FILENAME_MAX]; /* File name. */
|
|
|
|
};
|
|
|
|
# define opendir vlc_opendir
|
|
|
|
# define readdir vlc_readdir
|
|
|
|
# define closedir vlc_closedir
|
|
|
|
# define rewinddir vlc_rewindir
|
|
|
|
void *vlc_opendir (const char *);
|
|
|
|
void *vlc_readdir (void *);
|
|
|
|
int vlc_closedir(void *);
|
|
|
|
void vlc_rewinddir(void *);
|
|
|
|
# endif
|
|
|
|
|
2008-05-24 10:18:51 +02:00
|
|
|
#if defined (WIN32)
|
|
|
|
# include <dirent.h>
|
|
|
|
void *vlc_wopendir (const wchar_t *);
|
2008-05-28 01:20:20 +02:00
|
|
|
/* void *vlc_wclosedir (void *); in vlc's exported symbols */
|
2008-05-24 10:18:51 +02:00
|
|
|
struct _wdirent *vlc_wreaddir (void *);
|
|
|
|
void vlc_rewinddir (void *);
|
|
|
|
# define _wopendir vlc_wopendir
|
|
|
|
# define _wreaddir vlc_wreaddir
|
|
|
|
# define _wclosedir vlc_wclosedir
|
|
|
|
# define rewinddir vlc_rewinddir
|
|
|
|
#endif
|
|
|
|
|
2002-07-31 22:56:53 +02:00
|
|
|
#endif
|