Factory class for creating and attaching QwtPlotItem instances to a QwtPlot. More...

#include <qwt_plot_factory.h>

Static Public Member Functions
static QwtPlotCurve *	createCurve (QwtPlot *plot, const QString &title, const QVector< QPointF > &data, QwtAxisId xAxis=QwtAxis::XBottom, QwtAxisId yAxis=QwtAxis::YLeft)
	Create a curve from QPointF data and attach it to a plot.

static QwtPlotCurve *	createCurve (QwtPlot *plot, const QString &title, const QVector< double > &x, const QVector< double > &y, QwtAxisId xAxis=QwtAxis::XBottom, QwtAxisId yAxis=QwtAxis::YLeft)
	Create a curve from separate x and y vectors and attach it to a plot.

static QwtPlotCurve *	createCurve (QwtPlot *plot, const QString &title, const QVector< double > &y, QwtAxisId xAxis=QwtAxis::XBottom, QwtAxisId yAxis=QwtAxis::YLeft)
	Create a curve from y-only data (x = index) and attach it to a plot.

static QwtPlotBarChart *	createBarChart (QwtPlot *plot, const QString &title, const QVector< double > &values, QwtAxisId xAxis=QwtAxis::XBottom, QwtAxisId yAxis=QwtAxis::YLeft)
	Create a bar chart from y-only values and attach it to a plot.

static QwtPlotBarChart *	createBarChart (QwtPlot *plot, const QString &title, const QVector< QPointF > &data, QwtAxisId xAxis=QwtAxis::XBottom, QwtAxisId yAxis=QwtAxis::YLeft)
	Create a bar chart from QPointF data and attach it to a plot.

static QwtPlotMultiBarChart *	createMultiBarChart (QwtPlot *plot, const QString &title, const QVector< QwtSetSample > &data, QwtAxisId xAxis=QwtAxis::XBottom, QwtAxisId yAxis=QwtAxis::YLeft)
	Create a multi bar chart from QwtSetSample data.

static QwtPlotMultiBarChart *	createMultiBarChart (QwtPlot *plot, const QString &title, const QVector< QVector< double > > &data, QwtAxisId xAxis=QwtAxis::XBottom, QwtAxisId yAxis=QwtAxis::YLeft)
	Create a multi bar chart from nested vectors.

static QwtPlotHistogram *	createHistogram (QwtPlot *plot, const QString &title, const QVector< QwtIntervalSample > &data, QwtAxisId xAxis=QwtAxis::XBottom, QwtAxisId yAxis=QwtAxis::YLeft)
	Create a histogram from interval samples.

static QwtPlotIntervalCurve *	createIntervalCurve (QwtPlot *plot, const QString &title, const QVector< QwtIntervalSample > &data, QwtAxisId xAxis=QwtAxis::XBottom, QwtAxisId yAxis=QwtAxis::YLeft)
	Create an interval curve.

static QwtPlotTradingCurve *	createTradingCurve (QwtPlot *plot, const QString &title, const QVector< QwtOHLCSample > &data, QwtAxisId xAxis=QwtAxis::XBottom, QwtAxisId yAxis=QwtAxis::YLeft)
	Create a trading curve (K-line / OHLC)

static QwtPlotSpectroCurve *	createSpectroCurve (QwtPlot *plot, const QString &title, const QVector< QwtPoint3D > &data, QwtAxisId xAxis=QwtAxis::XBottom, QwtAxisId yAxis=QwtAxis::YLeft)
	Create a spectro curve from 3D point data.

static QwtPlotVectorField *	createVectorField (QwtPlot *plot, const QString &title, const QVector< QwtVectorFieldSample > &data, QwtAxisId xAxis=QwtAxis::XBottom, QwtAxisId yAxis=QwtAxis::YLeft)
	Create a vector field from samples.

static QwtPlotBoxChart *	createBoxChart (QwtPlot *plot, const QString &title, const QVector< QwtBoxSample > &data, QwtAxisId xAxis=QwtAxis::XBottom, QwtAxisId yAxis=QwtAxis::YLeft)
	Create a box chart from box samples.

