qwtpainter(3)

NAME

QwtPainter

SYNOPSIS

Detailed Description

A collection of QPainter workarounds.

1) Clipping to coordinate system limits

On X11 pixel coordinates are stored in shorts. Qt produces overruns
when mapping QCOORDS to shorts.

2) Scaling to device metrics

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, QwtPainter adds scaling of these geometries.
(Unfortunately QPainter::scale scales both types of paintings, so the
objects of the first type would be scaled twice).

3) Hide some Qt2/3 incompatibilities

Definition at line 50 of file qwt_painter.h.

Public Types

enum TextXorRopMode { XorRopTextNormal = 0, XorRopTextKeepFont = 1,

XorRopTextKeepColor = 2 }

Static Public Member Functions

void setMetricsMap (const QPaintDevice *layout, const QPaintDevice

*device)

void setMetricsMap (const QwtMetricsMap &)
void resetMetricsMap ()
const QwtMetricsMap & metricsMap ()
void setDeviceClipping (bool)
bool deviceClipping ()
void setClipRect (QPainter *, const QRect &)
void drawText (QPainter *, int x, int y, const QString &, int len=-1) void drawText (QPainter *, const QPoint &, const QString &, int len=-1) void drawText (QPainter *, int x, int y, int w, int h, int flags, const

QString &, int len=-1)

void drawText (QPainter *, const QRect &, int flags, const QString &,

int len=-1)

void drawSimpleRichText (QPainter *, const QRect &, int flags,

QSimpleRichText &)

void drawRect (QPainter *, int x, int y, int w, int h) void drawRect (QPainter *, const QRect &rect)
void fillRect (QPainter *, const QRect &, const QBrush &) void drawEllipse (QPainter *, const QRect &)
void drawLine (QPainter *, int x1, int y1, int x2, int y2) void drawLine (QPainter *, const QPoint &p1, const QPoint &p2) void drawPolygon (QPainter *, const QPointArray &pa) void drawPolyline (QPainter *, const QPointArray &pa) void drawPoint (QPainter *, int x, int y)
void drawRoundFrame (QPainter *, const QRect &, int width, const

QColorGroup &cg, bool sunken)

QPointArray clip (const QPointArray &)
int textXorRopMode ()
int setTextXorRopMode (TextXorRopMode mode)

Member Enumeration Documentation

enum QwtPainter::TextXorRopMode

Indicates a method to work around a bug in the drawing of text using
the XorROP raster operator on the X Window system. Has no effect on
other platforms.

See also:

QwtPainter::setTextXorRopMode

Definition at line 60 of file qwt_painter.h.

Member Function Documentation

QPointArray QwtPainter::clip (const QPointArray &) [static]

Clip a point array.

Definition at line 524 of file qwt_painter.cpp.

References QwtRect::clip().

Referenced by drawPolygon(), and drawPolyline().

bool QwtPainter::deviceClipping () [static]

Returns whether device clipping is enabled. On X11 the default is
enabled, otherwise it is disabled.

See also:

QwtPainter::setDeviceClipping()

Definition at line 88 of file qwt_painter.cpp.

void QwtPainter::drawEllipse (QPainter * painter, const QRect & rect)

[static]
Wrapper for QPainter::drawEllipse() Definition at line 195 of file
qwt_painter.cpp.

Referenced by QwtSymbol::draw(), and QwtPicker::drawRubberBand().

void QwtPainter::drawLine (QPainter * painter, const QPoint & p1, const

QPoint & p2) [static]
Wrapper for QPainter::drawLine() Definition at line 443 of file
qwt_painter.cpp.

References drawPolyline().

void QwtPainter::drawLine (QPainter * painter, int x1, int y1, int x2, int

y2) [static]
Wrapper for QPainter::drawLine() Definition at line 481 of file
qwt_painter.cpp.

Referenced by QwtSymbol::draw(), QwtMarker::draw(), QwtGrid::draw(),
QwtScaleDraw::drawBackbone(), QwtLegendItem::drawIdentifier(),
QwtPicker::drawRubberBand(), QwtCurve::drawSticks(), and
QwtScaleDraw::drawTick().

void QwtPainter::drawPoint (QPainter * painter, int x, int y) [static]

Wrapper for QPainter::drawPoint() Definition at line 513 of file
qwt_painter.cpp.

Referenced by QwtCurve::drawDots().

void QwtPainter::drawPolygon (QPainter * painter, const QPointArray & pa)

[static]
Wrapper for QPainter::drawPolygon() Definition at line 490 of file
qwt_painter.cpp.

References clip().

Referenced by QwtSymbol::draw(), QwtCurve::drawDots(),
QwtCurve::drawLines(), QwtCurve::drawSpline(), and
QwtCurve::drawSteps().

void QwtPainter::drawPolyline (QPainter * painter, const QPointArray & pa)

[static]
Wrapper for QPainter::drawPolyline() Definition at line 501 of file
qwt_painter.cpp.

References clip().

Referenced by drawLine(), QwtCurve::drawLines(),
QwtCurve::drawSpline(), and QwtCurve::drawSteps().

void QwtPainter::drawRect (QPainter * painter, const QRect & rect) [static]

Wrapper for QPainter::drawRect() Definition at line 168 of file
qwt_painter.cpp.

void QwtPainter::drawRect (QPainter * painter, int x, int y, int w, int h)

