<chapter id="settings">
<title>Configuration dialog</title>

<sect1 id="settings-overview">
<title>Overview</title>

<para>The <guilabel>&kplayer; Settings</guilabel> dialog allows you to control
most aspects of &kplayer;'s behavior, as well as choose options that are passed
to &mplayer; and control quality and performance of media playback.</para>

<para>Select <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
&kplayer;...</guimenuitem></menuchoice> to open the dialog box.</para>

<para>The dialog contains several sections which are selected by
<mousebutton>left</mousebutton> clicking one of the items on the left side of
the dialog box.</para>

<variablelist>

<varlistentry>
<term><link linkend="settings-general">General</link> section</term>
<listitem><para>Contains options that affect general &kplayer;
behavior.</para></listitem>
</varlistentry>

<varlistentry>
<term><link linkend="settings-playlist">Playlist</link> section</term>
<listitem><para>Contains advanced playlist options. The more basic
playlist options are available through &kplayer; menus and are described
in <link linkend="configuration-playlist">Playlist section</link> of the
Configuration chapter.</para></listitem>
</varlistentry>

<varlistentry>
<term><link linkend="settings-controls">Controls</link> section</term>
<listitem><para>Contains advanced options that control how your choices made
using various &kplayer; controls are applied and stored.</para>

<variablelist>

<varlistentry>
<term><link linkend="settings-progress">Progress</link> section</term>
<listitem><para>Contains options that affect the progress slider control
and the seeking function.</para></listitem>
</varlistentry>

<varlistentry>
<term><link linkend="settings-volume">Volume</link> section</term>
<listitem><para>Contains options that affect the volume slider
control.</para></listitem>
</varlistentry>

<varlistentry>
<term><link linkend="settings-contrast">Contrast</link> section</term>
<listitem><para>Contains options that affect the contrast slider
control.</para></listitem>
</varlistentry>

<varlistentry>
<term><link linkend="settings-brightness">Brightness</link> section</term>
<listitem><para>Contains options that affect the brightness slider
control.</para></listitem>
</varlistentry>

<varlistentry>
<term><link linkend="settings-hue">Hue</link> section</term>
<listitem><para>Contains options that affect the hue slider
control.</para></listitem>
</varlistentry>

<varlistentry>
<term><link linkend="settings-saturation">Saturation</link> section</term>
<listitem><para>Contains options that affect the saturation slider
control.</para></listitem>
</varlistentry>

<varlistentry>
<term><link linkend="settings-sliders">Sliders</link> section</term>
<listitem><para>Contains miscellaneous options that affect all slider
controls in &kplayer;.</para></listitem>
</varlistentry>

</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term><link linkend="settings-video">Video</link> section</term>
<listitem><para>Contains options that control video output.</para></listitem>
</varlistentry>

<varlistentry>
<term><link linkend="settings-audio">Audio</link> section</term>
<listitem><para>Contains options that control audio output.</para></listitem>
</varlistentry>

<varlistentry>
<term><link linkend="settings-subtitles">Subtitles</link> section</term>
<listitem><para>Contains options that control subtitle display.</para></listitem>
</varlistentry>

<varlistentry>
<term><link linkend="settings-messages">Messages</link> section</term>
<listitem><para>Contains options that affect the message log.</para></listitem>
</varlistentry>

<varlistentry>
<term><link linkend="settings-advanced">Advanced</link> section</term>
<listitem><para>Contains various options that affect advanced command line
parameters passed to &mplayer;, as well as interaction with &kde; I/O
Slaves.</para></listitem>
</varlistentry>

</variablelist>

<para>The buttons at the bottom of the dialog let you make choices about the
contents of all sections of the dialog.</para>

<variablelist>

<varlistentry>
<term><guibutton>OK</guibutton> button</term>
<listitem><para>Accepts your changes and closes the dialog.</para></listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Cancel</guibutton> button</term>
<listitem><para>Closes the dialog without saving the changes.</para></listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Apply</guibutton> button</term>
<listitem><para>Applies the changes without closing the dialog.</para></listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Defaults</guibutton> button</term>
<listitem><para>Restores all settings to their original, predefined values and
applies them.</para></listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Close</guibutton> button</term>
<listitem><para>After you choose <guibutton>Apply</guibutton> or
<guibutton>Defaults</guibutton>, the <guibutton>Cancel</guibutton> button
changes to <guibutton>Close</guibutton>. Clicking it closes the dialog
and discards changes you made since the last time changes were
applied.</para></listitem>
</varlistentry>

