A plottable representing a parametric curve in a plot. More...
#include <qcustomplot.h>
Public Types | |
enum | LineStyle { lsNone, lsLine } |
Public Member Functions | |
void | addData (const QVector< double > &t, const QVector< double > &keys, const QVector< double > &values, bool alreadySorted=false) |
void | addData (const QVector< double > &keys, const QVector< double > &values) |
void | addData (double t, double key, double value) |
void | addData (double key, double value) |
QSharedPointer< QCPCurveDataContainer > | data () const |
virtual QCPRange | getKeyRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE |
virtual QCPRange | getValueRange (bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE |
LineStyle | lineStyle () const |
QCPCurve (QCPAxis *keyAxis, QCPAxis *valueAxis) | |
int | scatterSkip () const |
QCPScatterStyle | scatterStyle () const |
virtual double | selectTest (const QPointF &pos, bool onlySelectable, QVariant *details=0) const Q_DECL_OVERRIDE |
void | setData (QSharedPointer< QCPCurveDataContainer > data) |
void | setData (const QVector< double > &t, const QVector< double > &keys, const QVector< double > &values, bool alreadySorted=false) |
void | setData (const QVector< double > &keys, const QVector< double > &values) |
void | setLineStyle (LineStyle style) |
void | setScatterSkip (int skip) |
void | setScatterStyle (const QCPScatterStyle &style) |
virtual | ~QCPCurve () |
![]() | |
virtual int | dataCount () const Q_DECL_OVERRIDE |
virtual double | dataMainKey (int index) const Q_DECL_OVERRIDE |
virtual double | dataMainValue (int index) const Q_DECL_OVERRIDE |
virtual QPointF | dataPixelPosition (int index) const Q_DECL_OVERRIDE |
virtual double | dataSortKey (int index) const Q_DECL_OVERRIDE |
virtual QCPRange | dataValueRange (int index) const Q_DECL_OVERRIDE |
virtual int | findBegin (double sortKey, bool expandedRange=true) const Q_DECL_OVERRIDE |
virtual int | findEnd (double sortKey, bool expandedRange=true) const Q_DECL_OVERRIDE |
virtual QCPPlottableInterface1D * | interface1D () Q_DECL_OVERRIDE |
QCPAbstractPlottable1D (QCPAxis *keyAxis, QCPAxis *valueAxis) | |
virtual QCPDataSelection | selectTestRect (const QRectF &rect, bool onlySelectable) const Q_DECL_OVERRIDE |
virtual bool | sortKeyIsMainKey () const Q_DECL_OVERRIDE |
virtual | ~QCPAbstractPlottable1D () |
![]() | |
bool | addToLegend (QCPLegend *legend) |
bool | addToLegend () |
bool | antialiasedFill () const |
bool | antialiasedScatters () const |
QBrush | brush () const |
void | coordsToPixels (double key, double value, double &x, double &y) const |
const QPointF | coordsToPixels (double key, double value) const |
QCPAxis * | keyAxis () const |
QString | name () const |
QPen | pen () const |
void | pixelsToCoords (double x, double y, double &key, double &value) const |
void | pixelsToCoords (const QPointF &pixelPos, double &key, double &value) const |
QCPAbstractPlottable (QCPAxis *keyAxis, QCPAxis *valueAxis) | |
bool | removeFromLegend (QCPLegend *legend) const |
bool | removeFromLegend () const |
void | rescaleAxes (bool onlyEnlarge=false) const |
void | rescaleKeyAxis (bool onlyEnlarge=false) const |
void | rescaleValueAxis (bool onlyEnlarge=false, bool inKeyRange=false) const |
QCP::SelectionType | selectable () const |
bool | selected () const |
QCPDataSelection | selection () const |
QCPSelectionDecorator * | selectionDecorator () const |
void | setAntialiasedFill (bool enabled) |
void | setAntialiasedScatters (bool enabled) |
void | setBrush (const QBrush &brush) |
void | setKeyAxis (QCPAxis *axis) |
void | setName (const QString &name) |
void | setPen (const QPen &pen) |
Q_SLOT void | setSelectable (QCP::SelectionType selectable) |
Q_SLOT void | setSelection (QCPDataSelection selection) |
void | setSelectionDecorator (QCPSelectionDecorator *decorator) |
void | setValueAxis (QCPAxis *axis) |
QCPAxis * | valueAxis () const |
virtual | ~QCPAbstractPlottable () |
![]() | |
bool | antialiased () const |
QCPLayer * | layer () const |
QCPLayerable * | parentLayerable () const |
QCustomPlot * | parentPlot () const |
QCPLayerable (QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=0) | |
bool | realVisibility () const |
void | setAntialiased (bool enabled) |
Q_SLOT bool | setLayer (QCPLayer *layer) |
bool | setLayer (const QString &layerName) |
void | setVisible (bool on) |
bool | visible () const |
virtual | ~QCPLayerable () |
![]() | |
virtual | ~QCPPlottableInterface1D () |
Protected Member Functions | |
virtual void | draw (QCPPainter *painter) Q_DECL_OVERRIDE |
virtual void | drawCurveLine (QCPPainter *painter, const QVector< QPointF > &lines) const |
virtual void | drawLegendIcon (QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE |
virtual void | drawScatterPlot (QCPPainter *painter, const QVector< QPointF > &points, const QCPScatterStyle &style) const |
void | getCurveLines (QVector< QPointF > *lines, const QCPDataRange &dataRange, double penWidth) const |
QVector< QPointF > | getOptimizedCornerPoints (int prevRegion, int currentRegion, double prevKey, double prevValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const |
QPointF | getOptimizedPoint (int prevRegion, double prevKey, double prevValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const |
int | getRegion (double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const |
void | getScatters (QVector< QPointF > *scatters, const QCPDataRange &dataRange, double scatterWidth) const |
bool | getTraverse (double prevKey, double prevValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin, QPointF &crossA, QPointF &crossB) const |
void | getTraverseCornerPoints (int prevRegion, int currentRegion, double keyMin, double valueMax, double keyMax, double valueMin, QVector< QPointF > &beforeTraverse, QVector< QPointF > &afterTraverse) const |
bool | mayTraverse (int prevRegion, int currentRegion) const |
double | pointDistance (const QPointF &pixelPoint, QCPCurveDataContainer::const_iterator &closestData) const |
![]() | |
void | drawPolyline (QCPPainter *painter, const QVector< QPointF > &lineData) const |
void | getDataSegments (QList< QCPDataRange > &selectedSegments, QList< QCPDataRange > &unselectedSegments) const |
![]() | |
void | applyDefaultAntialiasingHint (QCPPainter *painter) const Q_DECL_OVERRIDE |
void | applyFillAntialiasingHint (QCPPainter *painter) const |
void | applyScattersAntialiasingHint (QCPPainter *painter) const |
virtual QRect | clipRect () const Q_DECL_OVERRIDE |
virtual void | deselectEvent (bool *selectionStateChanged) Q_DECL_OVERRIDE |
virtual void | selectEvent (QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE |
virtual QCP::Interaction | selectionCategory () const Q_DECL_OVERRIDE |
![]() | |
void | applyAntialiasingHint (QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const |
void | initializeParentPlot (QCustomPlot *parentPlot) |
virtual void | mouseDoubleClickEvent (QMouseEvent *event, const QVariant &details) |
virtual void | mouseMoveEvent (QMouseEvent *event, const QPointF &startPos) |
virtual void | mousePressEvent (QMouseEvent *event, const QVariant &details) |
virtual void | mouseReleaseEvent (QMouseEvent *event, const QPointF &startPos) |
bool | moveToLayer (QCPLayer *layer, bool prepend) |
virtual void | parentPlotInitialized (QCustomPlot *parentPlot) |
void | setParentLayerable (QCPLayerable *parentLayerable) |
virtual void | wheelEvent (QWheelEvent *event) |
Protected Attributes | |
LineStyle | mLineStyle |
int | mScatterSkip |
QCPScatterStyle | mScatterStyle |
![]() | |
QSharedPointer< QCPDataContainer< QCPCurveData > > | mDataContainer |
![]() | |
bool | mAntialiasedFill |
bool | mAntialiasedScatters |
QBrush | mBrush |
QPointer< QCPAxis > | mKeyAxis |
QString | mName |
QPen | mPen |
QCP::SelectionType | mSelectable |
QCPDataSelection | mSelection |
QCPSelectionDecorator * | mSelectionDecorator |
QPointer< QCPAxis > | mValueAxis |
![]() | |
bool | mAntialiased |
QCPLayer * | mLayer |
QPointer< QCPLayerable > | mParentLayerable |
QCustomPlot * | mParentPlot |
bool | mVisible |
Friends | |
class | QCPLegend |
class | QCustomPlot |
Additional Inherited Members | |
![]() | |
void | selectableChanged (QCP::SelectionType selectable) |
void | selectionChanged (bool selected) |
void | selectionChanged (const QCPDataSelection &selection) |
![]() | |
void | layerChanged (QCPLayer *newLayer) |
A plottable representing a parametric curve in a plot.
Unlike QCPGraph, plottables of this type may have multiple points with the same key coordinate, so their visual representation can have loops. This is realized by introducing a third coordinate t, which defines the order of the points described by the other two coordinates x and y.
To plot data, assign it with the setData or addData functions. Alternatively, you can also access and modify the curve's data via the data method, which returns a pointer to the internal QCPCurveDataContainer.
Gaps in the curve can be created by adding data points with NaN as key and value (qQNaN()
or std::numeric_limits<double>::quiet_NaN()
) in between the two data points that shall be separated.
The appearance of the curve is determined by the pen and the brush (setPen, setBrush).
Like all data representing objects in QCustomPlot, the QCPCurve is a plottable (QCPAbstractPlottable). So the plottable-interface of QCustomPlot applies (QCustomPlot::plottable, QCustomPlot::removePlottable, etc.)
Usually, you first create an instance:
which registers it with the QCustomPlot instance of the passed axes. Note that this QCustomPlot instance takes ownership of the plottable, so do not delete it manually but use QCustomPlot::removePlottable() instead. The newly created plottable can be modified, e.g.:
Definition at line 5303 of file qcustomplot.h.
enum QCPCurve::LineStyle |
Defines how the curve's line is represented visually in the plot. The line is drawn with the current pen of the curve (setPen).
Enumerator | |
---|---|
lsNone | No line is drawn between data points (e.g. only scatters) |
lsLine | Data points are connected with a straight line. |
Definition at line 5317 of file qcustomplot.h.
Constructs a curve which uses keyAxis as its key axis ("x") and valueAxis as its value axis ("y"). keyAxis and valueAxis must reside in the same QCustomPlot instance and not have the same orientation. If either of these restrictions is violated, a corresponding message is printed to the debug output (qDebug), the construction is not aborted, though.
The created QCPCurve is automatically registered with the QCustomPlot instance inferred from keyAxis. This QCustomPlot instance takes ownership of the QCPCurve, so do not delete it manually but use QCustomPlot::removePlottable() instead.
Definition at line 21863 of file qcustomplot.cpp.
|
virtual |
Definition at line 21875 of file qcustomplot.cpp.
void QCPCurve::addData | ( | const QVector< double > & | t, |
const QVector< double > & | keys, | ||
const QVector< double > & | values, | ||
bool | alreadySorted = false |
||
) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Adds the provided points in t, keys and values to the current data. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector.
If you can guarantee that the passed data points are sorted by keys in ascending order, you can set alreadySorted to true, to improve performance by saving a sorting run.
Alternatively, you can also access and modify the data directly via the data method, which returns a pointer to the internal data container.
Definition at line 21986 of file qcustomplot.cpp.
void QCPCurve::addData | ( | const QVector< double > & | keys, |
const QVector< double > & | values | ||
) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Adds the provided points in keys and values to the current data. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector.
The t parameter of each data point will be set to the integer index of the respective key/value pair.
Alternatively, you can also access and modify the data directly via the data method, which returns a pointer to the internal data container.
Definition at line 22018 of file qcustomplot.cpp.
void QCPCurve::addData | ( | double | t, |
double | key, | ||
double | value | ||
) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Adds the provided data point as t, key and value to the current data.
Alternatively, you can also access and modify the data directly via the data method, which returns a pointer to the internal data container.
Definition at line 22049 of file qcustomplot.cpp.
void QCPCurve::addData | ( | double | key, |
double | value | ||
) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Adds the provided data point as key and value to the current data.
The t parameter is generated automatically by increments of 1 for each point, starting at the highest t of previously existing data or 0, if the curve data is empty.
Alternatively, you can also access and modify the data directly via the data method, which returns a pointer to the internal data container.
Definition at line 22064 of file qcustomplot.cpp.
|
inline |
Returns a shared pointer to the internal data storage of type QCPCurveDataContainer. You may use it to directly manipulate the data, which may be more convenient and faster than using the regular setData or addData methods.
Definition at line 5326 of file qcustomplot.h.
|
protectedvirtual |
Implements QCPAbstractPlottable.
Definition at line 22114 of file qcustomplot.cpp.
|
protectedvirtual |
Definition at line 22222 of file qcustomplot.cpp.
|
protectedvirtual |
Implements QCPAbstractPlottable.
Definition at line 22182 of file qcustomplot.cpp.
|
protectedvirtual |
Definition at line 22238 of file qcustomplot.cpp.
|
protected |
Definition at line 22276 of file qcustomplot.cpp.
|
virtual |
Returns the coordinate range that all data in this plottable span in the key axis dimension. For logarithmic plots, one can set inSignDomain to either QCP::sdNegative or QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only negative range is wanted, set inSignDomain to QCP::sdNegative and all positive points will be ignored for range calculation. For no restriction, just set inSignDomain to QCP::sdBoth (default). foundRange is an output parameter that indicates whether a range could be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data).
Note that foundRange is not the same as QCPRange::validRange, since the range returned by this function may have size zero (e.g. when there is only one data point). In this case foundRange would return true, but the returned range is not a valid range in terms of QCPRange::validRange.
Implements QCPAbstractPlottable.
Definition at line 22102 of file qcustomplot.cpp.
|
protected |
Definition at line 22637 of file qcustomplot.cpp.
|
protected |
Definition at line 22521 of file qcustomplot.cpp.
|
protected |
Definition at line 22477 of file qcustomplot.cpp.
|
protected |
Definition at line 22379 of file qcustomplot.cpp.
|
protected |
Definition at line 22904 of file qcustomplot.cpp.
|
protected |
Definition at line 23017 of file qcustomplot.cpp.
|
virtual |
Returns the coordinate range that the data points in the specified key range (inKeyRange) span in the value axis dimension. For logarithmic plots, one can set inSignDomain to either QCP::sdNegative or QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only negative range is wanted, set inSignDomain to QCP::sdNegative and all positive points will be ignored for range calculation. For no restriction, just set inSignDomain to QCP::sdBoth (default). foundRange is an output parameter that indicates whether a range could be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data).
If inKeyRange has both lower and upper bound set to zero (is equal to QCPRange()
), all data points are considered, without any restriction on the keys.
Note that foundRange is not the same as QCPRange::validRange, since the range returned by this function may have size zero (e.g. when there is only one data point). In this case foundRange would return true, but the returned range is not a valid range in terms of QCPRange::validRange.
Implements QCPAbstractPlottable.
Definition at line 22108 of file qcustomplot.cpp.
|
inline |
Definition at line 5329 of file qcustomplot.h.
Definition at line 22801 of file qcustomplot.cpp.
|
protected |
Definition at line 23113 of file qcustomplot.cpp.
|
inline |
Definition at line 5328 of file qcustomplot.h.
|
inline |
Definition at line 5327 of file qcustomplot.h.
|
virtual |
Implements a selectTest specific to this plottable's point geometry.
If details is not 0, it will be set to a QCPDataSelection, describing the closest data point to pos.
QCPAbstractPlottable::selectTest
Reimplemented from QCPAbstractPlottable1D< QCPCurveData >.
Definition at line 22080 of file qcustomplot.cpp.
void QCPCurve::setData | ( | QSharedPointer< QCPCurveDataContainer > | data | ) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Replaces the current data container with the provided data container.
Since a QSharedPointer is used, multiple QCPCurves may share the same data container safely. Modifying the data in the container will then affect all curves that share the container. Sharing can be achieved by simply exchanging the data containers wrapped in shared pointers:
If you do not wish to share containers, but create a copy from an existing container, rather use the QCPDataContainer<DataType>::set method on the curve's data container directly:
Definition at line 21894 of file qcustomplot.cpp.
void QCPCurve::setData | ( | const QVector< double > & | t, |
const QVector< double > & | keys, | ||
const QVector< double > & | values, | ||
bool | alreadySorted = false |
||
) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Replaces the current data with the provided points in t, keys and values. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector.
If you can guarantee that the passed data points are sorted by t in ascending order, you can set alreadySorted to true, to improve performance by saving a sorting run.
Definition at line 21910 of file qcustomplot.cpp.
void QCPCurve::setData | ( | const QVector< double > & | keys, |
const QVector< double > & | values | ||
) |
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.
Replaces the current data with the provided points in keys and values. The provided vectors should have equal length. Else, the number of added points will be the size of the smallest vector.
The t parameter of each data point will be set to the integer index of the respective key/value pair.
Definition at line 21928 of file qcustomplot.cpp.
void QCPCurve::setLineStyle | ( | QCPCurve::LineStyle | style | ) |
Sets how the single data points are connected in the plot or how they are represented visually apart from the scatter symbol. For scatter-only plots, set style to lsNone and setScatterStyle to the desired scatter style.
Definition at line 21969 of file qcustomplot.cpp.
void QCPCurve::setScatterSkip | ( | int | skip | ) |
If scatters are displayed (scatter style not QCPScatterStyle::ssNone), skip number of scatter points are skipped/not drawn after every drawn scatter point.
This can be used to make the data appear sparser while for example still having a smooth line, and to improve performance for very high density plots.
If skip is set to 0 (default), all scatter points are drawn.
Definition at line 21957 of file qcustomplot.cpp.
void QCPCurve::setScatterStyle | ( | const QCPScatterStyle & | style | ) |
Sets the visual appearance of single data points in the plot. If set to QCPScatterStyle::ssNone, no scatter points are drawn (e.g. for line-only plots with appropriate line style).
Definition at line 21941 of file qcustomplot.cpp.
|
friend |
Definition at line 5376 of file qcustomplot.h.
|
friend |
Definition at line 5375 of file qcustomplot.h.
|
protected |
Definition at line 5354 of file qcustomplot.h.
|
protected |
Definition at line 5353 of file qcustomplot.h.
|
protected |
Definition at line 5352 of file qcustomplot.h.