[Opengc-devel] notes regarding build process

[Damion S. <da...@op...>]

Hi, here's a few notes about the build process for the experimental 
repository...

---
Under all platforms:

Download and install CMake version 1.8+
Download and build FLTK version 1.1.4
Download and build Freetype 2.1.4
Download and build FTGL 2.07
Download and build Plib 1.6

Other versions of these libraries may work, although I have tested only 
the above set.

---
Under Unix (includes Linux and MacOS X):

Do a "make install" on Freetype, Plib, and FTGL. "make install" for 
FTGL appears to miss some critical include files, so you will need to 
override the include directory for FTGL as described below

---

Now that you have all of the libraries built, go ahead and run CMake on 
OpenGC. Options you will have to set are:

FLTK_INCLUDE_DIR - the root directory for FLTK, for example 
/Users/beowulf/fltk-1.1.4
The various FLTK libraries will be found automatically if this is set 
correctly.

FTGL_INCLUDE_DIR - for example, /Users/beowulf/opengc/FTGL-2.07/include 
- note that under Unix you should override the path if it's identified 
as /usr/local/include, since not all required headers are copied here.
FTGL_LIBRARY - should be found automatically under Unix if you did a 
"make install", may need to be located manually under Windows or under 
Unix (without make install). Under Windows, I suggest that you pick 
ftgl_static_MT as the library.

PLIB_INCLUDE_DIR - should be found automatically under Unix, under 
Windows it's the root plib directory (the Plib project is smart enough 
to lump the headers and libraries under the root Plib dir when 
building)
Various PLIB libraries should be found automatically under both Windows 
and Unix

Once CMake is happy, go ahead and run make or Visual Studio as 
appropriate. The results of building OpenGC will include 4 libraries 
(Base, DataSources, Gauges, and Nav) and one executable (OpenGC). The 
executable behaves approximately the same as it does in the main 
repository, with the exception of GPL licensed gauges which are not 
included yet.

Please let me know if you encounter any problems. You _should not_ need 
to modify any CMakeLists.txt files in order to get a successful build. 
If you do, I made a mistake somewhere. As of 6:20 pm EST, the new 
repository is building correctly on both Windows and Mac OS 10.3.

Cheers,
-Damion-