~l3on/ubuntu/oneiric/qwt/fix-921430

« back to all changes in this revision

Viewing changes to qwt-5.0.2/doc/man/man3/QwtPainter.3

  • Committer: Bazaar Package Importer
  • Author(s): Fathi Boudra
  • Date: 2007-10-05 15:20:41 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20071005152041-qmybqh4fj9jejyo2
Tags: 5.0.2-2
* Handle nostrip build option. (Closes: #437877)
* Build libqwt5-doc package in binary-indep target. (Closes: #443110)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH "QwtPainter" 3 "11 Jun 2007" "Version 5.0.2" "Qwt User's Guide" \" -*- nroff -*-
 
2
.ad l
 
3
.nh
 
4
.SH NAME
 
5
QwtPainter \- 
 
6
.SH SYNOPSIS
 
7
.br
 
8
.PP
 
9
.SH "Detailed Description"
 
10
.PP 
 
11
A collection of QPainter workarounds. 
 
12
 
 
13
1) Clipping to coordinate system limits (Qt3 only)
 
14
.PP
 
15
On X11 pixel coordinates are stored in shorts. Qt produces overruns when mapping QCOORDS to shorts.
 
16
.PP
 
17
2) Scaling to device metrics
 
18
.PP
 
19
QPainter scales fonts, line and fill patterns to the metrics of the paint device. Other values like the geometries of rects, points remain device independend. To enable a device independent widget implementation, \fBQwtPainter\fP adds scaling of these geometries. (Unfortunately QPainter::scale scales both types of paintings, so the objects of the first type would be scaled twice). 
 
20
.PP
 
21
Definition at line 62 of file qwt_painter.h.
 
22
.SS "Static Public Member Functions"
 
23
 
 
24
.in +1c
 
25
.ti -1c
 
26
.RI "static void \fBsetMetricsMap\fP (const QPaintDevice *layout, const QPaintDevice *device)"
 
27
.br
 
28
.ti -1c
 
29
.RI "static void \fBsetMetricsMap\fP (const \fBQwtMetricsMap\fP &)"
 
30
.br
 
31
.ti -1c
 
32
.RI "static void \fBresetMetricsMap\fP ()"
 
33
.br
 
34
.ti -1c
 
35
.RI "static const \fBQwtMetricsMap\fP & \fBmetricsMap\fP ()"
 
36
.br
 
37
.ti -1c
 
38
.RI "static void \fBsetDeviceClipping\fP (bool)"
 
39
.br
 
40
.ti -1c
 
41
.RI "static bool \fBdeviceClipping\fP ()"
 
42
.br
 
43
.ti -1c
 
44
.RI "static void \fBsetClipRect\fP (QPainter *, const QRect &)"
 
45
.br
 
46
.ti -1c
 
47
.RI "static void \fBdrawText\fP (QPainter *, int x, int y, const QString &)"
 
48
.br
 
49
.ti -1c
 
50
.RI "static void \fBdrawText\fP (QPainter *, const QPoint &, const QString &)"
 
51
.br
 
52
.ti -1c
 
53
.RI "static void \fBdrawText\fP (QPainter *, int x, int y, int w, int h, int flags, const QString &)"
 
54
.br
 
55
.ti -1c
 
56
.RI "static void \fBdrawText\fP (QPainter *, const QRect &, int flags, const QString &)"
 
57
.br
 
58
.ti -1c
 
59
.RI "static void \fBdrawSimpleRichText\fP (QPainter *, const QRect &, int flags, QTextDocument &)"
 
60
.br
 
61
.ti -1c
 
62
.RI "static void \fBdrawRect\fP (QPainter *, int x, int y, int w, int h)"
 
63
.br
 
64
.ti -1c
 
65
.RI "static void \fBdrawRect\fP (QPainter *, const QRect &rect)"
 
66
.br
 
67
.ti -1c
 
68
.RI "static void \fBfillRect\fP (QPainter *, const QRect &, const QBrush &)"
 
69
.br
 
70
.ti -1c
 
71
.RI "static void \fBdrawEllipse\fP (QPainter *, const QRect &)"
 
72
.br
 
73
.ti -1c
 
74
.RI "static void \fBdrawPie\fP (QPainter *, const QRect &r, int a, int alen)"
 
75
.br
 
76
.ti -1c
 
77
.RI "static void \fBdrawLine\fP (QPainter *, int x1, int y1, int x2, int y2)"
 
78
.br
 
79
.ti -1c
 
80
.RI "static void \fBdrawLine\fP (QPainter *, const QPoint &p1, const QPoint &p2)"
 
