Renderer for exporting a plot to a document, a printer or anything else, that is supported by QPainter/QPaintDevice. More...

#include <qwt_plot_renderer.h>

Classes
class	PrivateData
Public Types
enum	DiscardFlag { DiscardNone = 0x00, DiscardBackground = 0x01, DiscardTitle = 0x02, DiscardLegend = 0x04, DiscardCanvasBackground = 0x08, DiscardFooter = 0x10, DiscardCanvasFrame = 0x20 }
	Disard flags. More...
typedef QFlags< DiscardFlag >	DiscardFlags
	Disard flags.
enum	LayoutFlag { DefaultLayout = 0x00, FrameWithScales = 0x01 }
	Layout flags. More...
typedef QFlags< LayoutFlag >	LayoutFlags
	Layout flags.
Public Member Functions
DiscardFlags	discardFlags () const
bool	exportTo (QwtPlot *, const QString &documentName, const QSizeF &sizeMM=QSizeF(300, 200), int resolution=85)
	Execute a file dialog and render the plot to the selected file.
LayoutFlags	layoutFlags () const
	QwtPlotRenderer (QObject *=NULL)
virtual void	render (QwtPlot , QPainter , const QRectF &rect) const
virtual void	renderCanvas (const QwtPlot , QPainter , const QRectF &canvasRect, const QwtScaleMap *maps) const
void	renderDocument (QwtPlot *, const QString &fileName, const QSizeF &sizeMM, int resolution=85)
void	renderDocument (QwtPlot *, const QString &fileName, const QString &format, const QSizeF &sizeMM, int resolution=85)
virtual void	renderFooter (const QwtPlot , QPainter , const QRectF &) const
virtual void	renderLegend (const QwtPlot , QPainter , const QRectF &) const
virtual void	renderScale (const QwtPlot , QPainter , int axisId, int startDist, int endDist, int baseDist, const QRectF &) const
	Paint a scale into a given rectangle. Paint the scale into a given rectangle.
virtual void	renderTitle (const QwtPlot , QPainter , const QRectF &) const
void	renderTo (QwtPlot *, QPrinter &) const
	Render the plot to a QPrinter.
void	renderTo (QwtPlot *, QPaintDevice &p) const
	Render the plot to a `QPaintDevice`.
void	setDiscardFlag (DiscardFlag flag, bool on=true)
void	setDiscardFlags (DiscardFlags flags)
void	setLayoutFlag (LayoutFlag flag, bool on=true)
void	setLayoutFlags (LayoutFlags flags)
bool	testDiscardFlag (DiscardFlag flag) const
bool	testLayoutFlag (LayoutFlag flag) const
virtual	~QwtPlotRenderer ()
	Destructor.
Private Member Functions
void	buildCanvasMaps (const QwtPlot *, const QRectF &, QwtScaleMap maps[]) const
bool	updateCanvasMargins (QwtPlot *, const QRectF &, const QwtScaleMap maps[]) const
Private Attributes
PrivateData *	d_data

Detailed Description

Renderer for exporting a plot to a document, a printer or anything else, that is supported by QPainter/QPaintDevice.

Definition at line 39 of file qwt_plot_renderer.h.

Member Typedef Documentation

typedef QFlags<DiscardFlag> QwtPlotRenderer::DiscardFlags

Disard flags.

Definition at line 77 of file qwt_plot_renderer.h.

typedef QFlags<LayoutFlag> QwtPlotRenderer::LayoutFlags

Layout flags.

Definition at line 96 of file qwt_plot_renderer.h.

Member Enumeration Documentation

enum QwtPlotRenderer::DiscardFlag

Disard flags.

Enumerator:

DiscardNone	Render all components of the plot.
DiscardBackground	Don't render the background of the plot.
DiscardTitle	Don't render the title of the plot.
DiscardLegend	Don't render the legend of the plot.
DiscardCanvasBackground	Don't render the background of the canvas.
DiscardFooter	Don't render the footer of the plot.
DiscardCanvasFrame	Don't render the frame of the canvas Note: This flag has no effect when using style sheets, where the frame is part of the background

Definition at line 45 of file qwt_plot_renderer.h.

enum QwtPlotRenderer::LayoutFlag

Layout flags.

See also:: setLayoutFlag(), testLayoutFlag()

Enumerator:

DefaultLayout	Use the default layout as on screen.
FrameWithScales	Instead of the scales a box is painted around the plot canvas, where the scale ticks are aligned to.

Definition at line 83 of file qwt_plot_renderer.h.

Constructor & Destructor Documentation

QwtPlotRenderer::QwtPlotRenderer ( QObject * parent = NULL ) [explicit]

Constructor

