annotate DOCS/xml/en/tvinput.xml @ 27018:d8e2eb33be6b

add missing <application> tag around MPlayer, patch by Cedric Viou
author gpoirier
date Wed, 11 Jun 2008 20:25:09 +0000
parents 90896a8ab7b7
children b98fceff7bc7
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
20535
c0687e92d463 convert DOCS/xml/en and help_mp-en.h to UTF-8
kraymer
parents: 17321
diff changeset
1 <?xml version="1.0" encoding="utf-8"?>
10913
49b1a67e7381 Add revision keyword to english xml files, to ease translation synchronization
lumag
parents: 9948
diff changeset
2 <!-- $Revision$ -->
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 17280
diff changeset
3 <chapter id="tv">
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 17280
diff changeset
4 <title>TV</title>
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 17280
diff changeset
5
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
6 <sect1 id="tv-input" xreflabel="TV input">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
7 <title>TV input</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
8
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
9 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
10 This section is about how to enable <emphasis role="bold">watching/grabbing
9776
861a40949bf3 fixes, some by Dmitry Baryshkov <lumag@qnc.ru>, some by me
nicolas
parents: 9683
diff changeset
11 from V4L compatible TV tuner</emphasis>. See the man page for a description
861a40949bf3 fixes, some by Dmitry Baryshkov <lumag@qnc.ru>, some by me
nicolas
parents: 9683
diff changeset
12 of TV options and keyboard controls.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
13 </para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
14
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
15 <!-- ********** -->
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
16
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
17 <sect2 id="tv-compilation">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
18 <title>Compilation</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
19
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
20 <procedure>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
21 <step><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
22 First, you have to recompile. <filename>./configure</filename> will
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
23 autodetect kernel headers of v4l stuff and the existence of
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
24 <filename>/dev/video*</filename> entries. If they exist, TV support will
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
25 be built (see the output of <filename>./configure</filename>).
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
26 </para></step>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
27 <step><para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
28 Make sure your tuner works with another TV software in Linux, for
9776
861a40949bf3 fixes, some by Dmitry Baryshkov <lumag@qnc.ru>, some by me
nicolas
parents: 9683
diff changeset
29 example <application>XawTV</application>.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
30 </para></step>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
31 </procedure>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
32 </sect2>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
33
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
34 <!-- ********** -->
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
35
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
36 <sect2 id="tv-tips">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
37 <title>Usage tips</title>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
38
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
39 <para>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
40 The full listing of the options is available on the manual page.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
41 Here are just a few tips:
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
42
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
43 <itemizedlist>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
44 <listitem><para>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
45 Use the <option>channels</option> option. An example:
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
46 <screen>-tv channels=26-MTV1,23-TV2</screen>
23516
5441be2c507b caps character after "Explanation:" in tvinput.xml
ptt
parents: 21732
diff changeset
47 Explanation: Using this option, only the 26 and 23 channels will be usable,
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
48 and there will be a nice OSD text upon channel switching, displaying the
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
49 channel's name. Spaces in the channel name must be replaced by the
21596
f551403d82a9 replace &quot; with ", better readability
torinthiel
parents: 21521
diff changeset
50 "_" character.
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
51 </para></listitem>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
52 <listitem><para>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
53 Choose some sane image dimensions. The dimensions of the resulting image
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
54 should be divisible by 16.
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
55 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
56 <listitem>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
57 <para>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
58 If you capture the video with the vertical resolution higher than half
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
59 of the full resolution (i.e. 288 for PAL or 240 for NTSC), then the
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
60 'frames' you get will really be interleaved pairs of fields.
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
61 Depending on what you want to do with the video you may leave it in
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
62 this form, destructively deinterlace, or break the pairs apart into
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
63 individual fields.
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
64 </para>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
65 <para>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
66 Otherwise you'll get a movie which is distorted during
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
67 fast-motion scenes and the bitrate controller will be probably even unable
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
68 to retain the specified bitrate as the interlacing artifacts produce high
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
69 amount of detail and thus consume lot of bandwidth. You can enable
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
70 deinterlacing with <option>-vf pp=DEINT_TYPE</option>.
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
71 Usually <option>pp=lb</option> does a good job, but it can be matter of
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
72 personal preference.
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
73 See other deinterlacing algorithms in the manual and give it a try.
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
74 </para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
75 </listitem>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
76 <listitem><para>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
77 Crop out the dead space. When you capture the video, the areas at the edges
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
78 are usually black or contain some noise. These again consume lots of
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
79 unnecessary bandwidth. More precisely it's not the black areas themselves
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
80 but the sharp transitions between the black and the brighter video image
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
81 which do but that's not important for now. Before you start capturing,
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
82 adjust the arguments of the <option>crop</option> option so that all the
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
83 crap at the margins is cropped out. Again, don't forget to keep the resulting
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
84 dimensions sane.
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
85 </para></listitem>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
86 <listitem><para>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
87 Watch out for CPU load. It shouldn't cross the 90% boundary for most of the
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
88 time. If you have a large capture buffer, <application>MEncoder</application>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
89 can survive an overload for few seconds but nothing more. It's better to
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
90 turn off the 3D OpenGL screensavers and similar stuff.
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
91 </para></listitem>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
92 <listitem><para>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
93 Don't mess with the system clock. <application>MEncoder</application> uses the
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
94 system clock for doing A/V sync. If you adjust the system clock (especially
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
95 backwards in time), <application>MEncoder</application> gets confused and you
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
96 will lose frames. This is an important issue if you are hooked to a network
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
97 and run some time synchronization software like NTP. You have to turn NTP
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
98 off during the capture process if you want to capture reliably.
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
99 </para></listitem>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
100 <listitem><para>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
101 Don't change the <option>outfmt</option> unless you know what you are doing
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
102 or your card/driver really doesn't support the default (YV12 colorspace).
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
103 In the older versions of <application>MPlayer</application>/
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
104 <application>MEncoder</application> it was necessary to specify the output
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
105 format. This issue should be fixed in the current releases and
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
106 <option>outfmt</option> isn't required anymore, and the default suits the
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
107 most purposes. For example, if you are capturing into DivX using
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
108 <systemitem class="library">libavcodec</systemitem> and specify
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
109 <option>outfmt=RGB24</option> in order to increase the quality of the captured
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
110 images, the captured image will be actually later converted back into YV12 so
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
111 the only thing you achieve is a massive waste of CPU power.
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
112 </para></listitem>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
113 <listitem><para>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
114 To specify the I420 colorspace (<option>outfmt=i420</option>), you have to
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
115 add an option <option>-vc rawi420</option> due to a fourcc conflict with an
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
116 Intel Indeo video codec.
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
117 </para></listitem>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
118 <listitem><para>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
119 There are several ways of capturing audio. You can grab the sound either using
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
120 your sound card via an external cable connection between video card and
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
121 line-in, or using the built-in ADC in the bt878 chip. In the latter case, you
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
122 have to load the <emphasis role="bold">btaudio</emphasis> driver. Read the
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
123 <filename>linux/Documentation/sound/btaudio</filename> file (in the kernel
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
124 tree, not <application>MPlayer</application>'s) for some instructions on using
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
125 this driver.
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
126 </para></listitem>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
127 <listitem><para>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
128 If <application>MEncoder</application> cannot open the audio device, make
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
129 sure that it is really available. There can be some trouble with the sound
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
130 servers like aRts (KDE) or ESD (GNOME). If you have a full duplex sound card
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
131 (almost any decent card supports it today), and you are using KDE, try to
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
132 check the "full duplex" option in the sound server preference menu.
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
133 </para></listitem>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
134 </itemizedlist>
21732
893e314fff49 Reformatting round continued
torinthiel
parents: 21596
diff changeset
135 </para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
136 </sect2>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
137
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
138 <!-- ********** -->
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
139
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
140 <sect2 id="tv-examples">
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
141 <title>Examples</title>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
142
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
143 <informalexample><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
144 Dummy output, to AAlib :)
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
145 <screen>mplayer -tv driver=dummy:width=640:height=480 -vo aa tv://</screen>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
146 </para></informalexample>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
147
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
148 <informalexample><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
149 Input from standard V4L:
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
150 <screen>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
151 mplayer -tv driver=v4l:width=640:height=480:outfmt=i420 -vc rawi420 -vo xv tv://
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
152 </screen>
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
153 </para></informalexample>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
154
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
155 <informalexample><para>
11540
d480f7e36b74 <application> attack
wight
parents: 11271
diff changeset
156 A more sophisticated example. This makes <application>MEncoder</application>
d480f7e36b74 <application> attack
wight
parents: 11271
diff changeset
157 capture the full PAL image, crop the margins, and deinterlace the picture
d480f7e36b74 <application> attack
wight
parents: 11271
diff changeset
158 using a linear blend algorithm. Audio is compressed with a constant bitrate
d480f7e36b74 <application> attack
wight
parents: 11271
diff changeset
159 of 64kbps, using LAME codec. This setup is suitable for capturing movies.
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
160 <screen>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
161 mencoder -tv driver=v4l:width=768:height=576 -oac mp3lame -lameopts cbr:br=64\
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
162 -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=900 \
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
163 -vf crop=720:544:24:16,pp=lb -o <replaceable>output.avi</replaceable> tv://
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
164 </screen>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
165 </para></informalexample>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
166
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
167 <informalexample><para>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
168 This will additionally rescale the image to 384x288 and compresses the
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
169 video with the bitrate of 350kbps in high quality mode. The vqmax option
11271
252fb0cf331a spelling fixes, mostly by <ismail.donmez@boun.edu.tr>
diego
parents: 10913
diff changeset
170 looses the quantizer and allows the video compressor to actually reach so
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
171 low bitrate even at the expense of the quality. This can be used for
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
172 capturing long TV series, where the video quality isn't so important.
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
173 <screen>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
174 mencoder -tv driver=v4l:width=768:height=576 \
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
175 -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=350:vhq:vqmax=31:keyint=300 \
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
176 -oac mp3lame -lameopts cbr:br=48 -sws 1 -o <replaceable>output.avi</replaceable>\
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
177 -vf crop=720:540:24:18,pp=lb,scale=384:288 tv://
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
178 </screen>
21521
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
179 It's also possible to specify smaller image dimensions in the
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
180 <option>-tv</option> option and omit the software scaling but this approach
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
181 uses the maximum available information and is a little more resistant to noise.
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
182 The bt8x8 chips can do the pixel averaging only in the horizontal direction due
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
183 to a hardware limitation.
b210a229fbcb General reformatting round:
torinthiel
parents: 20535
diff changeset
184 </para></informalexample>
9675
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
185 </sect2>
62c5a17038ba XML version of MPlayer's doc
nicolas
parents:
diff changeset
186 </sect1>
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 17280
diff changeset
187
24584
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
188
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
189 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
190
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
191
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
192 <sect1 id="tv-teletext">
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
193 <title>Teletext</title>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
194
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
195 <para>
27018
d8e2eb33be6b add missing <application> tag around MPlayer,
gpoirier
parents: 24584
diff changeset
196 Teletext is currently available only in <application>MPlayer</application>
d8e2eb33be6b add missing <application> tag around MPlayer,
gpoirier
parents: 24584
diff changeset
197 for v4l and v4l2 drivers.
24584
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
198 </para>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
199
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
200 <sect2 id="tv-teletext-implementation-notes">
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
201 <title>Implementation notes</title>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
202
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
203 <para>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
204 <application>MPlayer</application> supports regular text, graphics and navigation links.
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
205 Unfortunately, colored pages are not fully supported yet - all pages are shown as grayscaled.
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
206 Subtitle pages (also known as Closed Captions) are supported, too.
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
207 </para>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
208
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
209 <para>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
210 <application>MPlayer</application> starts caching all teletext pages upon
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
211 starting to receive TV input, so you do not need to wait until the requested page is loaded.
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
212 </para>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
213
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
214 <para>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
215 Note: Using teletext with <option>-vo xv</option> causes strange colors.
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
216 </para>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
217 </sect2>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
218
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
219 <sect2 id="tv-teletext-usage">
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
220 <title>Using teletext</title>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
221
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
222 <para>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
223 To enable teletext decoding you must specify the VBI device to get teletext data
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
224 from (usually <filename>/dev/vbi0</filename> for Linux). This can be done by specifying
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
225 <option>tdevice</option> in your configuration file, like shown below:
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
226 <screen>tv=tdevice=/dev/vbi0</screen>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
227 </para>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
228
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
229 <para>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
230 You might need to specify the teletext language code for your country.
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
231 To list all available country codes use
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
232 <screen>tv=tdevice=/dev/vbi0:tlang=<replaceable>-1</replaceable></screen>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
233 Here is an example for Russian:
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
234 <screen>tv=tdevice=/dev/vbi0:tlang=<replaceable>33</replaceable></screen>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
235 </para>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
236
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
237 <para>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
238 </para>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
239 </sect2>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
240
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
241 <sect2 id="tv-teletext-hotkeys">
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
242 <title>Teletext hot keys</title>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
243
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
244 <informaltable frame="all">
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
245 <tgroup cols="2">
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
246 <thead>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
247 <row>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
248 <entry>Key</entry>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
249 <entry>Description</entry>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
250 </row>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
251 </thead>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
252 <tbody>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
253 <row>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
254 <entry>X</entry>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
255 <entry>Switch teletext display on/off</entry>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
256 </row>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
257 <row>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
258 <entry>C</entry>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
259 <entry>Cycle through teletext rendering modes (opaque, transparent, inverted opaque,
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
260 inverted transparent</entry>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
261 </row>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
262 <row>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
263 <entry>Left/Right</entry>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
264 <entry>Go to previous/next teletext page</entry>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
265 </row>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
266 <row>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
267 <entry>PageUp/PageDown</entry>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
268 <entry>Go to next/previous teletext subpage</entry>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
269 </row>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
270 <row>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
271 <entry>digits</entry>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
272 <entry>Enter teletext page number to jump to</entry>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
273 </row>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
274 </tbody>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
275 </tgroup>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
276 </informaltable>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
277 </sect2>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
278 </sect1>
90896a8ab7b7 Teletext documentation
voroshil
parents: 23516
diff changeset
279
17321
7f9fcf5245a0 Improve overall structure by adding a few top-level chapters so that
diego
parents: 17280
diff changeset
280 </chapter>