<varlistentry>
<term><guibutton>Help</guibutton> button</term>
<listitem><para>Opens this user manual and displays the section that describes
the currently selected section of the dialog.</para></listitem>
</varlistentry>

</variablelist>

<note><para>You can also click the small <guibutton>What's This</guibutton>
button with a question mark at the top right of the dialog and then click a
configuration option to get a brief explanation of it.</para>

<para>Clicking the rightmost button at the top of the dialog closes the dialog
discarding any unapplied changes.</para></note>

</sect1>

<sect1 id="settings-general">
<title><guilabel>General</guilabel> section</title>

<para>This section contains options that affect general &kplayer;
behavior.</para>

<mediaobject>
<imageobject>
<imagedata fileref="settings-general.png" format="PNG"/>
</imageobject>
</mediaobject>

<variablelist>

<varlistentry>
<term><guilabel>Resize main window automatically</guilabel></term>

<listitem><para>By default &kplayer; resizes the main window automatically
unless it is maximized or full screen. When &kplayer; loads and starts
playing a new video, it scales it in increments of 50% of the original
video size until the video width reaches the <guilabel>Minimum initial
video width</guilabel> setting. It also automatically resizes the window
to maintain the video aspect if that option is turned on.</para>

<para>If you would like to avoid automatic resizing and always keep the window
the size you make it, turn this option off. &kplayer; will then maintain the
video aspect by constraining the video within the window, as if the window was
maximized for example. You will also want to turn this option off if you get
problems coming back from full screen mode, like endless flickering for example.
But in that case you should also report the bug following instructions in
Reporting bugs HOWTO.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Minimum initial video width</guilabel></term>

<listitem><para>If <guilabel>Resize main window automatically</guilabel>
option is enabled, when &kplayer; loads and starts playing a new video,
it scales it in increments of 50% of the original video size until the
video width in pixels reaches this setting.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Recent file list size</guilabel></term>

<listitem><para>This option tells &kplayer; the maximum number of URLs
to put on the <guisubmenu>Recent Files</guisubmenu> submenu of the
<guimenu>File</guimenu> menu. When the number of URLs is exceeded, &kplayer;
will remove the oldest entries from the list.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Show Open dialog if started without file</guilabel></term>

<listitem><para>If this option is selected, if you start &kplayer; by itself,
without a file argument, it will display the <guilabel>Open File</guilabel>
dialog and let you choose a file to play. The <link linkend="starting">Starting
&kplayer;</link> section of this manual describes ways to start &kplayer;
without a file argument, while various ways to start &kplayer; with file
arguments are described in the <link linkend="playing">Playing
multimedia</link> section.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Show full path in window title</guilabel></term>

<listitem><para>If this option is selected, &kplayer; will display the full
path to the current file or the full URL for remote files in the main window
<link linkend="parts">title bar</link>. By default this option is turned off,
and &kplayer; will display only the file name without extension in the title
bar.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Disable screensaver while playing video</guilabel></term>

<listitem><para>If this option is selected and a screen saver is enabled in the
&kcontrolcenter;, &kplayer; will disable it while playing video and reenable it
when it stops playing video. When playing audio only files, &kplayer; will
leave your screen saver alone so it will work as usual.</para></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="settings-playlist">
<title><guilabel>Playlist</guilabel> section</title>

<para>This section contains advanced playlist options. The more basic playlist
options are available through &kplayer; menus and are described in <link
linkend="configuration-playlist">Playlist section</link> of the Configuration
chapter.</para>

<mediaobject>
<imageobject>
<imagedata fileref="settings-playlist.png" format="PNG"/>
</imageobject>
</mediaobject>

<variablelist>

<varlistentry>
<term><guilabel>Start playing new entries immediately</guilabel></term>

