README 3.74 KB
Newer Older
1 2 3 4




5
This is ViTE version 1.2.
6

7 8 9



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

12 13 14 15 16 17 18 19







***************
Johnny Jazeix's avatar
Johnny Jazeix committed
20
INSTALLING ViTE
21
***************
Johnny Jazeix's avatar
Johnny Jazeix committed
22 23 24 25 26 27

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.


28
-----------------------
29 30
For Debian/Ubuntu users:

31 32 33 34 35 36 37 38 39 40
** 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):

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

43
you can use apt-get :
44 45
sudo apt-get install libqt4-dev libqt4-opengl-dev libglew-dev

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

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

50
./configure (or ./configure --enable_otf if you want to compile and use the otf version from the sources)
51 52
or
cmake -D CMAKE_INSTALL_PREFIX:PATH=. .
53 54
or
ccmake (which allows you to choose the directories and library for otf)
55 56 57 58 59

will configure your Makefile depending on your OS.

make will create the binary file.

60 61

-----------------------
62
For Fedora/CentOS users:
63

64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81
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
82

83 84 85
Go to the vite/src/trunk directory then :
./configure
make or gmake will create the binary file.
Johnny Jazeix's avatar
Johnny Jazeix committed
86

87 88 89


*************
Johnny Jazeix's avatar
Johnny Jazeix committed
90
DOCUMENTATION
91
*************
Johnny Jazeix's avatar
Johnny Jazeix committed
92 93 94 95 96 97

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.
98

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

Johnny Jazeix's avatar
Johnny Jazeix committed
102
The doxygen documentation can be compiled by the command : make doc.
103 104


105
*******************
Johnny Jazeix's avatar
Johnny Jazeix committed
106
SUPPORTED PLATFORMS
107
*******************
108

Johnny Jazeix's avatar
Johnny Jazeix committed
109
For this release, the following platforms have been tested on :
110
- Ubuntu 8.04 / 8.10 / 9.04 / 10.04.
Johnny Jazeix's avatar
Johnny Jazeix committed
111 112 113
- Windows Xp/Vista.
- Mandriva linux one 2009 kde (under virtualbox).
- MacOS X.
114

115 116

*******************
Johnny Jazeix's avatar
Johnny Jazeix committed
117
HOW TO REPORT A BUG
118
*******************
119

120
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