libgeotiff
This library is designed to permit the extraction and parsing of the "GeoTIFF" Key directories, as well as definition and installation of GeoTIFF keys in new files. More information about GeoTIFF specifications, projection codes and use can be found here. Information on the mailing list and archived SVN repository can be found here
Archived releases can be found on the GitHub releases page or the OSGeo archive page
To ask questions and to follow release announcements, subscribe at the mailing list.
You can also report issues (do not use issue tracker for questions)
Dependencies
SQLite3, as a dependency of PROJ
Compilation Instructions
libgeotiff
supports out of tree builds.
Linux
cd libgeotiff
./autogen.sh
./configure
make dist
tar xvzf libgeotiff*.tar.gz
cd libgeotiff*
mkdir build_autoconf
cd build_autoconf
CFLAGS="-Wall -Wextra -Werror" ../configure
make -j3
make check
cd ..
mkdir build_cmake
cd build_cmake
cmake -DCMAKE_C_COMPILER_LAUNCHER=ccache -DCMAKE_C_FLAGS="-Wall -Wextra -Werror" ..
make -j3
Windows
libgeotiff
should work with the Visual Studio toolchain. See .appveyor.yml for example.
cd libgeotiff
mkdir build && cd build
cmake -G "%VS_FULL%" .. -DBUILD_SHARED_LIBS=ON -DCMAKE_BUILD_TYPE=Release -DCMAKE_C_FLAGS="/WX" -DCMAKE_CXX_FLAGS="/WX" -DCMAKE_INSTALL_PREFIX="%BUILD_FOLDER%/install" -DPROJ_INCLUDE_DIR="%BUILD_FOLDER%/install/include" -DPROJ_LIBRARY="%BUILD_FOLDER%/install/lib/proj.lib" -DCMAKE_TOOLCHAIN_FILE=c:/projects/libgeotiff/vcpkg/scripts/buildsystems/vcpkg.cmake
cmake --build . --config Release --target install
Testing
There are two demonstration test programs makegeo
and listgeo
that create and list-out the GeoTIFF tags and keys associated with a small TIFF file, as well as a full-featured utility called geotifcp
. These will all be built in the bin/
directory as a matter of course, though may require modification if you are not using LibTIFF
, as they make explicit calls to LibTIFF
for opening the files and setting the tags.
To run them simply call:
./makegeo
./listgeo newgeo.tif
to generate and list an example GeoTIFF file. To see the geotifcp
utility in action, first call:
listgeo newgeo.tif > metadata.txt
to create a GeoTIFF metadata file metadata.txt
, and then
geotifcp -g metadata.txt newgeo.tif newer.tif
to copy the TIFF file newgeo.tif
to newer.tif
, using the GeoTIFF metadata as stored in metadata.txt
. See docs/manual.txt
for further uses of geotifcp.
To convert a projection metafile, an ESRI world file, and a raw TIFF file into a GeoTIFF file do something like the following:
tiffcp -g metadata.txt -e abc.tfw abc.tif geo_abc.tif
License
Credits
-
This library was originally written by Niles Ritter (also the primary author of the GeoTIFF specification).
-
Eric Brown of Universal Systems, who contributed a bug fix to
GTIFPCSToImage()
. -
Safe Software who supported by upgrade to use the
EPSG 6.2.2
database forlibgeotiff 1.2.0
. -
Many others who contributed before it occured to me to maintain credits.