/*****************************************************************************
* libvlc-module.c: Options for the main (libvlc itself) module
*****************************************************************************
- * Copyright (C) 1998-2009 the VideoLAN team
+ * Copyright (C) 1998-2009 VLC authors and VideoLAN
* $Id$
*
* Authors: Vincent Seguin <seguin@via.ecp.fr>
* Gildas Bazin <gbazin@videolan.org>
* Jean-Paul Saman <jpsaman #_at_# m2x.nl>
*
- * 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
+ * This program is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation; either version 2.1 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.
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser 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
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
*****************************************************************************/
// Pretend we are a builtin module
#define VERBOSE_OBJECTS_TEXT N_("Choose which objects should print debug " \
"message")
#define VERBOSE_OBJECTS_LONGTEXT N_( \
- "This is a ',' separated string, each objects should be prefixed by " \
+ "This is a ',' separated string, each object should be prefixed by " \
"a '+' or a '-' to respectively enable or disable it. The keyword " \
"'all' refers to all objects. Objects can be referred to by their " \
"type or module name. Rules applying to named objects take precedence " \
#define VOLUME_TEXT N_("Default audio volume")
#define VOLUME_LONGTEXT N_( \
- "You can set the default audio output volume here, in a range from 0 to " \
- "1024.")
+ "You can set the default audio output volume here.")
#define VOLUME_STEP_TEXT N_("Audio output volume step")
#define VOLUME_STEP_LONGTEXT N_( \
- "The step size of the volume is adjustable using this option, " \
- "in a range from 0 to 1024." )
+ "The step size of the volume is adjustable using this option.")
#define AOUT_VOLUME_STEP 32
-#define AOUT_RATE_TEXT N_("Audio output frequency (Hz)")
-#define AOUT_RATE_LONGTEXT N_( \
- "You can force the audio output frequency here. Common values are " \
- "0 (undefined), 48000, 44100, 32000, 22050, 16000, 11025, 8000.")
+#define VOLUME_SAVE_TEXT N_( "Remember the audio volume" )
+#define VOLUME_SAVE_LONGTEXT N_( \
+ "The volume can be recorded and automatically restored next time " \
+ "VLC is used." )
#if !defined( __APPLE__ )
#define AOUT_RESAMP_TEXT N_("High quality audio resampling")
"This delays the audio output. The delay must be given in milliseconds. " \
"This can be handy if you notice a lag between the video and the audio.")
+#define AUDIO_RESAMPLER_TEXT N_("Audio resampler")
+#define AUDIO_RESAMPLER_LONGTEXT N_( \
+ "This selects which plugin to use for audio resampling." )
+
#define MULTICHA_TEXT N_("Audio output channels mode")
#define MULTICHA_LONGTEXT N_( \
"This sets the audio output channels mode that will " \
"When several video formats are available, select one whose " \
"resolution is closest to (but not higher than) this setting, " \
"in number of lines. Use this option if you don't have enough CPU " \
- "power or network bandwith to play higher resolutions.")
-static const int pi_prefres[] = { -1, 1080, 720, 576, 320 };
+ "power or network bandwidth to play higher resolutions.")
+static const int pi_prefres[] = { -1, 1080, 720, 576, 360, 240 };
static const char *const ppsz_prefres[] = {
N_("Best available"), N_("Full HD (1080p)"), N_("HD (720p)"),
N_("Standard Definition (576 or 480 lines)"),
- N_("Low definition (320 lines)")
+ N_("Low Definition (360 lines)"),
+ N_("Very Low Definition (240 lines)"),
};
#define INPUT_REPEAT_TEXT N_("Input repetitions")
"Default TCP connection timeout (in milliseconds). " )
#define HTTP_HOST_TEXT N_( "HTTP server address" )
-#define RTSP_HOST_TEXT N_( "RTSP server address" )
#define HOST_LONGTEXT N_( \
"By default, the server will listen on any local IP address. " \
"Specify an IP address (e.g. ::1 or 127.0.0.1) or a host name " \
"(e.g. localhost) to restrict them to a specific network interface." )
+#define RTSP_HOST_TEXT N_( "RTSP server address" )
+#define RTSP_HOST_LONGTEXT N_( \
+ "This defines the address the RTSP server will listen on, along " \
+ "with the base path of the RTSP VOD media. Syntax is address/path. " \
+ "By default, the server will listen on any local IP address. " \
+ "Specify an IP address (e.g. ::1 or 127.0.0.1) or a host name " \
+ "(e.g. localhost) to restrict them to a specific network interface." )
+
#define HTTP_PORT_TEXT N_( "HTTP server port" )
#define HTTP_PORT_LONGTEXT N_( \
"The HTTP server will listen on this TCP port. " \
#define RTSP_PORT_TEXT N_( "RTSP server port" )
#define RTSP_PORT_LONGTEXT N_( \
- "The HTTPS server will listen on this TCP port. " \
+ "The RTSP server will listen on this TCP port. " \
"The standard RTSP port number is 554. " \
"However allocation of port numbers below 1025 is usually restricted " \
"by the operating system." )
#define HTTP_CRL_TEXT N_("HTTP/TLS Certificate Revocation List")
#define CRL_LONGTEXT N_( \
- "This file countains an optional CRL to prevent remove clients " \
+ "This file contains an optional CRL to prevent remove clients " \
"from using revoked certificates in TLS sessions.")
#define SOCKS_SERVER_TEXT N_("SOCKS server")
"Additional path for VLC to look for its modules. You can add " \
"several paths by concatenating them using \" PATH_SEP \" as separator")
-#define DATA_PATH_TEXT N_("Data search path")
-#define DATA_PATH_LONGTEXT N_( \
- "Override the default data/share search path.")
-
#define VLM_CONF_TEXT N_("VLM configuration file")
#define VLM_CONF_LONGTEXT N_( \
"Read a VLM configuration file as soon as VLM is started." )
#define TOGGLE_FULLSCREEN_KEY_TEXT N_("Fullscreen")
#define TOGGLE_FULLSCREEN_KEY_LONGTEXT N_("Select the hotkey to use to swap fullscreen state.")
-#define LEAVE_FULLSCREEN_KEY_TEXT N_("Leave fullscreen")
-#define LEAVE_FULLSCREEN_KEY_LONGTEXT N_("Select the hotkey to use to leave fullscreen state.")
+#define LEAVE_FULLSCREEN_KEY_TEXT N_("Exit fullscreen")
+#define LEAVE_FULLSCREEN_KEY_LONGTEXT N_("Select the hotkey to use to exit fullscreen state.")
#define PLAY_PAUSE_KEY_TEXT N_("Play/Pause")
#define PLAY_PAUSE_KEY_LONGTEXT N_("Select the hotkey to use to swap paused state.")
#define PAUSE_KEY_TEXT N_("Pause only")
add_integer_with_range( "volume-step", AOUT_VOLUME_STEP, 0,
AOUT_VOLUME_MAX, VOLUME_STEP_TEXT,
VOLUME_STEP_LONGTEXT, true )
- add_obsolete_integer( "aout-rate" ) /* since 1.2.0 */
+ add_bool( "volume-save", true, VOLUME_SAVE_TEXT, VOLUME_SAVE_TEXT, true )
+ add_obsolete_integer( "aout-rate" ) /* since 2.0.0 */
#if HAVE_FPU && !defined( __APPLE__ )
add_bool( "hq-resampling", 1, AOUT_RESAMP_TEXT,
AOUT_RESAMP_LONGTEXT, true )
DESYNC_LONGTEXT, true )
change_safe ()
+ add_module( "audio-resampler", "audio resampler", NULL,
+ AUDIO_RESAMPLER_TEXT, AUDIO_RESAMPLER_LONGTEXT, true )
+
/* FIXME TODO create a subcat replay gain ? */
add_string( "audio-replay-gain-mode", ppsz_replay_gain_mode[0], AUDIO_REPLAY_GAIN_MODE_TEXT,
AUDIO_REPLAY_GAIN_MODE_LONGTEXT, false )
VIDEO_FILTER_TEXT, VIDEO_FILTER_LONGTEXT, false )
add_module_list_cat( "video-splitter", SUBCAT_VIDEO_VFILTER, NULL,
VIDEO_SPLITTER_TEXT, VIDEO_SPLITTER_LONGTEXT, false )
- add_obsolete_string( "vout-filter" ) /* since 1.2.0 */
+ add_obsolete_string( "vout-filter" ) /* since 2.0.0 */
#if 0
add_string( "pixel-ratio", "1", PIXEL_RATIO_TEXT, PIXEL_RATIO_TEXT )
#endif
add_integer( "sub-autodetect-fuzzy", 3,
SUB_FUZZY_TEXT, SUB_FUZZY_LONGTEXT, true )
#if defined( WIN32 ) || defined( __OS2__ )
-# define SUB_PATH ".\\subtitles"
+# define SUB_PATH ".\\subtitles, .\\subs"
#else
-# define SUB_PATH "./Subtitles, ./subtitles"
+# define SUB_PATH "./Subtitles, ./subtitles, ./Subs, ./subs"
#endif
add_string( "sub-autodetect-path", SUB_PATH,
SUB_PATH_TEXT, SUB_PATH_LONGTEXT, true )
set_section( N_( "Network settings" ), NULL )
add_integer( "mtu", MTU_DEFAULT, MTU_TEXT, MTU_LONGTEXT, true )
- add_obsolete_bool( "ipv6" ) /* since 1.2.0 */
- add_obsolete_bool( "ipv4" ) /* since 1.2.0 */
+ add_obsolete_bool( "ipv6" ) /* since 2.0.0 */
+ add_obsolete_bool( "ipv4" ) /* since 2.0.0 */
add_integer( "ipv4-timeout", 5 * 1000, TIMEOUT_TEXT,
TIMEOUT_LONGTEXT, true )
change_integer_range( 1, 65535 )
add_integer( "https-port", 8443, HTTPS_PORT_TEXT, HTTPS_PORT_LONGTEXT, true )
change_integer_range( 1, 65535 )
- add_string( "rtsp-host", NULL, RTSP_HOST_TEXT, HOST_LONGTEXT, true )
- add_integer( "rtsp-port", 8554, RTSP_PORT_TEXT, RTSP_PORT_LONGTEXT, true )
+ add_string( "rtsp-host", NULL, RTSP_HOST_TEXT, RTSP_HOST_LONGTEXT, true )
+ add_integer( "rtsp-port", 554, RTSP_PORT_TEXT, RTSP_PORT_LONGTEXT, true )
change_integer_range( 1, 65535 )
add_loadfile( "http-cert", NULL, HTTP_CERT_TEXT, CERT_LONGTEXT, true )
- add_obsolete_string( "sout-http-cert" ) /* since 1.2.0 */
+ add_obsolete_string( "sout-http-cert" ) /* since 2.0.0 */
add_loadfile( "http-key", NULL, HTTP_KEY_TEXT, KEY_LONGTEXT, true )
- add_obsolete_string( "sout-http-key" ) /* since 1.2.0 */
+ add_obsolete_string( "sout-http-key" ) /* since 2.0.0 */
add_loadfile( "http-ca", NULL, HTTP_CA_TEXT, CA_LONGTEXT, true )
- add_obsolete_string( "sout-http-ca" ) /* since 1.2.0 */
+ add_obsolete_string( "sout-http-ca" ) /* since 2.0.0 */
add_loadfile( "http-crl", NULL, HTTP_CRL_TEXT, CRL_LONGTEXT, true )
- add_obsolete_string( "sout-http-crl" ) /* since 1.2.0 */
+ add_obsolete_string( "sout-http-crl" ) /* since 2.0.0 */
set_section( N_( "Socks proxy") , NULL )
add_string( "socks", NULL,
CACHING_TEXT, CACHING_LONGTEXT, true )
change_integer_range( 0, 60000 )
change_safe()
- add_obsolete_integer( "vdr-caching" ) /* 1.2.0 */
+ add_obsolete_integer( "vdr-caching" ) /* 2.0.0 */
add_integer( "live-caching", DEFAULT_PTS_DELAY / 1000,
CAPTURE_CACHING_TEXT, CAPTURE_CACHING_LONGTEXT, true )
change_integer_range( 0, 60000 )
change_safe()
- add_obsolete_integer( "alsa-caching" ) /* 1.2.0 */
- add_obsolete_integer( "dshow-caching" ) /* 1.2.0 */
- add_obsolete_integer( "dv-caching" ) /* 1.2.0 */
- add_obsolete_integer( "dvb-caching" ) /* 1.2.0 */
- add_obsolete_integer( "eyetv-caching" ) /* 1.2.0 */
- add_obsolete_integer( "gnomevfs-caching" ) /* 1.2.0 */
- add_obsolete_integer( "jack-input-caching" ) /* 1.2.0 */
- add_obsolete_integer( "linsys-hdsdi-caching" ) /* 1.2.0 */
- add_obsolete_integer( "linsys-sdi-caching" ) /* 1.2.0 */
- add_obsolete_integer( "oss-caching" ) /* 1.2.0 */
- add_obsolete_integer( "pvr-caching" ) /* 1.2.0 */
- add_obsolete_integer( "screen-caching" ) /* 1.2.0 */
- add_obsolete_integer( "v4l2-caching" ) /* 1.2.0 */
+ add_obsolete_integer( "alsa-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "dshow-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "dv-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "dvb-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "eyetv-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "gnomevfs-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "jack-input-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "linsys-hdsdi-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "linsys-sdi-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "oss-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "pvr-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "screen-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "v4l2-caching" ) /* 2.0.0 */
add_integer( "disc-caching", DEFAULT_PTS_DELAY / 1000,
DISC_CACHING_TEXT, DISC_CACHING_LONGTEXT, true )
change_integer_range( 0, 60000 )
change_safe()
- add_obsolete_integer( "bd-caching" ) /* 1.2.0 */
- add_obsolete_integer( "bluray-caching" ) /* 1.2.0 */
- add_obsolete_integer( "cdda-caching" ) /* 1.2.0 */
- add_obsolete_integer( "dvdnav-caching" ) /* 1.2.0 */
- add_obsolete_integer( "dvdread-caching" ) /* 1.2.0 */
- add_obsolete_integer( "vcd-caching" ) /* 1.2.0 */
+ add_obsolete_integer( "bd-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "bluray-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "cdda-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "dvdnav-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "dvdread-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "vcd-caching" ) /* 2.0.0 */
add_integer( "network-caching", CLOCK_FREQ / 1000,
NETWORK_CACHING_TEXT, NETWORK_CACHING_LONGTEXT, true )
change_integer_range( 0, 60000 )
change_safe()
- add_obsolete_integer( "ftp-caching" ) /* 1.2.0 */
- add_obsolete_integer( "http-caching" ) /* 1.2.0 */
- add_obsolete_integer( "mms-caching" ) /* 1.2.0 */
- add_obsolete_integer( "realrtsp-caching" ) /* 1.2.0 */
- add_obsolete_integer( "rtp-caching" ) /* 1.2.0 */
- add_obsolete_integer( "rtsp-caching" ) /* 1.2.0 */
- add_obsolete_integer( "sftp-caching" ) /* 1.2.0 */
- add_obsolete_integer( "smb-caching" ) /* 1.2.0 */
- add_obsolete_integer( "tcp-caching" ) /* 1.2.0 */
- add_obsolete_integer( "udp-caching" ) /* 1.2.0 */
+ add_obsolete_integer( "ftp-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "http-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "mms-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "realrtsp-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "rtp-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "rtsp-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "sftp-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "smb-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "tcp-caching" ) /* 2.0.0 */
+ add_obsolete_integer( "udp-caching" ) /* 2.0.0 */
add_integer( "cr-average", 40, CR_AVERAGE_TEXT,
CR_AVERAGE_LONGTEXT, true )
ACCESS_OUTPUT_TEXT, ACCESS_OUTPUT_LONGTEXT, true )
add_integer( "ttl", -1, TTL_TEXT, TTL_LONGTEXT, true )
add_string( "miface", NULL, MIFACE_TEXT, MIFACE_LONGTEXT, true )
- add_obsolete_string( "miface-addr" )
+ add_obsolete_string( "miface-addr" ) /* since 2.0.0 */
add_integer( "dscp", 0, DSCP_TEXT, DSCP_LONGTEXT, true )
set_subcategory( SUBCAT_SOUT_PACKETIZER )
add_category_hint( N_("CPU"), CPU_CAT_LONGTEXT, true )
add_obsolete_bool( "fpu" )
#if defined( __i386__ ) || defined( __x86_64__ )
- add_obsolete_bool( "mmx" ) /* since 1.2.0 */
- add_obsolete_bool( "3dn" ) /* since 1.2.0 */
- add_obsolete_bool( "mmxext" ) /* since 1.2.0 */
- add_obsolete_bool( "sse" ) /* since 1.2.0 */
- add_obsolete_bool( "sse2" ) /* since 1.2.0 */
- add_obsolete_bool( "sse3" ) /* since 1.2.0 */
- add_obsolete_bool( "ssse3" ) /* since 1.2.0 */
- add_obsolete_bool( "sse41" ) /* since 1.2.0 */
- add_obsolete_bool( "sse42" ) /* since 1.2.0 */
+ add_obsolete_bool( "mmx" ) /* since 2.0.0 */
+ add_obsolete_bool( "3dn" ) /* since 2.0.0 */
+ add_obsolete_bool( "mmxext" ) /* since 2.0.0 */
+ add_obsolete_bool( "sse" ) /* since 2.0.0 */
+ add_obsolete_bool( "sse2" ) /* since 2.0.0 */
+ add_obsolete_bool( "sse3" ) /* since 2.0.0 */
+ add_obsolete_bool( "ssse3" ) /* since 2.0.0 */
+ add_obsolete_bool( "sse41" ) /* since 2.0.0 */
+ add_obsolete_bool( "sse42" ) /* since 2.0.0 */
#endif
#if defined( __powerpc__ ) || defined( __ppc__ ) || defined( __ppc64__ )
- add_obsolete_bool( "altivec" ) /* since 1.2.0 */
+ add_obsolete_bool( "altivec" ) /* since 2.0.0 */
#endif
/* Misc options */
set_section( N_("Plugins" ), NULL )
add_bool( "plugins-cache", true, PLUGINS_CACHE_TEXT,
PLUGINS_CACHE_LONGTEXT, true )
- add_obsolete_string( "plugin-path" )
- add_directory( "data-path", NULL, DATA_PATH_TEXT,
- DATA_PATH_LONGTEXT, true )
+ add_obsolete_string( "plugin-path" ) /* since 2.0.0 */
+ add_obsolete_string( "data-path" ) /* since 2.1.0 */
set_section( N_("Performance options"), NULL )