Classes | Public Types | Public Member Functions | Protected Member Functions | Private Member Functions | Private Attributes
QwtGraphic Class Reference

A paint device for scalable graphics. More...

#include <qwt_graphic.h>

Inheritance diagram for QwtGraphic:
Inheritance graph
[legend]

List of all members.

Classes

class  PathInfo
class  PrivateData

Public Types

enum  RenderHint { RenderPensUnscaled = 0x1 }
typedef QFlags< RenderHintRenderHints
 Render hints.

Public Member Functions

QRectF boundingRect () const
const QVector
< QwtPainterCommand > & 
commands () const
QRectF controlPointRect () const
QSizeF defaultSize () const
 Default size.
bool isEmpty () const
bool isNull () const
QwtGraphicoperator= (const QwtGraphic &)
 Assignment operator.
 QwtGraphic ()
 Constructor.
 QwtGraphic (const QwtGraphic &)
 Copy constructor.
void render (QPainter *) const
 Replay all recorded painter commands.
void render (QPainter *, const QSizeF &, Qt::AspectRatioMode=Qt::IgnoreAspectRatio) const
 Replay all recorded painter commands.
void render (QPainter *, const QRectF &, Qt::AspectRatioMode=Qt::IgnoreAspectRatio) const
 Replay all recorded painter commands.
void render (QPainter *, const QPointF &, Qt::Alignment=Qt::AlignTop|Qt::AlignLeft) const
 Replay all recorded painter commands.
void reset ()
 Clear all stored commands.
QRectF scaledBoundingRect (double sx, double sy) const
 Calculate the target rectangle for scaling the graphic.
void setCommands (QVector< QwtPainterCommand > &)
 Append paint commands.
void setDefaultSize (const QSizeF &)
 Set a default size.
void setRenderHint (RenderHint, bool on=true)
bool testRenderHint (RenderHint) const
QImage toImage () const
 Convert the graphic to a QImage.
QImage toImage (const QSize &, Qt::AspectRatioMode=Qt::IgnoreAspectRatio) const
 Convert the graphic to a QImage.
QPixmap toPixmap () const
 Convert the graphic to a QPixmap.
QPixmap toPixmap (const QSize &, Qt::AspectRatioMode=Qt::IgnoreAspectRatio) const
 Convert the graphic to a QPixmap.
virtual ~QwtGraphic ()
 Destructor.

Protected Member Functions

virtual void drawImage (const QRectF &, const QImage &, const QRectF &, Qt::ImageConversionFlags)
 Store a image command in the command list.
virtual void drawPath (const QPainterPath &)
virtual void drawPixmap (const QRectF &, const QPixmap &, const QRectF &)
 Store a pixmap command in the command list.
virtual QSize sizeMetrics () const
virtual void updateState (const QPaintEngineState &state)
 Store a state command in the command list.

Private Member Functions

void updateBoundingRect (const QRectF &)
void updateControlPointRect (const QRectF &)

Private Attributes

PrivateDatad_data

Detailed Description

A paint device for scalable graphics.

QwtGraphic is the representation of a graphic that is tailored for scalability. Like QPicture it will be initialized by QPainter operations and can be replayed later to any target paint device.

While the usual image representations QImage and QPixmap are not scalable Qt offers two paint devices, that might be candidates for representing a vector graphic:

QwtGraphic maps all scalable drawing primitives to a QPainterPath and stores them together with the painter state changes ( pen, brush, transformation ... ) in a list of QwtPaintCommands. For being a complete QPaintDevice it also stores pixmaps or images, what is somehow against the idea of the class, because these objects can't be scaled without a loss in quality.

The main issue about scaling a QwtGraphic object are the pens used for drawing the outlines of the painter paths. While non cosmetic pens ( QPen::isCosmetic() ) are scaled with the same ratio as the path, cosmetic pens have a fixed width. A graphic might have paths with different pens - cosmetic and non-cosmetic.

QwtGraphic caches 2 different rectangles:

Because the offset for drawing the outline depends on the shape of the painter path ( the peak of a triangle is different than the flat side ) scaling with a fixed aspect ratio always needs to be calculated from the control point rectangle.

See also:
QwtPainterCommand

Definition at line 74 of file qwt_graphic.h.


Member Typedef Documentation

Render hints.

The default setting is to disable all hints

Definition at line 103 of file qwt_graphic.h.


Member Enumeration Documentation

Hint how to render a graphic

See also:
setRenderHint(), testRenderHint()
Enumerator:
RenderPensUnscaled 

When rendering a QwtGraphic a specific scaling between the controlPointRect() and the coordinates of the target rectangle is set up internally in render().

When RenderPensUnscaled is set this specific scaling is applied for the control points only, but not for the pens. All other painter transformations ( set up by application code ) are supposed to work like usual.

See also:
render();

Definition at line 81 of file qwt_graphic.h.


Constructor & Destructor Documentation

Constructor.

Initializes a null graphic

See also:
isNull()

Definition at line 344 of file qwt_graphic.cpp.

