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>

Inheritance diagram for QwtPlotRenderer:

[legend]

Public Types
enum	DiscardFlag { DiscardNone = 0x00, DiscardBackground = 0x01, DiscardTitle = 0x02, DiscardLegend = 0x04, DiscardCanvasBackground = 0x08, DiscardFooter = 0x10, DiscardCanvasFrame = 0x20 }
	Disard flags. More...

enum	LayoutFlag { DefaultLayout = 0x00, FrameWithScales = 0x01 }
	Layout flags. More...

typedef QFlags< DiscardFlag >	DiscardFlags
	Disard flags.

typedef QFlags< LayoutFlag >	LayoutFlags
	Layout flags.

Public Member Functions
	QwtPlotRenderer (QObject *=NULL)

virtual	~QwtPlotRenderer ()
	Destructor.

void	setDiscardFlag (DiscardFlag flag, bool on=true)

bool	testDiscardFlag (DiscardFlag flag) const

void	setDiscardFlags (DiscardFlags flags)

DiscardFlags	discardFlags () const

void	setLayoutFlag (LayoutFlag flag, bool on=true)

bool	testLayoutFlag (LayoutFlag flag) const

void	setLayoutFlags (LayoutFlags flags)

LayoutFlags	layoutFlags () 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)

void	renderTo (QwtPlot *, QPrinter &) const
	Render the plot to a QPrinter. More...

void	renderTo (QwtPlot *, QPaintDevice &) const
	Render the plot to a `QPaintDevice`. More...

virtual void	render (QwtPlot , QPainter , const QRectF &plotRect) const

virtual void	renderTitle (const QwtPlot , QPainter , const QRectF &titleRect) const

virtual void	renderFooter (const QwtPlot , QPainter , const QRectF &footerRect) const

virtual void	renderScale (const QwtPlot , QPainter , int axisId, int startDist, int endDist, int baseDist, const QRectF &scaleRect) const
	Paint a scale into a given rectangle. Paint the scale into a given rectangle. More...

virtual void	renderCanvas (const QwtPlot , QPainter , const QRectF &canvasRect, const QwtScaleMap *maps) const

virtual void	renderLegend (const QwtPlot , QPainter , const QRectF &legendRect) 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. More...

Detailed Description

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

Member Enumeration Documentation

◆ DiscardFlag

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

◆ LayoutFlag

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.

Constructor & Destructor Documentation

◆ QwtPlotRenderer()

QwtPlotRenderer::QwtPlotRenderer ( QObject * parent = NULL )

explicit

Constructor

Parameters

parent Parent object

Member Function Documentation

◆ discardFlags()

QwtPlotRenderer::DiscardFlags QwtPlotRenderer::discardFlags ( ) const

Returns: Flags, indicating what to discard from rendering

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

◆ exportTo()

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()

◆ layoutFlags()

QwtPlotRenderer::LayoutFlags QwtPlotRenderer::layoutFlags ( ) const

Returns: Layout flags

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

◆ render()

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()

◆ renderCanvas()

void QwtPlotRenderer::renderCanvas	(	const QwtPlot *	plot,
		QPainter *	painter,
		const QRectF &	canvasRect,
		const QwtScaleMap *	maps
	)		const

virtual

Render the canvas into a given rectangle.

Parameters

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

◆ renderDocument() [1/2]

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)

◆ renderDocument() [2/2]

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()

◆ renderFooter()

void QwtPlotRenderer::renderFooter	(	const QwtPlot *	plot,
		QPainter *	painter,
		const QRectF &	footerRect
	)		const

virtual

Render the footer into a given rectangle.

Parameters

plot	Plot widget
painter	Painter
footerRect	Bounding rectangle for the footer

◆ renderLegend()

void QwtPlotRenderer::renderLegend	(	const QwtPlot *	plot,
		QPainter *	painter,
		const QRectF &	legendRect
	)		const

virtual

Render the legend into a given rectangle.

Parameters

plot	Plot widget
painter	Painter
legendRect	Bounding rectangle for the legend

◆ renderScale()

void QwtPlotRenderer::renderScale	(	const QwtPlot *	plot,
		QPainter *	painter,
		int	axisId,
		int	startDist,
		int	endDist,
		int	baseDist,
		const QRectF &	scaleRect
	)		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
scaleRect	Bounding rectangle for the scale

◆ renderTitle()

void QwtPlotRenderer::renderTitle	(	const QwtPlot *	plot,
		QPainter *	painter,
		const QRectF &	titleRect
	)		const

virtual

Render the title into a given rectangle.

Parameters

plot	Plot widget
painter	Painter
titleRect	Bounding rectangle for the title

◆ renderTo() [1/2]

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()

◆ renderTo() [2/2]

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()

◆ setDiscardFlag()

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()

◆ setDiscardFlags()

void QwtPlotRenderer::setDiscardFlags ( DiscardFlags flags )

Set the flags, indicating what to discard from rendering

Parameters

flags Flags

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

◆ setLayoutFlag()

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()

◆ setLayoutFlags()

void QwtPlotRenderer::setLayoutFlags ( LayoutFlags flags )

Set the layout flags

Parameters

flags Flags

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

◆ testDiscardFlag()

bool QwtPlotRenderer::testDiscardFlag ( DiscardFlag flag ) const

Returns: True, if flag is enabled.

Parameters

flag	Flag to be tested

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

◆ testLayoutFlag()

bool QwtPlotRenderer::testLayoutFlag ( LayoutFlag flag ) const

Returns: True, if flag is enabled.

Parameters

flag	Flag to be tested

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

Public Types

Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ DiscardFlag

◆ LayoutFlag

Constructor & Destructor Documentation

◆ QwtPlotRenderer()

Member Function Documentation

◆ discardFlags()

◆ exportTo()

◆ layoutFlags()

◆ render()

◆ renderCanvas()

◆ renderDocument() [1/2]

◆ renderDocument() [2/2]

◆ renderFooter()

◆ renderLegend()

◆ renderScale()

◆ renderTitle()

◆ renderTo() [1/2]

◆ renderTo() [2/2]

◆ setDiscardFlag()

◆ setDiscardFlags()

◆ setLayoutFlag()

◆ setLayoutFlags()

◆ testDiscardFlag()

◆ testLayoutFlag()