"Fossies" - the Fresh Open Source Software Archive

Member "libgeotiff-1.6.0/README" (28 May 2019, 4890 Bytes) of package /linux/privat/libgeotiff-1.6.0.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the latest Fossies "Diffs" side-by-side code changes report for "README": 1.5.1_vs_1.6.0.

    1 About LIBGEOTIFF:
    2 -----------------
    3 
    4 This library is designed to permit the extraction and parsing of the
    5 "GeoTIFF" Key directories, as well as definition and installation
    6 of GeoTIFF keys in new files. For more information about GeoTIFF
    7 specifications, projection codes and use, see the WWW web page at:
    8 
    9    http://geotiff.osgeo.org/
   10 
   11 or the download archive at:
   12 
   13    http://download.osgeo.org/geotiff/
   14    
   15 Mailing List
   16 ------------
   17 
   18 To ask questions and to follow release announcements, subscribe at:
   19 
   20    https://lists.osgeo.org/mailman/listinfo/geotiff
   21 
   22 
   23 Use of LIBTIFF
   24 --------------
   25 
   26 The default configuration assumes that the public-domain LIBTIFF
   27 package for reading and writing TIFF files has been installed, with
   28 the development kit (include files).  The latest version of libtiff may 
   29 be found at:
   30 
   31    http://www.simplesystems.org/libtiff/
   32 
   33 For this build to work you must use libtiff version v3.6.0 alpha or newer.
   34 
   35 Use of PROJ
   36 -----------
   37 
   38 PROJ 6 or later is a required dependency of libgeotiff 1.5 or later.
   39 The latest version of PROJ can be found at
   40 
   41    https://proj4.org/
   42 
   43 
   44 Building LIBGEOTIFF:
   45 --------------------
   46 
   47 Assuming that whatever TIFF library you use has been built, and installed
   48 may now build the rest of the geotiff library with:
   49 
   50    % cd libgeotiff
   51    % ./configure --with-proj=/contrib/proj-6
   52    % make 
   53 
   54 Common Configuration Issues:
   55 
   56  o If you want to alter the compiler used, set the CC environment variable
   57    before running configure.  
   58 
   59    % setenv CC cc
   60    % rm config.status
   61    % ./configure
   62    % make clean 
   63    % make 
   64 
   65  o If you want to control the compiler files, set the CFLAGS environment 
   66    variable.  This can be used to override the default optimization/debug
   67    flags for instance.
   68 
   69    % setenv CFLAGS -O4
   70    % rm config.status
   71    % ./configure
   72    % make clean 
   73    % make
   74 
   75  o If you want to force use of a locally built libtiff that was never 
   76    "installed" you can point to the directory like this:
   77 
   78    % rm config.status
   79    % ./configure --with-libtiff=/u/contrib/libtiff-3.6.0/libtiff
   80    % make clean 
   81    % make
   82 
   83  o If you have installed libtiff in a location other than /usr, then you can
   84    point to the install tree like this:
   85 
   86    % rm config.status
   87    % ./configure --with-libtiff=/usr/local
   88    % make clean 
   89    % make
   90 
   91  o The logic to build shared libraries is pretty weak, and is likely to
   92    only work on systems with the GNU tool chain (gcc, and ld) installed. 
   93    On other systems you can try hacking on Makefile after running configure.
   94    It may be necessary to set the GEOTIFF_SO macro to "libgeotiff.1.2.x"
   95    as it is made empty by default on systems configure doesn't think can 
   96    build shared libraries.
   97 
   98 
   99 Test Programs:
  100 
  101 There are two demonstration test programs "makegeo" and "listgeo"
  102 that create and list-out the GeoTIFF tags and keys associated 
  103 with a small TIFF file, as well as a full-featured utility called
  104 "geotifcp". These will all be built in the bin/ directory as a matter of 
  105 course, though may require modification if you are not using LIBTIFF, as they
  106 make explicit calls to LIBTIFF for opening the files and setting the
  107 tags. To run them simply call:
  108 
  109   % bin/makegeo
  110   % bin/listgeo newgeo.tif
  111 
  112 to generate and list an example GeoTIFF file. To see the
  113 "geotifcp" utility in action, first call:
  114 
  115   %  bin/listgeo newgeo.tif > metadata.txt
  116  
  117 to create a GeoTIFF metadata file "metadata.txt", and then
  118 
  119   %  bin/geotifcp  -g  metadata.txt  newgeo.tif  newer.tif
  120  
  121 to copy the TIFF file newgeo.tif to newer.tif, using the
  122 GeoTIFF metadata as stored in "metadata.txt". See "docs/manual.txt"
  123 for further uses of geotifcp.
  124 
  125 To convert a projection metafile, an ESRI world file, and a raw TIFF file
  126 into a GeoTIFF file do something like the following:
  127 
  128   % bin/tiffcp -g metadata.txt -e abc.tfw abc.tif geo_abc.tif
  129 
  130 
  131  
  132 Non-Standard Configuration:
  133 ---------------------------
  134 
  135 If you are using a TIFF software package other than libtiff, then you
  136 must override the TIFF file methods used in LIBGEOTIFF. To do this, 
  137 go into directory libgeotiff and edit the files:
  138 
  139     "geo_tiffp.h"
  140     "geo_tiffp.c"
  141     
  142 which contain all of the TIFF externals. You will need to define your
  143 own versions of the TIFF tag reading, writing, and memory allocation
  144 calls. See the comments of those two files to see what needs to be
  145 changed. Also, whatever software package you use will have to 
  146 recognize the GeoTIFF tags listed in the include files, and permit
  147 variable-length arrays to be passed in to those tags.
  148 
  149 
  150 Credits
  151 -------
  152 
  153  o This library was originally written by Niles Ritter (also the primary
  154    author of the GeoTIFF specification).  
  155 
  156  o Eric Brown of Universal Systems, who contributed a bug fix to 
  157    GTIFPCSToImage().
  158 
  159  o Safe Software (www.safe.com) who supported by upgrade to use the 
  160    EPSG 6.2.2 database for libgeotiff 1.2.0.
  161 
  162  o Many others who contributed before it occured to me to maintain credits.
  163 
  164