QwtPlotIntervalCurve represents a series of samples, where each value is associated with an interval ( $[y1,y2] = f(x)$ ). More...

#include <qwt_plot_intervalcurve.h>

Inheritance diagram for QwtPlotIntervalCurve:

Classes
class	PrivateData

Public Types
enum	CurveStyle { NoCurve , Tube , UserCurve = 100 }
	Curve styles. More...

enum	PaintAttribute { ClipPolygons = 0x01 , ClipSymbol = 0x02 }
	Attributes to modify the drawing algorithm. More...

Public Types inherited from QwtPlotItem
enum	RttiValues { Rtti_PlotItem = 0 , Rtti_PlotGrid , Rtti_PlotScale , Rtti_PlotLegend , Rtti_PlotMarker , Rtti_PlotCurve , Rtti_PlotSpectroCurve , Rtti_PlotIntervalCurve , Rtti_PlotHistogram , Rtti_PlotSpectrogram , Rtti_PlotGraphic , Rtti_PlotTradingCurve , Rtti_PlotBarChart , Rtti_PlotMultiBarChart , Rtti_PlotShape , Rtti_PlotTextLabel , Rtti_PlotZone , Rtti_PlotVectorField , Rtti_PlotUserItem = 1000 }
	Runtime type information. More...

enum	ItemAttribute { Legend = 0x01 , AutoScale = 0x02 , Margins = 0x04 }
	Plot Item Attributes. More...

enum	ItemInterest { ScaleInterest = 0x01 , LegendInterest = 0x02 }
	Plot Item Interests/绘图项关注的事件类型 More...

enum	RenderHint { RenderAntialiased = 0x1 }
	Render hints. More...

Public Member Functions
	QwtPlotIntervalCurve (const QString &title=QString())
	Constructor.

	QwtPlotIntervalCurve (const QwtText &title)
	Constructor.

virtual	~QwtPlotIntervalCurve ()
	Destructor.

virtual int	rtti () const QWT_OVERRIDE

void	setPaintAttribute (PaintAttribute, bool on=true)
	Specify an attribute how to draw the curve.

bool	testPaintAttribute (PaintAttribute) const

void	setSamples (const QVector< QwtIntervalSample > &)
	Initialize data with an array of samples.

void	setSamples (QwtSeriesData< QwtIntervalSample > *)
	Assign a series of samples.

void	setPen (const QColor &, qreal width=0.0, Qt::PenStyle=Qt::SolidLine)
	Build and assign a pen.

void	setPen (const QPen &)
	Assign a pen.

const QPen &	pen () const

void	setBrush (const QBrush &)
	Assign a brush.

const QBrush &	brush () const

void	setStyle (CurveStyle style)
	Set the curve's drawing style.

CurveStyle	style () const

void	setSymbol (const QwtIntervalSymbol *)
	Assign a symbol.

const QwtIntervalSymbol *	symbol () const

virtual void	drawSeries (QPainter *, const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect, int from, int to) const QWT_OVERRIDE
	Draw a subset of the samples.

virtual QRectF	boundingRect () const QWT_OVERRIDE

virtual QwtGraphic	legendIcon (int index, const QSizeF &) const QWT_OVERRIDE

Public Member Functions inherited from QwtPlotSeriesItem
	QwtPlotSeriesItem (const QString &title=QString())
	Constructor.

	QwtPlotSeriesItem (const QwtText &title)
	Constructor.

virtual	~QwtPlotSeriesItem ()
	Destructor.

void	setOrientation (Qt::Orientation)
	Set the orientation of the item.

Qt::Orientation	orientation () const

virtual void	draw (QPainter *, const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect) const QWT_OVERRIDE
	Draw the complete series.

virtual void	updateScaleDiv (const QwtScaleDiv &, const QwtScaleDiv &) QWT_OVERRIDE
	Update the item to changes of the axes scale division.

Public Member Functions inherited from QwtPlotItem
	QwtPlotItem ()
	Constructor.

	QwtPlotItem (const QString &title)
	Constructor.

	QwtPlotItem (const QwtText &title)
	Constructor.

virtual	~QwtPlotItem ()
	Destroy the QwtPlotItem.

void	attach (QwtPlot *plot)
	Attach the item to a plot.

void	detach ()
	This method detaches a QwtPlotItem from any QwtPlot it has been associated with.

QwtPlot *	plot () const
	Return attached plot.

