]> git.sesse.net Git - vlc/blobdiff - src/libvlc.h
* asf: fixed unintialised variable, cleaned up some stuffs.
[vlc] / src / libvlc.h
index 3bcd4908703c4b67470c01670948b35d9be8769d..f93b5ac34ae7d7a185a1120c0d2cd7cdbff825e8 100644 (file)
@@ -2,7 +2,7 @@
  * libvlc.h: main libvlc header
  *****************************************************************************
  * Copyright (C) 1998-2002 VideoLAN
- * $Id: libvlc.h,v 1.130 2004/01/25 13:50:33 zorglub Exp $
+ * $Id$
  *
  * Authors: Vincent Seguin <seguin@via.ecp.fr>
  *          Samuel Hocevar <sam@zoy.org>
@@ -32,8 +32,9 @@ static char *ppsz_language[] =
   "pl", "pt_BR", "ru", "sv" };
 static char *ppsz_language_text[] =
 { 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_("Brazilian"), N_("Russian"), N_("Swedish") };
+  N_("French"), N_("Hungarian"), N_("Italian"), N_("Japanese"), N_("Dutch"),
+  N_("Norwegian"), N_("Polish"), N_("Brazilian"), N_("Russian"),
+  N_("Swedish") };
 
 /*****************************************************************************
  * Configuration options for the main program. Each module will also separatly
@@ -161,14 +162,6 @@ static char *ppsz_language_text[] =
     "the sound, or audio visualization modules (spectrum analyzer, ...).")
 
 #define AUDIO_CHANNEL_MIXER N_("Channel mixer")
-#if 0
-#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.")
-#endif
-
 #define AUDIO_CHANNEL_MIXER_LONGTEXT N_( \
      "This allows you to choose a specific audio channel mixer. For " \
      "instance, you can use the \"headphone\" mixer that gives 5.1 feeling " \
@@ -177,8 +170,8 @@ static char *ppsz_language_text[] =
 #define VOUT_CAT_LONGTEXT N_( \
     "These options allow you to modify the behaviour of the video output " \
     "subsytem. You can for example enable video filters (deinterlacing, " \
-    "image adjusting, ...\n ). Enable these filters here and configure " \
-    "them in the \"video filters\" modules section. You can also set many" \
+    "image adjusting, ...). Enable these filters here and configure " \
+    "them in the \"video filters\" modules section. You can also set many " \
     "miscellaneous video options." )
 
 #define VOUT_TEXT N_("Video output module")
@@ -208,11 +201,9 @@ static char *ppsz_language_text[] =
     "will be centered (0=center, 1=left, 2=right, 4=top, 8=bottom, you can " \
     "also use combinations of these values).")
 static int pi_align_values[] = { 0, 1, 2, 4, 8, 5, 6, 9, 10 };
-static char *ppsz_align_descriptions[] = { N_("Center"),
-                                           N_("Left"), N_("Right"),
-                                           N_("Top"), N_("Bottom"),
-                                           N_("Top-Left"), N_("Top-Right"),
-                                           N_("Bottom-Left"), N_("Bottom-Right")};
+static char *ppsz_align_descriptions[] =
+{ N_("Center"), N_("Left"), N_("Right"), N_("Top"), N_("Bottom"),
+  N_("Top-Left"), N_("Top-Right"), N_("Bottom-Left"), N_("Bottom-Right") };
 
 #define ZOOM_TEXT N_("Zoom video")
 #define ZOOM_LONGTEXT N_( \
@@ -262,16 +253,6 @@ static char *ppsz_align_descriptions[] = { N_("Center"),
     "aspect, or a float value (1.25, 1.3333, etc.) expressing pixel " \
     "squareness.")
 
-#if 0
-#define PIXEL_RATIO_TEXT N_("Destination aspect ratio")
-#define PIXEL_RATIO_LONGTEXT N_( \
-    "This will force the destination pixel size. By default VLC assumes " \
-    "your pixels are square, unless your hardware has a way to tell it " \
-    "otherwise. This may be used when you output VLC's signal to another " \
-    "device such as a TV set. Accepted format is a float value (1, 1.25, " \
-    "1.3333, etc.) expressing pixel squareness.")
-#endif
-
 #define INPUT_CAT_LONGTEXT N_( \
     "These options allow you to modify the behaviour of the input " \
     "subsystem, such as the DVD or VCD device, the network interface " \
@@ -321,25 +302,34 @@ static char *ppsz_align_descriptions[] = { N_("Center"),
     "Give the stream number of the subtitle channel you want to use " \
     "(from 1 to n).")
 
+#define INPUT_REPEAT_TEXT N_("Number of time the same input will be repeated")
+#define INPUT_REPEAT_LONGTEXT N_("Number of time the same input will be repeated")
+
+#define START_TIME_TEXT N_("Input start time (second)")
+#define START_TIME_LONGTEXT N_("Input start time (second)")
+
+#define STOP_TIME_TEXT N_("Input stop time (second)")
+#define STOP_TIME_LONGTEXT N_("Input stop time (second)")
+
 #define SUB_AUTO_TEXT N_("Autodetect subtitle files")
 #define SUB_AUTO_LONGTEXT \
-    "Automatically detect a subtitle file, if no subtitle filename is " \
-    "specified."
+    N_("Automatically detect a subtitle file, if no subtitle filename is " \
+    "specified.")
 
 #define SUB_FUZZY_TEXT N_("Subtitle autodection fuzziness")
 #define SUB_FUZZY_LONGTEXT \
-    "This determines how fuzzy subtitle and movie filenaming matching " \
+    N_("This determines how fuzzy subtitle and movie filenaming matching " \
     "will be. Options are:\n" \
     "0 = no subtitles autodetected\n" \
     "1 = any subtitle file\n" \
     "2 = any subtitle file containing the movie name\n" \
     "3 = subtitle file matching the movie name with additional chars\n" \
-    "4 = subtitle file matching the movie name exactly"
+    "4 = subtitle file matching the movie name exactly")
 
 #define SUB_FILE_TEXT N_("Use subtitle file")
 #define SUB_FILE_LONGTEXT \
-    "Load this subtitle file. To be used when autodetect cannot detect " \
-    "your subtitlefile."
+    N_("Load this subtitle file. To be used when autodetect cannot detect " \
+    "your subtitle file.")
 
 #define DVD_DEV_TEXT N_("DVD device")
 #ifdef WIN32
@@ -381,6 +371,38 @@ static char *ppsz_align_descriptions[] = { N_("Center"),
     "If you check this box, IPv4 will be used by default for all UDP and " \
     "HTTP connections.")
 
+#define META_TITLE_TEXT N_("Title metadata")
+#define META_TITLE_LONGTEXT N_( \
+     "Allows you to specify a \"title\" metadata for an input.")
+
+#define META_AUTHOR_TEXT N_("Author metadata")
+#define META_AUTHOR_LONGTEXT N_( \
+     "Allows you to specify an \"author\" metadata for an input.")
+
+#define META_ARTIST_TEXT N_("Artist metadata")
+#define META_ARTIST_LONGTEXT N_( \
+     "Allows you to specify an \"artist\" metadata for an input.")
+
+#define META_GENRE_TEXT N_("Genre metadata")
+#define META_GENRE_LONGTEXT N_( \
+     "Allows you to specify a \"genre\" metadata for an input.")
+
+#define META_CPYR_TEXT N_("Copyright metadata")
+#define META_CPYR_LONGTEXT N_( \
+     "Allows you to specify a \"copyright\" metadata for an input.")
+
+#define META_DESCR_TEXT N_("Description metadata")
+#define META_DESCR_LONGTEXT N_( \
+     "Allows you to specify a \"description\" metadata for an input.")
+
+#define META_DATE_TEXT N_("Date metadata")
+#define META_DATE_LONGTEXT N_( \
+     "Allows you to specify a \"date\" metadata for an input.")
+
+#define META_URL_TEXT N_("URL metadata")
+#define META_URL_LONGTEXT N_( \
+     "Allows you to specify a \"url\" metadata for an input.")
+
 #define CODEC_CAT_LONGTEXT N_( \
     "This option can be used to alter the way VLC selects " \
     "its codecs (decompression methods). Only advanced users should " \
@@ -466,6 +488,11 @@ static char *ppsz_align_descriptions[] = { N_("Center"),
     "If your processor supports the SSE instructions set, VLC can take " \
     "advantage of them.")
 
+#define SSE2_TEXT N_("Enable CPU SSE2 support")
+#define SSE2_LONGTEXT N_( \
+    "If your processor supports the SSE2 instructions set, VLC can take " \
+    "advantage of them.")
+
 #define ALTIVEC_TEXT N_("Enable CPU AltiVec support")
 #define ALTIVEC_LONGTEXT N_( \
     "If your processor supports the AltiVec instructions set, VLC can take " \
@@ -515,6 +542,12 @@ static char *ppsz_align_descriptions[] = { N_("Center"),
     "slow. You should only activate this if you know what you're " \
     "doing.")
 
+#define RT_OFFSET_TEXT N_("Adjust VLC priority")
+#define RT_OFFSET_LONGTEXT N_( \
+    "This option adds an offset (positive or negative) to VLC default " \
+    "priorities. You can use it to tune VLC priority against other " \
+    "programs, or against other VLC instances.")
+
 #define MINIMIZE_THREADS_TXT N_("Minimize number of threads")
 #define MINIMIZE_THREADS_LONGTXT N_( \
      "This option minimizes the number of threads needed to run VLC")
@@ -595,17 +628,17 @@ static char *ppsz_align_descriptions[] = { N_("Center"),
 #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.")
+#define QUIT_KEY_LONGTEXT N_("Select the hotkey to quit the application.")
 #define NAV_UP_KEY_TEXT N_("Navigate up")
-#define NAV_UP_KEY_LONGTEXT N_("Select the key to move the selector up in dvd menus.")
+#define NAV_UP_KEY_LONGTEXT N_("Select the key to move the selector up in DVD menus.")
 #define NAV_DOWN_KEY_TEXT N_("Navigate down")
-#define NAV_DOWN_KEY_LONGTEXT N_("Select the key to move the selector down in dvd menus.")
+#define NAV_DOWN_KEY_LONGTEXT N_("Select the key to move the selector down in DVD menus.")
 #define NAV_LEFT_KEY_TEXT N_("Navigate left")
-#define NAV_LEFT_KEY_LONGTEXT N_("Select the key to move the selector left in dvd menus.")
+#define NAV_LEFT_KEY_LONGTEXT N_("Select the key to move the selector left in DVD menus.")
 #define NAV_RIGHT_KEY_TEXT N_("Navigate right")
 #define NAV_RIGHT_KEY_LONGTEXT N_("Select the key to move the selector right in dvd menus.")
 #define NAV_ACTIVATE_KEY_TEXT N_("Activate")
-#define NAV_ACTIVATE_KEY_LONGTEXT N_("Select the key to activate selected item in dvd menus.")
+#define NAV_ACTIVATE_KEY_LONGTEXT N_("Select the key to activate selected item in DVD menus.")
 #define VOL_UP_KEY_TEXT N_("Volume up")
 #define VOL_UP_KEY_LONGTEXT N_("Select the key to increase audio volume.")
 #define VOL_DOWN_KEY_TEXT N_("Volume down")
@@ -641,7 +674,7 @@ static char *ppsz_align_descriptions[] = { N_("Center"),
     "\n                                 DVD device" \
     "\n  [vcd:][device][@[title][,[chapter]]" \
     "\n                                 VCD device" \
-    "\n  udpstream:[@[<bind address>][:<bind port>]]" \
+    "\n  udpstream:[[<source address>]@[<bind address>][:<bind port>]]" \
     "\n                                 UDP stream sent by a streaming server" \
     "\n  vlc:pause                      pause execution of " \
     "playlist items" \
@@ -767,17 +800,42 @@ vlc_module_begin();
                  SUB_FUZZY_TEXT, SUB_FUZZY_LONGTEXT, VLC_TRUE );
     add_file( "sub-file", NULL, NULL,
                  SUB_FILE_TEXT, SUB_FILE_LONGTEXT, VLC_TRUE );
-
-
-    add_file( "dvd", DVD_DEVICE, NULL, DVD_DEV_TEXT, DVD_DEV_LONGTEXT, VLC_FALSE );
-    add_file( "vcd", VCD_DEVICE, NULL, VCD_DEV_TEXT, VCD_DEV_LONGTEXT, VLC_FALSE );
-    add_file( "cd-audio", CDAUDIO_DEVICE, NULL, CDAUDIO_DEV_TEXT, CDAUDIO_DEV_LONGTEXT, VLC_FALSE );
+    add_integer( "input-repeat", 0, NULL,
+                 INPUT_REPEAT_TEXT, INPUT_REPEAT_LONGTEXT, VLC_TRUE );
+    add_integer( "start-time", 0, NULL,
+                 START_TIME_TEXT, START_TIME_LONGTEXT, VLC_TRUE );
+    add_integer( "stop-time", 0, NULL,
+                 STOP_TIME_TEXT, STOP_TIME_LONGTEXT, VLC_TRUE );
+
+    add_file( "dvd", DVD_DEVICE, NULL, DVD_DEV_TEXT, DVD_DEV_LONGTEXT,
+              VLC_FALSE );
+    add_file( "vcd", VCD_DEVICE, NULL, VCD_DEV_TEXT, VCD_DEV_LONGTEXT,
+              VLC_FALSE );
+    add_file( "cd-audio", CDAUDIO_DEVICE, NULL, CDAUDIO_DEV_TEXT,
+              CDAUDIO_DEV_LONGTEXT, VLC_FALSE );
 
     add_bool( "ipv6", 0, NULL, IPV6_TEXT, IPV6_LONGTEXT, VLC_FALSE );
         change_short('6');
     add_bool( "ipv4", 0, NULL, IPV4_TEXT, IPV4_LONGTEXT, VLC_FALSE );
         change_short('4');
 
+    add_string( "meta-title", NULL, NULL, META_TITLE_TEXT,
+                META_TITLE_LONGTEXT, VLC_TRUE );
+    add_string( "meta-author", NULL, NULL, META_AUTHOR_TEXT,
+                META_AUTHOR_LONGTEXT, VLC_TRUE );
+    add_string( "meta-artist", NULL, NULL, META_ARTIST_TEXT,
+                META_ARTIST_LONGTEXT, VLC_TRUE );
+    add_string( "meta-genre", NULL, NULL, META_GENRE_TEXT,
+                META_GENRE_LONGTEXT, VLC_TRUE );
+    add_string( "meta-copyright", NULL, NULL, META_CPYR_TEXT,
+                META_CPYR_LONGTEXT, VLC_TRUE );
+    add_string( "meta-description", NULL, NULL, META_DESCR_TEXT,
+                META_DESCR_LONGTEXT, VLC_TRUE );
+    add_string( "meta-date", NULL, NULL, META_DATE_TEXT,
+                META_DATE_LONGTEXT, VLC_TRUE );
+    add_string( "meta-url", NULL, NULL, META_URL_TEXT,
+                META_URL_LONGTEXT, VLC_TRUE );
+
     /* Decoder options */
     add_category_hint( N_("Decoders"), CODEC_CAT_LONGTEXT , VLC_TRUE );
     add_module( "codec", "decoder", NULL, NULL, CODEC_TEXT, CODEC_LONGTEXT, VLC_TRUE );
