<chapter id="commands">
<title>Command reference</title>

<note><para>The shortcut key combinations shown in this chapter are the default
ones. They can of course be
<link linkend="configuration-shortcuts">changed</link>.</para></note>

<sect1 id="menubar">
<title>Menu bar</title>

<para>Note that many menu entries are only enabled when they are applicable
to the file currently loaded in &kplayer;. For example, the items on the
<guimenu>View</guimenu> menu will be disabled when playing audio only
files.</para>

<sect2 id="menu-file">
<title><guimenu>File</guimenu> menu</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo>
</shortcut>
<guimenuitem>Open...</guimenuitem>
</menuchoice></term>
<listitem><para>Displays the standard <guilabel>Open File</guilabel> dialog
and lets you choose a file or several files to put on the playlist and start
playing.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo>
</shortcut>
<guimenuitem>Open URL...</guimenuitem>
</menuchoice></term>
<listitem><para>Displays the standard <guilabel>Open URL</guilabel> dialog
and lets you type or paste in a <acronym>URL</acronym> to put on the playlist
and start playing. The <acronym>URL</acronym> can be a remote network location,
a local file path, a &kde; <acronym>I/O</acronym> Slave <acronym>URL</acronym>
or a special <acronym>URL</acronym> for playing from various types of
<link linkend="howto-devices">devices</link> like <acronym>DVD</acronym>, video
<acronym>CD</acronym>, audio <acronym>CD</acronym>, <acronym>TV</acronym> or
<acronym>DVB</acronym>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guisubmenu>Open Recent</guisubmenu>
</menuchoice></term>
<listitem><para>Displays a submenu listing the most recently opened files and
<acronym>URL</acronym>s and lets you choose one to put on the playlist and start
playing.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
</shortcut>
<guimenuitem>Load Subtitles...</guimenuitem>
</menuchoice></term>
<listitem><para>Displays the standard <guilabel>Open File</guilabel> dialog
and lets you choose a subtitle file to use with the current file or
<acronym>URL</acronym>. If you load subtitles when video is playing, &kplayer;
will restart playback with the subtitles. By default it will also remember the
subtitles you choose in the current file
<link linkend="properties">properties</link>. This command is available for
video files.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Load Subtitle URL...</guimenuitem>
</menuchoice></term>
<listitem><para>Displays the standard <guilabel>Open URL</guilabel> dialog and
lets you type or paste in a subtitle <acronym>URL</acronym> to use with the
current file or <acronym>URL</acronym>. If you load subtitles when video is
playing, &kplayer; will restart playback with the subtitles. By default it will
also remember the subtitles you choose in the current file
<link linkend="properties">properties</link>. This command is available for
video files.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Unload Subtitles</guimenuitem>
</menuchoice></term>
<listitem><para>Unloads the currently loaded subtitles, and if video is
playing, restarts playback without subtitles. This command is available
when subtitles are loaded.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Clear Log</guimenuitem>
</menuchoice></term>
<listitem><para>Removes all messages from the
<link linkend="parts-message-log">message log</link>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Alt;&Enter;</keycombo>
</shortcut>
<guimenuitem>Properties...</guimenuitem>
</menuchoice></term>
<listitem><para>Opens the <link linkend="properties">File Properties</link>
dialog that lets you choose many options specific to the currently loaded file.
See the <link linkend="howto-properties">File properties micro-HOWTO</link>
for details.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
</shortcut>
<guimenuitem>Quit</guimenuitem>
</menuchoice></term>
<listitem><para>Saves the playlist and all settings, stops playing and closes
&kplayer;.</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="menu-view">
<title><guimenu>View</guimenu> menu</title>

