A paint device for scalable graphics. More...

#include <qwt_graphic.h>

Inheritance diagram for QwtGraphic:

Classes
class	PathInfo

class	PrivateData

Public Types
enum	CommandType { VectorData = 1 << 0, RasterData = 1 << 1, Transformation = 1 << 2 }

typedef QFlags< CommandType >	CommandTypes

enum	RenderHint { RenderPensUnscaled = 0x1 }

typedef QFlags< RenderHint >	RenderHints
	Render hints. More...

Public Types inherited from QwtNullPaintDevice
enum	Mode { NormalMode, PolygonPathMode, PathMode }
	Render mode. More...

Public Member Functions
QRectF	boundingRect () const

const QVector< QwtPainterCommand > &	commands () const

CommandTypes	commandTypes () const

QRectF	controlPointRect () const

QSizeF	defaultSize () const
	Default size. More...

qreal	heightForWidth (qreal width) const

bool	isEmpty () const

bool	isNull () const

QwtGraphic &	operator= (const QwtGraphic &)
	Assignment operator. More...

	QwtGraphic ()
	Constructor. More...

	QwtGraphic (const QwtGraphic &)
	Copy constructor. More...

void	render (QPainter *) const
	Replay all recorded painter commands. More...

void	render (QPainter *, const QSizeF &, Qt::AspectRatioMode=Qt::IgnoreAspectRatio) const
	Replay all recorded painter commands. More...

void	render (QPainter *, const QPointF &, Qt::Alignment=Qt::AlignTop\|Qt::AlignLeft) const
	Replay all recorded painter commands. More...

void	render (QPainter *, const QRectF &, Qt::AspectRatioMode=Qt::IgnoreAspectRatio) const
	Replay all recorded painter commands. More...

RenderHints	renderHints () const

void	reset ()
	Clear all stored commands. More...

QRectF	scaledBoundingRect (qreal sx, qreal sy) const
	Calculate the target rectangle for scaling the graphic. More...

void	setCommands (const QVector< QwtPainterCommand > &)
	Append paint commands. More...

void	setDefaultSize (const QSizeF &)
	Set a default size. More...

void	setRenderHint (RenderHint, bool on=true)

bool	testRenderHint (RenderHint) const

QImage	toImage (qreal devicePixelRatio=0.0) const
	Convert the graphic to a QImage. More...

QImage	toImage (const QSize &, Qt::AspectRatioMode=Qt::IgnoreAspectRatio, qreal devicePixelRatio=0.0) const
	Convert the graphic to a QImage. More...

QPixmap	toPixmap (qreal devicePixelRatio=0.0) const
	Convert the graphic to a QPixmap. More...

QPixmap	toPixmap (const QSize &, Qt::AspectRatioMode=Qt::IgnoreAspectRatio, qreal devicePixelRatio=0.0) const
	Convert the graphic to a QPixmap. More...

qreal	widthForHeight (qreal height) const

virtual	~QwtGraphic ()
	Destructor. More...

Public Member Functions inherited from QwtNullPaintDevice
virtual void	drawEllipse (const QRectF &)
	See QPaintEngine::drawEllipse() More...

virtual void	drawEllipse (const QRect &)
	See QPaintEngine::drawEllipse() More...

virtual void	drawLines (const QLine *, int)
	See QPaintEngine::drawLines() More...

virtual void	drawLines (const QLineF *, int)
	See QPaintEngine::drawLines() More...

virtual void	drawPoints (const QPointF *, int)
	See QPaintEngine::drawPoints() More...

virtual void	drawPoints (const QPoint *, int)
	See QPaintEngine::drawPoints() More...

virtual void	drawPolygon (const QPointF *, int, QPaintEngine::PolygonDrawMode)
	See QPaintEngine::drawPolygon() More...

virtual void	drawPolygon (const QPoint *, int, QPaintEngine::PolygonDrawMode)
	See QPaintEngine::drawPolygon() More...

virtual void	drawRects (const QRect *, int)
	See QPaintEngine::drawRects() More...

virtual void	drawRects (const QRectF *, int)
	See QPaintEngine::drawRects() More...

virtual void	drawTextItem (const QPointF &, const QTextItem &)
	See QPaintEngine::drawTextItem() More...

virtual void	drawTiledPixmap (const QRectF &, const QPixmap &, const QPointF &)
	See QPaintEngine::drawTiledPixmap() More...

virtual int	metric (PaintDeviceMetric) const QWT_OVERRIDE

Mode	mode () const

virtual QPaintEngine *	paintEngine () const QWT_OVERRIDE
	See QPaintDevice::paintEngine() More...

	QwtNullPaintDevice ()
	Constructor. More...

void	setMode (Mode)

virtual	~QwtNullPaintDevice ()
	Destructor. More...

Protected Member Functions
virtual void	drawImage (const QRectF &, const QImage &, const QRectF &, Qt::ImageConversionFlags) QWT_OVERRIDE
	Store a image command in the command list. More...

virtual void	drawPath (const QPainterPath &) QWT_OVERRIDE

