QwtPlotRescaler takes care of fixed aspect ratios for plot scales. More...

#include <qwt_plot_rescaler.h>

Inheritance diagram for QwtPlotRescaler:

Public Types
enum	RescalePolicy { Fixed , Expanding , Fitting }

enum	ExpandingDirection { ExpandUp , ExpandDown , ExpandBoth }

Public Member Functions
	QwtPlotRescaler (QWidget *canvas, QwtAxisId referenceAxis=QwtAxis::XBottom, RescalePolicy=Expanding)

virtual	~QwtPlotRescaler ()
	Destructor.

void	setEnabled (bool)
	En/disable the rescaler. More...

bool	isEnabled () const

void	setRescalePolicy (RescalePolicy)

RescalePolicy	rescalePolicy () const

void	setExpandingDirection (ExpandingDirection)

void	setExpandingDirection (QwtAxisId, ExpandingDirection)

ExpandingDirection	expandingDirection (QwtAxisId) const

void	setReferenceAxis (QwtAxisId)

QwtAxisId	referenceAxis () const

void	setAspectRatio (double ratio)

void	setAspectRatio (QwtAxisId, double ratio)

double	aspectRatio (QwtAxisId) const

void	setIntervalHint (QwtAxisId, const QwtInterval &)

QwtInterval	intervalHint (QwtAxisId) const

QWidget *	canvas ()

const QWidget *	canvas () const

QwtPlot *	plot ()

const QwtPlot *	plot () const

virtual bool	eventFilter (QObject , QEvent ) override
	Event filter for the plot canvas.

void	rescale () const
	Adjust the plot axes scales.

Protected Member Functions
virtual void	canvasResizeEvent (QResizeEvent *)

virtual void	rescale (const QSize &oldSize, const QSize &newSize) const

virtual QwtInterval	expandScale (QwtAxisId, const QSize &oldSize, const QSize &newSize) const

virtual QwtInterval	syncScale (QwtAxisId, const QwtInterval &reference, const QSize &size) const

virtual void	updateScales (QwtInterval intervals[QwtAxis::AxisPositions]) const

Qt::Orientation	orientation (QwtAxisId) const

QwtInterval	interval (QwtAxisId) const

QwtInterval	expandInterval (const QwtInterval &, double width, ExpandingDirection) const

Detailed Description

QwtPlotRescaler takes care of fixed aspect ratios for plot scales.

QwtPlotRescaler auto adjusts the axes of a QwtPlot according to fixed aspect ratios.

Definition at line 29 of file qwt_plot_rescaler.h.

Member Enumeration Documentation

◆ ExpandingDirection

enum QwtPlotRescaler::ExpandingDirection

When rescalePolicy() is set to Expanding its direction depends on ExpandingDirection

Enumerator
ExpandUp	The upper limit of the scale is adjusted.
ExpandDown	The lower limit of the scale is adjusted.
ExpandBoth	Both limits of the scale are adjusted.

Definition at line 70 of file qwt_plot_rescaler.h.

◆ RescalePolicy

enum QwtPlotRescaler::RescalePolicy

The rescale policy defines how to rescale the reference axis and their depending axes.

See also: ExpandingDirection, setIntervalHint()

Enumerator

Fixed

The interval of the reference axis remains unchanged, when the geometry of the canvas changes. All other axes will be adjusted according to their aspect ratio.

Expanding

The interval of the reference axis will be shrunk/expanded, when the geometry of the canvas changes. All other axes will be adjusted according to their aspect ratio.

The interval, that is represented by one pixel is fixed.

Fitting

The intervals of the axes are calculated, so that all axes include their interval hint.

Definition at line 40 of file qwt_plot_rescaler.h.

Constructor & Destructor Documentation

◆ QwtPlotRescaler()

QwtPlotRescaler::QwtPlotRescaler	(	QWidget *	canvas,
		QwtAxisId	referenceAxis = `QwtAxis::XBottom`,
		RescalePolicy	policy = `Expanding`
	)

explicit

Constructor

Parameters

canvas	Canvas
referenceAxis	Reference axis, see RescalePolicy
policy	Rescale policy

See also: setRescalePolicy(), setReferenceAxis()

Definition at line 71 of file qwt_plot_rescaler.cpp.

Member Function Documentation

◆ aspectRatio()

double QwtPlotRescaler::aspectRatio ( QwtAxisId axisId ) const

