
This is ViTE version 1.2.

ViTE is a C++ Visual Trace Explorer using Qt for viewing.


***************
INSTALLING ViTE
***************

-----------------
For Windows users:

Run the installer provided.

-----------------------
For Debian/Ubuntu users:

** Since ViTE is already in Debian official repository, you can install the stable version with:
sudo apt-get install vite

** If you prefer to rebuild it from scratch, install all required dependencies with:
sudo apt-get build-dep vite


-------------------------------
Otherwise (Debian/Ubuntu users):

If you do not have Qt please visit: https://www.qt.io/ and download the development files for your operating system.

you can use apt-get:
sudo apt-get install vite

For Debian users, you may need to install several packages:
apt-get install qtbase5-dev qt5-qmake qttools5-dev libqt5charts5-dev libqt5svg5-dev
apt-get install libglm-dev libglew-dev

Then, after Qt development files have been installed, you can compile ViTE:

cmake -DCMAKE_INSTALL_PREFIX:PATH=. .
or
ccmake (which allows you to choose the directories and library for otf)

will configure your Makefile depending on your OS.
You can also use one of the config.XXXX scripts (./config.XXXX) to configure cmake.

Then, type the command:
make
to create the binary file.


-----------------------
For Fedora/CentOS users:

You have to have the administration rights (su).
you will need to get the following rpm packages:
wget ftp://ftp.pbone.net/mirror/ftp.pramberger.at/systems/linux/contrib/rhel5/i386/qt45-4.5.1-1.el5.pp.i386.rpm
wget ftp://ftp.pbone.net/mirror/ftp.pramberger.at/systems/linux/contrib/rhel5/i386/qt45-devel-4.5.1-1.el5.pp.i386.rpm
wget ftp://ftp.pbone.net/mirror/ftp.pramberger.at/systems/linux/contrib/rhel5/i386/qt45-sqlite-4.5.1-1.el5.pp.i386.rpm

Then, you will need to install the required packages used by the previous ones:
yum install dbus-devel fontconfig-devel freetype-devel glib2-devel libSM-devel libX11-devel libXcursor-devel libXext-devel libXfixes-devel libXi-devel libXinerama-devel libXrandr-devel libXrender-devel libpng-devel mesa-libGLU-devel glut glut-devel gcc-c++

After you can install the rpm packages you just download:
rpm -i qt45-4.5.1-1.el5.pp.i386.rpm
rpm -i qt45-sqlite-4.5.1-1.el5.pp.i386.rpm
rpm -i qt45-devel-4.5.1-1.el5.pp.i386.rpm

You have to export your PATH variable to the directory of qmake, which is by default:
export PATH=/usr/lib/qt45/qt/bin:/usr/lib/qt45/qt/include:$PATH

If it is not the case, try: find / | grep qmake and take the path given.

Go to the vite/src/trunk directory then:
./configure
make or gmake will create the binary file.



*************
DOCUMENTATION
*************

For ViTE there is three documentations that can be found in documentation folder.

The first one is the user manual which explain ViTE and its features.

The two other ones are for developers: this is the technical manual and the Doxygen generated doc. The technical manual explains how ViTE is coded and the Doxygen explains the classes and functions more in details.

For Doxygen, it is necessary to have epstopdf for the latex version. You can install it with the package texlive-extra-utils.
Also, install the dot program for graphics from the package graphviz.

The doxygen documentation can be compiled by the command: make doc.


*******************
SUPPORTED PLATFORMS
*******************

For this release, the following platforms have been tested on:
- Ubuntu 8.04 / 8.10 / 9.04 / 10.04.
- Windows Xp/Vista.
- Mandriva linux one 2009 kde (under virtualbox).
- MacOS X.


*******************
HOW TO REPORT A BUG
*******************

If you think you have found a bug in ViTE, you can report it by mail at vite-developpeurs@lists.gforge.inria.fr or in the forum at https://gforge.inria.fr/forum/?group_id=1596