81
.br
 
82
.ti -1c
 
83
.RI "static void \fBdrawPolygon\fP (QPainter *, const QwtPolygon &pa)"
 
84
.br
 
85
.ti -1c
 
86
.RI "static void \fBdrawPolyline\fP (QPainter *, const QwtPolygon &pa)"
 
87
.br
 
88
.ti -1c
 
89
.RI "static void \fBdrawPoint\fP (QPainter *, int x, int y)"
 
90
.br
 
91
.ti -1c
 
92
.RI "static void \fBdrawRoundFrame\fP (QPainter *, const QRect &, int width, const QPalette &, bool sunken)"
 
93
.br
 
94
.ti -1c
 
95
.RI "static void \fBdrawFocusRect\fP (QPainter *, QWidget *)"
 
96
.br
 
97
.ti -1c
 
98
.RI "static void \fBdrawFocusRect\fP (QPainter *, QWidget *, const QRect &)"
 
99
.br
 
100
.ti -1c
 
101
.RI "static QwtPolygon \fBclip\fP (const QwtPolygon &)"
 
102
.br
 
103
.ti -1c
 
104
.RI "static void \fBdrawColorBar\fP (QPainter *painter, const \fBQwtColorMap\fP &, const \fBQwtDoubleInterval\fP &, const \fBQwtScaleMap\fP &, Qt::Orientation, const QRect &)"
 
105
.br
 
106
.in -1c
 
107
.SH "Member Function Documentation"
 
108
.PP 
 
109
.SS "QwtPolygon QwtPainter::clip (const QwtPolygon &)\fC [static]\fP"
 
110
.PP
 
111
Clip a point array. 
 
112
.PP
 
113
Definition at line 95 of file qwt_painter.cpp.
 
114
.PP
 
115
References QwtRect::clip().
 
116
.PP
 
117
Referenced by drawPolygon(), and drawPolyline().
 
118
.SS "bool QwtPainter::deviceClipping ()\fC [static]\fP"
 
119
.PP
 
120
Returns whether device clipping is enabled. On X11 the default is enabled, otherwise it is disabled. 
 
121
.PP
 
122
\fBSee also:\fP
 
123
.RS 4
 
124
\fBQwtPainter::setDeviceClipping()\fP 
 
125
.RE
 
126
.PP
 
127
 
 
128
.PP
 
129
Definition at line 73 of file qwt_painter.cpp.
 
130
.SS "void QwtPainter::drawEllipse (QPainter * painter, const QRect & rect)\fC [static]\fP"
 
131
.PP
 
132
Wrapper for QPainter::drawEllipse() 
 
133
.PP
 
134
Definition at line 295 of file qwt_painter.cpp.
 
135
.PP
 
136
References QwtMetricsMap::layoutToDevice().
 
137
.PP
 
138
Referenced by QwtSymbol::draw(), and QwtPicker::drawRubberBand().
 
139
.SS "void QwtPainter::drawLine (QPainter *, const QPoint & p1, const QPoint & p2)\fC [inline, static]\fP"
 
140
.PP
 
141
Wrapper for QPainter::drawLine(). 
 
142
.PP
 
143
Definition at line 143 of file qwt_painter.h.
 
144
.PP
 
145
References drawLine().
 
146
.SS "void QwtPainter::drawLine (QPainter * painter, int x1, int y1, int x2, int y2)\fC [static]\fP"
 
147
.PP
 
148
Wrapper for QPainter::drawLine() 
 
149
.PP
 
150
Definition at line 438 of file qwt_painter.cpp.
 
151
.PP
 
152
References drawPolyline(), and QwtMetricsMap::isIdentity().
 
153
.PP
 
154
Referenced by QwtSymbol::draw(), QwtPlotMarker::draw(), QwtScaleDraw::drawBackbone(), QwtPlotSpectrogram::drawContourLines(), QwtLegendItem::drawIdentifier(), drawLine(), QwtPicker::drawRubberBand(), QwtPlotCurve::drawSticks(), and QwtRoundScaleDraw::drawTick().
 
155
.SS "void QwtPainter::drawPie (QPainter * painter, const QRect & rect, int a, int alen)\fC [static]\fP"
 
156
.PP
 
157
Wrapper for QPainter::drawPie() 
 
158
.PP
 
159
Definition at line 280 of file qwt_painter.cpp.
 
160
.PP
 
161
References QwtMetricsMap::layoutToDevice().
 
