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.
884 lines
33 KiB
884 lines
33 KiB
<chapter id="properties">
|
|
<title>File properties</title>
|
|
|
|
<sect1 id="properties-overview">
|
|
<title>Overview</title>
|
|
|
|
<para>The <guilabel>File Properties</guilabel> dialog allows you to choose
|
|
various options that will apply only to a particular file, stream, device,
|
|
track, title, or channel. Many of the options are the same or similar to the
|
|
ones that can be chosen globally in the <link linkend="settings">&kplayer;
|
|
Settings</link> dialog. The options set in file properties will override the
|
|
global ones. Additionally, options set for a track, title or channel will
|
|
override options set for the disk or device it comes from. The file properties
|
|
give you full control of how the file is played, including options that are
|
|
passed to &mplayer;. Other properties display information that &kplayer; found
|
|
out about the file or stream, like time length, video size, and audio and video
|
|
bitrates.</para>
|
|
|
|
<para>Select <menuchoice><guimenu>File</guimenu>
|
|
<guimenuitem>Properties...</guimenuitem></menuchoice> to open the dialog
|
|
box for the currently loaded file or <acronym>URL</acronym>. You can also open
|
|
the properties for any item in the <link linkend="parts-library">multimedia
|
|
library</link> by <mousebutton>right</mousebutton> clicking the item and
|
|
selecting <guimenuitem>Properties...</guimenuitem> from the
|
|
<link linkend="popup-library">library popup menu</link> or by selecting
|
|
<menuchoice><guimenu>Library</guimenu><guimenuitem>Properties...</guimenuitem>
|
|
</menuchoice>.</para>
|
|
|
|
<para>The dialog contains several sections which are selected by
|
|
<mousebutton>left</mousebutton> clicking one of the items on the
|
|
left side of the dialog box.</para>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><link linkend="properties-general">General</link> section</term>
|
|
<listitem><para>Shows general information about the multimedia item and lets you
|
|
set a few essential properties.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><link linkend="properties-size">Size</link> section</term>
|
|
<listitem><para>If the file or stream contains video, tells you the video
|
|
resolution and lets you control the video area size when playing
|
|
it.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><link linkend="properties-video">Video</link> section</term>
|
|
<listitem><para>Contains properties that show technical information about
|
|
the video and let you control video output when playing the file, if it has
|
|
a video component.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><link linkend="properties-audio">Audio</link> section</term>
|
|
<listitem><para>Contains properties that show technical information about
|
|
the audio and let you control audio output when playing the file, if it has
|
|
an audio component.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><link linkend="properties-subtitles">Subtitles</link> section</term>
|
|
<listitem><para>Contains properties that control subtitle loading and
|
|
display, if the file is played with subtitles.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><link linkend="properties-advanced">Advanced</link> section</term>
|
|
<listitem><para>Contains various properties that affect advanced command
|
|
line parameters passed to &mplayer;, as well as interaction with the &kde;
|
|
I/O Slave if it is used to transfer the file.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
<para>The buttons at the bottom of the dialog let you make choices
|
|
about the contents of all sections of the dialog.</para>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><guibutton>OK</guibutton> button</term>
|
|
<listitem><para>Accepts your changes and closes the dialog.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guibutton>Cancel</guibutton> button</term>
|
|
<listitem><para>Closes the dialog without saving the changes.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guibutton>Apply</guibutton> button</term>
|
|
<listitem><para>Applies the changes without closing the dialog.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guibutton>Defaults</guibutton> button</term>
|
|
<listitem><para>Restores all settings to their original, predefined values
|
|
and applies them.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guibutton>Close</guibutton> button</term>
|
|
<listitem><para>After you choose <guibutton>Apply</guibutton> or
|
|
<guibutton>Defaults</guibutton>, the <guibutton>Cancel</guibutton> button
|
|
changes to <guibutton>Close</guibutton>. Clicking it closes the dialog
|
|
and discards changes you made since the last time changes were
|
|
applied.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guibutton>Help</guibutton> button</term>
|
|
<listitem><para>Opens this user manual and displays the section that describes
|
|
the currently selected section of the dialog.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
<note><para>You can also click the small <guibutton>What's This</guibutton>
|
|
button with a question mark at the top right of the dialog and then click a
|
|
property to get a brief explanation of it.</para></note>
|
|
|
|
<para>Clicking the rightmost button at the top of the dialog closes the dialog
|
|
discarding any unapplied changes.</para>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="properties-general">
|
|
<title><guilabel>General</guilabel> section</title>
|
|
|
|
<para>This section shows general information about the multimedia item and lets
|
|
you set a few essential properties.</para>
|
|
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="properties-general.png" format="PNG"/>
|
|
</imageobject>
|
|
</mediaobject>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Name</guilabel></term>
|
|
|
|
<listitem><para>This property shows and lets you change the name of the item
|
|
that is displayed in the <link linkend="parts-toolbar-playlist">playlist drop
|
|
down box</link>, the <link linkend="parts-library">multimedia library</link>,
|
|
and also in the &kplayer; title bar when the item is loaded for
|
|
playing.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Path or URL</guilabel></term>
|
|
|
|
<listitem><para>This property shows the file path for local files or the full
|
|
<acronym>URL</acronym> for all other files. The <acronym>URL</acronym>
|
|
identifies the file or stream, and all other properties are attached to it.
|
|
This property is read only. It is not applicable and not shown for
|
|
<acronym>CD</acronym> tracks, <acronym>DVD</acronym> titles and tuner device
|
|
channels.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Type</guilabel></term>
|
|
|
|
<listitem><para>This property shows the type of the multimedia item. For a
|
|
device, track, title or channel it is the device type. For other items it is the
|
|
<acronym>MIME</acronym> type if it is known. This property is read
|
|
only.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Playlist</guilabel></term>
|
|
|
|
<listitem><para>This property shows and lets you choose whether this item
|
|
is a playlist file. &mplayer; cannot automatically detect and play a playlist
|
|
file, so &kplayer; has to explicitly tell it to parse a file as a playlist.
|
|
<guilabel>Auto</guilabel> lets &kplayer; use the file extension to guess
|
|
if it is a playlist file. The playlist extensions KPlayer recognizes are ram,
|
|
rpm, smi, smil, asx, m3u, pls and strm. If a file that is not a playlist has
|
|
one of these extensions, or a playlist file has a different extension, you
|
|
will need to correctly set this property in order to be able to play the file
|
|
or stream.</para>
|
|
|
|
<para>This property is not applicable and not shown for devices, disks, titles,
|
|
tracks and channels.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Length</guilabel></term>
|
|
|
|
<listitem><para>This property shows the time length of the file.
|
|
&kplayer; tries to detect it with precision of one tenth of a second,
|
|
and usually it gets it pretty close to the real length. This property
|
|
is read only. It is not applicable and not shown for devices and
|
|
channels.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
<para>Tuner <link linkend="howto-devices">devices</link> like
|
|
<acronym>DVB</acronym>, <acronym>PVR</acronym> and <acronym>TV</acronym> and
|
|
channels available on them have some specific properties that are not applicable
|
|
to other items.</para>
|
|
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="device-properties-general.png" format="PNG"/>
|
|
</imageobject>
|
|
</mediaobject>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Frequency</guilabel></term>
|
|
|
|
<listitem><para>This property shows and lets you change the frequency in
|
|
<acronym>MHz</acronym> of a <acronym>DVB</acronym>, <acronym>PVR</acronym> or
|
|
<acronym>TV</acronym> channel. For other items this property is not applicable
|
|
and not shown.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Channels</guilabel></term>
|
|
|
|
<listitem><para>This property shows and lets you choose the list of channels
|
|
available on a <acronym>TV</acronym> or <acronym>PVR</acronym> device. For other
|
|
items this property is not applicable and not shown.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Driver</guilabel></term>
|
|
|
|
<listitem><para>This property shows and lets you choose the input driver for a
|
|
<acronym>TV</acronym> or <acronym>PVR</acronym> device. For other items this
|
|
property is not applicable and not shown.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Channel file</guilabel></term>
|
|
|
|
<listitem><para>This property shows and lets you change the path to a file
|
|
listing the available channels on a <acronym>DVB</acronym> device and their
|
|
properties. For other items this property is not applicable and not
|
|
shown.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="properties-size">
|
|
<title><guilabel>Size</guilabel> section</title>
|
|
|
|
<para>This section shows the video resolution and lets you control the
|
|
<link linkend="parts-video-area">video area</link> size when playing this file,
|
|
if it has video.</para>
|
|
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="properties-size.png" format="PNG"/>
|
|
</imageobject>
|
|
</mediaobject>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Resolution</guilabel></term>
|
|
|
|
<listitem><para>This property shows the resolution of the video in pixels.
|
|
It is read only, and it is empty for audio only files.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Original size</guilabel></term>
|
|
|
|
<listitem><para>This property shows the original size of the video in pixels.
|
|
Original video size is the video resolution adjusted to the correct aspect
|
|
ratio. It is read only, and it is empty for audio only files.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Current size</guilabel></term>
|
|
|
|
<listitem><para>This property shows the current size of the video in pixels.
|
|
Current video size is the video size after application of any filters. It is
|
|
read only, and it is empty for audio only files.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Display size</guilabel></term>
|
|
|
|
<listitem><para>This property lets you choose the initial video size &kplayer;
|
|
will use when it starts playing the file, unless you turned off the option to
|
|
<guilabel>Resize main window automatically</guilabel> on the
|
|
<link linkend="settings-general"><guilabel>General</guilabel> page</link> in
|
|
<guilabel>&kplayer; Settings</guilabel>. The <guilabel>auto</guilabel> setting
|
|
will use the <guilabel>Minimum initial video width</guilabel> option from the
|
|
<guilabel>General</guilabel> settings. The <guilabel>set size</guilabel> setting
|
|
will use the fixed initial size you specify. The <guilabel>set aspect</guilabel>
|
|
setting will again use the <guilabel>Minimum initial video width</guilabel>
|
|
option, but will apply the fixed initial aspect you specify.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Full screen</guilabel></term>
|
|
|
|
<listitem><para>This property lets you choose the full screen mode when playing
|
|
this file. The <guilabel>default</guilabel> setting will keep the full screen
|
|
mode of the previous file.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Maximized</guilabel></term>
|
|
|
|
<listitem><para>This property lets you choose the maximized window state when
|
|
this file is not played full screen. The <guilabel>default</guilabel> setting
|
|
will keep the maximized state of the previous file.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Maintain aspect</guilabel></term>
|
|
|
|
<listitem><para>This property lets you choose the <guilabel>Maintain
|
|
Aspect</guilabel> option specifically for this file. The
|
|
<guilabel>default</guilabel> setting will keep the <guilabel>Maintain
|
|
Aspect</guilabel> setting you choose globally.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="properties-video">
|
|
<title><guilabel>Video</guilabel> section</title>
|
|
|
|
<para>This section contains properties that show technical information about
|
|
the video and let you control video output when playing the file, if it has
|
|
a video component.</para>
|
|
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="properties-video.png" format="PNG"/>
|
|
</imageobject>
|
|
</mediaobject>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Track</guilabel></term>
|
|
|
|
<listitem><para>This property lets you choose the video track to use when
|
|
playing this file or stream. The <guilabel>auto</guilabel> option lets &mplayer;
|
|
choose a video track automatically. The <guilabel>set ID</guilabel> option
|
|
allows you to enter a video track ID to play. The other options choose a video
|
|
track from the list of detected tracks. An easy way to set this property for a
|
|
file or stream that has more than one video track is by selecting a video track
|
|
from the <link linkend="submenu-video"><guisubmenu>Video</guisubmenu>
|
|
submenu</link> of the <guimenu>Player</guimenu> menu.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Contrast</guilabel></term>
|
|
|
|
<listitem><para>This property controls the video contrast for this file.
|
|
The <guilabel>default</guilabel> option uses the same contrast as for other
|
|
files. The <guilabel>set to</guilabel> option sets the specified initial
|
|
contrast when loading the file. The <guilabel>add</guilabel> and
|
|
<guilabel>subtract</guilabel> settings will adjust the contrast relative
|
|
to the default setting.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Brightness</guilabel></term>
|
|
|
|
<listitem><para>This property controls the video brightness for this file.
|
|
The <guilabel>default</guilabel> option uses the same brightness as for other
|
|
files. The <guilabel>set to</guilabel> option sets the specified initial
|
|
brightness when loading the file. The <guilabel>add</guilabel> and
|
|
<guilabel>subtract</guilabel> settings will adjust the brightness relative
|
|
to the default setting.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Hue</guilabel></term>
|
|
|
|
<listitem><para>This property controls the video hue for this file.
|
|
The <guilabel>default</guilabel> option uses the same hue as for other
|
|
files. The <guilabel>set to</guilabel> option sets the specified initial
|
|
hue when loading the file. The <guilabel>add</guilabel> and
|
|
<guilabel>subtract</guilabel> settings will adjust the hue relative
|
|
to the default setting.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Saturation</guilabel></term>
|
|
|
|
<listitem><para>This property controls the video saturation for this file.
|
|
The <guilabel>default</guilabel> option uses the same saturation as for other
|
|
files. The <guilabel>set to</guilabel> option sets the specified initial
|
|
saturation when loading the file. The <guilabel>add</guilabel> and
|
|
<guilabel>subtract</guilabel> settings will adjust the saturation relative
|
|
to the default setting.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Codec</guilabel></term>
|
|
|
|
<listitem><para>This property specifies the video codec to use when playing this
|
|
file. The <guilabel>default</guilabel> setting will use the codec chosen on the
|
|
<link linkend="settings-video"><guilabel>Video</guilabel> page</link> in
|
|
<guilabel>&kplayer; Settings</guilabel>, normally <guilabel>auto</guilabel>. The
|
|
<guilabel>auto</guilabel> setting will tell &mplayer; to choose the codec it
|
|
thinks is the best for playing this file.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Bitrate</guilabel></term>
|
|
|
|
<listitem><para>This property shows the video bitrate of this file.
|
|
It is read only, and it is empty for audio only files.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Framerate</guilabel></term>
|
|
|
|
<listitem><para>This property shows the video framerate of this file.
|
|
It is read only, and it is empty for audio only files.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
<para>Tuner <link linkend="howto-devices">devices</link> like
|
|
<acronym>DVB</acronym>, <acronym>PVR</acronym> and <acronym>TV</acronym> have
|
|
some specific properties that are not applicable to other items.</para>
|
|
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="device-properties-video.png" format="PNG"/>
|
|
</imageobject>
|
|
</mediaobject>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Input</guilabel></term>
|
|
|
|
<listitem><para>This property lets you choose the video input to use when
|
|
playing from the tuner device. The <guilabel>auto</guilabel> option tells
|
|
&mplayer; to choose a <acronym>TV</acronym> or <acronym>DVB</acronym> input
|
|
automatically. The <guilabel>set to</guilabel> option allows you to enter an
|
|
input ID to be used. For other items this property is not applicable and not
|
|
shown.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Format</guilabel></term>
|
|
|
|
<listitem><para>This property lets you choose the video format to use when
|
|
playing from the <acronym>PVR</acronym> or <acronym>TV</acronym> device. The
|
|
<guilabel>auto</guilabel> option tells &mplayer; to choose a video output format
|
|
automatically. The other options let you specify a particular video format.
|
|
For other items this property is not applicable and not shown.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Norm</guilabel></term>
|
|
|
|
<listitem><para>This property lets you choose the video norm to use when
|
|
playing from the <acronym>PVR</acronym> or <acronym>TV</acronym> device.
|
|
The <guilabel>auto</guilabel> option tells &mplayer; to choose a video norm
|
|
automatically. The <guilabel>set ID</guilabel> option allows you to enter a norm
|
|
ID to be used. The other options let you choose a particular video norm. For
|
|
other items this property is not applicable and not shown.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="properties-audio">
|
|
<title><guilabel>Audio</guilabel> section</title>
|
|
|
|
<para>This section contains properties that show technical information about
|
|
the audio and let you control audio output when playing the file, if it has
|
|
an audio component.</para>
|
|
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="properties-audio.png" format="PNG"/>
|
|
</imageobject>
|
|
</mediaobject>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Track</guilabel></term>
|
|
|
|
<listitem><para>This property lets you choose the audio track to use when
|
|
playing this file or stream. The <guilabel>auto</guilabel> option lets &mplayer;
|
|
choose an audio track automatically. The <guilabel>set ID</guilabel> option
|
|
allows you to enter a audio track ID to play. The other options choose an audio
|
|
track from the list of detected tracks. An easy way to set this property for a
|
|
file or stream that has more than one audio track is by selecting an audio track
|
|
from the <link linkend="submenu-audio"><guisubmenu>Audio</guisubmenu>
|
|
submenu</link> of the <guimenu>Player</guimenu> menu.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Volume</guilabel></term>
|
|
|
|
<listitem><para>This property controls the sound volume for this file.
|
|
The <guilabel>default</guilabel> option uses the same volume as for other
|
|
files. The <guilabel>set to</guilabel> option sets the specified initial
|
|
volume when loading the file. The <guilabel>add</guilabel> and
|
|
<guilabel>subtract</guilabel> settings will adjust the volume relative
|
|
to the default setting.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Delay</guilabel></term>
|
|
|
|
<listitem><para>This property controls delay of the sound relative to video.
|
|
By default this property is remembered automatically when you use the
|
|
<guimenuitem>Increase Delay</guimenuitem> and <guimenuitem>Decrease
|
|
Delay</guimenuitem> commands from the
|
|
<link linkend="submenu-audio"><guisubmenu>Audio</guisubmenu> submenu</link>
|
|
of the <guimenu>Player</guimenu> menu. The <guilabel>default</guilabel>
|
|
setting always resets audio delay to zero when the file is
|
|
loaded.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Codec</guilabel></term>
|
|
|
|
<listitem><para>This property specifies the audio codec to use when playing this
|
|
file. The <guilabel>default</guilabel> setting will use the codec chosen on the
|
|
<link linkend="settings-audio"><guilabel>Audio</guilabel> page</link> in
|
|
<guilabel>&kplayer; Settings</guilabel>, normally <guilabel>auto</guilabel>. The
|
|
<guilabel>auto</guilabel> setting will tell &mplayer; to choose the codec it
|
|
thinks is the best for playing this file.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Bitrate</guilabel></term>
|
|
|
|
<listitem><para>This property shows the audio bitrate of this file. It is
|
|
read only, and it is empty for files without an audio track.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Samplerate</guilabel></term>
|
|
|
|
<listitem><para>This property shows the audio samplerate of this file. It is
|
|
read only, and it is empty for files without an audio track.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
<para>Tuner <link linkend="howto-devices">devices</link> like
|
|
<acronym>DVB</acronym>, <acronym>PVR</acronym> and <acronym>TV</acronym> have
|
|
some specific properties that are not applicable to other items.</para>
|
|
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="device-properties-audio.png" format="PNG"/>
|
|
</imageobject>
|
|
</mediaobject>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Mode</guilabel></term>
|
|
|
|
<listitem><para>This property lets you choose the audio mode to use when
|
|
playing from the <acronym>PVR</acronym> or <acronym>TV</acronym> device.
|
|
The <guilabel>auto</guilabel> option tells &mplayer; to choose an audio mode
|
|
automatically. The other options let you specify a particular audio mode.
|
|
For other items this property is not applicable and not shown.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Input</guilabel></term>
|
|
|
|
<listitem><para>This property lets you choose the audio input to use when
|
|
playing from the tuner device. The <guilabel>auto</guilabel> option tells
|
|
&mplayer; to choose a <acronym>TV</acronym> or <acronym>DVB</acronym> audio
|
|
input automatically. The <guilabel>set to</guilabel> option allows you to enter
|
|
an input ID to be used. For other items this property is not applicable and not
|
|
shown.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Immediate mode</guilabel></term>
|
|
|
|
<listitem><para>This property lets you choose the immediate mode for playing
|
|
from the <acronym>PVR</acronym> or <acronym>TV</acronym> device. When disabled,
|
|
&mplayer; will capture audio from the same device as video. When enabled, tells
|
|
&mplayer; to capture audio through a cable going from the <acronym>TV</acronym>
|
|
card to the sound card. For other items this property is not applicable and not
|
|
shown.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Capture</guilabel></term>
|
|
|
|
<listitem><para>This property lets you choose the audio capture system, either
|
|
<acronym>ALSA</acronym> or <acronym>OSS</acronym>, for playing from the
|
|
<acronym>PVR</acronym> or <acronym>TV</acronym> device. For other items this
|
|
property is not applicable and not shown.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Capture device</guilabel></term>
|
|
|
|
<listitem><para>This property lets you specify the audio capture device for
|
|
playing from the <acronym>PVR</acronym> or <acronym>TV</acronym> device. For
|
|
other items this property is not applicable and not shown.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="properties-subtitles">
|
|
<title><guilabel>Subtitles</guilabel> section</title>
|
|
|
|
<para>This section contains properties that control subtitle loading and
|
|
display, if the file is played with subtitles.</para>
|
|
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="properties-subtitles.png" format="PNG"/>
|
|
</imageobject>
|
|
</mediaobject>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Track</guilabel></term>
|
|
|
|
<listitem><para>This property lets you choose the subtitles to use when playing
|
|
this file or stream. The <guilabel>none</guilabel> option disables subtitle
|
|
display. The <guilabel>external</guilabel> option tells &mplayer; to display
|
|
subtitles loaded from an external file given by the <guilabel>External
|
|
path</guilabel> property below. The <guilabel>set ID</guilabel> option allows
|
|
you to enter an internal subtitle track ID to play. The other options choose an
|
|
internal subtitle track from the list of detected tracks. An easy way to set
|
|
this property is by selecting a subtitle track or file or the
|
|
<guimenuitem>None</guimenuitem> option from the
|
|
<link linkend="submenu-subtitles"><guisubmenu>Subtitles</guisubmenu>
|
|
submenu</link> of the <guimenu>Player</guimenu> menu.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>External path</guilabel></term>
|
|
|
|
<listitem><para>This property specifies the path to the external subtitle file
|
|
to be used for this file. This property is set automatically when you use the
|
|
<guimenuitem>Load Subtitles...</guimenuitem> command from the
|
|
<guimenu>File</guimenu> menu or drag and drop subtitle files onto the &kplayer;
|
|
window, and the <guilabel>Track</guilabel> property above is set to
|
|
<guilabel>external</guilabel>.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>External type</guilabel></term>
|
|
|
|
<listitem><para>This property allows you to specify the type of the external
|
|
subtitles. The <guilabel>auto</guilabel> option tells &kplayer; to determine
|
|
the type based on the subtitle file extension.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Encoding</guilabel></term>
|
|
|
|
<listitem><para>This property lets you specify the encoding of text in the
|
|
external subtitle file. The <guilabel>default</guilabel> option tells &kplayer;
|
|
to use the encoding specified in
|
|
<link linkend="settings-subtitles"><guilabel>&kplayer;
|
|
Settings</guilabel></link>.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Framerate</guilabel></term>
|
|
|
|
<listitem><para>This property lets you specify the frame rate of the external
|
|
subtitle file. The <guilabel>auto</guilabel> option uses the frame rate of the
|
|
video file.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Autoload</guilabel></term>
|
|
|
|
<listitem><para>If this is a local file, this property tells &kplayer; whether
|
|
to try to autoload subtitles for it. The <guilabel>default</guilabel> setting
|
|
uses the <guilabel>Autoload</guilabel> settings from the
|
|
<link linkend="settings-subtitles"><guilabel>Subtitles</guilabel> page</link>
|
|
in <guilabel>&kplayer; Settings</guilabel>.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Position</guilabel></term>
|
|
|
|
<listitem><para>This property lets you set vertical position of subtitles.
|
|
The <guilabel>default</guilabel> setting will use the same subtitle position
|
|
as for other files. An easy way to set this property is by using keyboard
|
|
shortcuts for subtitle position commands on the
|
|
<link linkend="submenu-subtitles"><guisubmenu>Subtitles</guisubmenu>
|
|
submenu</link> of the <guimenu>Player</guimenu> menu while holding down the
|
|
&Shift; key.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Delay</guilabel></term>
|
|
|
|
<listitem><para>This property controls delay of the subtitles relative to
|
|
video. By default this property is remembered automatically when you use
|
|
the <guimenuitem>Increase Delay</guimenuitem> and <guimenuitem>Decrease
|
|
Delay</guimenuitem> commands from the
|
|
<link linkend="submenu-subtitles"><guisubmenu>Subtitles</guisubmenu>
|
|
submenu</link> of the <guimenu>Player</guimenu> menu. The
|
|
<guilabel>default</guilabel> setting always resets subtitle delay to zero when
|
|
the file is loaded.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Closed caption</guilabel></term>
|
|
|
|
<listitem><para>This property lets you choose to display or omit closed caption
|
|
subtitles on a specific device or disk or for each individual title on a
|
|
<acronym>DVD</acronym>. This property is not available for files or remote
|
|
streams.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="device-properties-subtitles.png" format="PNG"/>
|
|
</imageobject>
|
|
</mediaobject>
|
|
|
|
</sect1>
|
|
|
|
<sect1 id="properties-advanced">
|
|
<title><guilabel>Advanced</guilabel> section</title>
|
|
|
|
<para>This section contains various properties that affect advanced command
|
|
line parameters passed to &mplayer;, as well as interaction with the &kde;
|
|
I/O Slave if it is used to transfer the file.</para>
|
|
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="properties-advanced.png" format="PNG"/>
|
|
</imageobject>
|
|
</mediaobject>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Additional command line arguments</guilabel></term>
|
|
|
|
<listitem><para>This property lets you specify additional arguments to be
|
|
passed to &mplayer;. You can either <guilabel>append</guilabel> the arguments
|
|
to the ones given on the
|
|
<link linkend="settings-advanced"><guilabel>Advanced</guilabel></link> page in
|
|
<guilabel>&kplayer; Settings</guilabel> or use the <guilabel>set to</guilabel>
|
|
setting to override them. The <guilabel>default</guilabel> option uses the
|
|
arguments given in <guilabel>&kplayer; Settings</guilabel>.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Demuxer</guilabel></term>
|
|
|
|
<listitem><para>This property specifies the demultiplexer to use when playing
|
|
this file. The <guilabel>default</guilabel> setting will use the demuxer chosen
|
|
on the <link linkend="settings-advanced"><guilabel>Advanced</guilabel>
|
|
page</link> in <guilabel>&kplayer; Settings</guilabel>, normally
|
|
<guilabel>auto</guilabel>. The <guilabel>auto</guilabel> setting will tell
|
|
&mplayer; to choose the demuxer it thinks is the best for playing this
|
|
file.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Frame drop</guilabel></term>
|
|
|
|
<listitem><para>This property allows you to tell &mplayer; to drop some frames
|
|
if your system is too slow to play the file properly.
|
|
The <guilabel>soft</guilabel> setting drops less frames than
|
|
the <guilabel>hard</guilabel> one, so you should try it first.
|
|
The <guilabel>default</guilabel> option uses the <guilabel>Frame drop</guilabel>
|
|
setting from the <link linkend="settings-advanced"><guilabel>Advanced</guilabel>
|
|
page</link> in <guilabel>&kplayer; Settings</guilabel>. You can also change this
|
|
option while playing a file using commands on the
|
|
<link linkend="submenu-advanced"><guisubmenu>Advanced</guisubmenu>
|
|
submenu</link> of the <guimenu>Player</guimenu> menu. If you hold &Shift; when
|
|
choosing them, &kplayer; by default will use the setting only for the current
|
|
file and remember it in this property.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Cache</guilabel></term>
|
|
|
|
<listitem><para>This property lets you choose whether to use cache for this
|
|
file and set its size. The <guilabel>default</guilabel> setting uses the cache
|
|
options from the <link linkend="settings-advanced"><guilabel>Advanced</guilabel>
|
|
page</link> in <guilabel>&kplayer; Settings</guilabel>,
|
|
<guilabel>auto</guilabel> lets &mplayer; choose an optimal cache size,
|
|
<guilabel>none</guilabel> tells &mplayer; to use no cache, and <guilabel>set
|
|
size</guilabel> lets you set a specific size.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Build new index</guilabel></term>
|
|
|
|
<listitem><para>This property lets you choose whether &mplayer; should build
|
|
a new index for seeking. The <guilabel>default</guilabel> setting uses the
|
|
option from <link linkend="settings-advanced"><guilabel>&kplayer;
|
|
Settings</guilabel></link>, <guilabel>yes</guilabel> builds an index if the file
|
|
does not have it, <guilabel>no</guilabel> tells &mplayer; not to build an index,
|
|
and <guilabel>force</guilabel> tells it to always build an
|
|
index.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Use KIOSlave</guilabel></term>
|
|
|
|
<listitem><para>This property lets you choose whether to use a &kde; I/O
|
|
Slave to transfer and play this file. The <guilabel>auto</guilabel> setting
|
|
tells &kplayer; to decide it automatically using options set in
|
|
<link linkend="settings-advanced"><guilabel>&kplayer;
|
|
Settings</guilabel></link>.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Use temporary file</guilabel></term>
|
|
|
|
<listitem><para>This property lets you choose whether to use a temporary
|
|
file for playing from &kde; I/O Slave. The <guilabel>default</guilabel>
|
|
setting uses the option from <link
|
|
linkend="settings-advanced"><guilabel>&kplayer; Settings</guilabel></link>. This
|
|
property has no effect for URLs passed directly to &mplayer;.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
<para><acronym>PVR</acronym> and <acronym>TV</acronym>
|
|
<link linkend="howto-devices">devices</link> have some specific properties that
|
|
are not applicable to other items.</para>
|
|
|
|
<mediaobject>
|
|
<imageobject>
|
|
<imagedata fileref="device-properties-advanced.png" format="PNG"/>
|
|
</imageobject>
|
|
</mediaobject>
|
|
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Hardware compression</guilabel></term>
|
|
|
|
<listitem><para>This property lets you choose whether to use
|
|
<acronym>MJPEG</acronym> hardware compression for a <acronym>PVR</acronym> or
|
|
<acronym>TV</acronym> device and lets you specify the decimation or image size.
|
|
For other items this property is not applicable and not shown.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term><guilabel>Compression quality</guilabel></term>
|
|
|
|
<listitem><para>This property lets you specify the compression quality from 0 to
|
|
100 when hardware compression is enabled for a <acronym>PVR</acronym> or
|
|
<acronym>TV</acronym> device. For other items this property is not applicable
|
|
and not shown.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect1>
|
|
|
|
</chapter>
|