<listitem><para>This option tells &kplayer; whether to start playing new
items immediately when you add them to the playlist by using
<menuchoice><guimenu>File</guimenu><guimenuitem>Open</guimenuitem></menuchoice>
or
<menuchoice><guimenu>File</guimenu><guimenuitem>Open URL</guimenuitem></menuchoice>
commands, by dragging and dropping files onto &kplayer; window, or by
starting &kplayer; with file arguments. If this option is selected, &kplayer;
will start playing new items immediately if it is not currently playing any
existing item or if the <guilabel>only if player is idle</guilabel> option
is not selected. Else &kplayer; will put the new items on the playlist and
will only play them when their turn comes or when you manually select them
from the playlist.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>only if player is idle</guilabel></term>

<listitem><para>When this option is selected, &kplayer; will start playing
newly added playlist items immediately only if it is idle. If it is already
playing an existing item, it will put the new items on the playlist and will
only play them when their turn comes or when you manually select them from
the playlist. This option is only available when the <guilabel>Start playing
new entries immediately</guilabel> option is selected.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Allow duplicate entries</guilabel></term>

<listitem><para>If this option is selected, &kplayer; will let you add items
with identical URLs to the playlist. When the option is turned off and you add
new entries to the playlist, &kplayer; will remove any existing entries that
have the same URL as one of the new entries. Also if some of the new entries
have identical URLs, it will add only one for each URL.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Maximum number of entries</guilabel></term>

<listitem><para>If the number of items on the playlist exceeds this number,
&kplayer; will remove items from the top of the list.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Cache size limit</guilabel></term>

<listitem><para>It gives the maximum number of URLs for which &kplayer; will
remember their properties. If the number of items in the internal cache is
exceeded, &kplayer; will discard properties for the items that have not been
played for the longest time.</para></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="settings-controls">
<title><guilabel>Controls</guilabel> section</title>

<para>This section contains advanced options that control how your choices
made using various &kplayer; controls are applied and stored. For more
information on applying options to individual files see the File Properties
section of this manual.</para>

<mediaobject>
<imageobject>
<imagedata fileref="settings-controls.png" format="PNG"/>
</imageobject>
</mediaobject>

<variablelist>

<varlistentry>
<term><guilabel>Remember for current file any changes made with
Shift</guilabel></term>

<listitem><para>If this option is selected, when you adjust one of the
settings listed below while holding the &Shift; key down, &kplayer; will
apply the change only to the current file, store it in the file properties,
and revert to the setting prior to the change before loading another file.
You will be able to see and modify the stored setting in the File Properties
dialog. The next time the file is played, the setting stored in its
properties will again take effect until another file is loaded.</para>

<para>If the option is not selected or the change is made without pressing
the &Shift; key, and the corresponding option below is not selected, the
new setting will apply to the current file and all files played after it
until you change the setting again.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Always remember the following settings for each
file</guilabel></term>

<listitem><para>The following options let you choose what settings &kplayer;
will automatically remember in the file properties for each individual file.
By default it remembers subtitle URL, subtitle delay and audio delay, and
resets them for each new file, while other settings are preserved when
loading new files. Normally you should leave the options below at their
defaults. Settings for which the corresponding options below are not selected
can still be easily stored for each file by holding down the &Shift; key
while changing them, as long as the <guilabel>Remember for current file any
changes made with Shift</guilabel> option is selected.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Display size</guilabel></term>

<listitem><para>If this option is selected, &kplayer; will automatically
remember in the file properties for the currently loaded file the video
display size you choose by resizing the main KPlayer window or the video
area. As mentioned above, if this option is not selected, you can still
make &kplayer; remember the display size by holding down the &Shift; key,
but for that to work in this case it is important that you start holding
the &Shift; key before resizing.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Display aspect</guilabel></term>

<listitem><para>If this option is selected, &kplayer; will automatically
remember in the file properties for the currently loaded file the video
aspect you choose by using commands on <guimenu>View</guimenu>
menu.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Full screen</guilabel></term>

<listitem><para>If this option is selected, &kplayer; will automatically
remember in the file properties for the currently loaded file the full
screen option you choose on the <guimenu>View</guimenu>
menu.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Maximized</guilabel></term>

<listitem><para>If this option is selected, &kplayer; will automatically
remember the maximized window state in the file properties for the currently
loaded file.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Maintain aspect</guilabel></term>

<listitem><para>If this option is selected, &kplayer; will automatically
remember the maintain aspect setting in the file properties for the currently
loaded file.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Volume</guilabel></term>

