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/ | If you have GNU/Linux (for example the Kubuntu distribution 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 (for example the Kubuntu distribution 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/)
- 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/)
- 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.
The following software is optional
- NaturalDocs (http://www.naturaldocs.org/) is used to build the online documentation (the Perl version). See Generating NaturalDocs-documentation (GNU/Linux) for installation instructions
- 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).
E.g. under Kubuntu you can install the required packages as follows
sudo aptitude install ruby1.8 ruby1.8-dev sudo aptitude install ruby1.8-dev sudo aptitude install imagemagick sudo aptitude install librmagick-ruby1.8 sudo aptitude install g++ sudo aptitude install libboost-dev sudo aptitude install libxine-dev sudo aptitude install libdc1394-dev sudo aptitude install xorg-dev
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 the 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. Otherwise the HornetsEye installer will fail.
- 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/).
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.
- MEncoder (http://www.mplayerhq.hu/) is a video encoder. HornetsEye can create video files using MEncoder if it is installed.
- 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
HornetsEye for Windows is build using MinGW.
(*) 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