Download and setup

This page describes how to obtain, configure, compile and (if needed) install the QVision on a computer.

Prior to configuration and compilation, you should install the Qt Framework for high performance, cross-platform application development (Version 4.0 or later), and the GNU Scientific Library in the computer.

You should also download and install any third party library or application that you wish to interoperate with from the QVison. As described at the QVision overview section, the QVision can interoperate with the following libraries: the GSL - GNU Scientific Library, the Intel(R) Integrated Performance Primitives (IPP), the OpenCV library, the MPlayer application, the QWT - Qt Widgets for Technical Applications, the CGAL, the Octave C++ API, and the CUDA (not yet fully implemented).

Next, you should download the sources of the latest (recommended) version of the QVision. Then you should configure it and compile it. In that moment you should be able to start creating applications with the library. Optionally, you can install the library binaries and the header files in the system.

Installing Qt and third party libraries on Windows

The straightforward way to develop Qt applications on Windows is to install the Qt SDK. To compile the QVision, simply load the file qvision.pro at the Qt Creator and build the project.

It is also recommended to install the GSL for Windows, and configure the QVision to use it. Otherwise some of the QVision mathematical functionality will not be available. Make sure to install both the developer files and the binaries of this library under the same path.

You can optionally install other third-party libraries such as OpenCV or Intel IPP, and configure the QVision to link against them. Notice that some libraries and applications (such as MPlayer for video input functionality) can only be configured under Linux.

Installing Qt and third party libraries on Ubuntu/Debian 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 for the Qt and the GSL libraries:

Packages for Qt library: g++, 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 GSL: libgsl0-dev.
Version 1.9-3 for the GSL library was tested and worked correctly for current version of QVision.

If you want to interoperate with other libraries, you can install the following packages:

Packages for the Intel's IPP: unfortunately there are no deb packages available in the ubuntu repositories for that library. A free non-commercial 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.
Packages for the MPlayer: mencoder and mplayer.
Version 2:1.0 was tested and worked correctly for current version of QVision.
Packages for the 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 the the OpenCV: libcv-dev, libhighgui-dev, libcvaux-dev and opencv-doc.
Packages for the the CGAL: libcgal-dev.
Packages for the the CUDA Toolkit: nvidia-cg-toolkit, libdevil-dev and libglew1.5-dev.

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 g++ libqt4-core libqt4-dev libqt4-gui libqt4-qt3support libqt3-compat-headers qt4-designer qt4-dev-tools qt4-doc libgsl0-dev g++
# Packages for the MPlayer back-end application
sudo apt-get install mencoder mplayer
# Packages for the QWT library
sudo apt-get install libqwt5-qt4 libqwt5-qt4-dev
# Packages for the OpenCV library
sudo apt-get install libcv-dev libhighgui-dev libcvaux-dev opencv-doc
# Packages for the CGAL
sudo apt-get install libcgal-dev # Packages for CUDA Toolkit
sudo apt-get install nvidia-cg-toolkit libdevil-dev libglew1.5-dev

Downloading QVision

You can download the latest snapshot of the library from the following subversion repository:

       https://qvision.svn.sourceforge.net/svnroot/qvision qvision

To do so, you can use a Windows client such as Tortoise SVN. On Linux you can use the following line to download the library with the standard subversion client:

	svn co https://qvision.svn.sourceforge.net/svnroot/qvision qvision

The library files and sources are under the directory qvision/trunk in the svn repository.

If you want a closed and stable version of the QVision you can download one of the latest releases from the Sourceforge page:

http://sourceforge.net/projects/qvision/files/

Older releases can still be downloaded from the following URL:

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

Configuring QVision

You must rename the file config.pri.example to config.pri. This file contains several parameters and options that configure the compilation and functionality of the QVision.

In this file you can enable interoperability of the QVision with many third-party libraries and applications (see section Interoperability with other libraries). Open the file config.pri with a text editor, and read carefully the instructions contained in that file about how to tune each configuration parameter.

Compiling the QVision from the command shell (Linux)

Once the config.pri file is correctly configured, you can proceed to compile the QVision. First, you should use the qmake application, to create the Makefile file from the QVision project files (*.pro, *.pri and configure.pri files). You can use the following console command line, at the QVision directory:

	# qmake-qt4

The qmake application should display several messages. If everything was ok, the qmake should create the Makefile file. Then you can compile the library using the classic make command:

	# make

Compiling the QVision with Qt Creator (Windows and Linux)

You can open the qvision.pro file (contained in the QVision download) to load the whole QVision as a project in the Qt Creator IDE (installed with the SDK).

Then you can proceed to compile the library.

Note:: Make sure to disable the shadow build option in the Qt Creator application to compile the QVision. Otherwise the library files will not be where they are supposed to be.