Basic Image AlgorithmS Library
2.8.0
|
This library can be built with different compiler and under different operating systems, in particular with gcc 3.3/4.1 on Linux and Microsoft Visual Studio .NET 2003 on Windows.
You need to install a recent version of cmake from www.cmake.org. CMakeLists.txt files are used as input by cmake to generate Makefiles on Linux and Visual Studio project files on Windows (or nmake files).
BIAS requires some packages to be properly installed and can use some others to extend its own functions. Optional and mandatory packages are (as in BIAS/DEPENDENCIES):
Common ====== Because the build-system of BIAS is based on CMake (www.kitware.com) you must have properly installed these tools: * cmake (newest version, at least 2.0.3, see www.cmake.org) Most of the subdir MathAlgo is based on Blas/Lapack, so BIAS depends on: * lapack/blas (see below for Win32 hints) UNIX ==== There are some packages which have to be installed in order for BIAS to be built and to work correctly. Currently BIAS depends on: * libuuid (belongs to ext2 file system tools) * g2c/f2c (fortran-to-c) * make (GNU-make prefered, other untested) * a compiler (gcc/g++ 4.1 prefered) BIAS has interfaces for or supports the following packages (optional): * libdv * fftw3 * GSL (GNU Scientific Library) * ImageMagick (e.g. ImageMagick-6.2.0-Q16) * OpenCV (e.g. 2.0) * OpenGL * OpenEXR * Pthreads * wxWidgets (e.g. 2.6.3) * libxml2 (e.g. 2.5.10-25) * .. and more, see USE_* flags WINDOWS ====== BIAS is developed in parallel on PC hardware on Linux OS with gcc (4.1) and Windows XP with MS Visual Studio .NET 2003. Older Version of MSVS are not supported because of their broken template compilation engine. Under MS Windows there are the following dependencies: * lapack/blas (found at http://www.cs.unc.edu/~kim/lapack/VCLapack.zip Alternative download: http://www.mip.informatik.uni-kiel.de/~wwwadmin/Software/Download/VCLapack.zip http://www.mip.informatik.uni-kiel.de/~wwwadmin/Software/Download/VCBlas.zip You will have to download both zip-archives and to extract them to a place where libs and headers are found by the CMake scripts. set Path variable to both .dll files and ENV variables (LAPACK_HOME and BLAS_HOME) to the directory which containes lapack, blas and f2c.h (def's needed)) optional: * libXML2 2.5.10 (which depends on zlib and iconv. All this can be - 2.6.11 found at http://www.zlatkovic.com/libxml.en.html. For configuration with CMake, set environment variables XML2_HOME, ICONV_HOME and ZLIB_HOME. For runtime set PATH to the directories that containes all three DLL's or copy DLL's into systemdir) * ImageMagick (e.g. ImageMagick-6.2.0-Q16) www.imagemagick.org * OpenCV (e.g beta5a) sourceforge.net/projects/opencvlibrary/ * wxWidgets (e.g. version 2.6.3) www.wxwidgets.org * Pthreads * OpenGL * glut * glew * DevIL * GSL * OpenEXR * Nvidia StereoI (stereo rendering API, supports Shutter glasses, anaglyph red/green and more) * FFTW3 * ... and more, see USE_* options in cmake. Feel free to contact the developers (www.mip.informatik.uni-kiel.de) for multi platform and Windows details or write to the BIAS mailing list.
WIN32 Note: BIAS is frequently tested with "multithreaded shared debug" runtime libs ("/MDd") and NOT using UNICODE. However, other configurations such as release or static (e.g. "/MT") should work, too - but these are less frequently tested.
Installation of BIAS as described in BIAS/INSTALL is as following:
INSTALL howto for the BIAS library QUICKINSTALL: > get BIAS source > get CMakeModules > setenv CMAKE_MODULE_PATH to directory of CMakeModules > cmake . > make Building BIAS with CMake ------------------------ Prerequisites: (1) Install newest cmake version (minimum 2.4.5) from www.cmake.org (2) If you have a tar.gz BIAS version, all necessary CMake scripts will be inside that archive and you can proceed with step (3). When using the BIAS cvs access, you need to fetch build system scripts(2.1) and tell where they are(2.2): (2.1) Checkout our CMakeModules directory (same CVS settings as BIAS) containing additional find package macros for BIAS: > cvs co CMakeModules (2.2) Let environment variable CMAKE_MODULE_PATH point to the CMakeModules directory, e.g. on bash: > export CMAKE_MODULE_PATH=/home/user/CMakeModules or on tcsh: > setenv CMAKE_MODULE_PATH /home/user/CMakeModules (3) checkout/install BIAS source code. (4) configure run cmake to change options and to generate makefiles. example for an in-place build on Linux: cd to source directory of BIAS > cd BIAS configure and generate makefiles: On Linux you can either use the command line based version with: > ccmake . (mind the 'dot') See the bottom line for usage instructions, in particular: - press 'c', then modify options as required and press 'c' again to configure - finally press 'g' to generate Makefiles Or you can use the cmake GUI cmake-gui which is more convinient. On Win32: > CMakeSetup.exe The GUI is self-explaining. Note: You can also use > cmake . directly if you prefer command line instead of graphical interface. (4.2) configure examples: With the option BUILD_EXAMPLES at the you may switch the building of example binaries. > make (5) compile: > make (6) install: (optional, not required) > make install See ReadmeCMake.txt for further information. The MIP group: 12/2003 - 02/2011
Feel free to write to the BIAS Mailing List for details.