annotate DOCS/video.html @ 1731:07e2dfca67a3

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