static QwtPlotGrid *	createGrid (QwtPlot *plot, bool enableMinor=false, const QPen &majorPen=QPen(Qt::gray, 0, Qt::DotLine), const QPen &minorPen=QPen(Qt::lightGray, 0, Qt::DotLine))
	Create and attach a grid to a plot.

static QwtPlotMarker *	createMarker (QwtPlot *plot, const QPointF &pos, const QString &label=QString(), QwtAxisId xAxis=QwtAxis::XBottom, QwtAxisId yAxis=QwtAxis::YLeft)
	Create a point marker with optional label.

static QwtPlotMarker *	createHLine (QwtPlot *plot, double y, const QPen &pen=QPen(Qt::gray, 0, Qt::DashLine))
	Create a horizontal line marker.

static QwtPlotMarker *	createVLine (QwtPlot *plot, double x, const QPen &pen=QPen(Qt::gray, 0, Qt::DashLine))
	Create a vertical line marker.

static QwtPlotZoneItem *	createZone (QwtPlot *plot, const QwtInterval &interval, Qt::Orientation orientation=Qt::Vertical, const QBrush &brush=QBrush(QColor(0, 0, 255, 30)))
	Create a highlighted zone.

static QwtPlotArrowMarker *	createArrowMarker (QwtPlot *plot, const QPointF &start, const QPointF &end, QwtAxisId xAxis=QwtAxis::XBottom, QwtAxisId yAxis=QwtAxis::YLeft)
	Create an arrow marker.

static QwtPlotGraphicItem *	createGraphic (QwtPlot *plot, const QRectF &rect, const QwtGraphic &graphic)
	Create a graphic item.

static QwtPlotTextLabel *	createTextLabel (QwtPlot *plot, const QString &text, Qt::Alignment alignment=Qt::AlignTop\|Qt::AlignHCenter)
	Create a text label on the canvas.

static QwtPlotLegendItem *	createLegend (QwtPlot *plot)
	Create an in-canvas legend item.

static QwtPlotScaleItem *	createScaleItem (QwtPlot *plot, QwtAxisId axis)
	Create a scale item at a specific axis.

Detailed Description

Factory class for creating and attaching QwtPlotItem instances to a QwtPlot.

QwtPlotFactory provides static methods to create various plot items with common default settings, set their data, and attach them to a plot in a single call. This simplifies the common pattern of: create item -> configure -> set data -> attach.

All factory methods return the newly created item, which is already attached to the plot. The caller owns the item and may further customize it.

QwtPlot* plot = new QwtPlot();
 
// Create a curve with data in one line
QVector<QPointF> data = {{0, 1}, {1, 3}, {2, 2}, {3, 5}};
QwtPlotCurve* curve = Qwt::QwtPlotFactory::createCurve(plot, "My Curve", data);
 
// Add a grid
Qwt::QwtPlotFactory::createGrid(plot);
 
// Add a horizontal marker line
Qwt::QwtPlotFactory::createHLine(plot, 2.5);

See also: QwtPlotDataAccess, QwtPlotStyling

Member Function Documentation

◆ createArrowMarker()

QwtPlotArrowMarker * QwtPlotFactory::createArrowMarker	(	QwtPlot *	plot,
		const QPointF &	start,
		const QPointF &	end,
		QwtAxisId	xAxis = `QwtAxis::XBottom`,
		QwtAxisId	yAxis = `QwtAxis::YLeft`
	)

static

Create an arrow marker.

Parameters

plot	Target plot
start	Arrow start point in data coordinates
end	Arrow end point in data coordinates
xAxis	X axis to bind to
yAxis	Y axis to bind to

Returns: The newly created and attached arrow marker

◆ createBarChart() [1/2]

QwtPlotBarChart * QwtPlotFactory::createBarChart	(	QwtPlot *	plot,
		const QString &	title,
		const QVector< double > &	values,
		QwtAxisId	xAxis = `QwtAxis::XBottom`,
		QwtAxisId	yAxis = `QwtAxis::YLeft`
	)

static

Create a bar chart from y-only values and attach it to a plot.

