/[gentoo]/xml/htdocs/doc/en/dri-howto.xml
Gentoo

Diff of /xml/htdocs/doc/en/dri-howto.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.28 Revision 1.32
1<?xml version="1.0" encoding="UTF-8"?> 1<?xml version="1.0" encoding="UTF-8"?>
2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/dri-howto.xml,v 1.28 2006/02/01 11:58:34 neysx Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/dri-howto.xml,v 1.32 2006/07/31 19:37:50 jkt Exp $ -->
3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4 4
5<guide link="/doc/en/dri-howto.xml"> 5<guide link="/doc/en/dri-howto.xml">
6<title>Hardware 3D Acceleration Guide</title> 6<title>Hardware 3D Acceleration Guide</title>
7<author title="Author"> 7<author title="Author">
8<mail link="spyderous@gentoo.org">Donnie Berkholz</mail> 8<mail link="dberkholz@gentoo.org">Donnie Berkholz</mail>
9</author> 9</author>
10<author title="Editor"> 10<author title="Editor">
11<mail link="peesh@gentoo.org">Jorge Paulo</mail> 11<mail link="peesh@gentoo.org">Jorge Paulo</mail>
12</author> 12</author>
13 13
18 18
19<!-- The content of this document is licensed under the CC-BY-SA license --> 19<!-- The content of this document is licensed under the CC-BY-SA license -->
20<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 20<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
21<license/> 21<license/>
22 22
23<version>1.2</version> 23<version>1.3</version>
24<date>2006-02-01</date> 24<date>2006-05-12</date>
25 25
26<chapter> 26<chapter>
27<title>Introduction</title> 27<title>Introduction</title>
28<section> 28<section>
29<title>What is hardware 3D acceleration and why do I want it?</title> 29<title>What is hardware 3D acceleration and why do I want it?</title>
90<body> 90<body>
91 91
92<p> 92<p>
93This guide is for people who can't get direct rendering working with just Xorg. 93This guide is for people who can't get direct rendering working with just Xorg.
94X11-DRM works for 3dfx, gamma, i8x0, matrox, rage128, radeon, mach64 and sis300 94X11-DRM works for 3dfx, gamma, i8x0, matrox, rage128, radeon, mach64 and sis300
95series drivers. See the <uri link="http://dri.freedesktop.org/">DRI 95series drivers. VIA card owners should not use <c>x11-drm</c>, but should
96homepage</uri> for more info and documentation. 96instead use the DRI provided in recent kernels (&gt;2.6.13). See the <uri
97link="http://dri.freedesktop.org/">DRI homepage</uri> for more info and
98documentation.
97</p> 99</p>
98 100
99</body> 101</body>
100</section> 102</section>
101<section> 103<section>
102<title>Feedback</title> 104<title>Feedback</title>
103<body> 105<body>
104 106
105<p> 107<p>
106With suggestions, questions, etc., e-mail <mail 108With suggestions, questions, etc., e-mail <mail
107link="spyderous@gentoo.org">Donnie Berkholz</mail>. 109link="dberkholz@gentoo.org">Donnie Berkholz</mail>.
108</p> 110</p>
109 111
110</body> 112</body>
111</section> 113</section>
112</chapter> 114</chapter>
269<pre caption="Editing /etc/modules.autoload.d/kernel-2.6"> 271<pre caption="Editing /etc/modules.autoload.d/kernel-2.6">
270<comment>(Change module name as required.)</comment> 272<comment>(Change module name as required.)</comment>
271intel-agp 273intel-agp
272</pre> 274</pre>
273 275
276<note>
277If you compiled <c>agpgart</c> as a module, you will also need to add it to
278<path>/etc/modules.autoload.d/kernel-2.6</path>.
279</note>
280
274</body> 281</body>
275</section> 282</section>
276</chapter> 283</chapter>
277 284
278<chapter> 285<chapter>
280<section> 287<section>
281<title>Reboot to the new kernel</title> 288<title>Reboot to the new kernel</title>
282<body> 289<body>
283 290
284<p> 291<p>
285Reboot your computer to your new kernel. It's time to see if you have direct 292Reboot your computer to your new kernel and login as a normal user. It's time
286rendering and how good it is. 293to see if you have direct rendering and how good it is.
287</p> 294</p>
288 295
289<pre caption="Testing rendering"> 296<pre caption="Testing rendering">
290# <i>startx</i> 297$ <i>startx</i>
291<comment>(No need to load modules for your driver or agpgart, if you compiled agpgart as a module.)</comment> 298<comment>(No need to load modules for your driver or agpgart, even if you compiled them as a module.)</comment>
292<comment>(They will be loaded automatically.)</comment> 299<comment>(They will be loaded automatically.)</comment>
293# <i>glxinfo | grep rendering</i> 300$ <i>glxinfo | grep rendering</i>
294direct rendering: Yes 301direct rendering: Yes
295<comment>(If it says "No," you don't have 3D acceleration.)</comment> 302<comment>(If it says "No", you don't have 3D acceleration.)</comment>
296# <i>glxgears</i> 303$ <i>glxgears</i>
297<comment>(Test your frames per second (FPS) at the default size. The number should be )</comment> 304<comment>(Test your frames per second (FPS) at the default size. The number should be )</comment>
298<comment>(significantly higher than before installing x11-drm. Do this while the CPU is as idle as possible.)</comment> 305<comment>(significantly higher than before installing x11-drm. Do this while the CPU is as idle as possible.)</comment>
299</pre> 306</pre>
300 307
301</body> 308</body>
433<section> 440<section>
434<title>Get the most out of direct rendering</title> 441<title>Get the most out of direct rendering</title>
435<body> 442<body>
436 443
437<p> 444<p>
438A few options may increase performance by up to 30 percent (or more) over the 445A few options may increase performance by up to 30 percent (or more) over the
439default. Set them in <path>/etc/X11/xorg.conf</path>. 446default. Set them in <path>/etc/X11/xorg.conf</path>. However, you will first
447need to check that your motherboard and video card support these options.
448</p>
449
450<p>
451First, let's see if your video card can support fast writes. We'll do this by
452closely inspecting the output from <c>lspci</c>. Specifically, we are looking
453at the "VGA compatible controller" information.
454</p>
455
456<pre caption="Video card check">
457# <i>lspci -vv</i>
45801:00.0 VGA compatible controller: ATI Technologies Inc Radeon Mobility M6 LY (prog-if 00 [VGA])
459. . .
460Capabilities: [58] AGP version 2.0
461 Status: RQ=48 Iso- ArqSz=0 Cal=0 SBA+ ITACoh- GART64- HTrans- 64bit- FW+ AGP3- Rate=x1,x2,x4
462</pre>
463
464<p>
465While quite a lot of information is produced, we are looking for <b>FW</b> in
466the "Status" subsection of the AGP "Capabilities" section. If <b>FW+</b> is
467present in the "Status" line, it means the card supports fast writes. We can
468now check if the motherboard supports fast writes.
469</p>
470
471<impo>
472If you do not see <b>FW+</b>, but instead see <b>FW-</b>, you cannot enable
473fast writes in <path>xorg.conf</path>. Your card does not support fast writes.
474</impo>
475
476<p>
477Now let's make sure the motherboard supports fast writes as well. This time,
478look at the "Host bridge" section of your <c>lspci</c> output.
479</p>
480
481<pre caption="Motherboard check">
482# <i>lspci -vv</i>
48300:00.0 Host bridge: Intel Corporation 82830 830 Chipset Host Bridge (rev 02)
484. . .
485Capabilities: [a0] AGP version 2.0
486 Status: RQ=32 Iso- ArqSz=0 Cal=0 SBA+ ITACoh- GART64- HTrans- 64bit- FW+ AGP3- Rate=x1,x2,x4
487</pre>
488
489<p>
490Again, examine the "Status" subsection of your AGP "Capabilities" section. Look
491for <b>FW</b>. If you see <b>FW+</b>, your motherboard supports fast writes.
492</p>
493
494<impo>
495Remember, both your video card information and your motherboard information
496must show the same <b>FW</b> capability. If either device shows <b>FW-</b> in
497"Status", you cannot enable fast writes in <path>xorg.conf</path>.
498</impo>
499
500<p>
501Assuming that all has gone well and both your motherboard and video card
502support fast writes, let's enable this option in
503<path>/etc/X11/xorg.conf</path> and get the best performance out of your
504hardware.
440</p> 505</p>
441 506
442<pre caption="xorg.conf"> 507<pre caption="xorg.conf">
443Section "Device" 508Section "Device"
444 Option "AGPMode" "4" 509 Option "AGPMode" "4"
450 <comment>(This improved FPS from 618 to 702. It also is "risky" but few people have reported problems.)</comment> 515 <comment>(This improved FPS from 618 to 702. It also is "risky" but few people have reported problems.)</comment>
451 ... 516 ...
452EndSection 517EndSection
453</pre> 518</pre>
454 519
520<warn>
521Enabling <c>AGPFastWrite</c> on a VIA chipset will very likely cause your
522machine to lock up. VIA chipsets do not play nicely with fast writes, so use
523this setting at your own risk.
524</warn>
525
526<note>
527Remember, if you want fast writes to work properly, you will have to first
528enable the appropriate option in your BIOS.
529</note>
530
455<p> 531<p>
456If you want to set even more features, check out the <uri 532If you want to set even more features, check out the <uri
457link="http://dri.freedesktop.org/wiki/FeatureMatrix">feature matrix</uri> on 533link="http://dri.freedesktop.org/wiki/FeatureMatrix">feature matrix</uri> on
458the DRI web site or the <uri 534the DRI web site or the <uri
459link="http://dri.sourceforge.net/doc/dri_driver_features.phtml">features 535link="http://dri.sourceforge.net/doc/dri_driver_features.phtml">features

Legend:
Removed from v.1.28  
changed lines
  Added in v.1.32

  ViewVC Help
Powered by ViewVC 1.1.20