QwtPlotHistogram represents a series of samples, where an interval is associated with a value ( $y = f([x1,x2])$ ) More...

#include <qwt_plot_histogram.h>

Inheritance diagram for QwtPlotHistogram:

Classes
class	PrivateData

Public Types
enum	HistogramStyle { Outline , Columns , Lines , UserStyle = 100 }
	Histogram styles. 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_PlotArrowMarker , Rtti_PlotBoxChart , 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
	QwtPlotHistogram (const QString &title=QString())
	Constructor with QString title.

	QwtPlotHistogram (const QwtText &title)
	Constructor with QwtText title.

virtual	~QwtPlotHistogram ()
	Destructor .

virtual int	rtti () const override
	Get the runtime type information.

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

void	setPen (const QPen &)
	Assign a pen, that is used in a style() depending way.

const QPen &	pen () const
	Get the pen used in a style() depending way.

void	setBrush (const QBrush &)
	Assign a brush, that is used in a style() depending way.

const QBrush &	brush () const
	Get the brush used in a style() depending way.

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

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

void	setBaseline (double)
	Set the value of the baseline.

double	baseline () const
	Get the value of the baseline.

void	setStyle (HistogramStyle style)
	Set the histogram's drawing style.

HistogramStyle	style () const
	Get the histogram's drawing style.

void	setSymbol (const QwtColumnSymbol *)
	Assign a symbol.

const QwtColumnSymbol *	symbol () const
	Get the current symbol.

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

virtual QRectF	boundingRect () const override
	Get the bounding rectangle of all samples.

virtual QwtGraphic	legendIcon (int index, const QSizeF &) const override
	A plain rectangle without pen using the brush()

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
	Get the orientation of the plot item.

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

virtual void	updateScaleDiv (const QwtScaleDiv &, const QwtScaleDiv &) override
	Update the scale divisions.

Public Member Functions inherited from QwtPlotItem
	QwtPlotItem ()
	Default constructor.

	QwtPlotItem (const QString &title)
	Constructor with title as QString.

	QwtPlotItem (const QwtText &title)
	Constructor with title as QwtText.

virtual	~QwtPlotItem ()
	Destructor.

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

void	detach ()
	Detach the item from the plot.

QwtPlot *	plot () const
	Get the plot the item is attached to.

void	setTitle (const QString &title)
	Set the title using a QString.

void	setTitle (const QwtText &title)
	Set the title using a QwtText.

const QwtText &	title () const
	Get the title.

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

bool	testItemAttribute (ItemAttribute) const
	Test an item attribute.

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

bool	testItemInterest (ItemInterest) const
	Test an item interest.

void	setRenderHint (RenderHint, bool on=true)
	Set a render hint.

bool	testRenderHint (RenderHint) const
	Test a render hint.

void	setRenderThreadCount (uint numThreads)
	Set the number of render threads.

uint	renderThreadCount () const
	Get the number of render threads.

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

QSize	legendIconSize () const
	Get the legend icon size.

double	z () const
	Get the z-value.

void	setZ (double z)
	Set the z-value.

void	show ()
	Show the item.

void	hide ()
	Hide the item.

virtual void	setVisible (bool)
	Set the visibility.

bool	isVisible () const
	Check if the item is visible.

void	setAxes (QwtAxisId xAxis, QwtAxisId yAxis)
	Set both axes.

void	setXAxis (QwtAxisId)
	Set the x-axis.

QwtAxisId	xAxis () const
	Get the x-axis.

void	setYAxis (QwtAxisId)
	Set the y-axis.

QwtAxisId	yAxis () const
	Get the y-axis.

virtual void	itemChanged ()
	Notify the plot that the item has changed.

virtual void	legendChanged ()
	Notify the item that the legend has changed.

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

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

QRectF	scaleRect (const QwtScaleMap &, const QwtScaleMap &) const
	Calculate the scale rectangle.

QRectF	paintRect (const QwtScaleMap &, const QwtScaleMap &) const
	Calculate the paint rectangle.

