QCustomplot 图

最新推荐文章于 2024-10-15 13:28:34 发布

小玩龙

最新推荐文章于 2024-10-15 13:28:34 发布

阅读量1.3k

点赞数

分类专栏： Qt

原文链接：https://www.cnblogs.com/swarmbees/p/6057798.html

版权

Qt 专栏收录该内容

16 篇文章 15 订阅

订阅专栏

一、可以实现的图

相对于其他绘制图表的第三方库来说，QCustomPlot算是比较轻量的，不仅仅能实现功能，而且二次开发比较容易。下面我们来具体说下他可以实现那些图

QCPGraph：折线图，LineStyle枚举可以设置折线图绘制的风格，主要区别是两点间连线的方式，常规的方式就是直连，其他还有L型、Z型等，如图1所示，都是折线图，只是设置了不同的折线参数；QCPScatterStyle枚举用于设置节点类型，包括：圆形、三角形等，如图2所示。
QCPBars：柱状图，如图3所示
QCPFinancial：蜡烛图，主要用于展示股票k线图，如图4所示。
其他图表还包括：色谱图(QCPColorMap)、统计箱(QCPStatisticalBox)、参数曲线(QCPCurve)，这几个图我就不单独贴图说明了，想看效果的同学可以去QCustomplot使用分享(一) 能做什么事查看。

二、效果预览

这里我在单独贴出来QCustomPlot可以实现的图表，或者点击QCustomplot使用分享(一) 能做什么事，这篇文章里有一个gif图，图中包含所有的图。

图1 折线图

图2 折线图

图3 柱状图

图4 蜡烛图

三、数据存储

因为本篇文章是基于QCustomPlot2.0.0beta版本分析，如果有同学发现和自己手头的源码有出入，首先看下源码版本是否一致，如果源码版本一致，但是和我说的有出入，欢迎指正。

一个关键的模板类QCPDataContainer，提供了一些基础的数据操作方法，例如：设置数据、新增数据、按键移除数据、清空、排序和查找等一些的方法，这个类出现的原因主要在于图和图仅仅是存储的数据类型不同，但是他们对这些数据操作时的接口基本相同，而这个类的功能就是把这些公有的接口提取出来，如果那个图表需要这样的数据存储，只需要用这个类来存储，类的模板参数指明具体的存储数据类型即可。

因为不同的表只是数据存储格式不一样，而他们对数据的接口操作已经被QCPDataContainer类抽象到一起了，比如：折线图数据存储类QCPGraphData、柱状图数据存储类QCPBarsData等，当他们使用数据存储的时候会像这样QCPDataContainer<QCPGraphData>和QCPDataContainer<QCPBarsData>来声明对象。

这个时候呢抽象还没有结束，因为所有的绘图类仅仅是提供的接口参数不一样，就像最终存储数据的结构不一样似的，比如折线图可能会像addData(QCPGraphData)，柱状图可能会像addData(QCPBarsData)，但是这些接口里实现的时候调用的操作完全是一样的，这个时候又出现了一个操作的抽象接口类QCPPlottableInterface1D，这个类的实现类是QCPAbstractPlottable1D，其中包含了一个QCPDataContainer指针，存储着具体的图表类型数据，他的声明可能会像下边这样

template <class DataType>//该类在被继承的时候初始化该参数，一般设置为图表存储的数据类型
class QCP_LIB_DECL QCPAbstractPlottable1D : public QCPAbstractPlottable, public QCPPlottableInterface1D
{
    // No Q_OBJECT macro due to template class

public:
    QCPAbstractPlottable1D(QCPAxis *keyAxis, QCPAxis *valueAxis);
    virtual ~QCPAbstractPlottable1D();

    // virtual methods of 1d plottable interface:
    virtual int dataCount() const;
    virtual double dataMainKey(int index) const;
    virtual double dataSortKey(int index) const;
    virtual double dataMainValue(int index) const;
    virtual QCPRange dataValueRange(int index) const;
    virtual QPointF dataPixelPosition(int index) const;
    virtual bool sortKeyIsMainKey() const;
    virtual QCPDataSelection selectTestRect(const QRectF &rect, bool onlySelectable) const;
    virtual int findBegin(double sortKey, bool expandedRange = true) const;
    virtual int findEnd(double sortKey, bool expandedRange = true) const;

    // virtual methods:
    virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details = 0) const;
    virtual QCPPlottableInterface1D *interface1D() { return this; }

protected:
    // property members:
    QSharedPointer<QCPDataContainer<DataType> > mDataContainer;//数据存储容器，提供了绝大多数的操作

    // helpers for subclasses:
    void getDataSegments(QList<QCPDataRange> &selectedSegments, QList<QCPDataRange> &unselectedSegments) const;
    void drawPolyline(QCPPainter *painter, const QVector<QPointF> &lineData) const;

