README 3.25 KB
Newer Older
1
This is ViTE version 1.2.
2

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

Johnny Jazeix's avatar
Johnny Jazeix committed
5 6 7 8 9 10 11 12 13
INSTALLING ViTE

On Windows, please refer to the how_to_install.txt file in the windows.tar.gz file.

On MacOS X or Debian, follow the next step.


COMPILING ViTE

14 15
For Debian/Ubuntu users:

Johnny Jazeix's avatar
Johnny Jazeix committed
16
If you do not have Qt please visit : http://www.qtsoftware.com/downloads/opensource/appdev and download the development files for your operating system.
17

18
you can use apt-get :
19 20
sudo apt-get install libqt4-dev libqt4-opengl-dev libglew-dev

Arthur Redondy's avatar
Arthur Redondy committed
21
For Debian users, you may need to install also the qmake package.
22

Johnny Jazeix's avatar
Johnny Jazeix committed
23 24
Then, until Qt development files are installed, you can compile ViTE :

25
./configure (or ./configure --enable_otf if you want to compile and use the otf version from the sources)
26 27
or
cmake -D CMAKE_INSTALL_PREFIX:PATH=. .
28 29
or
ccmake (which allows you to choose the directories and library for otf)
30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53

will configure your Makefile depending on your OS.

make will 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.
Johnny Jazeix's avatar
Johnny Jazeix committed
54

55 56 57
Go to the vite/src/trunk directory then :
./configure
make or gmake will create the binary file.
Johnny Jazeix's avatar
Johnny Jazeix committed
58 59 60 61 62 63 64 65

DOCUMENTATION

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

The first one is the user manual which can be useful for a first use.

The two other ones are for developpers : 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.
66

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

Johnny Jazeix's avatar
Johnny Jazeix committed
70
The doxygen documentation can be compiled by the command : make doc.
71 72


Johnny Jazeix's avatar
Johnny Jazeix committed
73
SUPPORTED PLATFORMS
74

Johnny Jazeix's avatar
Johnny Jazeix committed
75
For this release, the following platforms have been tested on :
76
- Ubuntu 8.04 / 8.10 / 9.04.
Johnny Jazeix's avatar
Johnny Jazeix committed
77 78 79
- Windows Xp/Vista.
- Mandriva linux one 2009 kde (under virtualbox).
- MacOS X.
80

Johnny Jazeix's avatar
Johnny Jazeix committed
81
HOW TO REPORT A BUG
82

83
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