virtual QList< QwtLegendData >	legendData () const
	Return legend data.

Public Member Functions inherited from QwtSeriesStore< QwtIntervalSample >
void	setData (QwtSeriesData< QwtIntervalSample > *series)

QwtSeriesData< QwtIntervalSample > *	data ()

const QwtSeriesData< QwtIntervalSample > *	data () const

QwtIntervalSample	sample (size_t index) const

virtual size_t	dataSize () const override

virtual QRectF	dataRect () const override

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

QwtSeriesData< QwtIntervalSample > *	swapData (QwtSeriesData< QwtIntervalSample > *series)

Protected Member Functions
virtual QwtColumnRect	columnRect (const QwtIntervalSample &, const QwtScaleMap &, const QwtScaleMap &) const
	Get the column rectangle .

virtual void	drawColumn (QPainter *, const QwtColumnRect &, const QwtIntervalSample &) const
	Draw a column .

void	drawColumns (QPainter *, const QwtScaleMap &xMap, const QwtScaleMap &yMap, int from, int to) const
	Draw columns .

void	drawOutline (QPainter *, const QwtScaleMap &xMap, const QwtScaleMap &yMap, int from, int to) const
	Draw outline .

void	drawLines (QPainter *, const QwtScaleMap &xMap, const QwtScaleMap &yMap, int from, int to) const
	Draw lines .

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

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

Detailed Description

QwtPlotHistogram represents a series of samples, where an interval is associated with a value ( $y = f([x1,x2])$ )

Member Enumeration Documentation

◆ HistogramStyle

enum QwtPlotHistogram::HistogramStyle

Histogram styles.

Enumerator
Outline	Draw an outline around the area, that is build by all intervals using the pen() and fill it with the brush(). The outline style requires, that the intervals are in increasing order and not overlapping.
Columns	Draw a column for each interval. When a symbol() has been set the symbol is used otherwise the column is displayed as plain rectangle using pen() and brush().
Lines	Draw a simple line using the pen() for each interval.
UserStyle	Styles >= UserStyle are reserved for derived classes that overload drawSeries() with additional application specific ways to display a histogram.

Constructor & Destructor Documentation

◆ QwtPlotHistogram() [1/2]

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

explicit

Constructor with QString title.

◆ QwtPlotHistogram() [2/2]

QwtPlotHistogram::QwtPlotHistogram ( const QwtText & title )

explicit

Constructor with QwtText title.

◆ ~QwtPlotHistogram()

QwtPlotHistogram::~QwtPlotHistogram ( )

virtual

Destructor .

Member Function Documentation

◆ baseline()

double QwtPlotHistogram::baseline ( ) const

Get the value of the baseline.

◆ boundingRect()

QRectF QwtPlotHistogram::boundingRect ( ) const

overridevirtual

Get the bounding rectangle of all samples.

Reimplemented from QwtPlotSeriesItem.

◆ brush()

const QBrush & QwtPlotHistogram::brush ( ) const

Get the brush used in a style() depending way.

◆ columnRect()

QwtColumnRect QwtPlotHistogram::columnRect	(	const QwtIntervalSample &	sample,
		const QwtScaleMap &	xMap,
		const QwtScaleMap &	yMap
	)		const

protectedvirtual

Get the column rectangle .

Calculate the area that is covered by a sample.

Parameters

sample	Sample
xMap	Maps x-values into pixel coordinates.
yMap	Maps y-values into pixel coordinates.

Returns: Rectangle, that is covered by a sample

◆ drawColumn()

void QwtPlotHistogram::drawColumn	(	QPainter *	painter,
		const QwtColumnRect &	rect,
		const QwtIntervalSample &	sample
	)		const

protectedvirtual

Draw a column .

Draw a column for a sample in Columns style().

When a symbol() has been set the symbol is used otherwise the column is displayed as plain rectangle using pen() and brush().

Parameters

painter	Painter
rect	Rectangle where to paint the column in paint device coordinates
sample	Sample to be displayed