<listitem><para>If this option is selected, &kplayer; will automatically
remember volume adjustments in the file properties for the currently loaded
file.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Audio delay</guilabel></term>

<listitem><para>If this option is selected, &kplayer; will automatically
remember the audio delay setting in the file properties for the currently
loaded file.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Frame drop</guilabel></term>

<listitem><para>If this option is selected, &kplayer; will automatically
remember the frame drop setting in the file properties for the currently
loaded file.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Contrast</guilabel></term>

<listitem><para>If this option is selected, &kplayer; will automatically
remember contrast adjustments in the file properties for the currently
loaded file.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Brightness</guilabel></term>

<listitem><para>If this option is selected, &kplayer; will automatically
remember brightness adjustments in the file properties for the currently
loaded file.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Hue</guilabel></term>

<listitem><para>If this option is selected, &kplayer; will automatically
remember hue adjustments in the file properties for the currently loaded
file.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Saturation</guilabel></term>

<listitem><para>If this option is selected, &kplayer; will automatically
remember saturation adjustments in the file properties for the currently
loaded file.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Subtitle URL</guilabel></term>

<listitem><para>If this option is selected, &kplayer; will automatically
remember in the file properties for the current file the subtitles you load
using <guimenuitem>Load Subtitles</guimenuitem> and <guimenuitem>Load
Subtitle URL</guimenuitem> commands on the <guimenu>File</guimenu> menu.
Also, if you unload the subtitles using the <guimenuitem>Unload
Subtitles</guimenuitem> command, &kplayer; will reset the <guilabel>Subtitle
URL</guilabel> property of the current file.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Subtitle visibility</guilabel></term>

<listitem><para>If this option is selected, &kplayer; will automatically
remember the subtitle visibility setting in the file properties for the
currently loaded file.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Subtitle position</guilabel></term>

<listitem><para>If this option is selected, &kplayer; will automatically
remember the subtitle vertical position in the file properties for the
currently loaded file.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Subtitle delay</guilabel></term>

<listitem><para>If this option is selected, &kplayer; will automatically
remember the subtitle delay setting in the file properties for the currently
loaded file.</para></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="settings-progress">
<title><guilabel>Progress</guilabel> subsection</title>

<para>This section contains options that affect the progress slider control
and the seeking function.</para>

<mediaobject>
<imageobject>
<imagedata fileref="settings-progress.png" format="PNG"/>
</imageobject>
</mediaobject>

<variablelist>

<varlistentry>
<term><guilabel>Normal seek amount</guilabel></term>

<listitem><para>This option tells &kplayer; how far to seek (move the
current playback position) forward or backward when using
<guimenuitem>Forward</guimenuitem> and <guimenuitem>Backward</guimenuitem>
commands on <guimenu>Player</guimenu> menu, either in seconds or in
percents of the time length of the file if it is known.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Fast seek amount</guilabel></term>

<listitem><para>This option tells &kplayer; how far to seek (move the
current playback position) forward or backward when using
<guimenuitem>Fast Forward</guimenuitem> and <guimenuitem>Fast
Backward</guimenuitem> commands on <guimenu>Player</guimenu> menu, either
in seconds or in percents of the time length of the file if it is
known.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Distance between slider marks</guilabel></term>

<listitem><para>This option gives the distance between tick marks on the
progress slider, in percents of the slider length.</para></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="settings-volume">
<title><guilabel>Volume</guilabel> subsection</title>

<para>This section contains options that affect the volume slider
control.</para>

<mediaobject>
<imageobject>
<imagedata fileref="settings-volume.png" format="PNG"/>
</imageobject>
</mediaobject>

<variablelist>

<varlistentry>
<term><guilabel>Minimum</guilabel></term>

<listitem><para>This option gives the lower limit on the sound volume
setting.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Maximum</guilabel></term>

<listitem><para>This option gives the upper limit on the sound volume
setting.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Distance between slider marks</guilabel></term>

<listitem><para>This option gives the distance between tick marks on the
volume slider, in percents of the slider length.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Adjustment amount</guilabel></term>

<listitem><para>This option tells &kplayer; by how much to adjust the
sound volume when using the <guimenuitem>Increase Volume</guimenuitem>
and <guimenuitem>Decrease Volume</guimenuitem> commands on the
<guisubmenu>Audio</guisubmenu> submenu of the <guimenu>Player</guimenu>
menu or the corresponding keyboard shortcuts.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Reset</guilabel></term>

