source: x/lib/mesalib.xml@ 15e602c

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 15e602c was 15e602c, checked in by Dan Nichilson <dnicholson@…>, 15 years ago

Added missing expat dependency to MesaLib

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

  • Property mode set to 100644
File size: 10.6 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"/>,
103 <xref linkend="libdrm"/>, and
104 <xref linkend="expat"/></para>
105
106 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
107 href="../../xincludes/xorg7-only.xml"/>
108
109 <!-- <note>
110 <para>It is not recommended to build a newer version of
111 <application>Mesa</application> with <xref linkend="xfree86"/>.</para>
112 </note> -->
113
114 <para condition="html" role="usernotes">User Notes:
115 <ulink url="&blfs-wiki;/mesalib"/></para>
116
117 </sect2>
118
119 <sect2 role="installation">
120 <title>Installation of MesaLib</title>
121
122 <para>Extract all three tarballs from the same top-level directory as they
123 all will extract to the
124 <filename class="directory">Mesa-&mesalib-version;</filename>
125 directory.</para>
126
127 <!-- Commenting this out as there is already mention of this
128 <caution>
129 <para>You should ensure that the <envar>XORG_PREFIX</envar> variable in
130 the commands below is the same as the one used in the installation prefix
131 of <application>Xorg</application>.</para>
132 </caution>
133 -->
134
135 <para>Install <application>MesaLib</application> by running the following
136 command:</para>
137
138<screen><userinput>make linux-dri-x86 OPT_FLAGS="-O2 -fno-strict-aliasing" \
139 DRI_DRIVER_INSTALL_DIR=${XORG_PREFIX}/lib/modules/dri \
140 X11_INCLUDES=-I${XORG_PREFIX}/include \
141 EXTRA_LIB_PATH=-L${XORG_PREFIX}/lib</userinput></screen>
142
143 <para>If you downloaded and extracted the Demos package, build the programs
144 with the following commands:</para>
145
146<screen><userinput>sed -i 's@-l$(GLUT_LIB)@@g' configs/default &amp;&amp;
147make -C progs/xdemos PROGS='glxinfo glxgears'</userinput></screen>
148
149 <para>This package does not come with a test suite.</para>
150
151 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
152
153<screen role="root"><userinput>make install INSTALL_DIR=${XORG_PREFIX} \
154 DRI_DRIVER_INSTALL_DIR=${XORG_PREFIX}/lib/modules/dri &amp;&amp;
155install -dv ${XORG_PREFIX}/share/doc/MesaLib-&mesalib-version; &amp;&amp;
156install -v -m644 docs/* ${XORG_PREFIX}/share/doc/MesaLib-&mesalib-version;</userinput></screen>
157
158 <para>If you built the demo programs, install them using the following
159 command as the <systemitem class="username">root</systemitem> user:</para>
160
161<screen role="root"><userinput>install -v -m755 progs/xdemos/glx{info,gears} ${XORG_PREFIX}/bin</userinput></screen>
162
163 <para>Finally, if installing to any prefix other than
164 <filename class="directory">/usr</filename>, you should create symlinks
165 to the GL headers in <filename class="directory">/usr/include</filename>.
166 Execute the following command as the
167 <systemitem class="username">root</systemitem> user:</para>
168
169<screen role="root"><userinput>ln -s -v ${XORG_PREFIX}/include/GL /usr/include</userinput></screen>
170
171 <tip>
172 <para>Do not remove the Mesa source tree yet, it will be required to
173 build the <xref linkend="xorg7-server"/>.</para>
174 </tip>
175
176 </sect2>
177
178 <sect2 role="commands">
179 <title>Command Explanations</title>
180
181 <para><command>make ... linux-dri-x86</command>: The
182 <option>linux-dri-x86</option> target is specified to use a
183 few other helpful flags in addition to the defaults. See the other
184 targets in the <filename class="directory">configs</filename> directory
185 if your architecture is not x86.</para>
186
187 <para><envar>OPT_FLAGS="-O2 -fno-strict-aliasing"</envar>: A bug where
188 OpenGL applications are shifted to the left by 50% can be worked around
189 by adding <option>-fno-strict-aliasing</option> to the compiler flags.</para>
190
191 <para><envar>DRI_DRIVER_INSTALL_DIR=${XORG_PREFIX}/lib/modules/dri</envar>:
192 This setting specifies the location that the DRI modules will be installed
193 to. This path is also built into <filename
194 class="libraryfile">libGL.so</filename>.</para>
195
196 <para><command>sed -i 's@-l$(GLUT_LIB)@@g' configs/default</command>:
197 Disables linking against the GLUT libraries for the demo programs, omit
198 this command if you downloaded and extracted the GLUT tarball.</para>
199
200 <para><command>make ... PROGS='glxinfo glxgears'</command>: Only builds
201 the <command>glxinfo</command> and <command>glxgears</command>
202 programs.</para>
203
204 </sect2>
205
206 <sect2 role="content">
207 <title>Contents</title>
208
209 <segmentedlist>
210 <segtitle>Installed Programs (optional)</segtitle>
211 <segtitle>Installed Libraries</segtitle>
212 <segtitle>Installed Directories</segtitle>
213
214 <seglistitem>
215 <seg>glxgears and glxinfo</seg>
216 <seg>libGL.so, libGLU.so, libGLw.so, *_dri.so and
217 optionally, libglut.so</seg>
218 <seg><envar>$XORG_PREFIX</envar>/lib/modules/dri and
219 <envar>$XORG_PREFIX</envar>/share/doc/MesaLib-&mesalib-version;</seg>
220 </seglistitem>
221 </segmentedlist>
222
223 <variablelist>
224 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
225 <?dbfo list-presentation="list"?>
226 <?dbhtml list-presentation="table"?>
227
228 <varlistentry id="glxgears">
229 <term><filename>glxgears</filename></term>
230 <listitem>
231 <para>is a GL demo useful for troubleshooting graphics
232 problems.</para>
233 <indexterm zone="mesalib glxgears">
234 <primary sortas="b-glxgears">glxgears</primary>
235 </indexterm>
236 </listitem>
237 </varlistentry>
238
239 <varlistentry id="glxinfo">
240 <term><filename>glxinfo</filename></term>
241 <listitem>
242 <para>is a diagnostic program that displays information about the
243 graphics hardware and installed GL libraries.</para>
244 <indexterm zone="mesalib glxinfo">
245 <primary sortas="b-glxinfo">glxinfo</primary>
246 </indexterm>
247 </listitem>
248 </varlistentry>
249
250 <varlistentry id="libGL">
251 <term><filename class='libraryfile'>libGL.so</filename></term>
252 <listitem>
253 <para>is the main OpenGL library.</para>
254 <indexterm zone="mesalib libGL">
255 <primary sortas="c-libGL">libGL.so</primary>
256 </indexterm>
257 </listitem>
258 </varlistentry>
259
260 <varlistentry id="libGLU">
261 <term><filename class='libraryfile'>libGLU.so</filename></term>
262 <listitem>
263 <para>is the OpenGL Utility library.</para>
264 <indexterm zone="mesalib libGLU">
265 <primary sortas="c-libGLU">libGLU.so</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 <varlistentry id="libGLw">
271 <term><filename class='libraryfile'>libGLw.so</filename></term>
272 <listitem>
273 <para>is the Xt/Motif OpenGL drawing area widget library.</para>
274 <indexterm zone="mesalib libGLw">
275 <primary sortas="c-libGLw">libGLw.so</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279
280 <varlistentry id="libglut-mesa">
281 <term><filename class='libraryfile'>libglut.so</filename></term>
282 <listitem>
283 <para>is the OpenGL Utility Toolkit (GLUT) library.</para>
284 <indexterm zone="mesalib libglut-mesa">
285 <primary sortas="c-libglut">libglut.so</primary>
286 </indexterm>
287 </listitem>
288 </varlistentry>
289
290 </variablelist>
291
292 </sect2>
293
294</sect1>
Note: See TracBrowser for help on using the repository browser.