void	setTitle (const QString &title)
	Set a new title.

void	setTitle (const QwtText &title)
	Set a new title.

const QwtText &	title () const

void	setItemAttribute (ItemAttribute, bool on=true)
	Toggle an item attribute.

bool	testItemAttribute (ItemAttribute) const
	Test an item attribute.

void	setItemInterest (ItemInterest, bool on=true)
	Toggle an item interest.

bool	testItemInterest (ItemInterest) const
	Test an item interest.

void	setRenderHint (RenderHint, bool on=true)
	Toggle an render hint.

bool	testRenderHint (RenderHint) const
	Test a render hint.

void	setRenderThreadCount (uint numThreads)
	On multi core systems rendering of certain plot item ( f.e QwtPlotRasterItem ) can be done in parallel in several threads.

uint	renderThreadCount () const

void	setLegendIconSize (const QSize &)
	Set the size of the legend icon.

QSize	legendIconSize () const

double	z () const
	Plot items are painted in increasing z-order.

void	setZ (double z)
	Set the z value.

void	show ()
	Show the item.

void	hide ()
	Hide the item.

virtual void	setVisible (bool)
	Show/Hide the item.

bool	isVisible () const

void	setAxes (QwtAxisId xAxis, QwtAxisId yAxis)
	Set X and Y axis.

void	setXAxis (QwtAxisId)
	Set the X axis.

QwtAxisId	xAxis () const
	Return xAxis.

void	setYAxis (QwtAxisId)
	Set the Y axis.

QwtAxisId	yAxis () const
	Return yAxis.

virtual void	itemChanged ()
	Update the legend and call QwtPlot::autoRefresh() for the parent plot.

virtual void	legendChanged ()
	Update the legend of the parent plot.

virtual void	getCanvasMarginHint (const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect, double &left, double &top, double &right, double &bottom) const
	Calculate a hint for the canvas margin.

virtual void	updateLegend (const QwtPlotItem *, const QList< QwtLegendData > &)
	Update the item to changes of the legend info.

QRectF	scaleRect (const QwtScaleMap &, const QwtScaleMap &) const
	Calculate the bounding scale rectangle of 2 maps.

QRectF	paintRect (const QwtScaleMap &, const QwtScaleMap &) const
	Calculate the bounding paint rectangle of 2 maps.

virtual QList< QwtLegendData >	legendData () const
	Return all information, that is needed to represent the item on the legend.

Public Member Functions inherited from QwtAbstractSeriesStore
virtual	~QwtAbstractSeriesStore ()
	Destructor.

Public Member Functions inherited from QwtSeriesStore< QwtIntervalSample >
	QwtSeriesStore ()
	Constructor The store contains no series.

	~QwtSeriesStore ()
	Destructor.

void	setData (QwtSeriesData< QwtIntervalSample > *series)
	Assign a series of samples.

QwtSeriesData< QwtIntervalSample > *	data ()

const QwtSeriesData< QwtIntervalSample > *	data () const

QwtIntervalSample	sample (size_t index) const

virtual size_t	dataSize () const QWT_OVERRIDE

virtual QRectF	dataRect () const QWT_OVERRIDE

virtual void	setRectOfInterest (const QRectF &rect) QWT_OVERRIDE
	Set a the "rect of interest" for the series.

QwtSeriesData< QwtIntervalSample > *	swapData (QwtSeriesData< QwtIntervalSample > *series)
	Replace a series without deleting the previous one.

Protected Member Functions
void	init ()
	Initialize internal members.

virtual void	drawTube (QPainter *, const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect, int from, int to) const
	Draw a tube.

virtual void	drawSymbols (QPainter *, const QwtIntervalSymbol &, const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect, int from, int to) const
	Draw symbols for a subset of the samples.

Protected Member Functions inherited from QwtPlotSeriesItem
virtual void	dataChanged () QWT_OVERRIDE
	dataChanged() indicates, that the series has been changed.

Protected Member Functions inherited from QwtPlotItem
QwtGraphic	defaultIcon (const QBrush &, const QSizeF &) const
	Return a default icon from a brush.

Detailed Description

QwtPlotIntervalCurve represents a series of samples, where each value is associated with an interval ( $[y1,y2] = f(x)$ ).

The representation depends on the style() and an optional symbol() that is displayed for each interval. QwtPlotIntervalCurve might be used to display error bars or the area between 2 curves.

