![Roland Knall](/assets/img/avatar_default.png)
Following the move for widgets directory, moving utils to the utils directory. Guidelines for this directory are: - Generic use but not a widget - Utility functionality used by many classes Note: additionally all includes affected by this move have been changed to absolute path includes, instead of relative ones. Change-Id: I019ae4b6e6f6d06a5745a63ed195edbd36fb936b Reviewed-on: https://code.wireshark.org/review/22602 Petri-Dish: Roland Knall <rknall@gmail.com> Reviewed-by: Roland Knall <rknall@gmail.com>
3791 lines
146 KiB
C++
3791 lines
146 KiB
C++
/***************************************************************************
|
|
** **
|
|
** QCustomPlot, an easy to use, modern plotting widget for Qt **
|
|
** Copyright (C) 2011, 2012, 2013, 2014 Emanuel Eichhammer **
|
|
** **
|
|
** This program is free software: you can redistribute it and/or modify **
|
|
** it under the terms of the GNU General Public License as published by **
|
|
** the Free Software Foundation, either version 2 of the License, or **
|
|
** (at your option) any later version. **
|
|
** **
|
|
** This program is distributed in the hope that it will be useful, **
|
|
** but WITHOUT ANY WARRANTY; without even the implied warranty of **
|
|
** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the **
|
|
** GNU General Public License for more details. **
|
|
** **
|
|
** You should have received a copy of the GNU General Public License **
|
|
** along with this program. If not, see http://www.gnu.org/licenses/. **
|
|
** **
|
|
****************************************************************************
|
|
** Author: Emanuel Eichhammer **
|
|
** Website/Contact: http://www.qcustomplot.com/ **
|
|
** Emanuel Eichhammer has granted Wireshark permission to use QCustomPlot **
|
|
** under the terms of the GNU General Public License version 2. **
|
|
** Date: 27.12.14 **
|
|
** Version: 1.3.0 **
|
|
****************************************************************************/
|
|
|
|
#ifndef QCUSTOMPLOT_H
|
|
#define QCUSTOMPLOT_H
|
|
|
|
#include <QObject>
|
|
#include <QPointer>
|
|
#include <QWidget>
|
|
#include <QPainter>
|
|
#include <QPaintEvent>
|
|
#include <QMouseEvent>
|
|
#include <QPixmap>
|
|
#include <QVector>
|
|
#include <QString>
|
|
#include <QDateTime>
|
|
#include <QMultiMap>
|
|
#include <QFlags>
|
|
#include <QDebug>
|
|
#include <QVector2D>
|
|
#include <QStack>
|
|
#include <QCache>
|
|
#include <QMargins>
|
|
#include <qmath.h>
|
|
#include <limits>
|
|
#if QT_VERSION < QT_VERSION_CHECK(5, 0, 0)
|
|
# include <qnumeric.h>
|
|
# include <QPrinter>
|
|
# include <QPrintEngine>
|
|
#else
|
|
# include <QtNumeric>
|
|
# include <QtPrintSupport>
|
|
#endif
|
|
|
|
class QCPPainter;
|
|
class QCustomPlot;
|
|
class QCPLayerable;
|
|
class QCPLayoutElement;
|
|
class QCPLayout;
|
|
class QCPAxis;
|
|
class QCPAxisRect;
|
|
class QCPAxisPainterPrivate;
|
|
class QCPAbstractPlottable;
|
|
class QCPGraph;
|
|
class QCPAbstractItem;
|
|
class QCPItemPosition;
|
|
class QCPLayer;
|
|
class QCPPlotTitle;
|
|
class QCPLegend;
|
|
class QCPAbstractLegendItem;
|
|
class QCPColorMap;
|
|
class QCPColorScale;
|
|
class QCPBars;
|
|
|
|
|
|
/*! \file */
|
|
|
|
|
|
// decl definitions for shared library compilation/usage:
|
|
#if defined(QCUSTOMPLOT_COMPILE_LIBRARY)
|
|
# define QCP_LIB_DECL Q_DECL_EXPORT
|
|
#elif defined(QCUSTOMPLOT_USE_LIBRARY)
|
|
# define QCP_LIB_DECL Q_DECL_IMPORT
|
|
#else
|
|
# define QCP_LIB_DECL
|
|
#endif
|
|
|
|
/*!
|
|
The QCP Namespace contains general enums and QFlags used throughout the QCustomPlot library
|
|
*/
|
|
namespace QCP
|
|
{
|
|
/*!
|
|
Defines the sides of a rectangular entity to which margins can be applied.
|
|
|
|
\see QCPLayoutElement::setAutoMargins, QCPAxisRect::setAutoMargins
|
|
*/
|
|
enum MarginSide { msLeft = 0x01 ///< <tt>0x01</tt> left margin
|
|
,msRight = 0x02 ///< <tt>0x02</tt> right margin
|
|
,msTop = 0x04 ///< <tt>0x04</tt> top margin
|
|
,msBottom = 0x08 ///< <tt>0x08</tt> bottom margin
|
|
,msAll = 0xFF ///< <tt>0xFF</tt> all margins
|
|
,msNone = 0x00 ///< <tt>0x00</tt> no margin
|
|
};
|
|
Q_DECLARE_FLAGS(MarginSides, MarginSide)
|
|
|
|
/*!
|
|
Defines what objects of a plot can be forcibly drawn antialiased/not antialiased. If an object is
|
|
neither forcibly drawn antialiased nor forcibly drawn not antialiased, it is up to the respective
|
|
element how it is drawn. Typically it provides a \a setAntialiased function for this.
|
|
|
|
\c AntialiasedElements is a flag of or-combined elements of this enum type.
|
|
|
|
\see QCustomPlot::setAntialiasedElements, QCustomPlot::setNotAntialiasedElements
|
|
*/
|
|
enum AntialiasedElement { aeAxes = 0x0001 ///< <tt>0x0001</tt> Axis base line and tick marks
|
|
,aeGrid = 0x0002 ///< <tt>0x0002</tt> Grid lines
|
|
,aeSubGrid = 0x0004 ///< <tt>0x0004</tt> Sub grid lines
|
|
,aeLegend = 0x0008 ///< <tt>0x0008</tt> Legend box
|
|
,aeLegendItems = 0x0010 ///< <tt>0x0010</tt> Legend items
|
|
,aePlottables = 0x0020 ///< <tt>0x0020</tt> Main lines of plottables (excluding error bars, see element \ref aeErrorBars)
|
|
,aeItems = 0x0040 ///< <tt>0x0040</tt> Main lines of items
|
|
,aeScatters = 0x0080 ///< <tt>0x0080</tt> Scatter symbols of plottables (excluding scatter symbols of type ssPixmap)
|
|
,aeErrorBars = 0x0100 ///< <tt>0x0100</tt> Error bars
|
|
,aeFills = 0x0200 ///< <tt>0x0200</tt> Borders of fills (e.g. under or between graphs)
|
|
,aeZeroLine = 0x0400 ///< <tt>0x0400</tt> Zero-lines, see \ref QCPGrid::setZeroLinePen
|
|
,aeAll = 0xFFFF ///< <tt>0xFFFF</tt> All elements
|
|
,aeNone = 0x0000 ///< <tt>0x0000</tt> No elements
|
|
};
|
|
Q_DECLARE_FLAGS(AntialiasedElements, AntialiasedElement)
|
|
|
|
/*!
|
|
Defines plotting hints that control various aspects of the quality and speed of plotting.
|
|
|
|
\see QCustomPlot::setPlottingHints
|
|
*/
|
|
enum PlottingHint { phNone = 0x000 ///< <tt>0x000</tt> No hints are set
|
|
,phFastPolylines = 0x001 ///< <tt>0x001</tt> Graph/Curve lines are drawn with a faster method. This reduces the quality
|
|
///< especially of the line segment joins. (Only relevant for solid line pens.)
|
|
,phForceRepaint = 0x002 ///< <tt>0x002</tt> causes an immediate repaint() instead of a soft update() when QCustomPlot::replot() is called with parameter \ref QCustomPlot::rpHint.
|
|
///< This is set by default to prevent the plot from freezing on fast consecutive replots (e.g. user drags ranges with mouse).
|
|
,phCacheLabels = 0x004 ///< <tt>0x004</tt> axis (tick) labels will be cached as pixmaps, increasing replot performance.
|
|
};
|
|
Q_DECLARE_FLAGS(PlottingHints, PlottingHint)
|
|
|
|
/*!
|
|
Defines the mouse interactions possible with QCustomPlot.
|
|
|
|
\c Interactions is a flag of or-combined elements of this enum type.
|
|
|
|
\see QCustomPlot::setInteractions
|
|
*/
|
|
enum Interaction { iRangeDrag = 0x001 ///< <tt>0x001</tt> Axis ranges are draggable (see \ref QCPAxisRect::setRangeDrag, \ref QCPAxisRect::setRangeDragAxes)
|
|
,iRangeZoom = 0x002 ///< <tt>0x002</tt> Axis ranges are zoomable with the mouse wheel (see \ref QCPAxisRect::setRangeZoom, \ref QCPAxisRect::setRangeZoomAxes)
|
|
,iMultiSelect = 0x004 ///< <tt>0x004</tt> The user can select multiple objects by holding the modifier set by \ref QCustomPlot::setMultiSelectModifier while clicking
|
|
,iSelectPlottables = 0x008 ///< <tt>0x008</tt> Plottables are selectable (e.g. graphs, curves, bars,... see QCPAbstractPlottable)
|
|
,iSelectAxes = 0x010 ///< <tt>0x010</tt> Axes are selectable (or parts of them, see QCPAxis::setSelectableParts)
|
|
,iSelectLegend = 0x020 ///< <tt>0x020</tt> Legends are selectable (or their child items, see QCPLegend::setSelectableParts)
|
|
,iSelectItems = 0x040 ///< <tt>0x040</tt> Items are selectable (Rectangles, Arrows, Textitems, etc. see \ref QCPAbstractItem)
|
|
,iSelectOther = 0x080 ///< <tt>0x080</tt> All other objects are selectable (e.g. your own derived layerables, the plot title,...)
|
|
};
|
|
Q_DECLARE_FLAGS(Interactions, Interaction)
|
|
|
|
/*! \internal
|
|
|
|
Returns whether the specified \a value is considered an invalid data value for plottables (i.e.
|
|
is \e nan or \e +/-inf). This function is used to check data validity upon replots, when the
|
|
compiler flag \c QCUSTOMPLOT_CHECK_DATA is set.
|
|
*/
|
|
inline bool isInvalidData(double value)
|
|
{
|
|
return qIsNaN(value) || qIsInf(value);
|
|
}
|
|
|
|
/*! \internal
|
|
\overload
|
|
|
|
Checks two arguments instead of one.
|
|
*/
|
|
inline bool isInvalidData(double value1, double value2)
|
|
{
|
|
return isInvalidData(value1) || isInvalidData(value2);
|
|
}
|
|
|
|
/*! \internal
|
|
|
|
Sets the specified \a side of \a margins to \a value
|
|
|
|
\see getMarginValue
|
|
*/
|
|
inline void setMarginValue(QMargins &margins, QCP::MarginSide side, int value)
|
|
{
|
|
switch (side)
|
|
{
|
|
case QCP::msLeft: margins.setLeft(value); break;
|
|
case QCP::msRight: margins.setRight(value); break;
|
|
case QCP::msTop: margins.setTop(value); break;
|
|
case QCP::msBottom: margins.setBottom(value); break;
|
|
case QCP::msAll: margins = QMargins(value, value, value, value); break;
|
|
default: break;
|
|
}
|
|
}
|
|
|
|
/*! \internal
|
|
|
|
Returns the value of the specified \a side of \a margins. If \a side is \ref QCP::msNone or
|
|
\ref QCP::msAll, returns 0.
|
|
|
|
\see setMarginValue
|
|
*/
|
|
inline int getMarginValue(const QMargins &margins, QCP::MarginSide side)
|
|
{
|
|
switch (side)
|
|
{
|
|
case QCP::msLeft: return margins.left();
|
|
case QCP::msRight: return margins.right();
|
|
case QCP::msTop: return margins.top();
|
|
case QCP::msBottom: return margins.bottom();
|
|
default: break;
|
|
}
|
|
return 0;
|
|
}
|
|
|
|
} // end of namespace QCP
|
|
|
|
Q_DECLARE_OPERATORS_FOR_FLAGS(QCP::AntialiasedElements)
|
|
Q_DECLARE_OPERATORS_FOR_FLAGS(QCP::PlottingHints)
|
|
Q_DECLARE_OPERATORS_FOR_FLAGS(QCP::MarginSides)
|
|
Q_DECLARE_OPERATORS_FOR_FLAGS(QCP::Interactions)
|
|
|
|
|
|
class QCP_LIB_DECL QCPScatterStyle
|
|
{
|
|
Q_GADGET
|
|
public:
|
|
/*!
|
|
Defines the shape used for scatter points.
|
|
|
|
On plottables/items that draw scatters, the sizes of these visualizations (with exception of
|
|
\ref ssDot and \ref ssPixmap) can be controlled with the \ref setSize function. Scatters are
|
|
drawn with the pen and brush specified with \ref setPen and \ref setBrush.
|
|
*/
|
|
Q_ENUMS(ScatterShape)
|
|
enum ScatterShape { ssNone ///< no scatter symbols are drawn (e.g. in QCPGraph, data only represented with lines)
|
|
,ssDot ///< \enumimage{ssDot.png} a single pixel (use \ref ssDisc or \ref ssCircle if you want a round shape with a certain radius)
|
|
,ssCross ///< \enumimage{ssCross.png} a cross
|
|
,ssPlus ///< \enumimage{ssPlus.png} a plus
|
|
,ssCircle ///< \enumimage{ssCircle.png} a circle
|
|
,ssDisc ///< \enumimage{ssDisc.png} a circle which is filled with the pen's color (not the brush as with ssCircle)
|
|
,ssSquare ///< \enumimage{ssSquare.png} a square
|
|
,ssDiamond ///< \enumimage{ssDiamond.png} a diamond
|
|
,ssStar ///< \enumimage{ssStar.png} a star with eight arms, i.e. a combination of cross and plus
|
|
,ssTriangle ///< \enumimage{ssTriangle.png} an equilateral triangle, standing on baseline
|
|
,ssTriangleInverted ///< \enumimage{ssTriangleInverted.png} an equilateral triangle, standing on corner
|
|
,ssCrossSquare ///< \enumimage{ssCrossSquare.png} a square with a cross inside
|
|
,ssPlusSquare ///< \enumimage{ssPlusSquare.png} a square with a plus inside
|
|
,ssCrossCircle ///< \enumimage{ssCrossCircle.png} a circle with a cross inside
|
|
,ssPlusCircle ///< \enumimage{ssPlusCircle.png} a circle with a plus inside
|
|
,ssPeace ///< \enumimage{ssPeace.png} a circle, with one vertical and two downward diagonal lines
|
|
,ssPixmap ///< a custom pixmap specified by \ref setPixmap, centered on the data point coordinates
|
|
,ssCustom ///< custom painter operations are performed per scatter (As QPainterPath, see \ref setCustomPath)
|
|
};
|
|
|
|
QCPScatterStyle();
|
|
QCPScatterStyle(ScatterShape shape, double size=6);
|
|
QCPScatterStyle(ScatterShape shape, const QColor &color, double size);
|
|
QCPScatterStyle(ScatterShape shape, const QColor &color, const QColor &fill, double size);
|
|
QCPScatterStyle(ScatterShape shape, const QPen &pen, const QBrush &brush, double size);
|
|
QCPScatterStyle(const QPixmap &pixmap);
|
|
QCPScatterStyle(const QPainterPath &customPath, const QPen &pen, const QBrush &brush=Qt::NoBrush, double size=6);
|
|
|
|
// getters:
|
|
double size() const { return mSize; }
|
|
ScatterShape shape() const { return mShape; }
|
|
QPen pen() const { return mPen; }
|
|
QBrush brush() const { return mBrush; }
|
|
QPixmap pixmap() const { return mPixmap; }
|
|
QPainterPath customPath() const { return mCustomPath; }
|
|
|
|
// setters:
|
|
void setSize(double size);
|
|
void setShape(ScatterShape shape);
|
|
void setPen(const QPen &pen);
|
|
void setBrush(const QBrush &brush);
|
|
void setPixmap(const QPixmap &pixmap);
|
|
void setCustomPath(const QPainterPath &customPath);
|
|
|
|
// non-property methods:
|
|
bool isNone() const { return mShape == ssNone; }
|
|
bool isPenDefined() const { return mPenDefined; }
|
|
void applyTo(QCPPainter *painter, const QPen &defaultPen) const;
|
|
void drawShape(QCPPainter *painter, QPointF pos) const;
|
|
void drawShape(QCPPainter *painter, double x, double y) const;
|
|
|
|
protected:
|
|
// property members:
|
|
double mSize;
|
|
ScatterShape mShape;
|
|
QPen mPen;
|
|
QBrush mBrush;
|
|
QPixmap mPixmap;
|
|
QPainterPath mCustomPath;
|
|
|
|
// non-property members:
|
|
bool mPenDefined;
|
|
};
|
|
Q_DECLARE_TYPEINFO(QCPScatterStyle, Q_MOVABLE_TYPE);
|
|
|
|
|
|
class QCP_LIB_DECL QCPPainter : public QPainter
|
|
{
|
|
Q_GADGET
|
|
public:
|
|
/*!
|
|
Defines special modes the painter can operate in. They disable or enable certain subsets of features/fixes/workarounds,
|
|
depending on whether they are wanted on the respective output device.
|
|
*/
|
|
enum PainterMode { pmDefault = 0x00 ///< <tt>0x00</tt> Default mode for painting on screen devices
|
|
,pmVectorized = 0x01 ///< <tt>0x01</tt> Mode for vectorized painting (e.g. PDF export). For example, this prevents some antialiasing fixes.
|
|
,pmNoCaching = 0x02 ///< <tt>0x02</tt> Mode for all sorts of exports (e.g. PNG, PDF,...). For example, this prevents using cached pixmap labels
|
|
,pmNonCosmetic = 0x04 ///< <tt>0x04</tt> Turns pen widths 0 to 1, i.e. disables cosmetic pens. (A cosmetic pen is always drawn with width 1 pixel in the vector image/pdf viewer, independent of zoom.)
|
|
};
|
|
Q_FLAGS(PainterMode PainterModes)
|
|
Q_DECLARE_FLAGS(PainterModes, PainterMode)
|
|
|
|
QCPPainter();
|
|
QCPPainter(QPaintDevice *device);
|
|
~QCPPainter();
|
|
|
|
// getters:
|
|
bool antialiasing() const { return testRenderHint(QPainter::Antialiasing); }
|
|
PainterModes modes() const { return mModes; }
|
|
|
|
// setters:
|
|
void setAntialiasing(bool enabled);
|
|
void setMode(PainterMode mode, bool enabled=true);
|
|
void setModes(PainterModes modes);
|
|
|
|
// methods hiding non-virtual base class functions (QPainter bug workarounds):
|
|
bool begin(QPaintDevice *device);
|
|
void setPen(const QPen &pen);
|
|
void setPen(const QColor &color);
|
|
void setPen(Qt::PenStyle penStyle);
|
|
void drawLine(const QLineF &line);
|
|
void drawLine(const QPointF &p1, const QPointF &p2) {drawLine(QLineF(p1, p2));}
|
|
void save();
|
|
void restore();
|
|
|
|
// non-virtual methods:
|
|
void makeNonCosmetic();
|
|
|
|
protected:
|
|
// property members:
|
|
PainterModes mModes;
|
|
bool mIsAntialiasing;
|
|
|
|
// non-property members:
|
|
QStack<bool> mAntialiasingStack;
|
|
};
|
|
Q_DECLARE_OPERATORS_FOR_FLAGS(QCPPainter::PainterModes)
|
|
|
|
|
|
class QCP_LIB_DECL QCPLayer : public QObject
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(QCustomPlot* parentPlot READ parentPlot)
|
|
Q_PROPERTY(QString name READ name)
|
|
Q_PROPERTY(int index READ index)
|
|
Q_PROPERTY(QList<QCPLayerable*> children READ children)
|
|
Q_PROPERTY(bool visible READ visible WRITE setVisible)
|
|
/// \endcond
|
|
public:
|
|
QCPLayer(QCustomPlot* parentPlot, const QString &layerName);
|
|
~QCPLayer();
|
|
|
|
// getters:
|
|
QCustomPlot *parentPlot() const { return mParentPlot; }
|
|
QString name() const { return mName; }
|
|
int index() const { return mIndex; }
|
|
QList<QCPLayerable*> children() const { return mChildren; }
|
|
bool visible() const { return mVisible; }
|
|
|
|
// setters:
|
|
void setVisible(bool visible);
|
|
|
|
protected:
|
|
// property members:
|
|
QCustomPlot *mParentPlot;
|
|
QString mName;
|
|
int mIndex;
|
|
QList<QCPLayerable*> mChildren;
|
|
bool mVisible;
|
|
|
|
// non-virtual methods:
|
|
void addChild(QCPLayerable *layerable, bool prepend);
|
|
void removeChild(QCPLayerable *layerable);
|
|
|
|
private:
|
|
Q_DISABLE_COPY(QCPLayer)
|
|
|
|
friend class QCustomPlot;
|
|
friend class QCPLayerable;
|
|
};
|
|
|
|
class QCP_LIB_DECL QCPLayerable : public QObject
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(bool visible READ visible WRITE setVisible)
|
|
Q_PROPERTY(QCustomPlot* parentPlot READ parentPlot)
|
|
Q_PROPERTY(QCPLayerable* parentLayerable READ parentLayerable)
|
|
Q_PROPERTY(QCPLayer* layer READ layer WRITE setLayer NOTIFY layerChanged)
|
|
Q_PROPERTY(bool antialiased READ antialiased WRITE setAntialiased)
|
|
/// \endcond
|
|
public:
|
|
QCPLayerable(QCustomPlot *plot, QString targetLayer=QString(), QCPLayerable *parentLayerable=0);
|
|
~QCPLayerable();
|
|
|
|
// getters:
|
|
bool visible() const { return mVisible; }
|
|
QCustomPlot *parentPlot() const { return mParentPlot; }
|
|
QCPLayerable *parentLayerable() const { return mParentLayerable.data(); }
|
|
QCPLayer *layer() const { return mLayer; }
|
|
bool antialiased() const { return mAntialiased; }
|
|
|
|
// setters:
|
|
void setVisible(bool on);
|
|
Q_SLOT bool setLayer(QCPLayer *layer);
|
|
bool setLayer(const QString &layerName);
|
|
void setAntialiased(bool enabled);
|
|
|
|
// introduced virtual methods:
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
// non-property methods:
|
|
bool realVisibility() const;
|
|
|
|
signals:
|
|
void layerChanged(QCPLayer *newLayer);
|
|
|
|
protected:
|
|
// property members:
|
|
bool mVisible;
|
|
QCustomPlot *mParentPlot;
|
|
QPointer<QCPLayerable> mParentLayerable;
|
|
QCPLayer *mLayer;
|
|
bool mAntialiased;
|
|
|
|
// introduced virtual methods:
|
|
virtual void parentPlotInitialized(QCustomPlot *parentPlot);
|
|
virtual QCP::Interaction selectionCategory() const;
|
|
virtual QRect clipRect() const;
|
|
virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const = 0;
|
|
virtual void draw(QCPPainter *painter) = 0;
|
|
// events:
|
|
virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged);
|
|
virtual void deselectEvent(bool *selectionStateChanged);
|
|
|
|
// non-property methods:
|
|
void initializeParentPlot(QCustomPlot *parentPlot);
|
|
void setParentLayerable(QCPLayerable* parentLayerable);
|
|
bool moveToLayer(QCPLayer *layer, bool prepend);
|
|
void applyAntialiasingHint(QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const;
|
|
|
|
private:
|
|
Q_DISABLE_COPY(QCPLayerable)
|
|
|
|
friend class QCustomPlot;
|
|
friend class QCPAxisRect;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPRange
|
|
{
|
|
public:
|
|
double lower, upper;
|
|
|
|
QCPRange();
|
|
QCPRange(double lower, double upper);
|
|
|
|
bool operator==(const QCPRange& other) const { return lower == other.lower && upper == other.upper; }
|
|
bool operator!=(const QCPRange& other) const { return !(*this == other); }
|
|
|
|
QCPRange &operator+=(const double& value) { lower+=value; upper+=value; return *this; }
|
|
QCPRange &operator-=(const double& value) { lower-=value; upper-=value; return *this; }
|
|
QCPRange &operator*=(const double& value) { lower*=value; upper*=value; return *this; }
|
|
QCPRange &operator/=(const double& value) { lower/=value; upper/=value; return *this; }
|
|
friend inline const QCPRange operator+(const QCPRange&, double);
|
|
friend inline const QCPRange operator+(double, const QCPRange&);
|
|
friend inline const QCPRange operator-(const QCPRange& range, double value);
|
|
friend inline const QCPRange operator*(const QCPRange& range, double value);
|
|
friend inline const QCPRange operator*(double value, const QCPRange& range);
|
|
friend inline const QCPRange operator/(const QCPRange& range, double value);
|
|
|
|
double size() const;
|
|
double center() const;
|
|
void normalize();
|
|
void expand(const QCPRange &otherRange);
|
|
QCPRange expanded(const QCPRange &otherRange) const;
|
|
QCPRange sanitizedForLogScale() const;
|
|
QCPRange sanitizedForLinScale() const;
|
|
bool contains(double value) const;
|
|
|
|
static bool validRange(double lower, double upper);
|
|
static bool validRange(const QCPRange &range);
|
|
static const double minRange; //1e-280;
|
|
static const double maxRange; //1e280;
|
|
|
|
};
|
|
Q_DECLARE_TYPEINFO(QCPRange, Q_MOVABLE_TYPE);
|
|
|
|
/* documentation of inline functions */
|
|
|
|
/*! \fn QCPRange &QCPRange::operator+=(const double& value)
|
|
|
|
Adds \a value to both boundaries of the range.
|
|
*/
|
|
|
|
/*! \fn QCPRange &QCPRange::operator-=(const double& value)
|
|
|
|
Subtracts \a value from both boundaries of the range.
|
|
*/
|
|
|
|
/*! \fn QCPRange &QCPRange::operator*=(const double& value)
|
|
|
|
Multiplies both boundaries of the range by \a value.
|
|
*/
|
|
|
|
/*! \fn QCPRange &QCPRange::operator/=(const double& value)
|
|
|
|
Divides both boundaries of the range by \a value.
|
|
*/
|
|
|
|
/* end documentation of inline functions */
|
|
|
|
/*!
|
|
Adds \a value to both boundaries of the range.
|
|
*/
|
|
inline const QCPRange operator+(const QCPRange& range, double value)
|
|
{
|
|
QCPRange result(range);
|
|
result += value;
|
|
return result;
|
|
}
|
|
|
|
/*!
|
|
Adds \a value to both boundaries of the range.
|
|
*/
|
|
inline const QCPRange operator+(double value, const QCPRange& range)
|
|
{
|
|
QCPRange result(range);
|
|
result += value;
|
|
return result;
|
|
}
|
|
|
|
/*!
|
|
Subtracts \a value from both boundaries of the range.
|
|
*/
|
|
inline const QCPRange operator-(const QCPRange& range, double value)
|
|
{
|
|
QCPRange result(range);
|
|
result -= value;
|
|
return result;
|
|
}
|
|
|
|
/*!
|
|
Multiplies both boundaries of the range by \a value.
|
|
*/
|
|
inline const QCPRange operator*(const QCPRange& range, double value)
|
|
{
|
|
QCPRange result(range);
|
|
result *= value;
|
|
return result;
|
|
}
|
|
|
|
/*!
|
|
Multiplies both boundaries of the range by \a value.
|
|
*/
|
|
inline const QCPRange operator*(double value, const QCPRange& range)
|
|
{
|
|
QCPRange result(range);
|
|
result *= value;
|
|
return result;
|
|
}
|
|
|
|
/*!
|
|
Divides both boundaries of the range by \a value.
|
|
*/
|
|
inline const QCPRange operator/(const QCPRange& range, double value)
|
|
{
|
|
QCPRange result(range);
|
|
result /= value;
|
|
return result;
|
|
}
|
|
|
|
|
|
class QCP_LIB_DECL QCPMarginGroup : public QObject
|
|
{
|
|
Q_OBJECT
|
|
public:
|
|
QCPMarginGroup(QCustomPlot *parentPlot);
|
|
~QCPMarginGroup();
|
|
|
|
// non-virtual methods:
|
|
QList<QCPLayoutElement*> elements(QCP::MarginSide side) const { return mChildren.value(side); }
|
|
bool isEmpty() const;
|
|
void clear();
|
|
|
|
protected:
|
|
// non-property members:
|
|
QCustomPlot *mParentPlot;
|
|
QHash<QCP::MarginSide, QList<QCPLayoutElement*> > mChildren;
|
|
|
|
// non-virtual methods:
|
|
int commonMargin(QCP::MarginSide side) const;
|
|
void addChild(QCP::MarginSide side, QCPLayoutElement *element);
|
|
void removeChild(QCP::MarginSide side, QCPLayoutElement *element);
|
|
|
|
private:
|
|
Q_DISABLE_COPY(QCPMarginGroup)
|
|
|
|
friend class QCPLayoutElement;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPLayoutElement : public QCPLayerable
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(QCPLayout* layout READ layout)
|
|
Q_PROPERTY(QRect rect READ rect)
|
|
Q_PROPERTY(QRect outerRect READ outerRect WRITE setOuterRect)
|
|
Q_PROPERTY(QMargins margins READ margins WRITE setMargins)
|
|
Q_PROPERTY(QMargins minimumMargins READ minimumMargins WRITE setMinimumMargins)
|
|
Q_PROPERTY(QSize minimumSize READ minimumSize WRITE setMinimumSize)
|
|
Q_PROPERTY(QSize maximumSize READ maximumSize WRITE setMaximumSize)
|
|
/// \endcond
|
|
public:
|
|
/*!
|
|
Defines the phases of the update process, that happens just before a replot. At each phase,
|
|
\ref update is called with the according UpdatePhase value.
|
|
*/
|
|
enum UpdatePhase { upPreparation ///< Phase used for any type of preparation that needs to be done before margin calculation and layout
|
|
,upMargins ///< Phase in which the margins are calculated and set
|
|
,upLayout ///< Final phase in which the layout system places the rects of the elements
|
|
};
|
|
Q_ENUMS(UpdatePhase)
|
|
|
|
explicit QCPLayoutElement(QCustomPlot *parentPlot=0);
|
|
virtual ~QCPLayoutElement();
|
|
|
|
// getters:
|
|
QCPLayout *layout() const { return mParentLayout; }
|
|
QRect rect() const { return mRect; }
|
|
QRect outerRect() const { return mOuterRect; }
|
|
QMargins margins() const { return mMargins; }
|
|
QMargins minimumMargins() const { return mMinimumMargins; }
|
|
QCP::MarginSides autoMargins() const { return mAutoMargins; }
|
|
QSize minimumSize() const { return mMinimumSize; }
|
|
QSize maximumSize() const { return mMaximumSize; }
|
|
QCPMarginGroup *marginGroup(QCP::MarginSide side) const { return mMarginGroups.value(side, (QCPMarginGroup*)0); }
|
|
QHash<QCP::MarginSide, QCPMarginGroup*> marginGroups() const { return mMarginGroups; }
|
|
|
|
// setters:
|
|
void setOuterRect(const QRect &rect);
|
|
void setMargins(const QMargins &margins);
|
|
void setMinimumMargins(const QMargins &margins);
|
|
void setAutoMargins(QCP::MarginSides sides);
|
|
void setMinimumSize(const QSize &size);
|
|
void setMinimumSize(int width, int height);
|
|
void setMaximumSize(const QSize &size);
|
|
void setMaximumSize(int width, int height);
|
|
void setMarginGroup(QCP::MarginSides sides, QCPMarginGroup *group);
|
|
|
|
// introduced virtual methods:
|
|
virtual void update(UpdatePhase phase);
|
|
virtual QSize minimumSizeHint() const;
|
|
virtual QSize maximumSizeHint() const;
|
|
virtual QList<QCPLayoutElement*> elements(bool recursive) const;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
protected:
|
|
// property members:
|
|
QCPLayout *mParentLayout;
|
|
QSize mMinimumSize, mMaximumSize;
|
|
QRect mRect, mOuterRect;
|
|
QMargins mMargins, mMinimumMargins;
|
|
QCP::MarginSides mAutoMargins;
|
|
QHash<QCP::MarginSide, QCPMarginGroup*> mMarginGroups;
|
|
|
|
// introduced virtual methods:
|
|
virtual int calculateAutoMargin(QCP::MarginSide side);
|
|
// events:
|
|
virtual void mousePressEvent(QMouseEvent * ) { }
|
|
virtual void mouseMoveEvent(QMouseEvent * ) { }
|
|
virtual void mouseReleaseEvent(QMouseEvent * ) { }
|
|
virtual void mouseDoubleClickEvent(QMouseEvent * ) { }
|
|
virtual void wheelEvent(QWheelEvent * ) { }
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void applyDefaultAntialiasingHint(QCPPainter * ) const { }
|
|
virtual void draw(QCPPainter * ) { }
|
|
virtual void parentPlotInitialized(QCustomPlot *parentPlot);
|
|
|
|
private:
|
|
Q_DISABLE_COPY(QCPLayoutElement)
|
|
|
|
friend class QCustomPlot;
|
|
friend class QCPLayout;
|
|
friend class QCPMarginGroup;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPLayout : public QCPLayoutElement
|
|
{
|
|
Q_OBJECT
|
|
public:
|
|
explicit QCPLayout();
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void update(UpdatePhase phase);
|
|
virtual QList<QCPLayoutElement*> elements(bool recursive) const;
|
|
|
|
// introduced virtual methods:
|
|
virtual int elementCount() const = 0;
|
|
virtual QCPLayoutElement* elementAt(int index) const = 0;
|
|
virtual QCPLayoutElement* takeAt(int index) = 0;
|
|
virtual bool take(QCPLayoutElement* element) = 0;
|
|
virtual void simplify();
|
|
|
|
// non-virtual methods:
|
|
bool removeAt(int index);
|
|
bool remove(QCPLayoutElement* element);
|
|
void clear();
|
|
|
|
protected:
|
|
// introduced virtual methods:
|
|
virtual void updateLayout();
|
|
|
|
// non-virtual methods:
|
|
void sizeConstraintsChanged() const;
|
|
void adoptElement(QCPLayoutElement *el);
|
|
void releaseElement(QCPLayoutElement *el);
|
|
QVector<int> getSectionSizes(QVector<int> maxSizes, QVector<int> minSizes, QVector<double> stretchFactors, int totalSize) const;
|
|
|
|
private:
|
|
Q_DISABLE_COPY(QCPLayout)
|
|
friend class QCPLayoutElement;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPLayoutGrid : public QCPLayout
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(int rowCount READ rowCount)
|
|
Q_PROPERTY(int columnCount READ columnCount)
|
|
Q_PROPERTY(QList<double> columnStretchFactors READ columnStretchFactors WRITE setColumnStretchFactors)
|
|
Q_PROPERTY(QList<double> rowStretchFactors READ rowStretchFactors WRITE setRowStretchFactors)
|
|
Q_PROPERTY(int columnSpacing READ columnSpacing WRITE setColumnSpacing)
|
|
Q_PROPERTY(int rowSpacing READ rowSpacing WRITE setRowSpacing)
|
|
/// \endcond
|
|
public:
|
|
explicit QCPLayoutGrid();
|
|
virtual ~QCPLayoutGrid();
|
|
|
|
// getters:
|
|
int rowCount() const;
|
|
int columnCount() const;
|
|
QList<double> columnStretchFactors() const { return mColumnStretchFactors; }
|
|
QList<double> rowStretchFactors() const { return mRowStretchFactors; }
|
|
int columnSpacing() const { return mColumnSpacing; }
|
|
int rowSpacing() const { return mRowSpacing; }
|
|
|
|
// setters:
|
|
void setColumnStretchFactor(int column, double factor);
|
|
void setColumnStretchFactors(const QList<double> &factors);
|
|
void setRowStretchFactor(int row, double factor);
|
|
void setRowStretchFactors(const QList<double> &factors);
|
|
void setColumnSpacing(int pixels);
|
|
void setRowSpacing(int pixels);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void updateLayout();
|
|
virtual int elementCount() const;
|
|
virtual QCPLayoutElement* elementAt(int index) const;
|
|
virtual QCPLayoutElement* takeAt(int index);
|
|
virtual bool take(QCPLayoutElement* element);
|
|
virtual QList<QCPLayoutElement*> elements(bool recursive) const;
|
|
virtual void simplify();
|
|
virtual QSize minimumSizeHint() const;
|
|
virtual QSize maximumSizeHint() const;
|
|
|
|
// non-virtual methods:
|
|
QCPLayoutElement *element(int row, int column) const;
|
|
bool addElement(int row, int column, QCPLayoutElement *element);
|
|
bool hasElement(int row, int column);
|
|
void expandTo(int newRowCount, int newColumnCount);
|
|
void insertRow(int newIndex);
|
|
void insertColumn(int newIndex);
|
|
|
|
protected:
|
|
// property members:
|
|
QList<QList<QCPLayoutElement*> > mElements;
|
|
QList<double> mColumnStretchFactors;
|
|
QList<double> mRowStretchFactors;
|
|
int mColumnSpacing, mRowSpacing;
|
|
|
|
// non-virtual methods:
|
|
void getMinimumRowColSizes(QVector<int> *minColWidths, QVector<int> *minRowHeights) const;
|
|
void getMaximumRowColSizes(QVector<int> *maxColWidths, QVector<int> *maxRowHeights) const;
|
|
|
|
private:
|
|
Q_DISABLE_COPY(QCPLayoutGrid)
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPLayoutInset : public QCPLayout
|
|
{
|
|
Q_OBJECT
|
|
public:
|
|
/*!
|
|
Defines how the placement and sizing is handled for a certain element in a QCPLayoutInset.
|
|
*/
|
|
enum InsetPlacement { ipFree ///< The element may be positioned/sized arbitrarily, see \ref setInsetRect
|
|
,ipBorderAligned ///< The element is aligned to one of the layout sides, see \ref setInsetAlignment
|
|
};
|
|
|
|
explicit QCPLayoutInset();
|
|
virtual ~QCPLayoutInset();
|
|
|
|
// getters:
|
|
InsetPlacement insetPlacement(int index) const;
|
|
Qt::Alignment insetAlignment(int index) const;
|
|
QRectF insetRect(int index) const;
|
|
|
|
// setters:
|
|
void setInsetPlacement(int index, InsetPlacement placement);
|
|
void setInsetAlignment(int index, Qt::Alignment alignment);
|
|
void setInsetRect(int index, const QRectF &rect);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void updateLayout();
|
|
virtual int elementCount() const;
|
|
virtual QCPLayoutElement* elementAt(int index) const;
|
|
virtual QCPLayoutElement* takeAt(int index);
|
|
virtual bool take(QCPLayoutElement* element);
|
|
virtual void simplify() {}
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
// non-virtual methods:
|
|
void addElement(QCPLayoutElement *element, Qt::Alignment alignment);
|
|
void addElement(QCPLayoutElement *element, const QRectF &rect);
|
|
|
|
protected:
|
|
// property members:
|
|
QList<QCPLayoutElement*> mElements;
|
|
QList<InsetPlacement> mInsetPlacement;
|
|
QList<Qt::Alignment> mInsetAlignment;
|
|
QList<QRectF> mInsetRect;
|
|
|
|
private:
|
|
Q_DISABLE_COPY(QCPLayoutInset)
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPLineEnding
|
|
{
|
|
Q_GADGET
|
|
public:
|
|
/*!
|
|
Defines the type of ending decoration for line-like items, e.g. an arrow.
|
|
|
|
\image html QCPLineEnding.png
|
|
|
|
The width and length of these decorations can be controlled with the functions \ref setWidth
|
|
and \ref setLength. Some decorations like \ref esDisc, \ref esSquare, \ref esDiamond and \ref esBar only
|
|
support a width, the length property is ignored.
|
|
|
|
\see QCPItemLine::setHead, QCPItemLine::setTail, QCPItemCurve::setHead, QCPItemCurve::setTail, QCPAxis::setLowerEnding, QCPAxis::setUpperEnding
|
|
*/
|
|
Q_ENUMS(EndingStyle)
|
|
enum EndingStyle { esNone ///< No ending decoration
|
|
,esFlatArrow ///< A filled arrow head with a straight/flat back (a triangle)
|
|
,esSpikeArrow ///< A filled arrow head with an indented back
|
|
,esLineArrow ///< A non-filled arrow head with open back
|
|
,esDisc ///< A filled circle
|
|
,esSquare ///< A filled square
|
|
,esDiamond ///< A filled diamond (45 degrees rotated square)
|
|
,esBar ///< A bar perpendicular to the line
|
|
,esHalfBar ///< A bar perpendicular to the line, pointing out to only one side (to which side can be changed with \ref setInverted)
|
|
,esSkewedBar ///< A bar that is skewed (skew controllable via \ref setLength)
|
|
};
|
|
|
|
QCPLineEnding();
|
|
QCPLineEnding(EndingStyle style, double width=8, double length=10, bool inverted=false);
|
|
|
|
// getters:
|
|
EndingStyle style() const { return mStyle; }
|
|
double width() const { return mWidth; }
|
|
double length() const { return mLength; }
|
|
bool inverted() const { return mInverted; }
|
|
|
|
// setters:
|
|
void setStyle(EndingStyle style);
|
|
void setWidth(double width);
|
|
void setLength(double length);
|
|
void setInverted(bool inverted);
|
|
|
|
// non-property methods:
|
|
double boundingDistance() const;
|
|
double realLength() const;
|
|
void draw(QCPPainter *painter, const QVector2D &pos, const QVector2D &dir) const;
|
|
void draw(QCPPainter *painter, const QVector2D &pos, double angle) const;
|
|
|
|
protected:
|
|
// property members:
|
|
EndingStyle mStyle;
|
|
double mWidth, mLength;
|
|
bool mInverted;
|
|
};
|
|
Q_DECLARE_TYPEINFO(QCPLineEnding, Q_MOVABLE_TYPE);
|
|
|
|
|
|
class QCP_LIB_DECL QCPGrid :public QCPLayerable
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(bool subGridVisible READ subGridVisible WRITE setSubGridVisible)
|
|
Q_PROPERTY(bool antialiasedSubGrid READ antialiasedSubGrid WRITE setAntialiasedSubGrid)
|
|
Q_PROPERTY(bool antialiasedZeroLine READ antialiasedZeroLine WRITE setAntialiasedZeroLine)
|
|
Q_PROPERTY(QPen pen READ pen WRITE setPen)
|
|
Q_PROPERTY(QPen subGridPen READ subGridPen WRITE setSubGridPen)
|
|
Q_PROPERTY(QPen zeroLinePen READ zeroLinePen WRITE setZeroLinePen)
|
|
/// \endcond
|
|
public:
|
|
QCPGrid(QCPAxis *parentAxis);
|
|
|
|
// getters:
|
|
bool subGridVisible() const { return mSubGridVisible; }
|
|
bool antialiasedSubGrid() const { return mAntialiasedSubGrid; }
|
|
bool antialiasedZeroLine() const { return mAntialiasedZeroLine; }
|
|
QPen pen() const { return mPen; }
|
|
QPen subGridPen() const { return mSubGridPen; }
|
|
QPen zeroLinePen() const { return mZeroLinePen; }
|
|
|
|
// setters:
|
|
void setSubGridVisible(bool visible);
|
|
void setAntialiasedSubGrid(bool enabled);
|
|
void setAntialiasedZeroLine(bool enabled);
|
|
void setPen(const QPen &pen);
|
|
void setSubGridPen(const QPen &pen);
|
|
void setZeroLinePen(const QPen &pen);
|
|
|
|
protected:
|
|
// property members:
|
|
bool mSubGridVisible;
|
|
bool mAntialiasedSubGrid, mAntialiasedZeroLine;
|
|
QPen mPen, mSubGridPen, mZeroLinePen;
|
|
// non-property members:
|
|
QCPAxis *mParentAxis;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const;
|
|
virtual void draw(QCPPainter *painter);
|
|
|
|
// non-virtual methods:
|
|
void drawGridLines(QCPPainter *painter) const;
|
|
void drawSubGridLines(QCPPainter *painter) const;
|
|
|
|
friend class QCPAxis;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPAxis : public QCPLayerable
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(AxisType axisType READ axisType)
|
|
Q_PROPERTY(QCPAxisRect* axisRect READ axisRect)
|
|
Q_PROPERTY(ScaleType scaleType READ scaleType WRITE setScaleType NOTIFY scaleTypeChanged)
|
|
Q_PROPERTY(double scaleLogBase READ scaleLogBase WRITE setScaleLogBase)
|
|
Q_PROPERTY(QCPRange range READ range WRITE setRange NOTIFY rangeChanged)
|
|
Q_PROPERTY(bool rangeReversed READ rangeReversed WRITE setRangeReversed)
|
|
Q_PROPERTY(bool autoTicks READ autoTicks WRITE setAutoTicks)
|
|
Q_PROPERTY(int autoTickCount READ autoTickCount WRITE setAutoTickCount)
|
|
Q_PROPERTY(bool autoTickLabels READ autoTickLabels WRITE setAutoTickLabels)
|
|
Q_PROPERTY(bool autoTickStep READ autoTickStep WRITE setAutoTickStep)
|
|
Q_PROPERTY(bool autoSubTicks READ autoSubTicks WRITE setAutoSubTicks)
|
|
Q_PROPERTY(bool ticks READ ticks WRITE setTicks)
|
|
Q_PROPERTY(bool tickLabels READ tickLabels WRITE setTickLabels)
|
|
Q_PROPERTY(int tickLabelPadding READ tickLabelPadding WRITE setTickLabelPadding)
|
|
Q_PROPERTY(LabelType tickLabelType READ tickLabelType WRITE setTickLabelType)
|
|
Q_PROPERTY(QFont tickLabelFont READ tickLabelFont WRITE setTickLabelFont)
|
|
Q_PROPERTY(QColor tickLabelColor READ tickLabelColor WRITE setTickLabelColor)
|
|
Q_PROPERTY(double tickLabelRotation READ tickLabelRotation WRITE setTickLabelRotation)
|
|
Q_PROPERTY(LabelSide tickLabelSide READ tickLabelSide WRITE setTickLabelSide)
|
|
Q_PROPERTY(QString dateTimeFormat READ dateTimeFormat WRITE setDateTimeFormat)
|
|
Q_PROPERTY(Qt::TimeSpec dateTimeSpec READ dateTimeSpec WRITE setDateTimeSpec)
|
|
Q_PROPERTY(QString numberFormat READ numberFormat WRITE setNumberFormat)
|
|
Q_PROPERTY(int numberPrecision READ numberPrecision WRITE setNumberPrecision)
|
|
Q_PROPERTY(double tickStep READ tickStep WRITE setTickStep)
|
|
Q_PROPERTY(QVector<double> tickVector READ tickVector WRITE setTickVector)
|
|
Q_PROPERTY(QVector<QString> tickVectorLabels READ tickVectorLabels WRITE setTickVectorLabels)
|
|
Q_PROPERTY(int tickLengthIn READ tickLengthIn WRITE setTickLengthIn)
|
|
Q_PROPERTY(int tickLengthOut READ tickLengthOut WRITE setTickLengthOut)
|
|
Q_PROPERTY(int subTickCount READ subTickCount WRITE setSubTickCount)
|
|
Q_PROPERTY(int subTickLengthIn READ subTickLengthIn WRITE setSubTickLengthIn)
|
|
Q_PROPERTY(int subTickLengthOut READ subTickLengthOut WRITE setSubTickLengthOut)
|
|
Q_PROPERTY(QPen basePen READ basePen WRITE setBasePen)
|
|
Q_PROPERTY(QPen tickPen READ tickPen WRITE setTickPen)
|
|
Q_PROPERTY(QPen subTickPen READ subTickPen WRITE setSubTickPen)
|
|
Q_PROPERTY(QFont labelFont READ labelFont WRITE setLabelFont)
|
|
Q_PROPERTY(QColor labelColor READ labelColor WRITE setLabelColor)
|
|
Q_PROPERTY(QString label READ label WRITE setLabel)
|
|
Q_PROPERTY(int labelPadding READ labelPadding WRITE setLabelPadding)
|
|
Q_PROPERTY(int padding READ padding WRITE setPadding)
|
|
Q_PROPERTY(int offset READ offset WRITE setOffset)
|
|
Q_PROPERTY(SelectableParts selectedParts READ selectedParts WRITE setSelectedParts NOTIFY selectionChanged)
|
|
Q_PROPERTY(SelectableParts selectableParts READ selectableParts WRITE setSelectableParts NOTIFY selectableChanged)
|
|
Q_PROPERTY(QFont selectedTickLabelFont READ selectedTickLabelFont WRITE setSelectedTickLabelFont)
|
|
Q_PROPERTY(QFont selectedLabelFont READ selectedLabelFont WRITE setSelectedLabelFont)
|
|
Q_PROPERTY(QColor selectedTickLabelColor READ selectedTickLabelColor WRITE setSelectedTickLabelColor)
|
|
Q_PROPERTY(QColor selectedLabelColor READ selectedLabelColor WRITE setSelectedLabelColor)
|
|
Q_PROPERTY(QPen selectedBasePen READ selectedBasePen WRITE setSelectedBasePen)
|
|
Q_PROPERTY(QPen selectedTickPen READ selectedTickPen WRITE setSelectedTickPen)
|
|
Q_PROPERTY(QPen selectedSubTickPen READ selectedSubTickPen WRITE setSelectedSubTickPen)
|
|
Q_PROPERTY(QCPLineEnding lowerEnding READ lowerEnding WRITE setLowerEnding)
|
|
Q_PROPERTY(QCPLineEnding upperEnding READ upperEnding WRITE setUpperEnding)
|
|
Q_PROPERTY(QCPGrid* grid READ grid)
|
|
/// \endcond
|
|
public:
|
|
/*!
|
|
Defines at which side of the axis rect the axis will appear. This also affects how the tick
|
|
marks are drawn, on which side the labels are placed etc.
|
|
*/
|
|
enum AxisType { atLeft = 0x01 ///< <tt>0x01</tt> Axis is vertical and on the left side of the axis rect
|
|
,atRight = 0x02 ///< <tt>0x02</tt> Axis is vertical and on the right side of the axis rect
|
|
,atTop = 0x04 ///< <tt>0x04</tt> Axis is horizontal and on the top side of the axis rect
|
|
,atBottom = 0x08 ///< <tt>0x08</tt> Axis is horizontal and on the bottom side of the axis rect
|
|
};
|
|
Q_FLAGS(AxisType AxisTypes)
|
|
Q_DECLARE_FLAGS(AxisTypes, AxisType)
|
|
/*!
|
|
When automatic tick label generation is enabled (\ref setAutoTickLabels), defines how the
|
|
coordinate of the tick is interpreted, i.e. translated into a string.
|
|
|
|
\see setTickLabelType
|
|
*/
|
|
enum LabelType { ltNumber ///< Tick coordinate is regarded as normal number and will be displayed as such. (see \ref setNumberFormat)
|
|
,ltDateTime ///< Tick coordinate is regarded as a date/time (seconds since 1970-01-01T00:00:00 UTC) and will be displayed and formatted as such. (for details, see \ref setDateTimeFormat)
|
|
};
|
|
Q_ENUMS(LabelType)
|
|
/*!
|
|
Defines on which side of the axis the tick labels (numbers) shall appear.
|
|
|
|
\see setTickLabelSide
|
|
*/
|
|
enum LabelSide { lsInside ///< Tick labels will be displayed inside the axis rect and clipped to the inner axis rect
|
|
,lsOutside ///< Tick labels will be displayed outside the axis rect
|
|
};
|
|
Q_ENUMS(LabelSide)
|
|
/*!
|
|
Defines the scale of an axis.
|
|
\see setScaleType
|
|
*/
|
|
enum ScaleType { stLinear ///< Linear scaling
|
|
,stLogarithmic ///< Logarithmic scaling with correspondingly transformed plots and (major) tick marks at every base power (see \ref setScaleLogBase).
|
|
};
|
|
Q_ENUMS(ScaleType)
|
|
/*!
|
|
Defines the selectable parts of an axis.
|
|
\see setSelectableParts, setSelectedParts
|
|
*/
|
|
enum SelectablePart { spNone = 0 ///< None of the selectable parts
|
|
,spAxis = 0x001 ///< The axis backbone and tick marks
|
|
,spTickLabels = 0x002 ///< Tick labels (numbers) of this axis (as a whole, not individually)
|
|
,spAxisLabel = 0x004 ///< The axis label
|
|
};
|
|
Q_FLAGS(SelectablePart SelectableParts)
|
|
Q_DECLARE_FLAGS(SelectableParts, SelectablePart)
|
|
|
|
explicit QCPAxis(QCPAxisRect *parent, AxisType type);
|
|
virtual ~QCPAxis();
|
|
|
|
// getters:
|
|
AxisType axisType() const { return mAxisType; }
|
|
QCPAxisRect *axisRect() const { return mAxisRect; }
|
|
ScaleType scaleType() const { return mScaleType; }
|
|
double scaleLogBase() const { return mScaleLogBase; }
|
|
const QCPRange range() const { return mRange; }
|
|
bool rangeReversed() const { return mRangeReversed; }
|
|
bool autoTicks() const { return mAutoTicks; }
|
|
int autoTickCount() const { return mAutoTickCount; }
|
|
bool autoTickLabels() const { return mAutoTickLabels; }
|
|
bool autoTickStep() const { return mAutoTickStep; }
|
|
bool autoSubTicks() const { return mAutoSubTicks; }
|
|
bool ticks() const { return mTicks; }
|
|
bool tickLabels() const { return mTickLabels; }
|
|
int tickLabelPadding() const;
|
|
LabelType tickLabelType() const { return mTickLabelType; }
|
|
QFont tickLabelFont() const { return mTickLabelFont; }
|
|
QColor tickLabelColor() const { return mTickLabelColor; }
|
|
double tickLabelRotation() const;
|
|
LabelSide tickLabelSide() const;
|
|
QString dateTimeFormat() const { return mDateTimeFormat; }
|
|
Qt::TimeSpec dateTimeSpec() const { return mDateTimeSpec; }
|
|
QString numberFormat() const;
|
|
int numberPrecision() const { return mNumberPrecision; }
|
|
double tickStep() const { return mTickStep; }
|
|
QVector<double> tickVector() const { return mTickVector; }
|
|
QVector<QString> tickVectorLabels() const { return mTickVectorLabels; }
|
|
int tickLengthIn() const;
|
|
int tickLengthOut() const;
|
|
int subTickCount() const { return mSubTickCount; }
|
|
int subTickLengthIn() const;
|
|
int subTickLengthOut() const;
|
|
QPen basePen() const { return mBasePen; }
|
|
QPen tickPen() const { return mTickPen; }
|
|
QPen subTickPen() const { return mSubTickPen; }
|
|
QFont labelFont() const { return mLabelFont; }
|
|
QColor labelColor() const { return mLabelColor; }
|
|
QString label() const { return mLabel; }
|
|
int labelPadding() const;
|
|
int padding() const { return mPadding; }
|
|
int offset() const;
|
|
SelectableParts selectedParts() const { return mSelectedParts; }
|
|
SelectableParts selectableParts() const { return mSelectableParts; }
|
|
QFont selectedTickLabelFont() const { return mSelectedTickLabelFont; }
|
|
QFont selectedLabelFont() const { return mSelectedLabelFont; }
|
|
QColor selectedTickLabelColor() const { return mSelectedTickLabelColor; }
|
|
QColor selectedLabelColor() const { return mSelectedLabelColor; }
|
|
QPen selectedBasePen() const { return mSelectedBasePen; }
|
|
QPen selectedTickPen() const { return mSelectedTickPen; }
|
|
QPen selectedSubTickPen() const { return mSelectedSubTickPen; }
|
|
QCPLineEnding lowerEnding() const;
|
|
QCPLineEnding upperEnding() const;
|
|
QCPGrid *grid() const { return mGrid; }
|
|
|
|
// setters:
|
|
Q_SLOT void setScaleType(QCPAxis::ScaleType type);
|
|
void setScaleLogBase(double base);
|
|
Q_SLOT void setRange(const QCPRange &range);
|
|
void setRange(double lower, double upper);
|
|
void setRange(double position, double size, Qt::AlignmentFlag alignment);
|
|
void setRangeLower(double lower);
|
|
void setRangeUpper(double upper);
|
|
void setRangeReversed(bool reversed);
|
|
void setAutoTicks(bool on);
|
|
void setAutoTickCount(int approximateCount);
|
|
void setAutoTickLabels(bool on);
|
|
void setAutoTickStep(bool on);
|
|
void setAutoSubTicks(bool on);
|
|
void setTicks(bool show);
|
|
void setTickLabels(bool show);
|
|
void setTickLabelPadding(int padding);
|
|
void setTickLabelType(LabelType type);
|
|
void setTickLabelFont(const QFont &font);
|
|
void setTickLabelColor(const QColor &color);
|
|
void setTickLabelRotation(double degrees);
|
|
void setTickLabelSide(LabelSide side);
|
|
void setDateTimeFormat(const QString &format);
|
|
void setDateTimeSpec(const Qt::TimeSpec &timeSpec);
|
|
void setNumberFormat(const QString &formatCode);
|
|
void setNumberPrecision(int precision);
|
|
void setTickStep(double step);
|
|
void setTickVector(const QVector<double> &vec);
|
|
void setTickVectorLabels(const QVector<QString> &vec);
|
|
void setTickLength(int inside, int outside=0);
|
|
void setTickLengthIn(int inside);
|
|
void setTickLengthOut(int outside);
|
|
void setSubTickCount(int count);
|
|
void setSubTickLength(int inside, int outside=0);
|
|
void setSubTickLengthIn(int inside);
|
|
void setSubTickLengthOut(int outside);
|
|
void setBasePen(const QPen &pen);
|
|
void setTickPen(const QPen &pen);
|
|
void setSubTickPen(const QPen &pen);
|
|
void setLabelFont(const QFont &font);
|
|
void setLabelColor(const QColor &color);
|
|
void setLabel(const QString &str);
|
|
void setLabelPadding(int padding);
|
|
void setPadding(int padding);
|
|
void setOffset(int offset);
|
|
void setSelectedTickLabelFont(const QFont &font);
|
|
void setSelectedLabelFont(const QFont &font);
|
|
void setSelectedTickLabelColor(const QColor &color);
|
|
void setSelectedLabelColor(const QColor &color);
|
|
void setSelectedBasePen(const QPen &pen);
|
|
void setSelectedTickPen(const QPen &pen);
|
|
void setSelectedSubTickPen(const QPen &pen);
|
|
Q_SLOT void setSelectableParts(const QCPAxis::SelectableParts &selectableParts);
|
|
Q_SLOT void setSelectedParts(const QCPAxis::SelectableParts &selectedParts);
|
|
void setLowerEnding(const QCPLineEnding &ending);
|
|
void setUpperEnding(const QCPLineEnding &ending);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
// non-property methods:
|
|
Qt::Orientation orientation() const { return mOrientation; }
|
|
void moveRange(double diff);
|
|
void scaleRange(double factor, double center);
|
|
void setScaleRatio(const QCPAxis *otherAxis, double ratio=1.0);
|
|
void rescale(bool onlyVisiblePlottables=false);
|
|
double pixelToCoord(double value) const;
|
|
double coordToPixel(double value) const;
|
|
SelectablePart getPartAt(const QPointF &pos) const;
|
|
QList<QCPAbstractPlottable*> plottables() const;
|
|
QList<QCPGraph*> graphs() const;
|
|
QList<QCPAbstractItem*> items() const;
|
|
|
|
static AxisType marginSideToAxisType(QCP::MarginSide side);
|
|
static Qt::Orientation orientation(AxisType type) { return type==atBottom||type==atTop ? Qt::Horizontal : Qt::Vertical; }
|
|
static AxisType opposite(AxisType type);
|
|
|
|
signals:
|
|
void ticksRequest();
|
|
void rangeChanged(const QCPRange &newRange);
|
|
void rangeChanged(const QCPRange &newRange, const QCPRange &oldRange);
|
|
void scaleTypeChanged(QCPAxis::ScaleType scaleType);
|
|
void selectionChanged(const QCPAxis::SelectableParts &parts);
|
|
void selectableChanged(const QCPAxis::SelectableParts &parts);
|
|
|
|
protected:
|
|
// property members:
|
|
// axis base:
|
|
AxisType mAxisType;
|
|
QCPAxisRect *mAxisRect;
|
|
//int mOffset; // in QCPAxisPainter
|
|
int mPadding;
|
|
Qt::Orientation mOrientation;
|
|
SelectableParts mSelectableParts, mSelectedParts;
|
|
QPen mBasePen, mSelectedBasePen;
|
|
//QCPLineEnding mLowerEnding, mUpperEnding; // in QCPAxisPainter
|
|
// axis label:
|
|
//int mLabelPadding; // in QCPAxisPainter
|
|
QString mLabel;
|
|
QFont mLabelFont, mSelectedLabelFont;
|
|
QColor mLabelColor, mSelectedLabelColor;
|
|
// tick labels:
|
|
//int mTickLabelPadding; // in QCPAxisPainter
|
|
bool mTickLabels, mAutoTickLabels;
|
|
//double mTickLabelRotation; // in QCPAxisPainter
|
|
LabelType mTickLabelType;
|
|
QFont mTickLabelFont, mSelectedTickLabelFont;
|
|
QColor mTickLabelColor, mSelectedTickLabelColor;
|
|
QString mDateTimeFormat;
|
|
Qt::TimeSpec mDateTimeSpec;
|
|
int mNumberPrecision;
|
|
QLatin1Char mNumberFormatChar;
|
|
bool mNumberBeautifulPowers;
|
|
//bool mNumberMultiplyCross; // QCPAxisPainter
|
|
// ticks and subticks:
|
|
bool mTicks;
|
|
double mTickStep;
|
|
int mSubTickCount, mAutoTickCount;
|
|
bool mAutoTicks, mAutoTickStep, mAutoSubTicks;
|
|
//int mTickLengthIn, mTickLengthOut, mSubTickLengthIn, mSubTickLengthOut; // QCPAxisPainter
|
|
QPen mTickPen, mSelectedTickPen;
|
|
QPen mSubTickPen, mSelectedSubTickPen;
|
|
// scale and range:
|
|
QCPRange mRange;
|
|
bool mRangeReversed;
|
|
ScaleType mScaleType;
|
|
double mScaleLogBase, mScaleLogBaseLogInv;
|
|
|
|
// non-property members:
|
|
QCPGrid *mGrid;
|
|
QCPAxisPainterPrivate *mAxisPainter;
|
|
int mLowestVisibleTick, mHighestVisibleTick;
|
|
QVector<double> mTickVector;
|
|
QVector<QString> mTickVectorLabels;
|
|
QVector<double> mSubTickVector;
|
|
bool mCachedMarginValid;
|
|
int mCachedMargin;
|
|
|
|
// introduced virtual methods:
|
|
virtual void setupTickVectors();
|
|
virtual void generateAutoTicks();
|
|
virtual int calculateAutoSubTickCount(double tickStep) const;
|
|
virtual int calculateMargin();
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const;
|
|
virtual void draw(QCPPainter *painter);
|
|
virtual QCP::Interaction selectionCategory() const;
|
|
// events:
|
|
virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged);
|
|
virtual void deselectEvent(bool *selectionStateChanged);
|
|
|
|
// non-virtual methods:
|
|
void visibleTickBounds(int &lowIndex, int &highIndex) const;
|
|
double baseLog(double value) const;
|
|
double basePow(double value) const;
|
|
QPen getBasePen() const;
|
|
QPen getTickPen() const;
|
|
QPen getSubTickPen() const;
|
|
QFont getTickLabelFont() const;
|
|
QFont getLabelFont() const;
|
|
QColor getTickLabelColor() const;
|
|
QColor getLabelColor() const;
|
|
|
|
private:
|
|
Q_DISABLE_COPY(QCPAxis)
|
|
|
|
friend class QCustomPlot;
|
|
friend class QCPGrid;
|
|
friend class QCPAxisRect;
|
|
};
|
|
Q_DECLARE_OPERATORS_FOR_FLAGS(QCPAxis::SelectableParts)
|
|
Q_DECLARE_OPERATORS_FOR_FLAGS(QCPAxis::AxisTypes)
|
|
Q_DECLARE_METATYPE(QCPAxis::SelectablePart)
|
|
|
|
|
|
class QCPAxisPainterPrivate
|
|
{
|
|
public:
|
|
explicit QCPAxisPainterPrivate(QCustomPlot *parentPlot);
|
|
virtual ~QCPAxisPainterPrivate();
|
|
|
|
virtual void draw(QCPPainter *painter);
|
|
virtual int size() const;
|
|
void clearCache();
|
|
|
|
QRect axisSelectionBox() const { return mAxisSelectionBox; }
|
|
QRect tickLabelsSelectionBox() const { return mTickLabelsSelectionBox; }
|
|
QRect labelSelectionBox() const { return mLabelSelectionBox; }
|
|
|
|
// public property members:
|
|
QCPAxis::AxisType type;
|
|
QPen basePen;
|
|
QCPLineEnding lowerEnding, upperEnding; // directly accessed by QCPAxis setters/getters
|
|
int labelPadding; // directly accessed by QCPAxis setters/getters
|
|
QFont labelFont;
|
|
QColor labelColor;
|
|
QString label;
|
|
int tickLabelPadding; // directly accessed by QCPAxis setters/getters
|
|
double tickLabelRotation; // directly accessed by QCPAxis setters/getters
|
|
QCPAxis::LabelSide tickLabelSide; // directly accessed by QCPAxis setters/getters
|
|
bool substituteExponent;
|
|
bool numberMultiplyCross; // directly accessed by QCPAxis setters/getters
|
|
int tickLengthIn, tickLengthOut, subTickLengthIn, subTickLengthOut; // directly accessed by QCPAxis setters/getters
|
|
QPen tickPen, subTickPen;
|
|
QFont tickLabelFont;
|
|
QColor tickLabelColor;
|
|
QRect axisRect, viewportRect;
|
|
double offset; // directly accessed by QCPAxis setters/getters
|
|
bool abbreviateDecimalPowers;
|
|
bool reversedEndings;
|
|
|
|
QVector<double> subTickPositions;
|
|
QVector<double> tickPositions;
|
|
QVector<QString> tickLabels;
|
|
|
|
protected:
|
|
struct CachedLabel
|
|
{
|
|
QPointF offset;
|
|
QPixmap pixmap;
|
|
};
|
|
struct TickLabelData
|
|
{
|
|
QString basePart, expPart;
|
|
QRect baseBounds, expBounds, totalBounds, rotatedTotalBounds;
|
|
QFont baseFont, expFont;
|
|
};
|
|
QCustomPlot *mParentPlot;
|
|
QByteArray mLabelParameterHash; // to determine whether mLabelCache needs to be cleared due to changed parameters
|
|
QCache<QString, CachedLabel> mLabelCache;
|
|
QRect mAxisSelectionBox, mTickLabelsSelectionBox, mLabelSelectionBox;
|
|
|
|
virtual QByteArray generateLabelParameterHash() const;
|
|
|
|
virtual void placeTickLabel(QCPPainter *painter, double position, int distanceToAxis, const QString &text, QSize *tickLabelsSize);
|
|
virtual void drawTickLabel(QCPPainter *painter, double x, double y, const TickLabelData &labelData) const;
|
|
virtual TickLabelData getTickLabelData(const QFont &font, const QString &text) const;
|
|
virtual QPointF getTickLabelDrawOffset(const TickLabelData &labelData) const;
|
|
virtual void getMaxTickLabelSize(const QFont &font, const QString &text, QSize *tickLabelsSize) const;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPAbstractPlottable : public QCPLayerable
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(QString name READ name WRITE setName)
|
|
Q_PROPERTY(bool antialiasedFill READ antialiasedFill WRITE setAntialiasedFill)
|
|
Q_PROPERTY(bool antialiasedScatters READ antialiasedScatters WRITE setAntialiasedScatters)
|
|
Q_PROPERTY(bool antialiasedErrorBars READ antialiasedErrorBars WRITE setAntialiasedErrorBars)
|
|
Q_PROPERTY(QPen pen READ pen WRITE setPen)
|
|
Q_PROPERTY(QPen selectedPen READ selectedPen WRITE setSelectedPen)
|
|
Q_PROPERTY(QBrush brush READ brush WRITE setBrush)
|
|
Q_PROPERTY(QBrush selectedBrush READ selectedBrush WRITE setSelectedBrush)
|
|
Q_PROPERTY(QCPAxis* keyAxis READ keyAxis WRITE setKeyAxis)
|
|
Q_PROPERTY(QCPAxis* valueAxis READ valueAxis WRITE setValueAxis)
|
|
Q_PROPERTY(bool selectable READ selectable WRITE setSelectable NOTIFY selectableChanged)
|
|
Q_PROPERTY(bool selected READ selected WRITE setSelected NOTIFY selectionChanged)
|
|
/// \endcond
|
|
public:
|
|
QCPAbstractPlottable(QCPAxis *keyAxis, QCPAxis *valueAxis);
|
|
|
|
// getters:
|
|
QString name() const { return mName; }
|
|
bool antialiasedFill() const { return mAntialiasedFill; }
|
|
bool antialiasedScatters() const { return mAntialiasedScatters; }
|
|
bool antialiasedErrorBars() const { return mAntialiasedErrorBars; }
|
|
QPen pen() const { return mPen; }
|
|
QPen selectedPen() const { return mSelectedPen; }
|
|
QBrush brush() const { return mBrush; }
|
|
QBrush selectedBrush() const { return mSelectedBrush; }
|
|
QCPAxis *keyAxis() const { return mKeyAxis.data(); }
|
|
QCPAxis *valueAxis() const { return mValueAxis.data(); }
|
|
bool selectable() const { return mSelectable; }
|
|
bool selected() const { return mSelected; }
|
|
|
|
// setters:
|
|
void setName(const QString &name);
|
|
void setAntialiasedFill(bool enabled);
|
|
void setAntialiasedScatters(bool enabled);
|
|
void setAntialiasedErrorBars(bool enabled);
|
|
void setPen(const QPen &pen);
|
|
void setSelectedPen(const QPen &pen);
|
|
void setBrush(const QBrush &brush);
|
|
void setSelectedBrush(const QBrush &brush);
|
|
void setKeyAxis(QCPAxis *axis);
|
|
void setValueAxis(QCPAxis *axis);
|
|
Q_SLOT void setSelectable(bool selectable);
|
|
Q_SLOT void setSelected(bool selected);
|
|
|
|
// introduced virtual methods:
|
|
virtual void clearData() = 0;
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const = 0;
|
|
virtual bool addToLegend();
|
|
virtual bool removeFromLegend() const;
|
|
|
|
// non-property methods:
|
|
void rescaleAxes(bool onlyEnlarge=false) const;
|
|
void rescaleKeyAxis(bool onlyEnlarge=false) const;
|
|
void rescaleValueAxis(bool onlyEnlarge=false) const;
|
|
|
|
signals:
|
|
void selectionChanged(bool selected);
|
|
void selectableChanged(bool selectable);
|
|
|
|
protected:
|
|
/*!
|
|
Represents negative and positive sign domain for passing to \ref getKeyRange and \ref getValueRange.
|
|
*/
|
|
enum SignDomain { sdNegative ///< The negative sign domain, i.e. numbers smaller than zero
|
|
,sdBoth ///< Both sign domains, including zero, i.e. all (rational) numbers
|
|
,sdPositive ///< The positive sign domain, i.e. numbers greater than zero
|
|
};
|
|
|
|
// property members:
|
|
QString mName;
|
|
bool mAntialiasedFill, mAntialiasedScatters, mAntialiasedErrorBars;
|
|
QPen mPen, mSelectedPen;
|
|
QBrush mBrush, mSelectedBrush;
|
|
QPointer<QCPAxis> mKeyAxis, mValueAxis;
|
|
bool mSelectable, mSelected;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual QRect clipRect() const;
|
|
virtual void draw(QCPPainter *painter) = 0;
|
|
virtual QCP::Interaction selectionCategory() const;
|
|
void applyDefaultAntialiasingHint(QCPPainter *painter) const;
|
|
// events:
|
|
virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged);
|
|
virtual void deselectEvent(bool *selectionStateChanged);
|
|
|
|
// introduced virtual methods:
|
|
virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const = 0;
|
|
virtual QCPRange getKeyRange(bool &foundRange, SignDomain inSignDomain=sdBoth) const = 0;
|
|
virtual QCPRange getValueRange(bool &foundRange, SignDomain inSignDomain=sdBoth) const = 0;
|
|
|
|
// non-virtual methods:
|
|
void coordsToPixels(double key, double value, double &x, double &y) const;
|
|
const QPointF coordsToPixels(double key, double value) const;
|
|
void pixelsToCoords(double x, double y, double &key, double &value) const;
|
|
void pixelsToCoords(const QPointF &pixelPos, double &key, double &value) const;
|
|
QPen mainPen() const;
|
|
QBrush mainBrush() const;
|
|
void applyFillAntialiasingHint(QCPPainter *painter) const;
|
|
void applyScattersAntialiasingHint(QCPPainter *painter) const;
|
|
void applyErrorBarsAntialiasingHint(QCPPainter *painter) const;
|
|
double distSqrToLine(const QPointF &start, const QPointF &end, const QPointF &point) const;
|
|
|
|
private:
|
|
Q_DISABLE_COPY(QCPAbstractPlottable)
|
|
|
|
friend class QCustomPlot;
|
|
friend class QCPAxis;
|
|
friend class QCPPlottableLegendItem;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPItemAnchor
|
|
{
|
|
public:
|
|
QCPItemAnchor(QCustomPlot *parentPlot, QCPAbstractItem *parentItem, const QString name, int anchorId=-1);
|
|
virtual ~QCPItemAnchor();
|
|
|
|
// getters:
|
|
QString name() const { return mName; }
|
|
virtual QPointF pixelPoint() const;
|
|
|
|
protected:
|
|
// property members:
|
|
QString mName;
|
|
|
|
// non-property members:
|
|
QCustomPlot *mParentPlot;
|
|
QCPAbstractItem *mParentItem;
|
|
int mAnchorId;
|
|
QSet<QCPItemPosition*> mChildrenX, mChildrenY;
|
|
|
|
// introduced virtual methods:
|
|
virtual QCPItemPosition *toQCPItemPosition() { return 0; }
|
|
|
|
// non-virtual methods:
|
|
void addChildX(QCPItemPosition* pos); // called from pos when this anchor is set as parent
|
|
void removeChildX(QCPItemPosition *pos); // called from pos when its parent anchor is reset or pos deleted
|
|
void addChildY(QCPItemPosition* pos); // called from pos when this anchor is set as parent
|
|
void removeChildY(QCPItemPosition *pos); // called from pos when its parent anchor is reset or pos deleted
|
|
|
|
private:
|
|
Q_DISABLE_COPY(QCPItemAnchor)
|
|
|
|
friend class QCPItemPosition;
|
|
};
|
|
|
|
|
|
|
|
class QCP_LIB_DECL QCPItemPosition : public QCPItemAnchor
|
|
{
|
|
public:
|
|
/*!
|
|
Defines the ways an item position can be specified. Thus it defines what the numbers passed to
|
|
\ref setCoords actually mean.
|
|
|
|
\see setType
|
|
*/
|
|
enum PositionType { ptAbsolute ///< Static positioning in pixels, starting from the top left corner of the viewport/widget.
|
|
,ptViewportRatio ///< Static positioning given by a fraction of the viewport size. For example, if you call setCoords(0, 0), the position will be at the top
|
|
///< left corner of the viewport/widget. setCoords(1, 1) will be at the bottom right corner, setCoords(0.5, 0) will be horizontally centered and
|
|
///< vertically at the top of the viewport/widget, etc.
|
|
,ptAxisRectRatio ///< Static positioning given by a fraction of the axis rect size (see \ref setAxisRect). For example, if you call setCoords(0, 0), the position will be at the top
|
|
///< left corner of the axis rect. setCoords(1, 1) will be at the bottom right corner, setCoords(0.5, 0) will be horizontally centered and
|
|
///< vertically at the top of the axis rect, etc. You can also go beyond the axis rect by providing negative coordinates or coordinates larger than 1.
|
|
,ptPlotCoords ///< Dynamic positioning at a plot coordinate defined by two axes (see \ref setAxes).
|
|
};
|
|
|
|
QCPItemPosition(QCustomPlot *parentPlot, QCPAbstractItem *parentItem, const QString name);
|
|
virtual ~QCPItemPosition();
|
|
|
|
// getters:
|
|
PositionType type() const { return typeX(); }
|
|
PositionType typeX() const { return mPositionTypeX; }
|
|
PositionType typeY() const { return mPositionTypeY; }
|
|
QCPItemAnchor *parentAnchor() const { return parentAnchorX(); }
|
|
QCPItemAnchor *parentAnchorX() const { return mParentAnchorX; }
|
|
QCPItemAnchor *parentAnchorY() const { return mParentAnchorY; }
|
|
double key() const { return mKey; }
|
|
double value() const { return mValue; }
|
|
QPointF coords() const { return QPointF(mKey, mValue); }
|
|
QCPAxis *keyAxis() const { return mKeyAxis.data(); }
|
|
QCPAxis *valueAxis() const { return mValueAxis.data(); }
|
|
QCPAxisRect *axisRect() const;
|
|
virtual QPointF pixelPoint() const;
|
|
|
|
// setters:
|
|
void setType(PositionType type);
|
|
void setTypeX(PositionType type);
|
|
void setTypeY(PositionType type);
|
|
bool setParentAnchor(QCPItemAnchor *parentAnchor, bool keepPixelPosition=false);
|
|
bool setParentAnchorX(QCPItemAnchor *parentAnchor, bool keepPixelPosition=false);
|
|
bool setParentAnchorY(QCPItemAnchor *parentAnchor, bool keepPixelPosition=false);
|
|
void setCoords(double key, double value);
|
|
void setCoords(const QPointF &coords);
|
|
void setAxes(QCPAxis* keyAxis, QCPAxis* valueAxis);
|
|
void setAxisRect(QCPAxisRect *axisRect);
|
|
void setPixelPoint(const QPointF &pixelPoint);
|
|
|
|
protected:
|
|
// property members:
|
|
PositionType mPositionTypeX, mPositionTypeY;
|
|
QPointer<QCPAxis> mKeyAxis, mValueAxis;
|
|
QPointer<QCPAxisRect> mAxisRect;
|
|
double mKey, mValue;
|
|
QCPItemAnchor *mParentAnchorX, *mParentAnchorY;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual QCPItemPosition *toQCPItemPosition() { return this; }
|
|
|
|
private:
|
|
Q_DISABLE_COPY(QCPItemPosition)
|
|
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPAbstractItem : public QCPLayerable
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(bool clipToAxisRect READ clipToAxisRect WRITE setClipToAxisRect)
|
|
Q_PROPERTY(QCPAxisRect* clipAxisRect READ clipAxisRect WRITE setClipAxisRect)
|
|
Q_PROPERTY(bool selectable READ selectable WRITE setSelectable NOTIFY selectableChanged)
|
|
Q_PROPERTY(bool selected READ selected WRITE setSelected NOTIFY selectionChanged)
|
|
/// \endcond
|
|
public:
|
|
QCPAbstractItem(QCustomPlot *parentPlot);
|
|
virtual ~QCPAbstractItem();
|
|
|
|
// getters:
|
|
bool clipToAxisRect() const { return mClipToAxisRect; }
|
|
QCPAxisRect *clipAxisRect() const;
|
|
bool selectable() const { return mSelectable; }
|
|
bool selected() const { return mSelected; }
|
|
|
|
// setters:
|
|
void setClipToAxisRect(bool clip);
|
|
void setClipAxisRect(QCPAxisRect *rect);
|
|
Q_SLOT void setSelectable(bool selectable);
|
|
Q_SLOT void setSelected(bool selected);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const = 0;
|
|
|
|
// non-virtual methods:
|
|
QList<QCPItemPosition*> positions() const { return mPositions; }
|
|
QList<QCPItemAnchor*> anchors() const { return mAnchors; }
|
|
QCPItemPosition *position(const QString &name) const;
|
|
QCPItemAnchor *anchor(const QString &name) const;
|
|
bool hasAnchor(const QString &name) const;
|
|
|
|
signals:
|
|
void selectionChanged(bool selected);
|
|
void selectableChanged(bool selectable);
|
|
|
|
protected:
|
|
// property members:
|
|
bool mClipToAxisRect;
|
|
QPointer<QCPAxisRect> mClipAxisRect;
|
|
QList<QCPItemPosition*> mPositions;
|
|
QList<QCPItemAnchor*> mAnchors;
|
|
bool mSelectable, mSelected;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual QCP::Interaction selectionCategory() const;
|
|
virtual QRect clipRect() const;
|
|
virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const;
|
|
virtual void draw(QCPPainter *painter) = 0;
|
|
// events:
|
|
virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged);
|
|
virtual void deselectEvent(bool *selectionStateChanged);
|
|
|
|
// introduced virtual methods:
|
|
virtual QPointF anchorPixelPoint(int anchorId) const;
|
|
|
|
// non-virtual methods:
|
|
double distSqrToLine(const QPointF &start, const QPointF &end, const QPointF &point) const;
|
|
double rectSelectTest(const QRectF &rect, const QPointF &pos, bool filledRect) const;
|
|
QCPItemPosition *createPosition(const QString &name);
|
|
QCPItemAnchor *createAnchor(const QString &name, int anchorId);
|
|
|
|
private:
|
|
Q_DISABLE_COPY(QCPAbstractItem)
|
|
|
|
friend class QCustomPlot;
|
|
friend class QCPItemAnchor;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCustomPlot : public QWidget
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(QRect viewport READ viewport WRITE setViewport)
|
|
Q_PROPERTY(QPixmap background READ background WRITE setBackground)
|
|
Q_PROPERTY(bool backgroundScaled READ backgroundScaled WRITE setBackgroundScaled)
|
|
Q_PROPERTY(Qt::AspectRatioMode backgroundScaledMode READ backgroundScaledMode WRITE setBackgroundScaledMode)
|
|
Q_PROPERTY(QCPLayoutGrid* plotLayout READ plotLayout)
|
|
Q_PROPERTY(bool autoAddPlottableToLegend READ autoAddPlottableToLegend WRITE setAutoAddPlottableToLegend)
|
|
Q_PROPERTY(int selectionTolerance READ selectionTolerance WRITE setSelectionTolerance)
|
|
Q_PROPERTY(bool noAntialiasingOnDrag READ noAntialiasingOnDrag WRITE setNoAntialiasingOnDrag)
|
|
Q_PROPERTY(Qt::KeyboardModifier multiSelectModifier READ multiSelectModifier WRITE setMultiSelectModifier)
|
|
/// \endcond
|
|
public:
|
|
/*!
|
|
Defines how a layer should be inserted relative to an other layer.
|
|
|
|
\see addLayer, moveLayer
|
|
*/
|
|
enum LayerInsertMode { limBelow ///< Layer is inserted below other layer
|
|
,limAbove ///< Layer is inserted above other layer
|
|
};
|
|
Q_ENUMS(LayerInsertMode)
|
|
|
|
/*!
|
|
Defines with what timing the QCustomPlot surface is refreshed after a replot.
|
|
|
|
\see replot
|
|
*/
|
|
enum RefreshPriority { rpImmediate ///< The QCustomPlot surface is immediately refreshed, by calling QWidget::repaint() after the replot
|
|
,rpQueued ///< Queues the refresh such that it is performed at a slightly delayed point in time after the replot, by calling QWidget::update() after the replot
|
|
,rpHint ///< Whether to use immediate repaint or queued update depends on whether the plotting hint \ref QCP::phForceRepaint is set, see \ref setPlottingHints.
|
|
};
|
|
|
|
explicit QCustomPlot(QWidget *parent = 0);
|
|
virtual ~QCustomPlot();
|
|
|
|
// getters:
|
|
QRect viewport() const { return mViewport; }
|
|
QPixmap background() const { return mBackgroundPixmap; }
|
|
bool backgroundScaled() const { return mBackgroundScaled; }
|
|
Qt::AspectRatioMode backgroundScaledMode() const { return mBackgroundScaledMode; }
|
|
QCPLayoutGrid *plotLayout() const { return mPlotLayout; }
|
|
QCP::AntialiasedElements antialiasedElements() const { return mAntialiasedElements; }
|
|
QCP::AntialiasedElements notAntialiasedElements() const { return mNotAntialiasedElements; }
|
|
bool autoAddPlottableToLegend() const { return mAutoAddPlottableToLegend; }
|
|
const QCP::Interactions interactions() const { return mInteractions; }
|
|
int selectionTolerance() const { return mSelectionTolerance; }
|
|
bool noAntialiasingOnDrag() const { return mNoAntialiasingOnDrag; }
|
|
QCP::PlottingHints plottingHints() const { return mPlottingHints; }
|
|
Qt::KeyboardModifier multiSelectModifier() const { return mMultiSelectModifier; }
|
|
|
|
// setters:
|
|
void setViewport(const QRect &rect);
|
|
void setBackground(const QPixmap &pm);
|
|
void setBackground(const QPixmap &pm, bool scaled, Qt::AspectRatioMode mode=Qt::KeepAspectRatioByExpanding);
|
|
void setBackground(const QBrush &brush);
|
|
void setBackgroundScaled(bool scaled);
|
|
void setBackgroundScaledMode(Qt::AspectRatioMode mode);
|
|
void setAntialiasedElements(const QCP::AntialiasedElements &antialiasedElements);
|
|
void setAntialiasedElement(QCP::AntialiasedElement antialiasedElement, bool enabled=true);
|
|
void setNotAntialiasedElements(const QCP::AntialiasedElements ¬AntialiasedElements);
|
|
void setNotAntialiasedElement(QCP::AntialiasedElement notAntialiasedElement, bool enabled=true);
|
|
void setAutoAddPlottableToLegend(bool on);
|
|
void setInteractions(const QCP::Interactions &interactions);
|
|
void setInteraction(const QCP::Interaction &interaction, bool enabled=true);
|
|
void setSelectionTolerance(int pixels);
|
|
void setNoAntialiasingOnDrag(bool enabled);
|
|
void setPlottingHints(const QCP::PlottingHints &hints);
|
|
void setPlottingHint(QCP::PlottingHint hint, bool enabled=true);
|
|
void setMultiSelectModifier(Qt::KeyboardModifier modifier);
|
|
|
|
// non-property methods:
|
|
// plottable interface:
|
|
QCPAbstractPlottable *plottable(int index);
|
|
QCPAbstractPlottable *plottable();
|
|
bool addPlottable(QCPAbstractPlottable *plottable);
|
|
bool removePlottable(QCPAbstractPlottable *plottable);
|
|
bool removePlottable(int index);
|
|
int clearPlottables();
|
|
int plottableCount() const;
|
|
QList<QCPAbstractPlottable*> selectedPlottables() const;
|
|
QCPAbstractPlottable *plottableAt(const QPointF &pos, bool onlySelectable=false) const;
|
|
bool hasPlottable(QCPAbstractPlottable *plottable) const;
|
|
|
|
// specialized interface for QCPGraph:
|
|
QCPGraph *graph(int index) const;
|
|
QCPGraph *graph() const;
|
|
QCPGraph *addGraph(QCPAxis *keyAxis=0, QCPAxis *valueAxis=0);
|
|
bool removeGraph(QCPGraph *graph);
|
|
bool removeGraph(int index);
|
|
int clearGraphs();
|
|
int graphCount() const;
|
|
QList<QCPGraph*> selectedGraphs() const;
|
|
|
|
// item interface:
|
|
QCPAbstractItem *item(int index) const;
|
|
QCPAbstractItem *item() const;
|
|
bool addItem(QCPAbstractItem* item);
|
|
bool removeItem(QCPAbstractItem *item);
|
|
bool removeItem(int index);
|
|
int clearItems();
|
|
int itemCount() const;
|
|
QList<QCPAbstractItem*> selectedItems() const;
|
|
QCPAbstractItem *itemAt(const QPointF &pos, bool onlySelectable=false) const;
|
|
bool hasItem(QCPAbstractItem *item) const;
|
|
|
|
// layer interface:
|
|
QCPLayer *layer(const QString &name) const;
|
|
QCPLayer *layer(int index) const;
|
|
QCPLayer *currentLayer() const;
|
|
bool setCurrentLayer(const QString &name);
|
|
bool setCurrentLayer(QCPLayer *layer);
|
|
int layerCount() const;
|
|
bool addLayer(const QString &name, QCPLayer *otherLayer=0, LayerInsertMode insertMode=limAbove);
|
|
bool removeLayer(QCPLayer *layer);
|
|
bool moveLayer(QCPLayer *layer, QCPLayer *otherLayer, LayerInsertMode insertMode=limAbove);
|
|
|
|
// axis rect/layout interface:
|
|
int axisRectCount() const;
|
|
QCPAxisRect* axisRect(int index=0) const;
|
|
QList<QCPAxisRect*> axisRects() const;
|
|
QCPLayoutElement* layoutElementAt(const QPointF &pos) const;
|
|
Q_SLOT void rescaleAxes(bool onlyVisiblePlottables=false);
|
|
|
|
QList<QCPAxis*> selectedAxes() const;
|
|
QList<QCPLegend*> selectedLegends() const;
|
|
Q_SLOT void deselectAll();
|
|
|
|
bool savePdf(const QString &fileName, bool noCosmeticPen=false, int width=0, int height=0, const QString &pdfCreator=QString(), const QString &pdfTitle=QString());
|
|
bool savePng(const QString &fileName, int width=0, int height=0, double scale=1.0, int quality=-1);
|
|
bool saveJpg(const QString &fileName, int width=0, int height=0, double scale=1.0, int quality=-1);
|
|
bool saveBmp(const QString &fileName, int width=0, int height=0, double scale=1.0);
|
|
bool saveRastered(const QString &fileName, int width, int height, double scale, const char *format, int quality=-1);
|
|
QPixmap toPixmap(int width=0, int height=0, double scale=1.0);
|
|
void toPainter(QCPPainter *painter, int width=0, int height=0);
|
|
Q_SLOT void replot(QCustomPlot::RefreshPriority refreshPriority=QCustomPlot::rpHint);
|
|
|
|
QCPAxis *xAxis, *yAxis, *xAxis2, *yAxis2;
|
|
QCPLegend *legend;
|
|
|
|
signals:
|
|
void mouseDoubleClick(QMouseEvent *event);
|
|
void mousePress(QMouseEvent *event);
|
|
void mouseMove(QMouseEvent *event);
|
|
void mouseRelease(QMouseEvent *event);
|
|
void mouseWheel(QWheelEvent *event);
|
|
|
|
void plottableClick(QCPAbstractPlottable *plottable, QMouseEvent *event);
|
|
void plottableDoubleClick(QCPAbstractPlottable *plottable, QMouseEvent *event);
|
|
void itemClick(QCPAbstractItem *item, QMouseEvent *event);
|
|
void itemDoubleClick(QCPAbstractItem *item, QMouseEvent *event);
|
|
void axisClick(QCPAxis *axis, QCPAxis::SelectablePart part, QMouseEvent *event);
|
|
void axisDoubleClick(QCPAxis *axis, QCPAxis::SelectablePart part, QMouseEvent *event);
|
|
void legendClick(QCPLegend *legend, QCPAbstractLegendItem *item, QMouseEvent *event);
|
|
void legendDoubleClick(QCPLegend *legend, QCPAbstractLegendItem *item, QMouseEvent *event);
|
|
void titleClick(QMouseEvent *event, QCPPlotTitle *title);
|
|
void titleDoubleClick(QMouseEvent *event, QCPPlotTitle *title);
|
|
|
|
void selectionChangedByUser();
|
|
void beforeReplot();
|
|
void afterReplot();
|
|
|
|
protected:
|
|
// property members:
|
|
QRect mViewport;
|
|
QCPLayoutGrid *mPlotLayout;
|
|
bool mAutoAddPlottableToLegend;
|
|
QList<QCPAbstractPlottable*> mPlottables;
|
|
QList<QCPGraph*> mGraphs; // extra list of plottables also in mPlottables that are of type QCPGraph
|
|
QList<QCPAbstractItem*> mItems;
|
|
QList<QCPLayer*> mLayers;
|
|
QCP::AntialiasedElements mAntialiasedElements, mNotAntialiasedElements;
|
|
QCP::Interactions mInteractions;
|
|
int mSelectionTolerance;
|
|
bool mNoAntialiasingOnDrag;
|
|
QBrush mBackgroundBrush;
|
|
QPixmap mBackgroundPixmap;
|
|
QPixmap mScaledBackgroundPixmap;
|
|
bool mBackgroundScaled;
|
|
Qt::AspectRatioMode mBackgroundScaledMode;
|
|
QCPLayer *mCurrentLayer;
|
|
QCP::PlottingHints mPlottingHints;
|
|
Qt::KeyboardModifier mMultiSelectModifier;
|
|
|
|
// non-property members:
|
|
QPixmap mPaintBuffer;
|
|
QPoint mMousePressPos;
|
|
QPointer<QCPLayoutElement> mMouseEventElement;
|
|
bool mReplotting;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual QSize minimumSizeHint() const;
|
|
virtual QSize sizeHint() const;
|
|
virtual void paintEvent(QPaintEvent *event);
|
|
virtual void resizeEvent(QResizeEvent *event);
|
|
virtual void mouseDoubleClickEvent(QMouseEvent *event);
|
|
virtual void mousePressEvent(QMouseEvent *event);
|
|
virtual void mouseMoveEvent(QMouseEvent *event);
|
|
virtual void mouseReleaseEvent(QMouseEvent *event);
|
|
virtual void wheelEvent(QWheelEvent *event);
|
|
|
|
// introduced virtual methods:
|
|
virtual void draw(QCPPainter *painter);
|
|
virtual void axisRemoved(QCPAxis *axis);
|
|
virtual void legendRemoved(QCPLegend *legend);
|
|
|
|
// non-virtual methods:
|
|
void updateLayerIndices() const;
|
|
QCPLayerable *layerableAt(const QPointF &pos, bool onlySelectable, QVariant *selectionDetails=0) const;
|
|
void drawBackground(QCPPainter *painter);
|
|
|
|
friend class QCPLegend;
|
|
friend class QCPAxis;
|
|
friend class QCPLayer;
|
|
friend class QCPAxisRect;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPColorGradient
|
|
{
|
|
Q_GADGET
|
|
public:
|
|
/*!
|
|
Defines the color spaces in which color interpolation between gradient stops can be performed.
|
|
|
|
\see setColorInterpolation
|
|
*/
|
|
enum ColorInterpolation { ciRGB ///< Color channels red, green and blue are linearly interpolated
|
|
,ciHSV ///< Color channels hue, saturation and value are linearly interpolated (The hue is interpolated over the shortest angle distance)
|
|
};
|
|
Q_ENUMS(ColorInterpolation)
|
|
|
|
/*!
|
|
Defines the available presets that can be loaded with \ref loadPreset. See the documentation
|
|
there for an image of the presets.
|
|
*/
|
|
enum GradientPreset { gpGrayscale ///< Continuous lightness from black to white (suited for non-biased data representation)
|
|
,gpHot ///< Continuous lightness from black over firey colors to white (suited for non-biased data representation)
|
|
,gpCold ///< Continuous lightness from black over icey colors to white (suited for non-biased data representation)
|
|
,gpNight ///< Continuous lightness from black over weak blueish colors to white (suited for non-biased data representation)
|
|
,gpCandy ///< Blue over pink to white
|
|
,gpGeography ///< Colors suitable to represent different elevations on geographical maps
|
|
,gpIon ///< Half hue spectrum from black over purple to blue and finally green (creates banding illusion but allows more precise magnitude estimates)
|
|
,gpThermal ///< Colors suitable for thermal imaging, ranging from dark blue over purple to orange, yellow and white
|
|
,gpPolar ///< Colors suitable to emphasize polarity around the center, with blue for negative, black in the middle and red for positive values
|
|
,gpSpectrum ///< An approximation of the visible light spectrum (creates banding illusion but allows more precise magnitude estimates)
|
|
,gpJet ///< Hue variation similar to a spectrum, often used in numerical visualization (creates banding illusion but allows more precise magnitude estimates)
|
|
,gpHues ///< Full hue cycle, with highest and lowest color red (suitable for periodic data, such as angles and phases, see \ref setPeriodic)
|
|
};
|
|
Q_ENUMS(GradientPreset)
|
|
|
|
QCPColorGradient(GradientPreset preset=gpCold);
|
|
bool operator==(const QCPColorGradient &other) const;
|
|
bool operator!=(const QCPColorGradient &other) const { return !(*this == other); }
|
|
|
|
// getters:
|
|
int levelCount() const { return mLevelCount; }
|
|
QMap<double, QColor> colorStops() const { return mColorStops; }
|
|
ColorInterpolation colorInterpolation() const { return mColorInterpolation; }
|
|
bool periodic() const { return mPeriodic; }
|
|
|
|
// setters:
|
|
void setLevelCount(int n);
|
|
void setColorStops(const QMap<double, QColor> &colorStops);
|
|
void setColorStopAt(double position, const QColor &color);
|
|
void setColorInterpolation(ColorInterpolation interpolation);
|
|
void setPeriodic(bool enabled);
|
|
|
|
// non-property methods:
|
|
void colorize(const double *data, const QCPRange &range, QRgb *scanLine, int n, int dataIndexFactor=1, bool logarithmic=false);
|
|
QRgb color(double position, const QCPRange &range, bool logarithmic=false);
|
|
void loadPreset(GradientPreset preset);
|
|
void clearColorStops();
|
|
QCPColorGradient inverted() const;
|
|
|
|
protected:
|
|
void updateColorBuffer();
|
|
|
|
// property members:
|
|
int mLevelCount;
|
|
QMap<double, QColor> mColorStops;
|
|
ColorInterpolation mColorInterpolation;
|
|
bool mPeriodic;
|
|
|
|
// non-property members:
|
|
QVector<QRgb> mColorBuffer;
|
|
bool mColorBufferInvalidated;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPAxisRect : public QCPLayoutElement
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(QPixmap background READ background WRITE setBackground)
|
|
Q_PROPERTY(bool backgroundScaled READ backgroundScaled WRITE setBackgroundScaled)
|
|
Q_PROPERTY(Qt::AspectRatioMode backgroundScaledMode READ backgroundScaledMode WRITE setBackgroundScaledMode)
|
|
Q_PROPERTY(Qt::Orientations rangeDrag READ rangeDrag WRITE setRangeDrag)
|
|
Q_PROPERTY(Qt::Orientations rangeZoom READ rangeZoom WRITE setRangeZoom)
|
|
/// \endcond
|
|
public:
|
|
explicit QCPAxisRect(QCustomPlot *parentPlot, bool setupDefaultAxes=true);
|
|
virtual ~QCPAxisRect();
|
|
|
|
// getters:
|
|
QPixmap background() const { return mBackgroundPixmap; }
|
|
bool backgroundScaled() const { return mBackgroundScaled; }
|
|
Qt::AspectRatioMode backgroundScaledMode() const { return mBackgroundScaledMode; }
|
|
Qt::Orientations rangeDrag() const { return mRangeDrag; }
|
|
Qt::Orientations rangeZoom() const { return mRangeZoom; }
|
|
QCPAxis *rangeDragAxis(Qt::Orientation orientation);
|
|
QCPAxis *rangeZoomAxis(Qt::Orientation orientation);
|
|
double rangeZoomFactor(Qt::Orientation orientation);
|
|
|
|
// setters:
|
|
void setBackground(const QPixmap &pm);
|
|
void setBackground(const QPixmap &pm, bool scaled, Qt::AspectRatioMode mode=Qt::KeepAspectRatioByExpanding);
|
|
void setBackground(const QBrush &brush);
|
|
void setBackgroundScaled(bool scaled);
|
|
void setBackgroundScaledMode(Qt::AspectRatioMode mode);
|
|
void setRangeDrag(Qt::Orientations orientations);
|
|
void setRangeZoom(Qt::Orientations orientations);
|
|
void setRangeDragAxes(QCPAxis *horizontal, QCPAxis *vertical);
|
|
void setRangeZoomAxes(QCPAxis *horizontal, QCPAxis *vertical);
|
|
void setRangeZoomFactor(double horizontalFactor, double verticalFactor);
|
|
void setRangeZoomFactor(double factor);
|
|
|
|
// non-property methods:
|
|
int axisCount(QCPAxis::AxisType type) const;
|
|
QCPAxis *axis(QCPAxis::AxisType type, int index=0) const;
|
|
QList<QCPAxis*> axes(QCPAxis::AxisTypes types) const;
|
|
QList<QCPAxis*> axes() const;
|
|
QCPAxis *addAxis(QCPAxis::AxisType type, QCPAxis *axis=0);
|
|
QList<QCPAxis*> addAxes(QCPAxis::AxisTypes types);
|
|
bool removeAxis(QCPAxis *axis);
|
|
QCPLayoutInset *insetLayout() const { return mInsetLayout; }
|
|
|
|
void setupFullAxesBox(bool connectRanges=false);
|
|
QList<QCPAbstractPlottable*> plottables() const;
|
|
QList<QCPGraph*> graphs() const;
|
|
QList<QCPAbstractItem*> items() const;
|
|
|
|
// read-only interface imitating a QRect:
|
|
int left() const { return mRect.left(); }
|
|
int right() const { return mRect.right(); }
|
|
int top() const { return mRect.top(); }
|
|
int bottom() const { return mRect.bottom(); }
|
|
int width() const { return mRect.width(); }
|
|
int height() const { return mRect.height(); }
|
|
QSize size() const { return mRect.size(); }
|
|
QPoint topLeft() const { return mRect.topLeft(); }
|
|
QPoint topRight() const { return mRect.topRight(); }
|
|
QPoint bottomLeft() const { return mRect.bottomLeft(); }
|
|
QPoint bottomRight() const { return mRect.bottomRight(); }
|
|
QPoint center() const { return mRect.center(); }
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void update(UpdatePhase phase);
|
|
virtual QList<QCPLayoutElement*> elements(bool recursive) const;
|
|
|
|
protected:
|
|
// property members:
|
|
QBrush mBackgroundBrush;
|
|
QPixmap mBackgroundPixmap;
|
|
QPixmap mScaledBackgroundPixmap;
|
|
bool mBackgroundScaled;
|
|
Qt::AspectRatioMode mBackgroundScaledMode;
|
|
QCPLayoutInset *mInsetLayout;
|
|
Qt::Orientations mRangeDrag, mRangeZoom;
|
|
QPointer<QCPAxis> mRangeDragHorzAxis, mRangeDragVertAxis, mRangeZoomHorzAxis, mRangeZoomVertAxis;
|
|
double mRangeZoomFactorHorz, mRangeZoomFactorVert;
|
|
// non-property members:
|
|
QCPRange mDragStartHorzRange, mDragStartVertRange;
|
|
QCP::AntialiasedElements mAADragBackup, mNotAADragBackup;
|
|
QPoint mDragStart;
|
|
bool mDragging;
|
|
QHash<QCPAxis::AxisType, QList<QCPAxis*> > mAxes;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const;
|
|
virtual void draw(QCPPainter *painter);
|
|
virtual int calculateAutoMargin(QCP::MarginSide side);
|
|
// events:
|
|
virtual void mousePressEvent(QMouseEvent *event);
|
|
virtual void mouseMoveEvent(QMouseEvent *event);
|
|
virtual void mouseReleaseEvent(QMouseEvent *event);
|
|
virtual void wheelEvent(QWheelEvent *event);
|
|
|
|
// non-property methods:
|
|
void drawBackground(QCPPainter *painter);
|
|
void updateAxesOffset(QCPAxis::AxisType type);
|
|
|
|
private:
|
|
Q_DISABLE_COPY(QCPAxisRect)
|
|
|
|
friend class QCustomPlot;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPAbstractLegendItem : public QCPLayoutElement
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(QCPLegend* parentLegend READ parentLegend)
|
|
Q_PROPERTY(QFont font READ font WRITE setFont)
|
|
Q_PROPERTY(QColor textColor READ textColor WRITE setTextColor)
|
|
Q_PROPERTY(QFont selectedFont READ selectedFont WRITE setSelectedFont)
|
|
Q_PROPERTY(QColor selectedTextColor READ selectedTextColor WRITE setSelectedTextColor)
|
|
Q_PROPERTY(bool selectable READ selectable WRITE setSelectable NOTIFY selectionChanged)
|
|
Q_PROPERTY(bool selected READ selected WRITE setSelected NOTIFY selectableChanged)
|
|
/// \endcond
|
|
public:
|
|
explicit QCPAbstractLegendItem(QCPLegend *parent);
|
|
|
|
// getters:
|
|
QCPLegend *parentLegend() const { return mParentLegend; }
|
|
QFont font() const { return mFont; }
|
|
QColor textColor() const { return mTextColor; }
|
|
QFont selectedFont() const { return mSelectedFont; }
|
|
QColor selectedTextColor() const { return mSelectedTextColor; }
|
|
bool selectable() const { return mSelectable; }
|
|
bool selected() const { return mSelected; }
|
|
|
|
// setters:
|
|
void setFont(const QFont &font);
|
|
void setTextColor(const QColor &color);
|
|
void setSelectedFont(const QFont &font);
|
|
void setSelectedTextColor(const QColor &color);
|
|
Q_SLOT void setSelectable(bool selectable);
|
|
Q_SLOT void setSelected(bool selected);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
signals:
|
|
void selectionChanged(bool selected);
|
|
void selectableChanged(bool selectable);
|
|
|
|
protected:
|
|
// property members:
|
|
QCPLegend *mParentLegend;
|
|
QFont mFont;
|
|
QColor mTextColor;
|
|
QFont mSelectedFont;
|
|
QColor mSelectedTextColor;
|
|
bool mSelectable, mSelected;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual QCP::Interaction selectionCategory() const;
|
|
virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const;
|
|
virtual QRect clipRect() const;
|
|
virtual void draw(QCPPainter *painter) = 0;
|
|
// events:
|
|
virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged);
|
|
virtual void deselectEvent(bool *selectionStateChanged);
|
|
|
|
private:
|
|
Q_DISABLE_COPY(QCPAbstractLegendItem)
|
|
|
|
friend class QCPLegend;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPPlottableLegendItem : public QCPAbstractLegendItem
|
|
{
|
|
Q_OBJECT
|
|
public:
|
|
QCPPlottableLegendItem(QCPLegend *parent, QCPAbstractPlottable *plottable);
|
|
|
|
// getters:
|
|
QCPAbstractPlottable *plottable() { return mPlottable; }
|
|
|
|
protected:
|
|
// property members:
|
|
QCPAbstractPlottable *mPlottable;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void draw(QCPPainter *painter);
|
|
virtual QSize minimumSizeHint() const;
|
|
|
|
// non-virtual methods:
|
|
QPen getIconBorderPen() const;
|
|
QColor getTextColor() const;
|
|
QFont getFont() const;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPLegend : public QCPLayoutGrid
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(QPen borderPen READ borderPen WRITE setBorderPen)
|
|
Q_PROPERTY(QBrush brush READ brush WRITE setBrush)
|
|
Q_PROPERTY(QFont font READ font WRITE setFont)
|
|
Q_PROPERTY(QColor textColor READ textColor WRITE setTextColor)
|
|
Q_PROPERTY(QSize iconSize READ iconSize WRITE setIconSize)
|
|
Q_PROPERTY(int iconTextPadding READ iconTextPadding WRITE setIconTextPadding)
|
|
Q_PROPERTY(QPen iconBorderPen READ iconBorderPen WRITE setIconBorderPen)
|
|
Q_PROPERTY(SelectableParts selectableParts READ selectableParts WRITE setSelectableParts NOTIFY selectionChanged)
|
|
Q_PROPERTY(SelectableParts selectedParts READ selectedParts WRITE setSelectedParts NOTIFY selectableChanged)
|
|
Q_PROPERTY(QPen selectedBorderPen READ selectedBorderPen WRITE setSelectedBorderPen)
|
|
Q_PROPERTY(QPen selectedIconBorderPen READ selectedIconBorderPen WRITE setSelectedIconBorderPen)
|
|
Q_PROPERTY(QBrush selectedBrush READ selectedBrush WRITE setSelectedBrush)
|
|
Q_PROPERTY(QFont selectedFont READ selectedFont WRITE setSelectedFont)
|
|
Q_PROPERTY(QColor selectedTextColor READ selectedTextColor WRITE setSelectedTextColor)
|
|
/// \endcond
|
|
public:
|
|
/*!
|
|
Defines the selectable parts of a legend
|
|
|
|
\see setSelectedParts, setSelectableParts
|
|
*/
|
|
enum SelectablePart { spNone = 0x000 ///< <tt>0x000</tt> None
|
|
,spLegendBox = 0x001 ///< <tt>0x001</tt> The legend box (frame)
|
|
,spItems = 0x002 ///< <tt>0x002</tt> Legend items individually (see \ref selectedItems)
|
|
};
|
|
Q_FLAGS(SelectablePart SelectableParts)
|
|
Q_DECLARE_FLAGS(SelectableParts, SelectablePart)
|
|
|
|
explicit QCPLegend();
|
|
virtual ~QCPLegend();
|
|
|
|
// getters:
|
|
QPen borderPen() const { return mBorderPen; }
|
|
QBrush brush() const { return mBrush; }
|
|
QFont font() const { return mFont; }
|
|
QColor textColor() const { return mTextColor; }
|
|
QSize iconSize() const { return mIconSize; }
|
|
int iconTextPadding() const { return mIconTextPadding; }
|
|
QPen iconBorderPen() const { return mIconBorderPen; }
|
|
SelectableParts selectableParts() const { return mSelectableParts; }
|
|
SelectableParts selectedParts() const;
|
|
QPen selectedBorderPen() const { return mSelectedBorderPen; }
|
|
QPen selectedIconBorderPen() const { return mSelectedIconBorderPen; }
|
|
QBrush selectedBrush() const { return mSelectedBrush; }
|
|
QFont selectedFont() const { return mSelectedFont; }
|
|
QColor selectedTextColor() const { return mSelectedTextColor; }
|
|
|
|
// setters:
|
|
void setBorderPen(const QPen &pen);
|
|
void setBrush(const QBrush &brush);
|
|
void setFont(const QFont &font);
|
|
void setTextColor(const QColor &color);
|
|
void setIconSize(const QSize &size);
|
|
void setIconSize(int width, int height);
|
|
void setIconTextPadding(int padding);
|
|
void setIconBorderPen(const QPen &pen);
|
|
Q_SLOT void setSelectableParts(const SelectableParts &selectableParts);
|
|
Q_SLOT void setSelectedParts(const SelectableParts &selectedParts);
|
|
void setSelectedBorderPen(const QPen &pen);
|
|
void setSelectedIconBorderPen(const QPen &pen);
|
|
void setSelectedBrush(const QBrush &brush);
|
|
void setSelectedFont(const QFont &font);
|
|
void setSelectedTextColor(const QColor &color);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
// non-virtual methods:
|
|
QCPAbstractLegendItem *item(int index) const;
|
|
QCPPlottableLegendItem *itemWithPlottable(const QCPAbstractPlottable *plottable) const;
|
|
int itemCount() const;
|
|
bool hasItem(QCPAbstractLegendItem *item) const;
|
|
bool hasItemWithPlottable(const QCPAbstractPlottable *plottable) const;
|
|
bool addItem(QCPAbstractLegendItem *item);
|
|
bool removeItem(int index);
|
|
bool removeItem(QCPAbstractLegendItem *item);
|
|
void clearItems();
|
|
QList<QCPAbstractLegendItem*> selectedItems() const;
|
|
|
|
signals:
|
|
void selectionChanged(QCPLegend::SelectableParts parts);
|
|
void selectableChanged(QCPLegend::SelectableParts parts);
|
|
|
|
protected:
|
|
// property members:
|
|
QPen mBorderPen, mIconBorderPen;
|
|
QBrush mBrush;
|
|
QFont mFont;
|
|
QColor mTextColor;
|
|
QSize mIconSize;
|
|
int mIconTextPadding;
|
|
SelectableParts mSelectedParts, mSelectableParts;
|
|
QPen mSelectedBorderPen, mSelectedIconBorderPen;
|
|
QBrush mSelectedBrush;
|
|
QFont mSelectedFont;
|
|
QColor mSelectedTextColor;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void parentPlotInitialized(QCustomPlot *parentPlot);
|
|
virtual QCP::Interaction selectionCategory() const;
|
|
virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const;
|
|
virtual void draw(QCPPainter *painter);
|
|
// events:
|
|
virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged);
|
|
virtual void deselectEvent(bool *selectionStateChanged);
|
|
|
|
// non-virtual methods:
|
|
QPen getBorderPen() const;
|
|
QBrush getBrush() const;
|
|
|
|
private:
|
|
Q_DISABLE_COPY(QCPLegend)
|
|
|
|
friend class QCustomPlot;
|
|
friend class QCPAbstractLegendItem;
|
|
};
|
|
Q_DECLARE_OPERATORS_FOR_FLAGS(QCPLegend::SelectableParts)
|
|
Q_DECLARE_METATYPE(QCPLegend::SelectablePart)
|
|
|
|
|
|
class QCP_LIB_DECL QCPPlotTitle : public QCPLayoutElement
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(QString text READ text WRITE setText)
|
|
Q_PROPERTY(QFont font READ font WRITE setFont)
|
|
Q_PROPERTY(QColor textColor READ textColor WRITE setTextColor)
|
|
Q_PROPERTY(QFont selectedFont READ selectedFont WRITE setSelectedFont)
|
|
Q_PROPERTY(QColor selectedTextColor READ selectedTextColor WRITE setSelectedTextColor)
|
|
Q_PROPERTY(bool selectable READ selectable WRITE setSelectable NOTIFY selectableChanged)
|
|
Q_PROPERTY(bool selected READ selected WRITE setSelected NOTIFY selectionChanged)
|
|
/// \endcond
|
|
public:
|
|
explicit QCPPlotTitle(QCustomPlot *parentPlot);
|
|
explicit QCPPlotTitle(QCustomPlot *parentPlot, const QString &text);
|
|
|
|
// getters:
|
|
QString text() const { return mText; }
|
|
QFont font() const { return mFont; }
|
|
QColor textColor() const { return mTextColor; }
|
|
QFont selectedFont() const { return mSelectedFont; }
|
|
QColor selectedTextColor() const { return mSelectedTextColor; }
|
|
bool selectable() const { return mSelectable; }
|
|
bool selected() const { return mSelected; }
|
|
|
|
// setters:
|
|
void setText(const QString &text);
|
|
void setFont(const QFont &font);
|
|
void setTextColor(const QColor &color);
|
|
void setSelectedFont(const QFont &font);
|
|
void setSelectedTextColor(const QColor &color);
|
|
Q_SLOT void setSelectable(bool selectable);
|
|
Q_SLOT void setSelected(bool selected);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
signals:
|
|
void selectionChanged(bool selected);
|
|
void selectableChanged(bool selectable);
|
|
|
|
protected:
|
|
// property members:
|
|
QString mText;
|
|
QFont mFont;
|
|
QColor mTextColor;
|
|
QFont mSelectedFont;
|
|
QColor mSelectedTextColor;
|
|
QRect mTextBoundingRect;
|
|
bool mSelectable, mSelected;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const;
|
|
virtual void draw(QCPPainter *painter);
|
|
virtual QSize minimumSizeHint() const;
|
|
virtual QSize maximumSizeHint() const;
|
|
// events:
|
|
virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged);
|
|
virtual void deselectEvent(bool *selectionStateChanged);
|
|
|
|
// non-virtual methods:
|
|
QFont mainFont() const;
|
|
QColor mainTextColor() const;
|
|
|
|
private:
|
|
Q_DISABLE_COPY(QCPPlotTitle)
|
|
};
|
|
|
|
|
|
class QCPColorScaleAxisRectPrivate : public QCPAxisRect
|
|
{
|
|
Q_OBJECT
|
|
public:
|
|
explicit QCPColorScaleAxisRectPrivate(QCPColorScale *parentColorScale);
|
|
protected:
|
|
QCPColorScale *mParentColorScale;
|
|
QImage mGradientImage;
|
|
bool mGradientImageInvalidated;
|
|
// re-using some methods of QCPAxisRect to make them available to friend class QCPColorScale
|
|
using QCPAxisRect::calculateAutoMargin;
|
|
using QCPAxisRect::mousePressEvent;
|
|
using QCPAxisRect::mouseMoveEvent;
|
|
using QCPAxisRect::mouseReleaseEvent;
|
|
using QCPAxisRect::wheelEvent;
|
|
using QCPAxisRect::update;
|
|
virtual void draw(QCPPainter *painter);
|
|
void updateGradientImage();
|
|
Q_SLOT void axisSelectionChanged(QCPAxis::SelectableParts selectedParts);
|
|
Q_SLOT void axisSelectableChanged(QCPAxis::SelectableParts selectableParts);
|
|
friend class QCPColorScale;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPColorScale : public QCPLayoutElement
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(QCPAxis::AxisType type READ type WRITE setType)
|
|
Q_PROPERTY(QCPRange dataRange READ dataRange WRITE setDataRange NOTIFY dataRangeChanged)
|
|
Q_PROPERTY(QCPAxis::ScaleType dataScaleType READ dataScaleType WRITE setDataScaleType NOTIFY dataScaleTypeChanged)
|
|
Q_PROPERTY(QCPColorGradient gradient READ gradient WRITE setGradient NOTIFY gradientChanged)
|
|
Q_PROPERTY(QString label READ label WRITE setLabel)
|
|
Q_PROPERTY(int barWidth READ barWidth WRITE setBarWidth)
|
|
Q_PROPERTY(bool rangeDrag READ rangeDrag WRITE setRangeDrag)
|
|
Q_PROPERTY(bool rangeZoom READ rangeZoom WRITE setRangeZoom)
|
|
/// \endcond
|
|
public:
|
|
explicit QCPColorScale(QCustomPlot *parentPlot);
|
|
virtual ~QCPColorScale();
|
|
|
|
// getters:
|
|
QCPAxis *axis() const { return mColorAxis.data(); }
|
|
QCPAxis::AxisType type() const { return mType; }
|
|
QCPRange dataRange() const { return mDataRange; }
|
|
QCPAxis::ScaleType dataScaleType() const { return mDataScaleType; }
|
|
QCPColorGradient gradient() const { return mGradient; }
|
|
QString label() const;
|
|
int barWidth () const { return mBarWidth; }
|
|
bool rangeDrag() const;
|
|
bool rangeZoom() const;
|
|
|
|
// setters:
|
|
void setType(QCPAxis::AxisType type);
|
|
Q_SLOT void setDataRange(const QCPRange &dataRange);
|
|
Q_SLOT void setDataScaleType(QCPAxis::ScaleType scaleType);
|
|
Q_SLOT void setGradient(const QCPColorGradient &gradient);
|
|
void setLabel(const QString &str);
|
|
void setBarWidth(int width);
|
|
void setRangeDrag(bool enabled);
|
|
void setRangeZoom(bool enabled);
|
|
|
|
// non-property methods:
|
|
QList<QCPColorMap*> colorMaps() const;
|
|
void rescaleDataRange(bool onlyVisibleMaps);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void update(UpdatePhase phase);
|
|
|
|
signals:
|
|
void dataRangeChanged(QCPRange newRange);
|
|
void dataScaleTypeChanged(QCPAxis::ScaleType scaleType);
|
|
void gradientChanged(QCPColorGradient newGradient);
|
|
|
|
protected:
|
|
// property members:
|
|
QCPAxis::AxisType mType;
|
|
QCPRange mDataRange;
|
|
QCPAxis::ScaleType mDataScaleType;
|
|
QCPColorGradient mGradient;
|
|
int mBarWidth;
|
|
|
|
// non-property members:
|
|
QPointer<QCPColorScaleAxisRectPrivate> mAxisRect;
|
|
QPointer<QCPAxis> mColorAxis;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const;
|
|
// events:
|
|
virtual void mousePressEvent(QMouseEvent *event);
|
|
virtual void mouseMoveEvent(QMouseEvent *event);
|
|
virtual void mouseReleaseEvent(QMouseEvent *event);
|
|
virtual void wheelEvent(QWheelEvent *event);
|
|
|
|
private:
|
|
Q_DISABLE_COPY(QCPColorScale)
|
|
|
|
friend class QCPColorScaleAxisRectPrivate;
|
|
};
|
|
|
|
|
|
/*! \file */
|
|
|
|
|
|
|
|
class QCP_LIB_DECL QCPData
|
|
{
|
|
public:
|
|
QCPData();
|
|
QCPData(double key, double value);
|
|
double key, value;
|
|
double keyErrorPlus, keyErrorMinus;
|
|
double valueErrorPlus, valueErrorMinus;
|
|
};
|
|
Q_DECLARE_TYPEINFO(QCPData, Q_MOVABLE_TYPE);
|
|
|
|
/*! \typedef QCPDataMap
|
|
Container for storing \ref QCPData items in a sorted fashion. The key of the map
|
|
is the key member of the QCPData instance.
|
|
|
|
This is the container in which QCPGraph holds its data.
|
|
\see QCPData, QCPGraph::setData
|
|
*/
|
|
typedef QMap<double, QCPData> QCPDataMap;
|
|
typedef QMapIterator<double, QCPData> QCPDataMapIterator;
|
|
typedef QMutableMapIterator<double, QCPData> QCPDataMutableMapIterator;
|
|
|
|
|
|
class QCP_LIB_DECL QCPGraph : public QCPAbstractPlottable
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(LineStyle lineStyle READ lineStyle WRITE setLineStyle)
|
|
Q_PROPERTY(QCPScatterStyle scatterStyle READ scatterStyle WRITE setScatterStyle)
|
|
Q_PROPERTY(ErrorType errorType READ errorType WRITE setErrorType)
|
|
Q_PROPERTY(QPen errorPen READ errorPen WRITE setErrorPen)
|
|
Q_PROPERTY(double errorBarSize READ errorBarSize WRITE setErrorBarSize)
|
|
Q_PROPERTY(bool errorBarSkipSymbol READ errorBarSkipSymbol WRITE setErrorBarSkipSymbol)
|
|
Q_PROPERTY(QCPGraph* channelFillGraph READ channelFillGraph WRITE setChannelFillGraph)
|
|
Q_PROPERTY(bool adaptiveSampling READ adaptiveSampling WRITE setAdaptiveSampling)
|
|
/// \endcond
|
|
public:
|
|
/*!
|
|
Defines how the graph's line is represented visually in the plot. The line is drawn with the
|
|
current pen of the graph (\ref setPen).
|
|
\see setLineStyle
|
|
*/
|
|
enum LineStyle { lsNone ///< data points are not connected with any lines (e.g. data only represented
|
|
///< with symbols according to the scatter style, see \ref setScatterStyle)
|
|
,lsLine ///< data points are connected by a straight line
|
|
,lsStepLeft ///< line is drawn as steps where the step height is the value of the left data point
|
|
,lsStepRight ///< line is drawn as steps where the step height is the value of the right data point
|
|
,lsStepCenter ///< line is drawn as steps where the step is in between two data points
|
|
,lsImpulse ///< each data point is represented by a line parallel to the value axis, which reaches from the data point to the zero-value-line
|
|
};
|
|
Q_ENUMS(LineStyle)
|
|
/*!
|
|
Defines what kind of error bars are drawn for each data point
|
|
*/
|
|
enum ErrorType { etNone ///< No error bars are shown
|
|
,etKey ///< Error bars for the key dimension of the data point are shown
|
|
,etValue ///< Error bars for the value dimension of the data point are shown
|
|
,etBoth ///< Error bars for both key and value dimensions of the data point are shown
|
|
};
|
|
Q_ENUMS(ErrorType)
|
|
|
|
explicit QCPGraph(QCPAxis *keyAxis, QCPAxis *valueAxis);
|
|
virtual ~QCPGraph();
|
|
|
|
// getters:
|
|
QCPDataMap *data() const { return mData; }
|
|
LineStyle lineStyle() const { return mLineStyle; }
|
|
QCPScatterStyle scatterStyle() const { return mScatterStyle; }
|
|
ErrorType errorType() const { return mErrorType; }
|
|
QPen errorPen() const { return mErrorPen; }
|
|
double errorBarSize() const { return mErrorBarSize; }
|
|
bool errorBarSkipSymbol() const { return mErrorBarSkipSymbol; }
|
|
QCPGraph *channelFillGraph() const { return mChannelFillGraph.data(); }
|
|
bool adaptiveSampling() const { return mAdaptiveSampling; }
|
|
|
|
// setters:
|
|
void setData(QCPDataMap *data, bool copy=false);
|
|
void setData(const QVector<double> &key, const QVector<double> &value);
|
|
void setDataKeyError(const QVector<double> &key, const QVector<double> &value, const QVector<double> &keyError);
|
|
void setDataKeyError(const QVector<double> &key, const QVector<double> &value, const QVector<double> &keyErrorMinus, const QVector<double> &keyErrorPlus);
|
|
void setDataValueError(const QVector<double> &key, const QVector<double> &value, const QVector<double> &valueError);
|
|
void setDataValueError(const QVector<double> &key, const QVector<double> &value, const QVector<double> &valueErrorMinus, const QVector<double> &valueErrorPlus);
|
|
void setDataBothError(const QVector<double> &key, const QVector<double> &value, const QVector<double> &keyError, const QVector<double> &valueError);
|
|
void setDataBothError(const QVector<double> &key, const QVector<double> &value, const QVector<double> &keyErrorMinus, const QVector<double> &keyErrorPlus, const QVector<double> &valueErrorMinus, const QVector<double> &valueErrorPlus);
|
|
void setLineStyle(LineStyle ls);
|
|
void setScatterStyle(const QCPScatterStyle &style);
|
|
void setErrorType(ErrorType errorType);
|
|
void setErrorPen(const QPen &pen);
|
|
void setErrorBarSize(double size);
|
|
void setErrorBarSkipSymbol(bool enabled);
|
|
void setChannelFillGraph(QCPGraph *targetGraph);
|
|
void setAdaptiveSampling(bool enabled);
|
|
|
|
// non-property methods:
|
|
void addData(const QCPDataMap &dataMap);
|
|
void addData(const QCPData &data);
|
|
void addData(double key, double value);
|
|
void addData(const QVector<double> &keys, const QVector<double> &values);
|
|
void removeDataBefore(double key);
|
|
void removeDataAfter(double key);
|
|
void removeData(double fromKey, double toKey);
|
|
void removeData(double key);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void clearData();
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
using QCPAbstractPlottable::rescaleAxes;
|
|
using QCPAbstractPlottable::rescaleKeyAxis;
|
|
using QCPAbstractPlottable::rescaleValueAxis;
|
|
void rescaleAxes(bool onlyEnlarge, bool includeErrorBars) const; // overloads base class interface
|
|
void rescaleKeyAxis(bool onlyEnlarge, bool includeErrorBars) const; // overloads base class interface
|
|
void rescaleValueAxis(bool onlyEnlarge, bool includeErrorBars) const; // overloads base class interface
|
|
|
|
protected:
|
|
// property members:
|
|
QCPDataMap *mData;
|
|
QPen mErrorPen;
|
|
LineStyle mLineStyle;
|
|
QCPScatterStyle mScatterStyle;
|
|
ErrorType mErrorType;
|
|
double mErrorBarSize;
|
|
bool mErrorBarSkipSymbol;
|
|
QPointer<QCPGraph> mChannelFillGraph;
|
|
bool mAdaptiveSampling;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void draw(QCPPainter *painter);
|
|
virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const;
|
|
virtual QCPRange getKeyRange(bool &foundRange, SignDomain inSignDomain=sdBoth) const;
|
|
virtual QCPRange getValueRange(bool &foundRange, SignDomain inSignDomain=sdBoth) const;
|
|
virtual QCPRange getKeyRange(bool &foundRange, SignDomain inSignDomain, bool includeErrors) const; // overloads base class interface
|
|
virtual QCPRange getValueRange(bool &foundRange, SignDomain inSignDomain, bool includeErrors) const; // overloads base class interface
|
|
|
|
// introduced virtual methods:
|
|
virtual void drawFill(QCPPainter *painter, QVector<QPointF> *lineData) const;
|
|
virtual void drawScatterPlot(QCPPainter *painter, QVector<QCPData> *scatterData) const;
|
|
virtual void drawLinePlot(QCPPainter *painter, QVector<QPointF> *lineData) const;
|
|
virtual void drawImpulsePlot(QCPPainter *painter, QVector<QPointF> *lineData) const;
|
|
|
|
// non-virtual methods:
|
|
void getPreparedData(QVector<QCPData> *lineData, QVector<QCPData> *scatterData) const;
|
|
void getPlotData(QVector<QPointF> *lineData, QVector<QCPData> *scatterData) const;
|
|
void getScatterPlotData(QVector<QCPData> *scatterData) const;
|
|
void getLinePlotData(QVector<QPointF> *linePixelData, QVector<QCPData> *scatterData) const;
|
|
void getStepLeftPlotData(QVector<QPointF> *linePixelData, QVector<QCPData> *scatterData) const;
|
|
void getStepRightPlotData(QVector<QPointF> *linePixelData, QVector<QCPData> *scatterData) const;
|
|
void getStepCenterPlotData(QVector<QPointF> *linePixelData, QVector<QCPData> *scatterData) const;
|
|
void getImpulsePlotData(QVector<QPointF> *linePixelData, QVector<QCPData> *scatterData) const;
|
|
void drawError(QCPPainter *painter, double x, double y, const QCPData &data) const;
|
|
void getVisibleDataBounds(QCPDataMap::const_iterator &lower, QCPDataMap::const_iterator &upper) const;
|
|
int countDataInBounds(const QCPDataMap::const_iterator &lower, const QCPDataMap::const_iterator &upper, int maxCount) const;
|
|
void addFillBasePoints(QVector<QPointF> *lineData) const;
|
|
void removeFillBasePoints(QVector<QPointF> *lineData) const;
|
|
QPointF lowerFillBasePoint(double lowerKey) const;
|
|
QPointF upperFillBasePoint(double upperKey) const;
|
|
const QPolygonF getChannelFillPolygon(const QVector<QPointF> *lineData) const;
|
|
int findIndexBelowX(const QVector<QPointF> *data, double x) const;
|
|
int findIndexAboveX(const QVector<QPointF> *data, double x) const;
|
|
int findIndexBelowY(const QVector<QPointF> *data, double y) const;
|
|
int findIndexAboveY(const QVector<QPointF> *data, double y) const;
|
|
double pointDistance(const QPointF &pixelPoint) const;
|
|
|
|
friend class QCustomPlot;
|
|
friend class QCPLegend;
|
|
};
|
|
|
|
|
|
/*! \file */
|
|
|
|
|
|
|
|
class QCP_LIB_DECL QCPCurveData
|
|
{
|
|
public:
|
|
QCPCurveData();
|
|
QCPCurveData(double t, double key, double value);
|
|
double t, key, value;
|
|
};
|
|
Q_DECLARE_TYPEINFO(QCPCurveData, Q_MOVABLE_TYPE);
|
|
|
|
/*! \typedef QCPCurveDataMap
|
|
Container for storing \ref QCPCurveData items in a sorted fashion. The key of the map
|
|
is the t member of the QCPCurveData instance.
|
|
|
|
This is the container in which QCPCurve holds its data.
|
|
\see QCPCurveData, QCPCurve::setData
|
|
*/
|
|
|
|
typedef QMap<double, QCPCurveData> QCPCurveDataMap;
|
|
typedef QMapIterator<double, QCPCurveData> QCPCurveDataMapIterator;
|
|
typedef QMutableMapIterator<double, QCPCurveData> QCPCurveDataMutableMapIterator;
|
|
|
|
|
|
class QCP_LIB_DECL QCPCurve : public QCPAbstractPlottable
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(QCPScatterStyle scatterStyle READ scatterStyle WRITE setScatterStyle)
|
|
Q_PROPERTY(LineStyle lineStyle READ lineStyle WRITE setLineStyle)
|
|
/// \endcond
|
|
public:
|
|
/*!
|
|
Defines how the curve's line is represented visually in the plot. The line is drawn with the
|
|
current pen of the curve (\ref setPen).
|
|
\see setLineStyle
|
|
*/
|
|
enum LineStyle { lsNone ///< No line is drawn between data points (e.g. only scatters)
|
|
,lsLine ///< Data points are connected with a straight line
|
|
};
|
|
explicit QCPCurve(QCPAxis *keyAxis, QCPAxis *valueAxis);
|
|
virtual ~QCPCurve();
|
|
|
|
// getters:
|
|
QCPCurveDataMap *data() const { return mData; }
|
|
QCPScatterStyle scatterStyle() const { return mScatterStyle; }
|
|
LineStyle lineStyle() const { return mLineStyle; }
|
|
|
|
// setters:
|
|
void setData(QCPCurveDataMap *data, bool copy=false);
|
|
void setData(const QVector<double> &t, const QVector<double> &key, const QVector<double> &value);
|
|
void setData(const QVector<double> &key, const QVector<double> &value);
|
|
void setScatterStyle(const QCPScatterStyle &style);
|
|
void setLineStyle(LineStyle style);
|
|
|
|
// non-property methods:
|
|
void addData(const QCPCurveDataMap &dataMap);
|
|
void addData(const QCPCurveData &data);
|
|
void addData(double t, double key, double value);
|
|
void addData(double key, double value);
|
|
void addData(const QVector<double> &ts, const QVector<double> &keys, const QVector<double> &values);
|
|
void removeDataBefore(double t);
|
|
void removeDataAfter(double t);
|
|
void removeData(double fromt, double tot);
|
|
void removeData(double t);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void clearData();
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
protected:
|
|
// property members:
|
|
QCPCurveDataMap *mData;
|
|
QCPScatterStyle mScatterStyle;
|
|
LineStyle mLineStyle;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void draw(QCPPainter *painter);
|
|
virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const;
|
|
virtual QCPRange getKeyRange(bool &foundRange, SignDomain inSignDomain=sdBoth) const;
|
|
virtual QCPRange getValueRange(bool &foundRange, SignDomain inSignDomain=sdBoth) const;
|
|
|
|
// introduced virtual methods:
|
|
virtual void drawScatterPlot(QCPPainter *painter, const QVector<QPointF> *pointData) const;
|
|
|
|
// non-virtual methods:
|
|
void getCurveData(QVector<QPointF> *lineData) const;
|
|
int getRegion(double x, double y, double rectLeft, double rectTop, double rectRight, double rectBottom) const;
|
|
QPointF getOptimizedPoint(int prevRegion, double prevKey, double prevValue, double key, double value, double rectLeft, double rectTop, double rectRight, double rectBottom) const;
|
|
QVector<QPointF> getOptimizedCornerPoints(int prevRegion, int currentRegion, double prevKey, double prevValue, double key, double value, double rectLeft, double rectTop, double rectRight, double rectBottom) const;
|
|
bool mayTraverse(int prevRegion, int currentRegion) const;
|
|
bool getTraverse(double prevKey, double prevValue, double key, double value, double rectLeft, double rectTop, double rectRight, double rectBottom, QPointF &crossA, QPointF &crossB) const;
|
|
void getTraverseCornerPoints(int prevRegion, int currentRegion, double rectLeft, double rectTop, double rectRight, double rectBottom, QVector<QPointF> &beforeTraverse, QVector<QPointF> &afterTraverse) const;
|
|
double pointDistance(const QPointF &pixelPoint) const;
|
|
|
|
friend class QCustomPlot;
|
|
friend class QCPLegend;
|
|
};
|
|
|
|
|
|
/*! \file */
|
|
|
|
|
|
|
|
class QCP_LIB_DECL QCPBarsGroup : public QObject
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(SpacingType spacingType READ spacingType WRITE setSpacingType)
|
|
Q_PROPERTY(double spacing READ spacing WRITE setSpacing)
|
|
/// \endcond
|
|
public:
|
|
/*!
|
|
Defines the ways the spacing between bars in the group can be specified. Thus it defines what
|
|
the number passed to \ref setSpacing actually means.
|
|
|
|
\see setSpacingType, setSpacing
|
|
*/
|
|
enum SpacingType { stAbsolute ///< Bar spacing is in absolute pixels
|
|
,stAxisRectRatio ///< Bar spacing is given by a fraction of the axis rect size
|
|
,stPlotCoords ///< Bar spacing is in key coordinates and thus scales with the key axis range
|
|
};
|
|
QCPBarsGroup(QCustomPlot *parentPlot);
|
|
~QCPBarsGroup();
|
|
|
|
// getters:
|
|
SpacingType spacingType() const { return mSpacingType; }
|
|
double spacing() const { return mSpacing; }
|
|
|
|
// setters:
|
|
void setSpacingType(SpacingType spacingType);
|
|
void setSpacing(double spacing);
|
|
|
|
// non-virtual methods:
|
|
QList<QCPBars*> bars() const { return mBars; }
|
|
QCPBars* bars(int index) const;
|
|
int size() const { return mBars.size(); }
|
|
bool isEmpty() const { return mBars.isEmpty(); }
|
|
void clear();
|
|
bool contains(QCPBars *bars) const { return mBars.contains(bars); }
|
|
void append(QCPBars *bars);
|
|
void insert(int i, QCPBars *bars);
|
|
void remove(QCPBars *bars);
|
|
|
|
protected:
|
|
// non-property members:
|
|
QCustomPlot *mParentPlot;
|
|
SpacingType mSpacingType;
|
|
double mSpacing;
|
|
QList<QCPBars*> mBars;
|
|
|
|
// non-virtual methods:
|
|
void registerBars(QCPBars *bars);
|
|
void unregisterBars(QCPBars *bars);
|
|
|
|
// virtual methods:
|
|
double keyPixelOffset(const QCPBars *bars, double keyCoord);
|
|
double getPixelSpacing(const QCPBars *bars, double keyCoord);
|
|
|
|
private:
|
|
Q_DISABLE_COPY(QCPBarsGroup)
|
|
|
|
friend class QCPBars;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPBarData
|
|
{
|
|
public:
|
|
QCPBarData();
|
|
QCPBarData(double key, double value);
|
|
double key, value;
|
|
};
|
|
Q_DECLARE_TYPEINFO(QCPBarData, Q_MOVABLE_TYPE);
|
|
|
|
/*! \typedef QCPBarDataMap
|
|
Container for storing \ref QCPBarData items in a sorted fashion. The key of the map
|
|
is the key member of the QCPBarData instance.
|
|
|
|
This is the container in which QCPBars holds its data.
|
|
\see QCPBarData, QCPBars::setData
|
|
*/
|
|
typedef QMap<double, QCPBarData> QCPBarDataMap;
|
|
typedef QMapIterator<double, QCPBarData> QCPBarDataMapIterator;
|
|
typedef QMutableMapIterator<double, QCPBarData> QCPBarDataMutableMapIterator;
|
|
|
|
|
|
class QCP_LIB_DECL QCPBars : public QCPAbstractPlottable
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(double width READ width WRITE setWidth)
|
|
Q_PROPERTY(WidthType widthType READ widthType WRITE setWidthType)
|
|
Q_PROPERTY(QCPBarsGroup* barsGroup READ barsGroup WRITE setBarsGroup)
|
|
Q_PROPERTY(double baseValue READ baseValue WRITE setBaseValue)
|
|
Q_PROPERTY(QCPBars* barBelow READ barBelow)
|
|
Q_PROPERTY(QCPBars* barAbove READ barAbove)
|
|
/// \endcond
|
|
public:
|
|
/*!
|
|
Defines the ways the width of the bar can be specified. Thus it defines what the number passed
|
|
to \ref setWidth actually means.
|
|
|
|
\see setWidthType, setWidth
|
|
*/
|
|
enum WidthType { wtAbsolute ///< Bar width is in absolute pixels
|
|
,wtAxisRectRatio ///< Bar width is given by a fraction of the axis rect size
|
|
,wtPlotCoords ///< Bar width is in key coordinates and thus scales with the key axis range
|
|
};
|
|
Q_ENUMS(WidthType)
|
|
|
|
explicit QCPBars(QCPAxis *keyAxis, QCPAxis *valueAxis);
|
|
virtual ~QCPBars();
|
|
|
|
// getters:
|
|
double width() const { return mWidth; }
|
|
WidthType widthType() const { return mWidthType; }
|
|
QCPBarsGroup *barsGroup() const { return mBarsGroup; }
|
|
double baseValue() const { return mBaseValue; }
|
|
QCPBars *barBelow() const { return mBarBelow.data(); }
|
|
QCPBars *barAbove() const { return mBarAbove.data(); }
|
|
QCPBarDataMap *data() const { return mData; }
|
|
|
|
// setters:
|
|
void setWidth(double width);
|
|
void setWidthType(WidthType widthType);
|
|
void setBarsGroup(QCPBarsGroup *barsGroup);
|
|
void setBaseValue(double baseValue);
|
|
void setData(QCPBarDataMap *data, bool copy=false);
|
|
void setData(const QVector<double> &key, const QVector<double> &value);
|
|
|
|
// non-property methods:
|
|
void moveBelow(QCPBars *bars);
|
|
void moveAbove(QCPBars *bars);
|
|
void addData(const QCPBarDataMap &dataMap);
|
|
void addData(const QCPBarData &data);
|
|
void addData(double key, double value);
|
|
void addData(const QVector<double> &keys, const QVector<double> &values);
|
|
void removeDataBefore(double key);
|
|
void removeDataAfter(double key);
|
|
void removeData(double fromKey, double toKey);
|
|
void removeData(double key);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void clearData();
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
protected:
|
|
// property members:
|
|
QCPBarDataMap *mData;
|
|
double mWidth;
|
|
WidthType mWidthType;
|
|
QCPBarsGroup *mBarsGroup;
|
|
double mBaseValue;
|
|
QPointer<QCPBars> mBarBelow, mBarAbove;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void draw(QCPPainter *painter);
|
|
virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const;
|
|
virtual QCPRange getKeyRange(bool &foundRange, SignDomain inSignDomain=sdBoth) const;
|
|
virtual QCPRange getValueRange(bool &foundRange, SignDomain inSignDomain=sdBoth) const;
|
|
|
|
// non-virtual methods:
|
|
void getVisibleDataBounds(QCPBarDataMap::const_iterator &lower, QCPBarDataMap::const_iterator &upperEnd) const;
|
|
QPolygonF getBarPolygon(double key, double value) const;
|
|
void getPixelWidth(double key, double &lower, double &upper) const;
|
|
double getStackedBaseValue(double key, bool positive) const;
|
|
static void connectBars(QCPBars* lower, QCPBars* upper);
|
|
|
|
friend class QCustomPlot;
|
|
friend class QCPLegend;
|
|
friend class QCPBarsGroup;
|
|
};
|
|
|
|
|
|
/*! \file */
|
|
|
|
|
|
|
|
class QCP_LIB_DECL QCPStatisticalBox : public QCPAbstractPlottable
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(double key READ key WRITE setKey)
|
|
Q_PROPERTY(double minimum READ minimum WRITE setMinimum)
|
|
Q_PROPERTY(double lowerQuartile READ lowerQuartile WRITE setLowerQuartile)
|
|
Q_PROPERTY(double median READ median WRITE setMedian)
|
|
Q_PROPERTY(double upperQuartile READ upperQuartile WRITE setUpperQuartile)
|
|
Q_PROPERTY(double maximum READ maximum WRITE setMaximum)
|
|
Q_PROPERTY(QVector<double> outliers READ outliers WRITE setOutliers)
|
|
Q_PROPERTY(double width READ width WRITE setWidth)
|
|
Q_PROPERTY(double whiskerWidth READ whiskerWidth WRITE setWhiskerWidth)
|
|
Q_PROPERTY(QPen whiskerPen READ whiskerPen WRITE setWhiskerPen)
|
|
Q_PROPERTY(QPen whiskerBarPen READ whiskerBarPen WRITE setWhiskerBarPen)
|
|
Q_PROPERTY(QPen medianPen READ medianPen WRITE setMedianPen)
|
|
Q_PROPERTY(QCPScatterStyle outlierStyle READ outlierStyle WRITE setOutlierStyle)
|
|
/// \endcond
|
|
public:
|
|
explicit QCPStatisticalBox(QCPAxis *keyAxis, QCPAxis *valueAxis);
|
|
|
|
// getters:
|
|
double key() const { return mKey; }
|
|
double minimum() const { return mMinimum; }
|
|
double lowerQuartile() const { return mLowerQuartile; }
|
|
double median() const { return mMedian; }
|
|
double upperQuartile() const { return mUpperQuartile; }
|
|
double maximum() const { return mMaximum; }
|
|
QVector<double> outliers() const { return mOutliers; }
|
|
double width() const { return mWidth; }
|
|
double whiskerWidth() const { return mWhiskerWidth; }
|
|
QPen whiskerPen() const { return mWhiskerPen; }
|
|
QPen whiskerBarPen() const { return mWhiskerBarPen; }
|
|
QPen medianPen() const { return mMedianPen; }
|
|
QCPScatterStyle outlierStyle() const { return mOutlierStyle; }
|
|
|
|
// setters:
|
|
void setKey(double key);
|
|
void setMinimum(double value);
|
|
void setLowerQuartile(double value);
|
|
void setMedian(double value);
|
|
void setUpperQuartile(double value);
|
|
void setMaximum(double value);
|
|
void setOutliers(const QVector<double> &values);
|
|
void setData(double key, double minimum, double lowerQuartile, double median, double upperQuartile, double maximum);
|
|
void setWidth(double width);
|
|
void setWhiskerWidth(double width);
|
|
void setWhiskerPen(const QPen &pen);
|
|
void setWhiskerBarPen(const QPen &pen);
|
|
void setMedianPen(const QPen &pen);
|
|
void setOutlierStyle(const QCPScatterStyle &style);
|
|
|
|
// non-property methods:
|
|
virtual void clearData();
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
protected:
|
|
// property members:
|
|
QVector<double> mOutliers;
|
|
double mKey, mMinimum, mLowerQuartile, mMedian, mUpperQuartile, mMaximum;
|
|
double mWidth;
|
|
double mWhiskerWidth;
|
|
QPen mWhiskerPen, mWhiskerBarPen, mMedianPen;
|
|
QCPScatterStyle mOutlierStyle;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void draw(QCPPainter *painter);
|
|
virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const;
|
|
virtual QCPRange getKeyRange(bool &foundRange, SignDomain inSignDomain=sdBoth) const;
|
|
virtual QCPRange getValueRange(bool &foundRange, SignDomain inSignDomain=sdBoth) const;
|
|
|
|
// introduced virtual methods:
|
|
virtual void drawQuartileBox(QCPPainter *painter, QRectF *quartileBox=0) const;
|
|
virtual void drawMedian(QCPPainter *painter) const;
|
|
virtual void drawWhiskers(QCPPainter *painter) const;
|
|
virtual void drawOutliers(QCPPainter *painter) const;
|
|
|
|
friend class QCustomPlot;
|
|
friend class QCPLegend;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPColorMapData
|
|
{
|
|
public:
|
|
QCPColorMapData(int keySize, int valueSize, const QCPRange &keyRange, const QCPRange &valueRange);
|
|
~QCPColorMapData();
|
|
QCPColorMapData(const QCPColorMapData &other);
|
|
QCPColorMapData &operator=(const QCPColorMapData &other);
|
|
|
|
// getters:
|
|
int keySize() const { return mKeySize; }
|
|
int valueSize() const { return mValueSize; }
|
|
QCPRange keyRange() const { return mKeyRange; }
|
|
QCPRange valueRange() const { return mValueRange; }
|
|
QCPRange dataBounds() const { return mDataBounds; }
|
|
double data(double key, double value);
|
|
double cell(int keyIndex, int valueIndex);
|
|
|
|
// setters:
|
|
void setSize(int keySize, int valueSize);
|
|
void setKeySize(int keySize);
|
|
void setValueSize(int valueSize);
|
|
void setRange(const QCPRange &keyRange, const QCPRange &valueRange);
|
|
void setKeyRange(const QCPRange &keyRange);
|
|
void setValueRange(const QCPRange &valueRange);
|
|
void setData(double key, double value, double z);
|
|
void setCell(int keyIndex, int valueIndex, double z);
|
|
|
|
// non-property methods:
|
|
void recalculateDataBounds();
|
|
void clear();
|
|
void fill(double z);
|
|
bool isEmpty() const { return mIsEmpty; }
|
|
void coordToCell(double key, double value, int *keyIndex, int *valueIndex) const;
|
|
void cellToCoord(int keyIndex, int valueIndex, double *key, double *value) const;
|
|
|
|
protected:
|
|
// property members:
|
|
int mKeySize, mValueSize;
|
|
QCPRange mKeyRange, mValueRange;
|
|
bool mIsEmpty;
|
|
// non-property members:
|
|
double *mData;
|
|
QCPRange mDataBounds;
|
|
bool mDataModified;
|
|
|
|
friend class QCPColorMap;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPColorMap : public QCPAbstractPlottable
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(QCPRange dataRange READ dataRange WRITE setDataRange NOTIFY dataRangeChanged)
|
|
Q_PROPERTY(QCPAxis::ScaleType dataScaleType READ dataScaleType WRITE setDataScaleType NOTIFY dataScaleTypeChanged)
|
|
Q_PROPERTY(QCPColorGradient gradient READ gradient WRITE setGradient NOTIFY gradientChanged)
|
|
Q_PROPERTY(bool interpolate READ interpolate WRITE setInterpolate)
|
|
Q_PROPERTY(bool tightBoundary READ tightBoundary WRITE setTightBoundary)
|
|
Q_PROPERTY(QCPColorScale* colorScale READ colorScale WRITE setColorScale)
|
|
/// \endcond
|
|
public:
|
|
explicit QCPColorMap(QCPAxis *keyAxis, QCPAxis *valueAxis);
|
|
virtual ~QCPColorMap();
|
|
|
|
// getters:
|
|
QCPColorMapData *data() const { return mMapData; }
|
|
QCPRange dataRange() const { return mDataRange; }
|
|
QCPAxis::ScaleType dataScaleType() const { return mDataScaleType; }
|
|
bool interpolate() const { return mInterpolate; }
|
|
bool tightBoundary() const { return mTightBoundary; }
|
|
QCPColorGradient gradient() const { return mGradient; }
|
|
QCPColorScale *colorScale() const { return mColorScale.data(); }
|
|
|
|
// setters:
|
|
void setData(QCPColorMapData *data, bool copy=false);
|
|
Q_SLOT void setDataRange(const QCPRange &dataRange);
|
|
Q_SLOT void setDataScaleType(QCPAxis::ScaleType scaleType);
|
|
Q_SLOT void setGradient(const QCPColorGradient &gradient);
|
|
void setInterpolate(bool enabled);
|
|
void setTightBoundary(bool enabled);
|
|
void setColorScale(QCPColorScale *colorScale);
|
|
|
|
// non-property methods:
|
|
void rescaleDataRange(bool recalculateDataBounds=false);
|
|
Q_SLOT void updateLegendIcon(Qt::TransformationMode transformMode=Qt::SmoothTransformation, const QSize &thumbSize=QSize(32, 18));
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void clearData();
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
signals:
|
|
void dataRangeChanged(QCPRange newRange);
|
|
void dataScaleTypeChanged(QCPAxis::ScaleType scaleType);
|
|
void gradientChanged(QCPColorGradient newGradient);
|
|
|
|
protected:
|
|
// property members:
|
|
QCPRange mDataRange;
|
|
QCPAxis::ScaleType mDataScaleType;
|
|
QCPColorMapData *mMapData;
|
|
QCPColorGradient mGradient;
|
|
bool mInterpolate;
|
|
bool mTightBoundary;
|
|
QPointer<QCPColorScale> mColorScale;
|
|
// non-property members:
|
|
QImage mMapImage;
|
|
QPixmap mLegendIcon;
|
|
bool mMapImageInvalidated;
|
|
|
|
// introduced virtual methods:
|
|
virtual void updateMapImage();
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void draw(QCPPainter *painter);
|
|
virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const;
|
|
virtual QCPRange getKeyRange(bool &foundRange, SignDomain inSignDomain=sdBoth) const;
|
|
virtual QCPRange getValueRange(bool &foundRange, SignDomain inSignDomain=sdBoth) const;
|
|
|
|
friend class QCustomPlot;
|
|
friend class QCPLegend;
|
|
};
|
|
|
|
|
|
/*! \file */
|
|
|
|
|
|
|
|
class QCP_LIB_DECL QCPFinancialData
|
|
{
|
|
public:
|
|
QCPFinancialData();
|
|
QCPFinancialData(double key, double open, double high, double low, double close);
|
|
double key, open, high, low, close;
|
|
};
|
|
Q_DECLARE_TYPEINFO(QCPFinancialData, Q_MOVABLE_TYPE);
|
|
|
|
/*! \typedef QCPFinancialDataMap
|
|
Container for storing \ref QCPFinancialData items in a sorted fashion. The key of the map
|
|
is the key member of the QCPFinancialData instance.
|
|
|
|
This is the container in which QCPFinancial holds its data.
|
|
\see QCPFinancial, QCPFinancial::setData
|
|
*/
|
|
typedef QMap<double, QCPFinancialData> QCPFinancialDataMap;
|
|
typedef QMapIterator<double, QCPFinancialData> QCPFinancialDataMapIterator;
|
|
typedef QMutableMapIterator<double, QCPFinancialData> QCPFinancialDataMutableMapIterator;
|
|
|
|
|
|
class QCP_LIB_DECL QCPFinancial : public QCPAbstractPlottable
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(ChartStyle chartStyle READ chartStyle WRITE setChartStyle)
|
|
Q_PROPERTY(double width READ width WRITE setWidth)
|
|
Q_PROPERTY(bool twoColored READ twoColored WRITE setTwoColored)
|
|
Q_PROPERTY(QBrush brushPositive READ brushPositive WRITE setBrushPositive)
|
|
Q_PROPERTY(QBrush brushNegative READ brushNegative WRITE setBrushNegative)
|
|
Q_PROPERTY(QPen penPositive READ penPositive WRITE setPenPositive)
|
|
Q_PROPERTY(QPen penNegative READ penNegative WRITE setPenNegative)
|
|
/// \endcond
|
|
public:
|
|
/*!
|
|
Defines the possible representations of OHLC data in the plot.
|
|
|
|
\see setChartStyle
|
|
*/
|
|
enum ChartStyle { csOhlc ///< Open-High-Low-Close bar representation
|
|
,csCandlestick ///< Candlestick representation
|
|
};
|
|
Q_ENUMS(ChartStyle)
|
|
|
|
explicit QCPFinancial(QCPAxis *keyAxis, QCPAxis *valueAxis);
|
|
virtual ~QCPFinancial();
|
|
|
|
// getters:
|
|
QCPFinancialDataMap *data() const { return mData; }
|
|
ChartStyle chartStyle() const { return mChartStyle; }
|
|
double width() const { return mWidth; }
|
|
bool twoColored() const { return mTwoColored; }
|
|
QBrush brushPositive() const { return mBrushPositive; }
|
|
QBrush brushNegative() const { return mBrushNegative; }
|
|
QPen penPositive() const { return mPenPositive; }
|
|
QPen penNegative() const { return mPenNegative; }
|
|
|
|
|
|
// setters:
|
|
void setData(QCPFinancialDataMap *data, bool copy=false);
|
|
void setData(const QVector<double> &key, const QVector<double> &open, const QVector<double> &high, const QVector<double> &low, const QVector<double> &close);
|
|
void setChartStyle(ChartStyle style);
|
|
void setWidth(double width);
|
|
void setTwoColored(bool twoColored);
|
|
void setBrushPositive(const QBrush &brush);
|
|
void setBrushNegative(const QBrush &brush);
|
|
void setPenPositive(const QPen &pen);
|
|
void setPenNegative(const QPen &pen);
|
|
|
|
// non-property methods:
|
|
void addData(const QCPFinancialDataMap &dataMap);
|
|
void addData(const QCPFinancialData &data);
|
|
void addData(double key, double open, double high, double low, double close);
|
|
void addData(const QVector<double> &key, const QVector<double> &open, const QVector<double> &high, const QVector<double> &low, const QVector<double> &close);
|
|
void removeDataBefore(double key);
|
|
void removeDataAfter(double key);
|
|
void removeData(double fromKey, double toKey);
|
|
void removeData(double key);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void clearData();
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
// static methods:
|
|
static QCPFinancialDataMap timeSeriesToOhlc(const QVector<double> &time, const QVector<double> &value, double timeBinSize, double timeBinOffset = 0);
|
|
|
|
protected:
|
|
// property members:
|
|
QCPFinancialDataMap *mData;
|
|
ChartStyle mChartStyle;
|
|
double mWidth;
|
|
bool mTwoColored;
|
|
QBrush mBrushPositive, mBrushNegative;
|
|
QPen mPenPositive, mPenNegative;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void draw(QCPPainter *painter);
|
|
virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const;
|
|
virtual QCPRange getKeyRange(bool &foundRange, SignDomain inSignDomain=sdBoth) const;
|
|
virtual QCPRange getValueRange(bool &foundRange, SignDomain inSignDomain=sdBoth) const;
|
|
|
|
// non-virtual methods:
|
|
void drawOhlcPlot(QCPPainter *painter, const QCPFinancialDataMap::const_iterator &begin, const QCPFinancialDataMap::const_iterator &end);
|
|
void drawCandlestickPlot(QCPPainter *painter, const QCPFinancialDataMap::const_iterator &begin, const QCPFinancialDataMap::const_iterator &end);
|
|
double ohlcSelectTest(const QPointF &pos, const QCPFinancialDataMap::const_iterator &begin, const QCPFinancialDataMap::const_iterator &end) const;
|
|
double candlestickSelectTest(const QPointF &pos, const QCPFinancialDataMap::const_iterator &begin, const QCPFinancialDataMap::const_iterator &end) const;
|
|
void getVisibleDataBounds(QCPFinancialDataMap::const_iterator &lower, QCPFinancialDataMap::const_iterator &upper) const;
|
|
|
|
friend class QCustomPlot;
|
|
friend class QCPLegend;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPItemStraightLine : public QCPAbstractItem
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(QPen pen READ pen WRITE setPen)
|
|
Q_PROPERTY(QPen selectedPen READ selectedPen WRITE setSelectedPen)
|
|
/// \endcond
|
|
public:
|
|
QCPItemStraightLine(QCustomPlot *parentPlot);
|
|
virtual ~QCPItemStraightLine();
|
|
|
|
// getters:
|
|
QPen pen() const { return mPen; }
|
|
QPen selectedPen() const { return mSelectedPen; }
|
|
|
|
// setters;
|
|
void setPen(const QPen &pen);
|
|
void setSelectedPen(const QPen &pen);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
QCPItemPosition * const point1;
|
|
QCPItemPosition * const point2;
|
|
|
|
protected:
|
|
// property members:
|
|
QPen mPen, mSelectedPen;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void draw(QCPPainter *painter);
|
|
|
|
// non-virtual methods:
|
|
double distToStraightLine(const QVector2D &point1, const QVector2D &vec, const QVector2D &point) const;
|
|
QLineF getRectClippedStraightLine(const QVector2D &point1, const QVector2D &vec, const QRect &rect) const;
|
|
QPen mainPen() const;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPItemLine : public QCPAbstractItem
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(QPen pen READ pen WRITE setPen)
|
|
Q_PROPERTY(QPen selectedPen READ selectedPen WRITE setSelectedPen)
|
|
Q_PROPERTY(QCPLineEnding head READ head WRITE setHead)
|
|
Q_PROPERTY(QCPLineEnding tail READ tail WRITE setTail)
|
|
/// \endcond
|
|
public:
|
|
QCPItemLine(QCustomPlot *parentPlot);
|
|
virtual ~QCPItemLine();
|
|
|
|
// getters:
|
|
QPen pen() const { return mPen; }
|
|
QPen selectedPen() const { return mSelectedPen; }
|
|
QCPLineEnding head() const { return mHead; }
|
|
QCPLineEnding tail() const { return mTail; }
|
|
|
|
// setters;
|
|
void setPen(const QPen &pen);
|
|
void setSelectedPen(const QPen &pen);
|
|
void setHead(const QCPLineEnding &head);
|
|
void setTail(const QCPLineEnding &tail);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
QCPItemPosition * const start;
|
|
QCPItemPosition * const end;
|
|
|
|
protected:
|
|
// property members:
|
|
QPen mPen, mSelectedPen;
|
|
QCPLineEnding mHead, mTail;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void draw(QCPPainter *painter);
|
|
|
|
// non-virtual methods:
|
|
QLineF getRectClippedLine(const QVector2D &start, const QVector2D &end, const QRect &rect) const;
|
|
QPen mainPen() const;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPItemCurve : public QCPAbstractItem
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(QPen pen READ pen WRITE setPen)
|
|
Q_PROPERTY(QPen selectedPen READ selectedPen WRITE setSelectedPen)
|
|
Q_PROPERTY(QCPLineEnding head READ head WRITE setHead)
|
|
Q_PROPERTY(QCPLineEnding tail READ tail WRITE setTail)
|
|
/// \endcond
|
|
public:
|
|
QCPItemCurve(QCustomPlot *parentPlot);
|
|
virtual ~QCPItemCurve();
|
|
|
|
// getters:
|
|
QPen pen() const { return mPen; }
|
|
QPen selectedPen() const { return mSelectedPen; }
|
|
QCPLineEnding head() const { return mHead; }
|
|
QCPLineEnding tail() const { return mTail; }
|
|
|
|
// setters;
|
|
void setPen(const QPen &pen);
|
|
void setSelectedPen(const QPen &pen);
|
|
void setHead(const QCPLineEnding &head);
|
|
void setTail(const QCPLineEnding &tail);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
QCPItemPosition * const start;
|
|
QCPItemPosition * const startDir;
|
|
QCPItemPosition * const endDir;
|
|
QCPItemPosition * const end;
|
|
|
|
protected:
|
|
// property members:
|
|
QPen mPen, mSelectedPen;
|
|
QCPLineEnding mHead, mTail;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void draw(QCPPainter *painter);
|
|
|
|
// non-virtual methods:
|
|
QPen mainPen() const;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPItemRect : public QCPAbstractItem
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(QPen pen READ pen WRITE setPen)
|
|
Q_PROPERTY(QPen selectedPen READ selectedPen WRITE setSelectedPen)
|
|
Q_PROPERTY(QBrush brush READ brush WRITE setBrush)
|
|
Q_PROPERTY(QBrush selectedBrush READ selectedBrush WRITE setSelectedBrush)
|
|
/// \endcond
|
|
public:
|
|
QCPItemRect(QCustomPlot *parentPlot);
|
|
virtual ~QCPItemRect();
|
|
|
|
// getters:
|
|
QPen pen() const { return mPen; }
|
|
QPen selectedPen() const { return mSelectedPen; }
|
|
QBrush brush() const { return mBrush; }
|
|
QBrush selectedBrush() const { return mSelectedBrush; }
|
|
|
|
// setters;
|
|
void setPen(const QPen &pen);
|
|
void setSelectedPen(const QPen &pen);
|
|
void setBrush(const QBrush &brush);
|
|
void setSelectedBrush(const QBrush &brush);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
QCPItemPosition * const topLeft;
|
|
QCPItemPosition * const bottomRight;
|
|
QCPItemAnchor * const top;
|
|
QCPItemAnchor * const topRight;
|
|
QCPItemAnchor * const right;
|
|
QCPItemAnchor * const bottom;
|
|
QCPItemAnchor * const bottomLeft;
|
|
QCPItemAnchor * const left;
|
|
|
|
protected:
|
|
enum AnchorIndex {aiTop, aiTopRight, aiRight, aiBottom, aiBottomLeft, aiLeft};
|
|
|
|
// property members:
|
|
QPen mPen, mSelectedPen;
|
|
QBrush mBrush, mSelectedBrush;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void draw(QCPPainter *painter);
|
|
virtual QPointF anchorPixelPoint(int anchorId) const;
|
|
|
|
// non-virtual methods:
|
|
QPen mainPen() const;
|
|
QBrush mainBrush() const;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPItemText : public QCPAbstractItem
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(QColor color READ color WRITE setColor)
|
|
Q_PROPERTY(QColor selectedColor READ selectedColor WRITE setSelectedColor)
|
|
Q_PROPERTY(QPen pen READ pen WRITE setPen)
|
|
Q_PROPERTY(QPen selectedPen READ selectedPen WRITE setSelectedPen)
|
|
Q_PROPERTY(QBrush brush READ brush WRITE setBrush)
|
|
Q_PROPERTY(QBrush selectedBrush READ selectedBrush WRITE setSelectedBrush)
|
|
Q_PROPERTY(QFont font READ font WRITE setFont)
|
|
Q_PROPERTY(QFont selectedFont READ selectedFont WRITE setSelectedFont)
|
|
Q_PROPERTY(QString text READ text WRITE setText)
|
|
Q_PROPERTY(Qt::Alignment positionAlignment READ positionAlignment WRITE setPositionAlignment)
|
|
Q_PROPERTY(Qt::Alignment textAlignment READ textAlignment WRITE setTextAlignment)
|
|
Q_PROPERTY(double rotation READ rotation WRITE setRotation)
|
|
Q_PROPERTY(QMargins padding READ padding WRITE setPadding)
|
|
/// \endcond
|
|
public:
|
|
QCPItemText(QCustomPlot *parentPlot);
|
|
virtual ~QCPItemText();
|
|
|
|
// getters:
|
|
QColor color() const { return mColor; }
|
|
QColor selectedColor() const { return mSelectedColor; }
|
|
QPen pen() const { return mPen; }
|
|
QPen selectedPen() const { return mSelectedPen; }
|
|
QBrush brush() const { return mBrush; }
|
|
QBrush selectedBrush() const { return mSelectedBrush; }
|
|
QFont font() const { return mFont; }
|
|
QFont selectedFont() const { return mSelectedFont; }
|
|
QString text() const { return mText; }
|
|
Qt::Alignment positionAlignment() const { return mPositionAlignment; }
|
|
Qt::Alignment textAlignment() const { return mTextAlignment; }
|
|
double rotation() const { return mRotation; }
|
|
QMargins padding() const { return mPadding; }
|
|
|
|
// setters;
|
|
void setColor(const QColor &color);
|
|
void setSelectedColor(const QColor &color);
|
|
void setPen(const QPen &pen);
|
|
void setSelectedPen(const QPen &pen);
|
|
void setBrush(const QBrush &brush);
|
|
void setSelectedBrush(const QBrush &brush);
|
|
void setFont(const QFont &font);
|
|
void setSelectedFont(const QFont &font);
|
|
void setText(const QString &text);
|
|
void setPositionAlignment(Qt::Alignment alignment);
|
|
void setTextAlignment(Qt::Alignment alignment);
|
|
void setRotation(double degrees);
|
|
void setPadding(const QMargins &padding);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
QCPItemPosition * const position;
|
|
QCPItemAnchor * const topLeft;
|
|
QCPItemAnchor * const top;
|
|
QCPItemAnchor * const topRight;
|
|
QCPItemAnchor * const right;
|
|
QCPItemAnchor * const bottomRight;
|
|
QCPItemAnchor * const bottom;
|
|
QCPItemAnchor * const bottomLeft;
|
|
QCPItemAnchor * const left;
|
|
|
|
protected:
|
|
enum AnchorIndex {aiTopLeft, aiTop, aiTopRight, aiRight, aiBottomRight, aiBottom, aiBottomLeft, aiLeft};
|
|
|
|
// property members:
|
|
QColor mColor, mSelectedColor;
|
|
QPen mPen, mSelectedPen;
|
|
QBrush mBrush, mSelectedBrush;
|
|
QFont mFont, mSelectedFont;
|
|
QString mText;
|
|
Qt::Alignment mPositionAlignment;
|
|
Qt::Alignment mTextAlignment;
|
|
double mRotation;
|
|
QMargins mPadding;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void draw(QCPPainter *painter);
|
|
virtual QPointF anchorPixelPoint(int anchorId) const;
|
|
|
|
// non-virtual methods:
|
|
QPointF getTextDrawPoint(const QPointF &pos, const QRectF &rect, Qt::Alignment positionAlignment) const;
|
|
QFont mainFont() const;
|
|
QColor mainColor() const;
|
|
QPen mainPen() const;
|
|
QBrush mainBrush() const;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPItemEllipse : public QCPAbstractItem
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(QPen pen READ pen WRITE setPen)
|
|
Q_PROPERTY(QPen selectedPen READ selectedPen WRITE setSelectedPen)
|
|
Q_PROPERTY(QBrush brush READ brush WRITE setBrush)
|
|
Q_PROPERTY(QBrush selectedBrush READ selectedBrush WRITE setSelectedBrush)
|
|
/// \endcond
|
|
public:
|
|
QCPItemEllipse(QCustomPlot *parentPlot);
|
|
virtual ~QCPItemEllipse();
|
|
|
|
// getters:
|
|
QPen pen() const { return mPen; }
|
|
QPen selectedPen() const { return mSelectedPen; }
|
|
QBrush brush() const { return mBrush; }
|
|
QBrush selectedBrush() const { return mSelectedBrush; }
|
|
|
|
// setters;
|
|
void setPen(const QPen &pen);
|
|
void setSelectedPen(const QPen &pen);
|
|
void setBrush(const QBrush &brush);
|
|
void setSelectedBrush(const QBrush &brush);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
QCPItemPosition * const topLeft;
|
|
QCPItemPosition * const bottomRight;
|
|
QCPItemAnchor * const topLeftRim;
|
|
QCPItemAnchor * const top;
|
|
QCPItemAnchor * const topRightRim;
|
|
QCPItemAnchor * const right;
|
|
QCPItemAnchor * const bottomRightRim;
|
|
QCPItemAnchor * const bottom;
|
|
QCPItemAnchor * const bottomLeftRim;
|
|
QCPItemAnchor * const left;
|
|
QCPItemAnchor * const center;
|
|
|
|
protected:
|
|
enum AnchorIndex {aiTopLeftRim, aiTop, aiTopRightRim, aiRight, aiBottomRightRim, aiBottom, aiBottomLeftRim, aiLeft, aiCenter};
|
|
|
|
// property members:
|
|
QPen mPen, mSelectedPen;
|
|
QBrush mBrush, mSelectedBrush;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void draw(QCPPainter *painter);
|
|
virtual QPointF anchorPixelPoint(int anchorId) const;
|
|
|
|
// non-virtual methods:
|
|
QPen mainPen() const;
|
|
QBrush mainBrush() const;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPItemPixmap : public QCPAbstractItem
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(QPixmap pixmap READ pixmap WRITE setPixmap)
|
|
Q_PROPERTY(bool scaled READ scaled WRITE setScaled)
|
|
Q_PROPERTY(Qt::AspectRatioMode aspectRatioMode READ aspectRatioMode)
|
|
Q_PROPERTY(Qt::TransformationMode transformationMode READ transformationMode)
|
|
Q_PROPERTY(QPen pen READ pen WRITE setPen)
|
|
Q_PROPERTY(QPen selectedPen READ selectedPen WRITE setSelectedPen)
|
|
/// \endcond
|
|
public:
|
|
QCPItemPixmap(QCustomPlot *parentPlot);
|
|
virtual ~QCPItemPixmap();
|
|
|
|
// getters:
|
|
QPixmap pixmap() const { return mPixmap; }
|
|
bool scaled() const { return mScaled; }
|
|
Qt::AspectRatioMode aspectRatioMode() const { return mAspectRatioMode; }
|
|
Qt::TransformationMode transformationMode() const { return mTransformationMode; }
|
|
QPen pen() const { return mPen; }
|
|
QPen selectedPen() const { return mSelectedPen; }
|
|
|
|
// setters;
|
|
void setPixmap(const QPixmap &pixmap);
|
|
void setScaled(bool scaled, Qt::AspectRatioMode aspectRatioMode=Qt::KeepAspectRatio, Qt::TransformationMode transformationMode=Qt::SmoothTransformation);
|
|
void setPen(const QPen &pen);
|
|
void setSelectedPen(const QPen &pen);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
QCPItemPosition * const topLeft;
|
|
QCPItemPosition * const bottomRight;
|
|
QCPItemAnchor * const top;
|
|
QCPItemAnchor * const topRight;
|
|
QCPItemAnchor * const right;
|
|
QCPItemAnchor * const bottom;
|
|
QCPItemAnchor * const bottomLeft;
|
|
QCPItemAnchor * const left;
|
|
|
|
protected:
|
|
enum AnchorIndex {aiTop, aiTopRight, aiRight, aiBottom, aiBottomLeft, aiLeft};
|
|
|
|
// property members:
|
|
QPixmap mPixmap;
|
|
QPixmap mScaledPixmap;
|
|
bool mScaled;
|
|
Qt::AspectRatioMode mAspectRatioMode;
|
|
Qt::TransformationMode mTransformationMode;
|
|
QPen mPen, mSelectedPen;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void draw(QCPPainter *painter);
|
|
virtual QPointF anchorPixelPoint(int anchorId) const;
|
|
|
|
// non-virtual methods:
|
|
void updateScaledPixmap(QRect finalRect=QRect(), bool flipHorz=false, bool flipVert=false);
|
|
QRect getFinalRect(bool *flippedHorz=0, bool *flippedVert=0) const;
|
|
QPen mainPen() const;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPItemTracer : public QCPAbstractItem
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(QPen pen READ pen WRITE setPen)
|
|
Q_PROPERTY(QPen selectedPen READ selectedPen WRITE setSelectedPen)
|
|
Q_PROPERTY(QBrush brush READ brush WRITE setBrush)
|
|
Q_PROPERTY(QBrush selectedBrush READ selectedBrush WRITE setSelectedBrush)
|
|
Q_PROPERTY(double size READ size WRITE setSize)
|
|
Q_PROPERTY(TracerStyle style READ style WRITE setStyle)
|
|
Q_PROPERTY(QCPGraph* graph READ graph WRITE setGraph)
|
|
Q_PROPERTY(double graphKey READ graphKey WRITE setGraphKey)
|
|
Q_PROPERTY(bool interpolating READ interpolating WRITE setInterpolating)
|
|
/// \endcond
|
|
public:
|
|
/*!
|
|
The different visual appearances a tracer item can have. Some styles size may be controlled with \ref setSize.
|
|
|
|
\see setStyle
|
|
*/
|
|
enum TracerStyle { tsNone ///< The tracer is not visible
|
|
,tsPlus ///< A plus shaped crosshair with limited size
|
|
,tsCrosshair ///< A plus shaped crosshair which spans the complete axis rect
|
|
,tsCircle ///< A circle
|
|
,tsSquare ///< A square
|
|
};
|
|
Q_ENUMS(TracerStyle)
|
|
|
|
QCPItemTracer(QCustomPlot *parentPlot);
|
|
virtual ~QCPItemTracer();
|
|
|
|
// getters:
|
|
QPen pen() const { return mPen; }
|
|
QPen selectedPen() const { return mSelectedPen; }
|
|
QBrush brush() const { return mBrush; }
|
|
QBrush selectedBrush() const { return mSelectedBrush; }
|
|
double size() const { return mSize; }
|
|
TracerStyle style() const { return mStyle; }
|
|
QCPGraph *graph() const { return mGraph; }
|
|
double graphKey() const { return mGraphKey; }
|
|
bool interpolating() const { return mInterpolating; }
|
|
|
|
// setters;
|
|
void setPen(const QPen &pen);
|
|
void setSelectedPen(const QPen &pen);
|
|
void setBrush(const QBrush &brush);
|
|
void setSelectedBrush(const QBrush &brush);
|
|
void setSize(double size);
|
|
void setStyle(TracerStyle style);
|
|
void setGraph(QCPGraph *graph);
|
|
void setGraphKey(double key);
|
|
void setInterpolating(bool enabled);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
// non-virtual methods:
|
|
void updatePosition();
|
|
|
|
QCPItemPosition * const position;
|
|
|
|
protected:
|
|
// property members:
|
|
QPen mPen, mSelectedPen;
|
|
QBrush mBrush, mSelectedBrush;
|
|
double mSize;
|
|
TracerStyle mStyle;
|
|
QCPGraph *mGraph;
|
|
double mGraphKey;
|
|
bool mInterpolating;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void draw(QCPPainter *painter);
|
|
|
|
// non-virtual methods:
|
|
QPen mainPen() const;
|
|
QBrush mainBrush() const;
|
|
};
|
|
|
|
|
|
class QCP_LIB_DECL QCPItemBracket : public QCPAbstractItem
|
|
{
|
|
Q_OBJECT
|
|
/// \cond INCLUDE_QPROPERTIES
|
|
Q_PROPERTY(QPen pen READ pen WRITE setPen)
|
|
Q_PROPERTY(QPen selectedPen READ selectedPen WRITE setSelectedPen)
|
|
Q_PROPERTY(double length READ length WRITE setLength)
|
|
Q_PROPERTY(BracketStyle style READ style WRITE setStyle)
|
|
/// \endcond
|
|
public:
|
|
enum BracketStyle { bsSquare ///< A brace with angled edges
|
|
,bsRound ///< A brace with round edges
|
|
,bsCurly ///< A curly brace
|
|
,bsCalligraphic ///< A curly brace with varying stroke width giving a calligraphic impression
|
|
};
|
|
|
|
QCPItemBracket(QCustomPlot *parentPlot);
|
|
virtual ~QCPItemBracket();
|
|
|
|
// getters:
|
|
QPen pen() const { return mPen; }
|
|
QPen selectedPen() const { return mSelectedPen; }
|
|
double length() const { return mLength; }
|
|
BracketStyle style() const { return mStyle; }
|
|
|
|
// setters;
|
|
void setPen(const QPen &pen);
|
|
void setSelectedPen(const QPen &pen);
|
|
void setLength(double length);
|
|
void setStyle(BracketStyle style);
|
|
|
|
// reimplemented virtual methods:
|
|
virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const;
|
|
|
|
QCPItemPosition * const left;
|
|
QCPItemPosition * const right;
|
|
QCPItemAnchor * const center;
|
|
|
|
protected:
|
|
// property members:
|
|
enum AnchorIndex {aiCenter};
|
|
QPen mPen, mSelectedPen;
|
|
double mLength;
|
|
BracketStyle mStyle;
|
|
|
|
// reimplemented virtual methods:
|
|
virtual void draw(QCPPainter *painter);
|
|
virtual QPointF anchorPixelPoint(int anchorId) const;
|
|
|
|
// non-virtual methods:
|
|
QPen mainPen() const;
|
|
};
|
|
|
|
// Legend Title - Added to Wireshark
|
|
// From: http://www.qcustomplot.com/index.php/support/forum/443
|
|
|
|
class QCPStringLegendItem : public QCPAbstractLegendItem
|
|
{
|
|
Q_OBJECT
|
|
|
|
public:
|
|
explicit QCPStringLegendItem(QCPLegend *pParent, const QString& strText);
|
|
|
|
QString text() const;
|
|
void setText(const QString& strText);
|
|
|
|
protected:
|
|
virtual void draw(QCPPainter *painter);
|
|
virtual QSize minimumSizeHint() const;
|
|
|
|
private:
|
|
QString m_strText;
|
|
};
|
|
|
|
#endif // QCUSTOMPLOT_H
|
|
|