1qwtinstall(3) Qwt User's Guide qwtinstall(3)
2
6 qwtinstall - .TH "qwtinstall" 3 "Mon Aug 1 2011" "Version 5.2.2" "Qwt
7 User's Guide"
8
10 qwtinstall - .PP
11 Introduction
12 ============
13 Qwt uses qmake to build all its components and examples.
15 qmake is part of a Qt distribution.
16 qmake reads project files, that contain the options and rules how to
18 build a certain project. A project file ends with the suffix '*.pro'.
19 Files that end with the suffix '*.pri' are included by the project
20 files and contain definitions, that are common for several project files.
21 qwtconfig.pri is read by all project files of the Qwt package.
23 So the first step is to edit qwtconfig.pri to adjust it to your
24 needs.
25 MathML Extension
27 ================
28 Qwt/Qt4 supports the MathML render engine from the Qt solutions package,
30 that is only available with a commercial Qt license.
31 You need a release of qtmmlwidget >= 2.1.
33 Copy the files qtmmlwidget.[cpp|h] to textengines/mathml.
34 Documentation
36 ==========================
37 Qwt includes a class documentation, that is available in various formats:
39 - Html files
41 - PDF document
42 - Qt Compressed Help (*.qch ) for the Qt assistant or creator.
43 You can load it 'Edit Preferences' -> 'Documentation' -> 'Add...'
44 - Man pages ( UNIX only )
45 A) Unix Qt3/Qt4
47 ==========================
48 qmake
50 make
51 make install
52 If you have installed a shared library it's path has to be known to
54 the run-time linker of your operating system. On Linux systems read
55 the LD_LIBRARY_PATH (on some systems LIBPATH is used instead, on MacOSX
56 it is called DYLD_LIBRARY_PATH) environment variable.
57 If you only want to check the Qwt examples without installing something,
59 you can set the LD_LIBRARY_PATH to the lib directory
60 of your local build.
61 If you didn't enable autobuilding of the examples in qwtconfig.pri
63 you have to build the examples this way:
64 cd examples
66 qmake
67 make
68 B) Win32/MSVC Qt3/Qt4
71 =====================
72 Please read the qmake documentation how to convert
74 your *.pro files into your development environment.
75 F.e MSVC with nmake:
77 qmake qwt.pro
78 nmake
79 If you didn't enable autobuilding of the examples in qwtconfig.pri
81 you have to build the examples this way:
82 cd examples
84 qmake examples.pro
85 nmake
86 admin/msvc-qmake.bat helps users of Visual Studio users to
88 generate makefiles or project files (.dsp for MSVC-6.0 or vcproj for
89 MSVC.NET) for Qwt.
90 To generate makefiles, type: 'adminvc-qmake'
92 To generate project files, type: 'adminvc-qmake vc'
93 When you have built a Qwt DLL you need to add the following
95 define to your compiler flags: QWT_DLL.
96 Windows doesn't like mixing of debug and release binaries. Most
98 of the problems with using the Qwt designer plugin are because
99 of trying to load a Qwt debug library into a designer release
100 executable.
101 C) Win32/MinGW Qt4
104 ==================
105 C1) Windows Shell
107 Start a Windows Shell, where Qt4 is initialized. ( F.e. with
109 qmake qwt.pro
111 make
112 If you didn't enable autobuilding of the examples in qwtconfig.pri
114 you have to build the examples this way:
115 cd examples
117 qmake examples.pro
118 make
119 make install
120 C2) MSYS Shell Qt >= 4.3.0
122 Support for the MSYS Shell has been improved in Qt 4.3.0.
124 Now building Qwt from the MSYS Shell works exactly like in UNIX or in the
125 Windows Shell - or at least it should:
126 because of a bug in Qt 4.3.0 you always have to do a 'qmake -r'.
127 C3) MSYS Shell Qt < 4.3.0
129 For Qt < 4.3.0 you have to set the MINGW_IN_SHELL variable.
131 make will run into errors with the subdirs target, that can be
132 ignored (make -i).
133 export MINGW_IN_SHELL=1;
135 qmake
137 make -i
138 make -i install
139 If you didn't enable autobuilding of the examples in qwtconfig.pri
141 you have to build the examples this way:
142 cd examples
144 qmake examples.pro
145 make -i
146 make -i install
147 C1-C3)
149 When you have built a Qwt DLL you need to add QWT_DLL to your compiler
151 flags. If you are using qmake for your own builds this done by adding
152 the following line to your profile: 'DEFINES += QWT_DLL'.
153 Windows doesn't like mixing of debug and release binaries. Most
155 of the problems with using the Qwt designer plugin are because
156 of trying to load a Qwt debug library into a designer release
157 executable.
158 D) MacOSX
160 Well, the Mac is only another Unix system. So read the instructions in A).
162 In the recent Qt4 releases the default target of qmake is to generate
164 XCode project files instead of makefiles. So you might need to do the
165 following:
166 qmake -spec macx-g++
168 D) Qtopia Core
170 I only tested Qwt with Qtopia Core in qvfb (Virtual Framebuffer Devivce)
172 Emulator on my Linux box. To build Qwt for the emulator was as simple as
173 for a regular Unix build.
174 qmake
176 make
177 E) Qtopia (!= Qtopia Core)
179 I once compiled the Qwt library against Qtopia 4.2.0 successfully - but
181 not more. It should be possible to build and install Qwt, but it's
182 not done yet.
183 Good luck !
185Version 5.2.2 Mon Aug 1 2011 qwtinstall(3)