Compiling IIKH

1) Compiling on Unix (Solaris, Linux, BSD, etc.)
2) Compiling on Windows (Windows 95-Windows XP)

************************************************************
1 -- Compiling on Unix (Solaris, Linux, BSD, etc.)
************************************************************
This document contains instructions to compile
IIKH on various version of Unix.

Since most versions of unix have libjpeg already installed
you will only need the FLTK library, which is included on 
the CD. 

==== Compiling fltk-1.1.4 =================================
Compiling fltk-1.1.4 is very simple on Unix. After
extracting it to its directory you need to type the 
following lines:

$ ./configure
$ make

If you can't do this we have precompiled libraries that you
can use on the distribution CD.

==== Compiling IIKH v1 ====================================
Before you can compile IIKH, you should check the Makefile
and make sure that the search patchs for fltk are correct.

Then just type "make"

This will produce an iikh binary.


Before you can run iikh, you should convert the Recipes.txt
file to a unix format. Right now it is in a DOS format.

To convert simply type:

dos2unix -ascii Recipes.txt

If you don't want to do any of this, we also have 
precompiled versions for you.


************************************************************
2 --  Compiling on Windows (Windows 95-Windows XP)
************************************************************

This document contains instructions to compile
IIKH on Windows.

I have used Visual C++ v6.0 with Service Pack 5.
If you do not have Service Pack 5, please install
it. Compiling the program without Service Pack 5 
may result in unexpected or undesired behavior.

First, before you can compile IIKH you need 2 
external libraries.

The following libraries are needed:

libjpeg-v6b
fltk-1.1.4


==== Compiling libjpeg ====================================
libjpeg-v6b can be obtained from the Independent JPEG Group
at http://www.ijg.org/files/

The file you want to get is "jpegsrc.v6b.tar.gz". If this
file is no longer availible you can also get it from the
distribution CD. We have included this library in the event
that it is no longer availible.

The Makefile shipped with libjpeg is written for Visual C++
v4.0 which is not compatible with Visual C++ v6.

To compile, you need to copy the new Makefile that is
updated for Visual C++ 6 and type:

nmake nodebug=1

We aren't interested in debugging libjpeg so we don't want
to produce a debug enabled build.

After it compiles you will get a libjpeg.lib file.

If you don't wish to do this, we also provide a precompiled
version of libjpeg for you.

==== Compiling fltk-1.1.4 =================================
fltk-1.1.4 can be obtained from the FLTK homepage, however
at this time of writing the FLTK group is releasing 
fltk-1.1.5 and so various release canidates are now only 
being offered for download.

We also include fltk-1.1.4 on the distribution CD.

FLTK is compilable out of the box, however we want to tell
FLTK to use our version of libjpeg. (By default FLTK is not
able to display images). To do this, we need to edit the
config.h file in the visualc directory and change the 
LIBJPEG line to:

#define HAVE_LIBJPEG 1

When you compile the fltk-1.1.4 library you will have to
specify the location of the include files for libjpeg.

Make sure you set the build type to be a "Release Build"
and not a "Debug Build".

If you don't wish to do this, we also provide a precompiled
version of the fltk-1.1.4 libs for you.

==== Compiling IIKH v1 ===================================
Compiling IIKH under Visual C++ 6 is fairly easy. Just
double click on the DSW (Developer Studio Workspace) file 
included with the source code.

This will load the correct DSP (Developer Studio Project)
file. By default the DSP file assumes that FLTK is 
installed at C:\FLTK-1.1.4\ and the various libs needed
are in C:\FLTK-1.1.4\LIB (including the libjpeg lib as well)

IIKH.exe will be linked statically with fltk.lib, 
fltkimages.lib and also libjpeg.lib

If you are not able to compile IIKH or don't feel like
compiling it, we also provide a precompiled EXE for you.