<listitem><para>This option lets you reset the sound volume to a specific
setting every time before loading a new file or when starting
&kplayer;.</para></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="settings-contrast">
<title><guilabel>Contrast</guilabel> subsection</title>

<para>This section contains options that affect the contrast slider
control.</para>

<mediaobject>
<imageobject>
<imagedata fileref="settings-contrast.png" format="PNG"/>
</imageobject>
</mediaobject>

<variablelist>

<varlistentry>
<term><guilabel>Minimum</guilabel></term>

<listitem><para>This option gives the lower limit on the video contrast
setting.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Maximum</guilabel></term>

<listitem><para>This option gives the upper limit on the video contrast
setting.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Distance between slider marks</guilabel></term>

<listitem><para>This option gives the distance between tick marks on the
contrast slider, in percents of the slider length.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Adjustment amount</guilabel></term>

<listitem><para>This option tells &kplayer; by how much to adjust the
video contrast when using the <guimenuitem>Increase Contrast</guimenuitem>
and <guimenuitem>Decrease Contrast</guimenuitem> commands on the
<guisubmenu>Video</guisubmenu> submenu of the <guimenu>Player</guimenu>
menu or the corresponding keyboard shortcuts.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Reset</guilabel></term>

<listitem><para>This option lets you reset the video contrast to a specific
setting every time before loading a new file or when starting
&kplayer;.</para></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="settings-brightness">
<title><guilabel>Brightness</guilabel> subsection</title>

<para>This section contains options that affect the brightness slider
control.</para>

<mediaobject>
<imageobject>
<imagedata fileref="settings-brightness.png" format="PNG"/>
</imageobject>
</mediaobject>

<variablelist>

<varlistentry>
<term><guilabel>Minimum</guilabel></term>

<listitem><para>This option gives the lower limit on the video brightness
setting.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Maximum</guilabel></term>

<listitem><para>This option gives the upper limit on the video brightness
setting.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Distance between slider marks</guilabel></term>

<listitem><para>This option gives the distance between tick marks on the
brightness slider, in percents of the slider length.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Adjustment amount</guilabel></term>

<listitem><para>This option tells &kplayer; by how much to adjust the
video brightness when using the <guimenuitem>Increase Brightness</guimenuitem>
and <guimenuitem>Decrease Brightness</guimenuitem> commands on the
<guisubmenu>Video</guisubmenu> submenu of the <guimenu>Player</guimenu>
menu or the corresponding keyboard shortcuts.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Reset</guilabel></term>

<listitem><para>This option lets you reset the video brightness to a specific
setting every time before loading a new file or when starting
&kplayer;.</para></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="settings-hue">
<title><guilabel>Hue</guilabel> subsection</title>

<para>This section contains options that affect the hue slider
control.</para>

<mediaobject>
<imageobject>
<imagedata fileref="settings-hue.png" format="PNG"/>
</imageobject>
</mediaobject>

<variablelist>

<varlistentry>
<term><guilabel>Minimum</guilabel></term>

<listitem><para>This option gives the lower limit on the video hue
setting.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Maximum</guilabel></term>

<listitem><para>This option gives the upper limit on the video hue
setting.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Distance between slider marks</guilabel></term>

<listitem><para>This option gives the distance between tick marks on the
hue slider, in percents of the slider length.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Adjustment amount</guilabel></term>

<listitem><para>This option tells &kplayer; by how much to adjust the
video hue when using the <guimenuitem>Increase Hue</guimenuitem>
and <guimenuitem>Decrease Hue</guimenuitem> commands on the
<guisubmenu>Video</guisubmenu> submenu of the <guimenu>Player</guimenu>
menu or the corresponding keyboard shortcuts.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Reset</guilabel></term>

<listitem><para>This option lets you reset the video hue to a specific
setting every time before loading a new file or when starting
&kplayer;.</para></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="settings-saturation">
<title><guilabel>Saturation</guilabel> subsection</title>

<para>This section contains options that affect the saturation slider
control.</para>

<mediaobject>
<imageobject>
<imagedata fileref="settings-saturation.png" format="PNG"/>
</imageobject>
</mediaobject>

<variablelist>

