source: x/lib/mesalib.xml@ 9b3b6a4

10.0 10.1 11.0 11.1 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 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 9b3b6a4 was 9b3b6a4, checked in by Randy McMurchy <randy@…>, 15 years ago

Minor modifications to the MesaLib instructions (both the text and the commands)

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

  • Property mode set to 100644
File size: 9.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/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.3 MB">
11 <!ENTITY mesalib-buildsize "157 MB">
12 <!ENTITY mesalib-time "1.7 SBU">
13
14 <!ENTITY mesademos-download-http "http://downloads.sourceforge.net/mesa3d/MesaDemos-&mesalib-version;.tar.bz2">
15 <!ENTITY mesaglut-download-http "http://downloads.sourceforge.net/mesa3d/MesaGLUT-&mesalib-version;.tar.bz2">
16
17]>
18
19<sect1 id="mesalib" xreflabel="MesaLib-&mesalib-version;">
20 <?dbhtml filename="mesalib.html"?>
21
22 <sect1info>
23 <othername>$LastChangedBy$</othername>
24 <date>$Date$</date>
25 </sect1info>
26
27 <title>MesaLib-&mesalib-version;</title>
28
29 <indexterm zone="mesalib">
30 <primary sortas="a-MesaLib">MesaLib</primary>
31 </indexterm>
32
33 <sect2 role="package">
34 <title>Introduction to MesaLib</title>
35
36 <para><application>Mesa</application> is an OpenGL compatible 3-D graphics
37 library.</para>
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>Download (HTTP): <ulink url="&mesalib-download-http;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download (FTP): <ulink url="&mesalib-download-ftp;"/></para>
46 </listitem>
47 <listitem>
48 <para>Download MD5 sum: &mesalib-md5sum;</para>
49 </listitem>
50 <listitem>
51 <para>Download size (including recommended download):
52 &mesalib-size;</para>
53 </listitem>
54 <listitem>
55 <para>Estimated disk space required (including recommended download):
56 &mesalib-buildsize;</para>
57 </listitem>
58 <listitem>
59 <para>Estimated build time (including recommended download):
60 &mesalib-time;</para>
61 </listitem>
62 </itemizedlist>
63
64 <bridgehead renderas="sect3">MesaLib Dependencies</bridgehead>
65
66 <bridgehead renderas="sect4">Required</bridgehead>
67 <para role="required"><xref linkend="xorg7-lib"/>,
68 <xref linkend="xorg7-util"/>, and
69 <xref linkend="libdrm"/></para>
70
71 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude"
72 href="../../xincludes/xorg7-only.xml"/>
73
74 <!-- <note>
75 <para>It is not recommended to build a newer version of
76 <application>Mesa</application> with <xref linkend="xfree86"/>.</para>
77 </note> -->
78
79 <bridgehead renderas="sect3">Recommended Download</bridgehead>
80 <itemizedlist spacing="compact">
81 <listitem>
82 <para>Demonstration and diagnostic utilities used to verify that GL is
83 working properly: <ulink url="&mesademos-download-http;"/></para>
84 </listitem>
85 </itemizedlist>
86
87 <bridgehead renderas="sect3">Optional Download</bridgehead>
88 <itemizedlist spacing="compact">
89 <listitem>
90 <para>MesaLib GLUT library: <ulink url="&mesaglut-download-http;"/></para>
91 </listitem>
92 </itemizedlist>
93
94 <para condition="html" role="usernotes">User Notes:
95 <ulink url="&blfs-wiki;/mesalib"/></para>
96
97 </sect2>
98
99 <sect2 role="installation">
100 <title>Installation of MesaLib</title>
101
102 <para>Extract all three tarballs from the same top-level directory as they
103 all will extract to the
104 <filename class="directory">Mesa-&mesalib-version;</filename>
105 directory.</para>
106
107 <!-- Commenting this out as there is already mention of this
108 <caution>
109 <para>You should ensure that the <envar>XORG_PREFIX</envar> variable in
110 the commands below is the same as the one used in the installation prefix
111 of <application>Xorg</application>.</para>
112 </caution>
113 -->
114
115 <para>Fix an error with output redirection if <command>/bin/sh</command>
116 is not the <application>Bash</application> shell on your system:</para>
117
118<screen><userinput>sed -i 's%&gt;&amp; /dev/null%&gt;/dev/null%' src/mesa/drivers/dri/Makefile.template</userinput></screen>
119
120 <para>Install <application>MesaLib</application> by running the following
121 commands:</para>
122
123<screen><userinput>find . -type f -exec sed -i "s@/usr/X11R6@$XORG_PREFIX@g" {} \; &amp;&amp;
124sed -i 's@lib/modules@lib/X11/modules@' \
125 src/glx/x11/dri_glx.c \
126 src/mesa/drivers/dri/Makefile.template &amp;&amp;
127make OPT_FLAGS="-O2 -fno-strict-aliasing" linux-dri-x86</userinput></screen>
128
129 <para>If you downloaded and extracted the Demos package, build the programs
130 with the following commands:</para>
131
132<screen><userinput>sed -i 's@-l$(GLUT_LIB)@@g' configs/default &amp;&amp;
133make -C progs/xdemos PROGS='glxinfo glxgears'</userinput></screen>
134
135 <para>This package does not come with a test suite.</para>
136
137 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
138
139<screen role="root"><userinput>bin/installmesa $XORG_PREFIX &amp;&amp;
140install -v -m755 -d $XORG_PREFIX/lib/X11/modules/dri &amp;&amp;
141install -v -m755 lib/*dri* $XORG_PREFIX/lib/X11/modules/dri</userinput></screen>
142
143 <para>If you built the demo programs, install them using the following
144 command as the <systemitem class="username">root</systemitem> user:</para>
145
146<screen role="root"><userinput>install -v -m755 progs/xdemos/glx{info,gears} $XORG_PREFIX/bin</userinput></screen>
147
148 <para>Finally, if installing to any prefix other than
149 <filename class="directory">/usr</filename>, you should create symlinks
150 to the GL headers in <filename class="directory">/usr/include</filename>.
151 Execute the following command as the
152 <systemitem class="username">root</systemitem> user:</para>
153
154 <tip>
155 <para>Do not remove the Mesa source tree yet, it will be required to
156 build the <xref linkend="xorg7-server"/>.</para>
157 </tip>
158
159<screen role="root"><userinput>ln -s -v $XORG_PREFIX/include/GL /usr/include</userinput></screen>
160
161 </sect2>
162
163 <sect2 role="commands">
164 <title>Command Explanations</title>
165
166 <para><command>find ... sed -i "s@/usr/X11R6@$XORG_PREFIX@" ...</command>:
167 This command corrects several hard coded references to the X11R6 default
168 installation path.</para>
169
170 <para><command>sed -i 's@lib/modules@lib/X11/modules@' ...</command>:
171 This command corrects a hard coded reference to the module directory.</para>
172
173 <para><command>make OPT_FLAGS=... linux-dri-x86</command>: A bug where
174 OpenGL applications are shifted to the left by 50% can be worked around
175 by adding <option>-fno-strict-aliasing</option> to the compiler flags.
176 Also, the <option>linux-dri-x86</option> target is specified to use a
177 few other helpful flags in addition to the defaults. See the other
178 targets in the <filename class="directory">configs</filename> directory
179 if your architecture is not x86.</para>
180
181 <para><command>sed -i 's@-l$(GLUT_LIB)@@g' configs/default</command>:
182 Disables linking against the GLUT libraries for the demo programs, omit
183 this command if you downloaded and extracted the GLUT tarball.</para>
184
185 <para><command>make ... PROGS='glxinfo glxgears'</command>: Only builds
186 the <command>glxinfo</command> and <command>glxgears</command>
187 programs.</para>
188
189 <para><command>bin/installmesa</command>: Mesa uses a custom installation
190 script as opposed to the normal <parameter>install</parameter>
191 <command>make</command> target.</para>
192
193 <para><command>install -v -m755 lib/*dri*
194 $XORG_PREFIX/lib/X11/modules/dri</command>:
195 installs the DRI modules.</para>
196
197 </sect2>
198
199 <sect2 role="content">
200 <title>Contents</title>
201
202 <segmentedlist>
203 <segtitle>Installed Programs (optional)</segtitle>
204 <segtitle>Installed Libraries</segtitle>
205 <segtitle>Installed Directory</segtitle>
206
207 <seglistitem>
208 <seg>glxgears and glxinfo</seg>
209 <seg>libGL.{so,a}, libGLU.{so,a}, libGLw.{so,a}, *_dri.so and
210 optionally, libglut.{so,a}</seg>
211 <seg>$XORG_PREFIX/lib/modules/dri</seg>
212 </seglistitem>
213 </segmentedlist>
214
215 <variablelist>
216 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
217 <?dbfo list-presentation="list"?>
218 <?dbhtml list-presentation="table"?>
219
220 <varlistentry id="glxgears">
221 <term><filename>glxgears</filename></term>
222 <listitem>
223 <para>is a GL demo useful for troubleshooting graphics
224 problems.</para>
225 <indexterm zone="mesalib glxgears">
226 <primary sortas="b-glxgears">glxgears</primary>
227 </indexterm>
228 </listitem>
229 </varlistentry>
230
231 <varlistentry id="glxinfo">
232 <term><filename>glxinfo</filename></term>
233 <listitem>
234 <para>is a diagnostic program that displays information about the
235 graphics hardware and installed GL libraries.</para>
236 <indexterm zone="mesalib glxinfo">
237 <primary sortas="b-glxinfo">glxinfo</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 </variablelist>
243
244 </sect2>
245
246</sect1>
Note: See TracBrowser for help on using the repository browser.