==================================== - Xastir Install Extended Features - ==================================== Updated: May 20, 2004 20:52 For the latest ExtendedFeatures.txt: http://www.lintronix.com/winxastir Contents: * Xastir Source - Installing Xastir Source from CD-ROM - Installing Xastir Source from the Internet * Compiling - Compiling source manually - Compiling with the WinXastir script * Additional Xastir Libraries and Functionality - Shapelib - Imagemagick - Geotiff ------------------------------------------------------------------ Xastir Source ============= By default, Xastir source is not installed by the Cygwin package installer. You have two choices. Use the prepackaged source as included on the CD-ROM or install the latest from the web using CVS (Concurrent Version System). Installing Xastir Source from CD-ROM ------------------------------------ This will install the xastir source in /usr/src/Xastir-. If you installed Xastir source as part of the initial install, you do not need to do it again. Run Cygwin setup: CD\cygwin\setup.exe Click on [] in the Source column for Xastir Run the Install by stepping through the setup.exe dialogs. Create a soft link from the newly installed source to the simple name xastir. Do this in a Cygwin or Xterm window. cd /usr/src ln -s xastir-1.3.1-2 xastir Note that your XASTIR-SOURCE location is now /usr/src/xastir. Installing Xastir Source from the Internet ------------------------------------------ Complete instructions are in the Readme.win32. A script to help is included as part of the WinXastir distribution. From a Cygwin or Xterm window: cd /cygdrive/CDROM-LETTER/Xastir/WinLibs sh setup05-cvs.sh If everything works, you will have the latest STABLE source code for Xastir downloaded from the Concurrent Version System. Note that your XASTIR-SOURCE location if installed from CVS on the Internet would be /home/USER/xastir where USER corresponds to your login user name. ------------------------------------------------------------------ Compiling Xastir ================ Basic steps to compile manually ------------------------------- 1. go to the source directory $ cd /usr/local/xastir 2. The first time you need to run the bootstrap.sh script $ sh ./bootstrap.sh 3. Run configure to define your system configuration $ ./configure 4. Run the compile $ make 5. Install if everything compiled ok. $ make install Compile with the WinXastir script --------------------------------- A basic script is included to help with the compile From a Cygwin shell window, CD to the WinLib folder on the WinXastir CDROM. $ cd /cygdrive/CD-LETTER/xastir/WinLibs Run the compile script $ sh install09a-configuremake.sh If the compile succeeds, install the results with: $ sh install09b-install.sh ------------------------------------------------------------------ Additional Xastir Libraries and Functionality ============================================= To install the additional libraries for added functionality; from a Cygwin shell window, CD to the WinLibs folder in the WinXastir CDROM and execute install scripts. cd /cygdrive/CD-LETTER/xastir/WinLibs The install scripts need to know where the libraries are being added. Possible destinations are: /home/USER/src/xastir /usr/src/xastir Other.. If you installed the source code from the WinXastir CD, it will be in "/usr/src/xastir-" If you installed from the Internet, the source will be in your USER directory. The install scripts first look for environment variable XSRC for the source destination. If the environment variable isn't set, then the install scripts will look for a /home//src/xastir folder and if not found, then they look for /usr/src/xastir. Shapelib -------- Adding shapelib gives you the Weather counties warnings and shapefile maps. The install script will unpack the source, compile it to libraries, and place them where they belong. cd /cygdrive/CDROM-LETTER/xastir/WinLibs sh install01-shapelib.sh To use the Shapelib libraries in Xastir, you'll have to reconfigure and rebuild Xastir from source. cd # example /usr/src/xastir ./configure make make install Note that the Shapelib install script will automatically copy the Country warning files from the CDROM to the folder where Xastir needs them if they're not already there. /usr/local/share/xastir/Counties A good way to test the County warnings is to connect to the Firenet server. Create an Internet Service device for firenet, host = firenet.us' and port = 2023. Open this server. Enable Weather warnings by: Menu - Stations - Filter - Wx (finish this) Also note the County shape files don't show up in the map selections. Imagemagick ----------- Adding Imagemagick supports allow the use of .geo files and special Internet map downloads such as Tigermaps, Terraserver and Topomaps. First install LCMS - Color Management System: cd /cygdrive/CDROM-LETTER/xastir/WinLibs sh install03a-lcms.sh Then install Imagemagick: sh install03b-Imagemagick.sh Once again you'll have to reconfigure, rebuild and install Xastir to use the new functionality: cd # example /usr/src/xastir ./configure make make install Before running Xastir, you'll have to set the MAGICK_HOME environment variable. export MAGICK_HOME=/usr The readme.win32 contains several notes on how to automate this so you don't have to retype it each time you start Xastir. GeoTiff ------- First install libprog: cd /cygdrive/CDROM-LETTER/xastir/WinLibs sh install05a-libproj.sh Then install the Geo-Tiff package: sh install05b-GeoTIFF.sh Once again you'll have to reconfigure, rebuild and install Xastir to use the new functionality: cd $XSRC # example /usr/src/xastir ./configure make make install