Boolean Install
Problems
Contact me at ngi@klaasholwerda.nl
I did test on:
- windows XP and NT
- Linux using Redhat fedora 2
- Solaris
I am interested to know on which other platform you succeed to run
boolean.
Unzip distribution
UnZip the distribution in any directory you like.
I assume from now on that on windows you use
c:/tools/boolean or /usr/tools/boolean
on Unix.
The boolean distribuation contains one Module called kbool
which is
the algorithm to perform boolean operation. The Application called edit
is to read, edit and save files. Within edit the kbool
module
is used for performing boolean operations
on layers.
Install wxWidgets
The wxWidgets libary is used for the Graphical User Interface within
the
Boolean package.
In case you are going to compile yourself or you are using the dynamic
linked wxWidgets library, you first need to install the wxWidgets
library
which can be downloaded here http://www.wxWidgets.org
On Unix i used wxGTK sofar. Since wxGTK uses GTK/GLIB libraries
internal,
it might be necessary to also install those.
i recommend using Gtk2 as a start, this option is on by default.
I tested with wxWidgets 2.6.2, and i suggest to always used the latest
in
case of problems.
Download Cmake
If you want to compile Boolean yourself, download and install cmake
to
be found at http://www.cmake.org.
If you do not need to compile because you downloaded the binary, skip
this
step.
Cmake is used to generate:
- VC project files or
- nmake files or
- Borland files make or
- Unix make files
On Windows
Just run CMakeSetup on windows click on the line "Where is the source
installed"
and browse to where you installed boolean.
In our case c:/tools/boolean
and
on the line "Where to build binaries" and browse to where you installed
boolean.
(this maybe be any other directory also, e.g. c:/tools/boolean
/VCprojects.)
Choose in the "Build for line" the type of build you want to use.
Now click the button configure twice, and check the path to where your
wxWidgets
distribution was installed.
You can change them by hand if needed.
Last click on Ok.
Go into the directory you used for the build and type (
nmake for Visual C ).
In case of generating project files, open those instead.
On Unix
Make sure wx-config can be found, using
the
command which wx-config. If not extend
the path
to include
the path to the place where wxWidgets was installed. The default place
is
/usr/local/bin/wx-config.
Just type cmake within the directory
where you
installed the Boolean package.
After that type make or gmake.
Environment variables
The Boolean Application called edit uses two environment
variables.
- GDSROOT needs to be defined in order
for
boolean to find its settings
- HOME needs to be defined for boolean
in
order to save user changes.
In our example case this means:
- GDSROOT needs to point to
c:/tools/boolean/apps/edit
or on Unix /usr/tools/boolean/
apps/edit
- HOME may point to any place, but in
that
place you need to copy the following directory and its contents
c:/tools/boolean/apps/edit
/gdsuser.
On unix as well PC, $HOME is used to overrule the default configuration
found
in $(GDSROOT)/gdsuser.
When running Boolean its edit application on Unix, edit is linked
dynamically
to the wxWidgets library.
Therefore edit needs to be able to find the installed wxWidgets
library.
Often this is already
arranged in the environment. In case of problems set the
following
variable to point to the place where
the wxWidgets libraryies recide (the default is in /usr/local/lib).
- LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH
- export LD_LIBRARY_PATH
Scripts
The two scripts in
c:/tools/boolean
/bin or
/usr/tools/boolean/bin
show how you can easily setup starting the edit application.