private:
    Q_DISABLE_COPY(QCPAbstractPlottable1D)
};

    说到这里可能大家还是迷迷糊糊，那么接下来我们就上一个QCPGraph类的添加数据接口代码展示，大家一看就一目了然了。虽然QCPDataContainer容器类给我们提供了很多接口，但是有些接口的返回值我们是拿不到的，比如说begine和end指针地址，但是QCPPlottableInterface1D类帮助我们拿到了，因为我们所有的图表类都是该类的子类，我们都可以使用其中的方法，具体的可以自行查看QCPPlottableInterface1D接口类的实现类QCPAbstractPlottable1D

void QCPGraph::addData(const QVector<double> &keys, const QVector<double> &values, bool alreadySorted)
{
    if (keys.size() != values.size())
        qDebug() << Q_FUNC_INFO << "keys and values have different sizes:" << keys.size() << values.size();
    const int n = qMin(keys.size(), values.size());
    QVector<QCPGraphData> tempData(n);
    QVector<QCPGraphData>::iterator it = tempData.begin();
    const QVector<QCPGraphData>::iterator itEnd = tempData.end();
    int i = 0;
    while (it != itEnd)
    {
        it->key = keys[i];
        it->value = values[i];
        ++it;
        ++i;
    }
    mDataContainer->add(tempData, alreadySorted); // 这个add接口其实就是QCPDataContainer类提供的，
}

上边的这个数据存储抽象其实在QCustomPlot1.3.2发布版本中是没有的，不过我觉着这一部分做的挺不错的，不仅简化了代码，而且可维护性更强。

四、一个简单的示例

QCustomPlot的接口封装还是比较易懂的，那我在这里也就不一一举例说明每个图表的使用方法了，下面是折线图的简单用法，对应的效果图是图1

ui.widget_12->legend->setVisible(true);
    ui.widget_12->legend->setFont(QFont("Helvetica", 9));
    QPen pen;
    QStringList lineNames;//设置图例的文本
    lineNames << "lsNone" << "lsLine" << "lsStepLeft" << "lsStepRight" << "lsStepCenter" << "lsImpulse";
    // add graphs with different line styles:
    for (int i = QCPGraph::lsNone; i <= QCPGraph::lsImpulse; ++i)
    {
        ui.widget_12->addGraph();
        pen.setColor(QColor(qSin(i * 1 + 1.2) * 80 + 80, qSin(i*0.3 + 0) * 80 + 80, qSin(i*0.3 + 1.5) * 80 + 80));
        ui.widget_12->graph()->setPen(pen);
        ui.widget_12->graph()->setName(lineNames.at(i - QCPGraph::lsNone));
        ui.widget_12->graph()->setLineStyle((QCPGraph::LineStyle)i);//设置线性
        ui.widget_12->graph()->setScatterStyle(QCPScatterStyle(QCPScatterStyle::ssCircle, 5));//设置每个节点数据绘制风格，默认是空，这里设置为空心圆
        // generate data:
        QVector<double> x(15), y(15);
        for (int j = 0; j < 15; ++j)
        {
            x[j] = j / 15.0 * 5 * 3.14 + 0.01;
            y[j] = 7 * qSin(x[j]) / x[j] - (i - QCPGraph::lsNone) * 5 + (QCPGraph::lsImpulse) * 5 + 2;
        }
        ui.widget_12->graph()->setData(x, y);
        ui.widget_12->graph()->rescaleAxes(true);//坐标轴自适应
    }
    // zoom out a bit:
    ui.widget_12->yAxis->scaleRange(1.1, ui.widget_12->yAxis->range().center());
    ui.widget_12->xAxis->scaleRange(1.1, ui.widget_12->xAxis->range().center());
    // set blank axis lines:
    ui.widget_12->xAxis->setTicks(false);//x轴不显示刻度
    ui.widget_12->yAxis->setTicks(true);//y轴显示刻度
    ui.widget_12->xAxis->setTickLabels(false);//x轴不显示文本
    ui.widget_12->yAxis->setTickLabels(true);//y轴显示文本
    // make top right axes clones of bottom left axes:
    ui.widget_12->axisRect()->setupFullAxesBox();一个默认的坐标轴矩形配置，包括：顶部坐标轴跟随底部坐标轴同步、右侧坐标轴跟随左侧坐标轴同步，不仅仅是坐标轴范围跟随同步，包括文本精度、文本格式、坐标轴类型、是否自动生成刻度、刻度间距等等。