README for RLPlot, Copyright (c) 2002, 2003 R.Lackner
This file is part of RLPlot.
RLPlot is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
RLPlot is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with RLPlot; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
1. Building RLPlot for Linux
Before building RLPlot for Linux using the supplied 'Makefile' you probably need to make some adaptations. RLPlot uses Trolltech's Qt and the default Makefile assumes Qt beeing installed in /usr/local/qt. Which version of Qt should be used ? The best version is usually that coming with your distribution CDs. If there are several versions installed on your machine you may experience crashes especially if you try to copy/paste data from one application to another.
Most problems during compilation of RLPlot are due to missing Qt or installation of Qt in a different folder.
On most systems where Qt has been installed from the distribution CDs the environment variable 'QTDIR' is defined. In this case you may succeed by issuing the following command within the RLPlot folder:
make -e
If that does not work you have to ...
1.1: Find your Qt directory.
This is the directory where Qt has been installed. It contains the files ./bin/moc, ./include/qapplication.h ./lib/libqt.so (However, RLPlot needs more than those). If you don't find this directory you must install Qt devel. first from your distribution CDs or directly from www.trolltech.com.
1.2: Modify Makefile. Find the line (close to the top) where QTDIR is defined
and fill in the path to the Qt folder. Possible examples include:
QTDIR = /usr/lib/qt3
QTDIR = /usr/lib/qt-2.3.1
QTDIR = /usr/local/qt-2.3.1
QTDIR = /usr/local/qt-x11-free-3.0.4
Alternatively you may leave the Makefile unchanged and put a symbolic link
into /usr/local (if /usr/local/qt does not yet exist), for example:
cd /usr/local
ln -s /usr/lib/qt-2.3.1 qt
The latter method has the advantage that you can have concurrent versions
of Qt installed on your system and need not modify Makefile everytime you
download a new version of RLPlot. You may need root privileges to create
the link in /usr/local
1.3: Create the RLPlot executable by execting 'make' in the RLplot folder.
You can remove some intermediary file exceting 'make clean'. No further installation required. Just execute RLPlot.
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Problems and Platform notes:
Some recent versions of Qt use Open GL which requires additional libraries
to be included in the Makefile.
Common errors during build:
undefined reference to ...
This error usually occurs if a library necessary for link is not specified in the Makefile. You have to find a suitable library and specify it in the LIBS definition (some examples see below). May be you do not need this library and the build is done properly without e.g. '-lGL'. Example: undefined reference to 'glXQueryServerString'
libGL.so not specified in LIBS. Add '-lGL' to LIBS or a fully qualified
path to the folder with libGL.so, e.g. -L/usr/X11R6/lib
cannot find ....
This error occurs if a file is not found, possibly one of the libraries in of the LIBS definition. Probably you do not need this library and you can remove it from the LIBS. If this does not help you may be lucky to find it elsewhere (not very promising) or some package needs to be installed. Example: cannot find -lGL
libGL.so specified in LIBS but not found in a standard directory Example: cannot find -lqt-mt
libqt-mt.so not found. Modify the Makefile from 'QTLIBS= -lqt-mt' to
'QTLIBS= -lqt'. If this does not help Qt is not properly installed.
There are some LIBS definitions which might work on your system
LIBS = -L$(QTDIR)/lib -L/usr/X11R6/lib LIBS = -lGL -L$(QTDIR)/lib -L/usr/X11R6/lib LIBS = -L/usr/lib -L$(QTDIR)/lib -L/usr/X11R6/lib
2. Building RLPlot for Windows
To compile RLPlot from the sources you need to install MS Visual Studio first. Once you have RLPlot.exe no further installation is required. RLPlot does not change the registry. Double click on the icon in the explorer window to start the program.
2.1 Building RLPlot.exe using NMAKE
Open a DOS or command line window and move to the MSVC folder. Execute VCVARS32.BAT in the bin subdirectory. Change directory to the RLPlot folder. Whenever you close the DOS-box you need to execute VCVARS32.BAT again. Now execute nmake to compile and build RLPlot:
nmake -f "Makefile.win"
After building RLPlot you may wish to remove temporary files:
nmake -f "Makefile.win" clean
2.2 Creating a project in the IDE
Create a new project (RLPLot) using the MS Developer Studio creating a Win32 Application. Add the following files to the project: Export.cpp, FileIO.cpp, Output.cpp, PropertyDlg.cpp, rlplot.cpp, rlplot.h, RLPLOT.RC, spreadwi.cpp, TheDialog.cpp, TheDialog.h, UtilObj.cpp, Utils.cpp, Version.h, WinSpec.cpp, WinSpec.h. Now execute [!].
Success!
Reinhard Lackner Reinhard Lackner
Ing. Etzelstr. 19 Inst. f. Zoologie u. Limnologie
A-6020 Innsbruck Technikerstr. 25
AUSTRIA A-6020 Innsbruck
AUSTRIA