Mercurial > mplayer.hg
annotate DOCS/xml/en/tvinput.xml @ 15130:ba68f417b416
Typo
author | gpoirier |
---|---|
date | Mon, 11 Apr 2005 21:40:05 +0000 |
parents | 5897d202e4b0 |
children | 04d7da697677 |
rev | line source |
---|---|
9675 | 1 <?xml version="1.0" encoding="iso-8859-1"?> |
10913
49b1a67e7381
Add revision keyword to english xml files, to ease translation synchronization
lumag
parents:
9948
diff
changeset
|
2 <!-- $Revision$ --> |
9675 | 3 <sect1 id="tv-input" xreflabel="TV input"> |
4 <title>TV input</title> | |
5 | |
6 <para> | |
7 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
|
8 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
|
9 of TV options and keyboard controls. |
9675 | 10 </para> |
11 | |
12 | |
13 <sect2 id="tv-compilation"> | |
14 <title>Compilation</title> | |
15 | |
16 <procedure> | |
17 <step><para> | |
18 First, you have to recompile. <filename>./configure</filename> will | |
19 autodetect kernel headers of v4l stuff and the existence of | |
20 <filename>/dev/video*</filename> entries. If they exist, TV support will | |
21 be built (see the output of <filename>./configure</filename>). | |
22 </para></step> | |
23 <step><para> | |
24 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
|
25 example <application>XawTV</application>. |
9675 | 26 </para></step> |
27 </procedure> | |
28 </sect2> | |
29 | |
30 <sect2 id="tv-tips"> | |
31 <title>Usage tips</title> | |
32 <para> | |
33 The full listing of the options is available on the manual page. | |
34 Here are just a few tips: | |
35 </para> | |
36 <itemizedlist> | |
37 <listitem> | |
38 <para> | |
39 Use the <option>channels</option> option. An example: | |
9948 | 40 <screen>-tv channels=26-MTV1,23-TV2</screen> |
9675 | 41 Explanation: using this option, only the 26 and 23 channels will be usable, |
42 and there will be a nice OSD text upon channel switching, displaying the | |
43 channel's name. Spaces in the channel name must be replaced by the | |
44 "_" character. | |
45 </para> | |
46 </listitem> | |
47 | |
48 <listitem> | |
49 <para> | |
50 Choose some sane image dimensions. The dimensions of the resulting image should | |
51 be divisible by 16. | |
52 </para> | |
53 </listitem> | |
54 | |
55 <listitem> | |
56 <para> | |
57 If you capture the video with the vertical resolution higher than half of | |
58 the full resolution (i.e. 288 for PAL or 240 for NTSC), make sure you turned | |
59 deinterlacing on. Otherwise you'll get a movie which is distorted during | |
60 fast-motion scenes and the bitrate controller will be probably even unable | |
61 to retain the specified bitrate as the interlacing artifacts produce high | |
62 amount of detail and thus consume lot of bandwidth. You can enable | |
9677 | 63 deinterlacing with <option>-vf pp=DEINT_TYPE</option>. Usually |
9675 | 64 <option>pp=lb</option> does a good job, but it can be matter of personal |
65 preference. See other deinterlacing algorithms in the manual and give it a try. | |
66 </para> | |
67 </listitem> | |
68 | |
69 <listitem> | |
70 <para> | |
71 Crop out the dead space. When you capture the video, the areas at the edges | |
72 are usually black or contain some noise. These again consume lots of | |
73 unnecessary bandwidth. More precisely it's not the black areas themselves | |
74 but the sharp transitions between the black and the brighter video image | |
75 which do but that's not important for now. Before you start capturing, | |
76 adjust the arguments of the <option>crop</option> option so that all the | |
77 crap at the margins is cropped out. Again, don't forget to keep the resulting | |
78 dimensions sane. | |
79 </para> | |
80 </listitem> | |
81 | |
82 <listitem> | |
83 <para> | |
84 Watch out for CPU load. It shouldn't cross the 90% boundary for most of the | |
11540 | 85 time. If you have a large capture buffer, <application>MEncoder</application> |
86 can survive an overload for few seconds but nothing more. It's better to | |
87 turn off the 3D OpenGL screensavers and similar stuff. | |
9675 | 88 </para> |
89 </listitem> | |
90 | |
91 <listitem> | |
92 <para> | |
93 Don't mess with the system clock. <application>MEncoder</application> uses the | |
94 system clock for doing A/V sync. If you adjust the system clock (especially | |
11540 | 95 backwards in time), <application>MEncoder</application> gets confused and you |
96 will lose frames. This is an important issue if you are hooked to a network | |
97 and run some time synchronization software like NTP. You have to turn NTP | |
98 off during the capture process if you want to capture reliably. | |
9675 | 99 </para> |
100 </listitem> | |
101 | |
102 <listitem> | |
103 <para> | |
104 Don't change the <option>outfmt</option> unless you know what you are doing | |
105 or your card/driver really doesn't support the default (YV12 colorspace). | |
106 In the older versions of <application>MPlayer</application>/ | |
107 <application>MEncoder</application> it was necessary to specify the output | |
108 format. This issue should be fixed in the current releases and <option>outfmt</option> | |
109 isn't required anymore, and the default suits the most purposes. For example, | |
11822
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11713
diff
changeset
|
110 if you are capturing into DivX using |
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11713
diff
changeset
|
111 <systemitem class="library">libavcodec</systemitem> and specify |
9675 | 112 <option>outfmt=RGB24</option> in order to increase the quality of the captured |
113 images, the captured image will be actually later converted back into YV12 so | |
114 the only thing you achieve is a massive waste of CPU power. | |
115 </para> | |
116 </listitem> | |
117 | |
118 <listitem> | |
119 <para> | |
120 To specify the I420 colorspace (<option>outfmt=i420</option>), you have to add an | |
121 option <option>-vc rawi420</option> due to a fourcc conflict with an Intel Indeo | |
122 video codec. | |
123 </para> | |
124 </listitem> | |
125 | |
126 <listitem> | |
127 <para> | |
128 There are several ways of capturing audio. You can grab the sound either using | |
13532 | 129 your sound card via an external cable connection between video card and line-in, |
9675 | 130 or using the built-in ADC in the bt878 chip. In the latter case, you have to |
131 load the <emphasis role="bold">btaudio</emphasis> driver. Read the | |
132 <filename>linux/Documentation/sound/btaudio</filename> file (in the kernel | |
12578 | 133 tree, not <application>MPlayer</application>'s) for some instructions on using |
11540 | 134 this driver. |
9675 | 135 </para> |
136 </listitem> | |
137 | |
138 <listitem> | |
139 <para> | |
140 If <application>MEncoder</application> cannot open the audio device, make | |
141 sure that it is really available. There can be some trouble with the sound | |
13532 | 142 servers like arts (KDE) or esd (GNOME). If you have a full duplex sound card |
9675 | 143 (almost any decent card supports it today), and you are using KDE, try to |
144 check the "full duplex" option in the sound server preference menu. | |
145 </para> | |
146 </listitem> | |
147 </itemizedlist> | |
148 </sect2> | |
149 | |
150 | |
151 <sect2 id="tv-examples"> | |
152 <title>Examples</title> | |
153 | |
154 <informalexample> | |
155 <para> | |
156 Dummy output, to AAlib :) | |
157 <screen> | |
9948 | 158 mplayer -tv driver=dummy:width=640:height=480 -vo aa tv://<!-- |
9675 | 159 --></screen> |
160 </para> | |
161 </informalexample> | |
162 | |
163 <informalexample> | |
164 <para> | |
165 Input from standard V4L: | |
166 <screen> | |
9948 | 167 mplayer -tv driver=v4l:width=640:height=480:outfmt=i420 -vc rawi420 -vo xv tv://<!-- |
9675 | 168 --></screen> |
169 </para> | |
170 </informalexample> | |
171 | |
172 <informalexample> | |
173 <para> | |
11540 | 174 A more sophisticated example. This makes <application>MEncoder</application> |
175 capture the full PAL image, crop the margins, and deinterlace the picture | |
176 using a linear blend algorithm. Audio is compressed with a constant bitrate | |
177 of 64kbps, using LAME codec. This setup is suitable for capturing movies. | |
9675 | 178 <screen> |
9948 | 179 mencoder -tv driver=v4l:width=768:height=576 \ |
9675 | 180 -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=900 \ |
181 -oac mp3lame -lameopts cbr:br=64 \ | |
11713 | 182 -vf crop=720:544:24:16,pp=lb -o <replaceable>output.avi</replaceable> tv:// |
9675 | 183 </screen> |
184 </para> | |
185 </informalexample> | |
186 | |
187 <informalexample> | |
188 <para> | |
189 This will additionally rescale the image to 384x288 and compresses the | |
190 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
|
191 looses the quantizer and allows the video compressor to actually reach so |
9675 | 192 low bitrate even at the expense of the quality. This can be used for |
193 capturing long TV series, where the video quality isn't so important. | |
194 <screen> | |
9948 | 195 mencoder -tv driver=v4l:width=768:height=576 \ |
9675 | 196 -ovc lavc -lavcopts vcodec=mpeg4:vbitrate=350:vhq:vqmax=31:keyint=300 \ |
197 -oac mp3lame -lameopts cbr:br=48 \ | |
14978 | 198 -vf crop=720:540:24:18,pp=lb,scale=384:288 -sws 1 -o <replaceable>output.avi</replaceable> tv:// |
9675 | 199 </screen> |
200 It's also possible to specify smaller image dimensions in the <option>-tv</option> | |
201 option and omit the software scaling but this approach uses the maximum available | |
202 information and is a little more resistant to noise. The bt8x8 chips can do the | |
203 pixel averaging only in the horizontal direction due to a hardware limitation. | |
204 </para> | |
205 </informalexample> | |
206 </sect2> | |
207 </sect1> |