You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1941 lines
64 KiB
1941 lines
64 KiB
<chapter id="commands">
|
|
<title>Command reference</title>
|
|
|
|
<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>
|
|
|
|
<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>Play...</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Displays the standard <guilabel>Play files</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>Play URL...</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Displays the standard <guilabel>Play 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, or a &kde; <acronym>I/O</acronym> Slave
|
|
<acronym>URL</acronym>.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guisubmenu>Play List</guisubmenu>
|
|
</menuchoice></term>
|
|
<listitem><para>Displays a submenu listing all playlists and lets you choose one
|
|
of them to play.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guisubmenu>Play Recent</guisubmenu>
|
|
</menuchoice></term>
|
|
<listitem><para>Displays a submenu listing the most recently played 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>
|
|
<guisubmenu>Device</guisubmenu>
|
|
</menuchoice></term>
|
|
<listitem><para>Displays a submenu with commands for the particular device. Each
|
|
device has its own submenu. The submenu label reflects the kind of device it is,
|
|
for example <guilabel>TV Device</guilabel> or <guilabel>DVD Device</guilabel>.
|
|
When you put a disk in a disk drive, after a few seconds the label will change
|
|
to reflect the kind of disk you inserted, for example <guilabel>Audio CD in DVD
|
|
Device</guilabel>. The list of commands on the submenu will also be updated
|
|
accordingly to include commands applicable to the disk and the tracks it has.
|
|
See <link linkend="submenu-device">below</link> for details about the
|
|
commands.</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>Load subtitles</guilabel> dialog
|
|
and lets you choose a subtitle file or files to use with the current file or
|
|
<acronym>URL</acronym>.</para>
|
|
<para>After you click <guibutton>Open</guibutton>, &kplayer;
|
|
will start showing subtitles from the first of the files immediately if the
|
|
video is already playing, and list the subtitle files on the <link
|
|
linkend="submenu-subtitles"><guisubmenu>Subtitles</guisubmenu> submenu</link>
|
|
of the <guimenu>Player</guimenu> menu. By default it will also remember the
|
|
subtitles you choose in the current file
|
|
<link linkend="properties">properties</link>.</para>
|
|
<para>This command is available for video files. You can also drag subtitle
|
|
files from &konqueror; File Manager and drop them anywhere in &kplayer; except
|
|
the <interface>multimedia library</interface> to load and display
|
|
them.</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>
|
|
|
|
<sect3 id="submenu-device">
|
|
<title><guisubmenu>Device</guisubmenu> submenu</title>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Play Disk</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Plays the entire disk. This command is available if the device
|
|
is a disk drive.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Play Title</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Plays one title of a video <acronym>DVD</acronym>. This command
|
|
is available when &kplayer; detects a video <acronym>DVD</acronym> in a
|
|
<acronym>DVD</acronym> drive and finds out the number of titles on it. Each
|
|
title on the <acronym>DVD</acronym> has its own command on this
|
|
submenu.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Play Track</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Plays one track of an audio or video <acronym>CD</acronym>. This
|
|
command is available when &kplayer; detects an audio or video
|
|
<acronym>CD</acronym> in a disk drive and finds out the number of tracks on it.
|
|
Each track on the <acronym>CD</acronym> has its own command on this
|
|
submenu.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Load Disk</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Detects the kind of disk that is in the disk drive, finds the
|
|
number of titles or tracks on the disk and updates the submenu accordingly.
|
|
Usually &kplayer; detects this information automatically, but sometimes this
|
|
command can be useful to initiate the detection process manually. This command
|
|
is available if the device is a disk drive.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Play Channel</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Plays a channel from a tuner device. This command is available
|
|
if the device is a tuner device. Each channel on the device has its own command
|
|
on this submenu.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect3>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="menu-view">
|
|
<title><guimenu>View</guimenu> menu</title>
|
|
|
|
<para>Commands on this menu are only available for video files.</para>
|
|
|
|
<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%</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%</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%</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Resizes the video area to 150% of the original
|
|
video size of the current file.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Zoom to 200%</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%</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Resizes the video area to 250% of the original
|
|
video size of the current file.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Zoom to 300%</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>
|
|
<keycombo action="simul">&Alt;<keycap>Down 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>Up 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>
|
|
|
|
</variablelist>
|
|
|
|
<sect3 id="submenu-position">
|
|
<title><guisubmenu>Position</guisubmenu> submenu</title>
|
|
|
|
<para>This submenu and the commands it contains are available when playing a
|
|
file.</para>
|
|
|
|
<variablelist>
|
|
|
|
<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.</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.</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.</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.</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.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect3>
|
|
|
|
<sect3 id="submenu-audio">
|
|
<title><guisubmenu>Audio</guisubmenu> submenu</title>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Track</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Switches to the selected audio track. If the currently loaded
|
|
file or stream has more than one audio track, each track will have a command
|
|
that allows you to switch to that audio track. The command will be labelled with
|
|
the audio track language if it is known. If there is only one audio track, this
|
|
command will not be available.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<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>
|
|
|
|
<para>This submenu is only available for video files.</para>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Track</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Switches to the selected video track. If the currently loaded
|
|
file or stream has more than one video track, each track will have a command
|
|
that allows you to switch to that video track. If there is only one video track,
|
|
this command will not be available.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<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>
|
|
|
|
<para>This menu is only available when a video file has embedded subtitles or
|
|
when external subtitles are loaded.</para>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>None</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Stops showing subtitles while playing video.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Track</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Switches to the selected subtitles. If the currently loaded
|
|
file or stream has embedded subtitle tracks, each track will have a command
|
|
that allows you to switch to that subtitle track. The command will be labelled
|
|
with the subtitle track language if it is known. If you load external subtitles,
|
|
they will also have a command, labelled with the subtitle file name, that allows
|
|
you to switch to the external 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 in the video area.</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 in the video area.</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>
|
|
|
|
<sect3 id="submenu-advanced">
|
|
<title><guisubmenu>Advanced</guisubmenu> submenu</title>
|
|
|
|
<para>If your system is too slow to play a file, &mplayer; can drop some frames
|
|
so playback does not slow down. This submenu lets you choose a frame dropping
|
|
option. The soft frame dropping option drops frames less agressively than the
|
|
hard one and should not cause playback problems. You should try it when you get
|
|
video lagging behind audio, for example because you cannot use an accelerated
|
|
video output. The hard option drops frames more agressively than the soft one
|
|
and may sometimes break decoding.</para>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Soft Frame Dropping</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Toggles the soft frame dropping option.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Hard Frame Dropping</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Toggles the hard frame dropping option.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
<para>To turn frame dropping off, unselect the currently selected frame dropping
|
|
option. 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>
|
|
|
|
</sect3>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="menu-library">
|
|
<title><guimenu>Library</guimenu> menu</title>
|
|
|
|
<para>The commands on this menu work on the <link
|
|
linkend="parts-library">multimedia library</link>. Most of the commands are
|
|
available when the library is shown using the <guimenuitem>Show
|
|
Library</guimenuitem> command on the <link
|
|
linkend="menu-settings"><guimenu>Settings</guimenu> menu</link> or one of the
|
|
commands on the <link linkend="submenu-go"><guisubmenu>Go</guisubmenu>
|
|
submenu</link>. Other commands become available when you select some items in
|
|
the library. For a detailed description of the multimedia library feature see
|
|
the <link linkend="howto-library">Multimedia library micro-HOWTO</link>.</para>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;<keycap>Enter</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenuitem>Play</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Puts the selected items on the current playlist and starts
|
|
playing them.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Play Next</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Puts the selected items on the current playlist and plays them
|
|
after the currently playing item.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Queue</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Adds the selected items to the current
|
|
playlist.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Queue Next</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Adds the selected items to the current playlist and plays them
|
|
after the currently playing item.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Add to</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Shows a submenu with commands that add the current selection to
|
|
different locations in the <interface>multimedia library</interface>.
|
|
See <link linkend="submenu-add-to">below</link> for details on each available
|
|
command.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Add</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Shows a submenu with commands that allow you to add items to the
|
|
current folder. See <link linkend="submenu-add">below</link> for details on each
|
|
available command.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Select All</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Selects all items in the current folder.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Move Up</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Moves the currently selected items up in the
|
|
<interface>multimedia library</interface>. This command is available for items
|
|
in the <guilabel>Now Playing</guilabel>, <guilabel>Recent</guilabel> and
|
|
<guilabel>Playlists</guilabel> sections of the library. You can also move items
|
|
around in those sections by clicking and dragging them with the
|
|
&LMB;.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Move Down</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Moves the currently selected items down in the
|
|
<interface>multimedia library</interface>. This command is available for items
|
|
in the <guilabel>Now Playing</guilabel>, <guilabel>Recent</guilabel> and
|
|
<guilabel>Playlists</guilabel> sections of the library. You can also move items
|
|
around in those sections by clicking and dragging them with the
|
|
&LMB;.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut>
|
|
<keycap>Delete</keycap>
|
|
</shortcut>
|
|
<guimenuitem>Remove</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Removes the currently selected items from the
|
|
<interface>multimedia library</interface>. Note that &kplayer; never deletes any
|
|
multimedia files from your system, so this command is not available for files
|
|
and directories.</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
|
|
<interface>multimedia library</interface> so that you can change the item
|
|
name.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Edit</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Shows a submenu with commands that start edit mode for the
|
|
chosen field of the current item in the <interface>multimedia
|
|
library</interface>. Each editable field has its own command on this submenu.
|
|
If the field column is not shown, this command will show it. After you are done
|
|
editing the field, press &Enter; to apply the changes, or 	 or
|
|
<keycombo action="simul">&Shift;	</keycombo> to apply the changes and edit
|
|
the next or the previous field, or <keycap>Down Arrow</keycap> or <keycap>Up
|
|
Arrow</keycap> to apply the changes and edit the same field of the next or
|
|
previous item.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Properties...</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Opens the <link linkend="properties">File Properties</link>
|
|
dialog for the current item in the <interface>multimedia library</interface>.
|
|
This command currently does not apply to folders, but it is available for
|
|
devices and optical disks as well as other items. See the
|
|
<link linkend="howto-properties">File properties micro-HOWTO</link> for
|
|
details.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Columns</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Shows a submenu with commands that show or hide the chosen
|
|
column in the <interface>list view</interface> of the <interface>multimedia
|
|
library</interface>. Each available column has its own command on this
|
|
submenu.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Go</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Shows a submenu with commands that let you navigate the
|
|
<interface>multimedia library</interface>.
|
|
See <link linkend="submenu-go">below</link> for details on each available
|
|
command.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
<sect3 id="submenu-add-to">
|
|
<title><guisubmenu>Add to</guisubmenu> submenu</title>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Playlist</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Adds the selected items to the playlist you choose from the
|
|
list. Each playlist in the <guilabel>Playlist</guilabel>s section of the library
|
|
has its own command on this submenu.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>New Playlist...</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Shows a dialog allowing you to enter a name for a new playlist
|
|
to add to the <guilabel>Playlists</guilabel> section of the
|
|
<interface>multimedia library</interface> and adds the selected items to the new
|
|
playlist.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Playlists</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Adds the selected items to the <guilabel>Playlists</guilabel>
|
|
section of the <interface>multimedia library</interface>.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Collection</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Adds the selected items to the <guilabel>Collection</guilabel>
|
|
section of the <interface>multimedia library</interface>.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect3>
|
|
|
|
<sect3 id="submenu-add">
|
|
<title><guisubmenu>Add</guisubmenu> submenu</title>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Files...</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Displays the standard <guilabel>Add files</guilabel> dialog
|
|
and lets you choose a file or several files to add to the current
|
|
folder.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>URL...</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Displays the standard <guilabel>Add URL</guilabel> dialog
|
|
and lets you type or paste in a <acronym>URL</acronym> to add to the current
|
|
folder.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Folder...</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Shows a dialog allowing you to enter a name for a new subfolder
|
|
to add to the current folder.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Playlist...</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Shows a dialog allowing you to enter a name for a new playlist
|
|
to add to the playlist selected in the <interface>multimedia
|
|
library</interface>.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Device...</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Shows a dialog allowing you to enter a name, type and path for a
|
|
new device to add to the <guilabel>Devices</guilabel> section of the
|
|
<interface>multimedia library</interface>. Some device types need additional
|
|
settings. See the <link linkend="howto-devices">Devices micro-HOWTO</link> for
|
|
details.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect3>
|
|
|
|
<sect3 id="submenu-go">
|
|
<title><guisubmenu>Go</guisubmenu> submenu</title>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Folder</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Opens the selected folder in the <interface>multimedia
|
|
library</interface>. If the library window is not shown, this command will show
|
|
it. Each folder in the recent history has its own command on this submenu. Each
|
|
top level folder also has its own command.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Alt;<keycap>Left Arrow</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenuitem>Back</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Opens the previous folder.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Alt;<keycap>Right Arrow</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenuitem>Forward</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Opens the next folder. This command will be available after you
|
|
use the <guimenuitem>Back</guimenuitem> command.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Alt;&Shift;<keycap>Up Arrow</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenuitem>Up</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Opens the parent folder of the selected
|
|
folder.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Alt;&Shift;<keycap>Down Arrow</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenuitem>Down</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Opens the selected folder.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Alt;&Shift;<keycap>Left Arrow</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenuitem>To Origin</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Opens the origin folder of the selected folder. This command is
|
|
available when the currently selected folder is linked to an origin folder. For
|
|
an explanation of linked folders, see the
|
|
<link linkend="howto-library-linked-folders">Multimedia library
|
|
micro-HOWTO</link>.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect3>
|
|
|
|
</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>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>L</keycap></keycombo>
|
|
</shortcut>
|
|
<guimenuitem>Show Library</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Shows or hides the
|
|
<link linkend="parts-library">multimedia library</link>.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<shortcut>
|
|
<keycombo action="simul">&Ctrl;<keycap>G</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 Toolbars...</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Opens a <link linkend="configuration-toolbars">dialog</link>
|
|
that lets you see and change the command buttons available on &kplayer;'s
|
|
toolbars.</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 <link linkend="howto-bug-reporting">help topic</link>
|
|
that explains the recommended way to report a bug in
|
|
&kplayer;.</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>Play</guimenuitem> and <guimenuitem>Play
|
|
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 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 <link linkend="parts-toolbar-playlist">playlist toolbar</link>
|
|
contains the current playlist and the most frequently used playlist commands and
|
|
options.</para>
|
|
|
|
<itemizedlist>
|
|
|
|
<listitem><para><guimenuitem>Next</guimenuitem> and
|
|
<guimenuitem>Previous</guimenuitem> buttons correspond to the commands
|
|
on the <link linkend="menu-player"><guimenu>Player</guimenu>
|
|
menu</link> and will select the next or previous item on the playlist
|
|
and start playing it.</para></listitem>
|
|
|
|
<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>Loop</guimenuitem> button is the same as the
|
|
corresponding command on the
|
|
<link linkend="menu-player"><guimenu>Player</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-player"><guimenu>Player</guimenu> menu</link> that toggles
|
|
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>
|
|
|
|
</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>Play</guimenuitem> and <guimenuitem>Play
|
|
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 play local files or remote
|
|
<acronym>URL</acronym>s.</para></listitem>
|
|
|
|
<listitem><para><guisubmenu>Play List</guisubmenu> and <guisubmenu>Play
|
|
Recent</guisubmenu> show the submenus from the <link
|
|
linkend="menu-file"><guimenu>File</guimenu> menu</link> that allow you to
|
|
play a playlist or a recent item respectively.</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="toolbar-playlist">playlist toolbar</link>,
|
|
<link linkend="parts-library">multimedia library</link>,
|
|
<link linkend="parts-message-log">message log</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>
|
|
|
|
<listitem><para><guimenuitem>Quit</guimenuitem> command invokes the action on
|
|
the <link linkend="menu-file"><guimenu>File</guimenu> menu</link> that stops
|
|
playback, saves all settings and closes &kplayer;.</para></listitem>
|
|
|
|
</itemizedlist>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="popup-playlist">
|
|
<title>Playlist popup menu</title>
|
|
|
|
<para>When you <mousebutton>right</mousebutton> click the playlist drop down box
|
|
on the <link linkend="toolbar-playlist">playlist toolbar</link>, &kplayer;
|
|
displays a menu that lists commands that work on the current playlist.</para>
|
|
|
|
<itemizedlist>
|
|
|
|
<listitem><para><guimenuitem>Play...</guimenuitem> and <guimenuitem>Play
|
|
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 play local files or remote
|
|
<acronym>URL</acronym>s.</para></listitem>
|
|
|
|
<listitem><para><guisubmenu>Play List</guisubmenu> and <guisubmenu>Play
|
|
Recent</guisubmenu> show the submenus from the <link
|
|
linkend="menu-file"><guimenu>File</guimenu> menu</link> that allow you to
|
|
play a playlist or a recent item respectively.</para></listitem>
|
|
|
|
<listitem><para><guisubmenu>Device</guisubmenu> submenus are also the same as
|
|
the ones on the <link linkend="menu-file"><guimenu>File</guimenu> menu</link>.
|
|
Please refer to the <link linkend="submenu-device">description above</link> for
|
|
details.</para></listitem>
|
|
|
|
<listitem><para><guimenuitem>Next</guimenuitem> and
|
|
<guimenuitem>Previous</guimenuitem> commands invoke the corresponding actions
|
|
from the <link linkend="menu-player"><guimenu>Player</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> and
|
|
<guimenuitem>Shuffle</guimenuitem> commands are also the same as the ones on the
|
|
<link linkend="menu-player"><guimenu>Player</guimenu> menu</link> that toggle
|
|
the options to continue playing from the top of the current playlist after
|
|
playing the last item and to play items in random order
|
|
respectively.</para></listitem>
|
|
|
|
<listitem><para><guimenuitem>Edit</guimenuitem> command opens the current
|
|
playlist in the <link linkend="parts-library">multimedia library</link>,
|
|
allowing you to edit it.</para></listitem>
|
|
|
|
</itemizedlist>
|
|
|
|
<sect3 id="submenu-playlist-add">
|
|
<title><guisubmenu>Add</guisubmenu> submenu</title>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Files...</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Displays the standard <guilabel>Add files</guilabel> dialog
|
|
and lets you choose a file or several files to add to the current
|
|
playlist.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>URL...</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Displays the standard <guilabel>Add URL</guilabel> dialog
|
|
and lets you type or paste in a <acronym>URL</acronym> to add to the current
|
|
playlist.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect3>
|
|
|
|
<sect3 id="submenu-add-playlist-to">
|
|
<title><guisubmenu>Add to</guisubmenu> submenu</title>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Playlist</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Adds the contents of the current playlist to the playlist you
|
|
choose from the list. Each playlist in the <guilabel>Playlists</guilabel>
|
|
section of the library has its own command on this submenu.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Playlists...</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Shows a dialog allowing you to enter a name for a new playlist
|
|
and saves the current playlist in the <guilabel>Playlists</guilabel> section of
|
|
the <interface>multimedia library</interface> under that name.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><menuchoice>
|
|
<guimenuitem>Collection...</guimenuitem>
|
|
</menuchoice></term>
|
|
<listitem><para>Shows a dialog allowing you to enter a name for a new folder
|
|
and saves the current playlist in the <guilabel>Collection</guilabel> section of
|
|
the <interface>multimedia library</interface> under that name.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect3>
|
|
|
|
</sect2>
|
|
|
|
<sect2 id="popup-library">
|
|
<title>Library popup menu</title>
|
|
|
|
<para>When you <mousebutton>right</mousebutton> click an item in the
|
|
<link linkend="parts-library"><interface>multimedia library</interface></link>,
|
|
&kplayer; displays a menu that lists commands applicable to that item or to the
|
|
currently selected items or to the current folder. The menu is the same as the
|
|
<link linkend="menu-library"><guimenu>Library</guimenu> menu</link> on the menu
|
|
bar.</para>
|
|
|
|
</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>
|
|
|
|
<listitem><para><guimenuitem>Clear</guimenuitem> command removes all messages
|
|
from the message log.</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, as well as a
|
|
command that opens the <link linkend="configuration-toolbars-dialog">Toolbar
|
|
configuration dialog</link>.</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> submenu 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 the following commands, most of which are the same as
|
|
the corresponding commands in the full &kplayer;:</para>
|
|
|
|
<itemizedlist>
|
|
|
|
<listitem><para><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;;</para></listitem>
|
|
|
|
<listitem><para><guilabel>Decrease Volume</guilabel>, <guilabel>Increase
|
|
Volume</guilabel> and <guilabel>Mute</guilabel> commands from the
|
|
<link linkend="submenu-audio"><guisubmenu>Audio</guisubmenu>
|
|
submenu</link> of the <guimenu>Player</guimenu> menu of the full
|
|
&kplayer;;</para></listitem>
|
|
|
|
<listitem><para><guilabel>Maintain Aspect</guilabel> command from the
|
|
<link linkend="popup-main">general popup menu</link> of the full
|
|
&kplayer;;</para></listitem>
|
|
|
|
<listitem><para><guilabel>Properties</guilabel> command from the
|
|
<link linkend="menu-file"><guimenu>File</guimenu> menu</link> of the full
|
|
&kplayer;;</para></listitem>
|
|
|
|
<listitem><para><guilabel>Start &kplayer;</guilabel> command from the
|
|
<link linkend="kpart-popup">KPart popup menu</link> described
|
|
below.</para></listitem>
|
|
|
|
</itemizedlist>
|
|
|
|
</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-library">multimedia
|
|
library</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>
|