TopoLinux - Installation

Linux - Sources

The safest way to install QTopo on Linux is to compile it from the sources. Download and untar the source tgz:

	tar -xzf qtopo-XXX.tgz
This will create a directory TopoLinux, with the following subdirectories:
   bin .......... executable files
   basic-02 ..... TopoLinux utilities
   calib-02 ..... TopoLinux calibration utilities
   distox ....... DistoX connection and communication
   docs ......... documentation
   help ......... help pages
   i18n ......... internationalization data files
   icons ........ run-time icons
   pixmaps ...... compile-time pixmaps
   QTcalib-02 ... QTopoCalib classes
   QTshot-02 .... QTopoShot classes
   utils ........ utility classes
   tmp .......... data
The source files are in distox, utils, basic-02, calib-02, QTshot-02 and QTcalib-02. Furthermore, there are a few files, the most important of which is the run-time configuration file qtopo.rc.

There is no "configure" and you must compile everything by hand. You need the C++ and Qt development environment (g++, etc., and Qt). You do not need to compile the TopoLinux utilities in basic-02 and calib-02, unless you must work without a window environment. Therefore you need to make in four directories:

  1. cd distox; make
  2. cd utils; make
  3. cd QTshot; qmake; make
  4. cd QTcalib; qmake; make

At this point you have two executables QTshot-02/qtshot and QTcalib-02/qtcalib. Run them from the TopoLinux root directory.


Linux - Precompiled

The precompiled download archive contains the subdirectories

	bin ......... executables
	docs ........ documentation
	i18n ........ internationalization data
	icons ....... run-time icons
	help ........ help pages
	tmp ......... data

Furthermore, there is the run-time configuration file qtopo.rc.

You need to have the Qt run-time (libraries) installed. To execute a program, invoke it from the TopoLinux root directory. For example

	./bin/qtshot


Windows - Sources

The Windows sources are the same as for Linux. Download the source archive and unzip it.

You need to Microsoft Visual C++ 2008 (v. 9.0) and the Qt development environment (Qt-4.x.x). Create a new VisualC project with all the C source and header files in the subdirectories distox, utils, and QTshot-02.

Open a console window and cd into QTshot-02. Source the MSVC-9.0 vcvarsall.bat (see Qt build documentation). Execute Qt/bin/moc on the files

and include the moc-files in the project.

Compile the project, with QT3_SUPPORT.


Windows - Precompiled

You need to install the Microsoft VisulaC 2008 redistributable package. You can get it from http://go.microsoft.com. Make sure to get that one for VisualC 2008 (v. 9.0).

Download the precompiled archive, and unzip it. Open a console window to the TopoLinux root, and execute bin/qtshot.