<varlistentry>
<term><guilabel>Minimum</guilabel></term>

<listitem><para>This option gives the lower limit on the video saturation
setting.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Maximum</guilabel></term>

<listitem><para>This option gives the upper limit on the video saturation
setting.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Distance between slider marks</guilabel></term>

<listitem><para>This option gives the distance between tick marks on the
saturation slider, in percents of the slider length.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Adjustment amount</guilabel></term>

<listitem><para>This option tells &kplayer; by how much to adjust the
video saturation when using the <guimenuitem>Increase Saturation</guimenuitem>
and <guimenuitem>Decrease Saturation</guimenuitem> commands on the
<guisubmenu>Video</guisubmenu> submenu of the <guimenu>Player</guimenu>
menu or the corresponding keyboard shortcuts.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Reset</guilabel></term>

<listitem><para>This option lets you reset the video saturation to a specific
setting every time before loading a new file or when starting
&kplayer;.</para></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="settings-sliders">
<title><guilabel>Sliders</guilabel> subsection</title>

<para>This section contains miscellaneous options that affect all slider
controls in &kplayer;.</para>

<mediaobject>
<imageobject>
<imagedata fileref="settings-sliders.png" format="PNG"/>
</imageobject>
</mediaobject>

<variablelist>

<varlistentry>
<term><guilabel>Minimum slider length</guilabel></term>

<listitem><para>This option gives the minimum length of a slider control.
It affects all sliders embedded in toolbars.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Preferred slider length</guilabel></term>

<listitem><para>This option gives the preferred length of a slider control.
It affects both popup sliders and sliders embedded in toolbars.</para></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="settings-video">
<title><guilabel>Video</guilabel> section</title>

<para>This section contains options that control video output.</para>

<mediaobject>
<imageobject>
<imagedata fileref="settings-video.png" format="PNG"/>
</imageobject>
</mediaobject>

<variablelist>

<varlistentry>
<term><guilabel>Driver</guilabel></term>

<listitem><para>This option lists available video outputs and lets you
choose the one to use for playing video.</para>

<para>Recommended choice depends on the video card you have. If you have a
Matrox card, try XMGA, for other cards either XVidix (if supported) or XVideo
provide the best quality. With NVidia drivers you can also try XVMC output.
If after trying hard you cannot make any of these work, you can use X11
output as the last resort. Video outputs that open a separate window instead
of using &kplayer; video area are not recommended.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Fall back on others</guilabel></term>

<listitem><para>This option specifies whether to use other video outputs
if the chosen one fails.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Device</guilabel></term>

<listitem><para>This option specifies the video device to use for the selected
video output. Leave it blank to use the default device.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Codec</guilabel></term>

<listitem><para>This option lists the available video codecs and lets you
choose the one to be used for decoding video. <guilabel>Auto</guilabel> is the
recommended choice, it lets &mplayer; decide which codec to use automatically.
If you need to tell &mplayer; to use a particular codec for a particular file
or stream, set this option in the File Properties.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Fall back on others</guilabel></term>

<listitem><para>This option specifies whether to use other video codecs
if the chosen one fails.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Scaler</guilabel></term>

<listitem><para>This option specifies the video scaler to be used when doing
software scaling. Software scaling consumes considerable amount of system
resources, so unless you have plenty of them and software scaling gives you
better image quality, you should choose a video output above that uses
hardware scaling.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Enable double buffering</guilabel></term>

<listitem><para>This option lets you choose whether double buffering should
be used for video output. This option is recommended, it gives smoother
display in many cases.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Enable direct rendering</guilabel></term>

<listitem><para>This option lets you choose whether direct rendering should
be used for video output. This option may give performance improvement, but
may also cause video display problems, for example when used along with
double buffering option or when playing with subtitles.</para></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="settings-audio">
<title><guilabel>Audio</guilabel> section</title>

<para>This section contains options that control audio output.</para>

<mediaobject>
<imageobject>
<imagedata fileref="settings-audio.png" format="PNG"/>
</imageobject>
</mediaobject>

<variablelist>

<varlistentry>
<term><guilabel>Driver</guilabel></term>

<listitem><para>This option lists available audio outputs and lets you
choose the one to use for playing sound.</para>

