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.
514 lines
24 KiB
514 lines
24 KiB
9 years ago
|
<chapter id="basics">
|
||
|
|
<title>Basics</title>
|
||
|
|
|
||
|
|
<important><para>Like all &kde; applications, &kplayer; is highly configurable.
|
||
|
|
The default settings have been chosen for optimal performance and maximum
|
||
|
|
compatibility. This chapter describes how &kplayer; behaves with these default
|
||
|
|
settings.</para></important>
|
||
|
|
|
||
|
|
<sect1 id="starting">
|
||
|
|
<title>Starting &kplayer;</title>
|
||
|
|
|
||
|
|
<para>There are several ways to start &kplayer;. Which one you use is your
|
||
|
|
personal preference, and may depend on what type of media you are going to
|
||
|
|
play.</para>
|
||
|
|
|
||
|
|
<itemizedlist>
|
||
|
|
|
||
|
|
<listitem><para>From the &kmenu;, select
|
||
|
|
<menuchoice><guisubmenu>Multimedia</guisubmenu>
|
||
|
|
<guimenuitem>&kplayer;</guimenuitem></menuchoice></para></listitem>
|
||
|
|
|
||
|
|
<listitem><para>Or you can put &kplayer; icon on the desktop or on the &kicker;
|
||
|
|
panel. Then you can <mousebutton>left</mousebutton> click it to start
|
||
|
|
&kplayer;.</para></listitem>
|
||
|
|
|
||
|
|
<listitem><para><keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo>
|
||
|
|
will open a <guilabel>Run Command</guilabel> dialog box, type
|
||
|
|
<userinput><command>kplayer</command></userinput> (lower case) and press
|
||
|
|
&Enter; or click the <guibutton>Run</guibutton> button.</para></listitem>
|
||
|
|
|
||
|
|
<listitem><para>In a terminal program like &konsole; type
|
||
|
|
<userinput><command>kplayer</command></userinput> and press
|
||
|
|
&Enter;.</para></listitem>
|
||
|
|
|
||
|
|
<listitem><para>Depending on the type of content you are going to play,
|
||
|
|
there may be other ways to start &kplayer;. They are described in the
|
||
|
|
sections about playing <link linkend="playing">local files</link> and
|
||
|
|
<link linkend="playing-urls">remote addresses</link>.</para></listitem>
|
||
|
|
|
||
|
|
</itemizedlist>
|
||
|
|
|
||
|
|
</sect1>
|
||
|
|
|
||
|
|
<sect1 id="playing">
|
||
|
|
<title>Playing multimedia</title>
|
||
|
|
|
||
|
|
<para>&kplayer; can play multimedia from many different sources. In addition to
|
||
|
|
<link linkend="playing-files">local files</link>, it can play
|
||
|
|
<link linkend="playing-urls">remote network addresses</link> or
|
||
|
|
<acronym>URL</acronym>s, various devices like
|
||
|
|
<link linkend="playing-devices">disks and cards</link>, and many other sources
|
||
|
|
like <link linkend="playing-slaves">network locations and compressed
|
||
|
|
files</link> using &kde; feature known as <acronym>I/O</acronym> Slaves.</para>
|
||
|
|
|
||
|
|
<sect2 id="playing-files">
|
||
|
|
<title>Local files</title>
|
||
|
|
|
||
|
|
<para>Use any of the following ways to start playing local files from your
|
||
|
|
hard drive or any other device mounted as a directory on your system.</para>
|
||
|
|
|
||
|
|
<itemizedlist>
|
||
|
|
|
||
|
|
<listitem><para>When &kplayer; is running, select
|
||
|
|
<menuchoice><guimenu>Library</guimenu><guisubmenu>Go</guisubmenu>
|
||
|
|
<guimenuitem>Home Directory</guimenuitem></menuchoice>. &kplayer; will open your
|
||
|
|
home directory in the <link linkend="parts-library"><interface>multimedia
|
||
|
|
library</interface></link> and list any multimedia files you have in it. Then
|
||
|
|
you can select the file or files you want to play or look for multimedia files
|
||
|
|
in other directories.</para></listitem>
|
||
|
|
|
||
|
|
<listitem><para>The <interface>multimedia library</interface> allows you to
|
||
|
|
organize your multimedia collection for easier access. For example, once you
|
||
|
|
create some playlists, playing one of them becomes as easy as selecting
|
||
|
|
<menuchoice><guimenu>File</guimenu><guisubmenu>Play List</guisubmenu>
|
||
|
|
</menuchoice> and then selecting the playlist name from the
|
||
|
|
submenu.</para></listitem>
|
||
|
|
|
||
|
|
<listitem><para>If your file does not show up in the library, select
|
||
|
|
<menuchoice><guimenu>File</guimenu><guimenuitem>Play...</guimenuitem></menuchoice>,
|
||
|
|
or click the <guibutton>Play</guibutton> button on the main toolbar.
|
||
|
|
The standard <guilabel>Play files</guilabel>
|
||
|
|
dialog will appear, letting you choose a local file or several files. After
|
||
|
|
you click the <guibutton>Open</guibutton> button or press &Enter;, &kplayer;
|
||
|
|
will put your selection on the current playlist and start playing
|
||
|
|
it.</para></listitem>
|
||
|
|
|
||
|
|
<listitem><para>&kplayer; is associated with all media file types it can play.
|
||
|
|
If a type has more than one program associated to it, you need to move &kplayer;
|
||
|
|
to the top of the list on the <guilabel>File Associations</guilabel> page in the
|
||
|
|
&konqueror; configuration dialog. Then you can simply execute a media file in
|
||
|
|
&konqueror; File Manager with the <mousebutton>left</mousebutton> mouse button,
|
||
|
|
and it will open &kplayer; if it is not yet running and start playing the
|
||
|
|
file.</para></listitem>
|
||
|
|
|
||
|
|
<listitem><para><mousebutton>Right</mousebutton> click context menu in
|
||
|
|
&konqueror; File Manager will show the <guimenuitem>Play</guimenuitem> command
|
||
|
|
when a multimedia file or files are selected. Selecting the command will open
|
||
|
|
&kplayer;, put all the selected files on the current playlist and play them.
|
||
|
|
You can also <mousebutton>right</mousebutton> click a directory and play all
|
||
|
|
multimedia files contained in it and in all of its
|
||
|
|
subdirectories.</para></listitem>
|
||
|
|
|
||
|
|
<listitem><para>You can also drag files and directories from &konqueror; File
|
||
|
|
Manager and drop them on the &kplayer; window. &kplayer; will then put them on
|
||
|
|
the current playlist and start playing them.</para></listitem>
|
||
|
|
|
||
|
|
<listitem><para>In a terminal program like &konsole; type</para>
|
||
|
|
|
||
|
|
<para><userinput><command>kplayer</command>
|
||
|
|
<filename><replaceable>filename</replaceable></filename></userinput></para>
|
||
|
|
|
||
|
|
<para>where <filename><replaceable>filename</replaceable></filename> can be an
|
||
|
|
absolute or relative path to the file or directory you want to play, or just the
|
||
|
|
name if the file or directory is in the current directory. You can give multiple
|
||
|
|
file and directory names separated with spaces. After you press &Enter;,
|
||
|
|
&kplayer; will start if it is not already running, add the files and directories
|
||
|
|
to the current playlist and start playing them.</para></listitem>
|
||
|
|
|
||
|
|
</itemizedlist>
|
||
|
|
|
||
|
|
</sect2>
|
||
|
|
|
||
|
|
<sect2 id="playing-urls">
|
||
|
|
<title>Remote URLs</title>
|
||
|
|
|
||
|
|
<para>Use any of the following ways to start playing a remote file or stream
|
||
|
|
with a remote <acronym>URL</acronym> using a network protocol like
|
||
|
|
<acronym>HTTP</acronym>, <acronym>FTP</acronym>, Samba, <acronym>MMS</acronym>,
|
||
|
|
<acronym>RTSP</acronym>, <acronym>PNM</acronym>, etc.</para>
|
||
|
|
|
||
|
|
<itemizedlist>
|
||
|
|
|
||
|
|
<listitem><para>Once &kplayer; starts, select
|
||
|
|
<menuchoice><guimenu>File</guimenu><guimenuitem>Play
|
||
|
|
URL...</guimenuitem></menuchoice>, or click the <guibutton>Play URL</guibutton>
|
||
|
|
button on the main toolbar. The standard <guilabel>Play URL</guilabel> dialog
|
||
|
|
will appear, letting you type or paste in a remote <acronym>URL</acronym>.
|
||
|
|
After you click the <guibutton>Open</guibutton> button or press &Enter;,
|
||
|
|
&kplayer; will start playing the <acronym>URL</acronym> you
|
||
|
|
entered.</para></listitem>
|
||
|
|
|
||
|
|
<listitem><para>&kplayer; is associated with all media types it can play.
|
||
|
|
If a type has more than one program associated to it, you need to move &kplayer;
|
||
|
|
to the top of the list on the <guilabel>File Associations</guilabel> page in the
|
||
|
|
&konqueror; configuration dialog. Then you can simply
|
||
|
|
<mousebutton>left</mousebutton> click a link to a media file or stream of that
|
||
|
|
type in &konqueror; Web Browser, and it will open &kplayer; if it is not yet
|
||
|
|
running, put the link on the <link linkend="parts-toolbar-playlist">current
|
||
|
|
playlist</link> and start playing it.</para></listitem>
|
||
|
|
|
||
|
|
<listitem><para>Sometimes a web page will have a media object embedded in
|
||
|
|
it. If &kplayer; is at the top of the list of programs associated with the
|
||
|
|
media type of the object, when you open the page in &konqueror; Web Browser
|
||
|
|
it will embed &kplayer; into the web page and start playing the media. However,
|
||
|
|
it is recommended that you <mousebutton>right</mousebutton> click the media
|
||
|
|
object and choose <guimenuitem>Start &kplayer;</guimenuitem> so that the full
|
||
|
|
&kplayer; opens up and starts playing the media. This will give you a better
|
||
|
|
interface and more options than an embedded &kplayer;.</para></listitem>
|
||
|
|
|
||
|
|
<listitem><para>Just like with <link linkend="playing-files">local files</link>,
|
||
|
|
you can start &kplayer; from a terminal program like &konsole; with the
|
||
|
|
<acronym>URL</acronym> you want to play. This is useful for example if you
|
||
|
|
copied the <acronym>URL</acronym> to the clipboard in a text editor. In the
|
||
|
|
terminal program type</para>
|
||
|
|
|
||
|
|
<para><userinput><command>kplayer</command>
|
||
|
|
<filename><replaceable>mediaurl</replaceable></filename></userinput></para>
|
||
|
|
|
||
|
|
<para>where <filename><replaceable>mediaurl</replaceable></filename> can be any
|
||
|
|
of the many <acronym>URL</acronym> types &kplayer; supports. You have to give
|
||
|
|
the full <acronym>URL</acronym>, and if it has spaces or other special
|
||
|
|
characters in it, you need to enclose the <acronym>URL</acronym> in single
|
||
|
|
quotes so your shell does not try to interpret them. You can give multiple
|
||
|
|
<acronym>URL</acronym>s separated with spaces. After you press &Enter;,
|
||
|
|
&kplayer; will start if it is not already running, put the
|
||
|
|
<acronym>URL</acronym>s on the <link linkend="parts-toolbar-playlist">current
|
||
|
|
playlist</link> and start playing them.</para></listitem>
|
||
|
|
|
||
|
|
<listitem><para>And of course you can keep your favorite multimedia links in the
|
||
|
|
<link linkend="parts-library">multimedia library</link> and include them on your
|
||
|
|
playlists. Then you can play a playlist by choosing its name from the
|
||
|
|
<menuchoice><guimenu>File</guimenu><guisubmenu>Play
|
||
|
|
List</guisubmenu></menuchoice> submenu.</para></listitem>
|
||
|
|
|
||
|
|
</itemizedlist>
|
||
|
|
|
||
|
|
</sect2>
|
||
|
|
|
||
|
|
<sect2 id="playing-devices">
|
||
|
|
<title>Disk and tuner devices</title>
|
||
|
|
|
||
|
|
<para>&kplayer; finds any disk and tuner devices you have on your computer
|
||
|
|
and shows them on the <link linkend="submenu-device"><guimenu>File</guimenu>
|
||
|
|
menu</link> and in the <interface>Devices</interface> section of the <link
|
||
|
|
linkend="parts-library">multimedia library</link>.</para>
|
||
|
|
|
||
|
|
<para>When you insert a disk into a <acronym>DVD</acronym> or
|
||
|
|
<acronym>CD</acronym> device, &kplayer; finds the titles or tracks on the disk
|
||
|
|
and shows them on the <link linkend="submenu-device">device submenu</link> under
|
||
|
|
the <guimenu>File</guimenu> menu as well as in the <interface>multimedia
|
||
|
|
library</interface>.</para>
|
||
|
|
|
||
|
|
<para>To play the whole disk:</para>
|
||
|
|
|
||
|
|
<itemizedlist>
|
||
|
|
|
||
|
|
<listitem><para>Select <menuchoice><guimenuitem>Play
|
||
|
|
Disk</guimenuitem></menuchoice> from the device submenu under the
|
||
|
|
<guimenu>File</guimenu> menu, or</para></listitem>
|
||
|
|
|
||
|
|
<listitem><para><mousebutton>Right</mousebutton> click the device node in the
|
||
|
|
<interface>Devices</interface> section of the <interface>multimedia
|
||
|
|
library</interface> and select
|
||
|
|
<menuchoice><guimenuitem>Play</guimenuitem></menuchoice>, or</para></listitem>
|
||
|
|
|
||
|
|
<listitem><para><mousebutton>Left</mousebutton> click the disk icon when it
|
||
|
|
shows in the <interface>Devices</interface> applet in the &kde; task bar and
|
||
|
|
select <menuchoice><guimenuitem>Play</guimenuitem></menuchoice> from the
|
||
|
|
menu, or</para></listitem>
|
||
|
|
|
||
|
|
<listitem><para><mousebutton>Right</mousebutton> click the disk icon when it
|
||
|
|
shows on the desktop and select
|
||
|
|
<menuchoice><guimenuitem>Play</guimenuitem></menuchoice> from the
|
||
|
|
menu.</para></listitem>
|
||
|
|
|
||
|
|
</itemizedlist>
|
||
|
|
|
||
|
|
<para>To play a title or track:</para>
|
||
|
|
|
||
|
|
<itemizedlist>
|
||
|
|
|
||
|
|
<listitem><para>Select the title or track from the device submenu under the
|
||
|
|
<guimenu>File</guimenu> menu, or</para></listitem>
|
||
|
|
|
||
|
|
<listitem><para>Open the device node in the <interface>Devices</interface>
|
||
|
|
section of the <interface>multimedia library</interface> and execute the title
|
||
|
|
or track with the <mousebutton>left</mousebutton> mouse button or
|
||
|
|
<mousebutton>right</mousebutton> click it and select
|
||
|
|
<menuchoice><guimenuitem>Play</guimenuitem></menuchoice>.</para></listitem>
|
||
|
|
|
||
|
|
</itemizedlist>
|
||
|
|
|
||
|
|
<para>For tuner devices like <acronym>TV</acronym> or <acronym>DVB</acronym>
|
||
|
|
&kplayer; shows the available channels on the device submenu under the
|
||
|
|
<guimenu>File</guimenu> menu as well as under the device node in the
|
||
|
|
<interface>Devices</interface> section of the <interface>multimedia
|
||
|
|
library</interface>.</para>
|
||
|
|
|
||
|
|
<para>To play a channel:</para>
|
||
|
|
|
||
|
|
<itemizedlist>
|
||
|
|
|
||
|
|
<listitem><para>Select the channel from the device submenu under the
|
||
|
|
<guimenu>File</guimenu> menu, or</para></listitem>
|
||
|
|
|
||
|
|
<listitem><para>Open the device node in the <interface>Devices</interface>
|
||
|
|
section of the <interface>multimedia library</interface> and execute the channel
|
||
|
|
with the <mousebutton>left</mousebutton> mouse button or
|
||
|
|
<mousebutton>right</mousebutton> click it and select
|
||
|
|
<menuchoice><guimenuitem>Play</guimenuitem></menuchoice>.</para></listitem>
|
||
|
|
|
||
|
|
</itemizedlist>
|
||
|
|
|
||
|
|
</sect2>
|
||
|
|
|
||
|
|
<sect2 id="playing-slaves">
|
||
|
|
<title>&kde; I/O slaves: fish, sftp, webdav, tar, zip, audiocd, etc.</title>
|
||
|
|
|
||
|
|
<para>&kde; has a great way to access all kinds of data through a system known
|
||
|
|
as <acronym>I/O</acronym> Slaves. They are little programs that let you
|
||
|
|
represent many different sources of data as <acronym>URL</acronym> like
|
||
|
|
addresses, and open them in &kde; programs like &konqueror; and &kplayer;.
|
||
|
|
For example you can access a network host over <acronym>SSH</acronym> with
|
||
|
|
a <acronym>URL</acronym> like
|
||
|
|
<filename>fish:/<replaceable>host/path</replaceable></filename>, or a zip file
|
||
|
|
with a <acronym>URL</acronym> like
|
||
|
|
<filename>zip:/<replaceable>home/cooldude/my.zip</replaceable></filename>.</para>
|
||
|
|
|
||
|
|
<para>So you paste a <acronym>URL</acronym> like that in &konqueror; address
|
||
|
|
bar, hit &Enter; and see the data source as if it was a usual file or a
|
||
|
|
directory with files and subdirectories in it. If one of those files happens
|
||
|
|
to be a multimedia file like an MP3 file for example, you can execute it with
|
||
|
|
the <mousebutton>left</mousebutton> mouse button so that &kplayer; opens up and
|
||
|
|
starts playing the file, just like with plain local files. As usual, for this to
|
||
|
|
work &kplayer; needs to be the top program for that file type on the
|
||
|
|
<guilabel>File Associations</guilabel> page in &konqueror; or
|
||
|
|
&kcontrolcenter;.</para>
|
||
|
|
|
||
|
|
<para>Those same <acronym>URL</acronym>s will work in the <guilabel>Play
|
||
|
|
files</guilabel> dialog that you get when you select
|
||
|
|
<menuchoice><guimenu>File</guimenu><guimenuitem>Play...</guimenuitem></menuchoice>,
|
||
|
|
or click the <guibutton>Play</guibutton> button in &kplayer;. Or if you have the
|
||
|
|
full <acronym>URL</acronym> to the media file itself, like
|
||
|
|
<filename>fish:/<replaceable>host/path/song.mp3</replaceable></filename> or
|
||
|
|
<filename>zip:/<replaceable>home/cooldude/my.zip/subdir/song.mp3</replaceable></filename>,
|
||
|
|
you can paste it into the <guilabel>Play URL</guilabel> dialog that you get by
|
||
|
|
selecting <menuchoice><guimenu>File</guimenu><guimenuitem>Play
|
||
|
|
URL...</guimenuitem></menuchoice> or clicking the <guibutton>Play URL</guibutton>
|
||
|
|
button in &kplayer;.</para>
|
||
|
|
|
||
|
|
<para>Just like with <link linkend="playing-files">local files</link> and
|
||
|
|
<link linkend="playing-urls">remote addresses</link>, you can start &kplayer;
|
||
|
|
from a terminal program like &konsole; with the <acronym>URL</acronym> you want
|
||
|
|
to play. This is useful for example if you copied the <acronym>URL</acronym> to
|
||
|
|
the clipboard in a text editor. In the terminal program type</para>
|
||
|
|
|
||
|
|
<para><userinput><command>kplayer</command>
|
||
|
|
<filename><replaceable>mediaurl</replaceable></filename></userinput></para>
|
||
|
|
|
||
|
|
<para>where <filename><replaceable>mediaurl</replaceable></filename> can be any
|
||
|
|
of the many <acronym>URL</acronym> types &kplayer; supports. You have to give
|
||
|
|
the full <acronym>URL</acronym>, and if it has spaces or other special
|
||
|
|
characters in it, you need to enclose the <acronym>URL</acronym> in single
|
||
|
|
quotes so your shell does not try to interpret them. You can give multiple
|
||
|
|
<acronym>URL</acronym>s separated with spaces. After you press &Enter;,
|
||
|
|
&kplayer; will start if it is not already running, add the
|
||
|
|
<acronym>URL</acronym>s to the playlist and start playing them.</para>
|
||
|
|
|
||
|
|
</sect2>
|
||
|
|
|
||
|
|
</sect1>
|
||
|
|
|
||
|
|
<sect1 id="parts">
|
||
|
|
<title>Parts of &kplayer;</title>
|
||
|
|
|
||
|
|
<para>Here is a brief look at the main parts of &kplayer; window:</para>
|
||
|
|
|
||
|
|
<mediaobject>
|
||
|
|
<imageobject><imagedata format="PNG" fileref="dvd-bear.png"/></imageobject>
|
||
|
|
<textobject>
|
||
|
|
<phrase>A screenshot of &kplayer;</phrase>
|
||
|
|
</textobject>
|
||
|
|
</mediaobject>
|
||
|
|
|
||
|
|
<para>&kplayer; lets you choose what parts of it you want to be visible
|
||
|
|
and position them exactly where you want. You can use the
|
||
|
|
<link linkend="menu-settings"><guimenu>Settings</guimenu></link> menu to choose
|
||
|
|
whether to show or hide the <link linkend="parts-menu-bar">menu bar</link>,
|
||
|
|
<link linkend="parts-toolbar-main">toolbars</link>,
|
||
|
|
the <link linkend="parts-library">multimedia library</link>,
|
||
|
|
the <link linkend="parts-message-log">message log</link>
|
||
|
|
and the <link linkend="parts-status-bar">status bar</link>.
|
||
|
|
The <link linkend="parts-title-bar">title bar</link> as well as the window
|
||
|
|
borders will be hidden when you choose the <guimenuitem>Full
|
||
|
|
Screen</guimenuitem> option from the <guimenu>View</guimenu> menu.</para>
|
||
|
|
|
||
|
|
<sect2 id="parts-title-bar">
|
||
|
|
<title>Title bar</title>
|
||
|
|
|
||
|
|
<para><interface>Title bar</interface> is the strip across the top of &kplayer;
|
||
|
|
window, and operates in the same way as for other &kde; applications.
|
||
|
|
<mousebutton>Right</mousebutton> click the central portion to bring up the
|
||
|
|
<link linkend="popup-title-bar">title bar popup menu</link>.</para>
|
||
|
|
|
||
|
|
</sect2>
|
||
|
|
|
||
|
|
<sect2 id="parts-menu-bar">
|
||
|
|
<title>Menu bar</title>
|
||
|
|
|
||
|
|
<para><interface>Menu bar</interface> is the strip containing names of drop-down
|
||
|
|
menus. <mousebutton>Left</mousebutton> click a name to alternately show and hide
|
||
|
|
that menu, or use <keycombo action="simul">&Alt;<keycap>the underlined
|
||
|
|
letter</keycap></keycombo> in the name as a hot key, for example
|
||
|
|
<keycombo action="simul">&Alt;<keycap>F</keycap></keycombo> to show the
|
||
|
|
<guimenu>File</guimenu> menu. The various menus are described in the <link
|
||
|
|
linkend="menubar">Menu bar</link> section of this document.</para>
|
||
|
|
|
||
|
|
</sect2>
|
||
|
|
|
||
|
|
<sect2 id="parts-toolbar-main">
|
||
|
|
<title>Main toolbar</title>
|
||
|
|
|
||
|
|
<para><interface>Main toolbar</interface> contains buttons for commonly used
|
||
|
|
operations. <mousebutton>Left</mousebutton> clicking an icon will activate
|
||
|
|
the corresponding action. If you have enabled tooltips in the &kcontrolcenter;
|
||
|
|
<menuchoice><guimenu>Appearance & Themes</guimenu>
|
||
|
|
<guisubmenu>Style</guisubmenu></menuchoice> dialog, a brief description of what
|
||
|
|
that icon does will appear when you hover the mouse pointer over it. Some of the
|
||
|
|
main toolbar buttons will pop up slider controls when clicked. The sliders let
|
||
|
|
you change various player controls: sound volume, video contrast, brightness,
|
||
|
|
hue and saturation. The video controls will only be available for video
|
||
|
|
files. See the <link linkend="toolbar-main">Toolbars</link> section of this
|
||
|
|
manual for a full description of the buttons and their actions.</para>
|
||
|
|
|
||
|
|
</sect2>
|
||
|
|
|
||
|
|
<sect2 id="parts-toolbar-playlist">
|
||
|
|
<title>Playlist toolbar</title>
|
||
|
|
|
||
|
|
<para><interface>Playlist toolbar</interface> shows the multimedia title
|
||
|
|
currently loaded or being played, offers commands to go to the next or previous
|
||
|
|
items on the playlist, and also lets you see the entire playlist that consists
|
||
|
|
of items that are currently being played or have been played recently. If you
|
||
|
|
select a different item from the list, &kplayer; will load and start playing it.
|
||
|
|
The toolbar also contains options to loop and shuffle the playlist.
|
||
|
|
See the <link linkend="toolbar-playlist">Playlist toolbar</link> section of the
|
||
|
|
<link linkend="commands">Command reference</link> chapter of this manual for a
|
||
|
|
full description of the buttons and their actions.</para>
|
||
|
|
|
||
|
|
</sect2>
|
||
|
|
|
||
|
|
<sect2 id="parts-video-area">
|
||
|
|
<title>Video area</title>
|
||
|
|
|
||
|
|
<para><interface>Video area</interface> is the central part of &kplayer;.
|
||
|
|
When playing a file that has video, it will display the video and optionally
|
||
|
|
subtitles. Normally it will be hidden when playing an audio only file.
|
||
|
|
<mousebutton>Right</mousebutton> clicking the video area brings up the
|
||
|
|
<link linkend="popup-main">general popup menu</link>.</para>
|
||
|
|
|
||
|
|
</sect2>
|
||
|
|
|
||
|
|
<sect2 id="parts-toolbar-slider">
|
||
|
|
<title>Slider toolbars</title>
|
||
|
|
|
||
|
|
<para><interface>Slider toolbars</interface> contain a slider and one or more
|
||
|
|
related buttons. The <link linkend="toolbar-progress">progress and seeking
|
||
|
|
toolbar</link> is shown when the time length of a media file is known. It
|
||
|
|
displays the playback progress and also allows seeking, that is, moving the
|
||
|
|
playback point back and forth within the file. To seek to a specific position,
|
||
|
|
drag the slider thumb to that position with the &LMB;, or simply click at that
|
||
|
|
position with the &MMB;. To move forward or backward in steps,
|
||
|
|
<mousebutton>left</mousebutton> click the slider to the left or right of the
|
||
|
|
thumb, or click the <guibutton>Forward</guibutton> and
|
||
|
|
<guibutton>Backward</guibutton> buttons.</para>
|
||
|
|
|
||
|
|
<para>Other <interface>slider toolbars</interface> show sliders for volume,
|
||
|
|
contrast, brightness, hue and saturation. These are the same sliders you get
|
||
|
|
from the pop-up slider buttons on the <link linkend="parts-toolbar-main">main
|
||
|
|
toolbar</link>, but they will not disappear when you click elsewhere. The
|
||
|
|
sliders show the current setting and allow you to change it. You can get these
|
||
|
|
toolbars using options on the
|
||
|
|
<link linkend="menu-settings"><guimenu>Settings</guimenu> menu</link>.</para>
|
||
|
|
|
||
|
|
</sect2>
|
||
|
|
|
||
|
|
<sect2 id="parts-status-bar">
|
||
|
|
<title>Status bar</title>
|
||
|
|
|
||
|
|
<para><interface>Status bar</interface> runs across the bottom of the &kplayer;
|
||
|
|
window and shows general information about the player status and progress.</para>
|
||
|
|
|
||
|
|
<para>If an error occurs during playback, the left portion of the status bar
|
||
|
|
will show the word <guilabel>Error</guilabel>, and then you can
|
||
|
|
<mousebutton>left</mousebutton> click it to show the
|
||
|
|
<link linkend="parts-message-log">message log</link> and see the error
|
||
|
|
messages.</para>
|
||
|
|
|
||
|
|
<para>The middle portion displays the current player state, whether it is
|
||
|
|
<guilabel>Idle</guilabel>, <guilabel>Running</guilabel>,
|
||
|
|
<guilabel>Playing</guilabel> or <guilabel>Paused</guilabel>. The right portion
|
||
|
|
displays the current playback time, as well as the total time if it is
|
||
|
|
known.</para>
|
||
|
|
|
||
|
|
</sect2>
|
||
|
|
|
||
|
|
<sect2 id="parts-library">
|
||
|
|
<title>Multimedia library</title>
|
||
|
|
|
||
|
|
<mediaobject>
|
||
|
|
<imageobject><imagedata format="PNG" fileref="multimedia-library.png"/></imageobject>
|
||
|
|
<textobject>
|
||
|
|
<phrase>A screenshot of the multimedia library</phrase>
|
||
|
|
</textobject>
|
||
|
|
</mediaobject>
|
||
|
|
|
||
|
|
<para><interface>Multimedia library</interface> allows you to easily access the
|
||
|
|
multimedia available to you from your computer. In the <interface>multimedia
|
||
|
|
library</interface> window you can browse directories mounted on your system
|
||
|
|
for multimedia files, which include all video, audio and playlist files.
|
||
|
|
A separate section shows your <acronym>CD</acronym> and <acronym>DVD</acronym>
|
||
|
|
drives, disks you insert in them, titles or tracks on those disks, as well as
|
||
|
|
tuner devices like <acronym>TV</acronym> or <acronym>DVB</acronym> cards you
|
||
|
|
have on your system and channels available on those devices.</para>
|
||
|
|
|
||
|
|
<para>Other sections allow you to organize your multimedia files and links
|
||
|
|
to Internet media in a multimedia collection, create playlists, and view the
|
||
|
|
currently and recently played multimedia. You can use the commands on the <link
|
||
|
|
linkend="menu-library"><guimenu>Library</guimenu> menu</link> or the <link
|
||
|
|
linkend="popup-library"><mousebutton>right</mousebutton> click menu</link> to
|
||
|
|
add entries to the collection and playlists, move them around, and play your
|
||
|
|
selection. Additional commands allow you to show or change various information
|
||
|
|
about the media and its <link linkend="properties">properties</link>.</para>
|
||
|
|
|
||
|
|
<para>For details on the available commands and options see the <link
|
||
|
|
linkend="menu-library"><guilabel>Library</guilabel> menu</link> and the <link
|
||
|
|
linkend="popup-library">library popup menu</link> sections of this manual.
|
||
|
|
For a detailed description of the multimedia library feature see the
|
||
|
|
<link linkend="howto-library">Multimedia library micro-HOWTO</link>.</para>
|
||
|
|
|
||
|
|
</sect2>
|
||
|
|
|
||
|
|
<sect2 id="parts-message-log">
|
||
|
|
<title>Message log</title>
|
||
|
|
|
||
|
|
<mediaobject>
|
||
|
|
<imageobject><imagedata format="PNG" fileref="message-log.png"/></imageobject>
|
||
|
|
<textobject>
|
||
|
|
<phrase>A screenshot of the message log</phrase>
|
||
|
|
</textobject>
|
||
|
|
</mediaobject>
|
||
|
|
|
||
|
|
<para><interface>Message log</interface> is a window where &kplayer; shows
|
||
|
|
messages it receives from &mplayer; and &kde; <acronym>I/O</acronym> Slaves.
|
||
|
|
<mousebutton>Right</mousebutton> clicking the message log brings up the <link
|
||
|
|
linkend="popup-message-log">message log popup menu</link> that allows you to
|
||
|
|
select all messages, copy the current selection or remove all messages.</para>
|
||
|
|
|
||
|
|
</sect2>
|
||
|
|
|
||
|
|
</sect1>
|
||
|
|
|
||
|
|
</chapter>
|