LDP/LDP/ref/docbook/VLC-User-Guide/gui.sgml

278 lines
9.6 KiB
Plaintext

<chapter id="gui"><title id="tgui">The Graphical User Interface</title>
<sect1><title>Opening a stream</title>
<para>To open a stream using the graphical interface, click on either
:</para>
<itemizedlist>
<listitem><para>"File" to open a file stored on your hard
drive.</para></listitem>
<listitem><para>"Disc" to read a DVD or a VCD.</para></listitem>
<listitem><para>"Network" to read a network UDP stream
or an HTTP stream.</para></listitem>
<listitem><para>"Satellite" to read directly from a satellite
card.</para></listitem>
</itemizedlist>
<para>These four buttons, as well as the ones located in the "File"
menu, actually open the same dialog box, but on different tabs.</para>
<sect2><title>The "open a stream" dialog box</title>
<para>You can specify directly the Media Resource Locator MRL, if you
know the syntax that you have to use, but you may also use the different
tabs, that will fill it automatically.</para>
<itemizedlist>
<listitem><para>For a <command>File</command>, this is very simple, you
only have to fill the path to the file.</para></listitem>
<listitem><para>For a <command>Disc</command>, you select
the type of the disk, the path to the drive (looks like
<filename>/dev/dvd</filename> on Unix, or <filename>D:</filename> on
Windows), and the starting title and chapter.</para></listitem>
<listitem><para>For a <command>Network stream</command> :
<itemizedlist>
<listitem><para>if you use unicast mode, select <command>UDP</command>
and the port used,</para>
<listitem><para>if you use multicast, select <command>UDP
multicast</command>, enter the multicast address and the port ;</para>
<listitem><para>if you have a channel information service with
mini-VLCS, select <command>Channel server</command>, and give its
address ;</para>
<listitem><para>if you use HTTP streaming
to do Video On Demand, select <command>HTTP</command> and give the
address of your stream.</para></listitem>
</itemizedlist>
<listitem><para>For a <command>Satellite stream</command>, you have to
give the frequency, the rate, the polarization, and the FEC of your
stream.</para></listitem>
</itemizedlist>
</sect2>
<sect2><title>Basic stream control</title>
<para>You have at your disposal all the classical control of a video
player. For example when playing local streams or HTTP streams, you can
pause, speed up or slow down the stream, go forth and back... Just use
the corresponding buttons. </para>
<para>To go fullscreen, you can select the right options in the
<emphasis>view</emphasis> menu, or press <keycap>f</keycap>. To go
back to the normal mode, press <keycap>f</keycap>.</para>
</sect2>
<sect2><title>DVD and VCD navigation</title>
<para>When reading a DVD or a VCD, you can change chapter and titles as
you wish either by using the right-click menu or by using the options in
the "Parameters" menu. These options are enabled only when you play a
disk, or a disk through the network. </para>
</sect2>
<sect2><title>Programs, languages and subtitles</title>
<para>When reading a multiprogram stream, you can change the current
program by selecting it in the "View/Programs" submenu on the bar, or by
using the "right click" menu from the video output window. You can also
change the title and the chapter by the same way.</para>
<para>In DVDs, if different angles are availables, they will be treated as
different programs.</para>
<para>At any time you can change the audio/subtitles channel using either the
"setting" menu from the interface or using the "right click" menu from
the video output window.</para>
</sect2>
</sect1>
<sect1><title>Preferences window</title>
<para>By choosing "Preferences" in the "Settings" menu, you will open
the preferences window. This window is generated dynamically according
to the modules that were compiled.</para>
<para>In every tab, you may click on "Save" to store your
settings in your configuration file. (you can find it in
<command>~/.vlc/vlcrc</command> on Unix/Linux systems, or in
<command>Application Data\vlc\vlcrc</command> </para>
<sect2><title>Interface tab</title>
<para>In that tab, you can select which interface you would like
to use on next start. Click on the choosen interface, click on
<command>Select</command> then on <command>Save</command>.</para>
<para>There can be some configuration options available by clicking
<command>Configure</command>. This depends on the interface
chosen.</para>
<para>There are also a few generic settings, like color message or
setting the verbosity level of the logs. You can also specify the
path to the interface or to the plugin if they are not in the default
directory. [FIX : compare with settings on other OS, where is the
default file?] </para>
</sect2>
<sect2><title>Audio tab</title>
<para> In this tab, you can select and configure the audio output
you would like to use on next start (this works juste like for the
interface). You may also specify other settings such as enabling
or disabling the audio output, the output volume level, the audio
frequency, the number of channels on output, add desynchronization, or
set audio output format and headphone spazialization effect.</para>
</sect2>
<sect2><title>Video tab</title>
<para>In this tab, you can select which video output will be used on
next start, and add a video filter module, which means a filter that
will alter the rendered image. For more information on modules, please
look the Modules section. You may also specify some video settings, such
as the window size, if you would like fullscreen display or the video
zoom.</para>
<para>By using the <command>adjust</command> video filter module, you
will be able to modify the Brightness, Contrast, Saturation and Hue of
the video output.</para>
<para>There are also specific modules as wall which cut the output in
many windows to make a video wall, transform module to rotate the image
or invert module to invert the colors (who said it's useless?)</para>
</sect2>
<sect2><title>Input tab</title>
<para>In this tab, you can enter the input method with options by
default that will be used on next start.</para>
<para>Note that these are only <emphasis>default options</emphasis>,
which means that they will be written in the appropriate field, but, you
can of course change them.</para>
<para>You can configure the default addresses and port for network
streaming :</para>
<itemizedlist>
<listitem><para>the server port for UDP streaming,</para></listitem>
<listitem><para>the server port for UDP multicast streaming</para></listitem>
<listitem><para>the channel server adress and the channel server if you have a channel information service based on mini-VLCS.</para></listitem>
</itemizedlist>
<para>Here you also can choose which network interface the videolan
client will use to get the stream and the address of this interface.</para>
<para>The other options allow you to choose audio, channel, subtitles,
the device of the DVD, the device of the VCD and the IP protocol of the
stream (IPv6 or IPv4).</para>
</sect2>
<sect2><title>Decoders tab</title>
<para>In this tab, you can select which decoder (codec) you want to use
for audio or video decoders. VLC normally automatically detects the
right codec to use, so be sure to know what you are doing.</para>
</sect2>
<sect2><title>Stream ouput</title>
<para>In this tab you can configure the stream output capabilities.</para>
<para>Stream output is a new feature of VLC which allow you to save
the stream that you are watching to a file, or to stream it in unicast or multicast.</para>
<para>This tab allows you to set up some options for this. You will
be able to select the muxer used for the stream, ie PS, TS or AVI. PS
and TS are parts of the MPEG norm. PS stands for Program Stream, it is
usually used for files, whereas TS stands for Transport Stream, which
is rather used for network streams. AVI means output to an AVI file or
stream.</para>
<para>You may also select the <emphasis>access output</emphasis>,
i.e. what the strem will be output to. You can choose
beetween <emphasis>UDP</emphasis> (network stream) or
<emphasis>file</emphasis>.</para>
<para>The Packetizer is the format of the output.</para>
<para>You can also enable or disable audio or video.</para>
</sect2>
<sect2><title>CPU tab</title>
<para>This tab is dedicated to enabling or disabling support for
CPU extensions: MMX support (every processors since Pentium MMX),
3D! Now Support (for AMD K6-2, K6-3, Athlon and Duron processors),
MMX EXT support, and SSE support (for Pentium III and Pentium IV
processors).</para>
</sect2>
<sect2><title>Playlist tab</title>
<para>In this tab, you can select some playlist options, such as looping
the playlist, automatically launching the playlist on VLC's start, enqueue
items in it or randomly read the files.</para>
</sect2>
<sect2><title>Miscellanous tab</title>
<para> In this tab, you can select which memcpy version you want to use.
Some of them uses MMX or 3Dnow! extensions. You can also select the
access module (module used to get the stream) and the the demux module
(used to ... demux the stream).</para>
</sect2>
</sect1>
<sect1><title>Miscellaneous</title>
<sect2><title>The Messages Window</title>
<para>This window is available by clicking on
<emphasis>Messages</emphasis> in the <emphasis>View</emphasis> menu. It
shows all the debug messages of VLC. If you have a problem with VLC,
don't hesitate to open this window, as it may contain an interesting
error message.</para>
</sect2>
<sect2><title>The Playlist</title>
<para>VLC includes a simple playlist management system. By using the
buttons which are in the playlist window, you can easily add or remove
streams (whether these are files, disks, network streams, or satellites
streams).</para>
</sect2>
</sect1>
</chapter>