QwtPlotIntervalCurve(3)

📦
version 6.3.0 · 4 versions
, in alpine 3.24

💅 QwtPlotIntervalCurve(3) 💅

okay so bestie, this is from the Library Functions Manual, and it's literally the manual page for QwtPlotIntervalCurve — a C++ class that represents a series of samples where every value has an interval attached. no cap, it's giving interval-plot main character energy. 💖

🌸 NAME 🌸

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

🎀 SYNOPSIS 🎀

#include <qwt_plot_intervalcurve.h>

Inherits QwtPlotSeriesItem, and QwtSeriesStore< QwtIntervalSample >.

💖 Public Types 💖

here's the type menu, bestie:

  • enum CurveStyle { NoCurve, Tube, UserCurve = 100 } — curve styles. The default setting is QwtPlotIntervalCurve::Tube. slay.
  • enum PaintAttribute { ClipPolygons = 0x01, ClipSymbol = 0x02, TubeAsLines = 0x10 } — paint attributes, and yes we're getting into them later. 🫶
  • typedef QFlags< PaintAttribute > PaintAttributes — the flags combo type.

🦋 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. iconic.
  • enum ItemAttribute { Legend = 0x01, AutoScale = 0x02, Margins = 0x04 } — plot item attributes.
  • enum ItemInterest { ScaleInterest = 0x01, LegendInterest = 0x02 } — plot item interests.
  • enum RenderHint { RenderAntialiased = 0x1 } — render hints.
  • typedef QFlags< ItemAttribute > ItemAttributes — the item attribute flags type.
  • typedef QFlags< ItemInterest > ItemInterests — the item interest flags type.
  • typedef QFlags< RenderHint > RenderHints — the render hint flags type.

💅 Public Member Functions 💅

  • QwtPlotIntervalCurve (const QString &title=QString()) — constructor vibe.
  • QwtPlotIntervalCurve (const QwtText &title) — constructor with a QwtText title.
  • virtual ~QwtPlotIntervalCurve () — Destructor. bye bestie, cleanup era.
  • virtual int rtti () const override — runtime type info override.
  • void setPaintAttribute (PaintAttribute, bool on=true) — set a paint attribute.
  • bool testPaintAttribute (PaintAttribute) const — check a paint attribute.
  • void setSamples (const QVector< QwtIntervalSample > &) — set samples from a vector.
  • void setSamples (QwtSeriesData< QwtIntervalSample > *) — set samples from series data.
  • void setPen (const QColor &, qreal width=0.0, Qt::PenStyle=Qt::SolidLine) — set the pen from a color, width, and style.
  • void setPen (const QPen &) — Assign a pen. 💖
  • const QPen & pen () const — get the pen.
  • void setBrush (const QBrush &) — set the brush.
  • const QBrush & brush () const — get the brush.
  • void setStyle (CurveStyle style) — set the curve style.
  • CurveStyle style () const — get the curve style.
  • void setSymbol (const QwtIntervalSymbol *) — set the interval symbol.
  • const QwtIntervalSymbol * symbol () const — get the interval symbol.
  • virtual void drawSeries (QPainter *, const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect, int from, int to) const override — override, bestie.
  • virtual QRectF boundingRect () const override — bounding rect override.
  • virtual QwtGraphic legendIcon (int index, const QSizeF &) const override — legend icon override.

🌈 Public Member Functions inherited from QwtPlotSeriesItem 🌈

  • QwtPlotSeriesItem (const QString &title=QString()) — constructor with a QString title.
  • QwtPlotSeriesItem (const QwtText &title) — constructor with a QwtText title.
  • virtual ~QwtPlotSeriesItem () — Destructor. cleanup, but make it cute.
  • void setOrientation (Qt::Orientation) — set orientation.
  • Qt::Orientation orientation () const — get orientation.
  • 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 item to changes of the axes scale division.

👑 Public Member Functions inherited from QwtPlotItem 👑

  • QwtPlotItem () — default constructor.
  • QwtPlotItem (const QString &title) — constructor with a QString title.
  • QwtPlotItem (const QwtText &title) — constructor with a QwtText title.
  • 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 the title from a QString.
  • void setTitle (const QwtText &title) — set the title from a QwtText.
  • const QwtText & title () const — get the title.
  • void setItemAttribute (ItemAttribute, bool on=true) — set an item attribute.
  • bool testItemAttribute (ItemAttribute) const — check an item attribute.
  • void setItemInterest (ItemInterest, bool on=true) — set an item interest.
  • bool testItemInterest (ItemInterest) const — check an item interest.
  • void setRenderHint (RenderHint, bool on=true) — set a render hint.
  • bool testRenderHint (RenderHint) const — check a render hint.
  • void setRenderThreadCount (uint numThreads) — set the render thread count.
  • uint renderThreadCount () const — get the render thread count.
  • 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 visibility.
  • bool isVisible () const — check visibility.
  • void setAxes (QwtAxisId xAxis, QwtAxisId yAxis) — set both axes.
  • 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 () — item changed signal-ish thing.
  • virtual void legendChanged () — legend changed signal-ish thing.
  • 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. cleanup moment.