162
.SS "void QwtPainter::drawPoint (QPainter * painter, int x, int y)\fC [static]\fP"
 
163
.PP
 
164
Wrapper for QPainter::drawPoint() 
 
165
.PP
 
166
Definition at line 548 of file qwt_painter.cpp.
 
167
.PP
 
168
References QwtMetricsMap::layoutToDevice().
 
169
.PP
 
170
Referenced by QwtPlotCurve::drawDots().
 
171
.SS "void QwtPainter::drawPolygon (QPainter * painter, const QwtPolygon & pa)\fC [static]\fP"
 
172
.PP
 
173
Wrapper for QPainter::drawPolygon() 
 
174
.PP
 
175
Definition at line 488 of file qwt_painter.cpp.
 
176
.PP
 
177
References clip(), and QwtMetricsMap::layoutToDevice().
 
178
.PP
 
179
Referenced by QwtSymbol::draw(), and QwtPlotCurve::fillCurve().
 
180
.SS "void QwtPainter::drawPolyline (QPainter * painter, const QwtPolygon & pa)\fC [static]\fP"
 
181
.PP
 
182
Wrapper for QPainter::drawPolyline() 
 
183
.PP
 
184
Definition at line 505 of file qwt_painter.cpp.
 
185
.PP
 
186
References clip(), and QwtMetricsMap::layoutToDevice().
 
187
.PP
 
188
Referenced by drawLine(), and drawRect().
 
189
.SS "void QwtPainter::drawRect (QPainter * painter, const QRect & rect)\fC [static]\fP"
 
190
.PP
 
191
Wrapper for QPainter::drawRect() 
 
192
.PP
 
193
Definition at line 185 of file qwt_painter.cpp.
 
194
.PP
 
195
References drawPolyline(), fillRect(), and QwtMetricsMap::layoutToDevice().
 
196
.SS "void QwtPainter::drawRect (QPainter * painter, int x, int y, int w, int h)\fC [static]\fP"
 
197
.PP
 
198
Wrapper for QPainter::drawRect() 
 
199
.PP
 
200
Definition at line 177 of file qwt_painter.cpp.
 
201
.PP
 
202
Referenced by QwtText::draw(), QwtSymbol::draw(), drawColorBar(), and QwtPicker::drawRubberBand().
 
203
.SS "void QwtPainter::drawRoundFrame (QPainter *, const QRect &, int width, const QPalette &, bool sunken)\fC [static]\fP"
 
204
.PP
 
205
Draw a round frame. 
 
206
.PP
 
207
Definition at line 622 of file qwt_painter.cpp.
 
208
.PP
 
209
Referenced by QwtDial::drawFrame().
 
210
.SS "void QwtPainter::drawSimpleRichText (QPainter * painter, const QRect & rect, int flags, QTextDocument & text)\fC [static]\fP"
 
211
.PP
 
212
Wrapper for QSimpleRichText::draw() 
 
213
.PP
 
214
Definition at line 405 of file qwt_painter.cpp.
 
215
.PP
 
216
References QwtMetricsMap::layoutToDevice().
 
217
.PP
 
218
Referenced by QwtRichTextEngine::draw().
 
219
.SS "void QwtPainter::drawText (QPainter * painter, const QRect & rect, int flags, const QString & text)\fC [static]\fP"
 
220
.PP
 
221
Wrapper for QPainter::drawText() 
 
222
.PP
 
223
Definition at line 358 of file qwt_painter.cpp.
 
224
.PP
 
225
References QwtMetricsMap::layoutToDevice().
 
226
.SS "void QwtPainter::drawText (QPainter * painter, int x, int y, int w, int h, int flags, const QString & text)\fC [static]\fP"
 
227
.PP
 
228
Wrapper for QPainter::drawText() 
 
229
.PP
 
230
Definition at line 349 of file qwt_painter.cpp.
 
231
.PP
 
232
References drawText().
 
233
.SS "void QwtPainter::drawText (QPainter * painter, const QPoint & pos, const QString & text)\fC [static]\fP"
 
234
.PP
 
235
Wrapper for QPainter::drawText() 
 
236
.PP
 
237
Definition at line 333 of file qwt_painter.cpp.
 
238
.PP
 
239
References QwtMetricsMap::layoutToDevice().
 
240
.SS "void QwtPainter::drawText (QPainter * painter, int x, int y, const QString & text)\fC [static]\fP"
 
241
.PP
 
242
Wrapper for QPainter::drawText() 
 
243
.PP
 
244
Definition at line 324 of file qwt_painter.cpp.
 
245
.PP
 
