diff options
author | David Nusinow <[email protected]> | 2007-06-27 21:29:16 -0400 |
---|---|---|
committer | David Nusinow <[email protected]> | 2007-06-27 21:29:16 -0400 |
commit | b2e67fdb7ca78c468ecf583ef1fcf9643df55817 (patch) | |
tree | 4c6b1894e9a3db74b17626dd893ab7924e8ed225 /docs | |
parent | 1953cfc9542dafe2b92d2c9a0da819513ee2c1a4 (diff) | |
parent | 131baefac30e46287f0c83f43fc0e7b858877830 (diff) |
Merge branch 'upstream-experimental' into debian-experimental
Conflicts:
.gitignore
progs/miniglx/miniglxtest.c
src/glx/mini/Makefile
src/glx/mini/miniglx.c
src/mesa/drivers/dri/r300/.gitignore
Diffstat (limited to 'docs')
-rw-r--r-- | docs/MiniGLX.html | 13 | ||||
-rw-r--r-- | docs/contents.html | 2 | ||||
-rw-r--r-- | docs/download.html | 6 | ||||
-rw-r--r-- | docs/fbdev-dri.html | 213 | ||||
-rw-r--r-- | docs/intro.html | 20 | ||||
-rw-r--r-- | docs/news.html | 7 | ||||
-rw-r--r-- | docs/relnotes-6.5.3.html | 10 | ||||
-rw-r--r-- | docs/relnotes-7.0.html | 85 | ||||
-rw-r--r-- | docs/relnotes.html | 1 | ||||
-rw-r--r-- | docs/subset.html | 17 |
10 files changed, 197 insertions, 177 deletions
diff --git a/docs/MiniGLX.html b/docs/MiniGLX.html index 3429812993a..e7ebae68519 100644 --- a/docs/MiniGLX.html +++ b/docs/MiniGLX.html @@ -88,19 +88,6 @@ driver (such as <code>radeon_dri.so</code>) at runtime. The environment variable <code>LIBGL_DRIVERS_PATH</code> should name the directory where these modules are located.<br> <br> -Prior to running a MiniGXL application, the following kernel modules -must be installed:<br> -<br> -<div style="margin-left: 40px;"> agpgart.o<br> -radeonfb.o (assuming Radeon hardware)<br> -radeon.o (assuming Radeon hardware)<br> -</div> -<code></code> <br> -Finally, MiniGLX reads a configuration file (by default,<code> -/etc/miniglx.conf</code>) to determine basic configuration information. - The configuration file may also be located in the directory -specified by the <code>MINIGLX_CONF</code> environment variable).<br> -<br> The remainder of this section describes the MiniGLX API functions.<br> <br> <h2>3.1 Initialization</h2> diff --git a/docs/contents.html b/docs/contents.html index d8f427e59bc..a21341a5891 100644 --- a/docs/contents.html +++ b/docs/contents.html @@ -71,8 +71,8 @@ a:visited { <li><a href="helpwanted.html" target="MainFrame">Help Wanted</a> <li><a href="devinfo.html" target="MainFrame">Development Notes</a> <li><a href="sourcedocs.html" target="MainFrame">Source Documentation</a> -<li><a href="subset.html" target="MainFrame">Subset Information</a> <li><a href="fbdev-dri.html" target="MainFrame">fbdev/DRI Environment</a> +<li><a href="subset.html" target="MainFrame">Mesa Subset Driver</a> <li><a href="glfbdev-driver.html" target="MainFrame">glFBDev Driver</a> <LI><A HREF="dispatch.html" target="MainFrame">GL Dispatch</A> </ul> diff --git a/docs/download.html b/docs/download.html index 1afe64ef964..90f566351e8 100644 --- a/docs/download.html +++ b/docs/download.html @@ -9,11 +9,7 @@ <H1>Downloading</H1> <p> -Last development release: <b>6.5.3</b> -</p> - -<p> -Last stable release: <b>6.4.2</b> +Last stable release: <b>7.0</b> </p> <p> diff --git a/docs/fbdev-dri.html b/docs/fbdev-dri.html index 4af503932be..c7f59bb0c2f 100644 --- a/docs/fbdev-dri.html +++ b/docs/fbdev-dri.html @@ -12,161 +12,77 @@ <H1>1. Introduction</H1> <p> -The fbdev/DRI sub-project within Mesa brings hardware accelerated OpenGL -rendering to the Linux fbdev environment. -The X Window System / XFree86 is not needed. +The fbdev/DRI environment supports hardware-accelerated 3D rendering without +the X window system. This is typically used for embedded applications. </p> <p> -Basically, the <a href="http://dri.sf.net/">DRI</a> drivers for hardware -accelerated OpenGL for XFree86 have been ported to fbdev so that X is -not needed. -This means fbdev/DRI works in full-screen mode only. +Contributors to this project include Jon Smirl, Keith Whitwell and Dave Airlie. </p> <p> -DRI driver writers may find this simplified environment easier to work in, -compared to the full XFree86/DRI environment. +Applications in the fbdev/DRI environment use +the <a href="MiniGXL.html"> MiniGLX</a> interface to choose pixel +formats, create rendering contexts, etc. It's a subset of the GLX and +Xlib interfaces allowing some degree of application portability between +the X and X-less environments. </p> -<p> -Much of the work for this project has been done by Jon Smirl and -Keith Whitwell. -</p> - -<p> -To use fbdev/DRI, you'll need a Linux 2.4 or 2.6 kernel. -</p> - -<h3>Background Info</h3> - -<p> -The Mesa-based DRI drivers used to be hosted in the DRI tree (which is -basically a copy of the XFree86 tree). -Since the Mesa-based DRI drivers are moreso "Mesa drivers" than "XFree86 -drivers" and the fact that with some work, the drivers could be used -without X, the driver code was moved into the Mesa tree. -</p> - -<p> -So now the DRI drivers can be compiled for two different environments: -fbdev and XFree86. -To build the drivers for XFree86, one has to download/build the DRI -source tree. -Eventually, we'd like to be able to build the drivers for XFree86 outside -of the XFree86/DRI trees. -</p> - - - <h1>2. Compilation</h1> -<h2>2.1 Compiling the DRM modules</h2> - -<p> -First, you'll need the DRM (Direct Rendering Manager) kernel module sources. -They're found in a module of the DRI CVS tree. -To obtain the code do the following: -</p> -<pre> - cvs -d:pserver:[email protected]:/cvs/dri login -</pre> <p> -Press Enter/Return when prompted for a password. Then, +You'll need the DRM and pciaccess libraries. Check with: </p> <pre> - cvs -d:pserver:[email protected]:/cvs/dri co drm + pkg-config --modversion libdrm + pkg-config --modversion pciaccess </pre> <p> -Compile the DRM kernel modules: +You can get them from the git repository with: </p> <pre> - cd drm/linux - make + git clone git://anongit.freedesktop.org/git/mesa/drm + git clone git://anongit.freedesktop.org/git/xorg/lib/libpciaccess </pre> <p> -Note: you may need to be root in order to make a few symlinks. -</p> -<p> -When compilation is done, you should have at least the following -kernel modules: +See the README files in those projects for build/install instructions. </p> -<pre> - gamma.o - i810.o - i830.o - mach64.o - mga.o - r128.o - radeon.o - savage.o - sis.o - tdfx.o - via.o -</pre> -<p> -You'll probably want to copy/move them into your kernel module directory -(for example: <code>/lib/modules/2.4.18-14/kernel/drivers/char/drm/</code>). -</p> - -<h2>2.2 Compiling the Mesa drivers</h2> - <p> -Begin by editing the <code>Mesa/configs/default</code> file to set -the <code>DRM_SOURCE_PATH</code> variable. -Set it to the location where the DRM module sources are located. -For example, if your current directory in step 2.1 was <code>/home/fred/</code> -set DRM_SOURCE_PATH to <code>/home/fred/drm</code> +You'll need fbdev header files. Check with: </p> +<pre> + ls -l /usr/include/linux/fb.h +</pre> <p> -Next, assuming you're starting with a fresh Mesa CVS checkout, -do the following: +Compile Mesa with the 'linux-solo' configuration: </p> <pre> make linux-solo </pre> <p> -If you previously built the source tree, run <code>make realclean</code> -first to remove the old object files. +When complete you should have the following: </p> - -<p> -When this is finished, check the <code>Mesa/lib/</code> directory -to verify that the following files were made: -</p> - <ul> -<li><code>libGL.so.1.2</code> - the client-side OpenGL library - (and a few symlinks to it). -<li><code>libGLU.so.1.1</code> - the GLU library (and a few symlinks to it). -<li><code>libglut.so.3.7</code> - the GLUT library (and a few symlinks to it). -<li><code>mga_dri.so</code> - DRI driver for Matrox G200/G400 cards. -<li><code>r128_dri.so</code> - DRI driver for ATI Rage 128 cards. -<li><code>r200_dri.so</code> - DRI driver for ATI R200 Radeon cards. -<li><code>radeon_dri.so</code> - DRI driver for original ATI Radeon cards. -<li><code>i810_dri.so</code> - DRI driver for Intel i810/i815 chips. -<li><code>i830_dri.so</code> - DRI driver for Intel i830/i845 chips. -<li><code>mga_dri.so</code> - DRI driver for Matrox G200/G400 cards. -<li><code>sis_dri.so</code> - DRI driver for SIS cards. -<li><code>tdfx_dri.so</code> - DRI driver for 3dfx Voodoo 3/4/5 cards. -<li><code>gamma_dri.so</code> - DRI driver for 3Dlabs gamma cards. -<li><code>fb_dri.so</code> - software-only fbdev driver. -<li><code>miniglx.conf</code> - configuration file for the MiniGLX interface +<li>lib/libGL.so - the GL library which applications link with +<li>lib/*_dri_so - DRI drivers +<li>lib/miniglx.conf - sample MiniGLX config file +<li>progs/miniglx/* - several MiniGLX sample programs </ul> + <h1>3. Using fbdev/DRI</h1> <p> -If XFree86 is currently running, exit/stop the X server so you're -working from the console. +If an X server currently running, exit/stop it so you're working from +the console. </p> @@ -175,12 +91,23 @@ working from the console. <p> You'll need to load the kernel modules specific to your graphics hardware. Typically, this consists of the agpgart module, an fbdev driver module -and the DRM kernel module (from step 2.1). +and the DRM kernel module. +</p> +<p> +As root, the kernel modules can be loaded as follows: </p> +<p> +If you have Intel i915/i945 hardware: +</p> +<pre> + modprobe agpgart # the AGP GART module + modprobe intelfb # the Intel fbdev driver + modprobe i915 # the i915/945 DRI kernel module +</pre> <p> -If you have ATI Radeon/R200 hardware, run as root: +If you have ATI Radeon/R200 hardware: </p> <pre> modprobe agpgart # the AGP GART module @@ -189,7 +116,7 @@ If you have ATI Radeon/R200 hardware, run as root: </pre> <p> -If you have ATI Rage 128 hardware, run as root: +If you have ATI Rage 128 hardware: </p> <pre> modprobe agpgart # the AGP GART module @@ -198,7 +125,7 @@ If you have ATI Rage 128 hardware, run as root: </pre> <p> -If you have Matrox G200/G400 hardware, run as root: +If you have Matrox G200/G400 hardware: </p> <pre> modprobe agpgart # the AGP GART module @@ -207,37 +134,46 @@ If you have Matrox G200/G400 hardware, run as root: </pre> <p> -Then run <code>lsmod</code> to be sure the modules are loaded. -For a Radeon card, you should see something like this: +To verify that the agpgart, fbdev and drm modules are loaded: </p> <pre> -Module Size Used by Not tainted -radeon 110308 0 (unused) -radeonfb 21900 0 (unused) -agpgart 43072 1 + ls -l /dev/agpgart /dev/fb* /dev/dri </pre> - +<p> +Alternately, use lsmod to inspect the currently installed modules. +If you have problems, look at the output of dmesg. +</p> <h2>3.2 Configuration File</h2> <p> -The <code>Mesa/lib/miniglx.conf</code> file should be installed -in <code>/etc/</code>. +Copy the sample miniglx.conf to /etc/miniglx.conf and review/edit its contents. +Alternately, the MINIGLX_CONF environment variable can be used to +indicate the location of miniglx.conf </p> +To determine the pciBusID value, run lspci and examine the output. +For example: +</p> +<pre> + /sbin/lspci: + 00:02.0 VGA compatible controller: Intel Corporation 82915G/GV/910GL Express Chipset Family Graphics Controller (rev 04) +</pre> <p> -Edit <code>/etc/miniglx.conf</code> to be sure it's set up correctly -for your hardware. -Comments in the file explain the options. +00:02.0 indicates that pciBusID should be PCI:0:2:0 </p> + + <h2>3.3 Running fbdev/DRI Programs</h2> <p> Make sure your LD_LIBRARY_PATH environment variable is set to the -<code>Mesa/lib/</code> directory. +location of the libGL.so library. You may need to append other paths +to LD_LIBRARY_PATH if libpciaccess.so is in a non-standard location, +for example. </p> <p> @@ -245,7 +181,7 @@ Change to the <code>Mesa/progs/miniglx/</code> directory and start the sample_server program in the background: </p> <pre> - ./sample_server & + ./sample_server & </pre> <p> @@ -268,28 +204,25 @@ them from a remote shell so that you can stop them with ctrl-C. <h1>4.0 Troubleshooting</h1> -<p> +<ol> +<li> If you try to run miniglxtest and get the following: -</p> +<br> <pre> [miniglx] failed to probe chipset connect: Connection refused server connection lost </pre> -<p> It means that the sample_server process is not running. -</p> - - +<br> +<br> +</li> +</ol> <h1>5.0 Programming Information</h1> <p> -The full OpenGL API is available with fbdev/DRI. -</p> - -<p> OpenGL/Mesa is interfaced to fbdev via the <a href="MiniGLX.html">MiniGLX</a> interface. MiniGLX is a subset of Xlib and GLX API functions which provides just diff --git a/docs/intro.html b/docs/intro.html index 33a006a74b5..0e37322823b 100644 --- a/docs/intro.html +++ b/docs/intro.html @@ -128,10 +128,15 @@ specification as well as the GL_ARB_vertex_program and GL_ARB_fragment_program extensions. </p> +<p> +June 2007: Mesa 7.0 is released, implementing the OpenGL 2.1 specification +and OpenGL Shading Language. +</p> + <p> Ongoing: Mesa is used as the core of many hardware OpenGL drivers for -the XFree86 X.org X servers within the +the XFree86 and X.org X servers within the <A href="http://dri.freedesktop.org/" target="_parent">DRI project</A>. I continue to enhance Mesa with new extensions and features. </p> @@ -141,9 +146,16 @@ I continue to enhance Mesa with new extensions and features. <H1>Major Versions</H1> <p> -This is a summary of the major versions of Mesa. Note that Mesa's major -version number tracks OpenGL's minor version number (+1). -Work is underway to implement the OpenGL 2.0 specification. +This is a summary of the major versions of Mesa. +Mesa's major version number has been incremented whenever a new version +of the OpenGL specification is implemented. +</p> + + +<H2>Version 7.x features</H2> +<p> +Version 7.x of Mesa implements the OpenGL 2.1 API. The main feature +of OpenGL 2.x is the OpenGL Shading Language. </p> diff --git a/docs/news.html b/docs/news.html index d23fc6dfc6b..58aca318587 100644 --- a/docs/news.html +++ b/docs/news.html @@ -11,6 +11,13 @@ <H1>News</H1> +<h2>June 22, 2007</h2> +<p> +<a href="relnotes-7.0.html">Mesa 7.0</a> is released. +This is a stable release featuring OpenGL 2.1 support. +</p> + + <h2>April 27, 2007</h2> <p> <a href="relnotes-6.5.3.html">Mesa 6.5.3</a> is released. diff --git a/docs/relnotes-6.5.3.html b/docs/relnotes-6.5.3.html index df7526f4705..0d68d990134 100644 --- a/docs/relnotes-6.5.3.html +++ b/docs/relnotes-6.5.3.html @@ -18,7 +18,15 @@ Mesa 7.0 is expected to follow shortly. <h2>MD5 checksums</h2> <pre> -TBD +39f33ea64e34e2d5b20640b008b57649 MesaLib-6.5.3.tar.gz +46359457147c469745f24b5074a186f0 MesaLib-6.5.3.tar.bz2 +a8946fa861634ce15971396f47992c41 MesaLib-6.5.3.zip +08e26948d57eaca74d02a530b2d8106e MesaDemos-6.5.3.tar.gz +8af91773ab2653fe537499676b05f2e8 MesaDemos-6.5.3.tar.bz2 +783f81b171bf89b0929abc894efd25a6 MesaDemos-6.5.3.zip +9467d415388fe1ad82991fb20704b812 MesaGLUT-6.5.3.tar.gz +360843e46b7ebb6909290b023f9b26fa MesaGLUT-6.5.3.tar.bz2 +7686065e5c15a30de08a1610860b6840 MesaGLUT-6.5.3.zip </pre> diff --git a/docs/relnotes-7.0.html b/docs/relnotes-7.0.html new file mode 100644 index 00000000000..c3635ce3975 --- /dev/null +++ b/docs/relnotes-7.0.html @@ -0,0 +1,85 @@ +<HTML> + +<TITLE>Mesa Release Notes</TITLE> + +<head><link rel="stylesheet" type="text/css" href="mesa.css"></head> + +<BODY> + +<body bgcolor="#eeeeee"> + +<H1>Mesa 7.0 Release Notes / June 22, 2007</H1> + +<p> +Mesa 7.0 is a stable release, featuring OpenGL 2.1 API support. +A number of bugs have been fixed since the 6.5.3 release. +</p> + + +<h2>MD5 checksums</h2> +<pre> +TBD +</pre> + + +<h2>New features</h2> +<ul> +<li>OpenGL 2.0 and 2.1 API support. +</ul> + +<h2>Bug fixes</h2> +<ul> +<li>Fixed a few fog-related bugs. +<li>Fixed broken GLSL mix() function. +<li>Fixed broken GLSL exp() functions. +<li>Fixed GLSL mod4(vec4, vec4) bug. +<li>Implemented GLSL asin(), acos(), atan() functions. +<li>Fixed an R300 driver bug that caused Xorg composite manager to crash +<li>Fixed R300 vertex program/matrix bug (10848) +<li>GLSL dFdx() and dFdy() work for fragment program inputs now (texcoords) +<li>Specifying an invalid texture unit as a sampler could lead to a crash +<li>The GLX protocol request for glXDestroyPBuffer() was incorrect (bug 10983) +<li>ARB vp state.light[n].half value was incorrect (bug 10987) +<li>Fixed a positional light source bug (bug 11009) +<li>Fixed point size attenuation problem (bug 11042) +<li>glPopAttrib didn't restore texture object's LOD bias (bug 11049) +<li>Fixed a TLS / TEXTREL problem (bug 7459) +</ul> + + +<h2>Internal code changes</h2> +<ul> +<li>Some texture code consolidation and simplifiction (Ian Romanick) +<li>R300 driver clean-ups. +</ul> + + +<h2>To Do (someday) items</h2> +<ul> +<li>Switch to freeglut +<li>Fix linux-glide target/driver. +<li>Improved lambda and derivative calculation for frag progs. +</ul> + + +<h2>Driver Status</h2> + +<pre> +Driver Status +---------------------- ---------------------- +DRI drivers varies with the driver +XMesa/GLX (on Xlib) implements OpenGL 2.1 +OSMesa (off-screen) implements OpenGL 2.1 +Windows/Win32 implements OpenGL 2.1 +Glide (3dfx Voodoo1/2) implements OpenGL 1.3 +SVGA unsupported +Wind River UGL unsupported +DJGPP unsupported +GGI unsupported +BeOS unsupported +Allegro unsupported +D3D unsupported +</pre> + +</body> +</html> diff --git a/docs/relnotes.html b/docs/relnotes.html index f73500d4aca..c698dfe1312 100644 --- a/docs/relnotes.html +++ b/docs/relnotes.html @@ -20,6 +20,7 @@ The release notes summarize what's new or changed in each Mesa release. </p> <UL> +<LI><A HREF="relnotes-7.0.html">7.0 release notes</A> <LI><A HREF="relnotes-6.5.3.html">6.5.3 release notes</A> <LI><A HREF="relnotes-6.5.2.html">6.5.2 release notes</A> <LI><A HREF="relnotes-6.5.1.html">6.5.1 release notes</A> diff --git a/docs/subset.html b/docs/subset.html index dd1d742a821..4ac2eadffb9 100644 --- a/docs/subset.html +++ b/docs/subset.html @@ -1,17 +1,18 @@ <HTML> -<TITLE>Mesa Subset</TITLE> +<TITLE>Mesa Subset Driver</TITLE> <link rel="stylesheet" type="text/css" href="mesa.css"></head> <BODY> -<H1>Mesa Subset</H1> +<H1>Mesa Subset Driver</H1> <p> In 2002/2003 Tungsten Graphics was contracted to develop a subset Mesa/Radeon driver for an embedded environment. The result is a reduced-size DRI driver -for the ATI R200 chip, for use with Linux fbdev rather than XFree86. +for the ATI R200 chip, for use with +<a href="fbdev-dri.html">fbdev/DRI environment</a>. </p> <p> @@ -19,15 +20,5 @@ The specification for this subset can be found <a href="subset-A.html">here</a>. </p> -<p> -The <a href="MiniGLX.html">MiniGLX specification</a> describes the -interface between fbdev and Mesa. -</p> - -<p> -More info to come... -</p> - - </BODY> </HTML> |