🍓 Public Member Functions inherited from QwtSeriesStore< QwtIntervalSample > 🍓

  • QwtSeriesStore () — Constructor. The store contains no series.
  • ~QwtSeriesStore () — Destructor.
  • void setData (QwtSeriesData< QwtIntervalSample > *series) — set the data pointer.
  • QwtSeriesData< QwtIntervalSample > * data () — get the data pointer.
  • QwtIntervalSample sample (int index) const — get a sample by index.
  • virtual size_t dataSize () const override — data size override.
  • virtual QRectF dataRect () const override — data rect override.
  • virtual void setRectOfInterest (const QRectF &rect) override — set the rect of interest.
  • QwtSeriesData< QwtIntervalSample > * swapData (QwtSeriesData< QwtIntervalSample > *series) — swap the data pointer.

🔥 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 the tube.
  • virtual void drawSymbols (QPainter *, const QwtIntervalSymbol &, const QwtScaleMap &xMap, const QwtScaleMap &yMap, const QRectF &canvasRect, int from, int to) const — draw the symbols.

🫶 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 — 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)$. yes, we're back on the interval agenda.

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. it's giving versatile icon behavior. 💖

Definition at line 27 of file qwt_plot_intervalcurve.h.

🎀 Member Typedef Documentation 🎀

typedef QFlags<PaintAttribute > QwtPlotIntervalCurve::PaintAttributes

An ORed combination of PaintAttribute values. very flags, very combo, no cap. ✨

Definition at line 98 of file qwt_plot_intervalcurve.h.

🌈 Member Enumeration Documentation 🌈

enum QwtPlotIntervalCurve::CurveStyle

Curve styles. The default setting is QwtPlotIntervalCurve::Tube. slay.

See also setStyle(), style().

Enumerator

  • NoCurve — Don't draw a curve. Note: This doesn't affect the symbols. important distinction, bestie.
  • 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(). iconic tube behavior.
  • UserCurve — Styles >= QwtPlotIntervalCurve::UserCurve are reserved for derived classes that overload drawSeries() with additional application specific curve types.

Definition at line 38 of file qwt_plot_intervalcurve.h.

enum QwtPlotIntervalCurve::PaintAttribute

Attributes to modify the drawing algorithm. yes ma'am, paint-era controls.

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.
  • TubeAsLines — Fill the tube with horizontal or vertical lines and unite overlapping border lines. This attribute is useful for large data sets, where consecutive samples are often mapped to the same coordinate.

Beside other minor visual differences the filling is always monochrome - using brush().color(). 💅

This algorithm is very fast and effective and can be used inside a replot cycle. In the worst case the number of lines to be rendered will be 5 times the ( width/height - depending on the orientation() ) of the plot canvas.

Note: Has only an effect, when drawing to a paint device in integer coordinates ( f.e. all widgets on screen ).

See also QwtPlotCurve::FilterPointsAggressive.

Definition at line 64 of file qwt_plot_intervalcurve.h.

💖 Constructor & Destructor Documentation 💖

QwtPlotIntervalCurve::QwtPlotIntervalCurve (const QString & title = QString()) [explicit]

Constructor. we love a beginning.

Parameters

  • title — Title of the curve.

Definition at line 524 of file qwt_plot_intervalcurve.cpp.

QwtPlotIntervalCurve::QwtPlotIntervalCurve (const QwtText & title) [explicit]

Constructor. another one, and it's giving QwtText title realness.

Parameters

  • title — Title of the curve.

Definition at line 514 of file qwt_plot_intervalcurve.cpp.

QwtPlotIntervalCurve::~QwtPlotIntervalCurve () [virtual]

Destructor. cleanup era, bestie. 🫶

Definition at line 531 of file qwt_plot_intervalcurve.cpp.

💖 MEMBER FUNCTION DOCUMENTATION 💖

okay bestie, this is the function-by-function tea ☕ — every signature, return, parameter, warning, and source-line receipt is staying exactly as it is. No cap. 🫶

🦋 QRectF QwtPlotIntervalCurve::boundingRect () const [override], [virtual]

Returns: the bounding rectangle of all samples. For an empty series, the rectangle is invalid. 😭

Reimplemented from QwtPlotSeriesItem.

  • Definition at line 734 of file qwt_plot_intervalcurve.cpp.