Parameters

plot	Target plot
title	Bar chart title
values	Y values (x is auto-generated as 0, 1, 2, ...)
xAxis	X axis to bind to
yAxis	Y axis to bind to

Returns: The newly created and attached bar chart

◆ createBarChart() [2/2]

QwtPlotBarChart * QwtPlotFactory::createBarChart	(	QwtPlot *	plot,
		const QString &	title,
		const QVector< QPointF > &	data,
		QwtAxisId	xAxis = `QwtAxis::XBottom`,
		QwtAxisId	yAxis = `QwtAxis::YLeft`
	)

static

Create a bar chart from QPointF data and attach it to a plot.

Parameters

plot	Target plot
title	Bar chart title
data	Sample data as QPointF vector
xAxis	X axis to bind to
yAxis	Y axis to bind to

Returns: The newly created and attached bar chart

◆ createBoxChart()

QwtPlotBoxChart * QwtPlotFactory::createBoxChart	(	QwtPlot *	plot,
		const QString &	title,
		const QVector< QwtBoxSample > &	data,
		QwtAxisId	xAxis = `QwtAxis::XBottom`,
		QwtAxisId	yAxis = `QwtAxis::YLeft`
	)

static

Create a box chart from box samples.

Parameters

plot	Target plot
title	Box chart title
data	Box sample data
xAxis	X axis to bind to
yAxis	Y axis to bind to

Returns: The newly created and attached box chart

◆ createCurve() [1/3]

QwtPlotCurve * QwtPlotFactory::createCurve	(	QwtPlot *	plot,
		const QString &	title,
		const QVector< double > &	x,
		const QVector< double > &	y,
		QwtAxisId	xAxis = `QwtAxis::XBottom`,
		QwtAxisId	yAxis = `QwtAxis::YLeft`
	)

static

Create a curve from separate x and y vectors and attach it to a plot.

Parameters

plot	Target plot
title	Curve title
x	X coordinate vector
y	Y coordinate vector
xAxis	X axis to bind to
yAxis	Y axis to bind to

Returns: The newly created and attached curve

◆ createCurve() [2/3]

QwtPlotCurve * QwtPlotFactory::createCurve	(	QwtPlot *	plot,
		const QString &	title,
		const QVector< double > &	y,
		QwtAxisId	xAxis = `QwtAxis::XBottom`,
		QwtAxisId	yAxis = `QwtAxis::YLeft`
	)

static

Create a curve from y-only data (x = index) and attach it to a plot.

Parameters

plot	Target plot
title	Curve title
y	Y coordinate vector (x is auto-generated as 0, 1, 2, ...)
xAxis	X axis to bind to
yAxis	Y axis to bind to

Returns: The newly created and attached curve

◆ createCurve() [3/3]

QwtPlotCurve * QwtPlotFactory::createCurve	(	QwtPlot *	plot,
		const QString &	title,
		const QVector< QPointF > &	data,
		QwtAxisId	xAxis = `QwtAxis::XBottom`,
		QwtAxisId	yAxis = `QwtAxis::YLeft`
	)

static

Create a curve from QPointF data and attach it to a plot.

Parameters

plot	Target plot
title	Curve title
data	Sample data as QPointF vector
xAxis	X axis to bind to
yAxis	Y axis to bind to

Returns: The newly created and attached curve

◆ createGraphic()

QwtPlotGraphicItem * QwtPlotFactory::createGraphic	(	QwtPlot *	plot,
		const QRectF &	rect,
		const QwtGraphic &	graphic
	)

static

Create a graphic item.

Parameters

plot	Target plot
rect	Bounding rectangle in data coordinates
graphic	The graphic to display

Returns: The newly created and attached graphic item

◆ createGrid()

QwtPlotGrid * QwtPlotFactory::createGrid	(	QwtPlot *	plot,
		bool	enableMinor = `false`,
		const QPen &	majorPen = `QPen(Qt::gray, 0, Qt::DotLine)`,
		const QPen &	minorPen = `QPen(Qt::lightGray, 0, Qt::DotLine)`
	)

static