Note: In applications, where different intervals need to be displayed in a different way ( f.e different colors or even using different symbols) it is recommended to overload drawColumn().

◆ drawColumns()

void QwtPlotHistogram::drawColumns	(	QPainter *	painter,
		const QwtScaleMap &	xMap,
		const QwtScaleMap &	yMap,
		int	from,
		int	to
	)		const

protected

Draw columns .

Draw a histogram in Columns style()

Parameters

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

See also: setStyle(), style(), setSymbol(), drawColumn()

◆ drawLines()

void QwtPlotHistogram::drawLines	(	QPainter *	painter,
		const QwtScaleMap &	xMap,
		const QwtScaleMap &	yMap,
		int	from,
		int	to
	)		const

protected

Draw lines .

Draw a histogram in Lines style()

Parameters

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

See also: setStyle(), style(), setPen()

◆ drawOutline()

void QwtPlotHistogram::drawOutline	(	QPainter *	painter,
		const QwtScaleMap &	xMap,
		const QwtScaleMap &	yMap,
		int	from,
		int	to
	)		const

protected

Draw outline .

Draw a histogram in Outline style()

Parameters

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

See also: setStyle(), style()

Warning: The outline style requires, that the intervals are in increasing order and not overlapping.

◆ drawSeries()

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

overridevirtual

Draw a subset of the histogram samples.

Implements QwtPlotSeriesItem.

◆ legendIcon()

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

overridevirtual

A plain rectangle without pen using the brush()

Parameters

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

Returns: A graphic displaying the icon

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

Reimplemented from QwtPlotItem.

◆ pen()

const QPen & QwtPlotHistogram::pen ( ) const

Get the pen used in a style() depending way.

◆ rtti()

int QwtPlotHistogram::rtti ( ) const

overridevirtual

Get the runtime type information.

Reimplemented from QwtPlotItem.

◆ setBaseline()

void QwtPlotHistogram::setBaseline ( double value )

Set the value of the baseline.

◆ setBrush()

void QwtPlotHistogram::setBrush ( const QBrush & brush )

Assign a brush, that is used in a style() depending way.

◆ setPen() [1/2]

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

Build and assign a pen.

◆ setPen() [2/2]

void QwtPlotHistogram::setPen ( const QPen & pen )

Assign a pen, that is used in a style() depending way.

◆ setSamples() [1/2]

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

Initialize data with an array of samples.

◆ setSamples() [2/2]

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

Assign a series of samples.

◆ setStyle()

void QwtPlotHistogram::setStyle ( HistogramStyle style )

Set the histogram's drawing style.

◆ setSymbol()

void QwtPlotHistogram::setSymbol ( const QwtColumnSymbol * symbol )

Assign a symbol.

◆ style()

QwtPlotHistogram::HistogramStyle QwtPlotHistogram::style ( ) const

Get the histogram's drawing style.

◆ symbol()

const QwtColumnSymbol * QwtPlotHistogram::symbol ( ) const

Get the current symbol.

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

/home/runner/work/QWT/QWT/src/plot/qwt_plot_histogram.h
/home/runner/work/QWT/QWT/src/plot/qwt_plot_histogram.cpp

Classes

Public Types

Public Member Functions

Protected Member Functions

Detailed Description

Member Enumeration Documentation

◆ HistogramStyle

Constructor & Destructor Documentation

◆ QwtPlotHistogram() [1/2]

◆ QwtPlotHistogram() [2/2]

◆ ~QwtPlotHistogram()

Member Function Documentation

◆ baseline()

◆ boundingRect()

◆ brush()

◆ columnRect()

◆ drawColumn()

◆ drawColumns()

◆ drawLines()

◆ drawOutline()

◆ drawSeries()

◆ legendIcon()

◆ pen()

◆ rtti()

◆ setBaseline()

◆ setBrush()

◆ setPen() [1/2]

◆ setPen() [2/2]

◆ setSamples() [1/2]

◆ setSamples() [2/2]

◆ setStyle()

◆ setSymbol()

◆ style()

◆ symbol()