Member Enumeration Documentation

◆ CurveStyle

enum QwtPlotIntervalCurve::CurveStyle

Curve styles.

The default setting is QwtPlotIntervalCurve::Tube.

See also: setStyle(), style()

Enumerator

NoCurve

Don't draw a curve.

Note: This doesn't affect the symbols.

Tube

Build 2 curves from the upper and lower limits of the intervals and draw them with the pen().

The area between the curves is filled with the brush().

UserCurve

Styles >= QwtPlotIntervalCurve::UserCurve are reserved for derived classes that overload drawSeries() with additional application specific curve types.

◆ PaintAttribute

enum QwtPlotIntervalCurve::PaintAttribute

Attributes to modify the drawing algorithm.

See also: setPaintAttribute(), testPaintAttribute()

Enumerator

ClipPolygons

Clip polygons before painting them.

In situations, where points are far outside the visible area (f.e when zooming deep) this might be a substantial improvement for the painting performance.

ClipSymbol

Check if a symbol is on the plot canvas before painting it.

Constructor & Destructor Documentation

◆ QwtPlotIntervalCurve() [1/2]

QwtPlotIntervalCurve::QwtPlotIntervalCurve ( const QString & title = QString() )

explicit

Constructor.

Parameters

title Title of the curve

◆ QwtPlotIntervalCurve() [2/2]

QwtPlotIntervalCurve::QwtPlotIntervalCurve ( const QwtText & title )

explicit

Constructor.

Parameters

title Title of the curve

Member Function Documentation

◆ boundingRect()

QRectF QwtPlotIntervalCurve::boundingRect ( ) const

virtual

Returns: Bounding rectangle of all samples. For an empty series the rectangle is invalid.

Reimplemented from QwtPlotSeriesItem.

◆ brush()

const QBrush & QwtPlotIntervalCurve::brush ( ) const

Returns: Brush used to fill the area in Tube style()

See also: setBrush(), setStyle(), CurveStyle

◆ drawSeries()

void QwtPlotIntervalCurve::drawSeries	(	QPainter *	painter,
		const QwtScaleMap &	xMap,
		const QwtScaleMap &	yMap,
		const QRectF &	canvasRect,
		int	from,
		int	to
	)		const

virtual

Draw a subset of the samples.

Parameters

painter	Painter
xMap	Maps x-values into pixel coordinates.
yMap	Maps y-values into pixel coordinates.
canvasRect	Contents rectangle of the canvas
from	Index of the first sample to be painted
to	Index of the last sample to be painted. If to < 0 the series will be painted to its last sample.

See also: drawTube(), drawSymbols()

Implements QwtPlotSeriesItem.

◆ drawSymbols()

void QwtPlotIntervalCurve::drawSymbols	(	QPainter *	painter,
		const QwtIntervalSymbol &	symbol,
		const QwtScaleMap &	xMap,
		const QwtScaleMap &	yMap,
		const QRectF &	canvasRect,
		int	from,
		int	to
	)		const

protectedvirtual

Draw symbols for a subset of the samples.

Parameters

painter	Painter
symbol	Interval symbol
xMap	x map
yMap	y map
canvasRect	Contents rectangle of the canvas
from	Index of the first sample to be painted
to	Index of the last sample to be painted

See also: setSymbol(), drawSeries(), drawTube()

◆ drawTube()

void QwtPlotIntervalCurve::drawTube	(	QPainter *	painter,
		const QwtScaleMap &	xMap,
		const QwtScaleMap &	yMap,
		const QRectF &	canvasRect,
		int	from,
		int	to
	)		const

protectedvirtual

Draw a tube.

Builds 2 curves from the upper and lower limits of the intervals and draws them with the pen(). The area between the curves is filled with the brush().

Parameters

painter	Painter
xMap	Maps x-values into pixel coordinates.
yMap	Maps y-values into pixel coordinates.
canvasRect	Contents rectangle of the canvas
from	Index of the first sample to be painted
to	Index of the last sample to be painted. If to < 0 the series will be painted to its last sample.

See also: drawSeries(), drawSymbols()

◆ legendIcon()

QwtGraphic QwtPlotIntervalCurve::legendIcon	(	int	index,
		const QSizeF &	size
	)		const

virtual

Returns: Icon for the legend

In case of Tube style() the icon is a plain rectangle filled with the brush(). If a symbol is assigned it is scaled to size.

