Mercurial > mplayer.hg
annotate DOCS/video.html @ 1931:33a6314a43d9
added ffmp3
author | gabucino |
---|---|
date | Fri, 21 Sep 2001 22:33:46 +0000 |
parents | 5f0e4310dd4d |
children | 7fb1fb6f295f |
rev | line source |
---|---|
1612 | 1 <HTML> |
1704 | 2 <BODY BGCOLOR=white> |
3 | |
4 <FONT face="Verdana, Arial, Helvetica, sans-serif" size=2> | |
1612 | 5 |
1682 | 6 <P><B><A NAME=2.2.1>2.2.1. Video output devices</A></B></P> |
1612 | 7 |
1682 | 8 <TABLE BORDER=0> |
9 | |
10 <TD COLSPAN=4><P><B>General:</B></P></TD><TR> | |
1612 | 11 |
1682 | 12 <TD> </TD><TD VALIGN=top>x11</TD><TD> </TD><TD>X11 with optional SHM extension</TD><TR> |
13 <TD></TD><TD VALIGN=top>xv</TD><TD></TD><TD>X11 using overlays with the Xvideo extension (hardware YUV & scaling)</TD><TR> | |
14 <TD></TD><TD VALIGN=top>gl</TD><TD></TD><TD>OpenGL renderer, so far works only with: | |
15 <UL><LI>all cards with Utah-GLX | |
16 <LI>Matrox cards with X/DRI >=4.0.3 | |
17 <LI>Radeon with X/DRI CVS</UL></TD><TR> | |
18 <TD></TD><TD VALIGN=top>dga</TD><TD></TD><TD>X11 DGA extension</TD><TR> | |
19 <TD></TD><TD VALIGN=top>fbdev</TD><TD></TD><TD>Output to general framebuffers</TD><TR> | |
20 <TD></TD><TD VALIGN=top>svga</TD><TD></TD><TD>Output to SVGAlib</TD><TR> | |
21 <TD></TD><TD VALIGN=top>sdl</TD><TD></TD><TD> | |
22 <CODE>1.1.7:</CODE> supports software scaling<BR> | |
23 <CODE>1.1.8:</CODE> supports Xvideo (hardware scaling/fullscreen)<BR> | |
24 <CODE>1.2.0:</CODE> supports AAlib (-vo aa is very recommended, see below!)</TD><TR> | |
25 <TD></TD><TD VALIGN=top>ggi</TD><TD></TD><TD>similar to SDL</TD><TR> | |
26 <TD></TD><TD VALIGN=top>aa</TD><TD></TD><TD>textmode rendering with AAlib</TD><TR> | |
27 | |
28 <TD COLSPAN=4><P><B>Card specific:</B></P></TD><TR> | |
1612 | 29 |
1682 | 30 <TD> </TD><TD VALIGN=top>mga</TD><TD> </TD><TD>Matrox G200/G400 hardware YUV overlay via the mga_vid device</TD><TR> |
31 <TD></TD><TD VALIGN=top>xmga</TD><TD></TD><TD>Matrox G200/G400 overlay (mga_vid) in X11 window<BR> | |
32 (<I>Xv emulation on X 3.3.x!</I>)</TD><TR> | |
33 <TD></TD><TD VALIGN=top>syncfb</TD><TD></TD><TD>Matrox G400 YUV support on framebuffer (obsoleted, use mga/xmga)</TD><TR> | |
34 <TD></TD><TD VALIGN=top>3dfx</TD><TD></TD><TD>Voodoo2/3 hardware YUV (/dev/3dfx) support (not yet tested, maybe | |
35 broken)</TD><TR> | |
36 | |
37 <TD COLSPAN=4><P><B>Special:</B></P></TD><TR> | |
1612 | 38 |
1682 | 39 <TD> </TD><TD VALIGN=top>png</TD><TD> </TD><TD>PNG files output (use -z switch to set compression)</TD><TR> |
40 <TD></TD><TD VALIGN=top>pgm</TD><TD></TD><TD>PGM files output (for testing purposes or ffmpeg encoding)</TD><TR> | |
41 <TD></TD><TD VALIGN=top>md5</TD><TD></TD><TD>MD5sum output (for MPEG conformance tests)</TD><TR> | |
1898 | 42 <TD></TD><TD VALIGN=top>odivx</TD><TD></TD><TD>OpenDivX AVI File writer (use -br to set encoding bitrate) (<B>WITHOUT SOUND</B>!)</TD><TR> |
1682 | 43 <TD></TD><TD VALIGN=top>null</TD><TD></TD><TD>Null output (for speed tests/benchmarking)</TD><TR> |
44 </TABLE> | |
1612 | 45 |
1682 | 46 <P>NOTE: <I>check the following subsections for details and requirements!</I></P> |
1612 | 47 |
48 | |
1682 | 49 <P><B><A NAME=2.2.1.1>2.2.1.1. MTRR</A></B></P> |
1612 | 50 |
1682 | 51 <P>It is VERY recommended to set MTRR registers up properly, because they can |
52 give a big performance boost. First you have to find the base address. | |
53 You have 3 ways to find it:</P> | |
1612 | 54 |
1682 | 55 <P><UL> |
56 <LI>from X11 startup messages, for example: | |
57 <P><CODE>(--) SVGA: PCI: Matrox MGA G400 AGP rev 4, Memory @ 0xd8000000, 0xd4000000<BR> | |
58 (--) SVGA: Linear framebuffer at 0xD8000000</CODE></P> | |
59 <LI>from /proc/pci (use lspci -v command): | |
60 <P><TABLE> | |
61 <TD VALIGN=top><CODE>01:00.0</CODE></TD><TD><CODE>VGA compatible controller: Matrox Graphics, Inc.: Unknown device 0525</CODE></TD><TR> | |
62 <TD></TD><TD><CODE>Memory at d8000000 (32-bit, prefetchable)</CODE></TD><TR> | |
63 </TABLE></P></CODE> | |
64 <LI>from mga_vid kernel driver messages (use dmesg): | |
65 <P><CODE>mga_mem_base = d8000000</CODE></P> | |
66 </UL></P> | |
1612 | 67 |
1682 | 68 <P>Then let's find the memory size. This is very easy, just convert video ram |
69 size to hexadecimal, or use this table:</P> | |
1612 | 70 |
1682 | 71 <TABLE BORDER=0> |
72 <TD> </TD><TD>1 MB</TD><TD WIDTH=10%></TD><TD>0x100000</TD><TR> | |
73 <TD></TD><TD>2 MB</TD><TD></TD><TD>0x200000</TD><TR> | |
74 <TD></TD><TD>4 MB</TD><TD></TD><TD>0x400000</TD><TR> | |
75 <TD></TD><TD>8 MB</TD><TD></TD><TD>0x800000</TD><TR> | |
76 <TD></TD><TD>16 MB</TD><TD></TD><TD>0x1000000</TD><TR> | |
77 <TD></TD><TD>32 MB</TD><TD></TD><TD>0x2000000</TD><TR> | |
78 </TABLE> | |
1612 | 79 |
80 | |
1682 | 81 <P>You know base address and memory size, let's setup mtrr registers! |
82 For example, for the Matrox card above (base=0xd8000000) with 32MB | |
83 ram (size=0x2000000) just execute:</P> | |
1612 | 84 |
85 | |
1682 | 86 <P><CODE> echo "base=0xd8000000 size=0x2000000 type=write-combining" >| /proc/mtrr</CODE></P> |
1612 | 87 |
88 | |
1682 | 89 <P>Not all CPUs support MTRRs. For example older K6-2's [around 266Mhz, |
90 stepping 0] doesn't support MTRR, but stepping 12's do ('<CODE>cat /proc/cpuinfo</CODE>' | |
1686 | 91 to check it</CODE>').</P> |
1612 | 92 |
1682 | 93 <P><B><A NAME=2.2.1.2>2.2.1.2. Xv</A></B></P> |
1612 | 94 |
1682 | 95 <P>Under XFree86 4.0.2 or newer, you can use your card's hardware YUV routines |
96 using the XVideo extension. This is what the option '-vo xv' uses. | |
97 In order to make this work, be sure to check the following:</P> | |
98 <P><UL> | |
99 <LI>You have to use XFree86 4.0.2 or newer (former versions don't have XVideo) | |
100 <LI>Your card actually supports harware acceleration (modern cards do) | |
101 <LI>X loads the XVideo extension, it's something like this: | |
1612 | 102 |
1682 | 103 <P><CODE> (II) Loading extension XVideo</CODE></P> |
104 <P>in /var/log/XFree86.0.log</P> | |
1612 | 105 |
1682 | 106 <P>NOTE: this loads only the XFree86's extension. In a good install, this is |
107 always loaded, and doesn't mean that the _card's_ XVideo support is loaded!</P> | |
1612 | 108 |
1682 | 109 <LI>Your card has Xv support under Linux. To check, try 'xvinfo', it is the |
110 part of the XFree86 distribution. It should display a long text, similar | |
111 to this: | |
112 <PRE> | |
1612 | 113 X-Video Extension version 2.2 |
114 screen #0 | |
115 Adaptor #0: "Savage Streams Engine" | |
116 number of ports: 1 | |
117 port base: 43 | |
118 operations supported: PutImage | |
119 supported visuals: | |
120 depth 16, visualID 0x22 | |
121 depth 16, visualID 0x23 | |
122 number of attributes: 5 | |
123 (...) | |
124 Number of image formats: 7 | |
125 id: 0x32595559 (YUY2) | |
126 guid: 59555932-0000-0010-8000-00aa00389b71 | |
127 bits per pixel: 16 | |
128 number of planes: 1 | |
129 type: YUV (packed) | |
130 id: 0x32315659 (YV12) | |
131 guid: 59563132-0000-0010-8000-00aa00389b71 | |
132 bits per pixel: 12 | |
133 number of planes: 3 | |
134 type: YUV (planar) | |
135 (...etc...) | |
1682 | 136 </PRE> |
1612 | 137 |
1682 | 138 <P>It must support YUY2 packed, and YV12 planar pixel formats to be |
139 usable with <B>MPlayer</B>.</P> | |
1612 | 140 |
1682 | 141 <LI>And finally, check if <B>MPlayer</B> was compiled with 'xv' support. |
142 ./configure prints this. | |
1612 | 143 |
1682 | 144 </UL></P> |
145 | |
146 <P><B><A NAME=2.2.1.2.1>2.2.1.2.1. 3dfx cards</A></B></P> | |
1612 | 147 |
1682 | 148 <P>Older 3dfx drivers were known to have problems with XVideo acceleration, |
149 it didn't support either YUY2 or YV12, and so. Verify that you have | |
150 XFree86 version 4.1.0 or greater, it works ok. Alternatively, you can use | |
151 <A HREF="http://dri.sourceforge.net">DRI</A> cvs. | |
152 If you experience strange effects using -vo xv, try SDL (it has XVideo too) | |
153 and see if it helps. Check the <A HREF="#2.2.1.4">SDL section</A> for details.</P> | |
1612 | 154 |
155 | |
1682 | 156 <P><B><A NAME=2.2.1.2.2>2.2.1.2.2. S3 cards</A></B></P> |
157 | |
158 <P>S3 Savage3D's should work fine, but for Savage4, use XFree86 version 4.0.3 | |
159 or greater. As for S3 Virge.. sell it.</P> | |
160 | |
161 <P><B><A NAME=2.2.1.2.3>2.2.1.2.3. nVidia cards</A></B></P> | |
1612 | 162 |
1682 | 163 <P>nVidia isn't a very good choice under Linux.. You'll have to use the |
164 binary nVidia driver, available at nVidia's website. The standard X | |
165 driver doesn't support XVideo for these cards, due to nVidia's closed | |
166 sources/specifications.</P> | |
1612 | 167 |
1682 | 168 <P><UL><LI>Riva128 cards don't have XVideo support even with the nvidia driver :( |
169 Complain to NVidia.</UL></P> | |
1612 | 170 |
171 | |
1682 | 172 <P><B><A NAME=2.2.1.2.4>2.2.1.2.4. ATI cards</A></B></P> |
1612 | 173 |
1920 | 174 <P> |
175 <LI>The GATOS driver has VSYNC enabled by default. It means that decoding speed | |
1682 | 176 (!) is synced to the monitor's refresh rate. If playing seems to be slow, try |
1920 | 177 disabling VSYNC somehow, or set refresh rate to n*(fps of the movie) Hz.</LI> |
178 | |
179 <LI>Radeon VE - currently only XFree86 CVS has driver for this card, version | |
180 4.1.0 doesn't. No TV-out support.</LI> | |
181 </P> | |
1612 | 182 |
183 | |
1922
5f0e4310dd4d
NeoMagic stuff added (legyen egyszer gyereknap...)
gabucino
parents:
1920
diff
changeset
|
184 <P><B><A NAME=2.2.1.2.5>2.2.1.2.5. NeoMagic cards</A></B></P> |
5f0e4310dd4d
NeoMagic stuff added (legyen egyszer gyereknap...)
gabucino
parents:
1920
diff
changeset
|
185 |
5f0e4310dd4d
NeoMagic stuff added (legyen egyszer gyereknap...)
gabucino
parents:
1920
diff
changeset
|
186 <P> |
5f0e4310dd4d
NeoMagic stuff added (legyen egyszer gyereknap...)
gabucino
parents:
1920
diff
changeset
|
187 These cards can be found in many laptops. Under Linux, their peak is only DGA. |
5f0e4310dd4d
NeoMagic stuff added (legyen egyszer gyereknap...)
gabucino
parents:
1920
diff
changeset
|
188 Unfortunately, the DGA driver in X 4.1.0 doesn't work, you'll have to wait for |
5f0e4310dd4d
NeoMagic stuff added (legyen egyszer gyereknap...)
gabucino
parents:
1920
diff
changeset
|
189 4.2.0, or download a modified driver for 4.0.3 or 4.1.0 from here : |
5f0e4310dd4d
NeoMagic stuff added (legyen egyszer gyereknap...)
gabucino
parents:
1920
diff
changeset
|
190 <A HREF="http://www.mplayerhq.hu/MPlayer/incoming/NeoMagic-driver">http://www.mplayerhq.hu/MPlayer/incoming/NeoMagic-driver</A> |
5f0e4310dd4d
NeoMagic stuff added (legyen egyszer gyereknap...)
gabucino
parents:
1920
diff
changeset
|
191 (there is also the patch to the driver's source).<BR> |
5f0e4310dd4d
NeoMagic stuff added (legyen egyszer gyereknap...)
gabucino
parents:
1920
diff
changeset
|
192 Drivers provided by <A HREF="mailto:tomee@cpi.pl">Tomek Jarzynka</A>. |
5f0e4310dd4d
NeoMagic stuff added (legyen egyszer gyereknap...)
gabucino
parents:
1920
diff
changeset
|
193 </P> |
5f0e4310dd4d
NeoMagic stuff added (legyen egyszer gyereknap...)
gabucino
parents:
1920
diff
changeset
|
194 |
5f0e4310dd4d
NeoMagic stuff added (legyen egyszer gyereknap...)
gabucino
parents:
1920
diff
changeset
|
195 |
1682 | 196 <P><B><A NAME=2.2.1.3>2.2.1.3. DGA</A></B></P> |
1612 | 197 |
1682 | 198 <P><B><A NAME=2.2.1.3.1>2.2.1.3.1. Summary</A></B></P> |
1612 | 199 |
1682 | 200 <P>This document tries to explain in some words what DGA is in general and |
201 what the DGA video output driver for mplayer can do (and what it can't).</P> | |
1612 | 202 |
203 | |
1682 | 204 <P><B><A NAME=2.2.1.3.2>2.2.1.3.2. What is DGA</A></B></P> |
1612 | 205 |
1682 | 206 <P>DGA is short for Direct Graphics Access and is a means for a program to |
207 bypass the X-Server and directly modifying the framebuffer memory. | |
208 Technically spoken this happens by mapping the framebuffer memory into | |
209 the memory range of your process. This is allowed by the kernel only | |
210 if you have superuser privileges. You can get these either by logging in | |
211 as root or by setting the suid bit on the mplayer excecutable (NOT | |
212 recommended!).</P> | |
1612 | 213 |
1682 | 214 <P>There are two versions of DGA: DGA1 is used by XFree 3.x.x and DGA2 was |
215 introduced with XFree 4.0.1.</P> | |
1612 | 216 |
1682 | 217 <P>DGA1 provides only direct framebuffer access as described above. For |
218 switching the resolution of the video signal you have to rely on the | |
219 XVidMode extension.</P> | |
1612 | 220 |
1682 | 221 <P>DGA2 incorporates the features of XVidMode extension and also allows |
222 switching the depth of the display. So you may, although basically | |
223 running a 32 bit depth XServer, switch to a depth of 15 bits and vice | |
224 versa. </P> | |
1612 | 225 |
1682 | 226 <P>However DGA has some drawbacks. It seems it is somewhat dependent on the |
227 graphics chip you use and on the implementation of the XServer's video | |
228 driver that controls this chip. So it does not work on every system ...</P> | |
1612 | 229 |
230 | |
1682 | 231 <P><B><A NAME=2.2.1.3.3>2.2.1.3.3. Installing DGA support for MPlayer</A></B></P> |
232 | |
233 <P>First make sure X loads the DGA extension, see in /var/log/XFree86.0.log:</P> | |
234 | |
235 <P> <CODE>(II) Loading extension XFree86-DGA</CODE></P> | |
236 | |
237 <P>See, XFree86 4.0.x or greater is VERY RECOMMENDED! | |
238 <B>MPlayer</B>'s DGA driver is autodetected on ./configure, or you can force it | |
239 with --enable-dga.</P> | |
1612 | 240 |
1682 | 241 <P>If the driver couldn't switch to a smaller resolution, experiment with |
242 switches -vm (only with X 3.3.x), -fs, -bpp, -zoom to find a video mode that | |
243 the movie fits in. There is no converter right now.. :(</P> | |
1612 | 244 |
1682 | 245 <P>Become ROOT. DGA needs root access to be able to write directly video memory. |
246 If you want to run it as user, then install <B>MPlayer</B> SUID root:</P> | |
1612 | 247 |
1682 | 248 <P><CODE> |
249 <CODE>chown root /usr/local/bin/mplayer<BR> | |
1686 | 250 chmod 750 /usr/local/bin/mplayer<BR> |
251 chmod +s /usr/local/bin/mplayer</CODE></P> | |
1612 | 252 |
253 | |
1682 | 254 <P>Now it works as a simple user, too.</P> |
1612 | 255 |
256 | |
1682 | 257 <P><B>!!!! BUT STAY TUNED !!!!</B><BR> |
258 This is a <B>BIG</B> security risk! Never do this on a server or on a computer | |
259 can be accessed by more people than only you because they can gain root | |
260 privilegies through suid root mplayer.<BR> | |
261 <B>!!!! SO YOU HAVE BEEN WARNED ... !!!!</B></P> | |
262 | |
263 <P>Now use '-vo dga' option, and there you go! (hope so:) | |
264 You should also try if the '-vo sdl:dga' option works for you! It's much | |
265 faster!!!</P> | |
266 | |
267 <P><B><A NAME=2.2.1.3.4>2.2.1.3.4. Resolution switching</A></B></P> | |
268 | |
269 <P>The DGA driver allows for switching the resolution of the output signal. | |
270 This avoids the need for doing (slow) software scaling and at the same | |
271 time provides a fullscreen image. Ideally it would switch to the exact | |
272 resolution (except for honouring aspect ratio) of the video data, but the | |
1686 | 273 XServer only allows switching to resolutions predefined in |
1682 | 274 <CODE>/etc/X11/XF86Config</CODE> (<CODE>/etc/X11/XF86Config-4</CODE> for XFree 4.0.X respectively). |
275 Those are defined by so-called modelines and depend on the capabilites | |
276 of your video hardware. The XServer scans this config file on startup and | |
277 disables the modelines not suitable for your hardware. You can find | |
278 out which modes survive with the X11 log file. It can be found at: | |
279 <CODE>/var/log/XFree86.0.log</CODE>.</P> | |
280 <P>See appendix A for some sample modeline definitions.</P> | |
281 | |
282 <P><B><A NAME=2.2.1.3.5>2.2.1.3.5. DGA & MPlayer</A></B></P> | |
1612 | 283 |
1682 | 284 <P>DGA is used in two places with <B>MPlayer</B>: The SDL driver can be made to make |
285 use of it (-vo sdl:dga) and within the DGA driver (-vo dga). | |
286 The above said is true for both; in the following sections I'll explain | |
287 how the DGA driver for <B>MPlayer</B> works.</P> | |
1612 | 288 |
1682 | 289 <P><B><A NAME=2.2.1.3.6>2.2.1.3.6. Features of the DGA driver</A></B></P> |
290 | |
291 <P>The DGA driver is invoked by specifying -vo dga at the command line. | |
292 The default behaviour is to switch to a resolution matching the original | |
293 resolution of the video as close as possible. It deliberately ignores the | |
294 -vm and -fs switches (enabling of video mode switching and fullscreen) - | |
295 it always tries to cover as much area of your screen as possible by switching | |
296 the video mode, thus refraining to use a single additional cycle of your CPU | |
297 to scale the image. | |
298 If you don't like the mode it chooses you may force it to choose the mode | |
299 matching closest the resolution you specify by -x and -y. | |
300 By providing the -v option, the DGA driver will print, among a lot of other | |
301 things, a list of all resolutions supported by your current XF86-Config | |
302 file. | |
303 Having DGA2 you may also force it to use a certain depth by using the -bpp | |
304 option. Valid depths are 15, 16, 24 and 32. It depends on your hardware | |
305 whether these depths are natively supported or if a (possibly slow) | |
306 conversion has to be done.</P> | |
307 | |
308 <P>If you should be lucky enough to have enough offscreen memory left to | |
309 put a whole image there, the DGA driver will use doublebuffering, which | |
310 results in much smoother movie replaying. It will tell you whether double- | |
311 buffering is enabled or not.</P> | |
1612 | 312 |
1682 | 313 <P>Doublebuffering means that the next frame of your video is being drawn in |
314 some offscreen memory while the current frame is being displayed. When the | |
315 next frame is ready, the graphics chip is just told the location in memory | |
316 of the new frame and simply fetches the data to be displayed from there. | |
317 In the meantime the other buffer in memory will be filled again with new | |
318 video data.</P> | |
319 | |
320 Doublebuffering may be switched on by using the option -double and may be | |
321 disabled with -nodouble. Current default option is to disable | |
322 doublebuffering. When using the DGA driver, onscreen display (OSD) only | |
323 works with doublebuffering enabled. However, enabling doublebuffering may | |
324 result in a big speed penalty (on my K6-II+ 525 it used an additional 20% of | |
325 CPU time!) depending on the implementation of DGA for your hardware.</P> | |
326 | |
327 | |
328 <P><B><A NAME=2.2.1.3.7>2.2.1.3.7. Speed issues</A></B></P> | |
329 | |
330 <P>Generally spoken, DGA framebuffer access should be at least as fast as using | |
331 the X11 driver with the additional benefit of getting a fullscreen image. | |
332 The percentage speed values printed by mplayer have to be interpreted with | |
333 some care, as for example, with the X11 driver they do not include the time | |
334 used by the X-Server needed for the actual drawing. Hook a terminal to a | |
335 serial line of your box and start top to see what is really going on in your | |
336 box ...</P> | |
337 | |
338 <P>Generally spoken, the speedup done by using DGA against 'normal' use of X11 | |
339 highly depends on your graphics card and how well the X-Server module for it | |
340 is optimized.</P> | |
341 | |
342 <P>If you have a slow system, better use 15 or 16bit depth since they require | |
343 only half the memory bandwidth of a 32 bit display.</P> | |
1612 | 344 |
1682 | 345 <P>Using a depth of 24bit is even a good idea if your card natively just supports |
346 32 bit depth since it transfers 25% less data compared to the 32/32 mode.</P> | |
347 | |
348 <P>I've seen some avi files already be replayed on a Pentium MMX 266. AMD K6-2 | |
349 CPUs might work at 400 MHZ and above.</P> | |
1612 | 350 |
1682 | 351 <P><B><A NAME=2.2.1.3.8>2.2.1.3.8. Known bugs</A></B></P> |
352 | |
353 <P>Well, according to some developpers of XFree, DGA is quite a beast. They | |
354 tell you better not to use it. Its implementation is not always flawless | |
355 with every chipset driver for XFree out there.</P> | |
1612 | 356 |
1682 | 357 <P><UL> |
358 <LI>with XFree 4.0.3 and nv.o there is a bug resulting in strange colors | |
359 <LI>ATI driver requires to switch mode back more than once after finishing | |
360 using of DGA | |
361 <LI>some drivers simply fail to switch back to normal resolution (use | |
362 Ctrl-Alt-Keypad +, - to switch back manually) | |
363 <LI>some drivers simply display strange colors | |
364 <LI>some drivers lie about the amount of memory they map into the process's | |
365 address space, thus vo_dga won't use doublebuffering (SIS?) | |
366 <LI>some drivers seem to fail to report even a single valid mode. In this | |
367 case the DGA driver will crash telling you about a nonsense mode of | |
368 100000x100000 or the like ... | |
369 <LI>OSD only works with doublebuffering enabled | |
370 </UL></P> | |
371 | |
372 <P><B><A NAME=2.2.1.3.9>2.2.1.3.9. Future work</A></B></P> | |
373 | |
374 <P><UL><LI>use of the new X11 render interface for OSD | |
375 <LI>where is my TODO list ???? :-(((</UL></P> | |
1612 | 376 |
377 | |
1682 | 378 <P><B><A NAME=2.2.1.3.A>2.2.1.3.A. Some modelines</A></B></P> |
1612 | 379 |
1682 | 380 <PRE> |
1612 | 381 Section "Modes" |
382 Identifier "Modes[0]" | |
383 Modeline "800x600" 40 800 840 968 1056 600 601 605 628 | |
384 Modeline "712x600" 35.0 712 740 850 900 400 410 412 425 | |
385 Modeline "640x480" 25.175 640 664 760 800 480 491 493 525 | |
386 Modeline "400x300" 20 400 416 480 528 300 301 303 314 Doublescan | |
387 Modeline "352x288" 25.10 352 368 416 432 288 296 290 310 | |
388 Modeline "352x240" 15.750 352 368 416 432 240 244 246 262 Doublescan | |
389 Modeline "320x240" 12.588 320 336 384 400 240 245 246 262 Doublescan | |
390 EndSection | |
1682 | 391 </PRE> |
1612 | 392 |
1682 | 393 <P>These entries work fine with my Riva128 chip, using nv.o XServer driver |
394 module.</P> | |
1612 | 395 |
396 | |
1682 | 397 <P><B><A NAME=2.2.1.3.B>2.2.1.3.B. Bug Reports</A></B></P> |
1612 | 398 |
1682 | 399 <P>If you experience troubles with the DGA driver please feel free to file |
400 a bug report to me (e-mail address below). Please start mplayer with the | |
401 -v option and include all lines in the bug report that start with vo_dga:</P> | |
402 | |
403 <P>Please do also include the version of X11 you are using, the graphics card | |
404 and your CPU type. The X11 driver module (defined in XF86-Config) might | |
405 also help. Thanks!</P> | |
1612 | 406 |
1682 | 407 |
408 <P><I>Acki (acki@acki-netz.de, www.acki-netz.de)</I></P> | |
1612 | 409 |
410 | |
1682 | 411 <P><B><A NAME=2.2.1.4>2.2.1.4. SDL</A></B></P> |
1612 | 412 |
1682 | 413 <P>Here are some notes about SDL out in <B>MPlayer</B>.</P> |
1612 | 414 |
415 | |
416 | |
1682 | 417 <P><TABLE BORDER=0> |
418 <TD COLSPAN=4><P><B>There are several commandline switches for SDL:</B></P></TD><TR> | |
419 <TD> </TD><TD>-vo sdl:name</TD><TD> </TD><TD> | |
420 specifies sdl video driver to use (ie. aalib, dga, x11)</TD><TR> | |
421 <TD></TD><TD>-ao sdl:name</TD><TD></TD><TD>specifies sdl audio driver to use (ie. dsp, | |
422 esd, arts)</TD><TR> | |
423 <TD></TD><TD>-noxv</TD><TD></TD><TD>disables Xvideo hardware acceleration</TD><TR> | |
424 <TD></TD><TD>-forcexv</TD><TD></TD><TD>tries to force Xvideo acceleration</TD><TR> | |
1612 | 425 |
1682 | 426 <TD COLSPAN=4><P><B>SDL Keys:</B></P></TD><TR> |
1612 | 427 |
1682 | 428 <TD></TD><TD>F</TD><TD></TD><TD>toggles fullscreen/windowed mode</TD><TR> |
429 <TD></TD><TD>C</TD><TD></TD><TD>cycles available fullscreen modes</TD><TR> | |
430 <TD></TD><TD>W/S</TD><TD></TD><TD>mappings for * and / (mixer control)</TD><TR> | |
1612 | 431 |
1682 | 432 </TABLE></P> |
1612 | 433 |
1682 | 434 <P><B>KNOWN BUGS:</B></P> |
435 <P><UL><LI>Keys pressed under sdl:aalib console driver repeat forever. (use -vo aa !) | |
436 It's bug in SDL, I can't change it (tested with SDL 1.2.1). | |
437 </UL></P> | |
1612 | 438 |
1682 | 439 <P><B><A NAME=2.2.1.5>2.2.1.5. SVGAlib</A></B></P> |
440 | |
441 <P>If you don't have X, you can use the SVGAlib target! Be sure not to use the | |
442 -fs switch, since it toggles the usage of the software scaler, and it's | |
443 SLOOOW now, unless you have a real fast CPU (and/or MTRR?). :(</P> | |
1612 | 444 |
1682 | 445 <P>Of course you'll have to install svgalib and its development package in |
446 order for <B>MPlayer</B> build its SVGAlib driver (autodetected, but can be | |
447 forced), and don't forget to edit /etc/vga/libvga.config to suit your | |
448 card & monitor.</P> | |
1612 | 449 |
1682 | 450 <P><B><A NAME=2.2.1.6>2.2.1.6. Framebuffer output (FBdev)</A></B></P> |
451 | |
452 <P>Whether to build the FBdev target is autodetected during ./configure . | |
453 Read the framebuffer documentation in the kernel sources | |
454 (Documentation/fb/*) for info on how to enable it, etc.. !</P> | |
1612 | 455 |
1682 | 456 <P>If your card doesn't support VBE 2.0 standard (older ISA/PCI |
457 cards, such as S3 Trio64), only VBE 1.2 (or older?) : | |
458 Well, VESAfb is still available, but you'll have to load SciTech Display | |
459 Doctor (formerly UniVBE) before booting Linux. Use a DOS boot disk or | |
460 whatever. And don't forget to register your UniVBE ;))</P> | |
1612 | 461 |
1682 | 462 <P>The FBdev output takes some additional parameters above the others:</P> |
1612 | 463 |
1682 | 464 <P><TABLE BORDER=0> |
465 <TD> </TD><TD>-fb</TD><TD> </TD><TD> | |
466 specify the framebuffer device to use (/dev/fd0)</TD><TR> | |
467 <TD></TD><TD>-fbmode</TD><TD></TD><TD>mode name to use (according to /etc/fb.modes)</TD><TR> | |
468 <TD></TD><TD>-fbmodeconfig</TD><TD></TD><TD> config file of modes (default /etc/fb.modes)</TD><TR> | |
469 <TD></TD><TD>-monitor_hfreq</TD><TD></TD><TD ROWSPAN=3>IMPORTANT values, see example.conf</TD><TR> | |
470 <TD></TD><TD>-monitor_vfreq</TD><TD></TD><TR> | |
471 <TD></TD><TD>-monitor_dotclock</TD><TD></TD><TR> | |
472 </TABLE></P> | |
1612 | 473 |
1682 | 474 <P>If you want to change to a specific mode, then use</P> |
1612 | 475 |
1682 | 476 <P><CODE> mplayer -vm -fbmode (NameOfMode) filename</CODE></P> |
1612 | 477 |
1682 | 478 <P><UL><LI><B>-vm</B> alone will choose the most suitable mode from /etc/fb.modes . Can be |
479 used together with -x and -y options too. The -flip option is supported only | |
480 if the movie's pixel format matches the video mode's pixel format. | |
481 Pay attention to the bpp value, fbdev driver tries to use the current, | |
482 or if you specify the -bpp option, then that. | |
483 <LI><B>-zoom</B> option isn't supported (software scaling is slow). -fs option | |
484 isn't supported. You can't use 8bpp (or less) modes.</UL></P> | |
1612 | 485 |
1682 | 486 <P>NOTE: FBdev video mode changing _does not work_ with the VESA framebuffer, |
487 and don't ask for it, since it's not an <B>MPlayer</B> limitation.</P> | |
1612 | 488 |
1682 | 489 <P><B><A NAME=2.2.1.7>2.2.1.7. Matrox framebuffer (mga_vid)</A></B></P> |
1612 | 490 |
1682 | 491 <P>This section is about the Matrox G200/G400/G450 BES (Back-End Scaler) |
492 support, the mga_vid kernel driver. It's active developed by me (A'rpi), and | |
493 it has hardware VSYNC support with triple buffering. It works on both | |
494 framebuffer console and under X.</P> | |
495 | |
496 <P>To use it, you first have to compile mga_vid.o:</P> | |
1612 | 497 |
1682 | 498 <P><CODE> cd drivers<BR> |
499 make</CODE></P> | |
1612 | 500 |
1682 | 501 <P>Then create /dev/mga_vid device:</P> |
1612 | 502 |
1682 | 503 <P><CODE> mknod /dev/mga_vid c 178 0</CODE></P> |
1612 | 504 |
1682 | 505 <P>and load the driver with</P> |
506 | |
507 <P><CODE> insmod mga_vid.o</CODE></P> | |
1612 | 508 |
1682 | 509 <P>You should verify the memory size detection using the 'dmesg' command. If |
510 it's bad, use the mga_ram_size option (rmmod mga_vid first), specify card's | |
511 memory size in MB:</P> | |
1612 | 512 |
1682 | 513 <P><CODE> insmod mga_vid.o mga_ram_size=16</CODE></P> |
1612 | 514 |
1682 | 515 <P>To make it load/unload automatically when needed, insert the following line |
516 at the end of /etc/modules.conf:</P> | |
1612 | 517 |
1682 | 518 <P><CODE> alias char-major-178 mga_vid</CODE></P> |
1612 | 519 |
1682 | 520 <P>Then run</P> |
1612 | 521 |
1682 | 522 <P><CODE> depmod -a</CODE></P> |
1612 | 523 |
1682 | 524 <P>Now you have to (re)compile <B>MPlayer</B>, ./configure will detect /dev/mga_vid |
525 and build the 'mga' driver. Using it from <B>MPlayer</B> goes by '-vo mga' if | |
526 you have matroxfb console, or '-vo xmga' under XFree86 3.x.x or 4.x.x.</P> | |
527 | |
528 <P>Note: '-vo xmga' works under XFree86 4.x.x, but it conflicts with the Xv | |
529 driver, so avoid using both. If you messed up Xv with mga, try running | |
530 <B>MPlayer</B> with '-vo mga' . It should fix Xv.</P> | |
1612 | 531 |
532 | |
1682 | 533 <P><B><A NAME=2.2.1.8>2.2.1.8. SiS 6326 framebuffer (sis_vid)</A></B></P> |
534 | |
535 <P>SiS 6326 YUV Framebuffer driver -> sis_vid kernel driver</P> | |
1612 | 536 |
1682 | 537 <P>Its interface should be compatible with the mga_vid, but the driver was not |
538 updated after the mga_vid changes, so it's outdated now. Volunteers | |
539 needed to test it and bring the code up-to-date.</P> | |
1612 | 540 |
1682 | 541 <P><B><A NAME=2.2.1.9>2.2.1.9. 3dfx YUV support</A></B></P> |
1612 | 542 |
1682 | 543 <P>3dfx has native YUV+scaler support, using /dev/3dfx (tdfx.o driver?) |
544 The /dev/3dfx kernel driver exists only for 2.2.x kernels, for use with | |
545 Glide 2.x Linux ports. It's not tested with <B>MPlayer</B>, and so no more | |
546 supported. Volunteers needed to test it and bring the code up-to-date.</P> | |
1612 | 547 |
1682 | 548 <P><B><A NAME=2.2.1.10>2.2.1.10. OpenGL output</A></B></P> |
1612 | 549 |
1682 | 550 <P><B>MPlayer</B> support displaying movies using OpenGL. Unfortunately, not all |
551 drivers support this ability. For example the Utah-GLX drivers | |
552 (for XFree86 3.3.6) have it, with all cards. | |
553 See <A HREF="http://utah-glx.sourceforge.net">http://utah-glx.sourceforge.net</A> | |
554 for details about how to install it.</P> | |
1612 | 555 |
1682 | 556 <P>XFree86(DRI) >= 4.0.3 supports it only with Matrox, and Radeon cards. |
557 See <A HREF="http://dri.sourceforge.net">http://dri.sourceforge.net</A> for download, | |
558 and installation instructions.</P> | |
1612 | 559 |
1682 | 560 <P><B><A NAME=2.2.1.11>2.2.1.11. AAlib - text mode displaying</B></P> |
1612 | 561 |
1682 | 562 <P><B>AAlib</B> is a library for displaying graphics in text mode, using powerful |
563 ASCII renderer. There are LOTS of programs already supporting it, like Doom, | |
564 Quake, etc. MPlayer contains a very usable driver for it. | |
565 If ./configure detects aalib installed, the aalib libvo driver will be built.</P> | |
1612 | 566 |
1682 | 567 <P><TABLE BORDER=0> |
568 <TD COLSPAN=4><P><B>You can use some keys in the AA Window to change rendering options:</B></P></TD><TR> | |
569 <TD> </TD><TD>1</TD><TD> </TD><TD>decrease contrast</TD><TR> | |
570 <TD></TD><TD>2</TD><TD></TD><TD>increase contrast</TD><TR> | |
571 <TD></TD><TD>3</TD><TD></TD><TD>decrease brightness</TD><TR> | |
572 <TD></TD><TD>4</TD><TD></TD><TD>increase brightness</TD><TR> | |
573 <TD></TD><TD>5</TD><TD></TD><TD>switch fast rendering on/off</TD><TR> | |
574 <TD></TD><TD>6</TD><TD></TD><TD>set dithering mode (none, error distribution, floyd steinberg)</TD><TR> | |
575 <TD></TD><TD>7</TD><TD></TD><TD>invert image</TD><TR> | |
576 <TD></TD><TD>a</TD><TD></TD><TD>toggles between aa and mplayer control)</TD><TR> | |
577 | |
578 <TD COLSPAN=4><P><B>The following command line options can be used:</B></P></TD><TR> | |
1612 | 579 |
1682 | 580 <TD></TD><TD>-aaosdcolor=V</TD><TD></TD><TD>change osd color</TD><TR> |
581 <TD></TD><TD>-aasubcolor=V</TD><TD></TD><TD>change subtitle color</TD><TR> | |
582 <TD COLSPAN=3></TD><TD><P><I>where V can be: (0/normal, 1/dark, 2/bold, 3/boldfont, 4/reverse, 5/special)</P></TD><TR> | |
1612 | 583 |
1682 | 584 <TD COLSPAN=4><P><B>AAlib itselves provides a large sum of options. |
585 Here are some important:</P></B></TD><TR> | |
586 | |
587 <TD></TD><TD>-aadriver</TD><TD></TD><TD>set recommended aa driver (X11, curses, linux)</TD><TR> | |
588 <TD></TD><TD>-aaextended</TD><TD></TD><TD>use all 256 characters</TD><TR> | |
589 <TD></TD><TD>-aaeight</TD><TD></TD><TD>use eight bit ascii</TD><TR> | |
590 <TD></TD><TD>-aahelp</TD><TD></TD><TD>prints out all aalib options</TD><TR> | |
591 </TABLE></P> | |
592 | |
593 <P>NOTE: the rendering is very CPU intensive, especially when using AA-on-X | |
594 (using aalib on X), and it's least CPU intensive on standard, | |
595 non-framebuffer console. Use SVGATextMode to set up a big textmode, | |
596 then enjoy! (secondary head Hercules cards rock :)) (anyone can enhance | |
597 bdev to do conversion/dithering to hgafb? Would be neat :)</P> | |
1612 | 598 |
1682 | 599 <P>Use the -framedrop option if your comp isn't fast enough to render all frames!</P> |
1612 | 600 |
1682 | 601 <P>Playing on terminal you'll get better speed and quality using the linux driver, not |
602 curses (-aadriver linux). But therefore you need write access on /dev/vcsa<terminal>! | |
603 That isn't autodetected by aalib, bu vo_aa tries to find the best mode. | |
1731 | 604 See <A HREF="http://aa-project.sourceforge.net/tune/">http://aa-project.sourceforge.net/tune/</A> for further tuning issues.</P> |
1612 | 605 |
1682 | 606 <P><B><A NAME=2.2.1.A>2.2.1.A. TV-out support</A></B></P> |
1612 | 607 |
1682 | 608 <P><B><A NAME=2.2.1.A.1>2.2.1.A.1. Matrox cards</A></B></P> |
1612 | 609 |
1682 | 610 <P><I> What I'd love to see in mplayer is the the same feature that I see in my |
611 windows box. When I start a movie in windows (in a window or in full screen) | |
612 the movie is also redirected to the tv-out and I can also see it full screen | |
613 on my tv. I love this feature and was wondering how hard it would be to add | |
614 such a feature to mplayer.</I></P> | |
1612 | 615 |
1682 | 616 <P>It's a driver limitation. BES (Back-End Scaler, it's the overlay generator |
617 and YUV scaling engine of G200/G400/G450 cards) works only with CRTC1. | |
618 Normally, CRTC1 (textmode, every bpp gfx and BES) is routed to HEAD1, | |
619 and CRTC2 (only 16/32bpp gfx) is routed to HEAD2 (TV-out).</P> | |
1612 | 620 |
1682 | 621 <P>Under linux, you have two choices to get TV-out working:</P> |
1612 | 622 |
1682 | 623 <P><UL> |
624 <LI>Using X 4.0.x + the HAL driver from matrox, so you'll get dual-head | |
625 support, and you'll be able to redirect second output to the TV. | |
626 Unfortunately it has Macrovision encryption enabled, so it will | |
627 only work on directly-connected TV, no through VCR. | |
628 Other problem is that Xv doesn't work on the second head. | |
629 (I don't know how Windows solve it, maybe it swaps the CRTCs between | |
630 the heads, or just uses YUV framebuffer of second DAC with some trick) | |
631 <LI>Using matroxfb with dual-head support enabled (2.4.x kernels). | |
632 You'll be able to get a framebuffer console (using CRTC2, so it's | |
633 slow), and TV-out (using CRTC1, with BES support). | |
634 You have to forget X while using this kind of TV-out! :( | |
635 </UL></P> | |
1612 | 636 |
1682 | 637 <P>Follow these instructions:</P> |
1612 | 638 |
1682 | 639 <P><UL> |
640 <LI>Compile all the matrox-related things to modules in the kernel. | |
641 (you MUST compile them to modules, at least I couldn't get them | |
642 working built-in yet) | |
643 [reboot to new kernel & install modules, but don't load them yet!] | |
644 <P><CODE> | |
645 cd TVout<BR> | |
646 ./compile.sh</CODE></P> | |
647 <LI>Run the 'modules' script from the TV-out directory of mplayer. | |
648 It will switch your console to framebuffer. | |
649 Change to tty1 (ALT+F1)! | |
650 Now run the script 'independent', it will set up your tty's: | |
651 <P>tty 1,2: fb console, CRTC2, head 1 (monitor)<BR> | |
652 tty 3,4,5...: framebuffer+BES, CRTC1, head 2 (TV-out)</P> | |
653 You should run the scripts TV-* and Mon-* to set up resolutions: | |
654 <P>change to tty1 (ALT+F1), and run Mon-* (one of them)<BR> | |
655 change to tty3 (ALT+F3) and then back to tty1 (ALT+F1)</P> | |
656 (this change will select tty3 on /dev/fb1 - tricky)<BR> | |
657 <P>run TV-* (one of them)</P> | |
658 (now you'll get a console on your PAL TV - don't know about NTSC) | |
659 <P>Now if you start mplayer (on tty1), the picture will show up on | |
660 the tty3, so you'll see it on your TV or second monitor.</P> | |
661 </UL></P> | |
1612 | 662 |
1682 | 663 <P>Yes, it is a bit 'hack' now. But I'm waiting for the marvel |
664 project to be finished, it will provide real TV-out drivers, I hope.</P> | |
1612 | 665 |
1682 | 666 <P>My current problem is that BES is working only with CRTC1. So picture |
667 will always shown up on head routed to CRTC1 (normaly the monitor), | |
668 so i have to swap CRTC's, but this way your console will framebuffer | |
669 (CRTC2 can't do text-mode) and a bit slow (no acceleration). :(</P> | |
1612 | 670 |
1682 | 671 <P><I>Anyway i also just get monochrome output on the tv ...</I> |
672 Maybe you have NTSC TV? Or just didn't run one of TV-* scripts.</P> | |
1612 | 673 |
674 </BODY> | |
675 </HTML> |