QwtGraphic::QwtGraphic ( const QwtGraphic other)

Copy constructor.

Parameters:
otherSource
See also:
operator=()

Definition at line 357 of file qwt_graphic.cpp.

QwtGraphic::~QwtGraphic ( ) [virtual]

Destructor.

Definition at line 365 of file qwt_graphic.cpp.


Member Function Documentation

QRectF QwtGraphic::boundingRect ( ) const

The bounding rectangle is the controlPointRect() extended by the areas needed for rendering the outlines with unscaled pens.

Returns:
Bounding rectangle of the graphic
See also:
controlPointRect(), scaledBoundingRect()

Definition at line 453 of file qwt_graphic.cpp.

const QVector< QwtPainterCommand > & QwtGraphic::commands ( ) const
Returns:
List of recorded paint commands
See also:
setCommands()

Definition at line 980 of file qwt_graphic.cpp.

QRectF QwtGraphic::controlPointRect ( ) const

The control point rectangle is the bounding rectangle of all control points of the paths and the target rectangles of the images/pixmaps.

Returns:
Control point rectangle
See also:
boundingRect(), scaledBoundingRect()

Definition at line 469 of file qwt_graphic.cpp.

QSizeF QwtGraphic::defaultSize ( ) const

Default size.

When a non empty size has been assigned by setDefaultSize() this size will be returned. Otherwise the default size is the size of the bounding rectangle.

The default size is used in all methods rendering the graphic, where no size is explicitly specified.

Returns:
Default size
See also:
setDefaultSize(), boundingRect()

Definition at line 551 of file qwt_graphic.cpp.

void QwtGraphic::drawImage ( const QRectF &  rect,
const QImage &  image,
const QRectF &  subRect,
Qt::ImageConversionFlags  flags 
) [protected, virtual]

Store a image command in the command list.

Parameters:
recttraget rectangle
imageImage to be painted
subRectReactangle of the pixmap to be painted
flagsImage conversion flags
See also:
QPaintEngine::drawImage()

Reimplemented from QwtNullPaintDevice.

Definition at line 923 of file qwt_graphic.cpp.

void QwtGraphic::drawPath ( const QPainterPath &  path) [protected, virtual]

Store a path command in the command list

Parameters:
pathPainter path
See also:
QPaintEngine::drawPath()

Reimplemented from QwtNullPaintDevice.

Definition at line 861 of file qwt_graphic.cpp.

void QwtGraphic::drawPixmap ( const QRectF &  rect,
const QPixmap &  pixmap,
const QRectF &  subRect 
) [protected, virtual]

Store a pixmap command in the command list.

Parameters:
recttarget rectangle
pixmapPixmap to be painted
subRectReactangle of the pixmap to be painted
See also:
QPaintEngine::drawPixmap()

Reimplemented from QwtNullPaintDevice.

Definition at line 899 of file qwt_graphic.cpp.

bool QwtGraphic::isEmpty ( ) const
Returns:
True, when the bounding rectangle is empty
See also:
boundingRect(), isNull()

Definition at line 412 of file qwt_graphic.cpp.

bool QwtGraphic::isNull ( ) const
Returns:
True, when no painter commands have been stored
See also:
isEmpty(), commands()

Definition at line 403 of file qwt_graphic.cpp.

QwtGraphic & QwtGraphic::operator= ( const QwtGraphic other)

Assignment operator.

Parameters:
otherSource
Returns:
A reference of this object

Definition at line 376 of file qwt_graphic.cpp.

void QwtGraphic::render ( QPainter *  painter) const

Replay all recorded painter commands.

Parameters:
painterQt painter

Definition at line 563 of file qwt_graphic.cpp.

void QwtGraphic::render ( QPainter *  painter,
const QSizeF &  size,
Qt::AspectRatioMode  aspectRatioMode = Qt::IgnoreAspectRatio 
) const

Replay all recorded painter commands.

The graphic is scaled to fit into the rectangle of the given size starting at ( 0, 0 ).

Parameters:
painterQt painter
sizeSize for the scaled graphic
aspectRatioModeMode how to scale - See Qt::AspectRatioMode

Definition at line 594 of file qwt_graphic.cpp.

void QwtGraphic::render ( QPainter *  painter,
const QRectF &  rect,
Qt::AspectRatioMode  aspectRatioMode = Qt::IgnoreAspectRatio 
) const

Replay all recorded painter commands.

The graphic is scaled to fit into the given rectangle

Parameters:
painterQt painter
rectRectangle for the scaled graphic
aspectRatioModeMode how to scale - See Qt::AspectRatioMode

Definition at line 610 of file qwt_graphic.cpp.

void QwtGraphic::render ( QPainter *  painter,
const QPointF &  pos,
Qt::Alignment  alignment = Qt::AlignTop | Qt::AlignLeft 
) const

Replay all recorded painter commands.

The graphic is scaled to the defaultSize() and aligned to a position.