<para>Recommended choices are OSS (the default) and ALSA (recommended when
available). ARTS and SDL are not recommended. <guilabel>Auto</guilabel>
will let &mplayer; choose an audio output according to its own
configuration.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Fall back on others</guilabel></term>

<listitem><para>This option specifies whether to use other audio outputs
if the chosen one fails.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Device</guilabel></term>

<listitem><para>This option specifies the audio device to use for the selected
audio output. Leave it blank to use the default device.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Codec</guilabel></term>

<listitem><para>This option lists the available audio codecs and lets you
choose the one to be used for decoding audio. <guilabel>Auto</guilabel> is the
recommended choice, it lets &mplayer; decide which codec to use automatically.
If you need to tell &mplayer; to use a particular codec for a particular file
or stream, set this option in the File Properties.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Fall back on others</guilabel></term>

<listitem><para>This option specifies whether to use other audio codecs
if the chosen one fails.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Delay adjustment amount</guilabel></term>

<listitem><para>This option tells &kplayer; by how much to adjust the
audio delay when using the <guimenuitem>Increase Delay</guimenuitem>
and <guimenuitem>Decrease Delay</guimenuitem> commands on the
<guisubmenu>Audio</guisubmenu> submenu of the <guimenu>Player</guimenu>
menu or the corresponding keyboard shortcuts.</para></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="settings-subtitles">
<title><guilabel>Subtitles</guilabel> section</title>

<para>This section contains options that control subtitle display.</para>

<mediaobject>
<imageobject>
<imagedata fileref="settings-subtitles.png" format="PNG"/>
</imageobject>
</mediaobject>

<variablelist>

<varlistentry>
<term><guilabel>Position adjustment amount</guilabel></term>

<listitem><para>This option tells &kplayer; how far to move the subtitles, in
percents of the video height, when using the <guimenuitem>Move Up</guimenuitem>
and <guimenuitem>Move Down</guimenuitem> commands on the
<guisubmenu>Subtitles</guisubmenu> submenu of the <guimenu>Player</guimenu>
menu or the corresponding keyboard shortcuts.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Delay adjustment amount</guilabel></term>

<listitem><para>This option tells &kplayer; by how much to adjust the
subtitle delay when using the <guimenuitem>Increase Delay</guimenuitem>
and <guimenuitem>Decrease Delay</guimenuitem> commands on the
<guisubmenu>Subtitles</guisubmenu> submenu of the <guimenu>Player</guimenu>
menu or the corresponding keyboard shortcuts.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Autoload subtitles</guilabel></term>

<listitem><para>This option tells &kplayer; whether to automatically load
subtitle types selected below by looking for subtitle files with the same
name as the currently loaded file and the corresponding subtitle
extension.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>aqt</guilabel></term>

<listitem><para>This option tells &kplayer; whether to automatically load
subtitle files with aqt and AQT extensions.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>jss</guilabel></term>

<listitem><para>This option tells &kplayer; whether to automatically load
subtitle files with jss and JSS extensions.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>rt</guilabel></term>

<listitem><para>This option tells &kplayer; whether to automatically load
subtitle files with rt and RT extensions.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>smi</guilabel></term>

<listitem><para>This option tells &kplayer; whether to automatically load
subtitle files with smi and SMI extensions.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>srt</guilabel></term>

<listitem><para>This option tells &kplayer; whether to automatically load
subtitle files with srt and SRT extensions.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>ssa</guilabel></term>

<listitem><para>This option tells &kplayer; whether to automatically load
subtitle files with ssa and SSA extensions.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>sub</guilabel></term>

<listitem><para>This option tells &kplayer; whether to automatically load
subtitle files with sub and SUB extensions.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>txt</guilabel></term>

<listitem><para>This option tells &kplayer; whether to automatically load
subtitle files with txt and TXT extensions.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>utf</guilabel></term>

<listitem><para>This option tells &kplayer; whether to automatically load
subtitle files with utf and UTF extensions.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>other</guilabel></term>

<listitem><para>This option tells &kplayer; whether to automatically load
subtitle files with extensions you enter in text field below, separated
by commas, semicolons, colons, periods or spaces.</para></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="settings-messages">
<title><guilabel>Messages</guilabel> section</title>

<para>This section contains options that affect the message log.</para>

<mediaobject>
<imageobject>
<imagedata fileref="settings-messages.png" format="PNG"/>
</imageobject>
</mediaobject>

