/[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.21 Revision 1.28
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.21 2005/04/06 09:39:59 neysx Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/dri-howto.xml,v 1.28 2006/02/01 11:58:34 neysx 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">
14<abstract> 14<abstract>
15This document is a guide to getting 3D acceleration working using X11-DRM 15This document is a guide to getting 3D acceleration working using X11-DRM
16with Xorg in Gentoo Linux. 16with Xorg in Gentoo Linux.
17</abstract> 17</abstract>
18 18
19<!-- The content of this document is licensed under the CC-BY-SA license -->
20<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
19<license/> 21<license/>
20 22
21<version>1.0.9</version> 23<version>1.2</version>
22<date>2005-02-14</date> 24<date>2006-02-01</date>
23 25
24<chapter> 26<chapter>
25<title>Introduction</title> 27<title>Introduction</title>
26<section> 28<section>
27<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>
61<section> 63<section>
62<title>What is DRI?</title> 64<title>What is DRI?</title>
63<body> 65<body>
64 66
65<p> 67<p>
66The Direct Rendering Infrastructure (<uri 68The <uri link="http://dri.freedesktop.org/wiki/">Direct Rendering
67link="http://dri.sourceforge.net">dri.sourceforge.net</uri>), also known as the 69Infrastructure</uri>, also known as the DRI, is a framework for allowing direct
68DRI, is a framework for allowing direct access to graphics hardware in a safe 70access to graphics hardware in a safe and efficient manner. It includes changes
69and efficient manner. It includes changes to the X server, to several client 71to the X server, to several client libraries and to the kernel. The first major
70libraries and to the kernel. The first major use for the DRI is to create fast 72use for the DRI is to create fast OpenGL implementations.
71OpenGL implementations.
72</p> 73</p>
73 74
74</body> 75</body>
75</section> 76</section>
76<section> 77<section>
87<section> 88<section>
88<title>Purpose</title> 89<title>Purpose</title>
89<body> 90<body>
90 91
91<p> 92<p>
92This guide is for people who can't get direct rendering working with just 93This guide is for people who can't get direct rendering working with just Xorg.
93Xorg. X11-DRM works for 3dfx, gamma, i8x0, matrox, rage128, radeon, mach64 94X11-DRM works for 3dfx, gamma, i8x0, matrox, rage128, radeon, mach64 and sis300
94and sis300 series drivers. See the <uri 95series drivers. See the <uri link="http://dri.freedesktop.org/">DRI
95link="http://dri.sourceforge.net">DRI homepage</uri> for more info and 96homepage</uri> for more info and documentation.
96documentation.
97</p> 97</p>
98 98
99</body> 99</body>
100</section> 100</section>
101<section> 101<section>
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[M] Intel 440LX/BX/GX and I815/I820/I830M/I830MP/I840/I845/I850/I860 support
167<comment>(Enable your chipset instead of the above.)</comment> 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>
172If you use a 2.4 kernel, make sure the Direct Rendering Manager (DRM) is 172Make sure the Direct Rendering Manager (DRM) is <e>off</e>.
173<e>off</e>. The X11-DRM package will provide its own. 2.6 kernel users should 173The X11-DRM package will provide its own.
174<e>enable</e> the Direct Rendering Manager (DRM) as the X11-DRM package
175currently does not support 2.6 kernels yet.
176</p> 174</p>
177 175
178</body> 176</body>
179</section> 177</section>
180<section> 178<section>
181<title>Compile and install your kernel</title> 179<title>Compile and install your kernel</title>
182<body> 180<body>
183 181
184<pre caption="Compiling and installing kernel"> 182<pre caption="Compiling and installing kernel">
183<comment>(This example is for a 2.4 kernel)</comment>
185# <i>make dep &amp;&amp; make clean bzImage modules modules_install</i> 184# <i>make dep &amp;&amp; make clean bzImage modules modules_install</i>
186# <i>mount /boot</i> 185# <i>mount /boot</i>
187# <i>cp arch/i386/boot/bzImage /boot</i> 186# <i>cp arch/i386/boot/bzImage /boot</i>
188</pre> 187</pre>
189 188
201<title>Install X11-DRM and configure direct rendering</title> 200<title>Install X11-DRM and configure direct rendering</title>
202<section> 201<section>
203<title>Install X11-DRM</title> 202<title>Install X11-DRM</title>
204<body> 203<body>
205 204
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
211<pre caption="Installing X11-DRM"> 205<pre caption="Installing X11-DRM">
212# <i>emerge x11-drm</i> 206# <i>emerge x11-drm</i>
213</pre> 207</pre>
214 208
215</body> 209</body>
216</section> 210</section>
217<section id="configure_xorg"> 211<section id="configure_xorg">
218<title>Configure Xorg.conf</title> 212<title>Configure Xorg.conf</title>
219<body> 213<body>
214
215<p>
216Some chipsets require you to rebuild <c>xorg-x11</c> with
217<c>USE="insecure-drivers"</c>. This applies to mach64, unichrome and savage
218chipsets on xorg-x11-6.8.2, and to mach64 and unichrome on xorg-x11-6.8.99.x.
219Savage users should not try xorg-x11-6.8.99.x as support for the savage there
220is broken.
221</p>
222
223<pre caption="Rebuilding xorg-x11">
224<comment>(Add the insecure-drivers USE flag if you use one of the aforementioned chipsets)</comment>
225# <i>echo "x11-base/xorg-x11 insecure-drivers" &gt;&gt; /etc/portage/package.use</i>
226
227# <i>emerge xorg-x11</i>
228</pre>
220 229
221<p> 230<p>
222Open <path>/etc/X11/xorg.conf</path> with your favorite text editor and edit 231Open <path>/etc/X11/xorg.conf</path> with your favorite text editor and edit
223it to enable DRI and GLX. 232it to enable DRI and GLX.
224</p> 233</p>
245If you are using a different driver, replace "radeon" with yours. 254If you are using a different driver, replace "radeon" with yours.
246</p> 255</p>
247 256
248</body> 257</body>
249</section> 258</section>
259<section>
260<title>Changes to modules.autoload.d</title>
261<body>
262
263<p>
264You will need to add the module name that your card uses to
265<path>/etc/modules.autoload.d/kernel-2.6</path> to ensure that the module is
266loaded automatically when the system starts up.
267</p>
268
269<pre caption="Editing /etc/modules.autoload.d/kernel-2.6">
270<comment>(Change module name as required.)</comment>
271intel-agp
272</pre>
273
274</body>
275</section>
250</chapter> 276</chapter>
251 277
252<chapter> 278<chapter>
253<title>Test 3D acceleration</title> 279<title>Test 3D acceleration</title>
254<section> 280<section>
303<section> 329<section>
304<title>Do the CVS sources support your card?</title> 330<title>Do the CVS sources support your card?</title>
305<body> 331<body>
306 332
307<p> 333<p>
308Check the DRI <uri 334Check the DRI <uri link="http://dri.freedesktop.org/wiki/Status">supported
309link="http://dri.sourceforge.net/cgi-bin/moin.cgi/Status">supported cards
310list</uri> to see if the CVS supports your card. Even if it doesn't, but it 335cards list</uri> to see if the CVS supports your card. Even if it doesn't, but
311supports a similar card, try it. 336it supports a similar card, try it.
312</p> 337</p>
313 338
314<!-- I see a couple of 8x AGP stuff on the Internet about vanilla 2.4 kernels; 339<!-- I see a couple of 8x AGP stuff on the Internet about vanilla 2.4 kernels;
315 is this now available or not? I've commented it out for the time being, 340 is this now available or not? I've commented it out for the time being,
316 hoping that this doesn't affect us :) 341 hoping that this doesn't affect us :)
341<title>Follow the CVS Instructions</title> 366<title>Follow the CVS Instructions</title>
342<body> 367<body>
343 368
344<p> 369<p>
345The DRI project has a document about CVS compiling themselves. Please read <uri 370The DRI project has a document about CVS compiling themselves. Please read <uri
346link="http://dri.sourceforge.net/cgi-bin/moin.cgi/Building">the document</uri> 371link="http://dri.freedesktop.org/wiki/Building">the document</uri> and follow
347and follow the instructions up to the <e>Installing for XFree86</e> or 372the instructions up to the <e>Installing for X.org</e> part.
348<e>Installing for X.org</e> part.
349</p> 373</p>
350 374
351</body> 375</body>
352</section> 376</section>
353<section> 377<section>
371using the right version of the Linux kernel. The most recent kernels are not 395using the right version of the Linux kernel. The most recent kernels are not
372always supported. 396always supported.
373</p> 397</p>
374 398
375<p> 399<p>
376Install over your XFree86 or X.org installation. You may wish to back up xfree 400Install over your X.org installation. You may wish to back up xorg-x11.
377or xorg-x11.
378</p> 401</p>
379 402
380<pre caption="Backing up Xorg"> 403<pre caption="Backing up Xorg">
381# <i>quickpkg xorg-x11</i> 404# <i>quickpkg xorg-x11</i>
382<comment>(This backs up your Xorg-X11 package.)</comment> 405<comment>(This backs up your Xorg-X11 package.)</comment>
428 ... 451 ...
429EndSection 452EndSection
430</pre> 453</pre>
431 454
432<p> 455<p>
433If you want to set even more features, check out the <uri 456If you want to set even more features, check out the <uri
457link="http://dri.freedesktop.org/wiki/FeatureMatrix">feature matrix</uri> on
458the DRI web site or the <uri
434link="http://dri.sourceforge.net/doc/dri_driver_features.phtml">features 459link="http://dri.sourceforge.net/doc/dri_driver_features.phtml">features
435listing</uri> on the DRI Web site. 460listing</uri> on Sourceforge.
436</p> 461</p>
437 462
438</body> 463</body>
439</section> 464</section>
440</chapter> 465</chapter>
444<section> 469<section>
445<title>It doesn't work. I just recompiled my kernel or switched to a new one.</title> 470<title>It doesn't work. I just recompiled my kernel or switched to a new one.</title>
446<body> 471<body>
447 472
448<p> 473<p>
449Whenever you rebuild your kernel or switch to another kernel, you'll have to 474Whenever you rebuild your kernel or switch to another kernel, you'll have to
450rebuild the kernel module. Note that you don't need to remerge xfree or 475rebuild the kernel module. Note that you don't need to remerge xorg-x11, but
451xorg-x11, but you will need to remerge x11-drm. 476you will need to remerge x11-drm.
452</p> 477</p>
453 478
454</body> 479</body>
455</section> 480</section>
456 481
501<title>It doesn't work. My card is so incredibly new and cool that it isn't supported at all.</title> 526<title>It doesn't work. My card is so incredibly new and cool that it isn't supported at all.</title>
502<body> 527<body>
503 528
504<p> 529<p>
505Try out the binary drivers. For ati-drivers, a listing is at 530Try out the binary drivers. For ati-drivers, a listing is at
506<uri>http://www.schneider-digital.de/html/download_ati.html</uri>. If those 531<uri>http://www.schneider-digital.de/html/download_ati.php</uri>. If those
507don't support it, use fbdev. It's slow, but it works. 532don't support it, use fbdev. It's slow, but it works.
508</p> 533</p>
509 534
510</body> 535</body>
511</section> 536</section>
549<title>References</title> 574<title>References</title>
550<section> 575<section>
551<body> 576<body>
552 577
553<ol> 578<ol>
554 <li>http://forums.gentoo.org/viewtopic.php?t=46681</li> 579 <li><uri>http://forums.gentoo.org/viewtopic.php?t=46681</uri></li>
555 <li>http://forums.gentoo.org/viewtopic.php?t=29264</li> 580 <li><uri>http://forums.gentoo.org/viewtopic.php?t=29264</uri></li>
556 <li>http://dri.sourceforge.net/</li> 581 <li><uri>http://dri.freedesktop.org/</uri></li>
557 <li>http://www.retinalburn.net/linux/dri_status.html</li> 582 <li><uri>http://www.retinalburn.net/linux/dri_status.html</uri></li>
558</ol> 583</ol>
559 584
560</body> 585</body>
561</section> 586</section>
562</chapter> 587</chapter>

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

  ViewVC Help
Powered by ViewVC 1.1.20