summaryrefslogtreecommitdiffstats
path: root/doc/en/howto-devices.docbook
blob: 67835d1b9e08eaed4745c71d187c0b6a5e7429d8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
<sect1 id="howto-devices">
<title>Disk and tuner devices</title>

<sect2 id="howto-devices-setup">
<title>Setting up devices</title>

<para>&kplayer; tries to find any disk and tuner devices you have on your
system. The ones it finds it puts on the
<link linkend="menu-file"><guimenu>File</guimenu> menu</link> and on several
<mousebutton>right</mousebutton> click <link linkend="popup-menus">popup
menus</link>, as well as in the <guilabel>Devices</guilabel> section of the
<link linkend="parts-library"><interface>multimedia
library</interface></link>.</para>

<para>If the device you want &kplayer; to use does not show up on those lists,
you can add it manually by selecting the <guilabel>Devices</guilabel> node in
the <interface>multimedia library</interface> and choosing
<menuchoice><guisubmenu>Add</guisubmenu>
<guimenuitem>Device...</guimenuitem></menuchoice> command from the
<link linkend="menu-library"><guimenu>Library</guimenu> menu</link> or the
<mousebutton>right</mousebutton> click <link linkend="popup-library">popup
menu</link>. &kplayer; will show the <guilabel>Add device</guilabel>
dialog:</para>

<mediaobject>
<imageobject>
<imagedata fileref="device-add.png" format="PNG"/>
</imageobject>
<textobject>
<phrase>Add device dialog</phrase>
</textobject>
</mediaobject>

<para>Enter a unique descriptive name for the device and the path to the device
node under the <filename>/dev</filename> directory. Select the device type from
the drop down box. For a <acronym>TV</acronym> device select a channel list and
an input driver, usually <guilabel>Video4Linux 2</guilabel> or
<guilabel>Video4Linux</guilabel>. A <acronym>DVB</acronym> device needs the path
to a channel file in the <quote>zap</quote> format. You can get the file from
the Internet or create it using the <command>scan</command> utility that comes
with <acronym>DVB</acronym> drivers. &kplayer; looks for existing
<filename>channels.conf</filename> files and selects the first one it finds by
default.</para>

<para>To set additional options for a device, select it in the
<interface>multimedia library</interface> and choose the
<guimenuitem>Properties...</guimenuitem> command from the
<link linkend="menu-library"><guimenu>Library</guimenu> menu</link> or the
<mousebutton>right</mousebutton> click <link linkend="popup-library">popup
menu</link>. Most of the options are the same
<link linkend="howto-properties">properties</link> available for every
multimedia item in &kplayer;.</para>

<para>Tuner devices have several specific options detailed in the <link
linkend="properties"><guilabel>Properties</guilabel> dialog</link> chapter. The
<link linkend="properties-general"><guilabel>General</guilabel> page</link>
has the options to select a list of channels available from the device and an
input driver as discussed above. Other options are on the
<link linkend="properties-video"><guilabel>Video</guilabel></link>,
<link linkend="properties-audio"><guilabel>Audio</guilabel></link> and
<link linkend="properties-advanced"><guilabel>Advanced</guilabel></link> pages
of the dialog.</para>

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

<para>If you had <userinput><option>-dvd-device</option></userinput> or
<userinput><option>-cdrom-device</option></userinput> options in the
<guilabel>Additional command line parameters</guilabel> box on the
<guilabel>Advanced</guilabel> page in
<link linkend="settings-advanced">&kplayer; Settings</link>, you have to remove
them, because since version 0.6 &kplayer; supplies those options to &mplayer;
automatically.</para>

</sect2>

<sect2 id="howto-devices-playing">
<title>Playing from devices</title>

<para>When you put a disk into a <acronym>CD</acronym> or <acronym>DVD</acronym>
drive, &kplayer; detects what kind of disk it is and how many tracks or titles
it has, and updates the <link linkend="submenu-device">device submenu</link> of
the <guilabel>File</guilabel> menu accordingly. The submenu includes commands to
play the whole disk or an individual track or title from it.</para>

<para>&kplayer; supports video <acronym>DVD</acronym>, video
<acronym>CD</acronym>, including <acronym>SVCD</acronym> and other
<acronym>VCD</acronym> varieties, audio <acronym>CD</acronym>, data
<acronym>DVD</acronym> and data <acronym>CD</acronym> disks. If &kplayer; does
not detect your disk automatically for any reason, you can kick off the
detection process manually by selecting the <guimenuitem>Load Disk</guimenuitem>
command from the <link linkend="submenu-device">device submenu</link>.</para>