🎀 const QBrush & QwtPlotIntervalCurve::brush () const

Returns: the brush used to fill the area in Tube style(). 💅

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

  • Definition at line 725 of file qwt_plot_intervalcurve.cpp.

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

What it does: draws a subset of the samples. ✨

  • 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.

  • Definition at line 756 of file qwt_plot_intervalcurve.cpp.

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

What it does: draws symbols for a subset of the samples. 🫶

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

  • Definition at line 829 of file qwt_plot_intervalcurve.cpp.

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

What it does: draws 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().

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

  • Definition at line 797 of file qwt_plot_intervalcurve.cpp.

🍓 void QwtPlotIntervalCurve::init () [protected]

What it does: initializes the internal members. ✨

  • Definition at line 537 of file qwt_plot_intervalcurve.cpp.

👑 QwtGraphic QwtPlotIntervalCurve::legendIcon (int index, const QSizeF & size) const [override], [virtual]

Returns: the 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.

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

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

Reimplemented from QwtPlotItem.

  • Definition at line 896 of file qwt_plot_intervalcurve.cpp.

💅 const QPen & QwtPlotIntervalCurve::pen () const

Returns: the pen used to draw the lines. 🖊️

See also: setPen(), brush().

  • Definition at line 697 of file qwt_plot_intervalcurve.cpp.

🌈 int QwtPlotIntervalCurve::rtti () const [override], [virtual]

Returns: QwtPlotItem::Rtti_PlotIntervalCurve. ⭐

Reimplemented from QwtPlotItem.

  • Definition at line 549 of file qwt_plot_intervalcurve.cpp.

🦋 void QwtPlotIntervalCurve::setBrush (const QBrush & brush)

What it does: assigns a brush. That brush is used to fill the area in Tube style(). 💖

  • brush — Brush.

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

  • Definition at line 710 of file qwt_plot_intervalcurve.cpp.

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

What it does: specifies an attribute for how to draw the curve. 🎨

  • attribute — Paint attribute.
  • on — On/Off.

See also: testPaintAttribute().

  • Definition at line 561 of file qwt_plot_intervalcurve.cpp.

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

What it does: builds and assigns a pen. 🖋️

Heads up: 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.

  • color — Pen color.
  • width — Pen width.
  • style — Pen style.

See also: pen(), brush().

  • Definition at line 672 of file qwt_plot_intervalcurve.cpp.

🌸 void QwtPlotIntervalCurve::setPen (const QPen & pen)

What it does: assigns a pen. 🖊️

  • pen — New pen.

See also: pen(), brush().

  • Definition at line 682 of file qwt_plot_intervalcurve.cpp.

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

What it does: initializes the data with an array of samples. 🧺

  • samples — Vector of samples.
  • Definition at line 584 of file qwt_plot_intervalcurve.cpp.

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

What it does: assigns a series of samples. 🦋

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

  • data — Data.
Warning: The item takes ownership of the data object, deleting it when its not used anymore. 💀
  • Definition at line 600 of file qwt_plot_intervalcurve.cpp.

🌈 void QwtPlotIntervalCurve::setStyle (CurveStyle style)

What it does: sets the curve's drawing style. 🎨

  • style — Curve style.

See also: CurveStyle, style().

  • Definition at line 612 of file qwt_plot_intervalcurve.cpp.

⭐ void QwtPlotIntervalCurve::setSymbol (const QwtIntervalSymbol * symbol)

What it does: assigns a symbol. 💫

  • symbol — Symbol.

See also: symbol().

  • Definition at line 638 of file qwt_plot_intervalcurve.cpp.

🧚 QwtPlotIntervalCurve::CurveStyle QwtPlotIntervalCurve::style () const

Returns: the style of the curve. 🎀

See also: setStyle().

  • Definition at line 627 of file qwt_plot_intervalcurve.cpp.

🦋 const QwtIntervalSymbol * QwtPlotIntervalCurve::symbol () const

Returns: the current symbol or NULL, when no symbol has been assigned. 😭

See also: setSymbol().

  • Definition at line 654 of file qwt_plot_intervalcurve.cpp.

💖 bool QwtPlotIntervalCurve::testPaintAttribute (PaintAttribute attribute) const

Returns: True, when attribute is enabled. ✅

See also: PaintAttribute, setPaintAttribute().

  • Definition at line 574 of file qwt_plot_intervalcurve.cpp.

👑 AUTHOR 👑

Generated automatically by Doxygen for Qwt User's Guide from the source code.

💖 That’s the whole manual, bestie: source/version is Qwt User's Guide, the page is QwtPlotIntervalCurve(3), and the date is whatever Doxygen stamped on it. Bye! 💅✨

📦 where this page comes from