Parameters

index	Index of the legend entry ( ignored as there is only one )
size	Icon size

See also: QwtPlotItem::setLegendIconSize(), QwtPlotItem::legendData()

Reimplemented from QwtPlotItem.

◆ pen()

const QPen & QwtPlotIntervalCurve::pen ( ) const

Returns: Pen used to draw the lines

See also: setPen(), brush()

◆ rtti()

int QwtPlotIntervalCurve::rtti ( ) const

virtual

Returns: QwtPlotItem::Rtti_PlotIntervalCurve

Reimplemented from QwtPlotItem.

◆ setBrush()

void QwtPlotIntervalCurve::setBrush ( const QBrush & brush )

Assign a brush.

The brush is used to fill the area in Tube style().

Parameters

brush Brush

See also: brush(), pen(), setStyle(), CurveStyle

◆ setPaintAttribute()

void QwtPlotIntervalCurve::setPaintAttribute	(	PaintAttribute	attribute,
		bool	on = `true`
	)

Specify an attribute how to draw the curve.

Parameters

attribute	Paint attribute
on	On/Off

See also: testPaintAttribute()

◆ setPen() [1/2]

void QwtPlotIntervalCurve::setPen	(	const QColor &	color,
		qreal	width = `0.0`,
		Qt::PenStyle	style = `Qt::SolidLine`
	)

Build and assign a pen.

In Qt5 the default pen width is 1.0 ( 0.0 in Qt4 ) what makes it non cosmetic ( see QPen::isCosmetic() ). This method has been introduced to hide this incompatibility.

Parameters

color	Pen color
width	Pen width
style	Pen style

See also: pen(), brush()

◆ setPen() [2/2]

void QwtPlotIntervalCurve::setPen ( const QPen & pen )

Assign a pen.

Parameters

pen New pen

See also: pen(), brush()

◆ setSamples() [1/2]

void QwtPlotIntervalCurve::setSamples ( const QVector< QwtIntervalSample > & samples )

Initialize data with an array of samples.

Parameters

samples Vector of samples

◆ setSamples() [2/2]

void QwtPlotIntervalCurve::setSamples ( QwtSeriesData< QwtIntervalSample > * data )

Assign a series of samples.

setSamples() is just a wrapper for setData() without any additional value - beside that it is easier to find for the developer.

Parameters

data Data

Warning: The item takes ownership of the data object, deleting it when its not used anymore.

◆ setStyle()

void QwtPlotIntervalCurve::setStyle ( CurveStyle style )

Set the curve's drawing style.

Parameters

style Curve style

See also: CurveStyle, style()

◆ setSymbol()

void QwtPlotIntervalCurve::setSymbol ( const QwtIntervalSymbol * symbol )

Assign a symbol.

Parameters

symbol Symbol

See also: symbol()

◆ style()

QwtPlotIntervalCurve::CurveStyle QwtPlotIntervalCurve::style ( ) const

Returns: Style of the curve

See also: setStyle()

◆ symbol()

const QwtIntervalSymbol * QwtPlotIntervalCurve::symbol ( ) const

Returns: Current symbol or NULL, when no symbol has been assigned

See also: setSymbol()

◆ testPaintAttribute()

bool QwtPlotIntervalCurve::testPaintAttribute ( PaintAttribute attribute ) const

Returns: True, when attribute is enabled

See also: PaintAttribute, setPaintAttribute()

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

/home/runner/work/QWT/QWT/src/qwt_plot_intervalcurve.h
/home/runner/work/QWT/QWT/src/qwt_plot_intervalcurve.cpp

Classes

Public Types

Public Member Functions

Protected Member Functions

Detailed Description

Member Enumeration Documentation

◆ CurveStyle

◆ PaintAttribute

Constructor & Destructor Documentation

◆ QwtPlotIntervalCurve() [1/2]

◆ QwtPlotIntervalCurve() [2/2]

Member Function Documentation

◆ boundingRect()

◆ brush()

◆ drawSeries()

◆ drawSymbols()

◆ drawTube()

◆ legendIcon()

◆ pen()

◆ rtti()

◆ setBrush()

◆ setPaintAttribute()

◆ setPen() [1/2]

◆ setPen() [2/2]

◆ setSamples() [1/2]

◆ setSamples() [2/2]

◆ setStyle()

◆ setSymbol()

◆ style()

◆ symbol()

◆ testPaintAttribute()