/[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.19 Revision 1.23
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.19 2005/01/19 14:12:38 swift Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/dri-howto.xml,v 1.23 2005/07/27 12:45:04 fox2mike 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">
16with Xorg in Gentoo Linux. 16with Xorg in Gentoo Linux.
17</abstract> 17</abstract>
18 18
19<license/> 19<license/>
20 20
21<version>1.0.8</version> 21<version>1.0.11</version>
22<date>2005-01-19</date> 22<date>2005-07-27</date>
23 23
24<chapter> 24<chapter>
25<title>Introduction</title> 25<title>Introduction</title>
26<section> 26<section>
27<title>What is hardware 3D acceleration and why do I want it?</title> 27<title>What is hardware 3D acceleration and why do I want it?</title>
133</p> 133</p>
134 134
135<pre caption="Checking your AGP chipset"> 135<pre caption="Checking your AGP chipset">
136# <i>emerge pciutils; lspci | grep AGP</i> 136# <i>emerge pciutils; lspci | grep AGP</i>
137# <i>00:01.0 PCI bridge: Intel Corp. 440BX/ZX/DX - 82443BX/ZX/DX AGP bridge (rev 03)</i> 137# <i>00:01.0 PCI bridge: Intel Corp. 440BX/ZX/DX - 82443BX/ZX/DX AGP bridge (rev 03)</i>
138<codenote>Your output may not match the above due to different hardware.</codenote> 138<comment>(Your output may not match the above due to different hardware.)</comment>
139</pre> 139</pre>
140 140
141<p> 141<p>
142If your chipset is not supported by the kernel you might have some succes by 142If your chipset is not supported by the kernel you might have some succes by
143passing <c>agp=try_unsupported</c> as a kernel parameter. This will use Intel's 143passing <c>agp=try_unsupported</c> as a kernel parameter. This will use Intel's
151</p> 151</p>
152 152
153<pre caption="Configuring the kernel"> 153<pre caption="Configuring the kernel">
154# <i>ls -l /usr/src/linux </i> 154# <i>ls -l /usr/src/linux </i>
155lrwxrwxrwx 1 root root 22 May 29 18:20 /usr/src/linux -> linux-2.4.20-gentoo-r5 155lrwxrwxrwx 1 root root 22 May 29 18:20 /usr/src/linux -> linux-2.4.20-gentoo-r5
156<codenote>Make sure /usr/src/linux links to your current kernel.</codenote> 156<comment>(Make sure /usr/src/linux links to your current kernel.)</comment>
157# <i>cd /usr/src/linux</i> 157# <i>cd /usr/src/linux</i>
158# <i>make menuconfig</i> 158# <i>make menuconfig</i>
159</pre> 159</pre>
160 160
161<pre caption="make menuconfig options"> 161<pre caption="make menuconfig options">
162Processor type and features ---&gt; 162Processor type and features ---&gt;
163&lt;*&gt; MTRR (Memory Type Range Register) support 163&lt;*&gt; MTRR (Memory Type Range Register) support
164Character devices ---&gt; 164Character devices ---&gt;
165&lt;M&gt; /dev/agpgart (AGP Support) 165&lt;M&gt; /dev/agpgart (AGP Support)
166[*] Intel 440LX/BX/GX and I815/I820/I830M/I830MP/I840/I845/I850/I860 support 166[*] Intel 440LX/BX/GX and I815/I820/I830M/I830MP/I840/I845/I850/I860 support
167<codenote>Enable your chipset instead of the above.</codenote> 167<comment>(Enable your chipset instead of the above.)</comment>
168[ ] Direct Rendering Manager (XFree86 DRI support) 168&lt; &gt; Direct Rendering Manager (XFree86 4.1.0 and higher DRI support)
169</pre> 169</pre>
170 170
171<p> 171<p>
172Make sure the Direct Rendering Manager (DRM) is <e>off</e>. The X11-DRM 172If you use a 2.4 kernel, make sure the Direct Rendering Manager (DRM) is
173package will provide its own. 173<e>off</e>. The X11-DRM package will provide its own. 2.6 kernel users should
174<e>enable</e> the Direct Rendering Manager (DRM) as the X11-DRM package
175currently does not support 2.6 kernels yet.
174</p> 176</p>
175 177
176</body> 178</body>
177</section> 179</section>
178<section> 180<section>
199<title>Install X11-DRM and configure direct rendering</title> 201<title>Install X11-DRM and configure direct rendering</title>
200<section> 202<section>
201<title>Install X11-DRM</title> 203<title>Install X11-DRM</title>
202<body> 204<body>
203 205
206<warn>
207If you are a 2.6 kernel user, skip this section and go to <uri
208link="#configure_xorg">Configure Xorg.conf</uri>.
209</warn>
210
204<pre caption="Installing X11-DRM"> 211<pre caption="Installing X11-DRM">
205# <i>emerge x11-drm</i> 212# <i>emerge x11-drm</i>
206</pre> 213</pre>
207 214
208</body> 215</body>
209</section> 216</section>
210<section> 217<section id="configure_xorg">
211<title>Configure Xorg.conf</title> 218<title>Configure Xorg.conf</title>
212<body> 219<body>
220
221<p>
222Some chipsets require you to rebuild <c>xorg-x11</c> with
223<c>USE="insecure-drivers"</c>. This applies to mach64, unichrome and savage
224chipsets on xorg-x11-6.8.2, and to mach64 and unichrome on xorg-x11-6.8.99.x.
225Savage users should not try xorg-x11-6.8.99.x as support for the savage there
226is broken.
227</p>
228
229<pre caption="Rebuilding xorg-x11">
230# <i>vim /etc/portage/package.use</i>
231<comment>(Add the following line if you use one of the abovementioned chipsets)</comment>
232x11-base/xorg-x11 insecure-drivers
233
234# <i>emerge xorg-x11</i>
235</pre>
213 236
214<p> 237<p>
215Open <path>/etc/X11/xorg.conf</path> with your favorite text editor and edit 238Open <path>/etc/X11/xorg.conf</path> with your favorite text editor and edit
216it to enable DRI and GLX. 239it to enable DRI and GLX.
217</p> 240</p>
253rendering and how good it is. 276rendering and how good it is.
254</p> 277</p>
255 278
256<pre caption="Testing rendering"> 279<pre caption="Testing rendering">
257# <i>startx</i> 280# <i>startx</i>
258<codenote>No need to load modules for your driver or agpgart, if you compiled agpgart as a module.</codenote> 281<comment>(No need to load modules for your driver or agpgart, if you compiled agpgart as a module.)</comment>
259<codenote>They will be loaded automatically.</codenote> 282<comment>(They will be loaded automatically.)</comment>
260# <i>glxinfo | grep rendering</i> 283# <i>glxinfo | grep rendering</i>
261direct rendering: Yes 284direct rendering: Yes
262<codenote>If it says "No," you don't have 3D acceleration.</codenote> 285<comment>(If it says "No," you don't have 3D acceleration.)</comment>
263# <i>glxgears</i> 286# <i>glxgears</i>
264<codenote>Test your frames per second (FPS) at the default size. The number should be </codenote> 287<comment>(Test your frames per second (FPS) at the default size. The number should be )</comment>
265<codenote>significantly higher than before installing x11-drm. Do this while the CPU is as idle as possible.</codenote> 288<comment>(significantly higher than before installing x11-drm. Do this while the CPU is as idle as possible.)</comment>
266</pre> 289</pre>
267 290
268</body> 291</body>
269</section> 292</section>
270</chapter> 293</chapter>
335<body> 358<body>
336 359
337<p> 360<p>
338The DRI project has a document about CVS compiling themselves. Please read <uri 361The DRI project has a document about CVS compiling themselves. Please read <uri
339link="http://dri.sourceforge.net/cgi-bin/moin.cgi/Building">the document</uri> 362link="http://dri.sourceforge.net/cgi-bin/moin.cgi/Building">the document</uri>
340and follow the instructions up to the <e>Installing for XFree86</e> or 363and follow the instructions up to the <e>Installing for X.org</e> part.
341<e>Installing for X.org</e> part.
342</p> 364</p>
343 365
344</body> 366</body>
345</section> 367</section>
346<section> 368<section>
364using the right version of the Linux kernel. The most recent kernels are not 386using the right version of the Linux kernel. The most recent kernels are not
365always supported. 387always supported.
366</p> 388</p>
367 389
368<p> 390<p>
369Install over your XFree86 or X.org installation. You may wish to back up xfree 391Install over your X.org installation. You may wish to back up xorg-x11.
370or xorg-x11.
371</p> 392</p>
372 393
373<pre caption="Backing up Xorg"> 394<pre caption="Backing up Xorg">
374# <i>quickpkg xorg-x11</i> 395# <i>quickpkg xorg-x11</i>
375<codenote>This backs up your Xorg-X11 package.</codenote> 396<comment>(This backs up your Xorg-X11 package.)</comment>
376# <i>make install</i> 397# <i>make install</i>
377</pre> 398</pre>
378 399
379<p> 400<p>
380Follow the "Configure Xorg" section above. 401Follow the "Configure Xorg" section above.
410</p> 431</p>
411 432
412<pre caption="xorg.conf"> 433<pre caption="xorg.conf">
413Section "Device" 434Section "Device"
414 Option "AGPMode" "4" 435 Option "AGPMode" "4"
415 <codenote>This increased FPS from 609 to 618.</codenote> 436 <comment>(This increased FPS from 609 to 618.)</comment>
416 Option "AGPFastWrite" "True" 437 Option "AGPFastWrite" "True"
417 <codenote>This had no measurable effect, but it may increase instability of your computer.</codenote> 438 <comment>(This had no measurable effect, but it may increase instability of your computer.)</comment>
418 <codenote>You may also need to set it in your BIOS.</codenote> 439 <comment>(You may also need to set it in your BIOS.)</comment>
419 Option "EnablePageFlip" "True" 440 Option "EnablePageFlip" "True"
420 <codenote>This improved FPS from 618 to 702. It also is "risky" but few people have reported problems.</codenote> 441 <comment>(This improved FPS from 618 to 702. It also is "risky" but few people have reported problems.)</comment>
421 ... 442 ...
422EndSection 443EndSection
423</pre> 444</pre>
424 445
425<p> 446<p>
437<section> 458<section>
438<title>It doesn't work. I just recompiled my kernel or switched to a new one.</title> 459<title>It doesn't work. I just recompiled my kernel or switched to a new one.</title>
439<body> 460<body>
440 461
441<p> 462<p>
442Whenever you rebuild your kernel or switch to another kernel, you'll have to 463Whenever you rebuild your kernel or switch to another kernel, you'll have to
443rebuild the kernel module. Note that you don't need to remerge xfree or 464rebuild the kernel module. Note that you don't need to remerge xorg-x11, but
444xorg-x11, but you will need to remerge x11-drm. 465you will need to remerge x11-drm.
445</p> 466</p>
446 467
447</body> 468</body>
448</section> 469</section>
449 470

Legend:
Removed from v.1.19  
changed lines
  Added in v.1.23

  ViewVC Help
Powered by ViewVC 1.1.20