QVision. Qt's Image, Video and Computer Vision Library

I. About the library

QVision is an image and computer vision library, developed by the PARP Computer Perception Research Group, from the University of Murcia, Spain.

It's general purpose is to help research for new algorithms in the fields of video and image processing, and computer vision. It's open code, so it can be used for academic and research purposes mainly.

II. Copyright, license and warranty.

Copyright (C) 2007, 2008. PARP Research Group. University of Murcia, Spain. QVision is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, version 3 of the license.

QVision is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with QVision. If not, see <http://www.gnu.org/licenses/>.

III. Requirements.

Right now, QVision needs the following libraries and programs to be installed in the system. In a future, it will be a modular library, so you will be able to compile the core, without the parts that use each of these libraries and programs listed, if you don't need the functionality they provide to the QVision:

You can directly install the following packages using apt-get, synaptic, or adept package managers (or similar packaging system) if you are planning to install QVision on an Ubuntu or Debian system:

IV. Configuring.

Copy the file, called QVision.0.0.2.tgz to your home directory (or a temporary location for compiling), and untar-it using this line:
	# tar xzvf QVision.0.0.2.tgz
Then you should copy the file QVision/config.pri.example to a file in the same directory, QVision, named config.pri. It has some performance and system configuration parameters inside used to compile QVision library. Change the content of the variables INSTALL_PATH, IPP_DIR, QWT_INCLUDE, QWT_LIB_DIRECTORY, and QWT_LIB_NAME, according to the specifications found in the config.pri.example file about them. They contain information about the location of the QWT and Intel's IPP libraries, and the install path for the QVision library. Beside system and directories configuration, you can also tune performance and debugging options in the 'config.pri' file. You may uncomment the line
	#CONFIG += release
to compile a faster version of the library, or else the library will compile in debug mode, including debug and error checking at execution time code. You can also uncomment the line:
	#DEFINES += QT_NO_DEBUG_OUTPUT
if you don't want to be printed lots of debug information while the program is running when compiling in debug mode, that will heavily decrease the execution time.

V. Compilation and Install.

Once customized the program, type:
	# cd QVision
	# qmake
	# make
to compile the library. When compilation is done, you should install the library. There will be copied 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 do the following:
	# make install
or else you should use sudo console command, to copy the files as a super-user:
	# sudo make install
to make the installation proceed. If you need to delete the installation, simply compile again, and use the following line:
	# sudo make uninstall
it will erase QVision's library files from the directory where you installed it previously.

VI. Documentation and API

You can check the API for version 0.0.2 of the QVision.

Also you may want to read the online manual. Nowadays it's in spanish, but it will be translated shortly.

VII. Contact.

These mails are for contact purposes, bugs, questions, etc:
Pedro E. Lopez de Teruel Alcolea <pedroe@ditec.um.es>
Antonio L. Rodríguez López <alrl1@alu.um.es>


.