<para>Tuner devices like <acronym>TV</acronym> or <acronym>DVB</acronym> also
have their own submenus that contain commands to play each individual channel
available on the device. Or you can open the device in the <interface>multimedia
library</interface>, select some channels and play them using the commands on
the <link linkend="menu-library"><guimenu>Library</guimenu> menu</link> or the
<mousebutton>right</mousebutton> click <link linkend="popup-library">popup
menu</link>.</para>

<para>Another way to play an entire disk is through the
<filename>media:/</filename> or <filename>system:/</filename>
<acronym>I/O</acronym> Slaves. If you have the <interface>Devices</interface>
applet enabled in the &kicker; panel, it will show disks you insert into disk
drives. You can then <mousebutton>left</mousebutton> click the disk icon and
select the <guimenuitem>Play</guimenuitem> command. This will start &kplayer;
if it is not already running and play the disk. Similarly, if disk icons show
up on your desktop, you can <mousebutton>right</mousebutton> click them and
select <guimenuitem>Play</guimenuitem>. You can also display the disk icons
in &konqueror; file manager by opening <filename>media:/</filename> or
<filename>system:/media</filename> <acronym>URL</acronym>s in it.</para>

</sect2>

<sect2 id="howto-devices-deinterlacing">
<title>Inverse telecine and deinterlacing</title>

<para>Video on <acronym>DVD</acronym> disks is often telecined. The
<literal>pullup</literal> filter does a decent inverse telecine. To use it,
select the disk or one of its titles in the <guilabel>Devices</guilabel> section
of the
<link linkend="parts-library"><interface>multimedia library</interface></link>
and choose the <guimenuitem>Properties...</guimenuitem> command from the
<link linkend="menu-library"><guimenu>Library</guimenu> menu</link> or the
<mousebutton>right</mousebutton> click <link linkend="popup-library">popup
menu</link> to open the disk properties, then go to the
<link linkend="properties-advanced">Advanced page</link> and enter <option>-vf
pullup</option> in the <guilabel>Additional command line arguments</guilabel>
field before playing the video. Setting the property on the disk will apply the
filter to all titles on the <acronym>DVD</acronym>.</para>

<para>Some <acronym>DVD</acronym> disks and many <acronym>TV</acronym> and
<acronym>DVB</acronym> channels are interlaced. There are several deinterlacing
filters in &mplayer;. Each of them has its own advantages and disadvantages, so
try a few of them starting with <option>-vf yadif</option> and see which one
gives the best results for the particular video you are trying to watch. The
full list is available by running</para>

<para><userinput><command>mplayer</command> <option>-vf help</option>
<option>-pphelp</option> | <command>grep</command>
<option>deint</option></userinput></para>

</sect2>

<sect2 id="howto-devices-deblocking">
<title>Deblocking, deringing, denoising</title>

<para>The <option>-vf</option> option is in charge of video filtering in
&mplayer;. To get the full list of available filters, run</para>

<para><userinput><command>mplayer</command>
<option>-vf help</option></userinput></para>

<para>from the command line. Most of them are described on the
<ulink url="man:/mplayer">&mplayer; manpage</ulink>. One of the most useful
filters is <literal>pp</literal>, the postprocessing filter. Among other things
it can smooth blocky <acronym>MPEG</acronym>s using the deblocking filters
<literal>hb</literal> and <literal>vb</literal> or <literal>h1</literal> and
<literal>v1</literal>, usually combined with the deringing filter
<literal>dr</literal> like this: <option>-vf pp=hb/vb/dr</option> or
<option>-vf pp=h1/v1/dr</option>. To get a full list of <literal>pp</literal>
filters, run</para>

<para><userinput><command>mplayer</command>
<option>-pphelp</option></userinput></para>

<para>from the command line. Another useful filter is <literal>hqdn3d</literal>
that does high quality denoising: <option>-vf hqdn3d</option>.</para>

<para>You can combine several filters together and use them on the same device
or file by separating them with a comma without spaces, for example:</para>

<para><option>-vf pullup,pp=h1/v1/dr,hqdn3d</option></para>

<para>Put that into the <guilabel>Additional command line arguments</guilabel>
field on the <link linkend="properties-advanced">Advanced page</link> in
<guilabel>File Properties</guilabel>.</para>

</sect2>

</sect1>