* libvlc.h: main libvlc header
*****************************************************************************
* Copyright (C) 1998-2002 VideoLAN
- * $Id: libvlc.h,v 1.121 2003/12/12 23:03:35 yoann Exp $
+ * $Id: libvlc.h,v 1.127 2003/12/24 12:38:04 gbazin Exp $
*
* Authors: Vincent Seguin <seguin@via.ecp.fr>
* Samuel Hocevar <sam@zoy.org>
"fr", "hu", "it", "ja", "nl", "no",
"pl", "pt_BR", "ru", "sv" };
static char *ppsz_language_text[] =
-{ N_("Auto"), N_("English US"), N_("English GB"), N_("Spanish"), N_("German"),
+{ N_("Auto"), N_("American"), N_("British"), N_("Spanish"), N_("German"),
N_("French"), N_("Hungarian"), N_("Italian"), N_("Japanese"), N_("Dutch"), N_("Norwegian"),
- N_("Polish"), N_("Portuguese BR"), N_("Russian"), N_("Swedish") };
+ N_("Polish"), N_("Brazilian"), N_("Russian"), N_("Swedish") };
/*****************************************************************************
* Configuration options for the main program. Each module will also separatly
"This option allows you to delay the audio output. This can be handy if " \
"you notice a lag between the video and the audio.")
-#define MULTICHA_TEXT N_("Choose prefered audio output channels mode")
+#define MULTICHA_TEXT N_("Choose preferred audio output channels mode")
#define MULTICHA_LONGTEXT N_( \
"This option allows you to set the audio output channels mode that will " \
"be used by default when possible (ie. if your hardware supports it as " \
"This allows you to add audio postprocessing filters, to modify " \
"the sound.")
-#define HEADPHONE_TEXT N_("Headphone virtual spatialization effect")
-#define HEADPHONE_LONGTEXT N_( \
- "This effect gives you the feeling that you are standing in a room " \
- "with a complete 5.1 speaker set when using only a headphone, " \
- "providing a more realistic sound experience. It should also be " \
- "more comfortable and less tiring when listening to music for " \
- "long periods of time.\nIt works with any source format from mono " \
- "to 5.1.")
+#define AUDIO_CHANNEL_MIXER N_("Channel mixer")
+#define AUDIO_CHANNEL_MIXER_LONGTEXT N_( \
+ "This allows you to choose a specific audio channel mixer. For instance " \
+ "the headphone channel mixer will downmix any audio source to a stereo " \
+ "output and give the feeling that you are standing in a room with a " \
+ "complete 5.1 speaker set when using only a headphone.")
#define VOUT_CAT_LONGTEXT N_( \
"These options allow you to modify options related to " \
"1.3333, etc.) expressing pixel squareness.")
#endif
-#define INPUT_CAT_LONGTEXT N_( " " )
+#define INPUT_CAT_LONGTEXT N_( \
+ "These options allow you to modify options related to the input " \
+ "modules, such as the DVD or VCD device, the network interface " \
+ "settings or the subtitle channel.")
#define CR_AVERAGE_TEXT N_("Clock reference average counter")
#define CR_AVERAGE_LONGTEXT N_( \
"This is the default VCD device to use." )
#endif
-#define CDAUDIO_DEV_TEXT N_("CD Audio device")
+#define CDAUDIO_DEV_TEXT N_("Audio CD device")
#ifdef HAVE_CDDAX
#define CDAUDIO_DEV_LONGTEXT N_( \
- "This is the default CD Audio device to use. " \
+ "This is the default Audio CD device to use. " \
"If you don't specify anything, we'll scan for a suitable CD-ROM device." )
#else
#define CDAUDIO_DEV_LONGTEXT N_( \
- "This is the default CD Audio device to use." )
+ "This is the default Audio CD device to use." )
#endif
#define IPV6_TEXT N_("Force IPv6")
#define WIN9X_CV_TEXT N_("Condition variables implementation for Win9x " \
"(developers only)")
#define WIN9X_CV_LONGTEXT N_( \
- "On Windows 9x/Me we use a fast but not correct condition variables " \
+ "On Windows 9x/Me you can use a fast but incorrect condition variables " \
"implementation (more precisely there is a possibility for a race " \
"condition to happen). " \
- "However it is possible to use slower alternatives which should be more " \
+ "However it is possible to use slower alternatives which are more " \
"robust. " \
"Currently you can choose between implementation 0 (which is the " \
- "default and the fastest), 1 and 2.")
+ "fastest but slightly incorrect), 1 (default) and 2.")
-#define HOTKEY_CAT_LONGTEXT N_( " " )
+#define HOTKEY_CAT_LONGTEXT N_( "These settings are the global VLC key " \
+ "bindings, known as \"hotkeys\"." )
#define FULLSCREEN_KEY_TEXT N_("Fullscreen")
#define FULLSCREEN_KEY_LONGTEXT N_("Select the hotkey to use to swap fullscreen state")
#define POSITION_KEY_TEXT N_("Position")
#define POSITION_KEY_LONGTEXT N_("Select the hotkey to display the position")
-#define JB10SEC_KEY_TEXT N_("Jump backward 10 seconds")
-#define JB10SEC_KEY_LONGTEXT N_("Select the hotkey to jump backward by 10 seconds")
+#define JB10SEC_KEY_TEXT N_("Jump 10 seconds backwards")
+#define JB10SEC_KEY_LONGTEXT N_("Select the hotkey to jump 10 seconds backwards")
-#define JB1MIN_KEY_TEXT N_("Jump backward 1 minute")
-#define JB1MIN_KEY_LONGTEXT N_("Select the hotkey to jump backward by 1 minute")
-#define JB5MIN_KEY_TEXT N_("Jump backward 5 minutes")
-#define JB5MIN_KEY_LONGTEXT N_("Select the hotkey to jump backward by 5 minutes")
-#define JF10SEC_KEY_TEXT N_("Jump forward 10 seconds")
-#define JF10SEC_KEY_LONGTEXT N_("Select the hotkey to jump forward by 10 seconds")
+#define JB1MIN_KEY_TEXT N_("Jump 1 minute backwards")
+#define JB1MIN_KEY_LONGTEXT N_("Select the hotkey to jump 1 minute backwards")
+#define JB5MIN_KEY_TEXT N_("Jump 5 minutes backwards")
+#define JB5MIN_KEY_LONGTEXT N_("Select the hotkey to jump 5 minutes backwards")
+#define JF10SEC_KEY_TEXT N_("Jump 10 seconds forward")
+#define JF10SEC_KEY_LONGTEXT N_("Select the hotkey to jump 10 seconds forward")
-#define JF1MIN_KEY_TEXT N_("Jump forward 1 minute")
-#define JF1MIN_KEY_LONGTEXT N_("Select the hotkey to jump forward by 1 minute")
+#define JF1MIN_KEY_TEXT N_("Jump 1 minute forward")
+#define JF1MIN_KEY_LONGTEXT N_("Select the hotkey to jump 1 minute forward")
-#define JF5MIN_KEY_TEXT N_("Jump forward 5 minutes")
-#define JF5MIN_KEY_LONGTEXT N_("Select the hotkey to jump forward by 5 minutes")
+#define JF5MIN_KEY_TEXT N_("Jump 5 minutes forward")
+#define JF5MIN_KEY_LONGTEXT N_("Select the hotkey to jump 5 minutes forward")
#define QUIT_KEY_TEXT N_("Quit")
#define QUIT_KEY_LONGTEXT N_("Select the hotkey to quit the application")
add_bool( "hq-resampling", 1, NULL, AOUT_RESAMP_TEXT, AOUT_RESAMP_LONGTEXT, VLC_TRUE );
#endif
add_bool( "spdif", 0, NULL, SPDIF_TEXT, SPDIF_LONGTEXT, VLC_FALSE );
-#if 0
- add_bool( "headphone-opt", 0, NULL, HEADPHONE_TEXT,
- HEADPHONE_LONGTEXT, VLC_FALSE );
-#endif
add_integer( "audio-desync", 0, NULL, DESYNC_TEXT, DESYNC_LONGTEXT, VLC_TRUE );
add_string("audio-filter",0,NULL,AUDIO_FILTER_TEXT,
AUDIO_FILTER_LONGTEXT,VLC_FALSE);
+ add_module( "audio-channel-mixer", "audio filter", NULL, NULL,
+ AUDIO_CHANNEL_MIXER, AUDIO_CHANNEL_MIXER_LONGTEXT,
+ VLC_FALSE );
/* Video options */
add_category_hint( N_("Video"), VOUT_CAT_LONGTEXT , VLC_FALSE );
add_bool( "one-instance", 0, NULL, ONEINSTANCE_TEXT, ONEINSTANCE_LONGTEXT, VLC_TRUE );
add_bool( "high-priority", 1, NULL, HPRIORITY_TEXT, HPRIORITY_LONGTEXT, VLC_TRUE );
add_bool( "fast-mutex", 0, NULL, FAST_MUTEX_TEXT, FAST_MUTEX_LONGTEXT, VLC_TRUE );
- add_integer( "win9x-cv-method", 0, NULL, WIN9X_CV_TEXT, WIN9X_CV_LONGTEXT, VLC_TRUE );
+ add_integer( "win9x-cv-method", 1, NULL, WIN9X_CV_TEXT, WIN9X_CV_LONGTEXT, VLC_TRUE );
#endif
/* Hotkey options*/
add_key( "key-vol-down", KEY_MODIFIER_COMMAND|KEY_DOWN, NULL, VOL_DOWN_KEY_TEXT, VOL_DOWN_KEY_LONGTEXT, VLC_FALSE );
add_key( "key-vol-mute", KEY_MODIFIER_COMMAND|KEY_MODIFIER_SHIFT|'m', NULL, VOL_MUTE_KEY_TEXT, VOL_MUTE_KEY_LONGTEXT, VLC_FALSE );
add_key( "key-set-bookmark1", KEY_MODIFIER_COMMAND|KEY_F1, NULL, SET_BOOKMARK1_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
+ add_key( "key-set-bookmark2", KEY_MODIFIER_COMMAND|KEY_F2, NULL, SET_BOOKMARK2_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
+ add_key( "key-set-bookmark3", KEY_MODIFIER_COMMAND|KEY_F3, NULL, SET_BOOKMARK3_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
+ add_key( "key-set-bookmark4", KEY_MODIFIER_COMMAND|KEY_F4, NULL, SET_BOOKMARK4_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
+ add_key( "key-set-bookmark5", KEY_MODIFIER_COMMAND|KEY_F5, NULL, SET_BOOKMARK5_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
+ add_key( "key-set-bookmark6", KEY_MODIFIER_COMMAND|KEY_F6, NULL, SET_BOOKMARK6_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
+ add_key( "key-set-bookmark7", KEY_MODIFIER_COMMAND|KEY_F7, NULL, SET_BOOKMARK7_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
+ add_key( "key-set-bookmark8", KEY_MODIFIER_COMMAND|KEY_F8, NULL, SET_BOOKMARK8_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
+ add_key( "key-set-bookmark9", KEY_UNSET, NULL, SET_BOOKMARK9_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
+ add_key( "key-set-bookmark10", KEY_UNSET, NULL, SET_BOOKMARK10_KEY_TEXT, SET_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
add_key( "key-play-bookmark1", KEY_F1, NULL, PLAY_BOOKMARK1_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
+ add_key( "key-play-bookmark2", KEY_F2, NULL, PLAY_BOOKMARK2_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
+ add_key( "key-play-bookmark3", KEY_F3, NULL, PLAY_BOOKMARK3_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
+ add_key( "key-play-bookmark4", KEY_F4, NULL, PLAY_BOOKMARK4_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
+ add_key( "key-play-bookmark5", KEY_F5, NULL, PLAY_BOOKMARK5_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
+ add_key( "key-play-bookmark6", KEY_F6, NULL, PLAY_BOOKMARK6_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
+ add_key( "key-play-bookmark7", KEY_F7, NULL, PLAY_BOOKMARK7_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
+ add_key( "key-play-bookmark8", KEY_F8, NULL, PLAY_BOOKMARK8_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
+ add_key( "key-play-bookmark9", KEY_UNSET, NULL, PLAY_BOOKMARK9_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
+ add_key( "key-play-bookmark10", KEY_UNSET, NULL, PLAY_BOOKMARK10_KEY_TEXT, PLAY_BOOKMARK_KEY_LONGTEXT, VLC_TRUE );
#else
add_key( "key-fullscreen", 'f', NULL, FULLSCREEN_KEY_TEXT, FULLSCREEN_KEY_LONGTEXT, VLC_FALSE );
add_key( "key-play-pause", KEY_SPACE, NULL, PLAY_PAUSE_KEY_TEXT, PLAY_PAUSE_KEY_LONGTEXT, VLC_FALSE );