<variablelist>

<varlistentry>
<term><guilabel>Show if a file fails to play</guilabel></term>

<listitem><para>This option tells &kplayer; whether to automatically show the
<link linkend="parts-message-log">message log</link> if &kplayer; encounters an
error when trying to play a file. If this option is enabled, &kplayer; will show
the log and scroll to the last messages from the first file with an error, so
you can see what the error was. If the option is disabled, &kplayer; will
instead display the word <guilabel>Error</guilabel> in the left portion of the
<link linkend="parts-status-bar">status bar</link>, and then you can
<mousebutton>left</mousebutton> click it to show the message
log.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Show before playing</guilabel></term>

<listitem><para>This option tells &kplayer; whether to show message log
before starting to play a file. Select it if you want to always see &mplayer;
messages while a file is being played.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Show after playing</guilabel></term>

<listitem><para>This option tells &kplayer; whether to show message log
after a file finishes playing. Select it if you want to always see &mplayer;
messages after playing a file.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Clear before playing</guilabel></term>

<listitem><para>This option tells &kplayer; whether to remove all previous
messages before starting to play a file. If you select this option and also
select the option to show messages on error, &kplayer; will keep messages
from errored files until playback stops so you have a chance to review the
errors.</para></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="settings-advanced">
<title><guilabel>Advanced</guilabel> section</title>

<para>This section contains various options that affect advanced command
line parameters passed to &mplayer;, as well as interaction with &kde;
I/O Slaves.</para>

<mediaobject>
<imageobject>
<imagedata fileref="settings-advanced.png" format="PNG"/>
</imageobject>
</mediaobject>

<variablelist>

<varlistentry>
<term><guilabel>Executable path</guilabel></term>

<listitem><para>This option tells &kplayer; where to find the &mplayer;
executable. It is either an absolute path or a name to look for in the
current environment path.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Additional command line arguments</guilabel></term>

<listitem><para>This option gives additional options that will be passed
to &mplayer; on the command line. See mplayer(1) manpage for a complete
list of possible options. You can also set this option for individual file
or URL in File Properties.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Frame drop</guilabel></term>

<listitem><para>If your system is too slow to play a file, &mplayer; can
drop some frames so playback does not slow down. <guilabel>None</guilabel>
disables dropping, <guilabel>Soft</guilabel> drops less frames, and
<guilabel>Hard</guilabel> drops more frames and may sometimes break decoding.
You can also set this option for individual file or URL in File
Properties.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Cache</guilabel></term>

<listitem><para>This option lets you choose whether to use cache and set its
size. <guilabel>Auto</guilabel> lets &mplayer; use the its own configuration,
<guilabel>None</guilabel> tells &mplayer; to use no cache, and <guilabel>Set
Size</guilabel> lets you set a specific size. You can also set this option
for individual file or URL in File Properties.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Build new index</guilabel></term>

<listitem><para>This option lets you choose whether to build new index for
seeking. <guilabel>Yes</guilabel> builds an index if the file does not have
it, <guilabel>No</guilabel> tells &mplayer; not to build an index, and
<guilabel>Force</guilabel> tells it to always build an index. You can also
choose this option for individual file or URL in File
Properties.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Use temporary file for playing from KIOSlave</guilabel></term>

<listitem><para>This option lets you choose whether to use a temporary file
for playing from &kde; I/O Slaves. This option has no effect for URLs passed
directly to &mplayer;. You can also choose it for individual file or URL in
File Properties.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Use KIOSlave for</guilabel> <guilabel>HTTP</guilabel></term>

<listitem><para>This option lets you choose whether to use a &kde; I/O Slave
to play HTTP URLs. You can also choose this option for individual file or
stream in File Properties.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Use KIOSlave for</guilabel> <guilabel>FTP</guilabel></term>

<listitem><para>This option lets you choose whether to use a &kde; I/O Slave
to play FTP URLs. You can also choose this option for individual file or
stream in File Properties.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Use KIOSlave for</guilabel> <guilabel>SMB</guilabel></term>

<listitem><para>This option lets you choose whether to use a &kde; I/O Slave
to play Samba URLs. You can also choose this option for individual file or
stream in File Properties.</para></listitem>
</varlistentry>

</variablelist>

</sect1>

</chapter>
