]> git.sesse.net Git - vlc/blobdiff - src/libvlc.h
* modules/stream_out/transcode.c: added YV12 raw video fourcc (chroma planes will...
[vlc] / src / libvlc.h
index c73f14351bd12a289f7ba5738de81eabab6ea2f1..23c83ed166fa6044359bc1e4684e6c7836618f56 100644 (file)
@@ -2,7 +2,7 @@
  * 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>
@@ -31,9 +31,9 @@ static char *ppsz_language[] =
   "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
@@ -142,7 +142,7 @@ static char *ppsz_language_text[] =
     "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 " \
@@ -158,14 +158,12 @@ static char *ppsz_language_text[] =
     "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 " \
@@ -259,7 +257,10 @@ static char *ppsz_language_text[] =
     "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_( \
@@ -345,14 +346,14 @@ static char *ppsz_language_text[] =
     "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")
@@ -529,15 +530,16 @@ static char *ppsz_language_text[] =
 #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")
@@ -560,21 +562,21 @@ static char *ppsz_language_text[] =
 #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")
@@ -686,13 +688,12 @@ vlc_module_begin();
     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 );
@@ -823,7 +824,7 @@ vlc_module_begin();
     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*/
@@ -855,7 +856,25 @@ vlc_module_begin();
     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 );