Create and attach a grid to a plot.

Parameters

plot	Target plot
enableMinor	Whether to enable minor grid lines
majorPen	Pen for major grid lines
minorPen	Pen for minor grid lines

Returns: The newly created and attached grid

◆ createHistogram()

QwtPlotHistogram * QwtPlotFactory::createHistogram	(	QwtPlot *	plot,
		const QString &	title,
		const QVector< QwtIntervalSample > &	data,
		QwtAxisId	xAxis = `QwtAxis::XBottom`,
		QwtAxisId	yAxis = `QwtAxis::YLeft`
	)

static

Create a histogram from interval samples.

Parameters

plot	Target plot
title	Histogram title
data	Interval sample data
xAxis	X axis to bind to
yAxis	Y axis to bind to

Returns: The newly created and attached histogram

◆ createHLine()

QwtPlotMarker * QwtPlotFactory::createHLine	(	QwtPlot *	plot,
		double	y,
		const QPen &	pen = `QPen(Qt::gray, 0, Qt::DashLine)`
	)

static

Create a horizontal line marker.

Parameters

plot	Target plot
y	Y position of the line
pen	Line pen

Returns: The newly created and attached horizontal line marker

◆ createIntervalCurve()

QwtPlotIntervalCurve * QwtPlotFactory::createIntervalCurve	(	QwtPlot *	plot,
		const QString &	title,
		const QVector< QwtIntervalSample > &	data,
		QwtAxisId	xAxis = `QwtAxis::XBottom`,
		QwtAxisId	yAxis = `QwtAxis::YLeft`
	)

static

Create an interval curve.

Parameters

plot	Target plot
title	Interval curve title
data	Interval sample data
xAxis	X axis to bind to
yAxis	Y axis to bind to

Returns: The newly created and attached interval curve

◆ createLegend()

QwtPlotLegendItem * QwtPlotFactory::createLegend ( QwtPlot * plot )

static

Create an in-canvas legend item.

Parameters

plot	Target plot

Returns: The newly created and attached legend item

◆ createMarker()

QwtPlotMarker * QwtPlotFactory::createMarker	(	QwtPlot *	plot,
		const QPointF &	pos,
		const QString &	label = `QString()`,
		QwtAxisId	xAxis = `QwtAxis::XBottom`,
		QwtAxisId	yAxis = `QwtAxis::YLeft`
	)

static

Create a point marker with optional label.

Parameters

plot	Target plot
pos	Marker position in data coordinates
label	Optional text label
xAxis	X axis to bind to
yAxis	Y axis to bind to

Returns: The newly created and attached marker

◆ createMultiBarChart() [1/2]

QwtPlotMultiBarChart * QwtPlotFactory::createMultiBarChart	(	QwtPlot *	plot,
		const QString &	title,
		const QVector< QVector< double > > &	data,
		QwtAxisId	xAxis = `QwtAxis::XBottom`,
		QwtAxisId	yAxis = `QwtAxis::YLeft`
	)

static

Create a multi bar chart from nested vectors.

Parameters

plot	Target plot
title	Multi bar chart title
data	Nested vector where each inner vector is one bar group
xAxis	X axis to bind to
yAxis	Y axis to bind to

Returns: The newly created and attached multi bar chart

◆ createMultiBarChart() [2/2]

QwtPlotMultiBarChart * QwtPlotFactory::createMultiBarChart	(	QwtPlot *	plot,
		const QString &	title,
		const QVector< QwtSetSample > &	data,
		QwtAxisId	xAxis = `QwtAxis::XBottom`,
		QwtAxisId	yAxis = `QwtAxis::YLeft`
	)

static

Create a multi bar chart from QwtSetSample data.

Parameters

plot	Target plot
title	Multi bar chart title
data	Set sample data
xAxis	X axis to bind to
yAxis	Y axis to bind to

Returns: The newly created and attached multi bar chart

◆ createScaleItem()

QwtPlotScaleItem * QwtPlotFactory::createScaleItem	(	QwtPlot *	plot,
		QwtAxisId	axis
	)

static

Create a scale item at a specific axis.

