| 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/ |