<note><para>Commands on this menu are only available for video files.</para></note>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo>
</shortcut>
<guimenuitem>Full Screen</guimenuitem>
</menuchoice></term>
<listitem><para>Switches to <link linkend="howto-full-screen">full screen</link>
video display and back to normal mode. Double clicking the video area also
switches between full screen and normal window size.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>+</keycap></keycombo>
</shortcut>
<guimenuitem>Zoom In</guimenuitem>
</menuchoice></term>
<listitem><para>Enlarges the video area by one half of the original
video size of the current file.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>-</keycap></keycombo>
</shortcut>
<guimenuitem>Zoom Out</guimenuitem>
</menuchoice></term>
<listitem><para>Reduces the video area by one half of the original
video size of the current file.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Zoom to 50&percnt;</guimenuitem>
</menuchoice></term>
<listitem><para>Resizes the video area to one half of the original
video size of the current file.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;&Backspace;</keycombo>
</shortcut>
<guimenuitem>Zoom to 100&percnt;</guimenuitem>
</menuchoice></term>
<listitem><para>Resizes the video area to the original
video size of the current file.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Zoom to 150&percnt;</guimenuitem>
</menuchoice></term>
<listitem><para>Resizes the video area to 150&percnt; of the original
video size of the current file.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Zoom to 200&percnt;</guimenuitem>
</menuchoice></term>
<listitem><para>Resizes the video area to twice the original
video size of the current file.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Zoom to 250&percnt;</guimenuitem>
</menuchoice></term>
<listitem><para>Resizes the video area to 250&percnt; of the original
video size of the current file.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Zoom to 300&percnt;</guimenuitem>
</menuchoice></term>
<listitem><para>Resizes the video area to thrice the original
video size of the current file.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Maintain Original Aspect</guimenuitem>
</menuchoice></term>
<listitem><para>Toggles the option to maintain the original video aspect
ratio of the current file.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Maintain Current Aspect</guimenuitem>
</menuchoice></term>
<listitem><para>Toggles the option to maintain the current video aspect
ratio.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Force 4 to 3 Aspect</guimenuitem>
</menuchoice></term>
<listitem><para>Toggles the option to maintain four to three video aspect
ratio.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Force 16 to 9 Aspect</guimenuitem>
</menuchoice></term>
<listitem><para>Toggles the option to maintain sixteen to nine video aspect
ratio.</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="menu-player">
<title><guimenu>Player</guimenu> menu</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
&Enter;
</shortcut>
<guimenuitem>Play</guimenuitem>
</menuchoice></term>
<listitem><para>Starts playback of the current file. If the player has been
paused, this command resumes playback. This command is available when
a file is loaded.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>Space</keycap>
</shortcut>
<guimenuitem>Pause</guimenuitem>
</menuchoice></term>
<listitem><para>Pauses or resumes playback of the current file. This command
is available when the player is not idle.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
&Esc;
</shortcut>
<guimenuitem>Stop</guimenuitem>
</menuchoice></term>
<listitem><para>Stops playback of the current file. This command
is available when the player is not idle.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>Right Arrow</keycap>
</shortcut>
<guimenuitem>Forward</guimenuitem>
</menuchoice></term>
<listitem><para>Moves playback forward by one percent of the time length of the
current file. This command is available when playing a file.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>Right Arrow</keycap></keycombo>
</shortcut>
<guimenuitem>Fast Forward</guimenuitem>
</menuchoice></term>
<listitem><para>Moves playback forward by ten percent of the time length of the
current file. This command is available when playing a file.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>Left Arrow</keycap>
</shortcut>
<guimenuitem>Backward</guimenuitem>
</menuchoice></term>
<listitem><para>Moves playback backward by one percent of the time length of the
current file. This command is available when playing a file.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>Left Arrow</keycap></keycombo>
</shortcut>
<guimenuitem>Fast Backward</guimenuitem>
</menuchoice></term>
<listitem><para>Moves playback backward by ten percent of the time length of the
current file. This command is available when playing a file.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>Home</keycap></keycombo>
</shortcut>
<guimenuitem>Back to Start</guimenuitem>
</menuchoice></term>
<listitem><para>Moves playback to the beginning of the current file.
This command is available when playing a file.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Soft Frame Dropping</guimenuitem>
</menuchoice></term>
<listitem><para>Toggles the soft frame dropping option. If your system is too
slow to play a file, &mplayer; can drop some frames so playback does not slow
down. The soft option drops frames less agressively than the hard one, and
should not cause playback problems. The <guilabel>Frame drop</guilabel> option
can also be set on the <guilabel>Advanced</guilabel> page either globally in
<link linkend="settings-advanced">&kplayer; Settings</link> or for a particular
file in the <link linkend="properties-advanced">File
Properties</link>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Hard Frame Dropping</guimenuitem>
</menuchoice></term>
<listitem><para>Toggles the hard frame dropping option. If your system is too
slow to play a file, &mplayer; can drop some frames so playback does not slow
down. The hard option drops frames more agressively than the soft one, and may
sometimes break decoding. The <guilabel>Frame drop</guilabel> option can also
be set on the <guilabel>Advanced</guilabel> page either globally in
<link linkend="settings-advanced">&kplayer; Settings</link> or for a particular
file in the <link linkend="properties-advanced">File
Properties</link>.</para></listitem>
</varlistentry>

</variablelist>

