mplayer.hg: DOCS/video.html annotate

annotate DOCS/video.html @ 8334:0c9a596abe39

found in an AVI file and reported working by Damian Gatabria

author	rfelker
date	Tue, 03 Dec 2002 02:02:58 +0000
parents	8368a516019e
children	a986112926f4

rev	line source
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	2 <HTML>
4982 6cb9d9a1716d HTML: different font handling - idea from new hp dezign gabucino parents: 4920 diff changeset	3
6cb9d9a1716d HTML: different font handling - idea from new hp dezign gabucino parents: 4920 diff changeset	4 <HEAD>
6882 f3f87f6bf5cf Added a uniform title: something - MPlayer - The Movie Player for Linux. diego parents: 6732 diff changeset	5 <TITLE>Video - MPlayer - The Movie Player for Linux</TITLE>
6391 4e5c236ade69 small updates gabucino parents: 6309 diff changeset	6 <LINK REL="stylesheet" TYPE="text/css" HREF="default.css">
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	7 <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
4982 6cb9d9a1716d HTML: different font handling - idea from new hp dezign gabucino parents: 4920 diff changeset	8 </HEAD>
6cb9d9a1716d HTML: different font handling - idea from new hp dezign gabucino parents: 4920 diff changeset	9
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	10 <BODY>
1704 a2e1432f7ac3 Arial font gabucino parents: 1686 diff changeset	11
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	12
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	13 <H3><A NAME="video">2.3.1 Video output devices</A></H3>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	14
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	15
7699 5d4b0446a557 Cosmetics: Converted 2 spaces to one in section titles, changed some ugly diego parents: 7651 diff changeset	16 <H4><A NAME="mtrr">2.3.1.1 Setting up MTRR</A></H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	17
1946 7fb1fb6f295f * empty log message * gabucino parents: 1922 diff changeset	18 <P>It is VERY recommended to check if the MTRR registers are set up properly,
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	19 because they can give a big performance boost.</P>
1946 7fb1fb6f295f * empty log message * gabucino parents: 1922 diff changeset	20
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	21 <P>Do a '<CODE>cat /proc/mtrr</CODE>':</P>
1946 7fb1fb6f295f * empty log message * gabucino parents: 1922 diff changeset	22
7fb1fb6f295f * empty log message * gabucino parents: 1922 diff changeset	23 <P><CODE>
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	24 --($:~)-- cat /proc/mtrr<BR>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	25 reg00: base=0xe4000000 (3648MB), size= 16MB: write-combining, count=9<BR>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	26 reg01: base=0xd8000000 (3456MB), size= 128MB: write-combining, count=1</CODE></P>
1946 7fb1fb6f295f * empty log message * gabucino parents: 1922 diff changeset	27
6599 f20184a10258 1001 typos as found by ispell. diego parents: 6583 diff changeset	28 <P>It's right, shows my Matrox G400 with 16MB memory. I did this from
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	29 XFree 4.x.x , which sets up MTRR registers automatically.</P>
1946 7fb1fb6f295f * empty log message * gabucino parents: 1922 diff changeset	30
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	31 <P>If nothing worked, you have to do it manually. First, you have to find the
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	32 base address. You have 3 ways to find it:</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	33
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	34 <UL>
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	35 <LI>from X11 startup messages, for example:
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	36 <P><CODE>(--) SVGA: PCI: Matrox MGA G400 AGP rev 4, Memory @ 0xd8000000, 0xd4000000<BR>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	37 (--) SVGA: Linear framebuffer at 0xD8000000</CODE></P></LI>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	38 <LI>from /proc/pci (use lspci -v command):
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	39 <P>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	40 <CODE>01:00.0 VGA compatible controller: Matrox Graphics, Inc.: Unknown device 0525</CODE>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	41 <CODE>Memory at d8000000 (32-bit, prefetchable)</CODE>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	42 </P></LI>
7138 8ab4d11353ae Fixed some small HTML errors. diego parents: 7099 diff changeset	43 <LI>from mga_vid kernel driver messages (use <CODE>dmesg</CODE>):
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	44 <P><CODE>mga_mem_base = d8000000</CODE></P></LI>
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	45 </UL>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	46
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	47 <P>Then let's find the memory size. This is very easy, just convert video ram
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	48 size to hexadecimal, or use this table:</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	49
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	50 <TABLE BORDER=0>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	51 <TR><TD>  </TD><TD>1 MB</TD><TD WIDTH="10%"></TD><TD>0x100000</TD></TR>
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	52 <TR><TD></TD><TD>2 MB</TD><TD></TD><TD>0x200000</TD></TR>
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	53 <TR><TD></TD><TD>4 MB</TD><TD></TD><TD>0x400000</TD></TR>
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	54 <TR><TD></TD><TD>8 MB</TD><TD></TD><TD>0x800000</TD></TR>
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	55 <TR><TD></TD><TD>16 MB</TD><TD></TD><TD>0x1000000</TD></TR>
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	56 <TR><TD></TD><TD>32 MB</TD><TD></TD><TD>0x2000000</TD></TR>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	57 </TABLE>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	58
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	59
6599 f20184a10258 1001 typos as found by ispell. diego parents: 6583 diff changeset	60 <P>You know base address and memory size, let's setup MTRR registers!
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	61 For example, for the Matrox card above (base=0xd8000000) with 32MB
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	62 ram (size=0x2000000) just execute:</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	63
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	64
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	65 <P><CODE>  echo "base=0xd8000000 size=0x2000000 type=write-combining" >\| /proc/mtrr</CODE></P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	66
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	67
6599 f20184a10258 1001 typos as found by ispell. diego parents: 6583 diff changeset	68 <P>Not all CPUs support MTRRs. For example older K6-2's [around 266MHz,
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	69 stepping 0] doesn't support MTRR, but stepping 12's do ('<CODE>cat
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	70 /proc/cpuinfo</CODE>' to check it').</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	71
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	72 <H4><A NAME="normal">2.3.1.2 Video outputs for traditional video cards</A></H4>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	73
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	74 <H4><A NAME="xv">2.3.1.2.1 Xv</A></H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	75
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	76 <P>Under XFree86 4.0.2 or newer, you can use your card's hardware YUV routines
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	77 using the XVideo extension. This is what the option '-vo xv' uses. Also,
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	78 this is driver supports adjusting brightness/contrast/hue/etc (unless you use
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	79 the old, slow DirectShow DivX codec, which supports it everywhere), see the
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	80 man page.</P>
4498 554af641717d -vo xv does video equalizing gabucino parents: 4496 diff changeset	81
554af641717d -vo xv does video equalizing gabucino parents: 4496 diff changeset	82 <P>In order to make this work, be sure to check the following:</P>
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	83
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	84 <UL>
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	85 <LI>You have to use XFree86 4.0.2 or newer (former versions don't have
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	86 XVideo)</LI>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	87 <LI>Your card actually supports hardware acceleration (modern cards do)</LI>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	88 <LI>X loads the XVideo extension, it's something like this:
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	89
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	90 <P><CODE>  (II) Loading extension XVideo</CODE></P>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	91
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	92 <P>in /var/log/XFree86.0.log</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	93
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	94 <P>NOTE: this loads only the XFree86's extension. In a good install, this
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	95 is always loaded, and doesn't mean that the <B>card's</B> XVideo support is
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	96 loaded!</P>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	97 </LI>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	98 <LI>Your card has Xv support under Linux. To check, try 'xvinfo', it is the
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	99 part of the XFree86 distribution. It should display a long text, similar
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	100 to this:
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	101 <PRE>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	102 X-Video Extension version 2.2
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	103 screen #0
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	104 Adaptor #0: "Savage Streams Engine"
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	105 number of ports: 1
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	106 port base: 43
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	107 operations supported: PutImage
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	108 supported visuals:
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	109 depth 16, visualID 0x22
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	110 depth 16, visualID 0x23
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	111 number of attributes: 5
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	112 (...)
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	113 Number of image formats: 7
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	114 id: 0x32595559 (YUY2)
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	115 guid: 59555932-0000-0010-8000-00aa00389b71
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	116 bits per pixel: 16
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	117 number of planes: 1
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	118 type: YUV (packed)
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	119 id: 0x32315659 (YV12)
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	120 guid: 59563132-0000-0010-8000-00aa00389b71
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	121 bits per pixel: 12
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	122 number of planes: 3
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	123 type: YUV (planar)
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	124 (...etc...)
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	125 </PRE>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	126 <P>It must support YUY2 packed, and YV12 planar pixel formats to be
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	127 usable with MPlayer.</P>
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	128 </LI>
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	129 <LI>And finally, check if MPlayer was compiled with 'xv' support.
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	130 ./configure prints this.</LI>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	131 </UL>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	132
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	133
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	134 <H4><A NAME="xv_3dfx">2.3.1.2.1.1 3dfx cards</A></H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	135
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	136 <P>Older 3dfx drivers were known to have problems with XVideo acceleration, it
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	137 didn't support either YUY2 or YV12, and so. Verify that you have XFree86
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	138 version 4.2.0 or greater, it works OK with YV12 and YUY2. Previous versions,
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	139 including 4.1.0, <B>crash with YV12</B>. If you experience strange effects
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	140 using -vo xv, try SDL (it has XVideo too) and see if it helps. Check the
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	141 <A HREF="#sdl">SDL section</A> for details.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	142
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	143 <P><B>OR</B>, try the NEW -vo tdfxfb driver! See the
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	144 <A HREF="#tdfxfb">tdfxfb</A> section.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	145
2865 72c750bbc249 * empty log message * gabucino parents: 2848 diff changeset	146
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	147 <H4><A NAME="xv_s3">2.3.1.2.1.2 S3 cards</A></H4>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	148
dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	149 <P>S3 Savage3D's should work fine, but for Savage4, use XFree86 version 4.0.3
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	150 or greater (in case of image problems, try 16bpp). As for S3 Virge.. there is
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	151 xv support, but the card itself is very slow, so you better sell it.</P>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	152
7640 427935644581 updates, fixes gabucino parents: 7454 diff changeset	153 <P><B>NOTE</B>: it's currently unclear which Savage models lack YV12 support,
427935644581 updates, fixes gabucino parents: 7454 diff changeset	154 and convert by driver (slow). If you suspect your card, get a newer driver,
427935644581 updates, fixes gabucino parents: 7454 diff changeset	155 or ask politely on the mplayer-users mailing list for an MMX/3DNow enabled
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	156 driver.</P>
2865 72c750bbc249 * empty log message * gabucino parents: 2848 diff changeset	157
72c750bbc249 * empty log message * gabucino parents: 2848 diff changeset	158
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	159 <H4><A NAME="xv_nvidia">2.3.1.2.1.3 nVidia cards</A></H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	160
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	161 <P>nVidia isn't a very good choice under Linux (according to nVidia, this is
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	162 <A HREF="users_against_developers.html#nvidia">not true</A>).. You'll have to
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	163 use the binary closed-source nVidia driver, available at nVidia's web site.
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	164 The standard XFree86 driver doesn't support XVideo for these cards, due to
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	165 nVidia's closed sources/specifications.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	166
3290 3928aef86033 stuff I don't remember gabucino parents: 3268 diff changeset	167 <P>As far as I know the latest XFree86 driver contains XVideo support for
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	168 GeForce 2 and 3.</P>
3290 3928aef86033 stuff I don't remember gabucino parents: 3268 diff changeset	169
6599 f20184a10258 1001 typos as found by ispell. diego parents: 6583 diff changeset	170 <P>Riva128 cards don't have XVideo support even with the nVidia driver :(
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	171 Complain to nVidia.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	172
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	173
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	174 <H4><A NAME="xv_ati">2.3.1.2.1.4 ATI cards</A></H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	175
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	176 <UL>
7937 33e4345d6dd6 URLs corrected. diego parents: 7814 diff changeset	177 <LI>The <A HREF="http://gatos.sourceforge.net">GATOS driver</A> (which you
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	178 should use, unless you have Rage128 or Radeon) has VSYNC enabled by
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	179 default. It means that decoding speed (!) is synced to the monitor's
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	180 refresh rate. If playing seems to be slow, try disabling VSYNC somehow, or
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	181 set refresh rate to n*(fps of the movie) Hz.</LI>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	182 <LI>Radeon VE - currently only XFree86 CVS has driver for this card, version
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	183 4.1.0 doesn't. And no TV out support. Of course with MPlayer you can
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	184 happily get <B>accelerated</B> display, with or without <B>TV output</B>, and
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	185 no libraries or X are needed. Read <A HREF="#vidix">Vidix</A> section.</LI>
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	186 </UL>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	187
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	188
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	189 <H4><A NAME="xv_neomagic">2.3.1.2.1.5 NeoMagic cards</A></H4>
1922 5f0e4310dd4d NeoMagic stuff added (legyen egyszer gyereknap...) gabucino parents: 1920 diff changeset	190
4920 089485d69edd added notes about enhanced Neomagic and Savage4 drivers gabucino parents: 4908 diff changeset	191 <P>These cards can be found in many laptops. Unfortunately, the driver in
089485d69edd added notes about enhanced Neomagic and Savage4 drivers gabucino parents: 4908 diff changeset	192 X 4.2.0 can't do Xv, but we have a modified, Xv-capable driver for you.
089485d69edd added notes about enhanced Neomagic and Savage4 drivers gabucino parents: 4908 diff changeset	193 <A HREF="http://www.mplayerhq.hu/MPlayer/contrib/NeoMagic-driver/neomagic_drv.o.4.2.0.bz2">Download from here</A>.
5359 a647a4bd5e93 Updated neomagic info. atmos4 parents: 5119 diff changeset	194 Driver provided by Stefan Seyfried.</P>
5378 1a7fd8f13ac0 small update gabucino parents: 5359 diff changeset	195
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	196 <P>To allow playback of DVD sized content change your XF86Config like this:</P>
5378 1a7fd8f13ac0 small update gabucino parents: 5359 diff changeset	197
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	198 <P>Section "Device"<BR>
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	199     <I>[...]</I><BR>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	200     Driver "neomagic"<BR>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	201     <B>Option "OverlayMem" "829440"</B><BR>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	202     <I>[...]</I><BR>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	203 EndSection</P>
1922 5f0e4310dd4d NeoMagic stuff added (legyen egyszer gyereknap...) gabucino parents: 1920 diff changeset	204
5378 1a7fd8f13ac0 small update gabucino parents: 5359 diff changeset	205
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	206 <H4><A NAME="xv_trident">2.3.1.2.1.6 Trident cards</A></H4>
3794 4049673123e1 know not.. gabucino parents: 3664 diff changeset	207
7640 427935644581 updates, fixes gabucino parents: 7454 diff changeset	208 <P>If you want to use xv with a trident card, provided that it doesn't work
427935644581 updates, fixes gabucino parents: 7454 diff changeset	209 with 4.1.0, install XFree 4.2.0. 4.2.0 adds support for fullscreen xv
427935644581 updates, fixes gabucino parents: 7454 diff changeset	210 support with the Cyberblade XP card.</P>
1922 5f0e4310dd4d NeoMagic stuff added (legyen egyszer gyereknap...) gabucino parents: 1920 diff changeset	211
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	212
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	213 <H4><A NAME="dga">2.3.1.2.2 DGA</A></H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	214
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	215
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	216 <H4><A NAME="dga_summary">2.3.1.2.2.1 Summary</A></H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	217
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	218 <P>This document tries to explain in some words what DGA is in general and what
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	219 the DGA video output driver for MPlayer can do (and what it
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	220 can't).</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	221
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	222
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	223 <H4><A NAME="dga_whatis">2.3.1.2.2.2 What is DGA</A></H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	224
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	225 <P>DGA is short for Direct Graphics Access and is a means for a program to
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	226 bypass the X-Server and directly modifying the framebuffer memory.
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	227 Technically spoken this happens by mapping the framebuffer memory into
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	228 the memory range of your process. This is allowed by the kernel only
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	229 if you have superuser privileges. You can get these either by logging in
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	230 as root or by setting the SUID bit on the MPlayer executable (<B>not
7015 72059027f953 Applied patch by Andras Mohari <mayday at varoshaza nagyatad hu> in a diego parents: 6998 diff changeset	231 recommended</B>).</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	232
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	233 <P>There are two versions of DGA: DGA1 is used by XFree 3.x.x and DGA2 was
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	234 introduced with XFree 4.0.1.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	235
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	236 <P>DGA1 provides only direct framebuffer access as described above. For
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	237 switching the resolution of the video signal you have to rely on the
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	238 XVidMode extension.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	239
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	240 <P>DGA2 incorporates the features of XVidMode extension and also allows
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	241 switching the depth of the display. So you may, although basically
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	242 running a 32 bit depth X server, switch to a depth of 15 bits and vice
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	243 versa. </P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	244
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	245 <P>However DGA has some drawbacks. It seems it is somewhat dependent on the
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	246 graphics chip you use and on the implementation of the X server's video
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	247 driver that controls this chip. So it does not work on every system ...</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	248
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	249
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	250 <H4><A NAME="dga_installation">2.3.1.2.2.3 Installing DGA support for MPlayer</A></H4>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	251
dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	252 <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	253
dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	254 <P>    <CODE>(II) Loading extension XFree86-DGA</CODE></P>
dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	255
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	256 <P>See, XFree86 4.0.x or greater is VERY RECOMMENDED! MPlayer's DGA
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	257 driver is autodetected on ./configure, or you can force it with
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	258 --enable-dga.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	259
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	260 <P>If the driver couldn't switch to a smaller resolution, experiment with
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	261 switches -vm (only with X 3.3.x), -fs, -bpp, -zoom to find a video mode that
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	262 the movie fits in. There is no converter right now :(</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	263
7015 72059027f953 Applied patch by Andras Mohari <mayday at varoshaza nagyatad hu> in a diego parents: 6998 diff changeset	264 <P>Become root. DGA needs root access to be able to write directly to video
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	265 memory. If you want to run it as user, then install MPlayer SUID
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	266 root:</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	267
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	268 <P><CODE>
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	269     chown root /usr/local/bin/mplayer<BR>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	270     chmod 750 /usr/local/bin/mplayer<BR>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	271     chmod +s /usr/local/bin/mplayer</CODE></P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	272
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	273 <P>Now it works as a simple user, too.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	274
7015 72059027f953 Applied patch by Andras Mohari <mayday at varoshaza nagyatad hu> in a diego parents: 6998 diff changeset	275 <BLOCKQUOTE>
72059027f953 Applied patch by Andras Mohari <mayday at varoshaza nagyatad hu> in a diego parents: 6998 diff changeset	276 <B>Warning: security risk</B><BR>
72059027f953 Applied patch by Andras Mohari <mayday at varoshaza nagyatad hu> in a diego parents: 6998 diff changeset	277 This is a <B>big</B> security risk! <B>Never</B> do this on a server or on
72059027f953 Applied patch by Andras Mohari <mayday at varoshaza nagyatad hu> in a diego parents: 6998 diff changeset	278 a computer that can be accessed by other people because they can gain root
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	279 privileges through SUID root MPlayer.
7015 72059027f953 Applied patch by Andras Mohari <mayday at varoshaza nagyatad hu> in a diego parents: 6998 diff changeset	280 </BLOCKQUOTE>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	281
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	282 <P>Now use the <CODE>-vo dga</CODE> option, and there you go (hope so :))!
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	283 You should also try if the <CODE>-vo sdl:dga</CODE> option works for you. It's
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	284 much faster.</P>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	285
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	286
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	287 <H4><A NAME="dga_resolution">2.3.1.2.2.4 Resolution switching</A></H4>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	288
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	289 <P>The DGA driver allows for switching the resolution of the output signal.
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	290 This avoids the need for doing (slow) software scaling and at the same time
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	291 provides a fullscreen image. Ideally it would switch to the exact resolution
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	292 (except for honoring aspect ratio) of the video data, but the X server only
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	293 allows switching to resolutions predefined in
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	294 <CODE>/etc/X11/XF86Config</CODE> (<CODE>/etc/X11/XF86Config-4</CODE> for
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	295 XFree 4.0.X respectively). Those are defined by so-called modelines and
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	296 depend on the capabilities of your video hardware. The X server scans this
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	297 config file on startup and disables the modelines not suitable for your
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	298 hardware. You can find out which modes survive with the X11 log file. It can
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	299 be found at:
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	300 <CODE>/var/log/XFree86.0.log</CODE>.</P>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	301
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	302 <P>See appendix A for some sample modeline definitions.</P>
dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	303
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	304
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	305 <H4><A NAME="dga_mplayer">2.3.1.2.2.5 DGA & MPlayer</A></H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	306
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	307 <P>DGA is used in two places with MPlayer: The SDL driver can be made to
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	308 make use of it (-vo sdl:dga) and within the DGA driver (-vo dga). The above
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	309 said is true for both; in the following sections I'll explain how the DGA
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	310 driver for MPlayer works.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	311
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	312
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	313 <H4><A NAME="dga_features">2.3.1.2.2.6 Features of the DGA driver</A></H4>
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	314
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	315 <P>The DGA driver is invoked by specifying -vo dga at the command line.
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	316 The default behavior is to switch to a resolution matching the original
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	317 resolution of the video as close as possible. It deliberately ignores the
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	318 -vm and -fs switches (enabling of video mode switching and fullscreen) -
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	319 it always tries to cover as much area of your screen as possible by switching
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	320 the video mode, thus refraining to use a single additional cycle of your CPU
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	321 to scale the image.
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	322 If you don't like the mode it chooses you may force it to choose the mode
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	323 matching closest the resolution you specify by -x and -y.
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	324 By providing the -v option, the DGA driver will print, among a lot of other
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	325 things, a list of all resolutions supported by your current XF86-Config
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	326 file.
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	327 Having DGA2 you may also force it to use a certain depth by using the -bpp
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	328 option. Valid depths are 15, 16, 24 and 32. It depends on your hardware
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	329 whether these depths are natively supported or if a (possibly slow)
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	330 conversion has to be done.</P>
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	331
33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	332 <P>If you should be lucky enough to have enough offscreen memory left to
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	333 put a whole image there, the DGA driver will use doublebuffering, which
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	334 results in much smoother movie replaying. It will tell you whether double-
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	335 buffering is enabled or not.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	336
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	337 <P>Doublebuffering means that the next frame of your video is being drawn in
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	338 some offscreen memory while the current frame is being displayed. When the
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	339 next frame is ready, the graphics chip is just told the location in memory
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	340 of the new frame and simply fetches the data to be displayed from there.
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	341 In the meantime the other buffer in memory will be filled again with new
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	342 video data.</P>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	343
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	344 <P>Doublebuffering may be switched on by using the option -double and may be
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	345 disabled with -nodouble. Current default option is to disable
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	346 doublebuffering. When using the DGA driver, onscreen display (OSD) only
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	347 works with doublebuffering enabled. However, enabling doublebuffering may
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	348 result in a big speed penalty (on my K6-II+ 525 it used an additional 20% of
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	349 CPU time!) depending on the implementation of DGA for your hardware.</P>
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	350
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	351
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	352 <H4><A NAME="dga_speed">2.3.1.2.2.7 Speed issues</A></H4>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	353
dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	354 <P>Generally spoken, DGA framebuffer access should be at least as fast as using
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	355 the X11 driver with the additional benefit of getting a fullscreen image.
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	356 The percentage speed values printed by MPlayer have to be interpreted
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	357 with some care, as for example, with the X11 driver they do not include the
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	358 time used by the X-Server needed for the actual drawing. Hook a terminal to a
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	359 serial line of your box and start top to see what is really going on in your
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	360 box...</P>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	361
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	362 <P>Generally spoken, the speedup done by using DGA against 'normal' use of X11
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	363 highly depends on your graphics card and how well the X-Server module for it
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	364 is optimized.</P>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	365
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	366 <P>If you have a slow system, better use 15 or 16bit depth since they require
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	367 only half the memory bandwidth of a 32 bit display.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	368
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	369 <P>Using a depth of 24bit is even a good idea if your card natively just
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	370 supports 32 bit depth since it transfers 25% less data compared to the 32/32
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	371 mode.</P>
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	372
6599 f20184a10258 1001 typos as found by ispell. diego parents: 6583 diff changeset	373 <P>I've seen some AVI files already be replayed on a Pentium MMX 266. AMD K6-2
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	374 CPUs might work at 400 MHZ and above.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	375
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	376
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	377 <H4><A NAME="dga_bugs">2.3.1.2.2.8 Known bugs</A></H4>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	378
6599 f20184a10258 1001 typos as found by ispell. diego parents: 6583 diff changeset	379 <P>Well, according to some developers of XFree, DGA is quite a beast. They
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	380 tell you better not to use it. Its implementation is not always flawless
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	381 with every chipset driver for XFree out there.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	382
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	383 <UL>
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	384 <LI>With XFree 4.0.3 and nv.o there is a bug resulting in strange
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	385 colors.</LI>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	386 <LI>ATI driver requires to switch mode back more than once after finishing
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	387 using of DGA.</LI>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	388 <LI>Some drivers simply fail to switch back to normal resolution (use
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	389 Ctrl-Alt-Keypad +, - to switch back manually).</LI>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	390 <LI>Some drivers simply display strange colors.</LI>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	391 <LI>Some drivers lie about the amount of memory they map into the process's
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	392 address space, thus vo_dga won't use doublebuffering (SIS?).</LI>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	393 <LI>some drivers seem to fail to report even a single valid mode. In this
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	394 case the DGA driver will crash telling you about a nonsense mode of
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	395 100000x100000 or the like ...</LI>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	396 <LI>OSD only works with doublebuffering enabled.</LI>
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	397 </UL>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	398
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	399
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	400 <H4><A NAME="dga_future">2.3.1.2.2.9 Future work</A></H4>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	401
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	402 <UL>
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	403 <LI>use of the new X11 render interface for OSD</LI>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	404 <LI>where is my TODO list ???? :-(((</LI>
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	405 </UL>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	406
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	407
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	408 <H4><A NAME="dga_modelines">2.3.1.2.2.A Some modelines</A></H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	409
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	410 <PRE>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	411 Section "Modes"
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	412 Identifier "Modes[0]"
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	413 Modeline "800x600" 40 800 840 968 1056 600 601 605 628
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	414 Modeline "712x600" 35.0 712 740 850 900 400 410 412 425
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	415 Modeline "640x480" 25.175 640 664 760 800 480 491 493 525
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	416 Modeline "400x300" 20 400 416 480 528 300 301 303 314 Doublescan
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	417 Modeline "352x288" 25.10 352 368 416 432 288 296 290 310
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	418 Modeline "352x240" 15.750 352 368 416 432 240 244 246 262 Doublescan
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	419 Modeline "320x240" 12.588 320 336 384 400 240 245 246 262 Doublescan
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	420 EndSection
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	421 </PRE>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	422
6599 f20184a10258 1001 typos as found by ispell. diego parents: 6583 diff changeset	423 <P>These entries work fine with my Riva128 chip, using nv.o X server driver
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	424 module.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	425
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	426
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	427 <H4><A NAME="dga_bug_reports">2.3.1.2.2.B Bug Reports</A></H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	428
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	429 <P>If you experience troubles with the DGA driver please feel free to file
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	430 a bug report to me (e-mail address below). Please start MPlayer with
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	431 the -v option and include all lines in the bug report that start with
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	432 vo_dga:</P>
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	433
33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	434 <P>Please do also include the version of X11 you are using, the graphics card
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	435 and your CPU type. The X11 driver module (defined in XF86-Config) might
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	436 also help. Thanks!</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	437
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	438 <P><I>Acki (acki@acki-netz.de, www.acki-netz.de)</I></P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	439
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	440
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	441 <H4><A NAME="sdl">2.3.1.2.3 SDL</A></H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	442
6583 4b7d097a9c69 big update gabucino parents: 6499 diff changeset	443 <P>SDL (Simple Directmedia Layer) is basically a unified video/audio
3988 a5c59d8637a9 some user-parsible lines about SDL gabucino parents: 3942 diff changeset	444 interface. Programs that use it know only about SDL, and not about what video
a5c59d8637a9 some user-parsible lines about SDL gabucino parents: 3942 diff changeset	445 or audio driver does SDL actually use. For example a Doom port using SDL can
a5c59d8637a9 some user-parsible lines about SDL gabucino parents: 3942 diff changeset	446 run on svgalib, aalib, X, fbdev, and others, you only have to specify the
a5c59d8637a9 some user-parsible lines about SDL gabucino parents: 3942 diff changeset	447 (for example) video driver to use with the SDL_VIDEODRIVER environment
a5c59d8637a9 some user-parsible lines about SDL gabucino parents: 3942 diff changeset	448 variable. Well, in theory.</P>
a5c59d8637a9 some user-parsible lines about SDL gabucino parents: 3942 diff changeset	449
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	450 <P>With MPlayer, we used its X11 driver's software scaler ability for
3988 a5c59d8637a9 some user-parsible lines about SDL gabucino parents: 3942 diff changeset	451 cards/drivers that doesn't support XVideo, until we made our own (faster,
a5c59d8637a9 some user-parsible lines about SDL gabucino parents: 3942 diff changeset	452 nicer) software scaler. Also we used its aalib output, but now we have ours
a5c59d8637a9 some user-parsible lines about SDL gabucino parents: 3942 diff changeset	453 which is more comfortable. Its DGA mode was better than ours, until
a5c59d8637a9 some user-parsible lines about SDL gabucino parents: 3942 diff changeset	454 recently. Get it now? :)</P>
a5c59d8637a9 some user-parsible lines about SDL gabucino parents: 3942 diff changeset	455
a5c59d8637a9 some user-parsible lines about SDL gabucino parents: 3942 diff changeset	456 <P>It also helps with some buggy drivers/cards if the video is jerky
a5c59d8637a9 some user-parsible lines about SDL gabucino parents: 3942 diff changeset	457 (not slow system problem), or audio is lagging.</P>
a5c59d8637a9 some user-parsible lines about SDL gabucino parents: 3942 diff changeset	458
5119 636b20788503 szrii, tuu, van, fajor gabucino parents: 5116 diff changeset	459 <P>SDL video output supports displaying subtitles under the movie, on the (if
636b20788503 szrii, tuu, van, fajor gabucino parents: 5116 diff changeset	460 present) black bar.</P>
636b20788503 szrii, tuu, van, fajor gabucino parents: 5116 diff changeset	461
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	462 <P><B>There are several command line switches for SDL:</B></P>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	463 <DL>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	464 <DT><CODE>-vo sdl:name</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	465 <DD>specifies sdl video driver to use (i.e.. aalib, dga, x11)</DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	466
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	467 <DT><CODE>-ao sdl:name</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	468 <DD>specifies sdl audio driver to use (i.e. dsp, esd, arts)</DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	469
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	470 <DT><CODE>-noxv</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	471 <DD>disables XVideo hardware acceleration</DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	472
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	473 <DT><CODE>-forcexv</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	474 <DD>tries to force XVideo acceleration</DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	475 </DL>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	476
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	477 <TABLE BORDER=0>
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	478 <TR><TD COLSPAN=4><P><B>SDL Keys:</B></P></TD></TR>
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	479 <TR><TD></TD><TD><CODE>F</CODE></TD><TD></TD><TD>toggles fullscreen/windowed mode</TD></TR>
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	480 <TR><TD></TD><TD><CODE>C</CODE></TD><TD></TD><TD>cycles available fullscreen modes</TD></TR>
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	481 <TR><TD></TD><TD><CODE>W/S</CODE></TD><TD></TD><TD>mappings for * and / (mixer control)</TD></TR>
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	482 </TABLE>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	483
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	484 <H4>Known bugs:</H4>
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	485
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	486 <UL>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	487 <LI>Keys pressed under sdl:aalib console driver repeat forever. (use -vo aa!)
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	488 It's bug in SDL, I can't change it (tested with SDL 1.2.1).</LI>
8145 adc8d71a15bd space, whitespace fixes gabucino parents: 8088 diff changeset	489 <LI>DO NOT USE SDL with GUI! It won't work as it should.</LI>
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	490 </UL>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	491
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	492
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	493 <H4><A NAME="svgalib">2.3.1.2.4 SVGAlib</A></H4>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	494
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	495 <H4>Installation</H4>
4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	496
4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	497 <P>You'll have to install svgalib and its development package in order for
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	498 MPlayer build its SVGAlib driver (autodetected, but can be forced),
6499 ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	499 and don't forget to edit /etc/vga/libvga.config to suit your card &
ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	500 monitor.</P>
ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	501
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	502 <H4>Notes</H4>
4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	503
4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	504 <P>Be sure not to use the -fs switch, since it toggles the usage of the software
6499 ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	505 scaler, and it's slow. If you really need it, use the <CODE>-sws 4</CODE>
ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	506 option which will produce bad quality, but is somewhat faster.</P>
ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	507
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	508 <H4>EGA (4bpp) support</H4>
4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	509
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	510 <P>SVGAlib incorporates EGAlib, and MPlayer has the possibility to
6499 ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	511 display any movie in 16 colors, thus usable in the following sets:</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	512
6499 ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	513 <UL>
ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	514 <LI>EGA card with EGA monitor: 320x200x4bpp, 640x200x4bpp, 640x350x4bpp</LI>
ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	515 <LI>EGA card with CGA monitor: 320x200x4bpp, 640x200x4bpp</LI>
ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	516 </UL>
ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	517
ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	518 <P>The bpp (bits per pixel) value must be set to 4 by hand:<BR>
ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	519   <CODE>-bpp 4</CODE><BR>
ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	520 The movie probably must be scaled down to fit in EGA mode:<BR>
ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	521   <CODE>-vop scale=640:350</CODE> or<BR>
ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	522   <CODE>-vop scale=320:200</CODE><BR>
ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	523 For that we need fast but bad quality scaling routine:<BR>
ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	524   <CODE>-sws 4</CODE><BR>
ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	525 Maybe automatic aspect correction has to be shut off:<BR>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	526   <CODE>-noaspect</CODE></P>
6499 ce4647b864e5 SVGAlib section revised gabucino parents: 6435 diff changeset	527
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	528
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	529 <H4><A NAME="fbdev">2.3.1.2.5 Framebuffer output (FBdev)</A></H4>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	530
dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	531 <P>Whether to build the FBdev target is autodetected during ./configure .
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	532 Read the framebuffer documentation in the kernel sources
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	533 (Documentation/fb/*) for more information.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	534
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	535 <P>If your card doesn't support VBE 2.0 standard (older ISA/PCI
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	536 cards, such as S3 Trio64), only VBE 1.2 (or older?):
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	537 Well, VESAfb is still available, but you'll have to load SciTech Display
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	538 Doctor (formerly UniVBE) before booting Linux. Use a DOS boot disk or
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	539 whatever. And don't forget to register your UniVBE ;))</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	540
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	541 <P>The FBdev output takes some additional parameters above the others:</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	542
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	543 <DL>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	544 <DT><CODE>-fb</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	545 <DD>specify the framebuffer device to use (/dev/fb0)</DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	546
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	547 <DT><CODE>-fbmode</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	548 <DD>mode name to use (according to /etc/fb.modes)</DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	549
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	550 <DT><CODE>-fbmodeconfig</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	551 <DD>config file of modes (default /etc/fb.modes)</DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	552
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	553 <DT><CODE>-monitor_hfreq</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	554 <DT><CODE>-monitor_vfreq</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	555 <DT><CODE>-monitor_dotclock</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	556 <DD><STRONG>Important</STRONG> values, see <CODE>example.conf</CODE></DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	557 </DL>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	558
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	559 <P>If you want to change to a specific mode, then use</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	560
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	561 <P><CODE>    mplayer -vm -fbmode (NameOfMode) filename</CODE></P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	562
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	563 <UL>
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	564 <LI><B>-vm</B> alone will choose the most suitable mode from /etc/fb.modes.
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	565 Can be used together with -x and -y options too. The -flip option is
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	566 supported only if the movie's pixel format matches the video mode's pixel
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	567 format. Pay attention to the bpp value, fbdev driver tries to use the
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	568 current, or if you specify the -bpp option, then that.</LI>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	569 <LI><B>-zoom</B> option isn't supported (software scaling is slow). -fs
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	570 option isn't supported. You can't use 8bpp (or less) modes.</LI>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	571 <LI>you possibly want to turn the cursor off: <CODE>echo -e
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	572 '\033[?25l'</CODE> or <CODE>setterm -cursor off</CODE><BR>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	573 and the screen saver: <CODE>setterm -blank 0</CODE><BR>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	574 To turn the cursor back on: <CODE>echo -e '\033[?25h'</CODE>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	575 or <CODE>setterm -cursor on</CODE></LI>
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	576 </UL>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	577
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	578 <P>NOTE: FBdev video mode changing _does not work_ with the VESA framebuffer,
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	579 and don't ask for it, since it's not an MPlayer limitation.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	580
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	581
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	582 <H4><A NAME="mga_vid">2.3.1.2.6 Matrox framebuffer (mga_vid)</A></H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	583
1992 156639eddf49 tdfxfb added gabucino parents: 1988 diff changeset	584 <P>This section is about the Matrox G200/G400/G450/G550 BES (Back-End Scaler)
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	585 support, the mga_vid kernel driver. It's active developed by me (A'rpi), and
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	586 it has hardware VSYNC support with triple buffering. It works on both
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	587 framebuffer console and under X.</P>
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	588
6906 3274d0725fde Changed all link names from the section number to a sensible label. diego parents: 6882 diff changeset	589 <P><B>WARNING</B>: on non-Linux systems, use <A HREF="#vidix">VIDIX</A> for
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	590 mga_vid!</P>
4505 fdeee8424d90 on non-Linux use Vidix instead of mga_vid kernelmodule gabucino parents: 4504 diff changeset	591
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	592 <P><B>Installation:</B></P>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	593 <OL>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	594 <LI>To use it, you first have to compile mga_vid.o:
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	595 <P><CODE>cd drivers<BR>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	596 make</CODE></P></LI>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	597 <LI>Then create the <CODE>/dev/mga_vid</CODE> device:
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	598 <P><CODE>mknod /dev/mga_vid c 178 0</CODE></P>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	599 <P>and load the driver with</P>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	600 <P><CODE>insmod mga_vid.o</CODE></P></LI>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	601 <LI>You should verify the memory size detection using the <CODE>dmesg</CODE>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	602 command. If it's bad, use the <CODE>mga_ram_size</CODE> option
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	603 (<CODE>rmmod mga_vid</CODE> first), specify card's memory size in MB:
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	604 <P><CODE>insmod mga_vid.o mga_ram_size=16</CODE></P></LI>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	605 <LI>To make it load/unload automatically when needed, first insert the
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	606 following line at the end of <CODE>/etc/modules.conf</CODE>:
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	607 <P><CODE>alias char-major-178 mga_vid</CODE></P>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	608 <P>Then copy the <CODE>mga_vid.o</CODE> module to the appropriate place
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	609 under <CODE>/lib/modules/<kernel version>/somewhere</CODE>.</P>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	610 <P>Then run</P>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	611 <P><CODE>depmod -a</CODE></P></LI>
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	612 <LI>Now you have to (re)compile MPlayer, <CODE>configure</CODE> will
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	613 detect <CODE>/dev/mga_vid</CODE> and build the 'mga' driver. Using it from
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	614 MPlayer goes by <CODE>-vo mga</CODE> if you have matroxfb console,
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	615 or <CODE>-vo xmga</CODE> under XFree86 3.x.x or 4.x.x.</LI>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	616 </OL>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	617
2108 767dbc5b7daa mga_vid now cooperates with xv gabucino parents: 2063 diff changeset	618 <P>The mga_vid driver cooperates with Xv.</P>
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	619
4504 b2f4c590fb74 mga_vid supports reads and writes gabucino parents: 4498 diff changeset	620 <P>The <CODE>/dev/mga_vid</CODE> device file can be read (for example by
b2f4c590fb74 mga_vid supports reads and writes gabucino parents: 4498 diff changeset	621 <CODE>cat /dev/mga_vid</CODE>) for some info, and written for brightness
7076 3275af5787e0 Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, slightly diego parents: 7061 diff changeset	622 change: <CODE>echo "brightness=120" > /dev/mga_vid</CODE></P>
4504 b2f4c590fb74 mga_vid supports reads and writes gabucino parents: 4498 diff changeset	623
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	624
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	625 <H4><A NAME="tdfxfb">2.3.1.2.7 3dfx YUV support (tdfxfb)</A></H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	626
1992 156639eddf49 tdfxfb added gabucino parents: 1988 diff changeset	627 <P>This driver uses the kernel's tdfx framebuffer driver to play movies with
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	628 YUV acceleration. You'll need a kernel with tdfxfb support, and recompile
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	629 with <CODE>./configure --enable-tdfxfb</CODE></P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	630
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	631
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	632 <H4><A NAME="opengl">2.3.1.2.8 OpenGL output</A></H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	633
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	634 <P>MPlayer supports displaying movies using OpenGL, but if your
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	635 platform/driver supports xv as should be the case on a PC with Linux, use xv
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	636 instead, OpenGL performance is considerably worse. If you have an X11
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	637 implementation without xv support, OpenGL is a viable alternative.</P>
6309 d6eea5314980 OpenGL update diego parents: 5713 diff changeset	638
d6eea5314980 OpenGL update diego parents: 5713 diff changeset	639 <P>Unfortunately not all drivers support this feature. The Utah-GLX drivers
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	640 (for XFree86 3.3.6) support it for all cards. See
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	641 <A HREF="http://utah-glx.sourceforge.net">http://utah-glx.sourceforge.net</A>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	642 for details about how to install it.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	643
7076 3275af5787e0 Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, slightly diego parents: 7061 diff changeset	644 <P>XFree86(DRI) 4.0.3 or later supports OpenGL with Matrox and Radeon cards,
3275af5787e0 Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, slightly diego parents: 7061 diff changeset	645 4.2.0 or later supports Rage128. See
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	646 <A HREF="http://dri.sourceforge.net">http://dri.sourceforge.net</A>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	647 for download and installation instructions.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	648
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	649
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	650 <H4><A NAME="aalib">2.3.1.2.9 AAlib - text mode displaying</A></H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	651
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	652 <P><B>AAlib</B> is a library for displaying graphics in text mode, using powerful
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	653 ASCII renderer. There are LOTS of programs already supporting it, like Doom,
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	654 Quake, etc. MPlayer contains a very usable driver for it.
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	655 If ./configure detects aalib installed, the aalib libvo driver will be
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	656 built.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	657
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	658 <TABLE BORDER=0>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	659 <TR><TD COLSPAN=4><P><B>You can use some keys in the AA Window to change rendering options:</B></P></TD></TR>
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	660 <TR><TD>  </TD><TD><CODE>1</CODE></TD><TD>  </TD><TD>decrease contrast</TD></TR>
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	661 <TR><TD></TD><TD><CODE>2</CODE></TD><TD></TD><TD>increase contrast</TD></TR>
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	662 <TR><TD></TD><TD><CODE>3</CODE></TD><TD></TD><TD>decrease brightness</TD></TR>
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	663 <TR><TD></TD><TD><CODE>4</CODE></TD><TD></TD><TD>increase brightness</TD></TR>
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	664 <TR><TD></TD><TD><CODE>5</CODE></TD><TD></TD><TD>switch fast rendering on/off</TD></TR>
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	665 <TR><TD></TD><TD><CODE>6</CODE></TD><TD></TD><TD>set dithering mode (none, error distribution, Floyd Steinberg)</TD></TR>
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	666 <TR><TD></TD><TD><CODE>7</CODE></TD><TD></TD><TD>invert image</TD></TR>
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	667 <TR><TD></TD><TD><CODE>a</CODE></TD><TD></TD><TD>toggles between aa and MPlayer control)</TD></TR>
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	668 </TABLE>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	669
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	670 <P><B>The following command line options can be used:</B></P>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	671 <DL>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	672 <DT><CODE>-aaosdcolor=V</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	673 <DD>change OSD color</DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	674
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	675 <DT><CODE>-aasubcolor=V</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	676 <DD>change subtitle color
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	677 <P><I>where V can be: (0/normal, 1/dark, 2/bold, 3/bold font, 4/reverse,
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	678 5/special)</I></P></DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	679 </DL>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	680
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	681 <P><B>AAlib itself provides a large sum of options.
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	682 Here are some important:</B></P>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	683 <DL>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	684 <DT><CODE>-aadriver</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	685 <DD>set recommended aa driver (X11, curses, Linux)</DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	686
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	687 <DT><CODE>-aaextended</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	688 <DD>use all 256 characters</DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	689
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	690 <DT><CODE>-aaeight</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	691 <DD>use eight bit ASCII</DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	692
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	693 <DT><CODE>-aahelp</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	694 <DD>prints out all aalib options</DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	695 </DL>
1682 dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	696
dba45a1aafad * empty log message * gabucino parents: 1668 diff changeset	697 <P>NOTE: the rendering is very CPU intensive, especially when using AA-on-X
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	698 (using aalib on X), and it's least CPU intensive on standard,
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	699 non-framebuffer console. Use SVGATextMode to set up a big textmode,
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	700 then enjoy! (secondary head Hercules cards rock :)) (anyone can enhance
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	701 fbdev to do conversion/dithering to hgafb? Would be neat :)</P>
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	702
6732 8460a77203de DXR3 moved to video.html. TOC updated, added <CODE> where appropiate. diego parents: 6729 diff changeset	703 <P>Use the <CODE>-framedrop</CODE> option if your computer isn't fast enough to
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	704 render all frames!</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	705
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	706 <P>Playing on terminal you'll get better speed and quality using the Linux
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	707 driver, not curses (<CODE>-aadriver linux</CODE>). But therefore you need write access on
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	708 <CODE>/dev/vcsa<terminal></CODE>. That isn't autodetected by aalib, but vo_aa tries
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	709 to find the best mode. See
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	710 <A HREF="http://aa-project.sourceforge.net/tune/">http://aa-project.sourceforge.net/tune/</A>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	711 for further tuning issues.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	712
2471 6bf47f224789 * empty log message * gabucino parents: 2452 diff changeset	713
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	714 <H4><A NAME="vesa">2.3.1.2.10 VESA - output to VESA BIOS</A></H4>
6906 3274d0725fde Changed all link names from the section number to a sensible label. diego parents: 6882 diff changeset	715
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	716 <P>This driver was designed and introduced as a <B>generic driver</B> for any
7651 9bb9ce641684 documenting vesa 3 / GTF config arpi parents: 7640 diff changeset	717 video card which has VESA VBE 2.0+ compatible BIOS. Another advantage of this
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	718 driver is that it tries to force TV output on.<BR>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	719 <B>VESA BIOS EXTENSION (VBE) Version 3.0 Date: September 16, 1998</B> (Page
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	720 70) says:</P>
2448 1e56c3381d55 'vesa' vo driver added. By Nick Kurshev. (spellchecked, fixed, mplayerdoxized) gabucino parents: 2408 diff changeset	721
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	722 <BLOCKQUOTE>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	723 <B>Dual-Controller Designs</B><BR>
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	724 VBE 3.0 supports the dual-controller design by assuming that since both
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	725 controllers are typically provided by the same OEM, under control of a
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	726 single BIOS ROM on the same graphics card, it is possible to hide the fact
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	727 that two controllers are indeed present from the application. This has the
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	728 limitation of preventing simultaneous use of the independent controllers,
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	729 but allows applications released before VBE 3.0 to operate normally. The
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	730 VBE Function 00h (Return Controller Information) returns the combined
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	731 information of both controllers, including the combined list of available
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	732 modes. When the application selects a mode, the appropriate controller is
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	733 activated. Each of the remaining VBE functions then operates on the active
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	734 controller.
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	735 </BLOCKQUOTE>
2448 1e56c3381d55 'vesa' vo driver added. By Nick Kurshev. (spellchecked, fixed, mplayerdoxized) gabucino parents: 2408 diff changeset	736
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	737 <P>So you have chances to get working TV-out by using this driver.<BR>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	738 (I guess that TV-out frequently is standalone head or standalone output
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	739 at least.)</P>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	740
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	741 <H4>Advantages:</H4>
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	742
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	743 <UL>
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	744 <LI>You have the possibility to watch movies <B>even if Linux doesn't know</B>
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	745 your video hardware.</LI>
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	746 <LI>You don't need to have installed any graphics' related things on your Linux
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	747 (like X11 (aka XFree86), fbdev and so on). This driver can be run from
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	748 <B>text-mode</B>.</LI>
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	749 <LI>You have chances to get <B>working TV-out</B>. (It's known at least for
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	750 ATI's cards).</LI>
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	751 <LI>This driver calls <B>int 10h</B> handler thus it's not an emulator - it
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	752 calls <B>real</B> things of <B>real</B> BIOS in <B>real</B>-mode. (Finely -
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	753 in vm86 mode).</LI>
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	754 <LI>You can use Vidix with it, thus getting accelerated video display
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	755 <B>AND</B> TV output at the same time! (recommended for ATI cards)</LI>
7793 6d8b4a1adb9d Remove option descriptions that are in the man page, add some missing diego parents: 7699 diff changeset	756 <LI>If you have VESA VBE 3.0+, and you had specified <CODE>monitor_hfreq</CODE>,
6d8b4a1adb9d Remove option descriptions that are in the man page, add some missing diego parents: 7699 diff changeset	757 <CODE>monitor_vfreq</CODE>, <CODE>monitor_dotclock</CODE> somewhere (config
6d8b4a1adb9d Remove option descriptions that are in the man page, add some missing diego parents: 7699 diff changeset	758 file, or commandline) you will get the highest possible refresh rate. (Using
6d8b4a1adb9d Remove option descriptions that are in the man page, add some missing diego parents: 7699 diff changeset	759 General Timing Formula). To enable this feature you have to specify
6d8b4a1adb9d Remove option descriptions that are in the man page, add some missing diego parents: 7699 diff changeset	760 <B>all</B> your monitor options.</LI>
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	761 </UL>
2448 1e56c3381d55 'vesa' vo driver added. By Nick Kurshev. (spellchecked, fixed, mplayerdoxized) gabucino parents: 2408 diff changeset	762
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	763 <H4>Disadvantages:</H4>
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	764
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	765 <UL>
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	766 <LI>It works only on <B>x86 systems</B>.</LI>
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	767 <LI>It can be used only by <B>root</B>.</LI>
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	768 <LI>Currently it's available only for <B>Linux</B>.</LI>
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	769 </UL>
2448 1e56c3381d55 'vesa' vo driver added. By Nick Kurshev. (spellchecked, fixed, mplayerdoxized) gabucino parents: 2408 diff changeset	770
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	771 <P>Don't use this driver with <B>GCC 2.96</B>! It won't work!</P>
3141 21b6aab15ec9 -vo vesa + gcc 2.96 warning (is this confirmed?) gabucino parents: 3053 diff changeset	772
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	773 <P><B>Command line options available for VESA:</B></P>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	774 <DL>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	775 <DT><CODE>-vo vesa:opts</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	776 <DD>currently recognized: <B>dga</B> to force dga mode and <B>nodga</B> to
7793 6d8b4a1adb9d Remove option descriptions that are in the man page, add some missing diego parents: 7699 diff changeset	777 disable dga mode. In dga mode you can enable double buffering via the
6d8b4a1adb9d Remove option descriptions that are in the man page, add some missing diego parents: 7699 diff changeset	778 <CODE>-double</CODE> option. Note: you may omit these parameters to enable
6d8b4a1adb9d Remove option descriptions that are in the man page, add some missing diego parents: 7699 diff changeset	779 <B>autodetection</B> of dga mode.</DD>
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	780 </DL>
2448 1e56c3381d55 'vesa' vo driver added. By Nick Kurshev. (spellchecked, fixed, mplayerdoxized) gabucino parents: 2408 diff changeset	781
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	782 <H4>Known problems and workaround:</H4>
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	783
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	784 <UL>
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	785 <LI>If you have installed <B>NLS</B> font on your Linux box and run VESA
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	786 driver from text-mode then after terminating MPlayer you will have
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	787 <B>ROM font</B> loaded instead of national. You can load national font again
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	788 by using <B><I>setsysfont</I></B> utility from the Mandrake distribution
7076 3275af5787e0 Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, slightly diego parents: 7061 diff changeset	789 for example.<BR>
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	790 (<B>Hint:</B> The same utility is used for the localization of fbdev).</LI>
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	791 <LI>Some <B>Linux graphics drivers</B> don't update active <B>BIOS mode</B> in
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	792 DOS memory. So if you have such problem - always use VESA driver only from
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	793 <B>text-mode</B>. Otherwise text-mode (#03) will be activated anyway and
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	794 you will need restart your computer.</LI>
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	795 <LI>Often after terminating VESA driver you get <B>black screen</B>. To return
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	796 your screen to original state - simply switch to other console (by pressing
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	797 <B>Alt-Fx</B>) then switch to your previous console by the same way.</LI>
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	798 <LI>To get <B>working TV-out</B> you need have plugged TV-connector in before
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	799 booting your PC since video BIOS initializes itself only once during POST
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	800 procedure.</LI>
83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	801 </UL>
2448 1e56c3381d55 'vesa' vo driver added. By Nick Kurshev. (spellchecked, fixed, mplayerdoxized) gabucino parents: 2408 diff changeset	802
1e56c3381d55 'vesa' vo driver added. By Nick Kurshev. (spellchecked, fixed, mplayerdoxized) gabucino parents: 2408 diff changeset	803
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	804 <H4><A NAME="x11">2.3.1.2.11 X11</A></H4>
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	805
33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	806 <P>Avoid if possible. Outputs to X11 (uses shared memory extension), with no
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	807 hardware acceleration at all. Supports (MMX/3DNow/SSE accelerated, but still
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	808 slow) software scaling, use the options <CODE>-fs -zoom</CODE>. Most cards
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	809 have hardware scaling support, use the <CODE>-vo xv</CODE> output for them,
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	810 or <CODE>-vo xmga</CODE> for Matroxes.</P>
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	811
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	812 <P>The problem is that most cards' driver doesn't support hardware acceleration
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	813 on the second head/TV. In those cases, you see green/blue colored window
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	814 instead of the movie. This is where this driver comes in handy, but you need
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	815 powerful CPU to use software scaling. Don't use the SDL driver's software
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	816 output+scaler, it has worse image quality!</P>
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	817
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	818 <P>Software scaling is very slow, you better try changing video modes instead.
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	819 It's very simple. See the <A HREF="#dga_modelines">DGA section's modelines</A>,
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	820 and insert them into your XF86Config.</P>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	821
3290 3928aef86033 stuff I don't remember gabucino parents: 3268 diff changeset	822 <UL>
3928aef86033 stuff I don't remember gabucino parents: 3268 diff changeset	823 <LI>If you have XFree86 4.x.x - use the <CODE>-vm</CODE> option. It will
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	824 change to a resolution your movie fits in. If it doesn't:</LI>
3290 3928aef86033 stuff I don't remember gabucino parents: 3268 diff changeset	825 <LI>With XFree86 3.x.x - you have to cycle through available resolutions
3928aef86033 stuff I don't remember gabucino parents: 3268 diff changeset	826 with the <B>CTRL-ALT-plus</B> and <B>minus</B> keys.</LI>
3928aef86033 stuff I don't remember gabucino parents: 3268 diff changeset	827 </UL>
3928aef86033 stuff I don't remember gabucino parents: 3268 diff changeset	828
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	829 <P>If you can't find the modes you inserted, browse XFree86's output. Some
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	830 drivers can't use low pixelclocks that are needed for low resolution
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	831 video modes.</P>
3290 3928aef86033 stuff I don't remember gabucino parents: 3268 diff changeset	832
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	833
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	834 <H4><A NAME="vidix">2.3.1.2.12 VIDIX</A></H4>
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	835
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	836 <P>VIDIX is the abbreviation for <B>VID</B>eo <B>I</B>nterface for
d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	837 *ni<B>X</B>.<BR>
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	838 VIDIX was designed and introduced as an interface for fast user-space drivers
6583 4b7d097a9c69 big update gabucino parents: 6499 diff changeset	839 providing such video performance as mga_vid does for Matrox cards. It's
4b7d097a9c69 big update gabucino parents: 6499 diff changeset	840 also very portable.</P>
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	841
bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	842 <P>This interface was designed as an attempt to fit existing video acceleration
6583 4b7d097a9c69 big update gabucino parents: 6499 diff changeset	843 interfaces (known as mga_vid, rage128_vid, radeon_vid, pm3_vid) into a fixed scheme. It
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	844 provides highlevel interface to chips which are known as BES (BackEnd
bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	845 scalers) or OV (Video Overlays). It doesn't provide lowlevel interface to
bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	846 things which are known as graphics servers. (I don't want to compete with X11
bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	847 team in graphics mode switching). I.e. main goal of this interface is to
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	848 maximize the speed of video playback.</P>
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	849
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	850 <H4>USAGE</H4>
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	851
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	852 <UL>
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	853 <LI>You can use standalone video output driver: <CODE>-vo xvidix</CODE><BR>
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	854 This driver was developed as X11's front end to VIDIX technology. It
8029 6ccd72982b88 Document xvidix pixmap corruption issue and known workarounds. ranma parents: 8021 diff changeset	855 requires X server and can work only under X server. Note that, as it
6ccd72982b88 Document xvidix pixmap corruption issue and known workarounds. ranma parents: 8021 diff changeset	856 directly accesses the hardware and circumvents the X driver, pixmaps
6ccd72982b88 Document xvidix pixmap corruption issue and known workarounds. ranma parents: 8021 diff changeset	857 cached in the graphics card's memory may be corrupted. You can prevent
6ccd72982b88 Document xvidix pixmap corruption issue and known workarounds. ranma parents: 8021 diff changeset	858 this by limiting the amount of video memory used by X with the XF86Config
6ccd72982b88 Document xvidix pixmap corruption issue and known workarounds. ranma parents: 8021 diff changeset	859 option "VideoRam" in the device section. You should set this to the amount
6ccd72982b88 Document xvidix pixmap corruption issue and known workarounds. ranma parents: 8021 diff changeset	860 of memory installed on your card minus 4MB. If you have less than 8MB of
6ccd72982b88 Document xvidix pixmap corruption issue and known workarounds. ranma parents: 8021 diff changeset	861 video ram, you can use the option "XaaNoPixmapCache" in the screen section
6ccd72982b88 Document xvidix pixmap corruption issue and known workarounds. ranma parents: 8021 diff changeset	862 instead.</LI>
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	863 <LI>You can use VIDIX subdevice which was applied to several video output
bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	864 drivers, such as:<BR>
7015 72059027f953 Applied patch by Andras Mohari <mayday at varoshaza nagyatad hu> in a diego parents: 6998 diff changeset	865 <CODE>-vo vesa:vidix</CODE> (<B>Linux only</B>) and <CODE>-vo fbdev:vidix</CODE></LI>
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	866 </UL>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	867
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	868 Indeed it doesn't matter which video output driver is used with <B>VIDIX</B>.
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	869
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	870 <H4>REQUIREMENTS</H4>
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	871
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	872 <UL>
d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	873 <LI>video card should be in graphics mode (I write <B>should</B> simply
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	874 because I tested it in text mode - it works but has awful output ;) Use
bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	875 AAlib for that).<BR>
bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	876 <I>Note: Everyone can try this trick by commenting out mode switching in
bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	877 vo_vesa driver.</I></LI>
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	878 <LI>MPlayer's video output driver should know active video mode and be
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	879 able to tell to VIDIX subdevice some video characteristics of server.</LI>
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	880 </UL>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	881
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	882 I hope that probably every video output driver of MPlayer will
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	883 recognize <CODE>:vidix</CODE> subdevice.
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	884
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	885 <H4>USAGE METHODS</H4>
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	886
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	887 <P>When VIDIX is used as <B>subdevice</B> (<CODE>-vo vesa:vidix</CODE>) then
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	888 video mode configuration is performed by video output device
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	889 (<B>vo_server</B> in short). Therefore you can pass into command line of
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	890 MPlayer the same keys as for vo_server. In addition it understands
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	891 <CODE>-double</CODE> key as globally visible parameter. (I recommend using
bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	892 this key with VIDIX at least for ATI's card).<BR>
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	893 As for <CODE>-vo xvidix</CODE>: currently it recognizes the following
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	894 options: <CODE>-fs -zoom -x -y -double</CODE>.</P>
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	895
bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	896 <P>Also you can specify VIDIX's driver directly as third subargument in command
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	897 line:<BR>
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	898 <BR>
bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	899   <code>mplayer -vo xvidix:mga_vid.so -fs -zoom -double
bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	900 file.avi</code><BR>
bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	901 or<BR>
bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	902   <code>mplayer -vo vesa:vidix:radeon_vid.so -fs -zoom -double -bpp
bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	903 32 file.avi</code><BR>
bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	904 <BR>
bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	905 But it's dangerous, and you shouldn't do that. In this case given driver will
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	906 be forced and result is unpredictable (it may <B>freeze</B> your
4339 4b231f3778a6 entudjam? gabucino parents: 4223 diff changeset	907 computer). You should do that ONLY if you are absolutely sure it will work,
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	908 and MPlayer doesn't do it automatically. Please tell about it to the
4339 4b231f3778a6 entudjam? gabucino parents: 4223 diff changeset	909 developers. The Right Way is to use VIDIX without arguments to enable driver
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	910 autodetection.</P>
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	911
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	912 <P>VIDIX is very new technology and it's extremely possible that on your system
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	913 (OS=abc CPU=xyz) it won't work. In this case only solution for you it's port
bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	914 it (mainly libdha). But there is hope that it will work on those systems
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	915 where X11 does.</P>
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	916
7015 72059027f953 Applied patch by Andras Mohari <mayday at varoshaza nagyatad hu> in a diego parents: 6998 diff changeset	917 <BLOCKQUOTE>
72059027f953 Applied patch by Andras Mohari <mayday at varoshaza nagyatad hu> in a diego parents: 6998 diff changeset	918 <B>Warning: security risk</B><BR>
72059027f953 Applied patch by Andras Mohari <mayday at varoshaza nagyatad hu> in a diego parents: 6998 diff changeset	919 Unfortunately you <B>must</B> have <B>root</B> privileges to use VIDIX
72059027f953 Applied patch by Andras Mohari <mayday at varoshaza nagyatad hu> in a diego parents: 6998 diff changeset	920 due to direct hardware access. At least the <B>SUID</B> bit on the
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	921 MPlayer executable must be set.
7015 72059027f953 Applied patch by Andras Mohari <mayday at varoshaza nagyatad hu> in a diego parents: 6998 diff changeset	922 </BLOCKQUOTE>
4199 bcaf75e384d8 Added (sigh, reHTMLized;)) Nick's VIDIX patch gabucino parents: 4177 diff changeset	923
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	924 <H4>VIDEO EQUALIZER</H4>
4496 bf7ea03b1adf Vidix video equalizing (Nick's patch) gabucino parents: 4360 diff changeset	925
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	926 <P>This is a video equalizer implemented especially for VIDIX. You can use
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	927 it either with <B>1-8</B> keys as described in the man page, or
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	928 by command line arguments. MPlayer recognizes the
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	929 following options:</P>
4496 bf7ea03b1adf Vidix video equalizing (Nick's patch) gabucino parents: 4360 diff changeset	930
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	931 <DL>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	932 <DT><CODE>-brightness</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	933 <DD>Adjust <B>BRIGHTNESS</B> of video output. It's not equal to brightness
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	934 adjusting on monitor panel or on TV. It changes intensity of RGB components of
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	935 video signal from black to white screen.</DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	936
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	937 <DT><CODE>-contrast</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	938 <DD>Adjust <B>CONTRAST</B> of video output. Works in similar manner as
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	939 brightness.</DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	940
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	941 <DT><CODE>-saturation</CODE></DT>
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	942 <DD>Adjust <B>SATURATION</B> of video output. You can get grayscale
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	943 output with this option.</DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	944
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	945 <DT><CODE>-hue</CODE></DT>
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	946 <DD>Adjust <B>HUE</B> of video signal. You can get colored negative
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	947 of image with this option.</DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	948
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	949 <DT><CODE>-red_intensity</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	950 <DD>Adjust intensity of <B>RED</B> component of video signal.</DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	951
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	952 <DT><CODE>-green_intensity</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	953 <DD>Adjust intensity of <B>GREEN</B> component of video signal.</DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	954
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	955 <DT><CODE>-blue_intensity</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	956 <DD>Adjust intensity of <B>BLUE</B> component of video signal.</DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	957 </DL>
6732 8460a77203de DXR3 moved to video.html. TOC updated, added <CODE> where appropiate. diego parents: 6729 diff changeset	958
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	959 <P>Each parameter can accept values from <B>-1000</B> to <B>+1000</B>.<BR>
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	960 Default value for each parameter is <B>0</B>.</P>
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	961
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	962 <P><B>Note:</B> Not every driver provides support for each of those parameters.
6599 f20184a10258 1001 typos as found by ispell. diego parents: 6583 diff changeset	963 Currently only <B>radeon_vid.so</B> provides full support for video equalizing.
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	964 Other drivers only partly support these options.</P>
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	965
4496 bf7ea03b1adf Vidix video equalizing (Nick's patch) gabucino parents: 4360 diff changeset	966 <P><B>Examples:</B><BR>
bf7ea03b1adf Vidix video equalizing (Nick's patch) gabucino parents: 4360 diff changeset	967 <CODE>mplayer -vo vesa:vidix -brightness -300 -contrast 200
bf7ea03b1adf Vidix video equalizing (Nick's patch) gabucino parents: 4360 diff changeset	968 filename.avi</CODE><BR>
bf7ea03b1adf Vidix video equalizing (Nick's patch) gabucino parents: 4360 diff changeset	969 or<BR>
bf7ea03b1adf Vidix video equalizing (Nick's patch) gabucino parents: 4360 diff changeset	970 <CODE>mplayer -vo xvidix -red_intensity -50 -saturation 400 -hue 300
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	971 filename.vob</CODE></P>
4496 bf7ea03b1adf Vidix video equalizing (Nick's patch) gabucino parents: 4360 diff changeset	972
2956 f6b51da0a50d DOXized and applied Nick's radeon_vid patch. Nick, should I update gabucino parents: 2883 diff changeset	973
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	974 <H4><A NAME="directfb">2.3.1.2.13 DirectFB</A></H4>
7192 f771e685f3b1 Zr documentation updated plus some typos fixed. diego parents: 7138 diff changeset	975
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	976 <P><I>"DirectFB is a graphics library which was designed with embedded systems in
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	977 mind. It offers maximum hardware accelerated performance at a minimum of
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	978 resource usage and overhead."</I> - quoted from
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	979 <A HREF="http://www.directfb.org">http://www.directfb.org</A>.</P>
7192 f771e685f3b1 Zr documentation updated plus some typos fixed. diego parents: 7138 diff changeset	980
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	981 <P>I'll exclude DirectFB features from this section.</P>
7192 f771e685f3b1 Zr documentation updated plus some typos fixed. diego parents: 7138 diff changeset	982
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	983 <P>Though MPlayer is not supported as a "video provider" in DirectFB, this
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	984 output driver will enable video playback through DirectFB. It will -
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	985 of course - be accelerated, on my Matrox G400 DirectFB's speed was the
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	986 same as XVideo.</P>
4339 4b231f3778a6 entudjam? gabucino parents: 4223 diff changeset	987
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	988 <P>Always try to use the newest version of DirectFB. You can use DirectFB
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	989 options on the command line, using the <CODE>-dfbopts</CODE> option.
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	990 Layer selection can be done by the subdevice method, e.g.: <CODE>-vo
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	991 directfb:2</CODE> (layer -1 is default: autodetect)</P>
4339 4b231f3778a6 entudjam? gabucino parents: 4223 diff changeset	992
7367 5b0baab4c4fd Numbering corrected. diego parents: 7281 diff changeset	993
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	994 <H4><A NAME="dfbmga">2.3.1.2.14 DirectFB/Matrox (dfbmga)</A></H4>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	995
8332 8368a516019e small updates, ATI TV-out, -vo directx:noaccel diego parents: 8260 diff changeset	996 <P>Please read the <A HREF="#directfb">main DirectFB section</A> for general
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	997 informations.</P>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	998
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	999 <P>This video output driver will enable CRTC2 (on the second head) on the
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1000 Matrox G400 card, displaying video <B>independently</B> of the first head.</P>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1001
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1002 <P>Instructions on how to make it work can be found here:
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1003 <A HREF="http://www.sci.fi/~syrjala/directfb/readme.txt">http://www.sci.fi/~syrjala/directfb/readme.txt</A></P>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1004
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1005 <P>Note: we haven't been able to make this work, but others did. Anyway,
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1006 porting of the CRTC2 code to <B>mga_vid</B> is underway.</P>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1007
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1008
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1009 <H4><A NAME="mpegdec">2.3.1.3 MPEG decoders</A></H4>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1010
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1011 <H4><A NAME="dvb">2.3.1.3.1 DVB</A></H4>
6729 62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1012
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	1013 <P>MPlayer supports cards with the Siemens DVB chipset from vendors like
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1014 Siemens, Technotrend, Galaxis or Hauppauge. The latest DVB drivers are
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1015 available from the <A HREF="http://www.linuxtv.org">Linux TV site</A>. If you
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1016 want to do software transcoding you should have at least a 1GHz CPU.</P>
6729 62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1017
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1018 <P>Configure should detect your DVB card. If it did not, force detection with
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1019
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1020 <PRE>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1021 ./configure --enable-dvb
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1022 </PRE>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1023
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1024 <P>If you have ost headers at a non-standard path, set the path with</P>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1025
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1026 <PRE>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1027 ./configure --with-extraincdir=<DVB source directory>/ost/include
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1028 </PRE>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1029
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1030 <P>Then compile and install as usual.</P>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1031
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	1032 <H4>USAGE</H4>
6732 8460a77203de DXR3 moved to video.html. TOC updated, added <CODE> where appropiate. diego parents: 6729 diff changeset	1033
6729 62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1034 <P>Hardware decoding (playing standard MPEG1/2 files) can be done with this
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1035 command:</P>
6729 62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1036
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1037 <PRE>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1038 mplayer -ao mpegpes -vo mpegpes file.mpg\|vob
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1039 </PRE>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1040
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1041 <P>Software decoding or transcoding different formats to MPEG1 can be achieved
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1042 using a command like this:</P>
6729 62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1043
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1044 <PRE>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1045 mplayer -ao mpegpes -vo mpegpes -vop lavc yourfile.ext
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1046 mplayer -ao mpegpes -vo mpegpes -vop fame,expand yourfile.ext
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1047 </PRE>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1048
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1049 <P>Note that DVB cards only support heights 288 and 576 for PAL or 240 and 480
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1050 for NTSC. You <B>must</B> rescale for other heights by adding
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1051 <CODE>scale=width:height</CODE> with the width and height you want to the
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1052 <CODE>-vop</CODE> option. DVB cards accept various widths, like 720, 704,
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1053 640, 512, 480, 352 etc and do hardware scaling in horizontal direction, so
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1054 you do not need to scale horizontally in most cases. For a 512x384 (aspect
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1055 4:3) DivX try:</P>
6729 62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1056
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1057 <PRE>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1058 mplayer -ao mpegpes -vo mpegpes -vop lavc,scale=512:576
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1059 </PRE>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1060
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1061 <P>If you have a widescreen movie and you do not want to scale it to full height,
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1062 you can use the <CODE>expand=w:h</CODE> plugin to add black bands. To view a
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1063 640x384 DivX, try:</P>
6729 62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1064
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1065 <PRE>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1066 mplayer -ao mpegpes -vo mpegpes -vop lavc,expand=640:576 file.avi
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1067 </PRE>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1068
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1069 <P>If your CPU is too slow for a full size 720x576 DivX, try downscaling:</P>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1070
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1071 <PRE>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1072 mplayer -ao mpegpes -vo mpegpes -vop lavc,scale=352:576 file.avi
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1073 </PRE>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1074
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1075 <P>If speed does not improve, try vertical downscaling, too:</P>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1076
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1077 <PRE>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1078 mplayer -ao mpegpes -vo mpegpes -vop lavc,scale=352:288 file.avi
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1079 </PRE>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1080
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1081 <P>For OSD and subtitles use the expand feature of the OSD plugin. So, instead
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1082 of <CODE>expand=w:h</CODE> or <CODE>expand=w:h:x:y</CODE>, use
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1083 <CODE>expand=w:h:x:y:1</CODE> (the 5th parameter <CODE>:1</CODE> at the end
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1084 will enable OSD rendering). You may want to move the image up a bit to get a
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1085 bigger black zone for subtitles. You may also want to move subtitles up, if
7076 3275af5787e0 Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, slightly diego parents: 7061 diff changeset	1086 they are outside your TV screen, use the <CODE>-subpos <0-100></CODE> switch
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1087 to adjust this (<CODE>-subpos 80</CODE> is a good choice).</P>
6729 62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1088
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1089 <P>In order to play non-25fps movies on a PAL TV or with a slow CPU, add the
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1090 <CODE>-framedrop</CODE> option.</P>
6729 62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1091
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1092 <P>To keep the aspect ratio of DivX files and get the optimal scaling parameters
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1093 (hardware horizontal scaling and software vertical scaling while keeping the
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1094 right aspect ratio), use the new dvbscale plugin:</P>
6729 62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1095
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1096 <PRE>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1097 for 3:4 TV: -vop lavc,expand=-1:576:-1:-1:1,scale=-1:0,dvbscale
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1098 for 16:9 TV: -vop lavc,expand=-1:576:-1:-1:1,scale=-1:0,dvbscale=1024
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1099 </PRE>
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1100
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	1101 <H4>FUTURE</H4>
6732 8460a77203de DXR3 moved to video.html. TOC updated, added <CODE> where appropiate. diego parents: 6729 diff changeset	1102
6729 62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1103 <P>If you have questions or want to hear feature announcements and take part in
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1104 discussions on this subject, join our
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1105 <A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-dvb">MPlayer-DVB</A>
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1106 mailing list. Please remember that the list language is English.</P>
6729 62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1107
62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1108 <P>In the future you may expect the ability to display OSD and subtitles using
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1109 the native OSD feature of DVB cards, as well as more fluent playback of
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1110 non-25fps movies and realtime transcoding between MPEG2 and MPEG4 (partial
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1111 decompression).</P>
6729 62b33bad8fca Added DVB to the HTML docs. diego parents: 6599 diff changeset	1112
4496 bf7ea03b1adf Vidix video equalizing (Nick's patch) gabucino parents: 4360 diff changeset	1113
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1114 <H4><A NAME="dxr2">2.3.1.3.2 DXR2</A></H4>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1115
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1116 <P>TODO: somebody please fill this section with information.</P>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1117
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1118
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1119 <H4><A NAME="dxr3">2.3.1.3.3 DXR3/Hollywood+</A></H4>
6732 8460a77203de DXR3 moved to video.html. TOC updated, added <CODE> where appropiate. diego parents: 6729 diff changeset	1120
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	1121 <P>MPlayer supports hardware accelerated playback with the Creative DXR3
7270 60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1122 and Sigma Designs Hollywood Plus cards. These cards both use the em8300 MPEG
60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1123 decoder chip from Sigma Designs.</P>
6732 8460a77203de DXR3 moved to video.html. TOC updated, added <CODE> where appropiate. diego parents: 6729 diff changeset	1124
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1125 <P>First of all you will need properly installed DXR3/H+ drivers, version
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1126 0.12.0 or later. You can find the drivers and installation instructions at
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1127 the <A HREF="http://dxr3.sourceforge.net/">DXR3 & Hollywood Plus for
87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1128 Linux</A> site. Configure should detect your card automatically, compilation
7270 60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1129 should go without problems.</P>
6732 8460a77203de DXR3 moved to video.html. TOC updated, added <CODE> where appropiate. diego parents: 6729 diff changeset	1130
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	1131 <H4>Usage:</H4>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	1132 <DL>
7951 32ae0a9d06aa Updated the DXR3 section to reflect command changes, prebuf replaced mswitch parents: 7937 diff changeset	1133 <DT><CODE>-vo dxr3:prebuf:sync:<device></CODE></DT>
8088 59f4133fbab5 Updated docs with DXR3 overlay info mswitch parents: 8029 diff changeset	1134 <DD><CODE>overlay</CODE> activates the overlay instead of TVOut. It requires
59f4133fbab5 Updated docs with DXR3 overlay info mswitch parents: 8029 diff changeset	1135 that you have a properly configured overlay setup to work right. The easiest
59f4133fbab5 Updated docs with DXR3 overlay info mswitch parents: 8029 diff changeset	1136 way to configure the overlay is to first run autocal. Then run mplayer with
59f4133fbab5 Updated docs with DXR3 overlay info mswitch parents: 8029 diff changeset	1137 dxr3 output and without overlay turned on, run dxr3view. In dxr3view you can
59f4133fbab5 Updated docs with DXR3 overlay info mswitch parents: 8029 diff changeset	1138 tweak the overlay settings and see the effects in realtime, perhaps this
59f4133fbab5 Updated docs with DXR3 overlay info mswitch parents: 8029 diff changeset	1139 feature will be supported by the MPlayer GUI in the future. When overlay is
59f4133fbab5 Updated docs with DXR3 overlay info mswitch parents: 8029 diff changeset	1140 properly set up you will no longer need to use dxr3view.<BR>
59f4133fbab5 Updated docs with DXR3 overlay info mswitch parents: 8029 diff changeset	1141 <CODE>prebuf</CODE> turns on prebuffering. Prebuffering is a feature
7270 60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1142 of the em8300 chip that enables it to hold more than one frame of video at
7951 32ae0a9d06aa Updated the DXR3 section to reflect command changes, prebuf replaced mswitch parents: 7937 diff changeset	1143 a time. This means that when you are running with prebuffering
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	1144 MPlayer will try to keep the video buffer filled with data at all
988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	1145 times. If you are on a slow machine MPlayer will probably use close
7270 60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1146 to, or precisely 100% of CPU. This is especially common if you play pure MPEG
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	1147 streams (like DVDs, SVCDs a.s.o.) since MPlayer will not have to
7270 60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1148 reencode it to MPEG it will fill the buffer very fast.<BR>
60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1149 With prebuffering video playback is <B>much</B> less sensitive to other
60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1150 programs hogging the CPU, it will not drop frames unless applications hog
60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1151 the CPU for a long time.<BR>
7951 32ae0a9d06aa Updated the DXR3 section to reflect command changes, prebuf replaced mswitch parents: 7937 diff changeset	1152 When running without prebuffering the em8300 is much more sensitive to CPU
7969 9ec3f2b9a87f <B>MPlayer</B> --> MPlayer diego parents: 7951 diff changeset	1153 load, so it is highly suggested that you turn on MPlayer's
7951 32ae0a9d06aa Updated the DXR3 section to reflect command changes, prebuf replaced mswitch parents: 7937 diff changeset	1154 <CODE>-framedrop</CODE> option to avoid further loss of sync.<BR>
32ae0a9d06aa Updated the DXR3 section to reflect command changes, prebuf replaced mswitch parents: 7937 diff changeset	1155 <CODE>sync</CODE> will turn on the new sync-engine. This is currently an
32ae0a9d06aa Updated the DXR3 section to reflect command changes, prebuf replaced mswitch parents: 7937 diff changeset	1156 experimental feature. With the sync feature turned on the em8300's internal
32ae0a9d06aa Updated the DXR3 section to reflect command changes, prebuf replaced mswitch parents: 7937 diff changeset	1157 clock will be monitored at all times, if it starts to deviate from MPlayer's
32ae0a9d06aa Updated the DXR3 section to reflect command changes, prebuf replaced mswitch parents: 7937 diff changeset	1158 clock it will be reset causing the em8300 to drop any frames that are lagging
32ae0a9d06aa Updated the DXR3 section to reflect command changes, prebuf replaced mswitch parents: 7937 diff changeset	1159 behind.<BR>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	1160 <CODE><device></CODE> = device number to use if you have more than one
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	1161 em8300 card.
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	1162 <BR>
8021 66c0515d234f Cleaned up the DXR3 section (lots of old stuff which was no longer mswitch parents: 7969 diff changeset	1163 Any of these options may be left out.<BR>
66c0515d234f Cleaned up the DXR3 section (lots of old stuff which was no longer mswitch parents: 7969 diff changeset	1164 <CODE>:prebuf:sync</CODE> seems to work great when playing DivX etc, even on
66c0515d234f Cleaned up the DXR3 section (lots of old stuff which was no longer mswitch parents: 7969 diff changeset	1165 AMD's CPUs. But people have reported problems using these options when playing
66c0515d234f Cleaned up the DXR3 section (lots of old stuff which was no longer mswitch parents: 7969 diff changeset	1166 normal MPEGs. You might want to try running without any options first, if you
66c0515d234f Cleaned up the DXR3 section (lots of old stuff which was no longer mswitch parents: 7969 diff changeset	1167 have sync problems give <CODE>:sync</CODE> a try.</DD>
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	1168
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	1169 <DT><CODE>-ao oss:/dev/em8300_ma-X</CODE></DT>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	1170 <DD>For audio output, where <CODE>X</CODE> is the device number
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	1171 (0 if one card).</DD>
0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	1172
7270 60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1173 <DT><CODE>-aop list=resample:fout=xxxxx</CODE></DT>
60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1174 <DD>The em8300 cannot play back samplerates lower than 44100Hz. If the sample
60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1175 rate is below 44100Hz select either 44100Hz or 48000Hz depending on which
60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1176 one matches closest. I.e. if the movie uses 22050Hz use 44100Hz as
60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1177 44100 / 2 = 22050, if it is 24000Hz use 48000Hz as 48000 / 2 = 24000 and so
60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1178 on. This does not work with digital audio output (<CODE>-ac hwac3</CODE>).</DD>
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	1179
7270 60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1180 <DT><CODE>-vop lavc/fame</CODE></DT>
60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1181 <DD>To watch non-MPEG content on the em8300 (i.e. DivX or RealVideo) you have
60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1182 to specify an MPEG1 video filter such as libavcodec (lavc) or libfame
60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1183 (fame). At the moment lavc is both faster and gives better image quality, it
60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1184 is suggested that you use that unless you have problems with it. See the man
7951 32ae0a9d06aa Updated the DXR3 section to reflect command changes, prebuf replaced mswitch parents: 7937 diff changeset	1185 page for further info about <CODE>-vop lavc/fame</CODE>.<BR>
32ae0a9d06aa Updated the DXR3 section to reflect command changes, prebuf replaced mswitch parents: 7937 diff changeset	1186 Using lavc is highly recommended. Currently there is no way of setting the
32ae0a9d06aa Updated the DXR3 section to reflect command changes, prebuf replaced mswitch parents: 7937 diff changeset	1187 fps of the em8300 which means that it is fixed to 29.97fps. Because of this
8021 66c0515d234f Cleaned up the DXR3 section (lots of old stuff which was no longer mswitch parents: 7969 diff changeset	1188 it is highly recommended that you use <CODE>-vop lavc=<quality>:25</CODE>,
66c0515d234f Cleaned up the DXR3 section (lots of old stuff which was no longer mswitch parents: 7969 diff changeset	1189 especially if you are using prebuffering. Then why 25 and not 29.97? Well,
66c0515d234f Cleaned up the DXR3 section (lots of old stuff which was no longer mswitch parents: 7969 diff changeset	1190 the thing is that when you use 29.97 the picture becomes a bit jumpy. The
66c0515d234f Cleaned up the DXR3 section (lots of old stuff which was no longer mswitch parents: 7969 diff changeset	1191 reason for this is unknown to us. If you set it to somewhere between 25 and
66c0515d234f Cleaned up the DXR3 section (lots of old stuff which was no longer mswitch parents: 7969 diff changeset	1192 27 the picture becomes stable. For now all we can do is accept this for a
66c0515d234f Cleaned up the DXR3 section (lots of old stuff which was no longer mswitch parents: 7969 diff changeset	1193 fact.</DD>
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1194
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1195 <DT><CODE>-vop lavc,expand=-1:-1:-1:-1:1</CODE></DT>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1196 <DD>Altough the DXR3 driver can put some OSD onto the MPEG1/2/4 video,
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1197 it has much lower quality than MPlayer's traditional OSD, and has several
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1198 refresh problems as well. The command line above will firstly convert the
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1199 input video to MPEG4 (this is mandatory, sorry), then apply an expand
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1200 filter which won't expand anything (-1: default), but apply the normal OSD
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1201 onto the picture (that's what the "1" at the end does).</DD>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1202
7270 60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1203 <DT><CODE>-ac hwac3</CODE></DT>
60a3b83b73bf DXR3 docs updated. Patch by David Holm <david@realityrift.com>, further diego parents: 7192 diff changeset	1204 <DD>The em8300 supports playing back AC3 audio (surround sound) through the
7640 427935644581 updates, fixes gabucino parents: 7454 diff changeset	1205 digital audio output of the card. See the <CODE>-ao oss</CODE> option
427935644581 updates, fixes gabucino parents: 7454 diff changeset	1206 above, it must be used to specify the DXR3's output instead of
427935644581 updates, fixes gabucino parents: 7454 diff changeset	1207 a soundcard. Also read <A HREF="codecs.html#hardware_ac3">hardware AC3</A>
427935644581 updates, fixes gabucino parents: 7454 diff changeset	1208 section for further information on AC3.</DD>
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	1209 </DL>
6732 8460a77203de DXR3 moved to video.html. TOC updated, added <CODE> where appropiate. diego parents: 6729 diff changeset	1210
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	1211 <H4>MPEG1, MPEG2, VCD and DVD Notes</H4>
6732 8460a77203de DXR3 moved to video.html. TOC updated, added <CODE> where appropiate. diego parents: 6729 diff changeset	1212
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1213 <P>In some instances, subtitles may not appear properly in sync with the A/V
8021 66c0515d234f Cleaned up the DXR3 section (lots of old stuff which was no longer mswitch parents: 7969 diff changeset	1214 stream when using hardware decoding. This is a known bug. The em8300 will
66c0515d234f Cleaned up the DXR3 section (lots of old stuff which was no longer mswitch parents: 7969 diff changeset	1215 also improperly handle subtitles that are too big, and may hang for a second
66c0515d234f Cleaned up the DXR3 section (lots of old stuff which was no longer mswitch parents: 7969 diff changeset	1216 or two. At this time, the only workaround is to use <CODE>-vop lavc</CODE>
66c0515d234f Cleaned up the DXR3 section (lots of old stuff which was no longer mswitch parents: 7969 diff changeset	1217 when viewing DVDs with subtitles. When running with <CODE>-vop lavc</CODE>
66c0515d234f Cleaned up the DXR3 section (lots of old stuff which was no longer mswitch parents: 7969 diff changeset	1218 MPlayer will reencode video to MPEG (even if it already is MPEG). This means
66c0515d234f Cleaned up the DXR3 section (lots of old stuff which was no longer mswitch parents: 7969 diff changeset	1219 that it will need more CPU power, and you might loose some picture quality.</P>
6732 8460a77203de DXR3 moved to video.html. TOC updated, added <CODE> where appropiate. diego parents: 6729 diff changeset	1220
8460a77203de DXR3 moved to video.html. TOC updated, added <CODE> where appropiate. diego parents: 6729 diff changeset	1221
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1222 <H4><A NAME="other">2.3.1.4 Other visualization hardware</A></H4>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1223
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1224 <H4><A NAME="zr">2.3.1.4.1 Zr</A></H4>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1225
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1226 <P>This is a display-driver (<CODE>-vo zr</CODE>) for a number of MJPEG
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1227 capture/playback cards (tested for DC10+ and Buz, and it should work for the
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1228 LML33 and the original DC10). The driver works by encoding the frame to jpeg
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1229 and then sending it to the card. For the jpeg encoding <B>libavcodec</B> is
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1230 used, and required. With the special <I>cinerama</I> mode, you can watch
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1231 movies in true wide screen provided that you have two beamers and two
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1232 MJPEG cards. Depending on resolution and quality settings, this driver
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1233 may require a lot of CPU power, remember to specify <CODE>-framedrop</CODE>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1234 if your machine is too slow. Note: My AMD K6-2 350MHz is (with <CODE>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1235 -framedrop</CODE>) quite adequate for watching VCD sized material and
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1236 downscaled movies.
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1237
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1238 <P>This driver talks to the kernel driver available at
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1239 <A HREF="http://mjpeg.sourceforge.net">http://mjpeg.sourceforge.net</A>, so
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1240 you must get it working first. The presence of an MJPEG card is autodetected
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1241 by the configure script, if autodetection fails, force detection with
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1242
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1243 <PRE>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1244 ./configure --enable-zr
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1245 </PRE>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1246
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1247 <P>The output can be controlled by several options, a long description of the
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1248 options can be found in the man page, a short list of options can be
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1249 viewed by running
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1250
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1251 <PRE>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1252 mplayer -zrhelp
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1253 </PRE>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1254
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1255 <P>Things like scaling and the OSD (on screen display) are not handled by
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1256 this driver but can be done using the video filters. For example,
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1257 suppose that you have a movie with a resolution of <CODE>512x272</CODE> and
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1258 you want to view it fullscreen on your DC10+. There are three main
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1259 possibilities, you may scale the movie to a width of <CODE>768</CODE>,
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1260 <CODE>384</CODE> or <CODE>192</CODE>. For performance and quality reasons,
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1261 I would choose to scale the movie to <CODE>384x204</CODE> using the fast
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1262 bilinear software scaler. The commandline is
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1263
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1264 <PRE>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1265 mplayer -vo zr -sws 0 -vop scale=384:204 movie.avi
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1266 </PRE>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1267
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1268 <P>Cropping can be done by the <CODE>crop</CODE> filter and by
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1269 this driver itself. Suppose that a movie is too wide for display on your
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1270 Buz and that you want to use <CODE>-zrcrop</CODE> to make the movie less
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1271 wide, the you would issue the following command
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1272
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1273 <PRE>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1274 mplayer -vo zr -zrcrop 720x320+80+0 benhur.avi
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1275 </PRE>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1276
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1277 if you want to use the <CODE>crop</CODE> filter, you would do
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1278
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1279 <PRE>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1280 mplayer -vo zr -vop crop=720:320:80:0 benhur.avi
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1281 </PRE>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1282
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1283 <P>Extra occurances of <CODE>-zrcrop</CODE> invoke <I>cinerama</I> mode, i.e.
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1284 you can distribute the movie over several TV's or beamers to create a larger
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1285 screen. Suppose you have two beamers. The left one is connected to your Buz
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1286 at <CODE>/dev/video1</CODE> and the right one is connected to your DC10+ at
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1287 <CODE>/dev/video0</CODE>. The movie has a resolution of <CODE>704x288</CODE>.
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1288 Suppose also that you want the right beamer in black and white and that
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1289 the right beamer should have jpeg frames at quality <CODE>10</CODE>,
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1290 then you would issue the following command
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1291
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1292 <PRE>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1293 mplayer -vo zr -zrdev /dev/video0 -zrcrop 352x288+352+0 -zrxdoff 0 -zrbw \
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1294 -zrcrop 352x288+0+0 -zrdev /dev/video1 -zrquality 10 movie.avi
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1295 </PRE>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1296
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1297 <P>You see that the options appearing before the second <CODE>-zrcrop</CODE>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1298 only apply to the DC10+ and that the options after the second
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1299 <CODE>-zrcrop</CODE> apply to the Buz. The maximum number of MJPEG cards
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1300 participating in <I>cinerama</I> is four, so you can buid a <CODE>2x2</CODE>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1301 vidiwall.</P>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1302
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1303 <P>Finally an important remark: Do not start or stop XawTV on the playback
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1304 device during playback, it will crash your computer. It is, however, fine to
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1305 <B>FIRST</B> start XawTV, <B>THEN</B> start MPlayer, wait for
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1306 MPlayer to finish and <B>THEN</B> stop XawTV.</P>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	1307
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	1308
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1309 <H4><A NAME="blinken">2.3.1.4.2 Blinkenlights</A></H4>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1310
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1311 <P>This driver is capable of playback using the Blinkenlights UPD protocol.
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1312 If you don't know what Blinkenlights is, you don't need this driver.</P>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1313
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1314
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1315 <H4><A NAME="tv-out">2.3.1.5 TV-out support</A></H4>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1316
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1317
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1318 <H4><A NAME="tv-out_matrox">2.3.1.5.1 Matrox G400 cards</A></H4>
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	1319
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1320 <P>Under Linux you have 2 methods to get G400 TV out working:</P>
5116 20bf56a828d1 "nememlex" --Gabucino, 2002 arpi parents: 4982 diff changeset	1321
7377 2c13297f0b80 G450/G550 TV-out gabucino parents: 7367 diff changeset	1322 <P><B>IMPORTANT:</B> for Matrox G450/G550 TV-out instructions, please see the
2c13297f0b80 G450/G550 TV-out gabucino parents: 7367 diff changeset	1323 next section!</P>
2309 3128b9d8b4ea New section: Matrox TVout - method 2 gabucino parents: 2206 diff changeset	1324
2486 d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1325 <UL>
d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1326 <LI><B>XFree86</B>: using the driver and the HAL module, available from
d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1327 <A HREF="http://www.matrox.com">Matrox's site</A>. This will give you X on
d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1328 the TV.<BR> <B>This method doesn't give you accelerated playback</B> as
d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1329 under Windoze! The second head has only YUV framebuffer, the <I>BES</I>
d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1330 (Back End Scaler, the YUV scaler on G200/G400/G450/G550 cards) doesn't work
7061 33624384dd7b Typos, cosmetics and a tag closed. diego parents: 7047 diff changeset	1331 on it! The Windows driver somehow works around this, probably by using the
2486 d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1332 3D engine to zoom, and the YUV framebuffer to display the zoomed
2848 33c32f3d9f1f many small updates, fixes (some/more to be completed soon) gabucino parents: 2747 diff changeset	1333 image. If you really want to use X, use the <CODE>-vo x11 -fs -zoom</CODE>
6599 f20184a10258 1001 typos as found by ispell. diego parents: 6583 diff changeset	1334 options, but it will be <B>SLOW</B>, and has <B>Macrovision</B> copy protection
4177 cab4ac1467e4 many small updates gabucino parents: 3988 diff changeset	1335 enabled (you can "workaround" Macrovision using
cab4ac1467e4 many small updates gabucino parents: 3988 diff changeset	1336 <A HREF="http://avifile.sourceforge.net/mgamacro.pl">this</A> perl
cab4ac1467e4 many small updates gabucino parents: 3988 diff changeset	1337 script.</LI>
2486 d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1338 <LI><B>Framebuffer</B>: using the <B>matroxfb modules</B> in the 2.4 kernels.
d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1339 2.2 kernels don't have the TVout feature in them, thus unusable for this.
3030 1dbc569b6528 more fix/update gabucino parents: 3027 diff changeset	1340 You have to enable ALL matroxfb-specific feature during compilation (except
5713 634fbb5dd181 I2C is also needed for G400 tvout gabucino parents: 5378 diff changeset	1341 MultiHead), and compile them into <B>modules</B>! You'll also need I2C
634fbb5dd181 I2C is also needed for G400 tvout gabucino parents: 5378 diff changeset	1342 enabled.
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	1343 <OL>
2486 d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1344 <LI>
d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1345 Enter <CODE>TVout/matroxset</CODE> and type <CODE>make</CODE>. Install
d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1346 <CODE>matroxset</CODE> into somewhere in your PATH.</LI>
d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1347 <LI>
d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1348 If you don't have <CODE>fbset</CODE> installed, enter
d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1349 <CODE>TVout/fbset</CODE> and type <CODE>make</CODE>. Install
d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1350 <CODE>fbset</CODE> into somewhere in your PATH.</LI>
d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1351 <LI>
7814 988498df1996 <B>MPlayer</B> ---> MPlayer diego parents: 7793 diff changeset	1352 Then enter into the <CODE>TVout/</CODE> directory in the MPlayer
2486 d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1353 source, and execute <CODE>./modules</CODE> as root. Your text-mode console
d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1354 will enter into framebuffer mode (no way back!).</LI>
7454 a8ae3f53eb14 matroxtv script was modified gabucino parents: 7377 diff changeset	1355 <LI>Next, EDIT and run the <CODE>./matroxtv</CODE> script. This will present you
2486 d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1356 to a very simple menu. Press <B>2</B> and <B>ENTER</B>. Now you should
7454 a8ae3f53eb14 matroxtv script was modified gabucino parents: 7377 diff changeset	1357 have the same picture on your monitor, and TV. If
a8ae3f53eb14 matroxtv script was modified gabucino parents: 7377 diff changeset	1358 the TV (PAL by default) picture has some weird stripes on it, the script wasn't able to
a8ae3f53eb14 matroxtv script was modified gabucino parents: 7377 diff changeset	1359 set the resolution correctly (to 640x512 by default). Try other
a8ae3f53eb14 matroxtv script was modified gabucino parents: 7377 diff changeset	1360 resolutions from the menu and/or experiment with fbset.</LI>
7099 0b70f3dc34eb Applied patch by Andras Mohari <mayday@varoshaza.nagyatad.hu>, with some diego parents: 7076 diff changeset	1361 </OL>
2486 d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1362
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	1363 <P>Yoh. Next task is to make the cursor on tty1 (or whatever) to disappear,
2486 d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1364 and turn off screen blanking. Execute the following commands:</P>
d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1365
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	1366 <P><CODE>echo -e '\033[?25l'</CODE> or <CODE>setterm -cursor off<BR>
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	1367 setterm -blank 0</CODE></P>
2486 d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1368
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	1369 <P>You possibly want to put the above into a script, and also clear
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1370 the screen.. To turn the cursor back:<BR><CODE>echo -e '\033[?25h'</CODE>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	1371 or <CODE>setterm -cursor on</CODE></P>
2486 d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1372
d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1373 <P>Yeah kewl. Start movie playing with <CODE>mplayer -vo mga -fs -screenw 640
d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1374 -screenh 512 <filename></CODE><BR>
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1375 (if you use X, now change to matroxfb with for example CTRL-ALT-F1!)<BR>
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	1376 Change 640x512 if you set the resolution to other.<BR>
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	1377 <B>Enjoy the ultra-fast ultra-featured Matrox TV output (better than Xv)!</B></P>
2486 d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1378 </LI>
d4f398ef37aa rewritten matrox tvout section gabucino parents: 2472 diff changeset	1379 </UL>
2309 3128b9d8b4ea New section: Matrox TVout - method 2 gabucino parents: 2206 diff changeset	1380
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1381 <H4>Building a Matrox TV-out cable</H4>
2309 3128b9d8b4ea New section: Matrox TVout - method 2 gabucino parents: 2206 diff changeset	1382
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1383 <P>This information was contributed by <B>R�cz Bal�zs</B>. Of course
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1384 no one takes any responsibility, nor guarantee for any damage caused
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1385 by this documentation.</P>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1386
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1387 <P>The CRTC2 connector's fourth pin is the composite video signal. The ground
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1388 are the sixth, seventh and eighth pins.</P>
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1389
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1390
1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1391 <H4><A NAME="tv-out_matrox_g450">2.3.1.5.2 Matrox G450/G550 cards</A></H4>
7377 2c13297f0b80 G450/G550 TV-out gabucino parents: 7367 diff changeset	1392
2c13297f0b80 G450/G550 TV-out gabucino parents: 7367 diff changeset	1393 <P>TV output support for these cards has only been recently introduced, and is
2c13297f0b80 G450/G550 TV-out gabucino parents: 7367 diff changeset	1394 not yet in the mainstream kernel. Currently the <B>mga_vid</B> module
2c13297f0b80 G450/G550 TV-out gabucino parents: 7367 diff changeset	1395 can't be used AFAIK, because the G450/G550 driver works only in one
2c13297f0b80 G450/G550 TV-out gabucino parents: 7367 diff changeset	1396 configuration: the first CRTC chip (with much more features) on the first
2c13297f0b80 G450/G550 TV-out gabucino parents: 7367 diff changeset	1397 display (on monitor), and the second CRTC (no <B>BES</B> - for explanation
2c13297f0b80 G450/G550 TV-out gabucino parents: 7367 diff changeset	1398 on BES, please see the G400 section above) on TV. So you can only use
7969 9ec3f2b9a87f <B>MPlayer</B> --> MPlayer diego parents: 7951 diff changeset	1399 MPlayer's <I>fbdev</I> output driver at the present.</P>
7377 2c13297f0b80 G450/G550 TV-out gabucino parents: 7367 diff changeset	1400
2c13297f0b80 G450/G550 TV-out gabucino parents: 7367 diff changeset	1401 <P>The first CRTC can't be routed to the second head currently.
2c13297f0b80 G450/G550 TV-out gabucino parents: 7367 diff changeset	1402 The author of the kernel matroxfb driver - Petr Vandrovec - will maybe make
2c13297f0b80 G450/G550 TV-out gabucino parents: 7367 diff changeset	1403 support for this, by displaying the first CRTC's output onto both of the
2c13297f0b80 G450/G550 TV-out gabucino parents: 7367 diff changeset	1404 heads at once, as currently recommended for G400, see the section above.</P>
2c13297f0b80 G450/G550 TV-out gabucino parents: 7367 diff changeset	1405
2c13297f0b80 G450/G550 TV-out gabucino parents: 7367 diff changeset	1406 <P>The necessary kernel patch and the detailed howto is downloadable from
7937 33e4345d6dd6 URLs corrected. diego parents: 7814 diff changeset	1407 <A HREF="http://www3.sympatico.ca/dan.eriksen/matrox_tvout/">http://www3.sympatico.ca/dan.eriksen/matrox_tvout/</A></P>
7377 2c13297f0b80 G450/G550 TV-out gabucino parents: 7367 diff changeset	1408
2c13297f0b80 G450/G550 TV-out gabucino parents: 7367 diff changeset	1409
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1410 <H4><A NAME="tv-out_ati">2.3.1.5.3 ATI cards</A></H4>
2206 0e8e8fed492e ATI TVout stuff added (from Nick Kurshev) gabucino parents: 2131 diff changeset	1411
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	1412 <H5>PREAMBLE</H5>
4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	1413
4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	1414 <P>Currently ATI doesn't want to support any of its TV-out chips under Linux,
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1415 because of their licensed Macrovision technology.</P>
6583 4b7d097a9c69 big update gabucino parents: 6499 diff changeset	1416
7047 4f87cd0f642f Converted the docs to use proper headings tags. diego parents: 7015 diff changeset	1417 <H5>ATI CARDS TV-OUT STATUS ON LINUX</H5>
2206 0e8e8fed492e ATI TVout stuff added (from Nick Kurshev) gabucino parents: 2131 diff changeset	1418
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	1419 <UL>
8332 8368a516019e small updates, ATI TV-out, -vo directx:noaccel diego parents: 8260 diff changeset	1420 <LI><B>ATI Mach64</B>: Supported by
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1421 <A HREF="http://gatos.sf.net">gatos</A>.</LI>
8332 8368a516019e small updates, ATI TV-out, -vo directx:noaccel diego parents: 8260 diff changeset	1422 <LI><B>ASIC Radeon VIVO</B>: Supported by
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1423 <A HREF="http://gatos.sf.net">gatos</A>.</LI>
8332 8368a516019e small updates, ATI TV-out, -vo directx:noaccel diego parents: 8260 diff changeset	1424 <LI><B>Radeon</B> and <B>Rage128</B>: Supported by MPlayer!
6998 83a386e88f9e Applied patch by Andras Mohari <mayday at varoshaza . nagyatad . hu> diego parents: 6981 diff changeset	1425 Check <a href="#vesa">VESA driver</a> and <A HREF="#vidix">VIDIX</A>
6960 87deea511b1f continuing paragraph reformatting gabucino parents: 6906 diff changeset	1426 sections.</LI>
8332 8368a516019e small updates, ATI TV-out, -vo directx:noaccel diego parents: 8260 diff changeset	1427 <LI><B>Rage Mobility P/M, Radeon, Rage 128, Mobility M3/M4</B>: Supported by
8368a516019e small updates, ATI TV-out, -vo directx:noaccel diego parents: 8260 diff changeset	1428 <A HREF="http://www.stud.uni-hamburg.de/users/lennart/projects/atitvout/">
8368a516019e small updates, ATI TV-out, -vo directx:noaccel diego parents: 8260 diff changeset	1429 atitvout</A>.
6435 d0d74f9d8d4a Background now set by CSS, added doctype and charset. diego parents: 6393 diff changeset	1430 </UL>
2206 0e8e8fed492e ATI TVout stuff added (from Nick Kurshev) gabucino parents: 2131 diff changeset	1431
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	1432 <P>On other cards, just use the <a href="#vesa">VESA driver</a>, without
916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	1433 VIDIX. Powerful CPU is needed, though.</P>
2206 0e8e8fed492e ATI TVout stuff added (from Nick Kurshev) gabucino parents: 2131 diff changeset	1434
6583 4b7d097a9c69 big update gabucino parents: 6499 diff changeset	1435 <P>Only thing you need to do - <B>have TV connector plugged in before
4b7d097a9c69 big update gabucino parents: 6499 diff changeset	1436 booting your PC</B> since video BIOS initializes itself only once during
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	1437 POST procedure.</P>
2206 0e8e8fed492e ATI TVout stuff added (from Nick Kurshev) gabucino parents: 2131 diff changeset	1438
2472 487f5bbb38ae link to tomi ollila's voodoo3 tvout text. if he has interest to integrate gabucino parents: 2471 diff changeset	1439
8177 1f00a3d29b20 some TOC reorder gabucino parents: 8145 diff changeset	1440 <H4><A NAME="tv-out_voodoo">2.3.1.5.4 Voodoo 3</A></H4>
2472 487f5bbb38ae link to tomi ollila's voodoo3 tvout text. if he has interest to integrate gabucino parents: 2471 diff changeset	1441
6974 916f62dd0910 Another big batch of cosmetics only. diego parents: 6960 diff changeset	1442 <P>Check <A HREF="http://www.iki.fi/too/tvout-voodoo3-3000-xfree">this URL</A>.</P>
2472 487f5bbb38ae link to tomi ollila's voodoo3 tvout text. if he has interest to integrate gabucino parents: 2471 diff changeset	1443
8260 352b654c7787 updates gabucino parents: 8177 diff changeset	1444
352b654c7787 updates gabucino parents: 8177 diff changeset	1445 <H4><A NAME="tv-out_nvidia">2.3.1.5.5 nVidia</A></H4>
352b654c7787 updates gabucino parents: 8177 diff changeset	1446
352b654c7787 updates gabucino parents: 8177 diff changeset	1447 <P>First, you MUST download the closed-source drivers from
352b654c7787 updates gabucino parents: 8177 diff changeset	1448 <A HREF="http://nvidia.com">http://nvidia.com</A>. I will not describe the
352b654c7787 updates gabucino parents: 8177 diff changeset	1449 installation and configuration process because it does not cover the
352b654c7787 updates gabucino parents: 8177 diff changeset	1450 scope of this documentation.</P>
352b654c7787 updates gabucino parents: 8177 diff changeset	1451
352b654c7787 updates gabucino parents: 8177 diff changeset	1452 <P>After XFree86, XVideo, and 3D acceleration is properly working,
352b654c7787 updates gabucino parents: 8177 diff changeset	1453 edit your card's Device section in the <CODE>XF86Config</CODE> file,
352b654c7787 updates gabucino parents: 8177 diff changeset	1454 according to the following example (adapt for your card/TV):</P>
352b654c7787 updates gabucino parents: 8177 diff changeset	1455
352b654c7787 updates gabucino parents: 8177 diff changeset	1456 <PRE>
352b654c7787 updates gabucino parents: 8177 diff changeset	1457 Section "Device"
352b654c7787 updates gabucino parents: 8177 diff changeset	1458 Identifier "GeForce"
352b654c7787 updates gabucino parents: 8177 diff changeset	1459 VendorName "ASUS"
352b654c7787 updates gabucino parents: 8177 diff changeset	1460 BoardName "nVidia GeForce2/MX 400"
352b654c7787 updates gabucino parents: 8177 diff changeset	1461 Driver "nvidia"
352b654c7787 updates gabucino parents: 8177 diff changeset	1462 #Option "NvAGP" "1"
352b654c7787 updates gabucino parents: 8177 diff changeset	1463 Option "NoLogo"
352b654c7787 updates gabucino parents: 8177 diff changeset	1464 Option "CursorShadow" "on"
352b654c7787 updates gabucino parents: 8177 diff changeset	1465
352b654c7787 updates gabucino parents: 8177 diff changeset	1466 Option "TwinView"
352b654c7787 updates gabucino parents: 8177 diff changeset	1467 Option "TwinViewOrientation" "Clone"
352b654c7787 updates gabucino parents: 8177 diff changeset	1468 Option "MetaModes" "1024x768,640x480"
352b654c7787 updates gabucino parents: 8177 diff changeset	1469 Option "ConnectedMonitor" "CRT, TV"
352b654c7787 updates gabucino parents: 8177 diff changeset	1470 Option "TVStandard" "PAL-B"
352b654c7787 updates gabucino parents: 8177 diff changeset	1471 Option "TVOutFormat" "Composite"
352b654c7787 updates gabucino parents: 8177 diff changeset	1472
352b654c7787 updates gabucino parents: 8177 diff changeset	1473 EndSection
352b654c7787 updates gabucino parents: 8177 diff changeset	1474 </PRE>
352b654c7787 updates gabucino parents: 8177 diff changeset	1475
352b654c7787 updates gabucino parents: 8177 diff changeset	1476 <P>Of course the important thing is the TwinView part.</P>
352b654c7787 updates gabucino parents: 8177 diff changeset	1477
1612 1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	1478 </BODY>
1b011d6150c7 new, splitted, etc dox gabucino parents: diff changeset	1479 </HTML>

Mercurial > mplayer.hg

annotate DOCS/video.html @ 8334:0c9a596abe39