TopoLinux - Linux Installation


Sources

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

        mkdir TopoLinux
        cd TopoLInux
	tar -xzf topolinux-XXX.tgz
NOtice that you need to create a directory and untar the file there, because the archive does not contain it. The following subdirectories structure should appear:
   bin .......... executable files
   basic ........ TopoLinux utilities
   calib ........ 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 ...... QTopoCalib classes
   QTshot ....... QTopoShot classes
   utils ........ utility classes
   tmp .......... data
The source files are in distox, utils, basic, calib, QTshot and QTcalib. Unless you must work without a window environment, it is not necessary to compile the programs in basic and calib. There are also 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), and you must compile the sources 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 bin/qtshot and bin/qtcalib. Run them from the TopoLinux root directory, as they look for the run-time resources from there, in particular there is the configuraion file qtopo.rc.


Precompiled

The precompiled download archive qtopo-XXX.tgz 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-4 run-time (libraries) installed. To execute a program, invoke it from the TopoLinux root directory. For example

	./bin/qtshot