Parameters

plot	Target plot
axis	Axis to display the scale on

Returns: The newly created and attached scale item

◆ createSpectroCurve()

QwtPlotSpectroCurve * QwtPlotFactory::createSpectroCurve	(	QwtPlot *	plot,
		const QString &	title,
		const QVector< QwtPoint3D > &	data,
		QwtAxisId	xAxis = `QwtAxis::XBottom`,
		QwtAxisId	yAxis = `QwtAxis::YLeft`
	)

static

Create a spectro curve from 3D point data.

Parameters

plot	Target plot
title	Spectro curve title
data	3D point data (x, y, z where z is typically mapped to color)
xAxis	X axis to bind to
yAxis	Y axis to bind to

Returns: The newly created and attached spectro curve

◆ createTextLabel()

QwtPlotTextLabel * QwtPlotFactory::createTextLabel	(	QwtPlot *	plot,
		const QString &	text,
		Qt::Alignment	alignment = `Qt::AlignTop \| Qt::AlignHCenter`
	)

static

Create a text label on the canvas.

Parameters

plot	Target plot
text	Label text
alignment	Alignment within the canvas (applied via QwtText render flags)

Returns: The newly created and attached text label

◆ createTradingCurve()

QwtPlotTradingCurve * QwtPlotFactory::createTradingCurve	(	QwtPlot *	plot,
		const QString &	title,
		const QVector< QwtOHLCSample > &	data,
		QwtAxisId	xAxis = `QwtAxis::XBottom`,
		QwtAxisId	yAxis = `QwtAxis::YLeft`
	)

static

Create a trading curve (K-line / OHLC)

Parameters

plot	Target plot
title	Trading curve title
data	OHLC sample data
xAxis	X axis to bind to
yAxis	Y axis to bind to

Returns: The newly created and attached trading curve

◆ createVectorField()

QwtPlotVectorField * QwtPlotFactory::createVectorField	(	QwtPlot *	plot,
		const QString &	title,
		const QVector< QwtVectorFieldSample > &	data,
		QwtAxisId	xAxis = `QwtAxis::XBottom`,
		QwtAxisId	yAxis = `QwtAxis::YLeft`
	)

static

Create a vector field from samples.

Parameters

plot	Target plot
title	Vector field title
data	Vector field sample data (position + vector)
xAxis	X axis to bind to
yAxis	Y axis to bind to

Returns: The newly created and attached vector field

◆ createVLine()

QwtPlotMarker * QwtPlotFactory::createVLine	(	QwtPlot *	plot,
		double	x,
		const QPen &	pen = `QPen(Qt::gray, 0, Qt::DashLine)`
	)

static

Create a vertical line marker.

Parameters

plot	Target plot
x	X position of the line
pen	Line pen

Returns: The newly created and attached vertical line marker

◆ createZone()

QwtPlotZoneItem * QwtPlotFactory::createZone	(	QwtPlot *	plot,
		const QwtInterval &	interval,
		Qt::Orientation	orientation = `Qt::Vertical`,
		const QBrush &	brush = `QBrush(QColor(0, 0, 255, 30))`
	)

static

Create a highlighted zone.

Parameters

plot	Target plot
interval	The interval range to highlight
orientation	Vertical or horizontal zone
brush	Fill brush for the zone

Returns: The newly created and attached zone item

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

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

Static Public Member Functions

Detailed Description

Member Function Documentation

◆ createArrowMarker()

◆ createBarChart() [1/2]

◆ createBarChart() [2/2]

◆ createBoxChart()

◆ createCurve() [1/3]

◆ createCurve() [2/3]

◆ createCurve() [3/3]

◆ createGraphic()

◆ createGrid()

◆ createHistogram()

◆ createHLine()

◆ createIntervalCurve()

◆ createLegend()

◆ createMarker()

◆ createMultiBarChart() [1/2]

◆ createMultiBarChart() [2/2]

◆ createScaleItem()

◆ createSpectroCurve()

◆ createTextLabel()

◆ createTradingCurve()

◆ createVectorField()

◆ createVLine()

◆ createZone()