Returns: Aspect ratio between an axis and the reference axis.

Parameters

axisId Axis

See also: setAspectRatio()

Definition at line 243 of file qwt_plot_rescaler.cpp.

◆ canvas() [1/2]

QWidget * QwtPlotRescaler::canvas ( )

Returns: plot canvas

Definition at line 282 of file qwt_plot_rescaler.cpp.

◆ canvas() [2/2]

const QWidget * QwtPlotRescaler::canvas ( ) const

Returns: plot canvas

Definition at line 288 of file qwt_plot_rescaler.cpp.

◆ canvasResizeEvent()

void QwtPlotRescaler::canvasResizeEvent ( QResizeEvent * event )

protectedvirtual

Event handler for resize events of the plot canvas

Parameters

event Resize event

See also: rescale()

Definition at line 343 of file qwt_plot_rescaler.cpp.

◆ expandingDirection()

QwtPlotRescaler::ExpandingDirection QwtPlotRescaler::expandingDirection ( QwtAxisId axisId ) const

Returns: Direction in which an axis should be expanded

Parameters

axisId Axis

See also: setExpandingDirection()

Definition at line 197 of file qwt_plot_rescaler.cpp.

◆ expandInterval()

QwtInterval QwtPlotRescaler::expandInterval	(	const QwtInterval &	interval,
		double	width,
		ExpandingDirection	direction
	)		const

protected

Expand the interval

Parameters

interval	Interval to be expanded
width	Distance to be added to the interval
direction	Direction of the expand operation

Returns: Expanded interval

Definition at line 526 of file qwt_plot_rescaler.cpp.

◆ expandScale()

QwtInterval QwtPlotRescaler::expandScale	(	QwtAxisId	axisId,
		const QSize &	oldSize,
		const QSize &	newSize
	)		const

protectedvirtual

Calculate the new scale interval of a plot axis

Parameters

axisId	Axis
oldSize	Previous size of the canvas
newSize	New size of the canvas

Returns: Calculated new interval for the axis

Definition at line 405 of file qwt_plot_rescaler.cpp.

◆ interval()

QwtInterval QwtPlotRescaler::interval ( QwtAxisId axisId ) const

protected

Parameters

axisId Axis

Returns: Normalized interval of an axis

Definition at line 509 of file qwt_plot_rescaler.cpp.

◆ intervalHint()

QwtInterval QwtPlotRescaler::intervalHint ( QwtAxisId axisId ) const

Parameters

axisId Axis

Returns: Interval hint

See also: setIntervalHint(), RescalePolicy

Definition at line 273 of file qwt_plot_rescaler.cpp.

◆ isEnabled()

bool QwtPlotRescaler::isEnabled ( ) const

Returns: true when enabled, false otherwise

See also: setEnabled, eventFilter()

Definition at line 118 of file qwt_plot_rescaler.cpp.

◆ orientation()

Qt::Orientation QwtPlotRescaler::orientation ( QwtAxisId axisId ) const

protected

Returns: Orientation of an axis

Parameters

axisId Axis

Definition at line 500 of file qwt_plot_rescaler.cpp.

◆ plot() [1/2]

QwtPlot * QwtPlotRescaler::plot ( )

Returns: plot widget

Definition at line 294 of file qwt_plot_rescaler.cpp.

◆ plot() [2/2]

const QwtPlot * QwtPlotRescaler::plot ( ) const

Returns: plot widget

Definition at line 304 of file qwt_plot_rescaler.cpp.

◆ referenceAxis()

QwtAxisId QwtPlotRescaler::referenceAxis ( ) const

Returns: Reference axis ( see RescalePolicy )

See also: setReferenceAxis()

Definition at line 158 of file qwt_plot_rescaler.cpp.

◆ rescale()

void QwtPlotRescaler::rescale	(	const QSize &	oldSize,
		const QSize &	newSize
	)		const

protectedvirtual

Adjust the plot axes scales

Parameters

oldSize	Previous size of the canvas
newSize	New size of the canvas

Definition at line 367 of file qwt_plot_rescaler.cpp.

◆ rescalePolicy()

QwtPlotRescaler::RescalePolicy QwtPlotRescaler::rescalePolicy ( ) const

Returns: Rescale policy

See also: setRescalePolicy()

Definition at line 138 of file qwt_plot_rescaler.cpp.

◆ setAspectRatio() [1/2]

void QwtPlotRescaler::setAspectRatio ( double ratio )

