Commit 8f75e45a authored by Johan Bilien's avatar Johan Bilien

* doc/vlc-howto.sgml: Spelling mistakes, small updates, harmonization

                          with other documentations (thank you Alexis)
    * plugins/satellite/*: some fixes in options parsing (thank you Sam)
parent d2cd9fcc
...@@ -2,11 +2,11 @@ ...@@ -2,11 +2,11 @@
<linuxdoc><article> <linuxdoc><article>
<titlepag> <titlepag>
<title>VLC HOWTO</title> <title>VLC HOWTO</title>
<author>by the Videolan Team<tt><htmlurl url="mailto:videolan@videolan.org" name="videolan@videolan.org"></tt></author> <author>Originally written by Henri Fallon, maintained by Johan Bilien<tt><htmlurl url="mailto:jobi@videolan.org" name="<jobi@videolan.org>"></tt></author>
<date>v0.0.9, 16 april 2002</date> <date>v0.0.9, 16 april 2002</date>
<abstract> <abstract>
This document describes how to use the vlc (VideoLAN client) to read DVDs and mpeg files and DVDs. This document describes how to use the vlc (VideoLAN client) to read DVDs and mpeg files, locally or from a network.
</abstract> </abstract>
</titlepag> </titlepag>
...@@ -32,14 +32,59 @@ ...@@ -32,14 +32,59 @@
</sect1> </sect1>
<sect1> <sect1>
<heading>What is the vlc</heading> <heading>What is the VideoLAN project ?</heading>
<p> <p>
Vlc stands for VideoLAN client. It is the name of the program which is VideoLAN is a complete software solution for video streaming, developed
capable of decoding MPEG streams, and displaying them onto your screen, by students at the <htmlurl url="http://www.ecp.fr" name="Ecole Centrale
so you can watch you favourite movies, confortably sit in your armchair Paris"> and contributors from all over the world, under the General
:-). Public License (GPL). It has been designed for streaming MPEG 1 and MPEG
2 videos on local area networks (LAN), but it can be extended to
metropolitan or wide area networks (MAN, WAN),
thanks to the multicast technology.
The VideoLAN solution includes a server, which can stream video from
various sources (file, DVD, satellite, camera, ...), a client, which can
receive, decode and display MPEG 1 and MPEG 2 streams and, if necessary,
a channel server which tells automatically to the client the parameters
needed to receive the stream.
<verb>
DVD --->- Unicast/Broadcast/Multicast
\ ---
File --->-- -------- / \ --------
|->-| Server |=====>====| LAN |---->-----| Client |
Satellite ->-- | (VLS) | \ / | (VLC) |
/ -------- --- --------
MPEG2 -->- ^
encoder |
v
----------------
| Channel Server |
| (VLCS) |
----------------
</verb>
More details about the project can be found on the
<htmlurl url="http://www.videolan.org" name="VideoLAN Web site">.
</p> </p>
</sect1> </sect1>
<sect1>
<heading>The documentation of the project</heading>
<p>
There are four main documents :
<itemize>
<item>the <htmlurl
url="http://www.videolan.org/doc/videolan-quickstart/videolan-quickstart.html"
name="VideoLAN Quickstart">,
<item>the <htmlurl url="http://www.videolan.org/network/doc/videolan-howto.html"
name="VideoLAN HOWTO">,
<item>the <htmlurl url="http://www.videolan.org/vls/doc/vls-guide.html"
name="VideoLAN Server user guide">,
<item>this VideoLAN Client Howto.
</itemize>
The up-to-date version of these documents can be found on the <htmlurl
url="http://www.videolan.org/doc" name="VideoLAN Web Site">.
<sect1> <sect1>
<heading>Translated versions of this document</heading> <heading>Translated versions of this document</heading>
...@@ -55,6 +100,57 @@ ...@@ -55,6 +100,57 @@
</p> </p>
</sect1> </sect1>
<sect1>
<heading>Requirements</heading>
<sect2>
<heading>Operating system</heading>
<p>
VLC works under the following systems :
</p>
<p>
<itemize>
<item> Linux (all distributions, including iPAQ Familiar Linux)
<item> Windows (all 32bit versions)
<item> Mas OS X
<item> FreeBSD, NetBSD, OpenBSD, BSD/OS
<item> BeOS
<item> QNX RTOS
<item> Solaris
</itemize>
</p>
<p>
Please note that the Linux, Windows and MacOS X are generally the most
uptodate versions.
</p>
</sect2>
<sect2>
<heading>Software requirements</heading>
<p>
Depending on the outputs and inputs you are using, you may need
additionnal libraries. Please see <ref id="modules" name="description">.
</p>
<p>
For playing encrypted DVDs, you will need libdvdcss, which you can found
on this page :
<htmlurl name="http://www.videolan.org/libdvdcss/download.html"
url="http://www.videolan.org/libdvdcss/download.html">.
</p>
</sect2>
<sect2>
<heading>Hardware requirements</heading>
<p>
The hardware power needed depends a lot of the type of stream.
For reading a DVD, a CPU working at around 450 MHz is required.
</p>
<p>
VLC can benefits from hardware acceleration from modern video cards
for YUV transformation and window rescaling. it also uses MMX, MMX EXT,
SSE, 3Dnow! optimizations if available.
</p>
</sect2>
</sect1>
<sect1> <sect1>
<heading>Disclaimer</heading> <heading>Disclaimer</heading>
<p> <p>
...@@ -98,7 +194,7 @@ ...@@ -98,7 +194,7 @@
<heading>Which package to chose ?</heading> <heading>Which package to chose ?</heading>
<p> <p>
There are different packages because vlc has "plugins" which provide There are different packages because vlc has "plugins" which provide
features but also enlarge the executable and require external libs. features but also enlarge the executable and require external libraries.
</p> </p>
<p> <p>
SDL is a lib which allows you to have an accelerated video output. SDL is a lib which allows you to have an accelerated video output.
...@@ -124,7 +220,7 @@ ...@@ -124,7 +220,7 @@
</p> </p>
<p> <p>
Depending on the package you have downloaded, you may have dependency Depending on the package you have downloaded, you may have dependency
problems. You have to solve them, by installing the required libs. problems. You have to solve them, by installing the required libraries.
</p> </p>
</sect2> </sect2>
...@@ -137,7 +233,7 @@ ...@@ -137,7 +233,7 @@
</verb> </verb>
</p> </p>
<p> <p>
You may have to install external libs to meet dependencies, depending on You may have to install external libraries to meet dependencies, depending on
the package you downloaded (gnome, gtk, esd, ...). the package you downloaded (gnome, gtk, esd, ...).
</p> </p>
</sect2> </sect2>
...@@ -147,7 +243,7 @@ ...@@ -147,7 +243,7 @@
<p> <p>
Double-click on the archive. It should open your favorite archive extracter. Double-click on the archive. It should open your favorite archive extracter.
You can then execute the vlc from there, or extract the archive to a You can then execute the vlc from there, or extract the archive to a
diretory and run it from there. directory and run it from there.
</p> </p>
</sect2> </sect2>
...@@ -160,8 +256,9 @@ ...@@ -160,8 +256,9 @@
<sect2> <sect2>
<heading>Windows users</heading> <heading>Windows users</heading>
<p> <p>
Decompress the archive with your favourite extracter in a directory of your Launch the installer by double-clicking on it, and follow the installation
choice. instructions. Please note that in most cases you will need administrator
rights to install it under Windows NT, 2000 and XP
</p> </p>
</sect2> </sect2>
</sect1> </sect1>
...@@ -175,6 +272,10 @@ ...@@ -175,6 +272,10 @@
name="http://www.videolan.org/libdvdcss/download.html" name="http://www.videolan.org/libdvdcss/download.html"
url="http://www.videolan.org/libdvdcss/download.html"> url="http://www.videolan.org/libdvdcss/download.html">
</p> </p>
<p>
For Windows users, libdvdcss is statically linked in the
Windows binary, so you don't have to install it.
</p>
</sect1> </sect1>
<sect1> <sect1>
...@@ -209,7 +310,7 @@ ...@@ -209,7 +310,7 @@
<sect2> <sect2>
<heading>Windows users</heading> <heading>Windows users</heading>
<p> <p>
The path to your DVD drive usually is D: or E:. You may have a look The path to your DVD drive usually is D:\ or E:\. You may have a look
in "My Computer" and look to which letter your DVD drive is assigned. in "My Computer" and look to which letter your DVD drive is assigned.
</p> </p>
</sect2> </sect2>
...@@ -252,7 +353,7 @@ ...@@ -252,7 +353,7 @@
start. start.
</p> </p>
<p> <p>
If nothing appears and you are sure that a program is broadcasted in If nothing appears and you are sure that a program is streamed in
this channel, you may try once again, because a problem of communication this channel, you may try once again, because a problem of communication
with the channel server could have occured (in you launched vlc from with the channel server could have occured (in you launched vlc from
a terminal, you should see "Network error: no answer from vlcs"). a terminal, you should see "Network error: no answer from vlcs").
...@@ -328,7 +429,7 @@ ...@@ -328,7 +429,7 @@
</p> </p>
<p> <p>
In every tab, you may click on "Save" to store your settings in your In every tab, you may click on "Save" to store your settings in your
~/.videolan/vlrrc file. ~/.videolan/vlcrc file.
</p> </p>
<sect2> <sect2>
<heading>Interface tab</heading> <heading>Interface tab</heading>
...@@ -436,6 +537,8 @@ ...@@ -436,6 +537,8 @@
<verb> vlc udpstream:</verb> should be sufficient. If the stream <verb> vlc udpstream:</verb> should be sufficient. If the stream
is multicasted, you must specify the multicast address, for example is multicasted, you must specify the multicast address, for example
<verb> vlc udpstream:@239.255.255.42 </verb> <verb> vlc udpstream:@239.255.255.42 </verb>
<p>
To receive a http stream, start vlc with <tt>vlc &lt;your URL&gt;</tt>.
</p> </p>
...@@ -697,7 +800,7 @@ ...@@ -697,7 +800,7 @@
make make
</verb> </verb>
It should compile without any error. If there are, please check you It should compile without any error. If there are, please check you
have the required libs have the required libraries
installed on your system, as the configure script can't check them all. installed on your system, as the configure script can't check them all.
</p> </p>
<p> <p>
...@@ -731,7 +834,7 @@ ...@@ -731,7 +834,7 @@
<p> <p>
This is the basic x11 video output. It only requires a This is the basic x11 video output. It only requires a
working X11 server. You will need xlibs headers to compile it working X11 server. You will need xlibs headers to compile it
(xlibs-dev packet on Debian systems). (xlibs-dev package on Debian systems).
</p> </p>
</sect2> </sect2>
...@@ -937,6 +1040,13 @@ ...@@ -937,6 +1040,13 @@
This is the VideoCD input. This is the VideoCD input.
</p> </p>
</sect2> </sect2>
<sect2>
<heading>http</heading>
<p>default: enabled</p>
<p>
This is the http input. You can use it for Video On Demand.
</p>
</sect2>
<sect2> <sect2>
<heading>satellite</heading> <heading>satellite</heading>
<p>default: disabled</p> <p>default: disabled</p>
...@@ -1136,8 +1246,8 @@ ...@@ -1136,8 +1246,8 @@
<heading>Get more help</heading> <heading>Get more help</heading>
<p> <p>
First of all, it something seems to go wrong, read and try to First of all, it something seems to go wrong, read and try to
understand the error messages. If you are a confirmed user, you understand the error messages. You can have detailed messages by
may try the "-vvv" option which makes the vlc very verbose. choosing messages in the view menu, in GTK, Gnome and Win32 interfaces.
</p> </p>
<p> <p>
There is a FAQ page on our website : There is a FAQ page on our website :
......
...@@ -90,7 +90,7 @@ static int SatelliteOpen( input_thread_t * p_input ) ...@@ -90,7 +90,7 @@ static int SatelliteOpen( input_thread_t * p_input )
int i_freq = 0; int i_freq = 0;
int i_srate = 0; int i_srate = 0;
boolean_t b_pol = 0; boolean_t b_pol = 0;
int i_fec = 1; int i_fec = 0;
float f_fec = 1./2; float f_fec = 1./2;
boolean_t b_diseqc; boolean_t b_diseqc;
int i_lnb_lof1; int i_lnb_lof1;
...@@ -127,29 +127,50 @@ static int SatelliteOpen( input_thread_t * p_input ) ...@@ -127,29 +127,50 @@ static int SatelliteOpen( input_thread_t * p_input )
if( i_freq > 12999 || i_freq < 10000 ) if( i_freq > 12999 || i_freq < 10000 )
{ {
intf_WarnMsg( 1, "input: satellite: invalid frequency, using"\ intf_WarnMsg( 1, "input: satellite: invalid frequency, using "\
"default one" ); "default one" );
i_srate = config_GetIntVariable( "frequency" ); i_freq = config_GetIntVariable( "frequency" );
if( i_freq > 12999 || i_freq < 10000 )
{
intf_ErrMsg( "input: satellite: invalid default frequency" );
return -1;
}
} }
if( i_srate > 30000 || i_srate < 1000 ) if( i_srate > 30000 || i_srate < 1000 )
{ {
intf_WarnMsg( 1, "input: satellite: invalid symbol rate, using"\ intf_WarnMsg( 1, "input: satellite: invalid symbol rate, using "\
"default one" ); "default one" );
i_srate = config_GetIntVariable( "symbol-rate" ); i_srate = config_GetIntVariable( "symbol-rate" );
if( i_srate > 30000 || i_srate < 1000 )
{
intf_ErrMsg( "input: satellite: invalid default symbol rate" );
return -1;
}
} }
if( !b_pol && b_pol != 1 ) if( b_pol && b_pol != 1 )
{ {
intf_WarnMsg( 1, "input: satellite: invalid polarization, using"\ intf_WarnMsg( 1, "input: satellite: invalid polarization, using "\
"default one" ); "default one" );
b_pol = config_GetIntVariable( "polarization" ); b_pol = config_GetIntVariable( "polarization" );
fprintf(stderr, "%d\n", b_pol);
if( b_pol && b_pol != 1 )
{
intf_ErrMsg( "input: satellite: invalid default polarization" );
return -1;
}
} }
if( i_fec > 7 || i_fec < 1 ) if( i_fec > 7 || i_fec < 1 )
{ {
intf_WarnMsg( 1, "input: satellite: invalid FEC, using default one" ); intf_WarnMsg( 1, "input: satellite: invalid FEC, using default one " );
i_fec = config_GetIntVariable( "fec" ); i_fec = config_GetIntVariable( "fec" );
if( i_fec > 7 || i_fec < 1 )
{
intf_ErrMsg( "input: satellite: invalid default FEC" );
return -1;
}
} }
switch( i_fec ) switch( i_fec )
......
...@@ -38,16 +38,16 @@ void _M( demux_getfunctions )( function_list_t * p_function_list ); ...@@ -38,16 +38,16 @@ void _M( demux_getfunctions )( function_list_t * p_function_list );
* Build configuration tree. * Build configuration tree.
*****************************************************************************/ *****************************************************************************/
#define FREQ_TEXT N_("satellite transponder frequency") #define FREQ_TEXT N_("satellite default transponder frequency")
#define FREQ_LONGTEXT "" #define FREQ_LONGTEXT ""
#define POL_TEXT N_("satellite transponder polarization") #define POL_TEXT N_("satellite default transponder polarization")
#define POL_LONGTEXT "" #define POL_LONGTEXT ""
#define FEC_TEXT N_("satellite transponder FEC") #define FEC_TEXT N_("satellite default transponder FEC")
#define FEC_LONGTEXT "" #define FEC_LONGTEXT ""
#define SRATE_TEXT N_("satellite transponder symbol rate") #define SRATE_TEXT N_("satellite default transponder symbol rate")
#define SRATE_LONGTEXT "" #define SRATE_LONGTEXT ""
#define DISEQC_TEXT N_("use diseqc with antenna") #define DISEQC_TEXT N_("use diseqc with antenna")
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment