Debian Codegraph @

INSTALL

raw
1 FTGL Version 2.0.5
2
3 This project will build a static library (archive) in the src directory.
4
5 The Makefiles need GNU Make in order to work properly.
6
7 The easiest way to start is to try autogen.
8
9 $ ./autogen.sh
10
11 If this completes successfully, it means that the system was able to
12 deduce the location of all prerequisites. Next, configure the makefiles
13
14 $ ./configure
15
16 This will configure the default build configuration with a target install
17 directory of /usr/local. This is adequate for most users.
18
19 FTGL requires the Freetype2 library (version 2.0.9 or later) and OpenGL
20 (glu version 1.2 or later). If these libraries cannot be found by autogen,
21 you can pass flags to the configure script to point it to the place where
22 these libraries are installed, like this:
23
24 $ ./configure --with-gl-inc=/usr/local/include \
25 --with-gl-lib=/usr/local/lib
26
27 Should you need anything more complicated that that, try with:
28
29 $ ./configure --with-gl-inc=/usr/local/include \
30 --with-gl-lib="-L/weird/location -lGL -lX11 -lXi -lXm"
31
32 The same thing goes for the GLUT library. This is optional and is only
33 needed to build the demo program. Should any of this fail, please send
34 an email to [email protected] (please include FTGL somewhere in the
35 subject line) and include a copy of the config.log file that was left
36 behind.
37
38 Once the build is configured, simple run make
39
40 $ make
41
42 To install the library, you will probably require superuser permission:
43
44 $ sudo make install
45
46 If doxygen is installed, documentation in HTML format will be generated
47 in the docs subdirectory.
48
49 To use FTGL in your own projects you will need to link against this lib
50 and include the FTGL headers located in the src directory. Your project
51 will also need Freetype and OpenGL. For your convinience a pkg-config
52 metadata file has been included (ftgl.pc) and gets installed in
53 <libdir>/pkgconfig, where pkg-config should be able to find it. In
54 order to take advantage of this, just include something like this in
55 your makefiles:
56
57 FTGL_CPPFLAGS := $(shell pkg-config --cflags ftgl)
58 FTGL_LDFLAGS := $(shell pkg-config --libs-only-L ftgl)
59 FTGL_LIBS := $(shell pkg-config --libs-only-l ftgl)
60
61 The names of these variables should be self-explanatory. Note that
62 FTGL_LIBS will include -lGL, you shouldn't specify that flag separately.
63
64 For instructions on using Freetype go to http://www.freetype.org/
65 For instructions on using OpenGL go to http://www.opengl.org/
66
67 Please contact me if you have any suggestions, feature requests, or
68 problems.
69
70 Henry Maddocks
71 [email protected]
72 http://homepages.paradise.net.nz/henryj/