summaryrefslogtreecommitdiff
path: root/doc/html/build.html
blob: 7fe2a21bca8e2b901e59cdaad9b9f39a31c5f738 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>

<HEAD>
  <TITLE>How to build glean</TITLE>
  <META NAME="description" CONTENT="building glean">
  <META NAME="author" CONTENT="Allen Akin">
  <LINK REV="made" HREF="mailto:akin@pobox.com">
  <LINK rel="stylesheet" href="http://sourceforge.net/sourceforge.css"
    type="text/css">
</HEAD>

<BODY bgcolor=#FFFFFF topmargin="0" bottommargin="0" leftmargin="0"
  rightmargin="0" marginheight="0" marginwidth="0">

<H1>How do I build <I>glean</I>?</H1>

<P>
<I>Note:  Some pre-built executable versions of </I>glean<I> are available.
Check the <A HREF="http://sourceforge.net/project/filelist.php?form_grp=430">
</I>glean<I> downloads page on SourceForge</A> for files whose names contain
the string </I><KBD>exe</KBD><I>.</I>

<P>
<I>glean</I> is intended to run on a variety of operating systems.
It has been tested on Linux-based GNU systems with the XFree86
X11 server, and on Microsoft Windows.

<P>
To help port <I>glean</I> to other
systems, please see <A HREF="next.html">Where do we go from here?</A>.

<H2>Other software you'll need before you can build <I>glean</I></H2>

<P>
<I>glean</I> stores images in the TIFF format, because it's one of
the few standard formats that's capable of handling images with 32-bit
and floating-point color values.  The best widely-available library for
handling TIFF is <A HREF="ftp://ftp.sgi.com/graphics/tiff">Sam Leffler's
libtiff</A>.  Your operating system may include this library already
(most Linux distributions do); if not, you'll need to obtain a copy of
the source and compile it according to the instructions contained therein.
The pre-built executables for <I>glean</I> on Windows have been statically
linked with libTIFF, so there's no need to provide it separately if you're
using those executables.

<P>
Some of the tools in the <I>glean</I> suite (though not <I>glean</I>
itself) use <A HREF="http://reality.sgi.com/opengl/glut3/glut3.html">Mark
Kilgard's GLUT library</A>.  Again, your OS (or your <A
HREF="http://www.mesa3d.org/">MESA</A> distribution) may already include
GLUT, but if not, you'll need to grab a copy and install it.

<P>
Once you've completed those tasks, choose one of the following:

<UL>
  <LI><A HREF="buildgnu.html">Building <I>glean</I> for GNU/Linux</A></LI>
  <LI><A HREF="buildwin.html">Building <I>glean</I> for Windows</A></LI>
</UL>


<HR>
<SMALL>
  <UL TYPE=DISC>
    <LI> <A HREF="index.html"><I>glean</I> home</A>
    <LI> <A HREF="whatis.html">What is <I>glean</I>?</A>
    <LI> <A HREF="build.html">How do I build <I>glean</I>?</A>
    <LI> <A HREF="run.html">How do I run <I>glean</I>?</A>
    <LI> <A HREF="next.html">Where do we go from here?</A>
      <UL TYPE=CIRCLE>
        <LI> <A HREF="newtest.html">Adding new tests</A>
	<LI> <A HREF="newfeat.html">Adding new infrastructure features</A>
	<LI> <A HREF="overview.html">Overview of <I>glean</I> internals</A>
        <LI> <A HREF="repo.html">Creating a repository of results</A>
        <LI> <A HREF="port.html">Porting <I>glean</I></A>
        <LI> <A HREF="cleanup.html">Cleaning up loose ends</A>
      </UL>
    <LI> <A HREF="changes.html">What has changed recently?</A>
  </UL>
</SMALL>

</BODY>
</HTML>