virtual void	drawPixmap (const QRectF &, const QPixmap &, const QRectF &) QWT_OVERRIDE
	Store a pixmap command in the command list. More...

virtual QSize	sizeMetrics () const QWT_OVERRIDE

virtual void	updateState (const QPaintEngineState &) QWT_OVERRIDE
	Store a state command in the command list. More...

Private Member Functions
void	renderGraphic (QPainter , QTransform ) const

void	updateBoundingRect (const QRectF &)

void	updateControlPointRect (const QRectF &)

Private Attributes
PrivateData *	d_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:

QPicture
Unfortunately QPicture had been forgotten, when Qt4 introduced floating point based render engines. Its API is still on integers, what make it unusable for proper scaling.
QSvgRenderer/QSvgGenerator
Unfortunately QSvgRenderer hides to much information about its nodes in internal APIs, that are necessary for proper layout calculations. Also it is derived from QObject and can't be copied like QImage/QPixmap.

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:

control point rectangle
The control point rectangle is the bounding rectangle of all control point rectangles of the painter paths, or the target rectangle of the pixmaps/images.
bounding rectangle
The bounding rectangle extends the control point rectangle by what is needed for rendering the outline with an unscaled pen.

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 75 of file qwt_graphic.h.

Member Typedef Documentation

typedef QFlags< CommandType > QwtGraphic::CommandTypes

Flag indicating what types of painter commands are in a QskGraphic

See also: commandTypes();

Definition at line 126 of file qwt_graphic.h.

typedef QFlags< RenderHint > QwtGraphic::RenderHints

Render hints.

The default setting is to disable all hints

Definition at line 104 of file qwt_graphic.h.

Member Enumeration Documentation

enum QwtGraphic::CommandType

Indicator if the graphic contains a specific type of painter command

See also: CommandTypes, commandTypes();

Enumerator
VectorData	The graphic contains scalable vector data.
RasterData	The graphic contains raster data ( QPixmap or QImage )
Transformation	The graphic contains transformations beyond simple translations.

Definition at line 110 of file qwt_graphic.h.

enum QwtGraphic::RenderHint

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 82 of file qwt_graphic.h.

Constructor & Destructor Documentation

QwtGraphic::QwtGraphic ( )

Constructor.

Initializes a null graphic

See also: isNull()

Definition at line 355 of file qwt_graphic.cpp.

QwtGraphic::QwtGraphic ( const QwtGraphic & other )

Copy constructor.

Parameters

other Source

See also: operator=()

Definition at line 368 of file qwt_graphic.cpp.

QwtGraphic::~QwtGraphic ( )

virtual

Destructor.

Definition at line 376 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 479 of file qwt_graphic.cpp.

const QVector< QwtPainterCommand > & QwtGraphic::commands ( ) const

Returns: List of recorded paint commands

See also: setCommands()

Definition at line 1122 of file qwt_graphic.cpp.

QwtGraphic::CommandTypes QwtGraphic::commandTypes ( ) const

Returns: Types of painter commands being used

Definition at line 432 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 495 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 576 of file qwt_graphic.cpp.

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

protectedvirtual

Store a image command in the command list.

Parameters

rect	traget rectangle
image	Image to be painted
subRect	Reactangle of the pixmap to be painted
flags	Image conversion flags

See also: QPaintEngine::drawImage()

Reimplemented from QwtNullPaintDevice.

Definition at line 1050 of file qwt_graphic.cpp.

void QwtGraphic::drawPath ( const QPainterPath & path )

protectedvirtual

Store a path command in the command list

Parameters

path	Painter path

See also: QPaintEngine::drawPath()

Reimplemented from QwtNullPaintDevice.

Definition at line 986 of file qwt_graphic.cpp.

void QwtGraphic::drawPixmap	(	const QRectF &	rect,
		const QPixmap &	pixmap,
		const QRectF &	subRect
	)

protectedvirtual

Store a pixmap command in the command list.

Parameters

rect	target rectangle
pixmap	Pixmap to be painted
subRect	Reactangle of the pixmap to be painted

See also: QPaintEngine::drawPixmap()

Reimplemented from QwtNullPaintDevice.

Definition at line 1025 of file qwt_graphic.cpp.

qreal QwtGraphic::heightForWidth ( qreal width ) const

Find the height for a given width

The height is calculated using the aspect ratio of defaultSize().

Parameters

width Width

Returns: Calculated height

See also: defaultSize()

Definition at line 594 of file qwt_graphic.cpp.

bool QwtGraphic::isEmpty ( ) const

Returns: True, when the bounding rectangle is empty

See also: boundingRect(), isNull()

Definition at line 424 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 415 of file qwt_graphic.cpp.

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

Assignment operator.

Parameters

other Source

Returns: A reference of this object

Definition at line 387 of file qwt_graphic.cpp.

void QwtGraphic::render ( QPainter * painter ) const

Replay all recorded painter commands.

Parameters

painter Qt painter

Definition at line 626 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