Parameters:

parent Parent object

Definition at line 116 of file qwt_plot_renderer.cpp.

QwtPlotRenderer::~QwtPlotRenderer ( ) [virtual]

Destructor.

Definition at line 123 of file qwt_plot_renderer.cpp.

Member Function Documentation

void QwtPlotRenderer::buildCanvasMaps	(	const QwtPlot *	plot,
		const QRectF &	canvasRect,
		QwtScaleMap	maps[]
	)		const `[private]`

Calculated the scale maps for rendering the canvas

Parameters:

plot	Plot widget
canvasRect	Target rectangle
maps	Scale maps to be calculated

Definition at line 921 of file qwt_plot_renderer.cpp.

QwtPlotRenderer::DiscardFlags QwtPlotRenderer::discardFlags ( ) const

Returns:: Flags, indicating what to discard from rendering

See also:: DiscardFlag, setDiscardFlags(), setDiscardFlag(), testDiscardFlag()

Definition at line 169 of file qwt_plot_renderer.cpp.

bool QwtPlotRenderer::exportTo	(	QwtPlot *	plot,
		const QString &	documentName,
		const QSizeF &	sizeMM = `QSizeF( 300, 200 )`,
		int	resolution = `85`
	)

Execute a file dialog and render the plot to the selected file.

Parameters:

plot	Plot widget
documentName	Default document name
sizeMM	Size for the document in millimeters.
resolution	Resolution in dots per Inch (dpi)

Returns:: True, when exporting was successful

See also:: renderDocument()

Definition at line 1005 of file qwt_plot_renderer.cpp.

QwtPlotRenderer::LayoutFlags QwtPlotRenderer::layoutFlags ( ) const

Returns:: Layout flags

See also:: LayoutFlag, setLayoutFlags(), setLayoutFlag(), testLayoutFlag()

Definition at line 215 of file qwt_plot_renderer.cpp.

void QwtPlotRenderer::render	(	QwtPlot *	plot,
		QPainter *	painter,
		const QRectF &	plotRect
	)		const `[virtual]`

Paint the contents of a QwtPlot instance into a given rectangle.

Parameters:

plot	Plot to be rendered
painter	Painter
plotRect	Bounding rectangle

See also:: renderDocument(), renderTo(), QwtPainter::setRoundingAlignment()

Definition at line 452 of file qwt_plot_renderer.cpp.

void QwtPlotRenderer::renderCanvas	(	const QwtPlot *	plot,
		QPainter *	painter,
		const QRectF &	canvasRect,
		const QwtScaleMap *	map
	)		const `[virtual]`

Render the canvas into a given rectangle.

Parameters:

plot	Plot widget
painter	Painter
map	Maps mapping between plot and paint device coordinates
canvasRect	Canvas rectangle

Definition at line 787 of file qwt_plot_renderer.cpp.

void QwtPlotRenderer::renderDocument	(	QwtPlot *	plot,
		const QString &	fileName,
		const QSizeF &	sizeMM,
		int	resolution = `85`
	)

Render a plot to a file

The format of the document will be auto-detected from the suffix of the file name.

Parameters:

plot	Plot widget
fileName	Path of the file, where the document will be stored
sizeMM	Size for the document in millimeters.
resolution	Resolution in dots per Inch (dpi)

Definition at line 231 of file qwt_plot_renderer.cpp.

void QwtPlotRenderer::renderDocument	(	QwtPlot *	plot,
		const QString &	fileName,
		const QString &	format,
		const QSizeF &	sizeMM,
		int	resolution = `85`
	)

Render a plot to a file

Supported formats are:

pdf
Portable Document Format PDF
ps
Postcript
svg
Scalable Vector Graphics SVG
all image formats supported by Qt
see QImageWriter::supportedImageFormats()

Scalable vector graphic formats like PDF or SVG are superior to raster graphics formats.

Parameters:

plot	Plot widget
fileName	Path of the file, where the document will be stored
format	Format for the document
sizeMM	Size for the document in millimeters.
resolution	Resolution in dots per Inch (dpi)

See also:: renderTo(), render(), QwtPainter::setRoundingAlignment()

Definition at line 263 of file qwt_plot_renderer.cpp.

void QwtPlotRenderer::renderFooter	(	const QwtPlot *	plot,
		QPainter *	painter,
		const QRectF &	rect
	)		const `[virtual]`

Render the footer into a given rectangle.

Parameters:

plot	Plot widget
painter	Painter
rect	Bounding rectangle

Definition at line 656 of file qwt_plot_renderer.cpp.

void QwtPlotRenderer::renderLegend	(	const QwtPlot *	plot,
		QPainter *	painter,
		const QRectF &	rect
	)		const `[virtual]`

