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

« back to all changes in this revision

Viewing changes to qwt-5.0.1/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 "26 Feb 2007" "Version 5.0.1" "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 94 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 72 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 294 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 437 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 279 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 518 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 487 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 504 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 184 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 176 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 592 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 404 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 357 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 348 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 332 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 323 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 241 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 160 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 152 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 168 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 61 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 143 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 133 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.