[static]
Wrapper for QPainter::drawRect() Definition at line 160 of file
qwt_painter.cpp.

Referenced by QwtRichText::draw(), QwtPlainText::draw(),
QwtSymbol::draw(), QwtPicker::drawRubberBand(), and
QwtPlot::printCanvas().

void QwtPainter::drawRoundFrame (QPainter *, const QRect &, int width,

const QColorGroup & cg, bool sunken) [static] Draw a round frame.

Definition at line 560 of file qwt_painter.cpp.

Referenced by QwtDial::drawFrame().

void QwtPainter::drawSimpleRichText (QPainter * painter, const QRect &

rect, int flags, QSimpleRichText & text) [static] Wrapper for QSimpleRichText::draw() Definition at line 357 of file
qwt_painter.cpp.

Referenced by QwtRichText::draw().

void QwtPainter::drawText (QPainter * painter, const QRect & rect, int

flags, const QString & text, int len = -1) [static] Wrapper for QPainter::drawText() Definition at line 293 of file
qwt_painter.cpp.

void QwtPainter::drawText (QPainter * painter, int x, int y, int w, int h,

int flags, const QString & text, int len = -1) [static] Wrapper for QPainter::drawText() Definition at line 284 of file
qwt_painter.cpp.

References drawText().

void QwtPainter::drawText (QPainter * painter, const QPoint & pos, const

QString & text, int len = -1) [static] Wrapper for QPainter::drawText() Definition at line 217 of file
qwt_painter.cpp.

void QwtPainter::drawText (QPainter * painter, int x, int y, const QString

& text, int len = -1) [static] Wrapper for QPainter::drawText() Definition at line 208 of file
qwt_painter.cpp.

Referenced by QwtPlainText::draw(), QwtScaleDraw::drawLabel(), and
drawText().

void QwtPainter::fillRect (QPainter * painter, const QRect & rect, const

QBrush & brush) [static]
Wrapper for QPainter::fillRect() Definition at line 181 of file
qwt_painter.cpp.

Referenced by QwtPlot::printCanvas().

const QwtMetricsMap & QwtPainter::metricsMap () [static]

Returns:

Metrics map

Definition at line 144 of file qwt_painter.cpp.

Referenced by QwtMarker::draw(), QwtLegendItem::drawIdentifier(),
QwtLegendItem::drawItem(), and QwtPlot::print().

void QwtPainter::resetMetricsMap () [static]

Reset the metrics map to the ratio 1:1

See also:

QwtPainter::setMetricsMap, QwtPainter::resetMetricsMap

Definition at line 136 of file qwt_painter.cpp.

Referenced by QwtPlot::print().

void QwtPainter::setClipRect (QPainter * painter, const QRect & rect)

[static]
Wrapper for QPainter::setClipRect() Definition at line 152 of file
qwt_painter.cpp.

Referenced by QwtPlot::printCanvas(), and QwtPlot::printLegend().

void QwtPainter::setDeviceClipping (bool enable) [static]

En/Disable device clipping. On X11 the default for device clipping is
enabled, otherwise it is disabled.

See also:

QwtPainter::deviceClipping()

Definition at line 77 of file qwt_painter.cpp.

void QwtPainter::setMetricsMap (const QwtMetricsMap & map) [static]

Change the metrics map

See also:

QwtPainter::resetMetricsMap, QwtPainter::metricsMap

Definition at line 127 of file qwt_painter.cpp.

void QwtPainter::setMetricsMap (const QPaintDevice * layout, const

QPaintDevice * device) [static] Scale all QwtPainter drawing operations using the ratio
QwtPaintMetrics(from).logicalDpiX() / QwtPaintMetrics(to).logicalDpiX() and QwtPaintMetrics(from).logicalDpiY() /
QwtPaintMetrics(to).logicalDpiY()

See also:

QwtPainter::resetScaleMetrics(), QwtPainter::scaleMetricsX,
QwtPainter::scaleMetricsY()

Definition at line 117 of file qwt_painter.cpp.

Referenced by QwtPlot::print().

int QwtPainter::setTextXorRopMode (TextXorRopMode mode) [static]

Selects a method to work around a bug in the drawing of text using the XorROP raster operator on the X Window system. Has no effect on other
platforms.

See also:

QwtPicker

Possible modes are:

· XorRopTextNormal; fails on the X Window System with X Free Type

enabled.

· XorRopTextKeepFont; works around the bug while keeping the font, but

the color of the text is unpredictable. It is possible to get
satisfactory results by choosing a suitable combination of font, text color and background color.

· XorRopTextKeepColor; works around the bug while keeping the color,

but the font of the text is unpredictable (it depends on the version of Qt). The font that is used may not at all resemble the requested
font. This mode does not exist when Qwt has been built for Qt-2.3.

Parameters:

mode Mode to do the XorROP text drawing

Definition at line 640 of file qwt_painter.cpp.

int QwtPainter::textXorRopMode () [static]

Return the method to work around a bug in the drawing of text using the XorROP raster operator on the X Window system.

See also:

QwtPainter::textXorRopMode

Definition at line 594 of file qwt_painter.cpp.

Author

Generated automatically by Doxygen for Qwt User's Guide from the source code.

Version 4.2.0 16 Nov 2004 QwtPainter(3)