Render the legend into a given rectangle.

Parameters:

plot	Plot widget
painter	Painter
rect	Bounding rectangle

Definition at line 676 of file qwt_plot_renderer.cpp.

void QwtPlotRenderer::renderScale	(	const QwtPlot *	plot,
		QPainter *	painter,
		int	axisId,
		int	startDist,
		int	endDist,
		int	baseDist,
		const QRectF &	rect
	)		const `[virtual]`

Paint a scale into a given rectangle. Paint the scale into a given rectangle.

Parameters:

plot	Plot widget
painter	Painter
axisId	Axis
startDist	Start border distance
endDist	End border distance
baseDist	Base distance
rect	Bounding rectangle

Definition at line 698 of file qwt_plot_renderer.cpp.

void QwtPlotRenderer::renderTitle	(	const QwtPlot *	plot,
		QPainter *	painter,
		const QRectF &	rect
	)		const `[virtual]`

Render the title into a given rectangle.

Parameters:

plot	Plot widget
painter	Painter
rect	Bounding rectangle

Definition at line 637 of file qwt_plot_renderer.cpp.

void QwtPlotRenderer::renderTo	(	QwtPlot *	plot,
		QPrinter &	printer
	)		const

Render the plot to a QPrinter.

This function renders the contents of a QwtPlot instance to QPaintDevice object. The size is derived from the printer metrics.

Parameters:

plot	Plot to be rendered
printer	Printer to paint on

See also:: renderDocument(), render(), QwtPainter::setRoundingAlignment()

Definition at line 397 of file qwt_plot_renderer.cpp.

void QwtPlotRenderer::renderTo	(	QwtPlot *	plot,
		QPaintDevice &	paintDevice
	)		const

Render the plot to a QPaintDevice.

This function renders the contents of a QwtPlot instance to QPaintDevice object. The target rectangle is derived from its device metrics.

Parameters:

plot	Plot to be rendered
paintDevice	device to paint on, f.e a QImage

See also:: renderDocument(), render(), QwtPainter::setRoundingAlignment()

Definition at line 372 of file qwt_plot_renderer.cpp.

void QwtPlotRenderer::setDiscardFlag	(	DiscardFlag	flag,
		bool	on = `true`
	)

Change a flag, indicating what to discard from rendering

Parameters:

flag	Flag to change
on	On/Off

See also:: DiscardFlag, testDiscardFlag(), setDiscardFlags(), discardFlags()

Definition at line 136 of file qwt_plot_renderer.cpp.

void QwtPlotRenderer::setDiscardFlags ( DiscardFlags flags )

Set the flags, indicating what to discard from rendering

Parameters:

flags Flags

See also:: DiscardFlag, setDiscardFlag(), testDiscardFlag(), discardFlags()

Definition at line 160 of file qwt_plot_renderer.cpp.

void QwtPlotRenderer::setLayoutFlag	(	LayoutFlag	flag,
		bool	on = `true`
	)

Change a layout flag

Parameters:

flag	Flag to change
on	On/Off

See also:: LayoutFlag, testLayoutFlag(), setLayoutFlags(), layoutFlags()

Definition at line 182 of file qwt_plot_renderer.cpp.

void QwtPlotRenderer::setLayoutFlags ( LayoutFlags flags )

Set the layout flags

Parameters:

flags Flags

See also:: LayoutFlag, setLayoutFlag(), testLayoutFlag(), layoutFlags()

Definition at line 206 of file qwt_plot_renderer.cpp.

bool QwtPlotRenderer::testDiscardFlag ( DiscardFlag flag ) const

Returns:: True, if flag is enabled.

Parameters:

flag	Flag to be tested

See also:: DiscardFlag, setDiscardFlag(), setDiscardFlags(), discardFlags()

Definition at line 149 of file qwt_plot_renderer.cpp.

bool QwtPlotRenderer::testLayoutFlag ( LayoutFlag flag ) const

Returns:: True, if flag is enabled.

Parameters:

flag	Flag to be tested

See also:: LayoutFlag, setLayoutFlag(), setLayoutFlags(), layoutFlags()

Definition at line 195 of file qwt_plot_renderer.cpp.

bool QwtPlotRenderer::updateCanvasMargins	(	QwtPlot *	plot,
		const QRectF &	canvasRect,
		const QwtScaleMap	maps[]
	)		const `[private]`

Definition at line 972 of file qwt_plot_renderer.cpp.

Member Data Documentation

PrivateData* QwtPlotRenderer::d_data [private]

Definition at line 165 of file qwt_plot_renderer.h.

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

Classes

Public Types

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Member Typedef Documentation

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation