geography/fGIS/install.html

   1 <HTML>
   2 <HEAD>
   3 <TITLE>fGIS installation instruction</TITLE>
   4 </HEAD>
   5 <BODY>
   6
   7
   8 <H1>fGIS installation instructions</H1>
   9 <B>Before compiling and installing fGIS you should have working
  10 installation of Tcl/Tk 8.0</B>
  11 <P>
  12 Pre-alpha snapshots of fGIS source tree do not include correct
  13 install target in makefile.
  14 <P>
  15 So, you must install it by hand. Source tree is organized such way that
  16 fGIS can be loaded directly from compilation directory.
  17 <P>
  18 fGIS library directory should reside somewhere Tcl can find its packages
  19 i.e. as subdirectory of one of directories in tcl_pkgPath.
  20 <P>
  21 Directory tree should have following structure:
  22 <PRE>
  23   fgis
  24     |
  25     +-pkgIndex.tcl
  26     +-fgis.so (fgis.dll)
  27     +-fgis.rc
  28     +-tcl/
  29     |   |
  30     |   +- various scripts
  31     |
  32     +--colors/
  33     |   |
  34     |   +-color palettes (*.clr)
  35     |
  36     +--symbols/
  37         |
  38         +-- symbol files (*.sym)
  39
  40 </PRE>
  41
  42 fGIS initialization code uses some heuristics to find where its support
  43 files are located, but sureest method is to set Tcl variable
  44 fGIS_HOME to the top of fGIS library directory before loading dynamic
  45 library.
  46 <P>
  47 your pkgIndex.tcl can look as
  48 <PRE>
  49 package ifneeded Fgis 1.0 {set fGIS_HOME /usr/local/lib/fgis; load /usr/local/lib/fgis/fgis.so}
  50 </PRE>
  51 <P>
  52 Directory tcl in fgis source tree contain two executable scripts -
  53 <CODE>mapview</CODE> and <CODE>hypermap</CODE>. They are sample fGIS
  54 applications. In Unix they can be easily moved to any directory in your
  55 PATH - with correctly set up pkgIndex.tcl they'll find support files
  56 anywhere. On windows they should be renamed to <CODE>mapview.tcl</CODE> and
  57 <CODE>hypermap.tcl</CODE> so they could be started with double click.
  58 <P>
  59 More to follow soon..
  60 </BODY>
  61 </HTML>
  62
  63
  64
  65
  66