Installation
HornetsEye does not reinvent the wheel. It relies on a number of packages which you need to install first. Under GNU+Linux you can build HornetsEye the standard way as explained below. Since building under Microsoft Windows is considerably more difficult, an installation package is provided.
| Installation | HornetsEye does not reinvent the wheel. |
| GNU+Linux | If you have GNU+Linux (I recommend Kubuntu 8.04 which is available for download at http://www.kubuntu.org/), you need to make sure that the packages this project is depending on are installed. |
| Microsoft Windows | If you have purchased and installed Microsoft Windows on your PC, you still need to install a bunch of software which is required by HornetsEye. |
GNU+Linux
If you have GNU+Linux (I recommend Kubuntu 8.04 which is available for download at http://www.kubuntu.org/), you need to make sure that the packages this project is depending on are installed. Most or all of them should be available as a pre-compiled software package on your distributions installation repository.
The following software packages and their headers are required
- Ruby (http://www.ruby-lang.org/) and IRB
- RMagick (http://rmagick.rubyforge.org/) and a binary compatible version of ImageMagick (http://www.imagemagick.org/)
- g++ (http://www.gnu.org/software/gcc/) with standard libraries and Boost (http://www.boost.org/)
- libjit (http://freshmeat.net/projects/libjit/) is used for generating image processing code at runtime. Alternatively you can use an experimental branch of libjit with improved performance which is available at http://code.google.com
/p ./libjit-linear-scan-register-allocator /
Note that for x86_64 processors there is a recent bugfix in libjit. Make sure you install libjit-0.1.3pre or later (available here http://vision.eng.shu.ac.uk
The following software is optional
- ccache (http://ccache.samba.org/) compiler cache to speed up g++
- libxine (http://www.xinehq.de/) the library of the Xine player
- libdc1394 (http://damien.douxchamps.net/ieee1394/libdc1394/)
- Xorg (http://www.x.org/) with OpenGL/Mesa (http://www.mesa3d.org/) and Xv-extension headers.
- OpenEXR (http://www.openexr.com/) is a library for saving and loading HDR (high dynamic range) images. See Compiling with OpenEXR-support (GNU+Linux) for installation instructions.
- MPlayer (http://www.mplayerhq.hu/) is a video player. HornetsEye can access video files using MPlayer if it is installed.
- MEncoder (http://www.mplayerhq.hu/) is a video encoder. HornetsEye can create video files using MEncoder if it is installed.
- NArray (http://narray.rubyforge.org/) is a Ruby-extension offering multidimensional arrays. HornetsEye offers import and export to NArray.
- qt4-qtruby (http://rubyforge.org/projects/korundum/) is a Ruby-extension for developing graphical user interfaces with a binary compatible version of Qt4 (http://trolltech.com/products/qt).
- NaturalDocs (http://www.naturaldocs.org/) is used to build the online documentation (the Perl version). See Generating NaturalDocs-documentation (GNU+Linux) for installation instructions
Under Kubuntu you can install the required and optional packages apart from libjit as follows
sudo aptitude install ruby1.8 ruby1.8-dev irb1.8 imagemagick librmagick-ruby1.8 g++ ccache libboost-dev libxine-dev libdc1394-13-dev xorg-dev libfftw3-dev libopenexr-dev bison flex texinfo
You can also use adept_manager if you prefer a graphical user interface to the command line.
For installing HornetsEye itself you need to download the most recent version of the source archive hornetseye-x.x.tar.bz2 available at Rubyforge (http://rubyforge.org/frs/?group_id=2714) or Sourceforge (http://sourceforge.net
Configuring, building, and installing is done by using the GNU tools
tar xjf hornetseye-*.tar.bz2 cd hornetseye-* ./configure RUBYOPT="" make # You can use 'make -j 2' on a dual-core sudo make install # Maybe you need to do 'su -c "make install"' instead
Microsoft Windows
If you have purchased and installed Microsoft Windows on your PC, you still need to install a bunch of software which is required by HornetsEye.
Currently you can download all required software from the MMVL website http://vision.eng.shu.ac.uk
The following software packages are required (they are available at the URL mentioned above)
- Ruby one-click installer (http://rubyinstaller.rubyforge.org/). You need to restart your computer after installing Ruby so that gem is in the system path.
- Ghostscript fonts (http://pages.cs.wisc.edu/~ghost/) (they need to reside in c:\gs\fonts)
- RMagick (http://rmagick.rubyforge.org/) and a binary compatible version of ImageMagick (http://www.imagemagick.org/).
- libjit (http://www.dotgnu.org/) is repurposed for generating image processing code at runtime. It is included in the HornetsEye installer.
The following software is optional (all packages except MinGW are available at the URL mentioned above)
- NArray (http://narray.rubyforge.org/) is a Ruby-extension offering multidimensional arrays. HornetsEye offers import and export to NArray (*).
- MPlayer and MEncoder (http://www.mplayerhq.hu/) are a video player and a video encoder. HornetsEye can read and write video files using MPlayer and MEncoder if they are installed.
- OpenEXR (http://www.openexr.com/) is a library for saving and loading HDR (high dynamic range) images. It is included in the HornetsEye installer.
- qt4-qtruby (http://rubyforge.org/projects/korundum/) is a Ruby-extension for developing graphical user interfaces with a binary compatible version of Qt4 (http://trolltech.com/products/qt). Appart from Qt4 you also need to install MinGW (http://www.mingw.org/) with options g++ and make.
For installing HornetsEye download and run the most recent version of the installer hornetseyeinstaller-x.x.exe available at Rubyforge (http://rubyforge.org/frs/?group_id=2714) or Sourceforge (http://sourceforge.net
(*) The source-code for the NArray gem package is included in the HornetsEye source archive.
(**) The source-code for a qt4-qtruby installer is included in the HornetsEye source archive. The installer also is available at http://vision.eng.shu.ac.uk