Parameters:
painterQt painter
posReference point, where to render
alignmentFlags how to align the target rectangle to pos.

Definition at line 695 of file qwt_graphic.cpp.

Clear all stored commands.

See also:
isNull()

Definition at line 388 of file qwt_graphic.cpp.

QRectF QwtGraphic::scaledBoundingRect ( double  sx,
double  sy 
) const

Calculate the target rectangle for scaling the graphic.

Parameters:
sxHorizontal scaling factor
syVertical scaling factor
Note:
In case of paths that are painted with a cosmetic pen ( see QPen::isCosmetic() ) the target rectangle is different to multiplying the bounding rectangle.
Returns:
Scaled bounding rectangle
See also:
boundingRect(), controlPointRect()

Definition at line 490 of file qwt_graphic.cpp.

void QwtGraphic::setCommands ( QVector< QwtPainterCommand > &  commands)

Append paint commands.

Parameters:
commandsPaint commands
See also:
commands()

Definition at line 991 of file qwt_graphic.cpp.

void QwtGraphic::setDefaultSize ( const QSizeF &  size)

Set a default size.

The default size is used in all methods rendering the graphic, where no size is explicitly specified. Assigning an empty size means, that the default size will be calculated from the bounding rectangle.

The default setting is an empty size.

Parameters:
sizeDefault size
See also:
defaultSize(), boundingRect()

Definition at line 530 of file qwt_graphic.cpp.

void QwtGraphic::setRenderHint ( RenderHint  hint,
bool  on = true 
)

Toggle an render hint

Parameters:
hintRender hint
ontrue/false
See also:
testRenderHint(), RenderHint

Definition at line 425 of file qwt_graphic.cpp.

QSize QwtGraphic::sizeMetrics ( ) const [protected, virtual]
Returns:
Ceiled defaultSize()

Implements QwtNullPaintDevice.

Definition at line 510 of file qwt_graphic.cpp.

bool QwtGraphic::testRenderHint ( RenderHint  hint) const

Test a render hint

Parameters:
hintRender hint
Returns:
true/false
See also:
setRenderHint(), RenderHint

Definition at line 440 of file qwt_graphic.cpp.

QImage QwtGraphic::toImage ( ) const

Convert the graphic to a QImage.

All pixels of the image get initialized by 0 ( transparent ) before the graphic is scaled and rendered on it.

The format of the image is QImage::Format_ARGB32_Premultiplied.

The size of the image is the default size ( ceiled to integers ) of the graphic.

Returns:
The graphic as image in default size
See also:
defaultSize(), toPixmap(), render()

Definition at line 833 of file qwt_graphic.cpp.

QImage QwtGraphic::toImage ( const QSize &  size,
Qt::AspectRatioMode  aspectRatioMode = Qt::IgnoreAspectRatio 
) const

Convert the graphic to a QImage.

All pixels of the image get initialized by 0 ( transparent ) before the graphic is scaled and rendered on it.

The format of the image is QImage::Format_ARGB32_Premultiplied.

Parameters:
sizeSize of the image
aspectRatioModeAspect ratio how to scale the graphic
Returns:
The graphic as image
See also:
toPixmap(), render()

Definition at line 804 of file qwt_graphic.cpp.

QPixmap QwtGraphic::toPixmap ( ) const

Convert the graphic to a QPixmap.

All pixels of the pixmap get initialized by Qt::transparent before the graphic is scaled and rendered on it.

The size of the pixmap is the default size ( ceiled to integers ) of the graphic.

Returns:
The graphic as pixmap in default size
See also:
defaultSize(), toImage(), render()

Definition at line 741 of file qwt_graphic.cpp.

QPixmap QwtGraphic::toPixmap ( const QSize &  size,
Qt::AspectRatioMode  aspectRatioMode = Qt::IgnoreAspectRatio 
) const

Convert the graphic to a QPixmap.

All pixels of the pixmap get initialized by Qt::transparent before the graphic is scaled and rendered on it.

Parameters:
sizeSize of the image
aspectRatioModeAspect ratio how to scale the graphic
Returns:
The graphic as pixmap
See also:
toImage(), render()

Definition at line 775 of file qwt_graphic.cpp.

void QwtGraphic::updateBoundingRect ( const QRectF &  rect) [private]

Definition at line 949 of file qwt_graphic.cpp.

void QwtGraphic::updateControlPointRect ( const QRectF &  rect) [private]

Definition at line 968 of file qwt_graphic.cpp.

void QwtGraphic::updateState ( const QPaintEngineState &  state) [protected, virtual]

Store a state command in the command list.

Parameters:
stateState to be stored
See also:
QPaintEngine::updateState()

Reimplemented from QwtNullPaintDevice.

Definition at line 944 of file qwt_graphic.cpp.


Member Data Documentation

Reimplemented from QwtNullPaintDevice.

Definition at line 169 of file qwt_graphic.h.


The documentation for this class was generated from the following files:


plotjuggler
Author(s): Davide Faconti
autogenerated on Fri Sep 1 2017 02:41:57