source: x/lib/mesalib.xml@ ba2ac60

10.0 10.1 11.0 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since ba2ac60 was ba2ac60, checked in by Dan Nichilson <dnicholson@…>, 15 years ago

Updated to Mesa-6.5.2

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@6786 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 10.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY mesalib-download-http "http://downloads.sourceforge.net/mesa3d/MesaLib-&mesalib-version;.tar.bz2">
8 <!ENTITY mesalib-download-ftp " ">
9 <!ENTITY mesalib-md5sum "61beda590bfc5b4a12e979d5f2d70d7a">
10 <!ENTITY mesalib-size "3.1 MB">
11 <!ENTITY mesalib-buildsize "172 MB">
12 <!ENTITY mesalib-time "1.6 SBU">
13
14 <!ENTITY mesademos-download-http "http://downloads.sourceforge.net/mesa3d/MesaDemos-&mesalib-version;.tar.bz2">
15 <!ENTITY mesademos-md5sum "e870efe98d3a50be01ab211b9b2e25d9">
16 <!ENTITY mesademos-size "1.3 MB">
17
18 <!ENTITY mesaglut-download-http "http://downloads.sourceforge.net/mesa3d/MesaGLUT-&mesalib-version;.tar.bz2">
19 <!ENTITY mesaglut-md5sum "e84edbb11c69c8e408dfadd2ed08e95b">
20 <!ENTITY mesaglut-size "306 KB">
21
22]>
23
24<sect1 id="mesalib" xreflabel="MesaLib-&mesalib-version;">
25 <?dbhtml filename="mesalib.html"?>
26
27 <sect1info>
28 <othername>$LastChangedBy$</othername>
29 <date>$Date$</date>
30 </sect1info>
31
32 <title>MesaLib-&mesalib-version;</title>
33
34 <indexterm zone="mesalib">
35 <primary sortas="a-MesaLib">MesaLib</primary>
36 </indexterm>
37
38 <sect2 role="package">
39 <title>Introduction to MesaLib</title>
40
41 <para><application>Mesa</application> is an OpenGL compatible 3-D graphics
42 library.</para>
43
44 <bridgehead renderas="sect3">Package Information</bridgehead>
45 <itemizedlist spacing="compact">
46 <listitem>
47 <para>Download (HTTP): <ulink url="&mesalib-download-http;"/></para>
48 </listitem>
49 <listitem>
50 <para>Download (FTP): <ulink url="&mesalib-download-ftp;"/></para>
51 </listitem>
52 <listitem>
53 <para>Download MD5 sum: &mesalib-md5sum;</para>
54 </listitem>
55 <listitem>
56 <para>Download size (including recommended download):
57 &mesalib-size;</para>
58 </listitem>
59 <listitem>
60 <para>Estimated disk space required (including recommended download):
61 &mesalib-buildsize;</para>
62 </listitem>
63 <listitem>
64 <para>Estimated build time (including recommended download):
65 &mesalib-time;</para>
66 </listitem>
67 </itemizedlist>
68
69 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
70
71 <itemizedlist spacing="compact">
72 <title>Recommended demonstration and diagnostic utilities for
73 verifying OpenGL operation</title>
74 <listitem>
75 <para>Download (HTTP): <ulink url="&mesademos-download-http;"/></para>
76 </listitem>
77 <listitem>
78 <para>Download MD5 sum: &mesademos-md5sum;</para>
79 </listitem>
80 <listitem>
81 <para>Download size: &mesademos-size;</para>
82 </listitem>
83 </itemizedlist>
84
85 <itemizedlist spacing="compact">
86 <title>Optional GLUT library (see also <xref linkend="freeglut"/>)</title>
87 <listitem>
88 <para>Download (HTTP): <ulink url="&mesaglut-download-http;"/></para>
89 </listitem>
90 <listitem>
91 <para>Download MD5 sum: &mesaglut-md5sum;</para>
92 </listitem>
93 <listitem>
94 <para>Download size: &mesaglut-size;</para>
95 </listitem>
96 </itemizedlist>
97
98 <bridgehead renderas="sect3">MesaLib Dependencies</bridgehead>
99
100 <bridgehead renderas="sect4">Required</bridgehead>
101 <para role="required"><xref linkend="xorg7-lib"/>,
102 <xref linkend="xorg7-util"/>, and
103 <xref linkend="libdrm"/></para>
104
105 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
106 href="../../xincludes/xorg7-only.xml"/>
107
108 <!-- <note>
109 <para>It is not recommended to build a newer version of
110 <application>Mesa</application> with <xref linkend="xfree86"/>.</para>
111 </note> -->
112
113 <para condition="html" role="usernotes">User Notes:
114 <ulink url="&blfs-wiki;/mesalib"/></para>
115
116 </sect2>
117
118 <sect2 role="installation">
119 <title>Installation of MesaLib</title>
120
121 <para>Extract all three tarballs from the same top-level directory as they
122 all will extract to the
123 <filename class="directory">Mesa-&mesalib-version;</filename>
124 directory.</para>
125
126 <!-- Commenting this out as there is already mention of this
127 <caution>
128 <para>You should ensure that the <envar>XORG_PREFIX</envar> variable in
129 the commands below is the same as the one used in the installation prefix
130 of <application>Xorg</application>.</para>
131 </caution>
132 -->
133
134 <para>Install <application>MesaLib</application> by running the following
135 command:</para>
136
137<screen><userinput>make linux-dri-x86 OPT_FLAGS="-O2 -fno-strict-aliasing" \
138 DRI_DRIVER_INSTALL_DIR=${XORG_PREFIX}/lib/modules/dri \
139 X11_INCLUDES=-I${XORG_PREFIX}/include \
140 EXTRA_LIB_PATH=-L${XORG_PREFIX}/lib</userinput></screen>
141
142 <para>If you downloaded and extracted the Demos package, build the programs
143 with the following commands:</para>
144
145<screen><userinput>sed -i 's@-l$(GLUT_LIB)@@g' configs/default &amp;&amp;
146make -C progs/xdemos PROGS='glxinfo glxgears'</userinput></screen>
147
148 <para>This package does not come with a test suite.</para>
149
150 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
151
152<screen role="root"><userinput>make install INSTALL_DIR=${XORG_PREFIX} \
153 DRI_DRIVER_INSTALL_DIR=${XORG_PREFIX}/lib/modules/dri &amp;&amp;
154install -dv ${XORG_PREFIX}/share/doc/MesaLib-&mesalib-version; &amp;&amp;
155install -v -m644 docs/* ${XORG_PREFIX}/share/doc/MesaLib-&mesalib-version;</userinput></screen>
156
157 <para>If you built the demo programs, install them using the following
158 command as the <systemitem class="username">root</systemitem> user:</para>
159
160<screen role="root"><userinput>install -v -m755 progs/xdemos/glx{info,gears} ${XORG_PREFIX}/bin</userinput></screen>
161
162 <para>Finally, if installing to any prefix other than
163 <filename class="directory">/usr</filename>, you should create symlinks
164 to the GL headers in <filename class="directory">/usr/include</filename>.
165 Execute the following command as the
166 <systemitem class="username">root</systemitem> user:</para>
167
168<screen role="root"><userinput>ln -s -v ${XORG_PREFIX}/include/GL /usr/include</userinput></screen>
169
170 <tip>
171 <para>Do not remove the Mesa source tree yet, it will be required to
172 build the <xref linkend="xorg7-server"/>.</para>
173 </tip>
174
175 </sect2>
176
177 <sect2 role="commands">
178 <title>Command Explanations</title>
179
180 <para><command>make ... linux-dri-x86</command>: The
181 <option>linux-dri-x86</option> target is specified to use a
182 few other helpful flags in addition to the defaults. See the other
183 targets in the <filename class="directory">configs</filename> directory
184 if your architecture is not x86.</para>
185
186 <para><envar>OPT_FLAGS="-O2 -fno-strict-aliasing"</envar>: A bug where
187 OpenGL applications are shifted to the left by 50% can be worked around
188 by adding <option>-fno-strict-aliasing</option> to the compiler flags.</para>
189
190 <para><envar>DRI_DRIVER_INSTALL_DIR=${XORG_PREFIX}/lib/modules/dri</envar>:
191 This setting specifies the location that the DRI modules will be installed
192 to. This path is also built into <filename
193 class="libraryfile">libGL.so</filename>.</para>
194
195 <para><command>sed -i 's@-l$(GLUT_LIB)@@g' configs/default</command>:
196 Disables linking against the GLUT libraries for the demo programs, omit
197 this command if you downloaded and extracted the GLUT tarball.</para>
198
199 <para><command>make ... PROGS='glxinfo glxgears'</command>: Only builds
200 the <command>glxinfo</command> and <command>glxgears</command>
201 programs.</para>
202
203 </sect2>
204
205 <sect2 role="content">
206 <title>Contents</title>
207
208 <segmentedlist>
209 <segtitle>Installed Programs (optional)</segtitle>
210 <segtitle>Installed Libraries</segtitle>
211 <segtitle>Installed Directories</segtitle>
212
213 <seglistitem>
214 <seg>glxgears and glxinfo</seg>
215 <seg>libGL.so, libGLU.so, libGLw.so, *_dri.so and
216 optionally, libglut.so</seg>
217 <seg><envar>$XORG_PREFIX</envar>/lib/modules/dri and
218 <envar>$XORG_PREFIX</envar>/share/doc/MesaLib-&mesalib-version;</seg>
219 </seglistitem>
220 </segmentedlist>
221
222 <variablelist>
223 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
224 <?dbfo list-presentation="list"?>
225 <?dbhtml list-presentation="table"?>
226
227 <varlistentry id="glxgears">
228 <term><filename>glxgears</filename></term>
229 <listitem>
230 <para>is a GL demo useful for troubleshooting graphics
231 problems.</para>
232 <indexterm zone="mesalib glxgears">
233 <primary sortas="b-glxgears">glxgears</primary>
234 </indexterm>
235 </listitem>
236 </varlistentry>
237
238 <varlistentry id="glxinfo">
239 <term><filename>glxinfo</filename></term>
240 <listitem>
241 <para>is a diagnostic program that displays information about the
242 graphics hardware and installed GL libraries.</para>
243 <indexterm zone="mesalib glxinfo">
244 <primary sortas="b-glxinfo">glxinfo</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="libGL">
250 <term><filename class='libraryfile'>libGL.so</filename></term>
251 <listitem>
252 <para>is the main OpenGL library.</para>
253 <indexterm zone="mesalib libGL">
254 <primary sortas="c-libGL">libGL.so</primary>
255 </indexterm>
256 </listitem>
257 </varlistentry>
258
259 <varlistentry id="libGLU">
260 <term><filename class='libraryfile'>libGLU.so</filename></term>
261 <listitem>
262 <para>is the OpenGL Utility library.</para>
263 <indexterm zone="mesalib libGLU">
264 <primary sortas="c-libGLU">libGLU.so</primary>
265 </indexterm>
266 </listitem>
267 </varlistentry>
268
269 <varlistentry id="libGLw">
270 <term><filename class='libraryfile'>libGLw.so</filename></term>
271 <listitem>
272 <para>is the Xt/Motif OpenGL drawing area widget library.</para>
273 <indexterm zone="mesalib libGLw">
274 <primary sortas="c-libGLw">libGLw.so</primary>
275 </indexterm>
276 </listitem>
277 </varlistentry>
278
279 <varlistentry id="libglut-mesa">
280 <term><filename class='libraryfile'>libglut.so</filename></term>
281 <listitem>
282 <para>is the OpenGL Utility Toolkit (GLUT) library.</para>
283 <indexterm zone="mesalib libglut-mesa">
284 <primary sortas="c-libglut">libglut.so</primary>
285 </indexterm>
286 </listitem>
287 </varlistentry>
288
289 </variablelist>
290
291 </sect2>
292
293</sect1>
Note: See TracBrowser for help on using the repository browser.