mirror of
https://github.com/GoldenCheetah/GoldenCheetah.git
synced 2026-04-13 12:42:20 +00:00
Qwt 6.0.1 Support
Upgrade to QWT 6.0.1, but still uses a locally patched copy since support for 8 axes has not been included, despite it being a relatively simple patch. Fixes #634. Fixes #567.
This commit is contained in:
130
qwt/INSTALL
130
qwt/INSTALL
@@ -9,18 +9,14 @@ build a certain project. A project file ends with the suffix "*.pro".
|
||||
Files that end with the suffix "*.pri" are included by the project
|
||||
files and contain definitions, that are common for several project files.
|
||||
|
||||
qwtconfig.pri is read by all project files of the Qwt package.
|
||||
So the first step is to edit qwtconfig.pri to adjust it to your
|
||||
needs.
|
||||
qwtconfig.pri and qwtbuild.pri are read by all project files of the Qwt
|
||||
package. qwtconfig.pri is also read by qwt.prf, when building your
|
||||
application. So the first step is to edit the *.pri files to adjust
|
||||
them to your needs.
|
||||
|
||||
MathML Extension
|
||||
================
|
||||
|
||||
Qwt/Qt4 supports the MathML render engine from the Qt solutions package,
|
||||
that is only available with a commercial Qt license.
|
||||
|
||||
You need a release of qtmmlwidget >= 2.1.
|
||||
Copy the files qtmmlwidget.[cpp|h] to textengines/mathml.
|
||||
The subdirs template of qmake is known to be buggy when using spaces
|
||||
in path names. So better don't build Qwt below a path name with spaces.
|
||||
( Otherwise you might have to run qmake in all subdirs manually ).
|
||||
|
||||
Documentation
|
||||
==========================
|
||||
@@ -29,12 +25,19 @@ Qwt includes a class documentation, that is available in various formats:
|
||||
|
||||
- Html files
|
||||
- PDF document
|
||||
- Qt Compressed Help (*.qch ) for the Qt assistant.
|
||||
- Qt Compressed Help (*.qch ) for the Qt assistant or creator.
|
||||
You can load it "Edit Preferences" -> "Documentation" -> "Add..."
|
||||
- Man pages ( UNIX only )
|
||||
|
||||
A) Unix Qt3/Qt4
|
||||
Building Qwt
|
||||
==========================
|
||||
|
||||
The easiest way to build Qwt is from the command line - but you insist on
|
||||
using an IDE don't forget the "make install" step.
|
||||
|
||||
A) Unix
|
||||
--------
|
||||
|
||||
qmake
|
||||
make
|
||||
make install
|
||||
@@ -57,8 +60,10 @@ qmake
|
||||
make
|
||||
|
||||
|
||||
B) Win32/MSVC Qt3/Qt4
|
||||
=====================
|
||||
B) Win32/MSVC
|
||||
--------
|
||||
|
||||
Check that your Qt version has been built with MSVC - not with MinGW !
|
||||
|
||||
Please read the qmake documentation how to convert
|
||||
your *.pro files into your development environment.
|
||||
@@ -66,6 +71,7 @@ your *.pro files into your development environment.
|
||||
F.e MSVC with nmake:
|
||||
qmake qwt.pro
|
||||
nmake
|
||||
nmake install
|
||||
|
||||
If you didn't enable autobuilding of the examples in qwtconfig.pri
|
||||
you have to build the examples this way:
|
||||
@@ -74,32 +80,28 @@ cd examples
|
||||
qmake examples.pro
|
||||
nmake
|
||||
|
||||
admin/msvc-qmake.bat helps users of Visual Studio users to
|
||||
generate makefiles or project files (.dsp for MSVC-6.0 or vcproj for
|
||||
MSVC.NET) for Qwt.
|
||||
|
||||
To generate makefiles, type: "admin\msvc-qmake"
|
||||
To generate project files, type: "admin\msvc-qmake vc"
|
||||
|
||||
When you have built a Qwt DLL you need to add the following
|
||||
define to your compiler flags: QWT_DLL.
|
||||
|
||||
Windows doesn't like mixing of debug and release binaries. Most
|
||||
of the problems with using the Qwt designer plugin are because
|
||||
of trying to load a Qwt debug library into a designer release
|
||||
executable.
|
||||
|
||||
It's not possible to load a plugin, that has been built with MinGW
|
||||
into a Qt Designer/Creator, that has been built with MSVC ( and v.v ).
|
||||
This is a common reason for problems, when working with prebuild
|
||||
binaries of the Qt Creator.
|
||||
|
||||
C) Win32/MinGW Qt4
|
||||
==================
|
||||
C) Win32/MinGW
|
||||
--------
|
||||
|
||||
C1) Windows Shell
|
||||
Check that your Qt version has been built with MinGW - not with MSVC !
|
||||
|
||||
Start a Windows Shell, where Qt4 is initialized. ( F.e. with
|
||||
Start a Shell, where Qt4 is initialized. ( F.e. with
|
||||
"Programs->Qt by Trolltech ...->Qt 4.x.x Command Prompt" ).
|
||||
Check if you can execute "make" or something like "mingw32-make".
|
||||
|
||||
qmake qwt.pro
|
||||
make
|
||||
make install
|
||||
|
||||
If you didn't enable autobuilding of the examples in qwtconfig.pri
|
||||
you have to build the examples this way:
|
||||
@@ -107,47 +109,17 @@ you have to build the examples this way:
|
||||
cd examples
|
||||
qmake examples.pro
|
||||
make
|
||||
make install
|
||||
|
||||
C2) MSYS Shell Qt >= 4.3.0
|
||||
|
||||
Support for the MSYS Shell has been improved in Qt 4.3.0.
|
||||
Now building Qwt from the MSYS Shell works exactly like in UNIX or in the
|
||||
Windows Shell - or at least it should:
|
||||
because of a bug in Qt 4.3.0 you always have to do a "qmake -r".
|
||||
|
||||
C3) MSYS Shell Qt < 4.3.0
|
||||
|
||||
For Qt < 4.3.0 you have to set the MINGW_IN_SHELL variable.
|
||||
make will run into errors with the subdirs target, that can be
|
||||
ignored (make -i).
|
||||
|
||||
export MINGW_IN_SHELL=1;
|
||||
|
||||
qmake
|
||||
make -i
|
||||
make -i install
|
||||
|
||||
If you didn't enable autobuilding of the examples in qwtconfig.pri
|
||||
you have to build the examples this way:
|
||||
|
||||
cd examples
|
||||
qmake examples.pro
|
||||
make -i
|
||||
make -i install
|
||||
|
||||
C1-C3)
|
||||
|
||||
When you have built a Qwt DLL you need to add QWT_DLL to your compiler
|
||||
flags. If you are using qmake for your own builds this done by adding
|
||||
the following line to your profile: "DEFINES += QWT_DLL".
|
||||
|
||||
Windows doesn't like mixing of debug and release binaries. Most
|
||||
of the problems with using the Qwt designer plugin are because
|
||||
of trying to load a Qwt debug library into a designer release
|
||||
executable.
|
||||
|
||||
Don't forget to tell qmake where to find qwt.prf:
|
||||
qmake -set QMAKEFEATURES ...
|
||||
|
||||
D) MacOSX
|
||||
--------
|
||||
|
||||
Well, the Mac is only another Unix system. So read the instructions in A).
|
||||
|
||||
@@ -158,19 +130,35 @@ following:
|
||||
qmake -spec macx-g++
|
||||
...
|
||||
|
||||
D) Qtopia Core
|
||||
D) Qt Embedded
|
||||
--------
|
||||
|
||||
I only tested Qwt with Qtopia Core in qvfb (Virtual Framebuffer Devivce)
|
||||
I only tested Qwt with Qt Embedded in qvfb (Virtual Framebuffer Devivce)
|
||||
Emulator on my Linux box. To build Qwt for the emulator was as simple as
|
||||
for a regular Unix build.
|
||||
|
||||
qmake
|
||||
make
|
||||
F) Symbian
|
||||
--------
|
||||
|
||||
E) Qtopia (!= Qtopia Core)
|
||||
I never tried this platform myself.
|
||||
|
||||
I once compiled the Qwt library against Qtopia 4.2.0 successfully - but
|
||||
not more. It should be possible to build and install Qwt, but it's
|
||||
not done yet.
|
||||
Using Qwt
|
||||
===========
|
||||
|
||||
For building a Qwt application with qmake use the Qwt configuration features
|
||||
file, that has been installed by "make install". When qmake is able to find
|
||||
it ( http://doc.qt.nokia.com/4.7/qmake-advanced-usage.html#adding-new-configuration-features )
|
||||
you can simply add "CONFIG += qwt" to your application project file.
|
||||
|
||||
If you don't use qmake you have to add the include path to find the Qwt
|
||||
headers to your compiler flags and the Qwt library to your linker list.
|
||||
Don't forget to add QWT_DLL to the compiler flags, when you work with a
|
||||
Qwt-DLLs on Windows.
|
||||
|
||||
For using the designer plugin you have to configure the Qt designer/creator
|
||||
where to look for plugins. This can be done by setting the QT_PLUGIN_PATH or
|
||||
using a qt.conf file ( see http://doc.qt.nokia.com/4.7/deployment-plugins.html ).
|
||||
Beside the plugin the Qwt library itsself also needs to be known to the Designer/Creator
|
||||
( see LD_LIBRARY_PATH, PATH ... above ).
|
||||
|
||||
Good luck !
|
||||
|
||||
Reference in New Issue
Block a user