Gentoo Archives: gentoo-doc-cvs

From: "Joshua Saddler (nightmorph)" <nightmorph@g.o>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en: dri-howto.xml
Date: Mon, 30 Nov 2009 20:19:50
Message-Id: E1NFCid-0001w2-7s@stork.gentoo.org
1 nightmorph 09/11/30 20:19:35
2
3 Modified: dri-howto.xml
4 Log:
5 strip out all that nice AGP fastwrite stuff I wrote awhile ago. problem is it's not used on very many chipsets (only r200 and older Radeons, for example), and it is kinda risky. and it's for AGP chipsets, which are positively ancient. also made some misc. edits elsewhere.
6
7 Revision Changes Path
8 1.44 xml/htdocs/doc/en/dri-howto.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/dri-howto.xml?rev=1.44&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/dri-howto.xml?rev=1.44&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/dri-howto.xml?r1=1.43&r2=1.44
13
14 Index: dri-howto.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/dri-howto.xml,v
17 retrieving revision 1.43
18 retrieving revision 1.44
19 diff -u -r1.43 -r1.44
20 --- dri-howto.xml 6 Nov 2008 09:42:02 -0000 1.43
21 +++ dri-howto.xml 30 Nov 2009 20:19:35 -0000 1.44
22 @@ -1,19 +1,19 @@
23 <?xml version="1.0" encoding="UTF-8"?>
24 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/dri-howto.xml,v 1.43 2008/11/06 09:42:02 nightmorph Exp $ -->
25 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/dri-howto.xml,v 1.44 2009/11/30 20:19:35 nightmorph Exp $ -->
26 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
27
28 -<guide link="/doc/en/dri-howto.xml">
29 +<guide>
30
31 <title>Hardware 3D Acceleration Guide</title>
32
33 <author title="Author">
34 - <mail link="dberkholz@g.o">Donnie Berkholz</mail>
35 + <mail link="dberkholz"/>
36 </author>
37 <author title="Editor">
38 - <mail link="peesh@g.o">Jorge Paulo</mail>
39 + <mail link="peesh"/>
40 </author>
41 <author title="Editor">
42 - <mail link="nightmorph@g.o">Joshua Saddler</mail>
43 + <mail link="nightmorph"/>
44 </author>
45
46 <abstract>
47 @@ -25,8 +25,8 @@
48 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
49 <license/>
50
51 -<version>1.11</version>
52 -<date>2008-09-10</date>
53 +<version>1.12</version>
54 +<date>2009-11-30</date>
55
56 <chapter>
57 <title>Introduction</title>
58 @@ -291,111 +291,21 @@
59
60 <note>
61 FPS may be limited by your screen's refresh rate, so keep this in mind if
62 -<c>glxgears</c> reports only about 70-100 FPS. <c>games-fps/ut2004-demo</c> is a
63 -better benchmarking tool, as it can give you real-world performance results.
64 +<c>glxgears</c> reports only about 70-100 FPS. <c>games-fps/ut2004-demo</c> or
65 +other 3D games are better benchmarking tools, as they give you real-world
66 +performance results.
67 </note>
68
69 </body>
70 </section>
71 -</chapter>
72 -
73 -<chapter>
74 -<title>Tweak your performance</title>
75 <section>
76 <title>Get the most out of direct rendering</title>
77 <body>
78
79 <p>
80 -A few options may increase performance by up to 30 percent (or more) over the
81 -default. Set them in <path>/etc/X11/xorg.conf</path>. However, you will first
82 -need to check that your motherboard and video card support these options.
83 -</p>
84 -
85 -<p>
86 -First, let's see if your video card can support fast writes. We'll do this by
87 -closely inspecting the output from <c>lspci</c>. Specifically, we are looking
88 -at the "VGA compatible controller" information.
89 -</p>
90 -
91 -<pre caption="Video card check">
92 -# <i>lspci -vv</i>
93 -01:00.0 VGA compatible controller: ATI Technologies Inc Radeon Mobility M6 LY (prog-if 00 [VGA])
94 -. . .
95 -Capabilities: [58] AGP version 2.0
96 - Status: RQ=48 Iso- ArqSz=0 Cal=0 SBA+ ITACoh- GART64- HTrans- 64bit- FW+ AGP3- Rate=x1,x2,x4
97 -</pre>
98 -
99 -<p>
100 -While quite a lot of information is produced, we are looking for <b>FW</b> in
101 -the "Status" subsection of the AGP "Capabilities" section. If <b>FW+</b> is
102 -present in the "Status" line, it means the card supports fast writes. We can
103 -now check if the motherboard supports fast writes.
104 -</p>
105 -
106 -<impo>
107 -If you do not see <b>FW+</b>, but instead see <b>FW-</b>, you cannot enable
108 -fast writes in <path>xorg.conf</path>. Your card does not support fast writes.
109 -</impo>
110 -
111 -<p>
112 -Now let's make sure the motherboard supports fast writes as well. This time,
113 -look at the "Host bridge" section of your <c>lspci</c> output.
114 -</p>
115 -
116 -<pre caption="Motherboard check">
117 -# <i>lspci -vv</i>
118 -00:00.0 Host bridge: Intel Corporation 82830 830 Chipset Host Bridge (rev 02)
119 -. . .
120 -Capabilities: [a0] AGP version 2.0
121 - Status: RQ=32 Iso- ArqSz=0 Cal=0 SBA+ ITACoh- GART64- HTrans- 64bit- FW+ AGP3- Rate=x1,x2,x4
122 -</pre>
123 -
124 -<p>
125 -Again, examine the "Status" subsection of your AGP "Capabilities" section. Look
126 -for <b>FW</b>. If you see <b>FW+</b>, your motherboard supports fast writes.
127 -</p>
128 -
129 -<impo>
130 -Remember, both your video card information and your motherboard information
131 -must show the same <b>FW</b> capability. If either device shows <b>FW-</b> in
132 -"Status", you cannot enable fast writes in <path>xorg.conf</path>.
133 -</impo>
134 -
135 -<p>
136 -Assuming that all has gone well and both your motherboard and video card
137 -support fast writes, let's enable this option in
138 -<path>/etc/X11/xorg.conf</path> and get the best performance out of your
139 -hardware.
140 -</p>
141 -
142 -<pre caption="xorg.conf">
143 -Section "Device"
144 - Option "AGPMode" "4"
145 - <comment>(This increased FPS from 609 to 618.)</comment>
146 - Option "AGPFastWrite" "True"
147 - <comment>(This had no measurable effect, but it may increase instability of your computer.)</comment>
148 - <comment>(You may also need to set it in your BIOS.)</comment>
149 - Option "EnablePageFlip" "True"
150 - <comment>(This improved FPS from 618 to 702. It also is "risky" but few people have reported problems.)</comment>
151 - ...
152 -EndSection
153 -</pre>
154 -
155 -<warn>
156 -Enabling <c>AGPFastWrite</c> on a VIA chipset will very likely cause your
157 -machine to lock up. VIA chipsets do not play nicely with fast writes, so use
158 -this setting at your own risk.
159 -</warn>
160 -
161 -<note>
162 -Remember, if you want fast writes to work properly, you will have to first
163 -enable the appropriate option in your BIOS.
164 -</note>
165 -
166 -<p>
167 -If you want to set even more features, check out the <uri
168 -link="http://dri.freedesktop.org/wiki/FeatureMatrix">feature matrix</uri> on
169 -the DRI web site or the <uri
170 +If you want to set more features, for performance or other reasons, check out
171 +the <uri link="http://dri.freedesktop.org/wiki/FeatureMatrix">feature
172 +matrix</uri> on the DRI web site or the <uri
173 link="http://dri.sourceforge.net/doc/dri_driver_features.phtml">features
174 listing</uri> on Sourceforge.
175 </p>
176 @@ -475,26 +385,6 @@
177 </chapter>
178
179 <chapter>
180 -<title>Acknowledgments</title>
181 -<section>
182 -<body>
183 -
184 -<ol>
185 - <li>
186 - Christopher Webber for suggesting a troubleshooting question about changing
187 - or recompiling kernels
188 - </li>
189 - <li>
190 - Steve, for suggesting consistency between the cases of dri and DRI in
191 - XF86Config
192 - </li>
193 -</ol>
194 -
195 -</body>
196 -</section>
197 -</chapter>
198 -
199 -<chapter>
200 <title>References</title>
201 <section>
202 <body>