<sect3 id="submenu-audio">
<title><guisubmenu>Audio</guisubmenu> submenu</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>Down Arrow</keycap>
</shortcut>
<guimenuitem>Decrease Volume</guimenuitem>
</menuchoice></term>
<listitem><para>Decreases the sound volume.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>Up Arrow</keycap>
</shortcut>
<guimenuitem>Increase Volume</guimenuitem>
</menuchoice></term>
<listitem><para>Increases the sound volume.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>\</keycap></keycombo>
</shortcut>
<guimenuitem>Mute</guimenuitem>
</menuchoice></term>
<listitem><para>Turns the sound on or off.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>]</keycap></keycombo>
</shortcut>
<guimenuitem>Decrease Delay</guimenuitem>
</menuchoice></term>
<listitem><para>Decreases the delay of sound relative to video.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>[</keycap></keycombo>
</shortcut>
<guimenuitem>Increase Delay</guimenuitem>
</menuchoice></term>
<listitem><para>Increases the delay of sound relative to video.</para></listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="submenu-video">
<title><guisubmenu>Video</guisubmenu> submenu</title>

<note><para>This menu is only available for video files.</para></note>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>1</keycap></keycombo>
</shortcut>
<guimenuitem>Decrease Contrast</guimenuitem>
</menuchoice></term>
<listitem><para>Decreases the video contrast.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>2</keycap></keycombo>
</shortcut>
<guimenuitem>Increase Contrast</guimenuitem>
</menuchoice></term>
<listitem><para>Increases the video contrast.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>3</keycap></keycombo>
</shortcut>
<guimenuitem>Decrease Brightness</guimenuitem>
</menuchoice></term>
<listitem><para>Decreases the video brightness.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>4</keycap></keycombo>
</shortcut>
<guimenuitem>Increase Brightness</guimenuitem>
</menuchoice></term>
<listitem><para>Increases the video brightness.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>5</keycap></keycombo>
</shortcut>
<guimenuitem>Decrease Hue</guimenuitem>
</menuchoice></term>
<listitem><para>Decreases the video hue.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>6</keycap></keycombo>
</shortcut>
<guimenuitem>Increase Hue</guimenuitem>
</menuchoice></term>
<listitem><para>Increases the video hue.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>7</keycap></keycombo>
</shortcut>
<guimenuitem>Decrease Saturation</guimenuitem>
</menuchoice></term>
<listitem><para>Decreases the video saturation.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>8</keycap></keycombo>
</shortcut>
<guimenuitem>Increase Saturation</guimenuitem>
</menuchoice></term>
<listitem><para>Increases the video saturation.</para></listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="submenu-subtitles">
<title><guisubmenu>Subtitles</guisubmenu> submenu</title>

<note><para>This menu is only available when subtitles are loaded.</para></note>

<variablelist>

<varlistentry>
<term><menuchoice>
<guimenuitem>Show</guimenuitem>
</menuchoice></term>
<listitem><para>Shows or hides the subtitles.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>,</keycap></keycombo>
</shortcut>
<guimenuitem>Move Down</guimenuitem>
</menuchoice></term>
<listitem><para>Moves the subtitles down.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>.</keycap></keycombo>
</shortcut>
<guimenuitem>Move Up</guimenuitem>
</menuchoice></term>
<listitem><para>Moves the subtitles up.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>'</keycap></keycombo>
</shortcut>
<guimenuitem>Decrease Delay</guimenuitem>
</menuchoice></term>
<listitem><para>Decreases the delay of subtitles relative to video.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>;</keycap></keycombo>
</shortcut>
<guimenuitem>Increase Delay</guimenuitem>
</menuchoice></term>
<listitem><para>Increases the delay of subtitles relative to video.</para></listitem>
</varlistentry>

</variablelist>

</sect3>

</sect2>

<sect2 id="menu-playlist">
<title><guimenu>Playlist</guimenu> menu</title>

<para>For a detailed description of the playlist feature see the
<link linkend="howto-playlist">Playlist micro-HOWTO</link>.</para>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo>
</shortcut>
<guimenuitem>Show Playlist</guimenuitem>
</menuchoice></term>
<listitem><para>Shows or hides the
<link linkend="parts-toolbar-playlist">playlist
toolbar</link>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo>
</shortcut>
<guimenuitem>Show Editor</guimenuitem>
</menuchoice></term>
<listitem><para>Shows or hides the
<link linkend="parts-playlist-editor">playlist editor</link>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Show Toolbar</guimenuitem>
</menuchoice></term>
<listitem><para>Shows or hides the <link linkend="parts-toolbar-editor">playlist
editor toolbar</link>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Alt;<keycap>Right Arrow</keycap></keycombo>
</shortcut>
<guimenuitem>Next</guimenuitem>
</menuchoice></term>
<listitem><para>Starts playing the next item on the current
playlist.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Alt;<keycap>Left Arrow</keycap></keycombo>
</shortcut>
<guimenuitem>Previous</guimenuitem>
</menuchoice></term>
<listitem><para>Starts playing the previous item on the current
playlist.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Loop</guimenuitem>
</menuchoice></term>
<listitem><para>Toggles the option to start playing items from the beginning
of the playlist after playing the last item on the playlist.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Shuffle</guimenuitem>
</menuchoice></term>
<listitem><para>Toggles the option to play playlist items in a random
order.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Temporary List For New Entries</guimenuitem>
</menuchoice></term>
<listitem><para>Toggles the option to use a temporary playlist when adding
new entries. When enabled, this option locks the main playlist, so when
you load new items 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, it creates a temporary playlist, puts the new
items on it and starts playing them. To start playing items from the main
playlist again, choose <menuchoice><guimenu>Playlist</guimenu><guimenuitem>Play
From Playlist</guimenuitem></menuchoice>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Play Selection Only</guimenuitem>
</menuchoice></term>
<listitem><para>Toggles the option to only play items selected in the playlist
editor.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Clear Before Adding Entries</guimenuitem>
</menuchoice></term>
<listitem><para>Toggles the option to clear the current playlist before adding
new items to it. The current playlist can be either the main playlist or the
temporary playlist when the
<guimenuitem>Temporary List For New Entries</guimenuitem> option is
enabled.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Play From Playlist</guimenuitem>
</menuchoice></term>
<listitem><para>Starts playing items from the main playlist. This command
is only available when a temporary playlist is being used that has been
created because the <guimenuitem>Temporary List For New Entries</guimenuitem>
option had been enabled.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycap>F2</keycap>
</shortcut>
<guimenuitem>Rename</guimenuitem>
</menuchoice></term>
<listitem><para>Starts edit mode for the current item in the
<link linkend="parts-playlist-editor">playlist editor</link> so you can change
the item name. This command is available when playlist editor is shown and is
not empty.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Properties...</guimenuitem>
</menuchoice></term>
<listitem><para>Opens <link linkend="properties">File Properties</link> dialog
for the current item in the playlist editor. See the
<link linkend="howto-properties">File properties micro-HOWTO</link> for details.
This command is available when playlist editor is shown and is not
empty.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Move Up</guimenuitem>
</menuchoice></term>
<listitem><para>Moves the currently selected items up in the playlist editor.
This command is available when playlist editor is shown and some items are
selected.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Move Down</guimenuitem>
</menuchoice></term>
<listitem><para>Moves the currently selected items down in the playlist editor.
This command is available when playlist editor is shown and some items are
selected.</para>
<note><para> You can also move items around by clicking and dragging them with
the &LMB;.</para></note></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Remove</guimenuitem>
</menuchoice></term>
<listitem><para>Removes from the main playlist items currently selected in the
playlist editor. This command is available when playlist editor is shown and
some items are selected.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Clear</guimenuitem>
</menuchoice></term>
<listitem><para>Removes all items from the main playlist in the playlist editor.
This command is available when playlist editor is shown and is not
empty.</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="menu-settings">
<title><guimenu>Settings</guimenu> menu</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo>
</shortcut>
<guimenuitem>Show Menubar</guimenuitem>
</menuchoice></term>
<listitem><para>Shows or hides the <link linkend="parts-menu-bar">menu
bar</link>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Show Statusbar</guimenuitem>
</menuchoice></term>
<listitem><para>Shows or hides the <link linkend="parts-status-bar">status
bar</link>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo>
</shortcut>
<guimenuitem>Show Message Log</guimenuitem>
</menuchoice></term>
<listitem><para>Shows or hides the <link linkend="parts-message-log">message
log</link>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Show Main Toolbar</guimenuitem>
</menuchoice></term>
<listitem><para>Shows or hides the <link linkend="toolbar-main">main
toolbar</link>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Show Progress Toolbar</guimenuitem>
</menuchoice></term>
<listitem><para>Shows or hides the <link linkend="toolbar-progress">progress
toolbar</link>. This command is available when the time length of the current
file is known.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Show Volume Toolbar</guimenuitem>
</menuchoice></term>
<listitem><para>Shows or hides the <link linkend="toolbar-volume">volume
toolbar</link>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Show Contrast Toolbar</guimenuitem>
</menuchoice></term>
<listitem><para>Shows or hides the <link linkend="toolbar-contrast">contrast
toolbar</link>. This command is available for video files.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Show Brightness Toolbar</guimenuitem>
</menuchoice></term>
<listitem><para>Shows or hides the <link linkend="toolbar-brightness">brightness
toolbar</link>. This command is available for video files.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Show Hue Toolbar</guimenuitem>
</menuchoice></term>
<listitem><para>Shows or hides the <link linkend="toolbar-hue">hue
toolbar</link>. This command is available for video files.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Show Saturation Toolbar</guimenuitem>
</menuchoice></term>
<listitem><para>Shows or hides the <link linkend="toolbar-saturation">saturation
toolbar</link>. This command is available for video files.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Configure Shortcuts...</guimenuitem>
</menuchoice></term>
<listitem><para>Opens a <link linkend="configuration-shortcuts">dialog</link>
that lets you see and change &kplayer;'s shortcut key bindings, or associations
between actions and the corresponding keys or combinations of keys that activate
them. If you change the bindings, make sure not to duplicate an existing
shortcut and also not to use the &Shift; key for your new shortcuts, because the
&Shift; key has a <link linkend="howto-properties">special function</link> in
&kplayer;.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Configure &kplayer;...</guimenuitem>
</menuchoice></term>
<listitem><para>Opens a dialog that lets you configure the program, modifying
various aspects of its functionality, user interface and interaction with
&mplayer;. For more information see the <link linkend="settings">Configuration
dialog chapter</link> and the <link linkend="howto-settings">Advanced
configuration micro-HOWTO</link> in this manual.</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="menu-help">
<title><guimenu>Help</guimenu> menu</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<guimenuitem>&kplayer; Handbook</guimenuitem>
</menuchoice></term>
<listitem><para>Opens and displays the &kplayer; user manual.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>What's This...</guimenuitem>
</menuchoice></term>
<listitem><para>Changes the mouse pointer to a question mark and lets you click
a &kplayer; interface element to get a quick description of its purpose and
functionality.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>Report Bug...</guimenuitem>
</menuchoice></term>
<listitem><para>Opens a dialog that allows you to send a bug report to the
&kplayer; developer. However, the recommended way to report a bug is to collect
information using this dialog and then submit it following the instructions in
the <link linkend="howto-bug-reporting">Bug reporting
micro-HOWTO</link>.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>About &kplayer;...</guimenuitem>
</menuchoice></term>
<listitem><para>Displays some brief information about &kplayer;'s version
number, authors and license agreement.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenuitem>About &kde;...</guimenuitem>
</menuchoice></term>
<listitem><para>Shows some information about the version of &kde; that
you are running.</para></listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

<sect1 id="toolbars">
<title>Toolbars</title>

<sect2 id="toolbar-main">
<title><guilabel>Main</guilabel> toolbar</title>

<para>The main toolbar contains the most useful &kplayer; commands and
options.</para>

<itemizedlist>

<listitem><para><guimenuitem>Open</guimenuitem> and
<guimenuitem>Open URL</guimenuitem> buttons invoke the corresponding actions
from the <link linkend="menu-file"><guimenu>File</guimenu> menu</link> that
display dialog boxes allowing you to open and play local files or remote
<acronym>URL</acronym>s.</para></listitem>

<listitem><para><guimenuitem>Properties</guimenuitem> button corresponds to the
command on the <link linkend="menu-file"><guimenu>File</guimenu> menu</link>
that will open the <link linkend="properties">File Properties</link> dialog for
the current file.</para></listitem>

<listitem><para><guimenuitem>Play</guimenuitem>,
<guimenuitem>Pause</guimenuitem> and <guimenuitem>Stop</guimenuitem> buttons
correspond to the commands on the
<link linkend="menu-player"><guimenu>Player</guimenu> menu</link> and will
respectively start, pause and stop playback of the current
file.</para></listitem>

<listitem><para><guimenuitem>Zoom In</guimenuitem> and
<guimenuitem>Zoom Out</guimenuitem> buttons invoke the commands on the
<link linkend="menu-view"><guimenu>View</guimenu> menu</link> that respectively
enlarge and reduce the <link linkend="parts-video-area">video area</link> by one
half of the original video size of the current file.</para></listitem>

<listitem><para><guimenuitem>Maintain Aspect</guimenuitem> button corresponds
to the command on the <link linkend="popup-main">general popup menu</link> that
will toggle the option to maintain the video aspect ratio.</para></listitem>

<listitem><para><guimenuitem>Full Screen</guimenuitem> button invokes the
command on the <link linkend="menu-view"><guimenu>View</guimenu> menu</link>
that switches to the <link linkend="howto-full-screen">full screen mode</link>
and back the to normal mode.</para></listitem>

<listitem><para><guimenuitem>Volume</guimenuitem>,
<guimenuitem>Contrast</guimenuitem>, <guimenuitem>Brightness</guimenuitem>,
<guimenuitem>Hue</guimenuitem> and <guimenuitem>Saturation</guimenuitem>
buttons display popup sliders allowing you to adjust those settings. If you
want the slider to stay visible instead of disappearing when it loses the input
focus, use the <link linkend="parts-toolbar-slider">slider toolbars</link>
instead. As usual, if you hold the &Shift; key down, the changes you make to the
settings will be applied only to the current file and stored in its
<link linkend="howto-properties">properties</link>.</para></listitem>

</itemizedlist>

</sect2>

<sect2 id="toolbar-playlist">
<title><guilabel>Playlist</guilabel> toolbar</title>

<para>The playlist toolbar contains the current playlist and the most
frequently used playlist commands and options.</para>

<itemizedlist>

<listitem><para>The playlist combo box in the closed state displays the
current playlist item. You can drop down the combo box to see the entire
list and select a different item to load and play.</para></listitem>

<listitem><para><guimenuitem>Next</guimenuitem> and
<guimenuitem>Previous</guimenuitem> buttons correspond to the commands
on the <link linkend="menu-playlist"><guimenu>Playlist</guimenu>
menu</link> and will select the next or previous item on the playlist
and start playing it.</para></listitem>

<listitem><para><guimenuitem>Loop</guimenuitem> button is the same as the
corresponding command on the
<link linkend="menu-playlist"><guimenu>Playlist</guimenu> menu</link> that
toggles the option to continue playing from the top of the current playlist
after playing the last item.</para></listitem>

<listitem><para><guimenuitem>Shuffle</guimenuitem> button is also the same
as the corresponding command on the
<link linkend="menu-playlist"><guimenu>Playlist</guimenu> menu</link> and
will toggle the option to play items in random order.</para></listitem>

</itemizedlist>

</sect2>

<sect2 id="toolbar-progress">
<title><guilabel>Progress</guilabel> and seeking toolbar</title>

<para>The progress and seeking toolbar is available when &kplayer; knows
the time length of the current file. It shows the current playback progress
and lets you seek, which is to say, move the playback position forward or
backward.</para>

<itemizedlist>

<listitem><para>The progress slider reflects the current playback position
relative to the total time length of the current file, and also lets you
seek or change the current position. To seek forward and backward by the
distance between the tick marks on the slider, <mousebutton>left</mousebutton>
click to the right or left of the slider thumb. To seek to a specific point,
<mousebutton>middle</mousebutton> click that point, or
<mousebutton>left</mousebutton> click and drag the slider thumb to that
point. If your mouse has a wheel, you can roll it up (away from you) to seek
forward or down (towards you) to seek backward when the mouse pointer is over
the slider. If you hold down the &Ctrl; key on the keyboard when rolling the
wheel, seeking will be faster.</para></listitem>

<listitem><para><guimenuitem>Fast Forward</guimenuitem> and <guimenuitem>Fast
Backward</guimenuitem> buttons corresponds to the commands on the
<link linkend="menu-player"><guimenu>Player</guimenu> menu</link>
that seek forward or backward by the amount which by default is the same
as the distance between slider marks. However, internally they use different
seeking technique (relative as opposed to absolute), and so sometimes may
give different results than <mousebutton>left</mousebutton> clicking the
slider.</para></listitem>

</itemizedlist>

</sect2>

<sect2 id="toolbar-volume">
<title><guilabel>Volume</guilabel> toolbar</title>

<para>The volume toolbar allows you to control the sound volume.</para>

<itemizedlist>

<listitem><para>The volume slider allows you to change the sound volume. If you
hold the &Shift; key down, the setting will be applied only to the current file
and stored in its <link linkend="howto-properties">properties</link>. If you
want the slider to always disappear after you have changed the volume, hide this
toolbar and use the popup slider on the <link linkend="toolbar-main">main
toolbar</link> instead.</para></listitem>

<listitem><para><guimenuitem>Show Volume Toolbar</guimenuitem> button
corresponds to the command on the
<link linkend="menu-settings"><guimenu>Settings</guimenu> menu</link>
and will hide the toolbar when clicked.</para></listitem>

<listitem><para><guimenuitem>Mute</guimenuitem> button turns the sound
off and back on, without changing the normal sound volume. It is the same
as the command on the
<link linkend="submenu-audio"><guisubmenu>Audio</guisubmenu> submenu</link>
of the <guimenu>Player</guimenu> menu.</para></listitem>

</itemizedlist>

</sect2>

<sect2 id="toolbar-contrast">
<title><guilabel>Contrast</guilabel> toolbar</title>

<para>The contrast toolbar allows you to control the video contrast.</para>

<itemizedlist>

<listitem><para>The contrast slider allows you to change the video contrast. If
you hold the &Shift; key down, the setting will be applied only to the current
file and stored in its <link linkend="howto-properties">properties</link>. If
you want the slider to always disappear after you have changed the contrast,
hide this toolbar and use the popup slider on the
<link linkend="toolbar-main">main toolbar</link> instead.</para></listitem>

<listitem><para><guimenuitem>Show Contrast Toolbar</guimenuitem> button
corresponds to the command on the
<link linkend="menu-settings"><guimenu>Settings</guimenu> menu</link>
and will hide the toolbar when clicked.</para></listitem>

</itemizedlist>

</sect2>

<sect2 id="toolbar-brightness">
<title><guilabel>Brightness</guilabel> toolbar</title>

<para>The brightness toolbar allows you to control the video brightness.</para>

<itemizedlist>

<listitem><para>The brightness slider allows you to change the video brightness.
If you hold the &Shift; key down, the setting will be applied only to the
current file and stored in its
<link linkend="howto-properties">properties</link>. If you want the slider to
always disappear after you have changed the brightness, hide this toolbar and
use the popup slider on the <link linkend="toolbar-main">main toolbar</link>
instead.</para></listitem>

<listitem><para><guimenuitem>Show Brightness Toolbar</guimenuitem> button
corresponds to the command on the
<link linkend="menu-settings"><guimenu>Settings</guimenu> menu</link>
and will hide the toolbar when clicked.</para></listitem>

</itemizedlist>

</sect2>

<sect2 id="toolbar-hue">
<title><guilabel>Hue</guilabel> toolbar</title>

<para>The hue toolbar allows you to control the video hue.</para>

<itemizedlist>

<listitem><para>The hue slider allows you to change the video hue. If you hold
the &Shift; key down, the setting will be applied only to the current file and
stored in its <link linkend="howto-properties">properties</link>. If you want
the slider to always disappear after you have changed the hue, hide this toolbar
and use the popup slider on the <link linkend="toolbar-main">main toolbar</link>
instead.</para></listitem>

<listitem><para><guimenuitem>Show Hue Toolbar</guimenuitem> button
corresponds to the command on the
<link linkend="menu-settings"><guimenu>Settings</guimenu> menu</link>
and will hide the toolbar when clicked.</para></listitem>

</itemizedlist>

</sect2>

<sect2 id="toolbar-saturation">
<title><guilabel>Saturation</guilabel> toolbar</title>

<para>The saturation toolbar allows you to control the video saturation.</para>

<itemizedlist>

<listitem><para>The saturation slider allows you to change the video saturation.
If you hold the &Shift; key down, the setting will be applied only to the
current file and stored in its
<link linkend="howto-properties">properties</link>. If you want the slider to
always disappear after you have changed the saturation, hide this toolbar and
use the popup slider on the <link linkend="toolbar-main">main toolbar</link>
instead.</para></listitem>

<listitem><para><guimenuitem>Show Saturation Toolbar</guimenuitem> button
corresponds to the command on the
<link linkend="menu-settings"><guimenu>Settings</guimenu> menu</link>
and will hide the toolbar when clicked.</para></listitem>

</itemizedlist>

</sect2>

<sect2 id="toolbar-editor">
<title><guilabel>Playlist editor</guilabel> toolbar</title>

<para><link linkend="parts-playlist-editor">Playlist editor</link> has its own
toolbar that contains a few commands and an option that affect the editor and
are also available on the
<link linkend="menu-settings"><guimenu>Playlist</guimenu> menu</link>.</para>

<itemizedlist>

<listitem><para><guimenuitem>Temporary List For New Entries</guimenuitem> button
toggles the option to use a temporary playlist when adding new entries. When
enabled, this option locks the main playlist, so when you load new items 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, it creates a temporary playlist, puts the new items
on it and starts playing them. To start playing items from the main playlist
again, choose <menuchoice><guimenu>Playlist</guimenu><guimenuitem>Play From
Playlist</guimenuitem></menuchoice>.</para></listitem>

<listitem><para><guimenuitem>Move Up</guimenuitem> and
<guimenuitem>Move Down</guimenuitem> buttons move the items currently selected
in the playlist editor. You can also move the items around by clicking and
dragging them with the &LMB;.</para></listitem>

<listitem><para><guimenuitem>Remove</guimenuitem> button removes the currently
selected items from the playlist editor.</para></listitem>

<listitem><para><guimenuitem>Clear</guimenuitem> button removes all items from
the playlist editor.</para></listitem>

</itemizedlist>

</sect2>

</sect1>

<sect1 id="popup-menus">
<title>Popup menus</title>

<para>Like any half decent &kde; program, &kplayer; sports popup menus that
you can get by <mousebutton>right</mousebutton> clicking different
<link linkend="parts">parts</link> of it.</para>

<sect2 id="popup-main">
<title>General popup menu</title>

<para>When you <mousebutton>right</mousebutton> click the
<link linkend="parts-video-area">video area</link>, the
<link linkend="parts-menu-bar">menu bar</link> or the
<link linkend="parts-status-bar">status bar</link>, you get the general popup
menu that includes the most frequently used &kplayer; commands and
options.</para>

<itemizedlist>

<listitem><para><guimenuitem>Open</guimenuitem> and
<guimenuitem>Open URL</guimenuitem> commands invoke the corresponding actions
from the <link linkend="menu-file"><guimenu>File</guimenu> menu</link> that
display dialog boxes allowing you to open and play local files or remote
<acronym>URL</acronym>s.</para></listitem>

<listitem><para><guimenuitem>Properties</guimenuitem> command corresponds to the
command on the <link linkend="menu-file"><guimenu>File</guimenu> menu</link>
that will open the <link linkend="properties">File Properties</link> dialog for
the current file.</para></listitem>

<listitem><para><guimenuitem>Play</guimenuitem>,
<guimenuitem>Pause</guimenuitem> and <guimenuitem>Stop</guimenuitem> commands
correspond to the actions on the
<link linkend="menu-player"><guimenu>Player</guimenu> menu</link> and will
respectively start, pause and stop playback of the current
file.</para></listitem>

<listitem><para><guimenuitem>Maintain Aspect</guimenuitem> command toggles the
option to maintain the video aspect ratio.</para></listitem>

<listitem><para><guimenuitem>Full Screen</guimenuitem> command invokes the
action on the <link linkend="menu-view"><guimenu>View</guimenu> menu</link>
that switches to the <link linkend="howto-full-screen">full screen mode</link>
and back to the normal mode.</para></listitem>

<listitem><para>The commands on the <guisubmenu>Settings</guisubmenu> submenu
are the same as the commands on the
<link linkend="menu-settings"><guimenu>Settings</guimenu> menu</link> and will
show or hide the <link linkend="parts-menu-bar">menu bar</link>,
<link linkend="parts-status-bar">status bar</link>,
<link linkend="parts-message-log">message log</link>,
<link linkend="toolbar-playlist">playlist toolbar</link>,
<link linkend="parts-playlist-editor">playlist editor</link>,
<link linkend="toolbar-main">main toolbar</link>,
<link linkend="toolbar-progress">progress and seeking toolbar</link>
and <link linkend="toolbar-volume">volume toolbar</link>.</para></listitem>

</itemizedlist>

</sect2>

<sect2 id="popup-playlist">
<title>Playlist popup menu</title>

<para>When you <mousebutton>right</mousebutton> click an item on the playlist,
&kplayer; displays a menu that lists commands applicable to the playlist item
or to the currently selected items, as well as some playlist options.</para>

<itemizedlist>

<listitem><para><guimenuitem>Play</guimenuitem> command loads and plays the
item you <mousebutton>right</mousebutton> clicked.</para></listitem>

<listitem><para><guimenuitem>Rename</guimenuitem> command starts edit mode
for the item you <mousebutton>right</mousebutton> clicked so you can change
its name.</para></listitem>

<listitem><para><guimenuitem>Properties...</guimenuitem> command opens the
<link linkend="properties">File Properties</link> dialog for the item you
<mousebutton>right</mousebutton> clicked. See the
<link linkend="howto-properties">File properties micro-HOWTO</link> for
details.</para></listitem>

<listitem><para><guimenuitem>Temporary List For New Entries</guimenuitem> command
toggles the option to use a temporary playlist when adding new entries. When
enabled, this option locks the main playlist, so when you load new items 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, it creates a temporary playlist, puts the new
items on it and starts playing them. To start playing items from the main
playlist again, choose <menuchoice><guimenu>Playlist</guimenu><guimenuitem>Play
From Playlist</guimenuitem></menuchoice>.</para></listitem>

<listitem><para><guimenuitem>Play Selection Only</guimenuitem> command toggles
the option to only play items selected in the
<link linkend="parts-playlist-editor">playlist editor</link>.</para></listitem>

<listitem><para><guimenuitem>Move Up</guimenuitem> and
<guimenuitem>Move Down</guimenuitem> commands move the items currently selected
in the playlist editor. You can also move the items around by clicking and
dragging them with the &LMB;.</para></listitem>

<listitem><para><guimenuitem>Remove</guimenuitem> command removes the currently
selected items from the playlist editor.</para></listitem>

<listitem><para><guimenuitem>Clear</guimenuitem> command removes all items from
the playlist editor.</para></listitem>

</itemizedlist>

</sect2>

<sect2 id="popup-message-log">
<title>Message log popup menu</title>

<para>When you <mousebutton>right</mousebutton> click the
<link linkend="parts-message-log">message log</link>, &kplayer; displays a menu
that lists commands applicable to the message log.</para>

<itemizedlist>

<listitem><para><guimenuitem>Select All</guimenuitem> command selects all the
text in the message log.</para></listitem>

<listitem><para><guimenuitem>Copy</guimenuitem> command copies the selected
message log text to the clipboard.</para></listitem>

</itemizedlist>

</sect2>

<sect2 id="popup-toolbar">
<title>Toolbar popup menu</title>

<para>When you <mousebutton>right</mousebutton> click a &kplayer; toolbar,
you get a standard &kde; toolbar popup menu. It contains options that allow
you to change the toolbar orientation, text position and icon size.</para>

</sect2>

<sect2 id="popup-title-bar">
<title>Title bar popup menu</title>

<para>When you <mousebutton>right</mousebutton> click the &kplayer; title bar,
you get a standard &kde; title bar popup menu. You can also get it by
<mousebutton>left</mousebutton> clicking the little button in the top left
corner of &kplayer; window or by pressing
<keycombo action="simul">&Alt;<keycap>F3</keycap></keycombo>. The menu contains
commands that let you maximize, minimize, restore, move and resize the &kplayer;
window, as well as a few options, some of which you may find useful. For
example, the <guimenuitem>Keep Above Others</guimenuitem> option on the
<guisubmenu>Advanced</guisubmenu> lets you keep the &kplayer; window on top of
all other program windows.</para>

</sect2>

</sect1>

<sect1 id="kpart">
<title>KPart</title>

<para>&kplayer; features a KPart, which is an applet that can be embedded into
other programs and used to watch video or play audio. You can configure programs
like &konqueror; File Manager and &kmldonkey; to embed the &kplayer;'s KPart and
play files with it. &konqueror; Web Browser can also be configured to use the
&kplayer; KPart to display multimedia objects embedded in web pages.</para>

<para>You can tell &konqueror; to use &kplayer; for playing multimedia files and
<acronym>URL</acronym>s by going to the <guilabel>File Associations</guilabel>
page either in the &konqueror; configuration dialog or in &kcontrolcenter; and
moving &kplayer; to the top of the list of programs for each media type you want
&kplayer; to play, both on the <guilabel>Program</guilabel> tab and on the
<guilabel>Embedded</guilabel> tab. It is recommended that you choose the option
to <guilabel>Open Separate Program</guilabel>, which will give you a whole lot
more options and better interface when playing multimedia compared to an
embedded KPart. However, when an object is embedded into a web page, &konqueror;
has no choice but to use the KPart. In that situation the best thing is to
<mousebutton>right</mousebutton> click the multimedia object and select the
<guilabel>Start &kplayer;</guilabel> command described
<link linkend="kpart-popup">below</link>.</para>

<para>Following is a complete list of user interface elements that &kplayer;'s
KPart provides whenever possible. However, when the KPart is embedded into a web
page, only the <mousebutton>right</mousebutton> click
<link linkend="kpart-popup">popup menu</link> will be available.</para>

<sect2 id="kpart-menu">
<title><guilabel>Player</guilabel> menu</title>

<para>This menu contains <guilabel>Play</guilabel>, <guilabel>Pause</guilabel>,
<guilabel>Stop</guilabel>, <guilabel>Forward</guilabel>, <guilabel>Fast
Forward</guilabel>, <guilabel>Backward</guilabel>, <guilabel>Fast
Backward</guilabel> and <guilabel>Back to Start</guilabel> commands from the
<link linkend="menu-player"><guimenu>Player</guimenu> menu</link> of the full
&kplayer;, and <guilabel>Decrease Volume</guilabel>, <guilabel>Increase
Volume</guilabel> and <guilabel>Mute</guilabel> commands from its
<link linkend="submenu-audio"><guisubmenu>Audio</guisubmenu> submenu</link>,
as well as <guilabel>Maintain Aspect</guilabel> command from the
<link linkend="popup-main">general popup menu</link> and
<guilabel>Properties</guilabel> command from the
<link linkend="menu-file"><guimenu>File</guimenu> menu</link> found in the full
&kplayer;, as well as <guilabel>Start &kplayer;</guilabel> command from the
<link linkend="kpart-popup">KPart popup menu</link> described below.</para>

</sect2>

<sect2 id="kpart-toolbar">
<title>Main toolbar</title>

<para>This toolbar contains <guilabel>Play</guilabel>,
<guilabel>Pause</guilabel>, <guilabel>Stop</guilabel>, <guilabel>Maintain
Aspect</guilabel>, <guilabel>Volume</guilabel> and
<guilabel>Properties</guilabel> buttons which as the same as the ones on the
<link linkend="toolbar-main">main toolbar</link> in the full &kplayer;.</para>

</sect2>

<sect2 id="kpart-toolbar-progress">
<title>Progress toolbar</title>

<para>This toolbar is the same as the <link linkend="toolbar-progress">Progress
toolbar</link> in the full &kplayer;.</para>

</sect2>

<sect2 id="kpart-toolbar-volume">
<title>Volume toolbar</title>

<para>This toolbar is the same as the <link linkend="toolbar-volume">Volume
toolbar</link> in the full &kplayer;.</para>

</sect2>

<sect2 id="kpart-popup">
<title>Popup menu</title>

<para><mousebutton>Right</mousebutton> clicking the video area of &kplayer;
KPart embedded into another program gives you a popup menu.</para>

<para>The top item on the menu is <guilabel>Start &kplayer;</guilabel> command
that will stop playback, open the full &kplayer;, put the multimedia file or
<acronym>URL</acronym> on the
<link linkend="parts-toolbar-playlist">playlist</link> and start playing it.
It is always recommended that you choose this command, since it will give you
better interface and more options when playing the multimedia.</para>

<para>The popup menu also contains <guilabel>Play</guilabel>,
<guilabel>Pause</guilabel>, <guilabel>Stop</guilabel>, <guilabel>Maintain
Aspect</guilabel> and <guilabel>Properties</guilabel> commands which as the same
as the ones on the <link linkend="popup-main">general popup menu</link> in the
full &kplayer;.</para>

</sect2>

</sect1>

<sect1 id="mouse-wheel">
<title>Mouse wheel</title>

<para>The action of the mouse wheel in &kplayer; depends on where the mouse
cursor is positioned.</para>

<para>If the cursor is positioned over a slider, rolling the mouse wheel
will change the setting that the slider controls, like
<link linkend="toolbar-progress">playback position</link>,
<link linkend="toolbar-volume">sound volume</link>,
<link linkend="toolbar-contrast">video contrast</link> and so on. Rolling the
wheel up (away from you) increases the setting, while rolling it down (towards
you) decreases it. You can hold down the &Ctrl; key on the keyboard when rolling
the wheel to change the setting faster.</para>

<para>Rolling the wheel when the mouse pointer is positioned over a window that
has a scroll bar, like the <link linkend="parts-playlist-editor">playlist
editor</link> or the <link linkend="parts-message-log">message log</link>, will
scroll the window up or down. Rolling the wheel over the
<link linkend="toolbar-playlist">playlist combo box</link> will likewise scroll
it up or down, switch to a different entry and start playing it.</para>

<para>When the mouse pointer is in the video area, rolling the wheel up (away
from you) will zoom in, that is, enlarge the video area, and rolling the wheel
down (towards you) will zoom out, or reduce the video area. However, if
&kplayer; cannot resize the video area, for example when the window is full
screen or maximized, it will instead seek, or move the playback point, forward
when rolling the wheel up (away from you) or backward when rolling it down
(towards you). In that case you can also hold down the &Ctrl; key on the keyboard
to seek faster.</para>

</sect1>

</chapter>
