Installation

Note: You may need to be logged in as root, depending on the permissions of the directories where you choose to install QicsTable.

This product is built with, and depends on, Qt version 4.2 and newer. You must have Qt installed on the machine that you are using to build this product.

In the following instructions, <QICSTABLE> refers to the toplevel directory of the QicsTable distribution. For example, if you unpacked the Linux/Unix archive in /opt, <QICSTABLE> would refer to /opt/qicstable-x.x.x-unix-commercial-source

In the case of binding QicsTable to KDChart, please note that only KDChart 2.x is supported; any previous versions would not work. <KDCHART> refers to the toplevel directory of the KDChart distribution.

• Unpack the archive.
  • On Linux/Unix: 'tar xzvf qicstable-x.x.x-unix-commercial-source.tar.gz or, if your tar command doesn't support the '-z' flag, 'gunzip -c qicstable-x.x.x-unix-commercial-source.tar.gz | tar xvf -'
  • On Windows: Unzip qicstable-x.x.x-win32-commercial-source.zip using WinZip or similar utility. Be sure to extract the entire folder hierarchy.

• By default, QicsTable will build with the following options:
  • 'release' build
  • shared library/DLL

If you wish to change any of these options, edit the configuration file <QICSTABLE>/qicstable_config.pri. Each option is documented in the configuration file.

• If you would like to enable KDChart support, do the following:
  • Install KDChart 2.x to a directory on the filesystem (see KDChart documentation for details). <KDCHART> would point to the root of the installation.
  • Go to <QICSTABLE>/qicstable_config.pri file and find a line KDCHART_PATH =
  • Uncomment this line and write here the value of <KDCHART>.
    • For example, if KDChart has been installed into /opt/kdchart-2.0 then the given line should look like: KDCHART_PATH = /opt/kdchart-2.0

• Set the environment variable QTDIR to the location of your Qt distribution. If you are using the built-in Qt distribution on most Linux platforms, this location is /usr/local/Trolltech/Qt- <QtVersion>. If you have built Qt yourself from the source distribtion, use the location of that build.

• If you are using 'csh' as your shell, you can set QTDIR as follows: setenv QTDIR <your_qt_location>.

• If you are using 'bash' or 'ksh' as your shell, you can set QTDIR as follows: QTDIR=<your_qt_location>; export QTDIR

• If you are using the Windows command shell, you can set QTDIR as follows: 'set QTDIR=<your_qt_location>

• Build the distribution using the Qt utility 'qmake'.
  • On Linux/Unix/Windows:
    • Change directory to <QICSTABLE> and execute the following command: qmake qicstable.pro

• Once the toplevel makefile is built, you may build the distribution.
  • On Linux/Unix: make or gmake
  • On Windows(MSVC): nmake

This will build the QicsTable library and all the examples.

• HTML documentation can be found in <QICSTABLE>/doc/html. The main page is index.html

• Examples can be found in <QICSTABLE>/examples.

• On Windows, you will need to modify your Path environment variable in order for the example programs to find the QicsTable DLL. This can be done in a number of different ways, depending on the version of Windows that you are running. One way that will always work is via the command line.

C:> set Path=<QICSTABLE>;%Path%

As before, replace <QICSTABLE> with the full path to the directory in which you unpacked the archive.