Set the aspect ratio between the scale of the reference axis and the other scales. The default ratio is 1.0

Parameters

ratio Aspect ratio

See also: aspectRatio()

Definition at line 212 of file qwt_plot_rescaler.cpp.

◆ setAspectRatio() [2/2]

void QwtPlotRescaler::setAspectRatio	(	QwtAxisId	axisId,
		double	ratio
	)

Set the aspect ratio between the scale of the reference axis and another scale. The default ratio is 1.0

Parameters

axisId	Axis
ratio	Aspect ratio

See also: aspectRatio()

Definition at line 226 of file qwt_plot_rescaler.cpp.

◆ setEnabled()

void QwtPlotRescaler::setEnabled ( bool on )

En/disable the rescaler.

When enabled is true an event filter is installed for the canvas, otherwise the event filter is removed.

Parameters

on	true or false

See also: isEnabled(), eventFilter()

Definition at line 97 of file qwt_plot_rescaler.cpp.

◆ setExpandingDirection() [1/2]

void QwtPlotRescaler::setExpandingDirection ( ExpandingDirection direction )

Set the direction in which all axis should be expanded

Parameters

direction Direction

See also: expandingDirection()

Definition at line 169 of file qwt_plot_rescaler.cpp.

◆ setExpandingDirection() [2/2]

void QwtPlotRescaler::setExpandingDirection	(	QwtAxisId	axisId,
		ExpandingDirection	direction
	)

Set the direction in which an axis should be expanded

Parameters

axisId	Axis
direction	Direction

See also: expandingDirection()

Definition at line 183 of file qwt_plot_rescaler.cpp.

◆ setIntervalHint()

void QwtPlotRescaler::setIntervalHint	(	QwtAxisId	axisId,
		const QwtInterval &	interval
	)

Set an interval hint for an axis

In Fitting mode, the hint is used as minimal interval that always needs to be displayed.

Parameters

axisId	Axis
interval	Axis

See also: intervalHint(), RescalePolicy

Definition at line 261 of file qwt_plot_rescaler.cpp.

◆ setReferenceAxis()

void QwtPlotRescaler::setReferenceAxis ( QwtAxisId axisId )

Set the reference axis ( see RescalePolicy )

Parameters

axisId Axis

See also: referenceAxis()

Definition at line 149 of file qwt_plot_rescaler.cpp.

◆ setRescalePolicy()

void QwtPlotRescaler::setRescalePolicy ( RescalePolicy policy )

Change the rescale policy

Parameters

policy Rescale policy

See also: rescalePolicy()

Definition at line 129 of file qwt_plot_rescaler.cpp.

◆ syncScale()

QwtInterval QwtPlotRescaler::syncScale	(	QwtAxisId	axisId,
		const QwtInterval &	reference,
		const QSize &	size
	)		const

protectedvirtual

Synchronize an axis scale according to the scale of the reference axis

Parameters

axisId	Axis
reference	Interval of the reference axis
size	Size of the canvas

Returns: New interval for axis

Definition at line 469 of file qwt_plot_rescaler.cpp.

◆ updateScales()

void QwtPlotRescaler::updateScales ( QwtInterval intervals[QwtAxis::AxisPositions] ) const

protectedvirtual

Update the axes scales

Parameters

intervals Scale intervals

Definition at line 588 of file qwt_plot_rescaler.cpp.

Public Types

Public Member Functions

Protected Member Functions

Detailed Description

Member Enumeration Documentation

◆ ExpandingDirection

◆ RescalePolicy

Constructor & Destructor Documentation

◆ QwtPlotRescaler()

Member Function Documentation

◆ aspectRatio()

◆ canvas() [1/2]

◆ canvas() [2/2]

◆ canvasResizeEvent()

◆ expandingDirection()

◆ expandInterval()

◆ expandScale()

◆ interval()

◆ intervalHint()

◆ isEnabled()

◆ orientation()

◆ plot() [1/2]

◆ plot() [2/2]

◆ referenceAxis()

◆ rescale()

◆ rescalePolicy()

◆ setAspectRatio() [1/2]

◆ setAspectRatio() [2/2]

◆ setEnabled()

◆ setExpandingDirection() [1/2]

◆ setExpandingDirection() [2/2]

◆ setIntervalHint()

◆ setReferenceAxis()

◆ setRescalePolicy()

◆ syncScale()

◆ updateScales()