246
Referenced by QwtPlainTextEngine::draw(), and drawText().
 
247
.SS "void QwtPainter::fillRect (QPainter * painter, const QRect & rect, const QBrush & brush)\fC [static]\fP"
 
248
.PP
 
249
Wrapper for QPainter::fillRect() 
 
250
.PP
 
251
Definition at line 242 of file qwt_painter.cpp.
 
252
.PP
 
253
References QwtMetricsMap::layoutToDevice().
 
254
.PP
 
255
Referenced by drawRect().
 
256
.SS "const \fBQwtMetricsMap\fP & QwtPainter::metricsMap ()\fC [static]\fP"
 
257
.PP
 
258
\fBReturns:\fP
 
259
.RS 4
 
260
Metrics map 
 
261
.RE
 
262
.PP
 
263
 
 
264
.PP
 
265
Definition at line 161 of file qwt_painter.cpp.
 
266
.PP
 
267
Referenced by QwtText::draw(), QwtSymbol::draw(), QwtLegendItem::drawIdentifier(), QwtLegendItem::drawItem(), QwtPlotCurve::drawSymbols(), QwtScaleDraw::drawTick(), QwtText::heightForWidth(), QwtPlot::print(), and QwtPlot::printScale().
 
268
.SS "void QwtPainter::resetMetricsMap ()\fC [static]\fP"
 
269
.PP
 
270
Reset the metrics map to the ratio 1:1 
 
271
.PP
 
272
\fBSee also:\fP
 
273
.RS 4
 
274
\fBQwtPainter::setMetricsMap\fP, \fBQwtPainter::resetMetricsMap\fP 
 
275
.RE
 
276
.PP
 
277
 
 
278
.PP
 
279
Definition at line 153 of file qwt_painter.cpp.
 
280
.PP
 
281
Referenced by QwtScaleDraw::drawTick().
 
282
.SS "void QwtPainter::setClipRect (QPainter * painter, const QRect & rect)\fC [static]\fP"
 
283
.PP
 
284
Wrapper for QPainter::setClipRect() 
 
285
.PP
 
286
Definition at line 169 of file qwt_painter.cpp.
 
287
.PP
 
288
References QwtMetricsMap::layoutToDevice().
 
289
.PP
 
290
Referenced by drawColorBar(), and QwtPlot::printLegend().
 
291
.SS "void QwtPainter::setDeviceClipping (bool enable)\fC [static]\fP"
 
292
.PP
 
293
En/Disable device clipping. 
 
294
.PP
 
295
On X11 the default for device clipping is enabled, otherwise it is disabled. 
 
296
.PP
 
297
\fBSee also:\fP
 
298
.RS 4
 
299
\fBQwtPainter::deviceClipping()\fP 
 
300
.RE
 
301
.PP
 
302
 
 
303
.PP
 
304
Definition at line 62 of file qwt_painter.cpp.
 
305
.SS "void QwtPainter::setMetricsMap (const \fBQwtMetricsMap\fP & map)\fC [static]\fP"
 
306
.PP
 
307
Change the metrics map 
 
308
.PP
 
309
\fBSee also:\fP
 
310
.RS 4
 
311
\fBQwtPainter::resetMetricsMap\fP, \fBQwtPainter::metricsMap\fP 
 
312
.RE
 
313
.PP
 
314
 
 
315
.PP
 
316
Definition at line 144 of file qwt_painter.cpp.
 
317
.SS "void QwtPainter::setMetricsMap (const QPaintDevice * layout, const QPaintDevice * device)\fC [static]\fP"
 
318
.PP
 
319
Scale all \fBQwtPainter\fP drawing operations using the ratio QwtPaintMetrics(from).logicalDpiX() / QwtPaintMetrics(to).logicalDpiX() and QwtPaintMetrics(from).logicalDpiY() / QwtPaintMetrics(to).logicalDpiY()
 
320
.PP
 
321
\fBSee also:\fP
 
322
.RS 4
 
323
QwtPainter::resetScaleMetrics(), QwtPainter::scaleMetricsX, QwtPainter::scaleMetricsY() 
 
324
.RE
 
325
.PP
 
326
 
 
327
.PP
 
328
Definition at line 134 of file qwt_painter.cpp.
 
329
.PP
 
330
References QwtMetricsMap::setMetrics().
 
331
.PP
 
332
Referenced by QwtPlot::print().
 
333
 
 
334
.SH "Author"
 
335
.PP 
 
336
Generated automatically by Doxygen for Qwt User's Guide from the source code.