@@ -814,6 +872,7 @@ vlc_module_begin();
     add_bool( "3dn", 1, NULL, THREE_DN_TEXT, THREE_DN_LONGTEXT, VLC_TRUE );
     add_bool( "mmxext", 1, NULL, MMXEXT_TEXT, MMXEXT_LONGTEXT, VLC_TRUE );
     add_bool( "sse", 1, NULL, SSE_TEXT, SSE_LONGTEXT, VLC_TRUE );
+    add_bool( "sse2", 1, NULL, SSE2_TEXT, SSE2_LONGTEXT, VLC_TRUE );
 #endif
 #if defined( __powerpc__ ) || defined( SYS_DARWIN )
     add_bool( "altivec", 1, NULL, ALTIVEC_TEXT, ALTIVEC_LONGTEXT, VLC_TRUE );
@@ -840,6 +899,10 @@ vlc_module_begin();
     add_bool( "rt-priority", 0, NULL, RT_PRIORITY_TEXT, RT_PRIORITY_LONGTEXT, VLC_TRUE );
 #endif
 
+#if !defined(SYS_BEOS) && defined(PTHREAD_COND_T_IN_PTHREAD_H)
+    add_integer( "rt-offset", 0, NULL, RT_OFFSET_TEXT, RT_OFFSET_LONGTEXT, VLC_TRUE );
+#endif
+
 #if defined(WIN32)
     add_bool( "one-instance", 0, NULL, ONEINSTANCE_TEXT, ONEINSTANCE_LONGTEXT, VLC_TRUE );
     add_bool( "high-priority", 1, NULL, HPRIORITY_TEXT, HPRIORITY_LONGTEXT, VLC_TRUE );