]> git.sesse.net Git - vlc/blobdiff - src/libvlc.h
* vlm: better vlm_Show.
[vlc] / src / libvlc.h
index f6b19a3d13ab6b70ee855a149a7b733dd0a33d93..8f14331b46d1373d520c9ddc1b98d249bdb724b1 100644 (file)
@@ -2,7 +2,7 @@
  * libvlc.h: main libvlc header
  *****************************************************************************
  * Copyright (C) 1998-2002 VideoLAN
- * $Id: libvlc.h,v 1.135 2004/03/02 13:53:14 kuehne 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 " \
@@ -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 " \
@@ -324,25 +305,31 @@ static char *ppsz_align_descriptions[] = { N_("Center"),
 #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
@@ -384,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 " \
@@ -525,7 +544,7 @@ static char *ppsz_align_descriptions[] = { N_("Center"),
 
 #define RT_OFFSET_TEXT N_("Adjust VLC priority")
 #define RT_OFFSET_LONGTEXT N_( \
-    "This options adds an offset (positive or negative) to VLC default " \
+    "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.")
 
@@ -609,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")
@@ -651,10 +670,12 @@ static char *ppsz_align_descriptions[] = { N_("Center"),
 
 #define PLAYLIST_USAGE N_("\nPlaylist items:" \
     "\n  *.mpg, *.vob                   plain MPEG-1/2 files" \
-    "\n  [dvd:][device][@raw_device][@[title][,[chapter][,angle]]]" \
+    "\n  [dvd://][device][@raw_device][@[title][,[chapter][,angle]]]" \
     "\n                                 DVD device" \
-    "\n  [vcd:][device][@[title][,[chapter]]" \
+    "\n  [vcd://][device][@{S|T|E|P}[number]]" \
     "\n                                 VCD device" \
+    "\n  [cdda://][device][@[T][track-number]]" \
+    "\n                                 Audio CD device" \
     "\n  udpstream:[[<source address>]@[<bind address>][:<bind port>]]" \
     "\n                                 UDP stream sent by a streaming server" \
     "\n  vlc:pause                      pause execution of " \
@@ -783,16 +804,40 @@ vlc_module_begin();
                  SUB_FILE_TEXT, SUB_FILE_LONGTEXT, VLC_TRUE );
     add_integer( "input-repeat", 0, NULL,
                  INPUT_REPEAT_TEXT, INPUT_REPEAT_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( "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 );