/[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.29
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.29 2006/05/07 12:39:17 nightmorph 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">
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-07</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>
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, if you compiled agpgart 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>
450 <comment>(This improved FPS from 618 to 702. It also is "risky" but few people have reported problems.)</comment> 457 <comment>(This improved FPS from 618 to 702. It also is "risky" but few people have reported problems.)</comment>
451 ... 458 ...
452EndSection 459EndSection
453</pre> 460</pre>
454 461
462<warn>
463Enabling <c>AGPFastWrite</c> on a VIA chipset will very likely cause your
464machine to lock up. VIA chipsets do not play nicely with fast writes, so use
465this setting at your own risk.
466</warn>
467
468<note>
469Remember, if you want fast writes to work properly, you will have to first
470enable the appropriate option in your BIOS.
471</note>
472
473<!--
474**
475This section needs to be in eventually, but non-nvidia cards don't use
476/proc/driver at all. We need some way to get users to check and see that SBA
477and fast-writes are allowed for their hardware; that info is somewhere else in
478/proc. If you have a non-nvidia card, you can help by emailing
479nightmorph@gentoo.org with the relevant bits of your /proc so I can get this
480info into the guide. See below for where things are found on an nvidia card.
481**
482
483<p>
484A few options may increase performance by up to 30 percent (or more) over the
485default. Set them in <path>/etc/X11/xorg.conf</path>. However, you will first
486need to check that your motherboard and video card support these options.
487</p>
488
489<p>
490First, let's check the supported modes of your video cards, and see if your it
491supports fast writes. Remember to replace <c>nvidia</c> with the actual name of
492your device in <path>/proc/driver/nvidia/</path>.
493</p>
494
495<pre caption="Video card check">
496$ <i>cat /proc/driver/nvidia/agp/card</i>
497</pre>
498
499<p>
500Next, let's check out the capabilities of the motherboard:
501</p>
502
503<pre caption="Motherboard check">
504$ <i>cat /proc/driver/nvidia/agp/host-bridge</i>
505</pre>
506
507<impo>
508Remember, the modes and capabilities for your video card and motherboard must
509match for these settings to work!
510</impo>
511-->
512
455<p> 513<p>
456If you want to set even more features, check out the <uri 514If you want to set even more features, check out the <uri
457link="http://dri.freedesktop.org/wiki/FeatureMatrix">feature matrix</uri> on 515link="http://dri.freedesktop.org/wiki/FeatureMatrix">feature matrix</uri> on
458the DRI web site or the <uri 516the DRI web site or the <uri
459link="http://dri.sourceforge.net/doc/dri_driver_features.phtml">features 517link="http://dri.sourceforge.net/doc/dri_driver_features.phtml">features

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

  ViewVC Help
Powered by ViewVC 1.1.20