Readme Sources This file discribes how to build the library libpano12.so for the Linux operating system. This library is required for running any of the Panorama Tools applications (PTStitcher, etc). Legal Issues: This software is distributed under GNU-license, see the file COPYING for details. Some parts of the software are derived from other sources, which are distributed under different copyrights. These are: (1) The JPEG-library distributed by the Independent JPEG group. This package contains a precompiled binary of the JPEG library and the header files required for compilation in the folder Sources/libs/. The legal terms for using the JPEG library can be found in the file /copyright/README_JPEG. (2) The PNG-library written by G.E.Schalnat et al. This package contains a precompiled binary of the PNG library and the header files required for compilation in the folder Sources/libs/. The legal terms for using the PNG library can be found in the file Sources/libs/png.h (3) The TIFF-library by Sam Leffler/ Silicon Graphics Inc. This package contains a precompiled binary of the TIFF library and the header files required for compilation in the folder Sources/libs/. The legal terms for using the TIFF library can be found in the file /copyright/README_TIFF. (4) The ZLIB-library by Jean-loup Gailly and Mark Adler. This package contains a precompiled binary of the ZLIB library and the header files required for compilation in the folder Sources/libs/. The legal terms for using the ZLIB library can be found in the file zlib.h. (5) The public domain Levenberg-Marquardt solver of the Argonne National Laboratories MINPACK mathematical library, C translation by Steve Moshier (file lmdif.c). (6) Fast fourier transformation, code by: RC Singleton, Stanford Research Institute, Sept. 1968 Copyright MJ Olesen, Queen's University at Kingston, 1995-97. See the file fftn.c for details. BUILD INSTRUCTIONS You need the gcc compiler, libgcj and various imaging libraries: libtiff, libjpeg and libpng. Headers for these libraries are required, so you probably have to install libXXX-dev or libXXX-devel packages too. (Sun java is NOT required if you have libgcj) Compilation is straightforward: ./configure make make install If you have downloaded from CVS, you will need to bootstrap the build system first: ./bootstrap DEPRECATED BUILD INSTRUCTIONS Building the Library: The Java Development Kit is required. It can be downloaded from www.javasoft.com, or may be contained on your Linux CD. Create a directory 'pano12', move the file 'panosrc.tar.gz' into this directory, and unpack the file using the commands gzip -d panosrc.tar.gz and tar xf panosrc.tar Then build the library using the command make -f makefile.linux libpano12.so Limits and Modifications: This distribution of the sources limits processing of fisheye images to fields of view smaller than 160 degrees. This limit is controlled by the constant MAX_FISHEYE_FOV in the file filter.h. There is some controversy regarding the legality of processing hemispherical images (ie images having 180 degree field of view) in connection with virtual reality panoramas. If your application of fisheye lenses is not prohibited by patents, you can build and use your own unlimited version of the library by changing the soure code. Helmut Dersch der@fh-furtwangen.de
