PARP Research Group University of Murcia


Download and install

This guide is intended to help in the installation and configuration of the QVision on a new system. It also includes instructions to get a first "hands-on", not so simple "kind-of-hello-world" QVision sample application running.

Dependencies of the QVision

The QVision needs the following libraries to be installed:

Optional libraries and back-end applications

QVision can be compiled with functionallity to interoperate with the following libraries and applications. Install them before configuring and compiling the QVision if you are planning to use them from the QVision:

  • MPlayer and MEncoder.
    These programs are needed for the QVMplayerCamera class, mainly for versatile image and video input/output.
  • OpenCV.
  • CGAL.
  • (soon to be avaliable) CUDA.

Setting up at Ubuntu systems

If you are planning to install QVision on a Ubuntu, Debian or any other distribution with a similar package management, you can directly install the following packages:
  • Packages for Qt library: libqt4-core, libqt4-debug, libqt4-dev, libqt4-gui, libqt4-qt3support, libqt3-compat-headers, qt4-designer, qt4-dev-tools and qt4-doc.
    Version 4.3.2-0ubuntu3.1 of these packages was tested and works correctly for current version of QVision.
  • Packages for QWT library: libqwt5-qt4 and libqwt5-qt4-dev.
    Version 5.0.1-2 of these packages was tested and worked correctly for current version of QVision.
  • Packages for MPlayer: mencoder and mplayer.
    Version 2:1.0 was tested and worked correctly for current version of QVision.
  • Packages for GSL and scientific calculus: libgsl0 and libgsl0-dev.
    Version 1.9-3 for the GSL library was tested and worked correctly for current version of QVision.
  • Packages for Intel's IPP: there are no packages available in apt-get for that library. A free (consult conditions here) version is available for Linux platforms. You can download it from Intel's IPP homepage. Version 5.3 of this library was tested and worked correctly for current version of QVision.
  • Package for g++: Qt uses this compiler to built programs, but is not generally included with Ubuntu's base install. It should be included with the package g++.

For the optional libraries (OpenCV, CGAL), you can install the following packages:

  • Packages for the OpenCV: libcv1, libcvaux1, libcvaux-dev, libcv-dev, libhighgui1, libhighgui-dev and opencv-doc.
  • Packages for the CGAL: libcgal2, libcgal-dev and libcgal-demo.

Using apt-get, these packages can be installed from the command line with the following commands:

# Packages required for the basic installation
sudo apt-get install libqt4-core libqt4-debug libqt4-dev libqt4-gui libqt4-qt3support libqt3-compat-headers qt4-designer qt4-dev-tools qt4-doc libqwt5-qt4 libqwt5-qt4-dev mencoder mplayer libgsl0 libgsl0-dev g++
# -----------
# Packages for the OpenCV library
sudo apt-get install libcv1 libcvaux1 libcvaux-dev libcv-dev libhighgui1 libhighgui-dev opencv-doc
# -----------
# Packages for the CGAL
sudo apt-get install libcgal2 libcgal-dev libcgal-demo

Download

The latest release and older versions can be downloaded from the following url:

http://forja.rediris.es/frs/?group_id=321

Compilation and Install.

Once you have the tar file for QVision, named QVision.<version>.tgz, copy it to your home directory (or a temporary location for compiling), and untar-it using this line:

# tar xzvf QVision.<version>.tgz

Then you should rename or copy the file config.pri.example inside the QVision directory to config.pri. This file contains several configuration variables which can be modified to tune the compilation and installation of the library. Also, you can activate QVision interoperativity with other libraries, such as OpenCV and CGAL in this file. You can find detailed information about these configuration parameters in the own file config.pri.

Once customized the config.pri file to your needs and system, compile the library using the following commands inside the QVision directory:

# qmake
# make

This will compile the library. When compilation is done, you should install it in your system. This will copy some files in the directory specified in the variable 'INSTALL_PATH'. If that route is in your home directory, or other place you have permissions to write, you should simply do the following:

	# make install

Otherwise, you should use sudo console command, to copy the files as a super-user:

	# sudo make install

If you need to uninstall the library, simply compile again, and use the following line:

	# sudo make uninstall

This will erase QVision's library files from the directory where you installed it previously.




QVision framework. PARP research group, copyright 2007, 2008.