painter	Qt painter
size	Size for the scaled graphic
aspectRatioMode	Mode how to scale - See Qt::AspectRatioMode

Definition at line 662 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

painter	Qt painter
pos	Reference point, where to render
alignment	Flags how to align the target rectangle to pos.

Definition at line 764 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

painter	Qt painter
rect	Rectangle for the scaled graphic
aspectRatioMode	Mode how to scale - See Qt::AspectRatioMode

Definition at line 678 of file qwt_graphic.cpp.

void QwtGraphic::renderGraphic	(	QPainter *	painter,
		QTransform *	initialTransform
	)		const

private

Definition at line 631 of file qwt_graphic.cpp.

QwtGraphic::RenderHints QwtGraphic::renderHints ( ) const

Returns: Render hints

Definition at line 466 of file qwt_graphic.cpp.

void QwtGraphic::reset ( )

Clear all stored commands.

See also: isNull()

Definition at line 399 of file qwt_graphic.cpp.

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

Calculate the target rectangle for scaling the graphic.

Parameters

sx	Horizontal scaling factor
sy	Vertical 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 516 of file qwt_graphic.cpp.

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

Append paint commands.

Parameters

commands Paint commands

See also: commands()

Definition at line 1133 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

size	Default size

See also: defaultSize(), boundingRect()

Definition at line 555 of file qwt_graphic.cpp.

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

Toggle an render hint

Parameters

hint	Render hint
on	true/false

See also: testRenderHint(), RenderHint

Definition at line 445 of file qwt_graphic.cpp.

QSize QwtGraphic::sizeMetrics ( ) const

protectedvirtual

Returns: Ceiled defaultSize()

Implements QwtNullPaintDevice.

Definition at line 535 of file qwt_graphic.cpp.

bool QwtGraphic::testRenderHint ( RenderHint hint ) const

Test a render hint

Parameters

hint	Render hint

Returns: true/false

See also: setRenderHint(), RenderHint

Definition at line 460 of file qwt_graphic.cpp.

QImage QwtGraphic::toImage ( qreal devicePixelRatio = 0.0 ) 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 multiplied by the devicePixelRatio.

Parameters

devicePixelRatio Device pixel ratio for the image. If devicePixelRatio <= 0.0 the pixmap is initialized with the system default.

Returns: The graphic as image in default size

See also: defaultSize(), toPixmap(), render()

Definition at line 945 of file qwt_graphic.cpp.

QImage QwtGraphic::toImage	(	const QSize &	size,
		Qt::AspectRatioMode	aspectRatioMode = `Qt::IgnoreAspectRatio`,
		qreal	devicePixelRatio = `0.0`
	)		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

size	Size of the image ( will be multiplied by the devicePixelRatio )
aspectRatioMode	Aspect ratio how to scale the graphic
devicePixelRatio	Device pixel ratio for the image. If devicePixelRatio <= 0.0 the pixmap is initialized with the system default.

Returns: The graphic as image

See also: toPixmap(), render()

Definition at line 902 of file qwt_graphic.cpp.

QPixmap QwtGraphic::toPixmap ( qreal devicePixelRatio = 0.0 ) 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.

Parameters

devicePixelRatio Device pixel ratio for the pixmap. If devicePixelRatio <= 0.0 the pixmap is initialized with the system default.

Returns: The graphic as pixmap in default size

See also: defaultSize(), toImage(), render()

Definition at line 814 of file qwt_graphic.cpp.

QPixmap QwtGraphic::toPixmap	(	const QSize &	size,
		Qt::AspectRatioMode	aspectRatioMode = `Qt::IgnoreAspectRatio`,
		qreal	devicePixelRatio = `0.0`
	)		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

size	Size of the image
aspectRatioMode	Aspect ratio how to scale the graphic
devicePixelRatio	Device pixel ratio for the pixmap. If devicePixelRatio <= 0.0 the pixmap is initialized with the system default.

Returns: The graphic as pixmap

See also: toImage(), render()

Definition at line 861 of file qwt_graphic.cpp.

void QwtGraphic::updateBoundingRect ( const QRectF & rect )

private

Definition at line 1091 of file qwt_graphic.cpp.

void QwtGraphic::updateControlPointRect ( const QRectF & rect )

private

Definition at line 1110 of file qwt_graphic.cpp.

void QwtGraphic::updateState ( const QPaintEngineState & state )

protectedvirtual

Store a state command in the command list.

Parameters

state State to be stored

See also: QPaintEngine::updateState()

Reimplemented from QwtNullPaintDevice.

Definition at line 1072 of file qwt_graphic.cpp.

qreal QwtGraphic::widthForHeight ( qreal height ) const

Find the width for a given height

The width is calculated using the aspect ratio of defaultSize().

Parameters

height Height

Returns: Calculated width

See also: defaultSize()

Definition at line 613 of file qwt_graphic.cpp.

Member Data Documentation

PrivateData* QwtGraphic::d_data

private

Definition at line 205 of file qwt_graphic.h.

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

Classes

Public Types

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Detailed Description

Member Typedef Documentation

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation