QCustomplot使用分享(七) 层(完结)

2023-06-07,,

一、分层绘制

一直说要讲2.0.0版本,但总是想把1.3.2版本拿出来比较一下,这篇文章也不例外。QCustomPlot2.0.0beta版本比1.3.2release版本有一个很大的改进那就是分层绘制,所谓分层绘制就是把一张图分几张图来绘制,最后在把这分开的几张图统一绘制到一张图上,比如一张图A,需要分开成3张图B、C和D来绘制,当图A需要重新绘制时,我们一次判断B、C和D是否需要重新绘制,如果不需要绘制的我们直接把图贴到A上,那就很大的减少了重新绘制的时间,而这部分时间其实是没有必要花费的。

二、QCustomPlot的层

QCustomPlot默认提供了6个层,如下代码所示,分别是:背景层、网格层、主层、坐标轴层、图例层和矩形选择区域层。

 mLayers.append(new QCPLayer(this, QLatin1String("background")));
mLayers.append(new QCPLayer(this, QLatin1String("grid")));
mLayers.append(new QCPLayer(this, QLatin1String("main")));
mLayers.append(new QCPLayer(this, QLatin1String("axes")));
mLayers.append(new QCPLayer(this, QLatin1String("legend")));
mLayers.append(new QCPLayer(this, QLatin1String("overlay")));

背景层:绘制背景图
网格层:绘制网格线,每一个坐标轴对应一个网格对象
主层:绘制图表
坐标轴层:绘制坐标轴
图例层:绘制图例
overlay层:绘制最上层的东西,这一层在1.3.2版本时没有。鼠标选择矩形框在此层绘制。可以参考QCustomplot使用分享(五) 布局文章中图1

实现分层绘制的关键类QCPAbstractPaintBuffer,这是一个抽象基类,通过该类可以拿到一个QCPPainter指针,然后绘制东西的时候,都会绘制在这个指针所指的绘图设备上。QCPAbstractPaintBuffer类一共有3个子类,分别是QCPPaintBufferPixmap、QCPPaintBufferGlPbuffer和QCPPaintBufferGlFbo,这3个类分别使用了不同绘图技术来实现分层绘制。默认使用的是QCPPaintBufferPixmap来绘制,如果想使用QCPPaintBufferGlPbuffer或者QCPPaintBufferGlFbo来绘制,首先要使用setOpenGl接口打开使用opengl开关,然后定义QCP_OPENGL_FBO宏来默认使用QCPPaintBufferGlFbo绘制,或者定义QCP_OPENGL_PBUFFER宏来让默认使用QCPPaintBufferGlPbuffer方式绘制

三、QCPLayer

下图所示是QCPLayer图层类的部分头文件,代码里的大多数成员变量和成员方法我都给出了注释,大家看看并仔细揣摩一下,应该就基本能理解了。

 class QCP_LIB_DECL QCPLayer : public QObject
{
enum LayerMode {//分层绘制原理
lmLogical ///< Layer is used only for rendering order, and shares paint buffer with all other adjacent logical layers.
, lmBuffered ///< Layer has its own paint buffer and may be replotted individually (see \ref replot).
}; QCPLayer(QCustomPlot* parentPlot, const QString &layerName);
virtual ~QCPLayer(); // setters:
void setVisible(bool visible);//设置层是否可见
void setMode(LayerMode mode);//绘制时,painter使用模式 // non-virtual methods:
void replot();//重新绘制层 protected:
QCustomPlot *mParentPlot;//所在图表
QString mName;//层名称
int mIndex;//层序,决定绘制先后顺序
QList<QCPLayerable*> mChildren;//层中所有元素
bool mVisible;//是否可见标记
LayerMode mMode;//绘制模式标记 // non-property members:
QWeakPointer<QCPAbstractPaintBuffer> mPaintBuffer;//绘制缓冲区 // non-virtual methods:
void draw(QCPPainter *painter);//使用painter绘制
void drawToPaintBuffer();//绘制到缓冲区
void addChild(QCPLayerable *layerable, bool prepend);//新增元素
void removeChild(QCPLayerable *layerable);//移除元素
};

四、自定义层

如图1中所示的黑色十字线,就是我在自定义层中绘制的,下面我将我实现的代码贴出来

图1

实现头文件

 class CrossLinePlot : public  QCPLayerable
{
Q_OBJECT
signals :
void DrawCrossLine(const QPoint & pos); public:
CrossLinePlot(PlotCallback * basePlot, QCustomPlot * plot);
~CrossLinePlot(); public:
QString LayerName() const;//层名称
void SetVisible(bool visible);//设置层是否绘制 void SetPen(const QPen & pen);/设置十字线画笔 bool MouseButtonDown() const ;
bool GetLineVisible(QCP::LineState line) const;
void SetLineShow(QCP::LineState lines);//设置线是否显示 //十字线同步注册接口
bool RegisiterBortherLine(CrossLinePlot * line);
bool UnregisiterBortherLine(CrossLinePlot * line); protected:
virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const{};
virtual void draw(QCPPainter * painter); private:
void DrawLine(QCPAxis * axis, Qt::Orientation orientation);//画指定方向的坐标轴十字线(严格来说应该是一部分,一条线)
void SyncLinePosition(const QPoint & pos, double x);//同步线位置 private slots:
void MouseMoveHandle(QMouseEvent * event); private:
QScopedPointer<CrossLinePlotPrivate> d_ptr;
static std::vector<CrossLinePlot *> m_BrotherLine;//同步其他十字线
};

实现文件

 std::vector<CrossLinePlot *>CrossLinePlot::m_BrotherLine;

 struct CrossLinePlotPrivate
{
QCP::LineStates m_bIsVisible;
bool m_bLeftButtonPress = false;
double m_dAxisXValue = -;
QPoint m_MousePoint;
QCPPainter * m_pPainter = nullptr;
QPen m_Pen = QPen(Qt::black, , Qt::DashDotLine);
PlotCallback * m_pParentPlot = nullptr;
}; CrossLinePlot::CrossLinePlot(PlotCallback * basePlot, QCustomPlot * plot)
: QCPLayerable(plot)
, d_ptr(new CrossLinePlotPrivate)
{
d_ptr->m_pParentPlot = basePlot;
mParentPlot->addLayer(LayerName()); setLayer(LayerName()); connect(mParentPlot, &QCustomPlot::mousePress, this, [this](QMouseEvent * event){
if (event->button() & Qt::LeftButton)
{
d_ptr->m_bLeftButtonPress = true;
}
});
connect(mParentPlot, &QCustomPlot::mouseRelease, this, [this](QMouseEvent * event){
if (event->button() & Qt::LeftButton)
{
d_ptr->m_bLeftButtonPress = false;
}
});
connect(mParentPlot, &QCustomPlot::mouseMove, this, &CrossLinePlot::MouseMoveHandle); QVector<qreal> dashes;
qreal space = ;
dashes << << space << << space;
d_ptr->m_Pen.setDashPattern(dashes);
} CrossLinePlot::~CrossLinePlot()
{ } QString CrossLinePlot::LayerName() const
{
return QStringLiteral("crossline");
} void CrossLinePlot::SetVisible(bool visible)
{
QCPLayer * layer = mParentPlot->layer(LayerName());
if (layer)
{
layer->setVisible(visible);
}
} void CrossLinePlot::SetPen(const QPen & pen)
{
d_ptr->m_Pen = pen;
} bool CrossLinePlot::MouseButtonDown() const
{
return d_ptr->m_bLeftButtonPress;
} bool CrossLinePlot::GetLineVisible(QCP::LineState line) const
{
switch (line)
{
case Qt::Horizontal:
return d_ptr->m_bIsVisible.testFlag(QCP::E_Horizontal);
break;
case Qt::Vertical:
return d_ptr->m_bIsVisible.testFlag(QCP::E_Vertical);
break;
} return false;
} void CrossLinePlot::SetLineShow(QCP::LineState lines)
{
switch (lines)
{
case QCP::E_NULL:
d_ptr->m_bIsVisible = QCP::E_NULL;
break;
case QCP::E_Horizontal:
d_ptr->m_bIsVisible = QCP::E_Horizontal;
break;
case QCP::E_Vertical:
d_ptr->m_bIsVisible = QCP::E_Vertical;
break;
case QCP::E_ALL:
d_ptr->m_bIsVisible = QCP::E_ALL;
break;
} if (QCPLayer * layer = mParentPlot->layer(LayerName()))
{
layer->replot();
} if (d_ptr->m_bIsVisible == QCP::E_NULL)
{
for (CrossLinePlot * crossline : CrossLinePlot::m_BrotherLine)
{
if (crossline != this)
{
crossline->SyncLinePosition(QPoint(), d_ptr->m_dAxisXValue);
}
}
}
}

有兴趣的同学可以自行看实现文件,代码都不难理解

五、相关文章

  QCustomplot使用分享(一) 能做什么事

  QCustomplot使用分享(二) 源码解读

  QCustomplot使用分享(三) 图

  QCustomplot使用分享(四) QCPAbstractItem

  QCustomplot使用分享(五) 布局

  QCustomplot使用分享(六) 坐标轴和网格线

六、总结

这是QCustomPlot的第7篇文章了,按照我第二篇文章描述的那样,从QCustomplot使用分享(二) 源码解读、QCustomplot使用分享(三) 图   折线、参数曲线、蜡烛图、柱状图、面积图、QCustomplot使用分享(四) QCPAbstractItem、QCustomplot使用分享(五) 布局、QCustomplot使用分享(六) 坐标轴  网格线和QCustomplot使用分享(七) 层等这几个方面对QCustomPlot做了一个分析,其实还有很多细节我没有说到的地方。

虽然我使用QCustomPlot库的时间不长,但是用了3天的时间我把QCustomPlot的使用或者说是心得记录了下来,这几篇文章在写的过程中,也是自我回忆、自我重新理解的一个过程,说实话写完这几篇文章我还是收获挺大的,最起码能连贯的把这个源码库融合起来,现在在回想起这个库我就会觉得脑子里已经有了一个大概的图,也可以说是一幅画,基本的功能模块大体掌握,如果这时候给我一个需求,那我可能会更好的理解这个需求,更好的去在合适的地方更合理的完成这个需求。

七、示例下载

  基于QCustomPlot1.3.2的二次开发

  基于QCustomPlot2.0.0的二次开发

如果您觉得文章不错,不妨给个打赏,写作不易,感谢各位的支持。您的支持是我最大的动力,谢谢!!! 


 


很重要--转载声明

    本站文章无特别说明,皆为原创,版权所有,转载时请用链接的方式,给出原文出处。同时写上原作者:朝十晚八 or Twowords
    如要转载,请原文转载,如在转载时修改本文,请事先告知,谢绝在转载时通过修改本文达到有利于转载者的目的。

奋斗中的无名小卒。。。

QCustomplot使用分享(七) 层(完结)的相关教程结束。

《QCustomplot使用分享(七) 层(完结).doc》

下载本文的Word格式文档,以方便收藏与打印。