From 40a3558323df3f7307faed5d8005b9850506dbff Mon Sep 17 00:00:00 2001 From: feiyangqingyun Date: Fri, 10 Dec 2021 20:23:28 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E8=B6=85=E7=BA=A7=E6=9B=B2?= =?UTF-8?q?=E7=BA=BF=E5=9B=BE=E8=A1=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 5 +- third/0snap/qcustomplotdemo1.jpg | Bin 93353 -> 89825 bytes third/0snap/qcustomplotdemo2.jpg | Bin 64577 -> 85489 bytes third/0snap/qcustomplotdemo3.jpg | Bin 67151 -> 93472 bytes third/0snap/qcustomplotdemo4.jpg | Bin 69799 -> 66951 bytes third/0snap/qcustomplotdemo5.jpg | Bin 74525 -> 67746 bytes third/0snap/qcustomplotdemo6.jpg | Bin 0 -> 71388 bytes third/0snap/qcustomplotdemo7.jpg | Bin 0 -> 74683 bytes third/0snap/qcustomplotdemo8.jpg | Bin 0 -> 111636 bytes third/3rd_qcustomplot/3rd_qcustomplot.pri | 36 +- third/3rd_qcustomplot/v1_3/qcustomplot.cpp | 23553 ++++++++++++ third/3rd_qcustomplot/v1_3/qcustomplot.h | 3768 ++ third/3rd_qcustomplot/v2_0/qcustomplot.cpp | 30214 ++++++++++++++++ third/3rd_qcustomplot/v2_0/qcustomplot.h | 6673 ++++ .../{ => v2_1}/qcustomplot.cpp | 0 .../3rd_qcustomplot/{ => v2_1}/qcustomplot.h | 0 third/3rd_qcustomplot/v2_1_6/qcustomplot.h | 7722 ++++ third/qcustomplotdemo/data/data0.txt | 1 + third/qcustomplotdemo/data/data1.txt | 1 + third/qcustomplotdemo/data/data2.txt | 1 + third/qcustomplotdemo/form/frmtest.cpp | 19 - third/qcustomplotdemo/form/frmtest.h | 25 - third/qcustomplotdemo/frmcustom/frmcustom.pri | 13 + .../{form => frmcustom}/frmmain.cpp | 20 +- .../{form => frmcustom}/frmmain.h | 3 + .../{form => frmcustom}/frmmain.ui | 0 .../frmcustom/frmmultiaxes.cpp | 186 + .../qcustomplotdemo/frmcustom/frmmultiaxes.h | 36 + .../qcustomplotdemo/frmcustom/frmmultiaxes.ui | 35 + .../{ => frmcustom}/iconhelper.cpp | 0 .../{ => frmcustom}/iconhelper.h | 0 .../{form => frmexample}/frmadvancedaxes.cpp | 2 + .../{form => frmexample}/frmadvancedaxes.h | 0 .../{form => frmexample}/frmadvancedaxes.ui | 12 - .../{form => frmexample}/frmbarchart.cpp | 2 + .../{form => frmexample}/frmbarchart.h | 0 .../{form => frmexample}/frmbarchart.ui | 12 - .../{form => frmexample}/frmcolormap.cpp | 0 .../{form => frmexample}/frmcolormap.h | 0 .../{form => frmexample}/frmcolormap.ui | 12 - .../{form => frmexample}/frmdate.cpp | 2 + .../{form => frmexample}/frmdate.h | 0 .../{form => frmexample}/frmdate.ui | 12 - .../form.pri => frmexample/frmexample.pri} | 6 - .../{form => frmexample}/frmfinancial.cpp | 2 +- .../{form => frmexample}/frmfinancial.h | 0 .../{form => frmexample}/frmfinancial.ui | 12 - .../{form => frmexample}/frmitem.cpp | 0 .../{form => frmexample}/frmitem.h | 0 .../{form => frmexample}/frmitem.ui | 12 - .../{form => frmexample}/frmlinestyle.cpp | 0 .../{form => frmexample}/frmlinestyle.h | 0 .../{form => frmexample}/frmlinestyle.ui | 12 - .../{form => frmexample}/frmlogarithmic.cpp | 0 .../{form => frmexample}/frmlogarithmic.h | 0 .../{form => frmexample}/frmlogarithmic.ui | 12 - .../{form => frmexample}/frmmultiaxis.cpp | 0 .../{form => frmexample}/frmmultiaxis.h | 0 .../{form => frmexample}/frmmultiaxis.ui | 12 - .../frmparametriccurve.cpp | 0 .../{form => frmexample}/frmparametriccurve.h | 0 .../frmparametriccurve.ui | 12 - .../{form => frmexample}/frmpolarplot.cpp | 3 + .../{form => frmexample}/frmpolarplot.h | 0 .../{form => frmexample}/frmpolarplot.ui | 12 - .../{form => frmexample}/frmquadratic.cpp | 0 .../{form => frmexample}/frmquadratic.h | 0 .../{form => frmexample}/frmquadratic.ui | 12 - .../{form => frmexample}/frmrealtimedata.cpp | 0 .../{form => frmexample}/frmrealtimedata.h | 0 .../{form => frmexample}/frmrealtimedata.ui | 0 .../{form => frmexample}/frmscatterpixmap.cpp | 0 .../{form => frmexample}/frmscatterpixmap.h | 0 .../{form => frmexample}/frmscatterpixmap.ui | 12 - .../{form => frmexample}/frmscatterstyle.cpp | 10 +- .../{form => frmexample}/frmscatterstyle.h | 0 .../{form => frmexample}/frmscatterstyle.ui | 12 - .../{form => frmexample}/frmsimple.cpp | 0 .../{form => frmexample}/frmsimple.h | 0 .../{form => frmexample}/frmsimple.ui | 12 - .../{form => frmexample}/frmsimpleitem.cpp | 0 .../{form => frmexample}/frmsimpleitem.h | 0 .../{form => frmexample}/frmsimpleitem.ui | 12 - .../{form => frmexample}/frmsincscatter.cpp | 0 .../{form => frmexample}/frmsincscatter.h | 0 .../{form => frmexample}/frmsincscatter.ui | 12 - .../{form => frmexample}/frmstatistical.cpp | 0 .../{form => frmexample}/frmstatistical.h | 0 .../{form => frmexample}/frmstatistical.ui | 12 - .../{form => frmexample}/frmstyled.cpp | 0 .../{form => frmexample}/frmstyled.h | 0 .../{form => frmexample}/frmstyled.ui | 12 - .../{form => frmexample}/frmtexturebrush.cpp | 0 .../{form => frmexample}/frmtexturebrush.h | 0 .../{form => frmexample}/frmtexturebrush.ui | 12 - third/qcustomplotdemo/frmexample2/axistag.cpp | 112 + third/qcustomplotdemo/frmexample2/axistag.h | 60 + .../frmexample2/frmaxistag.cpp | 67 + .../qcustomplotdemo/frmexample2/frmaxistag.h | 34 + .../frmtest.ui => frmexample2/frmaxistag.ui} | 18 +- .../frmexample2/frmexample2.pri | 16 + .../frmexample2/frminteraction.cpp | 266 + .../frmexample2/frminteraction.h | 39 + .../frmexample2/frminteraction.ui | 32 + .../frmexample2/frmscrollbar.cpp | 80 + .../frmexample2/frmscrollbar.h | 30 + .../frmexample2/frmscrollbar.ui | 53 + third/qcustomplotdemo/main.cpp | 6 + third/qcustomplotdemo/main.qrc | 3 + third/qcustomplotdemo/qcustomplotdemo.pro | 15 +- third/qcustomplotdemo/readme.md | 77 + third/qcustomplotdemo/snap/1.jpg | Bin 0 -> 49353 bytes third/qcustomplotdemo/snap/10.jpg | Bin 0 -> 83256 bytes third/qcustomplotdemo/snap/11.jpg | Bin 0 -> 92501 bytes third/qcustomplotdemo/snap/12.jpg | Bin 0 -> 93167 bytes third/qcustomplotdemo/snap/13.jpg | Bin 0 -> 66189 bytes third/qcustomplotdemo/snap/14.jpg | Bin 0 -> 54559 bytes third/qcustomplotdemo/snap/15.jpg | Bin 0 -> 47707 bytes third/qcustomplotdemo/snap/16.jpg | Bin 0 -> 70488 bytes third/qcustomplotdemo/snap/17.jpg | Bin 0 -> 72159 bytes third/qcustomplotdemo/snap/18.jpg | Bin 0 -> 67977 bytes third/qcustomplotdemo/snap/19.jpg | Bin 0 -> 71479 bytes third/qcustomplotdemo/snap/2.jpg | Bin 0 -> 65517 bytes third/qcustomplotdemo/snap/20.jpg | Bin 0 -> 71215 bytes third/qcustomplotdemo/snap/21.jpg | Bin 0 -> 74643 bytes third/qcustomplotdemo/snap/22.jpg | Bin 0 -> 53463 bytes third/qcustomplotdemo/snap/23.jpg | Bin 0 -> 89028 bytes third/qcustomplotdemo/snap/24.jpg | Bin 0 -> 64510 bytes third/qcustomplotdemo/snap/25.jpg | Bin 0 -> 111202 bytes third/qcustomplotdemo/snap/3.jpg | Bin 0 -> 88200 bytes third/qcustomplotdemo/snap/4.jpg | Bin 0 -> 87892 bytes third/qcustomplotdemo/snap/5.jpg | Bin 0 -> 74621 bytes third/qcustomplotdemo/snap/6.jpg | Bin 0 -> 67196 bytes third/qcustomplotdemo/snap/7.jpg | Bin 0 -> 58323 bytes third/qcustomplotdemo/snap/8.jpg | Bin 0 -> 69779 bytes third/qcustomplotdemo/snap/9.jpg | Bin 0 -> 85107 bytes 136 files changed, 73164 insertions(+), 322 deletions(-) create mode 100644 third/0snap/qcustomplotdemo6.jpg create mode 100644 third/0snap/qcustomplotdemo7.jpg create mode 100644 third/0snap/qcustomplotdemo8.jpg create mode 100644 third/3rd_qcustomplot/v1_3/qcustomplot.cpp create mode 100644 third/3rd_qcustomplot/v1_3/qcustomplot.h create mode 100644 third/3rd_qcustomplot/v2_0/qcustomplot.cpp create mode 100644 third/3rd_qcustomplot/v2_0/qcustomplot.h rename third/3rd_qcustomplot/{ => v2_1}/qcustomplot.cpp (100%) rename third/3rd_qcustomplot/{ => v2_1}/qcustomplot.h (100%) create mode 100644 third/3rd_qcustomplot/v2_1_6/qcustomplot.h create mode 100644 third/qcustomplotdemo/data/data0.txt create mode 100644 third/qcustomplotdemo/data/data1.txt create mode 100644 third/qcustomplotdemo/data/data2.txt delete mode 100644 third/qcustomplotdemo/form/frmtest.cpp delete mode 100644 third/qcustomplotdemo/form/frmtest.h create mode 100644 third/qcustomplotdemo/frmcustom/frmcustom.pri rename third/qcustomplotdemo/{form => frmcustom}/frmmain.cpp (88%) rename third/qcustomplotdemo/{form => frmcustom}/frmmain.h (93%) rename third/qcustomplotdemo/{form => frmcustom}/frmmain.ui (100%) create mode 100644 third/qcustomplotdemo/frmcustom/frmmultiaxes.cpp create mode 100644 third/qcustomplotdemo/frmcustom/frmmultiaxes.h create mode 100644 third/qcustomplotdemo/frmcustom/frmmultiaxes.ui rename third/qcustomplotdemo/{ => frmcustom}/iconhelper.cpp (100%) rename third/qcustomplotdemo/{ => frmcustom}/iconhelper.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmadvancedaxes.cpp (99%) rename third/qcustomplotdemo/{form => frmexample}/frmadvancedaxes.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmadvancedaxes.ui (72%) rename third/qcustomplotdemo/{form => frmexample}/frmbarchart.cpp (99%) rename third/qcustomplotdemo/{form => frmexample}/frmbarchart.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmbarchart.ui (72%) rename third/qcustomplotdemo/{form => frmexample}/frmcolormap.cpp (100%) rename third/qcustomplotdemo/{form => frmexample}/frmcolormap.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmcolormap.ui (72%) rename third/qcustomplotdemo/{form => frmexample}/frmdate.cpp (98%) rename third/qcustomplotdemo/{form => frmexample}/frmdate.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmdate.ui (72%) rename third/qcustomplotdemo/{form/form.pri => frmexample/frmexample.pri} (92%) rename third/qcustomplotdemo/{form => frmexample}/frmfinancial.cpp (98%) rename third/qcustomplotdemo/{form => frmexample}/frmfinancial.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmfinancial.ui (72%) rename third/qcustomplotdemo/{form => frmexample}/frmitem.cpp (100%) rename third/qcustomplotdemo/{form => frmexample}/frmitem.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmitem.ui (72%) rename third/qcustomplotdemo/{form => frmexample}/frmlinestyle.cpp (100%) rename third/qcustomplotdemo/{form => frmexample}/frmlinestyle.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmlinestyle.ui (72%) rename third/qcustomplotdemo/{form => frmexample}/frmlogarithmic.cpp (100%) rename third/qcustomplotdemo/{form => frmexample}/frmlogarithmic.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmlogarithmic.ui (72%) rename third/qcustomplotdemo/{form => frmexample}/frmmultiaxis.cpp (100%) rename third/qcustomplotdemo/{form => frmexample}/frmmultiaxis.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmmultiaxis.ui (72%) rename third/qcustomplotdemo/{form => frmexample}/frmparametriccurve.cpp (100%) rename third/qcustomplotdemo/{form => frmexample}/frmparametriccurve.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmparametriccurve.ui (73%) rename third/qcustomplotdemo/{form => frmexample}/frmpolarplot.cpp (95%) rename third/qcustomplotdemo/{form => frmexample}/frmpolarplot.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmpolarplot.ui (72%) rename third/qcustomplotdemo/{form => frmexample}/frmquadratic.cpp (100%) rename third/qcustomplotdemo/{form => frmexample}/frmquadratic.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmquadratic.ui (72%) rename third/qcustomplotdemo/{form => frmexample}/frmrealtimedata.cpp (100%) rename third/qcustomplotdemo/{form => frmexample}/frmrealtimedata.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmrealtimedata.ui (100%) rename third/qcustomplotdemo/{form => frmexample}/frmscatterpixmap.cpp (100%) rename third/qcustomplotdemo/{form => frmexample}/frmscatterpixmap.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmscatterpixmap.ui (72%) rename third/qcustomplotdemo/{form => frmexample}/frmscatterstyle.cpp (89%) rename third/qcustomplotdemo/{form => frmexample}/frmscatterstyle.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmscatterstyle.ui (72%) rename third/qcustomplotdemo/{form => frmexample}/frmsimple.cpp (100%) rename third/qcustomplotdemo/{form => frmexample}/frmsimple.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmsimple.ui (72%) rename third/qcustomplotdemo/{form => frmexample}/frmsimpleitem.cpp (100%) rename third/qcustomplotdemo/{form => frmexample}/frmsimpleitem.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmsimpleitem.ui (72%) rename third/qcustomplotdemo/{form => frmexample}/frmsincscatter.cpp (100%) rename third/qcustomplotdemo/{form => frmexample}/frmsincscatter.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmsincscatter.ui (72%) rename third/qcustomplotdemo/{form => frmexample}/frmstatistical.cpp (100%) rename third/qcustomplotdemo/{form => frmexample}/frmstatistical.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmstatistical.ui (72%) rename third/qcustomplotdemo/{form => frmexample}/frmstyled.cpp (100%) rename third/qcustomplotdemo/{form => frmexample}/frmstyled.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmstyled.ui (72%) rename third/qcustomplotdemo/{form => frmexample}/frmtexturebrush.cpp (100%) rename third/qcustomplotdemo/{form => frmexample}/frmtexturebrush.h (100%) rename third/qcustomplotdemo/{form => frmexample}/frmtexturebrush.ui (72%) create mode 100644 third/qcustomplotdemo/frmexample2/axistag.cpp create mode 100644 third/qcustomplotdemo/frmexample2/axistag.h create mode 100644 third/qcustomplotdemo/frmexample2/frmaxistag.cpp create mode 100644 third/qcustomplotdemo/frmexample2/frmaxistag.h rename third/qcustomplotdemo/{form/frmtest.ui => frmexample2/frmaxistag.ui} (60%) create mode 100644 third/qcustomplotdemo/frmexample2/frmexample2.pri create mode 100644 third/qcustomplotdemo/frmexample2/frminteraction.cpp create mode 100644 third/qcustomplotdemo/frmexample2/frminteraction.h create mode 100644 third/qcustomplotdemo/frmexample2/frminteraction.ui create mode 100644 third/qcustomplotdemo/frmexample2/frmscrollbar.cpp create mode 100644 third/qcustomplotdemo/frmexample2/frmscrollbar.h create mode 100644 third/qcustomplotdemo/frmexample2/frmscrollbar.ui create mode 100644 third/qcustomplotdemo/readme.md create mode 100644 third/qcustomplotdemo/snap/1.jpg create mode 100644 third/qcustomplotdemo/snap/10.jpg create mode 100644 third/qcustomplotdemo/snap/11.jpg create mode 100644 third/qcustomplotdemo/snap/12.jpg create mode 100644 third/qcustomplotdemo/snap/13.jpg create mode 100644 third/qcustomplotdemo/snap/14.jpg create mode 100644 third/qcustomplotdemo/snap/15.jpg create mode 100644 third/qcustomplotdemo/snap/16.jpg create mode 100644 third/qcustomplotdemo/snap/17.jpg create mode 100644 third/qcustomplotdemo/snap/18.jpg create mode 100644 third/qcustomplotdemo/snap/19.jpg create mode 100644 third/qcustomplotdemo/snap/2.jpg create mode 100644 third/qcustomplotdemo/snap/20.jpg create mode 100644 third/qcustomplotdemo/snap/21.jpg create mode 100644 third/qcustomplotdemo/snap/22.jpg create mode 100644 third/qcustomplotdemo/snap/23.jpg create mode 100644 third/qcustomplotdemo/snap/24.jpg create mode 100644 third/qcustomplotdemo/snap/25.jpg create mode 100644 third/qcustomplotdemo/snap/3.jpg create mode 100644 third/qcustomplotdemo/snap/4.jpg create mode 100644 third/qcustomplotdemo/snap/5.jpg create mode 100644 third/qcustomplotdemo/snap/6.jpg create mode 100644 third/qcustomplotdemo/snap/7.jpg create mode 100644 third/qcustomplotdemo/snap/8.jpg create mode 100644 third/qcustomplotdemo/snap/9.jpg diff --git a/README.md b/README.md index af02562..8feb832 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -#### 一、特别说明 +#### 一、特别说明 1. 可以选择打开QWidgetDemo.pro一次性编译所有的，也可以到目录下打开pro编译。 2. 如果发现有些子项目没有加载请打开对应目录下的.pro仔细看里面的注释。 3. 编译好的可执行文件在源码同级目录下的bin目录。 @@ -153,6 +153,9 @@ ![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/0snap/qcustomplotdemo3.jpg) ![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/0snap/qcustomplotdemo4.jpg) ![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/0snap/qcustomplotdemo5.jpg) +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/0snap/qcustomplotdemo6.jpg) +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/0snap/qcustomplotdemo7.jpg) +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/0snap/qcustomplotdemo8.jpg) ##### 4.8、网友提供 ![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/netfriend/0snap/astackwidget.jpg) diff --git a/third/0snap/qcustomplotdemo1.jpg b/third/0snap/qcustomplotdemo1.jpg index 92de70d342b0ddba79a9acf7e73c1f5b3da196dd..5ff3024ed992235b111156961a6189fe0f5a9f84 100644 GIT binary patch literal 89825 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 z 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 literal 0 HcmV?d00001 diff --git a/third/0snap/qcustomplotdemo7.jpg b/third/0snap/qcustomplotdemo7.jpg new file mode 100644 index 0000000000000000000000000000000000000000..01dc182f2aebe0342b94e3e36f5b4c7434e7b355 GIT binary patch literal 74683 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

8K3{+3&Uo}&Urh;K6=x)AemiKz*Q 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 literal 0 HcmV?d00001 diff --git a/third/0snap/qcustomplotdemo8.jpg b/third/0snap/qcustomplotdemo8.jpg new file mode 100644 index 0000000000000000000000000000000000000000..65c6c7f4789cf74a638dfa687e946bbe633855e3 GIT binary patch literal 111636 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 z�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 M%K>D*%^%PI2Y)Z4r~m)} literal 0 HcmV?d00001 diff --git a/third/3rd_qcustomplot/3rd_qcustomplot.pri b/third/3rd_qcustomplot/3rd_qcustomplot.pri index 40bdd2a..dbeebc1 100644 --- a/third/3rd_qcustomplot/3rd_qcustomplot.pri +++ b/third/3rd_qcustomplot/3rd_qcustomplot.pri @@ -1,7 +1,35 @@ greaterThan(QT_MAJOR_VERSION, 4): QT += printsupport +greaterThan(QT_MAJOR_VERSION, 4): CONFIG += c++11 +#lessThan(QT_MAJOR_VERSION, 5): QMAKE_CXXFLAGS += -std=c++11 -HEADERS += \ - $$PWD/qcustomplot.h +!contains(DEFINES, qcustomplot_v1_3) { +!contains(DEFINES, qcustomplot_v2_0) { +!contains(DEFINES, qcustomplot_v2_1) { +DEFINES += qcustomplot_v2_0 +}}} -SOURCES += \ - $$PWD/qcustomplot.cpp +!contains(DEFINES, qcustomplot_v2_1) { +greaterThan(QT_MAJOR_VERSION, 4) { +DEFINES -= qcustomplot_v1_3 +DEFINES -= qcustomplot_v2_0 +DEFINES += qcustomplot_v2_1 +}} + +contains(DEFINES, qcustomplot_v1_3) { +INCLUDEPATH += $$PWD/v1_3 +HEADERS += $$PWD/v1_3/qcustomplot.h +SOURCES += $$PWD/v1_3/qcustomplot.cpp +} else { +contains(DEFINES, qcustomplot_v2_0) { +INCLUDEPATH += $$PWD/v2_0 +HEADERS += $$PWD/v2_0/qcustomplot.h +SOURCES += $$PWD/v2_0/qcustomplot.cpp +} else { +INCLUDEPATH += $$PWD/v2_1 +greaterThan(QT_MAJOR_VERSION, 5) { +HEADERS += $$PWD/v2_1_6/qcustomplot.h +} else { +HEADERS += $$PWD/v2_1/qcustomplot.h +} +SOURCES += $$PWD/v2_1/qcustomplot.cpp +}} diff --git a/third/3rd_qcustomplot/v1_3/qcustomplot.cpp b/third/3rd_qcustomplot/v1_3/qcustomplot.cpp new file mode 100644 index 0000000..3086082 --- /dev/null +++ b/third/3rd_qcustomplot/v1_3/qcustomplot.cpp @@ -0,0 +1,23553 @@ +/*************************************************************************** +** ** +** QCustomPlot, an easy to use, modern plotting widget for Qt ** +** Copyright (C) 2011-2015 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 3 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/ ** +** Date: 22.12.15 ** +** Version: 1.3.2 ** +****************************************************************************/ + +#include "qcustomplot.h" + + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPPainter +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPPainter + \brief QPainter subclass used internally + + This QPainter subclass is used to provide some extended functionality e.g. for tweaking position + consistency between antialiased and non-antialiased painting. Further it provides workarounds + for QPainter quirks. + + \warning This class intentionally hides non-virtual functions of QPainter, e.g. setPen, save and + restore. So while it is possible to pass a QCPPainter instance to a function that expects a + QPainter pointer, some of the workarounds and tweaks will be unavailable to the function (because + it will call the base class implementations of the functions actually hidden by QCPPainter). +*/ + +/*! + Creates a new QCPPainter instance and sets default values +*/ +QCPPainter::QCPPainter() : + QPainter(), + mModes(pmDefault), + mIsAntialiasing(false) +{ + // don't setRenderHint(QPainter::NonCosmeticDefautPen) here, because painter isn't active yet and + // a call to begin() will follow +} + +/*! + Creates a new QCPPainter instance on the specified paint \a device and sets default values. Just + like the analogous QPainter constructor, begins painting on \a device immediately. + + Like \ref begin, this method sets QPainter::NonCosmeticDefaultPen in Qt versions before Qt5. +*/ +QCPPainter::QCPPainter(QPaintDevice *device) : + QPainter(device), + mModes(pmDefault), + mIsAntialiasing(false) +{ +#if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) // before Qt5, default pens used to be cosmetic if NonCosmeticDefaultPen flag isn't set. So we set it to get consistency across Qt versions. + if (isActive()) + setRenderHint(QPainter::NonCosmeticDefaultPen); +#endif +} + +QCPPainter::~QCPPainter() +{ +} + +/*! + Sets the pen of the painter and applies certain fixes to it, depending on the mode of this + QCPPainter. + + \note this function hides the non-virtual base class implementation. +*/ +void QCPPainter::setPen(const QPen &pen) +{ + QPainter::setPen(pen); + if (mModes.testFlag(pmNonCosmetic)) + makeNonCosmetic(); +} + +/*! \overload + + Sets the pen (by color) of the painter and applies certain fixes to it, depending on the mode of + this QCPPainter. + + \note this function hides the non-virtual base class implementation. +*/ +void QCPPainter::setPen(const QColor &color) +{ + QPainter::setPen(color); + if (mModes.testFlag(pmNonCosmetic)) + makeNonCosmetic(); +} + +/*! \overload + + Sets the pen (by style) of the painter and applies certain fixes to it, depending on the mode of + this QCPPainter. + + \note this function hides the non-virtual base class implementation. +*/ +void QCPPainter::setPen(Qt::PenStyle penStyle) +{ + QPainter::setPen(penStyle); + if (mModes.testFlag(pmNonCosmetic)) + makeNonCosmetic(); +} + +/*! \overload + + Works around a Qt bug introduced with Qt 4.8 which makes drawing QLineF unpredictable when + antialiasing is disabled. Thus when antialiasing is disabled, it rounds the \a line to + integer coordinates and then passes it to the original drawLine. + + \note this function hides the non-virtual base class implementation. +*/ +void QCPPainter::drawLine(const QLineF &line) +{ + if (mIsAntialiasing || mModes.testFlag(pmVectorized)) + QPainter::drawLine(line); + else + QPainter::drawLine(line.toLine()); +} + +/*! + Sets whether painting uses antialiasing or not. Use this method instead of using setRenderHint + with QPainter::Antialiasing directly, as it allows QCPPainter to regain pixel exactness between + antialiased and non-antialiased painting (Since Qt < 5.0 uses slightly different coordinate systems for + AA/Non-AA painting). +*/ +void QCPPainter::setAntialiasing(bool enabled) +{ + setRenderHint(QPainter::Antialiasing, enabled); + if (mIsAntialiasing != enabled) + { + mIsAntialiasing = enabled; + if (!mModes.testFlag(pmVectorized)) // antialiasing half-pixel shift only needed for rasterized outputs + { + if (mIsAntialiasing) + translate(0.5, 0.5); + else + translate(-0.5, -0.5); + } + } +} + +/*! + Sets the mode of the painter. This controls whether the painter shall adjust its + fixes/workarounds optimized for certain output devices. +*/ +void QCPPainter::setModes(QCPPainter::PainterModes modes) +{ + mModes = modes; +} + +/*! + Sets the QPainter::NonCosmeticDefaultPen in Qt versions before Qt5 after beginning painting on \a + device. This is necessary to get cosmetic pen consistency across Qt versions, because since Qt5, + all pens are non-cosmetic by default, and in Qt4 this render hint must be set to get that + behaviour. + + The Constructor \ref QCPPainter(QPaintDevice *device) which directly starts painting also sets + the render hint as appropriate. + + \note this function hides the non-virtual base class implementation. +*/ +bool QCPPainter::begin(QPaintDevice *device) +{ + bool result = QPainter::begin(device); +#if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) // before Qt5, default pens used to be cosmetic if NonCosmeticDefaultPen flag isn't set. So we set it to get consistency across Qt versions. + if (result) + setRenderHint(QPainter::NonCosmeticDefaultPen); +#endif + return result; +} + +/*! \overload + + Sets the mode of the painter. This controls whether the painter shall adjust its + fixes/workarounds optimized for certain output devices. +*/ +void QCPPainter::setMode(QCPPainter::PainterMode mode, bool enabled) +{ + if (!enabled && mModes.testFlag(mode)) + mModes &= ~mode; + else if (enabled && !mModes.testFlag(mode)) + mModes |= mode; +} + +/*! + Saves the painter (see QPainter::save). Since QCPPainter adds some new internal state to + QPainter, the save/restore functions are reimplemented to also save/restore those members. + + \note this function hides the non-virtual base class implementation. + + \see restore +*/ +void QCPPainter::save() +{ + mAntialiasingStack.push(mIsAntialiasing); + QPainter::save(); +} + +/*! + Restores the painter (see QPainter::restore). Since QCPPainter adds some new internal state to + QPainter, the save/restore functions are reimplemented to also save/restore those members. + + \note this function hides the non-virtual base class implementation. + + \see save +*/ +void QCPPainter::restore() +{ + if (!mAntialiasingStack.isEmpty()) + mIsAntialiasing = mAntialiasingStack.pop(); + else + qDebug() << Q_FUNC_INFO << "Unbalanced save/restore"; + QPainter::restore(); +} + +/*! + Changes the pen width to 1 if it currently is 0. This function is called in the \ref setPen + overrides when the \ref pmNonCosmetic mode is set. +*/ +void QCPPainter::makeNonCosmetic() +{ + if (qFuzzyIsNull(pen().widthF())) + { + QPen p = pen(); + p.setWidth(1); + QPainter::setPen(p); + } +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPScatterStyle +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPScatterStyle + \brief Represents the visual appearance of scatter points + + This class holds information about shape, color and size of scatter points. In plottables like + QCPGraph it is used to store how scatter points shall be drawn. For example, \ref + QCPGraph::setScatterStyle takes a QCPScatterStyle instance. + + A scatter style consists of a shape (\ref setShape), a line color (\ref setPen) and possibly a + fill (\ref setBrush), if the shape provides a fillable area. Further, the size of the shape can + be controlled with \ref setSize. + + \section QCPScatterStyle-defining Specifying a scatter style + + You can set all these configurations either by calling the respective functions on an instance: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpscatterstyle-creation-1 + + Or you can use one of the various constructors that take different parameter combinations, making + it easy to specify a scatter style in a single call, like so: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpscatterstyle-creation-2 + + \section QCPScatterStyle-undefinedpen Leaving the color/pen up to the plottable + + There are two constructors which leave the pen undefined: \ref QCPScatterStyle() and \ref + QCPScatterStyle(ScatterShape shape, double size). If those constructors are used, a call to \ref + isPenDefined will return false. It leads to scatter points that inherit the pen from the + plottable that uses the scatter style. Thus, if such a scatter style is passed to QCPGraph, the line + color of the graph (\ref QCPGraph::setPen) will be used by the scatter points. This makes + it very convenient to set up typical scatter settings: + + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpscatterstyle-shortcreation + + Notice that it wasn't even necessary to explicitly call a QCPScatterStyle constructor. This works + because QCPScatterStyle provides a constructor that can transform a \ref ScatterShape directly + into a QCPScatterStyle instance (that's the \ref QCPScatterStyle(ScatterShape shape, double size) + constructor with a default for \a size). In those cases, C++ allows directly supplying a \ref + ScatterShape, where actually a QCPScatterStyle is expected. + + \section QCPScatterStyle-custompath-and-pixmap Custom shapes and pixmaps + + QCPScatterStyle supports drawing custom shapes and arbitrary pixmaps as scatter points. + + For custom shapes, you can provide a QPainterPath with the desired shape to the \ref + setCustomPath function or call the constructor that takes a painter path. The scatter shape will + automatically be set to \ref ssCustom. + + For pixmaps, you call \ref setPixmap with the desired QPixmap. Alternatively you can use the + constructor that takes a QPixmap. The scatter shape will automatically be set to \ref ssPixmap. + Note that \ref setSize does not influence the appearance of the pixmap. +*/ + +/* start documentation of inline functions */ + +/*! \fn bool QCPScatterStyle::isNone() const + + Returns whether the scatter shape is \ref ssNone. + + \see setShape +*/ + +/*! \fn bool QCPScatterStyle::isPenDefined() const + + Returns whether a pen has been defined for this scatter style. + + The pen is undefined if a constructor is called that does not carry \a pen as parameter. Those are + \ref QCPScatterStyle() and \ref QCPScatterStyle(ScatterShape shape, double size). If the pen is + left undefined, the scatter color will be inherited from the plottable that uses this scatter + style. + + \see setPen +*/ + +/* end documentation of inline functions */ + +/*! + Creates a new QCPScatterStyle instance with size set to 6. No shape, pen or brush is defined. + + Since the pen is undefined (\ref isPenDefined returns false), the scatter color will be inherited + from the plottable that uses this scatter style. +*/ +QCPScatterStyle::QCPScatterStyle() : + mSize(6), + mShape(ssNone), + mPen(Qt::NoPen), + mBrush(Qt::NoBrush), + mPenDefined(false) +{ +} + +/*! + Creates a new QCPScatterStyle instance with shape set to \a shape and size to \a size. No pen or + brush is defined. + + Since the pen is undefined (\ref isPenDefined returns false), the scatter color will be inherited + from the plottable that uses this scatter style. +*/ +QCPScatterStyle::QCPScatterStyle(ScatterShape shape, double size) : + mSize(size), + mShape(shape), + mPen(Qt::NoPen), + mBrush(Qt::NoBrush), + mPenDefined(false) +{ +} + +/*! + Creates a new QCPScatterStyle instance with shape set to \a shape, the pen color set to \a color, + and size to \a size. No brush is defined, i.e. the scatter point will not be filled. +*/ +QCPScatterStyle::QCPScatterStyle(ScatterShape shape, const QColor &color, double size) : + mSize(size), + mShape(shape), + mPen(QPen(color)), + mBrush(Qt::NoBrush), + mPenDefined(true) +{ +} + +/*! + Creates a new QCPScatterStyle instance with shape set to \a shape, the pen color set to \a color, + the brush color to \a fill (with a solid pattern), and size to \a size. +*/ +QCPScatterStyle::QCPScatterStyle(ScatterShape shape, const QColor &color, const QColor &fill, double size) : + mSize(size), + mShape(shape), + mPen(QPen(color)), + mBrush(QBrush(fill)), + mPenDefined(true) +{ +} + +/*! + Creates a new QCPScatterStyle instance with shape set to \a shape, the pen set to \a pen, the + brush to \a brush, and size to \a size. + + \warning In some cases it might be tempting to directly use a pen style like Qt::NoPen as \a pen + and a color like Qt::blue as \a brush. Notice however, that the corresponding call\n + QCPScatterStyle(QCPScatterShape::ssCircle, Qt::NoPen, Qt::blue, 5)\n + doesn't necessarily lead C++ to use this constructor in some cases, but might mistake + Qt::NoPen for a QColor and use the + \ref QCPScatterStyle(ScatterShape shape, const QColor &color, const QColor &fill, double size) + constructor instead (which will lead to an unexpected look of the scatter points). To prevent + this, be more explicit with the parameter types. For example, use QBrush(Qt::blue) + instead of just Qt::blue, to clearly point out to the compiler that this constructor is + wanted. +*/ +QCPScatterStyle::QCPScatterStyle(ScatterShape shape, const QPen &pen, const QBrush &brush, double size) : + mSize(size), + mShape(shape), + mPen(pen), + mBrush(brush), + mPenDefined(pen.style() != Qt::NoPen) +{ +} + +/*! + Creates a new QCPScatterStyle instance which will show the specified \a pixmap. The scatter shape + is set to \ref ssPixmap. +*/ +QCPScatterStyle::QCPScatterStyle(const QPixmap &pixmap) : + mSize(5), + mShape(ssPixmap), + mPen(Qt::NoPen), + mBrush(Qt::NoBrush), + mPixmap(pixmap), + mPenDefined(false) +{ +} + +/*! + Creates a new QCPScatterStyle instance with a custom shape that is defined via \a customPath. The + scatter shape is set to \ref ssCustom. + + The custom shape line will be drawn with \a pen and filled with \a brush. The size has a slightly + different meaning than for built-in scatter points: The custom path will be drawn scaled by a + factor of \a size/6.0. Since the default \a size is 6, the custom path will appear at a its + natural size by default. To double the size of the path for example, set \a size to 12. +*/ +QCPScatterStyle::QCPScatterStyle(const QPainterPath &customPath, const QPen &pen, const QBrush &brush, double size) : + mSize(size), + mShape(ssCustom), + mPen(pen), + mBrush(brush), + mCustomPath(customPath), + mPenDefined(pen.style() != Qt::NoPen) +{ +} + +/*! + Sets the size (pixel diameter) of the drawn scatter points to \a size. + + \see setShape +*/ +void QCPScatterStyle::setSize(double size) +{ + mSize = size; +} + +/*! + Sets the shape to \a shape. + + Note that the calls \ref setPixmap and \ref setCustomPath automatically set the shape to \ref + ssPixmap and \ref ssCustom, respectively. + + \see setSize +*/ +void QCPScatterStyle::setShape(QCPScatterStyle::ScatterShape shape) +{ + mShape = shape; +} + +/*! + Sets the pen that will be used to draw scatter points to \a pen. + + If the pen was previously undefined (see \ref isPenDefined), the pen is considered defined after + a call to this function, even if \a pen is Qt::NoPen. + + \see setBrush +*/ +void QCPScatterStyle::setPen(const QPen &pen) +{ + mPenDefined = true; + mPen = pen; +} + +/*! + Sets the brush that will be used to fill scatter points to \a brush. Note that not all scatter + shapes have fillable areas. For example, \ref ssPlus does not while \ref ssCircle does. + + \see setPen +*/ +void QCPScatterStyle::setBrush(const QBrush &brush) +{ + mBrush = brush; +} + +/*! + Sets the pixmap that will be drawn as scatter point to \a pixmap. + + Note that \ref setSize does not influence the appearance of the pixmap. + + The scatter shape is automatically set to \ref ssPixmap. +*/ +void QCPScatterStyle::setPixmap(const QPixmap &pixmap) +{ + setShape(ssPixmap); + mPixmap = pixmap; +} + +/*! + Sets the custom shape that will be drawn as scatter point to \a customPath. + + The scatter shape is automatically set to \ref ssCustom. +*/ +void QCPScatterStyle::setCustomPath(const QPainterPath &customPath) +{ + setShape(ssCustom); + mCustomPath = customPath; +} + +/*! + Applies the pen and the brush of this scatter style to \a painter. If this scatter style has an + undefined pen (\ref isPenDefined), sets the pen of \a painter to \a defaultPen instead. + + This function is used by plottables (or any class that wants to draw scatters) just before a + number of scatters with this style shall be drawn with the \a painter. + + \see drawShape +*/ +void QCPScatterStyle::applyTo(QCPPainter *painter, const QPen &defaultPen) const +{ + painter->setPen(mPenDefined ? mPen : defaultPen); + painter->setBrush(mBrush); +} + +/*! + Draws the scatter shape with \a painter at position \a pos. + + This function does not modify the pen or the brush on the painter, as \ref applyTo is meant to be + called before scatter points are drawn with \ref drawShape. + + \see applyTo +*/ +void QCPScatterStyle::drawShape(QCPPainter *painter, QPointF pos) const +{ + drawShape(painter, pos.x(), pos.y()); +} + +/*! \overload + Draws the scatter shape with \a painter at position \a x and \a y. +*/ +void QCPScatterStyle::drawShape(QCPPainter *painter, double x, double y) const +{ + double w = mSize/2.0; + switch (mShape) + { + case ssNone: break; + case ssDot: + { + painter->drawLine(QPointF(x, y), QPointF(x+0.0001, y)); + break; + } + case ssCross: + { + painter->drawLine(QLineF(x-w, y-w, x+w, y+w)); + painter->drawLine(QLineF(x-w, y+w, x+w, y-w)); + break; + } + case ssPlus: + { + painter->drawLine(QLineF(x-w, y, x+w, y)); + painter->drawLine(QLineF( x, y+w, x, y-w)); + break; + } + case ssCircle: + { + painter->drawEllipse(QPointF(x , y), w, w); + break; + } + case ssDisc: + { + QBrush b = painter->brush(); + painter->setBrush(painter->pen().color()); + painter->drawEllipse(QPointF(x , y), w, w); + painter->setBrush(b); + break; + } + case ssSquare: + { + painter->drawRect(QRectF(x-w, y-w, mSize, mSize)); + break; + } + case ssDiamond: + { + painter->drawLine(QLineF(x-w, y, x, y-w)); + painter->drawLine(QLineF( x, y-w, x+w, y)); + painter->drawLine(QLineF(x+w, y, x, y+w)); + painter->drawLine(QLineF( x, y+w, x-w, y)); + break; + } + case ssStar: + { + painter->drawLine(QLineF(x-w, y, x+w, y)); + painter->drawLine(QLineF( x, y+w, x, y-w)); + painter->drawLine(QLineF(x-w*0.707, y-w*0.707, x+w*0.707, y+w*0.707)); + painter->drawLine(QLineF(x-w*0.707, y+w*0.707, x+w*0.707, y-w*0.707)); + break; + } + case ssTriangle: + { + painter->drawLine(QLineF(x-w, y+0.755*w, x+w, y+0.755*w)); + painter->drawLine(QLineF(x+w, y+0.755*w, x, y-0.977*w)); + painter->drawLine(QLineF( x, y-0.977*w, x-w, y+0.755*w)); + break; + } + case ssTriangleInverted: + { + painter->drawLine(QLineF(x-w, y-0.755*w, x+w, y-0.755*w)); + painter->drawLine(QLineF(x+w, y-0.755*w, x, y+0.977*w)); + painter->drawLine(QLineF( x, y+0.977*w, x-w, y-0.755*w)); + break; + } + case ssCrossSquare: + { + painter->drawLine(QLineF(x-w, y-w, x+w*0.95, y+w*0.95)); + painter->drawLine(QLineF(x-w, y+w*0.95, x+w*0.95, y-w)); + painter->drawRect(QRectF(x-w, y-w, mSize, mSize)); + break; + } + case ssPlusSquare: + { + painter->drawLine(QLineF(x-w, y, x+w*0.95, y)); + painter->drawLine(QLineF( x, y+w, x, y-w)); + painter->drawRect(QRectF(x-w, y-w, mSize, mSize)); + break; + } + case ssCrossCircle: + { + painter->drawLine(QLineF(x-w*0.707, y-w*0.707, x+w*0.670, y+w*0.670)); + painter->drawLine(QLineF(x-w*0.707, y+w*0.670, x+w*0.670, y-w*0.707)); + painter->drawEllipse(QPointF(x, y), w, w); + break; + } + case ssPlusCircle: + { + painter->drawLine(QLineF(x-w, y, x+w, y)); + painter->drawLine(QLineF( x, y+w, x, y-w)); + painter->drawEllipse(QPointF(x, y), w, w); + break; + } + case ssPeace: + { + painter->drawLine(QLineF(x, y-w, x, y+w)); + painter->drawLine(QLineF(x, y, x-w*0.707, y+w*0.707)); + painter->drawLine(QLineF(x, y, x+w*0.707, y+w*0.707)); + painter->drawEllipse(QPointF(x, y), w, w); + break; + } + case ssPixmap: + { + painter->drawPixmap(x-mPixmap.width()*0.5, y-mPixmap.height()*0.5, mPixmap); + break; + } + case ssCustom: + { + QTransform oldTransform = painter->transform(); + painter->translate(x, y); + painter->scale(mSize/6.0, mSize/6.0); + painter->drawPath(mCustomPath); + painter->setTransform(oldTransform); + break; + } + } +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPLayer +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPLayer + \brief A layer that may contain objects, to control the rendering order + + The Layering system of QCustomPlot is the mechanism to control the rendering order of the + elements inside the plot. + + It is based on the two classes QCPLayer and QCPLayerable. QCustomPlot holds an ordered list of + one or more instances of QCPLayer (see QCustomPlot::addLayer, QCustomPlot::layer, + QCustomPlot::moveLayer, etc.). When replotting, QCustomPlot goes through the list of layers + bottom to top and successively draws the layerables of the layers. + + A QCPLayer contains an ordered list of QCPLayerable instances. QCPLayerable is an abstract base + class from which almost all visible objects derive, like axes, grids, graphs, items, etc. + + Initially, QCustomPlot has five layers: "background", "grid", "main", "axes" and "legend" (in + that order). The top two layers "axes" and "legend" contain the default axes and legend, so they + will be drawn on top. In the middle, there is the "main" layer. It is initially empty and set as + the current layer (see QCustomPlot::setCurrentLayer). This means, all new plottables, items etc. + are created on this layer by default. Then comes the "grid" layer which contains the QCPGrid + instances (which belong tightly to QCPAxis, see \ref QCPAxis::grid). The Axis rect background + shall be drawn behind everything else, thus the default QCPAxisRect instance is placed on the + "background" layer. Of course, the layer affiliation of the individual objects can be changed as + required (\ref QCPLayerable::setLayer). + + Controlling the ordering of objects is easy: Create a new layer in the position you want it to + be, e.g. above "main", with QCustomPlot::addLayer. Then set the current layer with + QCustomPlot::setCurrentLayer to that new layer and finally create the objects normally. They will + be placed on the new layer automatically, due to the current layer setting. Alternatively you + could have also ignored the current layer setting and just moved the objects with + QCPLayerable::setLayer to the desired layer after creating them. + + It is also possible to move whole layers. For example, If you want the grid to be shown in front + of all plottables/items on the "main" layer, just move it above "main" with + QCustomPlot::moveLayer. + + The rendering order within one layer is simply by order of creation or insertion. The item + created last (or added last to the layer), is drawn on top of all other objects on that layer. + + When a layer is deleted, the objects on it are not deleted with it, but fall on the layer below + the deleted layer, see QCustomPlot::removeLayer. +*/ + +/* start documentation of inline functions */ + +/*! \fn QList QCPLayer::children() const + + Returns a list of all layerables on this layer. The order corresponds to the rendering order: + layerables with higher indices are drawn above layerables with lower indices. +*/ + +/*! \fn int QCPLayer::index() const + + Returns the index this layer has in the QCustomPlot. The index is the integer number by which this layer can be + accessed via \ref QCustomPlot::layer. + + Layers with higher indices will be drawn above layers with lower indices. +*/ + +/* end documentation of inline functions */ + +/*! + Creates a new QCPLayer instance. + + Normally you shouldn't directly instantiate layers, use \ref QCustomPlot::addLayer instead. + + \warning It is not checked that \a layerName is actually a unique layer name in \a parentPlot. + This check is only performed by \ref QCustomPlot::addLayer. +*/ +QCPLayer::QCPLayer(QCustomPlot *parentPlot, const QString &layerName) : + QObject(parentPlot), + mParentPlot(parentPlot), + mName(layerName), + mIndex(-1), // will be set to a proper value by the QCustomPlot layer creation function + mVisible(true) +{ + // Note: no need to make sure layerName is unique, because layer + // management is done with QCustomPlot functions. +} + +QCPLayer::~QCPLayer() +{ + // If child layerables are still on this layer, detach them, so they don't try to reach back to this + // then invalid layer once they get deleted/moved themselves. This only happens when layers are deleted + // directly, like in the QCustomPlot destructor. (The regular layer removal procedure for the user is to + // call QCustomPlot::removeLayer, which moves all layerables off this layer before deleting it.) + + while (!mChildren.isEmpty()) + mChildren.last()->setLayer(0); // removes itself from mChildren via removeChild() + + if (mParentPlot->currentLayer() == this) + qDebug() << Q_FUNC_INFO << "The parent plot's mCurrentLayer will be a dangling pointer. Should have been set to a valid layer or 0 beforehand."; +} + +/*! + Sets whether this layer is visible or not. If \a visible is set to false, all layerables on this + layer will be invisible. + + This function doesn't change the visibility property of the layerables (\ref + QCPLayerable::setVisible), but the \ref QCPLayerable::realVisibility of each layerable takes the + visibility of the parent layer into account. +*/ +void QCPLayer::setVisible(bool visible) +{ + mVisible = visible; +} + +/*! \internal + + Adds the \a layerable to the list of this layer. If \a prepend is set to true, the layerable will + be prepended to the list, i.e. be drawn beneath the other layerables already in the list. + + This function does not change the \a mLayer member of \a layerable to this layer. (Use + QCPLayerable::setLayer to change the layer of an object, not this function.) + + \see removeChild +*/ +void QCPLayer::addChild(QCPLayerable *layerable, bool prepend) +{ + if (!mChildren.contains(layerable)) + { + if (prepend) + mChildren.prepend(layerable); + else + mChildren.append(layerable); + } else + qDebug() << Q_FUNC_INFO << "layerable is already child of this layer" << reinterpret_cast(layerable); +} + +/*! \internal + + Removes the \a layerable from the list of this layer. + + This function does not change the \a mLayer member of \a layerable. (Use QCPLayerable::setLayer + to change the layer of an object, not this function.) + + \see addChild +*/ +void QCPLayer::removeChild(QCPLayerable *layerable) +{ + if (!mChildren.removeOne(layerable)) + qDebug() << Q_FUNC_INFO << "layerable is not child of this layer" << reinterpret_cast(layerable); +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPLayerable +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPLayerable + \brief Base class for all drawable objects + + This is the abstract base class most visible objects derive from, e.g. plottables, axes, grid + etc. + + Every layerable is on a layer (QCPLayer) which allows controlling the rendering order by stacking + the layers accordingly. + + For details about the layering mechanism, see the QCPLayer documentation. +*/ + +/* start documentation of inline functions */ + +/*! \fn QCPLayerable *QCPLayerable::parentLayerable() const + + Returns the parent layerable of this layerable. The parent layerable is used to provide + visibility hierarchies in conjunction with the method \ref realVisibility. This way, layerables + only get drawn if their parent layerables are visible, too. + + Note that a parent layerable is not necessarily also the QObject parent for memory management. + Further, a layerable doesn't always have a parent layerable, so this function may return 0. + + A parent layerable is set implicitly with when placed inside layout elements and doesn't need to be + set manually by the user. +*/ + +/* end documentation of inline functions */ +/* start documentation of pure virtual functions */ + +/*! \fn virtual void QCPLayerable::applyDefaultAntialiasingHint(QCPPainter *painter) const = 0 + \internal + + This function applies the default antialiasing setting to the specified \a painter, using the + function \ref applyAntialiasingHint. It is the antialiasing state the painter is put in, when + \ref draw is called on the layerable. If the layerable has multiple entities whose antialiasing + setting may be specified individually, this function should set the antialiasing state of the + most prominent entity. In this case however, the \ref draw function usually calls the specialized + versions of this function before drawing each entity, effectively overriding the setting of the + default antialiasing hint. + + First example: QCPGraph has multiple entities that have an antialiasing setting: The graph + line, fills, scatters and error bars. Those can be configured via QCPGraph::setAntialiased, + QCPGraph::setAntialiasedFill, QCPGraph::setAntialiasedScatters etc. Consequently, there isn't + only the QCPGraph::applyDefaultAntialiasingHint function (which corresponds to the graph line's + antialiasing), but specialized ones like QCPGraph::applyFillAntialiasingHint and + QCPGraph::applyScattersAntialiasingHint. So before drawing one of those entities, QCPGraph::draw + calls the respective specialized applyAntialiasingHint function. + + Second example: QCPItemLine consists only of a line so there is only one antialiasing + setting which can be controlled with QCPItemLine::setAntialiased. (This function is inherited by + all layerables. The specialized functions, as seen on QCPGraph, must be added explicitly to the + respective layerable subclass.) Consequently it only has the normal + QCPItemLine::applyDefaultAntialiasingHint. The \ref QCPItemLine::draw function doesn't need to + care about setting any antialiasing states, because the default antialiasing hint is already set + on the painter when the \ref draw function is called, and that's the state it wants to draw the + line with. +*/ + +/*! \fn virtual void QCPLayerable::draw(QCPPainter *painter) const = 0 + \internal + + This function draws the layerable with the specified \a painter. It is only called by + QCustomPlot, if the layerable is visible (\ref setVisible). + + Before this function is called, the painter's antialiasing state is set via \ref + applyDefaultAntialiasingHint, see the documentation there. Further, the clipping rectangle was + set to \ref clipRect. +*/ + +/* end documentation of pure virtual functions */ +/* start documentation of signals */ + +/*! \fn void QCPLayerable::layerChanged(QCPLayer *newLayer); + + This signal is emitted when the layer of this layerable changes, i.e. this layerable is moved to + a different layer. + + \see setLayer +*/ + +/* end documentation of signals */ + +/*! + Creates a new QCPLayerable instance. + + Since QCPLayerable is an abstract base class, it can't be instantiated directly. Use one of the + derived classes. + + If \a plot is provided, it automatically places itself on the layer named \a targetLayer. If \a + targetLayer is an empty string, it places itself on the current layer of the plot (see \ref + QCustomPlot::setCurrentLayer). + + It is possible to provide 0 as \a plot. In that case, you should assign a parent plot at a later + time with \ref initializeParentPlot. + + The layerable's parent layerable is set to \a parentLayerable, if provided. Direct layerable + parents are mainly used to control visibility in a hierarchy of layerables. This means a + layerable is only drawn, if all its ancestor layerables are also visible. Note that \a + parentLayerable does not become the QObject-parent (for memory management) of this layerable, \a + plot does. It is not uncommon to set the QObject-parent to something else in the constructors of + QCPLayerable subclasses, to guarantee a working destruction hierarchy. +*/ +QCPLayerable::QCPLayerable(QCustomPlot *plot, QString targetLayer, QCPLayerable *parentLayerable) : + QObject(plot), + mVisible(true), + mParentPlot(plot), + mParentLayerable(parentLayerable), + mLayer(0), + mAntialiased(true) +{ + if (mParentPlot) + { + if (targetLayer.isEmpty()) + setLayer(mParentPlot->currentLayer()); + else if (!setLayer(targetLayer)) + qDebug() << Q_FUNC_INFO << "setting QCPlayerable initial layer to" << targetLayer << "failed."; + } +} + +QCPLayerable::~QCPLayerable() +{ + if (mLayer) + { + mLayer->removeChild(this); + mLayer = 0; + } +} + +/*! + Sets the visibility of this layerable object. If an object is not visible, it will not be drawn + on the QCustomPlot surface, and user interaction with it (e.g. click and selection) is not + possible. +*/ +void QCPLayerable::setVisible(bool on) +{ + mVisible = on; +} + +/*! + Sets the \a layer of this layerable object. The object will be placed on top of the other objects + already on \a layer. + + If \a layer is 0, this layerable will not be on any layer and thus not appear in the plot (or + interact/receive events). + + Returns true if the layer of this layerable was successfully changed to \a layer. +*/ +bool QCPLayerable::setLayer(QCPLayer *layer) +{ + return moveToLayer(layer, false); +} + +/*! \overload + Sets the layer of this layerable object by name + + Returns true on success, i.e. if \a layerName is a valid layer name. +*/ +bool QCPLayerable::setLayer(const QString &layerName) +{ + if (!mParentPlot) + { + qDebug() << Q_FUNC_INFO << "no parent QCustomPlot set"; + return false; + } + if (QCPLayer *layer = mParentPlot->layer(layerName)) + { + return setLayer(layer); + } else + { + qDebug() << Q_FUNC_INFO << "there is no layer with name" << layerName; + return false; + } +} + +/*! + Sets whether this object will be drawn antialiased or not. + + Note that antialiasing settings may be overridden by QCustomPlot::setAntialiasedElements and + QCustomPlot::setNotAntialiasedElements. +*/ +void QCPLayerable::setAntialiased(bool enabled) +{ + mAntialiased = enabled; +} + +/*! + Returns whether this layerable is visible, taking the visibility of the layerable parent and the + visibility of the layer this layerable is on into account. This is the method that is consulted + to decide whether a layerable shall be drawn or not. + + If this layerable has a direct layerable parent (usually set via hierarchies implemented in + subclasses, like in the case of QCPLayoutElement), this function returns true only if this + layerable has its visibility set to true and the parent layerable's \ref realVisibility returns + true. + + If this layerable doesn't have a direct layerable parent, returns the state of this layerable's + visibility. +*/ +bool QCPLayerable::realVisibility() const +{ + return mVisible && (!mLayer || mLayer->visible()) && (!mParentLayerable || mParentLayerable.data()->realVisibility()); +} + +/*! + This function is used to decide whether a click hits a layerable object or not. + + \a pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the + shortest pixel distance of this point to the object. If the object is either invisible or the + distance couldn't be determined, -1.0 is returned. Further, if \a onlySelectable is true and the + object is not selectable, -1.0 is returned, too. + + If the object is represented not by single lines but by an area like a \ref QCPItemText or the + bars of a \ref QCPBars plottable, a click inside the area should also be considered a hit. In + these cases this function thus returns a constant value greater zero but still below the parent + plot's selection tolerance. (typically the selectionTolerance multiplied by 0.99). + + Providing a constant value for area objects allows selecting line objects even when they are + obscured by such area objects, by clicking close to the lines (i.e. closer than + 0.99*selectionTolerance). + + The actual setting of the selection state is not done by this function. This is handled by the + parent QCustomPlot when the mouseReleaseEvent occurs, and the finally selected object is notified + via the selectEvent/deselectEvent methods. + + \a details is an optional output parameter. Every layerable subclass may place any information + in \a details. This information will be passed to \ref selectEvent when the parent QCustomPlot + decides on the basis of this selectTest call, that the object was successfully selected. The + subsequent call to \ref selectEvent will carry the \a details. This is useful for multi-part + objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked + is only done once in \ref selectTest. The result (i.e. the actually clicked part) can then be + placed in \a details. So in the subsequent \ref selectEvent, the decision which part was + selected doesn't have to be done a second time for a single selection operation. + + You may pass 0 as \a details to indicate that you are not interested in those selection details. + + \see selectEvent, deselectEvent, QCustomPlot::setInteractions +*/ +double QCPLayerable::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(pos) + Q_UNUSED(onlySelectable) + Q_UNUSED(details) + return -1.0; +} + +/*! \internal + + Sets the parent plot of this layerable. Use this function once to set the parent plot if you have + passed 0 in the constructor. It can not be used to move a layerable from one QCustomPlot to + another one. + + Note that, unlike when passing a non-null parent plot in the constructor, this function does not + make \a parentPlot the QObject-parent of this layerable. If you want this, call + QObject::setParent(\a parentPlot) in addition to this function. + + Further, you will probably want to set a layer (\ref setLayer) after calling this function, to + make the layerable appear on the QCustomPlot. + + The parent plot change will be propagated to subclasses via a call to \ref parentPlotInitialized + so they can react accordingly (e.g. also initialize the parent plot of child layerables, like + QCPLayout does). +*/ +void QCPLayerable::initializeParentPlot(QCustomPlot *parentPlot) +{ + if (mParentPlot) + { + qDebug() << Q_FUNC_INFO << "called with mParentPlot already initialized"; + return; + } + + if (!parentPlot) + qDebug() << Q_FUNC_INFO << "called with parentPlot zero"; + + mParentPlot = parentPlot; + parentPlotInitialized(mParentPlot); +} + +/*! \internal + + Sets the parent layerable of this layerable to \a parentLayerable. Note that \a parentLayerable does not + become the QObject-parent (for memory management) of this layerable. + + The parent layerable has influence on the return value of the \ref realVisibility method. Only + layerables with a fully visible parent tree will return true for \ref realVisibility, and thus be + drawn. + + \see realVisibility +*/ +void QCPLayerable::setParentLayerable(QCPLayerable *parentLayerable) +{ + mParentLayerable = parentLayerable; +} + +/*! \internal + + Moves this layerable object to \a layer. If \a prepend is true, this object will be prepended to + the new layer's list, i.e. it will be drawn below the objects already on the layer. If it is + false, the object will be appended. + + Returns true on success, i.e. if \a layer is a valid layer. +*/ +bool QCPLayerable::moveToLayer(QCPLayer *layer, bool prepend) +{ + if (layer && !mParentPlot) + { + qDebug() << Q_FUNC_INFO << "no parent QCustomPlot set"; + return false; + } + if (layer && layer->parentPlot() != mParentPlot) + { + qDebug() << Q_FUNC_INFO << "layer" << layer->name() << "is not in same QCustomPlot as this layerable"; + return false; + } + + QCPLayer *oldLayer = mLayer; + if (mLayer) + mLayer->removeChild(this); + mLayer = layer; + if (mLayer) + mLayer->addChild(this, prepend); + if (mLayer != oldLayer) + emit layerChanged(mLayer); + return true; +} + +/*! \internal + + Sets the QCPainter::setAntialiasing state on the provided \a painter, depending on the \a + localAntialiased value as well as the overrides \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. Which override enum this function takes into account is + controlled via \a overrideElement. +*/ +void QCPLayerable::applyAntialiasingHint(QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const +{ + if (mParentPlot && mParentPlot->notAntialiasedElements().testFlag(overrideElement)) + painter->setAntialiasing(false); + else if (mParentPlot && mParentPlot->antialiasedElements().testFlag(overrideElement)) + painter->setAntialiasing(true); + else + painter->setAntialiasing(localAntialiased); +} + +/*! \internal + + This function is called by \ref initializeParentPlot, to allow subclasses to react on the setting + of a parent plot. This is the case when 0 was passed as parent plot in the constructor, and the + parent plot is set at a later time. + + For example, QCPLayoutElement/QCPLayout hierarchies may be created independently of any + QCustomPlot at first. When they are then added to a layout inside the QCustomPlot, the top level + element of the hierarchy gets its parent plot initialized with \ref initializeParentPlot. To + propagate the parent plot to all the children of the hierarchy, the top level element then uses + this function to pass the parent plot on to its child elements. + + The default implementation does nothing. + + \see initializeParentPlot +*/ +void QCPLayerable::parentPlotInitialized(QCustomPlot *parentPlot) +{ + Q_UNUSED(parentPlot) +} + +/*! \internal + + Returns the selection category this layerable shall belong to. The selection category is used in + conjunction with \ref QCustomPlot::setInteractions to control which objects are selectable and + which aren't. + + Subclasses that don't fit any of the normal \ref QCP::Interaction values can use \ref + QCP::iSelectOther. This is what the default implementation returns. + + \see QCustomPlot::setInteractions +*/ +QCP::Interaction QCPLayerable::selectionCategory() const +{ + return QCP::iSelectOther; +} + +/*! \internal + + Returns the clipping rectangle of this layerable object. By default, this is the viewport of the + parent QCustomPlot. Specific subclasses may reimplement this function to provide different + clipping rects. + + The returned clipping rect is set on the painter before the draw function of the respective + object is called. +*/ +QRect QCPLayerable::clipRect() const +{ + if (mParentPlot) + return mParentPlot->viewport(); + else + return QRect(); +} + +/*! \internal + + This event is called when the layerable shall be selected, as a consequence of a click by the + user. Subclasses should react to it by setting their selection state appropriately. The default + implementation does nothing. + + \a event is the mouse event that caused the selection. \a additive indicates, whether the user + was holding the multi-select-modifier while performing the selection (see \ref + QCustomPlot::setMultiSelectModifier). if \a additive is true, the selection state must be toggled + (i.e. become selected when unselected and unselected when selected). + + Every selectEvent is preceded by a call to \ref selectTest, which has returned positively (i.e. + returned a value greater than 0 and less than the selection tolerance of the parent QCustomPlot). + The \a details data you output from \ref selectTest is fed back via \a details here. You may + use it to transport any kind of information from the selectTest to the possibly subsequent + selectEvent. Usually \a details is used to transfer which part was clicked, if it is a layerable + that has multiple individually selectable parts (like QCPAxis). This way selectEvent doesn't need + to do the calculation again to find out which part was actually clicked. + + \a selectionStateChanged is an output parameter. If the pointer is non-null, this function must + set the value either to true or false, depending on whether the selection state of this layerable + was actually changed. For layerables that only are selectable as a whole and not in parts, this + is simple: if \a additive is true, \a selectionStateChanged must also be set to true, because the + selection toggles. If \a additive is false, \a selectionStateChanged is only set to true, if the + layerable was previously unselected and now is switched to the selected state. + + \see selectTest, deselectEvent +*/ +void QCPLayerable::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) +{ + Q_UNUSED(event) + Q_UNUSED(additive) + Q_UNUSED(details) + Q_UNUSED(selectionStateChanged) +} + +/*! \internal + + This event is called when the layerable shall be deselected, either as consequence of a user + interaction or a call to \ref QCustomPlot::deselectAll. Subclasses should react to it by + unsetting their selection appropriately. + + just as in \ref selectEvent, the output parameter \a selectionStateChanged (if non-null), must + return true or false when the selection state of this layerable has changed or not changed, + respectively. + + \see selectTest, selectEvent +*/ +void QCPLayerable::deselectEvent(bool *selectionStateChanged) +{ + Q_UNUSED(selectionStateChanged) +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPRange +//////////////////////////////////////////////////////////////////////////////////////////////////// +/*! \class QCPRange + \brief Represents the range an axis is encompassing. + + contains a \a lower and \a upper double value and provides convenience input, output and + modification functions. + + \see QCPAxis::setRange +*/ + +/*! + Minimum range size (\a upper - \a lower) the range changing functions will accept. Smaller + intervals would cause errors due to the 11-bit exponent of double precision numbers, + corresponding to a minimum magnitude of roughly 1e-308. + \see validRange, maxRange +*/ +const double QCPRange::minRange = 1e-280; + +/*! + Maximum values (negative and positive) the range will accept in range-changing functions. + Larger absolute values would cause errors due to the 11-bit exponent of double precision numbers, + corresponding to a maximum magnitude of roughly 1e308. + Since the number of planck-volumes in the entire visible universe is only ~1e183, this should + be enough. + \see validRange, minRange +*/ +const double QCPRange::maxRange = 1e250; + +/*! + Constructs a range with \a lower and \a upper set to zero. +*/ +QCPRange::QCPRange() : + lower(0), + upper(0) +{ +} + +/*! \overload + Constructs a range with the specified \a lower and \a upper values. +*/ +QCPRange::QCPRange(double lower, double upper) : + lower(lower), + upper(upper) +{ + normalize(); +} + +/*! + Returns the size of the range, i.e. \a upper-\a lower +*/ +double QCPRange::size() const +{ + return upper-lower; +} + +/*! + Returns the center of the range, i.e. (\a upper+\a lower)*0.5 +*/ +double QCPRange::center() const +{ + return (upper+lower)*0.5; +} + +/*! + Makes sure \a lower is numerically smaller than \a upper. If this is not the case, the values + are swapped. +*/ +void QCPRange::normalize() +{ + if (lower > upper) + qSwap(lower, upper); +} + +/*! + Expands this range such that \a otherRange is contained in the new range. It is assumed that both + this range and \a otherRange are normalized (see \ref normalize). + + If \a otherRange is already inside the current range, this function does nothing. + + \see expanded +*/ +void QCPRange::expand(const QCPRange &otherRange) +{ + if (lower > otherRange.lower) + lower = otherRange.lower; + if (upper < otherRange.upper) + upper = otherRange.upper; +} + + +/*! + Returns an expanded range that contains this and \a otherRange. It is assumed that both this + range and \a otherRange are normalized (see \ref normalize). + + \see expand +*/ +QCPRange QCPRange::expanded(const QCPRange &otherRange) const +{ + QCPRange result = *this; + result.expand(otherRange); + return result; +} + +/*! + Returns a sanitized version of the range. Sanitized means for logarithmic scales, that + the range won't span the positive and negative sign domain, i.e. contain zero. Further + \a lower will always be numerically smaller (or equal) to \a upper. + + If the original range does span positive and negative sign domains or contains zero, + the returned range will try to approximate the original range as good as possible. + If the positive interval of the original range is wider than the negative interval, the + returned range will only contain the positive interval, with lower bound set to \a rangeFac or + \a rangeFac *\a upper, whichever is closer to zero. Same procedure is used if the negative interval + is wider than the positive interval, this time by changing the \a upper bound. +*/ +QCPRange QCPRange::sanitizedForLogScale() const +{ + double rangeFac = 1e-3; + QCPRange sanitizedRange(lower, upper); + sanitizedRange.normalize(); + // can't have range spanning negative and positive values in log plot, so change range to fix it + //if (qFuzzyCompare(sanitizedRange.lower+1, 1) && !qFuzzyCompare(sanitizedRange.upper+1, 1)) + if (sanitizedRange.lower == 0.0 && sanitizedRange.upper != 0.0) + { + // case lower is 0 + if (rangeFac < sanitizedRange.upper*rangeFac) + sanitizedRange.lower = rangeFac; + else + sanitizedRange.lower = sanitizedRange.upper*rangeFac; + } //else if (!qFuzzyCompare(lower+1, 1) && qFuzzyCompare(upper+1, 1)) + else if (sanitizedRange.lower != 0.0 && sanitizedRange.upper == 0.0) + { + // case upper is 0 + if (-rangeFac > sanitizedRange.lower*rangeFac) + sanitizedRange.upper = -rangeFac; + else + sanitizedRange.upper = sanitizedRange.lower*rangeFac; + } else if (sanitizedRange.lower < 0 && sanitizedRange.upper > 0) + { + // find out whether negative or positive interval is wider to decide which sign domain will be chosen + if (-sanitizedRange.lower > sanitizedRange.upper) + { + // negative is wider, do same as in case upper is 0 + if (-rangeFac > sanitizedRange.lower*rangeFac) + sanitizedRange.upper = -rangeFac; + else + sanitizedRange.upper = sanitizedRange.lower*rangeFac; + } else + { + // positive is wider, do same as in case lower is 0 + if (rangeFac < sanitizedRange.upper*rangeFac) + sanitizedRange.lower = rangeFac; + else + sanitizedRange.lower = sanitizedRange.upper*rangeFac; + } + } + // due to normalization, case lower>0 && upper<0 should never occur, because that implies upper= lower && value <= upper; +} + +/*! + Checks, whether the specified range is within valid bounds, which are defined + as QCPRange::maxRange and QCPRange::minRange. + A valid range means: + \li range bounds within -maxRange and maxRange + \li range size above minRange + \li range size below maxRange +*/ +bool QCPRange::validRange(double lower, double upper) +{ + return (lower > -maxRange && + upper < maxRange && + qAbs(lower-upper) > minRange && + qAbs(lower-upper) < maxRange && + !(lower > 0 && qIsInf(upper/lower)) && + !(upper < 0 && qIsInf(lower/upper))); +} + +/*! + \overload + Checks, whether the specified range is within valid bounds, which are defined + as QCPRange::maxRange and QCPRange::minRange. + A valid range means: + \li range bounds within -maxRange and maxRange + \li range size above minRange + \li range size below maxRange +*/ +bool QCPRange::validRange(const QCPRange &range) +{ + return (range.lower > -maxRange && + range.upper < maxRange && + qAbs(range.lower-range.upper) > minRange && + qAbs(range.lower-range.upper) < maxRange && + !(range.lower > 0 && qIsInf(range.upper/range.lower)) && + !(range.upper < 0 && qIsInf(range.lower/range.upper))); +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPMarginGroup +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPMarginGroup + \brief A margin group allows synchronization of margin sides if working with multiple layout elements. + + QCPMarginGroup allows you to tie a margin side of two or more layout elements together, such that + they will all have the same size, based on the largest required margin in the group. + + \n + \image html QCPMarginGroup.png "Demonstration of QCPMarginGroup" + \n + + In certain situations it is desirable that margins at specific sides are synchronized across + layout elements. For example, if one QCPAxisRect is below another one in a grid layout, it will + provide a cleaner look to the user if the left and right margins of the two axis rects are of the + same size. The left axis of the top axis rect will then be at the same horizontal position as the + left axis of the lower axis rect, making them appear aligned. The same applies for the right + axes. This is what QCPMarginGroup makes possible. + + To add/remove a specific side of a layout element to/from a margin group, use the \ref + QCPLayoutElement::setMarginGroup method. To completely break apart the margin group, either call + \ref clear, or just delete the margin group. + + \section QCPMarginGroup-example Example + + First create a margin group: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpmargingroup-creation-1 + Then set this group on the layout element sides: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpmargingroup-creation-2 + Here, we've used the first two axis rects of the plot and synchronized their left margins with + each other and their right margins with each other. +*/ + +/* start documentation of inline functions */ + +/*! \fn QList QCPMarginGroup::elements(QCP::MarginSide side) const + + Returns a list of all layout elements that have their margin \a side associated with this margin + group. +*/ + +/* end documentation of inline functions */ + +/*! + Creates a new QCPMarginGroup instance in \a parentPlot. +*/ +QCPMarginGroup::QCPMarginGroup(QCustomPlot *parentPlot) : + QObject(parentPlot), + mParentPlot(parentPlot) +{ + mChildren.insert(QCP::msLeft, QList()); + mChildren.insert(QCP::msRight, QList()); + mChildren.insert(QCP::msTop, QList()); + mChildren.insert(QCP::msBottom, QList()); +} + +QCPMarginGroup::~QCPMarginGroup() +{ + clear(); +} + +/*! + Returns whether this margin group is empty. If this function returns true, no layout elements use + this margin group to synchronize margin sides. +*/ +bool QCPMarginGroup::isEmpty() const +{ + QHashIterator > it(mChildren); + while (it.hasNext()) + { + it.next(); + if (!it.value().isEmpty()) + return false; + } + return true; +} + +/*! + Clears this margin group. The synchronization of the margin sides that use this margin group is + lifted and they will use their individual margin sizes again. +*/ +void QCPMarginGroup::clear() +{ + // make all children remove themselves from this margin group: + QHashIterator > it(mChildren); + while (it.hasNext()) + { + it.next(); + const QList elements = it.value(); + for (int i=elements.size()-1; i>=0; --i) + elements.at(i)->setMarginGroup(it.key(), 0); // removes itself from mChildren via removeChild + } +} + +/*! \internal + + Returns the synchronized common margin for \a side. This is the margin value that will be used by + the layout element on the respective side, if it is part of this margin group. + + The common margin is calculated by requesting the automatic margin (\ref + QCPLayoutElement::calculateAutoMargin) of each element associated with \a side in this margin + group, and choosing the largest returned value. (QCPLayoutElement::minimumMargins is taken into + account, too.) +*/ +int QCPMarginGroup::commonMargin(QCP::MarginSide side) const +{ + // query all automatic margins of the layout elements in this margin group side and find maximum: + int result = 0; + const QList elements = mChildren.value(side); + for (int i=0; iautoMargins().testFlag(side)) + continue; + int m = qMax(elements.at(i)->calculateAutoMargin(side), QCP::getMarginValue(elements.at(i)->minimumMargins(), side)); + if (m > result) + result = m; + } + return result; +} + +/*! \internal + + Adds \a element to the internal list of child elements, for the margin \a side. + + This function does not modify the margin group property of \a element. +*/ +void QCPMarginGroup::addChild(QCP::MarginSide side, QCPLayoutElement *element) +{ + if (!mChildren[side].contains(element)) + mChildren[side].append(element); + else + qDebug() << Q_FUNC_INFO << "element is already child of this margin group side" << reinterpret_cast(element); +} + +/*! \internal + + Removes \a element from the internal list of child elements, for the margin \a side. + + This function does not modify the margin group property of \a element. +*/ +void QCPMarginGroup::removeChild(QCP::MarginSide side, QCPLayoutElement *element) +{ + if (!mChildren[side].removeOne(element)) + qDebug() << Q_FUNC_INFO << "element is not child of this margin group side" << reinterpret_cast(element); +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPLayoutElement +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPLayoutElement + \brief The abstract base class for all objects that form \ref thelayoutsystem "the layout system". + + This is an abstract base class. As such, it can't be instantiated directly, rather use one of its subclasses. + + A Layout element is a rectangular object which can be placed in layouts. It has an outer rect + (QCPLayoutElement::outerRect) and an inner rect (\ref QCPLayoutElement::rect). The difference + between outer and inner rect is called its margin. The margin can either be set to automatic or + manual (\ref setAutoMargins) on a per-side basis. If a side is set to manual, that margin can be + set explicitly with \ref setMargins and will stay fixed at that value. If it's set to automatic, + the layout element subclass will control the value itself (via \ref calculateAutoMargin). + + Layout elements can be placed in layouts (base class QCPLayout) like QCPLayoutGrid. The top level + layout is reachable via \ref QCustomPlot::plotLayout, and is a \ref QCPLayoutGrid. Since \ref + QCPLayout itself derives from \ref QCPLayoutElement, layouts can be nested. + + Thus in QCustomPlot one can divide layout elements into two categories: The ones that are + invisible by themselves, because they don't draw anything. Their only purpose is to manage the + position and size of other layout elements. This category of layout elements usually use + QCPLayout as base class. Then there is the category of layout elements which actually draw + something. For example, QCPAxisRect, QCPLegend and QCPPlotTitle are of this category. This does + not necessarily mean that the latter category can't have child layout elements. QCPLegend for + instance, actually derives from QCPLayoutGrid and the individual legend items are child layout + elements in the grid layout. +*/ + +/* start documentation of inline functions */ + +/*! \fn QCPLayout *QCPLayoutElement::layout() const + + Returns the parent layout of this layout element. +*/ + +/*! \fn QRect QCPLayoutElement::rect() const + + Returns the inner rect of this layout element. The inner rect is the outer rect (\ref + setOuterRect) shrinked by the margins (\ref setMargins, \ref setAutoMargins). + + In some cases, the area between outer and inner rect is left blank. In other cases the margin + area is used to display peripheral graphics while the main content is in the inner rect. This is + where automatic margin calculation becomes interesting because it allows the layout element to + adapt the margins to the peripheral graphics it wants to draw. For example, \ref QCPAxisRect + draws the axis labels and tick labels in the margin area, thus needs to adjust the margins (if + \ref setAutoMargins is enabled) according to the space required by the labels of the axes. +*/ + +/*! \fn virtual void QCPLayoutElement::mousePressEvent(QMouseEvent *event) + + This event is called, if the mouse was pressed while being inside the outer rect of this layout + element. +*/ + +/*! \fn virtual void QCPLayoutElement::mouseMoveEvent(QMouseEvent *event) + + This event is called, if the mouse is moved inside the outer rect of this layout element. +*/ + +/*! \fn virtual void QCPLayoutElement::mouseReleaseEvent(QMouseEvent *event) + + This event is called, if the mouse was previously pressed inside the outer rect of this layout + element and is now released. +*/ + +/*! \fn virtual void QCPLayoutElement::mouseDoubleClickEvent(QMouseEvent *event) + + This event is called, if the mouse is double-clicked inside the outer rect of this layout + element. +*/ + +/*! \fn virtual void QCPLayoutElement::wheelEvent(QWheelEvent *event) + + This event is called, if the mouse wheel is scrolled while the cursor is inside the rect of this + layout element. +*/ + +/* end documentation of inline functions */ + +/*! + Creates an instance of QCPLayoutElement and sets default values. +*/ +QCPLayoutElement::QCPLayoutElement(QCustomPlot *parentPlot) : + QCPLayerable(parentPlot), // parenthood is changed as soon as layout element gets inserted into a layout (except for top level layout) + mParentLayout(0), + mMinimumSize(), + mMaximumSize(QWIDGETSIZE_MAX, QWIDGETSIZE_MAX), + mRect(0, 0, 0, 0), + mOuterRect(0, 0, 0, 0), + mMargins(0, 0, 0, 0), + mMinimumMargins(0, 0, 0, 0), + mAutoMargins(QCP::msAll) +{ +} + +QCPLayoutElement::~QCPLayoutElement() +{ + setMarginGroup(QCP::msAll, 0); // unregister at margin groups, if there are any + // unregister at layout: + if (qobject_cast(mParentLayout)) // the qobject_cast is just a safeguard in case the layout forgets to call clear() in its dtor and this dtor is called by QObject dtor + mParentLayout->take(this); +} + +/*! + Sets the outer rect of this layout element. If the layout element is inside a layout, the layout + sets the position and size of this layout element using this function. + + Calling this function externally has no effect, since the layout will overwrite any changes to + the outer rect upon the next replot. + + The layout element will adapt its inner \ref rect by applying the margins inward to the outer rect. + + \see rect +*/ +void QCPLayoutElement::setOuterRect(const QRect &rect) +{ + if (mOuterRect != rect) + { + mOuterRect = rect; + mRect = mOuterRect.adjusted(mMargins.left(), mMargins.top(), -mMargins.right(), -mMargins.bottom()); + } +} + +/*! + Sets the margins of this layout element. If \ref setAutoMargins is disabled for some or all + sides, this function is used to manually set the margin on those sides. Sides that are still set + to be handled automatically are ignored and may have any value in \a margins. + + The margin is the distance between the outer rect (controlled by the parent layout via \ref + setOuterRect) and the inner \ref rect (which usually contains the main content of this layout + element). + + \see setAutoMargins +*/ +void QCPLayoutElement::setMargins(const QMargins &margins) +{ + if (mMargins != margins) + { + mMargins = margins; + mRect = mOuterRect.adjusted(mMargins.left(), mMargins.top(), -mMargins.right(), -mMargins.bottom()); + } +} + +/*! + If \ref setAutoMargins is enabled on some or all margins, this function is used to provide + minimum values for those margins. + + The minimum values are not enforced on margin sides that were set to be under manual control via + \ref setAutoMargins. + + \see setAutoMargins +*/ +void QCPLayoutElement::setMinimumMargins(const QMargins &margins) +{ + if (mMinimumMargins != margins) + { + mMinimumMargins = margins; + } +} + +/*! + Sets on which sides the margin shall be calculated automatically. If a side is calculated + automatically, a minimum margin value may be provided with \ref setMinimumMargins. If a side is + set to be controlled manually, the value may be specified with \ref setMargins. + + Margin sides that are under automatic control may participate in a \ref QCPMarginGroup (see \ref + setMarginGroup), to synchronize (align) it with other layout elements in the plot. + + \see setMinimumMargins, setMargins +*/ +void QCPLayoutElement::setAutoMargins(QCP::MarginSides sides) +{ + mAutoMargins = sides; +} + +/*! + Sets the minimum size for the inner \ref rect of this layout element. A parent layout tries to + respect the \a size here by changing row/column sizes in the layout accordingly. + + If the parent layout size is not sufficient to satisfy all minimum size constraints of its child + layout elements, the layout may set a size that is actually smaller than \a size. QCustomPlot + propagates the layout's size constraints to the outside by setting its own minimum QWidget size + accordingly, so violations of \a size should be exceptions. +*/ +void QCPLayoutElement::setMinimumSize(const QSize &size) +{ + if (mMinimumSize != size) + { + mMinimumSize = size; + if (mParentLayout) + mParentLayout->sizeConstraintsChanged(); + } +} + +/*! \overload + + Sets the minimum size for the inner \ref rect of this layout element. +*/ +void QCPLayoutElement::setMinimumSize(int width, int height) +{ + setMinimumSize(QSize(width, height)); +} + +/*! + Sets the maximum size for the inner \ref rect of this layout element. A parent layout tries to + respect the \a size here by changing row/column sizes in the layout accordingly. +*/ +void QCPLayoutElement::setMaximumSize(const QSize &size) +{ + if (mMaximumSize != size) + { + mMaximumSize = size; + if (mParentLayout) + mParentLayout->sizeConstraintsChanged(); + } +} + +/*! \overload + + Sets the maximum size for the inner \ref rect of this layout element. +*/ +void QCPLayoutElement::setMaximumSize(int width, int height) +{ + setMaximumSize(QSize(width, height)); +} + +/*! + Sets the margin \a group of the specified margin \a sides. + + Margin groups allow synchronizing specified margins across layout elements, see the documentation + of \ref QCPMarginGroup. + + To unset the margin group of \a sides, set \a group to 0. + + Note that margin groups only work for margin sides that are set to automatic (\ref + setAutoMargins). +*/ +void QCPLayoutElement::setMarginGroup(QCP::MarginSides sides, QCPMarginGroup *group) +{ + QVector sideVector; + if (sides.testFlag(QCP::msLeft)) sideVector.append(QCP::msLeft); + if (sides.testFlag(QCP::msRight)) sideVector.append(QCP::msRight); + if (sides.testFlag(QCP::msTop)) sideVector.append(QCP::msTop); + if (sides.testFlag(QCP::msBottom)) sideVector.append(QCP::msBottom); + + for (int i=0; iremoveChild(side, this); + + if (!group) // if setting to 0, remove hash entry. Else set hash entry to new group and register there + { + mMarginGroups.remove(side); + } else // setting to a new group + { + mMarginGroups[side] = group; + group->addChild(side, this); + } + } + } +} + +/*! + Updates the layout element and sub-elements. This function is automatically called before every + replot by the parent layout element. It is called multiple times, once for every \ref + UpdatePhase. The phases are run through in the order of the enum values. For details about what + happens at the different phases, see the documentation of \ref UpdatePhase. + + Layout elements that have child elements should call the \ref update method of their child + elements, and pass the current \a phase unchanged. + + The default implementation executes the automatic margin mechanism in the \ref upMargins phase. + Subclasses should make sure to call the base class implementation. +*/ +void QCPLayoutElement::update(UpdatePhase phase) +{ + if (phase == upMargins) + { + if (mAutoMargins != QCP::msNone) + { + // set the margins of this layout element according to automatic margin calculation, either directly or via a margin group: + QMargins newMargins = mMargins; + QList allMarginSides = QList() << QCP::msLeft << QCP::msRight << QCP::msTop << QCP::msBottom; + foreach (QCP::MarginSide side, allMarginSides) + { + if (mAutoMargins.testFlag(side)) // this side's margin shall be calculated automatically + { + if (mMarginGroups.contains(side)) + QCP::setMarginValue(newMargins, side, mMarginGroups[side]->commonMargin(side)); // this side is part of a margin group, so get the margin value from that group + else + QCP::setMarginValue(newMargins, side, calculateAutoMargin(side)); // this side is not part of a group, so calculate the value directly + // apply minimum margin restrictions: + if (QCP::getMarginValue(newMargins, side) < QCP::getMarginValue(mMinimumMargins, side)) + QCP::setMarginValue(newMargins, side, QCP::getMarginValue(mMinimumMargins, side)); + } + } + setMargins(newMargins); + } + } +} + +/*! + Returns the minimum size this layout element (the inner \ref rect) may be compressed to. + + if a minimum size (\ref setMinimumSize) was not set manually, parent layouts consult this + function to determine the minimum allowed size of this layout element. (A manual minimum size is + considered set if it is non-zero.) +*/ +QSize QCPLayoutElement::minimumSizeHint() const +{ + return mMinimumSize; +} + +/*! + Returns the maximum size this layout element (the inner \ref rect) may be expanded to. + + if a maximum size (\ref setMaximumSize) was not set manually, parent layouts consult this + function to determine the maximum allowed size of this layout element. (A manual maximum size is + considered set if it is smaller than Qt's QWIDGETSIZE_MAX.) +*/ +QSize QCPLayoutElement::maximumSizeHint() const +{ + return mMaximumSize; +} + +/*! + Returns a list of all child elements in this layout element. If \a recursive is true, all + sub-child elements are included in the list, too. + + \warning There may be entries with value 0 in the returned list. (For example, QCPLayoutGrid may have + empty cells which yield 0 at the respective index.) +*/ +QList QCPLayoutElement::elements(bool recursive) const +{ + Q_UNUSED(recursive) + return QList(); +} + +/*! + Layout elements are sensitive to events inside their outer rect. If \a pos is within the outer + rect, this method returns a value corresponding to 0.99 times the parent plot's selection + tolerance. However, layout elements are not selectable by default. So if \a onlySelectable is + true, -1.0 is returned. + + See \ref QCPLayerable::selectTest for a general explanation of this virtual method. + + QCPLayoutElement subclasses may reimplement this method to provide more specific selection test + behaviour. +*/ +double QCPLayoutElement::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + + if (onlySelectable) + return -1; + + if (QRectF(mOuterRect).contains(pos)) + { + if (mParentPlot) + return mParentPlot->selectionTolerance()*0.99; + else + { + qDebug() << Q_FUNC_INFO << "parent plot not defined"; + return -1; + } + } else + return -1; +} + +/*! \internal + + propagates the parent plot initialization to all child elements, by calling \ref + QCPLayerable::initializeParentPlot on them. +*/ +void QCPLayoutElement::parentPlotInitialized(QCustomPlot *parentPlot) +{ + foreach (QCPLayoutElement* el, elements(false)) + { + if (!el->parentPlot()) + el->initializeParentPlot(parentPlot); + } +} + +/*! \internal + + Returns the margin size for this \a side. It is used if automatic margins is enabled for this \a + side (see \ref setAutoMargins). If a minimum margin was set with \ref setMinimumMargins, the + returned value will not be smaller than the specified minimum margin. + + The default implementation just returns the respective manual margin (\ref setMargins) or the + minimum margin, whichever is larger. +*/ +int QCPLayoutElement::calculateAutoMargin(QCP::MarginSide side) +{ + return qMax(QCP::getMarginValue(mMargins, side), QCP::getMarginValue(mMinimumMargins, side)); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPLayout +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPLayout + \brief The abstract base class for layouts + + This is an abstract base class for layout elements whose main purpose is to define the position + and size of other child layout elements. In most cases, layouts don't draw anything themselves + (but there are exceptions to this, e.g. QCPLegend). + + QCPLayout derives from QCPLayoutElement, and thus can itself be nested in other layouts. + + QCPLayout introduces a common interface for accessing and manipulating the child elements. Those + functions are most notably \ref elementCount, \ref elementAt, \ref takeAt, \ref take, \ref + simplify, \ref removeAt, \ref remove and \ref clear. Individual subclasses may add more functions + to this interface which are more specialized to the form of the layout. For example, \ref + QCPLayoutGrid adds functions that take row and column indices to access cells of the layout grid + more conveniently. + + Since this is an abstract base class, you can't instantiate it directly. Rather use one of its + subclasses like QCPLayoutGrid or QCPLayoutInset. + + For a general introduction to the layout system, see the dedicated documentation page \ref + thelayoutsystem "The Layout System". +*/ + +/* start documentation of pure virtual functions */ + +/*! \fn virtual int QCPLayout::elementCount() const = 0 + + Returns the number of elements/cells in the layout. + + \see elements, elementAt +*/ + +/*! \fn virtual QCPLayoutElement* QCPLayout::elementAt(int index) const = 0 + + Returns the element in the cell with the given \a index. If \a index is invalid, returns 0. + + Note that even if \a index is valid, the respective cell may be empty in some layouts (e.g. + QCPLayoutGrid), so this function may return 0 in those cases. You may use this function to check + whether a cell is empty or not. + + \see elements, elementCount, takeAt +*/ + +/*! \fn virtual QCPLayoutElement* QCPLayout::takeAt(int index) = 0 + + Removes the element with the given \a index from the layout and returns it. + + If the \a index is invalid or the cell with that index is empty, returns 0. + + Note that some layouts don't remove the respective cell right away but leave an empty cell after + successful removal of the layout element. To collapse empty cells, use \ref simplify. + + \see elementAt, take +*/ + +/*! \fn virtual bool QCPLayout::take(QCPLayoutElement* element) = 0 + + Removes the specified \a element from the layout and returns true on success. + + If the \a element isn't in this layout, returns false. + + Note that some layouts don't remove the respective cell right away but leave an empty cell after + successful removal of the layout element. To collapse empty cells, use \ref simplify. + + \see takeAt +*/ + +/* end documentation of pure virtual functions */ + +/*! + Creates an instance of QCPLayout and sets default values. Note that since QCPLayout + is an abstract base class, it can't be instantiated directly. +*/ +QCPLayout::QCPLayout() +{ +} + +/*! + First calls the QCPLayoutElement::update base class implementation to update the margins on this + layout. + + Then calls \ref updateLayout which subclasses reimplement to reposition and resize their cells. + + Finally, \ref update is called on all child elements. +*/ +void QCPLayout::update(UpdatePhase phase) +{ + QCPLayoutElement::update(phase); + + // set child element rects according to layout: + if (phase == upLayout) + updateLayout(); + + // propagate update call to child elements: + const int elCount = elementCount(); + for (int i=0; iupdate(phase); + } +} + +/* inherits documentation from base class */ +QList QCPLayout::elements(bool recursive) const +{ + const int c = elementCount(); + QList result; +#if QT_VERSION >= QT_VERSION_CHECK(4, 7, 0) + result.reserve(c); +#endif + for (int i=0; ielements(recursive); + } + } + return result; +} + +/*! + Simplifies the layout by collapsing empty cells. The exact behavior depends on subclasses, the + default implementation does nothing. + + Not all layouts need simplification. For example, QCPLayoutInset doesn't use explicit + simplification while QCPLayoutGrid does. +*/ +void QCPLayout::simplify() +{ +} + +/*! + Removes and deletes the element at the provided \a index. Returns true on success. If \a index is + invalid or points to an empty cell, returns false. + + This function internally uses \ref takeAt to remove the element from the layout and then deletes + the returned element. Note that some layouts don't remove the respective cell right away but leave an + empty cell after successful removal of the layout element. To collapse empty cells, use \ref + simplify. + + \see remove, takeAt +*/ +bool QCPLayout::removeAt(int index) +{ + if (QCPLayoutElement *el = takeAt(index)) + { + delete el; + return true; + } else + return false; +} + +/*! + Removes and deletes the provided \a element. Returns true on success. If \a element is not in the + layout, returns false. + + This function internally uses \ref takeAt to remove the element from the layout and then deletes + the element. Note that some layouts don't remove the respective cell right away but leave an + empty cell after successful removal of the layout element. To collapse empty cells, use \ref + simplify. + + \see removeAt, take +*/ +bool QCPLayout::remove(QCPLayoutElement *element) +{ + if (take(element)) + { + delete element; + return true; + } else + return false; +} + +/*! + Removes and deletes all layout elements in this layout. Finally calls \ref simplify to make sure + all empty cells are collapsed. + + \see remove, removeAt +*/ +void QCPLayout::clear() +{ + for (int i=elementCount()-1; i>=0; --i) + { + if (elementAt(i)) + removeAt(i); + } + simplify(); +} + +/*! + Subclasses call this method to report changed (minimum/maximum) size constraints. + + If the parent of this layout is again a QCPLayout, forwards the call to the parent's \ref + sizeConstraintsChanged. If the parent is a QWidget (i.e. is the \ref QCustomPlot::plotLayout of + QCustomPlot), calls QWidget::updateGeometry, so if the QCustomPlot widget is inside a Qt QLayout, + it may update itself and resize cells accordingly. +*/ +void QCPLayout::sizeConstraintsChanged() const +{ + if (QWidget *w = qobject_cast(parent())) + w->updateGeometry(); + else if (QCPLayout *l = qobject_cast(parent())) + l->sizeConstraintsChanged(); +} + +/*! \internal + + Subclasses reimplement this method to update the position and sizes of the child elements/cells + via calling their \ref QCPLayoutElement::setOuterRect. The default implementation does nothing. + + The geometry used as a reference is the inner \ref rect of this layout. Child elements should stay + within that rect. + + \ref getSectionSizes may help with the reimplementation of this function. + + \see update +*/ +void QCPLayout::updateLayout() +{ +} + + +/*! \internal + + Associates \a el with this layout. This is done by setting the \ref QCPLayoutElement::layout, the + \ref QCPLayerable::parentLayerable and the QObject parent to this layout. + + Further, if \a el didn't previously have a parent plot, calls \ref + QCPLayerable::initializeParentPlot on \a el to set the paret plot. + + This method is used by subclass specific methods that add elements to the layout. Note that this + method only changes properties in \a el. The removal from the old layout and the insertion into + the new layout must be done additionally. +*/ +void QCPLayout::adoptElement(QCPLayoutElement *el) +{ + if (el) + { + el->mParentLayout = this; + el->setParentLayerable(this); + el->setParent(this); + if (!el->parentPlot()) + el->initializeParentPlot(mParentPlot); + } else + qDebug() << Q_FUNC_INFO << "Null element passed"; +} + +/*! \internal + + Disassociates \a el from this layout. This is done by setting the \ref QCPLayoutElement::layout + and the \ref QCPLayerable::parentLayerable to zero. The QObject parent is set to the parent + QCustomPlot. + + This method is used by subclass specific methods that remove elements from the layout (e.g. \ref + take or \ref takeAt). Note that this method only changes properties in \a el. The removal from + the old layout must be done additionally. +*/ +void QCPLayout::releaseElement(QCPLayoutElement *el) +{ + if (el) + { + el->mParentLayout = 0; + el->setParentLayerable(0); + el->setParent(mParentPlot); + // Note: Don't initializeParentPlot(0) here, because layout element will stay in same parent plot + } else + qDebug() << Q_FUNC_INFO << "Null element passed"; +} + +/*! \internal + + This is a helper function for the implementation of \ref updateLayout in subclasses. + + It calculates the sizes of one-dimensional sections with provided constraints on maximum section + sizes, minimum section sizes, relative stretch factors and the final total size of all sections. + + The QVector entries refer to the sections. Thus all QVectors must have the same size. + + \a maxSizes gives the maximum allowed size of each section. If there shall be no maximum size + imposed, set all vector values to Qt's QWIDGETSIZE_MAX. + + \a minSizes gives the minimum allowed size of each section. If there shall be no minimum size + imposed, set all vector values to zero. If the \a minSizes entries add up to a value greater than + \a totalSize, sections will be scaled smaller than the proposed minimum sizes. (In other words, + not exceeding the allowed total size is taken to be more important than not going below minimum + section sizes.) + + \a stretchFactors give the relative proportions of the sections to each other. If all sections + shall be scaled equally, set all values equal. If the first section shall be double the size of + each individual other section, set the first number of \a stretchFactors to double the value of + the other individual values (e.g. {2, 1, 1, 1}). + + \a totalSize is the value that the final section sizes will add up to. Due to rounding, the + actual sum may differ slightly. If you want the section sizes to sum up to exactly that value, + you could distribute the remaining difference on the sections. + + The return value is a QVector containing the section sizes. +*/ +QVector QCPLayout::getSectionSizes(QVector maxSizes, QVector minSizes, QVector stretchFactors, int totalSize) const +{ + if (maxSizes.size() != minSizes.size() || minSizes.size() != stretchFactors.size()) + { + qDebug() << Q_FUNC_INFO << "Passed vector sizes aren't equal:" << maxSizes << minSizes << stretchFactors; + return QVector(); + } + if (stretchFactors.isEmpty()) + return QVector(); + int sectionCount = stretchFactors.size(); + QVector sectionSizes(sectionCount); + // if provided total size is forced smaller than total minimum size, ignore minimum sizes (squeeze sections): + int minSizeSum = 0; + for (int i=0; i minimumLockedSections; + QList unfinishedSections; + for (int i=0; i result(sectionCount); + for (int i=0; i= 0 && row < mElements.size()) + { + if (column >= 0 && column < mElements.first().size()) + { + if (QCPLayoutElement *result = mElements.at(row).at(column)) + return result; + else + qDebug() << Q_FUNC_INFO << "Requested cell is empty. Row:" << row << "Column:" << column; + } else + qDebug() << Q_FUNC_INFO << "Invalid column. Row:" << row << "Column:" << column; + } else + qDebug() << Q_FUNC_INFO << "Invalid row. Row:" << row << "Column:" << column; + return 0; +} + +/*! + Returns the number of rows in the layout. + + \see columnCount +*/ +int QCPLayoutGrid::rowCount() const +{ + return mElements.size(); +} + +/*! + Returns the number of columns in the layout. + + \see rowCount +*/ +int QCPLayoutGrid::columnCount() const +{ + if (mElements.size() > 0) + return mElements.first().size(); + else + return 0; +} + +/*! + Adds the \a element to cell with \a row and \a column. If \a element is already in a layout, it + is first removed from there. If \a row or \a column don't exist yet, the layout is expanded + accordingly. + + Returns true if the element was added successfully, i.e. if the cell at \a row and \a column + didn't already have an element. + + \see element, hasElement, take, remove +*/ +bool QCPLayoutGrid::addElement(int row, int column, QCPLayoutElement *element) +{ + if (element) + { + if (!hasElement(row, column)) + { + if (element->layout()) // remove from old layout first + element->layout()->take(element); + expandTo(row+1, column+1); + mElements[row][column] = element; + adoptElement(element); + return true; + } else + qDebug() << Q_FUNC_INFO << "There is already an element in the specified row/column:" << row << column; + } else + qDebug() << Q_FUNC_INFO << "Can't add null element to row/column:" << row << column; + return false; +} + +/*! + Returns whether the cell at \a row and \a column exists and contains a valid element, i.e. isn't + empty. + + \see element +*/ +bool QCPLayoutGrid::hasElement(int row, int column) +{ + if (row >= 0 && row < rowCount() && column >= 0 && column < columnCount()) + return mElements.at(row).at(column); + else + return false; +} + +/*! + Sets the stretch \a factor of \a column. + + Stretch factors control the relative sizes of rows and columns. Cells will not be resized beyond + their minimum and maximum widths/heights (\ref QCPLayoutElement::setMinimumSize, \ref + QCPLayoutElement::setMaximumSize), regardless of the stretch factor. + + The default stretch factor of newly created rows/columns is 1. + + \see setColumnStretchFactors, setRowStretchFactor +*/ +void QCPLayoutGrid::setColumnStretchFactor(int column, double factor) +{ + if (column >= 0 && column < columnCount()) + { + if (factor > 0) + mColumnStretchFactors[column] = factor; + else + qDebug() << Q_FUNC_INFO << "Invalid stretch factor, must be positive:" << factor; + } else + qDebug() << Q_FUNC_INFO << "Invalid column:" << column; +} + +/*! + Sets the stretch \a factors of all columns. \a factors must have the size \ref columnCount. + + Stretch factors control the relative sizes of rows and columns. Cells will not be resized beyond + their minimum and maximum widths/heights (\ref QCPLayoutElement::setMinimumSize, \ref + QCPLayoutElement::setMaximumSize), regardless of the stretch factor. + + The default stretch factor of newly created rows/columns is 1. + + \see setColumnStretchFactor, setRowStretchFactors +*/ +void QCPLayoutGrid::setColumnStretchFactors(const QList &factors) +{ + if (factors.size() == mColumnStretchFactors.size()) + { + mColumnStretchFactors = factors; + for (int i=0; i= 0 && row < rowCount()) + { + if (factor > 0) + mRowStretchFactors[row] = factor; + else + qDebug() << Q_FUNC_INFO << "Invalid stretch factor, must be positive:" << factor; + } else + qDebug() << Q_FUNC_INFO << "Invalid row:" << row; +} + +/*! + Sets the stretch \a factors of all rows. \a factors must have the size \ref rowCount. + + Stretch factors control the relative sizes of rows and columns. Cells will not be resized beyond + their minimum and maximum widths/heights (\ref QCPLayoutElement::setMinimumSize, \ref + QCPLayoutElement::setMaximumSize), regardless of the stretch factor. + + The default stretch factor of newly created rows/columns is 1. + + \see setRowStretchFactor, setColumnStretchFactors +*/ +void QCPLayoutGrid::setRowStretchFactors(const QList &factors) +{ + if (factors.size() == mRowStretchFactors.size()) + { + mRowStretchFactors = factors; + for (int i=0; i()); + mRowStretchFactors.append(1); + } + // go through rows and expand columns as necessary: + int newColCount = qMax(columnCount(), newColumnCount); + for (int i=0; i rowCount()) + newIndex = rowCount(); + + mRowStretchFactors.insert(newIndex, 1); + QList newRow; + for (int col=0; col columnCount()) + newIndex = columnCount(); + + mColumnStretchFactors.insert(newIndex, 1); + for (int row=0; row minColWidths, minRowHeights, maxColWidths, maxRowHeights; + getMinimumRowColSizes(&minColWidths, &minRowHeights); + getMaximumRowColSizes(&maxColWidths, &maxRowHeights); + + int totalRowSpacing = (rowCount()-1) * mRowSpacing; + int totalColSpacing = (columnCount()-1) * mColumnSpacing; + QVector colWidths = getSectionSizes(maxColWidths, minColWidths, mColumnStretchFactors.toVector(), mRect.width()-totalColSpacing); + QVector rowHeights = getSectionSizes(maxRowHeights, minRowHeights, mRowStretchFactors.toVector(), mRect.height()-totalRowSpacing); + + // go through cells and set rects accordingly: + int yOffset = mRect.top(); + for (int row=0; row 0) + yOffset += rowHeights.at(row-1)+mRowSpacing; + int xOffset = mRect.left(); + for (int col=0; col 0) + xOffset += colWidths.at(col-1)+mColumnSpacing; + if (mElements.at(row).at(col)) + mElements.at(row).at(col)->setOuterRect(QRect(xOffset, yOffset, colWidths.at(col), rowHeights.at(row))); + } + } +} + +/* inherits documentation from base class */ +int QCPLayoutGrid::elementCount() const +{ + return rowCount()*columnCount(); +} + +/* inherits documentation from base class */ +QCPLayoutElement *QCPLayoutGrid::elementAt(int index) const +{ + if (index >= 0 && index < elementCount()) + return mElements.at(index / columnCount()).at(index % columnCount()); + else + return 0; +} + +/* inherits documentation from base class */ +QCPLayoutElement *QCPLayoutGrid::takeAt(int index) +{ + if (QCPLayoutElement *el = elementAt(index)) + { + releaseElement(el); + mElements[index / columnCount()][index % columnCount()] = 0; + return el; + } else + { + qDebug() << Q_FUNC_INFO << "Attempt to take invalid index:" << index; + return 0; + } +} + +/* inherits documentation from base class */ +bool QCPLayoutGrid::take(QCPLayoutElement *element) +{ + if (element) + { + for (int i=0; i QCPLayoutGrid::elements(bool recursive) const +{ + QList result; + int colC = columnCount(); + int rowC = rowCount(); +#if QT_VERSION >= QT_VERSION_CHECK(4, 7, 0) + result.reserve(colC*rowC); +#endif + for (int row=0; rowelements(recursive); + } + } + return result; +} + +/*! + Simplifies the layout by collapsing rows and columns which only contain empty cells. +*/ +void QCPLayoutGrid::simplify() +{ + // remove rows with only empty cells: + for (int row=rowCount()-1; row>=0; --row) + { + bool hasElements = false; + for (int col=0; col=0; --col) + { + bool hasElements = false; + for (int row=0; row minColWidths, minRowHeights; + getMinimumRowColSizes(&minColWidths, &minRowHeights); + QSize result(0, 0); + for (int i=0; i maxColWidths, maxRowHeights; + getMaximumRowColSizes(&maxColWidths, &maxRowHeights); + + QSize result(0, 0); + for (int i=0; i *minColWidths, QVector *minRowHeights) const +{ + *minColWidths = QVector(columnCount(), 0); + *minRowHeights = QVector(rowCount(), 0); + for (int row=0; rowminimumSizeHint(); + QSize min = mElements.at(row).at(col)->minimumSize(); + QSize final(min.width() > 0 ? min.width() : minHint.width(), min.height() > 0 ? min.height() : minHint.height()); + if (minColWidths->at(col) < final.width()) + (*minColWidths)[col] = final.width(); + if (minRowHeights->at(row) < final.height()) + (*minRowHeights)[row] = final.height(); + } + } + } +} + +/*! \internal + + Places the maximum column widths and row heights into \a maxColWidths and \a maxRowHeights + respectively. + + The maximum height of a row is the smallest maximum height of any element in that row. The + maximum width of a column is the smallest maximum width of any element in that column. + + This is a helper function for \ref updateLayout. + + \see getMinimumRowColSizes +*/ +void QCPLayoutGrid::getMaximumRowColSizes(QVector *maxColWidths, QVector *maxRowHeights) const +{ + *maxColWidths = QVector(columnCount(), QWIDGETSIZE_MAX); + *maxRowHeights = QVector(rowCount(), QWIDGETSIZE_MAX); + for (int row=0; rowmaximumSizeHint(); + QSize max = mElements.at(row).at(col)->maximumSize(); + QSize final(max.width() < QWIDGETSIZE_MAX ? max.width() : maxHint.width(), max.height() < QWIDGETSIZE_MAX ? max.height() : maxHint.height()); + if (maxColWidths->at(col) > final.width()) + (*maxColWidths)[col] = final.width(); + if (maxRowHeights->at(row) > final.height()) + (*maxRowHeights)[row] = final.height(); + } + } + } +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPLayoutInset +//////////////////////////////////////////////////////////////////////////////////////////////////// +/*! \class QCPLayoutInset + \brief A layout that places child elements aligned to the border or arbitrarily positioned + + Elements are placed either aligned to the border or at arbitrary position in the area of the + layout. Which placement applies is controlled with the \ref InsetPlacement (\ref + setInsetPlacement). + + Elements are added via \ref addElement(QCPLayoutElement *element, Qt::Alignment alignment) or + addElement(QCPLayoutElement *element, const QRectF &rect). If the first method is used, the inset + placement will default to \ref ipBorderAligned and the element will be aligned according to the + \a alignment parameter. The second method defaults to \ref ipFree and allows placing elements at + arbitrary position and size, defined by \a rect. + + The alignment or rect can be set via \ref setInsetAlignment or \ref setInsetRect, respectively. + + This is the layout that every QCPAxisRect has as \ref QCPAxisRect::insetLayout. +*/ + +/* start documentation of inline functions */ + +/*! \fn virtual void QCPLayoutInset::simplify() + + The QCPInsetLayout does not need simplification since it can never have empty cells due to its + linear index structure. This method does nothing. +*/ + +/* end documentation of inline functions */ + +/*! + Creates an instance of QCPLayoutInset and sets default values. +*/ +QCPLayoutInset::QCPLayoutInset() +{ +} + +QCPLayoutInset::~QCPLayoutInset() +{ + // clear all child layout elements. This is important because only the specific layouts know how + // to handle removing elements (clear calls virtual removeAt method to do that). + clear(); +} + +/*! + Returns the placement type of the element with the specified \a index. +*/ +QCPLayoutInset::InsetPlacement QCPLayoutInset::insetPlacement(int index) const +{ + if (elementAt(index)) + return mInsetPlacement.at(index); + else + { + qDebug() << Q_FUNC_INFO << "Invalid element index:" << index; + return ipFree; + } +} + +/*! + Returns the alignment of the element with the specified \a index. The alignment only has a + meaning, if the inset placement (\ref setInsetPlacement) is \ref ipBorderAligned. +*/ +Qt::Alignment QCPLayoutInset::insetAlignment(int index) const +{ + if (elementAt(index)) + return mInsetAlignment.at(index); + else + { + qDebug() << Q_FUNC_INFO << "Invalid element index:" << index; + return 0; + } +} + +/*! + Returns the rect of the element with the specified \a index. The rect only has a + meaning, if the inset placement (\ref setInsetPlacement) is \ref ipFree. +*/ +QRectF QCPLayoutInset::insetRect(int index) const +{ + if (elementAt(index)) + return mInsetRect.at(index); + else + { + qDebug() << Q_FUNC_INFO << "Invalid element index:" << index; + return QRectF(); + } +} + +/*! + Sets the inset placement type of the element with the specified \a index to \a placement. + + \see InsetPlacement +*/ +void QCPLayoutInset::setInsetPlacement(int index, QCPLayoutInset::InsetPlacement placement) +{ + if (elementAt(index)) + mInsetPlacement[index] = placement; + else + qDebug() << Q_FUNC_INFO << "Invalid element index:" << index; +} + +/*! + If the inset placement (\ref setInsetPlacement) is \ref ipBorderAligned, this function + is used to set the alignment of the element with the specified \a index to \a alignment. + + \a alignment is an or combination of the following alignment flags: Qt::AlignLeft, + Qt::AlignHCenter, Qt::AlighRight, Qt::AlignTop, Qt::AlignVCenter, Qt::AlignBottom. Any other + alignment flags will be ignored. +*/ +void QCPLayoutInset::setInsetAlignment(int index, Qt::Alignment alignment) +{ + if (elementAt(index)) + mInsetAlignment[index] = alignment; + else + qDebug() << Q_FUNC_INFO << "Invalid element index:" << index; +} + +/*! + If the inset placement (\ref setInsetPlacement) is \ref ipFree, this function is used to set the + position and size of the element with the specified \a index to \a rect. + + \a rect is given in fractions of the whole inset layout rect. So an inset with rect (0, 0, 1, 1) + will span the entire layout. An inset with rect (0.6, 0.1, 0.35, 0.35) will be in the top right + corner of the layout, with 35% width and height of the parent layout. + + Note that the minimum and maximum sizes of the embedded element (\ref + QCPLayoutElement::setMinimumSize, \ref QCPLayoutElement::setMaximumSize) are enforced. +*/ +void QCPLayoutInset::setInsetRect(int index, const QRectF &rect) +{ + if (elementAt(index)) + mInsetRect[index] = rect; + else + qDebug() << Q_FUNC_INFO << "Invalid element index:" << index; +} + +/* inherits documentation from base class */ +void QCPLayoutInset::updateLayout() +{ + for (int i=0; iminimumSizeHint(); + QSize maxSizeHint = mElements.at(i)->maximumSizeHint(); + finalMinSize.setWidth(mElements.at(i)->minimumSize().width() > 0 ? mElements.at(i)->minimumSize().width() : minSizeHint.width()); + finalMinSize.setHeight(mElements.at(i)->minimumSize().height() > 0 ? mElements.at(i)->minimumSize().height() : minSizeHint.height()); + finalMaxSize.setWidth(mElements.at(i)->maximumSize().width() < QWIDGETSIZE_MAX ? mElements.at(i)->maximumSize().width() : maxSizeHint.width()); + finalMaxSize.setHeight(mElements.at(i)->maximumSize().height() < QWIDGETSIZE_MAX ? mElements.at(i)->maximumSize().height() : maxSizeHint.height()); + if (mInsetPlacement.at(i) == ipFree) + { + insetRect = QRect(rect().x()+rect().width()*mInsetRect.at(i).x(), + rect().y()+rect().height()*mInsetRect.at(i).y(), + rect().width()*mInsetRect.at(i).width(), + rect().height()*mInsetRect.at(i).height()); + if (insetRect.size().width() < finalMinSize.width()) + insetRect.setWidth(finalMinSize.width()); + if (insetRect.size().height() < finalMinSize.height()) + insetRect.setHeight(finalMinSize.height()); + if (insetRect.size().width() > finalMaxSize.width()) + insetRect.setWidth(finalMaxSize.width()); + if (insetRect.size().height() > finalMaxSize.height()) + insetRect.setHeight(finalMaxSize.height()); + } else if (mInsetPlacement.at(i) == ipBorderAligned) + { + insetRect.setSize(finalMinSize); + Qt::Alignment al = mInsetAlignment.at(i); + if (al.testFlag(Qt::AlignLeft)) insetRect.moveLeft(rect().x()); + else if (al.testFlag(Qt::AlignRight)) insetRect.moveRight(rect().x()+rect().width()); + else insetRect.moveLeft(rect().x()+rect().width()*0.5-finalMinSize.width()*0.5); // default to Qt::AlignHCenter + if (al.testFlag(Qt::AlignTop)) insetRect.moveTop(rect().y()); + else if (al.testFlag(Qt::AlignBottom)) insetRect.moveBottom(rect().y()+rect().height()); + else insetRect.moveTop(rect().y()+rect().height()*0.5-finalMinSize.height()*0.5); // default to Qt::AlignVCenter + } + mElements.at(i)->setOuterRect(insetRect); + } +} + +/* inherits documentation from base class */ +int QCPLayoutInset::elementCount() const +{ + return mElements.size(); +} + +/* inherits documentation from base class */ +QCPLayoutElement *QCPLayoutInset::elementAt(int index) const +{ + if (index >= 0 && index < mElements.size()) + return mElements.at(index); + else + return 0; +} + +/* inherits documentation from base class */ +QCPLayoutElement *QCPLayoutInset::takeAt(int index) +{ + if (QCPLayoutElement *el = elementAt(index)) + { + releaseElement(el); + mElements.removeAt(index); + mInsetPlacement.removeAt(index); + mInsetAlignment.removeAt(index); + mInsetRect.removeAt(index); + return el; + } else + { + qDebug() << Q_FUNC_INFO << "Attempt to take invalid index:" << index; + return 0; + } +} + +/* inherits documentation from base class */ +bool QCPLayoutInset::take(QCPLayoutElement *element) +{ + if (element) + { + for (int i=0; irealVisibility() && mElements.at(i)->selectTest(pos, onlySelectable) >= 0) + return mParentPlot->selectionTolerance()*0.99; + } + return -1; +} + +/*! + Adds the specified \a element to the layout as an inset aligned at the border (\ref + setInsetAlignment is initialized with \ref ipBorderAligned). The alignment is set to \a + alignment. + + \a alignment is an or combination of the following alignment flags: Qt::AlignLeft, + Qt::AlignHCenter, Qt::AlighRight, Qt::AlignTop, Qt::AlignVCenter, Qt::AlignBottom. Any other + alignment flags will be ignored. + + \see addElement(QCPLayoutElement *element, const QRectF &rect) +*/ +void QCPLayoutInset::addElement(QCPLayoutElement *element, Qt::Alignment alignment) +{ + if (element) + { + if (element->layout()) // remove from old layout first + element->layout()->take(element); + mElements.append(element); + mInsetPlacement.append(ipBorderAligned); + mInsetAlignment.append(alignment); + mInsetRect.append(QRectF(0.6, 0.6, 0.4, 0.4)); + adoptElement(element); + } else + qDebug() << Q_FUNC_INFO << "Can't add null element"; +} + +/*! + Adds the specified \a element to the layout as an inset with free positioning/sizing (\ref + setInsetAlignment is initialized with \ref ipFree). The position and size is set to \a + rect. + + \a rect is given in fractions of the whole inset layout rect. So an inset with rect (0, 0, 1, 1) + will span the entire layout. An inset with rect (0.6, 0.1, 0.35, 0.35) will be in the top right + corner of the layout, with 35% width and height of the parent layout. + + \see addElement(QCPLayoutElement *element, Qt::Alignment alignment) +*/ +void QCPLayoutInset::addElement(QCPLayoutElement *element, const QRectF &rect) +{ + if (element) + { + if (element->layout()) // remove from old layout first + element->layout()->take(element); + mElements.append(element); + mInsetPlacement.append(ipFree); + mInsetAlignment.append(Qt::AlignRight|Qt::AlignTop); + mInsetRect.append(rect); + adoptElement(element); + } else + qDebug() << Q_FUNC_INFO << "Can't add null element"; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPLineEnding +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPLineEnding + \brief Handles the different ending decorations for line-like items + + \image html QCPLineEnding.png "The various ending styles currently supported" + + For every ending a line-like item has, an instance of this class exists. For example, QCPItemLine + has two endings which can be set with QCPItemLine::setHead and QCPItemLine::setTail. + + The styles themselves are defined via the enum QCPLineEnding::EndingStyle. Most decorations can + be modified regarding width and length, see \ref setWidth and \ref setLength. The direction of + the ending decoration (e.g. direction an arrow is pointing) is controlled by the line-like item. + For example, when both endings of a QCPItemLine are set to be arrows, they will point to opposite + directions, e.g. "outward". This can be changed by \ref setInverted, which would make the + respective arrow point inward. + + Note that due to the overloaded QCPLineEnding constructor, you may directly specify a + QCPLineEnding::EndingStyle where actually a QCPLineEnding is expected, e.g. + \snippet documentation/doc-code-snippets/mainwindow.cpp qcplineending-sethead +*/ + +/*! + Creates a QCPLineEnding instance with default values (style \ref esNone). +*/ +QCPLineEnding::QCPLineEnding() : + mStyle(esNone), + mWidth(8), + mLength(10), + mInverted(false) +{ +} + +/*! + Creates a QCPLineEnding instance with the specified values. +*/ +QCPLineEnding::QCPLineEnding(QCPLineEnding::EndingStyle style, double width, double length, bool inverted) : + mStyle(style), + mWidth(width), + mLength(length), + mInverted(inverted) +{ +} + +/*! + Sets the style of the ending decoration. +*/ +void QCPLineEnding::setStyle(QCPLineEnding::EndingStyle style) +{ + mStyle = style; +} + +/*! + Sets the width of the ending decoration, if the style supports it. On arrows, for example, the + width defines the size perpendicular to the arrow's pointing direction. + + \see setLength +*/ +void QCPLineEnding::setWidth(double width) +{ + mWidth = width; +} + +/*! + Sets the length of the ending decoration, if the style supports it. On arrows, for example, the + length defines the size in pointing direction. + + \see setWidth +*/ +void QCPLineEnding::setLength(double length) +{ + mLength = length; +} + +/*! + Sets whether the ending decoration shall be inverted. For example, an arrow decoration will point + inward when \a inverted is set to true. + + Note that also the \a width direction is inverted. For symmetrical ending styles like arrows or + discs, this doesn't make a difference. However, asymmetric styles like \ref esHalfBar are + affected by it, which can be used to control to which side the half bar points to. +*/ +void QCPLineEnding::setInverted(bool inverted) +{ + mInverted = inverted; +} + +/*! \internal + + Returns the maximum pixel radius the ending decoration might cover, starting from the position + the decoration is drawn at (typically a line ending/\ref QCPItemPosition of an item). + + This is relevant for clipping. Only omit painting of the decoration when the position where the + decoration is supposed to be drawn is farther away from the clipping rect than the returned + distance. +*/ +double QCPLineEnding::boundingDistance() const +{ + switch (mStyle) + { + case esNone: + return 0; + + case esFlatArrow: + case esSpikeArrow: + case esLineArrow: + case esSkewedBar: + return qSqrt(mWidth*mWidth+mLength*mLength); // items that have width and length + + case esDisc: + case esSquare: + case esDiamond: + case esBar: + case esHalfBar: + return mWidth*1.42; // items that only have a width -> width*sqrt(2) + + } + return 0; +} + +/*! + Starting from the origin of this line ending (which is style specific), returns the length + covered by the line ending symbol, in backward direction. + + For example, the \ref esSpikeArrow has a shorter real length than a \ref esFlatArrow, even if + both have the same \ref setLength value, because the spike arrow has an inward curved back, which + reduces the length along its center axis (the drawing origin for arrows is at the tip). + + This function is used for precise, style specific placement of line endings, for example in + QCPAxes. +*/ +double QCPLineEnding::realLength() const +{ + switch (mStyle) + { + case esNone: + case esLineArrow: + case esSkewedBar: + case esBar: + case esHalfBar: + return 0; + + case esFlatArrow: + return mLength; + + case esDisc: + case esSquare: + case esDiamond: + return mWidth*0.5; + + case esSpikeArrow: + return mLength*0.8; + } + return 0; +} + +/*! \internal + + Draws the line ending with the specified \a painter at the position \a pos. The direction of the + line ending is controlled with \a dir. +*/ +void QCPLineEnding::draw(QCPPainter *painter, const QVector2D &pos, const QVector2D &dir) const +{ + if (mStyle == esNone) + return; + + QVector2D lengthVec(dir.normalized()); + if (lengthVec.isNull()) + lengthVec = QVector2D(1, 0); + QVector2D widthVec(-lengthVec.y(), lengthVec.x()); + lengthVec *= (float)(mLength*(mInverted ? -1 : 1)); + widthVec *= (float)(mWidth*0.5*(mInverted ? -1 : 1)); + + QPen penBackup = painter->pen(); + QBrush brushBackup = painter->brush(); + QPen miterPen = penBackup; + miterPen.setJoinStyle(Qt::MiterJoin); // to make arrow heads spikey + QBrush brush(painter->pen().color(), Qt::SolidPattern); + switch (mStyle) + { + case esNone: break; + case esFlatArrow: + { + QPointF points[3] = {pos.toPointF(), + (pos-lengthVec+widthVec).toPointF(), + (pos-lengthVec-widthVec).toPointF() + }; + painter->setPen(miterPen); + painter->setBrush(brush); + painter->drawConvexPolygon(points, 3); + painter->setBrush(brushBackup); + painter->setPen(penBackup); + break; + } + case esSpikeArrow: + { + QPointF points[4] = {pos.toPointF(), + (pos-lengthVec+widthVec).toPointF(), + (pos-lengthVec*0.8f).toPointF(), + (pos-lengthVec-widthVec).toPointF() + }; + painter->setPen(miterPen); + painter->setBrush(brush); + painter->drawConvexPolygon(points, 4); + painter->setBrush(brushBackup); + painter->setPen(penBackup); + break; + } + case esLineArrow: + { + QPointF points[3] = {(pos-lengthVec+widthVec).toPointF(), + pos.toPointF(), + (pos-lengthVec-widthVec).toPointF() + }; + painter->setPen(miterPen); + painter->drawPolyline(points, 3); + painter->setPen(penBackup); + break; + } + case esDisc: + { + painter->setBrush(brush); + painter->drawEllipse(pos.toPointF(), mWidth*0.5, mWidth*0.5); + painter->setBrush(brushBackup); + break; + } + case esSquare: + { + QVector2D widthVecPerp(-widthVec.y(), widthVec.x()); + QPointF points[4] = {(pos-widthVecPerp+widthVec).toPointF(), + (pos-widthVecPerp-widthVec).toPointF(), + (pos+widthVecPerp-widthVec).toPointF(), + (pos+widthVecPerp+widthVec).toPointF() + }; + painter->setPen(miterPen); + painter->setBrush(brush); + painter->drawConvexPolygon(points, 4); + painter->setBrush(brushBackup); + painter->setPen(penBackup); + break; + } + case esDiamond: + { + QVector2D widthVecPerp(-widthVec.y(), widthVec.x()); + QPointF points[4] = {(pos-widthVecPerp).toPointF(), + (pos-widthVec).toPointF(), + (pos+widthVecPerp).toPointF(), + (pos+widthVec).toPointF() + }; + painter->setPen(miterPen); + painter->setBrush(brush); + painter->drawConvexPolygon(points, 4); + painter->setBrush(brushBackup); + painter->setPen(penBackup); + break; + } + case esBar: + { + painter->drawLine((pos+widthVec).toPointF(), (pos-widthVec).toPointF()); + break; + } + case esHalfBar: + { + painter->drawLine((pos+widthVec).toPointF(), pos.toPointF()); + break; + } + case esSkewedBar: + { + if (qFuzzyIsNull(painter->pen().widthF()) && !painter->modes().testFlag(QCPPainter::pmNonCosmetic)) + { + // if drawing with cosmetic pen (perfectly thin stroke, happens only in vector exports), draw bar exactly on tip of line + painter->drawLine((pos+widthVec+lengthVec*0.2f*(mInverted?-1:1)).toPointF(), + (pos-widthVec-lengthVec*0.2f*(mInverted?-1:1)).toPointF()); + } else + { + // if drawing with thick (non-cosmetic) pen, shift bar a little in line direction to prevent line from sticking through bar slightly + painter->drawLine((pos+widthVec+lengthVec*0.2f*(mInverted?-1:1)+dir.normalized()*qMax(1.0f, (float)painter->pen().widthF())*0.5f).toPointF(), + (pos-widthVec-lengthVec*0.2f*(mInverted?-1:1)+dir.normalized()*qMax(1.0f, (float)painter->pen().widthF())*0.5f).toPointF()); + } + break; + } + } +} + +/*! \internal + \overload + + Draws the line ending. The direction is controlled with the \a angle parameter in radians. +*/ +void QCPLineEnding::draw(QCPPainter *painter, const QVector2D &pos, double angle) const +{ + draw(painter, pos, QVector2D(qCos(angle), qSin(angle))); +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPGrid +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPGrid + \brief Responsible for drawing the grid of a QCPAxis. + + This class is tightly bound to QCPAxis. Every axis owns a grid instance and uses it to draw the + grid lines, sub grid lines and zero-line. You can interact with the grid of an axis via \ref + QCPAxis::grid. Normally, you don't need to create an instance of QCPGrid yourself. + + The axis and grid drawing was split into two classes to allow them to be placed on different + layers (both QCPAxis and QCPGrid inherit from QCPLayerable). Thus it is possible to have the grid + in the background and the axes in the foreground, and any plottables/items in between. This + described situation is the default setup, see the QCPLayer documentation. +*/ + +/*! + Creates a QCPGrid instance and sets default values. + + You shouldn't instantiate grids on their own, since every QCPAxis brings its own QCPGrid. +*/ +QCPGrid::QCPGrid(QCPAxis *parentAxis) : + QCPLayerable(parentAxis->parentPlot(), QString(), parentAxis), + mParentAxis(parentAxis) +{ + // warning: this is called in QCPAxis constructor, so parentAxis members should not be accessed/called + setParent(parentAxis); + setPen(QPen(QColor(200,200,200), 0, Qt::DotLine)); + setSubGridPen(QPen(QColor(220,220,220), 0, Qt::DotLine)); + setZeroLinePen(QPen(QColor(200,200,200), 0, Qt::SolidLine)); + setSubGridVisible(false); + setAntialiased(false); + setAntialiasedSubGrid(false); + setAntialiasedZeroLine(false); +} + +/*! + Sets whether grid lines at sub tick marks are drawn. + + \see setSubGridPen +*/ +void QCPGrid::setSubGridVisible(bool visible) +{ + mSubGridVisible = visible; +} + +/*! + Sets whether sub grid lines are drawn antialiased. +*/ +void QCPGrid::setAntialiasedSubGrid(bool enabled) +{ + mAntialiasedSubGrid = enabled; +} + +/*! + Sets whether zero lines are drawn antialiased. +*/ +void QCPGrid::setAntialiasedZeroLine(bool enabled) +{ + mAntialiasedZeroLine = enabled; +} + +/*! + Sets the pen with which (major) grid lines are drawn. +*/ +void QCPGrid::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the pen with which sub grid lines are drawn. +*/ +void QCPGrid::setSubGridPen(const QPen &pen) +{ + mSubGridPen = pen; +} + +/*! + Sets the pen with which zero lines are drawn. + + Zero lines are lines at value coordinate 0 which may be drawn with a different pen than other grid + lines. To disable zero lines and just draw normal grid lines at zero, set \a pen to Qt::NoPen. +*/ +void QCPGrid::setZeroLinePen(const QPen &pen) +{ + mZeroLinePen = pen; +} + +/*! \internal + + A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter + before drawing the major grid lines. + + This is the antialiasing state the painter passed to the \ref draw method is in by default. + + This function takes into account the local setting of the antialiasing flag as well as the + overrides set with \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. + + \see setAntialiased +*/ +void QCPGrid::applyDefaultAntialiasingHint(QCPPainter *painter) const +{ + applyAntialiasingHint(painter, mAntialiased, QCP::aeGrid); +} + +/*! \internal + + Draws grid lines and sub grid lines at the positions of (sub) ticks of the parent axis, spanning + over the complete axis rect. Also draws the zero line, if appropriate (\ref setZeroLinePen). +*/ +void QCPGrid::draw(QCPPainter *painter) +{ + if (!mParentAxis) { qDebug() << Q_FUNC_INFO << "invalid parent axis"; return; } + + if (mSubGridVisible) + drawSubGridLines(painter); + drawGridLines(painter); +} + +/*! \internal + + Draws the main grid lines and possibly a zero line with the specified painter. + + This is a helper function called by \ref draw. +*/ +void QCPGrid::drawGridLines(QCPPainter *painter) const +{ + if (!mParentAxis) { qDebug() << Q_FUNC_INFO << "invalid parent axis"; return; } + + int lowTick = mParentAxis->mLowestVisibleTick; + int highTick = mParentAxis->mHighestVisibleTick; + double t; // helper variable, result of coordinate-to-pixel transforms + if (mParentAxis->orientation() == Qt::Horizontal) + { + // draw zeroline: + int zeroLineIndex = -1; + if (mZeroLinePen.style() != Qt::NoPen && mParentAxis->mRange.lower < 0 && mParentAxis->mRange.upper > 0) + { + applyAntialiasingHint(painter, mAntialiasedZeroLine, QCP::aeZeroLine); + painter->setPen(mZeroLinePen); + double epsilon = mParentAxis->range().size()*1E-6; // for comparing double to zero + for (int i=lowTick; i <= highTick; ++i) + { + if (qAbs(mParentAxis->mTickVector.at(i)) < epsilon) + { + zeroLineIndex = i; + t = mParentAxis->coordToPixel(mParentAxis->mTickVector.at(i)); // x + painter->drawLine(QLineF(t, mParentAxis->mAxisRect->bottom(), t, mParentAxis->mAxisRect->top())); + break; + } + } + } + // draw grid lines: + applyDefaultAntialiasingHint(painter); + painter->setPen(mPen); + for (int i=lowTick; i <= highTick; ++i) + { + if (i == zeroLineIndex) continue; // don't draw a gridline on top of the zeroline + t = mParentAxis->coordToPixel(mParentAxis->mTickVector.at(i)); // x + painter->drawLine(QLineF(t, mParentAxis->mAxisRect->bottom(), t, mParentAxis->mAxisRect->top())); + } + } else + { + // draw zeroline: + int zeroLineIndex = -1; + if (mZeroLinePen.style() != Qt::NoPen && mParentAxis->mRange.lower < 0 && mParentAxis->mRange.upper > 0) + { + applyAntialiasingHint(painter, mAntialiasedZeroLine, QCP::aeZeroLine); + painter->setPen(mZeroLinePen); + double epsilon = mParentAxis->mRange.size()*1E-6; // for comparing double to zero + for (int i=lowTick; i <= highTick; ++i) + { + if (qAbs(mParentAxis->mTickVector.at(i)) < epsilon) + { + zeroLineIndex = i; + t = mParentAxis->coordToPixel(mParentAxis->mTickVector.at(i)); // y + painter->drawLine(QLineF(mParentAxis->mAxisRect->left(), t, mParentAxis->mAxisRect->right(), t)); + break; + } + } + } + // draw grid lines: + applyDefaultAntialiasingHint(painter); + painter->setPen(mPen); + for (int i=lowTick; i <= highTick; ++i) + { + if (i == zeroLineIndex) continue; // don't draw a gridline on top of the zeroline + t = mParentAxis->coordToPixel(mParentAxis->mTickVector.at(i)); // y + painter->drawLine(QLineF(mParentAxis->mAxisRect->left(), t, mParentAxis->mAxisRect->right(), t)); + } + } +} + +/*! \internal + + Draws the sub grid lines with the specified painter. + + This is a helper function called by \ref draw. +*/ +void QCPGrid::drawSubGridLines(QCPPainter *painter) const +{ + if (!mParentAxis) { qDebug() << Q_FUNC_INFO << "invalid parent axis"; return; } + + applyAntialiasingHint(painter, mAntialiasedSubGrid, QCP::aeSubGrid); + double t; // helper variable, result of coordinate-to-pixel transforms + painter->setPen(mSubGridPen); + if (mParentAxis->orientation() == Qt::Horizontal) + { + for (int i=0; imSubTickVector.size(); ++i) + { + t = mParentAxis->coordToPixel(mParentAxis->mSubTickVector.at(i)); // x + painter->drawLine(QLineF(t, mParentAxis->mAxisRect->bottom(), t, mParentAxis->mAxisRect->top())); + } + } else + { + for (int i=0; imSubTickVector.size(); ++i) + { + t = mParentAxis->coordToPixel(mParentAxis->mSubTickVector.at(i)); // y + painter->drawLine(QLineF(mParentAxis->mAxisRect->left(), t, mParentAxis->mAxisRect->right(), t)); + } + } +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAxis +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPAxis + \brief Manages a single axis inside a QCustomPlot. + + Usually doesn't need to be instantiated externally. Access %QCustomPlot's default four axes via + QCustomPlot::xAxis (bottom), QCustomPlot::yAxis (left), QCustomPlot::xAxis2 (top) and + QCustomPlot::yAxis2 (right). + + Axes are always part of an axis rect, see QCPAxisRect. + \image html AxisNamesOverview.png +
Naming convention of axis parts
+ \n + + \image html AxisRectSpacingOverview.png +
Overview of the spacings and paddings that define the geometry of an axis. The dashed gray line + on the left represents the QCustomPlot widget border.
+ +*/ + +/* start of documentation of inline functions */ + +/*! \fn Qt::Orientation QCPAxis::orientation() const + + Returns the orientation of this axis. The axis orientation (horizontal or vertical) is deduced + from the axis type (left, top, right or bottom). + + \see orientation(AxisType type) +*/ + +/*! \fn QCPGrid *QCPAxis::grid() const + + Returns the \ref QCPGrid instance belonging to this axis. Access it to set details about the way the + grid is displayed. +*/ + +/*! \fn static Qt::Orientation QCPAxis::orientation(AxisType type) + + Returns the orientation of the specified axis type + + \see orientation() +*/ + +/* end of documentation of inline functions */ +/* start of documentation of signals */ + +/*! \fn void QCPAxis::ticksRequest() + + This signal is emitted when \ref setAutoTicks is false and the axis is about to generate tick + labels for a replot. + + Modifying the tick positions can be done with \ref setTickVector. If you also want to control the + tick labels, set \ref setAutoTickLabels to false and also provide the labels with \ref + setTickVectorLabels. + + If you only want static ticks you probably don't need this signal, since you can just set the + tick vector (and possibly tick label vector) once. However, if you want to provide ticks (and + maybe labels) dynamically, e.g. depending on the current axis range, connect a slot to this + signal and set the vector/vectors there. +*/ + +/*! \fn void QCPAxis::rangeChanged(const QCPRange &newRange) + + This signal is emitted when the range of this axis has changed. You can connect it to the \ref + setRange slot of another axis to communicate the new range to the other axis, in order for it to + be synchronized. + + You may also manipulate/correct the range with \ref setRange in a slot connected to this signal. + This is useful if for example a maximum range span shall not be exceeded, or if the lower/upper + range shouldn't go beyond certain values. For example, the following slot would limit the x axis + to only positive ranges: + \code + if (newRange.lower < 0) + plot->xAxis->setRange(0, newRange.size()); + \endcode +*/ + +/*! \fn void QCPAxis::rangeChanged(const QCPRange &newRange, const QCPRange &oldRange) + \overload + + Additionally to the new range, this signal also provides the previous range held by the axis as + \a oldRange. +*/ + +/*! \fn void QCPAxis::scaleTypeChanged(QCPAxis::ScaleType scaleType); + + This signal is emitted when the scale type changes, by calls to \ref setScaleType +*/ + +/*! \fn void QCPAxis::selectionChanged(QCPAxis::SelectableParts selection) + + This signal is emitted when the selection state of this axis has changed, either by user interaction + or by a direct call to \ref setSelectedParts. +*/ + +/*! \fn void QCPAxis::selectableChanged(const QCPAxis::SelectableParts &parts); + + This signal is emitted when the selectability changes, by calls to \ref setSelectableParts +*/ + +/* end of documentation of signals */ + +/*! + Constructs an Axis instance of Type \a type for the axis rect \a parent. + + Usually it isn't necessary to instantiate axes directly, because you can let QCustomPlot create + them for you with \ref QCPAxisRect::addAxis. If you want to use own QCPAxis-subclasses however, + create them manually and then inject them also via \ref QCPAxisRect::addAxis. +*/ +QCPAxis::QCPAxis(QCPAxisRect *parent, AxisType type) : + QCPLayerable(parent->parentPlot(), QString(), parent), + // axis base: + mAxisType(type), + mAxisRect(parent), + mPadding(5), + mOrientation(orientation(type)), + mSelectableParts(spAxis | spTickLabels | spAxisLabel), + mSelectedParts(spNone), + mBasePen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), + mSelectedBasePen(QPen(Qt::blue, 2)), + // axis label: + mLabel(), + mLabelFont(mParentPlot->font()), + mSelectedLabelFont(QFont(mLabelFont.family(), mLabelFont.pointSize(), QFont::Bold)), + mLabelColor(Qt::black), + mSelectedLabelColor(Qt::blue), + // tick labels: + mTickLabels(true), + mAutoTickLabels(true), + mTickLabelType(ltNumber), + mTickLabelFont(mParentPlot->font()), + mSelectedTickLabelFont(QFont(mTickLabelFont.family(), mTickLabelFont.pointSize(), QFont::Bold)), + mTickLabelColor(Qt::black), + mSelectedTickLabelColor(Qt::blue), + mDateTimeFormat(QLatin1String("hh:mm:ss\ndd.MM.yy")), + mDateTimeSpec(Qt::LocalTime), + mNumberPrecision(6), + mNumberFormatChar('g'), + mNumberBeautifulPowers(true), + // ticks and subticks: + mTicks(true), + mTickStep(1), + mSubTickCount(4), + mAutoTickCount(6), + mAutoTicks(true), + mAutoTickStep(true), + mAutoSubTicks(true), + mTickPen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), + mSelectedTickPen(QPen(Qt::blue, 2)), + mSubTickPen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), + mSelectedSubTickPen(QPen(Qt::blue, 2)), + // scale and range: + mRange(0, 5), + mRangeReversed(false), + mScaleType(stLinear), + mScaleLogBase(10), + mScaleLogBaseLogInv(1.0/qLn(mScaleLogBase)), + // internal members: + mGrid(new QCPGrid(this)), + mAxisPainter(new QCPAxisPainterPrivate(parent->parentPlot())), + mLowestVisibleTick(0), + mHighestVisibleTick(-1), + mCachedMarginValid(false), + mCachedMargin(0) +{ + setParent(parent); + mGrid->setVisible(false); + setAntialiased(false); + setLayer(mParentPlot->currentLayer()); // it's actually on that layer already, but we want it in front of the grid, so we place it on there again + + if (type == atTop) + { + setTickLabelPadding(3); + setLabelPadding(6); + } else if (type == atRight) + { + setTickLabelPadding(7); + setLabelPadding(12); + } else if (type == atBottom) + { + setTickLabelPadding(3); + setLabelPadding(3); + } else if (type == atLeft) + { + setTickLabelPadding(5); + setLabelPadding(10); + } +} + +QCPAxis::~QCPAxis() +{ + delete mAxisPainter; + delete mGrid; // delete grid here instead of via parent ~QObject for better defined deletion order +} + +/* No documentation as it is a property getter */ +int QCPAxis::tickLabelPadding() const +{ + return mAxisPainter->tickLabelPadding; +} + +/* No documentation as it is a property getter */ +double QCPAxis::tickLabelRotation() const +{ + return mAxisPainter->tickLabelRotation; +} + +/* No documentation as it is a property getter */ +QCPAxis::LabelSide QCPAxis::tickLabelSide() const +{ + return mAxisPainter->tickLabelSide; +} + +/* No documentation as it is a property getter */ +QString QCPAxis::numberFormat() const +{ + QString result; + result.append(mNumberFormatChar); + if (mNumberBeautifulPowers) + { + result.append(QLatin1Char('b')); + if (mAxisPainter->numberMultiplyCross) + result.append(QLatin1Char('c')); + } + return result; +} + +/* No documentation as it is a property getter */ +int QCPAxis::tickLengthIn() const +{ + return mAxisPainter->tickLengthIn; +} + +/* No documentation as it is a property getter */ +int QCPAxis::tickLengthOut() const +{ + return mAxisPainter->tickLengthOut; +} + +/* No documentation as it is a property getter */ +int QCPAxis::subTickLengthIn() const +{ + return mAxisPainter->subTickLengthIn; +} + +/* No documentation as it is a property getter */ +int QCPAxis::subTickLengthOut() const +{ + return mAxisPainter->subTickLengthOut; +} + +/* No documentation as it is a property getter */ +int QCPAxis::labelPadding() const +{ + return mAxisPainter->labelPadding; +} + +/* No documentation as it is a property getter */ +int QCPAxis::offset() const +{ + return mAxisPainter->offset; +} + +/* No documentation as it is a property getter */ +QCPLineEnding QCPAxis::lowerEnding() const +{ + return mAxisPainter->lowerEnding; +} + +/* No documentation as it is a property getter */ +QCPLineEnding QCPAxis::upperEnding() const +{ + return mAxisPainter->upperEnding; +} + +/*! + Sets whether the axis uses a linear scale or a logarithmic scale. If \a type is set to \ref + stLogarithmic, the logarithm base can be set with \ref setScaleLogBase. In logarithmic axis + scaling, major tick marks appear at all powers of the logarithm base. Properties like tick step + (\ref setTickStep) don't apply in logarithmic scaling. If you wish a decimal base but less major + ticks, consider choosing a logarithm base of 100, 1000 or even higher. + + If \a type is \ref stLogarithmic and the number format (\ref setNumberFormat) uses the 'b' option + (beautifully typeset decimal powers), the display usually is "1 [multiplication sign] 10 + [superscript] n", which looks unnatural for logarithmic scaling (the "1 [multiplication sign]" + part). To only display the decimal power, set the number precision to zero with + \ref setNumberPrecision. +*/ +void QCPAxis::setScaleType(QCPAxis::ScaleType type) +{ + if (mScaleType != type) + { + mScaleType = type; + if (mScaleType == stLogarithmic) + setRange(mRange.sanitizedForLogScale()); + mCachedMarginValid = false; + emit scaleTypeChanged(mScaleType); + } +} + +/*! + If \ref setScaleType is set to \ref stLogarithmic, \a base will be the logarithm base of the + scaling. In logarithmic axis scaling, major tick marks appear at all powers of \a base. + + Properties like tick step (\ref setTickStep) don't apply in logarithmic scaling. If you wish a decimal base but + less major ticks, consider choosing \a base 100, 1000 or even higher. +*/ +void QCPAxis::setScaleLogBase(double base) +{ + if (base > 1) + { + mScaleLogBase = base; + mScaleLogBaseLogInv = 1.0/qLn(mScaleLogBase); // buffer for faster baseLog() calculation + mCachedMarginValid = false; + } else + qDebug() << Q_FUNC_INFO << "Invalid logarithmic scale base (must be greater 1):" << base; +} + +/*! + Sets the range of the axis. + + This slot may be connected with the \ref rangeChanged signal of another axis so this axis + is always synchronized with the other axis range, when it changes. + + To invert the direction of an axis, use \ref setRangeReversed. +*/ +void QCPAxis::setRange(const QCPRange &range) +{ + if (range.lower == mRange.lower && range.upper == mRange.upper) + return; + + if (!QCPRange::validRange(range)) return; + QCPRange oldRange = mRange; + if (mScaleType == stLogarithmic) + { + mRange = range.sanitizedForLogScale(); + } else + { + mRange = range.sanitizedForLinScale(); + } + mCachedMarginValid = false; + emit rangeChanged(mRange); + emit rangeChanged(mRange, oldRange); +} + +/*! + Sets whether the user can (de-)select the parts in \a selectable by clicking on the QCustomPlot surface. + (When \ref QCustomPlot::setInteractions contains iSelectAxes.) + + However, even when \a selectable is set to a value not allowing the selection of a specific part, + it is still possible to set the selection of this part manually, by calling \ref setSelectedParts + directly. + + \see SelectablePart, setSelectedParts +*/ +void QCPAxis::setSelectableParts(const SelectableParts &selectable) +{ + if (mSelectableParts != selectable) + { + mSelectableParts = selectable; + emit selectableChanged(mSelectableParts); + } +} + +/*! + Sets the selected state of the respective axis parts described by \ref SelectablePart. When a part + is selected, it uses a different pen/font. + + The entire selection mechanism for axes is handled automatically when \ref + QCustomPlot::setInteractions contains iSelectAxes. You only need to call this function when you + wish to change the selection state manually. + + This function can change the selection state of a part, independent of the \ref setSelectableParts setting. + + emits the \ref selectionChanged signal when \a selected is different from the previous selection state. + + \see SelectablePart, setSelectableParts, selectTest, setSelectedBasePen, setSelectedTickPen, setSelectedSubTickPen, + setSelectedTickLabelFont, setSelectedLabelFont, setSelectedTickLabelColor, setSelectedLabelColor +*/ +void QCPAxis::setSelectedParts(const SelectableParts &selected) +{ + if (mSelectedParts != selected) + { + mSelectedParts = selected; + emit selectionChanged(mSelectedParts); + } +} + +/*! + \overload + + Sets the lower and upper bound of the axis range. + + To invert the direction of an axis, use \ref setRangeReversed. + + There is also a slot to set a range, see \ref setRange(const QCPRange &range). +*/ +void QCPAxis::setRange(double lower, double upper) +{ + if (lower == mRange.lower && upper == mRange.upper) + return; + + if (!QCPRange::validRange(lower, upper)) return; + QCPRange oldRange = mRange; + mRange.lower = lower; + mRange.upper = upper; + if (mScaleType == stLogarithmic) + { + mRange = mRange.sanitizedForLogScale(); + } else + { + mRange = mRange.sanitizedForLinScale(); + } + mCachedMarginValid = false; + emit rangeChanged(mRange); + emit rangeChanged(mRange, oldRange); +} + +/*! + \overload + + Sets the range of the axis. + + The \a position coordinate indicates together with the \a alignment parameter, where the new + range will be positioned. \a size defines the size of the new axis range. \a alignment may be + Qt::AlignLeft, Qt::AlignRight or Qt::AlignCenter. This will cause the left border, right border, + or center of the range to be aligned with \a position. Any other values of \a alignment will + default to Qt::AlignCenter. +*/ +void QCPAxis::setRange(double position, double size, Qt::AlignmentFlag alignment) +{ + if (alignment == Qt::AlignLeft) + setRange(position, position+size); + else if (alignment == Qt::AlignRight) + setRange(position-size, position); + else // alignment == Qt::AlignCenter + setRange(position-size/2.0, position+size/2.0); +} + +/*! + Sets the lower bound of the axis range. The upper bound is not changed. + \see setRange +*/ +void QCPAxis::setRangeLower(double lower) +{ + if (mRange.lower == lower) + return; + + QCPRange oldRange = mRange; + mRange.lower = lower; + if (mScaleType == stLogarithmic) + { + mRange = mRange.sanitizedForLogScale(); + } else + { + mRange = mRange.sanitizedForLinScale(); + } + mCachedMarginValid = false; + emit rangeChanged(mRange); + emit rangeChanged(mRange, oldRange); +} + +/*! + Sets the upper bound of the axis range. The lower bound is not changed. + \see setRange +*/ +void QCPAxis::setRangeUpper(double upper) +{ + if (mRange.upper == upper) + return; + + QCPRange oldRange = mRange; + mRange.upper = upper; + if (mScaleType == stLogarithmic) + { + mRange = mRange.sanitizedForLogScale(); + } else + { + mRange = mRange.sanitizedForLinScale(); + } + mCachedMarginValid = false; + emit rangeChanged(mRange); + emit rangeChanged(mRange, oldRange); +} + +/*! + Sets whether the axis range (direction) is displayed reversed. Normally, the values on horizontal + axes increase left to right, on vertical axes bottom to top. When \a reversed is set to true, the + direction of increasing values is inverted. + + Note that the range and data interface stays the same for reversed axes, e.g. the \a lower part + of the \ref setRange interface will still reference the mathematically smaller number than the \a + upper part. +*/ +void QCPAxis::setRangeReversed(bool reversed) +{ + if (mRangeReversed != reversed) + { + mRangeReversed = reversed; + mCachedMarginValid = false; + } +} + +/*! + Sets whether the tick positions should be calculated automatically (either from an automatically + generated tick step or a tick step provided manually via \ref setTickStep, see \ref setAutoTickStep). + + If \a on is set to false, you must provide the tick positions manually via \ref setTickVector. + For these manual ticks you may let QCPAxis generate the appropriate labels automatically by + leaving \ref setAutoTickLabels set to true. If you also wish to control the displayed labels + manually, set \ref setAutoTickLabels to false and provide the label strings with \ref + setTickVectorLabels. + + If you need dynamically calculated tick vectors (and possibly tick label vectors), set the + vectors in a slot connected to the \ref ticksRequest signal. + + \see setAutoTickLabels, setAutoSubTicks, setAutoTickCount, setAutoTickStep +*/ +void QCPAxis::setAutoTicks(bool on) +{ + if (mAutoTicks != on) + { + mAutoTicks = on; + mCachedMarginValid = false; + } +} + +/*! + When \ref setAutoTickStep is true, \a approximateCount determines how many ticks should be + generated in the visible range, approximately. + + It's not guaranteed that this number of ticks is met exactly, but approximately within a + tolerance of about two. + + Only values greater than zero are accepted as \a approximateCount. + + \see setAutoTickStep, setAutoTicks, setAutoSubTicks +*/ +void QCPAxis::setAutoTickCount(int approximateCount) +{ + if (mAutoTickCount != approximateCount) + { + if (approximateCount > 0) + { + mAutoTickCount = approximateCount; + mCachedMarginValid = false; + } else + qDebug() << Q_FUNC_INFO << "approximateCount must be greater than zero:" << approximateCount; + } +} + +/*! + Sets whether the tick labels are generated automatically. Depending on the tick label type (\ref + ltNumber or \ref ltDateTime), the labels will either show the coordinate as floating point + number (\ref setNumberFormat), or a date/time formatted according to \ref setDateTimeFormat. + + If \a on is set to false, you should provide the tick labels via \ref setTickVectorLabels. This + is usually used in a combination with \ref setAutoTicks set to false for complete control over + tick positions and labels, e.g. when the ticks should be at multiples of pi and show "2pi", "3pi" + etc. as tick labels. + + If you need dynamically calculated tick vectors (and possibly tick label vectors), set the + vectors in a slot connected to the \ref ticksRequest signal. + + \see setAutoTicks +*/ +void QCPAxis::setAutoTickLabels(bool on) +{ + if (mAutoTickLabels != on) + { + mAutoTickLabels = on; + mCachedMarginValid = false; + } +} + +/*! + Sets whether the tick step, i.e. the interval between two (major) ticks, is calculated + automatically. If \a on is set to true, the axis finds a tick step that is reasonable for human + readable plots. + + The number of ticks the algorithm aims for within the visible range can be specified with \ref + setAutoTickCount. + + If \a on is set to false, you may set the tick step manually with \ref setTickStep. + + \see setAutoTicks, setAutoSubTicks, setAutoTickCount +*/ +void QCPAxis::setAutoTickStep(bool on) +{ + if (mAutoTickStep != on) + { + mAutoTickStep = on; + mCachedMarginValid = false; + } +} + +/*! + Sets whether the number of sub ticks in one tick interval is determined automatically. This + works, as long as the tick step mantissa is a multiple of 0.5. When \ref setAutoTickStep is + enabled, this is always the case. + + When \a on is set to false, you may set the sub tick count with \ref setSubTickCount manually. + + \see setAutoTickCount, setAutoTicks, setAutoTickStep +*/ +void QCPAxis::setAutoSubTicks(bool on) +{ + if (mAutoSubTicks != on) + { + mAutoSubTicks = on; + mCachedMarginValid = false; + } +} + +/*! + Sets whether tick marks are displayed. + + Note that setting \a show to false does not imply that tick labels are invisible, too. To achieve + that, see \ref setTickLabels. +*/ +void QCPAxis::setTicks(bool show) +{ + if (mTicks != show) + { + mTicks = show; + mCachedMarginValid = false; + } +} + +/*! + Sets whether tick labels are displayed. Tick labels are the numbers drawn next to tick marks. +*/ +void QCPAxis::setTickLabels(bool show) +{ + if (mTickLabels != show) + { + mTickLabels = show; + mCachedMarginValid = false; + } +} + +/*! + Sets the distance between the axis base line (including any outward ticks) and the tick labels. + \see setLabelPadding, setPadding +*/ +void QCPAxis::setTickLabelPadding(int padding) +{ + if (mAxisPainter->tickLabelPadding != padding) + { + mAxisPainter->tickLabelPadding = padding; + mCachedMarginValid = false; + } +} + +/*! + Sets whether the tick labels display numbers or dates/times. + + If \a type is set to \ref ltNumber, the format specifications of \ref setNumberFormat apply. + + If \a type is set to \ref ltDateTime, the format specifications of \ref setDateTimeFormat apply. + + In QCustomPlot, date/time coordinates are double numbers representing the seconds since + 1970-01-01T00:00:00 UTC. This format can be retrieved from QDateTime objects with the + QDateTime::toTime_t() function. Since this only gives a resolution of one second, there is also + the QDateTime::toMSecsSinceEpoch() function which returns the timespan described above in + milliseconds. Divide its return value by 1000.0 to get a value with the format needed for + date/time plotting, with a resolution of one millisecond. + + Using the toMSecsSinceEpoch function allows dates that go back to 2nd January 4713 B.C. + (represented by a negative number), unlike the toTime_t function, which works with unsigned + integers and thus only goes back to 1st January 1970. So both for range and accuracy, use of + toMSecsSinceEpoch()/1000.0 should be preferred as key coordinate for date/time axes. + + \see setTickLabels +*/ +void QCPAxis::setTickLabelType(LabelType type) +{ + if (mTickLabelType != type) + { + mTickLabelType = type; + mCachedMarginValid = false; + } +} + +/*! + Sets the font of the tick labels. + + \see setTickLabels, setTickLabelColor +*/ +void QCPAxis::setTickLabelFont(const QFont &font) +{ + if (font != mTickLabelFont) + { + mTickLabelFont = font; + mCachedMarginValid = false; + } +} + +/*! + Sets the color of the tick labels. + + \see setTickLabels, setTickLabelFont +*/ +void QCPAxis::setTickLabelColor(const QColor &color) +{ + if (color != mTickLabelColor) + { + mTickLabelColor = color; + mCachedMarginValid = false; + } +} + +/*! + Sets the rotation of the tick labels. If \a degrees is zero, the labels are drawn normally. Else, + the tick labels are drawn rotated by \a degrees clockwise. The specified angle is bound to values + from -90 to 90 degrees. + + If \a degrees is exactly -90, 0 or 90, the tick labels are centered on the tick coordinate. For + other angles, the label is drawn with an offset such that it seems to point toward or away from + the tick mark. +*/ +void QCPAxis::setTickLabelRotation(double degrees) +{ + if (!qFuzzyIsNull(degrees-mAxisPainter->tickLabelRotation)) + { + mAxisPainter->tickLabelRotation = qBound(-90.0, degrees, 90.0); + mCachedMarginValid = false; + } +} + +/*! + Sets whether the tick labels (numbers) shall appear inside or outside the axis rect. + + The usual and default setting is \ref lsOutside. Very compact plots sometimes require tick labels + to be inside the axis rect, to save space. If \a side is set to \ref lsInside, the tick labels + appear on the inside are additionally clipped to the axis rect. +*/ +void QCPAxis::setTickLabelSide(LabelSide side) +{ + mAxisPainter->tickLabelSide = side; + mCachedMarginValid = false; +} + +/*! + Sets the format in which dates and times are displayed as tick labels, if \ref setTickLabelType is \ref ltDateTime. + for details about the \a format string, see the documentation of QDateTime::toString(). + + Newlines can be inserted with "\n". + + \see setDateTimeSpec +*/ +void QCPAxis::setDateTimeFormat(const QString &format) +{ + if (mDateTimeFormat != format) + { + mDateTimeFormat = format; + mCachedMarginValid = false; + } +} + +/*! + Sets the time spec that is used for the date time values when \ref setTickLabelType is \ref + ltDateTime. + + The default value of QDateTime objects (and also QCustomPlot) is Qt::LocalTime. However, + if the date time values passed to QCustomPlot are given in the UTC spec, set \a + timeSpec to Qt::UTC to get the correct axis labels. + + \see setDateTimeFormat +*/ +void QCPAxis::setDateTimeSpec(const Qt::TimeSpec &timeSpec) +{ + mDateTimeSpec = timeSpec; +} + +/*! + Sets the number format for the numbers drawn as tick labels (if tick label type is \ref + ltNumber). This \a formatCode is an extended version of the format code used e.g. by + QString::number() and QLocale::toString(). For reference about that, see the "Argument Formats" + section in the detailed description of the QString class. \a formatCode is a string of one, two + or three characters. The first character is identical to the normal format code used by Qt. In + short, this means: 'e'/'E' scientific format, 'f' fixed format, 'g'/'G' scientific or fixed, + whichever is shorter. + + The second and third characters are optional and specific to QCustomPlot:\n + If the first char was 'e' or 'g', numbers are/might be displayed in the scientific format, e.g. + "5.5e9", which is ugly in a plot. So when the second char of \a formatCode is set to 'b' (for + "beautiful"), those exponential numbers are formatted in a more natural way, i.e. "5.5 + [multiplication sign] 10 [superscript] 9". By default, the multiplication sign is a centered dot. + If instead a cross should be shown (as is usual in the USA), the third char of \a formatCode can + be set to 'c'. The inserted multiplication signs are the UTF-8 characters 215 (0xD7) for the + cross and 183 (0xB7) for the dot. + + If the scale type (\ref setScaleType) is \ref stLogarithmic and the \a formatCode uses the 'b' + option (beautifully typeset decimal powers), the display usually is "1 [multiplication sign] 10 + [superscript] n", which looks unnatural for logarithmic scaling (the "1 [multiplication sign]" + part). To only display the decimal power, set the number precision to zero with \ref + setNumberPrecision. + + Examples for \a formatCode: + \li \c g normal format code behaviour. If number is small, fixed format is used, if number is large, + normal scientific format is used + \li \c gb If number is small, fixed format is used, if number is large, scientific format is used with + beautifully typeset decimal powers and a dot as multiplication sign + \li \c ebc All numbers are in scientific format with beautifully typeset decimal power and a cross as + multiplication sign + \li \c fb illegal format code, since fixed format doesn't support (or need) beautifully typeset decimal + powers. Format code will be reduced to 'f'. + \li \c hello illegal format code, since first char is not 'e', 'E', 'f', 'g' or 'G'. Current format + code will not be changed. +*/ +void QCPAxis::setNumberFormat(const QString &formatCode) +{ + if (formatCode.isEmpty()) + { + qDebug() << Q_FUNC_INFO << "Passed formatCode is empty"; + return; + } + mCachedMarginValid = false; + + // interpret first char as number format char: + QString allowedFormatChars(QLatin1String("eEfgG")); + if (allowedFormatChars.contains(formatCode.at(0))) + { + mNumberFormatChar = QLatin1Char(formatCode.at(0).toLatin1()); + } else + { + qDebug() << Q_FUNC_INFO << "Invalid number format code (first char not in 'eEfgG'):" << formatCode; + return; + } + if (formatCode.length() < 2) + { + mNumberBeautifulPowers = false; + mAxisPainter->numberMultiplyCross = false; + return; + } + + // interpret second char as indicator for beautiful decimal powers: + if (formatCode.at(1) == QLatin1Char('b') && (mNumberFormatChar == QLatin1Char('e') || mNumberFormatChar == QLatin1Char('g'))) + { + mNumberBeautifulPowers = true; + } else + { + qDebug() << Q_FUNC_INFO << "Invalid number format code (second char not 'b' or first char neither 'e' nor 'g'):" << formatCode; + return; + } + if (formatCode.length() < 3) + { + mAxisPainter->numberMultiplyCross = false; + return; + } + + // interpret third char as indicator for dot or cross multiplication symbol: + if (formatCode.at(2) == QLatin1Char('c')) + { + mAxisPainter->numberMultiplyCross = true; + } else if (formatCode.at(2) == QLatin1Char('d')) + { + mAxisPainter->numberMultiplyCross = false; + } else + { + qDebug() << Q_FUNC_INFO << "Invalid number format code (third char neither 'c' nor 'd'):" << formatCode; + return; + } +} + +/*! + Sets the precision of the tick label numbers. See QLocale::toString(double i, char f, int prec) + for details. The effect of precisions are most notably for number Formats starting with 'e', see + \ref setNumberFormat + + If the scale type (\ref setScaleType) is \ref stLogarithmic and the number format (\ref + setNumberFormat) uses the 'b' format code (beautifully typeset decimal powers), the display + usually is "1 [multiplication sign] 10 [superscript] n", which looks unnatural for logarithmic + scaling (the redundant "1 [multiplication sign]" part). To only display the decimal power "10 + [superscript] n", set \a precision to zero. +*/ +void QCPAxis::setNumberPrecision(int precision) +{ + if (mNumberPrecision != precision) + { + mNumberPrecision = precision; + mCachedMarginValid = false; + } +} + +/*! + If \ref setAutoTickStep is set to false, use this function to set the tick step manually. + The tick step is the interval between (major) ticks, in plot coordinates. + \see setSubTickCount +*/ +void QCPAxis::setTickStep(double step) +{ + if (mTickStep != step) + { + mTickStep = step; + mCachedMarginValid = false; + } +} + +/*! + If you want full control over what ticks (and possibly labels) the axes show, this function is + used to set the coordinates at which ticks will appear.\ref setAutoTicks must be disabled, else + the provided tick vector will be overwritten with automatically generated tick coordinates upon + replot. The labels of the ticks can be generated automatically when \ref setAutoTickLabels is + left enabled. If it is disabled, you can set the labels manually with \ref setTickVectorLabels. + + \a vec is a vector containing the positions of the ticks, in plot coordinates. + + \warning \a vec must be sorted in ascending order, no additional checks are made to ensure this. + + \see setTickVectorLabels +*/ +void QCPAxis::setTickVector(const QVector &vec) +{ + // don't check whether mTickVector != vec here, because it takes longer than we would save + mTickVector = vec; + mCachedMarginValid = false; +} + +/*! + If you want full control over what ticks and labels the axes show, this function is used to set a + number of QStrings that will be displayed at the tick positions which you need to provide with + \ref setTickVector. These two vectors should have the same size. (Note that you need to disable + \ref setAutoTicks and \ref setAutoTickLabels first.) + + \a vec is a vector containing the labels of the ticks. The entries correspond to the respective + indices in the tick vector, passed via \ref setTickVector. + + \see setTickVector +*/ +void QCPAxis::setTickVectorLabels(const QVector &vec) +{ + // don't check whether mTickVectorLabels != vec here, because it takes longer than we would save + mTickVectorLabels = vec; + mCachedMarginValid = false; +} + +/*! + Sets the length of the ticks in pixels. \a inside is the length the ticks will reach inside the + plot and \a outside is the length they will reach outside the plot. If \a outside is greater than + zero, the tick labels and axis label will increase their distance to the axis accordingly, so + they won't collide with the ticks. + + \see setSubTickLength, setTickLengthIn, setTickLengthOut +*/ +void QCPAxis::setTickLength(int inside, int outside) +{ + setTickLengthIn(inside); + setTickLengthOut(outside); +} + +/*! + Sets the length of the inward ticks in pixels. \a inside is the length the ticks will reach + inside the plot. + + \see setTickLengthOut, setTickLength, setSubTickLength +*/ +void QCPAxis::setTickLengthIn(int inside) +{ + if (mAxisPainter->tickLengthIn != inside) + { + mAxisPainter->tickLengthIn = inside; + } +} + +/*! + Sets the length of the outward ticks in pixels. \a outside is the length the ticks will reach + outside the plot. If \a outside is greater than zero, the tick labels and axis label will + increase their distance to the axis accordingly, so they won't collide with the ticks. + + \see setTickLengthIn, setTickLength, setSubTickLength +*/ +void QCPAxis::setTickLengthOut(int outside) +{ + if (mAxisPainter->tickLengthOut != outside) + { + mAxisPainter->tickLengthOut = outside; + mCachedMarginValid = false; // only outside tick length can change margin + } +} + +/*! + Sets the number of sub ticks in one (major) tick step. A sub tick count of three for example, + divides the tick intervals in four sub intervals. + + By default, the number of sub ticks is chosen automatically in a reasonable manner as long as the + mantissa of the tick step is a multiple of 0.5. When \ref setAutoTickStep is enabled, this is + always the case. + + If you want to disable automatic sub tick count and use this function to set the count manually, + see \ref setAutoSubTicks. +*/ +void QCPAxis::setSubTickCount(int count) +{ + mSubTickCount = count; +} + +/*! + Sets the length of the subticks in pixels. \a inside is the length the subticks will reach inside + the plot and \a outside is the length they will reach outside the plot. If \a outside is greater + than zero, the tick labels and axis label will increase their distance to the axis accordingly, + so they won't collide with the ticks. + + \see setTickLength, setSubTickLengthIn, setSubTickLengthOut +*/ +void QCPAxis::setSubTickLength(int inside, int outside) +{ + setSubTickLengthIn(inside); + setSubTickLengthOut(outside); +} + +/*! + Sets the length of the inward subticks in pixels. \a inside is the length the subticks will reach inside + the plot. + + \see setSubTickLengthOut, setSubTickLength, setTickLength +*/ +void QCPAxis::setSubTickLengthIn(int inside) +{ + if (mAxisPainter->subTickLengthIn != inside) + { + mAxisPainter->subTickLengthIn = inside; + } +} + +/*! + Sets the length of the outward subticks in pixels. \a outside is the length the subticks will reach + outside the plot. If \a outside is greater than zero, the tick labels will increase their + distance to the axis accordingly, so they won't collide with the ticks. + + \see setSubTickLengthIn, setSubTickLength, setTickLength +*/ +void QCPAxis::setSubTickLengthOut(int outside) +{ + if (mAxisPainter->subTickLengthOut != outside) + { + mAxisPainter->subTickLengthOut = outside; + mCachedMarginValid = false; // only outside tick length can change margin + } +} + +/*! + Sets the pen, the axis base line is drawn with. + + \see setTickPen, setSubTickPen +*/ +void QCPAxis::setBasePen(const QPen &pen) +{ + mBasePen = pen; +} + +/*! + Sets the pen, tick marks will be drawn with. + + \see setTickLength, setBasePen +*/ +void QCPAxis::setTickPen(const QPen &pen) +{ + mTickPen = pen; +} + +/*! + Sets the pen, subtick marks will be drawn with. + + \see setSubTickCount, setSubTickLength, setBasePen +*/ +void QCPAxis::setSubTickPen(const QPen &pen) +{ + mSubTickPen = pen; +} + +/*! + Sets the font of the axis label. + + \see setLabelColor +*/ +void QCPAxis::setLabelFont(const QFont &font) +{ + if (mLabelFont != font) + { + mLabelFont = font; + mCachedMarginValid = false; + } +} + +/*! + Sets the color of the axis label. + + \see setLabelFont +*/ +void QCPAxis::setLabelColor(const QColor &color) +{ + mLabelColor = color; +} + +/*! + Sets the text of the axis label that will be shown below/above or next to the axis, depending on + its orientation. To disable axis labels, pass an empty string as \a str. +*/ +void QCPAxis::setLabel(const QString &str) +{ + if (mLabel != str) + { + mLabel = str; + mCachedMarginValid = false; + } +} + +/*! + Sets the distance between the tick labels and the axis label. + + \see setTickLabelPadding, setPadding +*/ +void QCPAxis::setLabelPadding(int padding) +{ + if (mAxisPainter->labelPadding != padding) + { + mAxisPainter->labelPadding = padding; + mCachedMarginValid = false; + } +} + +/*! + Sets the padding of the axis. + + When \ref QCPAxisRect::setAutoMargins is enabled, the padding is the additional outer most space, + that is left blank. + + The axis padding has no meaning if \ref QCPAxisRect::setAutoMargins is disabled. + + \see setLabelPadding, setTickLabelPadding +*/ +void QCPAxis::setPadding(int padding) +{ + if (mPadding != padding) + { + mPadding = padding; + mCachedMarginValid = false; + } +} + +/*! + Sets the offset the axis has to its axis rect side. + + If an axis rect side has multiple axes and automatic margin calculation is enabled for that side, + only the offset of the inner most axis has meaning (even if it is set to be invisible). The + offset of the other, outer axes is controlled automatically, to place them at appropriate + positions. +*/ +void QCPAxis::setOffset(int offset) +{ + mAxisPainter->offset = offset; +} + +/*! + Sets the font that is used for tick labels when they are selected. + + \see setTickLabelFont, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions +*/ +void QCPAxis::setSelectedTickLabelFont(const QFont &font) +{ + if (font != mSelectedTickLabelFont) + { + mSelectedTickLabelFont = font; + // don't set mCachedMarginValid to false here because margin calculation is always done with non-selected fonts + } +} + +/*! + Sets the font that is used for the axis label when it is selected. + + \see setLabelFont, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions +*/ +void QCPAxis::setSelectedLabelFont(const QFont &font) +{ + mSelectedLabelFont = font; + // don't set mCachedMarginValid to false here because margin calculation is always done with non-selected fonts +} + +/*! + Sets the color that is used for tick labels when they are selected. + + \see setTickLabelColor, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions +*/ +void QCPAxis::setSelectedTickLabelColor(const QColor &color) +{ + if (color != mSelectedTickLabelColor) + { + mSelectedTickLabelColor = color; + } +} + +/*! + Sets the color that is used for the axis label when it is selected. + + \see setLabelColor, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions +*/ +void QCPAxis::setSelectedLabelColor(const QColor &color) +{ + mSelectedLabelColor = color; +} + +/*! + Sets the pen that is used to draw the axis base line when selected. + + \see setBasePen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions +*/ +void QCPAxis::setSelectedBasePen(const QPen &pen) +{ + mSelectedBasePen = pen; +} + +/*! + Sets the pen that is used to draw the (major) ticks when selected. + + \see setTickPen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions +*/ +void QCPAxis::setSelectedTickPen(const QPen &pen) +{ + mSelectedTickPen = pen; +} + +/*! + Sets the pen that is used to draw the subticks when selected. + + \see setSubTickPen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions +*/ +void QCPAxis::setSelectedSubTickPen(const QPen &pen) +{ + mSelectedSubTickPen = pen; +} + +/*! + Sets the style for the lower axis ending. See the documentation of QCPLineEnding for available + styles. + + For horizontal axes, this method refers to the left ending, for vertical axes the bottom ending. + Note that this meaning does not change when the axis range is reversed with \ref + setRangeReversed. + + \see setUpperEnding +*/ +void QCPAxis::setLowerEnding(const QCPLineEnding &ending) +{ + mAxisPainter->lowerEnding = ending; +} + +/*! + Sets the style for the upper axis ending. See the documentation of QCPLineEnding for available + styles. + + For horizontal axes, this method refers to the right ending, for vertical axes the top ending. + Note that this meaning does not change when the axis range is reversed with \ref + setRangeReversed. + + \see setLowerEnding +*/ +void QCPAxis::setUpperEnding(const QCPLineEnding &ending) +{ + mAxisPainter->upperEnding = ending; +} + +/*! + If the scale type (\ref setScaleType) is \ref stLinear, \a diff is added to the lower and upper + bounds of the range. The range is simply moved by \a diff. + + If the scale type is \ref stLogarithmic, the range bounds are multiplied by \a diff. This + corresponds to an apparent "linear" move in logarithmic scaling by a distance of log(diff). +*/ +void QCPAxis::moveRange(double diff) +{ + QCPRange oldRange = mRange; + if (mScaleType == stLinear) + { + mRange.lower += diff; + mRange.upper += diff; + } else // mScaleType == stLogarithmic + { + mRange.lower *= diff; + mRange.upper *= diff; + } + mCachedMarginValid = false; + emit rangeChanged(mRange); + emit rangeChanged(mRange, oldRange); +} + +/*! + Scales the range of this axis by \a factor around the coordinate \a center. For example, if \a + factor is 2.0, \a center is 1.0, then the axis range will double its size, and the point at + coordinate 1.0 won't have changed its position in the QCustomPlot widget (i.e. coordinates + around 1.0 will have moved symmetrically closer to 1.0). +*/ +void QCPAxis::scaleRange(double factor, double center) +{ + QCPRange oldRange = mRange; + if (mScaleType == stLinear) + { + QCPRange newRange; + newRange.lower = (mRange.lower-center)*factor + center; + newRange.upper = (mRange.upper-center)*factor + center; + if (QCPRange::validRange(newRange)) + mRange = newRange.sanitizedForLinScale(); + } else // mScaleType == stLogarithmic + { + if ((mRange.upper < 0 && center < 0) || (mRange.upper > 0 && center > 0)) // make sure center has same sign as range + { + QCPRange newRange; + newRange.lower = qPow(mRange.lower/center, factor)*center; + newRange.upper = qPow(mRange.upper/center, factor)*center; + if (QCPRange::validRange(newRange)) + mRange = newRange.sanitizedForLogScale(); + } else + qDebug() << Q_FUNC_INFO << "Center of scaling operation doesn't lie in same logarithmic sign domain as range:" << center; + } + mCachedMarginValid = false; + emit rangeChanged(mRange); + emit rangeChanged(mRange, oldRange); +} + +/*! + Scales the range of this axis to have a certain scale \a ratio to \a otherAxis. The scaling will + be done around the center of the current axis range. + + For example, if \a ratio is 1, this axis is the \a yAxis and \a otherAxis is \a xAxis, graphs + plotted with those axes will appear in a 1:1 aspect ratio, independent of the aspect ratio the + axis rect has. + + This is an operation that changes the range of this axis once, it doesn't fix the scale ratio + indefinitely. Note that calling this function in the constructor of the QCustomPlot's parent + won't have the desired effect, since the widget dimensions aren't defined yet, and a resizeEvent + will follow. +*/ +void QCPAxis::setScaleRatio(const QCPAxis *otherAxis, double ratio) +{ + int otherPixelSize, ownPixelSize; + + if (otherAxis->orientation() == Qt::Horizontal) + otherPixelSize = otherAxis->axisRect()->width(); + else + otherPixelSize = otherAxis->axisRect()->height(); + + if (orientation() == Qt::Horizontal) + ownPixelSize = axisRect()->width(); + else + ownPixelSize = axisRect()->height(); + + double newRangeSize = ratio*otherAxis->range().size()*ownPixelSize/(double)otherPixelSize; + setRange(range().center(), newRangeSize, Qt::AlignCenter); +} + +/*! + Changes the axis range such that all plottables associated with this axis are fully visible in + that dimension. + + \see QCPAbstractPlottable::rescaleAxes, QCustomPlot::rescaleAxes +*/ +void QCPAxis::rescale(bool onlyVisiblePlottables) +{ + QList p = plottables(); + QCPRange newRange; + bool haveRange = false; + for (int i=0; irealVisibility() && onlyVisiblePlottables) + continue; + QCPRange plottableRange; + bool currentFoundRange; + QCPAbstractPlottable::SignDomain signDomain = QCPAbstractPlottable::sdBoth; + if (mScaleType == stLogarithmic) + signDomain = (mRange.upper < 0 ? QCPAbstractPlottable::sdNegative : QCPAbstractPlottable::sdPositive); + if (p.at(i)->keyAxis() == this) + plottableRange = p.at(i)->getKeyRange(currentFoundRange, signDomain); + else + plottableRange = p.at(i)->getValueRange(currentFoundRange, signDomain); + if (currentFoundRange) + { + if (!haveRange) + newRange = plottableRange; + else + newRange.expand(plottableRange); + haveRange = true; + } + } + if (haveRange) + { + if (!QCPRange::validRange(newRange)) // likely due to range being zero (plottable has only constant data in this axis dimension), shift current range to at least center the plottable + { + double center = (newRange.lower+newRange.upper)*0.5; // upper and lower should be equal anyway, but just to make sure, incase validRange returned false for other reason + if (mScaleType == stLinear) + { + newRange.lower = center-mRange.size()/2.0; + newRange.upper = center+mRange.size()/2.0; + } else // mScaleType == stLogarithmic + { + newRange.lower = center/qSqrt(mRange.upper/mRange.lower); + newRange.upper = center*qSqrt(mRange.upper/mRange.lower); + } + } + setRange(newRange); + } +} + +/*! + Transforms \a value, in pixel coordinates of the QCustomPlot widget, to axis coordinates. +*/ +double QCPAxis::pixelToCoord(double value) const +{ + if (orientation() == Qt::Horizontal) + { + if (mScaleType == stLinear) + { + if (!mRangeReversed) + return (value-mAxisRect->left())/(double)mAxisRect->width()*mRange.size()+mRange.lower; + else + return -(value-mAxisRect->left())/(double)mAxisRect->width()*mRange.size()+mRange.upper; + } else // mScaleType == stLogarithmic + { + if (!mRangeReversed) + return qPow(mRange.upper/mRange.lower, (value-mAxisRect->left())/(double)mAxisRect->width())*mRange.lower; + else + return qPow(mRange.upper/mRange.lower, (mAxisRect->left()-value)/(double)mAxisRect->width())*mRange.upper; + } + } else // orientation() == Qt::Vertical + { + if (mScaleType == stLinear) + { + if (!mRangeReversed) + return (mAxisRect->bottom()-value)/(double)mAxisRect->height()*mRange.size()+mRange.lower; + else + return -(mAxisRect->bottom()-value)/(double)mAxisRect->height()*mRange.size()+mRange.upper; + } else // mScaleType == stLogarithmic + { + if (!mRangeReversed) + return qPow(mRange.upper/mRange.lower, (mAxisRect->bottom()-value)/(double)mAxisRect->height())*mRange.lower; + else + return qPow(mRange.upper/mRange.lower, (value-mAxisRect->bottom())/(double)mAxisRect->height())*mRange.upper; + } + } +} + +/*! + Transforms \a value, in coordinates of the axis, to pixel coordinates of the QCustomPlot widget. +*/ +double QCPAxis::coordToPixel(double value) const +{ + if (orientation() == Qt::Horizontal) + { + if (mScaleType == stLinear) + { + if (!mRangeReversed) + return (value-mRange.lower)/mRange.size()*mAxisRect->width()+mAxisRect->left(); + else + return (mRange.upper-value)/mRange.size()*mAxisRect->width()+mAxisRect->left(); + } else // mScaleType == stLogarithmic + { + if (value >= 0 && mRange.upper < 0) // invalid value for logarithmic scale, just draw it outside visible range + return !mRangeReversed ? mAxisRect->right()+200 : mAxisRect->left()-200; + else if (value <= 0 && mRange.upper > 0) // invalid value for logarithmic scale, just draw it outside visible range + return !mRangeReversed ? mAxisRect->left()-200 : mAxisRect->right()+200; + else + { + if (!mRangeReversed) + return baseLog(value/mRange.lower)/baseLog(mRange.upper/mRange.lower)*mAxisRect->width()+mAxisRect->left(); + else + return baseLog(mRange.upper/value)/baseLog(mRange.upper/mRange.lower)*mAxisRect->width()+mAxisRect->left(); + } + } + } else // orientation() == Qt::Vertical + { + if (mScaleType == stLinear) + { + if (!mRangeReversed) + return mAxisRect->bottom()-(value-mRange.lower)/mRange.size()*mAxisRect->height(); + else + return mAxisRect->bottom()-(mRange.upper-value)/mRange.size()*mAxisRect->height(); + } else // mScaleType == stLogarithmic + { + if (value >= 0 && mRange.upper < 0) // invalid value for logarithmic scale, just draw it outside visible range + return !mRangeReversed ? mAxisRect->top()-200 : mAxisRect->bottom()+200; + else if (value <= 0 && mRange.upper > 0) // invalid value for logarithmic scale, just draw it outside visible range + return !mRangeReversed ? mAxisRect->bottom()+200 : mAxisRect->top()-200; + else + { + if (!mRangeReversed) + return mAxisRect->bottom()-baseLog(value/mRange.lower)/baseLog(mRange.upper/mRange.lower)*mAxisRect->height(); + else + return mAxisRect->bottom()-baseLog(mRange.upper/value)/baseLog(mRange.upper/mRange.lower)*mAxisRect->height(); + } + } + } +} + +/*! + Returns the part of the axis that is hit by \a pos (in pixels). The return value of this function + is independent of the user-selectable parts defined with \ref setSelectableParts. Further, this + function does not change the current selection state of the axis. + + If the axis is not visible (\ref setVisible), this function always returns \ref spNone. + + \see setSelectedParts, setSelectableParts, QCustomPlot::setInteractions +*/ +QCPAxis::SelectablePart QCPAxis::getPartAt(const QPointF &pos) const +{ + if (!mVisible) + return spNone; + + if (mAxisPainter->axisSelectionBox().contains(pos.toPoint())) + return spAxis; + else if (mAxisPainter->tickLabelsSelectionBox().contains(pos.toPoint())) + return spTickLabels; + else if (mAxisPainter->labelSelectionBox().contains(pos.toPoint())) + return spAxisLabel; + else + return spNone; +} + +/* inherits documentation from base class */ +double QCPAxis::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + if (!mParentPlot) return -1; + SelectablePart part = getPartAt(pos); + if ((onlySelectable && !mSelectableParts.testFlag(part)) || part == spNone) + return -1; + + if (details) + details->setValue(part); + return mParentPlot->selectionTolerance()*0.99; +} + +/*! + Returns a list of all the plottables that have this axis as key or value axis. + + If you are only interested in plottables of type QCPGraph, see \ref graphs. + + \see graphs, items +*/ +QList QCPAxis::plottables() const +{ + QList result; + if (!mParentPlot) return result; + + for (int i=0; imPlottables.size(); ++i) + { + if (mParentPlot->mPlottables.at(i)->keyAxis() == this ||mParentPlot->mPlottables.at(i)->valueAxis() == this) + result.append(mParentPlot->mPlottables.at(i)); + } + return result; +} + +/*! + Returns a list of all the graphs that have this axis as key or value axis. + + \see plottables, items +*/ +QList QCPAxis::graphs() const +{ + QList result; + if (!mParentPlot) return result; + + for (int i=0; imGraphs.size(); ++i) + { + if (mParentPlot->mGraphs.at(i)->keyAxis() == this || mParentPlot->mGraphs.at(i)->valueAxis() == this) + result.append(mParentPlot->mGraphs.at(i)); + } + return result; +} + +/*! + Returns a list of all the items that are associated with this axis. An item is considered + associated with an axis if at least one of its positions uses the axis as key or value axis. + + \see plottables, graphs +*/ +QList QCPAxis::items() const +{ + QList result; + if (!mParentPlot) return result; + + for (int itemId=0; itemIdmItems.size(); ++itemId) + { + QList positions = mParentPlot->mItems.at(itemId)->positions(); + for (int posId=0; posIdkeyAxis() == this || positions.at(posId)->valueAxis() == this) + { + result.append(mParentPlot->mItems.at(itemId)); + break; + } + } + } + return result; +} + +/*! + Transforms a margin side to the logically corresponding axis type. (QCP::msLeft to + QCPAxis::atLeft, QCP::msRight to QCPAxis::atRight, etc.) +*/ +QCPAxis::AxisType QCPAxis::marginSideToAxisType(QCP::MarginSide side) +{ + switch (side) + { + case QCP::msLeft: return atLeft; + case QCP::msRight: return atRight; + case QCP::msTop: return atTop; + case QCP::msBottom: return atBottom; + default: break; + } + qDebug() << Q_FUNC_INFO << "Invalid margin side passed:" << (int)side; + return atLeft; +} + +/*! + Returns the axis type that describes the opposite axis of an axis with the specified \a type. +*/ +QCPAxis::AxisType QCPAxis::opposite(QCPAxis::AxisType type) +{ + switch (type) + { + case atLeft: return atRight; break; + case atRight: return atLeft; break; + case atBottom: return atTop; break; + case atTop: return atBottom; break; + default: qDebug() << Q_FUNC_INFO << "invalid axis type"; return atLeft; break; + } +} + +/*! \internal + + This function is called to prepare the tick vector, sub tick vector and tick label vector. If + \ref setAutoTicks is set to true, appropriate tick values are determined automatically via \ref + generateAutoTicks. If it's set to false, the signal ticksRequest is emitted, which can be used to + provide external tick positions. Then the sub tick vectors and tick label vectors are created. +*/ +void QCPAxis::setupTickVectors() +{ + if (!mParentPlot) return; + if ((!mTicks && !mTickLabels && !mGrid->visible()) || mRange.size() <= 0) return; + + // fill tick vectors, either by auto generating or by notifying user to fill the vectors himself + if (mAutoTicks) + { + generateAutoTicks(); + } else + { + emit ticksRequest(); + } + + visibleTickBounds(mLowestVisibleTick, mHighestVisibleTick); + if (mTickVector.isEmpty()) + { + mSubTickVector.clear(); + return; + } + + // generate subticks between ticks: + mSubTickVector.resize((mTickVector.size()-1)*mSubTickCount); + if (mSubTickCount > 0) + { + double subTickStep = 0; + double subTickPosition = 0; + int subTickIndex = 0; + bool done = false; + int lowTick = mLowestVisibleTick > 0 ? mLowestVisibleTick-1 : mLowestVisibleTick; + int highTick = mHighestVisibleTick < mTickVector.size()-1 ? mHighestVisibleTick+1 : mHighestVisibleTick; + for (int i=lowTick+1; i<=highTick; ++i) + { + subTickStep = (mTickVector.at(i)-mTickVector.at(i-1))/(double)(mSubTickCount+1); + for (int k=1; k<=mSubTickCount; ++k) + { + subTickPosition = mTickVector.at(i-1) + k*subTickStep; + if (subTickPosition < mRange.lower) + continue; + if (subTickPosition > mRange.upper) + { + done = true; + break; + } + mSubTickVector[subTickIndex] = subTickPosition; + subTickIndex++; + } + if (done) break; + } + mSubTickVector.resize(subTickIndex); + } + + // generate tick labels according to tick positions: + if (mAutoTickLabels) + { + int vecsize = mTickVector.size(); + mTickVectorLabels.resize(vecsize); + if (mTickLabelType == ltNumber) + { + for (int i=mLowestVisibleTick; i<=mHighestVisibleTick; ++i) + mTickVectorLabels[i] = mParentPlot->locale().toString(mTickVector.at(i), mNumberFormatChar.toLatin1(), mNumberPrecision); + } else if (mTickLabelType == ltDateTime) + { + for (int i=mLowestVisibleTick; i<=mHighestVisibleTick; ++i) + { +#if QT_VERSION < QT_VERSION_CHECK(4, 7, 0) // use fromMSecsSinceEpoch function if available, to gain sub-second accuracy on tick labels (e.g. for format "hh:mm:ss:zzz") + mTickVectorLabels[i] = mParentPlot->locale().toString(QDateTime::fromTime_t(mTickVector.at(i)).toTimeSpec(mDateTimeSpec), mDateTimeFormat); +#else + mTickVectorLabels[i] = mParentPlot->locale().toString(QDateTime::fromMSecsSinceEpoch(mTickVector.at(i)*1000).toTimeSpec(mDateTimeSpec), mDateTimeFormat); +#endif + } + } + } else // mAutoTickLabels == false + { + if (mAutoTicks) // ticks generated automatically, but not ticklabels, so emit ticksRequest here for labels + { + emit ticksRequest(); + } + // make sure provided tick label vector has correct (minimal) length: + if (mTickVectorLabels.size() < mTickVector.size()) + mTickVectorLabels.resize(mTickVector.size()); + } +} + +/*! \internal + + If \ref setAutoTicks is set to true, this function is called by \ref setupTickVectors to + generate reasonable tick positions (and subtick count). The algorithm tries to create + approximately mAutoTickCount ticks (set via \ref setAutoTickCount). + + If the scale is logarithmic, \ref setAutoTickCount is ignored, and one tick is generated at every + power of the current logarithm base, set via \ref setScaleLogBase. +*/ +void QCPAxis::generateAutoTicks() +{ + if (mScaleType == stLinear) + { + if (mAutoTickStep) + { + // Generate tick positions according to linear scaling: + mTickStep = mRange.size()/(double)(mAutoTickCount+1e-10); // mAutoTickCount ticks on average, the small addition is to prevent jitter on exact integers + double magnitudeFactor = qPow(10.0, qFloor(qLn(mTickStep)/qLn(10.0))); // get magnitude factor e.g. 0.01, 1, 10, 1000 etc. + double tickStepMantissa = mTickStep/magnitudeFactor; + if (tickStepMantissa < 5) + { + // round digit after decimal point to 0.5 + mTickStep = (int)(tickStepMantissa*2)/2.0*magnitudeFactor; + } else + { + // round to first digit in multiples of 2 + mTickStep = (int)(tickStepMantissa/2.0)*2.0*magnitudeFactor; + } + } + if (mAutoSubTicks) + mSubTickCount = calculateAutoSubTickCount(mTickStep); + // Generate tick positions according to mTickStep: + qint64 firstStep = floor(mRange.lower/mTickStep); // do not use qFloor here, or we'll lose 64 bit precision + qint64 lastStep = ceil(mRange.upper/mTickStep); // do not use qCeil here, or we'll lose 64 bit precision + int tickcount = lastStep-firstStep+1; + if (tickcount < 0) tickcount = 0; + mTickVector.resize(tickcount); + for (int i=0; i 0 && mRange.upper > 0) // positive range + { + double lowerMag = basePow(qFloor(baseLog(mRange.lower))); + double currentMag = lowerMag; + mTickVector.clear(); + mTickVector.append(currentMag); + while (currentMag < mRange.upper && currentMag > 0) // currentMag might be zero for ranges ~1e-300, just cancel in that case + { + currentMag *= mScaleLogBase; + mTickVector.append(currentMag); + } + } else if (mRange.lower < 0 && mRange.upper < 0) // negative range + { + double lowerMag = -basePow(qCeil(baseLog(-mRange.lower))); + double currentMag = lowerMag; + mTickVector.clear(); + mTickVector.append(currentMag); + while (currentMag < mRange.upper && currentMag < 0) // currentMag might be zero for ranges ~1e-300, just cancel in that case + { + currentMag /= mScaleLogBase; + mTickVector.append(currentMag); + } + } else // invalid range for logarithmic scale, because lower and upper have different sign + { + mTickVector.clear(); + qDebug() << Q_FUNC_INFO << "Invalid range for logarithmic plot: " << mRange.lower << "-" << mRange.upper; + } + } +} + +/*! \internal + + Called by generateAutoTicks when \ref setAutoSubTicks is set to true. Depending on the \a + tickStep between two major ticks on the axis, a different number of sub ticks is appropriate. For + Example taking 4 sub ticks for a \a tickStep of 1 makes more sense than taking 5 sub ticks, + because this corresponds to a sub tick step of 0.2, instead of the less intuitive 0.16667. Note + that a subtick count of 4 means dividing the major tick step into 5 sections. + + This is implemented by a hand made lookup for integer tick steps as well as fractional tick steps + with a fractional part of (approximately) 0.5. If a tick step is different (i.e. has no + fractional part close to 0.5), the currently set sub tick count (\ref setSubTickCount) is + returned. +*/ +int QCPAxis::calculateAutoSubTickCount(double tickStep) const +{ + int result = mSubTickCount; // default to current setting, if no proper value can be found + + // get mantissa of tickstep: + double magnitudeFactor = qPow(10.0, qFloor(qLn(tickStep)/qLn(10.0))); // get magnitude factor e.g. 0.01, 1, 10, 1000 etc. + double tickStepMantissa = tickStep/magnitudeFactor; + + // separate integer and fractional part of mantissa: + double epsilon = 0.01; + double intPartf; + int intPart; + double fracPart = modf(tickStepMantissa, &intPartf); + intPart = intPartf; + + // handle cases with (almost) integer mantissa: + if (fracPart < epsilon || 1.0-fracPart < epsilon) + { + if (1.0-fracPart < epsilon) + ++intPart; + switch (intPart) + { + case 1: result = 4; break; // 1.0 -> 0.2 substep + case 2: result = 3; break; // 2.0 -> 0.5 substep + case 3: result = 2; break; // 3.0 -> 1.0 substep + case 4: result = 3; break; // 4.0 -> 1.0 substep + case 5: result = 4; break; // 5.0 -> 1.0 substep + case 6: result = 2; break; // 6.0 -> 2.0 substep + case 7: result = 6; break; // 7.0 -> 1.0 substep + case 8: result = 3; break; // 8.0 -> 2.0 substep + case 9: result = 2; break; // 9.0 -> 3.0 substep + } + } else + { + // handle cases with significantly fractional mantissa: + if (qAbs(fracPart-0.5) < epsilon) // *.5 mantissa + { + switch (intPart) + { + case 1: result = 2; break; // 1.5 -> 0.5 substep + case 2: result = 4; break; // 2.5 -> 0.5 substep + case 3: result = 4; break; // 3.5 -> 0.7 substep + case 4: result = 2; break; // 4.5 -> 1.5 substep + case 5: result = 4; break; // 5.5 -> 1.1 substep (won't occur with autoTickStep from here on) + case 6: result = 4; break; // 6.5 -> 1.3 substep + case 7: result = 2; break; // 7.5 -> 2.5 substep + case 8: result = 4; break; // 8.5 -> 1.7 substep + case 9: result = 4; break; // 9.5 -> 1.9 substep + } + } + // if mantissa fraction isnt 0.0 or 0.5, don't bother finding good sub tick marks, leave default + } + + return result; +} + +/* inherits documentation from base class */ +void QCPAxis::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) +{ + Q_UNUSED(event) + SelectablePart part = details.value(); + if (mSelectableParts.testFlag(part)) + { + SelectableParts selBefore = mSelectedParts; + setSelectedParts(additive ? mSelectedParts^part : part); + if (selectionStateChanged) + *selectionStateChanged = mSelectedParts != selBefore; + } +} + +/* inherits documentation from base class */ +void QCPAxis::deselectEvent(bool *selectionStateChanged) +{ + SelectableParts selBefore = mSelectedParts; + setSelectedParts(mSelectedParts & ~mSelectableParts); + if (selectionStateChanged) + *selectionStateChanged = mSelectedParts != selBefore; +} + +/*! \internal + + A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter + before drawing axis lines. + + This is the antialiasing state the painter passed to the \ref draw method is in by default. + + This function takes into account the local setting of the antialiasing flag as well as the + overrides set with \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. + + \see setAntialiased +*/ +void QCPAxis::applyDefaultAntialiasingHint(QCPPainter *painter) const +{ + applyAntialiasingHint(painter, mAntialiased, QCP::aeAxes); +} + +/*! \internal + + Draws the axis with the specified \a painter, using the internal QCPAxisPainterPrivate instance. + +*/ +void QCPAxis::draw(QCPPainter *painter) +{ + const int lowTick = mLowestVisibleTick; + const int highTick = mHighestVisibleTick; + QVector subTickPositions; // the final coordToPixel transformed vector passed to QCPAxisPainter + QVector tickPositions; // the final coordToPixel transformed vector passed to QCPAxisPainter + QVector tickLabels; // the final vector passed to QCPAxisPainter + tickPositions.reserve(highTick-lowTick+1); + tickLabels.reserve(highTick-lowTick+1); + subTickPositions.reserve(mSubTickVector.size()); + + if (mTicks) + { + for (int i=lowTick; i<=highTick; ++i) + { + tickPositions.append(coordToPixel(mTickVector.at(i))); + if (mTickLabels) + tickLabels.append(mTickVectorLabels.at(i)); + } + + if (mSubTickCount > 0) + { + const int subTickCount = mSubTickVector.size(); + for (int i=0; itype = mAxisType; + mAxisPainter->basePen = getBasePen(); + mAxisPainter->labelFont = getLabelFont(); + mAxisPainter->labelColor = getLabelColor(); + mAxisPainter->label = mLabel; + mAxisPainter->substituteExponent = mAutoTickLabels && mNumberBeautifulPowers && mTickLabelType == ltNumber; + mAxisPainter->tickPen = getTickPen(); + mAxisPainter->subTickPen = getSubTickPen(); + mAxisPainter->tickLabelFont = getTickLabelFont(); + mAxisPainter->tickLabelColor = getTickLabelColor(); + mAxisPainter->axisRect = mAxisRect->rect(); + mAxisPainter->viewportRect = mParentPlot->viewport(); + mAxisPainter->abbreviateDecimalPowers = mScaleType == stLogarithmic; + mAxisPainter->reversedEndings = mRangeReversed; + mAxisPainter->tickPositions = tickPositions; + mAxisPainter->tickLabels = tickLabels; + mAxisPainter->subTickPositions = subTickPositions; + mAxisPainter->draw(painter); +} + +/*! \internal + + Returns via \a lowIndex and \a highIndex, which ticks in the current tick vector are visible in + the current range. The return values are indices of the tick vector, not the positions of the + ticks themselves. + + The actual use of this function is when an external tick vector is provided, since it might + exceed far beyond the currently displayed range, and would cause unnecessary calculations e.g. of + subticks. + + If all ticks are outside the axis range, an inverted range is returned, i.e. highIndex will be + smaller than lowIndex. There is one case, where this function returns indices that are not really + visible in the current axis range: When the tick spacing is larger than the axis range size and + one tick is below the axis range and the next tick is already above the axis range. Because in + such cases it is usually desirable to know the tick pair, to draw proper subticks. +*/ +void QCPAxis::visibleTickBounds(int &lowIndex, int &highIndex) const +{ + bool lowFound = false; + bool highFound = false; + lowIndex = 0; + highIndex = -1; + + for (int i=0; i < mTickVector.size(); ++i) + { + if (mTickVector.at(i) >= mRange.lower) + { + lowFound = true; + lowIndex = i; + break; + } + } + for (int i=mTickVector.size()-1; i >= 0; --i) + { + if (mTickVector.at(i) <= mRange.upper) + { + highFound = true; + highIndex = i; + break; + } + } + + if (!lowFound && highFound) + lowIndex = highIndex+1; + else if (lowFound && !highFound) + highIndex = lowIndex-1; +} + +/*! \internal + + A log function with the base mScaleLogBase, used mostly for coordinate transforms in logarithmic + scales with arbitrary log base. Uses the buffered mScaleLogBaseLogInv for faster calculation. + This is set to 1.0/qLn(mScaleLogBase) in \ref setScaleLogBase. + + \see basePow, setScaleLogBase, setScaleType +*/ +double QCPAxis::baseLog(double value) const +{ + return qLn(value)*mScaleLogBaseLogInv; +} + +/*! \internal + + A power function with the base mScaleLogBase, used mostly for coordinate transforms in + logarithmic scales with arbitrary log base. + + \see baseLog, setScaleLogBase, setScaleType +*/ +double QCPAxis::basePow(double value) const +{ + return qPow(mScaleLogBase, value); +} + +/*! \internal + + Returns the pen that is used to draw the axis base line. Depending on the selection state, this + is either mSelectedBasePen or mBasePen. +*/ +QPen QCPAxis::getBasePen() const +{ + return mSelectedParts.testFlag(spAxis) ? mSelectedBasePen : mBasePen; +} + +/*! \internal + + Returns the pen that is used to draw the (major) ticks. Depending on the selection state, this + is either mSelectedTickPen or mTickPen. +*/ +QPen QCPAxis::getTickPen() const +{ + return mSelectedParts.testFlag(spAxis) ? mSelectedTickPen : mTickPen; +} + +/*! \internal + + Returns the pen that is used to draw the subticks. Depending on the selection state, this + is either mSelectedSubTickPen or mSubTickPen. +*/ +QPen QCPAxis::getSubTickPen() const +{ + return mSelectedParts.testFlag(spAxis) ? mSelectedSubTickPen : mSubTickPen; +} + +/*! \internal + + Returns the font that is used to draw the tick labels. Depending on the selection state, this + is either mSelectedTickLabelFont or mTickLabelFont. +*/ +QFont QCPAxis::getTickLabelFont() const +{ + return mSelectedParts.testFlag(spTickLabels) ? mSelectedTickLabelFont : mTickLabelFont; +} + +/*! \internal + + Returns the font that is used to draw the axis label. Depending on the selection state, this + is either mSelectedLabelFont or mLabelFont. +*/ +QFont QCPAxis::getLabelFont() const +{ + return mSelectedParts.testFlag(spAxisLabel) ? mSelectedLabelFont : mLabelFont; +} + +/*! \internal + + Returns the color that is used to draw the tick labels. Depending on the selection state, this + is either mSelectedTickLabelColor or mTickLabelColor. +*/ +QColor QCPAxis::getTickLabelColor() const +{ + return mSelectedParts.testFlag(spTickLabels) ? mSelectedTickLabelColor : mTickLabelColor; +} + +/*! \internal + + Returns the color that is used to draw the axis label. Depending on the selection state, this + is either mSelectedLabelColor or mLabelColor. +*/ +QColor QCPAxis::getLabelColor() const +{ + return mSelectedParts.testFlag(spAxisLabel) ? mSelectedLabelColor : mLabelColor; +} + +/*! \internal + + Returns the appropriate outward margin for this axis. It is needed if \ref + QCPAxisRect::setAutoMargins is set to true on the parent axis rect. An axis with axis type \ref + atLeft will return an appropriate left margin, \ref atBottom will return an appropriate bottom + margin and so forth. For the calculation, this function goes through similar steps as \ref draw, + so changing one function likely requires the modification of the other one as well. + + The margin consists of the outward tick length, tick label padding, tick label size, label + padding, label size, and padding. + + The margin is cached internally, so repeated calls while leaving the axis range, fonts, etc. + unchanged are very fast. +*/ +int QCPAxis::calculateMargin() +{ + if (!mVisible) // if not visible, directly return 0, don't cache 0 because we can't react to setVisible in QCPAxis + return 0; + + if (mCachedMarginValid) + return mCachedMargin; + + // run through similar steps as QCPAxis::draw, and caluclate margin needed to fit axis and its labels + int margin = 0; + + int lowTick, highTick; + visibleTickBounds(lowTick, highTick); + QVector tickPositions; // the final coordToPixel transformed vector passed to QCPAxisPainter + QVector tickLabels; // the final vector passed to QCPAxisPainter + tickPositions.reserve(highTick-lowTick+1); + tickLabels.reserve(highTick-lowTick+1); + if (mTicks) + { + for (int i=lowTick; i<=highTick; ++i) + { + tickPositions.append(coordToPixel(mTickVector.at(i))); + if (mTickLabels) + tickLabels.append(mTickVectorLabels.at(i)); + } + } + // transfer all properties of this axis to QCPAxisPainterPrivate which it needs to calculate the size. + // Note that some axis painter properties are already set by direct feed-through with QCPAxis setters + mAxisPainter->type = mAxisType; + mAxisPainter->labelFont = getLabelFont(); + mAxisPainter->label = mLabel; + mAxisPainter->tickLabelFont = mTickLabelFont; + mAxisPainter->axisRect = mAxisRect->rect(); + mAxisPainter->viewportRect = mParentPlot->viewport(); + mAxisPainter->tickPositions = tickPositions; + mAxisPainter->tickLabels = tickLabels; + margin += mAxisPainter->size(); + margin += mPadding; + + mCachedMargin = margin; + mCachedMarginValid = true; + return margin; +} + +/* inherits documentation from base class */ +QCP::Interaction QCPAxis::selectionCategory() const +{ + return QCP::iSelectAxes; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAxisPainterPrivate +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPAxisPainterPrivate + + \internal + \brief (Private) + + This is a private class and not part of the public QCustomPlot interface. + + It is used by QCPAxis to do the low-level drawing of axis backbone, tick marks, tick labels and + axis label. It also buffers the labels to reduce replot times. The parameters are configured by + directly accessing the public member variables. +*/ + +/*! + Constructs a QCPAxisPainterPrivate instance. Make sure to not create a new instance on every + redraw, to utilize the caching mechanisms. +*/ +QCPAxisPainterPrivate::QCPAxisPainterPrivate(QCustomPlot *parentPlot) : + type(QCPAxis::atLeft), + basePen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), + lowerEnding(QCPLineEnding::esNone), + upperEnding(QCPLineEnding::esNone), + labelPadding(0), + tickLabelPadding(0), + tickLabelRotation(0), + tickLabelSide(QCPAxis::lsOutside), + substituteExponent(true), + numberMultiplyCross(false), + tickLengthIn(5), + tickLengthOut(0), + subTickLengthIn(2), + subTickLengthOut(0), + tickPen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), + subTickPen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), + offset(0), + abbreviateDecimalPowers(false), + reversedEndings(false), + mParentPlot(parentPlot), + mLabelCache(16) // cache at most 16 (tick) labels +{ +} + +QCPAxisPainterPrivate::~QCPAxisPainterPrivate() +{ +} + +/*! \internal + + Draws the axis with the specified \a painter. + + The selection boxes (mAxisSelectionBox, mTickLabelsSelectionBox, mLabelSelectionBox) are set + here, too. +*/ +void QCPAxisPainterPrivate::draw(QCPPainter *painter) +{ + QByteArray newHash = generateLabelParameterHash(); + if (newHash != mLabelParameterHash) + { + mLabelCache.clear(); + mLabelParameterHash = newHash; + } + + QPoint origin; + switch (type) + { + case QCPAxis::atLeft: origin = axisRect.bottomLeft() +QPoint(-offset, 0); break; + case QCPAxis::atRight: origin = axisRect.bottomRight()+QPoint(+offset, 0); break; + case QCPAxis::atTop: origin = axisRect.topLeft() +QPoint(0, -offset); break; + case QCPAxis::atBottom: origin = axisRect.bottomLeft() +QPoint(0, +offset); break; + } + + double xCor = 0, yCor = 0; // paint system correction, for pixel exact matches (affects baselines and ticks of top/right axes) + switch (type) + { + case QCPAxis::atTop: yCor = -1; break; + case QCPAxis::atRight: xCor = 1; break; + default: break; + } + int margin = 0; + // draw baseline: + QLineF baseLine; + painter->setPen(basePen); + if (QCPAxis::orientation(type) == Qt::Horizontal) + baseLine.setPoints(origin+QPointF(xCor, yCor), origin+QPointF(axisRect.width()+xCor, yCor)); + else + baseLine.setPoints(origin+QPointF(xCor, yCor), origin+QPointF(xCor, -axisRect.height()+yCor)); + if (reversedEndings) + baseLine = QLineF(baseLine.p2(), baseLine.p1()); // won't make a difference for line itself, but for line endings later + painter->drawLine(baseLine); + + // draw ticks: + if (!tickPositions.isEmpty()) + { + painter->setPen(tickPen); + int tickDir = (type == QCPAxis::atBottom || type == QCPAxis::atRight) ? -1 : 1; // direction of ticks ("inward" is right for left axis and left for right axis) + if (QCPAxis::orientation(type) == Qt::Horizontal) + { + for (int i=0; idrawLine(QLineF(tickPositions.at(i)+xCor, origin.y()-tickLengthOut*tickDir+yCor, tickPositions.at(i)+xCor, origin.y()+tickLengthIn*tickDir+yCor)); + } else + { + for (int i=0; idrawLine(QLineF(origin.x()-tickLengthOut*tickDir+xCor, tickPositions.at(i)+yCor, origin.x()+tickLengthIn*tickDir+xCor, tickPositions.at(i)+yCor)); + } + } + + // draw subticks: + if (!subTickPositions.isEmpty()) + { + painter->setPen(subTickPen); + // direction of ticks ("inward" is right for left axis and left for right axis) + int tickDir = (type == QCPAxis::atBottom || type == QCPAxis::atRight) ? -1 : 1; + if (QCPAxis::orientation(type) == Qt::Horizontal) + { + for (int i=0; idrawLine(QLineF(subTickPositions.at(i)+xCor, origin.y()-subTickLengthOut*tickDir+yCor, subTickPositions.at(i)+xCor, origin.y()+subTickLengthIn*tickDir+yCor)); + } else + { + for (int i=0; idrawLine(QLineF(origin.x()-subTickLengthOut*tickDir+xCor, subTickPositions.at(i)+yCor, origin.x()+subTickLengthIn*tickDir+xCor, subTickPositions.at(i)+yCor)); + } + } + margin += qMax(0, qMax(tickLengthOut, subTickLengthOut)); + + // draw axis base endings: + bool antialiasingBackup = painter->antialiasing(); + painter->setAntialiasing(true); // always want endings to be antialiased, even if base and ticks themselves aren't + painter->setBrush(QBrush(basePen.color())); + QVector2D baseLineVector(baseLine.dx(), baseLine.dy()); + if (lowerEnding.style() != QCPLineEnding::esNone) + lowerEnding.draw(painter, QVector2D(baseLine.p1())-baseLineVector.normalized()*lowerEnding.realLength()*(lowerEnding.inverted()?-1:1), -baseLineVector); + if (upperEnding.style() != QCPLineEnding::esNone) + upperEnding.draw(painter, QVector2D(baseLine.p2())+baseLineVector.normalized()*upperEnding.realLength()*(upperEnding.inverted()?-1:1), baseLineVector); + painter->setAntialiasing(antialiasingBackup); + + // tick labels: + QRect oldClipRect; + if (tickLabelSide == QCPAxis::lsInside) // if using inside labels, clip them to the axis rect + { + oldClipRect = painter->clipRegion().boundingRect(); + painter->setClipRect(axisRect); + } + QSize tickLabelsSize(0, 0); // size of largest tick label, for offset calculation of axis label + if (!tickLabels.isEmpty()) + { + if (tickLabelSide == QCPAxis::lsOutside) + margin += tickLabelPadding; + painter->setFont(tickLabelFont); + painter->setPen(QPen(tickLabelColor)); + const int maxLabelIndex = qMin(tickPositions.size(), tickLabels.size()); + int distanceToAxis = margin; + if (tickLabelSide == QCPAxis::lsInside) + distanceToAxis = -(qMax(tickLengthIn, subTickLengthIn)+tickLabelPadding); + for (int i=0; isetClipRect(oldClipRect); + + // axis label: + QRect labelBounds; + if (!label.isEmpty()) + { + margin += labelPadding; + painter->setFont(labelFont); + painter->setPen(QPen(labelColor)); + labelBounds = painter->fontMetrics().boundingRect(0, 0, 0, 0, Qt::TextDontClip, label); + if (type == QCPAxis::atLeft) + { + QTransform oldTransform = painter->transform(); + painter->translate((origin.x()-margin-labelBounds.height()), origin.y()); + painter->rotate(-90); + painter->drawText(0, 0, axisRect.height(), labelBounds.height(), Qt::TextDontClip | Qt::AlignCenter, label); + painter->setTransform(oldTransform); + } + else if (type == QCPAxis::atRight) + { + QTransform oldTransform = painter->transform(); + painter->translate((origin.x()+margin+labelBounds.height()), origin.y()-axisRect.height()); + painter->rotate(90); + painter->drawText(0, 0, axisRect.height(), labelBounds.height(), Qt::TextDontClip | Qt::AlignCenter, label); + painter->setTransform(oldTransform); + } + else if (type == QCPAxis::atTop) + painter->drawText(origin.x(), origin.y()-margin-labelBounds.height(), axisRect.width(), labelBounds.height(), Qt::TextDontClip | Qt::AlignCenter, label); + else if (type == QCPAxis::atBottom) + painter->drawText(origin.x(), origin.y()+margin, axisRect.width(), labelBounds.height(), Qt::TextDontClip | Qt::AlignCenter, label); + } + + // set selection boxes: + int selectionTolerance = 0; + if (mParentPlot) + selectionTolerance = mParentPlot->selectionTolerance(); + else + qDebug() << Q_FUNC_INFO << "mParentPlot is null"; + int selAxisOutSize = qMax(qMax(tickLengthOut, subTickLengthOut), selectionTolerance); + int selAxisInSize = selectionTolerance; + int selTickLabelSize; + int selTickLabelOffset; + if (tickLabelSide == QCPAxis::lsOutside) + { + selTickLabelSize = (QCPAxis::orientation(type) == Qt::Horizontal ? tickLabelsSize.height() : tickLabelsSize.width()); + selTickLabelOffset = qMax(tickLengthOut, subTickLengthOut)+tickLabelPadding; + } else + { + selTickLabelSize = -(QCPAxis::orientation(type) == Qt::Horizontal ? tickLabelsSize.height() : tickLabelsSize.width()); + selTickLabelOffset = -(qMax(tickLengthIn, subTickLengthIn)+tickLabelPadding); + } + int selLabelSize = labelBounds.height(); + int selLabelOffset = qMax(tickLengthOut, subTickLengthOut)+(!tickLabels.isEmpty() && tickLabelSide == QCPAxis::lsOutside ? tickLabelPadding+selTickLabelSize : 0)+labelPadding; + if (type == QCPAxis::atLeft) + { + mAxisSelectionBox.setCoords(origin.x()-selAxisOutSize, axisRect.top(), origin.x()+selAxisInSize, axisRect.bottom()); + mTickLabelsSelectionBox.setCoords(origin.x()-selTickLabelOffset-selTickLabelSize, axisRect.top(), origin.x()-selTickLabelOffset, axisRect.bottom()); + mLabelSelectionBox.setCoords(origin.x()-selLabelOffset-selLabelSize, axisRect.top(), origin.x()-selLabelOffset, axisRect.bottom()); + } else if (type == QCPAxis::atRight) + { + mAxisSelectionBox.setCoords(origin.x()-selAxisInSize, axisRect.top(), origin.x()+selAxisOutSize, axisRect.bottom()); + mTickLabelsSelectionBox.setCoords(origin.x()+selTickLabelOffset+selTickLabelSize, axisRect.top(), origin.x()+selTickLabelOffset, axisRect.bottom()); + mLabelSelectionBox.setCoords(origin.x()+selLabelOffset+selLabelSize, axisRect.top(), origin.x()+selLabelOffset, axisRect.bottom()); + } else if (type == QCPAxis::atTop) + { + mAxisSelectionBox.setCoords(axisRect.left(), origin.y()-selAxisOutSize, axisRect.right(), origin.y()+selAxisInSize); + mTickLabelsSelectionBox.setCoords(axisRect.left(), origin.y()-selTickLabelOffset-selTickLabelSize, axisRect.right(), origin.y()-selTickLabelOffset); + mLabelSelectionBox.setCoords(axisRect.left(), origin.y()-selLabelOffset-selLabelSize, axisRect.right(), origin.y()-selLabelOffset); + } else if (type == QCPAxis::atBottom) + { + mAxisSelectionBox.setCoords(axisRect.left(), origin.y()-selAxisInSize, axisRect.right(), origin.y()+selAxisOutSize); + mTickLabelsSelectionBox.setCoords(axisRect.left(), origin.y()+selTickLabelOffset+selTickLabelSize, axisRect.right(), origin.y()+selTickLabelOffset); + mLabelSelectionBox.setCoords(axisRect.left(), origin.y()+selLabelOffset+selLabelSize, axisRect.right(), origin.y()+selLabelOffset); + } + mAxisSelectionBox = mAxisSelectionBox.normalized(); + mTickLabelsSelectionBox = mTickLabelsSelectionBox.normalized(); + mLabelSelectionBox = mLabelSelectionBox.normalized(); + // draw hitboxes for debug purposes: + //painter->setBrush(Qt::NoBrush); + //painter->drawRects(QVector() << mAxisSelectionBox << mTickLabelsSelectionBox << mLabelSelectionBox); +} + +/*! \internal + + Returns the size ("margin" in QCPAxisRect context, so measured perpendicular to the axis backbone + direction) needed to fit the axis. +*/ +int QCPAxisPainterPrivate::size() const +{ + int result = 0; + + // get length of tick marks pointing outwards: + if (!tickPositions.isEmpty()) + result += qMax(0, qMax(tickLengthOut, subTickLengthOut)); + + // calculate size of tick labels: + if (tickLabelSide == QCPAxis::lsOutside) + { + QSize tickLabelsSize(0, 0); + if (!tickLabels.isEmpty()) + { + for (int i=0; iplottingHints().testFlag(QCP::phCacheLabels) && !painter->modes().testFlag(QCPPainter::pmNoCaching)) // label caching enabled + { + CachedLabel *cachedLabel = mLabelCache.take(text); // attempt to get label from cache + if (!cachedLabel) // no cached label existed, create it + { + cachedLabel = new CachedLabel; + TickLabelData labelData = getTickLabelData(painter->font(), text); + cachedLabel->offset = getTickLabelDrawOffset(labelData)+labelData.rotatedTotalBounds.topLeft(); + cachedLabel->pixmap = QPixmap(labelData.rotatedTotalBounds.size()); + cachedLabel->pixmap.fill(Qt::transparent); + QCPPainter cachePainter(&cachedLabel->pixmap); + cachePainter.setPen(painter->pen()); + drawTickLabel(&cachePainter, -labelData.rotatedTotalBounds.topLeft().x(), -labelData.rotatedTotalBounds.topLeft().y(), labelData); + } + // if label would be partly clipped by widget border on sides, don't draw it (only for outside tick labels): + bool labelClippedByBorder = false; + if (tickLabelSide == QCPAxis::lsOutside) + { + if (QCPAxis::orientation(type) == Qt::Horizontal) + labelClippedByBorder = labelAnchor.x()+cachedLabel->offset.x()+cachedLabel->pixmap.width() > viewportRect.right() || labelAnchor.x()+cachedLabel->offset.x() < viewportRect.left(); + else + labelClippedByBorder = labelAnchor.y()+cachedLabel->offset.y()+cachedLabel->pixmap.height() > viewportRect.bottom() || labelAnchor.y()+cachedLabel->offset.y() < viewportRect.top(); + } + if (!labelClippedByBorder) + { + painter->drawPixmap(labelAnchor+cachedLabel->offset, cachedLabel->pixmap); + finalSize = cachedLabel->pixmap.size(); + } + mLabelCache.insert(text, cachedLabel); // return label to cache or insert for the first time if newly created + } else // label caching disabled, draw text directly on surface: + { + TickLabelData labelData = getTickLabelData(painter->font(), text); + QPointF finalPosition = labelAnchor + getTickLabelDrawOffset(labelData); + // if label would be partly clipped by widget border on sides, don't draw it (only for outside tick labels): + bool labelClippedByBorder = false; + if (tickLabelSide == QCPAxis::lsOutside) + { + if (QCPAxis::orientation(type) == Qt::Horizontal) + labelClippedByBorder = finalPosition.x()+(labelData.rotatedTotalBounds.width()+labelData.rotatedTotalBounds.left()) > viewportRect.right() || finalPosition.x()+labelData.rotatedTotalBounds.left() < viewportRect.left(); + else + labelClippedByBorder = finalPosition.y()+(labelData.rotatedTotalBounds.height()+labelData.rotatedTotalBounds.top()) > viewportRect.bottom() || finalPosition.y()+labelData.rotatedTotalBounds.top() < viewportRect.top(); + } + if (!labelClippedByBorder) + { + drawTickLabel(painter, finalPosition.x(), finalPosition.y(), labelData); + finalSize = labelData.rotatedTotalBounds.size(); + } + } + + // expand passed tickLabelsSize if current tick label is larger: + if (finalSize.width() > tickLabelsSize->width()) + tickLabelsSize->setWidth(finalSize.width()); + if (finalSize.height() > tickLabelsSize->height()) + tickLabelsSize->setHeight(finalSize.height()); +} + +/*! \internal + + This is a \ref placeTickLabel helper function. + + Draws the tick label specified in \a labelData with \a painter at the pixel positions \a x and \a + y. This function is used by \ref placeTickLabel to create new tick labels for the cache, or to + directly draw the labels on the QCustomPlot surface when label caching is disabled, i.e. when + QCP::phCacheLabels plotting hint is not set. +*/ +void QCPAxisPainterPrivate::drawTickLabel(QCPPainter *painter, double x, double y, const TickLabelData &labelData) const +{ + // backup painter settings that we're about to change: + QTransform oldTransform = painter->transform(); + QFont oldFont = painter->font(); + + // transform painter to position/rotation: + painter->translate(x, y); + if (!qFuzzyIsNull(tickLabelRotation)) + painter->rotate(tickLabelRotation); + + // draw text: + if (!labelData.expPart.isEmpty()) // indicator that beautiful powers must be used + { + painter->setFont(labelData.baseFont); + painter->drawText(0, 0, 0, 0, Qt::TextDontClip, labelData.basePart); + painter->setFont(labelData.expFont); + painter->drawText(labelData.baseBounds.width()+1, 0, labelData.expBounds.width(), labelData.expBounds.height(), Qt::TextDontClip, labelData.expPart); + } else + { + painter->setFont(labelData.baseFont); + painter->drawText(0, 0, labelData.totalBounds.width(), labelData.totalBounds.height(), Qt::TextDontClip | Qt::AlignHCenter, labelData.basePart); + } + + // reset painter settings to what it was before: + painter->setTransform(oldTransform); + painter->setFont(oldFont); +} + +/*! \internal + + This is a \ref placeTickLabel helper function. + + Transforms the passed \a text and \a font to a tickLabelData structure that can then be further + processed by \ref getTickLabelDrawOffset and \ref drawTickLabel. It splits the text into base and + exponent if necessary (member substituteExponent) and calculates appropriate bounding boxes. +*/ +QCPAxisPainterPrivate::TickLabelData QCPAxisPainterPrivate::getTickLabelData(const QFont &font, const QString &text) const +{ + TickLabelData result; + + // determine whether beautiful decimal powers should be used + bool useBeautifulPowers = false; + int ePos = -1; // first index of exponent part, text before that will be basePart, text until eLast will be expPart + int eLast = -1; // last index of exponent part, rest of text after this will be suffixPart + if (substituteExponent) + { + ePos = text.indexOf(QLatin1Char('e')); + if (ePos > 0 && text.at(ePos-1).isDigit()) + { + eLast = ePos; + while (eLast+1 < text.size() && (text.at(eLast+1) == QLatin1Char('+') || text.at(eLast+1) == QLatin1Char('-') || text.at(eLast+1).isDigit())) + ++eLast; + if (eLast > ePos) // only if also to right of 'e' is a digit/+/- interpret it as beautifiable power + useBeautifulPowers = true; + } + } + + // calculate text bounding rects and do string preparation for beautiful decimal powers: + result.baseFont = font; + if (result.baseFont.pointSizeF() > 0) // might return -1 if specified with setPixelSize, in that case we can't do correction in next line + result.baseFont.setPointSizeF(result.baseFont.pointSizeF()+0.05); // QFontMetrics.boundingRect has a bug for exact point sizes that make the results oscillate due to internal rounding + if (useBeautifulPowers) + { + // split text into parts of number/symbol that will be drawn normally and part that will be drawn as exponent: + result.basePart = text.left(ePos); + // in log scaling, we want to turn "1*10^n" into "10^n", else add multiplication sign and decimal base: + if (abbreviateDecimalPowers && result.basePart == QLatin1String("1")) + result.basePart = QLatin1String("10"); + else + result.basePart += (numberMultiplyCross ? QString(QChar(215)) : QString(QChar(183))) + QLatin1String("10"); + result.expPart = text.mid(ePos+1); + // clip "+" and leading zeros off expPart: + while (result.expPart.length() > 2 && result.expPart.at(1) == QLatin1Char('0')) // length > 2 so we leave one zero when numberFormatChar is 'e' + result.expPart.remove(1, 1); + if (!result.expPart.isEmpty() && result.expPart.at(0) == QLatin1Char('+')) + result.expPart.remove(0, 1); + // prepare smaller font for exponent: + result.expFont = font; + if (result.expFont.pointSize() > 0) + result.expFont.setPointSize(result.expFont.pointSize()*0.75); + else + result.expFont.setPixelSize(result.expFont.pixelSize()*0.75); + // calculate bounding rects of base part, exponent part and total one: + result.baseBounds = QFontMetrics(result.baseFont).boundingRect(0, 0, 0, 0, Qt::TextDontClip, result.basePart); + result.expBounds = QFontMetrics(result.expFont).boundingRect(0, 0, 0, 0, Qt::TextDontClip, result.expPart); + result.totalBounds = result.baseBounds.adjusted(0, 0, result.expBounds.width()+2, 0); // +2 consists of the 1 pixel spacing between base and exponent (see drawTickLabel) and an extra pixel to include AA + } else // useBeautifulPowers == false + { + result.basePart = text; + result.totalBounds = QFontMetrics(result.baseFont).boundingRect(0, 0, 0, 0, Qt::TextDontClip | Qt::AlignHCenter, result.basePart); + } + result.totalBounds.moveTopLeft(QPoint(0, 0)); // want bounding box aligned top left at origin, independent of how it was created, to make further processing simpler + + // calculate possibly different bounding rect after rotation: + result.rotatedTotalBounds = result.totalBounds; + if (!qFuzzyIsNull(tickLabelRotation)) + { + QTransform transform; + transform.rotate(tickLabelRotation); + result.rotatedTotalBounds = transform.mapRect(result.rotatedTotalBounds); + } + + return result; +} + +/*! \internal + + This is a \ref placeTickLabel helper function. + + Calculates the offset at which the top left corner of the specified tick label shall be drawn. + The offset is relative to a point right next to the tick the label belongs to. + + This function is thus responsible for e.g. centering tick labels under ticks and positioning them + appropriately when they are rotated. +*/ +QPointF QCPAxisPainterPrivate::getTickLabelDrawOffset(const TickLabelData &labelData) const +{ + /* + calculate label offset from base point at tick (non-trivial, for best visual appearance): short + explanation for bottom axis: The anchor, i.e. the point in the label that is placed + horizontally under the corresponding tick is always on the label side that is closer to the + axis (e.g. the left side of the text when we're rotating clockwise). On that side, the height + is halved and the resulting point is defined the anchor. This way, a 90 degree rotated text + will be centered under the tick (i.e. displaced horizontally by half its height). At the same + time, a 45 degree rotated text will "point toward" its tick, as is typical for rotated tick + labels. + */ + bool doRotation = !qFuzzyIsNull(tickLabelRotation); + bool flip = qFuzzyCompare(qAbs(tickLabelRotation), 90.0); // perfect +/-90 degree flip. Indicates vertical label centering on vertical axes. + double radians = tickLabelRotation/180.0*M_PI; + int x=0, y=0; + if ((type == QCPAxis::atLeft && tickLabelSide == QCPAxis::lsOutside) || (type == QCPAxis::atRight && tickLabelSide == QCPAxis::lsInside)) // Anchor at right side of tick label + { + if (doRotation) + { + if (tickLabelRotation > 0) + { + x = -qCos(radians)*labelData.totalBounds.width(); + y = flip ? -labelData.totalBounds.width()/2.0 : -qSin(radians)*labelData.totalBounds.width()-qCos(radians)*labelData.totalBounds.height()/2.0; + } else + { + x = -qCos(-radians)*labelData.totalBounds.width()-qSin(-radians)*labelData.totalBounds.height(); + y = flip ? +labelData.totalBounds.width()/2.0 : +qSin(-radians)*labelData.totalBounds.width()-qCos(-radians)*labelData.totalBounds.height()/2.0; + } + } else + { + x = -labelData.totalBounds.width(); + y = -labelData.totalBounds.height()/2.0; + } + } else if ((type == QCPAxis::atRight && tickLabelSide == QCPAxis::lsOutside) || (type == QCPAxis::atLeft && tickLabelSide == QCPAxis::lsInside)) // Anchor at left side of tick label + { + if (doRotation) + { + if (tickLabelRotation > 0) + { + x = +qSin(radians)*labelData.totalBounds.height(); + y = flip ? -labelData.totalBounds.width()/2.0 : -qCos(radians)*labelData.totalBounds.height()/2.0; + } else + { + x = 0; + y = flip ? +labelData.totalBounds.width()/2.0 : -qCos(-radians)*labelData.totalBounds.height()/2.0; + } + } else + { + x = 0; + y = -labelData.totalBounds.height()/2.0; + } + } else if ((type == QCPAxis::atTop && tickLabelSide == QCPAxis::lsOutside) || (type == QCPAxis::atBottom && tickLabelSide == QCPAxis::lsInside)) // Anchor at bottom side of tick label + { + if (doRotation) + { + if (tickLabelRotation > 0) + { + x = -qCos(radians)*labelData.totalBounds.width()+qSin(radians)*labelData.totalBounds.height()/2.0; + y = -qSin(radians)*labelData.totalBounds.width()-qCos(radians)*labelData.totalBounds.height(); + } else + { + x = -qSin(-radians)*labelData.totalBounds.height()/2.0; + y = -qCos(-radians)*labelData.totalBounds.height(); + } + } else + { + x = -labelData.totalBounds.width()/2.0; + y = -labelData.totalBounds.height(); + } + } else if ((type == QCPAxis::atBottom && tickLabelSide == QCPAxis::lsOutside) || (type == QCPAxis::atTop && tickLabelSide == QCPAxis::lsInside)) // Anchor at top side of tick label + { + if (doRotation) + { + if (tickLabelRotation > 0) + { + x = +qSin(radians)*labelData.totalBounds.height()/2.0; + y = 0; + } else + { + x = -qCos(-radians)*labelData.totalBounds.width()-qSin(-radians)*labelData.totalBounds.height()/2.0; + y = +qSin(-radians)*labelData.totalBounds.width(); + } + } else + { + x = -labelData.totalBounds.width()/2.0; + y = 0; + } + } + + return QPointF(x, y); +} + +/*! \internal + + Simulates the steps done by \ref placeTickLabel by calculating bounding boxes of the text label + to be drawn, depending on number format etc. Since only the largest tick label is wanted for the + margin calculation, the passed \a tickLabelsSize is only expanded, if it's currently set to a + smaller width/height. +*/ +void QCPAxisPainterPrivate::getMaxTickLabelSize(const QFont &font, const QString &text, QSize *tickLabelsSize) const +{ + // note: this function must return the same tick label sizes as the placeTickLabel function. + QSize finalSize; + if (mParentPlot->plottingHints().testFlag(QCP::phCacheLabels) && mLabelCache.contains(text)) // label caching enabled and have cached label + { + const CachedLabel *cachedLabel = mLabelCache.object(text); + finalSize = cachedLabel->pixmap.size(); + } else // label caching disabled or no label with this text cached: + { + TickLabelData labelData = getTickLabelData(font, text); + finalSize = labelData.rotatedTotalBounds.size(); + } + + // expand passed tickLabelsSize if current tick label is larger: + if (finalSize.width() > tickLabelsSize->width()) + tickLabelsSize->setWidth(finalSize.width()); + if (finalSize.height() > tickLabelsSize->height()) + tickLabelsSize->setHeight(finalSize.height()); +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAbstractPlottable +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPAbstractPlottable + \brief The abstract base class for all data representing objects in a plot. + + It defines a very basic interface like name, pen, brush, visibility etc. Since this class is + abstract, it can't be instantiated. Use one of the subclasses or create a subclass yourself to + create new ways of displaying data (see "Creating own plottables" below). + + All further specifics are in the subclasses, for example: + \li A normal graph with possibly a line, scatter points and error bars: \ref QCPGraph + (typically created with \ref QCustomPlot::addGraph) + \li A parametric curve: \ref QCPCurve + \li A bar chart: \ref QCPBars + \li A statistical box plot: \ref QCPStatisticalBox + \li A color encoded two-dimensional map: \ref QCPColorMap + \li An OHLC/Candlestick chart: \ref QCPFinancial + + \section plottables-subclassing Creating own plottables + + To create an own plottable, you implement a subclass of QCPAbstractPlottable. These are the pure + virtual functions, you must implement: + \li \ref clearData + \li \ref selectTest + \li \ref draw + \li \ref drawLegendIcon + \li \ref getKeyRange + \li \ref getValueRange + + See the documentation of those functions for what they need to do. + + For drawing your plot, you can use the \ref coordsToPixels functions to translate a point in plot + coordinates to pixel coordinates. This function is quite convenient, because it takes the + orientation of the key and value axes into account for you (x and y are swapped when the key axis + is vertical and the value axis horizontal). If you are worried about performance (i.e. you need + to translate many points in a loop like QCPGraph), you can directly use \ref + QCPAxis::coordToPixel. However, you must then take care about the orientation of the axis + yourself. + + Here are some important members you inherit from QCPAbstractPlottable: + + + + + + + + + + + + + + + + + + + + + + + + + + +
QCustomPlot *\b mParentPlotA pointer to the parent QCustomPlot instance. The parent plot is inferred from the axes that are passed in the constructor.
QString \b mNameThe name of the plottable.
QPen \b mPenThe generic pen of the plottable. You should use this pen for the most prominent data representing lines in the plottable (e.g QCPGraph uses this pen for its graph lines and scatters)
QPen \b mSelectedPenThe generic pen that should be used when the plottable is selected (hint: \ref mainPen gives you the right pen, depending on selection state).
QBrush \b mBrushThe generic brush of the plottable. You should use this brush for the most prominent fillable structures in the plottable (e.g. QCPGraph uses this brush to control filling under the graph)
QBrush \b mSelectedBrushThe generic brush that should be used when the plottable is selected (hint: \ref mainBrush gives you the right brush, depending on selection state).
QPointer\b mKeyAxis, \b mValueAxisThe key and value axes this plottable is attached to. Call their QCPAxis::coordToPixel functions to translate coordinates to pixels in either the key or value dimension. + Make sure to check whether the pointer is null before using it. If one of the axes is null, don't draw the plottable.
bool \b mSelectedindicates whether the plottable is selected or not.
+*/ + +/* start of documentation of pure virtual functions */ + +/*! \fn void QCPAbstractPlottable::clearData() = 0 + Clears all data in the plottable. +*/ + +/*! \fn void QCPAbstractPlottable::drawLegendIcon(QCPPainter *painter, const QRect &rect) const = 0 + \internal + + called by QCPLegend::draw (via QCPPlottableLegendItem::draw) to create a graphical representation + of this plottable inside \a rect, next to the plottable name. + + The passed \a painter has its cliprect set to \a rect, so painting outside of \a rect won't + appear outside the legend icon border. +*/ + +/*! \fn QCPRange QCPAbstractPlottable::getKeyRange(bool &foundRange, SignDomain inSignDomain) const = 0 + \internal + + called by rescaleAxes functions to get the full data key bounds. For logarithmic plots, one can + set \a inSignDomain to either \ref sdNegative or \ref sdPositive in order to restrict the + returned range to that sign domain. E.g. when only negative range is wanted, set \a inSignDomain + to \ref sdNegative and all positive points will be ignored for range calculation. For no + restriction, just set \a inSignDomain to \ref sdBoth (default). \a foundRange is an output + parameter that indicates whether a range could be found or not. If this is false, you shouldn't + use the returned range (e.g. no points in data). + + Note that \a foundRange is not the same as \ref QCPRange::validRange, since the range returned by + this function may have size zero, which wouldn't count as a valid range. + + \see rescaleAxes, getValueRange +*/ + +/*! \fn QCPRange QCPAbstractPlottable::getValueRange(bool &foundRange, SignDomain inSignDomain) const = 0 + \internal + + called by rescaleAxes functions to get the full data value bounds. For logarithmic plots, one can + set \a inSignDomain to either \ref sdNegative or \ref sdPositive in order to restrict the + returned range to that sign domain. E.g. when only negative range is wanted, set \a inSignDomain + to \ref sdNegative and all positive points will be ignored for range calculation. For no + restriction, just set \a inSignDomain to \ref sdBoth (default). \a foundRange is an output + parameter that indicates whether a range could be found or not. If this is false, you shouldn't + use the returned range (e.g. no points in data). + + Note that \a foundRange is not the same as \ref QCPRange::validRange, since the range returned by + this function may have size zero, which wouldn't count as a valid range. + + \see rescaleAxes, getKeyRange +*/ + +/* end of documentation of pure virtual functions */ +/* start of documentation of signals */ + +/*! \fn void QCPAbstractPlottable::selectionChanged(bool selected) + + This signal is emitted when the selection state of this plottable has changed, either by user + interaction or by a direct call to \ref setSelected. +*/ + +/*! \fn void QCPAbstractPlottable::selectableChanged(bool selectable); + + This signal is emitted when the selectability of this plottable has changed. + + \see setSelectable +*/ + +/* end of documentation of signals */ + +/*! + Constructs an abstract plottable which uses \a keyAxis as its key axis ("x") and \a valueAxis as + its value axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance + and have perpendicular orientations. If either of these restrictions is violated, a corresponding + message is printed to the debug output (qDebug), the construction is not aborted, though. + + Since QCPAbstractPlottable is an abstract class that defines the basic interface to plottables, + it can't be directly instantiated. + + You probably want one of the subclasses like \ref QCPGraph or \ref QCPCurve instead. +*/ +QCPAbstractPlottable::QCPAbstractPlottable(QCPAxis *keyAxis, QCPAxis *valueAxis) : + QCPLayerable(keyAxis->parentPlot(), QString(), keyAxis->axisRect()), + mName(), + mAntialiasedFill(true), + mAntialiasedScatters(true), + mAntialiasedErrorBars(false), + mPen(Qt::black), + mSelectedPen(Qt::black), + mBrush(Qt::NoBrush), + mSelectedBrush(Qt::NoBrush), + mKeyAxis(keyAxis), + mValueAxis(valueAxis), + mSelectable(true), + mSelected(false) +{ + if (keyAxis->parentPlot() != valueAxis->parentPlot()) + qDebug() << Q_FUNC_INFO << "Parent plot of keyAxis is not the same as that of valueAxis."; + if (keyAxis->orientation() == valueAxis->orientation()) + qDebug() << Q_FUNC_INFO << "keyAxis and valueAxis must be orthogonal to each other."; +} + +/*! + The name is the textual representation of this plottable as it is displayed in the legend + (\ref QCPLegend). It may contain any UTF-8 characters, including newlines. +*/ +void QCPAbstractPlottable::setName(const QString &name) +{ + mName = name; +} + +/*! + Sets whether fills of this plottable are drawn antialiased or not. + + Note that this setting may be overridden by \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. +*/ +void QCPAbstractPlottable::setAntialiasedFill(bool enabled) +{ + mAntialiasedFill = enabled; +} + +/*! + Sets whether the scatter symbols of this plottable are drawn antialiased or not. + + Note that this setting may be overridden by \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. +*/ +void QCPAbstractPlottable::setAntialiasedScatters(bool enabled) +{ + mAntialiasedScatters = enabled; +} + +/*! + Sets whether the error bars of this plottable are drawn antialiased or not. + + Note that this setting may be overridden by \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. +*/ +void QCPAbstractPlottable::setAntialiasedErrorBars(bool enabled) +{ + mAntialiasedErrorBars = enabled; +} + + +/*! + The pen is used to draw basic lines that make up the plottable representation in the + plot. + + For example, the \ref QCPGraph subclass draws its graph lines with this pen. + + \see setBrush +*/ +void QCPAbstractPlottable::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + When the plottable is selected, this pen is used to draw basic lines instead of the normal + pen set via \ref setPen. + + \see setSelected, setSelectable, setSelectedBrush, selectTest +*/ +void QCPAbstractPlottable::setSelectedPen(const QPen &pen) +{ + mSelectedPen = pen; +} + +/*! + The brush is used to draw basic fills of the plottable representation in the + plot. The Fill can be a color, gradient or texture, see the usage of QBrush. + + For example, the \ref QCPGraph subclass draws the fill under the graph with this brush, when + it's not set to Qt::NoBrush. + + \see setPen +*/ +void QCPAbstractPlottable::setBrush(const QBrush &brush) +{ + mBrush = brush; +} + +/*! + When the plottable is selected, this brush is used to draw fills instead of the normal + brush set via \ref setBrush. + + \see setSelected, setSelectable, setSelectedPen, selectTest +*/ +void QCPAbstractPlottable::setSelectedBrush(const QBrush &brush) +{ + mSelectedBrush = brush; +} + +/*! + The key axis of a plottable can be set to any axis of a QCustomPlot, as long as it is orthogonal + to the plottable's value axis. This function performs no checks to make sure this is the case. + The typical mathematical choice is to use the x-axis (QCustomPlot::xAxis) as key axis and the + y-axis (QCustomPlot::yAxis) as value axis. + + Normally, the key and value axes are set in the constructor of the plottable (or \ref + QCustomPlot::addGraph when working with QCPGraphs through the dedicated graph interface). + + \see setValueAxis +*/ +void QCPAbstractPlottable::setKeyAxis(QCPAxis *axis) +{ + mKeyAxis = axis; +} + +/*! + The value axis of a plottable can be set to any axis of a QCustomPlot, as long as it is + orthogonal to the plottable's key axis. This function performs no checks to make sure this is the + case. The typical mathematical choice is to use the x-axis (QCustomPlot::xAxis) as key axis and + the y-axis (QCustomPlot::yAxis) as value axis. + + Normally, the key and value axes are set in the constructor of the plottable (or \ref + QCustomPlot::addGraph when working with QCPGraphs through the dedicated graph interface). + + \see setKeyAxis +*/ +void QCPAbstractPlottable::setValueAxis(QCPAxis *axis) +{ + mValueAxis = axis; +} + +/*! + Sets whether the user can (de-)select this plottable by clicking on the QCustomPlot surface. + (When \ref QCustomPlot::setInteractions contains iSelectPlottables.) + + However, even when \a selectable was set to false, it is possible to set the selection manually, + by calling \ref setSelected directly. + + \see setSelected +*/ +void QCPAbstractPlottable::setSelectable(bool selectable) +{ + if (mSelectable != selectable) + { + mSelectable = selectable; + emit selectableChanged(mSelectable); + } +} + +/*! + Sets whether this plottable is selected or not. When selected, it uses a different pen and brush + to draw its lines and fills, see \ref setSelectedPen and \ref setSelectedBrush. + + The entire selection mechanism for plottables is handled automatically when \ref + QCustomPlot::setInteractions contains iSelectPlottables. You only need to call this function when + you wish to change the selection state manually. + + This function can change the selection state even when \ref setSelectable was set to false. + + emits the \ref selectionChanged signal when \a selected is different from the previous selection state. + + \see setSelectable, selectTest +*/ +void QCPAbstractPlottable::setSelected(bool selected) +{ + if (mSelected != selected) + { + mSelected = selected; + emit selectionChanged(mSelected); + } +} + +/*! + Rescales the key and value axes associated with this plottable to contain all displayed data, so + the whole plottable is visible. If the scaling of an axis is logarithmic, rescaleAxes will make + sure not to rescale to an illegal range i.e. a range containing different signs and/or zero. + Instead it will stay in the current sign domain and ignore all parts of the plottable that lie + outside of that domain. + + \a onlyEnlarge makes sure the ranges are only expanded, never reduced. So it's possible to show + multiple plottables in their entirety by multiple calls to rescaleAxes where the first call has + \a onlyEnlarge set to false (the default), and all subsequent set to true. + + \see rescaleKeyAxis, rescaleValueAxis, QCustomPlot::rescaleAxes, QCPAxis::rescale +*/ +void QCPAbstractPlottable::rescaleAxes(bool onlyEnlarge) const +{ + rescaleKeyAxis(onlyEnlarge); + rescaleValueAxis(onlyEnlarge); +} + +/*! + Rescales the key axis of the plottable so the whole plottable is visible. + + See \ref rescaleAxes for detailed behaviour. +*/ +void QCPAbstractPlottable::rescaleKeyAxis(bool onlyEnlarge) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + if (!keyAxis) { qDebug() << Q_FUNC_INFO << "invalid key axis"; return; } + + SignDomain signDomain = sdBoth; + if (keyAxis->scaleType() == QCPAxis::stLogarithmic) + signDomain = (keyAxis->range().upper < 0 ? sdNegative : sdPositive); + + bool foundRange; + QCPRange newRange = getKeyRange(foundRange, signDomain); + if (foundRange) + { + if (onlyEnlarge) + newRange.expand(keyAxis->range()); + if (!QCPRange::validRange(newRange)) // likely due to range being zero (plottable has only constant data in this axis dimension), shift current range to at least center the plottable + { + double center = (newRange.lower+newRange.upper)*0.5; // upper and lower should be equal anyway, but just to make sure, incase validRange returned false for other reason + if (keyAxis->scaleType() == QCPAxis::stLinear) + { + newRange.lower = center-keyAxis->range().size()/2.0; + newRange.upper = center+keyAxis->range().size()/2.0; + } else // scaleType() == stLogarithmic + { + newRange.lower = center/qSqrt(keyAxis->range().upper/keyAxis->range().lower); + newRange.upper = center*qSqrt(keyAxis->range().upper/keyAxis->range().lower); + } + } + keyAxis->setRange(newRange); + } +} + +/*! + Rescales the value axis of the plottable so the whole plottable is visible. + + Returns true if the axis was actually scaled. This might not be the case if this plottable has an + invalid range, e.g. because it has no data points. + + See \ref rescaleAxes for detailed behaviour. +*/ +void QCPAbstractPlottable::rescaleValueAxis(bool onlyEnlarge) const +{ + QCPAxis *valueAxis = mValueAxis.data(); + if (!valueAxis) { qDebug() << Q_FUNC_INFO << "invalid value axis"; return; } + + SignDomain signDomain = sdBoth; + if (valueAxis->scaleType() == QCPAxis::stLogarithmic) + signDomain = (valueAxis->range().upper < 0 ? sdNegative : sdPositive); + + bool foundRange; + QCPRange newRange = getValueRange(foundRange, signDomain); + if (foundRange) + { + if (onlyEnlarge) + newRange.expand(valueAxis->range()); + if (!QCPRange::validRange(newRange)) // likely due to range being zero (plottable has only constant data in this axis dimension), shift current range to at least center the plottable + { + double center = (newRange.lower+newRange.upper)*0.5; // upper and lower should be equal anyway, but just to make sure, incase validRange returned false for other reason + if (valueAxis->scaleType() == QCPAxis::stLinear) + { + newRange.lower = center-valueAxis->range().size()/2.0; + newRange.upper = center+valueAxis->range().size()/2.0; + } else // scaleType() == stLogarithmic + { + newRange.lower = center/qSqrt(valueAxis->range().upper/valueAxis->range().lower); + newRange.upper = center*qSqrt(valueAxis->range().upper/valueAxis->range().lower); + } + } + valueAxis->setRange(newRange); + } +} + +/*! + Adds this plottable to the legend of the parent QCustomPlot (QCustomPlot::legend). + + Normally, a QCPPlottableLegendItem is created and inserted into the legend. If the plottable + needs a more specialized representation in the legend, this function will take this into account + and instead create the specialized subclass of QCPAbstractLegendItem. + + Returns true on success, i.e. when the legend exists and a legend item associated with this plottable isn't already in + the legend. + + \see removeFromLegend, QCPLegend::addItem +*/ +bool QCPAbstractPlottable::addToLegend() +{ + if (!mParentPlot || !mParentPlot->legend) + return false; + + if (!mParentPlot->legend->hasItemWithPlottable(this)) + { + mParentPlot->legend->addItem(new QCPPlottableLegendItem(mParentPlot->legend, this)); + return true; + } else + return false; +} + +/*! + Removes the plottable from the legend of the parent QCustomPlot. This means the + QCPAbstractLegendItem (usually a QCPPlottableLegendItem) that is associated with this plottable + is removed. + + Returns true on success, i.e. if the legend exists and a legend item associated with this + plottable was found and removed. + + \see addToLegend, QCPLegend::removeItem +*/ +bool QCPAbstractPlottable::removeFromLegend() const +{ + if (!mParentPlot->legend) + return false; + + if (QCPPlottableLegendItem *lip = mParentPlot->legend->itemWithPlottable(this)) + return mParentPlot->legend->removeItem(lip); + else + return false; +} + +/* inherits documentation from base class */ +QRect QCPAbstractPlottable::clipRect() const +{ + if (mKeyAxis && mValueAxis) + return mKeyAxis.data()->axisRect()->rect() & mValueAxis.data()->axisRect()->rect(); + else + return QRect(); +} + +/* inherits documentation from base class */ +QCP::Interaction QCPAbstractPlottable::selectionCategory() const +{ + return QCP::iSelectPlottables; +} + +/*! \internal + + Convenience function for transforming a key/value pair to pixels on the QCustomPlot surface, + taking the orientations of the axes associated with this plottable into account (e.g. whether key + represents x or y). + + \a key and \a value are transformed to the coodinates in pixels and are written to \a x and \a y. + + \see pixelsToCoords, QCPAxis::coordToPixel +*/ +void QCPAbstractPlottable::coordsToPixels(double key, double value, double &x, double &y) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + + if (keyAxis->orientation() == Qt::Horizontal) + { + x = keyAxis->coordToPixel(key); + y = valueAxis->coordToPixel(value); + } else + { + y = keyAxis->coordToPixel(key); + x = valueAxis->coordToPixel(value); + } +} + +/*! \internal + \overload + + Returns the input as pixel coordinates in a QPointF. +*/ +const QPointF QCPAbstractPlottable::coordsToPixels(double key, double value) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return QPointF(); } + + if (keyAxis->orientation() == Qt::Horizontal) + return QPointF(keyAxis->coordToPixel(key), valueAxis->coordToPixel(value)); + else + return QPointF(valueAxis->coordToPixel(value), keyAxis->coordToPixel(key)); +} + +/*! \internal + + Convenience function for transforming a x/y pixel pair on the QCustomPlot surface to plot coordinates, + taking the orientations of the axes associated with this plottable into account (e.g. whether key + represents x or y). + + \a x and \a y are transformed to the plot coodinates and are written to \a key and \a value. + + \see coordsToPixels, QCPAxis::coordToPixel +*/ +void QCPAbstractPlottable::pixelsToCoords(double x, double y, double &key, double &value) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + + if (keyAxis->orientation() == Qt::Horizontal) + { + key = keyAxis->pixelToCoord(x); + value = valueAxis->pixelToCoord(y); + } else + { + key = keyAxis->pixelToCoord(y); + value = valueAxis->pixelToCoord(x); + } +} + +/*! \internal + \overload + + Returns the pixel input \a pixelPos as plot coordinates \a key and \a value. +*/ +void QCPAbstractPlottable::pixelsToCoords(const QPointF &pixelPos, double &key, double &value) const +{ + pixelsToCoords(pixelPos.x(), pixelPos.y(), key, value); +} + +/*! \internal + + Returns the pen that should be used for drawing lines of the plottable. Returns mPen when the + graph is not selected and mSelectedPen when it is. +*/ +QPen QCPAbstractPlottable::mainPen() const +{ + return mSelected ? mSelectedPen : mPen; +} + +/*! \internal + + Returns the brush that should be used for drawing fills of the plottable. Returns mBrush when the + graph is not selected and mSelectedBrush when it is. +*/ +QBrush QCPAbstractPlottable::mainBrush() const +{ + return mSelected ? mSelectedBrush : mBrush; +} + +/*! \internal + + A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter + before drawing plottable lines. + + This is the antialiasing state the painter passed to the \ref draw method is in by default. + + This function takes into account the local setting of the antialiasing flag as well as the + overrides set with \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. + + \see setAntialiased, applyFillAntialiasingHint, applyScattersAntialiasingHint, applyErrorBarsAntialiasingHint +*/ +void QCPAbstractPlottable::applyDefaultAntialiasingHint(QCPPainter *painter) const +{ + applyAntialiasingHint(painter, mAntialiased, QCP::aePlottables); +} + +/*! \internal + + A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter + before drawing plottable fills. + + This function takes into account the local setting of the antialiasing flag as well as the + overrides set with \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. + + \see setAntialiased, applyDefaultAntialiasingHint, applyScattersAntialiasingHint, applyErrorBarsAntialiasingHint +*/ +void QCPAbstractPlottable::applyFillAntialiasingHint(QCPPainter *painter) const +{ + applyAntialiasingHint(painter, mAntialiasedFill, QCP::aeFills); +} + +/*! \internal + + A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter + before drawing plottable scatter points. + + This function takes into account the local setting of the antialiasing flag as well as the + overrides set with \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. + + \see setAntialiased, applyFillAntialiasingHint, applyDefaultAntialiasingHint, applyErrorBarsAntialiasingHint +*/ +void QCPAbstractPlottable::applyScattersAntialiasingHint(QCPPainter *painter) const +{ + applyAntialiasingHint(painter, mAntialiasedScatters, QCP::aeScatters); +} + +/*! \internal + + A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter + before drawing plottable error bars. + + This function takes into account the local setting of the antialiasing flag as well as the + overrides set with \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. + + \see setAntialiased, applyFillAntialiasingHint, applyScattersAntialiasingHint, applyDefaultAntialiasingHint +*/ +void QCPAbstractPlottable::applyErrorBarsAntialiasingHint(QCPPainter *painter) const +{ + applyAntialiasingHint(painter, mAntialiasedErrorBars, QCP::aeErrorBars); +} + +/*! \internal + + Finds the shortest squared distance of \a point to the line segment defined by \a start and \a + end. + + This function may be used to help with the implementation of the \ref selectTest function for + specific plottables. + + \note This function is identical to QCPAbstractItem::distSqrToLine +*/ +double QCPAbstractPlottable::distSqrToLine(const QPointF &start, const QPointF &end, const QPointF &point) const +{ + QVector2D a(start); + QVector2D b(end); + QVector2D p(point); + QVector2D v(b-a); + + double vLengthSqr = v.lengthSquared(); + if (!qFuzzyIsNull(vLengthSqr)) + { + double mu = QVector2D::dotProduct(p-a, v)/vLengthSqr; + if (mu < 0) + return (a-p).lengthSquared(); + else if (mu > 1) + return (b-p).lengthSquared(); + else + return ((a + mu*v)-p).lengthSquared(); + } else + return (a-p).lengthSquared(); +} + +/* inherits documentation from base class */ +void QCPAbstractPlottable::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) +{ + Q_UNUSED(event) + Q_UNUSED(details) + if (mSelectable) + { + bool selBefore = mSelected; + setSelected(additive ? !mSelected : true); + if (selectionStateChanged) + *selectionStateChanged = mSelected != selBefore; + } +} + +/* inherits documentation from base class */ +void QCPAbstractPlottable::deselectEvent(bool *selectionStateChanged) +{ + if (mSelectable) + { + bool selBefore = mSelected; + setSelected(false); + if (selectionStateChanged) + *selectionStateChanged = mSelected != selBefore; + } +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemAnchor +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemAnchor + \brief An anchor of an item to which positions can be attached to. + + An item (QCPAbstractItem) may have one or more anchors. Unlike QCPItemPosition, an anchor doesn't + control anything on its item, but provides a way to tie other items via their positions to the + anchor. + + For example, a QCPItemRect is defined by its positions \a topLeft and \a bottomRight. + Additionally it has various anchors like \a top, \a topRight or \a bottomLeft etc. So you can + attach the \a start (which is a QCPItemPosition) of a QCPItemLine to one of the anchors by + calling QCPItemPosition::setParentAnchor on \a start, passing the wanted anchor of the + QCPItemRect. This way the start of the line will now always follow the respective anchor location + on the rect item. + + Note that QCPItemPosition derives from QCPItemAnchor, so every position can also serve as an + anchor to other positions. + + To learn how to provide anchors in your own item subclasses, see the subclassing section of the + QCPAbstractItem documentation. +*/ + +/* start documentation of inline functions */ + +/*! \fn virtual QCPItemPosition *QCPItemAnchor::toQCPItemPosition() + + Returns 0 if this instance is merely a QCPItemAnchor, and a valid pointer of type QCPItemPosition* if + it actually is a QCPItemPosition (which is a subclass of QCPItemAnchor). + + This safe downcast functionality could also be achieved with a dynamic_cast. However, QCustomPlot avoids + dynamic_cast to work with projects that don't have RTTI support enabled (e.g. -fno-rtti flag with + gcc compiler). +*/ + +/* end documentation of inline functions */ + +/*! + Creates a new QCPItemAnchor. You shouldn't create QCPItemAnchor instances directly, even if + you want to make a new item subclass. Use \ref QCPAbstractItem::createAnchor instead, as + explained in the subclassing section of the QCPAbstractItem documentation. +*/ +QCPItemAnchor::QCPItemAnchor(QCustomPlot *parentPlot, QCPAbstractItem *parentItem, const QString name, int anchorId) : + mName(name), + mParentPlot(parentPlot), + mParentItem(parentItem), + mAnchorId(anchorId) +{ +} + +QCPItemAnchor::~QCPItemAnchor() +{ + // unregister as parent at children: + foreach (QCPItemPosition *child, mChildrenX.toList()) + { + if (child->parentAnchorX() == this) + child->setParentAnchorX(0); // this acts back on this anchor and child removes itself from mChildrenX + } + foreach (QCPItemPosition *child, mChildrenY.toList()) + { + if (child->parentAnchorY() == this) + child->setParentAnchorY(0); // this acts back on this anchor and child removes itself from mChildrenY + } +} + +/*! + Returns the final absolute pixel position of the QCPItemAnchor on the QCustomPlot surface. + + The pixel information is internally retrieved via QCPAbstractItem::anchorPixelPosition of the + parent item, QCPItemAnchor is just an intermediary. +*/ +QPointF QCPItemAnchor::pixelPoint() const +{ + if (mParentItem) + { + if (mAnchorId > -1) + { + return mParentItem->anchorPixelPoint(mAnchorId); + } else + { + qDebug() << Q_FUNC_INFO << "no valid anchor id set:" << mAnchorId; + return QPointF(); + } + } else + { + qDebug() << Q_FUNC_INFO << "no parent item set"; + return QPointF(); + } +} + +/*! \internal + + Adds \a pos to the childX list of this anchor, which keeps track of which children use this + anchor as parent anchor for the respective coordinate. This is necessary to notify the children + prior to destruction of the anchor. + + Note that this function does not change the parent setting in \a pos. +*/ +void QCPItemAnchor::addChildX(QCPItemPosition *pos) +{ + if (!mChildrenX.contains(pos)) + mChildrenX.insert(pos); + else + qDebug() << Q_FUNC_INFO << "provided pos is child already" << reinterpret_cast(pos); +} + +/*! \internal + + Removes \a pos from the childX list of this anchor. + + Note that this function does not change the parent setting in \a pos. +*/ +void QCPItemAnchor::removeChildX(QCPItemPosition *pos) +{ + if (!mChildrenX.remove(pos)) + qDebug() << Q_FUNC_INFO << "provided pos isn't child" << reinterpret_cast(pos); +} + +/*! \internal + + Adds \a pos to the childY list of this anchor, which keeps track of which children use this + anchor as parent anchor for the respective coordinate. This is necessary to notify the children + prior to destruction of the anchor. + + Note that this function does not change the parent setting in \a pos. +*/ +void QCPItemAnchor::addChildY(QCPItemPosition *pos) +{ + if (!mChildrenY.contains(pos)) + mChildrenY.insert(pos); + else + qDebug() << Q_FUNC_INFO << "provided pos is child already" << reinterpret_cast(pos); +} + +/*! \internal + + Removes \a pos from the childY list of this anchor. + + Note that this function does not change the parent setting in \a pos. +*/ +void QCPItemAnchor::removeChildY(QCPItemPosition *pos) +{ + if (!mChildrenY.remove(pos)) + qDebug() << Q_FUNC_INFO << "provided pos isn't child" << reinterpret_cast(pos); +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemPosition +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemPosition + \brief Manages the position of an item. + + Every item has at least one public QCPItemPosition member pointer which provides ways to position the + item on the QCustomPlot surface. Some items have multiple positions, for example QCPItemRect has two: + \a topLeft and \a bottomRight. + + QCPItemPosition has a type (\ref PositionType) that can be set with \ref setType. This type + defines how coordinates passed to \ref setCoords are to be interpreted, e.g. as absolute pixel + coordinates, as plot coordinates of certain axes, etc. For more advanced plots it is also + possible to assign different types per X/Y coordinate of the position (see \ref setTypeX, \ref + setTypeY). This way an item could be positioned at a fixed pixel distance from the top in the Y + direction, while following a plot coordinate in the X direction. + + A QCPItemPosition may have a parent QCPItemAnchor, see \ref setParentAnchor. This way you can tie + multiple items together. If the QCPItemPosition has a parent, its coordinates (\ref setCoords) + are considered to be absolute pixels in the reference frame of the parent anchor, where (0, 0) + means directly ontop of the parent anchor. For example, You could attach the \a start position of + a QCPItemLine to the \a bottom anchor of a QCPItemText to make the starting point of the line + always be centered under the text label, no matter where the text is moved to. For more advanced + plots, it is possible to assign different parent anchors per X/Y coordinate of the position, see + \ref setParentAnchorX, \ref setParentAnchorY. This way an item could follow another item in the X + direction but stay at a fixed position in the Y direction. Or even follow item A in X, and item B + in Y. + + Note that every QCPItemPosition inherits from QCPItemAnchor and thus can itself be used as parent + anchor for other positions. + + To set the apparent pixel position on the QCustomPlot surface directly, use \ref setPixelPoint. This + works no matter what type this QCPItemPosition is or what parent-child situation it is in, as \ref + setPixelPoint transforms the coordinates appropriately, to make the position appear at the specified + pixel values. +*/ + +/* start documentation of inline functions */ + +/*! \fn QCPItemPosition::PositionType *QCPItemPosition::type() const + + Returns the current position type. + + If different types were set for X and Y (\ref setTypeX, \ref setTypeY), this method returns the + type of the X coordinate. In that case rather use \a typeX() and \a typeY(). + + \see setType +*/ + +/*! \fn QCPItemAnchor *QCPItemPosition::parentAnchor() const + + Returns the current parent anchor. + + If different parent anchors were set for X and Y (\ref setParentAnchorX, \ref setParentAnchorY), + this method returns the parent anchor of the Y coordinate. In that case rather use \a + parentAnchorX() and \a parentAnchorY(). + + \see setParentAnchor +*/ + +/* end documentation of inline functions */ + +/*! + Creates a new QCPItemPosition. You shouldn't create QCPItemPosition instances directly, even if + you want to make a new item subclass. Use \ref QCPAbstractItem::createPosition instead, as + explained in the subclassing section of the QCPAbstractItem documentation. +*/ +QCPItemPosition::QCPItemPosition(QCustomPlot *parentPlot, QCPAbstractItem *parentItem, const QString name) : + QCPItemAnchor(parentPlot, parentItem, name), + mPositionTypeX(ptAbsolute), + mPositionTypeY(ptAbsolute), + mKey(0), + mValue(0), + mParentAnchorX(0), + mParentAnchorY(0) +{ +} + +QCPItemPosition::~QCPItemPosition() +{ + // unregister as parent at children: + // Note: this is done in ~QCPItemAnchor again, but it's important QCPItemPosition does it itself, because only then + // the setParentAnchor(0) call the correct QCPItemPosition::pixelPoint function instead of QCPItemAnchor::pixelPoint + foreach (QCPItemPosition *child, mChildrenX.toList()) + { + if (child->parentAnchorX() == this) + child->setParentAnchorX(0); // this acts back on this anchor and child removes itself from mChildrenX + } + foreach (QCPItemPosition *child, mChildrenY.toList()) + { + if (child->parentAnchorY() == this) + child->setParentAnchorY(0); // this acts back on this anchor and child removes itself from mChildrenY + } + // unregister as child in parent: + if (mParentAnchorX) + mParentAnchorX->removeChildX(this); + if (mParentAnchorY) + mParentAnchorY->removeChildY(this); +} + +/* can't make this a header inline function, because QPointer breaks with forward declared types, see QTBUG-29588 */ +QCPAxisRect *QCPItemPosition::axisRect() const +{ + return mAxisRect.data(); +} + +/*! + Sets the type of the position. The type defines how the coordinates passed to \ref setCoords + should be handled and how the QCPItemPosition should behave in the plot. + + The possible values for \a type can be separated in two main categories: + + \li The position is regarded as a point in plot coordinates. This corresponds to \ref ptPlotCoords + and requires two axes that define the plot coordinate system. They can be specified with \ref setAxes. + By default, the QCustomPlot's x- and yAxis are used. + + \li The position is fixed on the QCustomPlot surface, i.e. independent of axis ranges. This + corresponds to all other types, i.e. \ref ptAbsolute, \ref ptViewportRatio and \ref + ptAxisRectRatio. They differ only in the way the absolute position is described, see the + documentation of \ref PositionType for details. For \ref ptAxisRectRatio, note that you can specify + the axis rect with \ref setAxisRect. By default this is set to the main axis rect. + + Note that the position type \ref ptPlotCoords is only available (and sensible) when the position + has no parent anchor (\ref setParentAnchor). + + If the type is changed, the apparent pixel position on the plot is preserved. This means + the coordinates as retrieved with coords() and set with \ref setCoords may change in the process. + + This method sets the type for both X and Y directions. It is also possible to set different types + for X and Y, see \ref setTypeX, \ref setTypeY. +*/ +void QCPItemPosition::setType(QCPItemPosition::PositionType type) +{ + setTypeX(type); + setTypeY(type); +} + +/*! + This method sets the position type of the X coordinate to \a type. + + For a detailed description of what a position type is, see the documentation of \ref setType. + + \see setType, setTypeY +*/ +void QCPItemPosition::setTypeX(QCPItemPosition::PositionType type) +{ + if (mPositionTypeX != type) + { + // if switching from or to coordinate type that isn't valid (e.g. because axes or axis rect + // were deleted), don't try to recover the pixelPoint() because it would output a qDebug warning. + bool retainPixelPosition = true; + if ((mPositionTypeX == ptPlotCoords || type == ptPlotCoords) && (!mKeyAxis || !mValueAxis)) + retainPixelPosition = false; + if ((mPositionTypeX == ptAxisRectRatio || type == ptAxisRectRatio) && (!mAxisRect)) + retainPixelPosition = false; + + QPointF pixel; + if (retainPixelPosition) + pixel = pixelPoint(); + + mPositionTypeX = type; + + if (retainPixelPosition) + setPixelPoint(pixel); + } +} + +/*! + This method sets the position type of the Y coordinate to \a type. + + For a detailed description of what a position type is, see the documentation of \ref setType. + + \see setType, setTypeX +*/ +void QCPItemPosition::setTypeY(QCPItemPosition::PositionType type) +{ + if (mPositionTypeY != type) + { + // if switching from or to coordinate type that isn't valid (e.g. because axes or axis rect + // were deleted), don't try to recover the pixelPoint() because it would output a qDebug warning. + bool retainPixelPosition = true; + if ((mPositionTypeY == ptPlotCoords || type == ptPlotCoords) && (!mKeyAxis || !mValueAxis)) + retainPixelPosition = false; + if ((mPositionTypeY == ptAxisRectRatio || type == ptAxisRectRatio) && (!mAxisRect)) + retainPixelPosition = false; + + QPointF pixel; + if (retainPixelPosition) + pixel = pixelPoint(); + + mPositionTypeY = type; + + if (retainPixelPosition) + setPixelPoint(pixel); + } +} + +/*! + Sets the parent of this QCPItemPosition to \a parentAnchor. This means the position will now + follow any position changes of the anchor. The local coordinate system of positions with a parent + anchor always is absolute pixels, with (0, 0) being exactly on top of the parent anchor. (Hence + the type shouldn't be set to \ref ptPlotCoords for positions with parent anchors.) + + if \a keepPixelPosition is true, the current pixel position of the QCPItemPosition is preserved + during reparenting. If it's set to false, the coordinates are set to (0, 0), i.e. the position + will be exactly on top of the parent anchor. + + To remove this QCPItemPosition from any parent anchor, set \a parentAnchor to 0. + + If the QCPItemPosition previously had no parent and the type is \ref ptPlotCoords, the type is + set to \ref ptAbsolute, to keep the position in a valid state. + + This method sets the parent anchor for both X and Y directions. It is also possible to set + different parents for X and Y, see \ref setParentAnchorX, \ref setParentAnchorY. +*/ +bool QCPItemPosition::setParentAnchor(QCPItemAnchor *parentAnchor, bool keepPixelPosition) +{ + bool successX = setParentAnchorX(parentAnchor, keepPixelPosition); + bool successY = setParentAnchorY(parentAnchor, keepPixelPosition); + return successX && successY; +} + +/*! + This method sets the parent anchor of the X coordinate to \a parentAnchor. + + For a detailed description of what a parent anchor is, see the documentation of \ref setParentAnchor. + + \see setParentAnchor, setParentAnchorY +*/ +bool QCPItemPosition::setParentAnchorX(QCPItemAnchor *parentAnchor, bool keepPixelPosition) +{ + // make sure self is not assigned as parent: + if (parentAnchor == this) + { + qDebug() << Q_FUNC_INFO << "can't set self as parent anchor" << reinterpret_cast(parentAnchor); + return false; + } + // make sure no recursive parent-child-relationships are created: + QCPItemAnchor *currentParent = parentAnchor; + while (currentParent) + { + if (QCPItemPosition *currentParentPos = currentParent->toQCPItemPosition()) + { + // is a QCPItemPosition, might have further parent, so keep iterating + if (currentParentPos == this) + { + qDebug() << Q_FUNC_INFO << "can't create recursive parent-child-relationship" << reinterpret_cast(parentAnchor); + return false; + } + currentParent = currentParentPos->parentAnchorX(); + } else + { + // is a QCPItemAnchor, can't have further parent. Now make sure the parent items aren't the + // same, to prevent a position being child of an anchor which itself depends on the position, + // because they're both on the same item: + if (currentParent->mParentItem == mParentItem) + { + qDebug() << Q_FUNC_INFO << "can't set parent to be an anchor which itself depends on this position" << reinterpret_cast(parentAnchor); + return false; + } + break; + } + } + + // if previously no parent set and PosType is still ptPlotCoords, set to ptAbsolute: + if (!mParentAnchorX && mPositionTypeX == ptPlotCoords) + setTypeX(ptAbsolute); + + // save pixel position: + QPointF pixelP; + if (keepPixelPosition) + pixelP = pixelPoint(); + // unregister at current parent anchor: + if (mParentAnchorX) + mParentAnchorX->removeChildX(this); + // register at new parent anchor: + if (parentAnchor) + parentAnchor->addChildX(this); + mParentAnchorX = parentAnchor; + // restore pixel position under new parent: + if (keepPixelPosition) + setPixelPoint(pixelP); + else + setCoords(0, coords().y()); + return true; +} + +/*! + This method sets the parent anchor of the Y coordinate to \a parentAnchor. + + For a detailed description of what a parent anchor is, see the documentation of \ref setParentAnchor. + + \see setParentAnchor, setParentAnchorX +*/ +bool QCPItemPosition::setParentAnchorY(QCPItemAnchor *parentAnchor, bool keepPixelPosition) +{ + // make sure self is not assigned as parent: + if (parentAnchor == this) + { + qDebug() << Q_FUNC_INFO << "can't set self as parent anchor" << reinterpret_cast(parentAnchor); + return false; + } + // make sure no recursive parent-child-relationships are created: + QCPItemAnchor *currentParent = parentAnchor; + while (currentParent) + { + if (QCPItemPosition *currentParentPos = currentParent->toQCPItemPosition()) + { + // is a QCPItemPosition, might have further parent, so keep iterating + if (currentParentPos == this) + { + qDebug() << Q_FUNC_INFO << "can't create recursive parent-child-relationship" << reinterpret_cast(parentAnchor); + return false; + } + currentParent = currentParentPos->parentAnchorY(); + } else + { + // is a QCPItemAnchor, can't have further parent. Now make sure the parent items aren't the + // same, to prevent a position being child of an anchor which itself depends on the position, + // because they're both on the same item: + if (currentParent->mParentItem == mParentItem) + { + qDebug() << Q_FUNC_INFO << "can't set parent to be an anchor which itself depends on this position" << reinterpret_cast(parentAnchor); + return false; + } + break; + } + } + + // if previously no parent set and PosType is still ptPlotCoords, set to ptAbsolute: + if (!mParentAnchorY && mPositionTypeY == ptPlotCoords) + setTypeY(ptAbsolute); + + // save pixel position: + QPointF pixelP; + if (keepPixelPosition) + pixelP = pixelPoint(); + // unregister at current parent anchor: + if (mParentAnchorY) + mParentAnchorY->removeChildY(this); + // register at new parent anchor: + if (parentAnchor) + parentAnchor->addChildY(this); + mParentAnchorY = parentAnchor; + // restore pixel position under new parent: + if (keepPixelPosition) + setPixelPoint(pixelP); + else + setCoords(coords().x(), 0); + return true; +} + +/*! + Sets the coordinates of this QCPItemPosition. What the coordinates mean, is defined by the type + (\ref setType, \ref setTypeX, \ref setTypeY). + + For example, if the type is \ref ptAbsolute, \a key and \a value mean the x and y pixel position + on the QCustomPlot surface. In that case the origin (0, 0) is in the top left corner of the + QCustomPlot viewport. If the type is \ref ptPlotCoords, \a key and \a value mean a point in the + plot coordinate system defined by the axes set by \ref setAxes. By default those are the + QCustomPlot's xAxis and yAxis. See the documentation of \ref setType for other available + coordinate types and their meaning. + + If different types were configured for X and Y (\ref setTypeX, \ref setTypeY), \a key and \a + value must also be provided in the different coordinate systems. Here, the X type refers to \a + key, and the Y type refers to \a value. + + \see setPixelPoint +*/ +void QCPItemPosition::setCoords(double key, double value) +{ + mKey = key; + mValue = value; +} + +/*! \overload + + Sets the coordinates as a QPointF \a pos where pos.x has the meaning of \a key and pos.y the + meaning of \a value of the \ref setCoords(double key, double value) method. +*/ +void QCPItemPosition::setCoords(const QPointF &pos) +{ + setCoords(pos.x(), pos.y()); +} + +/*! + Returns the final absolute pixel position of the QCPItemPosition on the QCustomPlot surface. It + includes all effects of type (\ref setType) and possible parent anchors (\ref setParentAnchor). + + \see setPixelPoint +*/ +QPointF QCPItemPosition::pixelPoint() const +{ + QPointF result; + + // determine X: + switch (mPositionTypeX) + { + case ptAbsolute: + { + result.rx() = mKey; + if (mParentAnchorX) + result.rx() += mParentAnchorX->pixelPoint().x(); + break; + } + case ptViewportRatio: + { + result.rx() = mKey*mParentPlot->viewport().width(); + if (mParentAnchorX) + result.rx() += mParentAnchorX->pixelPoint().x(); + else + result.rx() += mParentPlot->viewport().left(); + break; + } + case ptAxisRectRatio: + { + if (mAxisRect) + { + result.rx() = mKey*mAxisRect.data()->width(); + if (mParentAnchorX) + result.rx() += mParentAnchorX->pixelPoint().x(); + else + result.rx() += mAxisRect.data()->left(); + } else + qDebug() << Q_FUNC_INFO << "Item position type x is ptAxisRectRatio, but no axis rect was defined"; + break; + } + case ptPlotCoords: + { + if (mKeyAxis && mKeyAxis.data()->orientation() == Qt::Horizontal) + result.rx() = mKeyAxis.data()->coordToPixel(mKey); + else if (mValueAxis && mValueAxis.data()->orientation() == Qt::Horizontal) + result.rx() = mValueAxis.data()->coordToPixel(mValue); + else + qDebug() << Q_FUNC_INFO << "Item position type x is ptPlotCoords, but no axes were defined"; + break; + } + } + + // determine Y: + switch (mPositionTypeY) + { + case ptAbsolute: + { + result.ry() = mValue; + if (mParentAnchorY) + result.ry() += mParentAnchorY->pixelPoint().y(); + break; + } + case ptViewportRatio: + { + result.ry() = mValue*mParentPlot->viewport().height(); + if (mParentAnchorY) + result.ry() += mParentAnchorY->pixelPoint().y(); + else + result.ry() += mParentPlot->viewport().top(); + break; + } + case ptAxisRectRatio: + { + if (mAxisRect) + { + result.ry() = mValue*mAxisRect.data()->height(); + if (mParentAnchorY) + result.ry() += mParentAnchorY->pixelPoint().y(); + else + result.ry() += mAxisRect.data()->top(); + } else + qDebug() << Q_FUNC_INFO << "Item position type y is ptAxisRectRatio, but no axis rect was defined"; + break; + } + case ptPlotCoords: + { + if (mKeyAxis && mKeyAxis.data()->orientation() == Qt::Vertical) + result.ry() = mKeyAxis.data()->coordToPixel(mKey); + else if (mValueAxis && mValueAxis.data()->orientation() == Qt::Vertical) + result.ry() = mValueAxis.data()->coordToPixel(mValue); + else + qDebug() << Q_FUNC_INFO << "Item position type y is ptPlotCoords, but no axes were defined"; + break; + } + } + + return result; +} + +/*! + When \ref setType is \ref ptPlotCoords, this function may be used to specify the axes the + coordinates set with \ref setCoords relate to. By default they are set to the initial xAxis and + yAxis of the QCustomPlot. +*/ +void QCPItemPosition::setAxes(QCPAxis *keyAxis, QCPAxis *valueAxis) +{ + mKeyAxis = keyAxis; + mValueAxis = valueAxis; +} + +/*! + When \ref setType is \ref ptAxisRectRatio, this function may be used to specify the axis rect the + coordinates set with \ref setCoords relate to. By default this is set to the main axis rect of + the QCustomPlot. +*/ +void QCPItemPosition::setAxisRect(QCPAxisRect *axisRect) +{ + mAxisRect = axisRect; +} + +/*! + Sets the apparent pixel position. This works no matter what type (\ref setType) this + QCPItemPosition is or what parent-child situation it is in, as coordinates are transformed + appropriately, to make the position finally appear at the specified pixel values. + + Only if the type is \ref ptAbsolute and no parent anchor is set, this function's effect is + identical to that of \ref setCoords. + + \see pixelPoint, setCoords +*/ +void QCPItemPosition::setPixelPoint(const QPointF &pixelPoint) +{ + double x = pixelPoint.x(); + double y = pixelPoint.y(); + + switch (mPositionTypeX) + { + case ptAbsolute: + { + if (mParentAnchorX) + x -= mParentAnchorX->pixelPoint().x(); + break; + } + case ptViewportRatio: + { + if (mParentAnchorX) + x -= mParentAnchorX->pixelPoint().x(); + else + x -= mParentPlot->viewport().left(); + x /= (double)mParentPlot->viewport().width(); + break; + } + case ptAxisRectRatio: + { + if (mAxisRect) + { + if (mParentAnchorX) + x -= mParentAnchorX->pixelPoint().x(); + else + x -= mAxisRect.data()->left(); + x /= (double)mAxisRect.data()->width(); + } else + qDebug() << Q_FUNC_INFO << "Item position type x is ptAxisRectRatio, but no axis rect was defined"; + break; + } + case ptPlotCoords: + { + if (mKeyAxis && mKeyAxis.data()->orientation() == Qt::Horizontal) + x = mKeyAxis.data()->pixelToCoord(x); + else if (mValueAxis && mValueAxis.data()->orientation() == Qt::Horizontal) + y = mValueAxis.data()->pixelToCoord(x); + else + qDebug() << Q_FUNC_INFO << "Item position type x is ptPlotCoords, but no axes were defined"; + break; + } + } + + switch (mPositionTypeY) + { + case ptAbsolute: + { + if (mParentAnchorY) + y -= mParentAnchorY->pixelPoint().y(); + break; + } + case ptViewportRatio: + { + if (mParentAnchorY) + y -= mParentAnchorY->pixelPoint().y(); + else + y -= mParentPlot->viewport().top(); + y /= (double)mParentPlot->viewport().height(); + break; + } + case ptAxisRectRatio: + { + if (mAxisRect) + { + if (mParentAnchorY) + y -= mParentAnchorY->pixelPoint().y(); + else + y -= mAxisRect.data()->top(); + y /= (double)mAxisRect.data()->height(); + } else + qDebug() << Q_FUNC_INFO << "Item position type y is ptAxisRectRatio, but no axis rect was defined"; + break; + } + case ptPlotCoords: + { + if (mKeyAxis && mKeyAxis.data()->orientation() == Qt::Vertical) + x = mKeyAxis.data()->pixelToCoord(y); + else if (mValueAxis && mValueAxis.data()->orientation() == Qt::Vertical) + y = mValueAxis.data()->pixelToCoord(y); + else + qDebug() << Q_FUNC_INFO << "Item position type y is ptPlotCoords, but no axes were defined"; + break; + } + } + + setCoords(x, y); +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAbstractItem +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPAbstractItem + \brief The abstract base class for all items in a plot. + + In QCustomPlot, items are supplemental graphical elements that are neither plottables + (QCPAbstractPlottable) nor axes (QCPAxis). While plottables are always tied to two axes and thus + plot coordinates, items can also be placed in absolute coordinates independent of any axes. Each + specific item has at least one QCPItemPosition member which controls the positioning. Some items + are defined by more than one coordinate and thus have two or more QCPItemPosition members (For + example, QCPItemRect has \a topLeft and \a bottomRight). + + This abstract base class defines a very basic interface like visibility and clipping. Since this + class is abstract, it can't be instantiated. Use one of the subclasses or create a subclass + yourself to create new items. + + The built-in items are: + + + + + + + + + + +
QCPItemLineA line defined by a start and an end point. May have different ending styles on each side (e.g. arrows).
QCPItemStraightLineA straight line defined by a start and a direction point. Unlike QCPItemLine, the straight line is infinitely long and has no endings.
QCPItemCurveA curve defined by start, end and two intermediate control points. May have different ending styles on each side (e.g. arrows).
QCPItemRectA rectangle
QCPItemEllipseAn ellipse
QCPItemPixmapAn arbitrary pixmap
QCPItemTextA text label
QCPItemBracketA bracket which may be used to reference/highlight certain parts in the plot.
QCPItemTracerAn item that can be attached to a QCPGraph and sticks to its data points, given a key coordinate.
+ + \section items-clipping Clipping + + Items are by default clipped to the main axis rect (they are only visible inside the axis rect). + To make an item visible outside that axis rect, disable clipping via \ref setClipToAxisRect + "setClipToAxisRect(false)". + + On the other hand if you want the item to be clipped to a different axis rect, specify it via + \ref setClipAxisRect. This clipAxisRect property of an item is only used for clipping behaviour, and + in principle is independent of the coordinate axes the item might be tied to via its position + members (\ref QCPItemPosition::setAxes). However, it is common that the axis rect for clipping + also contains the axes used for the item positions. + + \section items-using Using items + + First you instantiate the item you want to use and add it to the plot: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpitemline-creation-1 + by default, the positions of the item are bound to the x- and y-Axis of the plot. So we can just + set the plot coordinates where the line should start/end: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpitemline-creation-2 + If we don't want the line to be positioned in plot coordinates but a different coordinate system, + e.g. absolute pixel positions on the QCustomPlot surface, we need to change the position type like this: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpitemline-creation-3 + Then we can set the coordinates, this time in pixels: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpitemline-creation-4 + and make the line visible on the entire QCustomPlot, by disabling clipping to the axis rect: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpitemline-creation-5 + + For more advanced plots, it is even possible to set different types and parent anchors per X/Y + coordinate of an item position, using for example \ref QCPItemPosition::setTypeX or \ref + QCPItemPosition::setParentAnchorX. For details, see the documentation of \ref QCPItemPosition. + + \section items-subclassing Creating own items + + To create an own item, you implement a subclass of QCPAbstractItem. These are the pure + virtual functions, you must implement: + \li \ref selectTest + \li \ref draw + + See the documentation of those functions for what they need to do. + + \subsection items-positioning Allowing the item to be positioned + + As mentioned, item positions are represented by QCPItemPosition members. Let's assume the new item shall + have only one point as its position (as opposed to two like a rect or multiple like a polygon). You then add + a public member of type QCPItemPosition like so: + + \code QCPItemPosition * const myPosition;\endcode + + the const makes sure the pointer itself can't be modified from the user of your new item (the QCPItemPosition + instance it points to, can be modified, of course). + The initialization of this pointer is made easy with the \ref createPosition function. Just assign + the return value of this function to each QCPItemPosition in the constructor of your item. \ref createPosition + takes a string which is the name of the position, typically this is identical to the variable name. + For example, the constructor of QCPItemExample could look like this: + + \code + QCPItemExample::QCPItemExample(QCustomPlot *parentPlot) : + QCPAbstractItem(parentPlot), + myPosition(createPosition("myPosition")) + { + // other constructor code + } + \endcode + + \subsection items-drawing The draw function + + To give your item a visual representation, reimplement the \ref draw function and use the passed + QCPPainter to draw the item. You can retrieve the item position in pixel coordinates from the + position member(s) via \ref QCPItemPosition::pixelPoint. + + To optimize performance you should calculate a bounding rect first (don't forget to take the pen + width into account), check whether it intersects the \ref clipRect, and only draw the item at all + if this is the case. + + \subsection items-selection The selectTest function + + Your implementation of the \ref selectTest function may use the helpers \ref distSqrToLine and + \ref rectSelectTest. With these, the implementation of the selection test becomes significantly + simpler for most items. See the documentation of \ref selectTest for what the function parameters + mean and what the function should return. + + \subsection anchors Providing anchors + + Providing anchors (QCPItemAnchor) starts off like adding a position. First you create a public + member, e.g. + + \code QCPItemAnchor * const bottom;\endcode + + and create it in the constructor with the \ref createAnchor function, assigning it a name and an + anchor id (an integer enumerating all anchors on the item, you may create an own enum for this). + Since anchors can be placed anywhere, relative to the item's position(s), your item needs to + provide the position of every anchor with the reimplementation of the \ref anchorPixelPoint(int + anchorId) function. + + In essence the QCPItemAnchor is merely an intermediary that itself asks your item for the pixel + position when anything attached to the anchor needs to know the coordinates. +*/ + +/* start of documentation of inline functions */ + +/*! \fn QList QCPAbstractItem::positions() const + + Returns all positions of the item in a list. + + \see anchors, position +*/ + +/*! \fn QList QCPAbstractItem::anchors() const + + Returns all anchors of the item in a list. Note that since a position (QCPItemPosition) is always + also an anchor, the list will also contain the positions of this item. + + \see positions, anchor +*/ + +/* end of documentation of inline functions */ +/* start documentation of pure virtual functions */ + +/*! \fn void QCPAbstractItem::draw(QCPPainter *painter) = 0 + \internal + + Draws this item with the provided \a painter. + + The cliprect of the provided painter is set to the rect returned by \ref clipRect before this + function is called. The clipRect depends on the clipping settings defined by \ref + setClipToAxisRect and \ref setClipAxisRect. +*/ + +/* end documentation of pure virtual functions */ +/* start documentation of signals */ + +/*! \fn void QCPAbstractItem::selectionChanged(bool selected) + This signal is emitted when the selection state of this item has changed, either by user interaction + or by a direct call to \ref setSelected. +*/ + +/* end documentation of signals */ + +/*! + Base class constructor which initializes base class members. +*/ +QCPAbstractItem::QCPAbstractItem(QCustomPlot *parentPlot) : + QCPLayerable(parentPlot), + mClipToAxisRect(false), + mSelectable(true), + mSelected(false) +{ + QList rects = parentPlot->axisRects(); + if (rects.size() > 0) + { + setClipToAxisRect(true); + setClipAxisRect(rects.first()); + } +} + +QCPAbstractItem::~QCPAbstractItem() +{ + // don't delete mPositions because every position is also an anchor and thus in mAnchors + qDeleteAll(mAnchors); +} + +/* can't make this a header inline function, because QPointer breaks with forward declared types, see QTBUG-29588 */ +QCPAxisRect *QCPAbstractItem::clipAxisRect() const +{ + return mClipAxisRect.data(); +} + +/*! + Sets whether the item shall be clipped to an axis rect or whether it shall be visible on the + entire QCustomPlot. The axis rect can be set with \ref setClipAxisRect. + + \see setClipAxisRect +*/ +void QCPAbstractItem::setClipToAxisRect(bool clip) +{ + mClipToAxisRect = clip; + if (mClipToAxisRect) + setParentLayerable(mClipAxisRect.data()); +} + +/*! + Sets the clip axis rect. It defines the rect that will be used to clip the item when \ref + setClipToAxisRect is set to true. + + \see setClipToAxisRect +*/ +void QCPAbstractItem::setClipAxisRect(QCPAxisRect *rect) +{ + mClipAxisRect = rect; + if (mClipToAxisRect) + setParentLayerable(mClipAxisRect.data()); +} + +/*! + Sets whether the user can (de-)select this item by clicking on the QCustomPlot surface. + (When \ref QCustomPlot::setInteractions contains QCustomPlot::iSelectItems.) + + However, even when \a selectable was set to false, it is possible to set the selection manually, + by calling \ref setSelected. + + \see QCustomPlot::setInteractions, setSelected +*/ +void QCPAbstractItem::setSelectable(bool selectable) +{ + if (mSelectable != selectable) + { + mSelectable = selectable; + emit selectableChanged(mSelectable); + } +} + +/*! + Sets whether this item is selected or not. When selected, it might use a different visual + appearance (e.g. pen and brush), this depends on the specific item though. + + The entire selection mechanism for items is handled automatically when \ref + QCustomPlot::setInteractions contains QCustomPlot::iSelectItems. You only need to call this + function when you wish to change the selection state manually. + + This function can change the selection state even when \ref setSelectable was set to false. + + emits the \ref selectionChanged signal when \a selected is different from the previous selection state. + + \see setSelectable, selectTest +*/ +void QCPAbstractItem::setSelected(bool selected) +{ + if (mSelected != selected) + { + mSelected = selected; + emit selectionChanged(mSelected); + } +} + +/*! + Returns the QCPItemPosition with the specified \a name. If this item doesn't have a position by + that name, returns 0. + + This function provides an alternative way to access item positions. Normally, you access + positions direcly by their member pointers (which typically have the same variable name as \a + name). + + \see positions, anchor +*/ +QCPItemPosition *QCPAbstractItem::position(const QString &name) const +{ + for (int i=0; iname() == name) + return mPositions.at(i); + } + qDebug() << Q_FUNC_INFO << "position with name not found:" << name; + return 0; +} + +/*! + Returns the QCPItemAnchor with the specified \a name. If this item doesn't have an anchor by + that name, returns 0. + + This function provides an alternative way to access item anchors. Normally, you access + anchors direcly by their member pointers (which typically have the same variable name as \a + name). + + \see anchors, position +*/ +QCPItemAnchor *QCPAbstractItem::anchor(const QString &name) const +{ + for (int i=0; iname() == name) + return mAnchors.at(i); + } + qDebug() << Q_FUNC_INFO << "anchor with name not found:" << name; + return 0; +} + +/*! + Returns whether this item has an anchor with the specified \a name. + + Note that you can check for positions with this function, too. This is because every position is + also an anchor (QCPItemPosition inherits from QCPItemAnchor). + + \see anchor, position +*/ +bool QCPAbstractItem::hasAnchor(const QString &name) const +{ + for (int i=0; iname() == name) + return true; + } + return false; +} + +/*! \internal + + Returns the rect the visual representation of this item is clipped to. This depends on the + current setting of \ref setClipToAxisRect as well as the axis rect set with \ref setClipAxisRect. + + If the item is not clipped to an axis rect, the \ref QCustomPlot::viewport rect is returned. + + \see draw +*/ +QRect QCPAbstractItem::clipRect() const +{ + if (mClipToAxisRect && mClipAxisRect) + return mClipAxisRect.data()->rect(); + else + return mParentPlot->viewport(); +} + +/*! \internal + + A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter + before drawing item lines. + + This is the antialiasing state the painter passed to the \ref draw method is in by default. + + This function takes into account the local setting of the antialiasing flag as well as the + overrides set with \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. + + \see setAntialiased +*/ +void QCPAbstractItem::applyDefaultAntialiasingHint(QCPPainter *painter) const +{ + applyAntialiasingHint(painter, mAntialiased, QCP::aeItems); +} + +/*! \internal + + Finds the shortest squared distance of \a point to the line segment defined by \a start and \a + end. + + This function may be used to help with the implementation of the \ref selectTest function for + specific items. + + \note This function is identical to QCPAbstractPlottable::distSqrToLine + + \see rectSelectTest +*/ +double QCPAbstractItem::distSqrToLine(const QPointF &start, const QPointF &end, const QPointF &point) const +{ + QVector2D a(start); + QVector2D b(end); + QVector2D p(point); + QVector2D v(b-a); + + double vLengthSqr = v.lengthSquared(); + if (!qFuzzyIsNull(vLengthSqr)) + { + double mu = QVector2D::dotProduct(p-a, v)/vLengthSqr; + if (mu < 0) + return (a-p).lengthSquared(); + else if (mu > 1) + return (b-p).lengthSquared(); + else + return ((a + mu*v)-p).lengthSquared(); + } else + return (a-p).lengthSquared(); +} + +/*! \internal + + A convenience function which returns the selectTest value for a specified \a rect and a specified + click position \a pos. \a filledRect defines whether a click inside the rect should also be + considered a hit or whether only the rect border is sensitive to hits. + + This function may be used to help with the implementation of the \ref selectTest function for + specific items. + + For example, if your item consists of four rects, call this function four times, once for each + rect, in your \ref selectTest reimplementation. Finally, return the minimum of all four returned + values. + + \see distSqrToLine +*/ +double QCPAbstractItem::rectSelectTest(const QRectF &rect, const QPointF &pos, bool filledRect) const +{ + double result = -1; + + // distance to border: + QList lines; + lines << QLineF(rect.topLeft(), rect.topRight()) << QLineF(rect.bottomLeft(), rect.bottomRight()) + << QLineF(rect.topLeft(), rect.bottomLeft()) << QLineF(rect.topRight(), rect.bottomRight()); + double minDistSqr = std::numeric_limits::max(); + for (int i=0; i mParentPlot->selectionTolerance()*0.99) + { + if (rect.contains(pos)) + result = mParentPlot->selectionTolerance()*0.99; + } + return result; +} + +/*! \internal + + Returns the pixel position of the anchor with Id \a anchorId. This function must be reimplemented in + item subclasses if they want to provide anchors (QCPItemAnchor). + + For example, if the item has two anchors with id 0 and 1, this function takes one of these anchor + ids and returns the respective pixel points of the specified anchor. + + \see createAnchor +*/ +QPointF QCPAbstractItem::anchorPixelPoint(int anchorId) const +{ + qDebug() << Q_FUNC_INFO << "called on item which shouldn't have any anchors (this method not reimplemented). anchorId" << anchorId; + return QPointF(); +} + +/*! \internal + + Creates a QCPItemPosition, registers it with this item and returns a pointer to it. The specified + \a name must be a unique string that is usually identical to the variable name of the position + member (This is needed to provide the name-based \ref position access to positions). + + Don't delete positions created by this function manually, as the item will take care of it. + + Use this function in the constructor (initialization list) of the specific item subclass to + create each position member. Don't create QCPItemPositions with \b new yourself, because they + won't be registered with the item properly. + + \see createAnchor +*/ +QCPItemPosition *QCPAbstractItem::createPosition(const QString &name) +{ + if (hasAnchor(name)) + qDebug() << Q_FUNC_INFO << "anchor/position with name exists already:" << name; + QCPItemPosition *newPosition = new QCPItemPosition(mParentPlot, this, name); + mPositions.append(newPosition); + mAnchors.append(newPosition); // every position is also an anchor + newPosition->setAxes(mParentPlot->xAxis, mParentPlot->yAxis); + newPosition->setType(QCPItemPosition::ptPlotCoords); + if (mParentPlot->axisRect()) + newPosition->setAxisRect(mParentPlot->axisRect()); + newPosition->setCoords(0, 0); + return newPosition; +} + +/*! \internal + + Creates a QCPItemAnchor, registers it with this item and returns a pointer to it. The specified + \a name must be a unique string that is usually identical to the variable name of the anchor + member (This is needed to provide the name based \ref anchor access to anchors). + + The \a anchorId must be a number identifying the created anchor. It is recommended to create an + enum (e.g. "AnchorIndex") for this on each item that uses anchors. This id is used by the anchor + to identify itself when it calls QCPAbstractItem::anchorPixelPoint. That function then returns + the correct pixel coordinates for the passed anchor id. + + Don't delete anchors created by this function manually, as the item will take care of it. + + Use this function in the constructor (initialization list) of the specific item subclass to + create each anchor member. Don't create QCPItemAnchors with \b new yourself, because then they + won't be registered with the item properly. + + \see createPosition +*/ +QCPItemAnchor *QCPAbstractItem::createAnchor(const QString &name, int anchorId) +{ + if (hasAnchor(name)) + qDebug() << Q_FUNC_INFO << "anchor/position with name exists already:" << name; + QCPItemAnchor *newAnchor = new QCPItemAnchor(mParentPlot, this, name, anchorId); + mAnchors.append(newAnchor); + return newAnchor; +} + +/* inherits documentation from base class */ +void QCPAbstractItem::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) +{ + Q_UNUSED(event) + Q_UNUSED(details) + if (mSelectable) + { + bool selBefore = mSelected; + setSelected(additive ? !mSelected : true); + if (selectionStateChanged) + *selectionStateChanged = mSelected != selBefore; + } +} + +/* inherits documentation from base class */ +void QCPAbstractItem::deselectEvent(bool *selectionStateChanged) +{ + if (mSelectable) + { + bool selBefore = mSelected; + setSelected(false); + if (selectionStateChanged) + *selectionStateChanged = mSelected != selBefore; + } +} + +/* inherits documentation from base class */ +QCP::Interaction QCPAbstractItem::selectionCategory() const +{ + return QCP::iSelectItems; +} + + +/*! \file */ + + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCustomPlot +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCustomPlot + + \brief The central class of the library. This is the QWidget which displays the plot and + interacts with the user. + + For tutorials on how to use QCustomPlot, see the website\n + http://www.qcustomplot.com/ +*/ + +/* start of documentation of inline functions */ + +/*! \fn QRect QCustomPlot::viewport() const + + Returns the viewport rect of this QCustomPlot instance. The viewport is the area the plot is + drawn in, all mechanisms, e.g. margin caluclation take the viewport to be the outer border of the + plot. The viewport normally is the rect() of the QCustomPlot widget, i.e. a rect with top left + (0, 0) and size of the QCustomPlot widget. + + Don't confuse the viewport with the axis rect (QCustomPlot::axisRect). An axis rect is typically + an area enclosed by four axes, where the graphs/plottables are drawn in. The viewport is larger + and contains also the axes themselves, their tick numbers, their labels, the plot title etc. + + Only when saving to a file (see \ref savePng, \ref savePdf etc.) the viewport is temporarily + modified to allow saving plots with sizes independent of the current widget size. +*/ + +/*! \fn QCPLayoutGrid *QCustomPlot::plotLayout() const + + Returns the top level layout of this QCustomPlot instance. It is a \ref QCPLayoutGrid, initially containing just + one cell with the main QCPAxisRect inside. +*/ + +/* end of documentation of inline functions */ +/* start of documentation of signals */ + +/*! \fn void QCustomPlot::mouseDoubleClick(QMouseEvent *event) + + This signal is emitted when the QCustomPlot receives a mouse double click event. +*/ + +/*! \fn void QCustomPlot::mousePress(QMouseEvent *event) + + This signal is emitted when the QCustomPlot receives a mouse press event. + + It is emitted before QCustomPlot handles any other mechanism like range dragging. So a slot + connected to this signal can still influence the behaviour e.g. with \ref QCPAxisRect::setRangeDrag or \ref + QCPAxisRect::setRangeDragAxes. +*/ + +/*! \fn void QCustomPlot::mouseMove(QMouseEvent *event) + + This signal is emitted when the QCustomPlot receives a mouse move event. + + It is emitted before QCustomPlot handles any other mechanism like range dragging. So a slot + connected to this signal can still influence the behaviour e.g. with \ref QCPAxisRect::setRangeDrag or \ref + QCPAxisRect::setRangeDragAxes. + + \warning It is discouraged to change the drag-axes with \ref QCPAxisRect::setRangeDragAxes here, + because the dragging starting point was saved the moment the mouse was pressed. Thus it only has + a meaning for the range drag axes that were set at that moment. If you want to change the drag + axes, consider doing this in the \ref mousePress signal instead. +*/ + +/*! \fn void QCustomPlot::mouseRelease(QMouseEvent *event) + + This signal is emitted when the QCustomPlot receives a mouse release event. + + It is emitted before QCustomPlot handles any other mechanisms like object selection. So a + slot connected to this signal can still influence the behaviour e.g. with \ref setInteractions or + \ref QCPAbstractPlottable::setSelectable. +*/ + +/*! \fn void QCustomPlot::mouseWheel(QMouseEvent *event) + + This signal is emitted when the QCustomPlot receives a mouse wheel event. + + It is emitted before QCustomPlot handles any other mechanisms like range zooming. So a slot + connected to this signal can still influence the behaviour e.g. with \ref QCPAxisRect::setRangeZoom, \ref + QCPAxisRect::setRangeZoomAxes or \ref QCPAxisRect::setRangeZoomFactor. +*/ + +/*! \fn void QCustomPlot::plottableClick(QCPAbstractPlottable *plottable, QMouseEvent *event) + + This signal is emitted when a plottable is clicked. + + \a event is the mouse event that caused the click and \a plottable is the plottable that received + the click. + + \see plottableDoubleClick +*/ + +/*! \fn void QCustomPlot::plottableDoubleClick(QCPAbstractPlottable *plottable, QMouseEvent *event) + + This signal is emitted when a plottable is double clicked. + + \a event is the mouse event that caused the click and \a plottable is the plottable that received + the click. + + \see plottableClick +*/ + +/*! \fn void QCustomPlot::itemClick(QCPAbstractItem *item, QMouseEvent *event) + + This signal is emitted when an item is clicked. + + \a event is the mouse event that caused the click and \a item is the item that received the + click. + + \see itemDoubleClick +*/ + +/*! \fn void QCustomPlot::itemDoubleClick(QCPAbstractItem *item, QMouseEvent *event) + + This signal is emitted when an item is double clicked. + + \a event is the mouse event that caused the click and \a item is the item that received the + click. + + \see itemClick +*/ + +/*! \fn void QCustomPlot::axisClick(QCPAxis *axis, QCPAxis::SelectablePart part, QMouseEvent *event) + + This signal is emitted when an axis is clicked. + + \a event is the mouse event that caused the click, \a axis is the axis that received the click and + \a part indicates the part of the axis that was clicked. + + \see axisDoubleClick +*/ + +/*! \fn void QCustomPlot::axisDoubleClick(QCPAxis *axis, QCPAxis::SelectablePart part, QMouseEvent *event) + + This signal is emitted when an axis is double clicked. + + \a event is the mouse event that caused the click, \a axis is the axis that received the click and + \a part indicates the part of the axis that was clicked. + + \see axisClick +*/ + +/*! \fn void QCustomPlot::legendClick(QCPLegend *legend, QCPAbstractLegendItem *item, QMouseEvent *event) + + This signal is emitted when a legend (item) is clicked. + + \a event is the mouse event that caused the click, \a legend is the legend that received the + click and \a item is the legend item that received the click. If only the legend and no item is + clicked, \a item is 0. This happens for a click inside the legend padding or the space between + two items. + + \see legendDoubleClick +*/ + +/*! \fn void QCustomPlot::legendDoubleClick(QCPLegend *legend, QCPAbstractLegendItem *item, QMouseEvent *event) + + This signal is emitted when a legend (item) is double clicked. + + \a event is the mouse event that caused the click, \a legend is the legend that received the + click and \a item is the legend item that received the click. If only the legend and no item is + clicked, \a item is 0. This happens for a click inside the legend padding or the space between + two items. + + \see legendClick +*/ + +/*! \fn void QCustomPlot:: titleClick(QMouseEvent *event, QCPPlotTitle *title) + + This signal is emitted when a plot title is clicked. + + \a event is the mouse event that caused the click and \a title is the plot title that received + the click. + + \see titleDoubleClick +*/ + +/*! \fn void QCustomPlot::titleDoubleClick(QMouseEvent *event, QCPPlotTitle *title) + + This signal is emitted when a plot title is double clicked. + + \a event is the mouse event that caused the click and \a title is the plot title that received + the click. + + \see titleClick +*/ + +/*! \fn void QCustomPlot::selectionChangedByUser() + + This signal is emitted after the user has changed the selection in the QCustomPlot, e.g. by + clicking. It is not emitted when the selection state of an object has changed programmatically by + a direct call to setSelected() on an object or by calling \ref deselectAll. + + In addition to this signal, selectable objects also provide individual signals, for example + QCPAxis::selectionChanged or QCPAbstractPlottable::selectionChanged. Note that those signals are + emitted even if the selection state is changed programmatically. + + See the documentation of \ref setInteractions for details about the selection mechanism. + + \see selectedPlottables, selectedGraphs, selectedItems, selectedAxes, selectedLegends +*/ + +/*! \fn void QCustomPlot::beforeReplot() + + This signal is emitted immediately before a replot takes place (caused by a call to the slot \ref + replot). + + It is safe to mutually connect the replot slot with this signal on two QCustomPlots to make them + replot synchronously, it won't cause an infinite recursion. + + \see replot, afterReplot +*/ + +/*! \fn void QCustomPlot::afterReplot() + + This signal is emitted immediately after a replot has taken place (caused by a call to the slot \ref + replot). + + It is safe to mutually connect the replot slot with this signal on two QCustomPlots to make them + replot synchronously, it won't cause an infinite recursion. + + \see replot, beforeReplot +*/ + +/* end of documentation of signals */ +/* start of documentation of public members */ + +/*! \var QCPAxis *QCustomPlot::xAxis + + A pointer to the primary x Axis (bottom) of the main axis rect of the plot. + + QCustomPlot offers convenient pointers to the axes (\ref xAxis, \ref yAxis, \ref xAxis2, \ref + yAxis2) and the \ref legend. They make it very easy working with plots that only have a single + axis rect and at most one axis at each axis rect side. If you use \link thelayoutsystem the + layout system\endlink to add multiple axis rects or multiple axes to one side, use the \ref + QCPAxisRect::axis interface to access the new axes. If one of the four default axes or the + default legend is removed due to manipulation of the layout system (e.g. by removing the main + axis rect), the corresponding pointers become 0. +*/ + +/*! \var QCPAxis *QCustomPlot::yAxis + + A pointer to the primary y Axis (left) of the main axis rect of the plot. + + QCustomPlot offers convenient pointers to the axes (\ref xAxis, \ref yAxis, \ref xAxis2, \ref + yAxis2) and the \ref legend. They make it very easy working with plots that only have a single + axis rect and at most one axis at each axis rect side. If you use \link thelayoutsystem the + layout system\endlink to add multiple axis rects or multiple axes to one side, use the \ref + QCPAxisRect::axis interface to access the new axes. If one of the four default axes or the + default legend is removed due to manipulation of the layout system (e.g. by removing the main + axis rect), the corresponding pointers become 0. +*/ + +/*! \var QCPAxis *QCustomPlot::xAxis2 + + A pointer to the secondary x Axis (top) of the main axis rect of the plot. Secondary axes are + invisible by default. Use QCPAxis::setVisible to change this (or use \ref + QCPAxisRect::setupFullAxesBox). + + QCustomPlot offers convenient pointers to the axes (\ref xAxis, \ref yAxis, \ref xAxis2, \ref + yAxis2) and the \ref legend. They make it very easy working with plots that only have a single + axis rect and at most one axis at each axis rect side. If you use \link thelayoutsystem the + layout system\endlink to add multiple axis rects or multiple axes to one side, use the \ref + QCPAxisRect::axis interface to access the new axes. If one of the four default axes or the + default legend is removed due to manipulation of the layout system (e.g. by removing the main + axis rect), the corresponding pointers become 0. +*/ + +/*! \var QCPAxis *QCustomPlot::yAxis2 + + A pointer to the secondary y Axis (right) of the main axis rect of the plot. Secondary axes are + invisible by default. Use QCPAxis::setVisible to change this (or use \ref + QCPAxisRect::setupFullAxesBox). + + QCustomPlot offers convenient pointers to the axes (\ref xAxis, \ref yAxis, \ref xAxis2, \ref + yAxis2) and the \ref legend. They make it very easy working with plots that only have a single + axis rect and at most one axis at each axis rect side. If you use \link thelayoutsystem the + layout system\endlink to add multiple axis rects or multiple axes to one side, use the \ref + QCPAxisRect::axis interface to access the new axes. If one of the four default axes or the + default legend is removed due to manipulation of the layout system (e.g. by removing the main + axis rect), the corresponding pointers become 0. +*/ + +/*! \var QCPLegend *QCustomPlot::legend + + A pointer to the default legend of the main axis rect. The legend is invisible by default. Use + QCPLegend::setVisible to change this. + + QCustomPlot offers convenient pointers to the axes (\ref xAxis, \ref yAxis, \ref xAxis2, \ref + yAxis2) and the \ref legend. They make it very easy working with plots that only have a single + axis rect and at most one axis at each axis rect side. If you use \link thelayoutsystem the + layout system\endlink to add multiple legends to the plot, use the layout system interface to + access the new legend. For example, legends can be placed inside an axis rect's \ref + QCPAxisRect::insetLayout "inset layout", and must then also be accessed via the inset layout. If + the default legend is removed due to manipulation of the layout system (e.g. by removing the main + axis rect), the corresponding pointer becomes 0. +*/ + +/* end of documentation of public members */ + +/*! + Constructs a QCustomPlot and sets reasonable default values. +*/ +QCustomPlot::QCustomPlot(QWidget *parent) : + QWidget(parent), + xAxis(0), + yAxis(0), + xAxis2(0), + yAxis2(0), + legend(0), + mPlotLayout(0), + mAutoAddPlottableToLegend(true), + mAntialiasedElements(QCP::aeNone), + mNotAntialiasedElements(QCP::aeNone), + mInteractions(0), + mSelectionTolerance(8), + mNoAntialiasingOnDrag(false), + mBackgroundBrush(Qt::white, Qt::SolidPattern), + mBackgroundScaled(true), + mBackgroundScaledMode(Qt::KeepAspectRatioByExpanding), + mCurrentLayer(0), + mPlottingHints(QCP::phCacheLabels|QCP::phForceRepaint), + mMultiSelectModifier(Qt::ControlModifier), + mPaintBuffer(size()), + mMouseEventElement(0), + mReplotting(false) +{ + setAttribute(Qt::WA_NoMousePropagation); + setAttribute(Qt::WA_OpaquePaintEvent); + setMouseTracking(true); + QLocale currentLocale = locale(); + currentLocale.setNumberOptions(QLocale::OmitGroupSeparator); + setLocale(currentLocale); + + // create initial layers: + 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"))); + updateLayerIndices(); + setCurrentLayer(QLatin1String("main")); + + // create initial layout, axis rect and legend: + mPlotLayout = new QCPLayoutGrid; + mPlotLayout->initializeParentPlot(this); + mPlotLayout->setParent(this); // important because if parent is QWidget, QCPLayout::sizeConstraintsChanged will call QWidget::updateGeometry + mPlotLayout->setLayer(QLatin1String("main")); + QCPAxisRect *defaultAxisRect = new QCPAxisRect(this, true); + mPlotLayout->addElement(0, 0, defaultAxisRect); + xAxis = defaultAxisRect->axis(QCPAxis::atBottom); + yAxis = defaultAxisRect->axis(QCPAxis::atLeft); + xAxis2 = defaultAxisRect->axis(QCPAxis::atTop); + yAxis2 = defaultAxisRect->axis(QCPAxis::atRight); + legend = new QCPLegend; + legend->setVisible(false); + defaultAxisRect->insetLayout()->addElement(legend, Qt::AlignRight|Qt::AlignTop); + defaultAxisRect->insetLayout()->setMargins(QMargins(12, 12, 12, 12)); + + defaultAxisRect->setLayer(QLatin1String("background")); + xAxis->setLayer(QLatin1String("axes")); + yAxis->setLayer(QLatin1String("axes")); + xAxis2->setLayer(QLatin1String("axes")); + yAxis2->setLayer(QLatin1String("axes")); + xAxis->grid()->setLayer(QLatin1String("grid")); + yAxis->grid()->setLayer(QLatin1String("grid")); + xAxis2->grid()->setLayer(QLatin1String("grid")); + yAxis2->grid()->setLayer(QLatin1String("grid")); + legend->setLayer(QLatin1String("legend")); + + setViewport(rect()); // needs to be called after mPlotLayout has been created + + replot(); +} + +QCustomPlot::~QCustomPlot() +{ + clearPlottables(); + clearItems(); + + if (mPlotLayout) + { + delete mPlotLayout; + mPlotLayout = 0; + } + + mCurrentLayer = 0; + qDeleteAll(mLayers); // don't use removeLayer, because it would prevent the last layer to be removed + mLayers.clear(); +} + +/*! + Sets which elements are forcibly drawn antialiased as an \a or combination of QCP::AntialiasedElement. + + This overrides the antialiasing settings for whole element groups, normally controlled with the + \a setAntialiasing function on the individual elements. If an element is neither specified in + \ref setAntialiasedElements nor in \ref setNotAntialiasedElements, the antialiasing setting on + each individual element instance is used. + + For example, if \a antialiasedElements contains \ref QCP::aePlottables, all plottables will be + drawn antialiased, no matter what the specific QCPAbstractPlottable::setAntialiased value was set + to. + + if an element in \a antialiasedElements is already set in \ref setNotAntialiasedElements, it is + removed from there. + + \see setNotAntialiasedElements +*/ +void QCustomPlot::setAntialiasedElements(const QCP::AntialiasedElements &antialiasedElements) +{ + mAntialiasedElements = antialiasedElements; + + // make sure elements aren't in mNotAntialiasedElements and mAntialiasedElements simultaneously: + if ((mNotAntialiasedElements & mAntialiasedElements) != 0) + mNotAntialiasedElements |= ~mAntialiasedElements; +} + +/*! + Sets whether the specified \a antialiasedElement is forcibly drawn antialiased. + + See \ref setAntialiasedElements for details. + + \see setNotAntialiasedElement +*/ +void QCustomPlot::setAntialiasedElement(QCP::AntialiasedElement antialiasedElement, bool enabled) +{ + if (!enabled && mAntialiasedElements.testFlag(antialiasedElement)) + mAntialiasedElements &= ~antialiasedElement; + else if (enabled && !mAntialiasedElements.testFlag(antialiasedElement)) + mAntialiasedElements |= antialiasedElement; + + // make sure elements aren't in mNotAntialiasedElements and mAntialiasedElements simultaneously: + if ((mNotAntialiasedElements & mAntialiasedElements) != 0) + mNotAntialiasedElements |= ~mAntialiasedElements; +} + +/*! + Sets which elements are forcibly drawn not antialiased as an \a or combination of + QCP::AntialiasedElement. + + This overrides the antialiasing settings for whole element groups, normally controlled with the + \a setAntialiasing function on the individual elements. If an element is neither specified in + \ref setAntialiasedElements nor in \ref setNotAntialiasedElements, the antialiasing setting on + each individual element instance is used. + + For example, if \a notAntialiasedElements contains \ref QCP::aePlottables, no plottables will be + drawn antialiased, no matter what the specific QCPAbstractPlottable::setAntialiased value was set + to. + + if an element in \a notAntialiasedElements is already set in \ref setAntialiasedElements, it is + removed from there. + + \see setAntialiasedElements +*/ +void QCustomPlot::setNotAntialiasedElements(const QCP::AntialiasedElements ¬AntialiasedElements) +{ + mNotAntialiasedElements = notAntialiasedElements; + + // make sure elements aren't in mNotAntialiasedElements and mAntialiasedElements simultaneously: + if ((mNotAntialiasedElements & mAntialiasedElements) != 0) + mAntialiasedElements |= ~mNotAntialiasedElements; +} + +/*! + Sets whether the specified \a notAntialiasedElement is forcibly drawn not antialiased. + + See \ref setNotAntialiasedElements for details. + + \see setAntialiasedElement +*/ +void QCustomPlot::setNotAntialiasedElement(QCP::AntialiasedElement notAntialiasedElement, bool enabled) +{ + if (!enabled && mNotAntialiasedElements.testFlag(notAntialiasedElement)) + mNotAntialiasedElements &= ~notAntialiasedElement; + else if (enabled && !mNotAntialiasedElements.testFlag(notAntialiasedElement)) + mNotAntialiasedElements |= notAntialiasedElement; + + // make sure elements aren't in mNotAntialiasedElements and mAntialiasedElements simultaneously: + if ((mNotAntialiasedElements & mAntialiasedElements) != 0) + mAntialiasedElements |= ~mNotAntialiasedElements; +} + +/*! + If set to true, adding a plottable (e.g. a graph) to the QCustomPlot automatically also adds the + plottable to the legend (QCustomPlot::legend). + + \see addPlottable, addGraph, QCPLegend::addItem +*/ +void QCustomPlot::setAutoAddPlottableToLegend(bool on) +{ + mAutoAddPlottableToLegend = on; +} + +/*! + Sets the possible interactions of this QCustomPlot as an or-combination of \ref QCP::Interaction + enums. There are the following types of interactions: + + Axis range manipulation is controlled via \ref QCP::iRangeDrag and \ref QCP::iRangeZoom. When the + respective interaction is enabled, the user may drag axes ranges and zoom with the mouse wheel. + For details how to control which axes the user may drag/zoom and in what orientations, see \ref + QCPAxisRect::setRangeDrag, \ref QCPAxisRect::setRangeZoom, \ref QCPAxisRect::setRangeDragAxes, + \ref QCPAxisRect::setRangeZoomAxes. + + Plottable selection is controlled by \ref QCP::iSelectPlottables. If \ref QCP::iSelectPlottables is + set, the user may select plottables (graphs, curves, bars,...) by clicking on them or in their + vicinity (\ref setSelectionTolerance). Whether the user can actually select a plottable can + further be restricted with the \ref QCPAbstractPlottable::setSelectable function on the specific + plottable. To find out whether a specific plottable is selected, call + QCPAbstractPlottable::selected(). To retrieve a list of all currently selected plottables, call + \ref selectedPlottables. If you're only interested in QCPGraphs, you may use the convenience + function \ref selectedGraphs. + + Item selection is controlled by \ref QCP::iSelectItems. If \ref QCP::iSelectItems is set, the user + may select items (QCPItemLine, QCPItemText,...) by clicking on them or in their vicinity. To find + out whether a specific item is selected, call QCPAbstractItem::selected(). To retrieve a list of + all currently selected items, call \ref selectedItems. + + Axis selection is controlled with \ref QCP::iSelectAxes. If \ref QCP::iSelectAxes is set, the user + may select parts of the axes by clicking on them. What parts exactly (e.g. Axis base line, tick + labels, axis label) are selectable can be controlled via \ref QCPAxis::setSelectableParts for + each axis. To retrieve a list of all axes that currently contain selected parts, call \ref + selectedAxes. Which parts of an axis are selected, can be retrieved with QCPAxis::selectedParts(). + + Legend selection is controlled with \ref QCP::iSelectLegend. If this is set, the user may + select the legend itself or individual items by clicking on them. What parts exactly are + selectable can be controlled via \ref QCPLegend::setSelectableParts. To find out whether the + legend or any of its child items are selected, check the value of QCPLegend::selectedParts. To + find out which child items are selected, call \ref QCPLegend::selectedItems. + + All other selectable elements The selection of all other selectable objects (e.g. + QCPPlotTitle, or your own layerable subclasses) is controlled with \ref QCP::iSelectOther. If set, the + user may select those objects by clicking on them. To find out which are currently selected, you + need to check their selected state explicitly. + + If the selection state has changed by user interaction, the \ref selectionChangedByUser signal is + emitted. Each selectable object additionally emits an individual selectionChanged signal whenever + their selection state has changed, i.e. not only by user interaction. + + To allow multiple objects to be selected by holding the selection modifier (\ref + setMultiSelectModifier), set the flag \ref QCP::iMultiSelect. + + \note In addition to the selection mechanism presented here, QCustomPlot always emits + corresponding signals, when an object is clicked or double clicked. see \ref plottableClick and + \ref plottableDoubleClick for example. + + \see setInteraction, setSelectionTolerance +*/ +void QCustomPlot::setInteractions(const QCP::Interactions &interactions) +{ + mInteractions = interactions; +} + +/*! + Sets the single \a interaction of this QCustomPlot to \a enabled. + + For details about the interaction system, see \ref setInteractions. + + \see setInteractions +*/ +void QCustomPlot::setInteraction(const QCP::Interaction &interaction, bool enabled) +{ + if (!enabled && mInteractions.testFlag(interaction)) + mInteractions &= ~interaction; + else if (enabled && !mInteractions.testFlag(interaction)) + mInteractions |= interaction; +} + +/*! + Sets the tolerance that is used to decide whether a click selects an object (e.g. a plottable) or + not. + + If the user clicks in the vicinity of the line of e.g. a QCPGraph, it's only regarded as a + potential selection when the minimum distance between the click position and the graph line is + smaller than \a pixels. Objects that are defined by an area (e.g. QCPBars) only react to clicks + directly inside the area and ignore this selection tolerance. In other words, it only has meaning + for parts of objects that are too thin to exactly hit with a click and thus need such a + tolerance. + + \see setInteractions, QCPLayerable::selectTest +*/ +void QCustomPlot::setSelectionTolerance(int pixels) +{ + mSelectionTolerance = pixels; +} + +/*! + Sets whether antialiasing is disabled for this QCustomPlot while the user is dragging axes + ranges. If many objects, especially plottables, are drawn antialiased, this greatly improves + performance during dragging. Thus it creates a more responsive user experience. As soon as the + user stops dragging, the last replot is done with normal antialiasing, to restore high image + quality. + + \see setAntialiasedElements, setNotAntialiasedElements +*/ +void QCustomPlot::setNoAntialiasingOnDrag(bool enabled) +{ + mNoAntialiasingOnDrag = enabled; +} + +/*! + Sets the plotting hints for this QCustomPlot instance as an \a or combination of QCP::PlottingHint. + + \see setPlottingHint +*/ +void QCustomPlot::setPlottingHints(const QCP::PlottingHints &hints) +{ + mPlottingHints = hints; +} + +/*! + Sets the specified plotting \a hint to \a enabled. + + \see setPlottingHints +*/ +void QCustomPlot::setPlottingHint(QCP::PlottingHint hint, bool enabled) +{ + QCP::PlottingHints newHints = mPlottingHints; + if (!enabled) + newHints &= ~hint; + else + newHints |= hint; + + if (newHints != mPlottingHints) + setPlottingHints(newHints); +} + +/*! + Sets the keyboard modifier that will be recognized as multi-select-modifier. + + If \ref QCP::iMultiSelect is specified in \ref setInteractions, the user may select multiple objects + by clicking on them one after the other while holding down \a modifier. + + By default the multi-select-modifier is set to Qt::ControlModifier. + + \see setInteractions +*/ +void QCustomPlot::setMultiSelectModifier(Qt::KeyboardModifier modifier) +{ + mMultiSelectModifier = modifier; +} + +/*! + Sets the viewport of this QCustomPlot. The Viewport is the area that the top level layout + (QCustomPlot::plotLayout()) uses as its rect. Normally, the viewport is the entire widget rect. + + This function is used to allow arbitrary size exports with \ref toPixmap, \ref savePng, \ref + savePdf, etc. by temporarily changing the viewport size. +*/ +void QCustomPlot::setViewport(const QRect &rect) +{ + mViewport = rect; + if (mPlotLayout) + mPlotLayout->setOuterRect(mViewport); +} + +/*! + Sets \a pm as the viewport background pixmap (see \ref setViewport). The pixmap is always drawn + below all other objects in the plot. + + For cases where the provided pixmap doesn't have the same size as the viewport, scaling can be + enabled with \ref setBackgroundScaled and the scaling mode (whether and how the aspect ratio is + preserved) can be set with \ref setBackgroundScaledMode. To set all these options in one call, + consider using the overloaded version of this function. + + If a background brush was set with \ref setBackground(const QBrush &brush), the viewport will + first be filled with that brush, before drawing the background pixmap. This can be useful for + background pixmaps with translucent areas. + + \see setBackgroundScaled, setBackgroundScaledMode +*/ +void QCustomPlot::setBackground(const QPixmap &pm) +{ + mBackgroundPixmap = pm; + mScaledBackgroundPixmap = QPixmap(); +} + +/*! + Sets the background brush of the viewport (see \ref setViewport). + + Before drawing everything else, the background is filled with \a brush. If a background pixmap + was set with \ref setBackground(const QPixmap &pm), this brush will be used to fill the viewport + before the background pixmap is drawn. This can be useful for background pixmaps with translucent + areas. + + Set \a brush to Qt::NoBrush or Qt::Transparent to leave background transparent. This can be + useful for exporting to image formats which support transparency, e.g. \ref savePng. + + \see setBackgroundScaled, setBackgroundScaledMode +*/ +void QCustomPlot::setBackground(const QBrush &brush) +{ + mBackgroundBrush = brush; +} + +/*! \overload + + Allows setting the background pixmap of the viewport, whether it shall be scaled and how it + shall be scaled in one call. + + \see setBackground(const QPixmap &pm), setBackgroundScaled, setBackgroundScaledMode +*/ +void QCustomPlot::setBackground(const QPixmap &pm, bool scaled, Qt::AspectRatioMode mode) +{ + mBackgroundPixmap = pm; + mScaledBackgroundPixmap = QPixmap(); + mBackgroundScaled = scaled; + mBackgroundScaledMode = mode; +} + +/*! + Sets whether the viewport background pixmap shall be scaled to fit the viewport. If \a scaled is + set to true, control whether and how the aspect ratio of the original pixmap is preserved with + \ref setBackgroundScaledMode. + + Note that the scaled version of the original pixmap is buffered, so there is no performance + penalty on replots. (Except when the viewport dimensions are changed continuously.) + + \see setBackground, setBackgroundScaledMode +*/ +void QCustomPlot::setBackgroundScaled(bool scaled) +{ + mBackgroundScaled = scaled; +} + +/*! + If scaling of the viewport background pixmap is enabled (\ref setBackgroundScaled), use this + function to define whether and how the aspect ratio of the original pixmap is preserved. + + \see setBackground, setBackgroundScaled +*/ +void QCustomPlot::setBackgroundScaledMode(Qt::AspectRatioMode mode) +{ + mBackgroundScaledMode = mode; +} + +/*! + Returns the plottable with \a index. If the index is invalid, returns 0. + + There is an overloaded version of this function with no parameter which returns the last added + plottable, see QCustomPlot::plottable() + + \see plottableCount, addPlottable +*/ +QCPAbstractPlottable *QCustomPlot::plottable(int index) +{ + if (index >= 0 && index < mPlottables.size()) + { + return mPlottables.at(index); + } else + { + qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; + return 0; + } +} + +/*! \overload + + Returns the last plottable that was added with \ref addPlottable. If there are no plottables in + the plot, returns 0. + + \see plottableCount, addPlottable +*/ +QCPAbstractPlottable *QCustomPlot::plottable() +{ + if (!mPlottables.isEmpty()) + { + return mPlottables.last(); + } else + return 0; +} + +/*! + Adds the specified plottable to the plot and, if \ref setAutoAddPlottableToLegend is enabled, to + the legend (QCustomPlot::legend). QCustomPlot takes ownership of the plottable. + + Returns true on success, i.e. when \a plottable isn't already in the plot and the parent plot of + \a plottable is this QCustomPlot (the latter is controlled by what axes were passed in the + plottable's constructor). + + \see plottable, plottableCount, removePlottable, clearPlottables +*/ +bool QCustomPlot::addPlottable(QCPAbstractPlottable *plottable) +{ + if (mPlottables.contains(plottable)) + { + qDebug() << Q_FUNC_INFO << "plottable already added to this QCustomPlot:" << reinterpret_cast(plottable); + return false; + } + if (plottable->parentPlot() != this) + { + qDebug() << Q_FUNC_INFO << "plottable not created with this QCustomPlot as parent:" << reinterpret_cast(plottable); + return false; + } + + mPlottables.append(plottable); + // possibly add plottable to legend: + if (mAutoAddPlottableToLegend) + plottable->addToLegend(); + // special handling for QCPGraphs to maintain the simple graph interface: + if (QCPGraph *graph = qobject_cast(plottable)) + mGraphs.append(graph); + if (!plottable->layer()) // usually the layer is already set in the constructor of the plottable (via QCPLayerable constructor) + plottable->setLayer(currentLayer()); + return true; +} + +/*! + Removes the specified plottable from the plot and, if necessary, from the legend (QCustomPlot::legend). + + Returns true on success. + + \see addPlottable, clearPlottables +*/ +bool QCustomPlot::removePlottable(QCPAbstractPlottable *plottable) +{ + if (!mPlottables.contains(plottable)) + { + qDebug() << Q_FUNC_INFO << "plottable not in list:" << reinterpret_cast(plottable); + return false; + } + + // remove plottable from legend: + plottable->removeFromLegend(); + // special handling for QCPGraphs to maintain the simple graph interface: + if (QCPGraph *graph = qobject_cast(plottable)) + mGraphs.removeOne(graph); + // remove plottable: + delete plottable; + mPlottables.removeOne(plottable); + return true; +} + +/*! \overload + + Removes the plottable by its \a index. +*/ +bool QCustomPlot::removePlottable(int index) +{ + if (index >= 0 && index < mPlottables.size()) + return removePlottable(mPlottables[index]); + else + { + qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; + return false; + } +} + +/*! + Removes all plottables from the plot (and the QCustomPlot::legend, if necessary). + + Returns the number of plottables removed. + + \see removePlottable +*/ +int QCustomPlot::clearPlottables() +{ + int c = mPlottables.size(); + for (int i=c-1; i >= 0; --i) + removePlottable(mPlottables[i]); + return c; +} + +/*! + Returns the number of currently existing plottables in the plot + + \see plottable, addPlottable +*/ +int QCustomPlot::plottableCount() const +{ + return mPlottables.size(); +} + +/*! + Returns a list of the selected plottables. If no plottables are currently selected, the list is empty. + + There is a convenience function if you're only interested in selected graphs, see \ref selectedGraphs. + + \see setInteractions, QCPAbstractPlottable::setSelectable, QCPAbstractPlottable::setSelected +*/ +QList QCustomPlot::selectedPlottables() const +{ + QList result; + foreach (QCPAbstractPlottable *plottable, mPlottables) + { + if (plottable->selected()) + result.append(plottable); + } + return result; +} + +/*! + Returns the plottable at the pixel position \a pos. Plottables that only consist of single lines + (like graphs) have a tolerance band around them, see \ref setSelectionTolerance. If multiple + plottables come into consideration, the one closest to \a pos is returned. + + If \a onlySelectable is true, only plottables that are selectable + (QCPAbstractPlottable::setSelectable) are considered. + + If there is no plottable at \a pos, the return value is 0. + + \see itemAt, layoutElementAt +*/ +QCPAbstractPlottable *QCustomPlot::plottableAt(const QPointF &pos, bool onlySelectable) const +{ + QCPAbstractPlottable *resultPlottable = 0; + double resultDistance = mSelectionTolerance; // only regard clicks with distances smaller than mSelectionTolerance as selections, so initialize with that value + + foreach (QCPAbstractPlottable *plottable, mPlottables) + { + if (onlySelectable && !plottable->selectable()) // we could have also passed onlySelectable to the selectTest function, but checking here is faster, because we have access to QCPabstractPlottable::selectable + continue; + if ((plottable->keyAxis()->axisRect()->rect() & plottable->valueAxis()->axisRect()->rect()).contains(pos.toPoint())) // only consider clicks inside the rect that is spanned by the plottable's key/value axes + { + double currentDistance = plottable->selectTest(pos, false); + if (currentDistance >= 0 && currentDistance < resultDistance) + { + resultPlottable = plottable; + resultDistance = currentDistance; + } + } + } + + return resultPlottable; +} + +/*! + Returns whether this QCustomPlot instance contains the \a plottable. + + \see addPlottable +*/ +bool QCustomPlot::hasPlottable(QCPAbstractPlottable *plottable) const +{ + return mPlottables.contains(plottable); +} + +/*! + Returns the graph with \a index. If the index is invalid, returns 0. + + There is an overloaded version of this function with no parameter which returns the last created + graph, see QCustomPlot::graph() + + \see graphCount, addGraph +*/ +QCPGraph *QCustomPlot::graph(int index) const +{ + if (index >= 0 && index < mGraphs.size()) + { + return mGraphs.at(index); + } else + { + qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; + return 0; + } +} + +/*! \overload + + Returns the last graph, that was created with \ref addGraph. If there are no graphs in the plot, + returns 0. + + \see graphCount, addGraph +*/ +QCPGraph *QCustomPlot::graph() const +{ + if (!mGraphs.isEmpty()) + { + return mGraphs.last(); + } else + return 0; +} + +/*! + Creates a new graph inside the plot. If \a keyAxis and \a valueAxis are left unspecified (0), the + bottom (xAxis) is used as key and the left (yAxis) is used as value axis. If specified, \a + keyAxis and \a valueAxis must reside in this QCustomPlot. + + \a keyAxis will be used as key axis (typically "x") and \a valueAxis as value axis (typically + "y") for the graph. + + Returns a pointer to the newly created graph, or 0 if adding the graph failed. + + \see graph, graphCount, removeGraph, clearGraphs +*/ +QCPGraph *QCustomPlot::addGraph(QCPAxis *keyAxis, QCPAxis *valueAxis) +{ + if (!keyAxis) keyAxis = xAxis; + if (!valueAxis) valueAxis = yAxis; + if (!keyAxis || !valueAxis) + { + qDebug() << Q_FUNC_INFO << "can't use default QCustomPlot xAxis or yAxis, because at least one is invalid (has been deleted)"; + return 0; + } + if (keyAxis->parentPlot() != this || valueAxis->parentPlot() != this) + { + qDebug() << Q_FUNC_INFO << "passed keyAxis or valueAxis doesn't have this QCustomPlot as parent"; + return 0; + } + + QCPGraph *newGraph = new QCPGraph(keyAxis, valueAxis); + if (addPlottable(newGraph)) + { + newGraph->setName(QLatin1String("Graph ")+QString::number(mGraphs.size())); + return newGraph; + } else + { + delete newGraph; + return 0; + } +} + +/*! + Removes the specified \a graph from the plot and, if necessary, from the QCustomPlot::legend. If + any other graphs in the plot have a channel fill set towards the removed graph, the channel fill + property of those graphs is reset to zero (no channel fill). + + Returns true on success. + + \see clearGraphs +*/ +bool QCustomPlot::removeGraph(QCPGraph *graph) +{ + return removePlottable(graph); +} + +/*! \overload + + Removes the graph by its \a index. +*/ +bool QCustomPlot::removeGraph(int index) +{ + if (index >= 0 && index < mGraphs.size()) + return removeGraph(mGraphs[index]); + else + return false; +} + +/*! + Removes all graphs from the plot (and the QCustomPlot::legend, if necessary). + + Returns the number of graphs removed. + + \see removeGraph +*/ +int QCustomPlot::clearGraphs() +{ + int c = mGraphs.size(); + for (int i=c-1; i >= 0; --i) + removeGraph(mGraphs[i]); + return c; +} + +/*! + Returns the number of currently existing graphs in the plot + + \see graph, addGraph +*/ +int QCustomPlot::graphCount() const +{ + return mGraphs.size(); +} + +/*! + Returns a list of the selected graphs. If no graphs are currently selected, the list is empty. + + If you are not only interested in selected graphs but other plottables like QCPCurve, QCPBars, + etc., use \ref selectedPlottables. + + \see setInteractions, selectedPlottables, QCPAbstractPlottable::setSelectable, QCPAbstractPlottable::setSelected +*/ +QList QCustomPlot::selectedGraphs() const +{ + QList result; + foreach (QCPGraph *graph, mGraphs) + { + if (graph->selected()) + result.append(graph); + } + return result; +} + +/*! + Returns the item with \a index. If the index is invalid, returns 0. + + There is an overloaded version of this function with no parameter which returns the last added + item, see QCustomPlot::item() + + \see itemCount, addItem +*/ +QCPAbstractItem *QCustomPlot::item(int index) const +{ + if (index >= 0 && index < mItems.size()) + { + return mItems.at(index); + } else + { + qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; + return 0; + } +} + +/*! \overload + + Returns the last item, that was added with \ref addItem. If there are no items in the plot, + returns 0. + + \see itemCount, addItem +*/ +QCPAbstractItem *QCustomPlot::item() const +{ + if (!mItems.isEmpty()) + { + return mItems.last(); + } else + return 0; +} + +/*! + Adds the specified item to the plot. QCustomPlot takes ownership of the item. + + Returns true on success, i.e. when \a item wasn't already in the plot and the parent plot of \a + item is this QCustomPlot. + + \see item, itemCount, removeItem, clearItems +*/ +bool QCustomPlot::addItem(QCPAbstractItem *item) +{ + if (!mItems.contains(item) && item->parentPlot() == this) + { + mItems.append(item); + return true; + } else + { + qDebug() << Q_FUNC_INFO << "item either already in list or not created with this QCustomPlot as parent:" << reinterpret_cast(item); + return false; + } +} + +/*! + Removes the specified item from the plot. + + Returns true on success. + + \see addItem, clearItems +*/ +bool QCustomPlot::removeItem(QCPAbstractItem *item) +{ + if (mItems.contains(item)) + { + delete item; + mItems.removeOne(item); + return true; + } else + { + qDebug() << Q_FUNC_INFO << "item not in list:" << reinterpret_cast(item); + return false; + } +} + +/*! \overload + + Removes the item by its \a index. +*/ +bool QCustomPlot::removeItem(int index) +{ + if (index >= 0 && index < mItems.size()) + return removeItem(mItems[index]); + else + { + qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; + return false; + } +} + +/*! + Removes all items from the plot. + + Returns the number of items removed. + + \see removeItem +*/ +int QCustomPlot::clearItems() +{ + int c = mItems.size(); + for (int i=c-1; i >= 0; --i) + removeItem(mItems[i]); + return c; +} + +/*! + Returns the number of currently existing items in the plot + + \see item, addItem +*/ +int QCustomPlot::itemCount() const +{ + return mItems.size(); +} + +/*! + Returns a list of the selected items. If no items are currently selected, the list is empty. + + \see setInteractions, QCPAbstractItem::setSelectable, QCPAbstractItem::setSelected +*/ +QList QCustomPlot::selectedItems() const +{ + QList result; + foreach (QCPAbstractItem *item, mItems) + { + if (item->selected()) + result.append(item); + } + return result; +} + +/*! + Returns the item at the pixel position \a pos. Items that only consist of single lines (e.g. \ref + QCPItemLine or \ref QCPItemCurve) have a tolerance band around them, see \ref + setSelectionTolerance. If multiple items come into consideration, the one closest to \a pos is + returned. + + If \a onlySelectable is true, only items that are selectable (QCPAbstractItem::setSelectable) are + considered. + + If there is no item at \a pos, the return value is 0. + + \see plottableAt, layoutElementAt +*/ +QCPAbstractItem *QCustomPlot::itemAt(const QPointF &pos, bool onlySelectable) const +{ + QCPAbstractItem *resultItem = 0; + double resultDistance = mSelectionTolerance; // only regard clicks with distances smaller than mSelectionTolerance as selections, so initialize with that value + + foreach (QCPAbstractItem *item, mItems) + { + if (onlySelectable && !item->selectable()) // we could have also passed onlySelectable to the selectTest function, but checking here is faster, because we have access to QCPAbstractItem::selectable + continue; + if (!item->clipToAxisRect() || item->clipRect().contains(pos.toPoint())) // only consider clicks inside axis cliprect of the item if actually clipped to it + { + double currentDistance = item->selectTest(pos, false); + if (currentDistance >= 0 && currentDistance < resultDistance) + { + resultItem = item; + resultDistance = currentDistance; + } + } + } + + return resultItem; +} + +/*! + Returns whether this QCustomPlot contains the \a item. + + \see addItem +*/ +bool QCustomPlot::hasItem(QCPAbstractItem *item) const +{ + return mItems.contains(item); +} + +/*! + Returns the layer with the specified \a name. If there is no layer with the specified name, 0 is + returned. + + Layer names are case-sensitive. + + \see addLayer, moveLayer, removeLayer +*/ +QCPLayer *QCustomPlot::layer(const QString &name) const +{ + foreach (QCPLayer *layer, mLayers) + { + if (layer->name() == name) + return layer; + } + return 0; +} + +/*! \overload + + Returns the layer by \a index. If the index is invalid, 0 is returned. + + \see addLayer, moveLayer, removeLayer +*/ +QCPLayer *QCustomPlot::layer(int index) const +{ + if (index >= 0 && index < mLayers.size()) + { + return mLayers.at(index); + } else + { + qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; + return 0; + } +} + +/*! + Returns the layer that is set as current layer (see \ref setCurrentLayer). +*/ +QCPLayer *QCustomPlot::currentLayer() const +{ + return mCurrentLayer; +} + +/*! + Sets the layer with the specified \a name to be the current layer. All layerables (\ref + QCPLayerable), e.g. plottables and items, are created on the current layer. + + Returns true on success, i.e. if there is a layer with the specified \a name in the QCustomPlot. + + Layer names are case-sensitive. + + \see addLayer, moveLayer, removeLayer, QCPLayerable::setLayer +*/ +bool QCustomPlot::setCurrentLayer(const QString &name) +{ + if (QCPLayer *newCurrentLayer = layer(name)) + { + return setCurrentLayer(newCurrentLayer); + } else + { + qDebug() << Q_FUNC_INFO << "layer with name doesn't exist:" << name; + return false; + } +} + +/*! \overload + + Sets the provided \a layer to be the current layer. + + Returns true on success, i.e. when \a layer is a valid layer in the QCustomPlot. + + \see addLayer, moveLayer, removeLayer +*/ +bool QCustomPlot::setCurrentLayer(QCPLayer *layer) +{ + if (!mLayers.contains(layer)) + { + qDebug() << Q_FUNC_INFO << "layer not a layer of this QCustomPlot:" << reinterpret_cast(layer); + return false; + } + + mCurrentLayer = layer; + return true; +} + +/*! + Returns the number of currently existing layers in the plot + + \see layer, addLayer +*/ +int QCustomPlot::layerCount() const +{ + return mLayers.size(); +} + +/*! + Adds a new layer to this QCustomPlot instance. The new layer will have the name \a name, which + must be unique. Depending on \a insertMode, it is positioned either below or above \a otherLayer. + + Returns true on success, i.e. if there is no other layer named \a name and \a otherLayer is a + valid layer inside this QCustomPlot. + + If \a otherLayer is 0, the highest layer in the QCustomPlot will be used. + + For an explanation of what layers are in QCustomPlot, see the documentation of \ref QCPLayer. + + \see layer, moveLayer, removeLayer +*/ +bool QCustomPlot::addLayer(const QString &name, QCPLayer *otherLayer, QCustomPlot::LayerInsertMode insertMode) +{ + if (!otherLayer) + otherLayer = mLayers.last(); + if (!mLayers.contains(otherLayer)) + { + qDebug() << Q_FUNC_INFO << "otherLayer not a layer of this QCustomPlot:" << reinterpret_cast(otherLayer); + return false; + } + if (layer(name)) + { + qDebug() << Q_FUNC_INFO << "A layer exists already with the name" << name; + return false; + } + + QCPLayer *newLayer = new QCPLayer(this, name); + mLayers.insert(otherLayer->index() + (insertMode==limAbove ? 1:0), newLayer); + updateLayerIndices(); + return true; +} + +/*! + Removes the specified \a layer and returns true on success. + + All layerables (e.g. plottables and items) on the removed layer will be moved to the layer below + \a layer. If \a layer is the bottom layer, the layerables are moved to the layer above. In both + cases, the total rendering order of all layerables in the QCustomPlot is preserved. + + If \a layer is the current layer (\ref setCurrentLayer), the layer below (or above, if bottom + layer) becomes the new current layer. + + It is not possible to remove the last layer of the plot. + + \see layer, addLayer, moveLayer +*/ +bool QCustomPlot::removeLayer(QCPLayer *layer) +{ + if (!mLayers.contains(layer)) + { + qDebug() << Q_FUNC_INFO << "layer not a layer of this QCustomPlot:" << reinterpret_cast(layer); + return false; + } + if (mLayers.size() < 2) + { + qDebug() << Q_FUNC_INFO << "can't remove last layer"; + return false; + } + + // append all children of this layer to layer below (if this is lowest layer, prepend to layer above) + int removedIndex = layer->index(); + bool isFirstLayer = removedIndex==0; + QCPLayer *targetLayer = isFirstLayer ? mLayers.at(removedIndex+1) : mLayers.at(removedIndex-1); + QList children = layer->children(); + if (isFirstLayer) // prepend in reverse order (so order relative to each other stays the same) + { + for (int i=children.size()-1; i>=0; --i) + children.at(i)->moveToLayer(targetLayer, true); + } else // append normally + { + for (int i=0; imoveToLayer(targetLayer, false); + } + // if removed layer is current layer, change current layer to layer below/above: + if (layer == mCurrentLayer) + setCurrentLayer(targetLayer); + // remove layer: + delete layer; + mLayers.removeOne(layer); + updateLayerIndices(); + return true; +} + +/*! + Moves the specified \a layer either above or below \a otherLayer. Whether it's placed above or + below is controlled with \a insertMode. + + Returns true on success, i.e. when both \a layer and \a otherLayer are valid layers in the + QCustomPlot. + + \see layer, addLayer, moveLayer +*/ +bool QCustomPlot::moveLayer(QCPLayer *layer, QCPLayer *otherLayer, QCustomPlot::LayerInsertMode insertMode) +{ + if (!mLayers.contains(layer)) + { + qDebug() << Q_FUNC_INFO << "layer not a layer of this QCustomPlot:" << reinterpret_cast(layer); + return false; + } + if (!mLayers.contains(otherLayer)) + { + qDebug() << Q_FUNC_INFO << "otherLayer not a layer of this QCustomPlot:" << reinterpret_cast(otherLayer); + return false; + } + + if (layer->index() > otherLayer->index()) + mLayers.move(layer->index(), otherLayer->index() + (insertMode==limAbove ? 1:0)); + else if (layer->index() < otherLayer->index()) + mLayers.move(layer->index(), otherLayer->index() + (insertMode==limAbove ? 0:-1)); + + updateLayerIndices(); + return true; +} + +/*! + Returns the number of axis rects in the plot. + + All axis rects can be accessed via QCustomPlot::axisRect(). + + Initially, only one axis rect exists in the plot. + + \see axisRect, axisRects +*/ +int QCustomPlot::axisRectCount() const +{ + return axisRects().size(); +} + +/*! + Returns the axis rect with \a index. + + Initially, only one axis rect (with index 0) exists in the plot. If multiple axis rects were + added, all of them may be accessed with this function in a linear fashion (even when they are + nested in a layout hierarchy or inside other axis rects via QCPAxisRect::insetLayout). + + \see axisRectCount, axisRects +*/ +QCPAxisRect *QCustomPlot::axisRect(int index) const +{ + const QList rectList = axisRects(); + if (index >= 0 && index < rectList.size()) + { + return rectList.at(index); + } else + { + qDebug() << Q_FUNC_INFO << "invalid axis rect index" << index; + return 0; + } +} + +/*! + Returns all axis rects in the plot. + + \see axisRectCount, axisRect +*/ +QList QCustomPlot::axisRects() const +{ + QList result; + QStack elementStack; + if (mPlotLayout) + elementStack.push(mPlotLayout); + + while (!elementStack.isEmpty()) + { + foreach (QCPLayoutElement *element, elementStack.pop()->elements(false)) + { + if (element) + { + elementStack.push(element); + if (QCPAxisRect *ar = qobject_cast(element)) + result.append(ar); + } + } + } + + return result; +} + +/*! + Returns the layout element at pixel position \a pos. If there is no element at that position, + returns 0. + + Only visible elements are used. If \ref QCPLayoutElement::setVisible on the element itself or on + any of its parent elements is set to false, it will not be considered. + + \see itemAt, plottableAt +*/ +QCPLayoutElement *QCustomPlot::layoutElementAt(const QPointF &pos) const +{ + QCPLayoutElement *currentElement = mPlotLayout; + bool searchSubElements = true; + while (searchSubElements && currentElement) + { + searchSubElements = false; + foreach (QCPLayoutElement *subElement, currentElement->elements(false)) + { + if (subElement && subElement->realVisibility() && subElement->selectTest(pos, false) >= 0) + { + currentElement = subElement; + searchSubElements = true; + break; + } + } + } + return currentElement; +} + +/*! + Returns the axes that currently have selected parts, i.e. whose selection state is not \ref + QCPAxis::spNone. + + \see selectedPlottables, selectedLegends, setInteractions, QCPAxis::setSelectedParts, + QCPAxis::setSelectableParts +*/ +QList QCustomPlot::selectedAxes() const +{ + QList result, allAxes; + foreach (QCPAxisRect *rect, axisRects()) + allAxes << rect->axes(); + + foreach (QCPAxis *axis, allAxes) + { + if (axis->selectedParts() != QCPAxis::spNone) + result.append(axis); + } + + return result; +} + +/*! + Returns the legends that currently have selected parts, i.e. whose selection state is not \ref + QCPLegend::spNone. + + \see selectedPlottables, selectedAxes, setInteractions, QCPLegend::setSelectedParts, + QCPLegend::setSelectableParts, QCPLegend::selectedItems +*/ +QList QCustomPlot::selectedLegends() const +{ + QList result; + + QStack elementStack; + if (mPlotLayout) + elementStack.push(mPlotLayout); + + while (!elementStack.isEmpty()) + { + foreach (QCPLayoutElement *subElement, elementStack.pop()->elements(false)) + { + if (subElement) + { + elementStack.push(subElement); + if (QCPLegend *leg = qobject_cast(subElement)) + { + if (leg->selectedParts() != QCPLegend::spNone) + result.append(leg); + } + } + } + } + + return result; +} + +/*! + Deselects all layerables (plottables, items, axes, legends,...) of the QCustomPlot. + + Since calling this function is not a user interaction, this does not emit the \ref + selectionChangedByUser signal. The individual selectionChanged signals are emitted though, if the + objects were previously selected. + + \see setInteractions, selectedPlottables, selectedItems, selectedAxes, selectedLegends +*/ +void QCustomPlot::deselectAll() +{ + foreach (QCPLayer *layer, mLayers) + { + foreach (QCPLayerable *layerable, layer->children()) + layerable->deselectEvent(0); + } +} + +/*! + Causes a complete replot into the internal buffer. Finally, update() is called, to redraw the + buffer on the QCustomPlot widget surface. This is the method that must be called to make changes, + for example on the axis ranges or data points of graphs, visible. + + Under a few circumstances, QCustomPlot causes a replot by itself. Those are resize events of the + QCustomPlot widget and user interactions (object selection and range dragging/zooming). + + Before the replot happens, the signal \ref beforeReplot is emitted. After the replot, \ref + afterReplot is emitted. It is safe to mutually connect the replot slot with any of those two + signals on two QCustomPlots to make them replot synchronously, it won't cause an infinite + recursion. +*/ +void QCustomPlot::replot(QCustomPlot::RefreshPriority refreshPriority) +{ + if (mReplotting) // incase signals loop back to replot slot + return; + mReplotting = true; + emit beforeReplot(); + + mPaintBuffer.fill(mBackgroundBrush.style() == Qt::SolidPattern ? mBackgroundBrush.color() : Qt::transparent); + QCPPainter painter; + painter.begin(&mPaintBuffer); + if (painter.isActive()) + { + painter.setRenderHint(QPainter::HighQualityAntialiasing); // to make Antialiasing look good if using the OpenGL graphicssystem + if (mBackgroundBrush.style() != Qt::SolidPattern && mBackgroundBrush.style() != Qt::NoBrush) + painter.fillRect(mViewport, mBackgroundBrush); + draw(&painter); + painter.end(); + if ((refreshPriority == rpHint && mPlottingHints.testFlag(QCP::phForceRepaint)) || refreshPriority==rpImmediate) + repaint(); + else + update(); + } else // might happen if QCustomPlot has width or height zero + qDebug() << Q_FUNC_INFO << "Couldn't activate painter on buffer. This usually happens because QCustomPlot has width or height zero."; + + emit afterReplot(); + mReplotting = false; +} + +/*! + Rescales the axes such that all plottables (like graphs) in the plot are fully visible. + + if \a onlyVisiblePlottables is set to true, only the plottables that have their visibility set to true + (QCPLayerable::setVisible), will be used to rescale the axes. + + \see QCPAbstractPlottable::rescaleAxes, QCPAxis::rescale +*/ +void QCustomPlot::rescaleAxes(bool onlyVisiblePlottables) +{ + QList allAxes; + foreach (QCPAxisRect *rect, axisRects()) + allAxes << rect->axes(); + + foreach (QCPAxis *axis, allAxes) + axis->rescale(onlyVisiblePlottables); +} + +/*! + Saves a PDF with the vectorized plot to the file \a fileName. The axis ratio as well as the scale + of texts and lines will be derived from the specified \a width and \a height. This means, the + output will look like the normal on-screen output of a QCustomPlot widget with the corresponding + pixel width and height. If either \a width or \a height is zero, the exported image will have the + same dimensions as the QCustomPlot widget currently has. + + \a noCosmeticPen disables the use of cosmetic pens when drawing to the PDF file. Cosmetic pens + are pens with numerical width 0, which are always drawn as a one pixel wide line, no matter what + zoom factor is set in the PDF-Viewer. For more information about cosmetic pens, see the QPainter + and QPen documentation. + + The objects of the plot will appear in the current selection state. If you don't want any + selected objects to be painted in their selected look, deselect everything with \ref deselectAll + before calling this function. + + Returns true on success. + + \warning + \li If you plan on editing the exported PDF file with a vector graphics editor like + Inkscape, it is advised to set \a noCosmeticPen to true to avoid losing those cosmetic lines + (which might be quite many, because cosmetic pens are the default for e.g. axes and tick marks). + \li If calling this function inside the constructor of the parent of the QCustomPlot widget + (i.e. the MainWindow constructor, if QCustomPlot is inside the MainWindow), always provide + explicit non-zero widths and heights. If you leave \a width or \a height as 0 (default), this + function uses the current width and height of the QCustomPlot widget. However, in Qt, these + aren't defined yet inside the constructor, so you would get an image that has strange + widths/heights. + + \a pdfCreator and \a pdfTitle may be used to set the according metadata fields in the resulting + PDF file. + + \note On Android systems, this method does nothing and issues an according qDebug warning + message. This is also the case if for other reasons the define flag QT_NO_PRINTER is set. + + \see savePng, saveBmp, saveJpg, saveRastered +*/ +bool QCustomPlot::savePdf(const QString &fileName, bool noCosmeticPen, int width, int height, const QString &pdfCreator, const QString &pdfTitle) +{ + bool success = false; +#ifdef QT_NO_PRINTER + Q_UNUSED(fileName) + Q_UNUSED(noCosmeticPen) + Q_UNUSED(width) + Q_UNUSED(height) + Q_UNUSED(pdfCreator) + Q_UNUSED(pdfTitle) + qDebug() << Q_FUNC_INFO << "Qt was built without printer support (QT_NO_PRINTER). PDF not created."; +#else + int newWidth, newHeight; + if (width == 0 || height == 0) + { + newWidth = this->width(); + newHeight = this->height(); + } else + { + newWidth = width; + newHeight = height; + } + + QPrinter printer(QPrinter::ScreenResolution); + printer.setOutputFileName(fileName); + printer.setOutputFormat(QPrinter::PdfFormat); + printer.setColorMode(QPrinter::Color); + printer.printEngine()->setProperty(QPrintEngine::PPK_Creator, pdfCreator); + printer.printEngine()->setProperty(QPrintEngine::PPK_DocumentName, pdfTitle); + QRect oldViewport = viewport(); + setViewport(QRect(0, 0, newWidth, newHeight)); +#if QT_VERSION < QT_VERSION_CHECK(5, 3, 0) + printer.setFullPage(true); + printer.setPaperSize(viewport().size(), QPrinter::DevicePixel); +#else + QPageLayout pageLayout; + pageLayout.setMode(QPageLayout::FullPageMode); + pageLayout.setOrientation(QPageLayout::Portrait); + pageLayout.setMargins(QMarginsF(0, 0, 0, 0)); + pageLayout.setPageSize(QPageSize(viewport().size(), QPageSize::Point, QString(), QPageSize::ExactMatch)); + printer.setPageLayout(pageLayout); +#endif + QCPPainter printpainter; + if (printpainter.begin(&printer)) + { + printpainter.setMode(QCPPainter::pmVectorized); + printpainter.setMode(QCPPainter::pmNoCaching); + printpainter.setMode(QCPPainter::pmNonCosmetic, noCosmeticPen); + printpainter.setWindow(mViewport); + if (mBackgroundBrush.style() != Qt::NoBrush && + mBackgroundBrush.color() != Qt::white && + mBackgroundBrush.color() != Qt::transparent && + mBackgroundBrush.color().alpha() > 0) // draw pdf background color if not white/transparent + printpainter.fillRect(viewport(), mBackgroundBrush); + draw(&printpainter); + printpainter.end(); + success = true; + } + setViewport(oldViewport); +#endif // QT_NO_PRINTER + return success; +} + +/*! + Saves a PNG image file to \a fileName on disc. The output plot will have the dimensions \a width + and \a height in pixels. If either \a width or \a height is zero, the exported image will have + the same dimensions as the QCustomPlot widget currently has. Line widths and texts etc. are not + scaled up when larger widths/heights are used. If you want that effect, use the \a scale parameter. + + For example, if you set both \a width and \a height to 100 and \a scale to 2, you will end up with an + image file of size 200*200 in which all graphical elements are scaled up by factor 2 (line widths, + texts, etc.). This scaling is not done by stretching a 100*100 image, the result will have full + 200*200 pixel resolution. + + If you use a high scaling factor, it is recommended to enable antialiasing for all elements via + temporarily setting \ref QCustomPlot::setAntialiasedElements to \ref QCP::aeAll as this allows + QCustomPlot to place objects with sub-pixel accuracy. + + \warning If calling this function inside the constructor of the parent of the QCustomPlot widget + (i.e. the MainWindow constructor, if QCustomPlot is inside the MainWindow), always provide + explicit non-zero widths and heights. If you leave \a width or \a height as 0 (default), this + function uses the current width and height of the QCustomPlot widget. However, in Qt, these + aren't defined yet inside the constructor, so you would get an image that has strange + widths/heights. + + The objects of the plot will appear in the current selection state. If you don't want any selected + objects to be painted in their selected look, deselect everything with \ref deselectAll before calling + this function. + + If you want the PNG to have a transparent background, call \ref setBackground(const QBrush + &brush) with no brush (Qt::NoBrush) or a transparent color (Qt::transparent), before saving. + + PNG compression can be controlled with the \a quality parameter which must be between 0 and 100 or + -1 to use the default setting. + + Returns true on success. If this function fails, most likely the PNG format isn't supported by + the system, see Qt docs about QImageWriter::supportedImageFormats(). + + \see savePdf, saveBmp, saveJpg, saveRastered +*/ +bool QCustomPlot::savePng(const QString &fileName, int width, int height, double scale, int quality) +{ + return saveRastered(fileName, width, height, scale, "PNG", quality); +} + +/*! + Saves a JPG image file to \a fileName on disc. The output plot will have the dimensions \a width + and \a height in pixels. If either \a width or \a height is zero, the exported image will have + the same dimensions as the QCustomPlot widget currently has. Line widths and texts etc. are not + scaled up when larger widths/heights are used. If you want that effect, use the \a scale parameter. + + For example, if you set both \a width and \a height to 100 and \a scale to 2, you will end up with an + image file of size 200*200 in which all graphical elements are scaled up by factor 2 (line widths, + texts, etc.). This scaling is not done by stretching a 100*100 image, the result will have full + 200*200 pixel resolution. + + If you use a high scaling factor, it is recommended to enable antialiasing for all elements via + temporarily setting \ref QCustomPlot::setAntialiasedElements to \ref QCP::aeAll as this allows + QCustomPlot to place objects with sub-pixel accuracy. + + \warning If calling this function inside the constructor of the parent of the QCustomPlot widget + (i.e. the MainWindow constructor, if QCustomPlot is inside the MainWindow), always provide + explicit non-zero widths and heights. If you leave \a width or \a height as 0 (default), this + function uses the current width and height of the QCustomPlot widget. However, in Qt, these + aren't defined yet inside the constructor, so you would get an image that has strange + widths/heights. + + The objects of the plot will appear in the current selection state. If you don't want any selected + objects to be painted in their selected look, deselect everything with \ref deselectAll before calling + this function. + + JPG compression can be controlled with the \a quality parameter which must be between 0 and 100 or + -1 to use the default setting. + + Returns true on success. If this function fails, most likely the JPG format isn't supported by + the system, see Qt docs about QImageWriter::supportedImageFormats(). + + \see savePdf, savePng, saveBmp, saveRastered +*/ +bool QCustomPlot::saveJpg(const QString &fileName, int width, int height, double scale, int quality) +{ + return saveRastered(fileName, width, height, scale, "JPG", quality); +} + +/*! + Saves a BMP image file to \a fileName on disc. The output plot will have the dimensions \a width + and \a height in pixels. If either \a width or \a height is zero, the exported image will have + the same dimensions as the QCustomPlot widget currently has. Line widths and texts etc. are not + scaled up when larger widths/heights are used. If you want that effect, use the \a scale parameter. + + For example, if you set both \a width and \a height to 100 and \a scale to 2, you will end up with an + image file of size 200*200 in which all graphical elements are scaled up by factor 2 (line widths, + texts, etc.). This scaling is not done by stretching a 100*100 image, the result will have full + 200*200 pixel resolution. + + If you use a high scaling factor, it is recommended to enable antialiasing for all elements via + temporarily setting \ref QCustomPlot::setAntialiasedElements to \ref QCP::aeAll as this allows + QCustomPlot to place objects with sub-pixel accuracy. + + \warning If calling this function inside the constructor of the parent of the QCustomPlot widget + (i.e. the MainWindow constructor, if QCustomPlot is inside the MainWindow), always provide + explicit non-zero widths and heights. If you leave \a width or \a height as 0 (default), this + function uses the current width and height of the QCustomPlot widget. However, in Qt, these + aren't defined yet inside the constructor, so you would get an image that has strange + widths/heights. + + The objects of the plot will appear in the current selection state. If you don't want any selected + objects to be painted in their selected look, deselect everything with \ref deselectAll before calling + this function. + + Returns true on success. If this function fails, most likely the BMP format isn't supported by + the system, see Qt docs about QImageWriter::supportedImageFormats(). + + \see savePdf, savePng, saveJpg, saveRastered +*/ +bool QCustomPlot::saveBmp(const QString &fileName, int width, int height, double scale) +{ + return saveRastered(fileName, width, height, scale, "BMP"); +} + +/*! \internal + + Returns a minimum size hint that corresponds to the minimum size of the top level layout + (\ref plotLayout). To prevent QCustomPlot from being collapsed to size/width zero, set a minimum + size (setMinimumSize) either on the whole QCustomPlot or on any layout elements inside the plot. + This is especially important, when placed in a QLayout where other components try to take in as + much space as possible (e.g. QMdiArea). +*/ +QSize QCustomPlot::minimumSizeHint() const +{ + return mPlotLayout->minimumSizeHint(); +} + +/*! \internal + + Returns a size hint that is the same as \ref minimumSizeHint. + +*/ +QSize QCustomPlot::sizeHint() const +{ + return mPlotLayout->minimumSizeHint(); +} + +/*! \internal + + Event handler for when the QCustomPlot widget needs repainting. This does not cause a \ref replot, but + draws the internal buffer on the widget surface. +*/ +void QCustomPlot::paintEvent(QPaintEvent *event) +{ + Q_UNUSED(event); + QPainter painter(this); + painter.drawPixmap(0, 0, mPaintBuffer); +} + +/*! \internal + + Event handler for a resize of the QCustomPlot widget. Causes the internal buffer to be resized to + the new size. The viewport (which becomes the outer rect of mPlotLayout) is resized + appropriately. Finally a \ref replot is performed. +*/ +void QCustomPlot::resizeEvent(QResizeEvent *event) +{ + // resize and repaint the buffer: + mPaintBuffer = QPixmap(event->size()); + setViewport(rect()); + replot(rpQueued); // queued update is important here, to prevent painting issues in some contexts +} + +/*! \internal + + Event handler for when a double click occurs. Emits the \ref mouseDoubleClick signal, then emits + the specialized signals when certain objecs are clicked (e.g. \ref plottableDoubleClick, \ref + axisDoubleClick, etc.). Finally determines the affected layout element and forwards the event to + it. + + \see mousePressEvent, mouseReleaseEvent +*/ +void QCustomPlot::mouseDoubleClickEvent(QMouseEvent *event) +{ + emit mouseDoubleClick(event); + + QVariant details; + QCPLayerable *clickedLayerable = layerableAt(event->pos(), false, &details); + + // emit specialized object double click signals: + if (QCPAbstractPlottable *ap = qobject_cast(clickedLayerable)) + emit plottableDoubleClick(ap, event); + else if (QCPAxis *ax = qobject_cast(clickedLayerable)) + emit axisDoubleClick(ax, details.value(), event); + else if (QCPAbstractItem *ai = qobject_cast(clickedLayerable)) + emit itemDoubleClick(ai, event); + else if (QCPLegend *lg = qobject_cast(clickedLayerable)) + emit legendDoubleClick(lg, 0, event); + else if (QCPAbstractLegendItem *li = qobject_cast(clickedLayerable)) + emit legendDoubleClick(li->parentLegend(), li, event); + else if (QCPPlotTitle *pt = qobject_cast(clickedLayerable)) + emit titleDoubleClick(event, pt); + + // call double click event of affected layout element: + if (QCPLayoutElement *el = layoutElementAt(event->pos())) + el->mouseDoubleClickEvent(event); + + // call release event of affected layout element (as in mouseReleaseEvent, since the mouseDoubleClick replaces the second release event in double click case): + if (mMouseEventElement) + { + mMouseEventElement->mouseReleaseEvent(event); + mMouseEventElement = 0; + } + + //QWidget::mouseDoubleClickEvent(event); don't call base class implementation because it would just cause a mousePress/ReleaseEvent, which we don't want. +} + +/*! \internal + + Event handler for when a mouse button is pressed. Emits the mousePress signal. Then determines + the affected layout element and forwards the event to it. + + \see mouseMoveEvent, mouseReleaseEvent +*/ +void QCustomPlot::mousePressEvent(QMouseEvent *event) +{ + emit mousePress(event); + mMousePressPos = event->pos(); // need this to determine in releaseEvent whether it was a click (no position change between press and release) + + // call event of affected layout element: + mMouseEventElement = layoutElementAt(event->pos()); + if (mMouseEventElement) + mMouseEventElement->mousePressEvent(event); + + QWidget::mousePressEvent(event); +} + +/*! \internal + + Event handler for when the cursor is moved. Emits the \ref mouseMove signal. + + If a layout element has mouse capture focus (a mousePressEvent happened on top of the layout + element before), the mouseMoveEvent is forwarded to that element. + + \see mousePressEvent, mouseReleaseEvent +*/ +void QCustomPlot::mouseMoveEvent(QMouseEvent *event) +{ + emit mouseMove(event); + + // call event of affected layout element: + if (mMouseEventElement) + mMouseEventElement->mouseMoveEvent(event); + + QWidget::mouseMoveEvent(event); +} + +/*! \internal + + Event handler for when a mouse button is released. Emits the \ref mouseRelease signal. + + If the mouse was moved less than a certain threshold in any direction since the \ref + mousePressEvent, it is considered a click which causes the selection mechanism (if activated via + \ref setInteractions) to possibly change selection states accordingly. Further, specialized mouse + click signals are emitted (e.g. \ref plottableClick, \ref axisClick, etc.) + + If a layout element has mouse capture focus (a \ref mousePressEvent happened on top of the layout + element before), the \ref mouseReleaseEvent is forwarded to that element. + + \see mousePressEvent, mouseMoveEvent +*/ +void QCustomPlot::mouseReleaseEvent(QMouseEvent *event) +{ + emit mouseRelease(event); + bool doReplot = false; + + if ((mMousePressPos-event->pos()).manhattanLength() < 5) // determine whether it was a click operation + { + if (event->button() == Qt::LeftButton) + { + // handle selection mechanism: + QVariant details; + QCPLayerable *clickedLayerable = layerableAt(event->pos(), true, &details); + bool selectionStateChanged = false; + bool additive = mInteractions.testFlag(QCP::iMultiSelect) && event->modifiers().testFlag(mMultiSelectModifier); + // deselect all other layerables if not additive selection: + if (!additive) + { + foreach (QCPLayer *layer, mLayers) + { + foreach (QCPLayerable *layerable, layer->children()) + { + if (layerable != clickedLayerable && mInteractions.testFlag(layerable->selectionCategory())) + { + bool selChanged = false; + layerable->deselectEvent(&selChanged); + selectionStateChanged |= selChanged; + } + } + } + } + if (clickedLayerable && mInteractions.testFlag(clickedLayerable->selectionCategory())) + { + // a layerable was actually clicked, call its selectEvent: + bool selChanged = false; + clickedLayerable->selectEvent(event, additive, details, &selChanged); + selectionStateChanged |= selChanged; + } + if (selectionStateChanged) + { + doReplot = true; + emit selectionChangedByUser(); + } + } + + // emit specialized object click signals: + QVariant details; + QCPLayerable *clickedLayerable = layerableAt(event->pos(), false, &details); // for these signals, selectability is ignored, that's why we call this again with onlySelectable set to false + if (QCPAbstractPlottable *ap = qobject_cast(clickedLayerable)) + emit plottableClick(ap, event); + else if (QCPAxis *ax = qobject_cast(clickedLayerable)) + emit axisClick(ax, details.value(), event); + else if (QCPAbstractItem *ai = qobject_cast(clickedLayerable)) + emit itemClick(ai, event); + else if (QCPLegend *lg = qobject_cast(clickedLayerable)) + emit legendClick(lg, 0, event); + else if (QCPAbstractLegendItem *li = qobject_cast(clickedLayerable)) + emit legendClick(li->parentLegend(), li, event); + else if (QCPPlotTitle *pt = qobject_cast(clickedLayerable)) + emit titleClick(event, pt); + } + + // call event of affected layout element: + if (mMouseEventElement) + { + mMouseEventElement->mouseReleaseEvent(event); + mMouseEventElement = 0; + } + + if (doReplot || noAntialiasingOnDrag()) + replot(); + + QWidget::mouseReleaseEvent(event); +} + +/*! \internal + + Event handler for mouse wheel events. First, the \ref mouseWheel signal is emitted. Then + determines the affected layout element and forwards the event to it. + +*/ +void QCustomPlot::wheelEvent(QWheelEvent *event) +{ + emit mouseWheel(event); + + // call event of affected layout element: + if (QCPLayoutElement *el = layoutElementAt(event->pos())) + el->wheelEvent(event); + + QWidget::wheelEvent(event); +} + +/*! \internal + + This is the main draw function. It draws the entire plot, including background pixmap, with the + specified \a painter. Note that it does not fill the background with the background brush (as the + user may specify with \ref setBackground(const QBrush &brush)), this is up to the respective + functions calling this method (e.g. \ref replot, \ref toPixmap and \ref toPainter). +*/ +void QCustomPlot::draw(QCPPainter *painter) +{ + // run through layout phases: + mPlotLayout->update(QCPLayoutElement::upPreparation); + mPlotLayout->update(QCPLayoutElement::upMargins); + mPlotLayout->update(QCPLayoutElement::upLayout); + + // draw viewport background pixmap: + drawBackground(painter); + + // draw all layered objects (grid, axes, plottables, items, legend,...): + foreach (QCPLayer *layer, mLayers) + { + foreach (QCPLayerable *child, layer->children()) + { + if (child->realVisibility()) + { + painter->save(); + painter->setClipRect(child->clipRect().translated(0, -1)); + child->applyDefaultAntialiasingHint(painter); + child->draw(painter); + painter->restore(); + } + } + } + + /* Debug code to draw all layout element rects + foreach (QCPLayoutElement* el, findChildren()) + { + painter->setBrush(Qt::NoBrush); + painter->setPen(QPen(QColor(0, 0, 0, 100), 0, Qt::DashLine)); + painter->drawRect(el->rect()); + painter->setPen(QPen(QColor(255, 0, 0, 100), 0, Qt::DashLine)); + painter->drawRect(el->outerRect()); + } + */ +} + +/*! \internal + + Draws the viewport background pixmap of the plot. + + If a pixmap was provided via \ref setBackground, this function buffers the scaled version + depending on \ref setBackgroundScaled and \ref setBackgroundScaledMode and then draws it inside + the viewport with the provided \a painter. The scaled version is buffered in + mScaledBackgroundPixmap to prevent expensive rescaling at every redraw. It is only updated, when + the axis rect has changed in a way that requires a rescale of the background pixmap (this is + dependent on the \ref setBackgroundScaledMode), or when a differend axis background pixmap was + set. + + Note that this function does not draw a fill with the background brush (\ref setBackground(const + QBrush &brush)) beneath the pixmap. + + \see setBackground, setBackgroundScaled, setBackgroundScaledMode +*/ +void QCustomPlot::drawBackground(QCPPainter *painter) +{ + // Note: background color is handled in individual replot/save functions + + // draw background pixmap (on top of fill, if brush specified): + if (!mBackgroundPixmap.isNull()) + { + if (mBackgroundScaled) + { + // check whether mScaledBackground needs to be updated: + QSize scaledSize(mBackgroundPixmap.size()); + scaledSize.scale(mViewport.size(), mBackgroundScaledMode); + if (mScaledBackgroundPixmap.size() != scaledSize) + mScaledBackgroundPixmap = mBackgroundPixmap.scaled(mViewport.size(), mBackgroundScaledMode, Qt::SmoothTransformation); + painter->drawPixmap(mViewport.topLeft(), mScaledBackgroundPixmap, QRect(0, 0, mViewport.width(), mViewport.height()) & mScaledBackgroundPixmap.rect()); + } else + { + painter->drawPixmap(mViewport.topLeft(), mBackgroundPixmap, QRect(0, 0, mViewport.width(), mViewport.height())); + } + } +} + + +/*! \internal + + This method is used by \ref QCPAxisRect::removeAxis to report removed axes to the QCustomPlot + so it may clear its QCustomPlot::xAxis, yAxis, xAxis2 and yAxis2 members accordingly. +*/ +void QCustomPlot::axisRemoved(QCPAxis *axis) +{ + if (xAxis == axis) + xAxis = 0; + if (xAxis2 == axis) + xAxis2 = 0; + if (yAxis == axis) + yAxis = 0; + if (yAxis2 == axis) + yAxis2 = 0; + + // Note: No need to take care of range drag axes and range zoom axes, because they are stored in smart pointers +} + +/*! \internal + + This method is used by the QCPLegend destructor to report legend removal to the QCustomPlot so + it may clear its QCustomPlot::legend member accordingly. +*/ +void QCustomPlot::legendRemoved(QCPLegend *legend) +{ + if (this->legend == legend) + this->legend = 0; +} + +/*! \internal + + Assigns all layers their index (QCPLayer::mIndex) in the mLayers list. This method is thus called + after every operation that changes the layer indices, like layer removal, layer creation, layer + moving. +*/ +void QCustomPlot::updateLayerIndices() const +{ + for (int i=0; imIndex = i; +} + +/*! \internal + + Returns the layerable at pixel position \a pos. If \a onlySelectable is set to true, only those + layerables that are selectable will be considered. (Layerable subclasses communicate their + selectability via the QCPLayerable::selectTest method, by returning -1.) + + \a selectionDetails is an output parameter that contains selection specifics of the affected + layerable. This is useful if the respective layerable shall be given a subsequent + QCPLayerable::selectEvent (like in \ref mouseReleaseEvent). \a selectionDetails usually contains + information about which part of the layerable was hit, in multi-part layerables (e.g. + QCPAxis::SelectablePart). +*/ +QCPLayerable *QCustomPlot::layerableAt(const QPointF &pos, bool onlySelectable, QVariant *selectionDetails) const +{ + for (int layerIndex=mLayers.size()-1; layerIndex>=0; --layerIndex) + { + const QList layerables = mLayers.at(layerIndex)->children(); + double minimumDistance = selectionTolerance()*1.1; + QCPLayerable *minimumDistanceLayerable = 0; + for (int i=layerables.size()-1; i>=0; --i) + { + if (!layerables.at(i)->realVisibility()) + continue; + QVariant details; + double dist = layerables.at(i)->selectTest(pos, onlySelectable, &details); + if (dist >= 0 && dist < minimumDistance) + { + minimumDistance = dist; + minimumDistanceLayerable = layerables.at(i); + if (selectionDetails) *selectionDetails = details; + } + } + if (minimumDistance < selectionTolerance()) + return minimumDistanceLayerable; + } + return 0; +} + +/*! + Saves the plot to a rastered image file \a fileName in the image format \a format. The plot is + sized to \a width and \a height in pixels and scaled with \a scale. (width 100 and scale 2.0 lead + to a full resolution file with width 200.) If the \a format supports compression, \a quality may + be between 0 and 100 to control it. + + Returns true on success. If this function fails, most likely the given \a format isn't supported + by the system, see Qt docs about QImageWriter::supportedImageFormats(). + + \see saveBmp, saveJpg, savePng, savePdf +*/ +bool QCustomPlot::saveRastered(const QString &fileName, int width, int height, double scale, const char *format, int quality) +{ + QPixmap buffer = toPixmap(width, height, scale); + if (!buffer.isNull()) + return buffer.save(fileName, format, quality); + else + return false; +} + +/*! + Renders the plot to a pixmap and returns it. + + The plot is sized to \a width and \a height in pixels and scaled with \a scale. (width 100 and + scale 2.0 lead to a full resolution pixmap with width 200.) + + \see toPainter, saveRastered, saveBmp, savePng, saveJpg, savePdf +*/ +QPixmap QCustomPlot::toPixmap(int width, int height, double scale) +{ + // this method is somewhat similar to toPainter. Change something here, and a change in toPainter might be necessary, too. + int newWidth, newHeight; + if (width == 0 || height == 0) + { + newWidth = this->width(); + newHeight = this->height(); + } else + { + newWidth = width; + newHeight = height; + } + int scaledWidth = qRound(scale*newWidth); + int scaledHeight = qRound(scale*newHeight); + + QPixmap result(scaledWidth, scaledHeight); + result.fill(mBackgroundBrush.style() == Qt::SolidPattern ? mBackgroundBrush.color() : Qt::transparent); // if using non-solid pattern, make transparent now and draw brush pattern later + QCPPainter painter; + painter.begin(&result); + if (painter.isActive()) + { + QRect oldViewport = viewport(); + setViewport(QRect(0, 0, newWidth, newHeight)); + painter.setMode(QCPPainter::pmNoCaching); + if (!qFuzzyCompare(scale, 1.0)) + { + if (scale > 1.0) // for scale < 1 we always want cosmetic pens where possible, because else lines might disappear for very small scales + painter.setMode(QCPPainter::pmNonCosmetic); + painter.scale(scale, scale); + } + if (mBackgroundBrush.style() != Qt::SolidPattern && mBackgroundBrush.style() != Qt::NoBrush) // solid fills were done a few lines above with QPixmap::fill + painter.fillRect(mViewport, mBackgroundBrush); + draw(&painter); + setViewport(oldViewport); + painter.end(); + } else // might happen if pixmap has width or height zero + { + qDebug() << Q_FUNC_INFO << "Couldn't activate painter on pixmap"; + return QPixmap(); + } + return result; +} + +/*! + Renders the plot using the passed \a painter. + + The plot is sized to \a width and \a height in pixels. If the \a painter's scale is not 1.0, the resulting plot will + appear scaled accordingly. + + \note If you are restricted to using a QPainter (instead of QCPPainter), create a temporary QPicture and open a QCPPainter + on it. Then call \ref toPainter with this QCPPainter. After ending the paint operation on the picture, draw it with + the QPainter. This will reproduce the painter actions the QCPPainter took, with a QPainter. + + \see toPixmap +*/ +void QCustomPlot::toPainter(QCPPainter *painter, int width, int height) +{ + // this method is somewhat similar to toPixmap. Change something here, and a change in toPixmap might be necessary, too. + int newWidth, newHeight; + if (width == 0 || height == 0) + { + newWidth = this->width(); + newHeight = this->height(); + } else + { + newWidth = width; + newHeight = height; + } + + if (painter->isActive()) + { + QRect oldViewport = viewport(); + setViewport(QRect(0, 0, newWidth, newHeight)); + painter->setMode(QCPPainter::pmNoCaching); + if (mBackgroundBrush.style() != Qt::NoBrush) // unlike in toPixmap, we can't do QPixmap::fill for Qt::SolidPattern brush style, so we also draw solid fills with fillRect here + painter->fillRect(mViewport, mBackgroundBrush); + draw(painter); + setViewport(oldViewport); + } else + qDebug() << Q_FUNC_INFO << "Passed painter is not active"; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPColorGradient +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPColorGradient + \brief Defines a color gradient for use with e.g. \ref QCPColorMap + + This class describes a color gradient which can be used to encode data with color. For example, + QCPColorMap and QCPColorScale have \ref QCPColorMap::setGradient "setGradient" methods which + take an instance of this class. Colors are set with \ref setColorStopAt(double position, const QColor &color) + with a \a position from 0 to 1. In between these defined color positions, the + color will be interpolated linearly either in RGB or HSV space, see \ref setColorInterpolation. + + Alternatively, load one of the preset color gradients shown in the image below, with \ref + loadPreset, or by directly specifying the preset in the constructor. + + \image html QCPColorGradient.png + + The fact that the \ref QCPColorGradient(GradientPreset preset) constructor allows directly + converting a \ref GradientPreset to a QCPColorGradient, you can also directly pass \ref + GradientPreset to all the \a setGradient methods, e.g.: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcolorgradient-setgradient + + The total number of levels used in the gradient can be set with \ref setLevelCount. Whether the + color gradient shall be applied periodically (wrapping around) to data values that lie outside + the data range specified on the plottable instance can be controlled with \ref setPeriodic. +*/ + +/*! + Constructs a new QCPColorGradient initialized with the colors and color interpolation according + to \a preset. + + The color level count is initialized to 350. +*/ +QCPColorGradient::QCPColorGradient(GradientPreset preset) : + mLevelCount(350), + mColorInterpolation(ciRGB), + mPeriodic(false), + mColorBufferInvalidated(true) +{ + mColorBuffer.fill(qRgb(0, 0, 0), mLevelCount); + loadPreset(preset); +} + +/* undocumented operator */ +bool QCPColorGradient::operator==(const QCPColorGradient &other) const +{ + return ((other.mLevelCount == this->mLevelCount) && + (other.mColorInterpolation == this->mColorInterpolation) && + (other.mPeriodic == this->mPeriodic) && + (other.mColorStops == this->mColorStops)); +} + +/*! + Sets the number of discretization levels of the color gradient to \a n. The default is 350 which + is typically enough to create a smooth appearance. + + \image html QCPColorGradient-levelcount.png +*/ +void QCPColorGradient::setLevelCount(int n) +{ + if (n < 2) + { + qDebug() << Q_FUNC_INFO << "n must be greater or equal 2 but was" << n; + n = 2; + } + if (n != mLevelCount) + { + mLevelCount = n; + mColorBufferInvalidated = true; + } +} + +/*! + Sets at which positions from 0 to 1 which color shall occur. The positions are the keys, the + colors are the values of the passed QMap \a colorStops. In between these color stops, the color + is interpolated according to \ref setColorInterpolation. + + A more convenient way to create a custom gradient may be to clear all color stops with \ref + clearColorStops and then adding them one by one with \ref setColorStopAt. + + \see clearColorStops +*/ +void QCPColorGradient::setColorStops(const QMap &colorStops) +{ + mColorStops = colorStops; + mColorBufferInvalidated = true; +} + +/*! + Sets the \a color the gradient will have at the specified \a position (from 0 to 1). In between + these color stops, the color is interpolated according to \ref setColorInterpolation. + + \see setColorStops, clearColorStops +*/ +void QCPColorGradient::setColorStopAt(double position, const QColor &color) +{ + mColorStops.insert(position, color); + mColorBufferInvalidated = true; +} + +/*! + Sets whether the colors in between the configured color stops (see \ref setColorStopAt) shall be + interpolated linearly in RGB or in HSV color space. + + For example, a sweep in RGB space from red to green will have a muddy brown intermediate color, + whereas in HSV space the intermediate color is yellow. +*/ +void QCPColorGradient::setColorInterpolation(QCPColorGradient::ColorInterpolation interpolation) +{ + if (interpolation != mColorInterpolation) + { + mColorInterpolation = interpolation; + mColorBufferInvalidated = true; + } +} + +/*! + Sets whether data points that are outside the configured data range (e.g. \ref + QCPColorMap::setDataRange) are colored by periodically repeating the color gradient or whether + they all have the same color, corresponding to the respective gradient boundary color. + + \image html QCPColorGradient-periodic.png + + As shown in the image above, gradients that have the same start and end color are especially + suitable for a periodic gradient mapping, since they produce smooth color transitions throughout + the color map. A preset that has this property is \ref gpHues. + + In practice, using periodic color gradients makes sense when the data corresponds to a periodic + dimension, such as an angle or a phase. If this is not the case, the color encoding might become + ambiguous, because multiple different data values are shown as the same color. +*/ +void QCPColorGradient::setPeriodic(bool enabled) +{ + mPeriodic = enabled; +} + +/*! + This method is used to quickly convert a \a data array to colors. The colors will be output in + the array \a scanLine. Both \a data and \a scanLine must have the length \a n when passed to this + function. The data range that shall be used for mapping the data value to the gradient is passed + in \a range. \a logarithmic indicates whether the data values shall be mapped to colors + logarithmically. + + if \a data actually contains 2D-data linearized via [row*columnCount + column], you can + set \a dataIndexFactor to columnCount to convert a column instead of a row of the data + array, in \a scanLine. \a scanLine will remain a regular (1D) array. This works because \a data + is addressed data[i*dataIndexFactor]. +*/ +void QCPColorGradient::colorize(const double *data, const QCPRange &range, QRgb *scanLine, int n, int dataIndexFactor, bool logarithmic) +{ + // If you change something here, make sure to also adapt ::color() + if (!data) + { + qDebug() << Q_FUNC_INFO << "null pointer given as data"; + return; + } + if (!scanLine) + { + qDebug() << Q_FUNC_INFO << "null pointer given as scanLine"; + return; + } + if (mColorBufferInvalidated) + updateColorBuffer(); + + if (!logarithmic) + { + const double posToIndexFactor = (mLevelCount-1)/range.size(); + if (mPeriodic) + { + for (int i=0; i= mLevelCount) + index = mLevelCount-1; + scanLine[i] = mColorBuffer.at(index); + } + } + } else // logarithmic == true + { + if (mPeriodic) + { + for (int i=0; i= mLevelCount) + index = mLevelCount-1; + scanLine[i] = mColorBuffer.at(index); + } + } + } +} + +/*! \internal + + This method is used to colorize a single data value given in \a position, to colors. The data + range that shall be used for mapping the data value to the gradient is passed in \a range. \a + logarithmic indicates whether the data value shall be mapped to a color logarithmically. + + If an entire array of data values shall be converted, rather use \ref colorize, for better + performance. +*/ +QRgb QCPColorGradient::color(double position, const QCPRange &range, bool logarithmic) +{ + // If you change something here, make sure to also adapt ::colorize() + if (mColorBufferInvalidated) + updateColorBuffer(); + int index = 0; + if (!logarithmic) + index = (position-range.lower)*(mLevelCount-1)/range.size(); + else + index = qLn(position/range.lower)/qLn(range.upper/range.lower)*(mLevelCount-1); + if (mPeriodic) + { + index = index % mLevelCount; + if (index < 0) + index += mLevelCount; + } else + { + if (index < 0) + index = 0; + else if (index >= mLevelCount) + index = mLevelCount-1; + } + return mColorBuffer.at(index); +} + +/*! + Clears the current color stops and loads the specified \a preset. A preset consists of predefined + color stops and the corresponding color interpolation method. + + The available presets are: + \image html QCPColorGradient.png +*/ +void QCPColorGradient::loadPreset(GradientPreset preset) +{ + clearColorStops(); + switch (preset) + { + case gpGrayscale: + setColorInterpolation(ciRGB); + setColorStopAt(0, Qt::black); + setColorStopAt(1, Qt::white); + break; + case gpHot: + setColorInterpolation(ciRGB); + setColorStopAt(0, QColor(50, 0, 0)); + setColorStopAt(0.2, QColor(180, 10, 0)); + setColorStopAt(0.4, QColor(245, 50, 0)); + setColorStopAt(0.6, QColor(255, 150, 10)); + setColorStopAt(0.8, QColor(255, 255, 50)); + setColorStopAt(1, QColor(255, 255, 255)); + break; + case gpCold: + setColorInterpolation(ciRGB); + setColorStopAt(0, QColor(0, 0, 50)); + setColorStopAt(0.2, QColor(0, 10, 180)); + setColorStopAt(0.4, QColor(0, 50, 245)); + setColorStopAt(0.6, QColor(10, 150, 255)); + setColorStopAt(0.8, QColor(50, 255, 255)); + setColorStopAt(1, QColor(255, 255, 255)); + break; + case gpNight: + setColorInterpolation(ciHSV); + setColorStopAt(0, QColor(10, 20, 30)); + setColorStopAt(1, QColor(250, 255, 250)); + break; + case gpCandy: + setColorInterpolation(ciHSV); + setColorStopAt(0, QColor(0, 0, 255)); + setColorStopAt(1, QColor(255, 250, 250)); + break; + case gpGeography: + setColorInterpolation(ciRGB); + setColorStopAt(0, QColor(70, 170, 210)); + setColorStopAt(0.20, QColor(90, 160, 180)); + setColorStopAt(0.25, QColor(45, 130, 175)); + setColorStopAt(0.30, QColor(100, 140, 125)); + setColorStopAt(0.5, QColor(100, 140, 100)); + setColorStopAt(0.6, QColor(130, 145, 120)); + setColorStopAt(0.7, QColor(140, 130, 120)); + setColorStopAt(0.9, QColor(180, 190, 190)); + setColorStopAt(1, QColor(210, 210, 230)); + break; + case gpIon: + setColorInterpolation(ciHSV); + setColorStopAt(0, QColor(50, 10, 10)); + setColorStopAt(0.45, QColor(0, 0, 255)); + setColorStopAt(0.8, QColor(0, 255, 255)); + setColorStopAt(1, QColor(0, 255, 0)); + break; + case gpThermal: + setColorInterpolation(ciRGB); + setColorStopAt(0, QColor(0, 0, 50)); + setColorStopAt(0.15, QColor(20, 0, 120)); + setColorStopAt(0.33, QColor(200, 30, 140)); + setColorStopAt(0.6, QColor(255, 100, 0)); + setColorStopAt(0.85, QColor(255, 255, 40)); + setColorStopAt(1, QColor(255, 255, 255)); + break; + case gpPolar: + setColorInterpolation(ciRGB); + setColorStopAt(0, QColor(50, 255, 255)); + setColorStopAt(0.18, QColor(10, 70, 255)); + setColorStopAt(0.28, QColor(10, 10, 190)); + setColorStopAt(0.5, QColor(0, 0, 0)); + setColorStopAt(0.72, QColor(190, 10, 10)); + setColorStopAt(0.82, QColor(255, 70, 10)); + setColorStopAt(1, QColor(255, 255, 50)); + break; + case gpSpectrum: + setColorInterpolation(ciHSV); + setColorStopAt(0, QColor(50, 0, 50)); + setColorStopAt(0.15, QColor(0, 0, 255)); + setColorStopAt(0.35, QColor(0, 255, 255)); + setColorStopAt(0.6, QColor(255, 255, 0)); + setColorStopAt(0.75, QColor(255, 30, 0)); + setColorStopAt(1, QColor(50, 0, 0)); + break; + case gpJet: + setColorInterpolation(ciRGB); + setColorStopAt(0, QColor(0, 0, 100)); + setColorStopAt(0.15, QColor(0, 50, 255)); + setColorStopAt(0.35, QColor(0, 255, 255)); + setColorStopAt(0.65, QColor(255, 255, 0)); + setColorStopAt(0.85, QColor(255, 30, 0)); + setColorStopAt(1, QColor(100, 0, 0)); + break; + case gpHues: + setColorInterpolation(ciHSV); + setColorStopAt(0, QColor(255, 0, 0)); + setColorStopAt(1.0/3.0, QColor(0, 0, 255)); + setColorStopAt(2.0/3.0, QColor(0, 255, 0)); + setColorStopAt(1, QColor(255, 0, 0)); + break; + } +} + +/*! + Clears all color stops. + + \see setColorStops, setColorStopAt +*/ +void QCPColorGradient::clearColorStops() +{ + mColorStops.clear(); + mColorBufferInvalidated = true; +} + +/*! + Returns an inverted gradient. The inverted gradient has all properties as this \ref + QCPColorGradient, but the order of the color stops is inverted. + + \see setColorStops, setColorStopAt +*/ +QCPColorGradient QCPColorGradient::inverted() const +{ + QCPColorGradient result(*this); + result.clearColorStops(); + for (QMap::const_iterator it=mColorStops.constBegin(); it!=mColorStops.constEnd(); ++it) + result.setColorStopAt(1.0-it.key(), it.value()); + return result; +} + +/*! \internal + + Updates the internal color buffer which will be used by \ref colorize and \ref color, to quickly + convert positions to colors. This is where the interpolation between color stops is calculated. +*/ +void QCPColorGradient::updateColorBuffer() +{ + if (mColorBuffer.size() != mLevelCount) + mColorBuffer.resize(mLevelCount); + if (mColorStops.size() > 1) + { + double indexToPosFactor = 1.0/(double)(mLevelCount-1); + for (int i=0; i::const_iterator it = mColorStops.lowerBound(position); + if (it == mColorStops.constEnd()) // position is on or after last stop, use color of last stop + { + mColorBuffer[i] = (it-1).value().rgb(); + } else if (it == mColorStops.constBegin()) // position is on or before first stop, use color of first stop + { + mColorBuffer[i] = it.value().rgb(); + } else // position is in between stops (or on an intermediate stop), interpolate color + { + QMap::const_iterator high = it; + QMap::const_iterator low = it-1; + double t = (position-low.key())/(high.key()-low.key()); // interpolation factor 0..1 + switch (mColorInterpolation) + { + case ciRGB: + { + mColorBuffer[i] = qRgb((1-t)*low.value().red() + t*high.value().red(), + (1-t)*low.value().green() + t*high.value().green(), + (1-t)*low.value().blue() + t*high.value().blue()); + break; + } + case ciHSV: + { + QColor lowHsv = low.value().toHsv(); + QColor highHsv = high.value().toHsv(); + double hue = 0; + double hueDiff = highHsv.hueF()-lowHsv.hueF(); + if (hueDiff > 0.5) + hue = lowHsv.hueF() - t*(1.0-hueDiff); + else if (hueDiff < -0.5) + hue = lowHsv.hueF() + t*(1.0+hueDiff); + else + hue = lowHsv.hueF() + t*hueDiff; + if (hue < 0) hue += 1.0; + else if (hue >= 1.0) hue -= 1.0; + mColorBuffer[i] = QColor::fromHsvF(hue, (1-t)*lowHsv.saturationF() + t*highHsv.saturationF(), (1-t)*lowHsv.valueF() + t*highHsv.valueF()).rgb(); + break; + } + } + } + } + } else if (mColorStops.size() == 1) + { + mColorBuffer.fill(mColorStops.constBegin().value().rgb()); + } else // mColorStops is empty, fill color buffer with black + { + mColorBuffer.fill(qRgb(0, 0, 0)); + } + mColorBufferInvalidated = false; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAxisRect +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPAxisRect + \brief Holds multiple axes and arranges them in a rectangular shape. + + This class represents an axis rect, a rectangular area that is bounded on all sides with an + arbitrary number of axes. + + Initially QCustomPlot has one axis rect, accessible via QCustomPlot::axisRect(). However, the + layout system allows to have multiple axis rects, e.g. arranged in a grid layout + (QCustomPlot::plotLayout). + + By default, QCPAxisRect comes with four axes, at bottom, top, left and right. They can be + accessed via \ref axis by providing the respective axis type (\ref QCPAxis::AxisType) and index. + If you need all axes in the axis rect, use \ref axes. The top and right axes are set to be + invisible initially (QCPAxis::setVisible). To add more axes to a side, use \ref addAxis or \ref + addAxes. To remove an axis, use \ref removeAxis. + + The axis rect layerable itself only draws a background pixmap or color, if specified (\ref + setBackground). It is placed on the "background" layer initially (see \ref QCPLayer for an + explanation of the QCustomPlot layer system). The axes that are held by the axis rect can be + placed on other layers, independently of the axis rect. + + Every axis rect has a child layout of type \ref QCPLayoutInset. It is accessible via \ref + insetLayout and can be used to have other layout elements (or even other layouts with multiple + elements) hovering inside the axis rect. + + If an axis rect is clicked and dragged, it processes this by moving certain axis ranges. The + behaviour can be controlled with \ref setRangeDrag and \ref setRangeDragAxes. If the mouse wheel + is scrolled while the cursor is on the axis rect, certain axes are scaled. This is controllable + via \ref setRangeZoom, \ref setRangeZoomAxes and \ref setRangeZoomFactor. These interactions are + only enabled if \ref QCustomPlot::setInteractions contains \ref QCP::iRangeDrag and \ref + QCP::iRangeZoom. + + \image html AxisRectSpacingOverview.png +
Overview of the spacings and paddings that define the geometry of an axis. The dashed + line on the far left indicates the viewport/widget border.
+*/ + +/* start documentation of inline functions */ + +/*! \fn QCPLayoutInset *QCPAxisRect::insetLayout() const + + Returns the inset layout of this axis rect. It can be used to place other layout elements (or + even layouts with multiple other elements) inside/on top of an axis rect. + + \see QCPLayoutInset +*/ + +/*! \fn int QCPAxisRect::left() const + + Returns the pixel position of the left border of this axis rect. Margins are not taken into + account here, so the returned value is with respect to the inner \ref rect. +*/ + +/*! \fn int QCPAxisRect::right() const + + Returns the pixel position of the right border of this axis rect. Margins are not taken into + account here, so the returned value is with respect to the inner \ref rect. +*/ + +/*! \fn int QCPAxisRect::top() const + + Returns the pixel position of the top border of this axis rect. Margins are not taken into + account here, so the returned value is with respect to the inner \ref rect. +*/ + +/*! \fn int QCPAxisRect::bottom() const + + Returns the pixel position of the bottom border of this axis rect. Margins are not taken into + account here, so the returned value is with respect to the inner \ref rect. +*/ + +/*! \fn int QCPAxisRect::width() const + + Returns the pixel width of this axis rect. Margins are not taken into account here, so the + returned value is with respect to the inner \ref rect. +*/ + +/*! \fn int QCPAxisRect::height() const + + Returns the pixel height of this axis rect. Margins are not taken into account here, so the + returned value is with respect to the inner \ref rect. +*/ + +/*! \fn QSize QCPAxisRect::size() const + + Returns the pixel size of this axis rect. Margins are not taken into account here, so the + returned value is with respect to the inner \ref rect. +*/ + +/*! \fn QPoint QCPAxisRect::topLeft() const + + Returns the top left corner of this axis rect in pixels. Margins are not taken into account here, + so the returned value is with respect to the inner \ref rect. +*/ + +/*! \fn QPoint QCPAxisRect::topRight() const + + Returns the top right corner of this axis rect in pixels. Margins are not taken into account + here, so the returned value is with respect to the inner \ref rect. +*/ + +/*! \fn QPoint QCPAxisRect::bottomLeft() const + + Returns the bottom left corner of this axis rect in pixels. Margins are not taken into account + here, so the returned value is with respect to the inner \ref rect. +*/ + +/*! \fn QPoint QCPAxisRect::bottomRight() const + + Returns the bottom right corner of this axis rect in pixels. Margins are not taken into account + here, so the returned value is with respect to the inner \ref rect. +*/ + +/*! \fn QPoint QCPAxisRect::center() const + + Returns the center of this axis rect in pixels. Margins are not taken into account here, so the + returned value is with respect to the inner \ref rect. +*/ + +/* end documentation of inline functions */ + +/*! + Creates a QCPAxisRect instance and sets default values. An axis is added for each of the four + sides, the top and right axes are set invisible initially. +*/ +QCPAxisRect::QCPAxisRect(QCustomPlot *parentPlot, bool setupDefaultAxes) : + QCPLayoutElement(parentPlot), + mBackgroundBrush(Qt::NoBrush), + mBackgroundScaled(true), + mBackgroundScaledMode(Qt::KeepAspectRatioByExpanding), + mInsetLayout(new QCPLayoutInset), + mRangeDrag(Qt::Horizontal|Qt::Vertical), + mRangeZoom(Qt::Horizontal|Qt::Vertical), + mRangeZoomFactorHorz(0.85), + mRangeZoomFactorVert(0.85), + mDragging(false) +{ + mInsetLayout->initializeParentPlot(mParentPlot); + mInsetLayout->setParentLayerable(this); + mInsetLayout->setParent(this); + + setMinimumSize(50, 50); + setMinimumMargins(QMargins(15, 15, 15, 15)); + mAxes.insert(QCPAxis::atLeft, QList()); + mAxes.insert(QCPAxis::atRight, QList()); + mAxes.insert(QCPAxis::atTop, QList()); + mAxes.insert(QCPAxis::atBottom, QList()); + + if (setupDefaultAxes) + { + QCPAxis *xAxis = addAxis(QCPAxis::atBottom); + QCPAxis *yAxis = addAxis(QCPAxis::atLeft); + QCPAxis *xAxis2 = addAxis(QCPAxis::atTop); + QCPAxis *yAxis2 = addAxis(QCPAxis::atRight); + setRangeDragAxes(xAxis, yAxis); + setRangeZoomAxes(xAxis, yAxis); + xAxis2->setVisible(false); + yAxis2->setVisible(false); + xAxis->grid()->setVisible(true); + yAxis->grid()->setVisible(true); + xAxis2->grid()->setVisible(false); + yAxis2->grid()->setVisible(false); + xAxis2->grid()->setZeroLinePen(Qt::NoPen); + yAxis2->grid()->setZeroLinePen(Qt::NoPen); + xAxis2->grid()->setVisible(false); + yAxis2->grid()->setVisible(false); + } +} + +QCPAxisRect::~QCPAxisRect() +{ + delete mInsetLayout; + mInsetLayout = 0; + + QList axesList = axes(); + for (int i=0; i ax(mAxes.value(type)); + if (index >= 0 && index < ax.size()) + { + return ax.at(index); + } else + { + qDebug() << Q_FUNC_INFO << "Axis index out of bounds:" << index; + return 0; + } +} + +/*! + Returns all axes on the axis rect sides specified with \a types. + + \a types may be a single \ref QCPAxis::AxisType or an or-combination, to get the axes of + multiple sides. + + \see axis +*/ +QList QCPAxisRect::axes(QCPAxis::AxisTypes types) const +{ + QList result; + if (types.testFlag(QCPAxis::atLeft)) + result << mAxes.value(QCPAxis::atLeft); + if (types.testFlag(QCPAxis::atRight)) + result << mAxes.value(QCPAxis::atRight); + if (types.testFlag(QCPAxis::atTop)) + result << mAxes.value(QCPAxis::atTop); + if (types.testFlag(QCPAxis::atBottom)) + result << mAxes.value(QCPAxis::atBottom); + return result; +} + +/*! \overload + + Returns all axes of this axis rect. +*/ +QList QCPAxisRect::axes() const +{ + QList result; + QHashIterator > it(mAxes); + while (it.hasNext()) + { + it.next(); + result << it.value(); + } + return result; +} + +/*! + Adds a new axis to the axis rect side specified with \a type, and returns it. If \a axis is 0, a + new QCPAxis instance is created internally. + + You may inject QCPAxis instances (or sublasses of QCPAxis) by setting \a axis to an axis that was + previously created outside QCustomPlot. It is important to note that QCustomPlot takes ownership + of the axis, so you may not delete it afterwards. Further, the \a axis must have been created + with this axis rect as parent and with the same axis type as specified in \a type. If this is not + the case, a debug output is generated, the axis is not added, and the method returns 0. + + This method can not be used to move \a axis between axis rects. The same \a axis instance must + not be added multiple times to the same or different axis rects. + + If an axis rect side already contains one or more axes, the lower and upper endings of the new + axis (\ref QCPAxis::setLowerEnding, \ref QCPAxis::setUpperEnding) are set to \ref + QCPLineEnding::esHalfBar. + + \see addAxes, setupFullAxesBox +*/ +QCPAxis *QCPAxisRect::addAxis(QCPAxis::AxisType type, QCPAxis *axis) +{ + QCPAxis *newAxis = axis; + if (!newAxis) + { + newAxis = new QCPAxis(this, type); + } else // user provided existing axis instance, do some sanity checks + { + if (newAxis->axisType() != type) + { + qDebug() << Q_FUNC_INFO << "passed axis has different axis type than specified in type parameter"; + return 0; + } + if (newAxis->axisRect() != this) + { + qDebug() << Q_FUNC_INFO << "passed axis doesn't have this axis rect as parent axis rect"; + return 0; + } + if (axes().contains(newAxis)) + { + qDebug() << Q_FUNC_INFO << "passed axis is already owned by this axis rect"; + return 0; + } + } + if (mAxes[type].size() > 0) // multiple axes on one side, add half-bar axis ending to additional axes with offset + { + bool invert = (type == QCPAxis::atRight) || (type == QCPAxis::atBottom); + newAxis->setLowerEnding(QCPLineEnding(QCPLineEnding::esHalfBar, 6, 10, !invert)); + newAxis->setUpperEnding(QCPLineEnding(QCPLineEnding::esHalfBar, 6, 10, invert)); + } + mAxes[type].append(newAxis); + return newAxis; +} + +/*! + Adds a new axis with \ref addAxis to each axis rect side specified in \a types. This may be an + or-combination of QCPAxis::AxisType, so axes can be added to multiple sides at once. + + Returns a list of the added axes. + + \see addAxis, setupFullAxesBox +*/ +QList QCPAxisRect::addAxes(QCPAxis::AxisTypes types) +{ + QList result; + if (types.testFlag(QCPAxis::atLeft)) + result << addAxis(QCPAxis::atLeft); + if (types.testFlag(QCPAxis::atRight)) + result << addAxis(QCPAxis::atRight); + if (types.testFlag(QCPAxis::atTop)) + result << addAxis(QCPAxis::atTop); + if (types.testFlag(QCPAxis::atBottom)) + result << addAxis(QCPAxis::atBottom); + return result; +} + +/*! + Removes the specified \a axis from the axis rect and deletes it. + + Returns true on success, i.e. if \a axis was a valid axis in this axis rect. + + \see addAxis +*/ +bool QCPAxisRect::removeAxis(QCPAxis *axis) +{ + // don't access axis->axisType() to provide safety when axis is an invalid pointer, rather go through all axis containers: + QHashIterator > it(mAxes); + while (it.hasNext()) + { + it.next(); + if (it.value().contains(axis)) + { + mAxes[it.key()].removeOne(axis); + if (qobject_cast(parentPlot())) // make sure this isn't called from QObject dtor when QCustomPlot is already destructed (happens when the axis rect is not in any layout and thus QObject-child of QCustomPlot) + parentPlot()->axisRemoved(axis); + delete axis; + return true; + } + } + qDebug() << Q_FUNC_INFO << "Axis isn't in axis rect:" << reinterpret_cast(axis); + return false; +} + +/*! + Convenience function to create an axis on each side that doesn't have any axes yet and set their + visibility to true. Further, the top/right axes are assigned the following properties of the + bottom/left axes: + + \li range (\ref QCPAxis::setRange) + \li range reversed (\ref QCPAxis::setRangeReversed) + \li scale type (\ref QCPAxis::setScaleType) + \li scale log base (\ref QCPAxis::setScaleLogBase) + \li ticks (\ref QCPAxis::setTicks) + \li auto (major) tick count (\ref QCPAxis::setAutoTickCount) + \li sub tick count (\ref QCPAxis::setSubTickCount) + \li auto sub ticks (\ref QCPAxis::setAutoSubTicks) + \li tick step (\ref QCPAxis::setTickStep) + \li auto tick step (\ref QCPAxis::setAutoTickStep) + \li number format (\ref QCPAxis::setNumberFormat) + \li number precision (\ref QCPAxis::setNumberPrecision) + \li tick label type (\ref QCPAxis::setTickLabelType) + \li date time format (\ref QCPAxis::setDateTimeFormat) + \li date time spec (\ref QCPAxis::setDateTimeSpec) + + Tick labels (\ref QCPAxis::setTickLabels) of the right and top axes are set to false. + + If \a connectRanges is true, the \ref QCPAxis::rangeChanged "rangeChanged" signals of the bottom + and left axes are connected to the \ref QCPAxis::setRange slots of the top and right axes. +*/ +void QCPAxisRect::setupFullAxesBox(bool connectRanges) +{ + QCPAxis *xAxis, *yAxis, *xAxis2, *yAxis2; + if (axisCount(QCPAxis::atBottom) == 0) + xAxis = addAxis(QCPAxis::atBottom); + else + xAxis = axis(QCPAxis::atBottom); + + if (axisCount(QCPAxis::atLeft) == 0) + yAxis = addAxis(QCPAxis::atLeft); + else + yAxis = axis(QCPAxis::atLeft); + + if (axisCount(QCPAxis::atTop) == 0) + xAxis2 = addAxis(QCPAxis::atTop); + else + xAxis2 = axis(QCPAxis::atTop); + + if (axisCount(QCPAxis::atRight) == 0) + yAxis2 = addAxis(QCPAxis::atRight); + else + yAxis2 = axis(QCPAxis::atRight); + + xAxis->setVisible(true); + yAxis->setVisible(true); + xAxis2->setVisible(true); + yAxis2->setVisible(true); + xAxis2->setTickLabels(false); + yAxis2->setTickLabels(false); + + xAxis2->setRange(xAxis->range()); + xAxis2->setRangeReversed(xAxis->rangeReversed()); + xAxis2->setScaleType(xAxis->scaleType()); + xAxis2->setScaleLogBase(xAxis->scaleLogBase()); + xAxis2->setTicks(xAxis->ticks()); + xAxis2->setAutoTickCount(xAxis->autoTickCount()); + xAxis2->setSubTickCount(xAxis->subTickCount()); + xAxis2->setAutoSubTicks(xAxis->autoSubTicks()); + xAxis2->setTickStep(xAxis->tickStep()); + xAxis2->setAutoTickStep(xAxis->autoTickStep()); + xAxis2->setNumberFormat(xAxis->numberFormat()); + xAxis2->setNumberPrecision(xAxis->numberPrecision()); + xAxis2->setTickLabelType(xAxis->tickLabelType()); + xAxis2->setDateTimeFormat(xAxis->dateTimeFormat()); + xAxis2->setDateTimeSpec(xAxis->dateTimeSpec()); + + yAxis2->setRange(yAxis->range()); + yAxis2->setRangeReversed(yAxis->rangeReversed()); + yAxis2->setScaleType(yAxis->scaleType()); + yAxis2->setScaleLogBase(yAxis->scaleLogBase()); + yAxis2->setTicks(yAxis->ticks()); + yAxis2->setAutoTickCount(yAxis->autoTickCount()); + yAxis2->setSubTickCount(yAxis->subTickCount()); + yAxis2->setAutoSubTicks(yAxis->autoSubTicks()); + yAxis2->setTickStep(yAxis->tickStep()); + yAxis2->setAutoTickStep(yAxis->autoTickStep()); + yAxis2->setNumberFormat(yAxis->numberFormat()); + yAxis2->setNumberPrecision(yAxis->numberPrecision()); + yAxis2->setTickLabelType(yAxis->tickLabelType()); + yAxis2->setDateTimeFormat(yAxis->dateTimeFormat()); + yAxis2->setDateTimeSpec(yAxis->dateTimeSpec()); + + if (connectRanges) + { + connect(xAxis, SIGNAL(rangeChanged(QCPRange)), xAxis2, SLOT(setRange(QCPRange))); + connect(yAxis, SIGNAL(rangeChanged(QCPRange)), yAxis2, SLOT(setRange(QCPRange))); + } +} + +/*! + Returns a list of all the plottables that are associated with this axis rect. + + A plottable is considered associated with an axis rect if its key or value axis (or both) is in + this axis rect. + + \see graphs, items +*/ +QList QCPAxisRect::plottables() const +{ + // Note: don't append all QCPAxis::plottables() into a list, because we might get duplicate entries + QList result; + for (int i=0; imPlottables.size(); ++i) + { + if (mParentPlot->mPlottables.at(i)->keyAxis()->axisRect() == this ||mParentPlot->mPlottables.at(i)->valueAxis()->axisRect() == this) + result.append(mParentPlot->mPlottables.at(i)); + } + return result; +} + +/*! + Returns a list of all the graphs that are associated with this axis rect. + + A graph is considered associated with an axis rect if its key or value axis (or both) is in + this axis rect. + + \see plottables, items +*/ +QList QCPAxisRect::graphs() const +{ + // Note: don't append all QCPAxis::graphs() into a list, because we might get duplicate entries + QList result; + for (int i=0; imGraphs.size(); ++i) + { + if (mParentPlot->mGraphs.at(i)->keyAxis()->axisRect() == this || mParentPlot->mGraphs.at(i)->valueAxis()->axisRect() == this) + result.append(mParentPlot->mGraphs.at(i)); + } + return result; +} + +/*! + Returns a list of all the items that are associated with this axis rect. + + An item is considered associated with an axis rect if any of its positions has key or value axis + set to an axis that is in this axis rect, or if any of its positions has \ref + QCPItemPosition::setAxisRect set to the axis rect, or if the clip axis rect (\ref + QCPAbstractItem::setClipAxisRect) is set to this axis rect. + + \see plottables, graphs +*/ +QList QCPAxisRect::items() const +{ + // Note: don't just append all QCPAxis::items() into a list, because we might get duplicate entries + // and miss those items that have this axis rect as clipAxisRect. + QList result; + for (int itemId=0; itemIdmItems.size(); ++itemId) + { + if (mParentPlot->mItems.at(itemId)->clipAxisRect() == this) + { + result.append(mParentPlot->mItems.at(itemId)); + continue; + } + QList positions = mParentPlot->mItems.at(itemId)->positions(); + for (int posId=0; posIdaxisRect() == this || + positions.at(posId)->keyAxis()->axisRect() == this || + positions.at(posId)->valueAxis()->axisRect() == this) + { + result.append(mParentPlot->mItems.at(itemId)); + break; + } + } + } + return result; +} + +/*! + This method is called automatically upon replot and doesn't need to be called by users of + QCPAxisRect. + + Calls the base class implementation to update the margins (see \ref QCPLayoutElement::update), + and finally passes the \ref rect to the inset layout (\ref insetLayout) and calls its + QCPInsetLayout::update function. +*/ +void QCPAxisRect::update(UpdatePhase phase) +{ + QCPLayoutElement::update(phase); + + switch (phase) + { + case upPreparation: + { + QList allAxes = axes(); + for (int i=0; isetupTickVectors(); + break; + } + case upLayout: + { + mInsetLayout->setOuterRect(rect()); + break; + } + default: break; + } + + // pass update call on to inset layout (doesn't happen automatically, because QCPAxisRect doesn't derive from QCPLayout): + mInsetLayout->update(phase); +} + +/* inherits documentation from base class */ +QList QCPAxisRect::elements(bool recursive) const +{ + QList result; + if (mInsetLayout) + { + result << mInsetLayout; + if (recursive) + result << mInsetLayout->elements(recursive); + } + return result; +} + +/* inherits documentation from base class */ +void QCPAxisRect::applyDefaultAntialiasingHint(QCPPainter *painter) const +{ + painter->setAntialiasing(false); +} + +/* inherits documentation from base class */ +void QCPAxisRect::draw(QCPPainter *painter) +{ + drawBackground(painter); +} + +/*! + Sets \a pm as the axis background pixmap. The axis background pixmap will be drawn inside the + axis rect. Since axis rects place themselves on the "background" layer by default, the axis rect + backgrounds are usually drawn below everything else. + + For cases where the provided pixmap doesn't have the same size as the axis rect, scaling can be + enabled with \ref setBackgroundScaled and the scaling mode (i.e. whether and how the aspect ratio + is preserved) can be set with \ref setBackgroundScaledMode. To set all these options in one call, + consider using the overloaded version of this function. + + Below the pixmap, the axis rect may be optionally filled with a brush, if specified with \ref + setBackground(const QBrush &brush). + + \see setBackgroundScaled, setBackgroundScaledMode, setBackground(const QBrush &brush) +*/ +void QCPAxisRect::setBackground(const QPixmap &pm) +{ + mBackgroundPixmap = pm; + mScaledBackgroundPixmap = QPixmap(); +} + +/*! \overload + + Sets \a brush as the background brush. The axis rect background will be filled with this brush. + Since axis rects place themselves on the "background" layer by default, the axis rect backgrounds + are usually drawn below everything else. + + The brush will be drawn before (under) any background pixmap, which may be specified with \ref + setBackground(const QPixmap &pm). + + To disable drawing of a background brush, set \a brush to Qt::NoBrush. + + \see setBackground(const QPixmap &pm) +*/ +void QCPAxisRect::setBackground(const QBrush &brush) +{ + mBackgroundBrush = brush; +} + +/*! \overload + + Allows setting the background pixmap of the axis rect, whether it shall be scaled and how it + shall be scaled in one call. + + \see setBackground(const QPixmap &pm), setBackgroundScaled, setBackgroundScaledMode +*/ +void QCPAxisRect::setBackground(const QPixmap &pm, bool scaled, Qt::AspectRatioMode mode) +{ + mBackgroundPixmap = pm; + mScaledBackgroundPixmap = QPixmap(); + mBackgroundScaled = scaled; + mBackgroundScaledMode = mode; +} + +/*! + Sets whether the axis background pixmap shall be scaled to fit the axis rect or not. If \a scaled + is set to true, you may control whether and how the aspect ratio of the original pixmap is + preserved with \ref setBackgroundScaledMode. + + Note that the scaled version of the original pixmap is buffered, so there is no performance + penalty on replots. (Except when the axis rect dimensions are changed continuously.) + + \see setBackground, setBackgroundScaledMode +*/ +void QCPAxisRect::setBackgroundScaled(bool scaled) +{ + mBackgroundScaled = scaled; +} + +/*! + If scaling of the axis background pixmap is enabled (\ref setBackgroundScaled), use this function to + define whether and how the aspect ratio of the original pixmap passed to \ref setBackground is preserved. + \see setBackground, setBackgroundScaled +*/ +void QCPAxisRect::setBackgroundScaledMode(Qt::AspectRatioMode mode) +{ + mBackgroundScaledMode = mode; +} + +/*! + Returns the range drag axis of the \a orientation provided. + + \see setRangeDragAxes +*/ +QCPAxis *QCPAxisRect::rangeDragAxis(Qt::Orientation orientation) +{ + return (orientation == Qt::Horizontal ? mRangeDragHorzAxis.data() : mRangeDragVertAxis.data()); +} + +/*! + Returns the range zoom axis of the \a orientation provided. + + \see setRangeZoomAxes +*/ +QCPAxis *QCPAxisRect::rangeZoomAxis(Qt::Orientation orientation) +{ + return (orientation == Qt::Horizontal ? mRangeZoomHorzAxis.data() : mRangeZoomVertAxis.data()); +} + +/*! + Returns the range zoom factor of the \a orientation provided. + + \see setRangeZoomFactor +*/ +double QCPAxisRect::rangeZoomFactor(Qt::Orientation orientation) +{ + return (orientation == Qt::Horizontal ? mRangeZoomFactorHorz : mRangeZoomFactorVert); +} + +/*! + Sets which axis orientation may be range dragged by the user with mouse interaction. + What orientation corresponds to which specific axis can be set with + \ref setRangeDragAxes(QCPAxis *horizontal, QCPAxis *vertical). By + default, the horizontal axis is the bottom axis (xAxis) and the vertical axis + is the left axis (yAxis). + + To disable range dragging entirely, pass 0 as \a orientations or remove \ref QCP::iRangeDrag from \ref + QCustomPlot::setInteractions. To enable range dragging for both directions, pass Qt::Horizontal | + Qt::Vertical as \a orientations. + + In addition to setting \a orientations to a non-zero value, make sure \ref QCustomPlot::setInteractions + contains \ref QCP::iRangeDrag to enable the range dragging interaction. + + \see setRangeZoom, setRangeDragAxes, QCustomPlot::setNoAntialiasingOnDrag +*/ +void QCPAxisRect::setRangeDrag(Qt::Orientations orientations) +{ + mRangeDrag = orientations; +} + +/*! + Sets which axis orientation may be zoomed by the user with the mouse wheel. What orientation + corresponds to which specific axis can be set with \ref setRangeZoomAxes(QCPAxis *horizontal, + QCPAxis *vertical). By default, the horizontal axis is the bottom axis (xAxis) and the vertical + axis is the left axis (yAxis). + + To disable range zooming entirely, pass 0 as \a orientations or remove \ref QCP::iRangeZoom from \ref + QCustomPlot::setInteractions. To enable range zooming for both directions, pass Qt::Horizontal | + Qt::Vertical as \a orientations. + + In addition to setting \a orientations to a non-zero value, make sure \ref QCustomPlot::setInteractions + contains \ref QCP::iRangeZoom to enable the range zooming interaction. + + \see setRangeZoomFactor, setRangeZoomAxes, setRangeDrag +*/ +void QCPAxisRect::setRangeZoom(Qt::Orientations orientations) +{ + mRangeZoom = orientations; +} + +/*! + Sets the axes whose range will be dragged when \ref setRangeDrag enables mouse range dragging + on the QCustomPlot widget. + + \see setRangeZoomAxes +*/ +void QCPAxisRect::setRangeDragAxes(QCPAxis *horizontal, QCPAxis *vertical) +{ + mRangeDragHorzAxis = horizontal; + mRangeDragVertAxis = vertical; +} + +/*! + Sets the axes whose range will be zoomed when \ref setRangeZoom enables mouse wheel zooming on the + QCustomPlot widget. The two axes can be zoomed with different strengths, when different factors + are passed to \ref setRangeZoomFactor(double horizontalFactor, double verticalFactor). + + \see setRangeDragAxes +*/ +void QCPAxisRect::setRangeZoomAxes(QCPAxis *horizontal, QCPAxis *vertical) +{ + mRangeZoomHorzAxis = horizontal; + mRangeZoomVertAxis = vertical; +} + +/*! + Sets how strong one rotation step of the mouse wheel zooms, when range zoom was activated with + \ref setRangeZoom. The two parameters \a horizontalFactor and \a verticalFactor provide a way to + let the horizontal axis zoom at different rates than the vertical axis. Which axis is horizontal + and which is vertical, can be set with \ref setRangeZoomAxes. + + When the zoom factor is greater than one, scrolling the mouse wheel backwards (towards the user) + will zoom in (make the currently visible range smaller). For zoom factors smaller than one, the + same scrolling direction will zoom out. +*/ +void QCPAxisRect::setRangeZoomFactor(double horizontalFactor, double verticalFactor) +{ + mRangeZoomFactorHorz = horizontalFactor; + mRangeZoomFactorVert = verticalFactor; +} + +/*! \overload + + Sets both the horizontal and vertical zoom \a factor. +*/ +void QCPAxisRect::setRangeZoomFactor(double factor) +{ + mRangeZoomFactorHorz = factor; + mRangeZoomFactorVert = factor; +} + +/*! \internal + + Draws the background of this axis rect. It may consist of a background fill (a QBrush) and a + pixmap. + + If a brush was given via \ref setBackground(const QBrush &brush), this function first draws an + according filling inside the axis rect with the provided \a painter. + + Then, if a pixmap was provided via \ref setBackground, this function buffers the scaled version + depending on \ref setBackgroundScaled and \ref setBackgroundScaledMode and then draws it inside + the axis rect with the provided \a painter. The scaled version is buffered in + mScaledBackgroundPixmap to prevent expensive rescaling at every redraw. It is only updated, when + the axis rect has changed in a way that requires a rescale of the background pixmap (this is + dependant on the \ref setBackgroundScaledMode), or when a differend axis backgroud pixmap was + set. + + \see setBackground, setBackgroundScaled, setBackgroundScaledMode +*/ +void QCPAxisRect::drawBackground(QCPPainter *painter) +{ + // draw background fill: + if (mBackgroundBrush != Qt::NoBrush) + painter->fillRect(mRect, mBackgroundBrush); + + // draw background pixmap (on top of fill, if brush specified): + if (!mBackgroundPixmap.isNull()) + { + if (mBackgroundScaled) + { + // check whether mScaledBackground needs to be updated: + QSize scaledSize(mBackgroundPixmap.size()); + scaledSize.scale(mRect.size(), mBackgroundScaledMode); + if (mScaledBackgroundPixmap.size() != scaledSize) + mScaledBackgroundPixmap = mBackgroundPixmap.scaled(mRect.size(), mBackgroundScaledMode, Qt::SmoothTransformation); + painter->drawPixmap(mRect.topLeft()+QPoint(0, -1), mScaledBackgroundPixmap, QRect(0, 0, mRect.width(), mRect.height()) & mScaledBackgroundPixmap.rect()); + } else + { + painter->drawPixmap(mRect.topLeft()+QPoint(0, -1), mBackgroundPixmap, QRect(0, 0, mRect.width(), mRect.height())); + } + } +} + +/*! \internal + + This function makes sure multiple axes on the side specified with \a type don't collide, but are + distributed according to their respective space requirement (QCPAxis::calculateMargin). + + It does this by setting an appropriate offset (\ref QCPAxis::setOffset) on all axes except the + one with index zero. + + This function is called by \ref calculateAutoMargin. +*/ +void QCPAxisRect::updateAxesOffset(QCPAxis::AxisType type) +{ + const QList axesList = mAxes.value(type); + if (axesList.isEmpty()) + return; + + bool isFirstVisible = !axesList.first()->visible(); // if the first axis is visible, the second axis (which is where the loop starts) isn't the first visible axis, so initialize with false + for (int i=1; ioffset() + axesList.at(i-1)->calculateMargin(); + if (axesList.at(i)->visible()) // only add inner tick length to offset if this axis is visible and it's not the first visible one (might happen if true first axis is invisible) + { + if (!isFirstVisible) + offset += axesList.at(i)->tickLengthIn(); + isFirstVisible = false; + } + axesList.at(i)->setOffset(offset); + } +} + +/* inherits documentation from base class */ +int QCPAxisRect::calculateAutoMargin(QCP::MarginSide side) +{ + if (!mAutoMargins.testFlag(side)) + qDebug() << Q_FUNC_INFO << "Called with side that isn't specified as auto margin"; + + updateAxesOffset(QCPAxis::marginSideToAxisType(side)); + + // note: only need to look at the last (outer most) axis to determine the total margin, due to updateAxisOffset call + const QList axesList = mAxes.value(QCPAxis::marginSideToAxisType(side)); + if (axesList.size() > 0) + return axesList.last()->offset() + axesList.last()->calculateMargin(); + else + return 0; +} + +/*! \internal + + Event handler for when a mouse button is pressed on the axis rect. If the left mouse button is + pressed, the range dragging interaction is initialized (the actual range manipulation happens in + the \ref mouseMoveEvent). + + The mDragging flag is set to true and some anchor points are set that are needed to determine the + distance the mouse was dragged in the mouse move/release events later. + + \see mouseMoveEvent, mouseReleaseEvent +*/ +void QCPAxisRect::mousePressEvent(QMouseEvent *event) +{ + mDragStart = event->pos(); // need this even when not LeftButton is pressed, to determine in releaseEvent whether it was a full click (no position change between press and release) + if (event->buttons() & Qt::LeftButton) + { + mDragging = true; + // initialize antialiasing backup in case we start dragging: + if (mParentPlot->noAntialiasingOnDrag()) + { + mAADragBackup = mParentPlot->antialiasedElements(); + mNotAADragBackup = mParentPlot->notAntialiasedElements(); + } + // Mouse range dragging interaction: + if (mParentPlot->interactions().testFlag(QCP::iRangeDrag)) + { + if (mRangeDragHorzAxis) + mDragStartHorzRange = mRangeDragHorzAxis.data()->range(); + if (mRangeDragVertAxis) + mDragStartVertRange = mRangeDragVertAxis.data()->range(); + } + } +} + +/*! \internal + + Event handler for when the mouse is moved on the axis rect. If range dragging was activated in a + preceding \ref mousePressEvent, the range is moved accordingly. + + \see mousePressEvent, mouseReleaseEvent +*/ +void QCPAxisRect::mouseMoveEvent(QMouseEvent *event) +{ + // Mouse range dragging interaction: + if (mDragging && mParentPlot->interactions().testFlag(QCP::iRangeDrag)) + { + if (mRangeDrag.testFlag(Qt::Horizontal)) + { + if (QCPAxis *rangeDragHorzAxis = mRangeDragHorzAxis.data()) + { + if (rangeDragHorzAxis->mScaleType == QCPAxis::stLinear) + { + double diff = rangeDragHorzAxis->pixelToCoord(mDragStart.x()) - rangeDragHorzAxis->pixelToCoord(event->pos().x()); + rangeDragHorzAxis->setRange(mDragStartHorzRange.lower+diff, mDragStartHorzRange.upper+diff); + } else if (rangeDragHorzAxis->mScaleType == QCPAxis::stLogarithmic) + { + double diff = rangeDragHorzAxis->pixelToCoord(mDragStart.x()) / rangeDragHorzAxis->pixelToCoord(event->pos().x()); + rangeDragHorzAxis->setRange(mDragStartHorzRange.lower*diff, mDragStartHorzRange.upper*diff); + } + } + } + if (mRangeDrag.testFlag(Qt::Vertical)) + { + if (QCPAxis *rangeDragVertAxis = mRangeDragVertAxis.data()) + { + if (rangeDragVertAxis->mScaleType == QCPAxis::stLinear) + { + double diff = rangeDragVertAxis->pixelToCoord(mDragStart.y()) - rangeDragVertAxis->pixelToCoord(event->pos().y()); + rangeDragVertAxis->setRange(mDragStartVertRange.lower+diff, mDragStartVertRange.upper+diff); + } else if (rangeDragVertAxis->mScaleType == QCPAxis::stLogarithmic) + { + double diff = rangeDragVertAxis->pixelToCoord(mDragStart.y()) / rangeDragVertAxis->pixelToCoord(event->pos().y()); + rangeDragVertAxis->setRange(mDragStartVertRange.lower*diff, mDragStartVertRange.upper*diff); + } + } + } + if (mRangeDrag != 0) // if either vertical or horizontal drag was enabled, do a replot + { + if (mParentPlot->noAntialiasingOnDrag()) + mParentPlot->setNotAntialiasedElements(QCP::aeAll); + mParentPlot->replot(); + } + } +} + +/* inherits documentation from base class */ +void QCPAxisRect::mouseReleaseEvent(QMouseEvent *event) +{ + Q_UNUSED(event) + mDragging = false; + if (mParentPlot->noAntialiasingOnDrag()) + { + mParentPlot->setAntialiasedElements(mAADragBackup); + mParentPlot->setNotAntialiasedElements(mNotAADragBackup); + } +} + +/*! \internal + + Event handler for mouse wheel events. If rangeZoom is Qt::Horizontal, Qt::Vertical or both, the + ranges of the axes defined as rangeZoomHorzAxis and rangeZoomVertAxis are scaled. The center of + the scaling operation is the current cursor position inside the axis rect. The scaling factor is + dependant on the mouse wheel delta (which direction the wheel was rotated) to provide a natural + zooming feel. The Strength of the zoom can be controlled via \ref setRangeZoomFactor. + + Note, that event->delta() is usually +/-120 for single rotation steps. However, if the mouse + wheel is turned rapidly, many steps may bunch up to one event, so the event->delta() may then be + multiples of 120. This is taken into account here, by calculating \a wheelSteps and using it as + exponent of the range zoom factor. This takes care of the wheel direction automatically, by + inverting the factor, when the wheel step is negative (f^-1 = 1/f). +*/ +void QCPAxisRect::wheelEvent(QWheelEvent *event) +{ + // Mouse range zooming interaction: + if (mParentPlot->interactions().testFlag(QCP::iRangeZoom)) + { + if (mRangeZoom != 0) + { + double factor; + double wheelSteps = event->delta()/120.0; // a single step delta is +/-120 usually + if (mRangeZoom.testFlag(Qt::Horizontal)) + { + factor = qPow(mRangeZoomFactorHorz, wheelSteps); + if (mRangeZoomHorzAxis.data()) + mRangeZoomHorzAxis.data()->scaleRange(factor, mRangeZoomHorzAxis.data()->pixelToCoord(event->pos().x())); + } + if (mRangeZoom.testFlag(Qt::Vertical)) + { + factor = qPow(mRangeZoomFactorVert, wheelSteps); + if (mRangeZoomVertAxis.data()) + mRangeZoomVertAxis.data()->scaleRange(factor, mRangeZoomVertAxis.data()->pixelToCoord(event->pos().y())); + } + mParentPlot->replot(); + } + } +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAbstractLegendItem +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPAbstractLegendItem + \brief The abstract base class for all entries in a QCPLegend. + + It defines a very basic interface for entries in a QCPLegend. For representing plottables in the + legend, the subclass \ref QCPPlottableLegendItem is more suitable. + + Only derive directly from this class when you need absolute freedom (e.g. a custom legend entry + that's not even associated with a plottable). + + You must implement the following pure virtual functions: + \li \ref draw (from QCPLayerable) + + You inherit the following members you may use: + + + + + + + + +
QCPLegend *\b mParentLegendA pointer to the parent QCPLegend.
QFont \b mFontThe generic font of the item. You should use this font for all or at least the most prominent text of the item.
+*/ + +/* start of documentation of signals */ + +/*! \fn void QCPAbstractLegendItem::selectionChanged(bool selected) + + This signal is emitted when the selection state of this legend item has changed, either by user + interaction or by a direct call to \ref setSelected. +*/ + +/* end of documentation of signals */ + +/*! + Constructs a QCPAbstractLegendItem and associates it with the QCPLegend \a parent. This does not + cause the item to be added to \a parent, so \ref QCPLegend::addItem must be called separately. +*/ +QCPAbstractLegendItem::QCPAbstractLegendItem(QCPLegend *parent) : + QCPLayoutElement(parent->parentPlot()), + mParentLegend(parent), + mFont(parent->font()), + mTextColor(parent->textColor()), + mSelectedFont(parent->selectedFont()), + mSelectedTextColor(parent->selectedTextColor()), + mSelectable(true), + mSelected(false) +{ + setLayer(QLatin1String("legend")); + setMargins(QMargins(8, 2, 8, 2)); +} + +/*! + Sets the default font of this specific legend item to \a font. + + \see setTextColor, QCPLegend::setFont +*/ +void QCPAbstractLegendItem::setFont(const QFont &font) +{ + mFont = font; +} + +/*! + Sets the default text color of this specific legend item to \a color. + + \see setFont, QCPLegend::setTextColor +*/ +void QCPAbstractLegendItem::setTextColor(const QColor &color) +{ + mTextColor = color; +} + +/*! + When this legend item is selected, \a font is used to draw generic text, instead of the normal + font set with \ref setFont. + + \see setFont, QCPLegend::setSelectedFont +*/ +void QCPAbstractLegendItem::setSelectedFont(const QFont &font) +{ + mSelectedFont = font; +} + +/*! + When this legend item is selected, \a color is used to draw generic text, instead of the normal + color set with \ref setTextColor. + + \see setTextColor, QCPLegend::setSelectedTextColor +*/ +void QCPAbstractLegendItem::setSelectedTextColor(const QColor &color) +{ + mSelectedTextColor = color; +} + +/*! + Sets whether this specific legend item is selectable. + + \see setSelectedParts, QCustomPlot::setInteractions +*/ +void QCPAbstractLegendItem::setSelectable(bool selectable) +{ + if (mSelectable != selectable) + { + mSelectable = selectable; + emit selectableChanged(mSelectable); + } +} + +/*! + Sets whether this specific legend item is selected. + + It is possible to set the selection state of this item by calling this function directly, even if + setSelectable is set to false. + + \see setSelectableParts, QCustomPlot::setInteractions +*/ +void QCPAbstractLegendItem::setSelected(bool selected) +{ + if (mSelected != selected) + { + mSelected = selected; + emit selectionChanged(mSelected); + } +} + +/* inherits documentation from base class */ +double QCPAbstractLegendItem::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (!mParentPlot) return -1; + if (onlySelectable && (!mSelectable || !mParentLegend->selectableParts().testFlag(QCPLegend::spItems))) + return -1; + + if (mRect.contains(pos.toPoint())) + return mParentPlot->selectionTolerance()*0.99; + else + return -1; +} + +/* inherits documentation from base class */ +void QCPAbstractLegendItem::applyDefaultAntialiasingHint(QCPPainter *painter) const +{ + applyAntialiasingHint(painter, mAntialiased, QCP::aeLegendItems); +} + +/* inherits documentation from base class */ +QRect QCPAbstractLegendItem::clipRect() const +{ + return mOuterRect; +} + +/* inherits documentation from base class */ +void QCPAbstractLegendItem::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) +{ + Q_UNUSED(event) + Q_UNUSED(details) + if (mSelectable && mParentLegend->selectableParts().testFlag(QCPLegend::spItems)) + { + bool selBefore = mSelected; + setSelected(additive ? !mSelected : true); + if (selectionStateChanged) + *selectionStateChanged = mSelected != selBefore; + } +} + +/* inherits documentation from base class */ +void QCPAbstractLegendItem::deselectEvent(bool *selectionStateChanged) +{ + if (mSelectable && mParentLegend->selectableParts().testFlag(QCPLegend::spItems)) + { + bool selBefore = mSelected; + setSelected(false); + if (selectionStateChanged) + *selectionStateChanged = mSelected != selBefore; + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPPlottableLegendItem +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPPlottableLegendItem + \brief A legend item representing a plottable with an icon and the plottable name. + + This is the standard legend item for plottables. It displays an icon of the plottable next to the + plottable name. The icon is drawn by the respective plottable itself (\ref + QCPAbstractPlottable::drawLegendIcon), and tries to give an intuitive symbol for the plottable. + For example, the QCPGraph draws a centered horizontal line and/or a single scatter point in the + middle. + + Legend items of this type are always associated with one plottable (retrievable via the + plottable() function and settable with the constructor). You may change the font of the plottable + name with \ref setFont. Icon padding and border pen is taken from the parent QCPLegend, see \ref + QCPLegend::setIconBorderPen and \ref QCPLegend::setIconTextPadding. + + The function \ref QCPAbstractPlottable::addToLegend/\ref QCPAbstractPlottable::removeFromLegend + creates/removes legend items of this type in the default implementation. However, these functions + may be reimplemented such that a different kind of legend item (e.g a direct subclass of + QCPAbstractLegendItem) is used for that plottable. + + Since QCPLegend is based on QCPLayoutGrid, a legend item itself is just a subclass of + QCPLayoutElement. While it could be added to a legend (or any other layout) via the normal layout + interface, QCPLegend has specialized functions for handling legend items conveniently, see the + documentation of \ref QCPLegend. +*/ + +/*! + Creates a new legend item associated with \a plottable. + + Once it's created, it can be added to the legend via \ref QCPLegend::addItem. + + A more convenient way of adding/removing a plottable to/from the legend is via the functions \ref + QCPAbstractPlottable::addToLegend and \ref QCPAbstractPlottable::removeFromLegend. +*/ +QCPPlottableLegendItem::QCPPlottableLegendItem(QCPLegend *parent, QCPAbstractPlottable *plottable) : + QCPAbstractLegendItem(parent), + mPlottable(plottable) +{ +} + +/*! \internal + + Returns the pen that shall be used to draw the icon border, taking into account the selection + state of this item. +*/ +QPen QCPPlottableLegendItem::getIconBorderPen() const +{ + return mSelected ? mParentLegend->selectedIconBorderPen() : mParentLegend->iconBorderPen(); +} + +/*! \internal + + Returns the text color that shall be used to draw text, taking into account the selection state + of this item. +*/ +QColor QCPPlottableLegendItem::getTextColor() const +{ + return mSelected ? mSelectedTextColor : mTextColor; +} + +/*! \internal + + Returns the font that shall be used to draw text, taking into account the selection state of this + item. +*/ +QFont QCPPlottableLegendItem::getFont() const +{ + return mSelected ? mSelectedFont : mFont; +} + +/*! \internal + + Draws the item with \a painter. The size and position of the drawn legend item is defined by the + parent layout (typically a \ref QCPLegend) and the \ref minimumSizeHint and \ref maximumSizeHint + of this legend item. +*/ +void QCPPlottableLegendItem::draw(QCPPainter *painter) +{ + if (!mPlottable) return; + painter->setFont(getFont()); + painter->setPen(QPen(getTextColor())); + QSizeF iconSize = mParentLegend->iconSize(); + QRectF textRect = painter->fontMetrics().boundingRect(0, 0, 0, iconSize.height(), Qt::TextDontClip, mPlottable->name()); + QRectF iconRect(mRect.topLeft(), iconSize); + int textHeight = qMax(textRect.height(), iconSize.height()); // if text has smaller height than icon, center text vertically in icon height, else align tops + painter->drawText(mRect.x()+iconSize.width()+mParentLegend->iconTextPadding(), mRect.y(), textRect.width(), textHeight, Qt::TextDontClip, mPlottable->name()); + // draw icon: + painter->save(); + painter->setClipRect(iconRect, Qt::IntersectClip); + mPlottable->drawLegendIcon(painter, iconRect); + painter->restore(); + // draw icon border: + if (getIconBorderPen().style() != Qt::NoPen) + { + painter->setPen(getIconBorderPen()); + painter->setBrush(Qt::NoBrush); + painter->drawRect(iconRect); + } +} + +/*! \internal + + Calculates and returns the size of this item. This includes the icon, the text and the padding in + between. +*/ +QSize QCPPlottableLegendItem::minimumSizeHint() const +{ + if (!mPlottable) return QSize(); + QSize result(0, 0); + QRect textRect; + QFontMetrics fontMetrics(getFont()); + QSize iconSize = mParentLegend->iconSize(); + textRect = fontMetrics.boundingRect(0, 0, 0, iconSize.height(), Qt::TextDontClip, mPlottable->name()); + result.setWidth(iconSize.width() + mParentLegend->iconTextPadding() + textRect.width() + mMargins.left() + mMargins.right()); + result.setHeight(qMax(textRect.height(), iconSize.height()) + mMargins.top() + mMargins.bottom()); + return result; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPLegend +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPLegend + \brief Manages a legend inside a QCustomPlot. + + A legend is a small box somewhere in the plot which lists plottables with their name and icon. + + Normally, the legend is populated by calling \ref QCPAbstractPlottable::addToLegend. The + respective legend item can be removed with \ref QCPAbstractPlottable::removeFromLegend. However, + QCPLegend also offers an interface to add and manipulate legend items directly: \ref item, \ref + itemWithPlottable, \ref itemCount, \ref addItem, \ref removeItem, etc. + + The QCPLegend derives from QCPLayoutGrid and as such can be placed in any position a + QCPLayoutElement may be positioned. The legend items are themselves QCPLayoutElements which are + placed in the grid layout of the legend. QCPLegend only adds an interface specialized for + handling child elements of type QCPAbstractLegendItem, as mentioned above. In principle, any + other layout elements may also be added to a legend via the normal \ref QCPLayoutGrid interface. + However, the QCPAbstractLegendItem-Interface will ignore those elements (e.g. \ref itemCount will + only return the number of items with QCPAbstractLegendItems type). + + By default, every QCustomPlot has one legend (QCustomPlot::legend) which is placed in the inset + layout of the main axis rect (\ref QCPAxisRect::insetLayout). To move the legend to another + position inside the axis rect, use the methods of the \ref QCPLayoutInset. To move the legend + outside of the axis rect, place it anywhere else with the QCPLayout/QCPLayoutElement interface. +*/ + +/* start of documentation of signals */ + +/*! \fn void QCPLegend::selectionChanged(QCPLegend::SelectableParts selection); + + This signal is emitted when the selection state of this legend has changed. + + \see setSelectedParts, setSelectableParts +*/ + +/* end of documentation of signals */ + +/*! + Constructs a new QCPLegend instance with \a parentPlot as the containing plot and default values. + + Note that by default, QCustomPlot already contains a legend ready to be used as + QCustomPlot::legend +*/ +QCPLegend::QCPLegend() +{ + setRowSpacing(0); + setColumnSpacing(10); + setMargins(QMargins(2, 3, 2, 2)); + setAntialiased(false); + setIconSize(32, 18); + + setIconTextPadding(7); + + setSelectableParts(spLegendBox | spItems); + setSelectedParts(spNone); + + setBorderPen(QPen(Qt::black)); + setSelectedBorderPen(QPen(Qt::blue, 2)); + setIconBorderPen(Qt::NoPen); + setSelectedIconBorderPen(QPen(Qt::blue, 2)); + setBrush(Qt::white); + setSelectedBrush(Qt::white); + setTextColor(Qt::black); + setSelectedTextColor(Qt::blue); +} + +QCPLegend::~QCPLegend() +{ + clearItems(); + if (qobject_cast(mParentPlot)) // make sure this isn't called from QObject dtor when QCustomPlot is already destructed (happens when the legend is not in any layout and thus QObject-child of QCustomPlot) + mParentPlot->legendRemoved(this); +} + +/* no doc for getter, see setSelectedParts */ +QCPLegend::SelectableParts QCPLegend::selectedParts() const +{ + // check whether any legend elements selected, if yes, add spItems to return value + bool hasSelectedItems = false; + for (int i=0; iselected()) + { + hasSelectedItems = true; + break; + } + } + if (hasSelectedItems) + return mSelectedParts | spItems; + else + return mSelectedParts & ~spItems; +} + +/*! + Sets the pen, the border of the entire legend is drawn with. +*/ +void QCPLegend::setBorderPen(const QPen &pen) +{ + mBorderPen = pen; +} + +/*! + Sets the brush of the legend background. +*/ +void QCPLegend::setBrush(const QBrush &brush) +{ + mBrush = brush; +} + +/*! + Sets the default font of legend text. Legend items that draw text (e.g. the name of a graph) will + use this font by default. However, a different font can be specified on a per-item-basis by + accessing the specific legend item. + + This function will also set \a font on all already existing legend items. + + \see QCPAbstractLegendItem::setFont +*/ +void QCPLegend::setFont(const QFont &font) +{ + mFont = font; + for (int i=0; isetFont(mFont); + } +} + +/*! + Sets the default color of legend text. Legend items that draw text (e.g. the name of a graph) + will use this color by default. However, a different colors can be specified on a per-item-basis + by accessing the specific legend item. + + This function will also set \a color on all already existing legend items. + + \see QCPAbstractLegendItem::setTextColor +*/ +void QCPLegend::setTextColor(const QColor &color) +{ + mTextColor = color; + for (int i=0; isetTextColor(color); + } +} + +/*! + Sets the size of legend icons. Legend items that draw an icon (e.g. a visual + representation of the graph) will use this size by default. +*/ +void QCPLegend::setIconSize(const QSize &size) +{ + mIconSize = size; +} + +/*! \overload +*/ +void QCPLegend::setIconSize(int width, int height) +{ + mIconSize.setWidth(width); + mIconSize.setHeight(height); +} + +/*! + Sets the horizontal space in pixels between the legend icon and the text next to it. + Legend items that draw an icon (e.g. a visual representation of the graph) and text (e.g. the + name of the graph) will use this space by default. +*/ +void QCPLegend::setIconTextPadding(int padding) +{ + mIconTextPadding = padding; +} + +/*! + Sets the pen used to draw a border around each legend icon. Legend items that draw an + icon (e.g. a visual representation of the graph) will use this pen by default. + + If no border is wanted, set this to \a Qt::NoPen. +*/ +void QCPLegend::setIconBorderPen(const QPen &pen) +{ + mIconBorderPen = pen; +} + +/*! + Sets whether the user can (de-)select the parts in \a selectable by clicking on the QCustomPlot surface. + (When \ref QCustomPlot::setInteractions contains \ref QCP::iSelectLegend.) + + However, even when \a selectable is set to a value not allowing the selection of a specific part, + it is still possible to set the selection of this part manually, by calling \ref setSelectedParts + directly. + + \see SelectablePart, setSelectedParts +*/ +void QCPLegend::setSelectableParts(const SelectableParts &selectable) +{ + if (mSelectableParts != selectable) + { + mSelectableParts = selectable; + emit selectableChanged(mSelectableParts); + } +} + +/*! + Sets the selected state of the respective legend parts described by \ref SelectablePart. When a part + is selected, it uses a different pen/font and brush. If some legend items are selected and \a selected + doesn't contain \ref spItems, those items become deselected. + + The entire selection mechanism is handled automatically when \ref QCustomPlot::setInteractions + contains iSelectLegend. You only need to call this function when you wish to change the selection + state manually. + + This function can change the selection state of a part even when \ref setSelectableParts was set to a + value that actually excludes the part. + + emits the \ref selectionChanged signal when \a selected is different from the previous selection state. + + Note that it doesn't make sense to set the selected state \ref spItems here when it wasn't set + before, because there's no way to specify which exact items to newly select. Do this by calling + \ref QCPAbstractLegendItem::setSelected directly on the legend item you wish to select. + + \see SelectablePart, setSelectableParts, selectTest, setSelectedBorderPen, setSelectedIconBorderPen, setSelectedBrush, + setSelectedFont +*/ +void QCPLegend::setSelectedParts(const SelectableParts &selected) +{ + SelectableParts newSelected = selected; + mSelectedParts = this->selectedParts(); // update mSelectedParts in case item selection changed + + if (mSelectedParts != newSelected) + { + if (!mSelectedParts.testFlag(spItems) && newSelected.testFlag(spItems)) // attempt to set spItems flag (can't do that) + { + qDebug() << Q_FUNC_INFO << "spItems flag can not be set, it can only be unset with this function"; + newSelected &= ~spItems; + } + if (mSelectedParts.testFlag(spItems) && !newSelected.testFlag(spItems)) // spItems flag was unset, so clear item selection + { + for (int i=0; isetSelected(false); + } + } + mSelectedParts = newSelected; + emit selectionChanged(mSelectedParts); + } +} + +/*! + When the legend box is selected, this pen is used to draw the border instead of the normal pen + set via \ref setBorderPen. + + \see setSelectedParts, setSelectableParts, setSelectedBrush +*/ +void QCPLegend::setSelectedBorderPen(const QPen &pen) +{ + mSelectedBorderPen = pen; +} + +/*! + Sets the pen legend items will use to draw their icon borders, when they are selected. + + \see setSelectedParts, setSelectableParts, setSelectedFont +*/ +void QCPLegend::setSelectedIconBorderPen(const QPen &pen) +{ + mSelectedIconBorderPen = pen; +} + +/*! + When the legend box is selected, this brush is used to draw the legend background instead of the normal brush + set via \ref setBrush. + + \see setSelectedParts, setSelectableParts, setSelectedBorderPen +*/ +void QCPLegend::setSelectedBrush(const QBrush &brush) +{ + mSelectedBrush = brush; +} + +/*! + Sets the default font that is used by legend items when they are selected. + + This function will also set \a font on all already existing legend items. + + \see setFont, QCPAbstractLegendItem::setSelectedFont +*/ +void QCPLegend::setSelectedFont(const QFont &font) +{ + mSelectedFont = font; + for (int i=0; isetSelectedFont(font); + } +} + +/*! + Sets the default text color that is used by legend items when they are selected. + + This function will also set \a color on all already existing legend items. + + \see setTextColor, QCPAbstractLegendItem::setSelectedTextColor +*/ +void QCPLegend::setSelectedTextColor(const QColor &color) +{ + mSelectedTextColor = color; + for (int i=0; isetSelectedTextColor(color); + } +} + +/*! + Returns the item with index \a i. + + \see itemCount +*/ +QCPAbstractLegendItem *QCPLegend::item(int index) const +{ + return qobject_cast(elementAt(index)); +} + +/*! + Returns the QCPPlottableLegendItem which is associated with \a plottable (e.g. a \ref QCPGraph*). + If such an item isn't in the legend, returns 0. + + \see hasItemWithPlottable +*/ +QCPPlottableLegendItem *QCPLegend::itemWithPlottable(const QCPAbstractPlottable *plottable) const +{ + for (int i=0; i(item(i))) + { + if (pli->plottable() == plottable) + return pli; + } + } + return 0; +} + +/*! + Returns the number of items currently in the legend. + \see item +*/ +int QCPLegend::itemCount() const +{ + return elementCount(); +} + +/*! + Returns whether the legend contains \a itm. +*/ +bool QCPLegend::hasItem(QCPAbstractLegendItem *item) const +{ + for (int i=0; iitem(i)) + return true; + } + return false; +} + +/*! + Returns whether the legend contains a QCPPlottableLegendItem which is associated with \a plottable (e.g. a \ref QCPGraph*). + If such an item isn't in the legend, returns false. + + \see itemWithPlottable +*/ +bool QCPLegend::hasItemWithPlottable(const QCPAbstractPlottable *plottable) const +{ + return itemWithPlottable(plottable); +} + +/*! + Adds \a item to the legend, if it's not present already. + + Returns true on sucess, i.e. if the item wasn't in the list already and has been successfuly added. + + The legend takes ownership of the item. +*/ +bool QCPLegend::addItem(QCPAbstractLegendItem *item) +{ + if (!hasItem(item)) + { + return addElement(rowCount(), 0, item); + } else + return false; +} + +/*! + Removes the item with index \a index from the legend. + + Returns true, if successful. + + \see itemCount, clearItems +*/ +bool QCPLegend::removeItem(int index) +{ + if (QCPAbstractLegendItem *ali = item(index)) + { + bool success = remove(ali); + simplify(); + return success; + } else + return false; +} + +/*! \overload + + Removes \a item from the legend. + + Returns true, if successful. + + \see clearItems +*/ +bool QCPLegend::removeItem(QCPAbstractLegendItem *item) +{ + bool success = remove(item); + simplify(); + return success; +} + +/*! + Removes all items from the legend. +*/ +void QCPLegend::clearItems() +{ + for (int i=itemCount()-1; i>=0; --i) + removeItem(i); +} + +/*! + Returns the legend items that are currently selected. If no items are selected, + the list is empty. + + \see QCPAbstractLegendItem::setSelected, setSelectable +*/ +QList QCPLegend::selectedItems() const +{ + QList result; + for (int i=0; iselected()) + result.append(ali); + } + } + return result; +} + +/*! \internal + + A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter + before drawing main legend elements. + + This is the antialiasing state the painter passed to the \ref draw method is in by default. + + This function takes into account the local setting of the antialiasing flag as well as the + overrides set with \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. + + \see setAntialiased +*/ +void QCPLegend::applyDefaultAntialiasingHint(QCPPainter *painter) const +{ + applyAntialiasingHint(painter, mAntialiased, QCP::aeLegend); +} + +/*! \internal + + Returns the pen used to paint the border of the legend, taking into account the selection state + of the legend box. +*/ +QPen QCPLegend::getBorderPen() const +{ + return mSelectedParts.testFlag(spLegendBox) ? mSelectedBorderPen : mBorderPen; +} + +/*! \internal + + Returns the brush used to paint the background of the legend, taking into account the selection + state of the legend box. +*/ +QBrush QCPLegend::getBrush() const +{ + return mSelectedParts.testFlag(spLegendBox) ? mSelectedBrush : mBrush; +} + +/*! \internal + + Draws the legend box with the provided \a painter. The individual legend items are layerables + themselves, thus are drawn independently. +*/ +void QCPLegend::draw(QCPPainter *painter) +{ + // draw background rect: + painter->setBrush(getBrush()); + painter->setPen(getBorderPen()); + painter->drawRect(mOuterRect); +} + +/* inherits documentation from base class */ +double QCPLegend::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + if (!mParentPlot) return -1; + if (onlySelectable && !mSelectableParts.testFlag(spLegendBox)) + return -1; + + if (mOuterRect.contains(pos.toPoint())) + { + if (details) details->setValue(spLegendBox); + return mParentPlot->selectionTolerance()*0.99; + } + return -1; +} + +/* inherits documentation from base class */ +void QCPLegend::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) +{ + Q_UNUSED(event) + mSelectedParts = selectedParts(); // in case item selection has changed + if (details.value() == spLegendBox && mSelectableParts.testFlag(spLegendBox)) + { + SelectableParts selBefore = mSelectedParts; + setSelectedParts(additive ? mSelectedParts^spLegendBox : mSelectedParts|spLegendBox); // no need to unset spItems in !additive case, because they will be deselected by QCustomPlot (they're normal QCPLayerables with own deselectEvent) + if (selectionStateChanged) + *selectionStateChanged = mSelectedParts != selBefore; + } +} + +/* inherits documentation from base class */ +void QCPLegend::deselectEvent(bool *selectionStateChanged) +{ + mSelectedParts = selectedParts(); // in case item selection has changed + if (mSelectableParts.testFlag(spLegendBox)) + { + SelectableParts selBefore = mSelectedParts; + setSelectedParts(selectedParts() & ~spLegendBox); + if (selectionStateChanged) + *selectionStateChanged = mSelectedParts != selBefore; + } +} + +/* inherits documentation from base class */ +QCP::Interaction QCPLegend::selectionCategory() const +{ + return QCP::iSelectLegend; +} + +/* inherits documentation from base class */ +QCP::Interaction QCPAbstractLegendItem::selectionCategory() const +{ + return QCP::iSelectLegend; +} + +/* inherits documentation from base class */ +void QCPLegend::parentPlotInitialized(QCustomPlot *parentPlot) +{ + Q_UNUSED(parentPlot) +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPPlotTitle +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPPlotTitle + \brief A layout element displaying a plot title text + + The text may be specified with \ref setText, theformatting can be controlled with \ref setFont + and \ref setTextColor. + + A plot title can be added as follows: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpplottitle-creation + + Since a plot title is a common requirement, QCustomPlot offers specialized selection signals for + easy interaction with QCPPlotTitle. If a layout element of type QCPPlotTitle is clicked, the + signal \ref QCustomPlot::titleClick is emitted. A double click emits the \ref + QCustomPlot::titleDoubleClick signal. +*/ + +/* start documentation of signals */ + +/*! \fn void QCPPlotTitle::selectionChanged(bool selected) + + This signal is emitted when the selection state has changed to \a selected, either by user + interaction or by a direct call to \ref setSelected. + + \see setSelected, setSelectable +*/ + +/* end documentation of signals */ + +/*! + Creates a new QCPPlotTitle instance and sets default values. The initial text is empty (\ref setText). + + To set the title text in the constructor, rather use \ref QCPPlotTitle(QCustomPlot *parentPlot, const QString &text). +*/ +QCPPlotTitle::QCPPlotTitle(QCustomPlot *parentPlot) : + QCPLayoutElement(parentPlot), + mFont(QFont(QLatin1String("sans serif"), 13*1.5, QFont::Bold)), + mTextColor(Qt::black), + mSelectedFont(QFont(QLatin1String("sans serif"), 13*1.6, QFont::Bold)), + mSelectedTextColor(Qt::blue), + mSelectable(false), + mSelected(false) +{ + if (parentPlot) + { + setLayer(parentPlot->currentLayer()); + mFont = QFont(parentPlot->font().family(), parentPlot->font().pointSize()*1.5, QFont::Bold); + mSelectedFont = QFont(parentPlot->font().family(), parentPlot->font().pointSize()*1.6, QFont::Bold); + } + setMargins(QMargins(5, 5, 5, 0)); +} + +/*! \overload + + Creates a new QCPPlotTitle instance and sets default values. The initial text is set to \a text. +*/ +QCPPlotTitle::QCPPlotTitle(QCustomPlot *parentPlot, const QString &text) : + QCPLayoutElement(parentPlot), + mText(text), + mFont(QFont(parentPlot->font().family(), parentPlot->font().pointSize()*1.5, QFont::Bold)), + mTextColor(Qt::black), + mSelectedFont(QFont(parentPlot->font().family(), parentPlot->font().pointSize()*1.6, QFont::Bold)), + mSelectedTextColor(Qt::blue), + mSelectable(false), + mSelected(false) +{ + setLayer(QLatin1String("axes")); + setMargins(QMargins(5, 5, 5, 0)); +} + +/*! + Sets the text that will be displayed to \a text. Multiple lines can be created by insertion of "\n". + + \see setFont, setTextColor +*/ +void QCPPlotTitle::setText(const QString &text) +{ + mText = text; +} + +/*! + Sets the \a font of the title text. + + \see setTextColor, setSelectedFont +*/ +void QCPPlotTitle::setFont(const QFont &font) +{ + mFont = font; +} + +/*! + Sets the \a color of the title text. + + \see setFont, setSelectedTextColor +*/ +void QCPPlotTitle::setTextColor(const QColor &color) +{ + mTextColor = color; +} + +/*! + Sets the \a font of the title text that will be used if the plot title is selected (\ref setSelected). + + \see setFont +*/ +void QCPPlotTitle::setSelectedFont(const QFont &font) +{ + mSelectedFont = font; +} + +/*! + Sets the \a color of the title text that will be used if the plot title is selected (\ref setSelected). + + \see setTextColor +*/ +void QCPPlotTitle::setSelectedTextColor(const QColor &color) +{ + mSelectedTextColor = color; +} + +/*! + Sets whether the user may select this plot title to \a selectable. + + Note that even when \a selectable is set to false, the selection state may be changed + programmatically via \ref setSelected. +*/ +void QCPPlotTitle::setSelectable(bool selectable) +{ + if (mSelectable != selectable) + { + mSelectable = selectable; + emit selectableChanged(mSelectable); + } +} + +/*! + Sets the selection state of this plot title to \a selected. If the selection has changed, \ref + selectionChanged is emitted. + + Note that this function can change the selection state independently of the current \ref + setSelectable state. +*/ +void QCPPlotTitle::setSelected(bool selected) +{ + if (mSelected != selected) + { + mSelected = selected; + emit selectionChanged(mSelected); + } +} + +/* inherits documentation from base class */ +void QCPPlotTitle::applyDefaultAntialiasingHint(QCPPainter *painter) const +{ + applyAntialiasingHint(painter, mAntialiased, QCP::aeNone); +} + +/* inherits documentation from base class */ +void QCPPlotTitle::draw(QCPPainter *painter) +{ + painter->setFont(mainFont()); + painter->setPen(QPen(mainTextColor())); + painter->drawText(mRect, Qt::AlignCenter, mText, &mTextBoundingRect); +} + +/* inherits documentation from base class */ +QSize QCPPlotTitle::minimumSizeHint() const +{ + QFontMetrics metrics(mFont); + QSize result = metrics.boundingRect(0, 0, 0, 0, Qt::AlignCenter, mText).size(); + result.rwidth() += mMargins.left() + mMargins.right(); + result.rheight() += mMargins.top() + mMargins.bottom(); + return result; +} + +/* inherits documentation from base class */ +QSize QCPPlotTitle::maximumSizeHint() const +{ + QFontMetrics metrics(mFont); + QSize result = metrics.boundingRect(0, 0, 0, 0, Qt::AlignCenter, mText).size(); + result.rheight() += mMargins.top() + mMargins.bottom(); + result.setWidth(QWIDGETSIZE_MAX); + return result; +} + +/* inherits documentation from base class */ +void QCPPlotTitle::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) +{ + Q_UNUSED(event) + Q_UNUSED(details) + if (mSelectable) + { + bool selBefore = mSelected; + setSelected(additive ? !mSelected : true); + if (selectionStateChanged) + *selectionStateChanged = mSelected != selBefore; + } +} + +/* inherits documentation from base class */ +void QCPPlotTitle::deselectEvent(bool *selectionStateChanged) +{ + if (mSelectable) + { + bool selBefore = mSelected; + setSelected(false); + if (selectionStateChanged) + *selectionStateChanged = mSelected != selBefore; + } +} + +/* inherits documentation from base class */ +double QCPPlotTitle::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + + if (mTextBoundingRect.contains(pos.toPoint())) + return mParentPlot->selectionTolerance()*0.99; + else + return -1; +} + +/*! \internal + + Returns the main font to be used. This is mSelectedFont if \ref setSelected is set to + true, else mFont is returned. +*/ +QFont QCPPlotTitle::mainFont() const +{ + return mSelected ? mSelectedFont : mFont; +} + +/*! \internal + + Returns the main color to be used. This is mSelectedTextColor if \ref setSelected is set to + true, else mTextColor is returned. +*/ +QColor QCPPlotTitle::mainTextColor() const +{ + return mSelected ? mSelectedTextColor : mTextColor; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPColorScale +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPColorScale + \brief A color scale for use with color coding data such as QCPColorMap + + This layout element can be placed on the plot to correlate a color gradient with data values. It + is usually used in combination with one or multiple \ref QCPColorMap "QCPColorMaps". + + \image html QCPColorScale.png + + The color scale can be either horizontal or vertical, as shown in the image above. The + orientation and the side where the numbers appear is controlled with \ref setType. + + Use \ref QCPColorMap::setColorScale to connect a color map with a color scale. Once they are + connected, they share their gradient, data range and data scale type (\ref setGradient, \ref + setDataRange, \ref setDataScaleType). Multiple color maps may be associated with a single color + scale, to make them all synchronize these properties. + + To have finer control over the number display and axis behaviour, you can directly access the + \ref axis. See the documentation of QCPAxis for details about configuring axes. For example, if + you want to change the number of automatically generated ticks, call + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcolorscale-autotickcount + + Placing a color scale next to the main axis rect works like with any other layout element: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcolorscale-creation + In this case we have placed it to the right of the default axis rect, so it wasn't necessary to + call \ref setType, since \ref QCPAxis::atRight is already the default. The text next to the color + scale can be set with \ref setLabel. + + For optimum appearance (like in the image above), it may be desirable to line up the axis rect and + the borders of the color scale. Use a \ref QCPMarginGroup to achieve this: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcolorscale-margingroup + + Color scales are initialized with a non-zero minimum top and bottom margin (\ref + setMinimumMargins), because vertical color scales are most common and the minimum top/bottom + margin makes sure it keeps some distance to the top/bottom widget border. So if you change to a + horizontal color scale by setting \ref setType to \ref QCPAxis::atBottom or \ref QCPAxis::atTop, you + might want to also change the minimum margins accordingly, e.g. setMinimumMargins(QMargins(6, 0, 6, 0)). +*/ + +/* start documentation of inline functions */ + +/*! \fn QCPAxis *QCPColorScale::axis() const + + Returns the internal \ref QCPAxis instance of this color scale. You can access it to alter the + appearance and behaviour of the axis. \ref QCPColorScale duplicates some properties in its + interface for convenience. Those are \ref setDataRange (\ref QCPAxis::setRange), \ref + setDataScaleType (\ref QCPAxis::setScaleType), and the method \ref setLabel (\ref + QCPAxis::setLabel). As they each are connected, it does not matter whether you use the method on + the QCPColorScale or on its QCPAxis. + + If the type of the color scale is changed with \ref setType, the axis returned by this method + will change, too, to either the left, right, bottom or top axis, depending on which type was set. +*/ + +/* end documentation of signals */ +/* start documentation of signals */ + +/*! \fn void QCPColorScale::dataRangeChanged(QCPRange newRange); + + This signal is emitted when the data range changes. + + \see setDataRange +*/ + +/*! \fn void QCPColorScale::dataScaleTypeChanged(QCPAxis::ScaleType scaleType); + + This signal is emitted when the data scale type changes. + + \see setDataScaleType +*/ + +/*! \fn void QCPColorScale::gradientChanged(QCPColorGradient newGradient); + + This signal is emitted when the gradient changes. + + \see setGradient +*/ + +/* end documentation of signals */ + +/*! + Constructs a new QCPColorScale. +*/ +QCPColorScale::QCPColorScale(QCustomPlot *parentPlot) : + QCPLayoutElement(parentPlot), + mType(QCPAxis::atTop), // set to atTop such that setType(QCPAxis::atRight) below doesn't skip work because it thinks it's already atRight + mDataScaleType(QCPAxis::stLinear), + mBarWidth(20), + mAxisRect(new QCPColorScaleAxisRectPrivate(this)) +{ + setMinimumMargins(QMargins(0, 6, 0, 6)); // for default right color scale types, keep some room at bottom and top (important if no margin group is used) + setType(QCPAxis::atRight); + setDataRange(QCPRange(0, 6)); +} + +QCPColorScale::~QCPColorScale() +{ + delete mAxisRect; +} + +/* undocumented getter */ +QString QCPColorScale::label() const +{ + if (!mColorAxis) + { + qDebug() << Q_FUNC_INFO << "internal color axis undefined"; + return QString(); + } + + return mColorAxis.data()->label(); +} + +/* undocumented getter */ +bool QCPColorScale::rangeDrag() const +{ + if (!mAxisRect) + { + qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; + return false; + } + + return mAxisRect.data()->rangeDrag().testFlag(QCPAxis::orientation(mType)) && + mAxisRect.data()->rangeDragAxis(QCPAxis::orientation(mType)) && + mAxisRect.data()->rangeDragAxis(QCPAxis::orientation(mType))->orientation() == QCPAxis::orientation(mType); +} + +/* undocumented getter */ +bool QCPColorScale::rangeZoom() const +{ + if (!mAxisRect) + { + qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; + return false; + } + + return mAxisRect.data()->rangeZoom().testFlag(QCPAxis::orientation(mType)) && + mAxisRect.data()->rangeZoomAxis(QCPAxis::orientation(mType)) && + mAxisRect.data()->rangeZoomAxis(QCPAxis::orientation(mType))->orientation() == QCPAxis::orientation(mType); +} + +/*! + Sets at which side of the color scale the axis is placed, and thus also its orientation. + + Note that after setting \a type to a different value, the axis returned by \ref axis() will + be a different one. The new axis will adopt the following properties from the previous axis: The + range, scale type, log base and label. +*/ +void QCPColorScale::setType(QCPAxis::AxisType type) +{ + if (!mAxisRect) + { + qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; + return; + } + if (mType != type) + { + mType = type; + QCPRange rangeTransfer(0, 6); + double logBaseTransfer = 10; + QString labelTransfer; + // revert some settings on old axis: + if (mColorAxis) + { + rangeTransfer = mColorAxis.data()->range(); + labelTransfer = mColorAxis.data()->label(); + logBaseTransfer = mColorAxis.data()->scaleLogBase(); + mColorAxis.data()->setLabel(QString()); + disconnect(mColorAxis.data(), SIGNAL(rangeChanged(QCPRange)), this, SLOT(setDataRange(QCPRange))); + disconnect(mColorAxis.data(), SIGNAL(scaleTypeChanged(QCPAxis::ScaleType)), this, SLOT(setDataScaleType(QCPAxis::ScaleType))); + } + QList allAxisTypes = QList() << QCPAxis::atLeft << QCPAxis::atRight << QCPAxis::atBottom << QCPAxis::atTop; + foreach (QCPAxis::AxisType atype, allAxisTypes) + { + mAxisRect.data()->axis(atype)->setTicks(atype == mType); + mAxisRect.data()->axis(atype)->setTickLabels(atype== mType); + } + // set new mColorAxis pointer: + mColorAxis = mAxisRect.data()->axis(mType); + // transfer settings to new axis: + mColorAxis.data()->setRange(rangeTransfer); // transfer range of old axis to new one (necessary if axis changes from vertical to horizontal or vice versa) + mColorAxis.data()->setLabel(labelTransfer); + mColorAxis.data()->setScaleLogBase(logBaseTransfer); // scaleType is synchronized among axes in realtime via signals (connected in QCPColorScale ctor), so we only need to take care of log base here + connect(mColorAxis.data(), SIGNAL(rangeChanged(QCPRange)), this, SLOT(setDataRange(QCPRange))); + connect(mColorAxis.data(), SIGNAL(scaleTypeChanged(QCPAxis::ScaleType)), this, SLOT(setDataScaleType(QCPAxis::ScaleType))); + mAxisRect.data()->setRangeDragAxes(QCPAxis::orientation(mType) == Qt::Horizontal ? mColorAxis.data() : 0, + QCPAxis::orientation(mType) == Qt::Vertical ? mColorAxis.data() : 0); + } +} + +/*! + Sets the range spanned by the color gradient and that is shown by the axis in the color scale. + + It is equivalent to calling QCPColorMap::setDataRange on any of the connected color maps. It is + also equivalent to directly accessing the \ref axis and setting its range with \ref + QCPAxis::setRange. + + \see setDataScaleType, setGradient, rescaleDataRange +*/ +void QCPColorScale::setDataRange(const QCPRange &dataRange) +{ + if (mDataRange.lower != dataRange.lower || mDataRange.upper != dataRange.upper) + { + mDataRange = dataRange; + if (mColorAxis) + mColorAxis.data()->setRange(mDataRange); + emit dataRangeChanged(mDataRange); + } +} + +/*! + Sets the scale type of the color scale, i.e. whether values are linearly associated with colors + or logarithmically. + + It is equivalent to calling QCPColorMap::setDataScaleType on any of the connected color maps. It is + also equivalent to directly accessing the \ref axis and setting its scale type with \ref + QCPAxis::setScaleType. + + \see setDataRange, setGradient +*/ +void QCPColorScale::setDataScaleType(QCPAxis::ScaleType scaleType) +{ + if (mDataScaleType != scaleType) + { + mDataScaleType = scaleType; + if (mColorAxis) + mColorAxis.data()->setScaleType(mDataScaleType); + if (mDataScaleType == QCPAxis::stLogarithmic) + setDataRange(mDataRange.sanitizedForLogScale()); + emit dataScaleTypeChanged(mDataScaleType); + } +} + +/*! + Sets the color gradient that will be used to represent data values. + + It is equivalent to calling QCPColorMap::setGradient on any of the connected color maps. + + \see setDataRange, setDataScaleType +*/ +void QCPColorScale::setGradient(const QCPColorGradient &gradient) +{ + if (mGradient != gradient) + { + mGradient = gradient; + if (mAxisRect) + mAxisRect.data()->mGradientImageInvalidated = true; + emit gradientChanged(mGradient); + } +} + +/*! + Sets the axis label of the color scale. This is equivalent to calling \ref QCPAxis::setLabel on + the internal \ref axis. +*/ +void QCPColorScale::setLabel(const QString &str) +{ + if (!mColorAxis) + { + qDebug() << Q_FUNC_INFO << "internal color axis undefined"; + return; + } + + mColorAxis.data()->setLabel(str); +} + +/*! + Sets the width (or height, for horizontal color scales) the bar where the gradient is displayed + will have. +*/ +void QCPColorScale::setBarWidth(int width) +{ + mBarWidth = width; +} + +/*! + Sets whether the user can drag the data range (\ref setDataRange). + + Note that \ref QCP::iRangeDrag must be in the QCustomPlot's interactions (\ref + QCustomPlot::setInteractions) to allow range dragging. +*/ +void QCPColorScale::setRangeDrag(bool enabled) +{ + if (!mAxisRect) + { + qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; + return; + } + + if (enabled) + mAxisRect.data()->setRangeDrag(QCPAxis::orientation(mType)); + else + mAxisRect.data()->setRangeDrag(0); +} + +/*! + Sets whether the user can zoom the data range (\ref setDataRange) by scrolling the mouse wheel. + + Note that \ref QCP::iRangeZoom must be in the QCustomPlot's interactions (\ref + QCustomPlot::setInteractions) to allow range dragging. +*/ +void QCPColorScale::setRangeZoom(bool enabled) +{ + if (!mAxisRect) + { + qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; + return; + } + + if (enabled) + mAxisRect.data()->setRangeZoom(QCPAxis::orientation(mType)); + else + mAxisRect.data()->setRangeZoom(0); +} + +/*! + Returns a list of all the color maps associated with this color scale. +*/ +QList QCPColorScale::colorMaps() const +{ + QList result; + for (int i=0; iplottableCount(); ++i) + { + if (QCPColorMap *cm = qobject_cast(mParentPlot->plottable(i))) + if (cm->colorScale() == this) + result.append(cm); + } + return result; +} + +/*! + Changes the data range such that all color maps associated with this color scale are fully mapped + to the gradient in the data dimension. + + \see setDataRange +*/ +void QCPColorScale::rescaleDataRange(bool onlyVisibleMaps) +{ + QList maps = colorMaps(); + QCPRange newRange; + bool haveRange = false; + int sign = 0; // TODO: should change this to QCPAbstractPlottable::SignDomain later (currently is protected, maybe move to QCP namespace) + if (mDataScaleType == QCPAxis::stLogarithmic) + sign = (mDataRange.upper < 0 ? -1 : 1); + for (int i=0; irealVisibility() && onlyVisibleMaps) + continue; + QCPRange mapRange; + if (maps.at(i)->colorScale() == this) + { + bool currentFoundRange = true; + mapRange = maps.at(i)->data()->dataBounds(); + if (sign == 1) + { + if (mapRange.lower <= 0 && mapRange.upper > 0) + mapRange.lower = mapRange.upper*1e-3; + else if (mapRange.lower <= 0 && mapRange.upper <= 0) + currentFoundRange = false; + } else if (sign == -1) + { + if (mapRange.upper >= 0 && mapRange.lower < 0) + mapRange.upper = mapRange.lower*1e-3; + else if (mapRange.upper >= 0 && mapRange.lower >= 0) + currentFoundRange = false; + } + if (currentFoundRange) + { + if (!haveRange) + newRange = mapRange; + else + newRange.expand(mapRange); + haveRange = true; + } + } + } + if (haveRange) + { + if (!QCPRange::validRange(newRange)) // likely due to range being zero (plottable has only constant data in this dimension), shift current range to at least center the data + { + double center = (newRange.lower+newRange.upper)*0.5; // upper and lower should be equal anyway, but just to make sure, incase validRange returned false for other reason + if (mDataScaleType == QCPAxis::stLinear) + { + newRange.lower = center-mDataRange.size()/2.0; + newRange.upper = center+mDataRange.size()/2.0; + } else // mScaleType == stLogarithmic + { + newRange.lower = center/qSqrt(mDataRange.upper/mDataRange.lower); + newRange.upper = center*qSqrt(mDataRange.upper/mDataRange.lower); + } + } + setDataRange(newRange); + } +} + +/* inherits documentation from base class */ +void QCPColorScale::update(UpdatePhase phase) +{ + QCPLayoutElement::update(phase); + if (!mAxisRect) + { + qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; + return; + } + + mAxisRect.data()->update(phase); + + switch (phase) + { + case upMargins: + { + if (mType == QCPAxis::atBottom || mType == QCPAxis::atTop) + { + setMaximumSize(QWIDGETSIZE_MAX, mBarWidth+mAxisRect.data()->margins().top()+mAxisRect.data()->margins().bottom()+margins().top()+margins().bottom()); + setMinimumSize(0, mBarWidth+mAxisRect.data()->margins().top()+mAxisRect.data()->margins().bottom()+margins().top()+margins().bottom()); + } else + { + setMaximumSize(mBarWidth+mAxisRect.data()->margins().left()+mAxisRect.data()->margins().right()+margins().left()+margins().right(), QWIDGETSIZE_MAX); + setMinimumSize(mBarWidth+mAxisRect.data()->margins().left()+mAxisRect.data()->margins().right()+margins().left()+margins().right(), 0); + } + break; + } + case upLayout: + { + mAxisRect.data()->setOuterRect(rect()); + break; + } + default: break; + } +} + +/* inherits documentation from base class */ +void QCPColorScale::applyDefaultAntialiasingHint(QCPPainter *painter) const +{ + painter->setAntialiasing(false); +} + +/* inherits documentation from base class */ +void QCPColorScale::mousePressEvent(QMouseEvent *event) +{ + if (!mAxisRect) + { + qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; + return; + } + mAxisRect.data()->mousePressEvent(event); +} + +/* inherits documentation from base class */ +void QCPColorScale::mouseMoveEvent(QMouseEvent *event) +{ + if (!mAxisRect) + { + qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; + return; + } + mAxisRect.data()->mouseMoveEvent(event); +} + +/* inherits documentation from base class */ +void QCPColorScale::mouseReleaseEvent(QMouseEvent *event) +{ + if (!mAxisRect) + { + qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; + return; + } + mAxisRect.data()->mouseReleaseEvent(event); +} + +/* inherits documentation from base class */ +void QCPColorScale::wheelEvent(QWheelEvent *event) +{ + if (!mAxisRect) + { + qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; + return; + } + mAxisRect.data()->wheelEvent(event); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPColorScaleAxisRectPrivate +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPColorScaleAxisRectPrivate + + \internal + \brief An axis rect subclass for use in a QCPColorScale + + This is a private class and not part of the public QCustomPlot interface. + + It provides the axis rect functionality for the QCPColorScale class. +*/ + + +/*! + Creates a new instance, as a child of \a parentColorScale. +*/ +QCPColorScaleAxisRectPrivate::QCPColorScaleAxisRectPrivate(QCPColorScale *parentColorScale) : + QCPAxisRect(parentColorScale->parentPlot(), true), + mParentColorScale(parentColorScale), + mGradientImageInvalidated(true) +{ + setParentLayerable(parentColorScale); + setMinimumMargins(QMargins(0, 0, 0, 0)); + QList allAxisTypes = QList() << QCPAxis::atBottom << QCPAxis::atTop << QCPAxis::atLeft << QCPAxis::atRight; + foreach (QCPAxis::AxisType type, allAxisTypes) + { + axis(type)->setVisible(true); + axis(type)->grid()->setVisible(false); + axis(type)->setPadding(0); + connect(axis(type), SIGNAL(selectionChanged(QCPAxis::SelectableParts)), this, SLOT(axisSelectionChanged(QCPAxis::SelectableParts))); + connect(axis(type), SIGNAL(selectableChanged(QCPAxis::SelectableParts)), this, SLOT(axisSelectableChanged(QCPAxis::SelectableParts))); + } + + connect(axis(QCPAxis::atLeft), SIGNAL(rangeChanged(QCPRange)), axis(QCPAxis::atRight), SLOT(setRange(QCPRange))); + connect(axis(QCPAxis::atRight), SIGNAL(rangeChanged(QCPRange)), axis(QCPAxis::atLeft), SLOT(setRange(QCPRange))); + connect(axis(QCPAxis::atBottom), SIGNAL(rangeChanged(QCPRange)), axis(QCPAxis::atTop), SLOT(setRange(QCPRange))); + connect(axis(QCPAxis::atTop), SIGNAL(rangeChanged(QCPRange)), axis(QCPAxis::atBottom), SLOT(setRange(QCPRange))); + connect(axis(QCPAxis::atLeft), SIGNAL(scaleTypeChanged(QCPAxis::ScaleType)), axis(QCPAxis::atRight), SLOT(setScaleType(QCPAxis::ScaleType))); + connect(axis(QCPAxis::atRight), SIGNAL(scaleTypeChanged(QCPAxis::ScaleType)), axis(QCPAxis::atLeft), SLOT(setScaleType(QCPAxis::ScaleType))); + connect(axis(QCPAxis::atBottom), SIGNAL(scaleTypeChanged(QCPAxis::ScaleType)), axis(QCPAxis::atTop), SLOT(setScaleType(QCPAxis::ScaleType))); + connect(axis(QCPAxis::atTop), SIGNAL(scaleTypeChanged(QCPAxis::ScaleType)), axis(QCPAxis::atBottom), SLOT(setScaleType(QCPAxis::ScaleType))); + + // make layer transfers of color scale transfer to axis rect and axes + // the axes must be set after axis rect, such that they appear above color gradient drawn by axis rect: + connect(parentColorScale, SIGNAL(layerChanged(QCPLayer*)), this, SLOT(setLayer(QCPLayer*))); + foreach (QCPAxis::AxisType type, allAxisTypes) + connect(parentColorScale, SIGNAL(layerChanged(QCPLayer*)), axis(type), SLOT(setLayer(QCPLayer*))); +} + +/*! \internal + Updates the color gradient image if necessary, by calling \ref updateGradientImage, then draws + it. Then the axes are drawn by calling the \ref QCPAxisRect::draw base class implementation. +*/ +void QCPColorScaleAxisRectPrivate::draw(QCPPainter *painter) +{ + if (mGradientImageInvalidated) + updateGradientImage(); + + bool mirrorHorz = false; + bool mirrorVert = false; + if (mParentColorScale->mColorAxis) + { + mirrorHorz = mParentColorScale->mColorAxis.data()->rangeReversed() && (mParentColorScale->type() == QCPAxis::atBottom || mParentColorScale->type() == QCPAxis::atTop); + mirrorVert = mParentColorScale->mColorAxis.data()->rangeReversed() && (mParentColorScale->type() == QCPAxis::atLeft || mParentColorScale->type() == QCPAxis::atRight); + } + + painter->drawImage(rect().adjusted(0, -1, 0, -1), mGradientImage.mirrored(mirrorHorz, mirrorVert)); + QCPAxisRect::draw(painter); +} + +/*! \internal + + Uses the current gradient of the parent \ref QCPColorScale (specified in the constructor) to + generate a gradient image. This gradient image will be used in the \ref draw method. +*/ +void QCPColorScaleAxisRectPrivate::updateGradientImage() +{ + if (rect().isEmpty()) + return; + + int n = mParentColorScale->mGradient.levelCount(); + int w, h; + QVector data(n); + for (int i=0; imType == QCPAxis::atBottom || mParentColorScale->mType == QCPAxis::atTop) + { + w = n; + h = rect().height(); + mGradientImage = QImage(w, h, QImage::Format_RGB32); + QVector pixels; + for (int y=0; y(mGradientImage.scanLine(y))); + mParentColorScale->mGradient.colorize(data.constData(), QCPRange(0, n-1), pixels.first(), n); + for (int y=1; y(mGradientImage.scanLine(y)); + const QRgb lineColor = mParentColorScale->mGradient.color(data[h-1-y], QCPRange(0, n-1)); + for (int x=0; x allAxisTypes = QList() << QCPAxis::atBottom << QCPAxis::atTop << QCPAxis::atLeft << QCPAxis::atRight; + foreach (QCPAxis::AxisType type, allAxisTypes) + { + if (QCPAxis *senderAxis = qobject_cast(sender())) + if (senderAxis->axisType() == type) + continue; + + if (axis(type)->selectableParts().testFlag(QCPAxis::spAxis)) + { + if (selectedParts.testFlag(QCPAxis::spAxis)) + axis(type)->setSelectedParts(axis(type)->selectedParts() | QCPAxis::spAxis); + else + axis(type)->setSelectedParts(axis(type)->selectedParts() & ~QCPAxis::spAxis); + } + } +} + +/*! \internal + + This slot is connected to the selectableChanged signals of the four axes in the constructor. It + synchronizes the selectability of the axes. +*/ +void QCPColorScaleAxisRectPrivate::axisSelectableChanged(QCPAxis::SelectableParts selectableParts) +{ + // synchronize axis base selectability: + QList allAxisTypes = QList() << QCPAxis::atBottom << QCPAxis::atTop << QCPAxis::atLeft << QCPAxis::atRight; + foreach (QCPAxis::AxisType type, allAxisTypes) + { + if (QCPAxis *senderAxis = qobject_cast(sender())) + if (senderAxis->axisType() == type) + continue; + + if (axis(type)->selectableParts().testFlag(QCPAxis::spAxis)) + { + if (selectableParts.testFlag(QCPAxis::spAxis)) + axis(type)->setSelectableParts(axis(type)->selectableParts() | QCPAxis::spAxis); + else + axis(type)->setSelectableParts(axis(type)->selectableParts() & ~QCPAxis::spAxis); + } + } +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPData +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPData + \brief Holds the data of one single data point for QCPGraph. + + The container for storing multiple data points is \ref QCPDataMap. + + The stored data is: + \li \a key: coordinate on the key axis of this data point + \li \a value: coordinate on the value axis of this data point + \li \a keyErrorMinus: negative error in the key dimension (for error bars) + \li \a keyErrorPlus: positive error in the key dimension (for error bars) + \li \a valueErrorMinus: negative error in the value dimension (for error bars) + \li \a valueErrorPlus: positive error in the value dimension (for error bars) + + \see QCPDataMap +*/ + +/*! + Constructs a data point with key, value and all errors set to zero. +*/ +QCPData::QCPData() : + key(0), + value(0), + keyErrorPlus(0), + keyErrorMinus(0), + valueErrorPlus(0), + valueErrorMinus(0) +{ +} + +/*! + Constructs a data point with the specified \a key and \a value. All errors are set to zero. +*/ +QCPData::QCPData(double key, double value) : + key(key), + value(value), + keyErrorPlus(0), + keyErrorMinus(0), + valueErrorPlus(0), + valueErrorMinus(0) +{ +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPGraph +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPGraph + \brief A plottable representing a graph in a plot. + + \image html QCPGraph.png + + Usually you create new graphs by calling QCustomPlot::addGraph. The resulting instance can be + accessed via QCustomPlot::graph. + + To plot data, assign it with the \ref setData or \ref addData functions. Alternatively, you can + also access and modify the graph's data via the \ref data method, which returns a pointer to the + internal \ref QCPDataMap. + + Graphs are used to display single-valued data. Single-valued means that there should only be one + data point per unique key coordinate. In other words, the graph can't have \a loops. If you do + want to plot non-single-valued curves, rather use the QCPCurve plottable. + + Gaps in the graph line can be created by adding data points with NaN as value + (qQNaN() or std::numeric_limits::quiet_NaN()) in between the two data points that shall be + separated. + + \section appearance Changing the appearance + + The appearance of the graph is mainly determined by the line style, scatter style, brush and pen + of the graph (\ref setLineStyle, \ref setScatterStyle, \ref setBrush, \ref setPen). + + \subsection filling Filling under or between graphs + + QCPGraph knows two types of fills: Normal graph fills towards the zero-value-line parallel to + the key axis of the graph, and fills between two graphs, called channel fills. To enable a fill, + just set a brush with \ref setBrush which is neither Qt::NoBrush nor fully transparent. + + By default, a normal fill towards the zero-value-line will be drawn. To set up a channel fill + between this graph and another one, call \ref setChannelFillGraph with the other graph as + parameter. + + \see QCustomPlot::addGraph, QCustomPlot::graph +*/ + +/* start of documentation of inline functions */ + +/*! \fn QCPDataMap *QCPGraph::data() const + + Returns a pointer to the internal data storage of type \ref QCPDataMap. You may use it to + directly manipulate the data, which may be more convenient and faster than using the regular \ref + setData or \ref addData methods, in certain situations. +*/ + +/* end of documentation of inline functions */ + +/*! + Constructs a graph which uses \a keyAxis as its key axis ("x") and \a valueAxis as its value + axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance and not have + the same orientation. If either of these restrictions is violated, a corresponding message is + printed to the debug output (qDebug), the construction is not aborted, though. + + The constructed QCPGraph can be added to the plot with QCustomPlot::addPlottable, QCustomPlot + then takes ownership of the graph. + + To directly create a graph inside a plot, you can also use the simpler QCustomPlot::addGraph function. +*/ +QCPGraph::QCPGraph(QCPAxis *keyAxis, QCPAxis *valueAxis) : + QCPAbstractPlottable(keyAxis, valueAxis) +{ + mData = new QCPDataMap; + + setPen(QPen(Qt::blue, 0)); + setErrorPen(QPen(Qt::black)); + setBrush(Qt::NoBrush); + setSelectedPen(QPen(QColor(80, 80, 255), 2.5)); + setSelectedBrush(Qt::NoBrush); + + setLineStyle(lsLine); + setErrorType(etNone); + setErrorBarSize(6); + setErrorBarSkipSymbol(true); + setChannelFillGraph(0); + setAdaptiveSampling(true); +} + +QCPGraph::~QCPGraph() +{ + delete mData; +} + +/*! + Replaces the current data with the provided \a data. + + If \a copy is set to true, data points in \a data will only be copied. if false, the graph + takes ownership of the passed data and replaces the internal data pointer with it. This is + significantly faster than copying for large datasets. + + Alternatively, you can also access and modify the graph's data via the \ref data method, which + returns a pointer to the internal \ref QCPDataMap. +*/ +void QCPGraph::setData(QCPDataMap *data, bool copy) +{ + if (mData == data) + { + qDebug() << Q_FUNC_INFO << "The data pointer is already in (and owned by) this plottable" << reinterpret_cast(data); + return; + } + if (copy) + { + *mData = *data; + } else + { + delete mData; + mData = data; + } +} + +/*! \overload + + Replaces the current data with the provided points in \a key and \a value pairs. The provided + vectors should have equal length. Else, the number of added points will be the size of the + smallest vector. +*/ +void QCPGraph::setData(const QVector &key, const QVector &value) +{ + mData->clear(); + int n = key.size(); + n = qMin(n, value.size()); + QCPData newData; + for (int i=0; iinsertMulti(newData.key, newData); + } +} + +/*! + Replaces the current data with the provided points in \a key and \a value pairs. Additionally the + symmetrical value error of the data points are set to the values in \a valueError. + For error bars to show appropriately, see \ref setErrorType. + The provided vectors should have equal length. Else, the number of added points will be the size of the + smallest vector. + + For asymmetrical errors (plus different from minus), see the overloaded version of this function. +*/ +void QCPGraph::setDataValueError(const QVector &key, const QVector &value, const QVector &valueError) +{ + mData->clear(); + int n = key.size(); + n = qMin(n, value.size()); + n = qMin(n, valueError.size()); + QCPData newData; + for (int i=0; iinsertMulti(key[i], newData); + } +} + +/*! + \overload + Replaces the current data with the provided points in \a key and \a value pairs. Additionally the + negative value error of the data points are set to the values in \a valueErrorMinus, the positive + value error to \a valueErrorPlus. + For error bars to show appropriately, see \ref setErrorType. + The provided vectors should have equal length. Else, the number of added points will be the size of the + smallest vector. +*/ +void QCPGraph::setDataValueError(const QVector &key, const QVector &value, const QVector &valueErrorMinus, const QVector &valueErrorPlus) +{ + mData->clear(); + int n = key.size(); + n = qMin(n, value.size()); + n = qMin(n, valueErrorMinus.size()); + n = qMin(n, valueErrorPlus.size()); + QCPData newData; + for (int i=0; iinsertMulti(key[i], newData); + } +} + +/*! + Replaces the current data with the provided points in \a key and \a value pairs. Additionally the + symmetrical key error of the data points are set to the values in \a keyError. + For error bars to show appropriately, see \ref setErrorType. + The provided vectors should have equal length. Else, the number of added points will be the size of the + smallest vector. + + For asymmetrical errors (plus different from minus), see the overloaded version of this function. +*/ +void QCPGraph::setDataKeyError(const QVector &key, const QVector &value, const QVector &keyError) +{ + mData->clear(); + int n = key.size(); + n = qMin(n, value.size()); + n = qMin(n, keyError.size()); + QCPData newData; + for (int i=0; iinsertMulti(key[i], newData); + } +} + +/*! + \overload + Replaces the current data with the provided points in \a key and \a value pairs. Additionally the + negative key error of the data points are set to the values in \a keyErrorMinus, the positive + key error to \a keyErrorPlus. + For error bars to show appropriately, see \ref setErrorType. + The provided vectors should have equal length. Else, the number of added points will be the size of the + smallest vector. +*/ +void QCPGraph::setDataKeyError(const QVector &key, const QVector &value, const QVector &keyErrorMinus, const QVector &keyErrorPlus) +{ + mData->clear(); + int n = key.size(); + n = qMin(n, value.size()); + n = qMin(n, keyErrorMinus.size()); + n = qMin(n, keyErrorPlus.size()); + QCPData newData; + for (int i=0; iinsertMulti(key[i], newData); + } +} + +/*! + Replaces the current data with the provided points in \a key and \a value pairs. Additionally the + symmetrical key and value errors of the data points are set to the values in \a keyError and \a valueError. + For error bars to show appropriately, see \ref setErrorType. + The provided vectors should have equal length. Else, the number of added points will be the size of the + smallest vector. + + For asymmetrical errors (plus different from minus), see the overloaded version of this function. +*/ +void QCPGraph::setDataBothError(const QVector &key, const QVector &value, const QVector &keyError, const QVector &valueError) +{ + mData->clear(); + int n = key.size(); + n = qMin(n, value.size()); + n = qMin(n, valueError.size()); + n = qMin(n, keyError.size()); + QCPData newData; + for (int i=0; iinsertMulti(key[i], newData); + } +} + +/*! + \overload + Replaces the current data with the provided points in \a key and \a value pairs. Additionally the + negative key and value errors of the data points are set to the values in \a keyErrorMinus and \a valueErrorMinus. The positive + key and value errors are set to the values in \a keyErrorPlus \a valueErrorPlus. + For error bars to show appropriately, see \ref setErrorType. + The provided vectors should have equal length. Else, the number of added points will be the size of the + smallest vector. +*/ +void QCPGraph::setDataBothError(const QVector &key, const QVector &value, const QVector &keyErrorMinus, const QVector &keyErrorPlus, const QVector &valueErrorMinus, const QVector &valueErrorPlus) +{ + mData->clear(); + int n = key.size(); + n = qMin(n, value.size()); + n = qMin(n, valueErrorMinus.size()); + n = qMin(n, valueErrorPlus.size()); + n = qMin(n, keyErrorMinus.size()); + n = qMin(n, keyErrorPlus.size()); + QCPData newData; + for (int i=0; iinsertMulti(key[i], newData); + } +} + + +/*! + Sets how the single data points are connected in the plot. For scatter-only plots, set \a ls to + \ref lsNone and \ref setScatterStyle to the desired scatter style. + + \see setScatterStyle +*/ +void QCPGraph::setLineStyle(LineStyle ls) +{ + mLineStyle = ls; +} + +/*! + Sets the visual appearance of single data points in the plot. If set to \ref QCPScatterStyle::ssNone, no scatter points + are drawn (e.g. for line-only-plots with appropriate line style). + + \see QCPScatterStyle, setLineStyle +*/ +void QCPGraph::setScatterStyle(const QCPScatterStyle &style) +{ + mScatterStyle = style; +} + +/*! + Sets which kind of error bars (Key Error, Value Error or both) should be drawn on each data + point. If you set \a errorType to something other than \ref etNone, make sure to actually pass + error data via the specific setData functions along with the data points (e.g. \ref + setDataValueError, \ref setDataKeyError, \ref setDataBothError). + + \see ErrorType +*/ +void QCPGraph::setErrorType(ErrorType errorType) +{ + mErrorType = errorType; +} + +/*! + Sets the pen with which the error bars will be drawn. + \see setErrorBarSize, setErrorType +*/ +void QCPGraph::setErrorPen(const QPen &pen) +{ + mErrorPen = pen; +} + +/*! + Sets the width of the handles at both ends of an error bar in pixels. +*/ +void QCPGraph::setErrorBarSize(double size) +{ + mErrorBarSize = size; +} + +/*! + If \a enabled is set to true, the error bar will not be drawn as a solid line under the scatter symbol but + leave some free space around the symbol. + + This feature uses the current scatter size (\ref QCPScatterStyle::setSize) to determine the size + of the area to leave blank. So when drawing Pixmaps as scatter points (\ref + QCPScatterStyle::ssPixmap), the scatter size must be set manually to a value corresponding to the + size of the Pixmap, if the error bars should leave gaps to its boundaries. + + \ref setErrorType, setErrorBarSize, setScatterStyle +*/ +void QCPGraph::setErrorBarSkipSymbol(bool enabled) +{ + mErrorBarSkipSymbol = enabled; +} + +/*! + Sets the target graph for filling the area between this graph and \a targetGraph with the current + brush (\ref setBrush). + + When \a targetGraph is set to 0, a normal graph fill to the zero-value-line will be shown. To + disable any filling, set the brush to Qt::NoBrush. + + \see setBrush +*/ +void QCPGraph::setChannelFillGraph(QCPGraph *targetGraph) +{ + // prevent setting channel target to this graph itself: + if (targetGraph == this) + { + qDebug() << Q_FUNC_INFO << "targetGraph is this graph itself"; + mChannelFillGraph = 0; + return; + } + // prevent setting channel target to a graph not in the plot: + if (targetGraph && targetGraph->mParentPlot != mParentPlot) + { + qDebug() << Q_FUNC_INFO << "targetGraph not in same plot"; + mChannelFillGraph = 0; + return; + } + + mChannelFillGraph = targetGraph; +} + +/*! + Sets whether adaptive sampling shall be used when plotting this graph. QCustomPlot's adaptive + sampling technique can drastically improve the replot performance for graphs with a larger number + of points (e.g. above 10,000), without notably changing the appearance of the graph. + + By default, adaptive sampling is enabled. Even if enabled, QCustomPlot decides whether adaptive + sampling shall actually be used on a per-graph basis. So leaving adaptive sampling enabled has no + disadvantage in almost all cases. + + \image html adaptive-sampling-line.png "A line plot of 500,000 points without and with adaptive sampling" + + As can be seen, line plots experience no visual degradation from adaptive sampling. Outliers are + reproduced reliably, as well as the overall shape of the data set. The replot time reduces + dramatically though. This allows QCustomPlot to display large amounts of data in realtime. + + \image html adaptive-sampling-scatter.png "A scatter plot of 100,000 points without and with adaptive sampling" + + Care must be taken when using high-density scatter plots in combination with adaptive sampling. + The adaptive sampling algorithm treats scatter plots more carefully than line plots which still + gives a significant reduction of replot times, but not quite as much as for line plots. This is + because scatter plots inherently need more data points to be preserved in order to still resemble + the original, non-adaptive-sampling plot. As shown above, the results still aren't quite + identical, as banding occurs for the outer data points. This is in fact intentional, such that + the boundaries of the data cloud stay visible to the viewer. How strong the banding appears, + depends on the point density, i.e. the number of points in the plot. + + For some situations with scatter plots it might thus be desirable to manually turn adaptive + sampling off. For example, when saving the plot to disk. This can be achieved by setting \a + enabled to false before issuing a command like \ref QCustomPlot::savePng, and setting \a enabled + back to true afterwards. +*/ +void QCPGraph::setAdaptiveSampling(bool enabled) +{ + mAdaptiveSampling = enabled; +} + +/*! + Adds the provided data points in \a dataMap to the current data. + + Alternatively, you can also access and modify the graph's data via the \ref data method, which + returns a pointer to the internal \ref QCPDataMap. + + \see removeData +*/ +void QCPGraph::addData(const QCPDataMap &dataMap) +{ + mData->unite(dataMap); +} + +/*! \overload + Adds the provided single data point in \a data to the current data. + + Alternatively, you can also access and modify the graph's data via the \ref data method, which + returns a pointer to the internal \ref QCPDataMap. + + \see removeData +*/ +void QCPGraph::addData(const QCPData &data) +{ + mData->insertMulti(data.key, data); +} + +/*! \overload + Adds the provided single data point as \a key and \a value pair to the current data. + + Alternatively, you can also access and modify the graph's data via the \ref data method, which + returns a pointer to the internal \ref QCPDataMap. + + \see removeData +*/ +void QCPGraph::addData(double key, double value) +{ + QCPData newData; + newData.key = key; + newData.value = value; + mData->insertMulti(newData.key, newData); +} + +/*! \overload + Adds the provided data points as \a key and \a value pairs to the current data. + + Alternatively, you can also access and modify the graph's data via the \ref data method, which + returns a pointer to the internal \ref QCPDataMap. + + \see removeData +*/ +void QCPGraph::addData(const QVector &keys, const QVector &values) +{ + int n = qMin(keys.size(), values.size()); + QCPData newData; + for (int i=0; iinsertMulti(newData.key, newData); + } +} + +/*! + Removes all data points with keys smaller than \a key. + \see addData, clearData +*/ +void QCPGraph::removeDataBefore(double key) +{ + QCPDataMap::iterator it = mData->begin(); + while (it != mData->end() && it.key() < key) + it = mData->erase(it); +} + +/*! + Removes all data points with keys greater than \a key. + \see addData, clearData +*/ +void QCPGraph::removeDataAfter(double key) +{ + if (mData->isEmpty()) return; + QCPDataMap::iterator it = mData->upperBound(key); + while (it != mData->end()) + it = mData->erase(it); +} + +/*! + Removes all data points with keys between \a fromKey and \a toKey. + if \a fromKey is greater or equal to \a toKey, the function does nothing. To remove + a single data point with known key, use \ref removeData(double key). + + \see addData, clearData +*/ +void QCPGraph::removeData(double fromKey, double toKey) +{ + if (fromKey >= toKey || mData->isEmpty()) return; + QCPDataMap::iterator it = mData->upperBound(fromKey); + QCPDataMap::iterator itEnd = mData->upperBound(toKey); + while (it != itEnd) + it = mData->erase(it); +} + +/*! \overload + + Removes a single data point at \a key. If the position is not known with absolute precision, + consider using \ref removeData(double fromKey, double toKey) with a small fuzziness interval around + the suspected position, depeding on the precision with which the key is known. + + \see addData, clearData +*/ +void QCPGraph::removeData(double key) +{ + mData->remove(key); +} + +/*! + Removes all data points. + \see removeData, removeDataAfter, removeDataBefore +*/ +void QCPGraph::clearData() +{ + mData->clear(); +} + +/* inherits documentation from base class */ +double QCPGraph::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if ((onlySelectable && !mSelectable) || mData->isEmpty()) + return -1; + if (!mKeyAxis || !mValueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return -1; } + + if (mKeyAxis.data()->axisRect()->rect().contains(pos.toPoint())) + return pointDistance(pos); + else + return -1; +} + +/*! \overload + + Allows to define whether error bars are taken into consideration when determining the new axis + range. + + \see rescaleKeyAxis, rescaleValueAxis, QCPAbstractPlottable::rescaleAxes, QCustomPlot::rescaleAxes +*/ +void QCPGraph::rescaleAxes(bool onlyEnlarge, bool includeErrorBars) const +{ + rescaleKeyAxis(onlyEnlarge, includeErrorBars); + rescaleValueAxis(onlyEnlarge, includeErrorBars); +} + +/*! \overload + + Allows to define whether error bars (of kind \ref QCPGraph::etKey) are taken into consideration + when determining the new axis range. + + \see rescaleAxes, QCPAbstractPlottable::rescaleKeyAxis +*/ +void QCPGraph::rescaleKeyAxis(bool onlyEnlarge, bool includeErrorBars) const +{ + // this code is a copy of QCPAbstractPlottable::rescaleKeyAxis with the only change + // that getKeyRange is passed the includeErrorBars value. + if (mData->isEmpty()) return; + + QCPAxis *keyAxis = mKeyAxis.data(); + if (!keyAxis) { qDebug() << Q_FUNC_INFO << "invalid key axis"; return; } + + SignDomain signDomain = sdBoth; + if (keyAxis->scaleType() == QCPAxis::stLogarithmic) + signDomain = (keyAxis->range().upper < 0 ? sdNegative : sdPositive); + + bool foundRange; + QCPRange newRange = getKeyRange(foundRange, signDomain, includeErrorBars); + + if (foundRange) + { + if (onlyEnlarge) + { + if (keyAxis->range().lower < newRange.lower) + newRange.lower = keyAxis->range().lower; + if (keyAxis->range().upper > newRange.upper) + newRange.upper = keyAxis->range().upper; + } + keyAxis->setRange(newRange); + } +} + +/*! \overload + + Allows to define whether error bars (of kind \ref QCPGraph::etValue) are taken into consideration + when determining the new axis range. + + \see rescaleAxes, QCPAbstractPlottable::rescaleValueAxis +*/ +void QCPGraph::rescaleValueAxis(bool onlyEnlarge, bool includeErrorBars) const +{ + // this code is a copy of QCPAbstractPlottable::rescaleValueAxis with the only change + // is that getValueRange is passed the includeErrorBars value. + if (mData->isEmpty()) return; + + QCPAxis *valueAxis = mValueAxis.data(); + if (!valueAxis) { qDebug() << Q_FUNC_INFO << "invalid value axis"; return; } + + SignDomain signDomain = sdBoth; + if (valueAxis->scaleType() == QCPAxis::stLogarithmic) + signDomain = (valueAxis->range().upper < 0 ? sdNegative : sdPositive); + + bool foundRange; + QCPRange newRange = getValueRange(foundRange, signDomain, includeErrorBars); + + if (foundRange) + { + if (onlyEnlarge) + { + if (valueAxis->range().lower < newRange.lower) + newRange.lower = valueAxis->range().lower; + if (valueAxis->range().upper > newRange.upper) + newRange.upper = valueAxis->range().upper; + } + valueAxis->setRange(newRange); + } +} + +/* inherits documentation from base class */ +void QCPGraph::draw(QCPPainter *painter) +{ + if (!mKeyAxis || !mValueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + if (mKeyAxis.data()->range().size() <= 0 || mData->isEmpty()) return; + if (mLineStyle == lsNone && mScatterStyle.isNone()) return; + + // allocate line and (if necessary) point vectors: + QVector *lineData = new QVector; + QVector *scatterData = 0; + if (!mScatterStyle.isNone()) + scatterData = new QVector; + + // fill vectors with data appropriate to plot style: + getPlotData(lineData, scatterData); + + // check data validity if flag set: +#ifdef QCUSTOMPLOT_CHECK_DATA + QCPDataMap::const_iterator it; + for (it = mData->constBegin(); it != mData->constEnd(); ++it) + { + if (QCP::isInvalidData(it.value().key, it.value().value) || + QCP::isInvalidData(it.value().keyErrorPlus, it.value().keyErrorMinus) || + QCP::isInvalidData(it.value().valueErrorPlus, it.value().valueErrorPlus)) + qDebug() << Q_FUNC_INFO << "Data point at" << it.key() << "invalid." << "Plottable name:" << name(); + } +#endif + + // draw fill of graph: + if (mLineStyle != lsNone) + drawFill(painter, lineData); + + // draw line: + if (mLineStyle == lsImpulse) + drawImpulsePlot(painter, lineData); + else if (mLineStyle != lsNone) + drawLinePlot(painter, lineData); // also step plots can be drawn as a line plot + + // draw scatters: + if (scatterData) + drawScatterPlot(painter, scatterData); + + // free allocated line and point vectors: + delete lineData; + if (scatterData) + delete scatterData; +} + +/* inherits documentation from base class */ +void QCPGraph::drawLegendIcon(QCPPainter *painter, const QRectF &rect) const +{ + // draw fill: + if (mBrush.style() != Qt::NoBrush) + { + applyFillAntialiasingHint(painter); + painter->fillRect(QRectF(rect.left(), rect.top()+rect.height()/2.0, rect.width(), rect.height()/3.0), mBrush); + } + // draw line vertically centered: + if (mLineStyle != lsNone) + { + applyDefaultAntialiasingHint(painter); + painter->setPen(mPen); + painter->drawLine(QLineF(rect.left(), rect.top()+rect.height()/2.0, rect.right()+5, rect.top()+rect.height()/2.0)); // +5 on x2 else last segment is missing from dashed/dotted pens + } + // draw scatter symbol: + if (!mScatterStyle.isNone()) + { + applyScattersAntialiasingHint(painter); + // scale scatter pixmap if it's too large to fit in legend icon rect: + if (mScatterStyle.shape() == QCPScatterStyle::ssPixmap && (mScatterStyle.pixmap().size().width() > rect.width() || mScatterStyle.pixmap().size().height() > rect.height())) + { + QCPScatterStyle scaledStyle(mScatterStyle); + scaledStyle.setPixmap(scaledStyle.pixmap().scaled(rect.size().toSize(), Qt::KeepAspectRatio, Qt::SmoothTransformation)); + scaledStyle.applyTo(painter, mPen); + scaledStyle.drawShape(painter, QRectF(rect).center()); + } else + { + mScatterStyle.applyTo(painter, mPen); + mScatterStyle.drawShape(painter, QRectF(rect).center()); + } + } +} + +/*! \internal + + This function branches out to the line style specific "get(...)PlotData" functions, according to + the line style of the graph. + + \a lineData will be filled with raw points that will be drawn with the according draw functions, + e.g. \ref drawLinePlot and \ref drawImpulsePlot. These aren't necessarily the original data + points, since for step plots for example, additional points are needed for drawing lines that + make up steps. If the line style of the graph is \ref lsNone, the \a lineData vector will be left + untouched. + + \a scatterData will be filled with the original data points so \ref drawScatterPlot can draw the + scatter symbols accordingly. If no scatters need to be drawn, i.e. the scatter style's shape is + \ref QCPScatterStyle::ssNone, pass 0 as \a scatterData, and this step will be skipped. + + \see getScatterPlotData, getLinePlotData, getStepLeftPlotData, getStepRightPlotData, + getStepCenterPlotData, getImpulsePlotData +*/ +void QCPGraph::getPlotData(QVector *lineData, QVector *scatterData) const +{ + switch(mLineStyle) + { + case lsNone: getScatterPlotData(scatterData); break; + case lsLine: getLinePlotData(lineData, scatterData); break; + case lsStepLeft: getStepLeftPlotData(lineData, scatterData); break; + case lsStepRight: getStepRightPlotData(lineData, scatterData); break; + case lsStepCenter: getStepCenterPlotData(lineData, scatterData); break; + case lsImpulse: getImpulsePlotData(lineData, scatterData); break; + } +} + +/*! \internal + + If line style is \ref lsNone and the scatter style's shape is not \ref QCPScatterStyle::ssNone, + this function serves at providing the visible data points in \a scatterData, so the \ref + drawScatterPlot function can draw the scatter points accordingly. + + If line style is not \ref lsNone, this function is not called and the data for the scatter points + are (if needed) calculated inside the corresponding other "get(...)PlotData" functions. + + \see drawScatterPlot +*/ +void QCPGraph::getScatterPlotData(QVector *scatterData) const +{ + getPreparedData(0, scatterData); +} + +/*! \internal + + Places the raw data points needed for a normal linearly connected graph in \a linePixelData. + + As for all plot data retrieval functions, \a scatterData just contains all unaltered data (scatter) + points that are visible for drawing scatter points, if necessary. If drawing scatter points is + disabled (i.e. the scatter style's shape is \ref QCPScatterStyle::ssNone), pass 0 as \a + scatterData, and the function will skip filling the vector. + + \see drawLinePlot +*/ +void QCPGraph::getLinePlotData(QVector *linePixelData, QVector *scatterData) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + if (!linePixelData) { qDebug() << Q_FUNC_INFO << "null pointer passed as linePixelData"; return; } + + QVector lineData; + getPreparedData(&lineData, scatterData); + linePixelData->reserve(lineData.size()+2); // added 2 to reserve memory for lower/upper fill base points that might be needed for fill + linePixelData->resize(lineData.size()); + + // transform lineData points to pixels: + if (keyAxis->orientation() == Qt::Vertical) + { + for (int i=0; icoordToPixel(lineData.at(i).value)); + (*linePixelData)[i].setY(keyAxis->coordToPixel(lineData.at(i).key)); + } + } else // key axis is horizontal + { + for (int i=0; icoordToPixel(lineData.at(i).key)); + (*linePixelData)[i].setY(valueAxis->coordToPixel(lineData.at(i).value)); + } + } +} + +/*! + \internal + Places the raw data points needed for a step plot with left oriented steps in \a lineData. + + As for all plot data retrieval functions, \a scatterData just contains all unaltered data (scatter) + points that are visible for drawing scatter points, if necessary. If drawing scatter points is + disabled (i.e. the scatter style's shape is \ref QCPScatterStyle::ssNone), pass 0 as \a + scatterData, and the function will skip filling the vector. + + \see drawLinePlot +*/ +void QCPGraph::getStepLeftPlotData(QVector *linePixelData, QVector *scatterData) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + if (!linePixelData) { qDebug() << Q_FUNC_INFO << "null pointer passed as lineData"; return; } + + QVector lineData; + getPreparedData(&lineData, scatterData); + linePixelData->reserve(lineData.size()*2+2); // added 2 to reserve memory for lower/upper fill base points that might be needed for fill + linePixelData->resize(lineData.size()*2); + + // calculate steps from lineData and transform to pixel coordinates: + if (keyAxis->orientation() == Qt::Vertical) + { + double lastValue = valueAxis->coordToPixel(lineData.first().value); + double key; + for (int i=0; icoordToPixel(lineData.at(i).key); + (*linePixelData)[i*2+0].setX(lastValue); + (*linePixelData)[i*2+0].setY(key); + lastValue = valueAxis->coordToPixel(lineData.at(i).value); + (*linePixelData)[i*2+1].setX(lastValue); + (*linePixelData)[i*2+1].setY(key); + } + } else // key axis is horizontal + { + double lastValue = valueAxis->coordToPixel(lineData.first().value); + double key; + for (int i=0; icoordToPixel(lineData.at(i).key); + (*linePixelData)[i*2+0].setX(key); + (*linePixelData)[i*2+0].setY(lastValue); + lastValue = valueAxis->coordToPixel(lineData.at(i).value); + (*linePixelData)[i*2+1].setX(key); + (*linePixelData)[i*2+1].setY(lastValue); + } + } +} + +/*! + \internal + Places the raw data points needed for a step plot with right oriented steps in \a lineData. + + As for all plot data retrieval functions, \a scatterData just contains all unaltered data (scatter) + points that are visible for drawing scatter points, if necessary. If drawing scatter points is + disabled (i.e. the scatter style's shape is \ref QCPScatterStyle::ssNone), pass 0 as \a + scatterData, and the function will skip filling the vector. + + \see drawLinePlot +*/ +void QCPGraph::getStepRightPlotData(QVector *linePixelData, QVector *scatterData) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + if (!linePixelData) { qDebug() << Q_FUNC_INFO << "null pointer passed as lineData"; return; } + + QVector lineData; + getPreparedData(&lineData, scatterData); + linePixelData->reserve(lineData.size()*2+2); // added 2 to reserve memory for lower/upper fill base points that might be needed for fill + linePixelData->resize(lineData.size()*2); + + // calculate steps from lineData and transform to pixel coordinates: + if (keyAxis->orientation() == Qt::Vertical) + { + double lastKey = keyAxis->coordToPixel(lineData.first().key); + double value; + for (int i=0; icoordToPixel(lineData.at(i).value); + (*linePixelData)[i*2+0].setX(value); + (*linePixelData)[i*2+0].setY(lastKey); + lastKey = keyAxis->coordToPixel(lineData.at(i).key); + (*linePixelData)[i*2+1].setX(value); + (*linePixelData)[i*2+1].setY(lastKey); + } + } else // key axis is horizontal + { + double lastKey = keyAxis->coordToPixel(lineData.first().key); + double value; + for (int i=0; icoordToPixel(lineData.at(i).value); + (*linePixelData)[i*2+0].setX(lastKey); + (*linePixelData)[i*2+0].setY(value); + lastKey = keyAxis->coordToPixel(lineData.at(i).key); + (*linePixelData)[i*2+1].setX(lastKey); + (*linePixelData)[i*2+1].setY(value); + } + } +} + +/*! + \internal + Places the raw data points needed for a step plot with centered steps in \a lineData. + + As for all plot data retrieval functions, \a scatterData just contains all unaltered data (scatter) + points that are visible for drawing scatter points, if necessary. If drawing scatter points is + disabled (i.e. the scatter style's shape is \ref QCPScatterStyle::ssNone), pass 0 as \a + scatterData, and the function will skip filling the vector. + + \see drawLinePlot +*/ +void QCPGraph::getStepCenterPlotData(QVector *linePixelData, QVector *scatterData) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + if (!linePixelData) { qDebug() << Q_FUNC_INFO << "null pointer passed as lineData"; return; } + + QVector lineData; + getPreparedData(&lineData, scatterData); + linePixelData->reserve(lineData.size()*2+2); // added 2 to reserve memory for lower/upper fill base points that might be needed for fill + linePixelData->resize(lineData.size()*2); + // calculate steps from lineData and transform to pixel coordinates: + if (keyAxis->orientation() == Qt::Vertical) + { + double lastKey = keyAxis->coordToPixel(lineData.first().key); + double lastValue = valueAxis->coordToPixel(lineData.first().value); + double key; + (*linePixelData)[0].setX(lastValue); + (*linePixelData)[0].setY(lastKey); + for (int i=1; icoordToPixel(lineData.at(i).key)+lastKey)*0.5; + (*linePixelData)[i*2-1].setX(lastValue); + (*linePixelData)[i*2-1].setY(key); + lastValue = valueAxis->coordToPixel(lineData.at(i).value); + lastKey = keyAxis->coordToPixel(lineData.at(i).key); + (*linePixelData)[i*2+0].setX(lastValue); + (*linePixelData)[i*2+0].setY(key); + } + (*linePixelData)[lineData.size()*2-1].setX(lastValue); + (*linePixelData)[lineData.size()*2-1].setY(lastKey); + } else // key axis is horizontal + { + double lastKey = keyAxis->coordToPixel(lineData.first().key); + double lastValue = valueAxis->coordToPixel(lineData.first().value); + double key; + (*linePixelData)[0].setX(lastKey); + (*linePixelData)[0].setY(lastValue); + for (int i=1; icoordToPixel(lineData.at(i).key)+lastKey)*0.5; + (*linePixelData)[i*2-1].setX(key); + (*linePixelData)[i*2-1].setY(lastValue); + lastValue = valueAxis->coordToPixel(lineData.at(i).value); + lastKey = keyAxis->coordToPixel(lineData.at(i).key); + (*linePixelData)[i*2+0].setX(key); + (*linePixelData)[i*2+0].setY(lastValue); + } + (*linePixelData)[lineData.size()*2-1].setX(lastKey); + (*linePixelData)[lineData.size()*2-1].setY(lastValue); + } + +} + +/*! + \internal + Places the raw data points needed for an impulse plot in \a lineData. + + As for all plot data retrieval functions, \a scatterData just contains all unaltered data (scatter) + points that are visible for drawing scatter points, if necessary. If drawing scatter points is + disabled (i.e. the scatter style's shape is \ref QCPScatterStyle::ssNone), pass 0 as \a + scatterData, and the function will skip filling the vector. + + \see drawImpulsePlot +*/ +void QCPGraph::getImpulsePlotData(QVector *linePixelData, QVector *scatterData) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + if (!linePixelData) { qDebug() << Q_FUNC_INFO << "null pointer passed as linePixelData"; return; } + + QVector lineData; + getPreparedData(&lineData, scatterData); + linePixelData->resize(lineData.size()*2); // no need to reserve 2 extra points because impulse plot has no fill + + // transform lineData points to pixels: + if (keyAxis->orientation() == Qt::Vertical) + { + double zeroPointX = valueAxis->coordToPixel(0); + double key; + for (int i=0; icoordToPixel(lineData.at(i).key); + (*linePixelData)[i*2+0].setX(zeroPointX); + (*linePixelData)[i*2+0].setY(key); + (*linePixelData)[i*2+1].setX(valueAxis->coordToPixel(lineData.at(i).value)); + (*linePixelData)[i*2+1].setY(key); + } + } else // key axis is horizontal + { + double zeroPointY = valueAxis->coordToPixel(0); + double key; + for (int i=0; icoordToPixel(lineData.at(i).key); + (*linePixelData)[i*2+0].setX(key); + (*linePixelData)[i*2+0].setY(zeroPointY); + (*linePixelData)[i*2+1].setX(key); + (*linePixelData)[i*2+1].setY(valueAxis->coordToPixel(lineData.at(i).value)); + } + } +} + +/*! \internal + + Draws the fill of the graph with the specified brush. + + If the fill is a normal fill towards the zero-value-line, only the \a lineData is required (and + two extra points at the zero-value-line, which are added by \ref addFillBasePoints and removed by + \ref removeFillBasePoints after the fill drawing is done). + + If the fill is a channel fill between this QCPGraph and another QCPGraph (mChannelFillGraph), the + more complex polygon is calculated with the \ref getChannelFillPolygon function. + + \see drawLinePlot +*/ +void QCPGraph::drawFill(QCPPainter *painter, QVector *lineData) const +{ + if (mLineStyle == lsImpulse) return; // fill doesn't make sense for impulse plot + if (mainBrush().style() == Qt::NoBrush || mainBrush().color().alpha() == 0) return; + + applyFillAntialiasingHint(painter); + if (!mChannelFillGraph) + { + // draw base fill under graph, fill goes all the way to the zero-value-line: + addFillBasePoints(lineData); + painter->setPen(Qt::NoPen); + painter->setBrush(mainBrush()); + painter->drawPolygon(QPolygonF(*lineData)); + removeFillBasePoints(lineData); + } else + { + // draw channel fill between this graph and mChannelFillGraph: + painter->setPen(Qt::NoPen); + painter->setBrush(mainBrush()); + painter->drawPolygon(getChannelFillPolygon(lineData)); + } +} + +/*! \internal + + Draws scatter symbols at every data point passed in \a scatterData. scatter symbols are independent + of the line style and are always drawn if the scatter style's shape is not \ref + QCPScatterStyle::ssNone. Hence, the \a scatterData vector is outputted by all "get(...)PlotData" + functions, together with the (line style dependent) line data. + + \see drawLinePlot, drawImpulsePlot +*/ +void QCPGraph::drawScatterPlot(QCPPainter *painter, QVector *scatterData) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + + // draw error bars: + if (mErrorType != etNone) + { + applyErrorBarsAntialiasingHint(painter); + painter->setPen(mErrorPen); + if (keyAxis->orientation() == Qt::Vertical) + { + for (int i=0; isize(); ++i) + drawError(painter, valueAxis->coordToPixel(scatterData->at(i).value), keyAxis->coordToPixel(scatterData->at(i).key), scatterData->at(i)); + } else + { + for (int i=0; isize(); ++i) + drawError(painter, keyAxis->coordToPixel(scatterData->at(i).key), valueAxis->coordToPixel(scatterData->at(i).value), scatterData->at(i)); + } + } + + // draw scatter point symbols: + applyScattersAntialiasingHint(painter); + mScatterStyle.applyTo(painter, mPen); + if (keyAxis->orientation() == Qt::Vertical) + { + for (int i=0; isize(); ++i) + if (!qIsNaN(scatterData->at(i).value)) + mScatterStyle.drawShape(painter, valueAxis->coordToPixel(scatterData->at(i).value), keyAxis->coordToPixel(scatterData->at(i).key)); + } else + { + for (int i=0; isize(); ++i) + if (!qIsNaN(scatterData->at(i).value)) + mScatterStyle.drawShape(painter, keyAxis->coordToPixel(scatterData->at(i).key), valueAxis->coordToPixel(scatterData->at(i).value)); + } +} + +/*! \internal + + Draws line graphs from the provided data. It connects all points in \a lineData, which was + created by one of the "get(...)PlotData" functions for line styles that require simple line + connections between the point vector they create. These are for example \ref getLinePlotData, + \ref getStepLeftPlotData, \ref getStepRightPlotData and \ref getStepCenterPlotData. + + \see drawScatterPlot, drawImpulsePlot +*/ +void QCPGraph::drawLinePlot(QCPPainter *painter, QVector *lineData) const +{ + // draw line of graph: + if (mainPen().style() != Qt::NoPen && mainPen().color().alpha() != 0) + { + applyDefaultAntialiasingHint(painter); + painter->setPen(mainPen()); + painter->setBrush(Qt::NoBrush); + + /* Draws polyline in batches, currently not used: + int p = 0; + while (p < lineData->size()) + { + int batch = qMin(25, lineData->size()-p); + if (p != 0) + { + ++batch; + --p; // to draw the connection lines between two batches + } + painter->drawPolyline(lineData->constData()+p, batch); + p += batch; + } + */ + + // if drawing solid line and not in PDF, use much faster line drawing instead of polyline: + if (mParentPlot->plottingHints().testFlag(QCP::phFastPolylines) && + painter->pen().style() == Qt::SolidLine && + !painter->modes().testFlag(QCPPainter::pmVectorized) && + !painter->modes().testFlag(QCPPainter::pmNoCaching)) + { + int i = 0; + bool lastIsNan = false; + const int lineDataSize = lineData->size(); + while (i < lineDataSize && (qIsNaN(lineData->at(i).y()) || qIsNaN(lineData->at(i).x()))) // make sure first point is not NaN + ++i; + ++i; // because drawing works in 1 point retrospect + while (i < lineDataSize) + { + if (!qIsNaN(lineData->at(i).y()) && !qIsNaN(lineData->at(i).x())) // NaNs create a gap in the line + { + if (!lastIsNan) + painter->drawLine(lineData->at(i-1), lineData->at(i)); + else + lastIsNan = false; + } else + lastIsNan = true; + ++i; + } + } else + { + int segmentStart = 0; + int i = 0; + const int lineDataSize = lineData->size(); + while (i < lineDataSize) + { + if (qIsNaN(lineData->at(i).y()) || qIsNaN(lineData->at(i).x()) || qIsInf(lineData->at(i).y())) // NaNs create a gap in the line. Also filter Infs which make drawPolyline block + { + painter->drawPolyline(lineData->constData()+segmentStart, i-segmentStart); // i, because we don't want to include the current NaN point + segmentStart = i+1; + } + ++i; + } + // draw last segment: + painter->drawPolyline(lineData->constData()+segmentStart, lineDataSize-segmentStart); + } + } +} + +/*! \internal + + Draws impulses from the provided data, i.e. it connects all line pairs in \a lineData, which was + created by \ref getImpulsePlotData. + + \see drawScatterPlot, drawLinePlot +*/ +void QCPGraph::drawImpulsePlot(QCPPainter *painter, QVector *lineData) const +{ + // draw impulses: + if (mainPen().style() != Qt::NoPen && mainPen().color().alpha() != 0) + { + applyDefaultAntialiasingHint(painter); + QPen pen = mainPen(); + pen.setCapStyle(Qt::FlatCap); // so impulse line doesn't reach beyond zero-line + painter->setPen(pen); + painter->setBrush(Qt::NoBrush); + painter->drawLines(*lineData); + } +} + +/*! \internal + + Returns the \a lineData and \a scatterData that need to be plotted for this graph taking into + consideration the current axis ranges and, if \ref setAdaptiveSampling is enabled, local point + densities. + + 0 may be passed as \a lineData or \a scatterData to indicate that the respective dataset isn't + needed. For example, if the scatter style (\ref setScatterStyle) is \ref QCPScatterStyle::ssNone, \a + scatterData should be 0 to prevent unnecessary calculations. + + This method is used by the various "get(...)PlotData" methods to get the basic working set of data. +*/ +void QCPGraph::getPreparedData(QVector *lineData, QVector *scatterData) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + // get visible data range: + QCPDataMap::const_iterator lower, upper; // note that upper is the actual upper point, and not 1 step after the upper point + getVisibleDataBounds(lower, upper); + if (lower == mData->constEnd() || upper == mData->constEnd()) + return; + + // count points in visible range, taking into account that we only need to count to the limit maxCount if using adaptive sampling: + int maxCount = std::numeric_limits::max(); + if (mAdaptiveSampling) + { + int keyPixelSpan = qAbs(keyAxis->coordToPixel(lower.key())-keyAxis->coordToPixel(upper.key())); + maxCount = 2*keyPixelSpan+2; + } + int dataCount = countDataInBounds(lower, upper, maxCount); + + if (mAdaptiveSampling && dataCount >= maxCount) // use adaptive sampling only if there are at least two points per pixel on average + { + if (lineData) + { + QCPDataMap::const_iterator it = lower; + QCPDataMap::const_iterator upperEnd = upper+1; + double minValue = it.value().value; + double maxValue = it.value().value; + QCPDataMap::const_iterator currentIntervalFirstPoint = it; + int reversedFactor = keyAxis->rangeReversed() != (keyAxis->orientation()==Qt::Vertical) ? -1 : 1; // is used to calculate keyEpsilon pixel into the correct direction + int reversedRound = keyAxis->rangeReversed() != (keyAxis->orientation()==Qt::Vertical) ? 1 : 0; // is used to switch between floor (normal) and ceil (reversed) rounding of currentIntervalStartKey + double currentIntervalStartKey = keyAxis->pixelToCoord((int)(keyAxis->coordToPixel(lower.key())+reversedRound)); + double lastIntervalEndKey = currentIntervalStartKey; + double keyEpsilon = qAbs(currentIntervalStartKey-keyAxis->pixelToCoord(keyAxis->coordToPixel(currentIntervalStartKey)+1.0*reversedFactor)); // interval of one pixel on screen when mapped to plot key coordinates + bool keyEpsilonVariable = keyAxis->scaleType() == QCPAxis::stLogarithmic; // indicates whether keyEpsilon needs to be updated after every interval (for log axes) + int intervalDataCount = 1; + ++it; // advance iterator to second data point because adaptive sampling works in 1 point retrospect + while (it != upperEnd) + { + if (it.key() < currentIntervalStartKey+keyEpsilon) // data point is still within same pixel, so skip it and expand value span of this cluster if necessary + { + if (it.value().value < minValue) + minValue = it.value().value; + else if (it.value().value > maxValue) + maxValue = it.value().value; + ++intervalDataCount; + } else // new pixel interval started + { + if (intervalDataCount >= 2) // last pixel had multiple data points, consolidate them to a cluster + { + if (lastIntervalEndKey < currentIntervalStartKey-keyEpsilon) // last point is further away, so first point of this cluster must be at a real data point + lineData->append(QCPData(currentIntervalStartKey+keyEpsilon*0.2, currentIntervalFirstPoint.value().value)); + lineData->append(QCPData(currentIntervalStartKey+keyEpsilon*0.25, minValue)); + lineData->append(QCPData(currentIntervalStartKey+keyEpsilon*0.75, maxValue)); + if (it.key() > currentIntervalStartKey+keyEpsilon*2) // new pixel started further away from previous cluster, so make sure the last point of the cluster is at a real data point + lineData->append(QCPData(currentIntervalStartKey+keyEpsilon*0.8, (it-1).value().value)); + } else + lineData->append(QCPData(currentIntervalFirstPoint.key(), currentIntervalFirstPoint.value().value)); + lastIntervalEndKey = (it-1).value().key; + minValue = it.value().value; + maxValue = it.value().value; + currentIntervalFirstPoint = it; + currentIntervalStartKey = keyAxis->pixelToCoord((int)(keyAxis->coordToPixel(it.key())+reversedRound)); + if (keyEpsilonVariable) + keyEpsilon = qAbs(currentIntervalStartKey-keyAxis->pixelToCoord(keyAxis->coordToPixel(currentIntervalStartKey)+1.0*reversedFactor)); + intervalDataCount = 1; + } + ++it; + } + // handle last interval: + if (intervalDataCount >= 2) // last pixel had multiple data points, consolidate them to a cluster + { + if (lastIntervalEndKey < currentIntervalStartKey-keyEpsilon) // last point wasn't a cluster, so first point of this cluster must be at a real data point + lineData->append(QCPData(currentIntervalStartKey+keyEpsilon*0.2, currentIntervalFirstPoint.value().value)); + lineData->append(QCPData(currentIntervalStartKey+keyEpsilon*0.25, minValue)); + lineData->append(QCPData(currentIntervalStartKey+keyEpsilon*0.75, maxValue)); + } else + lineData->append(QCPData(currentIntervalFirstPoint.key(), currentIntervalFirstPoint.value().value)); + } + + if (scatterData) + { + double valueMaxRange = valueAxis->range().upper; + double valueMinRange = valueAxis->range().lower; + QCPDataMap::const_iterator it = lower; + QCPDataMap::const_iterator upperEnd = upper+1; + double minValue = it.value().value; + double maxValue = it.value().value; + QCPDataMap::const_iterator minValueIt = it; + QCPDataMap::const_iterator maxValueIt = it; + QCPDataMap::const_iterator currentIntervalStart = it; + int reversedFactor = keyAxis->rangeReversed() ? -1 : 1; // is used to calculate keyEpsilon pixel into the correct direction + int reversedRound = keyAxis->rangeReversed() ? 1 : 0; // is used to switch between floor (normal) and ceil (reversed) rounding of currentIntervalStartKey + double currentIntervalStartKey = keyAxis->pixelToCoord((int)(keyAxis->coordToPixel(lower.key())+reversedRound)); + double keyEpsilon = qAbs(currentIntervalStartKey-keyAxis->pixelToCoord(keyAxis->coordToPixel(currentIntervalStartKey)+1.0*reversedFactor)); // interval of one pixel on screen when mapped to plot key coordinates + bool keyEpsilonVariable = keyAxis->scaleType() == QCPAxis::stLogarithmic; // indicates whether keyEpsilon needs to be updated after every interval (for log axes) + int intervalDataCount = 1; + ++it; // advance iterator to second data point because adaptive sampling works in 1 point retrospect + while (it != upperEnd) + { + if (it.key() < currentIntervalStartKey+keyEpsilon) // data point is still within same pixel, so skip it and expand value span of this pixel if necessary + { + if (it.value().value < minValue && it.value().value > valueMinRange && it.value().value < valueMaxRange) + { + minValue = it.value().value; + minValueIt = it; + } else if (it.value().value > maxValue && it.value().value > valueMinRange && it.value().value < valueMaxRange) + { + maxValue = it.value().value; + maxValueIt = it; + } + ++intervalDataCount; + } else // new pixel started + { + if (intervalDataCount >= 2) // last pixel had multiple data points, consolidate them + { + // determine value pixel span and add as many points in interval to maintain certain vertical data density (this is specific to scatter plot): + double valuePixelSpan = qAbs(valueAxis->coordToPixel(minValue)-valueAxis->coordToPixel(maxValue)); + int dataModulo = qMax(1, qRound(intervalDataCount/(valuePixelSpan/4.0))); // approximately every 4 value pixels one data point on average + QCPDataMap::const_iterator intervalIt = currentIntervalStart; + int c = 0; + while (intervalIt != it) + { + if ((c % dataModulo == 0 || intervalIt == minValueIt || intervalIt == maxValueIt) && intervalIt.value().value > valueMinRange && intervalIt.value().value < valueMaxRange) + scatterData->append(intervalIt.value()); + ++c; + ++intervalIt; + } + } else if (currentIntervalStart.value().value > valueMinRange && currentIntervalStart.value().value < valueMaxRange) + scatterData->append(currentIntervalStart.value()); + minValue = it.value().value; + maxValue = it.value().value; + currentIntervalStart = it; + currentIntervalStartKey = keyAxis->pixelToCoord((int)(keyAxis->coordToPixel(it.key())+reversedRound)); + if (keyEpsilonVariable) + keyEpsilon = qAbs(currentIntervalStartKey-keyAxis->pixelToCoord(keyAxis->coordToPixel(currentIntervalStartKey)+1.0*reversedFactor)); + intervalDataCount = 1; + } + ++it; + } + // handle last interval: + if (intervalDataCount >= 2) // last pixel had multiple data points, consolidate them + { + // determine value pixel span and add as many points in interval to maintain certain vertical data density (this is specific to scatter plot): + double valuePixelSpan = qAbs(valueAxis->coordToPixel(minValue)-valueAxis->coordToPixel(maxValue)); + int dataModulo = qMax(1, qRound(intervalDataCount/(valuePixelSpan/4.0))); // approximately every 4 value pixels one data point on average + QCPDataMap::const_iterator intervalIt = currentIntervalStart; + int c = 0; + while (intervalIt != it) + { + if ((c % dataModulo == 0 || intervalIt == minValueIt || intervalIt == maxValueIt) && intervalIt.value().value > valueMinRange && intervalIt.value().value < valueMaxRange) + scatterData->append(intervalIt.value()); + ++c; + ++intervalIt; + } + } else if (currentIntervalStart.value().value > valueMinRange && currentIntervalStart.value().value < valueMaxRange) + scatterData->append(currentIntervalStart.value()); + } + } else // don't use adaptive sampling algorithm, transfer points one-to-one from the map into the output parameters + { + QVector *dataVector = 0; + if (lineData) + dataVector = lineData; + else if (scatterData) + dataVector = scatterData; + if (dataVector) + { + QCPDataMap::const_iterator it = lower; + QCPDataMap::const_iterator upperEnd = upper+1; + dataVector->reserve(dataCount+2); // +2 for possible fill end points + while (it != upperEnd) + { + dataVector->append(it.value()); + ++it; + } + } + if (lineData && scatterData) + *scatterData = *dataVector; + } +} + +/*! \internal + + called by the scatter drawing function (\ref drawScatterPlot) to draw the error bars on one data + point. \a x and \a y pixel positions of the data point are passed since they are already known in + pixel coordinates in the drawing function, so we save some extra coordToPixel transforms here. \a + data is therefore only used for the errors, not key and value. +*/ +void QCPGraph::drawError(QCPPainter *painter, double x, double y, const QCPData &data) const +{ + if (qIsNaN(data.value)) + return; + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + + double a, b; // positions of error bar bounds in pixels + double barWidthHalf = mErrorBarSize*0.5; + double skipSymbolMargin = mScatterStyle.size(); // pixels left blank per side, when mErrorBarSkipSymbol is true + + if (keyAxis->orientation() == Qt::Vertical) + { + // draw key error vertically and value error horizontally + if (mErrorType == etKey || mErrorType == etBoth) + { + a = keyAxis->coordToPixel(data.key-data.keyErrorMinus); + b = keyAxis->coordToPixel(data.key+data.keyErrorPlus); + if (keyAxis->rangeReversed()) + qSwap(a,b); + // draw spine: + if (mErrorBarSkipSymbol) + { + if (a-y > skipSymbolMargin) // don't draw spine if error is so small it's within skipSymbolmargin + painter->drawLine(QLineF(x, a, x, y+skipSymbolMargin)); + if (y-b > skipSymbolMargin) + painter->drawLine(QLineF(x, y-skipSymbolMargin, x, b)); + } else + painter->drawLine(QLineF(x, a, x, b)); + // draw handles: + painter->drawLine(QLineF(x-barWidthHalf, a, x+barWidthHalf, a)); + painter->drawLine(QLineF(x-barWidthHalf, b, x+barWidthHalf, b)); + } + if (mErrorType == etValue || mErrorType == etBoth) + { + a = valueAxis->coordToPixel(data.value-data.valueErrorMinus); + b = valueAxis->coordToPixel(data.value+data.valueErrorPlus); + if (valueAxis->rangeReversed()) + qSwap(a,b); + // draw spine: + if (mErrorBarSkipSymbol) + { + if (x-a > skipSymbolMargin) // don't draw spine if error is so small it's within skipSymbolmargin + painter->drawLine(QLineF(a, y, x-skipSymbolMargin, y)); + if (b-x > skipSymbolMargin) + painter->drawLine(QLineF(x+skipSymbolMargin, y, b, y)); + } else + painter->drawLine(QLineF(a, y, b, y)); + // draw handles: + painter->drawLine(QLineF(a, y-barWidthHalf, a, y+barWidthHalf)); + painter->drawLine(QLineF(b, y-barWidthHalf, b, y+barWidthHalf)); + } + } else // mKeyAxis->orientation() is Qt::Horizontal + { + // draw value error vertically and key error horizontally + if (mErrorType == etKey || mErrorType == etBoth) + { + a = keyAxis->coordToPixel(data.key-data.keyErrorMinus); + b = keyAxis->coordToPixel(data.key+data.keyErrorPlus); + if (keyAxis->rangeReversed()) + qSwap(a,b); + // draw spine: + if (mErrorBarSkipSymbol) + { + if (x-a > skipSymbolMargin) // don't draw spine if error is so small it's within skipSymbolmargin + painter->drawLine(QLineF(a, y, x-skipSymbolMargin, y)); + if (b-x > skipSymbolMargin) + painter->drawLine(QLineF(x+skipSymbolMargin, y, b, y)); + } else + painter->drawLine(QLineF(a, y, b, y)); + // draw handles: + painter->drawLine(QLineF(a, y-barWidthHalf, a, y+barWidthHalf)); + painter->drawLine(QLineF(b, y-barWidthHalf, b, y+barWidthHalf)); + } + if (mErrorType == etValue || mErrorType == etBoth) + { + a = valueAxis->coordToPixel(data.value-data.valueErrorMinus); + b = valueAxis->coordToPixel(data.value+data.valueErrorPlus); + if (valueAxis->rangeReversed()) + qSwap(a,b); + // draw spine: + if (mErrorBarSkipSymbol) + { + if (a-y > skipSymbolMargin) // don't draw spine if error is so small it's within skipSymbolmargin + painter->drawLine(QLineF(x, a, x, y+skipSymbolMargin)); + if (y-b > skipSymbolMargin) + painter->drawLine(QLineF(x, y-skipSymbolMargin, x, b)); + } else + painter->drawLine(QLineF(x, a, x, b)); + // draw handles: + painter->drawLine(QLineF(x-barWidthHalf, a, x+barWidthHalf, a)); + painter->drawLine(QLineF(x-barWidthHalf, b, x+barWidthHalf, b)); + } + } +} + +/*! \internal + + called by \ref getPreparedData to determine which data (key) range is visible at the current key + axis range setting, so only that needs to be processed. + + \a lower returns an iterator to the lowest data point that needs to be taken into account when + plotting. Note that in order to get a clean plot all the way to the edge of the axis rect, \a + lower may still be just outside the visible range. + + \a upper returns an iterator to the highest data point. Same as before, \a upper may also lie + just outside of the visible range. + + if the graph contains no data, both \a lower and \a upper point to constEnd. +*/ +void QCPGraph::getVisibleDataBounds(QCPDataMap::const_iterator &lower, QCPDataMap::const_iterator &upper) const +{ + if (!mKeyAxis) { qDebug() << Q_FUNC_INFO << "invalid key axis"; return; } + if (mData->isEmpty()) + { + lower = mData->constEnd(); + upper = mData->constEnd(); + return; + } + + // get visible data range as QMap iterators + QCPDataMap::const_iterator lbound = mData->lowerBound(mKeyAxis.data()->range().lower); + QCPDataMap::const_iterator ubound = mData->upperBound(mKeyAxis.data()->range().upper); + bool lowoutlier = lbound != mData->constBegin(); // indicates whether there exist points below axis range + bool highoutlier = ubound != mData->constEnd(); // indicates whether there exist points above axis range + + lower = (lowoutlier ? lbound-1 : lbound); // data point range that will be actually drawn + upper = (highoutlier ? ubound : ubound-1); // data point range that will be actually drawn +} + +/*! \internal + + Counts the number of data points between \a lower and \a upper (including them), up to a maximum + of \a maxCount. + + This function is used by \ref getPreparedData to determine whether adaptive sampling shall be + used (if enabled via \ref setAdaptiveSampling) or not. This is also why counting of data points + only needs to be done until \a maxCount is reached, which should be set to the number of data + points at which adaptive sampling sets in. +*/ +int QCPGraph::countDataInBounds(const QCPDataMap::const_iterator &lower, const QCPDataMap::const_iterator &upper, int maxCount) const +{ + if (upper == mData->constEnd() && lower == mData->constEnd()) + return 0; + QCPDataMap::const_iterator it = lower; + int count = 1; + while (it != upper && count < maxCount) + { + ++it; + ++count; + } + return count; +} + +/*! \internal + + The line data vector generated by e.g. getLinePlotData contains only the line that connects the + data points. If the graph needs to be filled, two additional points need to be added at the + value-zero-line in the lower and upper key positions of the graph. This function calculates these + points and adds them to the end of \a lineData. Since the fill is typically drawn before the line + stroke, these added points need to be removed again after the fill is done, with the + removeFillBasePoints function. + + The expanding of \a lineData by two points will not cause unnecessary memory reallocations, + because the data vector generation functions (getLinePlotData etc.) reserve two extra points when + they allocate memory for \a lineData. + + \see removeFillBasePoints, lowerFillBasePoint, upperFillBasePoint +*/ +void QCPGraph::addFillBasePoints(QVector *lineData) const +{ + if (!mKeyAxis) { qDebug() << Q_FUNC_INFO << "invalid key axis"; return; } + if (!lineData) { qDebug() << Q_FUNC_INFO << "passed null as lineData"; return; } + if (lineData->isEmpty()) return; + + // append points that close the polygon fill at the key axis: + if (mKeyAxis.data()->orientation() == Qt::Vertical) + { + *lineData << upperFillBasePoint(lineData->last().y()); + *lineData << lowerFillBasePoint(lineData->first().y()); + } else + { + *lineData << upperFillBasePoint(lineData->last().x()); + *lineData << lowerFillBasePoint(lineData->first().x()); + } +} + +/*! \internal + + removes the two points from \a lineData that were added by \ref addFillBasePoints. + + \see addFillBasePoints, lowerFillBasePoint, upperFillBasePoint +*/ +void QCPGraph::removeFillBasePoints(QVector *lineData) const +{ + if (!lineData) { qDebug() << Q_FUNC_INFO << "passed null as lineData"; return; } + if (lineData->isEmpty()) return; + + lineData->remove(lineData->size()-2, 2); +} + +/*! \internal + + called by \ref addFillBasePoints to conveniently assign the point which closes the fill polygon + on the lower side of the zero-value-line parallel to the key axis. The logarithmic axis scale + case is a bit special, since the zero-value-line in pixel coordinates is in positive or negative + infinity. So this case is handled separately by just closing the fill polygon on the axis which + lies in the direction towards the zero value. + + \a lowerKey will be the the key (in pixels) of the returned point. Depending on whether the key + axis is horizontal or vertical, \a lowerKey will end up as the x or y value of the returned + point, respectively. + + \see upperFillBasePoint, addFillBasePoints +*/ +QPointF QCPGraph::lowerFillBasePoint(double lowerKey) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return QPointF(); } + + QPointF point; + if (valueAxis->scaleType() == QCPAxis::stLinear) + { + if (keyAxis->axisType() == QCPAxis::atLeft) + { + point.setX(valueAxis->coordToPixel(0)); + point.setY(lowerKey); + } else if (keyAxis->axisType() == QCPAxis::atRight) + { + point.setX(valueAxis->coordToPixel(0)); + point.setY(lowerKey); + } else if (keyAxis->axisType() == QCPAxis::atTop) + { + point.setX(lowerKey); + point.setY(valueAxis->coordToPixel(0)); + } else if (keyAxis->axisType() == QCPAxis::atBottom) + { + point.setX(lowerKey); + point.setY(valueAxis->coordToPixel(0)); + } + } else // valueAxis->mScaleType == QCPAxis::stLogarithmic + { + // In logarithmic scaling we can't just draw to value zero so we just fill all the way + // to the axis which is in the direction towards zero + if (keyAxis->orientation() == Qt::Vertical) + { + if ((valueAxis->range().upper < 0 && !valueAxis->rangeReversed()) || + (valueAxis->range().upper > 0 && valueAxis->rangeReversed())) // if range is negative, zero is on opposite side of key axis + point.setX(keyAxis->axisRect()->right()); + else + point.setX(keyAxis->axisRect()->left()); + point.setY(lowerKey); + } else if (keyAxis->axisType() == QCPAxis::atTop || keyAxis->axisType() == QCPAxis::atBottom) + { + point.setX(lowerKey); + if ((valueAxis->range().upper < 0 && !valueAxis->rangeReversed()) || + (valueAxis->range().upper > 0 && valueAxis->rangeReversed())) // if range is negative, zero is on opposite side of key axis + point.setY(keyAxis->axisRect()->top()); + else + point.setY(keyAxis->axisRect()->bottom()); + } + } + return point; +} + +/*! \internal + + called by \ref addFillBasePoints to conveniently assign the point which closes the fill + polygon on the upper side of the zero-value-line parallel to the key axis. The logarithmic axis + scale case is a bit special, since the zero-value-line in pixel coordinates is in positive or + negative infinity. So this case is handled separately by just closing the fill polygon on the + axis which lies in the direction towards the zero value. + + \a upperKey will be the the key (in pixels) of the returned point. Depending on whether the key + axis is horizontal or vertical, \a upperKey will end up as the x or y value of the returned + point, respectively. + + \see lowerFillBasePoint, addFillBasePoints +*/ +QPointF QCPGraph::upperFillBasePoint(double upperKey) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return QPointF(); } + + QPointF point; + if (valueAxis->scaleType() == QCPAxis::stLinear) + { + if (keyAxis->axisType() == QCPAxis::atLeft) + { + point.setX(valueAxis->coordToPixel(0)); + point.setY(upperKey); + } else if (keyAxis->axisType() == QCPAxis::atRight) + { + point.setX(valueAxis->coordToPixel(0)); + point.setY(upperKey); + } else if (keyAxis->axisType() == QCPAxis::atTop) + { + point.setX(upperKey); + point.setY(valueAxis->coordToPixel(0)); + } else if (keyAxis->axisType() == QCPAxis::atBottom) + { + point.setX(upperKey); + point.setY(valueAxis->coordToPixel(0)); + } + } else // valueAxis->mScaleType == QCPAxis::stLogarithmic + { + // In logarithmic scaling we can't just draw to value 0 so we just fill all the way + // to the axis which is in the direction towards 0 + if (keyAxis->orientation() == Qt::Vertical) + { + if ((valueAxis->range().upper < 0 && !valueAxis->rangeReversed()) || + (valueAxis->range().upper > 0 && valueAxis->rangeReversed())) // if range is negative, zero is on opposite side of key axis + point.setX(keyAxis->axisRect()->right()); + else + point.setX(keyAxis->axisRect()->left()); + point.setY(upperKey); + } else if (keyAxis->axisType() == QCPAxis::atTop || keyAxis->axisType() == QCPAxis::atBottom) + { + point.setX(upperKey); + if ((valueAxis->range().upper < 0 && !valueAxis->rangeReversed()) || + (valueAxis->range().upper > 0 && valueAxis->rangeReversed())) // if range is negative, zero is on opposite side of key axis + point.setY(keyAxis->axisRect()->top()); + else + point.setY(keyAxis->axisRect()->bottom()); + } + } + return point; +} + +/*! \internal + + Generates the polygon needed for drawing channel fills between this graph (data passed via \a + lineData) and the graph specified by mChannelFillGraph (data generated by calling its \ref + getPlotData function). May return an empty polygon if the key ranges have no overlap or fill + target graph and this graph don't have same orientation (i.e. both key axes horizontal or both + key axes vertical). For increased performance (due to implicit sharing), keep the returned + QPolygonF const. +*/ +const QPolygonF QCPGraph::getChannelFillPolygon(const QVector *lineData) const +{ + if (!mChannelFillGraph) + return QPolygonF(); + + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return QPolygonF(); } + if (!mChannelFillGraph.data()->mKeyAxis) { qDebug() << Q_FUNC_INFO << "channel fill target key axis invalid"; return QPolygonF(); } + + if (mChannelFillGraph.data()->mKeyAxis.data()->orientation() != keyAxis->orientation()) + return QPolygonF(); // don't have same axis orientation, can't fill that (Note: if keyAxis fits, valueAxis will fit too, because it's always orthogonal to keyAxis) + + if (lineData->isEmpty()) return QPolygonF(); + QVector otherData; + mChannelFillGraph.data()->getPlotData(&otherData, 0); + if (otherData.isEmpty()) return QPolygonF(); + QVector thisData; + thisData.reserve(lineData->size()+otherData.size()); // because we will join both vectors at end of this function + for (int i=0; isize(); ++i) // don't use the vector<<(vector), it squeezes internally, which ruins the performance tuning with reserve() + thisData << lineData->at(i); + + // pointers to be able to swap them, depending which data range needs cropping: + QVector *staticData = &thisData; + QVector *croppedData = &otherData; + + // crop both vectors to ranges in which the keys overlap (which coord is key, depends on axisType): + if (keyAxis->orientation() == Qt::Horizontal) + { + // x is key + // if an axis range is reversed, the data point keys will be descending. Reverse them, since following algorithm assumes ascending keys: + if (staticData->first().x() > staticData->last().x()) + { + int size = staticData->size(); + for (int i=0; ifirst().x() > croppedData->last().x()) + { + int size = croppedData->size(); + for (int i=0; ifirst().x() < croppedData->first().x()) // other one must be cropped + qSwap(staticData, croppedData); + int lowBound = findIndexBelowX(croppedData, staticData->first().x()); + if (lowBound == -1) return QPolygonF(); // key ranges have no overlap + croppedData->remove(0, lowBound); + // set lowest point of cropped data to fit exactly key position of first static data + // point via linear interpolation: + if (croppedData->size() < 2) return QPolygonF(); // need at least two points for interpolation + double slope; + if (croppedData->at(1).x()-croppedData->at(0).x() != 0) + slope = (croppedData->at(1).y()-croppedData->at(0).y())/(croppedData->at(1).x()-croppedData->at(0).x()); + else + slope = 0; + (*croppedData)[0].setY(croppedData->at(0).y()+slope*(staticData->first().x()-croppedData->at(0).x())); + (*croppedData)[0].setX(staticData->first().x()); + + // crop upper bound: + if (staticData->last().x() > croppedData->last().x()) // other one must be cropped + qSwap(staticData, croppedData); + int highBound = findIndexAboveX(croppedData, staticData->last().x()); + if (highBound == -1) return QPolygonF(); // key ranges have no overlap + croppedData->remove(highBound+1, croppedData->size()-(highBound+1)); + // set highest point of cropped data to fit exactly key position of last static data + // point via linear interpolation: + if (croppedData->size() < 2) return QPolygonF(); // need at least two points for interpolation + int li = croppedData->size()-1; // last index + if (croppedData->at(li).x()-croppedData->at(li-1).x() != 0) + slope = (croppedData->at(li).y()-croppedData->at(li-1).y())/(croppedData->at(li).x()-croppedData->at(li-1).x()); + else + slope = 0; + (*croppedData)[li].setY(croppedData->at(li-1).y()+slope*(staticData->last().x()-croppedData->at(li-1).x())); + (*croppedData)[li].setX(staticData->last().x()); + } else // mKeyAxis->orientation() == Qt::Vertical + { + // y is key + // similar to "x is key" but switched x,y. Further, lower/upper meaning is inverted compared to x, + // because in pixel coordinates, y increases from top to bottom, not bottom to top like data coordinate. + // if an axis range is reversed, the data point keys will be descending. Reverse them, since following algorithm assumes ascending keys: + if (staticData->first().y() < staticData->last().y()) + { + int size = staticData->size(); + for (int i=0; ifirst().y() < croppedData->last().y()) + { + int size = croppedData->size(); + for (int i=0; ifirst().y() > croppedData->first().y()) // other one must be cropped + qSwap(staticData, croppedData); + int lowBound = findIndexAboveY(croppedData, staticData->first().y()); + if (lowBound == -1) return QPolygonF(); // key ranges have no overlap + croppedData->remove(0, lowBound); + // set lowest point of cropped data to fit exactly key position of first static data + // point via linear interpolation: + if (croppedData->size() < 2) return QPolygonF(); // need at least two points for interpolation + double slope; + if (croppedData->at(1).y()-croppedData->at(0).y() != 0) // avoid division by zero in step plots + slope = (croppedData->at(1).x()-croppedData->at(0).x())/(croppedData->at(1).y()-croppedData->at(0).y()); + else + slope = 0; + (*croppedData)[0].setX(croppedData->at(0).x()+slope*(staticData->first().y()-croppedData->at(0).y())); + (*croppedData)[0].setY(staticData->first().y()); + + // crop upper bound: + if (staticData->last().y() < croppedData->last().y()) // other one must be cropped + qSwap(staticData, croppedData); + int highBound = findIndexBelowY(croppedData, staticData->last().y()); + if (highBound == -1) return QPolygonF(); // key ranges have no overlap + croppedData->remove(highBound+1, croppedData->size()-(highBound+1)); + // set highest point of cropped data to fit exactly key position of last static data + // point via linear interpolation: + if (croppedData->size() < 2) return QPolygonF(); // need at least two points for interpolation + int li = croppedData->size()-1; // last index + if (croppedData->at(li).y()-croppedData->at(li-1).y() != 0) // avoid division by zero in step plots + slope = (croppedData->at(li).x()-croppedData->at(li-1).x())/(croppedData->at(li).y()-croppedData->at(li-1).y()); + else + slope = 0; + (*croppedData)[li].setX(croppedData->at(li-1).x()+slope*(staticData->last().y()-croppedData->at(li-1).y())); + (*croppedData)[li].setY(staticData->last().y()); + } + + // return joined: + for (int i=otherData.size()-1; i>=0; --i) // insert reversed, otherwise the polygon will be twisted + thisData << otherData.at(i); + return QPolygonF(thisData); +} + +/*! \internal + + Finds the smallest index of \a data, whose points x value is just above \a x. Assumes x values in + \a data points are ordered ascending, as is the case when plotting with horizontal key axis. + + Used to calculate the channel fill polygon, see \ref getChannelFillPolygon. +*/ +int QCPGraph::findIndexAboveX(const QVector *data, double x) const +{ + for (int i=data->size()-1; i>=0; --i) + { + if (data->at(i).x() < x) + { + if (isize()-1) + return i+1; + else + return data->size()-1; + } + } + return -1; +} + +/*! \internal + + Finds the highest index of \a data, whose points x value is just below \a x. Assumes x values in + \a data points are ordered ascending, as is the case when plotting with horizontal key axis. + + Used to calculate the channel fill polygon, see \ref getChannelFillPolygon. +*/ +int QCPGraph::findIndexBelowX(const QVector *data, double x) const +{ + for (int i=0; isize(); ++i) + { + if (data->at(i).x() > x) + { + if (i>0) + return i-1; + else + return 0; + } + } + return -1; +} + +/*! \internal + + Finds the smallest index of \a data, whose points y value is just above \a y. Assumes y values in + \a data points are ordered descending, as is the case when plotting with vertical key axis. + + Used to calculate the channel fill polygon, see \ref getChannelFillPolygon. +*/ +int QCPGraph::findIndexAboveY(const QVector *data, double y) const +{ + for (int i=0; isize(); ++i) + { + if (data->at(i).y() < y) + { + if (i>0) + return i-1; + else + return 0; + } + } + return -1; +} + +/*! \internal + + Calculates the (minimum) distance (in pixels) the graph's representation has from the given \a + pixelPoint in pixels. This is used to determine whether the graph was clicked or not, e.g. in + \ref selectTest. + + If either the graph has no data or if the line style is \ref lsNone and the scatter style's shape + is \ref QCPScatterStyle::ssNone (i.e. there is no visual representation of the graph), returns -1.0. +*/ +double QCPGraph::pointDistance(const QPointF &pixelPoint) const +{ + if (mData->isEmpty()) + return -1.0; + if (mLineStyle == lsNone && mScatterStyle.isNone()) + return -1.0; + + // calculate minimum distances to graph representation: + if (mLineStyle == lsNone) + { + // no line displayed, only calculate distance to scatter points: + QVector scatterData; + getScatterPlotData(&scatterData); + if (scatterData.size() > 0) + { + double minDistSqr = std::numeric_limits::max(); + for (int i=0; i lineData; + getPlotData(&lineData, 0); // unlike with getScatterPlotData we get pixel coordinates here + if (lineData.size() > 1) // at least one line segment, compare distance to line segments + { + double minDistSqr = std::numeric_limits::max(); + if (mLineStyle == lsImpulse) + { + // impulse plot differs from other line styles in that the lineData points are only pairwise connected: + for (int i=0; i 0) // only single data point, calculate distance to that point + { + return QVector2D(lineData.at(0)-pixelPoint).length(); + } else // no data available in view to calculate distance to + return -1.0; + } +} + +/*! \internal + + Finds the highest index of \a data, whose points y value is just below \a y. Assumes y values in + \a data points are ordered descending, as is the case when plotting with vertical key axis (since + keys are ordered ascending). + + Used to calculate the channel fill polygon, see \ref getChannelFillPolygon. +*/ +int QCPGraph::findIndexBelowY(const QVector *data, double y) const +{ + for (int i=data->size()-1; i>=0; --i) + { + if (data->at(i).y() > y) + { + if (isize()-1) + return i+1; + else + return data->size()-1; + } + } + return -1; +} + +/* inherits documentation from base class */ +QCPRange QCPGraph::getKeyRange(bool &foundRange, SignDomain inSignDomain) const +{ + // just call the specialized version which takes an additional argument whether error bars + // should also be taken into consideration for range calculation. We set this to true here. + return getKeyRange(foundRange, inSignDomain, true); +} + +/* inherits documentation from base class */ +QCPRange QCPGraph::getValueRange(bool &foundRange, SignDomain inSignDomain) const +{ + // just call the specialized version which takes an additional argument whether error bars + // should also be taken into consideration for range calculation. We set this to true here. + return getValueRange(foundRange, inSignDomain, true); +} + +/*! \overload + + Allows to specify whether the error bars should be included in the range calculation. + + \see getKeyRange(bool &foundRange, SignDomain inSignDomain) +*/ +QCPRange QCPGraph::getKeyRange(bool &foundRange, SignDomain inSignDomain, bool includeErrors) const +{ + QCPRange range; + bool haveLower = false; + bool haveUpper = false; + + double current, currentErrorMinus, currentErrorPlus; + + if (inSignDomain == sdBoth) // range may be anywhere + { + QCPDataMap::const_iterator it = mData->constBegin(); + while (it != mData->constEnd()) + { + if (!qIsNaN(it.value().value)) + { + current = it.value().key; + currentErrorMinus = (includeErrors ? it.value().keyErrorMinus : 0); + currentErrorPlus = (includeErrors ? it.value().keyErrorPlus : 0); + if (current-currentErrorMinus < range.lower || !haveLower) + { + range.lower = current-currentErrorMinus; + haveLower = true; + } + if (current+currentErrorPlus > range.upper || !haveUpper) + { + range.upper = current+currentErrorPlus; + haveUpper = true; + } + } + ++it; + } + } else if (inSignDomain == sdNegative) // range may only be in the negative sign domain + { + QCPDataMap::const_iterator it = mData->constBegin(); + while (it != mData->constEnd()) + { + if (!qIsNaN(it.value().value)) + { + current = it.value().key; + currentErrorMinus = (includeErrors ? it.value().keyErrorMinus : 0); + currentErrorPlus = (includeErrors ? it.value().keyErrorPlus : 0); + if ((current-currentErrorMinus < range.lower || !haveLower) && current-currentErrorMinus < 0) + { + range.lower = current-currentErrorMinus; + haveLower = true; + } + if ((current+currentErrorPlus > range.upper || !haveUpper) && current+currentErrorPlus < 0) + { + range.upper = current+currentErrorPlus; + haveUpper = true; + } + if (includeErrors) // in case point is in valid sign domain but errobars stretch beyond it, we still want to geht that point. + { + if ((current < range.lower || !haveLower) && current < 0) + { + range.lower = current; + haveLower = true; + } + if ((current > range.upper || !haveUpper) && current < 0) + { + range.upper = current; + haveUpper = true; + } + } + } + ++it; + } + } else if (inSignDomain == sdPositive) // range may only be in the positive sign domain + { + QCPDataMap::const_iterator it = mData->constBegin(); + while (it != mData->constEnd()) + { + if (!qIsNaN(it.value().value)) + { + current = it.value().key; + currentErrorMinus = (includeErrors ? it.value().keyErrorMinus : 0); + currentErrorPlus = (includeErrors ? it.value().keyErrorPlus : 0); + if ((current-currentErrorMinus < range.lower || !haveLower) && current-currentErrorMinus > 0) + { + range.lower = current-currentErrorMinus; + haveLower = true; + } + if ((current+currentErrorPlus > range.upper || !haveUpper) && current+currentErrorPlus > 0) + { + range.upper = current+currentErrorPlus; + haveUpper = true; + } + if (includeErrors) // in case point is in valid sign domain but errobars stretch beyond it, we still want to get that point. + { + if ((current < range.lower || !haveLower) && current > 0) + { + range.lower = current; + haveLower = true; + } + if ((current > range.upper || !haveUpper) && current > 0) + { + range.upper = current; + haveUpper = true; + } + } + } + ++it; + } + } + + foundRange = haveLower && haveUpper; + return range; +} + +/*! \overload + + Allows to specify whether the error bars should be included in the range calculation. + + \see getValueRange(bool &foundRange, SignDomain inSignDomain) +*/ +QCPRange QCPGraph::getValueRange(bool &foundRange, SignDomain inSignDomain, bool includeErrors) const +{ + QCPRange range; + bool haveLower = false; + bool haveUpper = false; + + double current, currentErrorMinus, currentErrorPlus; + + if (inSignDomain == sdBoth) // range may be anywhere + { + QCPDataMap::const_iterator it = mData->constBegin(); + while (it != mData->constEnd()) + { + current = it.value().value; + if (!qIsNaN(current)) + { + currentErrorMinus = (includeErrors ? it.value().valueErrorMinus : 0); + currentErrorPlus = (includeErrors ? it.value().valueErrorPlus : 0); + if (current-currentErrorMinus < range.lower || !haveLower) + { + range.lower = current-currentErrorMinus; + haveLower = true; + } + if (current+currentErrorPlus > range.upper || !haveUpper) + { + range.upper = current+currentErrorPlus; + haveUpper = true; + } + } + ++it; + } + } else if (inSignDomain == sdNegative) // range may only be in the negative sign domain + { + QCPDataMap::const_iterator it = mData->constBegin(); + while (it != mData->constEnd()) + { + current = it.value().value; + if (!qIsNaN(current)) + { + currentErrorMinus = (includeErrors ? it.value().valueErrorMinus : 0); + currentErrorPlus = (includeErrors ? it.value().valueErrorPlus : 0); + if ((current-currentErrorMinus < range.lower || !haveLower) && current-currentErrorMinus < 0) + { + range.lower = current-currentErrorMinus; + haveLower = true; + } + if ((current+currentErrorPlus > range.upper || !haveUpper) && current+currentErrorPlus < 0) + { + range.upper = current+currentErrorPlus; + haveUpper = true; + } + if (includeErrors) // in case point is in valid sign domain but errobars stretch beyond it, we still want to get that point. + { + if ((current < range.lower || !haveLower) && current < 0) + { + range.lower = current; + haveLower = true; + } + if ((current > range.upper || !haveUpper) && current < 0) + { + range.upper = current; + haveUpper = true; + } + } + } + ++it; + } + } else if (inSignDomain == sdPositive) // range may only be in the positive sign domain + { + QCPDataMap::const_iterator it = mData->constBegin(); + while (it != mData->constEnd()) + { + current = it.value().value; + if (!qIsNaN(current)) + { + currentErrorMinus = (includeErrors ? it.value().valueErrorMinus : 0); + currentErrorPlus = (includeErrors ? it.value().valueErrorPlus : 0); + if ((current-currentErrorMinus < range.lower || !haveLower) && current-currentErrorMinus > 0) + { + range.lower = current-currentErrorMinus; + haveLower = true; + } + if ((current+currentErrorPlus > range.upper || !haveUpper) && current+currentErrorPlus > 0) + { + range.upper = current+currentErrorPlus; + haveUpper = true; + } + if (includeErrors) // in case point is in valid sign domain but errobars stretch beyond it, we still want to geht that point. + { + if ((current < range.lower || !haveLower) && current > 0) + { + range.lower = current; + haveLower = true; + } + if ((current > range.upper || !haveUpper) && current > 0) + { + range.upper = current; + haveUpper = true; + } + } + } + ++it; + } + } + + foundRange = haveLower && haveUpper; + return range; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPCurveData +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPCurveData + \brief Holds the data of one single data point for QCPCurve. + + The container for storing multiple data points is \ref QCPCurveDataMap. + + The stored data is: + \li \a t: the free parameter of the curve at this curve point (cp. the mathematical vector (x(t), y(t))) + \li \a key: coordinate on the key axis of this curve point + \li \a value: coordinate on the value axis of this curve point + + \see QCPCurveDataMap +*/ + +/*! + Constructs a curve data point with t, key and value set to zero. +*/ +QCPCurveData::QCPCurveData() : + t(0), + key(0), + value(0) +{ +} + +/*! + Constructs a curve data point with the specified \a t, \a key and \a value. +*/ +QCPCurveData::QCPCurveData(double t, double key, double value) : + t(t), + key(key), + value(value) +{ +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPCurve +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPCurve + \brief A plottable representing a parametric curve in a plot. + + \image html QCPCurve.png + + Unlike QCPGraph, plottables of this type may have multiple points with the same key coordinate, + so their visual representation can have \a loops. This is realized by introducing a third + coordinate \a t, which defines the order of the points described by the other two coordinates \a + x and \a y. + + To plot data, assign it with the \ref setData or \ref addData functions. + + Gaps in the curve can be created by adding data points with NaN as key and value + (qQNaN() or std::numeric_limits::quiet_NaN()) in between the two data points that shall be + separated. + + \section appearance Changing the appearance + + The appearance of the curve is determined by the pen and the brush (\ref setPen, \ref setBrush). + \section usage Usage + + Like all data representing objects in QCustomPlot, the QCPCurve is a plottable (QCPAbstractPlottable). So + the plottable-interface of QCustomPlot applies (QCustomPlot::plottable, QCustomPlot::addPlottable, QCustomPlot::removePlottable, etc.) + + Usually, you first create an instance and add it to the customPlot: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcurve-creation-1 + and then modify the properties of the newly created plottable, e.g.: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcurve-creation-2 +*/ + +/*! + Constructs a curve which uses \a keyAxis as its key axis ("x") and \a valueAxis as its value + axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance and not have + the same orientation. If either of these restrictions is violated, a corresponding message is + printed to the debug output (qDebug), the construction is not aborted, though. + + The constructed QCPCurve can be added to the plot with QCustomPlot::addPlottable, QCustomPlot + then takes ownership of the graph. +*/ +QCPCurve::QCPCurve(QCPAxis *keyAxis, QCPAxis *valueAxis) : + QCPAbstractPlottable(keyAxis, valueAxis) +{ + mData = new QCPCurveDataMap; + mPen.setColor(Qt::blue); + mPen.setStyle(Qt::SolidLine); + mBrush.setColor(Qt::blue); + mBrush.setStyle(Qt::NoBrush); + mSelectedPen = mPen; + mSelectedPen.setWidthF(2.5); + mSelectedPen.setColor(QColor(80, 80, 255)); // lighter than Qt::blue of mPen + mSelectedBrush = mBrush; + + setScatterStyle(QCPScatterStyle()); + setLineStyle(lsLine); +} + +QCPCurve::~QCPCurve() +{ + delete mData; +} + +/*! + Replaces the current data with the provided \a data. + + If \a copy is set to true, data points in \a data will only be copied. if false, the plottable + takes ownership of the passed data and replaces the internal data pointer with it. This is + significantly faster than copying for large datasets. +*/ +void QCPCurve::setData(QCPCurveDataMap *data, bool copy) +{ + if (mData == data) + { + qDebug() << Q_FUNC_INFO << "The data pointer is already in (and owned by) this plottable" << reinterpret_cast(data); + return; + } + if (copy) + { + *mData = *data; + } else + { + delete mData; + mData = data; + } +} + +/*! \overload + + Replaces the current data with the provided points in \a t, \a key and \a value tuples. The + provided vectors should have equal length. Else, the number of added points will be the size of + the smallest vector. +*/ +void QCPCurve::setData(const QVector &t, const QVector &key, const QVector &value) +{ + mData->clear(); + int n = t.size(); + n = qMin(n, key.size()); + n = qMin(n, value.size()); + QCPCurveData newData; + for (int i=0; iinsertMulti(newData.t, newData); + } +} + +/*! \overload + + Replaces the current data with the provided \a key and \a value pairs. The t parameter + of each data point will be set to the integer index of the respective key/value pair. +*/ +void QCPCurve::setData(const QVector &key, const QVector &value) +{ + mData->clear(); + int n = key.size(); + n = qMin(n, value.size()); + QCPCurveData newData; + for (int i=0; iinsertMulti(newData.t, newData); + } +} + +/*! + Sets the visual appearance of single data points in the plot. If set to \ref + QCPScatterStyle::ssNone, no scatter points are drawn (e.g. for line-only plots with appropriate + line style). + + \see QCPScatterStyle, setLineStyle +*/ +void QCPCurve::setScatterStyle(const QCPScatterStyle &style) +{ + mScatterStyle = style; +} + +/*! + Sets how the single data points are connected in the plot or how they are represented visually + apart from the scatter symbol. For scatter-only plots, set \a style to \ref lsNone and \ref + setScatterStyle to the desired scatter style. + + \see setScatterStyle +*/ +void QCPCurve::setLineStyle(QCPCurve::LineStyle style) +{ + mLineStyle = style; +} + +/*! + Adds the provided data points in \a dataMap to the current data. + \see removeData +*/ +void QCPCurve::addData(const QCPCurveDataMap &dataMap) +{ + mData->unite(dataMap); +} + +/*! \overload + Adds the provided single data point in \a data to the current data. + \see removeData +*/ +void QCPCurve::addData(const QCPCurveData &data) +{ + mData->insertMulti(data.t, data); +} + +/*! \overload + Adds the provided single data point as \a t, \a key and \a value tuple to the current data + \see removeData +*/ +void QCPCurve::addData(double t, double key, double value) +{ + QCPCurveData newData; + newData.t = t; + newData.key = key; + newData.value = value; + mData->insertMulti(newData.t, newData); +} + +/*! \overload + + Adds the provided single data point as \a key and \a value pair to the current data The t + parameter of the data point is set to the t of the last data point plus 1. If there is no last + data point, t will be set to 0. + + \see removeData +*/ +void QCPCurve::addData(double key, double value) +{ + QCPCurveData newData; + if (!mData->isEmpty()) + newData.t = (mData->constEnd()-1).key()+1; + else + newData.t = 0; + newData.key = key; + newData.value = value; + mData->insertMulti(newData.t, newData); +} + +/*! \overload + Adds the provided data points as \a t, \a key and \a value tuples to the current data. + \see removeData +*/ +void QCPCurve::addData(const QVector &ts, const QVector &keys, const QVector &values) +{ + int n = ts.size(); + n = qMin(n, keys.size()); + n = qMin(n, values.size()); + QCPCurveData newData; + for (int i=0; iinsertMulti(newData.t, newData); + } +} + +/*! + Removes all data points with curve parameter t smaller than \a t. + \see addData, clearData +*/ +void QCPCurve::removeDataBefore(double t) +{ + QCPCurveDataMap::iterator it = mData->begin(); + while (it != mData->end() && it.key() < t) + it = mData->erase(it); +} + +/*! + Removes all data points with curve parameter t greater than \a t. + \see addData, clearData +*/ +void QCPCurve::removeDataAfter(double t) +{ + if (mData->isEmpty()) return; + QCPCurveDataMap::iterator it = mData->upperBound(t); + while (it != mData->end()) + it = mData->erase(it); +} + +/*! + Removes all data points with curve parameter t between \a fromt and \a tot. if \a fromt is + greater or equal to \a tot, the function does nothing. To remove a single data point with known + t, use \ref removeData(double t). + + \see addData, clearData +*/ +void QCPCurve::removeData(double fromt, double tot) +{ + if (fromt >= tot || mData->isEmpty()) return; + QCPCurveDataMap::iterator it = mData->upperBound(fromt); + QCPCurveDataMap::iterator itEnd = mData->upperBound(tot); + while (it != itEnd) + it = mData->erase(it); +} + +/*! \overload + + Removes a single data point at curve parameter \a t. If the position is not known with absolute + precision, consider using \ref removeData(double fromt, double tot) with a small fuzziness + interval around the suspected position, depeding on the precision with which the curve parameter + is known. + + \see addData, clearData +*/ +void QCPCurve::removeData(double t) +{ + mData->remove(t); +} + +/*! + Removes all data points. + \see removeData, removeDataAfter, removeDataBefore +*/ +void QCPCurve::clearData() +{ + mData->clear(); +} + +/* inherits documentation from base class */ +double QCPCurve::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if ((onlySelectable && !mSelectable) || mData->isEmpty()) + return -1; + if (!mKeyAxis || !mValueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return -1; } + + if (mKeyAxis.data()->axisRect()->rect().contains(pos.toPoint())) + return pointDistance(pos); + else + return -1; +} + +/* inherits documentation from base class */ +void QCPCurve::draw(QCPPainter *painter) +{ + if (mData->isEmpty()) return; + + // allocate line vector: + QVector *lineData = new QVector; + + // fill with curve data: + getCurveData(lineData); + + // check data validity if flag set: +#ifdef QCUSTOMPLOT_CHECK_DATA + QCPCurveDataMap::const_iterator it; + for (it = mData->constBegin(); it != mData->constEnd(); ++it) + { + if (QCP::isInvalidData(it.value().t) || + QCP::isInvalidData(it.value().key, it.value().value)) + qDebug() << Q_FUNC_INFO << "Data point at" << it.key() << "invalid." << "Plottable name:" << name(); + } +#endif + + // draw curve fill: + if (mainBrush().style() != Qt::NoBrush && mainBrush().color().alpha() != 0) + { + applyFillAntialiasingHint(painter); + painter->setPen(Qt::NoPen); + painter->setBrush(mainBrush()); + painter->drawPolygon(QPolygonF(*lineData)); + } + + // draw curve line: + if (mLineStyle != lsNone && mainPen().style() != Qt::NoPen && mainPen().color().alpha() != 0) + { + applyDefaultAntialiasingHint(painter); + painter->setPen(mainPen()); + painter->setBrush(Qt::NoBrush); + // if drawing solid line and not in PDF, use much faster line drawing instead of polyline: + if (mParentPlot->plottingHints().testFlag(QCP::phFastPolylines) && + painter->pen().style() == Qt::SolidLine && + !painter->modes().testFlag(QCPPainter::pmVectorized) && + !painter->modes().testFlag(QCPPainter::pmNoCaching)) + { + int i = 0; + bool lastIsNan = false; + const int lineDataSize = lineData->size(); + while (i < lineDataSize && (qIsNaN(lineData->at(i).y()) || qIsNaN(lineData->at(i).x()))) // make sure first point is not NaN + ++i; + ++i; // because drawing works in 1 point retrospect + while (i < lineDataSize) + { + if (!qIsNaN(lineData->at(i).y()) && !qIsNaN(lineData->at(i).x())) // NaNs create a gap in the line + { + if (!lastIsNan) + painter->drawLine(lineData->at(i-1), lineData->at(i)); + else + lastIsNan = false; + } else + lastIsNan = true; + ++i; + } + } else + { + int segmentStart = 0; + int i = 0; + const int lineDataSize = lineData->size(); + while (i < lineDataSize) + { + if (qIsNaN(lineData->at(i).y()) || qIsNaN(lineData->at(i).x())) // NaNs create a gap in the line + { + painter->drawPolyline(lineData->constData()+segmentStart, i-segmentStart); // i, because we don't want to include the current NaN point + segmentStart = i+1; + } + ++i; + } + // draw last segment: + painter->drawPolyline(lineData->constData()+segmentStart, lineDataSize-segmentStart); + } + } + + // draw scatters: + if (!mScatterStyle.isNone()) + drawScatterPlot(painter, lineData); + + // free allocated line data: + delete lineData; +} + +/* inherits documentation from base class */ +void QCPCurve::drawLegendIcon(QCPPainter *painter, const QRectF &rect) const +{ + // draw fill: + if (mBrush.style() != Qt::NoBrush) + { + applyFillAntialiasingHint(painter); + painter->fillRect(QRectF(rect.left(), rect.top()+rect.height()/2.0, rect.width(), rect.height()/3.0), mBrush); + } + // draw line vertically centered: + if (mLineStyle != lsNone) + { + applyDefaultAntialiasingHint(painter); + painter->setPen(mPen); + painter->drawLine(QLineF(rect.left(), rect.top()+rect.height()/2.0, rect.right()+5, rect.top()+rect.height()/2.0)); // +5 on x2 else last segment is missing from dashed/dotted pens + } + // draw scatter symbol: + if (!mScatterStyle.isNone()) + { + applyScattersAntialiasingHint(painter); + // scale scatter pixmap if it's too large to fit in legend icon rect: + if (mScatterStyle.shape() == QCPScatterStyle::ssPixmap && (mScatterStyle.pixmap().size().width() > rect.width() || mScatterStyle.pixmap().size().height() > rect.height())) + { + QCPScatterStyle scaledStyle(mScatterStyle); + scaledStyle.setPixmap(scaledStyle.pixmap().scaled(rect.size().toSize(), Qt::KeepAspectRatio, Qt::SmoothTransformation)); + scaledStyle.applyTo(painter, mPen); + scaledStyle.drawShape(painter, QRectF(rect).center()); + } else + { + mScatterStyle.applyTo(painter, mPen); + mScatterStyle.drawShape(painter, QRectF(rect).center()); + } + } +} + +/*! \internal + + Draws scatter symbols at every data point passed in \a pointData. scatter symbols are independent of + the line style and are always drawn if scatter shape is not \ref QCPScatterStyle::ssNone. +*/ +void QCPCurve::drawScatterPlot(QCPPainter *painter, const QVector *pointData) const +{ + // draw scatter point symbols: + applyScattersAntialiasingHint(painter); + mScatterStyle.applyTo(painter, mPen); + for (int i=0; isize(); ++i) + if (!qIsNaN(pointData->at(i).x()) && !qIsNaN(pointData->at(i).y())) + mScatterStyle.drawShape(painter, pointData->at(i)); +} + +/*! \internal + + called by QCPCurve::draw to generate a point vector (in pixel coordinates) which represents the + line of the curve. + + Line segments that aren't visible in the current axis rect are handled in an optimized way. They + are projected onto a rectangle slightly larger than the visible axis rect and simplified + regarding point count. The algorithm makes sure to preserve appearance of lines and fills inside + the visible axis rect by generating new temporary points on the outer rect if necessary. + + Methods that are also involved in the algorithm are: \ref getRegion, \ref getOptimizedPoint, \ref + getOptimizedCornerPoints \ref mayTraverse, \ref getTraverse, \ref getTraverseCornerPoints. +*/ +void QCPCurve::getCurveData(QVector *lineData) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + + // add margins to rect to compensate for stroke width + double strokeMargin = qMax(qreal(1.0), qreal(mainPen().widthF()*0.75)); // stroke radius + 50% safety + if (!mScatterStyle.isNone()) + strokeMargin = qMax(strokeMargin, mScatterStyle.size()); + double rectLeft = keyAxis->pixelToCoord(keyAxis->coordToPixel(keyAxis->range().lower)-strokeMargin*((keyAxis->orientation()==Qt::Vertical)!=keyAxis->rangeReversed()?-1:1)); + double rectRight = keyAxis->pixelToCoord(keyAxis->coordToPixel(keyAxis->range().upper)+strokeMargin*((keyAxis->orientation()==Qt::Vertical)!=keyAxis->rangeReversed()?-1:1)); + double rectBottom = valueAxis->pixelToCoord(valueAxis->coordToPixel(valueAxis->range().lower)+strokeMargin*((valueAxis->orientation()==Qt::Horizontal)!=valueAxis->rangeReversed()?-1:1)); + double rectTop = valueAxis->pixelToCoord(valueAxis->coordToPixel(valueAxis->range().upper)-strokeMargin*((valueAxis->orientation()==Qt::Horizontal)!=valueAxis->rangeReversed()?-1:1)); + int currentRegion; + QCPCurveDataMap::const_iterator it = mData->constBegin(); + QCPCurveDataMap::const_iterator prevIt = mData->constEnd()-1; + int prevRegion = getRegion(prevIt.value().key, prevIt.value().value, rectLeft, rectTop, rectRight, rectBottom); + QVector trailingPoints; // points that must be applied after all other points (are generated only when handling first point to get virtual segment between last and first point right) + while (it != mData->constEnd()) + { + currentRegion = getRegion(it.value().key, it.value().value, rectLeft, rectTop, rectRight, rectBottom); + if (currentRegion != prevRegion) // changed region, possibly need to add some optimized edge points or original points if entering R + { + if (currentRegion != 5) // segment doesn't end in R, so it's a candidate for removal + { + QPointF crossA, crossB; + if (prevRegion == 5) // we're coming from R, so add this point optimized + { + lineData->append(getOptimizedPoint(currentRegion, it.value().key, it.value().value, prevIt.value().key, prevIt.value().value, rectLeft, rectTop, rectRight, rectBottom)); + // in the situations 5->1/7/9/3 the segment may leave R and directly cross through two outer regions. In these cases we need to add an additional corner point + *lineData << getOptimizedCornerPoints(prevRegion, currentRegion, prevIt.value().key, prevIt.value().value, it.value().key, it.value().value, rectLeft, rectTop, rectRight, rectBottom); + } else if (mayTraverse(prevRegion, currentRegion) && + getTraverse(prevIt.value().key, prevIt.value().value, it.value().key, it.value().value, rectLeft, rectTop, rectRight, rectBottom, crossA, crossB)) + { + // add the two cross points optimized if segment crosses R and if segment isn't virtual zeroth segment between last and first curve point: + QVector beforeTraverseCornerPoints, afterTraverseCornerPoints; + getTraverseCornerPoints(prevRegion, currentRegion, rectLeft, rectTop, rectRight, rectBottom, beforeTraverseCornerPoints, afterTraverseCornerPoints); + if (it != mData->constBegin()) + { + *lineData << beforeTraverseCornerPoints; + lineData->append(crossA); + lineData->append(crossB); + *lineData << afterTraverseCornerPoints; + } else + { + lineData->append(crossB); + *lineData << afterTraverseCornerPoints; + trailingPoints << beforeTraverseCornerPoints << crossA ; + } + } else // doesn't cross R, line is just moving around in outside regions, so only need to add optimized point(s) at the boundary corner(s) + { + *lineData << getOptimizedCornerPoints(prevRegion, currentRegion, prevIt.value().key, prevIt.value().value, it.value().key, it.value().value, rectLeft, rectTop, rectRight, rectBottom); + } + } else // segment does end in R, so we add previous point optimized and this point at original position + { + if (it == mData->constBegin()) // it is first point in curve and prevIt is last one. So save optimized point for adding it to the lineData in the end + trailingPoints << getOptimizedPoint(prevRegion, prevIt.value().key, prevIt.value().value, it.value().key, it.value().value, rectLeft, rectTop, rectRight, rectBottom); + else + lineData->append(getOptimizedPoint(prevRegion, prevIt.value().key, prevIt.value().value, it.value().key, it.value().value, rectLeft, rectTop, rectRight, rectBottom)); + lineData->append(coordsToPixels(it.value().key, it.value().value)); + } + } else // region didn't change + { + if (currentRegion == 5) // still in R, keep adding original points + { + lineData->append(coordsToPixels(it.value().key, it.value().value)); + } else // still outside R, no need to add anything + { + // see how this is not doing anything? That's the main optimization... + } + } + prevIt = it; + prevRegion = currentRegion; + ++it; + } + *lineData << trailingPoints; +} + +/*! \internal + + This function is part of the curve optimization algorithm of \ref getCurveData. + + It returns the region of the given point (\a x, \a y) with respect to a rectangle defined by \a + rectLeft, \a rectTop, \a rectRight, and \a rectBottom. + + The regions are enumerated from top to bottom and left to right: + + + + + +
147
258
369
+ + With the rectangle being region 5, and the outer regions extending infinitely outwards. In the + curve optimization algorithm, region 5 is considered to be the visible portion of the plot. +*/ +int QCPCurve::getRegion(double x, double y, double rectLeft, double rectTop, double rectRight, double rectBottom) const +{ + if (x < rectLeft) // region 123 + { + if (y > rectTop) + return 1; + else if (y < rectBottom) + return 3; + else + return 2; + } else if (x > rectRight) // region 789 + { + if (y > rectTop) + return 7; + else if (y < rectBottom) + return 9; + else + return 8; + } else // region 456 + { + if (y > rectTop) + return 4; + else if (y < rectBottom) + return 6; + else + return 5; + } +} + +/*! \internal + + This function is part of the curve optimization algorithm of \ref getCurveData. + + This method is used in case the current segment passes from inside the visible rect (region 5, + see \ref getRegion) to any of the outer regions (\a otherRegion). The current segment is given by + the line connecting (\a key, \a value) with (\a otherKey, \a otherValue). + + It returns the intersection point of the segment with the border of region 5. + + For this function it doesn't matter whether (\a key, \a value) is the point inside region 5 or + whether it's (\a otherKey, \a otherValue), i.e. whether the segment is coming from region 5 or + leaving it. It is important though that \a otherRegion correctly identifies the other region not + equal to 5. +*/ +QPointF QCPCurve::getOptimizedPoint(int otherRegion, double otherKey, double otherValue, double key, double value, double rectLeft, double rectTop, double rectRight, double rectBottom) const +{ + double intersectKey = rectLeft; // initial value is just fail-safe + double intersectValue = rectTop; // initial value is just fail-safe + switch (otherRegion) + { + case 1: // top and left edge + { + intersectValue = rectTop; + intersectKey = otherKey + (key-otherKey)/(value-otherValue)*(intersectValue-otherValue); + if (intersectKey < rectLeft || intersectKey > rectRight) // doesn't intersect, so must intersect other: + { + intersectKey = rectLeft; + intersectValue = otherValue + (value-otherValue)/(key-otherKey)*(intersectKey-otherKey); + } + break; + } + case 2: // left edge + { + intersectKey = rectLeft; + intersectValue = otherValue + (value-otherValue)/(key-otherKey)*(intersectKey-otherKey); + break; + } + case 3: // bottom and left edge + { + intersectValue = rectBottom; + intersectKey = otherKey + (key-otherKey)/(value-otherValue)*(intersectValue-otherValue); + if (intersectKey < rectLeft || intersectKey > rectRight) // doesn't intersect, so must intersect other: + { + intersectKey = rectLeft; + intersectValue = otherValue + (value-otherValue)/(key-otherKey)*(intersectKey-otherKey); + } + break; + } + case 4: // top edge + { + intersectValue = rectTop; + intersectKey = otherKey + (key-otherKey)/(value-otherValue)*(intersectValue-otherValue); + break; + } + case 5: + { + break; // case 5 shouldn't happen for this function but we add it anyway to prevent potential discontinuity in branch table + } + case 6: // bottom edge + { + intersectValue = rectBottom; + intersectKey = otherKey + (key-otherKey)/(value-otherValue)*(intersectValue-otherValue); + break; + } + case 7: // top and right edge + { + intersectValue = rectTop; + intersectKey = otherKey + (key-otherKey)/(value-otherValue)*(intersectValue-otherValue); + if (intersectKey < rectLeft || intersectKey > rectRight) // doesn't intersect, so must intersect other: + { + intersectKey = rectRight; + intersectValue = otherValue + (value-otherValue)/(key-otherKey)*(intersectKey-otherKey); + } + break; + } + case 8: // right edge + { + intersectKey = rectRight; + intersectValue = otherValue + (value-otherValue)/(key-otherKey)*(intersectKey-otherKey); + break; + } + case 9: // bottom and right edge + { + intersectValue = rectBottom; + intersectKey = otherKey + (key-otherKey)/(value-otherValue)*(intersectValue-otherValue); + if (intersectKey < rectLeft || intersectKey > rectRight) // doesn't intersect, so must intersect other: + { + intersectKey = rectRight; + intersectValue = otherValue + (value-otherValue)/(key-otherKey)*(intersectKey-otherKey); + } + break; + } + } + return coordsToPixels(intersectKey, intersectValue); +} + +/*! \internal + + This function is part of the curve optimization algorithm of \ref getCurveData. + + In situations where a single segment skips over multiple regions it might become necessary to add + extra points at the corners of region 5 (see \ref getRegion) such that the optimized segment + doesn't unintentionally cut through the visible area of the axis rect and create plot artifacts. + This method provides these points that must be added, assuming the original segment doesn't + start, end, or traverse region 5. (Corner points where region 5 is traversed are calculated by + \ref getTraverseCornerPoints.) + + For example, consider a segment which directly goes from region 4 to 2 but originally is far out + to the top left such that it doesn't cross region 5. Naively optimizing these points by + projecting them on the top and left borders of region 5 will create a segment that surely crosses + 5, creating a visual artifact in the plot. This method prevents this by providing extra points at + the top left corner, making the optimized curve correctly pass from region 4 to 1 to 2 without + traversing 5. +*/ +QVector QCPCurve::getOptimizedCornerPoints(int prevRegion, int currentRegion, double prevKey, double prevValue, double key, double value, double rectLeft, double rectTop, double rectRight, double rectBottom) const +{ + QVector result; + switch (prevRegion) + { + case 1: + { + switch (currentRegion) + { + case 2: { result << coordsToPixels(rectLeft, rectTop); break; } + case 4: { result << coordsToPixels(rectLeft, rectTop); break; } + case 3: { result << coordsToPixels(rectLeft, rectTop) << coordsToPixels(rectLeft, rectBottom); break; } + case 7: { result << coordsToPixels(rectLeft, rectTop) << coordsToPixels(rectRight, rectTop); break; } + case 6: { result << coordsToPixels(rectLeft, rectTop) << coordsToPixels(rectLeft, rectBottom); result.append(result.last()); break; } + case 8: { result << coordsToPixels(rectLeft, rectTop) << coordsToPixels(rectRight, rectTop); result.append(result.last()); break; } + case 9: { // in this case we need another distinction of cases: segment may pass below or above rect, requiring either bottom right or top left corner points + if ((value-prevValue)/(key-prevKey)*(rectLeft-key)+value < rectBottom) // segment passes below R + { result << coordsToPixels(rectLeft, rectTop) << coordsToPixels(rectLeft, rectBottom); result.append(result.last()); result << coordsToPixels(rectRight, rectBottom); } + else + { result << coordsToPixels(rectLeft, rectTop) << coordsToPixels(rectRight, rectTop); result.append(result.last()); result << coordsToPixels(rectRight, rectBottom); } + break; + } + } + break; + } + case 2: + { + switch (currentRegion) + { + case 1: { result << coordsToPixels(rectLeft, rectTop); break; } + case 3: { result << coordsToPixels(rectLeft, rectBottom); break; } + case 4: { result << coordsToPixels(rectLeft, rectTop); result.append(result.last()); break; } + case 6: { result << coordsToPixels(rectLeft, rectBottom); result.append(result.last()); break; } + case 7: { result << coordsToPixels(rectLeft, rectTop); result.append(result.last()); result << coordsToPixels(rectRight, rectTop); break; } + case 9: { result << coordsToPixels(rectLeft, rectBottom); result.append(result.last()); result << coordsToPixels(rectRight, rectBottom); break; } + } + break; + } + case 3: + { + switch (currentRegion) + { + case 2: { result << coordsToPixels(rectLeft, rectBottom); break; } + case 6: { result << coordsToPixels(rectLeft, rectBottom); break; } + case 1: { result << coordsToPixels(rectLeft, rectBottom) << coordsToPixels(rectLeft, rectTop); break; } + case 9: { result << coordsToPixels(rectLeft, rectBottom) << coordsToPixels(rectRight, rectBottom); break; } + case 4: { result << coordsToPixels(rectLeft, rectBottom) << coordsToPixels(rectLeft, rectTop); result.append(result.last()); break; } + case 8: { result << coordsToPixels(rectLeft, rectBottom) << coordsToPixels(rectRight, rectBottom); result.append(result.last()); break; } + case 7: { // in this case we need another distinction of cases: segment may pass below or above rect, requiring either bottom right or top left corner points + if ((value-prevValue)/(key-prevKey)*(rectRight-key)+value < rectBottom) // segment passes below R + { result << coordsToPixels(rectLeft, rectBottom) << coordsToPixels(rectRight, rectBottom); result.append(result.last()); result << coordsToPixels(rectRight, rectTop); } + else + { result << coordsToPixels(rectLeft, rectBottom) << coordsToPixels(rectLeft, rectTop); result.append(result.last()); result << coordsToPixels(rectRight, rectTop); } + break; + } + } + break; + } + case 4: + { + switch (currentRegion) + { + case 1: { result << coordsToPixels(rectLeft, rectTop); break; } + case 7: { result << coordsToPixels(rectRight, rectTop); break; } + case 2: { result << coordsToPixels(rectLeft, rectTop); result.append(result.last()); break; } + case 8: { result << coordsToPixels(rectRight, rectTop); result.append(result.last()); break; } + case 3: { result << coordsToPixels(rectLeft, rectTop); result.append(result.last()); result << coordsToPixels(rectLeft, rectBottom); break; } + case 9: { result << coordsToPixels(rectRight, rectTop); result.append(result.last()); result << coordsToPixels(rectRight, rectBottom); break; } + } + break; + } + case 5: + { + switch (currentRegion) + { + case 1: { result << coordsToPixels(rectLeft, rectTop); break; } + case 7: { result << coordsToPixels(rectRight, rectTop); break; } + case 9: { result << coordsToPixels(rectRight, rectBottom); break; } + case 3: { result << coordsToPixels(rectLeft, rectBottom); break; } + } + break; + } + case 6: + { + switch (currentRegion) + { + case 3: { result << coordsToPixels(rectLeft, rectBottom); break; } + case 9: { result << coordsToPixels(rectRight, rectBottom); break; } + case 2: { result << coordsToPixels(rectLeft, rectBottom); result.append(result.last()); break; } + case 8: { result << coordsToPixels(rectRight, rectBottom); result.append(result.last()); break; } + case 1: { result << coordsToPixels(rectLeft, rectBottom); result.append(result.last()); result << coordsToPixels(rectLeft, rectTop); break; } + case 7: { result << coordsToPixels(rectRight, rectBottom); result.append(result.last()); result << coordsToPixels(rectRight, rectTop); break; } + } + break; + } + case 7: + { + switch (currentRegion) + { + case 4: { result << coordsToPixels(rectRight, rectTop); break; } + case 8: { result << coordsToPixels(rectRight, rectTop); break; } + case 1: { result << coordsToPixels(rectRight, rectTop) << coordsToPixels(rectLeft, rectTop); break; } + case 9: { result << coordsToPixels(rectRight, rectTop) << coordsToPixels(rectRight, rectBottom); break; } + case 2: { result << coordsToPixels(rectRight, rectTop) << coordsToPixels(rectLeft, rectTop); result.append(result.last()); break; } + case 6: { result << coordsToPixels(rectRight, rectTop) << coordsToPixels(rectRight, rectBottom); result.append(result.last()); break; } + case 3: { // in this case we need another distinction of cases: segment may pass below or above rect, requiring either bottom right or top left corner points + if ((value-prevValue)/(key-prevKey)*(rectRight-key)+value < rectBottom) // segment passes below R + { result << coordsToPixels(rectRight, rectTop) << coordsToPixels(rectRight, rectBottom); result.append(result.last()); result << coordsToPixels(rectLeft, rectBottom); } + else + { result << coordsToPixels(rectRight, rectTop) << coordsToPixels(rectLeft, rectTop); result.append(result.last()); result << coordsToPixels(rectLeft, rectBottom); } + break; + } + } + break; + } + case 8: + { + switch (currentRegion) + { + case 7: { result << coordsToPixels(rectRight, rectTop); break; } + case 9: { result << coordsToPixels(rectRight, rectBottom); break; } + case 4: { result << coordsToPixels(rectRight, rectTop); result.append(result.last()); break; } + case 6: { result << coordsToPixels(rectRight, rectBottom); result.append(result.last()); break; } + case 1: { result << coordsToPixels(rectRight, rectTop); result.append(result.last()); result << coordsToPixels(rectLeft, rectTop); break; } + case 3: { result << coordsToPixels(rectRight, rectBottom); result.append(result.last()); result << coordsToPixels(rectLeft, rectBottom); break; } + } + break; + } + case 9: + { + switch (currentRegion) + { + case 6: { result << coordsToPixels(rectRight, rectBottom); break; } + case 8: { result << coordsToPixels(rectRight, rectBottom); break; } + case 3: { result << coordsToPixels(rectRight, rectBottom) << coordsToPixels(rectLeft, rectBottom); break; } + case 7: { result << coordsToPixels(rectRight, rectBottom) << coordsToPixels(rectRight, rectTop); break; } + case 2: { result << coordsToPixels(rectRight, rectBottom) << coordsToPixels(rectLeft, rectBottom); result.append(result.last()); break; } + case 4: { result << coordsToPixels(rectRight, rectBottom) << coordsToPixels(rectRight, rectTop); result.append(result.last()); break; } + case 1: { // in this case we need another distinction of cases: segment may pass below or above rect, requiring either bottom right or top left corner points + if ((value-prevValue)/(key-prevKey)*(rectLeft-key)+value < rectBottom) // segment passes below R + { result << coordsToPixels(rectRight, rectBottom) << coordsToPixels(rectLeft, rectBottom); result.append(result.last()); result << coordsToPixels(rectLeft, rectTop); } + else + { result << coordsToPixels(rectRight, rectBottom) << coordsToPixels(rectRight, rectTop); result.append(result.last()); result << coordsToPixels(rectLeft, rectTop); } + break; + } + } + break; + } + } + return result; +} + +/*! \internal + + This function is part of the curve optimization algorithm of \ref getCurveData. + + This method returns whether a segment going from \a prevRegion to \a currentRegion (see \ref + getRegion) may traverse the visible region 5. This function assumes that neither \a prevRegion + nor \a currentRegion is 5 itself. + + If this method returns false, the segment for sure doesn't pass region 5. If it returns true, the + segment may or may not pass region 5 and a more fine-grained calculation must be used (\ref + getTraverse). +*/ +bool QCPCurve::mayTraverse(int prevRegion, int currentRegion) const +{ + switch (prevRegion) + { + case 1: + { + switch (currentRegion) + { + case 4: + case 7: + case 2: + case 3: return false; + default: return true; + } + } + case 2: + { + switch (currentRegion) + { + case 1: + case 3: return false; + default: return true; + } + } + case 3: + { + switch (currentRegion) + { + case 1: + case 2: + case 6: + case 9: return false; + default: return true; + } + } + case 4: + { + switch (currentRegion) + { + case 1: + case 7: return false; + default: return true; + } + } + case 5: return false; // should never occur + case 6: + { + switch (currentRegion) + { + case 3: + case 9: return false; + default: return true; + } + } + case 7: + { + switch (currentRegion) + { + case 1: + case 4: + case 8: + case 9: return false; + default: return true; + } + } + case 8: + { + switch (currentRegion) + { + case 7: + case 9: return false; + default: return true; + } + } + case 9: + { + switch (currentRegion) + { + case 3: + case 6: + case 8: + case 7: return false; + default: return true; + } + } + default: return true; + } +} + + +/*! \internal + + This function is part of the curve optimization algorithm of \ref getCurveData. + + This method assumes that the \ref mayTraverse test has returned true, so there is a chance the + segment defined by (\a prevKey, \a prevValue) and (\a key, \a value) goes through the visible + region 5. + + The return value of this method indicates whether the segment actually traverses region 5 or not. + + If the segment traverses 5, the output parameters \a crossA and \a crossB indicate the entry and + exit points of region 5. They will become the optimized points for that segment. +*/ +bool QCPCurve::getTraverse(double prevKey, double prevValue, double key, double value, double rectLeft, double rectTop, double rectRight, double rectBottom, QPointF &crossA, QPointF &crossB) const +{ + QList intersections; // x of QPointF corresponds to key and y to value + if (qFuzzyIsNull(key-prevKey)) // line is parallel to value axis + { + // due to region filter in mayTraverseR(), if line is parallel to value or key axis, R is traversed here + intersections.append(QPointF(key, rectBottom)); // direction will be taken care of at end of method + intersections.append(QPointF(key, rectTop)); + } else if (qFuzzyIsNull(value-prevValue)) // line is parallel to key axis + { + // due to region filter in mayTraverseR(), if line is parallel to value or key axis, R is traversed here + intersections.append(QPointF(rectLeft, value)); // direction will be taken care of at end of method + intersections.append(QPointF(rectRight, value)); + } else // line is skewed + { + double gamma; + double keyPerValue = (key-prevKey)/(value-prevValue); + // check top of rect: + gamma = prevKey + (rectTop-prevValue)*keyPerValue; + if (gamma >= rectLeft && gamma <= rectRight) + intersections.append(QPointF(gamma, rectTop)); + // check bottom of rect: + gamma = prevKey + (rectBottom-prevValue)*keyPerValue; + if (gamma >= rectLeft && gamma <= rectRight) + intersections.append(QPointF(gamma, rectBottom)); + double valuePerKey = 1.0/keyPerValue; + // check left of rect: + gamma = prevValue + (rectLeft-prevKey)*valuePerKey; + if (gamma >= rectBottom && gamma <= rectTop) + intersections.append(QPointF(rectLeft, gamma)); + // check right of rect: + gamma = prevValue + (rectRight-prevKey)*valuePerKey; + if (gamma >= rectBottom && gamma <= rectTop) + intersections.append(QPointF(rectRight, gamma)); + } + + // handle cases where found points isn't exactly 2: + if (intersections.size() > 2) + { + // line probably goes through corner of rect, and we got duplicate points there. single out the point pair with greatest distance in between: + double distSqrMax = 0; + QPointF pv1, pv2; + for (int i=0; i distSqrMax) + { + pv1 = intersections.at(i); + pv2 = intersections.at(k); + distSqrMax = distSqr; + } + } + } + intersections = QList() << pv1 << pv2; + } else if (intersections.size() != 2) + { + // one or even zero points found (shouldn't happen unless line perfectly tangent to corner), no need to draw segment + return false; + } + + // possibly re-sort points so optimized point segment has same direction as original segment: + if ((key-prevKey)*(intersections.at(1).x()-intersections.at(0).x()) + (value-prevValue)*(intersections.at(1).y()-intersections.at(0).y()) < 0) // scalar product of both segments < 0 -> opposite direction + intersections.move(0, 1); + crossA = coordsToPixels(intersections.at(0).x(), intersections.at(0).y()); + crossB = coordsToPixels(intersections.at(1).x(), intersections.at(1).y()); + return true; +} + +/*! \internal + + This function is part of the curve optimization algorithm of \ref getCurveData. + + This method assumes that the \ref getTraverse test has returned true, so the segment definitely + traverses the visible region 5 when going from \a prevRegion to \a currentRegion. + + In certain situations it is not sufficient to merely generate the entry and exit points of the + segment into/out of region 5, as \ref getTraverse provides. It may happen that a single segment, in + addition to traversing region 5, skips another region outside of region 5, which makes it + necessary to add an optimized corner point there (very similar to the job \ref + getOptimizedCornerPoints does for segments that are completely in outside regions and don't + traverse 5). + + As an example, consider a segment going from region 1 to region 6, traversing the lower left + corner of region 5. In this configuration, the segment additionally crosses the border between + region 1 and 2 before entering region 5. This makes it necessary to add an additional point in + the top left corner, before adding the optimized traverse points. So in this case, the output + parameter \a beforeTraverse will contain the top left corner point, and \a afterTraverse will be + empty. + + In some cases, such as when going from region 1 to 9, it may even be necessary to add additional + corner points before and after the traverse. Then both \a beforeTraverse and \a afterTraverse + return the respective corner points. +*/ +void QCPCurve::getTraverseCornerPoints(int prevRegion, int currentRegion, double rectLeft, double rectTop, double rectRight, double rectBottom, QVector &beforeTraverse, QVector &afterTraverse) const +{ + switch (prevRegion) + { + case 1: + { + switch (currentRegion) + { + case 6: { beforeTraverse << coordsToPixels(rectLeft, rectTop); break; } + case 9: { beforeTraverse << coordsToPixels(rectLeft, rectTop); afterTraverse << coordsToPixels(rectRight, rectBottom); break; } + case 8: { beforeTraverse << coordsToPixels(rectLeft, rectTop); break; } + } + break; + } + case 2: + { + switch (currentRegion) + { + case 7: { afterTraverse << coordsToPixels(rectRight, rectTop); break; } + case 9: { afterTraverse << coordsToPixels(rectRight, rectBottom); break; } + } + break; + } + case 3: + { + switch (currentRegion) + { + case 4: { beforeTraverse << coordsToPixels(rectLeft, rectBottom); break; } + case 7: { beforeTraverse << coordsToPixels(rectLeft, rectBottom); afterTraverse << coordsToPixels(rectRight, rectTop); break; } + case 8: { beforeTraverse << coordsToPixels(rectLeft, rectBottom); break; } + } + break; + } + case 4: + { + switch (currentRegion) + { + case 3: { afterTraverse << coordsToPixels(rectLeft, rectBottom); break; } + case 9: { afterTraverse << coordsToPixels(rectRight, rectBottom); break; } + } + break; + } + case 5: { break; } // shouldn't happen because this method only handles full traverses + case 6: + { + switch (currentRegion) + { + case 1: { afterTraverse << coordsToPixels(rectLeft, rectTop); break; } + case 7: { afterTraverse << coordsToPixels(rectRight, rectTop); break; } + } + break; + } + case 7: + { + switch (currentRegion) + { + case 2: { beforeTraverse << coordsToPixels(rectRight, rectTop); break; } + case 3: { beforeTraverse << coordsToPixels(rectRight, rectTop); afterTraverse << coordsToPixels(rectLeft, rectBottom); break; } + case 6: { beforeTraverse << coordsToPixels(rectRight, rectTop); break; } + } + break; + } + case 8: + { + switch (currentRegion) + { + case 1: { afterTraverse << coordsToPixels(rectLeft, rectTop); break; } + case 3: { afterTraverse << coordsToPixels(rectLeft, rectBottom); break; } + } + break; + } + case 9: + { + switch (currentRegion) + { + case 2: { beforeTraverse << coordsToPixels(rectRight, rectBottom); break; } + case 1: { beforeTraverse << coordsToPixels(rectRight, rectBottom); afterTraverse << coordsToPixels(rectLeft, rectTop); break; } + case 4: { beforeTraverse << coordsToPixels(rectRight, rectBottom); break; } + } + break; + } + } +} + +/*! \internal + + Calculates the (minimum) distance (in pixels) the curve's representation has from the given \a + pixelPoint in pixels. This is used to determine whether the curve was clicked or not, e.g. in + \ref selectTest. +*/ +double QCPCurve::pointDistance(const QPointF &pixelPoint) const +{ + if (mData->isEmpty()) + { + qDebug() << Q_FUNC_INFO << "requested point distance on curve" << mName << "without data"; + return 500; + } + if (mData->size() == 1) + { + QPointF dataPoint = coordsToPixels(mData->constBegin().key(), mData->constBegin().value().value); + return QVector2D(dataPoint-pixelPoint).length(); + } + + // calculate minimum distance to line segments: + QVector *lineData = new QVector; + getCurveData(lineData); + double minDistSqr = std::numeric_limits::max(); + for (int i=0; isize()-1; ++i) + { + double currentDistSqr = distSqrToLine(lineData->at(i), lineData->at(i+1), pixelPoint); + if (currentDistSqr < minDistSqr) + minDistSqr = currentDistSqr; + } + delete lineData; + return qSqrt(minDistSqr); +} + +/* inherits documentation from base class */ +QCPRange QCPCurve::getKeyRange(bool &foundRange, SignDomain inSignDomain) const +{ + QCPRange range; + bool haveLower = false; + bool haveUpper = false; + + double current; + + QCPCurveDataMap::const_iterator it = mData->constBegin(); + while (it != mData->constEnd()) + { + current = it.value().key; + if (!qIsNaN(current) && !qIsNaN(it.value().value)) + { + if (inSignDomain == sdBoth || (inSignDomain == sdNegative && current < 0) || (inSignDomain == sdPositive && current > 0)) + { + if (current < range.lower || !haveLower) + { + range.lower = current; + haveLower = true; + } + if (current > range.upper || !haveUpper) + { + range.upper = current; + haveUpper = true; + } + } + } + ++it; + } + + foundRange = haveLower && haveUpper; + return range; +} + +/* inherits documentation from base class */ +QCPRange QCPCurve::getValueRange(bool &foundRange, SignDomain inSignDomain) const +{ + QCPRange range; + bool haveLower = false; + bool haveUpper = false; + + double current; + + QCPCurveDataMap::const_iterator it = mData->constBegin(); + while (it != mData->constEnd()) + { + current = it.value().value; + if (!qIsNaN(current) && !qIsNaN(it.value().key)) + { + if (inSignDomain == sdBoth || (inSignDomain == sdNegative && current < 0) || (inSignDomain == sdPositive && current > 0)) + { + if (current < range.lower || !haveLower) + { + range.lower = current; + haveLower = true; + } + if (current > range.upper || !haveUpper) + { + range.upper = current; + haveUpper = true; + } + } + } + ++it; + } + + foundRange = haveLower && haveUpper; + return range; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPBarsGroup +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPBarsGroup + \brief Groups multiple QCPBars together so they appear side by side + + \image html QCPBarsGroup.png + + When showing multiple QCPBars in one plot which have bars at identical keys, it may be desirable + to have them appearing next to each other at each key. This is what adding the respective QCPBars + plottables to a QCPBarsGroup achieves. (An alternative approach is to stack them on top of each + other, see \ref QCPBars::moveAbove.) + + \section qcpbarsgroup-usage Usage + + To add a QCPBars plottable to the group, create a new group and then add the respective bars + intances: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpbarsgroup-creation + Alternatively to appending to the group like shown above, you can also set the group on the + QCPBars plottable via \ref QCPBars::setBarsGroup. + + The spacing between the bars can be configured via \ref setSpacingType and \ref setSpacing. The + bars in this group appear in the plot in the order they were appended. To insert a bars plottable + at a certain index position, or to reposition a bars plottable which is already in the group, use + \ref insert. + + To remove specific bars from the group, use either \ref remove or call \ref + QCPBars::setBarsGroup "QCPBars::setBarsGroup(0)" on the respective bars plottable. + + To clear the entire group, call \ref clear, or simply delete the group. + + \section qcpbarsgroup-example Example + + The image above is generated with the following code: + \snippet documentation/doc-image-generator/mainwindow.cpp qcpbarsgroup-example +*/ + +/* start of documentation of inline functions */ + +/*! \fn QList QCPBarsGroup::bars() const + + Returns all bars currently in this group. + + \see bars(int index) +*/ + +/*! \fn int QCPBarsGroup::size() const + + Returns the number of QCPBars plottables that are part of this group. + +*/ + +/*! \fn bool QCPBarsGroup::isEmpty() const + + Returns whether this bars group is empty. + + \see size +*/ + +/*! \fn bool QCPBarsGroup::contains(QCPBars *bars) + + Returns whether the specified \a bars plottable is part of this group. + +*/ + +/* end of documentation of inline functions */ + +/*! + Constructs a new bars group for the specified QCustomPlot instance. +*/ +QCPBarsGroup::QCPBarsGroup(QCustomPlot *parentPlot) : + QObject(parentPlot), + mParentPlot(parentPlot), + mSpacingType(stAbsolute), + mSpacing(4) +{ +} + +QCPBarsGroup::~QCPBarsGroup() +{ + clear(); +} + +/*! + Sets how the spacing between adjacent bars is interpreted. See \ref SpacingType. + + The actual spacing can then be specified with \ref setSpacing. + + \see setSpacing +*/ +void QCPBarsGroup::setSpacingType(SpacingType spacingType) +{ + mSpacingType = spacingType; +} + +/*! + Sets the spacing between adjacent bars. What the number passed as \a spacing actually means, is + defined by the current \ref SpacingType, which can be set with \ref setSpacingType. + + \see setSpacingType +*/ +void QCPBarsGroup::setSpacing(double spacing) +{ + mSpacing = spacing; +} + +/*! + Returns the QCPBars instance with the specified \a index in this group. If no such QCPBars + exists, returns 0. + + \see bars(), size +*/ +QCPBars *QCPBarsGroup::bars(int index) const +{ + if (index >= 0 && index < mBars.size()) + { + return mBars.at(index); + } else + { + qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; + return 0; + } +} + +/*! + Removes all QCPBars plottables from this group. + + \see isEmpty +*/ +void QCPBarsGroup::clear() +{ + foreach (QCPBars *bars, mBars) // since foreach takes a copy, removing bars in the loop is okay + bars->setBarsGroup(0); // removes itself via removeBars +} + +/*! + Adds the specified \a bars plottable to this group. Alternatively, you can also use \ref + QCPBars::setBarsGroup on the \a bars instance. + + \see insert, remove +*/ +void QCPBarsGroup::append(QCPBars *bars) +{ + if (!bars) + { + qDebug() << Q_FUNC_INFO << "bars is 0"; + return; + } + + if (!mBars.contains(bars)) + bars->setBarsGroup(this); + else + qDebug() << Q_FUNC_INFO << "bars plottable is already in this bars group:" << reinterpret_cast(bars); +} + +/*! + Inserts the specified \a bars plottable into this group at the specified index position \a i. + This gives you full control over the ordering of the bars. + + \a bars may already be part of this group. In that case, \a bars is just moved to the new index + position. + + \see append, remove +*/ +void QCPBarsGroup::insert(int i, QCPBars *bars) +{ + if (!bars) + { + qDebug() << Q_FUNC_INFO << "bars is 0"; + return; + } + + // first append to bars list normally: + if (!mBars.contains(bars)) + bars->setBarsGroup(this); + // then move to according position: + mBars.move(mBars.indexOf(bars), qBound(0, i, mBars.size()-1)); +} + +/*! + Removes the specified \a bars plottable from this group. + + \see contains, clear +*/ +void QCPBarsGroup::remove(QCPBars *bars) +{ + if (!bars) + { + qDebug() << Q_FUNC_INFO << "bars is 0"; + return; + } + + if (mBars.contains(bars)) + bars->setBarsGroup(0); + else + qDebug() << Q_FUNC_INFO << "bars plottable is not in this bars group:" << reinterpret_cast(bars); +} + +/*! \internal + + Adds the specified \a bars to the internal mBars list of bars. This method does not change the + barsGroup property on \a bars. + + \see unregisterBars +*/ +void QCPBarsGroup::registerBars(QCPBars *bars) +{ + if (!mBars.contains(bars)) + mBars.append(bars); +} + +/*! \internal + + Removes the specified \a bars from the internal mBars list of bars. This method does not change + the barsGroup property on \a bars. + + \see registerBars +*/ +void QCPBarsGroup::unregisterBars(QCPBars *bars) +{ + mBars.removeOne(bars); +} + +/*! \internal + + Returns the pixel offset in the key dimension the specified \a bars plottable should have at the + given key coordinate \a keyCoord. The offset is relative to the pixel position of the key + coordinate \a keyCoord. +*/ +double QCPBarsGroup::keyPixelOffset(const QCPBars *bars, double keyCoord) +{ + // find list of all base bars in case some mBars are stacked: + QList baseBars; + foreach (const QCPBars *b, mBars) + { + while (b->barBelow()) + b = b->barBelow(); + if (!baseBars.contains(b)) + baseBars.append(b); + } + // find base bar this "bars" is stacked on: + const QCPBars *thisBase = bars; + while (thisBase->barBelow()) + thisBase = thisBase->barBelow(); + + // determine key pixel offset of this base bars considering all other base bars in this barsgroup: + double result = 0; + int index = baseBars.indexOf(thisBase); + if (index >= 0) + { + int startIndex; + double lowerPixelWidth, upperPixelWidth; + if (baseBars.size() % 2 == 1 && index == (baseBars.size()-1)/2) // is center bar (int division on purpose) + { + return result; + } else if (index < (baseBars.size()-1)/2.0) // bar is to the left of center + { + if (baseBars.size() % 2 == 0) // even number of bars + { + startIndex = baseBars.size()/2-1; + result -= getPixelSpacing(baseBars.at(startIndex), keyCoord)*0.5; // half of middle spacing + } else // uneven number of bars + { + startIndex = (baseBars.size()-1)/2-1; + baseBars.at((baseBars.size()-1)/2)->getPixelWidth(keyCoord, lowerPixelWidth, upperPixelWidth); + result -= qAbs(upperPixelWidth-lowerPixelWidth)*0.5; // half of center bar + result -= getPixelSpacing(baseBars.at((baseBars.size()-1)/2), keyCoord); // center bar spacing + } + for (int i=startIndex; i>index; --i) // add widths and spacings of bars in between center and our bars + { + baseBars.at(i)->getPixelWidth(keyCoord, lowerPixelWidth, upperPixelWidth); + result -= qAbs(upperPixelWidth-lowerPixelWidth); + result -= getPixelSpacing(baseBars.at(i), keyCoord); + } + // finally half of our bars width: + baseBars.at(index)->getPixelWidth(keyCoord, lowerPixelWidth, upperPixelWidth); + result -= qAbs(upperPixelWidth-lowerPixelWidth)*0.5; + } else // bar is to the right of center + { + if (baseBars.size() % 2 == 0) // even number of bars + { + startIndex = baseBars.size()/2; + result += getPixelSpacing(baseBars.at(startIndex), keyCoord)*0.5; // half of middle spacing + } else // uneven number of bars + { + startIndex = (baseBars.size()-1)/2+1; + baseBars.at((baseBars.size()-1)/2)->getPixelWidth(keyCoord, lowerPixelWidth, upperPixelWidth); + result += qAbs(upperPixelWidth-lowerPixelWidth)*0.5; // half of center bar + result += getPixelSpacing(baseBars.at((baseBars.size()-1)/2), keyCoord); // center bar spacing + } + for (int i=startIndex; igetPixelWidth(keyCoord, lowerPixelWidth, upperPixelWidth); + result += qAbs(upperPixelWidth-lowerPixelWidth); + result += getPixelSpacing(baseBars.at(i), keyCoord); + } + // finally half of our bars width: + baseBars.at(index)->getPixelWidth(keyCoord, lowerPixelWidth, upperPixelWidth); + result += qAbs(upperPixelWidth-lowerPixelWidth)*0.5; + } + } + return result; +} + +/*! \internal + + Returns the spacing in pixels which is between this \a bars and the following one, both at the + key coordinate \a keyCoord. + + \note Typically the returned value doesn't depend on \a bars or \a keyCoord. \a bars is only + needed to get acces to the key axis transformation and axis rect for the modes \ref + stAxisRectRatio and \ref stPlotCoords. The \a keyCoord is only relevant for spacings given in + \ref stPlotCoords on a logarithmic axis. +*/ +double QCPBarsGroup::getPixelSpacing(const QCPBars *bars, double keyCoord) +{ + switch (mSpacingType) + { + case stAbsolute: + { + return mSpacing; + } + case stAxisRectRatio: + { + if (bars->keyAxis()->orientation() == Qt::Horizontal) + return bars->keyAxis()->axisRect()->width()*mSpacing; + else + return bars->keyAxis()->axisRect()->height()*mSpacing; + } + case stPlotCoords: + { + double keyPixel = bars->keyAxis()->coordToPixel(keyCoord); + return bars->keyAxis()->coordToPixel(keyCoord+mSpacing)-keyPixel; + } + } + return 0; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPBarData +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPBarData + \brief Holds the data of one single data point (one bar) for QCPBars. + + The container for storing multiple data points is \ref QCPBarDataMap. + + The stored data is: + \li \a key: coordinate on the key axis of this bar + \li \a value: height coordinate on the value axis of this bar + + \see QCPBarDataaMap +*/ + +/*! + Constructs a bar data point with key and value set to zero. +*/ +QCPBarData::QCPBarData() : + key(0), + value(0) +{ +} + +/*! + Constructs a bar data point with the specified \a key and \a value. +*/ +QCPBarData::QCPBarData(double key, double value) : + key(key), + value(value) +{ +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPBars +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPBars + \brief A plottable representing a bar chart in a plot. + + \image html QCPBars.png + + To plot data, assign it with the \ref setData or \ref addData functions. + + \section appearance Changing the appearance + + The appearance of the bars is determined by the pen and the brush (\ref setPen, \ref setBrush). + The width of the individual bars can be controlled with \ref setWidthType and \ref setWidth. + + Bar charts are stackable. This means, two QCPBars plottables can be placed on top of each other + (see \ref QCPBars::moveAbove). So when two bars are at the same key position, they will appear + stacked. + + If you would like to group multiple QCPBars plottables together so they appear side by side as + shown below, use QCPBarsGroup. + + \image html QCPBarsGroup.png + + \section usage Usage + + Like all data representing objects in QCustomPlot, the QCPBars is a plottable + (QCPAbstractPlottable). So the plottable-interface of QCustomPlot applies + (QCustomPlot::plottable, QCustomPlot::addPlottable, QCustomPlot::removePlottable, etc.) + + Usually, you first create an instance: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpbars-creation-1 + add it to the customPlot with QCustomPlot::addPlottable: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpbars-creation-2 + and then modify the properties of the newly created plottable, e.g.: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpbars-creation-3 +*/ + +/* start of documentation of inline functions */ + +/*! \fn QCPBars *QCPBars::barBelow() const + Returns the bars plottable that is directly below this bars plottable. + If there is no such plottable, returns 0. + + \see barAbove, moveBelow, moveAbove +*/ + +/*! \fn QCPBars *QCPBars::barAbove() const + Returns the bars plottable that is directly above this bars plottable. + If there is no such plottable, returns 0. + + \see barBelow, moveBelow, moveAbove +*/ + +/* end of documentation of inline functions */ + +/*! + Constructs a bar chart which uses \a keyAxis as its key axis ("x") and \a valueAxis as its value + axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance and not have + the same orientation. If either of these restrictions is violated, a corresponding message is + printed to the debug output (qDebug), the construction is not aborted, though. + + The constructed QCPBars can be added to the plot with QCustomPlot::addPlottable, QCustomPlot + then takes ownership of the bar chart. +*/ +QCPBars::QCPBars(QCPAxis *keyAxis, QCPAxis *valueAxis) : + QCPAbstractPlottable(keyAxis, valueAxis), + mData(new QCPBarDataMap), + mWidth(0.75), + mWidthType(wtPlotCoords), + mBarsGroup(0), + mBaseValue(0) +{ + // modify inherited properties from abstract plottable: + mPen.setColor(Qt::blue); + mPen.setStyle(Qt::SolidLine); + mBrush.setColor(QColor(40, 50, 255, 30)); + mBrush.setStyle(Qt::SolidPattern); + mSelectedPen = mPen; + mSelectedPen.setWidthF(2.5); + mSelectedPen.setColor(QColor(80, 80, 255)); // lighter than Qt::blue of mPen + mSelectedBrush = mBrush; +} + +QCPBars::~QCPBars() +{ + setBarsGroup(0); + if (mBarBelow || mBarAbove) + connectBars(mBarBelow.data(), mBarAbove.data()); // take this bar out of any stacking + delete mData; +} + +/*! + Sets the width of the bars. + + How the number passed as \a width is interpreted (e.g. screen pixels, plot coordinates,...), + depends on the currently set width type, see \ref setWidthType and \ref WidthType. +*/ +void QCPBars::setWidth(double width) +{ + mWidth = width; +} + +/*! + Sets how the width of the bars is defined. See the documentation of \ref WidthType for an + explanation of the possible values for \a widthType. + + The default value is \ref wtPlotCoords. + + \see setWidth +*/ +void QCPBars::setWidthType(QCPBars::WidthType widthType) +{ + mWidthType = widthType; +} + +/*! + Sets to which QCPBarsGroup this QCPBars instance belongs to. Alternatively, you can also use \ref + QCPBarsGroup::append. + + To remove this QCPBars from any group, set \a barsGroup to 0. +*/ +void QCPBars::setBarsGroup(QCPBarsGroup *barsGroup) +{ + // deregister at old group: + if (mBarsGroup) + mBarsGroup->unregisterBars(this); + mBarsGroup = barsGroup; + // register at new group: + if (mBarsGroup) + mBarsGroup->registerBars(this); +} + +/*! + Sets the base value of this bars plottable. + + The base value defines where on the value coordinate the bars start. How far the bars extend from + the base value is given by their individual value data. For example, if the base value is set to + 1, a bar with data value 2 will have its lowest point at value coordinate 1 and highest point at + 3. + + For stacked bars, only the base value of the bottom-most QCPBars has meaning. + + The default base value is 0. +*/ +void QCPBars::setBaseValue(double baseValue) +{ + mBaseValue = baseValue; +} + +/*! + Replaces the current data with the provided \a data. + + If \a copy is set to true, data points in \a data will only be copied. if false, the plottable + takes ownership of the passed data and replaces the internal data pointer with it. This is + significantly faster than copying for large datasets. +*/ +void QCPBars::setData(QCPBarDataMap *data, bool copy) +{ + if (mData == data) + { + qDebug() << Q_FUNC_INFO << "The data pointer is already in (and owned by) this plottable" << reinterpret_cast(data); + return; + } + if (copy) + { + *mData = *data; + } else + { + delete mData; + mData = data; + } +} + +/*! \overload + + Replaces the current data with the provided points in \a key and \a value tuples. The + provided vectors should have equal length. Else, the number of added points will be the size of + the smallest vector. +*/ +void QCPBars::setData(const QVector &key, const QVector &value) +{ + mData->clear(); + int n = key.size(); + n = qMin(n, value.size()); + QCPBarData newData; + for (int i=0; iinsertMulti(newData.key, newData); + } +} + +/*! + Moves this bars plottable below \a bars. In other words, the bars of this plottable will appear + below the bars of \a bars. The move target \a bars must use the same key and value axis as this + plottable. + + Inserting into and removing from existing bar stacking is handled gracefully. If \a bars already + has a bars object below itself, this bars object is inserted between the two. If this bars object + is already between two other bars, the two other bars will be stacked on top of each other after + the operation. + + To remove this bars plottable from any stacking, set \a bars to 0. + + \see moveBelow, barAbove, barBelow +*/ +void QCPBars::moveBelow(QCPBars *bars) +{ + if (bars == this) return; + if (bars && (bars->keyAxis() != mKeyAxis.data() || bars->valueAxis() != mValueAxis.data())) + { + qDebug() << Q_FUNC_INFO << "passed QCPBars* doesn't have same key and value axis as this QCPBars"; + return; + } + // remove from stacking: + connectBars(mBarBelow.data(), mBarAbove.data()); // Note: also works if one (or both) of them is 0 + // if new bar given, insert this bar below it: + if (bars) + { + if (bars->mBarBelow) + connectBars(bars->mBarBelow.data(), this); + connectBars(this, bars); + } +} + +/*! + Moves this bars plottable above \a bars. In other words, the bars of this plottable will appear + above the bars of \a bars. The move target \a bars must use the same key and value axis as this + plottable. + + Inserting into and removing from existing bar stacking is handled gracefully. If \a bars already + has a bars object above itself, this bars object is inserted between the two. If this bars object + is already between two other bars, the two other bars will be stacked on top of each other after + the operation. + + To remove this bars plottable from any stacking, set \a bars to 0. + + \see moveBelow, barBelow, barAbove +*/ +void QCPBars::moveAbove(QCPBars *bars) +{ + if (bars == this) return; + if (bars && (bars->keyAxis() != mKeyAxis.data() || bars->valueAxis() != mValueAxis.data())) + { + qDebug() << Q_FUNC_INFO << "passed QCPBars* doesn't have same key and value axis as this QCPBars"; + return; + } + // remove from stacking: + connectBars(mBarBelow.data(), mBarAbove.data()); // Note: also works if one (or both) of them is 0 + // if new bar given, insert this bar above it: + if (bars) + { + if (bars->mBarAbove) + connectBars(this, bars->mBarAbove.data()); + connectBars(bars, this); + } +} + +/*! + Adds the provided data points in \a dataMap to the current data. + \see removeData +*/ +void QCPBars::addData(const QCPBarDataMap &dataMap) +{ + mData->unite(dataMap); +} + +/*! \overload + Adds the provided single data point in \a data to the current data. + \see removeData +*/ +void QCPBars::addData(const QCPBarData &data) +{ + mData->insertMulti(data.key, data); +} + +/*! \overload + Adds the provided single data point as \a key and \a value tuple to the current data + \see removeData +*/ +void QCPBars::addData(double key, double value) +{ + QCPBarData newData; + newData.key = key; + newData.value = value; + mData->insertMulti(newData.key, newData); +} + +/*! \overload + Adds the provided data points as \a key and \a value tuples to the current data. + \see removeData +*/ +void QCPBars::addData(const QVector &keys, const QVector &values) +{ + int n = keys.size(); + n = qMin(n, values.size()); + QCPBarData newData; + for (int i=0; iinsertMulti(newData.key, newData); + } +} + +/*! + Removes all data points with key smaller than \a key. + \see addData, clearData +*/ +void QCPBars::removeDataBefore(double key) +{ + QCPBarDataMap::iterator it = mData->begin(); + while (it != mData->end() && it.key() < key) + it = mData->erase(it); +} + +/*! + Removes all data points with key greater than \a key. + \see addData, clearData +*/ +void QCPBars::removeDataAfter(double key) +{ + if (mData->isEmpty()) return; + QCPBarDataMap::iterator it = mData->upperBound(key); + while (it != mData->end()) + it = mData->erase(it); +} + +/*! + Removes all data points with key between \a fromKey and \a toKey. if \a fromKey is + greater or equal to \a toKey, the function does nothing. To remove a single data point with known + key, use \ref removeData(double key). + + \see addData, clearData +*/ +void QCPBars::removeData(double fromKey, double toKey) +{ + if (fromKey >= toKey || mData->isEmpty()) return; + QCPBarDataMap::iterator it = mData->upperBound(fromKey); + QCPBarDataMap::iterator itEnd = mData->upperBound(toKey); + while (it != itEnd) + it = mData->erase(it); +} + +/*! \overload + + Removes a single data point at \a key. If the position is not known with absolute precision, + consider using \ref removeData(double fromKey, double toKey) with a small fuzziness interval + around the suspected position, depeding on the precision with which the key is known. + + \see addData, clearData +*/ +void QCPBars::removeData(double key) +{ + mData->remove(key); +} + +/*! + Removes all data points. + \see removeData, removeDataAfter, removeDataBefore +*/ +void QCPBars::clearData() +{ + mData->clear(); +} + +/* inherits documentation from base class */ +double QCPBars::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + if (!mKeyAxis || !mValueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return -1; } + + if (mKeyAxis.data()->axisRect()->rect().contains(pos.toPoint())) + { + QCPBarDataMap::ConstIterator it; + for (it = mData->constBegin(); it != mData->constEnd(); ++it) + { + if (getBarPolygon(it.value().key, it.value().value).boundingRect().contains(pos)) + return mParentPlot->selectionTolerance()*0.99; + } + } + return -1; +} + +/* inherits documentation from base class */ +void QCPBars::draw(QCPPainter *painter) +{ + if (!mKeyAxis || !mValueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + if (mData->isEmpty()) return; + + QCPBarDataMap::const_iterator it, lower, upperEnd; + getVisibleDataBounds(lower, upperEnd); + for (it = lower; it != upperEnd; ++it) + { + // check data validity if flag set: +#ifdef QCUSTOMPLOT_CHECK_DATA + if (QCP::isInvalidData(it.value().key, it.value().value)) + qDebug() << Q_FUNC_INFO << "Data point at" << it.key() << "of drawn range invalid." << "Plottable name:" << name(); +#endif + QPolygonF barPolygon = getBarPolygon(it.key(), it.value().value); + // draw bar fill: + if (mainBrush().style() != Qt::NoBrush && mainBrush().color().alpha() != 0) + { + applyFillAntialiasingHint(painter); + painter->setPen(Qt::NoPen); + painter->setBrush(mainBrush()); + painter->drawPolygon(barPolygon); + } + // draw bar line: + if (mainPen().style() != Qt::NoPen && mainPen().color().alpha() != 0) + { + applyDefaultAntialiasingHint(painter); + painter->setPen(mainPen()); + painter->setBrush(Qt::NoBrush); + painter->drawPolyline(barPolygon); + } + } +} + +/* inherits documentation from base class */ +void QCPBars::drawLegendIcon(QCPPainter *painter, const QRectF &rect) const +{ + // draw filled rect: + applyDefaultAntialiasingHint(painter); + painter->setBrush(mBrush); + painter->setPen(mPen); + QRectF r = QRectF(0, 0, rect.width()*0.67, rect.height()*0.67); + r.moveCenter(rect.center()); + painter->drawRect(r); +} + +/*! \internal + + called by \ref draw to determine which data (key) range is visible at the current key axis range + setting, so only that needs to be processed. It also takes into account the bar width. + + \a lower returns an iterator to the lowest data point that needs to be taken into account when + plotting. Note that in order to get a clean plot all the way to the edge of the axis rect, \a + lower may still be just outside the visible range. + + \a upperEnd returns an iterator one higher than the highest visible data point. Same as before, \a + upperEnd may also lie just outside of the visible range. + + if the bars plottable contains no data, both \a lower and \a upperEnd point to constEnd. +*/ +void QCPBars::getVisibleDataBounds(QCPBarDataMap::const_iterator &lower, QCPBarDataMap::const_iterator &upperEnd) const +{ + if (!mKeyAxis) { qDebug() << Q_FUNC_INFO << "invalid key axis"; return; } + if (mData->isEmpty()) + { + lower = mData->constEnd(); + upperEnd = mData->constEnd(); + return; + } + + // get visible data range as QMap iterators + lower = mData->lowerBound(mKeyAxis.data()->range().lower); + upperEnd = mData->upperBound(mKeyAxis.data()->range().upper); + double lowerPixelBound = mKeyAxis.data()->coordToPixel(mKeyAxis.data()->range().lower); + double upperPixelBound = mKeyAxis.data()->coordToPixel(mKeyAxis.data()->range().upper); + bool isVisible = false; + // walk left from lbound to find lower bar that actually is completely outside visible pixel range: + QCPBarDataMap::const_iterator it = lower; + while (it != mData->constBegin()) + { + --it; + QRectF barBounds = getBarPolygon(it.value().key, it.value().value).boundingRect(); + if (mKeyAxis.data()->orientation() == Qt::Horizontal) + isVisible = ((!mKeyAxis.data()->rangeReversed() && barBounds.right() >= lowerPixelBound) || (mKeyAxis.data()->rangeReversed() && barBounds.left() <= lowerPixelBound)); + else // keyaxis is vertical + isVisible = ((!mKeyAxis.data()->rangeReversed() && barBounds.top() <= lowerPixelBound) || (mKeyAxis.data()->rangeReversed() && barBounds.bottom() >= lowerPixelBound)); + if (isVisible) + lower = it; + else + break; + } + // walk right from ubound to find upper bar that actually is completely outside visible pixel range: + it = upperEnd; + while (it != mData->constEnd()) + { + QRectF barBounds = getBarPolygon(upperEnd.value().key, upperEnd.value().value).boundingRect(); + if (mKeyAxis.data()->orientation() == Qt::Horizontal) + isVisible = ((!mKeyAxis.data()->rangeReversed() && barBounds.left() <= upperPixelBound) || (mKeyAxis.data()->rangeReversed() && barBounds.right() >= upperPixelBound)); + else // keyaxis is vertical + isVisible = ((!mKeyAxis.data()->rangeReversed() && barBounds.bottom() >= upperPixelBound) || (mKeyAxis.data()->rangeReversed() && barBounds.top() <= upperPixelBound)); + if (isVisible) + upperEnd = it+1; + else + break; + ++it; + } +} + +/*! \internal + + Returns the polygon of a single bar with \a key and \a value. The Polygon is open at the bottom + and shifted according to the bar stacking (see \ref moveAbove) and base value (see \ref + setBaseValue). +*/ +QPolygonF QCPBars::getBarPolygon(double key, double value) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return QPolygonF(); } + + QPolygonF result; + double lowerPixelWidth, upperPixelWidth; + getPixelWidth(key, lowerPixelWidth, upperPixelWidth); + double base = getStackedBaseValue(key, value >= 0); + double basePixel = valueAxis->coordToPixel(base); + double valuePixel = valueAxis->coordToPixel(base+value); + double keyPixel = keyAxis->coordToPixel(key); + if (mBarsGroup) + keyPixel += mBarsGroup->keyPixelOffset(this, key); + if (keyAxis->orientation() == Qt::Horizontal) + { + result << QPointF(keyPixel+lowerPixelWidth, basePixel); + result << QPointF(keyPixel+lowerPixelWidth, valuePixel); + result << QPointF(keyPixel+upperPixelWidth, valuePixel); + result << QPointF(keyPixel+upperPixelWidth, basePixel); + } else + { + result << QPointF(basePixel, keyPixel+lowerPixelWidth); + result << QPointF(valuePixel, keyPixel+lowerPixelWidth); + result << QPointF(valuePixel, keyPixel+upperPixelWidth); + result << QPointF(basePixel, keyPixel+upperPixelWidth); + } + return result; +} + +/*! \internal + + This function is used to determine the width of the bar at coordinate \a key, according to the + specified width (\ref setWidth) and width type (\ref setWidthType). + + The output parameters \a lower and \a upper return the number of pixels the bar extends to lower + and higher keys, relative to the \a key coordinate (so with a non-reversed horizontal axis, \a + lower is negative and \a upper positive). +*/ +void QCPBars::getPixelWidth(double key, double &lower, double &upper) const +{ + switch (mWidthType) + { + case wtAbsolute: + { + upper = mWidth*0.5; + lower = -upper; + if (mKeyAxis && (mKeyAxis.data()->rangeReversed() ^ (mKeyAxis.data()->orientation() == Qt::Vertical))) + qSwap(lower, upper); + break; + } + case wtAxisRectRatio: + { + if (mKeyAxis && mKeyAxis.data()->axisRect()) + { + if (mKeyAxis.data()->orientation() == Qt::Horizontal) + upper = mKeyAxis.data()->axisRect()->width()*mWidth*0.5; + else + upper = mKeyAxis.data()->axisRect()->height()*mWidth*0.5; + lower = -upper; + if (mKeyAxis && (mKeyAxis.data()->rangeReversed() ^ (mKeyAxis.data()->orientation() == Qt::Vertical))) + qSwap(lower, upper); + } else + qDebug() << Q_FUNC_INFO << "No key axis or axis rect defined"; + break; + } + case wtPlotCoords: + { + if (mKeyAxis) + { + double keyPixel = mKeyAxis.data()->coordToPixel(key); + upper = mKeyAxis.data()->coordToPixel(key+mWidth*0.5)-keyPixel; + lower = mKeyAxis.data()->coordToPixel(key-mWidth*0.5)-keyPixel; + // no need to qSwap(lower, higher) when range reversed, because higher/lower are gained by + // coordinate transform which includes range direction + } else + qDebug() << Q_FUNC_INFO << "No key axis defined"; + break; + } + } +} + +/*! \internal + + This function is called to find at which value to start drawing the base of a bar at \a key, when + it is stacked on top of another QCPBars (e.g. with \ref moveAbove). + + positive and negative bars are separated per stack (positive are stacked above baseValue upwards, + negative are stacked below baseValue downwards). This can be indicated with \a positive. So if the + bar for which we need the base value is negative, set \a positive to false. +*/ +double QCPBars::getStackedBaseValue(double key, bool positive) const +{ + if (mBarBelow) + { + double max = 0; // don't use mBaseValue here because only base value of bottom-most bar has meaning in a bar stack + // find bars of mBarBelow that are approximately at key and find largest one: + double epsilon = qAbs(key)*1e-6; // should be safe even when changed to use float at some point + if (key == 0) + epsilon = 1e-6; + QCPBarDataMap::const_iterator it = mBarBelow.data()->mData->lowerBound(key-epsilon); + QCPBarDataMap::const_iterator itEnd = mBarBelow.data()->mData->upperBound(key+epsilon); + while (it != itEnd) + { + if ((positive && it.value().value > max) || + (!positive && it.value().value < max)) + max = it.value().value; + ++it; + } + // recurse down the bar-stack to find the total height: + return max + mBarBelow.data()->getStackedBaseValue(key, positive); + } else + return mBaseValue; +} + +/*! \internal + + Connects \a below and \a above to each other via their mBarAbove/mBarBelow properties. The bar(s) + currently above lower and below upper will become disconnected to lower/upper. + + If lower is zero, upper will be disconnected at the bottom. + If upper is zero, lower will be disconnected at the top. +*/ +void QCPBars::connectBars(QCPBars *lower, QCPBars *upper) +{ + if (!lower && !upper) return; + + if (!lower) // disconnect upper at bottom + { + // disconnect old bar below upper: + if (upper->mBarBelow && upper->mBarBelow.data()->mBarAbove.data() == upper) + upper->mBarBelow.data()->mBarAbove = 0; + upper->mBarBelow = 0; + } else if (!upper) // disconnect lower at top + { + // disconnect old bar above lower: + if (lower->mBarAbove && lower->mBarAbove.data()->mBarBelow.data() == lower) + lower->mBarAbove.data()->mBarBelow = 0; + lower->mBarAbove = 0; + } else // connect lower and upper + { + // disconnect old bar above lower: + if (lower->mBarAbove && lower->mBarAbove.data()->mBarBelow.data() == lower) + lower->mBarAbove.data()->mBarBelow = 0; + // disconnect old bar below upper: + if (upper->mBarBelow && upper->mBarBelow.data()->mBarAbove.data() == upper) + upper->mBarBelow.data()->mBarAbove = 0; + lower->mBarAbove = upper; + upper->mBarBelow = lower; + } +} + +/* inherits documentation from base class */ +QCPRange QCPBars::getKeyRange(bool &foundRange, SignDomain inSignDomain) const +{ + QCPRange range; + bool haveLower = false; + bool haveUpper = false; + + double current; + QCPBarDataMap::const_iterator it = mData->constBegin(); + while (it != mData->constEnd()) + { + current = it.value().key; + if (inSignDomain == sdBoth || (inSignDomain == sdNegative && current < 0) || (inSignDomain == sdPositive && current > 0)) + { + if (current < range.lower || !haveLower) + { + range.lower = current; + haveLower = true; + } + if (current > range.upper || !haveUpper) + { + range.upper = current; + haveUpper = true; + } + } + ++it; + } + // determine exact range of bars by including bar width and barsgroup offset: + if (haveLower && mKeyAxis) + { + double lowerPixelWidth, upperPixelWidth, keyPixel; + getPixelWidth(range.lower, lowerPixelWidth, upperPixelWidth); + keyPixel = mKeyAxis.data()->coordToPixel(range.lower) + lowerPixelWidth; + if (mBarsGroup) + keyPixel += mBarsGroup->keyPixelOffset(this, range.lower); + range.lower = mKeyAxis.data()->pixelToCoord(keyPixel); + } + if (haveUpper && mKeyAxis) + { + double lowerPixelWidth, upperPixelWidth, keyPixel; + getPixelWidth(range.upper, lowerPixelWidth, upperPixelWidth); + keyPixel = mKeyAxis.data()->coordToPixel(range.upper) + upperPixelWidth; + if (mBarsGroup) + keyPixel += mBarsGroup->keyPixelOffset(this, range.upper); + range.upper = mKeyAxis.data()->pixelToCoord(keyPixel); + } + foundRange = haveLower && haveUpper; + return range; +} + +/* inherits documentation from base class */ +QCPRange QCPBars::getValueRange(bool &foundRange, SignDomain inSignDomain) const +{ + QCPRange range; + range.lower = mBaseValue; + range.upper = mBaseValue; + bool haveLower = true; // set to true, because baseValue should always be visible in bar charts + bool haveUpper = true; // set to true, because baseValue should always be visible in bar charts + double current; + + QCPBarDataMap::const_iterator it = mData->constBegin(); + while (it != mData->constEnd()) + { + current = it.value().value + getStackedBaseValue(it.value().key, it.value().value >= 0); + if (inSignDomain == sdBoth || (inSignDomain == sdNegative && current < 0) || (inSignDomain == sdPositive && current > 0)) + { + if (current < range.lower || !haveLower) + { + range.lower = current; + haveLower = true; + } + if (current > range.upper || !haveUpper) + { + range.upper = current; + haveUpper = true; + } + } + ++it; + } + + foundRange = true; // return true because bar charts always have the 0-line visible + return range; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPStatisticalBox +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPStatisticalBox + \brief A plottable representing a single statistical box in a plot. + + \image html QCPStatisticalBox.png + + To plot data, assign it with the individual parameter functions or use \ref setData to set all + parameters at once. The individual functions are: + \li \ref setMinimum + \li \ref setLowerQuartile + \li \ref setMedian + \li \ref setUpperQuartile + \li \ref setMaximum + + Additionally you can define a list of outliers, drawn as scatter datapoints: + \li \ref setOutliers + + \section appearance Changing the appearance + + The appearance of the box itself is controlled via \ref setPen and \ref setBrush. You may change + the width of the box with \ref setWidth in plot coordinates (not pixels). + + Analog functions exist for the minimum/maximum-whiskers: \ref setWhiskerPen, \ref + setWhiskerBarPen, \ref setWhiskerWidth. The whisker width is the width of the bar at the top + (maximum) and bottom (minimum). + + The median indicator line has its own pen, \ref setMedianPen. + + If the whisker backbone pen is changed, make sure to set the capStyle to Qt::FlatCap. Else, the + backbone line might exceed the whisker bars by a few pixels due to the pen cap being not + perfectly flat. + + The Outlier data points are drawn as normal scatter points. Their look can be controlled with + \ref setOutlierStyle + + \section usage Usage + + Like all data representing objects in QCustomPlot, the QCPStatisticalBox is a plottable. + Usually, you first create an instance and add it to the customPlot: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpstatisticalbox-creation-1 + and then modify the properties of the newly created plottable, e.g.: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpstatisticalbox-creation-2 +*/ + +/*! + Constructs a statistical box which uses \a keyAxis as its key axis ("x") and \a valueAxis as its + value axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance and + not have the same orientation. If either of these restrictions is violated, a corresponding + message is printed to the debug output (qDebug), the construction is not aborted, though. + + The constructed statistical box can be added to the plot with QCustomPlot::addPlottable, + QCustomPlot then takes ownership of the statistical box. +*/ +QCPStatisticalBox::QCPStatisticalBox(QCPAxis *keyAxis, QCPAxis *valueAxis) : + QCPAbstractPlottable(keyAxis, valueAxis), + mKey(0), + mMinimum(0), + mLowerQuartile(0), + mMedian(0), + mUpperQuartile(0), + mMaximum(0) +{ + setOutlierStyle(QCPScatterStyle(QCPScatterStyle::ssCircle, Qt::blue, 6)); + setWhiskerWidth(0.2); + setWidth(0.5); + + setPen(QPen(Qt::black)); + setSelectedPen(QPen(Qt::blue, 2.5)); + setMedianPen(QPen(Qt::black, 3, Qt::SolidLine, Qt::FlatCap)); + setWhiskerPen(QPen(Qt::black, 0, Qt::DashLine, Qt::FlatCap)); + setWhiskerBarPen(QPen(Qt::black)); + setBrush(Qt::NoBrush); + setSelectedBrush(Qt::NoBrush); +} + +/*! + Sets the key coordinate of the statistical box. +*/ +void QCPStatisticalBox::setKey(double key) +{ + mKey = key; +} + +/*! + Sets the parameter "minimum" of the statistical box plot. This is the position of the lower + whisker, typically the minimum measurement of the sample that's not considered an outlier. + + \see setMaximum, setWhiskerPen, setWhiskerBarPen, setWhiskerWidth +*/ +void QCPStatisticalBox::setMinimum(double value) +{ + mMinimum = value; +} + +/*! + Sets the parameter "lower Quartile" of the statistical box plot. This is the lower end of the + box. The lower and the upper quartiles are the two statistical quartiles around the median of the + sample, they contain 50% of the sample data. + + \see setUpperQuartile, setPen, setBrush, setWidth +*/ +void QCPStatisticalBox::setLowerQuartile(double value) +{ + mLowerQuartile = value; +} + +/*! + Sets the parameter "median" of the statistical box plot. This is the value of the median mark + inside the quartile box. The median separates the sample data in half (50% of the sample data is + below/above the median). + + \see setMedianPen +*/ +void QCPStatisticalBox::setMedian(double value) +{ + mMedian = value; +} + +/*! + Sets the parameter "upper Quartile" of the statistical box plot. This is the upper end of the + box. The lower and the upper quartiles are the two statistical quartiles around the median of the + sample, they contain 50% of the sample data. + + \see setLowerQuartile, setPen, setBrush, setWidth +*/ +void QCPStatisticalBox::setUpperQuartile(double value) +{ + mUpperQuartile = value; +} + +/*! + Sets the parameter "maximum" of the statistical box plot. This is the position of the upper + whisker, typically the maximum measurement of the sample that's not considered an outlier. + + \see setMinimum, setWhiskerPen, setWhiskerBarPen, setWhiskerWidth +*/ +void QCPStatisticalBox::setMaximum(double value) +{ + mMaximum = value; +} + +/*! + Sets a vector of outlier values that will be drawn as scatters. Any data points in the sample + that are not within the whiskers (\ref setMinimum, \ref setMaximum) should be considered outliers + and displayed as such. + + \see setOutlierStyle +*/ +void QCPStatisticalBox::setOutliers(const QVector &values) +{ + mOutliers = values; +} + +/*! + Sets all parameters of the statistical box plot at once. + + \see setKey, setMinimum, setLowerQuartile, setMedian, setUpperQuartile, setMaximum +*/ +void QCPStatisticalBox::setData(double key, double minimum, double lowerQuartile, double median, double upperQuartile, double maximum) +{ + setKey(key); + setMinimum(minimum); + setLowerQuartile(lowerQuartile); + setMedian(median); + setUpperQuartile(upperQuartile); + setMaximum(maximum); +} + +/*! + Sets the width of the box in key coordinates. + + \see setWhiskerWidth +*/ +void QCPStatisticalBox::setWidth(double width) +{ + mWidth = width; +} + +/*! + Sets the width of the whiskers (\ref setMinimum, \ref setMaximum) in key coordinates. + + \see setWidth +*/ +void QCPStatisticalBox::setWhiskerWidth(double width) +{ + mWhiskerWidth = width; +} + +/*! + Sets the pen used for drawing the whisker backbone (That's the line parallel to the value axis). + + Make sure to set the \a pen capStyle to Qt::FlatCap to prevent the whisker backbone from reaching + a few pixels past the whisker bars, when using a non-zero pen width. + + \see setWhiskerBarPen +*/ +void QCPStatisticalBox::setWhiskerPen(const QPen &pen) +{ + mWhiskerPen = pen; +} + +/*! + Sets the pen used for drawing the whisker bars (Those are the lines parallel to the key axis at + each end of the whisker backbone). + + \see setWhiskerPen +*/ +void QCPStatisticalBox::setWhiskerBarPen(const QPen &pen) +{ + mWhiskerBarPen = pen; +} + +/*! + Sets the pen used for drawing the median indicator line inside the statistical box. +*/ +void QCPStatisticalBox::setMedianPen(const QPen &pen) +{ + mMedianPen = pen; +} + +/*! + Sets the appearance of the outlier data points. + + \see setOutliers +*/ +void QCPStatisticalBox::setOutlierStyle(const QCPScatterStyle &style) +{ + mOutlierStyle = style; +} + +/* inherits documentation from base class */ +void QCPStatisticalBox::clearData() +{ + setOutliers(QVector()); + setKey(0); + setMinimum(0); + setLowerQuartile(0); + setMedian(0); + setUpperQuartile(0); + setMaximum(0); +} + +/* inherits documentation from base class */ +double QCPStatisticalBox::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + if (!mKeyAxis || !mValueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return -1; } + + if (mKeyAxis.data()->axisRect()->rect().contains(pos.toPoint())) + { + double posKey, posValue; + pixelsToCoords(pos, posKey, posValue); + // quartile box: + QCPRange keyRange(mKey-mWidth*0.5, mKey+mWidth*0.5); + QCPRange valueRange(mLowerQuartile, mUpperQuartile); + if (keyRange.contains(posKey) && valueRange.contains(posValue)) + return mParentPlot->selectionTolerance()*0.99; + + // min/max whiskers: + if (QCPRange(mMinimum, mMaximum).contains(posValue)) + return qAbs(mKeyAxis.data()->coordToPixel(mKey)-mKeyAxis.data()->coordToPixel(posKey)); + } + return -1; +} + +/* inherits documentation from base class */ +void QCPStatisticalBox::draw(QCPPainter *painter) +{ + if (!mKeyAxis || !mValueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + + // check data validity if flag set: +#ifdef QCUSTOMPLOT_CHECK_DATA + if (QCP::isInvalidData(mKey, mMedian) || + QCP::isInvalidData(mLowerQuartile, mUpperQuartile) || + QCP::isInvalidData(mMinimum, mMaximum)) + qDebug() << Q_FUNC_INFO << "Data point at" << mKey << "of drawn range has invalid data." << "Plottable name:" << name(); + for (int i=0; isave(); + painter->setClipRect(quartileBox, Qt::IntersectClip); + drawMedian(painter); + painter->restore(); + + drawWhiskers(painter); + drawOutliers(painter); +} + +/* inherits documentation from base class */ +void QCPStatisticalBox::drawLegendIcon(QCPPainter *painter, const QRectF &rect) const +{ + // draw filled rect: + applyDefaultAntialiasingHint(painter); + painter->setPen(mPen); + painter->setBrush(mBrush); + QRectF r = QRectF(0, 0, rect.width()*0.67, rect.height()*0.67); + r.moveCenter(rect.center()); + painter->drawRect(r); +} + +/*! \internal + + Draws the quartile box. \a box is an output parameter that returns the quartile box (in pixel + coordinates) which is used to set the clip rect of the painter before calling \ref drawMedian (so + the median doesn't draw outside the quartile box). +*/ +void QCPStatisticalBox::drawQuartileBox(QCPPainter *painter, QRectF *quartileBox) const +{ + QRectF box; + box.setTopLeft(coordsToPixels(mKey-mWidth*0.5, mUpperQuartile)); + box.setBottomRight(coordsToPixels(mKey+mWidth*0.5, mLowerQuartile)); + applyDefaultAntialiasingHint(painter); + painter->setPen(mainPen()); + painter->setBrush(mainBrush()); + painter->drawRect(box); + if (quartileBox) + *quartileBox = box; +} + +/*! \internal + + Draws the median line inside the quartile box. +*/ +void QCPStatisticalBox::drawMedian(QCPPainter *painter) const +{ + QLineF medianLine; + medianLine.setP1(coordsToPixels(mKey-mWidth*0.5, mMedian)); + medianLine.setP2(coordsToPixels(mKey+mWidth*0.5, mMedian)); + applyDefaultAntialiasingHint(painter); + painter->setPen(mMedianPen); + painter->drawLine(medianLine); +} + +/*! \internal + + Draws both whisker backbones and bars. +*/ +void QCPStatisticalBox::drawWhiskers(QCPPainter *painter) const +{ + QLineF backboneMin, backboneMax, barMin, barMax; + backboneMax.setPoints(coordsToPixels(mKey, mUpperQuartile), coordsToPixels(mKey, mMaximum)); + backboneMin.setPoints(coordsToPixels(mKey, mLowerQuartile), coordsToPixels(mKey, mMinimum)); + barMax.setPoints(coordsToPixels(mKey-mWhiskerWidth*0.5, mMaximum), coordsToPixels(mKey+mWhiskerWidth*0.5, mMaximum)); + barMin.setPoints(coordsToPixels(mKey-mWhiskerWidth*0.5, mMinimum), coordsToPixels(mKey+mWhiskerWidth*0.5, mMinimum)); + applyErrorBarsAntialiasingHint(painter); + painter->setPen(mWhiskerPen); + painter->drawLine(backboneMin); + painter->drawLine(backboneMax); + painter->setPen(mWhiskerBarPen); + painter->drawLine(barMin); + painter->drawLine(barMax); +} + +/*! \internal + + Draws the outlier scatter points. +*/ +void QCPStatisticalBox::drawOutliers(QCPPainter *painter) const +{ + applyScattersAntialiasingHint(painter); + mOutlierStyle.applyTo(painter, mPen); + for (int i=0; i 0) + return QCPRange(mKey-mWidth*0.5, mKey+mWidth*0.5); + else if (mKey > 0) + return QCPRange(mKey, mKey+mWidth*0.5); + else + { + foundRange = false; + return QCPRange(); + } + } + foundRange = false; + return QCPRange(); +} + +/* inherits documentation from base class */ +QCPRange QCPStatisticalBox::getValueRange(bool &foundRange, SignDomain inSignDomain) const +{ + QVector values; // values that must be considered (i.e. all outliers and the five box-parameters) + values.reserve(mOutliers.size() + 5); + values << mMaximum << mUpperQuartile << mMedian << mLowerQuartile << mMinimum; + values << mOutliers; + // go through values and find the ones in legal range: + bool haveUpper = false; + bool haveLower = false; + double upper = 0; + double lower = 0; + for (int i=0; i 0) || + (inSignDomain == sdBoth)) + { + if (values.at(i) > upper || !haveUpper) + { + upper = values.at(i); + haveUpper = true; + } + if (values.at(i) < lower || !haveLower) + { + lower = values.at(i); + haveLower = true; + } + } + } + // return the bounds if we found some sensible values: + if (haveLower && haveUpper) + { + foundRange = true; + return QCPRange(lower, upper); + } else // might happen if all values are in other sign domain + { + foundRange = false; + return QCPRange(); + } +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPColorMapData +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPColorMapData + \brief Holds the two-dimensional data of a QCPColorMap plottable. + + This class is a data storage for \ref QCPColorMap. It holds a two-dimensional array, which \ref + QCPColorMap then displays as a 2D image in the plot, where the array values are represented by a + color, depending on the value. + + The size of the array can be controlled via \ref setSize (or \ref setKeySize, \ref setValueSize). + Which plot coordinates these cells correspond to can be configured with \ref setRange (or \ref + setKeyRange, \ref setValueRange). + + The data cells can be accessed in two ways: They can be directly addressed by an integer index + with \ref setCell. This is the fastest method. Alternatively, they can be addressed by their plot + coordinate with \ref setData. plot coordinate to cell index transformations and vice versa are + provided by the functions \ref coordToCell and \ref cellToCoord. + + This class also buffers the minimum and maximum values that are in the data set, to provide + QCPColorMap::rescaleDataRange with the necessary information quickly. Setting a cell to a value + that is greater than the current maximum increases this maximum to the new value. However, + setting the cell that currently holds the maximum value to a smaller value doesn't decrease the + maximum again, because finding the true new maximum would require going through the entire data + array, which might be time consuming. The same holds for the data minimum. This functionality is + given by \ref recalculateDataBounds, such that you can decide when it is sensible to find the + true current minimum and maximum. The method QCPColorMap::rescaleDataRange offers a convenience + parameter \a recalculateDataBounds which may be set to true to automatically call \ref + recalculateDataBounds internally. +*/ + +/* start of documentation of inline functions */ + +/*! \fn bool QCPColorMapData::isEmpty() const + + Returns whether this instance carries no data. This is equivalent to having a size where at least + one of the dimensions is 0 (see \ref setSize). +*/ + +/* end of documentation of inline functions */ + +/*! + Constructs a new QCPColorMapData instance. The instance has \a keySize cells in the key direction + and \a valueSize cells in the value direction. These cells will be displayed by the \ref QCPColorMap + at the coordinates \a keyRange and \a valueRange. + + \see setSize, setKeySize, setValueSize, setRange, setKeyRange, setValueRange +*/ +QCPColorMapData::QCPColorMapData(int keySize, int valueSize, const QCPRange &keyRange, const QCPRange &valueRange) : + mKeySize(0), + mValueSize(0), + mKeyRange(keyRange), + mValueRange(valueRange), + mIsEmpty(true), + mData(0), + mDataModified(true) +{ + setSize(keySize, valueSize); + fill(0); +} + +QCPColorMapData::~QCPColorMapData() +{ + if (mData) + delete[] mData; +} + +/*! + Constructs a new QCPColorMapData instance copying the data and range of \a other. +*/ +QCPColorMapData::QCPColorMapData(const QCPColorMapData &other) : + mKeySize(0), + mValueSize(0), + mIsEmpty(true), + mData(0), + mDataModified(true) +{ + *this = other; +} + +/*! + Overwrites this color map data instance with the data stored in \a other. +*/ +QCPColorMapData &QCPColorMapData::operator=(const QCPColorMapData &other) +{ + if (&other != this) + { + const int keySize = other.keySize(); + const int valueSize = other.valueSize(); + setSize(keySize, valueSize); + setRange(other.keyRange(), other.valueRange()); + if (!mIsEmpty) + memcpy(mData, other.mData, sizeof(mData[0])*keySize*valueSize); + mDataBounds = other.mDataBounds; + mDataModified = true; + } + return *this; +} + +/* undocumented getter */ +double QCPColorMapData::data(double key, double value) +{ + int keyCell = (key-mKeyRange.lower)/(mKeyRange.upper-mKeyRange.lower)*(mKeySize-1)+0.5; + int valueCell = (value-mValueRange.lower)/(mValueRange.upper-mValueRange.lower)*(mValueSize-1)+0.5; + if (keyCell >= 0 && keyCell < mKeySize && valueCell >= 0 && valueCell < mValueSize) + return mData[valueCell*mKeySize + keyCell]; + else + return 0; +} + +/* undocumented getter */ +double QCPColorMapData::cell(int keyIndex, int valueIndex) +{ + if (keyIndex >= 0 && keyIndex < mKeySize && valueIndex >= 0 && valueIndex < mValueSize) + return mData[valueIndex*mKeySize + keyIndex]; + else + return 0; +} + +/*! + Resizes the data array to have \a keySize cells in the key dimension and \a valueSize cells in + the value dimension. + + The current data is discarded and the map cells are set to 0, unless the map had already the + requested size. + + Setting at least one of \a keySize or \a valueSize to zero frees the internal data array and \ref + isEmpty returns true. + + \see setRange, setKeySize, setValueSize +*/ +void QCPColorMapData::setSize(int keySize, int valueSize) +{ + if (keySize != mKeySize || valueSize != mValueSize) + { + mKeySize = keySize; + mValueSize = valueSize; + if (mData) + delete[] mData; + mIsEmpty = mKeySize == 0 || mValueSize == 0; + if (!mIsEmpty) + { +#ifdef __EXCEPTIONS + try { // 2D arrays get memory intensive fast. So if the allocation fails, at least output debug message +#endif + mData = new double[mKeySize*mValueSize]; +#ifdef __EXCEPTIONS + } catch (...) { mData = 0; } +#endif + if (mData) + fill(0); + else + qDebug() << Q_FUNC_INFO << "out of memory for data dimensions "<< mKeySize << "*" << mValueSize; + } else + mData = 0; + mDataModified = true; + } +} + +/*! + Resizes the data array to have \a keySize cells in the key dimension. + + The current data is discarded and the map cells are set to 0, unless the map had already the + requested size. + + Setting \a keySize to zero frees the internal data array and \ref isEmpty returns true. + + \see setKeyRange, setSize, setValueSize +*/ +void QCPColorMapData::setKeySize(int keySize) +{ + setSize(keySize, mValueSize); +} + +/*! + Resizes the data array to have \a valueSize cells in the value dimension. + + The current data is discarded and the map cells are set to 0, unless the map had already the + requested size. + + Setting \a valueSize to zero frees the internal data array and \ref isEmpty returns true. + + \see setValueRange, setSize, setKeySize +*/ +void QCPColorMapData::setValueSize(int valueSize) +{ + setSize(mKeySize, valueSize); +} + +/*! + Sets the coordinate ranges the data shall be distributed over. This defines the rectangular area + covered by the color map in plot coordinates. + + The outer cells will be centered on the range boundaries given to this function. For example, if + the key size (\ref setKeySize) is 3 and \a keyRange is set to QCPRange(2, 3) there will + be cells centered on the key coordinates 2, 2.5 and 3. + + \see setSize +*/ +void QCPColorMapData::setRange(const QCPRange &keyRange, const QCPRange &valueRange) +{ + setKeyRange(keyRange); + setValueRange(valueRange); +} + +/*! + Sets the coordinate range the data shall be distributed over in the key dimension. Together with + the value range, This defines the rectangular area covered by the color map in plot coordinates. + + The outer cells will be centered on the range boundaries given to this function. For example, if + the key size (\ref setKeySize) is 3 and \a keyRange is set to QCPRange(2, 3) there will + be cells centered on the key coordinates 2, 2.5 and 3. + + \see setRange, setValueRange, setSize +*/ +void QCPColorMapData::setKeyRange(const QCPRange &keyRange) +{ + mKeyRange = keyRange; +} + +/*! + Sets the coordinate range the data shall be distributed over in the value dimension. Together with + the key range, This defines the rectangular area covered by the color map in plot coordinates. + + The outer cells will be centered on the range boundaries given to this function. For example, if + the value size (\ref setValueSize) is 3 and \a valueRange is set to QCPRange(2, 3) there + will be cells centered on the value coordinates 2, 2.5 and 3. + + \see setRange, setKeyRange, setSize +*/ +void QCPColorMapData::setValueRange(const QCPRange &valueRange) +{ + mValueRange = valueRange; +} + +/*! + Sets the data of the cell, which lies at the plot coordinates given by \a key and \a value, to \a + z. + + \note The QCPColorMap always displays the data at equal key/value intervals, even if the key or + value axis is set to a logarithmic scaling. If you want to use QCPColorMap with logarithmic axes, + you shouldn't use the \ref QCPColorMapData::setData method as it uses a linear transformation to + determine the cell index. Rather directly access the cell index with \ref + QCPColorMapData::setCell. + + \see setCell, setRange +*/ +void QCPColorMapData::setData(double key, double value, double z) +{ + int keyCell = (key-mKeyRange.lower)/(mKeyRange.upper-mKeyRange.lower)*(mKeySize-1)+0.5; + int valueCell = (value-mValueRange.lower)/(mValueRange.upper-mValueRange.lower)*(mValueSize-1)+0.5; + if (keyCell >= 0 && keyCell < mKeySize && valueCell >= 0 && valueCell < mValueSize) + { + mData[valueCell*mKeySize + keyCell] = z; + if (z < mDataBounds.lower) + mDataBounds.lower = z; + if (z > mDataBounds.upper) + mDataBounds.upper = z; + mDataModified = true; + } +} + +/*! + Sets the data of the cell with indices \a keyIndex and \a valueIndex to \a z. The indices + enumerate the cells starting from zero, up to the map's size-1 in the respective dimension (see + \ref setSize). + + In the standard plot configuration (horizontal key axis and vertical value axis, both not + range-reversed), the cell with indices (0, 0) is in the bottom left corner and the cell with + indices (keySize-1, valueSize-1) is in the top right corner of the color map. + + \see setData, setSize +*/ +void QCPColorMapData::setCell(int keyIndex, int valueIndex, double z) +{ + if (keyIndex >= 0 && keyIndex < mKeySize && valueIndex >= 0 && valueIndex < mValueSize) + { + mData[valueIndex*mKeySize + keyIndex] = z; + if (z < mDataBounds.lower) + mDataBounds.lower = z; + if (z > mDataBounds.upper) + mDataBounds.upper = z; + mDataModified = true; + } +} + +/*! + Goes through the data and updates the buffered minimum and maximum data values. + + Calling this method is only advised if you are about to call \ref QCPColorMap::rescaleDataRange + and can not guarantee that the cells holding the maximum or minimum data haven't been overwritten + with a smaller or larger value respectively, since the buffered maximum/minimum values have been + updated the last time. Why this is the case is explained in the class description (\ref + QCPColorMapData). + + Note that the method \ref QCPColorMap::rescaleDataRange provides a parameter \a + recalculateDataBounds for convenience. Setting this to true will call this method for you, before + doing the rescale. +*/ +void QCPColorMapData::recalculateDataBounds() +{ + if (mKeySize > 0 && mValueSize > 0) + { + double minHeight = mData[0]; + double maxHeight = mData[0]; + const int dataCount = mValueSize*mKeySize; + for (int i=0; i maxHeight) + maxHeight = mData[i]; + if (mData[i] < minHeight) + minHeight = mData[i]; + } + mDataBounds.lower = minHeight; + mDataBounds.upper = maxHeight; + } +} + +/*! + Frees the internal data memory. + + This is equivalent to calling \ref setSize "setSize(0, 0)". +*/ +void QCPColorMapData::clear() +{ + setSize(0, 0); +} + +/*! + Sets all cells to the value \a z. +*/ +void QCPColorMapData::fill(double z) +{ + const int dataCount = mValueSize*mKeySize; + for (int i=0; i(data); + return; + } + if (copy) + { + *mMapData = *data; + } else + { + delete mMapData; + mMapData = data; + } + mMapImageInvalidated = true; +} + +/*! + Sets the data range of this color map to \a dataRange. The data range defines which data values + are mapped to the color gradient. + + To make the data range span the full range of the data set, use \ref rescaleDataRange. + + \see QCPColorScale::setDataRange +*/ +void QCPColorMap::setDataRange(const QCPRange &dataRange) +{ + if (!QCPRange::validRange(dataRange)) return; + if (mDataRange.lower != dataRange.lower || mDataRange.upper != dataRange.upper) + { + if (mDataScaleType == QCPAxis::stLogarithmic) + mDataRange = dataRange.sanitizedForLogScale(); + else + mDataRange = dataRange.sanitizedForLinScale(); + mMapImageInvalidated = true; + emit dataRangeChanged(mDataRange); + } +} + +/*! + Sets whether the data is correlated with the color gradient linearly or logarithmically. + + \see QCPColorScale::setDataScaleType +*/ +void QCPColorMap::setDataScaleType(QCPAxis::ScaleType scaleType) +{ + if (mDataScaleType != scaleType) + { + mDataScaleType = scaleType; + mMapImageInvalidated = true; + emit dataScaleTypeChanged(mDataScaleType); + if (mDataScaleType == QCPAxis::stLogarithmic) + setDataRange(mDataRange.sanitizedForLogScale()); + } +} + +/*! + Sets the color gradient that is used to represent the data. For more details on how to create an + own gradient or use one of the preset gradients, see \ref QCPColorGradient. + + The colors defined by the gradient will be used to represent data values in the currently set + data range, see \ref setDataRange. Data points that are outside this data range will either be + colored uniformly with the respective gradient boundary color, or the gradient will repeat, + depending on \ref QCPColorGradient::setPeriodic. + + \see QCPColorScale::setGradient +*/ +void QCPColorMap::setGradient(const QCPColorGradient &gradient) +{ + if (mGradient != gradient) + { + mGradient = gradient; + mMapImageInvalidated = true; + emit gradientChanged(mGradient); + } +} + +/*! + Sets whether the color map image shall use bicubic interpolation when displaying the color map + shrinked or expanded, and not at a 1:1 pixel-to-data scale. + + \image html QCPColorMap-interpolate.png "A 10*10 color map, with interpolation and without interpolation enabled" +*/ +void QCPColorMap::setInterpolate(bool enabled) +{ + mInterpolate = enabled; + mMapImageInvalidated = true; // because oversampling factors might need to change +} + +/*! + Sets whether the outer most data rows and columns are clipped to the specified key and value + range (see \ref QCPColorMapData::setKeyRange, \ref QCPColorMapData::setValueRange). + + if \a enabled is set to false, the data points at the border of the color map are drawn with the + same width and height as all other data points. Since the data points are represented by + rectangles of one color centered on the data coordinate, this means that the shown color map + extends by half a data point over the specified key/value range in each direction. + + \image html QCPColorMap-tightboundary.png "A color map, with tight boundary enabled and disabled" +*/ +void QCPColorMap::setTightBoundary(bool enabled) +{ + mTightBoundary = enabled; +} + +/*! + Associates the color scale \a colorScale with this color map. + + This means that both the color scale and the color map synchronize their gradient, data range and + data scale type (\ref setGradient, \ref setDataRange, \ref setDataScaleType). Multiple color maps + can be associated with one single color scale. This causes the color maps to also synchronize + those properties, via the mutual color scale. + + This function causes the color map to adopt the current color gradient, data range and data scale + type of \a colorScale. After this call, you may change these properties at either the color map + or the color scale, and the setting will be applied to both. + + Pass 0 as \a colorScale to disconnect the color scale from this color map again. +*/ +void QCPColorMap::setColorScale(QCPColorScale *colorScale) +{ + if (mColorScale) // unconnect signals from old color scale + { + disconnect(this, SIGNAL(dataRangeChanged(QCPRange)), mColorScale.data(), SLOT(setDataRange(QCPRange))); + disconnect(this, SIGNAL(dataScaleTypeChanged(QCPAxis::ScaleType)), mColorScale.data(), SLOT(setDataScaleType(QCPAxis::ScaleType))); + disconnect(this, SIGNAL(gradientChanged(QCPColorGradient)), mColorScale.data(), SLOT(setGradient(QCPColorGradient))); + disconnect(mColorScale.data(), SIGNAL(dataRangeChanged(QCPRange)), this, SLOT(setDataRange(QCPRange))); + disconnect(mColorScale.data(), SIGNAL(gradientChanged(QCPColorGradient)), this, SLOT(setGradient(QCPColorGradient))); + disconnect(mColorScale.data(), SIGNAL(dataScaleTypeChanged(QCPAxis::ScaleType)), this, SLOT(setDataScaleType(QCPAxis::ScaleType))); + } + mColorScale = colorScale; + if (mColorScale) // connect signals to new color scale + { + setGradient(mColorScale.data()->gradient()); + setDataRange(mColorScale.data()->dataRange()); + setDataScaleType(mColorScale.data()->dataScaleType()); + connect(this, SIGNAL(dataRangeChanged(QCPRange)), mColorScale.data(), SLOT(setDataRange(QCPRange))); + connect(this, SIGNAL(dataScaleTypeChanged(QCPAxis::ScaleType)), mColorScale.data(), SLOT(setDataScaleType(QCPAxis::ScaleType))); + connect(this, SIGNAL(gradientChanged(QCPColorGradient)), mColorScale.data(), SLOT(setGradient(QCPColorGradient))); + connect(mColorScale.data(), SIGNAL(dataRangeChanged(QCPRange)), this, SLOT(setDataRange(QCPRange))); + connect(mColorScale.data(), SIGNAL(gradientChanged(QCPColorGradient)), this, SLOT(setGradient(QCPColorGradient))); + connect(mColorScale.data(), SIGNAL(dataScaleTypeChanged(QCPAxis::ScaleType)), this, SLOT(setDataScaleType(QCPAxis::ScaleType))); + } +} + +/*! + Sets the data range (\ref setDataRange) to span the minimum and maximum values that occur in the + current data set. This corresponds to the \ref rescaleKeyAxis or \ref rescaleValueAxis methods, + only for the third data dimension of the color map. + + The minimum and maximum values of the data set are buffered in the internal QCPColorMapData + instance (\ref data). As data is updated via its \ref QCPColorMapData::setCell or \ref + QCPColorMapData::setData, the buffered minimum and maximum values are updated, too. For + performance reasons, however, they are only updated in an expanding fashion. So the buffered + maximum can only increase and the buffered minimum can only decrease. In consequence, changes to + the data that actually lower the maximum of the data set (by overwriting the cell holding the + current maximum with a smaller value), aren't recognized and the buffered maximum overestimates + the true maximum of the data set. The same happens for the buffered minimum. To recalculate the + true minimum and maximum by explicitly looking at each cell, the method + QCPColorMapData::recalculateDataBounds can be used. For convenience, setting the parameter \a + recalculateDataBounds calls this method before setting the data range to the buffered minimum and + maximum. + + \see setDataRange +*/ +void QCPColorMap::rescaleDataRange(bool recalculateDataBounds) +{ + if (recalculateDataBounds) + mMapData->recalculateDataBounds(); + setDataRange(mMapData->dataBounds()); +} + +/*! + Takes the current appearance of the color map and updates the legend icon, which is used to + represent this color map in the legend (see \ref QCPLegend). + + The \a transformMode specifies whether the rescaling is done by a faster, low quality image + scaling algorithm (Qt::FastTransformation) or by a slower, higher quality algorithm + (Qt::SmoothTransformation). + + The current color map appearance is scaled down to \a thumbSize. Ideally, this should be equal to + the size of the legend icon (see \ref QCPLegend::setIconSize). If it isn't exactly the configured + legend icon size, the thumb will be rescaled during drawing of the legend item. + + \see setDataRange +*/ +void QCPColorMap::updateLegendIcon(Qt::TransformationMode transformMode, const QSize &thumbSize) +{ + if (mMapImage.isNull() && !data()->isEmpty()) + updateMapImage(); // try to update map image if it's null (happens if no draw has happened yet) + + if (!mMapImage.isNull()) // might still be null, e.g. if data is empty, so check here again + { + bool mirrorX = (keyAxis()->orientation() == Qt::Horizontal ? keyAxis() : valueAxis())->rangeReversed(); + bool mirrorY = (valueAxis()->orientation() == Qt::Vertical ? valueAxis() : keyAxis())->rangeReversed(); + mLegendIcon = QPixmap::fromImage(mMapImage.mirrored(mirrorX, mirrorY)).scaled(thumbSize, Qt::KeepAspectRatio, transformMode); + } +} + +/*! + Clears the colormap data by calling \ref QCPColorMapData::clear() on the internal data. This also + resizes the map to 0x0 cells. +*/ +void QCPColorMap::clearData() +{ + mMapData->clear(); +} + +/* inherits documentation from base class */ +double QCPColorMap::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + if (!mKeyAxis || !mValueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return -1; } + + if (mKeyAxis.data()->axisRect()->rect().contains(pos.toPoint())) + { + double posKey, posValue; + pixelsToCoords(pos, posKey, posValue); + if (mMapData->keyRange().contains(posKey) && mMapData->valueRange().contains(posValue)) + return mParentPlot->selectionTolerance()*0.99; + } + return -1; +} + +/*! \internal + + Updates the internal map image buffer by going through the internal \ref QCPColorMapData and + turning the data values into color pixels with \ref QCPColorGradient::colorize. + + This method is called by \ref QCPColorMap::draw if either the data has been modified or the map image + has been invalidated for a different reason (e.g. a change of the data range with \ref + setDataRange). + + If the map cell count is low, the image created will be oversampled in order to avoid a + QPainter::drawImage bug which makes inner pixel boundaries jitter when stretch-drawing images + without smooth transform enabled. Accordingly, oversampling isn't performed if \ref + setInterpolate is true. +*/ +void QCPColorMap::updateMapImage() +{ + QCPAxis *keyAxis = mKeyAxis.data(); + if (!keyAxis) return; + if (mMapData->isEmpty()) return; + + const int keySize = mMapData->keySize(); + const int valueSize = mMapData->valueSize(); + int keyOversamplingFactor = mInterpolate ? 1 : (int)(1.0+100.0/(double)keySize); // make mMapImage have at least size 100, factor becomes 1 if size > 200 or interpolation is on + int valueOversamplingFactor = mInterpolate ? 1 : (int)(1.0+100.0/(double)valueSize); // make mMapImage have at least size 100, factor becomes 1 if size > 200 or interpolation is on + + // resize mMapImage to correct dimensions including possible oversampling factors, according to key/value axes orientation: + if (keyAxis->orientation() == Qt::Horizontal && (mMapImage.width() != keySize*keyOversamplingFactor || mMapImage.height() != valueSize*valueOversamplingFactor)) + mMapImage = QImage(QSize(keySize*keyOversamplingFactor, valueSize*valueOversamplingFactor), QImage::Format_RGB32); + else if (keyAxis->orientation() == Qt::Vertical && (mMapImage.width() != valueSize*valueOversamplingFactor || mMapImage.height() != keySize*keyOversamplingFactor)) + mMapImage = QImage(QSize(valueSize*valueOversamplingFactor, keySize*keyOversamplingFactor), QImage::Format_RGB32); + + QImage *localMapImage = &mMapImage; // this is the image on which the colorization operates. Either the final mMapImage, or if we need oversampling, mUndersampledMapImage + if (keyOversamplingFactor > 1 || valueOversamplingFactor > 1) + { + // resize undersampled map image to actual key/value cell sizes: + if (keyAxis->orientation() == Qt::Horizontal && (mUndersampledMapImage.width() != keySize || mUndersampledMapImage.height() != valueSize)) + mUndersampledMapImage = QImage(QSize(keySize, valueSize), QImage::Format_RGB32); + else if (keyAxis->orientation() == Qt::Vertical && (mUndersampledMapImage.width() != valueSize || mUndersampledMapImage.height() != keySize)) + mUndersampledMapImage = QImage(QSize(valueSize, keySize), QImage::Format_RGB32); + localMapImage = &mUndersampledMapImage; // make the colorization run on the undersampled image + } else if (!mUndersampledMapImage.isNull()) + mUndersampledMapImage = QImage(); // don't need oversampling mechanism anymore (map size has changed) but mUndersampledMapImage still has nonzero size, free it + + const double *rawData = mMapData->mData; + if (keyAxis->orientation() == Qt::Horizontal) + { + const int lineCount = valueSize; + const int rowCount = keySize; + for (int line=0; line(localMapImage->scanLine(lineCount-1-line)); // invert scanline index because QImage counts scanlines from top, but our vertical index counts from bottom (mathematical coordinate system) + mGradient.colorize(rawData+line*rowCount, mDataRange, pixels, rowCount, 1, mDataScaleType==QCPAxis::stLogarithmic); + } + } else // keyAxis->orientation() == Qt::Vertical + { + const int lineCount = keySize; + const int rowCount = valueSize; + for (int line=0; line(localMapImage->scanLine(lineCount-1-line)); // invert scanline index because QImage counts scanlines from top, but our vertical index counts from bottom (mathematical coordinate system) + mGradient.colorize(rawData+line, mDataRange, pixels, rowCount, lineCount, mDataScaleType==QCPAxis::stLogarithmic); + } + } + + if (keyOversamplingFactor > 1 || valueOversamplingFactor > 1) + { + if (keyAxis->orientation() == Qt::Horizontal) + mMapImage = mUndersampledMapImage.scaled(keySize*keyOversamplingFactor, valueSize*valueOversamplingFactor, Qt::IgnoreAspectRatio, Qt::FastTransformation); + else + mMapImage = mUndersampledMapImage.scaled(valueSize*valueOversamplingFactor, keySize*keyOversamplingFactor, Qt::IgnoreAspectRatio, Qt::FastTransformation); + } + mMapData->mDataModified = false; + mMapImageInvalidated = false; +} + +/* inherits documentation from base class */ +void QCPColorMap::draw(QCPPainter *painter) +{ + if (mMapData->isEmpty()) return; + if (!mKeyAxis || !mValueAxis) return; + applyDefaultAntialiasingHint(painter); + + if (mMapData->mDataModified || mMapImageInvalidated) + updateMapImage(); + + // use buffer if painting vectorized (PDF): + bool useBuffer = painter->modes().testFlag(QCPPainter::pmVectorized); + QCPPainter *localPainter = painter; // will be redirected to paint on mapBuffer if painting vectorized + QRectF mapBufferTarget; // the rect in absolute widget coordinates where the visible map portion/buffer will end up in + QPixmap mapBuffer; + double mapBufferPixelRatio = 3; // factor by which DPI is increased in embedded bitmaps + if (useBuffer) + { + mapBufferTarget = painter->clipRegion().boundingRect(); + mapBuffer = QPixmap((mapBufferTarget.size()*mapBufferPixelRatio).toSize()); + mapBuffer.fill(Qt::transparent); + localPainter = new QCPPainter(&mapBuffer); + localPainter->scale(mapBufferPixelRatio, mapBufferPixelRatio); + localPainter->translate(-mapBufferTarget.topLeft()); + } + + QRectF imageRect = QRectF(coordsToPixels(mMapData->keyRange().lower, mMapData->valueRange().lower), + coordsToPixels(mMapData->keyRange().upper, mMapData->valueRange().upper)).normalized(); + // extend imageRect to contain outer halves/quarters of bordering/cornering pixels (cells are centered on map range boundary): + double halfCellWidth = 0; // in pixels + double halfCellHeight = 0; // in pixels + if (keyAxis()->orientation() == Qt::Horizontal) + { + if (mMapData->keySize() > 1) + halfCellWidth = 0.5*imageRect.width()/(double)(mMapData->keySize()-1); + if (mMapData->valueSize() > 1) + halfCellHeight = 0.5*imageRect.height()/(double)(mMapData->valueSize()-1); + } else // keyAxis orientation is Qt::Vertical + { + if (mMapData->keySize() > 1) + halfCellHeight = 0.5*imageRect.height()/(double)(mMapData->keySize()-1); + if (mMapData->valueSize() > 1) + halfCellWidth = 0.5*imageRect.width()/(double)(mMapData->valueSize()-1); + } + imageRect.adjust(-halfCellWidth, -halfCellHeight, halfCellWidth, halfCellHeight); + bool mirrorX = (keyAxis()->orientation() == Qt::Horizontal ? keyAxis() : valueAxis())->rangeReversed(); + bool mirrorY = (valueAxis()->orientation() == Qt::Vertical ? valueAxis() : keyAxis())->rangeReversed(); + bool smoothBackup = localPainter->renderHints().testFlag(QPainter::SmoothPixmapTransform); + localPainter->setRenderHint(QPainter::SmoothPixmapTransform, mInterpolate); + QRegion clipBackup; + if (mTightBoundary) + { + clipBackup = localPainter->clipRegion(); + QRectF tightClipRect = QRectF(coordsToPixels(mMapData->keyRange().lower, mMapData->valueRange().lower), + coordsToPixels(mMapData->keyRange().upper, mMapData->valueRange().upper)).normalized(); + localPainter->setClipRect(tightClipRect, Qt::IntersectClip); + } + localPainter->drawImage(imageRect, mMapImage.mirrored(mirrorX, mirrorY)); + if (mTightBoundary) + localPainter->setClipRegion(clipBackup); + localPainter->setRenderHint(QPainter::SmoothPixmapTransform, smoothBackup); + + if (useBuffer) // localPainter painted to mapBuffer, so now draw buffer with original painter + { + delete localPainter; + painter->drawPixmap(mapBufferTarget.toRect(), mapBuffer); + } +} + +/* inherits documentation from base class */ +void QCPColorMap::drawLegendIcon(QCPPainter *painter, const QRectF &rect) const +{ + applyDefaultAntialiasingHint(painter); + // draw map thumbnail: + if (!mLegendIcon.isNull()) + { + QPixmap scaledIcon = mLegendIcon.scaled(rect.size().toSize(), Qt::KeepAspectRatio, Qt::FastTransformation); + QRectF iconRect = QRectF(0, 0, scaledIcon.width(), scaledIcon.height()); + iconRect.moveCenter(rect.center()); + painter->drawPixmap(iconRect.topLeft(), scaledIcon); + } + /* + // draw frame: + painter->setBrush(Qt::NoBrush); + painter->setPen(Qt::black); + painter->drawRect(rect.adjusted(1, 1, 0, 0)); + */ +} + +/* inherits documentation from base class */ +QCPRange QCPColorMap::getKeyRange(bool &foundRange, SignDomain inSignDomain) const +{ + foundRange = true; + QCPRange result = mMapData->keyRange(); + result.normalize(); + if (inSignDomain == QCPAbstractPlottable::sdPositive) + { + if (result.lower <= 0 && result.upper > 0) + result.lower = result.upper*1e-3; + else if (result.lower <= 0 && result.upper <= 0) + foundRange = false; + } else if (inSignDomain == QCPAbstractPlottable::sdNegative) + { + if (result.upper >= 0 && result.lower < 0) + result.upper = result.lower*1e-3; + else if (result.upper >= 0 && result.lower >= 0) + foundRange = false; + } + return result; +} + +/* inherits documentation from base class */ +QCPRange QCPColorMap::getValueRange(bool &foundRange, SignDomain inSignDomain) const +{ + foundRange = true; + QCPRange result = mMapData->valueRange(); + result.normalize(); + if (inSignDomain == QCPAbstractPlottable::sdPositive) + { + if (result.lower <= 0 && result.upper > 0) + result.lower = result.upper*1e-3; + else if (result.lower <= 0 && result.upper <= 0) + foundRange = false; + } else if (inSignDomain == QCPAbstractPlottable::sdNegative) + { + if (result.upper >= 0 && result.lower < 0) + result.upper = result.lower*1e-3; + else if (result.upper >= 0 && result.lower >= 0) + foundRange = false; + } + return result; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPFinancialData +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPFinancialData + \brief Holds the data of one single data point for QCPFinancial. + + The container for storing multiple data points is \ref QCPFinancialDataMap. + + The stored data is: + \li \a key: coordinate on the key axis of this data point + \li \a open: The opening value at the data point + \li \a high: The high/maximum value at the data point + \li \a low: The low/minimum value at the data point + \li \a close: The closing value at the data point + + \see QCPFinancialDataMap +*/ + +/*! + Constructs a data point with key and all values set to zero. +*/ +QCPFinancialData::QCPFinancialData() : + key(0), + open(0), + high(0), + low(0), + close(0) +{ +} + +/*! + Constructs a data point with the specified \a key and OHLC values. +*/ +QCPFinancialData::QCPFinancialData(double key, double open, double high, double low, double close) : + key(key), + open(open), + high(high), + low(low), + close(close) +{ +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPFinancial +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPFinancial + \brief A plottable representing a financial stock chart + + \image html QCPFinancial.png + + This plottable represents time series data binned to certain intervals, mainly used for stock + charts. The two common representations OHLC (Open-High-Low-Close) bars and Candlesticks can be + set via \ref setChartStyle. + + The data is passed via \ref setData as a set of open/high/low/close values at certain keys + (typically times). This means the data must be already binned appropriately. If data is only + available as a series of values (e.g. \a price against \a time), you can use the static + convenience function \ref timeSeriesToOhlc to generate binned OHLC-data which can then be passed + to \ref setData. + + The width of the OHLC bars/candlesticks can be controlled with \ref setWidth and is given in plot + key coordinates. A typical choice is to set it to (or slightly less than) one bin interval width. + + \section appearance Changing the appearance + + Charts can be either single- or two-colored (\ref setTwoColored). If set to be single-colored, + lines are drawn with the plottable's pen (\ref setPen) and fills with the brush (\ref setBrush). + + If set to two-colored, positive changes of the value during an interval (\a close >= \a open) are + represented with a different pen and brush than negative changes (\a close < \a open). These can + be configured with \ref setPenPositive, \ref setPenNegative, \ref setBrushPositive, and \ref + setBrushNegative. In two-colored mode, the normal plottable pen/brush is ignored. Upon selection + however, the normal selected pen/brush (\ref setSelectedPen, \ref setSelectedBrush) is used, + irrespective of whether the chart is single- or two-colored. + +*/ + +/* start of documentation of inline functions */ + +/*! \fn QCPFinancialDataMap *QCPFinancial::data() const + + Returns a pointer to the internal data storage of type \ref QCPFinancialDataMap. You may use it to + directly manipulate the data, which may be more convenient and faster than using the regular \ref + setData or \ref addData methods, in certain situations. +*/ + +/* end of documentation of inline functions */ + +/*! + Constructs a financial chart which uses \a keyAxis as its key axis ("x") and \a valueAxis as its value + axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance and not have + the same orientation. If either of these restrictions is violated, a corresponding message is + printed to the debug output (qDebug), the construction is not aborted, though. + + The constructed QCPFinancial can be added to the plot with QCustomPlot::addPlottable, QCustomPlot + then takes ownership of the financial chart. +*/ +QCPFinancial::QCPFinancial(QCPAxis *keyAxis, QCPAxis *valueAxis) : + QCPAbstractPlottable(keyAxis, valueAxis), + mData(0), + mChartStyle(csOhlc), + mWidth(0.5), + mTwoColored(false), + mBrushPositive(QBrush(QColor(210, 210, 255))), + mBrushNegative(QBrush(QColor(255, 210, 210))), + mPenPositive(QPen(QColor(10, 40, 180))), + mPenNegative(QPen(QColor(180, 40, 10))) +{ + mData = new QCPFinancialDataMap; + + setSelectedPen(QPen(QColor(80, 80, 255), 2.5)); + setSelectedBrush(QBrush(QColor(80, 80, 255))); +} + +QCPFinancial::~QCPFinancial() +{ + delete mData; +} + +/*! + Replaces the current data with the provided \a data. + + If \a copy is set to true, data points in \a data will only be copied. if false, the plottable + takes ownership of the passed data and replaces the internal data pointer with it. This is + significantly faster than copying for large datasets. + + Alternatively, you can also access and modify the plottable's data via the \ref data method, which + returns a pointer to the internal \ref QCPFinancialDataMap. + + \see timeSeriesToOhlc +*/ +void QCPFinancial::setData(QCPFinancialDataMap *data, bool copy) +{ + if (mData == data) + { + qDebug() << Q_FUNC_INFO << "The data pointer is already in (and owned by) this plottable" << reinterpret_cast(data); + return; + } + if (copy) + { + *mData = *data; + } else + { + delete mData; + mData = data; + } +} + +/*! \overload + + Replaces the current data with the provided open/high/low/close data. The provided vectors should + have equal length. Else, the number of added points will be the size of the smallest vector. + + \see timeSeriesToOhlc +*/ +void QCPFinancial::setData(const QVector &key, const QVector &open, const QVector &high, const QVector &low, const QVector &close) +{ + mData->clear(); + int n = key.size(); + n = qMin(n, open.size()); + n = qMin(n, high.size()); + n = qMin(n, low.size()); + n = qMin(n, close.size()); + for (int i=0; iinsertMulti(key[i], QCPFinancialData(key[i], open[i], high[i], low[i], close[i])); + } +} + +/*! + Sets which representation style shall be used to display the OHLC data. +*/ +void QCPFinancial::setChartStyle(QCPFinancial::ChartStyle style) +{ + mChartStyle = style; +} + +/*! + Sets the width of the individual bars/candlesticks to \a width in plot key coordinates. + + A typical choice is to set it to (or slightly less than) one bin interval width. +*/ +void QCPFinancial::setWidth(double width) +{ + mWidth = width; +} + +/*! + Sets whether this chart shall contrast positive from negative trends per data point by using two + separate colors to draw the respective bars/candlesticks. + + If \a twoColored is false, the normal plottable's pen and brush are used (\ref setPen, \ref + setBrush). + + \see setPenPositive, setPenNegative, setBrushPositive, setBrushNegative +*/ +void QCPFinancial::setTwoColored(bool twoColored) +{ + mTwoColored = twoColored; +} + +/*! + If \ref setTwoColored is set to true, this function controls the brush that is used to draw fills + of data points with a positive trend (i.e. bars/candlesticks with close >= open). + + If \a twoColored is false, the normal plottable's pen and brush are used (\ref setPen, \ref + setBrush). + + \see setBrushNegative, setPenPositive, setPenNegative +*/ +void QCPFinancial::setBrushPositive(const QBrush &brush) +{ + mBrushPositive = brush; +} + +/*! + If \ref setTwoColored is set to true, this function controls the brush that is used to draw fills + of data points with a negative trend (i.e. bars/candlesticks with close < open). + + If \a twoColored is false, the normal plottable's pen and brush are used (\ref setPen, \ref + setBrush). + + \see setBrushPositive, setPenNegative, setPenPositive +*/ +void QCPFinancial::setBrushNegative(const QBrush &brush) +{ + mBrushNegative = brush; +} + +/*! + If \ref setTwoColored is set to true, this function controls the pen that is used to draw + outlines of data points with a positive trend (i.e. bars/candlesticks with close >= open). + + If \a twoColored is false, the normal plottable's pen and brush are used (\ref setPen, \ref + setBrush). + + \see setPenNegative, setBrushPositive, setBrushNegative +*/ +void QCPFinancial::setPenPositive(const QPen &pen) +{ + mPenPositive = pen; +} + +/*! + If \ref setTwoColored is set to true, this function controls the pen that is used to draw + outlines of data points with a negative trend (i.e. bars/candlesticks with close < open). + + If \a twoColored is false, the normal plottable's pen and brush are used (\ref setPen, \ref + setBrush). + + \see setPenPositive, setBrushNegative, setBrushPositive +*/ +void QCPFinancial::setPenNegative(const QPen &pen) +{ + mPenNegative = pen; +} + +/*! + Adds the provided data points in \a dataMap to the current data. + + Alternatively, you can also access and modify the data via the \ref data method, which returns a + pointer to the internal \ref QCPFinancialDataMap. + + \see removeData +*/ +void QCPFinancial::addData(const QCPFinancialDataMap &dataMap) +{ + mData->unite(dataMap); +} + +/*! \overload + + Adds the provided single data point in \a data to the current data. + + Alternatively, you can also access and modify the data via the \ref data method, which returns a + pointer to the internal \ref QCPFinancialData. + + \see removeData +*/ +void QCPFinancial::addData(const QCPFinancialData &data) +{ + mData->insertMulti(data.key, data); +} + +/*! \overload + + Adds the provided single data point given by \a key, \a open, \a high, \a low, and \a close to + the current data. + + Alternatively, you can also access and modify the data via the \ref data method, which returns a + pointer to the internal \ref QCPFinancialData. + + \see removeData +*/ +void QCPFinancial::addData(double key, double open, double high, double low, double close) +{ + mData->insertMulti(key, QCPFinancialData(key, open, high, low, close)); +} + +/*! \overload + + Adds the provided open/high/low/close data to the current data. + + Alternatively, you can also access and modify the data via the \ref data method, which returns a + pointer to the internal \ref QCPFinancialData. + + \see removeData +*/ +void QCPFinancial::addData(const QVector &key, const QVector &open, const QVector &high, const QVector &low, const QVector &close) +{ + int n = key.size(); + n = qMin(n, open.size()); + n = qMin(n, high.size()); + n = qMin(n, low.size()); + n = qMin(n, close.size()); + for (int i=0; iinsertMulti(key[i], QCPFinancialData(key[i], open[i], high[i], low[i], close[i])); + } +} + +/*! + Removes all data points with keys smaller than \a key. + + \see addData, clearData +*/ +void QCPFinancial::removeDataBefore(double key) +{ + QCPFinancialDataMap::iterator it = mData->begin(); + while (it != mData->end() && it.key() < key) + it = mData->erase(it); +} + +/*! + Removes all data points with keys greater than \a key. + + \see addData, clearData +*/ +void QCPFinancial::removeDataAfter(double key) +{ + if (mData->isEmpty()) return; + QCPFinancialDataMap::iterator it = mData->upperBound(key); + while (it != mData->end()) + it = mData->erase(it); +} + +/*! + Removes all data points with keys between \a fromKey and \a toKey. if \a fromKey is greater or + equal to \a toKey, the function does nothing. To remove a single data point with known key, use + \ref removeData(double key). + + \see addData, clearData +*/ +void QCPFinancial::removeData(double fromKey, double toKey) +{ + if (fromKey >= toKey || mData->isEmpty()) return; + QCPFinancialDataMap::iterator it = mData->upperBound(fromKey); + QCPFinancialDataMap::iterator itEnd = mData->upperBound(toKey); + while (it != itEnd) + it = mData->erase(it); +} + +/*! \overload + + Removes a single data point at \a key. If the position is not known with absolute precision, + consider using \ref removeData(double fromKey, double toKey) with a small fuzziness interval + around the suspected position, depeding on the precision with which the key is known. + + \see addData, clearData +*/ +void QCPFinancial::removeData(double key) +{ + mData->remove(key); +} + +/*! + Removes all data points. + + \see removeData, removeDataAfter, removeDataBefore +*/ +void QCPFinancial::clearData() +{ + mData->clear(); +} + +/* inherits documentation from base class */ +double QCPFinancial::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + if (!mKeyAxis || !mValueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return -1; } + + if (mKeyAxis.data()->axisRect()->rect().contains(pos.toPoint())) + { + // get visible data range: + QCPFinancialDataMap::const_iterator lower, upper; // note that upper is the actual upper point, and not 1 step after the upper point + getVisibleDataBounds(lower, upper); + if (lower == mData->constEnd() || upper == mData->constEnd()) + return -1; + // perform select test according to configured style: + switch (mChartStyle) + { + case QCPFinancial::csOhlc: + return ohlcSelectTest(pos, lower, upper+1); break; + case QCPFinancial::csCandlestick: + return candlestickSelectTest(pos, lower, upper+1); break; + } + } + return -1; +} + +/*! + A convenience function that converts time series data (\a value against \a time) to OHLC binned + data points. The return value can then be passed on to \ref setData. + + The size of the bins can be controlled with \a timeBinSize in the same units as \a time is given. + For example, if the unit of \a time is seconds and single OHLC/Candlesticks should span an hour + each, set \a timeBinSize to 3600. + + \a timeBinOffset allows to control precisely at what \a time coordinate a bin should start. The + value passed as \a timeBinOffset doesn't need to be in the range encompassed by the \a time keys. + It merely defines the mathematical offset/phase of the bins that will be used to process the + data. +*/ +QCPFinancialDataMap QCPFinancial::timeSeriesToOhlc(const QVector &time, const QVector &value, double timeBinSize, double timeBinOffset) +{ + QCPFinancialDataMap map; + int count = qMin(time.size(), value.size()); + if (count == 0) + return QCPFinancialDataMap(); + + QCPFinancialData currentBinData(0, value.first(), value.first(), value.first(), value.first()); + int currentBinIndex = qFloor((time.first()-timeBinOffset)/timeBinSize+0.5); + for (int i=0; i currentBinData.high) currentBinData.high = value.at(i); + if (i == count-1) // last data point is in current bin, finalize bin: + { + currentBinData.close = value.at(i); + currentBinData.key = timeBinOffset+(index)*timeBinSize; + map.insert(currentBinData.key, currentBinData); + } + } else // data point not anymore in current bin, set close of old and open of new bin, and add old to map: + { + // finalize current bin: + currentBinData.close = value.at(i-1); + currentBinData.key = timeBinOffset+(index-1)*timeBinSize; + map.insert(currentBinData.key, currentBinData); + // start next bin: + currentBinIndex = index; + currentBinData.open = value.at(i); + currentBinData.high = value.at(i); + currentBinData.low = value.at(i); + } + } + + return map; +} + +/* inherits documentation from base class */ +void QCPFinancial::draw(QCPPainter *painter) +{ + // get visible data range: + QCPFinancialDataMap::const_iterator lower, upper; // note that upper is the actual upper point, and not 1 step after the upper point + getVisibleDataBounds(lower, upper); + if (lower == mData->constEnd() || upper == mData->constEnd()) + return; + + // draw visible data range according to configured style: + switch (mChartStyle) + { + case QCPFinancial::csOhlc: + drawOhlcPlot(painter, lower, upper+1); break; + case QCPFinancial::csCandlestick: + drawCandlestickPlot(painter, lower, upper+1); break; + } +} + +/* inherits documentation from base class */ +void QCPFinancial::drawLegendIcon(QCPPainter *painter, const QRectF &rect) const +{ + painter->setAntialiasing(false); // legend icon especially of csCandlestick looks better without antialiasing + if (mChartStyle == csOhlc) + { + if (mTwoColored) + { + // draw upper left half icon with positive color: + painter->setBrush(mBrushPositive); + painter->setPen(mPenPositive); + painter->setClipRegion(QRegion(QPolygon() << rect.bottomLeft().toPoint() << rect.topRight().toPoint() << rect.topLeft().toPoint())); + painter->drawLine(QLineF(0, rect.height()*0.5, rect.width(), rect.height()*0.5).translated(rect.topLeft())); + painter->drawLine(QLineF(rect.width()*0.2, rect.height()*0.3, rect.width()*0.2, rect.height()*0.5).translated(rect.topLeft())); + painter->drawLine(QLineF(rect.width()*0.8, rect.height()*0.5, rect.width()*0.8, rect.height()*0.7).translated(rect.topLeft())); + // draw bottom right hald icon with negative color: + painter->setBrush(mBrushNegative); + painter->setPen(mPenNegative); + painter->setClipRegion(QRegion(QPolygon() << rect.bottomLeft().toPoint() << rect.topRight().toPoint() << rect.bottomRight().toPoint())); + painter->drawLine(QLineF(0, rect.height()*0.5, rect.width(), rect.height()*0.5).translated(rect.topLeft())); + painter->drawLine(QLineF(rect.width()*0.2, rect.height()*0.3, rect.width()*0.2, rect.height()*0.5).translated(rect.topLeft())); + painter->drawLine(QLineF(rect.width()*0.8, rect.height()*0.5, rect.width()*0.8, rect.height()*0.7).translated(rect.topLeft())); + } else + { + painter->setBrush(mBrush); + painter->setPen(mPen); + painter->drawLine(QLineF(0, rect.height()*0.5, rect.width(), rect.height()*0.5).translated(rect.topLeft())); + painter->drawLine(QLineF(rect.width()*0.2, rect.height()*0.3, rect.width()*0.2, rect.height()*0.5).translated(rect.topLeft())); + painter->drawLine(QLineF(rect.width()*0.8, rect.height()*0.5, rect.width()*0.8, rect.height()*0.7).translated(rect.topLeft())); + } + } else if (mChartStyle == csCandlestick) + { + if (mTwoColored) + { + // draw upper left half icon with positive color: + painter->setBrush(mBrushPositive); + painter->setPen(mPenPositive); + painter->setClipRegion(QRegion(QPolygon() << rect.bottomLeft().toPoint() << rect.topRight().toPoint() << rect.topLeft().toPoint())); + painter->drawLine(QLineF(0, rect.height()*0.5, rect.width()*0.25, rect.height()*0.5).translated(rect.topLeft())); + painter->drawLine(QLineF(rect.width()*0.75, rect.height()*0.5, rect.width(), rect.height()*0.5).translated(rect.topLeft())); + painter->drawRect(QRectF(rect.width()*0.25, rect.height()*0.25, rect.width()*0.5, rect.height()*0.5).translated(rect.topLeft())); + // draw bottom right hald icon with negative color: + painter->setBrush(mBrushNegative); + painter->setPen(mPenNegative); + painter->setClipRegion(QRegion(QPolygon() << rect.bottomLeft().toPoint() << rect.topRight().toPoint() << rect.bottomRight().toPoint())); + painter->drawLine(QLineF(0, rect.height()*0.5, rect.width()*0.25, rect.height()*0.5).translated(rect.topLeft())); + painter->drawLine(QLineF(rect.width()*0.75, rect.height()*0.5, rect.width(), rect.height()*0.5).translated(rect.topLeft())); + painter->drawRect(QRectF(rect.width()*0.25, rect.height()*0.25, rect.width()*0.5, rect.height()*0.5).translated(rect.topLeft())); + } else + { + painter->setBrush(mBrush); + painter->setPen(mPen); + painter->drawLine(QLineF(0, rect.height()*0.5, rect.width()*0.25, rect.height()*0.5).translated(rect.topLeft())); + painter->drawLine(QLineF(rect.width()*0.75, rect.height()*0.5, rect.width(), rect.height()*0.5).translated(rect.topLeft())); + painter->drawRect(QRectF(rect.width()*0.25, rect.height()*0.25, rect.width()*0.5, rect.height()*0.5).translated(rect.topLeft())); + } + } +} + +/* inherits documentation from base class */ +QCPRange QCPFinancial::getKeyRange(bool &foundRange, QCPAbstractPlottable::SignDomain inSignDomain) const +{ + QCPRange range; + bool haveLower = false; + bool haveUpper = false; + + double current; + QCPFinancialDataMap::const_iterator it = mData->constBegin(); + while (it != mData->constEnd()) + { + current = it.value().key; + if (inSignDomain == sdBoth || (inSignDomain == sdNegative && current < 0) || (inSignDomain == sdPositive && current > 0)) + { + if (current < range.lower || !haveLower) + { + range.lower = current; + haveLower = true; + } + if (current > range.upper || !haveUpper) + { + range.upper = current; + haveUpper = true; + } + } + ++it; + } + // determine exact range by including width of bars/flags: + if (haveLower && mKeyAxis) + range.lower = range.lower-mWidth*0.5; + if (haveUpper && mKeyAxis) + range.upper = range.upper+mWidth*0.5; + foundRange = haveLower && haveUpper; + return range; +} + +/* inherits documentation from base class */ +QCPRange QCPFinancial::getValueRange(bool &foundRange, QCPAbstractPlottable::SignDomain inSignDomain) const +{ + QCPRange range; + bool haveLower = false; + bool haveUpper = false; + + QCPFinancialDataMap::const_iterator it = mData->constBegin(); + while (it != mData->constEnd()) + { + // high: + if (inSignDomain == sdBoth || (inSignDomain == sdNegative && it.value().high < 0) || (inSignDomain == sdPositive && it.value().high > 0)) + { + if (it.value().high < range.lower || !haveLower) + { + range.lower = it.value().high; + haveLower = true; + } + if (it.value().high > range.upper || !haveUpper) + { + range.upper = it.value().high; + haveUpper = true; + } + } + // low: + if (inSignDomain == sdBoth || (inSignDomain == sdNegative && it.value().low < 0) || (inSignDomain == sdPositive && it.value().low > 0)) + { + if (it.value().low < range.lower || !haveLower) + { + range.lower = it.value().low; + haveLower = true; + } + if (it.value().low > range.upper || !haveUpper) + { + range.upper = it.value().low; + haveUpper = true; + } + } + ++it; + } + + foundRange = haveLower && haveUpper; + return range; +} + +/*! \internal + + Draws the data from \a begin to \a end as OHLC bars with the provided \a painter. + + This method is a helper function for \ref draw. It is used when the chart style is \ref csOhlc. +*/ +void QCPFinancial::drawOhlcPlot(QCPPainter *painter, const QCPFinancialDataMap::const_iterator &begin, const QCPFinancialDataMap::const_iterator &end) +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + + QPen linePen; + + if (keyAxis->orientation() == Qt::Horizontal) + { + for (QCPFinancialDataMap::const_iterator it = begin; it != end; ++it) + { + if (mSelected) + linePen = mSelectedPen; + else if (mTwoColored) + linePen = it.value().close >= it.value().open ? mPenPositive : mPenNegative; + else + linePen = mPen; + painter->setPen(linePen); + double keyPixel = keyAxis->coordToPixel(it.value().key); + double openPixel = valueAxis->coordToPixel(it.value().open); + double closePixel = valueAxis->coordToPixel(it.value().close); + // draw backbone: + painter->drawLine(QPointF(keyPixel, valueAxis->coordToPixel(it.value().high)), QPointF(keyPixel, valueAxis->coordToPixel(it.value().low))); + // draw open: + double keyWidthPixels = keyPixel-keyAxis->coordToPixel(it.value().key-mWidth*0.5); // sign of this makes sure open/close are on correct sides + painter->drawLine(QPointF(keyPixel-keyWidthPixels, openPixel), QPointF(keyPixel, openPixel)); + // draw close: + painter->drawLine(QPointF(keyPixel, closePixel), QPointF(keyPixel+keyWidthPixels, closePixel)); + } + } else + { + for (QCPFinancialDataMap::const_iterator it = begin; it != end; ++it) + { + if (mSelected) + linePen = mSelectedPen; + else if (mTwoColored) + linePen = it.value().close >= it.value().open ? mPenPositive : mPenNegative; + else + linePen = mPen; + painter->setPen(linePen); + double keyPixel = keyAxis->coordToPixel(it.value().key); + double openPixel = valueAxis->coordToPixel(it.value().open); + double closePixel = valueAxis->coordToPixel(it.value().close); + // draw backbone: + painter->drawLine(QPointF(valueAxis->coordToPixel(it.value().high), keyPixel), QPointF(valueAxis->coordToPixel(it.value().low), keyPixel)); + // draw open: + double keyWidthPixels = keyPixel-keyAxis->coordToPixel(it.value().key-mWidth*0.5); // sign of this makes sure open/close are on correct sides + painter->drawLine(QPointF(openPixel, keyPixel-keyWidthPixels), QPointF(openPixel, keyPixel)); + // draw close: + painter->drawLine(QPointF(closePixel, keyPixel), QPointF(closePixel, keyPixel+keyWidthPixels)); + } + } +} + +/*! \internal + + Draws the data from \a begin to \a end as Candlesticks with the provided \a painter. + + This method is a helper function for \ref draw. It is used when the chart style is \ref csCandlestick. +*/ +void QCPFinancial::drawCandlestickPlot(QCPPainter *painter, const QCPFinancialDataMap::const_iterator &begin, const QCPFinancialDataMap::const_iterator &end) +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + + QPen linePen; + QBrush boxBrush; + + if (keyAxis->orientation() == Qt::Horizontal) + { + for (QCPFinancialDataMap::const_iterator it = begin; it != end; ++it) + { + if (mSelected) + { + linePen = mSelectedPen; + boxBrush = mSelectedBrush; + } else if (mTwoColored) + { + if (it.value().close >= it.value().open) + { + linePen = mPenPositive; + boxBrush = mBrushPositive; + } else + { + linePen = mPenNegative; + boxBrush = mBrushNegative; + } + } else + { + linePen = mPen; + boxBrush = mBrush; + } + painter->setPen(linePen); + painter->setBrush(boxBrush); + double keyPixel = keyAxis->coordToPixel(it.value().key); + double openPixel = valueAxis->coordToPixel(it.value().open); + double closePixel = valueAxis->coordToPixel(it.value().close); + // draw high: + painter->drawLine(QPointF(keyPixel, valueAxis->coordToPixel(it.value().high)), QPointF(keyPixel, valueAxis->coordToPixel(qMax(it.value().open, it.value().close)))); + // draw low: + painter->drawLine(QPointF(keyPixel, valueAxis->coordToPixel(it.value().low)), QPointF(keyPixel, valueAxis->coordToPixel(qMin(it.value().open, it.value().close)))); + // draw open-close box: + double keyWidthPixels = keyPixel-keyAxis->coordToPixel(it.value().key-mWidth*0.5); + painter->drawRect(QRectF(QPointF(keyPixel-keyWidthPixels, closePixel), QPointF(keyPixel+keyWidthPixels, openPixel))); + } + } else // keyAxis->orientation() == Qt::Vertical + { + for (QCPFinancialDataMap::const_iterator it = begin; it != end; ++it) + { + if (mSelected) + { + linePen = mSelectedPen; + boxBrush = mSelectedBrush; + } else if (mTwoColored) + { + if (it.value().close >= it.value().open) + { + linePen = mPenPositive; + boxBrush = mBrushPositive; + } else + { + linePen = mPenNegative; + boxBrush = mBrushNegative; + } + } else + { + linePen = mPen; + boxBrush = mBrush; + } + painter->setPen(linePen); + painter->setBrush(boxBrush); + double keyPixel = keyAxis->coordToPixel(it.value().key); + double openPixel = valueAxis->coordToPixel(it.value().open); + double closePixel = valueAxis->coordToPixel(it.value().close); + // draw high: + painter->drawLine(QPointF(valueAxis->coordToPixel(it.value().high), keyPixel), QPointF(valueAxis->coordToPixel(qMax(it.value().open, it.value().close)), keyPixel)); + // draw low: + painter->drawLine(QPointF(valueAxis->coordToPixel(it.value().low), keyPixel), QPointF(valueAxis->coordToPixel(qMin(it.value().open, it.value().close)), keyPixel)); + // draw open-close box: + double keyWidthPixels = keyPixel-keyAxis->coordToPixel(it.value().key-mWidth*0.5); + painter->drawRect(QRectF(QPointF(closePixel, keyPixel-keyWidthPixels), QPointF(openPixel, keyPixel+keyWidthPixels))); + } + } +} + +/*! \internal + + This method is a helper function for \ref selectTest. It is used to test for selection when the + chart style is \ref csOhlc. It only tests against the data points between \a begin and \a end. +*/ +double QCPFinancial::ohlcSelectTest(const QPointF &pos, const QCPFinancialDataMap::const_iterator &begin, const QCPFinancialDataMap::const_iterator &end) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return -1; } + + double minDistSqr = std::numeric_limits::max(); + QCPFinancialDataMap::const_iterator it; + if (keyAxis->orientation() == Qt::Horizontal) + { + for (it = begin; it != end; ++it) + { + double keyPixel = keyAxis->coordToPixel(it.value().key); + // calculate distance to backbone: + double currentDistSqr = distSqrToLine(QPointF(keyPixel, valueAxis->coordToPixel(it.value().high)), QPointF(keyPixel, valueAxis->coordToPixel(it.value().low)), pos); + if (currentDistSqr < minDistSqr) + minDistSqr = currentDistSqr; + } + } else // keyAxis->orientation() == Qt::Vertical + { + for (it = begin; it != end; ++it) + { + double keyPixel = keyAxis->coordToPixel(it.value().key); + // calculate distance to backbone: + double currentDistSqr = distSqrToLine(QPointF(valueAxis->coordToPixel(it.value().high), keyPixel), QPointF(valueAxis->coordToPixel(it.value().low), keyPixel), pos); + if (currentDistSqr < minDistSqr) + minDistSqr = currentDistSqr; + } + } + return qSqrt(minDistSqr); +} + +/*! \internal + + This method is a helper function for \ref selectTest. It is used to test for selection when the + chart style is \ref csCandlestick. It only tests against the data points between \a begin and \a + end. +*/ +double QCPFinancial::candlestickSelectTest(const QPointF &pos, const QCPFinancialDataMap::const_iterator &begin, const QCPFinancialDataMap::const_iterator &end) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return -1; } + + double minDistSqr = std::numeric_limits::max(); + QCPFinancialDataMap::const_iterator it; + if (keyAxis->orientation() == Qt::Horizontal) + { + for (it = begin; it != end; ++it) + { + double currentDistSqr; + // determine whether pos is in open-close-box: + QCPRange boxKeyRange(it.value().key-mWidth*0.5, it.value().key+mWidth*0.5); + QCPRange boxValueRange(it.value().close, it.value().open); + double posKey, posValue; + pixelsToCoords(pos, posKey, posValue); + if (boxKeyRange.contains(posKey) && boxValueRange.contains(posValue)) // is in open-close-box + { + currentDistSqr = mParentPlot->selectionTolerance()*0.99 * mParentPlot->selectionTolerance()*0.99; + } else + { + // calculate distance to high/low lines: + double keyPixel = keyAxis->coordToPixel(it.value().key); + double highLineDistSqr = distSqrToLine(QPointF(keyPixel, valueAxis->coordToPixel(it.value().high)), QPointF(keyPixel, valueAxis->coordToPixel(qMax(it.value().open, it.value().close))), pos); + double lowLineDistSqr = distSqrToLine(QPointF(keyPixel, valueAxis->coordToPixel(it.value().low)), QPointF(keyPixel, valueAxis->coordToPixel(qMin(it.value().open, it.value().close))), pos); + currentDistSqr = qMin(highLineDistSqr, lowLineDistSqr); + } + if (currentDistSqr < minDistSqr) + minDistSqr = currentDistSqr; + } + } else // keyAxis->orientation() == Qt::Vertical + { + for (it = begin; it != end; ++it) + { + double currentDistSqr; + // determine whether pos is in open-close-box: + QCPRange boxKeyRange(it.value().key-mWidth*0.5, it.value().key+mWidth*0.5); + QCPRange boxValueRange(it.value().close, it.value().open); + double posKey, posValue; + pixelsToCoords(pos, posKey, posValue); + if (boxKeyRange.contains(posKey) && boxValueRange.contains(posValue)) // is in open-close-box + { + currentDistSqr = mParentPlot->selectionTolerance()*0.99 * mParentPlot->selectionTolerance()*0.99; + } else + { + // calculate distance to high/low lines: + double keyPixel = keyAxis->coordToPixel(it.value().key); + double highLineDistSqr = distSqrToLine(QPointF(valueAxis->coordToPixel(it.value().high), keyPixel), QPointF(valueAxis->coordToPixel(qMax(it.value().open, it.value().close)), keyPixel), pos); + double lowLineDistSqr = distSqrToLine(QPointF(valueAxis->coordToPixel(it.value().low), keyPixel), QPointF(valueAxis->coordToPixel(qMin(it.value().open, it.value().close)), keyPixel), pos); + currentDistSqr = qMin(highLineDistSqr, lowLineDistSqr); + } + if (currentDistSqr < minDistSqr) + minDistSqr = currentDistSqr; + } + } + return qSqrt(minDistSqr); +} + +/*! \internal + + called by the drawing methods to determine which data (key) range is visible at the current key + axis range setting, so only that needs to be processed. + + \a lower returns an iterator to the lowest data point that needs to be taken into account when + plotting. Note that in order to get a clean plot all the way to the edge of the axis rect, \a + lower may still be just outside the visible range. + + \a upper returns an iterator to the highest data point. Same as before, \a upper may also lie + just outside of the visible range. + + if the plottable contains no data, both \a lower and \a upper point to constEnd. + + \see QCPGraph::getVisibleDataBounds +*/ +void QCPFinancial::getVisibleDataBounds(QCPFinancialDataMap::const_iterator &lower, QCPFinancialDataMap::const_iterator &upper) const +{ + if (!mKeyAxis) { qDebug() << Q_FUNC_INFO << "invalid key axis"; return; } + if (mData->isEmpty()) + { + lower = mData->constEnd(); + upper = mData->constEnd(); + return; + } + + // get visible data range as QMap iterators + QCPFinancialDataMap::const_iterator lbound = mData->lowerBound(mKeyAxis.data()->range().lower); + QCPFinancialDataMap::const_iterator ubound = mData->upperBound(mKeyAxis.data()->range().upper); + bool lowoutlier = lbound != mData->constBegin(); // indicates whether there exist points below axis range + bool highoutlier = ubound != mData->constEnd(); // indicates whether there exist points above axis range + + lower = (lowoutlier ? lbound-1 : lbound); // data point range that will be actually drawn + upper = (highoutlier ? ubound : ubound-1); // data point range that will be actually drawn +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemStraightLine +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemStraightLine + \brief A straight line that spans infinitely in both directions + + \image html QCPItemStraightLine.png "Straight line example. Blue dotted circles are anchors, solid blue discs are positions." + + It has two positions, \a point1 and \a point2, which define the straight line. +*/ + +/*! + Creates a straight line item and sets default values. + + The constructed item can be added to the plot with QCustomPlot::addItem. +*/ +QCPItemStraightLine::QCPItemStraightLine(QCustomPlot *parentPlot) : + QCPAbstractItem(parentPlot), + point1(createPosition(QLatin1String("point1"))), + point2(createPosition(QLatin1String("point2"))) +{ + point1->setCoords(0, 0); + point2->setCoords(1, 1); + + setPen(QPen(Qt::black)); + setSelectedPen(QPen(Qt::blue,2)); +} + +QCPItemStraightLine::~QCPItemStraightLine() +{ +} + +/*! + Sets the pen that will be used to draw the line + + \see setSelectedPen +*/ +void QCPItemStraightLine::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the pen that will be used to draw the line when selected + + \see setPen, setSelected +*/ +void QCPItemStraightLine::setSelectedPen(const QPen &pen) +{ + mSelectedPen = pen; +} + +/* inherits documentation from base class */ +double QCPItemStraightLine::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + + return distToStraightLine(QVector2D(point1->pixelPoint()), QVector2D(point2->pixelPoint()-point1->pixelPoint()), QVector2D(pos)); +} + +/* inherits documentation from base class */ +void QCPItemStraightLine::draw(QCPPainter *painter) +{ + QVector2D start(point1->pixelPoint()); + QVector2D end(point2->pixelPoint()); + // get visible segment of straight line inside clipRect: + double clipPad = mainPen().widthF(); + QLineF line = getRectClippedStraightLine(start, end-start, clipRect().adjusted(-clipPad, -clipPad, clipPad, clipPad)); + // paint visible segment, if existent: + if (!line.isNull()) + { + painter->setPen(mainPen()); + painter->drawLine(line); + } +} + +/*! \internal + + finds the shortest distance of \a point to the straight line defined by the base point \a + base and the direction vector \a vec. + + This is a helper function for \ref selectTest. +*/ +double QCPItemStraightLine::distToStraightLine(const QVector2D &base, const QVector2D &vec, const QVector2D &point) const +{ + return qAbs((base.y()-point.y())*vec.x()-(base.x()-point.x())*vec.y())/vec.length(); +} + +/*! \internal + + Returns the section of the straight line defined by \a base and direction vector \a + vec, that is visible in the specified \a rect. + + This is a helper function for \ref draw. +*/ +QLineF QCPItemStraightLine::getRectClippedStraightLine(const QVector2D &base, const QVector2D &vec, const QRect &rect) const +{ + double bx, by; + double gamma; + QLineF result; + if (vec.x() == 0 && vec.y() == 0) + return result; + if (qFuzzyIsNull(vec.x())) // line is vertical + { + // check top of rect: + bx = rect.left(); + by = rect.top(); + gamma = base.x()-bx + (by-base.y())*vec.x()/vec.y(); + if (gamma >= 0 && gamma <= rect.width()) + result.setLine(bx+gamma, rect.top(), bx+gamma, rect.bottom()); // no need to check bottom because we know line is vertical + } else if (qFuzzyIsNull(vec.y())) // line is horizontal + { + // check left of rect: + bx = rect.left(); + by = rect.top(); + gamma = base.y()-by + (bx-base.x())*vec.y()/vec.x(); + if (gamma >= 0 && gamma <= rect.height()) + result.setLine(rect.left(), by+gamma, rect.right(), by+gamma); // no need to check right because we know line is horizontal + } else // line is skewed + { + QList pointVectors; + // check top of rect: + bx = rect.left(); + by = rect.top(); + gamma = base.x()-bx + (by-base.y())*vec.x()/vec.y(); + if (gamma >= 0 && gamma <= rect.width()) + pointVectors.append(QVector2D(bx+gamma, by)); + // check bottom of rect: + bx = rect.left(); + by = rect.bottom(); + gamma = base.x()-bx + (by-base.y())*vec.x()/vec.y(); + if (gamma >= 0 && gamma <= rect.width()) + pointVectors.append(QVector2D(bx+gamma, by)); + // check left of rect: + bx = rect.left(); + by = rect.top(); + gamma = base.y()-by + (bx-base.x())*vec.y()/vec.x(); + if (gamma >= 0 && gamma <= rect.height()) + pointVectors.append(QVector2D(bx, by+gamma)); + // check right of rect: + bx = rect.right(); + by = rect.top(); + gamma = base.y()-by + (bx-base.x())*vec.y()/vec.x(); + if (gamma >= 0 && gamma <= rect.height()) + pointVectors.append(QVector2D(bx, by+gamma)); + + // evaluate points: + if (pointVectors.size() == 2) + { + result.setPoints(pointVectors.at(0).toPointF(), pointVectors.at(1).toPointF()); + } else if (pointVectors.size() > 2) + { + // line probably goes through corner of rect, and we got two points there. single out the point pair with greatest distance: + double distSqrMax = 0; + QVector2D pv1, pv2; + for (int i=0; i distSqrMax) + { + pv1 = pointVectors.at(i); + pv2 = pointVectors.at(k); + distSqrMax = distSqr; + } + } + } + result.setPoints(pv1.toPointF(), pv2.toPointF()); + } + } + return result; +} + +/*! \internal + + Returns the pen that should be used for drawing lines. Returns mPen when the + item is not selected and mSelectedPen when it is. +*/ +QPen QCPItemStraightLine::mainPen() const +{ + return mSelected ? mSelectedPen : mPen; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemLine +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemLine + \brief A line from one point to another + + \image html QCPItemLine.png "Line example. Blue dotted circles are anchors, solid blue discs are positions." + + It has two positions, \a start and \a end, which define the end points of the line. + + With \ref setHead and \ref setTail you may set different line ending styles, e.g. to create an arrow. +*/ + +/*! + Creates a line item and sets default values. + + The constructed item can be added to the plot with QCustomPlot::addItem. +*/ +QCPItemLine::QCPItemLine(QCustomPlot *parentPlot) : + QCPAbstractItem(parentPlot), + start(createPosition(QLatin1String("start"))), + end(createPosition(QLatin1String("end"))) +{ + start->setCoords(0, 0); + end->setCoords(1, 1); + + setPen(QPen(Qt::black)); + setSelectedPen(QPen(Qt::blue,2)); +} + +QCPItemLine::~QCPItemLine() +{ +} + +/*! + Sets the pen that will be used to draw the line + + \see setSelectedPen +*/ +void QCPItemLine::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the pen that will be used to draw the line when selected + + \see setPen, setSelected +*/ +void QCPItemLine::setSelectedPen(const QPen &pen) +{ + mSelectedPen = pen; +} + +/*! + Sets the line ending style of the head. The head corresponds to the \a end position. + + Note that due to the overloaded QCPLineEnding constructor, you may directly specify + a QCPLineEnding::EndingStyle here, e.g. \code setHead(QCPLineEnding::esSpikeArrow) \endcode + + \see setTail +*/ +void QCPItemLine::setHead(const QCPLineEnding &head) +{ + mHead = head; +} + +/*! + Sets the line ending style of the tail. The tail corresponds to the \a start position. + + Note that due to the overloaded QCPLineEnding constructor, you may directly specify + a QCPLineEnding::EndingStyle here, e.g. \code setTail(QCPLineEnding::esSpikeArrow) \endcode + + \see setHead +*/ +void QCPItemLine::setTail(const QCPLineEnding &tail) +{ + mTail = tail; +} + +/* inherits documentation from base class */ +double QCPItemLine::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + + return qSqrt(distSqrToLine(start->pixelPoint(), end->pixelPoint(), pos)); +} + +/* inherits documentation from base class */ +void QCPItemLine::draw(QCPPainter *painter) +{ + QVector2D startVec(start->pixelPoint()); + QVector2D endVec(end->pixelPoint()); + if (startVec.toPoint() == endVec.toPoint()) + return; + // get visible segment of straight line inside clipRect: + double clipPad = qMax(mHead.boundingDistance(), mTail.boundingDistance()); + clipPad = qMax(clipPad, (double)mainPen().widthF()); + QLineF line = getRectClippedLine(startVec, endVec, clipRect().adjusted(-clipPad, -clipPad, clipPad, clipPad)); + // paint visible segment, if existent: + if (!line.isNull()) + { + painter->setPen(mainPen()); + painter->drawLine(line); + painter->setBrush(Qt::SolidPattern); + if (mTail.style() != QCPLineEnding::esNone) + mTail.draw(painter, startVec, startVec-endVec); + if (mHead.style() != QCPLineEnding::esNone) + mHead.draw(painter, endVec, endVec-startVec); + } +} + +/*! \internal + + Returns the section of the line defined by \a start and \a end, that is visible in the specified + \a rect. + + This is a helper function for \ref draw. +*/ +QLineF QCPItemLine::getRectClippedLine(const QVector2D &start, const QVector2D &end, const QRect &rect) const +{ + bool containsStart = rect.contains(start.x(), start.y()); + bool containsEnd = rect.contains(end.x(), end.y()); + if (containsStart && containsEnd) + return QLineF(start.toPointF(), end.toPointF()); + + QVector2D base = start; + QVector2D vec = end-start; + double bx, by; + double gamma, mu; + QLineF result; + QList pointVectors; + + if (!qFuzzyIsNull(vec.y())) // line is not horizontal + { + // check top of rect: + bx = rect.left(); + by = rect.top(); + mu = (by-base.y())/vec.y(); + if (mu >= 0 && mu <= 1) + { + gamma = base.x()-bx + mu*vec.x(); + if (gamma >= 0 && gamma <= rect.width()) + pointVectors.append(QVector2D(bx+gamma, by)); + } + // check bottom of rect: + bx = rect.left(); + by = rect.bottom(); + mu = (by-base.y())/vec.y(); + if (mu >= 0 && mu <= 1) + { + gamma = base.x()-bx + mu*vec.x(); + if (gamma >= 0 && gamma <= rect.width()) + pointVectors.append(QVector2D(bx+gamma, by)); + } + } + if (!qFuzzyIsNull(vec.x())) // line is not vertical + { + // check left of rect: + bx = rect.left(); + by = rect.top(); + mu = (bx-base.x())/vec.x(); + if (mu >= 0 && mu <= 1) + { + gamma = base.y()-by + mu*vec.y(); + if (gamma >= 0 && gamma <= rect.height()) + pointVectors.append(QVector2D(bx, by+gamma)); + } + // check right of rect: + bx = rect.right(); + by = rect.top(); + mu = (bx-base.x())/vec.x(); + if (mu >= 0 && mu <= 1) + { + gamma = base.y()-by + mu*vec.y(); + if (gamma >= 0 && gamma <= rect.height()) + pointVectors.append(QVector2D(bx, by+gamma)); + } + } + + if (containsStart) + pointVectors.append(start); + if (containsEnd) + pointVectors.append(end); + + // evaluate points: + if (pointVectors.size() == 2) + { + result.setPoints(pointVectors.at(0).toPointF(), pointVectors.at(1).toPointF()); + } else if (pointVectors.size() > 2) + { + // line probably goes through corner of rect, and we got two points there. single out the point pair with greatest distance: + double distSqrMax = 0; + QVector2D pv1, pv2; + for (int i=0; i distSqrMax) + { + pv1 = pointVectors.at(i); + pv2 = pointVectors.at(k); + distSqrMax = distSqr; + } + } + } + result.setPoints(pv1.toPointF(), pv2.toPointF()); + } + return result; +} + +/*! \internal + + Returns the pen that should be used for drawing lines. Returns mPen when the + item is not selected and mSelectedPen when it is. +*/ +QPen QCPItemLine::mainPen() const +{ + return mSelected ? mSelectedPen : mPen; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemCurve +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemCurve + \brief A curved line from one point to another + + \image html QCPItemCurve.png "Curve example. Blue dotted circles are anchors, solid blue discs are positions." + + It has four positions, \a start and \a end, which define the end points of the line, and two + control points which define the direction the line exits from the start and the direction from + which it approaches the end: \a startDir and \a endDir. + + With \ref setHead and \ref setTail you may set different line ending styles, e.g. to create an + arrow. + + Often it is desirable for the control points to stay at fixed relative positions to the start/end + point. This can be achieved by setting the parent anchor e.g. of \a startDir simply to \a start, + and then specify the desired pixel offset with QCPItemPosition::setCoords on \a startDir. +*/ + +/*! + Creates a curve item and sets default values. + + The constructed item can be added to the plot with QCustomPlot::addItem. +*/ +QCPItemCurve::QCPItemCurve(QCustomPlot *parentPlot) : + QCPAbstractItem(parentPlot), + start(createPosition(QLatin1String("start"))), + startDir(createPosition(QLatin1String("startDir"))), + endDir(createPosition(QLatin1String("endDir"))), + end(createPosition(QLatin1String("end"))) +{ + start->setCoords(0, 0); + startDir->setCoords(0.5, 0); + endDir->setCoords(0, 0.5); + end->setCoords(1, 1); + + setPen(QPen(Qt::black)); + setSelectedPen(QPen(Qt::blue,2)); +} + +QCPItemCurve::~QCPItemCurve() +{ +} + +/*! + Sets the pen that will be used to draw the line + + \see setSelectedPen +*/ +void QCPItemCurve::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the pen that will be used to draw the line when selected + + \see setPen, setSelected +*/ +void QCPItemCurve::setSelectedPen(const QPen &pen) +{ + mSelectedPen = pen; +} + +/*! + Sets the line ending style of the head. The head corresponds to the \a end position. + + Note that due to the overloaded QCPLineEnding constructor, you may directly specify + a QCPLineEnding::EndingStyle here, e.g. \code setHead(QCPLineEnding::esSpikeArrow) \endcode + + \see setTail +*/ +void QCPItemCurve::setHead(const QCPLineEnding &head) +{ + mHead = head; +} + +/*! + Sets the line ending style of the tail. The tail corresponds to the \a start position. + + Note that due to the overloaded QCPLineEnding constructor, you may directly specify + a QCPLineEnding::EndingStyle here, e.g. \code setTail(QCPLineEnding::esSpikeArrow) \endcode + + \see setHead +*/ +void QCPItemCurve::setTail(const QCPLineEnding &tail) +{ + mTail = tail; +} + +/* inherits documentation from base class */ +double QCPItemCurve::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + + QPointF startVec(start->pixelPoint()); + QPointF startDirVec(startDir->pixelPoint()); + QPointF endDirVec(endDir->pixelPoint()); + QPointF endVec(end->pixelPoint()); + + QPainterPath cubicPath(startVec); + cubicPath.cubicTo(startDirVec, endDirVec, endVec); + + QPolygonF polygon = cubicPath.toSubpathPolygons().first(); + double minDistSqr = std::numeric_limits::max(); + for (int i=1; ipixelPoint()); + QPointF startDirVec(startDir->pixelPoint()); + QPointF endDirVec(endDir->pixelPoint()); + QPointF endVec(end->pixelPoint()); + if (QVector2D(endVec-startVec).length() > 1e10f) // too large curves cause crash + return; + + QPainterPath cubicPath(startVec); + cubicPath.cubicTo(startDirVec, endDirVec, endVec); + + // paint visible segment, if existent: + QRect clip = clipRect().adjusted(-mainPen().widthF(), -mainPen().widthF(), mainPen().widthF(), mainPen().widthF()); + QRect cubicRect = cubicPath.controlPointRect().toRect(); + if (cubicRect.isEmpty()) // may happen when start and end exactly on same x or y position + cubicRect.adjust(0, 0, 1, 1); + if (clip.intersects(cubicRect)) + { + painter->setPen(mainPen()); + painter->drawPath(cubicPath); + painter->setBrush(Qt::SolidPattern); + if (mTail.style() != QCPLineEnding::esNone) + mTail.draw(painter, QVector2D(startVec), M_PI-cubicPath.angleAtPercent(0)/180.0*M_PI); + if (mHead.style() != QCPLineEnding::esNone) + mHead.draw(painter, QVector2D(endVec), -cubicPath.angleAtPercent(1)/180.0*M_PI); + } +} + +/*! \internal + + Returns the pen that should be used for drawing lines. Returns mPen when the + item is not selected and mSelectedPen when it is. +*/ +QPen QCPItemCurve::mainPen() const +{ + return mSelected ? mSelectedPen : mPen; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemRect +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemRect + \brief A rectangle + + \image html QCPItemRect.png "Rectangle example. Blue dotted circles are anchors, solid blue discs are positions." + + It has two positions, \a topLeft and \a bottomRight, which define the rectangle. +*/ + +/*! + Creates a rectangle item and sets default values. + + The constructed item can be added to the plot with QCustomPlot::addItem. +*/ +QCPItemRect::QCPItemRect(QCustomPlot *parentPlot) : + QCPAbstractItem(parentPlot), + topLeft(createPosition(QLatin1String("topLeft"))), + bottomRight(createPosition(QLatin1String("bottomRight"))), + top(createAnchor(QLatin1String("top"), aiTop)), + topRight(createAnchor(QLatin1String("topRight"), aiTopRight)), + right(createAnchor(QLatin1String("right"), aiRight)), + bottom(createAnchor(QLatin1String("bottom"), aiBottom)), + bottomLeft(createAnchor(QLatin1String("bottomLeft"), aiBottomLeft)), + left(createAnchor(QLatin1String("left"), aiLeft)) +{ + topLeft->setCoords(0, 1); + bottomRight->setCoords(1, 0); + + setPen(QPen(Qt::black)); + setSelectedPen(QPen(Qt::blue,2)); + setBrush(Qt::NoBrush); + setSelectedBrush(Qt::NoBrush); +} + +QCPItemRect::~QCPItemRect() +{ +} + +/*! + Sets the pen that will be used to draw the line of the rectangle + + \see setSelectedPen, setBrush +*/ +void QCPItemRect::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the pen that will be used to draw the line of the rectangle when selected + + \see setPen, setSelected +*/ +void QCPItemRect::setSelectedPen(const QPen &pen) +{ + mSelectedPen = pen; +} + +/*! + Sets the brush that will be used to fill the rectangle. To disable filling, set \a brush to + Qt::NoBrush. + + \see setSelectedBrush, setPen +*/ +void QCPItemRect::setBrush(const QBrush &brush) +{ + mBrush = brush; +} + +/*! + Sets the brush that will be used to fill the rectangle when selected. To disable filling, set \a + brush to Qt::NoBrush. + + \see setBrush +*/ +void QCPItemRect::setSelectedBrush(const QBrush &brush) +{ + mSelectedBrush = brush; +} + +/* inherits documentation from base class */ +double QCPItemRect::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + + QRectF rect = QRectF(topLeft->pixelPoint(), bottomRight->pixelPoint()).normalized(); + bool filledRect = mBrush.style() != Qt::NoBrush && mBrush.color().alpha() != 0; + return rectSelectTest(rect, pos, filledRect); +} + +/* inherits documentation from base class */ +void QCPItemRect::draw(QCPPainter *painter) +{ + QPointF p1 = topLeft->pixelPoint(); + QPointF p2 = bottomRight->pixelPoint(); + if (p1.toPoint() == p2.toPoint()) + return; + QRectF rect = QRectF(p1, p2).normalized(); + double clipPad = mainPen().widthF(); + QRectF boundingRect = rect.adjusted(-clipPad, -clipPad, clipPad, clipPad); + if (boundingRect.intersects(clipRect())) // only draw if bounding rect of rect item is visible in cliprect + { + painter->setPen(mainPen()); + painter->setBrush(mainBrush()); + painter->drawRect(rect); + } +} + +/* inherits documentation from base class */ +QPointF QCPItemRect::anchorPixelPoint(int anchorId) const +{ + QRectF rect = QRectF(topLeft->pixelPoint(), bottomRight->pixelPoint()); + switch (anchorId) + { + case aiTop: return (rect.topLeft()+rect.topRight())*0.5; + case aiTopRight: return rect.topRight(); + case aiRight: return (rect.topRight()+rect.bottomRight())*0.5; + case aiBottom: return (rect.bottomLeft()+rect.bottomRight())*0.5; + case aiBottomLeft: return rect.bottomLeft(); + case aiLeft: return (rect.topLeft()+rect.bottomLeft())*0.5; + } + + qDebug() << Q_FUNC_INFO << "invalid anchorId" << anchorId; + return QPointF(); +} + +/*! \internal + + Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected + and mSelectedPen when it is. +*/ +QPen QCPItemRect::mainPen() const +{ + return mSelected ? mSelectedPen : mPen; +} + +/*! \internal + + Returns the brush that should be used for drawing fills of the item. Returns mBrush when the item + is not selected and mSelectedBrush when it is. +*/ +QBrush QCPItemRect::mainBrush() const +{ + return mSelected ? mSelectedBrush : mBrush; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemText +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemText + \brief A text label + + \image html QCPItemText.png "Text example. Blue dotted circles are anchors, solid blue discs are positions." + + Its position is defined by the member \a position and the setting of \ref setPositionAlignment. + The latter controls which part of the text rect shall be aligned with \a position. + + The text alignment itself (i.e. left, center, right) can be controlled with \ref + setTextAlignment. + + The text may be rotated around the \a position point with \ref setRotation. +*/ + +/*! + Creates a text item and sets default values. + + The constructed item can be added to the plot with QCustomPlot::addItem. +*/ +QCPItemText::QCPItemText(QCustomPlot *parentPlot) : + QCPAbstractItem(parentPlot), + position(createPosition(QLatin1String("position"))), + topLeft(createAnchor(QLatin1String("topLeft"), aiTopLeft)), + top(createAnchor(QLatin1String("top"), aiTop)), + topRight(createAnchor(QLatin1String("topRight"), aiTopRight)), + right(createAnchor(QLatin1String("right"), aiRight)), + bottomRight(createAnchor(QLatin1String("bottomRight"), aiBottomRight)), + bottom(createAnchor(QLatin1String("bottom"), aiBottom)), + bottomLeft(createAnchor(QLatin1String("bottomLeft"), aiBottomLeft)), + left(createAnchor(QLatin1String("left"), aiLeft)) +{ + position->setCoords(0, 0); + + setRotation(0); + setTextAlignment(Qt::AlignTop|Qt::AlignHCenter); + setPositionAlignment(Qt::AlignCenter); + setText(QLatin1String("text")); + + setPen(Qt::NoPen); + setSelectedPen(Qt::NoPen); + setBrush(Qt::NoBrush); + setSelectedBrush(Qt::NoBrush); + setColor(Qt::black); + setSelectedColor(Qt::blue); +} + +QCPItemText::~QCPItemText() +{ +} + +/*! + Sets the color of the text. +*/ +void QCPItemText::setColor(const QColor &color) +{ + mColor = color; +} + +/*! + Sets the color of the text that will be used when the item is selected. +*/ +void QCPItemText::setSelectedColor(const QColor &color) +{ + mSelectedColor = color; +} + +/*! + Sets the pen that will be used do draw a rectangular border around the text. To disable the + border, set \a pen to Qt::NoPen. + + \see setSelectedPen, setBrush, setPadding +*/ +void QCPItemText::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the pen that will be used do draw a rectangular border around the text, when the item is + selected. To disable the border, set \a pen to Qt::NoPen. + + \see setPen +*/ +void QCPItemText::setSelectedPen(const QPen &pen) +{ + mSelectedPen = pen; +} + +/*! + Sets the brush that will be used do fill the background of the text. To disable the + background, set \a brush to Qt::NoBrush. + + \see setSelectedBrush, setPen, setPadding +*/ +void QCPItemText::setBrush(const QBrush &brush) +{ + mBrush = brush; +} + +/*! + Sets the brush that will be used do fill the background of the text, when the item is selected. To disable the + background, set \a brush to Qt::NoBrush. + + \see setBrush +*/ +void QCPItemText::setSelectedBrush(const QBrush &brush) +{ + mSelectedBrush = brush; +} + +/*! + Sets the font of the text. + + \see setSelectedFont, setColor +*/ +void QCPItemText::setFont(const QFont &font) +{ + mFont = font; +} + +/*! + Sets the font of the text that will be used when the item is selected. + + \see setFont +*/ +void QCPItemText::setSelectedFont(const QFont &font) +{ + mSelectedFont = font; +} + +/*! + Sets the text that will be displayed. Multi-line texts are supported by inserting a line break + character, e.g. '\n'. + + \see setFont, setColor, setTextAlignment +*/ +void QCPItemText::setText(const QString &text) +{ + mText = text; +} + +/*! + Sets which point of the text rect shall be aligned with \a position. + + Examples: + \li If \a alignment is Qt::AlignHCenter | Qt::AlignTop, the text will be positioned such + that the top of the text rect will be horizontally centered on \a position. + \li If \a alignment is Qt::AlignLeft | Qt::AlignBottom, \a position will indicate the + bottom left corner of the text rect. + + If you want to control the alignment of (multi-lined) text within the text rect, use \ref + setTextAlignment. +*/ +void QCPItemText::setPositionAlignment(Qt::Alignment alignment) +{ + mPositionAlignment = alignment; +} + +/*! + Controls how (multi-lined) text is aligned inside the text rect (typically Qt::AlignLeft, Qt::AlignCenter or Qt::AlignRight). +*/ +void QCPItemText::setTextAlignment(Qt::Alignment alignment) +{ + mTextAlignment = alignment; +} + +/*! + Sets the angle in degrees by which the text (and the text rectangle, if visible) will be rotated + around \a position. +*/ +void QCPItemText::setRotation(double degrees) +{ + mRotation = degrees; +} + +/*! + Sets the distance between the border of the text rectangle and the text. The appearance (and + visibility) of the text rectangle can be controlled with \ref setPen and \ref setBrush. +*/ +void QCPItemText::setPadding(const QMargins &padding) +{ + mPadding = padding; +} + +/* inherits documentation from base class */ +double QCPItemText::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + + // The rect may be rotated, so we transform the actual clicked pos to the rotated + // coordinate system, so we can use the normal rectSelectTest function for non-rotated rects: + QPointF positionPixels(position->pixelPoint()); + QTransform inputTransform; + inputTransform.translate(positionPixels.x(), positionPixels.y()); + inputTransform.rotate(-mRotation); + inputTransform.translate(-positionPixels.x(), -positionPixels.y()); + QPointF rotatedPos = inputTransform.map(pos); + QFontMetrics fontMetrics(mFont); + QRect textRect = fontMetrics.boundingRect(0, 0, 0, 0, Qt::TextDontClip|mTextAlignment, mText); + QRect textBoxRect = textRect.adjusted(-mPadding.left(), -mPadding.top(), mPadding.right(), mPadding.bottom()); + QPointF textPos = getTextDrawPoint(positionPixels, textBoxRect, mPositionAlignment); + textBoxRect.moveTopLeft(textPos.toPoint()); + + return rectSelectTest(textBoxRect, rotatedPos, true); +} + +/* inherits documentation from base class */ +void QCPItemText::draw(QCPPainter *painter) +{ + QPointF pos(position->pixelPoint()); + QTransform transform = painter->transform(); + transform.translate(pos.x(), pos.y()); + if (!qFuzzyIsNull(mRotation)) + transform.rotate(mRotation); + painter->setFont(mainFont()); + QRect textRect = painter->fontMetrics().boundingRect(0, 0, 0, 0, Qt::TextDontClip|mTextAlignment, mText); + QRect textBoxRect = textRect.adjusted(-mPadding.left(), -mPadding.top(), mPadding.right(), mPadding.bottom()); + QPointF textPos = getTextDrawPoint(QPointF(0, 0), textBoxRect, mPositionAlignment); // 0, 0 because the transform does the translation + textRect.moveTopLeft(textPos.toPoint()+QPoint(mPadding.left(), mPadding.top())); + textBoxRect.moveTopLeft(textPos.toPoint()); + double clipPad = mainPen().widthF(); + QRect boundingRect = textBoxRect.adjusted(-clipPad, -clipPad, clipPad, clipPad); + if (transform.mapRect(boundingRect).intersects(painter->transform().mapRect(clipRect()))) + { + painter->setTransform(transform); + if ((mainBrush().style() != Qt::NoBrush && mainBrush().color().alpha() != 0) || + (mainPen().style() != Qt::NoPen && mainPen().color().alpha() != 0)) + { + painter->setPen(mainPen()); + painter->setBrush(mainBrush()); + painter->drawRect(textBoxRect); + } + painter->setBrush(Qt::NoBrush); + painter->setPen(QPen(mainColor())); + painter->drawText(textRect, Qt::TextDontClip|mTextAlignment, mText); + } +} + +/* inherits documentation from base class */ +QPointF QCPItemText::anchorPixelPoint(int anchorId) const +{ + // get actual rect points (pretty much copied from draw function): + QPointF pos(position->pixelPoint()); + QTransform transform; + transform.translate(pos.x(), pos.y()); + if (!qFuzzyIsNull(mRotation)) + transform.rotate(mRotation); + QFontMetrics fontMetrics(mainFont()); + QRect textRect = fontMetrics.boundingRect(0, 0, 0, 0, Qt::TextDontClip|mTextAlignment, mText); + QRectF textBoxRect = textRect.adjusted(-mPadding.left(), -mPadding.top(), mPadding.right(), mPadding.bottom()); + QPointF textPos = getTextDrawPoint(QPointF(0, 0), textBoxRect, mPositionAlignment); // 0, 0 because the transform does the translation + textBoxRect.moveTopLeft(textPos.toPoint()); + QPolygonF rectPoly = transform.map(QPolygonF(textBoxRect)); + + switch (anchorId) + { + case aiTopLeft: return rectPoly.at(0); + case aiTop: return (rectPoly.at(0)+rectPoly.at(1))*0.5; + case aiTopRight: return rectPoly.at(1); + case aiRight: return (rectPoly.at(1)+rectPoly.at(2))*0.5; + case aiBottomRight: return rectPoly.at(2); + case aiBottom: return (rectPoly.at(2)+rectPoly.at(3))*0.5; + case aiBottomLeft: return rectPoly.at(3); + case aiLeft: return (rectPoly.at(3)+rectPoly.at(0))*0.5; + } + + qDebug() << Q_FUNC_INFO << "invalid anchorId" << anchorId; + return QPointF(); +} + +/*! \internal + + Returns the point that must be given to the QPainter::drawText function (which expects the top + left point of the text rect), according to the position \a pos, the text bounding box \a rect and + the requested \a positionAlignment. + + For example, if \a positionAlignment is Qt::AlignLeft | Qt::AlignBottom the returned point + will be shifted upward by the height of \a rect, starting from \a pos. So if the text is finally + drawn at that point, the lower left corner of the resulting text rect is at \a pos. +*/ +QPointF QCPItemText::getTextDrawPoint(const QPointF &pos, const QRectF &rect, Qt::Alignment positionAlignment) const +{ + if (positionAlignment == 0 || positionAlignment == (Qt::AlignLeft|Qt::AlignTop)) + return pos; + + QPointF result = pos; // start at top left + if (positionAlignment.testFlag(Qt::AlignHCenter)) + result.rx() -= rect.width()/2.0; + else if (positionAlignment.testFlag(Qt::AlignRight)) + result.rx() -= rect.width(); + if (positionAlignment.testFlag(Qt::AlignVCenter)) + result.ry() -= rect.height()/2.0; + else if (positionAlignment.testFlag(Qt::AlignBottom)) + result.ry() -= rect.height(); + return result; +} + +/*! \internal + + Returns the font that should be used for drawing text. Returns mFont when the item is not selected + and mSelectedFont when it is. +*/ +QFont QCPItemText::mainFont() const +{ + return mSelected ? mSelectedFont : mFont; +} + +/*! \internal + + Returns the color that should be used for drawing text. Returns mColor when the item is not + selected and mSelectedColor when it is. +*/ +QColor QCPItemText::mainColor() const +{ + return mSelected ? mSelectedColor : mColor; +} + +/*! \internal + + Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected + and mSelectedPen when it is. +*/ +QPen QCPItemText::mainPen() const +{ + return mSelected ? mSelectedPen : mPen; +} + +/*! \internal + + Returns the brush that should be used for drawing fills of the item. Returns mBrush when the item + is not selected and mSelectedBrush when it is. +*/ +QBrush QCPItemText::mainBrush() const +{ + return mSelected ? mSelectedBrush : mBrush; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemEllipse +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemEllipse + \brief An ellipse + + \image html QCPItemEllipse.png "Ellipse example. Blue dotted circles are anchors, solid blue discs are positions." + + It has two positions, \a topLeft and \a bottomRight, which define the rect the ellipse will be drawn in. +*/ + +/*! + Creates an ellipse item and sets default values. + + The constructed item can be added to the plot with QCustomPlot::addItem. +*/ +QCPItemEllipse::QCPItemEllipse(QCustomPlot *parentPlot) : + QCPAbstractItem(parentPlot), + topLeft(createPosition(QLatin1String("topLeft"))), + bottomRight(createPosition(QLatin1String("bottomRight"))), + topLeftRim(createAnchor(QLatin1String("topLeftRim"), aiTopLeftRim)), + top(createAnchor(QLatin1String("top"), aiTop)), + topRightRim(createAnchor(QLatin1String("topRightRim"), aiTopRightRim)), + right(createAnchor(QLatin1String("right"), aiRight)), + bottomRightRim(createAnchor(QLatin1String("bottomRightRim"), aiBottomRightRim)), + bottom(createAnchor(QLatin1String("bottom"), aiBottom)), + bottomLeftRim(createAnchor(QLatin1String("bottomLeftRim"), aiBottomLeftRim)), + left(createAnchor(QLatin1String("left"), aiLeft)), + center(createAnchor(QLatin1String("center"), aiCenter)) +{ + topLeft->setCoords(0, 1); + bottomRight->setCoords(1, 0); + + setPen(QPen(Qt::black)); + setSelectedPen(QPen(Qt::blue, 2)); + setBrush(Qt::NoBrush); + setSelectedBrush(Qt::NoBrush); +} + +QCPItemEllipse::~QCPItemEllipse() +{ +} + +/*! + Sets the pen that will be used to draw the line of the ellipse + + \see setSelectedPen, setBrush +*/ +void QCPItemEllipse::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the pen that will be used to draw the line of the ellipse when selected + + \see setPen, setSelected +*/ +void QCPItemEllipse::setSelectedPen(const QPen &pen) +{ + mSelectedPen = pen; +} + +/*! + Sets the brush that will be used to fill the ellipse. To disable filling, set \a brush to + Qt::NoBrush. + + \see setSelectedBrush, setPen +*/ +void QCPItemEllipse::setBrush(const QBrush &brush) +{ + mBrush = brush; +} + +/*! + Sets the brush that will be used to fill the ellipse when selected. To disable filling, set \a + brush to Qt::NoBrush. + + \see setBrush +*/ +void QCPItemEllipse::setSelectedBrush(const QBrush &brush) +{ + mSelectedBrush = brush; +} + +/* inherits documentation from base class */ +double QCPItemEllipse::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + + double result = -1; + QPointF p1 = topLeft->pixelPoint(); + QPointF p2 = bottomRight->pixelPoint(); + QPointF center((p1+p2)/2.0); + double a = qAbs(p1.x()-p2.x())/2.0; + double b = qAbs(p1.y()-p2.y())/2.0; + double x = pos.x()-center.x(); + double y = pos.y()-center.y(); + + // distance to border: + double c = 1.0/qSqrt(x*x/(a*a)+y*y/(b*b)); + result = qAbs(c-1)*qSqrt(x*x+y*y); + // filled ellipse, allow click inside to count as hit: + if (result > mParentPlot->selectionTolerance()*0.99 && mBrush.style() != Qt::NoBrush && mBrush.color().alpha() != 0) + { + if (x*x/(a*a) + y*y/(b*b) <= 1) + result = mParentPlot->selectionTolerance()*0.99; + } + return result; +} + +/* inherits documentation from base class */ +void QCPItemEllipse::draw(QCPPainter *painter) +{ + QPointF p1 = topLeft->pixelPoint(); + QPointF p2 = bottomRight->pixelPoint(); + if (p1.toPoint() == p2.toPoint()) + return; + QRectF ellipseRect = QRectF(p1, p2).normalized(); + QRect clip = clipRect().adjusted(-mainPen().widthF(), -mainPen().widthF(), mainPen().widthF(), mainPen().widthF()); + if (ellipseRect.intersects(clip)) // only draw if bounding rect of ellipse is visible in cliprect + { + painter->setPen(mainPen()); + painter->setBrush(mainBrush()); +#ifdef __EXCEPTIONS + try // drawEllipse sometimes throws exceptions if ellipse is too big + { +#endif + painter->drawEllipse(ellipseRect); +#ifdef __EXCEPTIONS + } catch (...) + { + qDebug() << Q_FUNC_INFO << "Item too large for memory, setting invisible"; + setVisible(false); + } +#endif + } +} + +/* inherits documentation from base class */ +QPointF QCPItemEllipse::anchorPixelPoint(int anchorId) const +{ + QRectF rect = QRectF(topLeft->pixelPoint(), bottomRight->pixelPoint()); + switch (anchorId) + { + case aiTopLeftRim: return rect.center()+(rect.topLeft()-rect.center())*1/qSqrt(2); + case aiTop: return (rect.topLeft()+rect.topRight())*0.5; + case aiTopRightRim: return rect.center()+(rect.topRight()-rect.center())*1/qSqrt(2); + case aiRight: return (rect.topRight()+rect.bottomRight())*0.5; + case aiBottomRightRim: return rect.center()+(rect.bottomRight()-rect.center())*1/qSqrt(2); + case aiBottom: return (rect.bottomLeft()+rect.bottomRight())*0.5; + case aiBottomLeftRim: return rect.center()+(rect.bottomLeft()-rect.center())*1/qSqrt(2); + case aiLeft: return (rect.topLeft()+rect.bottomLeft())*0.5; + case aiCenter: return (rect.topLeft()+rect.bottomRight())*0.5; + } + + qDebug() << Q_FUNC_INFO << "invalid anchorId" << anchorId; + return QPointF(); +} + +/*! \internal + + Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected + and mSelectedPen when it is. +*/ +QPen QCPItemEllipse::mainPen() const +{ + return mSelected ? mSelectedPen : mPen; +} + +/*! \internal + + Returns the brush that should be used for drawing fills of the item. Returns mBrush when the item + is not selected and mSelectedBrush when it is. +*/ +QBrush QCPItemEllipse::mainBrush() const +{ + return mSelected ? mSelectedBrush : mBrush; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemPixmap +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemPixmap + \brief An arbitrary pixmap + + \image html QCPItemPixmap.png "Pixmap example. Blue dotted circles are anchors, solid blue discs are positions." + + It has two positions, \a topLeft and \a bottomRight, which define the rectangle the pixmap will + be drawn in. Depending on the scale setting (\ref setScaled), the pixmap will be either scaled to + fit the rectangle or be drawn aligned to the topLeft position. + + If scaling is enabled and \a topLeft is further to the bottom/right than \a bottomRight (as shown + on the right side of the example image), the pixmap will be flipped in the respective + orientations. +*/ + +/*! + Creates a rectangle item and sets default values. + + The constructed item can be added to the plot with QCustomPlot::addItem. +*/ +QCPItemPixmap::QCPItemPixmap(QCustomPlot *parentPlot) : + QCPAbstractItem(parentPlot), + topLeft(createPosition(QLatin1String("topLeft"))), + bottomRight(createPosition(QLatin1String("bottomRight"))), + top(createAnchor(QLatin1String("top"), aiTop)), + topRight(createAnchor(QLatin1String("topRight"), aiTopRight)), + right(createAnchor(QLatin1String("right"), aiRight)), + bottom(createAnchor(QLatin1String("bottom"), aiBottom)), + bottomLeft(createAnchor(QLatin1String("bottomLeft"), aiBottomLeft)), + left(createAnchor(QLatin1String("left"), aiLeft)), + mScaledPixmapInvalidated(true) +{ + topLeft->setCoords(0, 1); + bottomRight->setCoords(1, 0); + + setPen(Qt::NoPen); + setSelectedPen(QPen(Qt::blue)); + setScaled(false, Qt::KeepAspectRatio, Qt::SmoothTransformation); +} + +QCPItemPixmap::~QCPItemPixmap() +{ +} + +/*! + Sets the pixmap that will be displayed. +*/ +void QCPItemPixmap::setPixmap(const QPixmap &pixmap) +{ + mPixmap = pixmap; + mScaledPixmapInvalidated = true; + if (mPixmap.isNull()) + qDebug() << Q_FUNC_INFO << "pixmap is null"; +} + +/*! + Sets whether the pixmap will be scaled to fit the rectangle defined by the \a topLeft and \a + bottomRight positions. +*/ +void QCPItemPixmap::setScaled(bool scaled, Qt::AspectRatioMode aspectRatioMode, Qt::TransformationMode transformationMode) +{ + mScaled = scaled; + mAspectRatioMode = aspectRatioMode; + mTransformationMode = transformationMode; + mScaledPixmapInvalidated = true; +} + +/*! + Sets the pen that will be used to draw a border around the pixmap. + + \see setSelectedPen, setBrush +*/ +void QCPItemPixmap::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the pen that will be used to draw a border around the pixmap when selected + + \see setPen, setSelected +*/ +void QCPItemPixmap::setSelectedPen(const QPen &pen) +{ + mSelectedPen = pen; +} + +/* inherits documentation from base class */ +double QCPItemPixmap::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + + return rectSelectTest(getFinalRect(), pos, true); +} + +/* inherits documentation from base class */ +void QCPItemPixmap::draw(QCPPainter *painter) +{ + bool flipHorz = false; + bool flipVert = false; + QRect rect = getFinalRect(&flipHorz, &flipVert); + double clipPad = mainPen().style() == Qt::NoPen ? 0 : mainPen().widthF(); + QRect boundingRect = rect.adjusted(-clipPad, -clipPad, clipPad, clipPad); + if (boundingRect.intersects(clipRect())) + { + updateScaledPixmap(rect, flipHorz, flipVert); + painter->drawPixmap(rect.topLeft(), mScaled ? mScaledPixmap : mPixmap); + QPen pen = mainPen(); + if (pen.style() != Qt::NoPen) + { + painter->setPen(pen); + painter->setBrush(Qt::NoBrush); + painter->drawRect(rect); + } + } +} + +/* inherits documentation from base class */ +QPointF QCPItemPixmap::anchorPixelPoint(int anchorId) const +{ + bool flipHorz; + bool flipVert; + QRect rect = getFinalRect(&flipHorz, &flipVert); + // we actually want denormal rects (negative width/height) here, so restore + // the flipped state: + if (flipHorz) + rect.adjust(rect.width(), 0, -rect.width(), 0); + if (flipVert) + rect.adjust(0, rect.height(), 0, -rect.height()); + + switch (anchorId) + { + case aiTop: return (rect.topLeft()+rect.topRight())*0.5; + case aiTopRight: return rect.topRight(); + case aiRight: return (rect.topRight()+rect.bottomRight())*0.5; + case aiBottom: return (rect.bottomLeft()+rect.bottomRight())*0.5; + case aiBottomLeft: return rect.bottomLeft(); + case aiLeft: return (rect.topLeft()+rect.bottomLeft())*0.5;; + } + + qDebug() << Q_FUNC_INFO << "invalid anchorId" << anchorId; + return QPointF(); +} + +/*! \internal + + Creates the buffered scaled image (\a mScaledPixmap) to fit the specified \a finalRect. The + parameters \a flipHorz and \a flipVert control whether the resulting image shall be flipped + horizontally or vertically. (This is used when \a topLeft is further to the bottom/right than \a + bottomRight.) + + This function only creates the scaled pixmap when the buffered pixmap has a different size than + the expected result, so calling this function repeatedly, e.g. in the \ref draw function, does + not cause expensive rescaling every time. + + If scaling is disabled, sets mScaledPixmap to a null QPixmap. +*/ +void QCPItemPixmap::updateScaledPixmap(QRect finalRect, bool flipHorz, bool flipVert) +{ + if (mPixmap.isNull()) + return; + + if (mScaled) + { + if (finalRect.isNull()) + finalRect = getFinalRect(&flipHorz, &flipVert); + if (mScaledPixmapInvalidated || finalRect.size() != mScaledPixmap.size()) + { + mScaledPixmap = mPixmap.scaled(finalRect.size(), mAspectRatioMode, mTransformationMode); + if (flipHorz || flipVert) + mScaledPixmap = QPixmap::fromImage(mScaledPixmap.toImage().mirrored(flipHorz, flipVert)); + } + } else if (!mScaledPixmap.isNull()) + mScaledPixmap = QPixmap(); + mScaledPixmapInvalidated = false; +} + +/*! \internal + + Returns the final (tight) rect the pixmap is drawn in, depending on the current item positions + and scaling settings. + + The output parameters \a flippedHorz and \a flippedVert return whether the pixmap should be drawn + flipped horizontally or vertically in the returned rect. (The returned rect itself is always + normalized, i.e. the top left corner of the rect is actually further to the top/left than the + bottom right corner). This is the case when the item position \a topLeft is further to the + bottom/right than \a bottomRight. + + If scaling is disabled, returns a rect with size of the original pixmap and the top left corner + aligned with the item position \a topLeft. The position \a bottomRight is ignored. +*/ +QRect QCPItemPixmap::getFinalRect(bool *flippedHorz, bool *flippedVert) const +{ + QRect result; + bool flipHorz = false; + bool flipVert = false; + QPoint p1 = topLeft->pixelPoint().toPoint(); + QPoint p2 = bottomRight->pixelPoint().toPoint(); + if (p1 == p2) + return QRect(p1, QSize(0, 0)); + if (mScaled) + { + QSize newSize = QSize(p2.x()-p1.x(), p2.y()-p1.y()); + QPoint topLeft = p1; + if (newSize.width() < 0) + { + flipHorz = true; + newSize.rwidth() *= -1; + topLeft.setX(p2.x()); + } + if (newSize.height() < 0) + { + flipVert = true; + newSize.rheight() *= -1; + topLeft.setY(p2.y()); + } + QSize scaledSize = mPixmap.size(); + scaledSize.scale(newSize, mAspectRatioMode); + result = QRect(topLeft, scaledSize); + } else + { + result = QRect(p1, mPixmap.size()); + } + if (flippedHorz) + *flippedHorz = flipHorz; + if (flippedVert) + *flippedVert = flipVert; + return result; +} + +/*! \internal + + Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected + and mSelectedPen when it is. +*/ +QPen QCPItemPixmap::mainPen() const +{ + return mSelected ? mSelectedPen : mPen; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemTracer +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemTracer + \brief Item that sticks to QCPGraph data points + + \image html QCPItemTracer.png "Tracer example. Blue dotted circles are anchors, solid blue discs are positions." + + The tracer can be connected with a QCPGraph via \ref setGraph. Then it will automatically adopt + the coordinate axes of the graph and update its \a position to be on the graph's data. This means + the key stays controllable via \ref setGraphKey, but the value will follow the graph data. If a + QCPGraph is connected, note that setting the coordinates of the tracer item directly via \a + position will have no effect because they will be overriden in the next redraw (this is when the + coordinate update happens). + + If the specified key in \ref setGraphKey is outside the key bounds of the graph, the tracer will + stay at the corresponding end of the graph. + + With \ref setInterpolating you may specify whether the tracer may only stay exactly on data + points or whether it interpolates data points linearly, if given a key that lies between two data + points of the graph. + + The tracer has different visual styles, see \ref setStyle. It is also possible to make the tracer + have no own visual appearance (set the style to \ref tsNone), and just connect other item + positions to the tracer \a position (used as an anchor) via \ref + QCPItemPosition::setParentAnchor. + + \note The tracer position is only automatically updated upon redraws. So when the data of the + graph changes and immediately afterwards (without a redraw) the a position coordinates of the + tracer are retrieved, they will not reflect the updated data of the graph. In this case \ref + updatePosition must be called manually, prior to reading the tracer coordinates. +*/ + +/*! + Creates a tracer item and sets default values. + + The constructed item can be added to the plot with QCustomPlot::addItem. +*/ +QCPItemTracer::QCPItemTracer(QCustomPlot *parentPlot) : + QCPAbstractItem(parentPlot), + position(createPosition(QLatin1String("position"))), + mGraph(0) +{ + position->setCoords(0, 0); + + setBrush(Qt::NoBrush); + setSelectedBrush(Qt::NoBrush); + setPen(QPen(Qt::black)); + setSelectedPen(QPen(Qt::blue, 2)); + setStyle(tsCrosshair); + setSize(6); + setInterpolating(false); + setGraphKey(0); +} + +QCPItemTracer::~QCPItemTracer() +{ +} + +/*! + Sets the pen that will be used to draw the line of the tracer + + \see setSelectedPen, setBrush +*/ +void QCPItemTracer::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the pen that will be used to draw the line of the tracer when selected + + \see setPen, setSelected +*/ +void QCPItemTracer::setSelectedPen(const QPen &pen) +{ + mSelectedPen = pen; +} + +/*! + Sets the brush that will be used to draw any fills of the tracer + + \see setSelectedBrush, setPen +*/ +void QCPItemTracer::setBrush(const QBrush &brush) +{ + mBrush = brush; +} + +/*! + Sets the brush that will be used to draw any fills of the tracer, when selected. + + \see setBrush, setSelected +*/ +void QCPItemTracer::setSelectedBrush(const QBrush &brush) +{ + mSelectedBrush = brush; +} + +/*! + Sets the size of the tracer in pixels, if the style supports setting a size (e.g. \ref tsSquare + does, \ref tsCrosshair does not). +*/ +void QCPItemTracer::setSize(double size) +{ + mSize = size; +} + +/*! + Sets the style/visual appearance of the tracer. + + If you only want to use the tracer \a position as an anchor for other items, set \a style to + \ref tsNone. +*/ +void QCPItemTracer::setStyle(QCPItemTracer::TracerStyle style) +{ + mStyle = style; +} + +/*! + Sets the QCPGraph this tracer sticks to. The tracer \a position will be set to type + QCPItemPosition::ptPlotCoords and the axes will be set to the axes of \a graph. + + To free the tracer from any graph, set \a graph to 0. The tracer \a position can then be placed + freely like any other item position. This is the state the tracer will assume when its graph gets + deleted while still attached to it. + + \see setGraphKey +*/ +void QCPItemTracer::setGraph(QCPGraph *graph) +{ + if (graph) + { + if (graph->parentPlot() == mParentPlot) + { + position->setType(QCPItemPosition::ptPlotCoords); + position->setAxes(graph->keyAxis(), graph->valueAxis()); + mGraph = graph; + updatePosition(); + } else + qDebug() << Q_FUNC_INFO << "graph isn't in same QCustomPlot instance as this item"; + } else + { + mGraph = 0; + } +} + +/*! + Sets the key of the graph's data point the tracer will be positioned at. This is the only free + coordinate of a tracer when attached to a graph. + + Depending on \ref setInterpolating, the tracer will be either positioned on the data point + closest to \a key, or will stay exactly at \a key and interpolate the value linearly. + + \see setGraph, setInterpolating +*/ +void QCPItemTracer::setGraphKey(double key) +{ + mGraphKey = key; +} + +/*! + Sets whether the value of the graph's data points shall be interpolated, when positioning the + tracer. + + If \a enabled is set to false and a key is given with \ref setGraphKey, the tracer is placed on + the data point of the graph which is closest to the key, but which is not necessarily exactly + there. If \a enabled is true, the tracer will be positioned exactly at the specified key, and + the appropriate value will be interpolated from the graph's data points linearly. + + \see setGraph, setGraphKey +*/ +void QCPItemTracer::setInterpolating(bool enabled) +{ + mInterpolating = enabled; +} + +/* inherits documentation from base class */ +double QCPItemTracer::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + + QPointF center(position->pixelPoint()); + double w = mSize/2.0; + QRect clip = clipRect(); + switch (mStyle) + { + case tsNone: return -1; + case tsPlus: + { + if (clipRect().intersects(QRectF(center-QPointF(w, w), center+QPointF(w, w)).toRect())) + return qSqrt(qMin(distSqrToLine(center+QPointF(-w, 0), center+QPointF(w, 0), pos), + distSqrToLine(center+QPointF(0, -w), center+QPointF(0, w), pos))); + break; + } + case tsCrosshair: + { + return qSqrt(qMin(distSqrToLine(QPointF(clip.left(), center.y()), QPointF(clip.right(), center.y()), pos), + distSqrToLine(QPointF(center.x(), clip.top()), QPointF(center.x(), clip.bottom()), pos))); + } + case tsCircle: + { + if (clip.intersects(QRectF(center-QPointF(w, w), center+QPointF(w, w)).toRect())) + { + // distance to border: + double centerDist = QVector2D(center-pos).length(); + double circleLine = w; + double result = qAbs(centerDist-circleLine); + // filled ellipse, allow click inside to count as hit: + if (result > mParentPlot->selectionTolerance()*0.99 && mBrush.style() != Qt::NoBrush && mBrush.color().alpha() != 0) + { + if (centerDist <= circleLine) + result = mParentPlot->selectionTolerance()*0.99; + } + return result; + } + break; + } + case tsSquare: + { + if (clip.intersects(QRectF(center-QPointF(w, w), center+QPointF(w, w)).toRect())) + { + QRectF rect = QRectF(center-QPointF(w, w), center+QPointF(w, w)); + bool filledRect = mBrush.style() != Qt::NoBrush && mBrush.color().alpha() != 0; + return rectSelectTest(rect, pos, filledRect); + } + break; + } + } + return -1; +} + +/* inherits documentation from base class */ +void QCPItemTracer::draw(QCPPainter *painter) +{ + updatePosition(); + if (mStyle == tsNone) + return; + + painter->setPen(mainPen()); + painter->setBrush(mainBrush()); + QPointF center(position->pixelPoint()); + double w = mSize/2.0; + QRect clip = clipRect(); + switch (mStyle) + { + case tsNone: return; + case tsPlus: + { + if (clip.intersects(QRectF(center-QPointF(w, w), center+QPointF(w, w)).toRect())) + { + painter->drawLine(QLineF(center+QPointF(-w, 0), center+QPointF(w, 0))); + painter->drawLine(QLineF(center+QPointF(0, -w), center+QPointF(0, w))); + } + break; + } + case tsCrosshair: + { + if (center.y() > clip.top() && center.y() < clip.bottom()) + painter->drawLine(QLineF(clip.left(), center.y(), clip.right(), center.y())); + if (center.x() > clip.left() && center.x() < clip.right()) + painter->drawLine(QLineF(center.x(), clip.top(), center.x(), clip.bottom())); + break; + } + case tsCircle: + { + if (clip.intersects(QRectF(center-QPointF(w, w), center+QPointF(w, w)).toRect())) + painter->drawEllipse(center, w, w); + break; + } + case tsSquare: + { + if (clip.intersects(QRectF(center-QPointF(w, w), center+QPointF(w, w)).toRect())) + painter->drawRect(QRectF(center-QPointF(w, w), center+QPointF(w, w))); + break; + } + } +} + +/*! + If the tracer is connected with a graph (\ref setGraph), this function updates the tracer's \a + position to reside on the graph data, depending on the configured key (\ref setGraphKey). + + It is called automatically on every redraw and normally doesn't need to be called manually. One + exception is when you want to read the tracer coordinates via \a position and are not sure that + the graph's data (or the tracer key with \ref setGraphKey) hasn't changed since the last redraw. + In that situation, call this function before accessing \a position, to make sure you don't get + out-of-date coordinates. + + If there is no graph set on this tracer, this function does nothing. +*/ +void QCPItemTracer::updatePosition() +{ + if (mGraph) + { + if (mParentPlot->hasPlottable(mGraph)) + { + if (mGraph->data()->size() > 1) + { + QCPDataMap::const_iterator first = mGraph->data()->constBegin(); + QCPDataMap::const_iterator last = mGraph->data()->constEnd()-1; + if (mGraphKey < first.key()) + position->setCoords(first.key(), first.value().value); + else if (mGraphKey > last.key()) + position->setCoords(last.key(), last.value().value); + else + { + QCPDataMap::const_iterator it = mGraph->data()->lowerBound(mGraphKey); + if (it != first) // mGraphKey is somewhere between iterators + { + QCPDataMap::const_iterator prevIt = it-1; + if (mInterpolating) + { + // interpolate between iterators around mGraphKey: + double slope = 0; + if (!qFuzzyCompare((double)it.key(), (double)prevIt.key())) + slope = (it.value().value-prevIt.value().value)/(it.key()-prevIt.key()); + position->setCoords(mGraphKey, (mGraphKey-prevIt.key())*slope+prevIt.value().value); + } else + { + // find iterator with key closest to mGraphKey: + if (mGraphKey < (prevIt.key()+it.key())*0.5) + it = prevIt; + position->setCoords(it.key(), it.value().value); + } + } else // mGraphKey is exactly on first iterator + position->setCoords(it.key(), it.value().value); + } + } else if (mGraph->data()->size() == 1) + { + QCPDataMap::const_iterator it = mGraph->data()->constBegin(); + position->setCoords(it.key(), it.value().value); + } else + qDebug() << Q_FUNC_INFO << "graph has no data"; + } else + qDebug() << Q_FUNC_INFO << "graph not contained in QCustomPlot instance (anymore)"; + } +} + +/*! \internal + + Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected + and mSelectedPen when it is. +*/ +QPen QCPItemTracer::mainPen() const +{ + return mSelected ? mSelectedPen : mPen; +} + +/*! \internal + + Returns the brush that should be used for drawing fills of the item. Returns mBrush when the item + is not selected and mSelectedBrush when it is. +*/ +QBrush QCPItemTracer::mainBrush() const +{ + return mSelected ? mSelectedBrush : mBrush; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemBracket +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemBracket + \brief A bracket for referencing/highlighting certain parts in the plot. + + \image html QCPItemBracket.png "Bracket example. Blue dotted circles are anchors, solid blue discs are positions." + + It has two positions, \a left and \a right, which define the span of the bracket. If \a left is + actually farther to the left than \a right, the bracket is opened to the bottom, as shown in the + example image. + + The bracket supports multiple styles via \ref setStyle. The length, i.e. how far the bracket + stretches away from the embraced span, can be controlled with \ref setLength. + + \image html QCPItemBracket-length.png +
Demonstrating the effect of different values for \ref setLength, for styles \ref + bsCalligraphic and \ref bsSquare. Anchors and positions are displayed for reference.
+ + It provides an anchor \a center, to allow connection of other items, e.g. an arrow (QCPItemLine + or QCPItemCurve) or a text label (QCPItemText), to the bracket. +*/ + +/*! + Creates a bracket item and sets default values. + + The constructed item can be added to the plot with QCustomPlot::addItem. +*/ +QCPItemBracket::QCPItemBracket(QCustomPlot *parentPlot) : + QCPAbstractItem(parentPlot), + left(createPosition(QLatin1String("left"))), + right(createPosition(QLatin1String("right"))), + center(createAnchor(QLatin1String("center"), aiCenter)) +{ + left->setCoords(0, 0); + right->setCoords(1, 1); + + setPen(QPen(Qt::black)); + setSelectedPen(QPen(Qt::blue, 2)); + setLength(8); + setStyle(bsCalligraphic); +} + +QCPItemBracket::~QCPItemBracket() +{ +} + +/*! + Sets the pen that will be used to draw the bracket. + + Note that when the style is \ref bsCalligraphic, only the color will be taken from the pen, the + stroke and width are ignored. To change the apparent stroke width of a calligraphic bracket, use + \ref setLength, which has a similar effect. + + \see setSelectedPen +*/ +void QCPItemBracket::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the pen that will be used to draw the bracket when selected + + \see setPen, setSelected +*/ +void QCPItemBracket::setSelectedPen(const QPen &pen) +{ + mSelectedPen = pen; +} + +/*! + Sets the \a length in pixels how far the bracket extends in the direction towards the embraced + span of the bracket (i.e. perpendicular to the left-right-direction) + + \image html QCPItemBracket-length.png +
Demonstrating the effect of different values for \ref setLength, for styles \ref + bsCalligraphic and \ref bsSquare. Anchors and positions are displayed for reference.
+*/ +void QCPItemBracket::setLength(double length) +{ + mLength = length; +} + +/*! + Sets the style of the bracket, i.e. the shape/visual appearance. + + \see setPen +*/ +void QCPItemBracket::setStyle(QCPItemBracket::BracketStyle style) +{ + mStyle = style; +} + +/* inherits documentation from base class */ +double QCPItemBracket::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + + QVector2D leftVec(left->pixelPoint()); + QVector2D rightVec(right->pixelPoint()); + if (leftVec.toPoint() == rightVec.toPoint()) + return -1; + + QVector2D widthVec = (rightVec-leftVec)*0.5f; + QVector2D lengthVec(-widthVec.y(), widthVec.x()); + lengthVec = lengthVec.normalized()*mLength; + QVector2D centerVec = (rightVec+leftVec)*0.5f-lengthVec; + + switch (mStyle) + { + case QCPItemBracket::bsSquare: + case QCPItemBracket::bsRound: + { + double a = distSqrToLine((centerVec-widthVec).toPointF(), (centerVec+widthVec).toPointF(), pos); + double b = distSqrToLine((centerVec-widthVec+lengthVec).toPointF(), (centerVec-widthVec).toPointF(), pos); + double c = distSqrToLine((centerVec+widthVec+lengthVec).toPointF(), (centerVec+widthVec).toPointF(), pos); + return qSqrt(qMin(qMin(a, b), c)); + } + case QCPItemBracket::bsCurly: + case QCPItemBracket::bsCalligraphic: + { + double a = distSqrToLine((centerVec-widthVec*0.75f+lengthVec*0.15f).toPointF(), (centerVec+lengthVec*0.3f).toPointF(), pos); + double b = distSqrToLine((centerVec-widthVec+lengthVec*0.7f).toPointF(), (centerVec-widthVec*0.75f+lengthVec*0.15f).toPointF(), pos); + double c = distSqrToLine((centerVec+widthVec*0.75f+lengthVec*0.15f).toPointF(), (centerVec+lengthVec*0.3f).toPointF(), pos); + double d = distSqrToLine((centerVec+widthVec+lengthVec*0.7f).toPointF(), (centerVec+widthVec*0.75f+lengthVec*0.15f).toPointF(), pos); + return qSqrt(qMin(qMin(a, b), qMin(c, d))); + } + } + return -1; +} + +/* inherits documentation from base class */ +void QCPItemBracket::draw(QCPPainter *painter) +{ + QVector2D leftVec(left->pixelPoint()); + QVector2D rightVec(right->pixelPoint()); + if (leftVec.toPoint() == rightVec.toPoint()) + return; + + QVector2D widthVec = (rightVec-leftVec)*0.5f; + QVector2D lengthVec(-widthVec.y(), widthVec.x()); + lengthVec = lengthVec.normalized()*mLength; + QVector2D centerVec = (rightVec+leftVec)*0.5f-lengthVec; + + QPolygon boundingPoly; + boundingPoly << leftVec.toPoint() << rightVec.toPoint() + << (rightVec-lengthVec).toPoint() << (leftVec-lengthVec).toPoint(); + QRect clip = clipRect().adjusted(-mainPen().widthF(), -mainPen().widthF(), mainPen().widthF(), mainPen().widthF()); + if (clip.intersects(boundingPoly.boundingRect())) + { + painter->setPen(mainPen()); + switch (mStyle) + { + case bsSquare: + { + painter->drawLine((centerVec+widthVec).toPointF(), (centerVec-widthVec).toPointF()); + painter->drawLine((centerVec+widthVec).toPointF(), (centerVec+widthVec+lengthVec).toPointF()); + painter->drawLine((centerVec-widthVec).toPointF(), (centerVec-widthVec+lengthVec).toPointF()); + break; + } + case bsRound: + { + painter->setBrush(Qt::NoBrush); + QPainterPath path; + path.moveTo((centerVec+widthVec+lengthVec).toPointF()); + path.cubicTo((centerVec+widthVec).toPointF(), (centerVec+widthVec).toPointF(), centerVec.toPointF()); + path.cubicTo((centerVec-widthVec).toPointF(), (centerVec-widthVec).toPointF(), (centerVec-widthVec+lengthVec).toPointF()); + painter->drawPath(path); + break; + } + case bsCurly: + { + painter->setBrush(Qt::NoBrush); + QPainterPath path; + path.moveTo((centerVec+widthVec+lengthVec).toPointF()); + path.cubicTo((centerVec+widthVec-lengthVec*0.8f).toPointF(), (centerVec+0.4f*widthVec+lengthVec).toPointF(), centerVec.toPointF()); + path.cubicTo((centerVec-0.4f*widthVec+lengthVec).toPointF(), (centerVec-widthVec-lengthVec*0.8f).toPointF(), (centerVec-widthVec+lengthVec).toPointF()); + painter->drawPath(path); + break; + } + case bsCalligraphic: + { + painter->setPen(Qt::NoPen); + painter->setBrush(QBrush(mainPen().color())); + QPainterPath path; + path.moveTo((centerVec+widthVec+lengthVec).toPointF()); + + path.cubicTo((centerVec+widthVec-lengthVec*0.8f).toPointF(), (centerVec+0.4f*widthVec+0.8f*lengthVec).toPointF(), centerVec.toPointF()); + path.cubicTo((centerVec-0.4f*widthVec+0.8f*lengthVec).toPointF(), (centerVec-widthVec-lengthVec*0.8f).toPointF(), (centerVec-widthVec+lengthVec).toPointF()); + + path.cubicTo((centerVec-widthVec-lengthVec*0.5f).toPointF(), (centerVec-0.2f*widthVec+1.2f*lengthVec).toPointF(), (centerVec+lengthVec*0.2f).toPointF()); + path.cubicTo((centerVec+0.2f*widthVec+1.2f*lengthVec).toPointF(), (centerVec+widthVec-lengthVec*0.5f).toPointF(), (centerVec+widthVec+lengthVec).toPointF()); + + painter->drawPath(path); + break; + } + } + } +} + +/* inherits documentation from base class */ +QPointF QCPItemBracket::anchorPixelPoint(int anchorId) const +{ + QVector2D leftVec(left->pixelPoint()); + QVector2D rightVec(right->pixelPoint()); + if (leftVec.toPoint() == rightVec.toPoint()) + return leftVec.toPointF(); + + QVector2D widthVec = (rightVec-leftVec)*0.5f; + QVector2D lengthVec(-widthVec.y(), widthVec.x()); + lengthVec = lengthVec.normalized()*mLength; + QVector2D centerVec = (rightVec+leftVec)*0.5f-lengthVec; + + switch (anchorId) + { + case aiCenter: + return centerVec.toPointF(); + } + qDebug() << Q_FUNC_INFO << "invalid anchorId" << anchorId; + return QPointF(); +} + +/*! \internal + + Returns the pen that should be used for drawing lines. Returns mPen when the + item is not selected and mSelectedPen when it is. +*/ +QPen QCPItemBracket::mainPen() const +{ + return mSelected ? mSelectedPen : mPen; +} + diff --git a/third/3rd_qcustomplot/v1_3/qcustomplot.h b/third/3rd_qcustomplot/v1_3/qcustomplot.h new file mode 100644 index 0000000..bb998f1 --- /dev/null +++ b/third/3rd_qcustomplot/v1_3/qcustomplot.h @@ -0,0 +1,3768 @@ +/*************************************************************************** +** ** +** QCustomPlot, an easy to use, modern plotting widget for Qt ** +** Copyright (C) 2011-2015 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 3 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/ ** +** Date: 22.12.15 ** +** Version: 1.3.2 ** +****************************************************************************/ + +#ifndef QCUSTOMPLOT_H +#define QCUSTOMPLOT_H + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) +# include +# include +# include +#else +# include +# include +#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 ///< 0x01 left margin + ,msRight = 0x02 ///< 0x02 right margin + ,msTop = 0x04 ///< 0x04 top margin + ,msBottom = 0x08 ///< 0x08 bottom margin + ,msAll = 0xFF ///< 0xFF all margins + ,msNone = 0x00 ///< 0x00 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 ///< 0x0001 Axis base line and tick marks + ,aeGrid = 0x0002 ///< 0x0002 Grid lines + ,aeSubGrid = 0x0004 ///< 0x0004 Sub grid lines + ,aeLegend = 0x0008 ///< 0x0008 Legend box + ,aeLegendItems = 0x0010 ///< 0x0010 Legend items + ,aePlottables = 0x0020 ///< 0x0020 Main lines of plottables (excluding error bars, see element \ref aeErrorBars) + ,aeItems = 0x0040 ///< 0x0040 Main lines of items + ,aeScatters = 0x0080 ///< 0x0080 Scatter symbols of plottables (excluding scatter symbols of type ssPixmap) + ,aeErrorBars = 0x0100 ///< 0x0100 Error bars + ,aeFills = 0x0200 ///< 0x0200 Borders of fills (e.g. under or between graphs) + ,aeZeroLine = 0x0400 ///< 0x0400 Zero-lines, see \ref QCPGrid::setZeroLinePen + ,aeAll = 0xFFFF ///< 0xFFFF All elements + ,aeNone = 0x0000 ///< 0x0000 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 ///< 0x000 No hints are set + ,phFastPolylines = 0x001 ///< 0x001 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 ///< 0x002 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 ///< 0x004 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 ///< 0x001 Axis ranges are draggable (see \ref QCPAxisRect::setRangeDrag, \ref QCPAxisRect::setRangeDragAxes) + ,iRangeZoom = 0x002 ///< 0x002 Axis ranges are zoomable with the mouse wheel (see \ref QCPAxisRect::setRangeZoom, \ref QCPAxisRect::setRangeZoomAxes) + ,iMultiSelect = 0x004 ///< 0x004 The user can select multiple objects by holding the modifier set by \ref QCustomPlot::setMultiSelectModifier while clicking + ,iSelectPlottables = 0x008 ///< 0x008 Plottables are selectable (e.g. graphs, curves, bars,... see QCPAbstractPlottable) + ,iSelectAxes = 0x010 ///< 0x010 Axes are selectable (or parts of them, see QCPAxis::setSelectableParts) + ,iSelectLegend = 0x020 ///< 0x020 Legends are selectable (or their child items, see QCPLegend::setSelectableParts) + ,iSelectItems = 0x040 ///< 0x040 Items are selectable (Rectangles, Arrows, Textitems, etc. see \ref QCPAbstractItem) + ,iSelectOther = 0x080 ///< 0x080 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 ///< 0x00 Default mode for painting on screen devices + ,pmVectorized = 0x01 ///< 0x01 Mode for vectorized painting (e.g. PDF export). For example, this prevents some antialiasing fixes. + ,pmNoCaching = 0x02 ///< 0x02 Mode for all sorts of exports (e.g. PNG, PDF,...). For example, this prevents using cached pixmap labels + ,pmNonCosmetic = 0x04 ///< 0x04 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 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 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 children() const { return mChildren; } + bool visible() const { return mVisible; } + + // setters: + void setVisible(bool visible); + +protected: + // property members: + QCustomPlot *mParentPlot; + QString mName; + int mIndex; + QList 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 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 elements(QCP::MarginSide side) const { return mChildren.value(side); } + bool isEmpty() const; + void clear(); + +protected: + // non-property members: + QCustomPlot *mParentPlot; + QHash > 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 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 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 mMarginGroups; + + // introduced virtual methods: + virtual int calculateAutoMargin(QCP::MarginSide side); + // events: + virtual void mousePressEvent(QMouseEvent *event) {Q_UNUSED(event)} + virtual void mouseMoveEvent(QMouseEvent *event) {Q_UNUSED(event)} + virtual void mouseReleaseEvent(QMouseEvent *event) {Q_UNUSED(event)} + virtual void mouseDoubleClickEvent(QMouseEvent *event) {Q_UNUSED(event)} + virtual void wheelEvent(QWheelEvent *event) {Q_UNUSED(event)} + + // reimplemented virtual methods: + virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const { Q_UNUSED(painter) } + virtual void draw(QCPPainter *painter) { Q_UNUSED(painter) } + 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 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 getSectionSizes(QVector maxSizes, QVector minSizes, QVector 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 columnStretchFactors READ columnStretchFactors WRITE setColumnStretchFactors) + Q_PROPERTY(QList 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 columnStretchFactors() const { return mColumnStretchFactors; } + QList 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 &factors); + void setRowStretchFactor(int row, double factor); + void setRowStretchFactors(const QList &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 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 > mElements; + QList mColumnStretchFactors; + QList mRowStretchFactors; + int mColumnSpacing, mRowSpacing; + + // non-virtual methods: + void getMinimumRowColSizes(QVector *minColWidths, QVector *minRowHeights) const; + void getMaximumRowColSizes(QVector *maxColWidths, QVector *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 mElements; + QList mInsetPlacement; + QList mInsetAlignment; + QList 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° 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 tickVector READ tickVector WRITE setTickVector) + Q_PROPERTY(QVector 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 ///< 0x01 Axis is vertical and on the left side of the axis rect + ,atRight = 0x02 ///< 0x02 Axis is vertical and on the right side of the axis rect + ,atTop = 0x04 ///< 0x04 Axis is horizontal and on the top side of the axis rect + ,atBottom = 0x08 ///< 0x08 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 tickVector() const { return mTickVector; } + QVector 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 &vec); + void setTickVectorLabels(const QVector &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 plottables() const; + QList graphs() const; + QList 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 mTickVector; + QVector mTickVectorLabels; + QVector 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 subTickPositions; + QVector tickPositions; + QVector 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 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 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 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 mKeyAxis, mValueAxis; + QPointer 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 positions() const { return mPositions; } + QList 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 mClipAxisRect; + QList mPositions; + QList 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 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 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 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 axisRects() const; + QCPLayoutElement* layoutElementAt(const QPointF &pos) const; + Q_SLOT void rescaleAxes(bool onlyVisiblePlottables=false); + + QList selectedAxes() const; + QList 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 mPlottables; + QList mGraphs; // extra list of plottables also in mPlottables that are of type QCPGraph + QList mItems; + QList 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 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 colorStops() const { return mColorStops; } + ColorInterpolation colorInterpolation() const { return mColorInterpolation; } + bool periodic() const { return mPeriodic; } + + // setters: + void setLevelCount(int n); + void setColorStops(const QMap &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 mColorStops; + ColorInterpolation mColorInterpolation; + bool mPeriodic; + + // non-property members: + QVector 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 axes(QCPAxis::AxisTypes types) const; + QList axes() const; + QCPAxis *addAxis(QCPAxis::AxisType type, QCPAxis *axis=0); + QList addAxes(QCPAxis::AxisTypes types); + bool removeAxis(QCPAxis *axis); + QCPLayoutInset *insetLayout() const { return mInsetLayout; } + + void setupFullAxesBox(bool connectRanges=false); + QList plottables() const; + QList graphs() const; + QList 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 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 mRangeDragHorzAxis, mRangeDragVertAxis, mRangeZoomHorzAxis, mRangeZoomVertAxis; + double mRangeZoomFactorHorz, mRangeZoomFactorVert; + // non-property members: + QCPRange mDragStartHorzRange, mDragStartVertRange; + QCP::AntialiasedElements mAADragBackup, mNotAADragBackup; + QPoint mDragStart; + bool mDragging; + QHash > 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 ///< 0x000 None + ,spLegendBox = 0x001 ///< 0x001 The legend box (frame) + ,spItems = 0x002 ///< 0x002 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 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 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 mAxisRect; + QPointer 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 QCPDataMap; +typedef QMapIterator QCPDataMapIterator; +typedef QMutableMapIterator 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 &key, const QVector &value); + void setDataKeyError(const QVector &key, const QVector &value, const QVector &keyError); + void setDataKeyError(const QVector &key, const QVector &value, const QVector &keyErrorMinus, const QVector &keyErrorPlus); + void setDataValueError(const QVector &key, const QVector &value, const QVector &valueError); + void setDataValueError(const QVector &key, const QVector &value, const QVector &valueErrorMinus, const QVector &valueErrorPlus); + void setDataBothError(const QVector &key, const QVector &value, const QVector &keyError, const QVector &valueError); + void setDataBothError(const QVector &key, const QVector &value, const QVector &keyErrorMinus, const QVector &keyErrorPlus, const QVector &valueErrorMinus, const QVector &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 &keys, const QVector &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 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 *lineData) const; + virtual void drawScatterPlot(QCPPainter *painter, QVector *scatterData) const; + virtual void drawLinePlot(QCPPainter *painter, QVector *lineData) const; + virtual void drawImpulsePlot(QCPPainter *painter, QVector *lineData) const; + + // non-virtual methods: + void getPreparedData(QVector *lineData, QVector *scatterData) const; + void getPlotData(QVector *lineData, QVector *scatterData) const; + void getScatterPlotData(QVector *scatterData) const; + void getLinePlotData(QVector *linePixelData, QVector *scatterData) const; + void getStepLeftPlotData(QVector *linePixelData, QVector *scatterData) const; + void getStepRightPlotData(QVector *linePixelData, QVector *scatterData) const; + void getStepCenterPlotData(QVector *linePixelData, QVector *scatterData) const; + void getImpulsePlotData(QVector *linePixelData, QVector *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 *lineData) const; + void removeFillBasePoints(QVector *lineData) const; + QPointF lowerFillBasePoint(double lowerKey) const; + QPointF upperFillBasePoint(double upperKey) const; + const QPolygonF getChannelFillPolygon(const QVector *lineData) const; + int findIndexBelowX(const QVector *data, double x) const; + int findIndexAboveX(const QVector *data, double x) const; + int findIndexBelowY(const QVector *data, double y) const; + int findIndexAboveY(const QVector *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 QCPCurveDataMap; +typedef QMapIterator QCPCurveDataMapIterator; +typedef QMutableMapIterator 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 &t, const QVector &key, const QVector &value); + void setData(const QVector &key, const QVector &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 &ts, const QVector &keys, const QVector &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 *pointData) const; + + // non-virtual methods: + void getCurveData(QVector *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 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 &beforeTraverse, QVector &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 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 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 QCPBarDataMap; +typedef QMapIterator QCPBarDataMapIterator; +typedef QMutableMapIterator 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 &key, const QVector &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 &keys, const QVector &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 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 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 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 &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 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 mColorScale; + // non-property members: + QImage mMapImage, mUndersampledMapImage; + 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 QCPFinancialDataMap; +typedef QMapIterator QCPFinancialDataMapIterator; +typedef QMutableMapIterator 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 &key, const QVector &open, const QVector &high, const QVector &low, const QVector &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 &key, const QVector &open, const QVector &high, const QVector &low, const QVector &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 &time, const QVector &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; + bool mScaledPixmapInvalidated; + 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; +}; + +#endif // QCUSTOMPLOT_H + diff --git a/third/3rd_qcustomplot/v2_0/qcustomplot.cpp b/third/3rd_qcustomplot/v2_0/qcustomplot.cpp new file mode 100644 index 0000000..51722e2 --- /dev/null +++ b/third/3rd_qcustomplot/v2_0/qcustomplot.cpp @@ -0,0 +1,30214 @@ +/*************************************************************************** +** ** +** QCustomPlot, an easy to use, modern plotting widget for Qt ** +** Copyright (C) 2011-2018 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 3 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/ ** +** Date: 25.06.18 ** +** Version: 2.0.1 ** +****************************************************************************/ + +#include "qcustomplot.h" + + +/* including file 'src/vector2d.cpp', size 7340 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPVector2D +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPVector2D + \brief Represents two doubles as a mathematical 2D vector + + This class acts as a replacement for QVector2D with the advantage of double precision instead of + single, and some convenience methods tailored for the QCustomPlot library. +*/ + +/* start documentation of inline functions */ + +/*! \fn void QCPVector2D::setX(double x) + + Sets the x coordinate of this vector to \a x. + + \see setY +*/ + +/*! \fn void QCPVector2D::setY(double y) + + Sets the y coordinate of this vector to \a y. + + \see setX +*/ + +/*! \fn double QCPVector2D::length() const + + Returns the length of this vector. + + \see lengthSquared +*/ + +/*! \fn double QCPVector2D::lengthSquared() const + + Returns the squared length of this vector. In some situations, e.g. when just trying to find the + shortest vector of a group, this is faster than calculating \ref length, because it avoids + calculation of a square root. + + \see length +*/ + +/*! \fn QPoint QCPVector2D::toPoint() const + + Returns a QPoint which has the x and y coordinates of this vector, truncating any floating point + information. + + \see toPointF +*/ + +/*! \fn QPointF QCPVector2D::toPointF() const + + Returns a QPointF which has the x and y coordinates of this vector. + + \see toPoint +*/ + +/*! \fn bool QCPVector2D::isNull() const + + Returns whether this vector is null. A vector is null if \c qIsNull returns true for both x and y + coordinates, i.e. if both are binary equal to 0. +*/ + +/*! \fn QCPVector2D QCPVector2D::perpendicular() const + + Returns a vector perpendicular to this vector, with the same length. +*/ + +/*! \fn double QCPVector2D::dot() const + + Returns the dot/scalar product of this vector with the specified vector \a vec. +*/ + +/* end documentation of inline functions */ + +/*! + Creates a QCPVector2D object and initializes the x and y coordinates to 0. +*/ +QCPVector2D::QCPVector2D() : + mX(0), + mY(0) +{ +} + +/*! + Creates a QCPVector2D object and initializes the \a x and \a y coordinates with the specified + values. +*/ +QCPVector2D::QCPVector2D(double x, double y) : + mX(x), + mY(y) +{ +} + +/*! + Creates a QCPVector2D object and initializes the x and y coordinates respective coordinates of + the specified \a point. +*/ +QCPVector2D::QCPVector2D(const QPoint &point) : + mX(point.x()), + mY(point.y()) +{ +} + +/*! + Creates a QCPVector2D object and initializes the x and y coordinates respective coordinates of + the specified \a point. +*/ +QCPVector2D::QCPVector2D(const QPointF &point) : + mX(point.x()), + mY(point.y()) +{ +} + +/*! + Normalizes this vector. After this operation, the length of the vector is equal to 1. + + \see normalized, length, lengthSquared +*/ +void QCPVector2D::normalize() +{ + double len = length(); + mX /= len; + mY /= len; +} + +/*! + Returns a normalized version of this vector. The length of the returned vector is equal to 1. + + \see normalize, length, lengthSquared +*/ +QCPVector2D QCPVector2D::normalized() const +{ + QCPVector2D result(mX, mY); + result.normalize(); + return result; +} + +/*! \overload + + Returns the squared shortest distance of this vector (interpreted as a point) to the finite line + segment given by \a start and \a end. + + \see distanceToStraightLine +*/ +double QCPVector2D::distanceSquaredToLine(const QCPVector2D &start, const QCPVector2D &end) const +{ + QCPVector2D v(end-start); + double vLengthSqr = v.lengthSquared(); + if (!qFuzzyIsNull(vLengthSqr)) + { + double mu = v.dot(*this-start)/vLengthSqr; + if (mu < 0) + return (*this-start).lengthSquared(); + else if (mu > 1) + return (*this-end).lengthSquared(); + else + return ((start + mu*v)-*this).lengthSquared(); + } else + return (*this-start).lengthSquared(); +} + +/*! \overload + + Returns the squared shortest distance of this vector (interpreted as a point) to the finite line + segment given by \a line. + + \see distanceToStraightLine +*/ +double QCPVector2D::distanceSquaredToLine(const QLineF &line) const +{ + return distanceSquaredToLine(QCPVector2D(line.p1()), QCPVector2D(line.p2())); +} + +/*! + Returns the shortest distance of this vector (interpreted as a point) to the infinite straight + line given by a \a base point and a \a direction vector. + + \see distanceSquaredToLine +*/ +double QCPVector2D::distanceToStraightLine(const QCPVector2D &base, const QCPVector2D &direction) const +{ + return qAbs((*this-base).dot(direction.perpendicular()))/direction.length(); +} + +/*! + Scales this vector by the given \a factor, i.e. the x and y components are multiplied by \a + factor. +*/ +QCPVector2D &QCPVector2D::operator*=(double factor) +{ + mX *= factor; + mY *= factor; + return *this; +} + +/*! + Scales this vector by the given \a divisor, i.e. the x and y components are divided by \a + divisor. +*/ +QCPVector2D &QCPVector2D::operator/=(double divisor) +{ + mX /= divisor; + mY /= divisor; + return *this; +} + +/*! + Adds the given \a vector to this vector component-wise. +*/ +QCPVector2D &QCPVector2D::operator+=(const QCPVector2D &vector) +{ + mX += vector.mX; + mY += vector.mY; + return *this; +} + +/*! + subtracts the given \a vector from this vector component-wise. +*/ +QCPVector2D &QCPVector2D::operator-=(const QCPVector2D &vector) +{ + mX -= vector.mX; + mY -= vector.mY; + return *this; +} +/* end of 'src/vector2d.cpp' */ + + +/* including file 'src/painter.cpp', size 8670 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPPainter +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPPainter + \brief QPainter subclass used internally + + This QPainter subclass is used to provide some extended functionality e.g. for tweaking position + consistency between antialiased and non-antialiased painting. Further it provides workarounds + for QPainter quirks. + + \warning This class intentionally hides non-virtual functions of QPainter, e.g. setPen, save and + restore. So while it is possible to pass a QCPPainter instance to a function that expects a + QPainter pointer, some of the workarounds and tweaks will be unavailable to the function (because + it will call the base class implementations of the functions actually hidden by QCPPainter). +*/ + +/*! + Creates a new QCPPainter instance and sets default values +*/ +QCPPainter::QCPPainter() : + QPainter(), + mModes(pmDefault), + mIsAntialiasing(false) +{ + // don't setRenderHint(QPainter::NonCosmeticDefautPen) here, because painter isn't active yet and + // a call to begin() will follow +} + +/*! + Creates a new QCPPainter instance on the specified paint \a device and sets default values. Just + like the analogous QPainter constructor, begins painting on \a device immediately. + + Like \ref begin, this method sets QPainter::NonCosmeticDefaultPen in Qt versions before Qt5. +*/ +QCPPainter::QCPPainter(QPaintDevice *device) : + QPainter(device), + mModes(pmDefault), + mIsAntialiasing(false) +{ +#if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) // before Qt5, default pens used to be cosmetic if NonCosmeticDefaultPen flag isn't set. So we set it to get consistency across Qt versions. + if (isActive()) + setRenderHint(QPainter::NonCosmeticDefaultPen); +#endif +} + +/*! + Sets the pen of the painter and applies certain fixes to it, depending on the mode of this + QCPPainter. + + \note this function hides the non-virtual base class implementation. +*/ +void QCPPainter::setPen(const QPen &pen) +{ + QPainter::setPen(pen); + if (mModes.testFlag(pmNonCosmetic)) + makeNonCosmetic(); +} + +/*! \overload + + Sets the pen (by color) of the painter and applies certain fixes to it, depending on the mode of + this QCPPainter. + + \note this function hides the non-virtual base class implementation. +*/ +void QCPPainter::setPen(const QColor &color) +{ + QPainter::setPen(color); + if (mModes.testFlag(pmNonCosmetic)) + makeNonCosmetic(); +} + +/*! \overload + + Sets the pen (by style) of the painter and applies certain fixes to it, depending on the mode of + this QCPPainter. + + \note this function hides the non-virtual base class implementation. +*/ +void QCPPainter::setPen(Qt::PenStyle penStyle) +{ + QPainter::setPen(penStyle); + if (mModes.testFlag(pmNonCosmetic)) + makeNonCosmetic(); +} + +/*! \overload + + Works around a Qt bug introduced with Qt 4.8 which makes drawing QLineF unpredictable when + antialiasing is disabled. Thus when antialiasing is disabled, it rounds the \a line to + integer coordinates and then passes it to the original drawLine. + + \note this function hides the non-virtual base class implementation. +*/ +void QCPPainter::drawLine(const QLineF &line) +{ + if (mIsAntialiasing || mModes.testFlag(pmVectorized)) + QPainter::drawLine(line); + else + QPainter::drawLine(line.toLine()); +} + +/*! + Sets whether painting uses antialiasing or not. Use this method instead of using setRenderHint + with QPainter::Antialiasing directly, as it allows QCPPainter to regain pixel exactness between + antialiased and non-antialiased painting (Since Qt < 5.0 uses slightly different coordinate systems for + AA/Non-AA painting). +*/ +void QCPPainter::setAntialiasing(bool enabled) +{ + setRenderHint(QPainter::Antialiasing, enabled); + if (mIsAntialiasing != enabled) + { + mIsAntialiasing = enabled; + if (!mModes.testFlag(pmVectorized)) // antialiasing half-pixel shift only needed for rasterized outputs + { + if (mIsAntialiasing) + translate(0.5, 0.5); + else + translate(-0.5, -0.5); + } + } +} + +/*! + Sets the mode of the painter. This controls whether the painter shall adjust its + fixes/workarounds optimized for certain output devices. +*/ +void QCPPainter::setModes(QCPPainter::PainterModes modes) +{ + mModes = modes; +} + +/*! + Sets the QPainter::NonCosmeticDefaultPen in Qt versions before Qt5 after beginning painting on \a + device. This is necessary to get cosmetic pen consistency across Qt versions, because since Qt5, + all pens are non-cosmetic by default, and in Qt4 this render hint must be set to get that + behaviour. + + The Constructor \ref QCPPainter(QPaintDevice *device) which directly starts painting also sets + the render hint as appropriate. + + \note this function hides the non-virtual base class implementation. +*/ +bool QCPPainter::begin(QPaintDevice *device) +{ + bool result = QPainter::begin(device); +#if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) // before Qt5, default pens used to be cosmetic if NonCosmeticDefaultPen flag isn't set. So we set it to get consistency across Qt versions. + if (result) + setRenderHint(QPainter::NonCosmeticDefaultPen); +#endif + return result; +} + +/*! \overload + + Sets the mode of the painter. This controls whether the painter shall adjust its + fixes/workarounds optimized for certain output devices. +*/ +void QCPPainter::setMode(QCPPainter::PainterMode mode, bool enabled) +{ + if (!enabled && mModes.testFlag(mode)) + mModes &= ~mode; + else if (enabled && !mModes.testFlag(mode)) + mModes |= mode; +} + +/*! + Saves the painter (see QPainter::save). Since QCPPainter adds some new internal state to + QPainter, the save/restore functions are reimplemented to also save/restore those members. + + \note this function hides the non-virtual base class implementation. + + \see restore +*/ +void QCPPainter::save() +{ + mAntialiasingStack.push(mIsAntialiasing); + QPainter::save(); +} + +/*! + Restores the painter (see QPainter::restore). Since QCPPainter adds some new internal state to + QPainter, the save/restore functions are reimplemented to also save/restore those members. + + \note this function hides the non-virtual base class implementation. + + \see save +*/ +void QCPPainter::restore() +{ + if (!mAntialiasingStack.isEmpty()) + mIsAntialiasing = mAntialiasingStack.pop(); + else + qDebug() << Q_FUNC_INFO << "Unbalanced save/restore"; + QPainter::restore(); +} + +/*! + Changes the pen width to 1 if it currently is 0. This function is called in the \ref setPen + overrides when the \ref pmNonCosmetic mode is set. +*/ +void QCPPainter::makeNonCosmetic() +{ + if (qFuzzyIsNull(pen().widthF())) + { + QPen p = pen(); + p.setWidth(1); + QPainter::setPen(p); + } +} +/* end of 'src/painter.cpp' */ + + +/* including file 'src/paintbuffer.cpp', size 18502 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAbstractPaintBuffer +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPAbstractPaintBuffer + \brief The abstract base class for paint buffers, which define the rendering backend + + This abstract base class defines the basic interface that a paint buffer needs to provide in + order to be usable by QCustomPlot. + + A paint buffer manages both a surface to draw onto, and the matching paint device. The size of + the surface can be changed via \ref setSize. External classes (\ref QCustomPlot and \ref + QCPLayer) request a painter via \ref startPainting and then perform the draw calls. Once the + painting is complete, \ref donePainting is called, so the paint buffer implementation can do + clean up if necessary. Before rendering a frame, each paint buffer is usually filled with a color + using \ref clear (usually the color is \c Qt::transparent), to remove the contents of the + previous frame. + + The simplest paint buffer implementation is \ref QCPPaintBufferPixmap which allows regular + software rendering via the raster engine. Hardware accelerated rendering via pixel buffers and + frame buffer objects is provided by \ref QCPPaintBufferGlPbuffer and \ref QCPPaintBufferGlFbo. + They are used automatically if \ref QCustomPlot::setOpenGl is enabled. +*/ + +/* start documentation of pure virtual functions */ + +/*! \fn virtual QCPPainter *QCPAbstractPaintBuffer::startPainting() = 0 + + Returns a \ref QCPPainter which is ready to draw to this buffer. The ownership and thus the + responsibility to delete the painter after the painting operations are complete is given to the + caller of this method. + + Once you are done using the painter, delete the painter and call \ref donePainting. + + While a painter generated with this method is active, you must not call \ref setSize, \ref + setDevicePixelRatio or \ref clear. + + This method may return 0, if a painter couldn't be activated on the buffer. This usually + indicates a problem with the respective painting backend. +*/ + +/*! \fn virtual void QCPAbstractPaintBuffer::draw(QCPPainter *painter) const = 0 + + Draws the contents of this buffer with the provided \a painter. This is the method that is used + to finally join all paint buffers and draw them onto the screen. +*/ + +/*! \fn virtual void QCPAbstractPaintBuffer::clear(const QColor &color) = 0 + + Fills the entire buffer with the provided \a color. To have an empty transparent buffer, use the + named color \c Qt::transparent. + + This method must not be called if there is currently a painter (acquired with \ref startPainting) + active. +*/ + +/*! \fn virtual void QCPAbstractPaintBuffer::reallocateBuffer() = 0 + + Reallocates the internal buffer with the currently configured size (\ref setSize) and device + pixel ratio, if applicable (\ref setDevicePixelRatio). It is called as soon as any of those + properties are changed on this paint buffer. + + \note Subclasses of \ref QCPAbstractPaintBuffer must call their reimplementation of this method + in their constructor, to perform the first allocation (this can not be done by the base class + because calling pure virtual methods in base class constructors is not possible). +*/ + +/* end documentation of pure virtual functions */ +/* start documentation of inline functions */ + +/*! \fn virtual void QCPAbstractPaintBuffer::donePainting() + + If you have acquired a \ref QCPPainter to paint onto this paint buffer via \ref startPainting, + call this method as soon as you are done with the painting operations and have deleted the + painter. + + paint buffer subclasses may use this method to perform any type of cleanup that is necessary. The + default implementation does nothing. +*/ + +/* end documentation of inline functions */ + +/*! + Creates a paint buffer and initializes it with the provided \a size and \a devicePixelRatio. + + Subclasses must call their \ref reallocateBuffer implementation in their respective constructors. +*/ +QCPAbstractPaintBuffer::QCPAbstractPaintBuffer(const QSize &size, double devicePixelRatio) : + mSize(size), + mDevicePixelRatio(devicePixelRatio), + mInvalidated(true) +{ +} + +QCPAbstractPaintBuffer::~QCPAbstractPaintBuffer() +{ +} + +/*! + Sets the paint buffer size. + + The buffer is reallocated (by calling \ref reallocateBuffer), so any painters that were obtained + by \ref startPainting are invalidated and must not be used after calling this method. + + If \a size is already the current buffer size, this method does nothing. +*/ +void QCPAbstractPaintBuffer::setSize(const QSize &size) +{ + if (mSize != size) + { + mSize = size; + reallocateBuffer(); + } +} + +/*! + Sets the invalidated flag to \a invalidated. + + This mechanism is used internally in conjunction with isolated replotting of \ref QCPLayer + instances (in \ref QCPLayer::lmBuffered mode). If \ref QCPLayer::replot is called on a buffered + layer, i.e. an isolated repaint of only that layer (and its dedicated paint buffer) is requested, + QCustomPlot will decide depending on the invalidated flags of other paint buffers whether it also + replots them, instead of only the layer on which the replot was called. + + The invalidated flag is set to true when \ref QCPLayer association has changed, i.e. if layers + were added or removed from this buffer, or if they were reordered. It is set to false as soon as + all associated \ref QCPLayer instances are drawn onto the buffer. + + Under normal circumstances, it is not necessary to manually call this method. +*/ +void QCPAbstractPaintBuffer::setInvalidated(bool invalidated) +{ + mInvalidated = invalidated; +} + +/*! + Sets the the device pixel ratio to \a ratio. This is useful to render on high-DPI output devices. + The ratio is automatically set to the device pixel ratio used by the parent QCustomPlot instance. + + The buffer is reallocated (by calling \ref reallocateBuffer), so any painters that were obtained + by \ref startPainting are invalidated and must not be used after calling this method. + + \note This method is only available for Qt versions 5.4 and higher. +*/ +void QCPAbstractPaintBuffer::setDevicePixelRatio(double ratio) +{ + if (!qFuzzyCompare(ratio, mDevicePixelRatio)) + { +#ifdef QCP_DEVICEPIXELRATIO_SUPPORTED + mDevicePixelRatio = ratio; + reallocateBuffer(); +#else + qDebug() << Q_FUNC_INFO << "Device pixel ratios not supported for Qt versions before 5.4"; + mDevicePixelRatio = 1.0; +#endif + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPPaintBufferPixmap +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPPaintBufferPixmap + \brief A paint buffer based on QPixmap, using software raster rendering + + This paint buffer is the default and fall-back paint buffer which uses software rendering and + QPixmap as internal buffer. It is used if \ref QCustomPlot::setOpenGl is false. +*/ + +/*! + Creates a pixmap paint buffer instancen with the specified \a size and \a devicePixelRatio, if + applicable. +*/ +QCPPaintBufferPixmap::QCPPaintBufferPixmap(const QSize &size, double devicePixelRatio) : + QCPAbstractPaintBuffer(size, devicePixelRatio) +{ + QCPPaintBufferPixmap::reallocateBuffer(); +} + +QCPPaintBufferPixmap::~QCPPaintBufferPixmap() +{ +} + +/* inherits documentation from base class */ +QCPPainter *QCPPaintBufferPixmap::startPainting() +{ + QCPPainter *result = new QCPPainter(&mBuffer); + result->setRenderHint(QPainter::HighQualityAntialiasing); + return result; +} + +/* inherits documentation from base class */ +void QCPPaintBufferPixmap::draw(QCPPainter *painter) const +{ + if (painter && painter->isActive()) + painter->drawPixmap(0, 0, mBuffer); + else + qDebug() << Q_FUNC_INFO << "invalid or inactive painter passed"; +} + +/* inherits documentation from base class */ +void QCPPaintBufferPixmap::clear(const QColor &color) +{ + mBuffer.fill(color); +} + +/* inherits documentation from base class */ +void QCPPaintBufferPixmap::reallocateBuffer() +{ + setInvalidated(); + if (!qFuzzyCompare(1.0, mDevicePixelRatio)) + { +#ifdef QCP_DEVICEPIXELRATIO_SUPPORTED + mBuffer = QPixmap(mSize*mDevicePixelRatio); + mBuffer.setDevicePixelRatio(mDevicePixelRatio); +#else + qDebug() << Q_FUNC_INFO << "Device pixel ratios not supported for Qt versions before 5.4"; + mDevicePixelRatio = 1.0; + mBuffer = QPixmap(mSize); +#endif + } else + { + mBuffer = QPixmap(mSize); + } +} + + +#ifdef QCP_OPENGL_PBUFFER +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPPaintBufferGlPbuffer +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPPaintBufferGlPbuffer + \brief A paint buffer based on OpenGL pixel buffers, using hardware accelerated rendering + + This paint buffer is one of the OpenGL paint buffers which facilitate hardware accelerated plot + rendering. It is based on OpenGL pixel buffers (pbuffer) and is used in Qt versions before 5.0. + (See \ref QCPPaintBufferGlFbo used in newer Qt versions.) + + The OpenGL paint buffers are used if \ref QCustomPlot::setOpenGl is set to true, and if they are + supported by the system. +*/ + +/*! + Creates a \ref QCPPaintBufferGlPbuffer instance with the specified \a size and \a + devicePixelRatio, if applicable. + + The parameter \a multisamples defines how many samples are used per pixel. Higher values thus + result in higher quality antialiasing. If the specified \a multisamples value exceeds the + capability of the graphics hardware, the highest supported multisampling is used. +*/ +QCPPaintBufferGlPbuffer::QCPPaintBufferGlPbuffer(const QSize &size, double devicePixelRatio, int multisamples) : + QCPAbstractPaintBuffer(size, devicePixelRatio), + mGlPBuffer(0), + mMultisamples(qMax(0, multisamples)) +{ + QCPPaintBufferGlPbuffer::reallocateBuffer(); +} + +QCPPaintBufferGlPbuffer::~QCPPaintBufferGlPbuffer() +{ + if (mGlPBuffer) + delete mGlPBuffer; +} + +/* inherits documentation from base class */ +QCPPainter *QCPPaintBufferGlPbuffer::startPainting() +{ + if (!mGlPBuffer->isValid()) + { + qDebug() << Q_FUNC_INFO << "OpenGL frame buffer object doesn't exist, reallocateBuffer was not called?"; + return 0; + } + + QCPPainter *result = new QCPPainter(mGlPBuffer); + result->setRenderHint(QPainter::HighQualityAntialiasing); + return result; +} + +/* inherits documentation from base class */ +void QCPPaintBufferGlPbuffer::draw(QCPPainter *painter) const +{ + if (!painter || !painter->isActive()) + { + qDebug() << Q_FUNC_INFO << "invalid or inactive painter passed"; + return; + } + if (!mGlPBuffer->isValid()) + { + qDebug() << Q_FUNC_INFO << "OpenGL pbuffer isn't valid, reallocateBuffer was not called?"; + return; + } + painter->drawImage(0, 0, mGlPBuffer->toImage()); +} + +/* inherits documentation from base class */ +void QCPPaintBufferGlPbuffer::clear(const QColor &color) +{ + if (mGlPBuffer->isValid()) + { + mGlPBuffer->makeCurrent(); + glClearColor(color.redF(), color.greenF(), color.blueF(), color.alphaF()); + glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); + mGlPBuffer->doneCurrent(); + } else + qDebug() << Q_FUNC_INFO << "OpenGL pbuffer invalid or context not current"; +} + +/* inherits documentation from base class */ +void QCPPaintBufferGlPbuffer::reallocateBuffer() +{ + if (mGlPBuffer) + delete mGlPBuffer; + + QGLFormat format; + format.setAlpha(true); + format.setSamples(mMultisamples); + mGlPBuffer = new QGLPixelBuffer(mSize, format); +} +#endif // QCP_OPENGL_PBUFFER + + +#ifdef QCP_OPENGL_FBO +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPPaintBufferGlFbo +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPPaintBufferGlFbo + \brief A paint buffer based on OpenGL frame buffers objects, using hardware accelerated rendering + + This paint buffer is one of the OpenGL paint buffers which facilitate hardware accelerated plot + rendering. It is based on OpenGL frame buffer objects (fbo) and is used in Qt versions 5.0 and + higher. (See \ref QCPPaintBufferGlPbuffer used in older Qt versions.) + + The OpenGL paint buffers are used if \ref QCustomPlot::setOpenGl is set to true, and if they are + supported by the system. +*/ + +/*! + Creates a \ref QCPPaintBufferGlFbo instance with the specified \a size and \a devicePixelRatio, + if applicable. + + All frame buffer objects shall share one OpenGL context and paint device, which need to be set up + externally and passed via \a glContext and \a glPaintDevice. The set-up is done in \ref + QCustomPlot::setupOpenGl and the context and paint device are managed by the parent QCustomPlot + instance. +*/ +QCPPaintBufferGlFbo::QCPPaintBufferGlFbo(const QSize &size, double devicePixelRatio, QWeakPointer glContext, QWeakPointer glPaintDevice) : + QCPAbstractPaintBuffer(size, devicePixelRatio), + mGlContext(glContext), + mGlPaintDevice(glPaintDevice), + mGlFrameBuffer(0) +{ + QCPPaintBufferGlFbo::reallocateBuffer(); +} + +QCPPaintBufferGlFbo::~QCPPaintBufferGlFbo() +{ + if (mGlFrameBuffer) + delete mGlFrameBuffer; +} + +/* inherits documentation from base class */ +QCPPainter *QCPPaintBufferGlFbo::startPainting() +{ + if (mGlPaintDevice.isNull()) + { + qDebug() << Q_FUNC_INFO << "OpenGL paint device doesn't exist"; + return 0; + } + if (!mGlFrameBuffer) + { + qDebug() << Q_FUNC_INFO << "OpenGL frame buffer object doesn't exist, reallocateBuffer was not called?"; + return 0; + } + + if (QOpenGLContext::currentContext() != mGlContext.data()) + mGlContext.data()->makeCurrent(mGlContext.data()->surface()); + mGlFrameBuffer->bind(); + QCPPainter *result = new QCPPainter(mGlPaintDevice.data()); + result->setRenderHint(QPainter::HighQualityAntialiasing); + return result; +} + +/* inherits documentation from base class */ +void QCPPaintBufferGlFbo::donePainting() +{ + if (mGlFrameBuffer && mGlFrameBuffer->isBound()) + mGlFrameBuffer->release(); + else + qDebug() << Q_FUNC_INFO << "Either OpenGL frame buffer not valid or was not bound"; +} + +/* inherits documentation from base class */ +void QCPPaintBufferGlFbo::draw(QCPPainter *painter) const +{ + if (!painter || !painter->isActive()) + { + qDebug() << Q_FUNC_INFO << "invalid or inactive painter passed"; + return; + } + if (!mGlFrameBuffer) + { + qDebug() << Q_FUNC_INFO << "OpenGL frame buffer object doesn't exist, reallocateBuffer was not called?"; + return; + } + painter->drawImage(0, 0, mGlFrameBuffer->toImage()); +} + +/* inherits documentation from base class */ +void QCPPaintBufferGlFbo::clear(const QColor &color) +{ + if (mGlContext.isNull()) + { + qDebug() << Q_FUNC_INFO << "OpenGL context doesn't exist"; + return; + } + if (!mGlFrameBuffer) + { + qDebug() << Q_FUNC_INFO << "OpenGL frame buffer object doesn't exist, reallocateBuffer was not called?"; + return; + } + + if (QOpenGLContext::currentContext() != mGlContext.data()) + mGlContext.data()->makeCurrent(mGlContext.data()->surface()); + mGlFrameBuffer->bind(); + glClearColor(color.redF(), color.greenF(), color.blueF(), color.alphaF()); + glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT); + mGlFrameBuffer->release(); +} + +/* inherits documentation from base class */ +void QCPPaintBufferGlFbo::reallocateBuffer() +{ + // release and delete possibly existing framebuffer: + if (mGlFrameBuffer) + { + if (mGlFrameBuffer->isBound()) + mGlFrameBuffer->release(); + delete mGlFrameBuffer; + mGlFrameBuffer = 0; + } + + if (mGlContext.isNull()) + { + qDebug() << Q_FUNC_INFO << "OpenGL context doesn't exist"; + return; + } + if (mGlPaintDevice.isNull()) + { + qDebug() << Q_FUNC_INFO << "OpenGL paint device doesn't exist"; + return; + } + + // create new fbo with appropriate size: + mGlContext.data()->makeCurrent(mGlContext.data()->surface()); + QOpenGLFramebufferObjectFormat frameBufferFormat; + frameBufferFormat.setSamples(mGlContext.data()->format().samples()); + frameBufferFormat.setAttachment(QOpenGLFramebufferObject::CombinedDepthStencil); + mGlFrameBuffer = new QOpenGLFramebufferObject(mSize*mDevicePixelRatio, frameBufferFormat); + if (mGlPaintDevice.data()->size() != mSize*mDevicePixelRatio) + mGlPaintDevice.data()->setSize(mSize*mDevicePixelRatio); +#ifdef QCP_DEVICEPIXELRATIO_SUPPORTED + mGlPaintDevice.data()->setDevicePixelRatio(mDevicePixelRatio); +#endif +} +#endif // QCP_OPENGL_FBO +/* end of 'src/paintbuffer.cpp' */ + + +/* including file 'src/layer.cpp', size 37304 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPLayer +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPLayer + \brief A layer that may contain objects, to control the rendering order + + The Layering system of QCustomPlot is the mechanism to control the rendering order of the + elements inside the plot. + + It is based on the two classes QCPLayer and QCPLayerable. QCustomPlot holds an ordered list of + one or more instances of QCPLayer (see QCustomPlot::addLayer, QCustomPlot::layer, + QCustomPlot::moveLayer, etc.). When replotting, QCustomPlot goes through the list of layers + bottom to top and successively draws the layerables of the layers into the paint buffer(s). + + A QCPLayer contains an ordered list of QCPLayerable instances. QCPLayerable is an abstract base + class from which almost all visible objects derive, like axes, grids, graphs, items, etc. + + \section qcplayer-defaultlayers Default layers + + Initially, QCustomPlot has six layers: "background", "grid", "main", "axes", "legend" and + "overlay" (in that order). On top is the "overlay" layer, which only contains the QCustomPlot's + selection rect (\ref QCustomPlot::selectionRect). The next two layers "axes" and "legend" contain + the default axes and legend, so they will be drawn above plottables. In the middle, there is the + "main" layer. It is initially empty and set as the current layer (see + QCustomPlot::setCurrentLayer). This means, all new plottables, items etc. are created on this + layer by default. Then comes the "grid" layer which contains the QCPGrid instances (which belong + tightly to QCPAxis, see \ref QCPAxis::grid). The Axis rect background shall be drawn behind + everything else, thus the default QCPAxisRect instance is placed on the "background" layer. Of + course, the layer affiliation of the individual objects can be changed as required (\ref + QCPLayerable::setLayer). + + \section qcplayer-ordering Controlling the rendering order via layers + + Controlling the ordering of layerables in the plot is easy: Create a new layer in the position + you want the layerable to be in, e.g. above "main", with \ref QCustomPlot::addLayer. Then set the + current layer with \ref QCustomPlot::setCurrentLayer to that new layer and finally create the + objects normally. They will be placed on the new layer automatically, due to the current layer + setting. Alternatively you could have also ignored the current layer setting and just moved the + objects with \ref QCPLayerable::setLayer to the desired layer after creating them. + + It is also possible to move whole layers. For example, If you want the grid to be shown in front + of all plottables/items on the "main" layer, just move it above "main" with + QCustomPlot::moveLayer. + + The rendering order within one layer is simply by order of creation or insertion. The item + created last (or added last to the layer), is drawn on top of all other objects on that layer. + + When a layer is deleted, the objects on it are not deleted with it, but fall on the layer below + the deleted layer, see QCustomPlot::removeLayer. + + \section qcplayer-buffering Replotting only a specific layer + + If the layer mode (\ref setMode) is set to \ref lmBuffered, you can replot only this specific + layer by calling \ref replot. In certain situations this can provide better replot performance, + compared with a full replot of all layers. Upon creation of a new layer, the layer mode is + initialized to \ref lmLogical. The only layer that is set to \ref lmBuffered in a new \ref + QCustomPlot instance is the "overlay" layer, containing the selection rect. +*/ + +/* start documentation of inline functions */ + +/*! \fn QList QCPLayer::children() const + + Returns a list of all layerables on this layer. The order corresponds to the rendering order: + layerables with higher indices are drawn above layerables with lower indices. +*/ + +/*! \fn int QCPLayer::index() const + + Returns the index this layer has in the QCustomPlot. The index is the integer number by which this layer can be + accessed via \ref QCustomPlot::layer. + + Layers with higher indices will be drawn above layers with lower indices. +*/ + +/* end documentation of inline functions */ + +/*! + Creates a new QCPLayer instance. + + Normally you shouldn't directly instantiate layers, use \ref QCustomPlot::addLayer instead. + + \warning It is not checked that \a layerName is actually a unique layer name in \a parentPlot. + This check is only performed by \ref QCustomPlot::addLayer. +*/ +QCPLayer::QCPLayer(QCustomPlot *parentPlot, const QString &layerName) : + QObject(parentPlot), + mParentPlot(parentPlot), + mName(layerName), + mIndex(-1), // will be set to a proper value by the QCustomPlot layer creation function + mVisible(true), + mMode(lmLogical) +{ + // Note: no need to make sure layerName is unique, because layer + // management is done with QCustomPlot functions. +} + +QCPLayer::~QCPLayer() +{ + // If child layerables are still on this layer, detach them, so they don't try to reach back to this + // then invalid layer once they get deleted/moved themselves. This only happens when layers are deleted + // directly, like in the QCustomPlot destructor. (The regular layer removal procedure for the user is to + // call QCustomPlot::removeLayer, which moves all layerables off this layer before deleting it.) + + while (!mChildren.isEmpty()) + mChildren.last()->setLayer(0); // removes itself from mChildren via removeChild() + + if (mParentPlot->currentLayer() == this) + qDebug() << Q_FUNC_INFO << "The parent plot's mCurrentLayer will be a dangling pointer. Should have been set to a valid layer or 0 beforehand."; +} + +/*! + Sets whether this layer is visible or not. If \a visible is set to false, all layerables on this + layer will be invisible. + + This function doesn't change the visibility property of the layerables (\ref + QCPLayerable::setVisible), but the \ref QCPLayerable::realVisibility of each layerable takes the + visibility of the parent layer into account. +*/ +void QCPLayer::setVisible(bool visible) +{ + mVisible = visible; +} + +/*! + Sets the rendering mode of this layer. + + If \a mode is set to \ref lmBuffered for a layer, it will be given a dedicated paint buffer by + the parent QCustomPlot instance. This means it may be replotted individually by calling \ref + QCPLayer::replot, without needing to replot all other layers. + + Layers which are set to \ref lmLogical (the default) are used only to define the rendering order + and can't be replotted individually. + + Note that each layer which is set to \ref lmBuffered requires additional paint buffers for the + layers below, above and for the layer itself. This increases the memory consumption and + (slightly) decreases the repainting speed because multiple paint buffers need to be joined. So + you should carefully choose which layers benefit from having their own paint buffer. A typical + example would be a layer which contains certain layerables (e.g. items) that need to be changed + and thus replotted regularly, while all other layerables on other layers stay static. By default, + only the topmost layer called "overlay" is in mode \ref lmBuffered, and contains the selection + rect. + + \see replot +*/ +void QCPLayer::setMode(QCPLayer::LayerMode mode) +{ + if (mMode != mode) + { + mMode = mode; + if (!mPaintBuffer.isNull()) + mPaintBuffer.data()->setInvalidated(); + } +} + +/*! \internal + + Draws the contents of this layer with the provided \a painter. + + \see replot, drawToPaintBuffer +*/ +void QCPLayer::draw(QCPPainter *painter) +{ + foreach (QCPLayerable *child, mChildren) + { + if (child->realVisibility()) + { + painter->save(); + painter->setClipRect(child->clipRect().translated(0, -1)); + child->applyDefaultAntialiasingHint(painter); + child->draw(painter); + painter->restore(); + } + } +} + +/*! \internal + + Draws the contents of this layer into the paint buffer which is associated with this layer. The + association is established by the parent QCustomPlot, which manages all paint buffers (see \ref + QCustomPlot::setupPaintBuffers). + + \see draw +*/ +void QCPLayer::drawToPaintBuffer() +{ + if (!mPaintBuffer.isNull()) + { + if (QCPPainter *painter = mPaintBuffer.data()->startPainting()) + { + if (painter->isActive()) + draw(painter); + else + qDebug() << Q_FUNC_INFO << "paint buffer returned inactive painter"; + delete painter; + mPaintBuffer.data()->donePainting(); + } else + qDebug() << Q_FUNC_INFO << "paint buffer returned zero painter"; + } else + qDebug() << Q_FUNC_INFO << "no valid paint buffer associated with this layer"; +} + +/*! + If the layer mode (\ref setMode) is set to \ref lmBuffered, this method allows replotting only + the layerables on this specific layer, without the need to replot all other layers (as a call to + \ref QCustomPlot::replot would do). + + If the layer mode is \ref lmLogical however, this method simply calls \ref QCustomPlot::replot on + the parent QCustomPlot instance. + + QCustomPlot also makes sure to replot all layers instead of only this one, if the layer ordering + has changed since the last full replot and the other paint buffers were thus invalidated. + + \see draw +*/ +void QCPLayer::replot() +{ + if (mMode == lmBuffered && !mParentPlot->hasInvalidatedPaintBuffers()) + { + if (!mPaintBuffer.isNull()) + { + mPaintBuffer.data()->clear(Qt::transparent); + drawToPaintBuffer(); + mPaintBuffer.data()->setInvalidated(false); + mParentPlot->update(); + } else + qDebug() << Q_FUNC_INFO << "no valid paint buffer associated with this layer"; + } else if (mMode == lmLogical) + mParentPlot->replot(); +} + +/*! \internal + + Adds the \a layerable to the list of this layer. If \a prepend is set to true, the layerable will + be prepended to the list, i.e. be drawn beneath the other layerables already in the list. + + This function does not change the \a mLayer member of \a layerable to this layer. (Use + QCPLayerable::setLayer to change the layer of an object, not this function.) + + \see removeChild +*/ +void QCPLayer::addChild(QCPLayerable *layerable, bool prepend) +{ + if (!mChildren.contains(layerable)) + { + if (prepend) + mChildren.prepend(layerable); + else + mChildren.append(layerable); + if (!mPaintBuffer.isNull()) + mPaintBuffer.data()->setInvalidated(); + } else + qDebug() << Q_FUNC_INFO << "layerable is already child of this layer" << reinterpret_cast(layerable); +} + +/*! \internal + + Removes the \a layerable from the list of this layer. + + This function does not change the \a mLayer member of \a layerable. (Use QCPLayerable::setLayer + to change the layer of an object, not this function.) + + \see addChild +*/ +void QCPLayer::removeChild(QCPLayerable *layerable) +{ + if (mChildren.removeOne(layerable)) + { + if (!mPaintBuffer.isNull()) + mPaintBuffer.data()->setInvalidated(); + } else + qDebug() << Q_FUNC_INFO << "layerable is not child of this layer" << reinterpret_cast(layerable); +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPLayerable +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPLayerable + \brief Base class for all drawable objects + + This is the abstract base class most visible objects derive from, e.g. plottables, axes, grid + etc. + + Every layerable is on a layer (QCPLayer) which allows controlling the rendering order by stacking + the layers accordingly. + + For details about the layering mechanism, see the QCPLayer documentation. +*/ + +/* start documentation of inline functions */ + +/*! \fn QCPLayerable *QCPLayerable::parentLayerable() const + + Returns the parent layerable of this layerable. The parent layerable is used to provide + visibility hierarchies in conjunction with the method \ref realVisibility. This way, layerables + only get drawn if their parent layerables are visible, too. + + Note that a parent layerable is not necessarily also the QObject parent for memory management. + Further, a layerable doesn't always have a parent layerable, so this function may return 0. + + A parent layerable is set implicitly when placed inside layout elements and doesn't need to be + set manually by the user. +*/ + +/* end documentation of inline functions */ +/* start documentation of pure virtual functions */ + +/*! \fn virtual void QCPLayerable::applyDefaultAntialiasingHint(QCPPainter *painter) const = 0 + \internal + + This function applies the default antialiasing setting to the specified \a painter, using the + function \ref applyAntialiasingHint. It is the antialiasing state the painter is put in, when + \ref draw is called on the layerable. If the layerable has multiple entities whose antialiasing + setting may be specified individually, this function should set the antialiasing state of the + most prominent entity. In this case however, the \ref draw function usually calls the specialized + versions of this function before drawing each entity, effectively overriding the setting of the + default antialiasing hint. + + First example: QCPGraph has multiple entities that have an antialiasing setting: The graph + line, fills and scatters. Those can be configured via QCPGraph::setAntialiased, + QCPGraph::setAntialiasedFill and QCPGraph::setAntialiasedScatters. Consequently, there isn't only + the QCPGraph::applyDefaultAntialiasingHint function (which corresponds to the graph line's + antialiasing), but specialized ones like QCPGraph::applyFillAntialiasingHint and + QCPGraph::applyScattersAntialiasingHint. So before drawing one of those entities, QCPGraph::draw + calls the respective specialized applyAntialiasingHint function. + + Second example: QCPItemLine consists only of a line so there is only one antialiasing + setting which can be controlled with QCPItemLine::setAntialiased. (This function is inherited by + all layerables. The specialized functions, as seen on QCPGraph, must be added explicitly to the + respective layerable subclass.) Consequently it only has the normal + QCPItemLine::applyDefaultAntialiasingHint. The \ref QCPItemLine::draw function doesn't need to + care about setting any antialiasing states, because the default antialiasing hint is already set + on the painter when the \ref draw function is called, and that's the state it wants to draw the + line with. +*/ + +/*! \fn virtual void QCPLayerable::draw(QCPPainter *painter) const = 0 + \internal + + This function draws the layerable with the specified \a painter. It is only called by + QCustomPlot, if the layerable is visible (\ref setVisible). + + Before this function is called, the painter's antialiasing state is set via \ref + applyDefaultAntialiasingHint, see the documentation there. Further, the clipping rectangle was + set to \ref clipRect. +*/ + +/* end documentation of pure virtual functions */ +/* start documentation of signals */ + +/*! \fn void QCPLayerable::layerChanged(QCPLayer *newLayer); + + This signal is emitted when the layer of this layerable changes, i.e. this layerable is moved to + a different layer. + + \see setLayer +*/ + +/* end documentation of signals */ + +/*! + Creates a new QCPLayerable instance. + + Since QCPLayerable is an abstract base class, it can't be instantiated directly. Use one of the + derived classes. + + If \a plot is provided, it automatically places itself on the layer named \a targetLayer. If \a + targetLayer is an empty string, it places itself on the current layer of the plot (see \ref + QCustomPlot::setCurrentLayer). + + It is possible to provide 0 as \a plot. In that case, you should assign a parent plot at a later + time with \ref initializeParentPlot. + + The layerable's parent layerable is set to \a parentLayerable, if provided. Direct layerable + parents are mainly used to control visibility in a hierarchy of layerables. This means a + layerable is only drawn, if all its ancestor layerables are also visible. Note that \a + parentLayerable does not become the QObject-parent (for memory management) of this layerable, \a + plot does. It is not uncommon to set the QObject-parent to something else in the constructors of + QCPLayerable subclasses, to guarantee a working destruction hierarchy. +*/ +QCPLayerable::QCPLayerable(QCustomPlot *plot, QString targetLayer, QCPLayerable *parentLayerable) : + QObject(plot), + mVisible(true), + mParentPlot(plot), + mParentLayerable(parentLayerable), + mLayer(0), + mAntialiased(true) +{ + if (mParentPlot) + { + if (targetLayer.isEmpty()) + setLayer(mParentPlot->currentLayer()); + else if (!setLayer(targetLayer)) + qDebug() << Q_FUNC_INFO << "setting QCPlayerable initial layer to" << targetLayer << "failed."; + } +} + +QCPLayerable::~QCPLayerable() +{ + if (mLayer) + { + mLayer->removeChild(this); + mLayer = 0; + } +} + +/*! + Sets the visibility of this layerable object. If an object is not visible, it will not be drawn + on the QCustomPlot surface, and user interaction with it (e.g. click and selection) is not + possible. +*/ +void QCPLayerable::setVisible(bool on) +{ + mVisible = on; +} + +/*! + Sets the \a layer of this layerable object. The object will be placed on top of the other objects + already on \a layer. + + If \a layer is 0, this layerable will not be on any layer and thus not appear in the plot (or + interact/receive events). + + Returns true if the layer of this layerable was successfully changed to \a layer. +*/ +bool QCPLayerable::setLayer(QCPLayer *layer) +{ + return moveToLayer(layer, false); +} + +/*! \overload + Sets the layer of this layerable object by name + + Returns true on success, i.e. if \a layerName is a valid layer name. +*/ +bool QCPLayerable::setLayer(const QString &layerName) +{ + if (!mParentPlot) + { + qDebug() << Q_FUNC_INFO << "no parent QCustomPlot set"; + return false; + } + if (QCPLayer *layer = mParentPlot->layer(layerName)) + { + return setLayer(layer); + } else + { + qDebug() << Q_FUNC_INFO << "there is no layer with name" << layerName; + return false; + } +} + +/*! + Sets whether this object will be drawn antialiased or not. + + Note that antialiasing settings may be overridden by QCustomPlot::setAntialiasedElements and + QCustomPlot::setNotAntialiasedElements. +*/ +void QCPLayerable::setAntialiased(bool enabled) +{ + mAntialiased = enabled; +} + +/*! + Returns whether this layerable is visible, taking the visibility of the layerable parent and the + visibility of this layerable's layer into account. This is the method that is consulted to decide + whether a layerable shall be drawn or not. + + If this layerable has a direct layerable parent (usually set via hierarchies implemented in + subclasses, like in the case of \ref QCPLayoutElement), this function returns true only if this + layerable has its visibility set to true and the parent layerable's \ref realVisibility returns + true. +*/ +bool QCPLayerable::realVisibility() const +{ + return mVisible && (!mLayer || mLayer->visible()) && (!mParentLayerable || mParentLayerable.data()->realVisibility()); +} + +/*! + This function is used to decide whether a click hits a layerable object or not. + + \a pos is a point in pixel coordinates on the QCustomPlot surface. This function returns the + shortest pixel distance of this point to the object. If the object is either invisible or the + distance couldn't be determined, -1.0 is returned. Further, if \a onlySelectable is true and the + object is not selectable, -1.0 is returned, too. + + If the object is represented not by single lines but by an area like a \ref QCPItemText or the + bars of a \ref QCPBars plottable, a click inside the area should also be considered a hit. In + these cases this function thus returns a constant value greater zero but still below the parent + plot's selection tolerance. (typically the selectionTolerance multiplied by 0.99). + + Providing a constant value for area objects allows selecting line objects even when they are + obscured by such area objects, by clicking close to the lines (i.e. closer than + 0.99*selectionTolerance). + + The actual setting of the selection state is not done by this function. This is handled by the + parent QCustomPlot when the mouseReleaseEvent occurs, and the finally selected object is notified + via the \ref selectEvent/\ref deselectEvent methods. + + \a details is an optional output parameter. Every layerable subclass may place any information + in \a details. This information will be passed to \ref selectEvent when the parent QCustomPlot + decides on the basis of this selectTest call, that the object was successfully selected. The + subsequent call to \ref selectEvent will carry the \a details. This is useful for multi-part + objects (like QCPAxis). This way, a possibly complex calculation to decide which part was clicked + is only done once in \ref selectTest. The result (i.e. the actually clicked part) can then be + placed in \a details. So in the subsequent \ref selectEvent, the decision which part was + selected doesn't have to be done a second time for a single selection operation. + + In the case of 1D Plottables (\ref QCPAbstractPlottable1D, like \ref QCPGraph or \ref QCPBars) \a + details will be set to a \ref QCPDataSelection, describing the closest data point to \a pos. + + You may pass 0 as \a details to indicate that you are not interested in those selection details. + + \see selectEvent, deselectEvent, mousePressEvent, wheelEvent, QCustomPlot::setInteractions, + QCPAbstractPlottable1D::selectTestRect +*/ +double QCPLayerable::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(pos) + Q_UNUSED(onlySelectable) + Q_UNUSED(details) + return -1.0; +} + +/*! \internal + + Sets the parent plot of this layerable. Use this function once to set the parent plot if you have + passed 0 in the constructor. It can not be used to move a layerable from one QCustomPlot to + another one. + + Note that, unlike when passing a non-null parent plot in the constructor, this function does not + make \a parentPlot the QObject-parent of this layerable. If you want this, call + QObject::setParent(\a parentPlot) in addition to this function. + + Further, you will probably want to set a layer (\ref setLayer) after calling this function, to + make the layerable appear on the QCustomPlot. + + The parent plot change will be propagated to subclasses via a call to \ref parentPlotInitialized + so they can react accordingly (e.g. also initialize the parent plot of child layerables, like + QCPLayout does). +*/ +void QCPLayerable::initializeParentPlot(QCustomPlot *parentPlot) +{ + if (mParentPlot) + { + qDebug() << Q_FUNC_INFO << "called with mParentPlot already initialized"; + return; + } + + if (!parentPlot) + qDebug() << Q_FUNC_INFO << "called with parentPlot zero"; + + mParentPlot = parentPlot; + parentPlotInitialized(mParentPlot); +} + +/*! \internal + + Sets the parent layerable of this layerable to \a parentLayerable. Note that \a parentLayerable does not + become the QObject-parent (for memory management) of this layerable. + + The parent layerable has influence on the return value of the \ref realVisibility method. Only + layerables with a fully visible parent tree will return true for \ref realVisibility, and thus be + drawn. + + \see realVisibility +*/ +void QCPLayerable::setParentLayerable(QCPLayerable *parentLayerable) +{ + mParentLayerable = parentLayerable; +} + +/*! \internal + + Moves this layerable object to \a layer. If \a prepend is true, this object will be prepended to + the new layer's list, i.e. it will be drawn below the objects already on the layer. If it is + false, the object will be appended. + + Returns true on success, i.e. if \a layer is a valid layer. +*/ +bool QCPLayerable::moveToLayer(QCPLayer *layer, bool prepend) +{ + if (layer && !mParentPlot) + { + qDebug() << Q_FUNC_INFO << "no parent QCustomPlot set"; + return false; + } + if (layer && layer->parentPlot() != mParentPlot) + { + qDebug() << Q_FUNC_INFO << "layer" << layer->name() << "is not in same QCustomPlot as this layerable"; + return false; + } + + QCPLayer *oldLayer = mLayer; + if (mLayer) + mLayer->removeChild(this); + mLayer = layer; + if (mLayer) + mLayer->addChild(this, prepend); + if (mLayer != oldLayer) + emit layerChanged(mLayer); + return true; +} + +/*! \internal + + Sets the QCPainter::setAntialiasing state on the provided \a painter, depending on the \a + localAntialiased value as well as the overrides \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. Which override enum this function takes into account is + controlled via \a overrideElement. +*/ +void QCPLayerable::applyAntialiasingHint(QCPPainter *painter, bool localAntialiased, QCP::AntialiasedElement overrideElement) const +{ + if (mParentPlot && mParentPlot->notAntialiasedElements().testFlag(overrideElement)) + painter->setAntialiasing(false); + else if (mParentPlot && mParentPlot->antialiasedElements().testFlag(overrideElement)) + painter->setAntialiasing(true); + else + painter->setAntialiasing(localAntialiased); +} + +/*! \internal + + This function is called by \ref initializeParentPlot, to allow subclasses to react on the setting + of a parent plot. This is the case when 0 was passed as parent plot in the constructor, and the + parent plot is set at a later time. + + For example, QCPLayoutElement/QCPLayout hierarchies may be created independently of any + QCustomPlot at first. When they are then added to a layout inside the QCustomPlot, the top level + element of the hierarchy gets its parent plot initialized with \ref initializeParentPlot. To + propagate the parent plot to all the children of the hierarchy, the top level element then uses + this function to pass the parent plot on to its child elements. + + The default implementation does nothing. + + \see initializeParentPlot +*/ +void QCPLayerable::parentPlotInitialized(QCustomPlot *parentPlot) +{ + Q_UNUSED(parentPlot) +} + +/*! \internal + + Returns the selection category this layerable shall belong to. The selection category is used in + conjunction with \ref QCustomPlot::setInteractions to control which objects are selectable and + which aren't. + + Subclasses that don't fit any of the normal \ref QCP::Interaction values can use \ref + QCP::iSelectOther. This is what the default implementation returns. + + \see QCustomPlot::setInteractions +*/ +QCP::Interaction QCPLayerable::selectionCategory() const +{ + return QCP::iSelectOther; +} + +/*! \internal + + Returns the clipping rectangle of this layerable object. By default, this is the viewport of the + parent QCustomPlot. Specific subclasses may reimplement this function to provide different + clipping rects. + + The returned clipping rect is set on the painter before the draw function of the respective + object is called. +*/ +QRect QCPLayerable::clipRect() const +{ + if (mParentPlot) + return mParentPlot->viewport(); + else + return QRect(); +} + +/*! \internal + + This event is called when the layerable shall be selected, as a consequence of a click by the + user. Subclasses should react to it by setting their selection state appropriately. The default + implementation does nothing. + + \a event is the mouse event that caused the selection. \a additive indicates, whether the user + was holding the multi-select-modifier while performing the selection (see \ref + QCustomPlot::setMultiSelectModifier). if \a additive is true, the selection state must be toggled + (i.e. become selected when unselected and unselected when selected). + + Every selectEvent is preceded by a call to \ref selectTest, which has returned positively (i.e. + returned a value greater than 0 and less than the selection tolerance of the parent QCustomPlot). + The \a details data you output from \ref selectTest is fed back via \a details here. You may + use it to transport any kind of information from the selectTest to the possibly subsequent + selectEvent. Usually \a details is used to transfer which part was clicked, if it is a layerable + that has multiple individually selectable parts (like QCPAxis). This way selectEvent doesn't need + to do the calculation again to find out which part was actually clicked. + + \a selectionStateChanged is an output parameter. If the pointer is non-null, this function must + set the value either to true or false, depending on whether the selection state of this layerable + was actually changed. For layerables that only are selectable as a whole and not in parts, this + is simple: if \a additive is true, \a selectionStateChanged must also be set to true, because the + selection toggles. If \a additive is false, \a selectionStateChanged is only set to true, if the + layerable was previously unselected and now is switched to the selected state. + + \see selectTest, deselectEvent +*/ +void QCPLayerable::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) +{ + Q_UNUSED(event) + Q_UNUSED(additive) + Q_UNUSED(details) + Q_UNUSED(selectionStateChanged) +} + +/*! \internal + + This event is called when the layerable shall be deselected, either as consequence of a user + interaction or a call to \ref QCustomPlot::deselectAll. Subclasses should react to it by + unsetting their selection appropriately. + + just as in \ref selectEvent, the output parameter \a selectionStateChanged (if non-null), must + return true or false when the selection state of this layerable has changed or not changed, + respectively. + + \see selectTest, selectEvent +*/ +void QCPLayerable::deselectEvent(bool *selectionStateChanged) +{ + Q_UNUSED(selectionStateChanged) +} + +/*! + This event gets called when the user presses a mouse button while the cursor is over the + layerable. Whether a cursor is over the layerable is decided by a preceding call to \ref + selectTest. + + The current pixel position of the cursor on the QCustomPlot widget is accessible via \c + event->pos(). The parameter \a details contains layerable-specific details about the hit, which + were generated in the previous call to \ref selectTest. For example, One-dimensional plottables + like \ref QCPGraph or \ref QCPBars convey the clicked data point in the \a details parameter, as + \ref QCPDataSelection packed as QVariant. Multi-part objects convey the specific \c + SelectablePart that was hit (e.g. \ref QCPAxis::SelectablePart in the case of axes). + + QCustomPlot uses an event propagation system that works the same as Qt's system. If your + layerable doesn't reimplement the \ref mousePressEvent or explicitly calls \c event->ignore() in + its reimplementation, the event will be propagated to the next layerable in the stacking order. + + Once a layerable has accepted the \ref mousePressEvent, it is considered the mouse grabber and + will receive all following calls to \ref mouseMoveEvent or \ref mouseReleaseEvent for this mouse + interaction (a "mouse interaction" in this context ends with the release). + + The default implementation does nothing except explicitly ignoring the event with \c + event->ignore(). + + \see mouseMoveEvent, mouseReleaseEvent, mouseDoubleClickEvent, wheelEvent +*/ +void QCPLayerable::mousePressEvent(QMouseEvent *event, const QVariant &details) +{ + Q_UNUSED(details) + event->ignore(); +} + +/*! + This event gets called when the user moves the mouse while holding a mouse button, after this + layerable has become the mouse grabber by accepting the preceding \ref mousePressEvent. + + The current pixel position of the cursor on the QCustomPlot widget is accessible via \c + event->pos(). The parameter \a startPos indicates the position where the initial \ref + mousePressEvent occured, that started the mouse interaction. + + The default implementation does nothing. + + \see mousePressEvent, mouseReleaseEvent, mouseDoubleClickEvent, wheelEvent +*/ +void QCPLayerable::mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) +{ + Q_UNUSED(startPos) + event->ignore(); +} + +/*! + This event gets called when the user releases the mouse button, after this layerable has become + the mouse grabber by accepting the preceding \ref mousePressEvent. + + The current pixel position of the cursor on the QCustomPlot widget is accessible via \c + event->pos(). The parameter \a startPos indicates the position where the initial \ref + mousePressEvent occured, that started the mouse interaction. + + The default implementation does nothing. + + \see mousePressEvent, mouseMoveEvent, mouseDoubleClickEvent, wheelEvent +*/ +void QCPLayerable::mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) +{ + Q_UNUSED(startPos) + event->ignore(); +} + +/*! + This event gets called when the user presses the mouse button a second time in a double-click, + while the cursor is over the layerable. Whether a cursor is over the layerable is decided by a + preceding call to \ref selectTest. + + The \ref mouseDoubleClickEvent is called instead of the second \ref mousePressEvent. So in the + case of a double-click, the event succession is + pressEvent – releaseEvent – doubleClickEvent – releaseEvent. + + The current pixel position of the cursor on the QCustomPlot widget is accessible via \c + event->pos(). The parameter \a details contains layerable-specific details about the hit, which + were generated in the previous call to \ref selectTest. For example, One-dimensional plottables + like \ref QCPGraph or \ref QCPBars convey the clicked data point in the \a details parameter, as + \ref QCPDataSelection packed as QVariant. Multi-part objects convey the specific \c + SelectablePart that was hit (e.g. \ref QCPAxis::SelectablePart in the case of axes). + + Similarly to \ref mousePressEvent, once a layerable has accepted the \ref mouseDoubleClickEvent, + it is considered the mouse grabber and will receive all following calls to \ref mouseMoveEvent + and \ref mouseReleaseEvent for this mouse interaction (a "mouse interaction" in this context ends + with the release). + + The default implementation does nothing except explicitly ignoring the event with \c + event->ignore(). + + \see mousePressEvent, mouseMoveEvent, mouseReleaseEvent, wheelEvent +*/ +void QCPLayerable::mouseDoubleClickEvent(QMouseEvent *event, const QVariant &details) +{ + Q_UNUSED(details) + event->ignore(); +} + +/*! + This event gets called when the user turns the mouse scroll wheel while the cursor is over the + layerable. Whether a cursor is over the layerable is decided by a preceding call to \ref + selectTest. + + The current pixel position of the cursor on the QCustomPlot widget is accessible via \c + event->pos(). + + The \c event->delta() indicates how far the mouse wheel was turned, which is usually +/- 120 for + single rotation steps. However, if the mouse wheel is turned rapidly, multiple steps may + accumulate to one event, making \c event->delta() larger. On the other hand, if the wheel has + very smooth steps or none at all, the delta may be smaller. + + The default implementation does nothing. + + \see mousePressEvent, mouseMoveEvent, mouseReleaseEvent, mouseDoubleClickEvent +*/ +void QCPLayerable::wheelEvent(QWheelEvent *event) +{ + event->ignore(); +} +/* end of 'src/layer.cpp' */ + + +/* including file 'src/axis/range.cpp', size 12221 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPRange +//////////////////////////////////////////////////////////////////////////////////////////////////// +/*! \class QCPRange + \brief Represents the range an axis is encompassing. + + contains a \a lower and \a upper double value and provides convenience input, output and + modification functions. + + \see QCPAxis::setRange +*/ + +/* start of documentation of inline functions */ + +/*! \fn double QCPRange::size() const + + Returns the size of the range, i.e. \a upper-\a lower +*/ + +/*! \fn double QCPRange::center() const + + Returns the center of the range, i.e. (\a upper+\a lower)*0.5 +*/ + +/*! \fn void QCPRange::normalize() + + Makes sure \a lower is numerically smaller than \a upper. If this is not the case, the values are + swapped. +*/ + +/*! \fn bool QCPRange::contains(double value) const + + Returns true when \a value lies within or exactly on the borders of the range. +*/ + +/*! \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 of documentation of inline functions */ + +/*! + Minimum range size (\a upper - \a lower) the range changing functions will accept. Smaller + intervals would cause errors due to the 11-bit exponent of double precision numbers, + corresponding to a minimum magnitude of roughly 1e-308. + + \warning Do not use this constant to indicate "arbitrarily small" values in plotting logic (as + values that will appear in the plot)! It is intended only as a bound to compare against, e.g. to + prevent axis ranges from obtaining underflowing ranges. + + \see validRange, maxRange +*/ +const double QCPRange::minRange = 1e-280; + +/*! + Maximum values (negative and positive) the range will accept in range-changing functions. + Larger absolute values would cause errors due to the 11-bit exponent of double precision numbers, + corresponding to a maximum magnitude of roughly 1e308. + + \warning Do not use this constant to indicate "arbitrarily large" values in plotting logic (as + values that will appear in the plot)! It is intended only as a bound to compare against, e.g. to + prevent axis ranges from obtaining overflowing ranges. + + \see validRange, minRange +*/ +const double QCPRange::maxRange = 1e250; + +/*! + Constructs a range with \a lower and \a upper set to zero. +*/ +QCPRange::QCPRange() : + lower(0), + upper(0) +{ +} + +/*! \overload + + Constructs a range with the specified \a lower and \a upper values. + + The resulting range will be normalized (see \ref normalize), so if \a lower is not numerically + smaller than \a upper, they will be swapped. +*/ +QCPRange::QCPRange(double lower, double upper) : + lower(lower), + upper(upper) +{ + normalize(); +} + +/*! \overload + + Expands this range such that \a otherRange is contained in the new range. It is assumed that both + this range and \a otherRange are normalized (see \ref normalize). + + If this range contains NaN as lower or upper bound, it will be replaced by the respective bound + of \a otherRange. + + If \a otherRange is already inside the current range, this function does nothing. + + \see expanded +*/ +void QCPRange::expand(const QCPRange &otherRange) +{ + if (lower > otherRange.lower || qIsNaN(lower)) + lower = otherRange.lower; + if (upper < otherRange.upper || qIsNaN(upper)) + upper = otherRange.upper; +} + +/*! \overload + + Expands this range such that \a includeCoord is contained in the new range. It is assumed that + this range is normalized (see \ref normalize). + + If this range contains NaN as lower or upper bound, the respective bound will be set to \a + includeCoord. + + If \a includeCoord is already inside the current range, this function does nothing. + + \see expand +*/ +void QCPRange::expand(double includeCoord) +{ + if (lower > includeCoord || qIsNaN(lower)) + lower = includeCoord; + if (upper < includeCoord || qIsNaN(upper)) + upper = includeCoord; +} + + +/*! \overload + + Returns an expanded range that contains this and \a otherRange. It is assumed that both this + range and \a otherRange are normalized (see \ref normalize). + + If this range contains NaN as lower or upper bound, the returned range's bound will be taken from + \a otherRange. + + \see expand +*/ +QCPRange QCPRange::expanded(const QCPRange &otherRange) const +{ + QCPRange result = *this; + result.expand(otherRange); + return result; +} + +/*! \overload + + Returns an expanded range that includes the specified \a includeCoord. It is assumed that this + range is normalized (see \ref normalize). + + If this range contains NaN as lower or upper bound, the returned range's bound will be set to \a + includeCoord. + + \see expand +*/ +QCPRange QCPRange::expanded(double includeCoord) const +{ + QCPRange result = *this; + result.expand(includeCoord); + return result; +} + +/*! + Returns this range, possibly modified to not exceed the bounds provided as \a lowerBound and \a + upperBound. If possible, the size of the current range is preserved in the process. + + If the range shall only be bounded at the lower side, you can set \a upperBound to \ref + QCPRange::maxRange. If it shall only be bounded at the upper side, set \a lowerBound to -\ref + QCPRange::maxRange. +*/ +QCPRange QCPRange::bounded(double lowerBound, double upperBound) const +{ + if (lowerBound > upperBound) + qSwap(lowerBound, upperBound); + + QCPRange result(lower, upper); + if (result.lower < lowerBound) + { + result.lower = lowerBound; + result.upper = lowerBound + size(); + if (result.upper > upperBound || qFuzzyCompare(size(), upperBound-lowerBound)) + result.upper = upperBound; + } else if (result.upper > upperBound) + { + result.upper = upperBound; + result.lower = upperBound - size(); + if (result.lower < lowerBound || qFuzzyCompare(size(), upperBound-lowerBound)) + result.lower = lowerBound; + } + + return result; +} + +/*! + Returns a sanitized version of the range. Sanitized means for logarithmic scales, that + the range won't span the positive and negative sign domain, i.e. contain zero. Further + \a lower will always be numerically smaller (or equal) to \a upper. + + If the original range does span positive and negative sign domains or contains zero, + the returned range will try to approximate the original range as good as possible. + If the positive interval of the original range is wider than the negative interval, the + returned range will only contain the positive interval, with lower bound set to \a rangeFac or + \a rangeFac *\a upper, whichever is closer to zero. Same procedure is used if the negative interval + is wider than the positive interval, this time by changing the \a upper bound. +*/ +QCPRange QCPRange::sanitizedForLogScale() const +{ + double rangeFac = 1e-3; + QCPRange sanitizedRange(lower, upper); + sanitizedRange.normalize(); + // can't have range spanning negative and positive values in log plot, so change range to fix it + //if (qFuzzyCompare(sanitizedRange.lower+1, 1) && !qFuzzyCompare(sanitizedRange.upper+1, 1)) + if (sanitizedRange.lower == 0.0 && sanitizedRange.upper != 0.0) + { + // case lower is 0 + if (rangeFac < sanitizedRange.upper*rangeFac) + sanitizedRange.lower = rangeFac; + else + sanitizedRange.lower = sanitizedRange.upper*rangeFac; + } //else if (!qFuzzyCompare(lower+1, 1) && qFuzzyCompare(upper+1, 1)) + else if (sanitizedRange.lower != 0.0 && sanitizedRange.upper == 0.0) + { + // case upper is 0 + if (-rangeFac > sanitizedRange.lower*rangeFac) + sanitizedRange.upper = -rangeFac; + else + sanitizedRange.upper = sanitizedRange.lower*rangeFac; + } else if (sanitizedRange.lower < 0 && sanitizedRange.upper > 0) + { + // find out whether negative or positive interval is wider to decide which sign domain will be chosen + if (-sanitizedRange.lower > sanitizedRange.upper) + { + // negative is wider, do same as in case upper is 0 + if (-rangeFac > sanitizedRange.lower*rangeFac) + sanitizedRange.upper = -rangeFac; + else + sanitizedRange.upper = sanitizedRange.lower*rangeFac; + } else + { + // positive is wider, do same as in case lower is 0 + if (rangeFac < sanitizedRange.upper*rangeFac) + sanitizedRange.lower = rangeFac; + else + sanitizedRange.lower = sanitizedRange.upper*rangeFac; + } + } + // due to normalization, case lower>0 && upper<0 should never occur, because that implies upper -maxRange && + upper < maxRange && + qAbs(lower-upper) > minRange && + qAbs(lower-upper) < maxRange && + !(lower > 0 && qIsInf(upper/lower)) && + !(upper < 0 && qIsInf(lower/upper))); +} + +/*! + \overload + Checks, whether the specified range is within valid bounds, which are defined + as QCPRange::maxRange and QCPRange::minRange. + A valid range means: + \li range bounds within -maxRange and maxRange + \li range size above minRange + \li range size below maxRange +*/ +bool QCPRange::validRange(const QCPRange &range) +{ + return (range.lower > -maxRange && + range.upper < maxRange && + qAbs(range.lower-range.upper) > minRange && + qAbs(range.lower-range.upper) < maxRange && + !(range.lower > 0 && qIsInf(range.upper/range.lower)) && + !(range.upper < 0 && qIsInf(range.lower/range.upper))); +} +/* end of 'src/axis/range.cpp' */ + + +/* including file 'src/selection.cpp', size 21941 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPDataRange +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPDataRange + \brief Describes a data range given by begin and end index + + QCPDataRange holds two integers describing the begin (\ref setBegin) and end (\ref setEnd) index + of a contiguous set of data points. The end index points to the data point just after the last + data point that's part of the data range, similarly to the nomenclature used in standard + iterators. + + Data Ranges are not bound to a certain plottable, thus they can be freely exchanged, created and + modified. If a non-contiguous data set shall be described, the class \ref QCPDataSelection is + used, which holds and manages multiple instances of \ref QCPDataRange. In most situations, \ref + QCPDataSelection is thus used. + + Both \ref QCPDataRange and \ref QCPDataSelection offer convenience methods to work with them, + e.g. \ref bounded, \ref expanded, \ref intersects, \ref intersection, \ref adjusted, \ref + contains. Further, addition and subtraction operators (defined in \ref QCPDataSelection) can be + used to join/subtract data ranges and data selections (or mixtures), to retrieve a corresponding + \ref QCPDataSelection. + + %QCustomPlot's \ref dataselection "data selection mechanism" is based on \ref QCPDataSelection and + QCPDataRange. + + \note Do not confuse \ref QCPDataRange with \ref QCPRange. A \ref QCPRange describes an interval + in floating point plot coordinates, e.g. the current axis range. +*/ + +/* start documentation of inline functions */ + +/*! \fn int QCPDataRange::size() const + + Returns the number of data points described by this data range. This is equal to the end index + minus the begin index. + + \see length +*/ + +/*! \fn int QCPDataRange::length() const + + Returns the number of data points described by this data range. Equivalent to \ref size. +*/ + +/*! \fn void QCPDataRange::setBegin(int begin) + + Sets the begin of this data range. The \a begin index points to the first data point that is part + of the data range. + + No checks or corrections are made to ensure the resulting range is valid (\ref isValid). + + \see setEnd +*/ + +/*! \fn void QCPDataRange::setEnd(int end) + + Sets the end of this data range. The \a end index points to the data point just after the last + data point that is part of the data range. + + No checks or corrections are made to ensure the resulting range is valid (\ref isValid). + + \see setBegin +*/ + +/*! \fn bool QCPDataRange::isValid() const + + Returns whether this range is valid. A valid range has a begin index greater or equal to 0, and + an end index greater or equal to the begin index. + + \note Invalid ranges should be avoided and are never the result of any of QCustomPlot's methods + (unless they are themselves fed with invalid ranges). Do not pass invalid ranges to QCustomPlot's + methods. The invalid range is not inherently prevented in QCPDataRange, to allow temporary + invalid begin/end values while manipulating the range. An invalid range is not necessarily empty + (\ref isEmpty), since its \ref length can be negative and thus non-zero. +*/ + +/*! \fn bool QCPDataRange::isEmpty() const + + Returns whether this range is empty, i.e. whether its begin index equals its end index. + + \see size, length +*/ + +/*! \fn QCPDataRange QCPDataRange::adjusted(int changeBegin, int changeEnd) const + + Returns a data range where \a changeBegin and \a changeEnd were added to the begin and end + indices, respectively. +*/ + +/* end documentation of inline functions */ + +/*! + Creates an empty QCPDataRange, with begin and end set to 0. +*/ +QCPDataRange::QCPDataRange() : + mBegin(0), + mEnd(0) +{ +} + +/*! + Creates a QCPDataRange, initialized with the specified \a begin and \a end. + + No checks or corrections are made to ensure the resulting range is valid (\ref isValid). +*/ +QCPDataRange::QCPDataRange(int begin, int end) : + mBegin(begin), + mEnd(end) +{ +} + +/*! + Returns a data range that matches this data range, except that parts exceeding \a other are + excluded. + + This method is very similar to \ref intersection, with one distinction: If this range and the \a + other range share no intersection, the returned data range will be empty with begin and end set + to the respective boundary side of \a other, at which this range is residing. (\ref intersection + would just return a range with begin and end set to 0.) +*/ +QCPDataRange QCPDataRange::bounded(const QCPDataRange &other) const +{ + QCPDataRange result(intersection(other)); + if (result.isEmpty()) // no intersection, preserve respective bounding side of otherRange as both begin and end of return value + { + if (mEnd <= other.mBegin) + result = QCPDataRange(other.mBegin, other.mBegin); + else + result = QCPDataRange(other.mEnd, other.mEnd); + } + return result; +} + +/*! + Returns a data range that contains both this data range as well as \a other. +*/ +QCPDataRange QCPDataRange::expanded(const QCPDataRange &other) const +{ + return QCPDataRange(qMin(mBegin, other.mBegin), qMax(mEnd, other.mEnd)); +} + +/*! + Returns the data range which is contained in both this data range and \a other. + + This method is very similar to \ref bounded, with one distinction: If this range and the \a other + range share no intersection, the returned data range will be empty with begin and end set to 0. + (\ref bounded would return a range with begin and end set to one of the boundaries of \a other, + depending on which side this range is on.) + + \see QCPDataSelection::intersection +*/ +QCPDataRange QCPDataRange::intersection(const QCPDataRange &other) const +{ + QCPDataRange result(qMax(mBegin, other.mBegin), qMin(mEnd, other.mEnd)); + if (result.isValid()) + return result; + else + return QCPDataRange(); +} + +/*! + Returns whether this data range and \a other share common data points. + + \see intersection, contains +*/ +bool QCPDataRange::intersects(const QCPDataRange &other) const +{ + return !( (mBegin > other.mBegin && mBegin >= other.mEnd) || + (mEnd <= other.mBegin && mEnd < other.mEnd) ); +} + +/*! + Returns whether all data points of \a other are also contained inside this data range. + + \see intersects +*/ +bool QCPDataRange::contains(const QCPDataRange &other) const +{ + return mBegin <= other.mBegin && mEnd >= other.mEnd; +} + + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPDataSelection +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPDataSelection + \brief Describes a data set by holding multiple QCPDataRange instances + + QCPDataSelection manages multiple instances of QCPDataRange in order to represent any (possibly + disjoint) set of data selection. + + The data selection can be modified with addition and subtraction operators which take + QCPDataSelection and QCPDataRange instances, as well as methods such as \ref addDataRange and + \ref clear. Read access is provided by \ref dataRange, \ref dataRanges, \ref dataRangeCount, etc. + + The method \ref simplify is used to join directly adjacent or even overlapping QCPDataRange + instances. QCPDataSelection automatically simplifies when using the addition/subtraction + operators. The only case when \ref simplify is left to the user, is when calling \ref + addDataRange, with the parameter \a simplify explicitly set to false. This is useful if many data + ranges will be added to the selection successively and the overhead for simplifying after each + iteration shall be avoided. In this case, you should make sure to call \ref simplify after + completing the operation. + + Use \ref enforceType to bring the data selection into a state complying with the constraints for + selections defined in \ref QCP::SelectionType. + + %QCustomPlot's \ref dataselection "data selection mechanism" is based on QCPDataSelection and + QCPDataRange. + + \section qcpdataselection-iterating Iterating over a data selection + + As an example, the following code snippet calculates the average value of a graph's data + \ref QCPAbstractPlottable::selection "selection": + + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpdataselection-iterating-1 + +*/ + +/* start documentation of inline functions */ + +/*! \fn int QCPDataSelection::dataRangeCount() const + + Returns the number of ranges that make up the data selection. The ranges can be accessed by \ref + dataRange via their index. + + \see dataRange, dataPointCount +*/ + +/*! \fn QList QCPDataSelection::dataRanges() const + + Returns all data ranges that make up the data selection. If the data selection is simplified (the + usual state of the selection, see \ref simplify), the ranges are sorted by ascending data point + index. + + \see dataRange +*/ + +/*! \fn bool QCPDataSelection::isEmpty() const + + Returns true if there are no data ranges, and thus no data points, in this QCPDataSelection + instance. + + \see dataRangeCount +*/ + +/* end documentation of inline functions */ + +/*! + Creates an empty QCPDataSelection. +*/ +QCPDataSelection::QCPDataSelection() +{ +} + +/*! + Creates a QCPDataSelection containing the provided \a range. +*/ +QCPDataSelection::QCPDataSelection(const QCPDataRange &range) +{ + mDataRanges.append(range); +} + +/*! + Returns true if this selection is identical (contains the same data ranges with the same begin + and end indices) to \a other. + + Note that both data selections must be in simplified state (the usual state of the selection, see + \ref simplify) for this operator to return correct results. +*/ +bool QCPDataSelection::operator==(const QCPDataSelection &other) const +{ + if (mDataRanges.size() != other.mDataRanges.size()) + return false; + for (int i=0; i= other.end()) + break; // since data ranges are sorted after the simplify() call, no ranges which contain other will come after this + + if (thisEnd > other.begin()) // ranges which don't fulfill this are entirely before other and can be ignored + { + if (thisBegin >= other.begin()) // range leading segment is encompassed + { + if (thisEnd <= other.end()) // range fully encompassed, remove completely + { + mDataRanges.removeAt(i); + continue; + } else // only leading segment is encompassed, trim accordingly + mDataRanges[i].setBegin(other.end()); + } else // leading segment is not encompassed + { + if (thisEnd <= other.end()) // only trailing segment is encompassed, trim accordingly + { + mDataRanges[i].setEnd(other.begin()); + } else // other lies inside this range, so split range + { + mDataRanges[i].setEnd(other.begin()); + mDataRanges.insert(i+1, QCPDataRange(other.end(), thisEnd)); + break; // since data ranges are sorted (and don't overlap) after simplify() call, we're done here + } + } + } + ++i; + } + + return *this; +} + +/*! + Returns the total number of data points contained in all data ranges that make up this data + selection. +*/ +int QCPDataSelection::dataPointCount() const +{ + int result = 0; + for (int i=0; i= 0 && index < mDataRanges.size()) + { + return mDataRanges.at(index); + } else + { + qDebug() << Q_FUNC_INFO << "index out of range:" << index; + return QCPDataRange(); + } +} + +/*! + Returns a \ref QCPDataRange which spans the entire data selection, including possible + intermediate segments which are not part of the original data selection. +*/ +QCPDataRange QCPDataSelection::span() const +{ + if (isEmpty()) + return QCPDataRange(); + else + return QCPDataRange(mDataRanges.first().begin(), mDataRanges.last().end()); +} + +/*! + Adds the given \a dataRange to this data selection. This is equivalent to the += operator but + allows disabling immediate simplification by setting \a simplify to false. This can improve + performance if adding a very large amount of data ranges successively. In this case, make sure to + call \ref simplify manually, after the operation. +*/ +void QCPDataSelection::addDataRange(const QCPDataRange &dataRange, bool simplify) +{ + mDataRanges.append(dataRange); + if (simplify) + this->simplify(); +} + +/*! + Removes all data ranges. The data selection then contains no data points. + + \ref isEmpty +*/ +void QCPDataSelection::clear() +{ + mDataRanges.clear(); +} + +/*! + Sorts all data ranges by range begin index in ascending order, and then joins directly adjacent + or overlapping ranges. This can reduce the number of individual data ranges in the selection, and + prevents possible double-counting when iterating over the data points held by the data ranges. + + This method is automatically called when using the addition/subtraction operators. The only case + when \ref simplify is left to the user, is when calling \ref addDataRange, with the parameter \a + simplify explicitly set to false. +*/ +void QCPDataSelection::simplify() +{ + // remove any empty ranges: + for (int i=mDataRanges.size()-1; i>=0; --i) + { + if (mDataRanges.at(i).isEmpty()) + mDataRanges.removeAt(i); + } + if (mDataRanges.isEmpty()) + return; + + // sort ranges by starting value, ascending: + std::sort(mDataRanges.begin(), mDataRanges.end(), lessThanDataRangeBegin); + + // join overlapping/contiguous ranges: + int i = 1; + while (i < mDataRanges.size()) + { + if (mDataRanges.at(i-1).end() >= mDataRanges.at(i).begin()) // range i overlaps/joins with i-1, so expand range i-1 appropriately and remove range i from list + { + mDataRanges[i-1].setEnd(qMax(mDataRanges.at(i-1).end(), mDataRanges.at(i).end())); + mDataRanges.removeAt(i); + } else + ++i; + } +} + +/*! + Makes sure this data selection conforms to the specified \a type selection type. Before the type + is enforced, \ref simplify is called. + + Depending on \a type, enforcing means adding new data points that were previously not part of the + selection, or removing data points from the selection. If the current selection already conforms + to \a type, the data selection is not changed. + + \see QCP::SelectionType +*/ +void QCPDataSelection::enforceType(QCP::SelectionType type) +{ + simplify(); + switch (type) + { + case QCP::stNone: + { + mDataRanges.clear(); + break; + } + case QCP::stWhole: + { + // whole selection isn't defined by data range, so don't change anything (is handled in plottable methods) + break; + } + case QCP::stSingleData: + { + // reduce all data ranges to the single first data point: + if (!mDataRanges.isEmpty()) + { + if (mDataRanges.size() > 1) + mDataRanges = QList() << mDataRanges.first(); + if (mDataRanges.first().length() > 1) + mDataRanges.first().setEnd(mDataRanges.first().begin()+1); + } + break; + } + case QCP::stDataRange: + { + if (!isEmpty()) + mDataRanges = QList() << span(); + break; + } + case QCP::stMultipleDataRanges: + { + // this is the selection type that allows all concievable combinations of ranges, so do nothing + break; + } + } +} + +/*! + Returns true if the data selection \a other is contained entirely in this data selection, i.e. + all data point indices that are in \a other are also in this data selection. + + \see QCPDataRange::contains +*/ +bool QCPDataSelection::contains(const QCPDataSelection &other) const +{ + if (other.isEmpty()) return false; + + int otherIndex = 0; + int thisIndex = 0; + while (thisIndex < mDataRanges.size() && otherIndex < other.mDataRanges.size()) + { + if (mDataRanges.at(thisIndex).contains(other.mDataRanges.at(otherIndex))) + ++otherIndex; + else + ++thisIndex; + } + return thisIndex < mDataRanges.size(); // if thisIndex ran all the way to the end to find a containing range for the current otherIndex, other is not contained in this +} + +/*! + Returns a data selection containing the points which are both in this data selection and in the + data range \a other. + + A common use case is to limit an unknown data selection to the valid range of a data container, + using \ref QCPDataContainer::dataRange as \a other. One can then safely iterate over the returned + data selection without exceeding the data container's bounds. +*/ +QCPDataSelection QCPDataSelection::intersection(const QCPDataRange &other) const +{ + QCPDataSelection result; + for (int i=0; iorientation() == Qt::Horizontal) + return QCPRange(axis->pixelToCoord(mRect.left()), axis->pixelToCoord(mRect.left()+mRect.width())); + else + return QCPRange(axis->pixelToCoord(mRect.top()+mRect.height()), axis->pixelToCoord(mRect.top())); + } else + { + qDebug() << Q_FUNC_INFO << "called with axis zero"; + return QCPRange(); + } +} + +/*! + Sets the pen that will be used to draw the selection rect outline. + + \see setBrush +*/ +void QCPSelectionRect::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the brush that will be used to fill the selection rect. By default the selection rect is not + filled, i.e. \a brush is Qt::NoBrush. + + \see setPen +*/ +void QCPSelectionRect::setBrush(const QBrush &brush) +{ + mBrush = brush; +} + +/*! + If there is currently a selection interaction going on (\ref isActive), the interaction is + canceled. The selection rect will emit the \ref canceled signal. +*/ +void QCPSelectionRect::cancel() +{ + if (mActive) + { + mActive = false; + emit canceled(mRect, 0); + } +} + +/*! \internal + + This method is called by QCustomPlot to indicate that a selection rect interaction was initiated. + The default implementation sets the selection rect to active, initializes the selection rect + geometry and emits the \ref started signal. +*/ +void QCPSelectionRect::startSelection(QMouseEvent *event) +{ + mActive = true; + mRect = QRect(event->pos(), event->pos()); + emit started(event); +} + +/*! \internal + + This method is called by QCustomPlot to indicate that an ongoing selection rect interaction needs + to update its geometry. The default implementation updates the rect and emits the \ref changed + signal. +*/ +void QCPSelectionRect::moveSelection(QMouseEvent *event) +{ + mRect.setBottomRight(event->pos()); + emit changed(mRect, event); + layer()->replot(); +} + +/*! \internal + + This method is called by QCustomPlot to indicate that an ongoing selection rect interaction has + finished by the user releasing the mouse button. The default implementation deactivates the + selection rect and emits the \ref accepted signal. +*/ +void QCPSelectionRect::endSelection(QMouseEvent *event) +{ + mRect.setBottomRight(event->pos()); + mActive = false; + emit accepted(mRect, event); +} + +/*! \internal + + This method is called by QCustomPlot when a key has been pressed by the user while the selection + rect interaction is active. The default implementation allows to \ref cancel the interaction by + hitting the escape key. +*/ +void QCPSelectionRect::keyPressEvent(QKeyEvent *event) +{ + if (event->key() == Qt::Key_Escape && mActive) + { + mActive = false; + emit canceled(mRect, event); + } +} + +/* inherits documentation from base class */ +void QCPSelectionRect::applyDefaultAntialiasingHint(QCPPainter *painter) const +{ + applyAntialiasingHint(painter, mAntialiased, QCP::aeOther); +} + +/*! \internal + + If the selection rect is active (\ref isActive), draws the selection rect defined by \a mRect. + + \seebaseclassmethod +*/ +void QCPSelectionRect::draw(QCPPainter *painter) +{ + if (mActive) + { + painter->setPen(mPen); + painter->setBrush(mBrush); + painter->drawRect(mRect); + } +} +/* end of 'src/selectionrect.cpp' */ + + +/* including file 'src/layout.cpp', size 79139 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPMarginGroup +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPMarginGroup + \brief A margin group allows synchronization of margin sides if working with multiple layout elements. + + QCPMarginGroup allows you to tie a margin side of two or more layout elements together, such that + they will all have the same size, based on the largest required margin in the group. + + \n + \image html QCPMarginGroup.png "Demonstration of QCPMarginGroup" + \n + + In certain situations it is desirable that margins at specific sides are synchronized across + layout elements. For example, if one QCPAxisRect is below another one in a grid layout, it will + provide a cleaner look to the user if the left and right margins of the two axis rects are of the + same size. The left axis of the top axis rect will then be at the same horizontal position as the + left axis of the lower axis rect, making them appear aligned. The same applies for the right + axes. This is what QCPMarginGroup makes possible. + + To add/remove a specific side of a layout element to/from a margin group, use the \ref + QCPLayoutElement::setMarginGroup method. To completely break apart the margin group, either call + \ref clear, or just delete the margin group. + + \section QCPMarginGroup-example Example + + First create a margin group: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpmargingroup-creation-1 + Then set this group on the layout element sides: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpmargingroup-creation-2 + Here, we've used the first two axis rects of the plot and synchronized their left margins with + each other and their right margins with each other. +*/ + +/* start documentation of inline functions */ + +/*! \fn QList QCPMarginGroup::elements(QCP::MarginSide side) const + + Returns a list of all layout elements that have their margin \a side associated with this margin + group. +*/ + +/* end documentation of inline functions */ + +/*! + Creates a new QCPMarginGroup instance in \a parentPlot. +*/ +QCPMarginGroup::QCPMarginGroup(QCustomPlot *parentPlot) : + QObject(parentPlot), + mParentPlot(parentPlot) +{ + mChildren.insert(QCP::msLeft, QList()); + mChildren.insert(QCP::msRight, QList()); + mChildren.insert(QCP::msTop, QList()); + mChildren.insert(QCP::msBottom, QList()); +} + +QCPMarginGroup::~QCPMarginGroup() +{ + clear(); +} + +/*! + Returns whether this margin group is empty. If this function returns true, no layout elements use + this margin group to synchronize margin sides. +*/ +bool QCPMarginGroup::isEmpty() const +{ + QHashIterator > it(mChildren); + while (it.hasNext()) + { + it.next(); + if (!it.value().isEmpty()) + return false; + } + return true; +} + +/*! + Clears this margin group. The synchronization of the margin sides that use this margin group is + lifted and they will use their individual margin sizes again. +*/ +void QCPMarginGroup::clear() +{ + // make all children remove themselves from this margin group: + QHashIterator > it(mChildren); + while (it.hasNext()) + { + it.next(); + const QList elements = it.value(); + for (int i=elements.size()-1; i>=0; --i) + elements.at(i)->setMarginGroup(it.key(), 0); // removes itself from mChildren via removeChild + } +} + +/*! \internal + + Returns the synchronized common margin for \a side. This is the margin value that will be used by + the layout element on the respective side, if it is part of this margin group. + + The common margin is calculated by requesting the automatic margin (\ref + QCPLayoutElement::calculateAutoMargin) of each element associated with \a side in this margin + group, and choosing the largest returned value. (QCPLayoutElement::minimumMargins is taken into + account, too.) +*/ +int QCPMarginGroup::commonMargin(QCP::MarginSide side) const +{ + // query all automatic margins of the layout elements in this margin group side and find maximum: + int result = 0; + const QList elements = mChildren.value(side); + for (int i=0; iautoMargins().testFlag(side)) + continue; + int m = qMax(elements.at(i)->calculateAutoMargin(side), QCP::getMarginValue(elements.at(i)->minimumMargins(), side)); + if (m > result) + result = m; + } + return result; +} + +/*! \internal + + Adds \a element to the internal list of child elements, for the margin \a side. + + This function does not modify the margin group property of \a element. +*/ +void QCPMarginGroup::addChild(QCP::MarginSide side, QCPLayoutElement *element) +{ + if (!mChildren[side].contains(element)) + mChildren[side].append(element); + else + qDebug() << Q_FUNC_INFO << "element is already child of this margin group side" << reinterpret_cast(element); +} + +/*! \internal + + Removes \a element from the internal list of child elements, for the margin \a side. + + This function does not modify the margin group property of \a element. +*/ +void QCPMarginGroup::removeChild(QCP::MarginSide side, QCPLayoutElement *element) +{ + if (!mChildren[side].removeOne(element)) + qDebug() << Q_FUNC_INFO << "element is not child of this margin group side" << reinterpret_cast(element); +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPLayoutElement +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPLayoutElement + \brief The abstract base class for all objects that form \ref thelayoutsystem "the layout system". + + This is an abstract base class. As such, it can't be instantiated directly, rather use one of its subclasses. + + A Layout element is a rectangular object which can be placed in layouts. It has an outer rect + (QCPLayoutElement::outerRect) and an inner rect (\ref QCPLayoutElement::rect). The difference + between outer and inner rect is called its margin. The margin can either be set to automatic or + manual (\ref setAutoMargins) on a per-side basis. If a side is set to manual, that margin can be + set explicitly with \ref setMargins and will stay fixed at that value. If it's set to automatic, + the layout element subclass will control the value itself (via \ref calculateAutoMargin). + + Layout elements can be placed in layouts (base class QCPLayout) like QCPLayoutGrid. The top level + layout is reachable via \ref QCustomPlot::plotLayout, and is a \ref QCPLayoutGrid. Since \ref + QCPLayout itself derives from \ref QCPLayoutElement, layouts can be nested. + + Thus in QCustomPlot one can divide layout elements into two categories: The ones that are + invisible by themselves, because they don't draw anything. Their only purpose is to manage the + position and size of other layout elements. This category of layout elements usually use + QCPLayout as base class. Then there is the category of layout elements which actually draw + something. For example, QCPAxisRect, QCPLegend and QCPTextElement are of this category. This does + not necessarily mean that the latter category can't have child layout elements. QCPLegend for + instance, actually derives from QCPLayoutGrid and the individual legend items are child layout + elements in the grid layout. +*/ + +/* start documentation of inline functions */ + +/*! \fn QCPLayout *QCPLayoutElement::layout() const + + Returns the parent layout of this layout element. +*/ + +/*! \fn QRect QCPLayoutElement::rect() const + + Returns the inner rect of this layout element. The inner rect is the outer rect (\ref outerRect, \ref + setOuterRect) shrinked by the margins (\ref setMargins, \ref setAutoMargins). + + In some cases, the area between outer and inner rect is left blank. In other cases the margin + area is used to display peripheral graphics while the main content is in the inner rect. This is + where automatic margin calculation becomes interesting because it allows the layout element to + adapt the margins to the peripheral graphics it wants to draw. For example, \ref QCPAxisRect + draws the axis labels and tick labels in the margin area, thus needs to adjust the margins (if + \ref setAutoMargins is enabled) according to the space required by the labels of the axes. + + \see outerRect +*/ + +/*! \fn QRect QCPLayoutElement::outerRect() const + + Returns the outer rect of this layout element. The outer rect is the inner rect expanded by the + margins (\ref setMargins, \ref setAutoMargins). The outer rect is used (and set via \ref + setOuterRect) by the parent \ref QCPLayout to control the size of this layout element. + + \see rect +*/ + +/* end documentation of inline functions */ + +/*! + Creates an instance of QCPLayoutElement and sets default values. +*/ +QCPLayoutElement::QCPLayoutElement(QCustomPlot *parentPlot) : + QCPLayerable(parentPlot), // parenthood is changed as soon as layout element gets inserted into a layout (except for top level layout) + mParentLayout(0), + mMinimumSize(), + mMaximumSize(QWIDGETSIZE_MAX, QWIDGETSIZE_MAX), + mSizeConstraintRect(scrInnerRect), + mRect(0, 0, 0, 0), + mOuterRect(0, 0, 0, 0), + mMargins(0, 0, 0, 0), + mMinimumMargins(0, 0, 0, 0), + mAutoMargins(QCP::msAll) +{ +} + +QCPLayoutElement::~QCPLayoutElement() +{ + setMarginGroup(QCP::msAll, 0); // unregister at margin groups, if there are any + // unregister at layout: + if (qobject_cast(mParentLayout)) // the qobject_cast is just a safeguard in case the layout forgets to call clear() in its dtor and this dtor is called by QObject dtor + mParentLayout->take(this); +} + +/*! + Sets the outer rect of this layout element. If the layout element is inside a layout, the layout + sets the position and size of this layout element using this function. + + Calling this function externally has no effect, since the layout will overwrite any changes to + the outer rect upon the next replot. + + The layout element will adapt its inner \ref rect by applying the margins inward to the outer rect. + + \see rect +*/ +void QCPLayoutElement::setOuterRect(const QRect &rect) +{ + if (mOuterRect != rect) + { + mOuterRect = rect; + mRect = mOuterRect.adjusted(mMargins.left(), mMargins.top(), -mMargins.right(), -mMargins.bottom()); + } +} + +/*! + Sets the margins of this layout element. If \ref setAutoMargins is disabled for some or all + sides, this function is used to manually set the margin on those sides. Sides that are still set + to be handled automatically are ignored and may have any value in \a margins. + + The margin is the distance between the outer rect (controlled by the parent layout via \ref + setOuterRect) and the inner \ref rect (which usually contains the main content of this layout + element). + + \see setAutoMargins +*/ +void QCPLayoutElement::setMargins(const QMargins &margins) +{ + if (mMargins != margins) + { + mMargins = margins; + mRect = mOuterRect.adjusted(mMargins.left(), mMargins.top(), -mMargins.right(), -mMargins.bottom()); + } +} + +/*! + If \ref setAutoMargins is enabled on some or all margins, this function is used to provide + minimum values for those margins. + + The minimum values are not enforced on margin sides that were set to be under manual control via + \ref setAutoMargins. + + \see setAutoMargins +*/ +void QCPLayoutElement::setMinimumMargins(const QMargins &margins) +{ + if (mMinimumMargins != margins) + { + mMinimumMargins = margins; + } +} + +/*! + Sets on which sides the margin shall be calculated automatically. If a side is calculated + automatically, a minimum margin value may be provided with \ref setMinimumMargins. If a side is + set to be controlled manually, the value may be specified with \ref setMargins. + + Margin sides that are under automatic control may participate in a \ref QCPMarginGroup (see \ref + setMarginGroup), to synchronize (align) it with other layout elements in the plot. + + \see setMinimumMargins, setMargins, QCP::MarginSide +*/ +void QCPLayoutElement::setAutoMargins(QCP::MarginSides sides) +{ + mAutoMargins = sides; +} + +/*! + Sets the minimum size of this layout element. A parent layout tries to respect the \a size here + by changing row/column sizes in the layout accordingly. + + If the parent layout size is not sufficient to satisfy all minimum size constraints of its child + layout elements, the layout may set a size that is actually smaller than \a size. QCustomPlot + propagates the layout's size constraints to the outside by setting its own minimum QWidget size + accordingly, so violations of \a size should be exceptions. + + Whether this constraint applies to the inner or the outer rect can be specified with \ref + setSizeConstraintRect (see \ref rect and \ref outerRect). +*/ +void QCPLayoutElement::setMinimumSize(const QSize &size) +{ + if (mMinimumSize != size) + { + mMinimumSize = size; + if (mParentLayout) + mParentLayout->sizeConstraintsChanged(); + } +} + +/*! \overload + + Sets the minimum size of this layout element. + + Whether this constraint applies to the inner or the outer rect can be specified with \ref + setSizeConstraintRect (see \ref rect and \ref outerRect). +*/ +void QCPLayoutElement::setMinimumSize(int width, int height) +{ + setMinimumSize(QSize(width, height)); +} + +/*! + Sets the maximum size of this layout element. A parent layout tries to respect the \a size here + by changing row/column sizes in the layout accordingly. + + Whether this constraint applies to the inner or the outer rect can be specified with \ref + setSizeConstraintRect (see \ref rect and \ref outerRect). +*/ +void QCPLayoutElement::setMaximumSize(const QSize &size) +{ + if (mMaximumSize != size) + { + mMaximumSize = size; + if (mParentLayout) + mParentLayout->sizeConstraintsChanged(); + } +} + +/*! \overload + + Sets the maximum size of this layout element. + + Whether this constraint applies to the inner or the outer rect can be specified with \ref + setSizeConstraintRect (see \ref rect and \ref outerRect). +*/ +void QCPLayoutElement::setMaximumSize(int width, int height) +{ + setMaximumSize(QSize(width, height)); +} + +/*! + Sets to which rect of a layout element the size constraints apply. Size constraints can be set + via \ref setMinimumSize and \ref setMaximumSize. + + The outer rect (\ref outerRect) includes the margins (e.g. in the case of a QCPAxisRect the axis + labels), whereas the inner rect (\ref rect) does not. + + \see setMinimumSize, setMaximumSize +*/ +void QCPLayoutElement::setSizeConstraintRect(SizeConstraintRect constraintRect) +{ + if (mSizeConstraintRect != constraintRect) + { + mSizeConstraintRect = constraintRect; + if (mParentLayout) + mParentLayout->sizeConstraintsChanged(); + } +} + +/*! + Sets the margin \a group of the specified margin \a sides. + + Margin groups allow synchronizing specified margins across layout elements, see the documentation + of \ref QCPMarginGroup. + + To unset the margin group of \a sides, set \a group to 0. + + Note that margin groups only work for margin sides that are set to automatic (\ref + setAutoMargins). + + \see QCP::MarginSide +*/ +void QCPLayoutElement::setMarginGroup(QCP::MarginSides sides, QCPMarginGroup *group) +{ + QVector sideVector; + if (sides.testFlag(QCP::msLeft)) sideVector.append(QCP::msLeft); + if (sides.testFlag(QCP::msRight)) sideVector.append(QCP::msRight); + if (sides.testFlag(QCP::msTop)) sideVector.append(QCP::msTop); + if (sides.testFlag(QCP::msBottom)) sideVector.append(QCP::msBottom); + + for (int i=0; iremoveChild(side, this); + + if (!group) // if setting to 0, remove hash entry. Else set hash entry to new group and register there + { + mMarginGroups.remove(side); + } else // setting to a new group + { + mMarginGroups[side] = group; + group->addChild(side, this); + } + } + } +} + +/*! + Updates the layout element and sub-elements. This function is automatically called before every + replot by the parent layout element. It is called multiple times, once for every \ref + UpdatePhase. The phases are run through in the order of the enum values. For details about what + happens at the different phases, see the documentation of \ref UpdatePhase. + + Layout elements that have child elements should call the \ref update method of their child + elements, and pass the current \a phase unchanged. + + The default implementation executes the automatic margin mechanism in the \ref upMargins phase. + Subclasses should make sure to call the base class implementation. +*/ +void QCPLayoutElement::update(UpdatePhase phase) +{ + if (phase == upMargins) + { + if (mAutoMargins != QCP::msNone) + { + // set the margins of this layout element according to automatic margin calculation, either directly or via a margin group: + QMargins newMargins = mMargins; + QList allMarginSides = QList() << QCP::msLeft << QCP::msRight << QCP::msTop << QCP::msBottom; + foreach (QCP::MarginSide side, allMarginSides) + { + if (mAutoMargins.testFlag(side)) // this side's margin shall be calculated automatically + { + if (mMarginGroups.contains(side)) + QCP::setMarginValue(newMargins, side, mMarginGroups[side]->commonMargin(side)); // this side is part of a margin group, so get the margin value from that group + else + QCP::setMarginValue(newMargins, side, calculateAutoMargin(side)); // this side is not part of a group, so calculate the value directly + // apply minimum margin restrictions: + if (QCP::getMarginValue(newMargins, side) < QCP::getMarginValue(mMinimumMargins, side)) + QCP::setMarginValue(newMargins, side, QCP::getMarginValue(mMinimumMargins, side)); + } + } + setMargins(newMargins); + } + } +} + +/*! + Returns the suggested minimum size this layout element (the \ref outerRect) may be compressed to, + if no manual minimum size is set. + + if a minimum size (\ref setMinimumSize) was not set manually, parent layouts use the returned size + (usually indirectly through \ref QCPLayout::getFinalMinimumOuterSize) to determine the minimum + allowed size of this layout element. + + A manual minimum size is considered set if it is non-zero. + + The default implementation simply returns the sum of the horizontal margins for the width and the + sum of the vertical margins for the height. Reimplementations may use their detailed knowledge + about the layout element's content to provide size hints. +*/ +QSize QCPLayoutElement::minimumOuterSizeHint() const +{ + return QSize(mMargins.left()+mMargins.right(), mMargins.top()+mMargins.bottom()); +} + +/*! + Returns the suggested maximum size this layout element (the \ref outerRect) may be expanded to, + if no manual maximum size is set. + + if a maximum size (\ref setMaximumSize) was not set manually, parent layouts use the returned + size (usually indirectly through \ref QCPLayout::getFinalMaximumOuterSize) to determine the + maximum allowed size of this layout element. + + A manual maximum size is considered set if it is smaller than Qt's \c QWIDGETSIZE_MAX. + + The default implementation simply returns \c QWIDGETSIZE_MAX for both width and height, implying + no suggested maximum size. Reimplementations may use their detailed knowledge about the layout + element's content to provide size hints. +*/ +QSize QCPLayoutElement::maximumOuterSizeHint() const +{ + return QSize(QWIDGETSIZE_MAX, QWIDGETSIZE_MAX); +} + +/*! + Returns a list of all child elements in this layout element. If \a recursive is true, all + sub-child elements are included in the list, too. + + \warning There may be entries with value 0 in the returned list. (For example, QCPLayoutGrid may have + empty cells which yield 0 at the respective index.) +*/ +QList QCPLayoutElement::elements(bool recursive) const +{ + Q_UNUSED(recursive) + return QList(); +} + +/*! + Layout elements are sensitive to events inside their outer rect. If \a pos is within the outer + rect, this method returns a value corresponding to 0.99 times the parent plot's selection + tolerance. However, layout elements are not selectable by default. So if \a onlySelectable is + true, -1.0 is returned. + + See \ref QCPLayerable::selectTest for a general explanation of this virtual method. + + QCPLayoutElement subclasses may reimplement this method to provide more specific selection test + behaviour. +*/ +double QCPLayoutElement::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + + if (onlySelectable) + return -1; + + if (QRectF(mOuterRect).contains(pos)) + { + if (mParentPlot) + return mParentPlot->selectionTolerance()*0.99; + else + { + qDebug() << Q_FUNC_INFO << "parent plot not defined"; + return -1; + } + } else + return -1; +} + +/*! \internal + + propagates the parent plot initialization to all child elements, by calling \ref + QCPLayerable::initializeParentPlot on them. +*/ +void QCPLayoutElement::parentPlotInitialized(QCustomPlot *parentPlot) +{ + foreach (QCPLayoutElement* el, elements(false)) + { + if (!el->parentPlot()) + el->initializeParentPlot(parentPlot); + } +} + +/*! \internal + + Returns the margin size for this \a side. It is used if automatic margins is enabled for this \a + side (see \ref setAutoMargins). If a minimum margin was set with \ref setMinimumMargins, the + returned value will not be smaller than the specified minimum margin. + + The default implementation just returns the respective manual margin (\ref setMargins) or the + minimum margin, whichever is larger. +*/ +int QCPLayoutElement::calculateAutoMargin(QCP::MarginSide side) +{ + return qMax(QCP::getMarginValue(mMargins, side), QCP::getMarginValue(mMinimumMargins, side)); +} + +/*! \internal + + This virtual method is called when this layout element was moved to a different QCPLayout, or + when this layout element has changed its logical position (e.g. row and/or column) within the + same QCPLayout. Subclasses may use this to react accordingly. + + Since this method is called after the completion of the move, you can access the new parent + layout via \ref layout(). + + The default implementation does nothing. +*/ +void QCPLayoutElement::layoutChanged() +{ +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPLayout +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPLayout + \brief The abstract base class for layouts + + This is an abstract base class for layout elements whose main purpose is to define the position + and size of other child layout elements. In most cases, layouts don't draw anything themselves + (but there are exceptions to this, e.g. QCPLegend). + + QCPLayout derives from QCPLayoutElement, and thus can itself be nested in other layouts. + + QCPLayout introduces a common interface for accessing and manipulating the child elements. Those + functions are most notably \ref elementCount, \ref elementAt, \ref takeAt, \ref take, \ref + simplify, \ref removeAt, \ref remove and \ref clear. Individual subclasses may add more functions + to this interface which are more specialized to the form of the layout. For example, \ref + QCPLayoutGrid adds functions that take row and column indices to access cells of the layout grid + more conveniently. + + Since this is an abstract base class, you can't instantiate it directly. Rather use one of its + subclasses like QCPLayoutGrid or QCPLayoutInset. + + For a general introduction to the layout system, see the dedicated documentation page \ref + thelayoutsystem "The Layout System". +*/ + +/* start documentation of pure virtual functions */ + +/*! \fn virtual int QCPLayout::elementCount() const = 0 + + Returns the number of elements/cells in the layout. + + \see elements, elementAt +*/ + +/*! \fn virtual QCPLayoutElement* QCPLayout::elementAt(int index) const = 0 + + Returns the element in the cell with the given \a index. If \a index is invalid, returns 0. + + Note that even if \a index is valid, the respective cell may be empty in some layouts (e.g. + QCPLayoutGrid), so this function may return 0 in those cases. You may use this function to check + whether a cell is empty or not. + + \see elements, elementCount, takeAt +*/ + +/*! \fn virtual QCPLayoutElement* QCPLayout::takeAt(int index) = 0 + + Removes the element with the given \a index from the layout and returns it. + + If the \a index is invalid or the cell with that index is empty, returns 0. + + Note that some layouts don't remove the respective cell right away but leave an empty cell after + successful removal of the layout element. To collapse empty cells, use \ref simplify. + + \see elementAt, take +*/ + +/*! \fn virtual bool QCPLayout::take(QCPLayoutElement* element) = 0 + + Removes the specified \a element from the layout and returns true on success. + + If the \a element isn't in this layout, returns false. + + Note that some layouts don't remove the respective cell right away but leave an empty cell after + successful removal of the layout element. To collapse empty cells, use \ref simplify. + + \see takeAt +*/ + +/* end documentation of pure virtual functions */ + +/*! + Creates an instance of QCPLayout and sets default values. Note that since QCPLayout + is an abstract base class, it can't be instantiated directly. +*/ +QCPLayout::QCPLayout() +{ +} + +/*! + If \a phase is \ref upLayout, calls \ref updateLayout, which subclasses may reimplement to + reposition and resize their cells. + + Finally, the call is propagated down to all child \ref QCPLayoutElement "QCPLayoutElements". + + For details about this method and the update phases, see the documentation of \ref + QCPLayoutElement::update. +*/ +void QCPLayout::update(UpdatePhase phase) +{ + QCPLayoutElement::update(phase); + + // set child element rects according to layout: + if (phase == upLayout) + updateLayout(); + + // propagate update call to child elements: + const int elCount = elementCount(); + for (int i=0; iupdate(phase); + } +} + +/* inherits documentation from base class */ +QList QCPLayout::elements(bool recursive) const +{ + const int c = elementCount(); + QList result; +#if QT_VERSION >= QT_VERSION_CHECK(4, 7, 0) + result.reserve(c); +#endif + for (int i=0; ielements(recursive); + } + } + return result; +} + +/*! + Simplifies the layout by collapsing empty cells. The exact behavior depends on subclasses, the + default implementation does nothing. + + Not all layouts need simplification. For example, QCPLayoutInset doesn't use explicit + simplification while QCPLayoutGrid does. +*/ +void QCPLayout::simplify() +{ +} + +/*! + Removes and deletes the element at the provided \a index. Returns true on success. If \a index is + invalid or points to an empty cell, returns false. + + This function internally uses \ref takeAt to remove the element from the layout and then deletes + the returned element. Note that some layouts don't remove the respective cell right away but leave an + empty cell after successful removal of the layout element. To collapse empty cells, use \ref + simplify. + + \see remove, takeAt +*/ +bool QCPLayout::removeAt(int index) +{ + if (QCPLayoutElement *el = takeAt(index)) + { + delete el; + return true; + } else + return false; +} + +/*! + Removes and deletes the provided \a element. Returns true on success. If \a element is not in the + layout, returns false. + + This function internally uses \ref takeAt to remove the element from the layout and then deletes + the element. Note that some layouts don't remove the respective cell right away but leave an + empty cell after successful removal of the layout element. To collapse empty cells, use \ref + simplify. + + \see removeAt, take +*/ +bool QCPLayout::remove(QCPLayoutElement *element) +{ + if (take(element)) + { + delete element; + return true; + } else + return false; +} + +/*! + Removes and deletes all layout elements in this layout. Finally calls \ref simplify to make sure + all empty cells are collapsed. + + \see remove, removeAt +*/ +void QCPLayout::clear() +{ + for (int i=elementCount()-1; i>=0; --i) + { + if (elementAt(i)) + removeAt(i); + } + simplify(); +} + +/*! + Subclasses call this method to report changed (minimum/maximum) size constraints. + + If the parent of this layout is again a QCPLayout, forwards the call to the parent's \ref + sizeConstraintsChanged. If the parent is a QWidget (i.e. is the \ref QCustomPlot::plotLayout of + QCustomPlot), calls QWidget::updateGeometry, so if the QCustomPlot widget is inside a Qt QLayout, + it may update itself and resize cells accordingly. +*/ +void QCPLayout::sizeConstraintsChanged() const +{ + if (QWidget *w = qobject_cast(parent())) + w->updateGeometry(); + else if (QCPLayout *l = qobject_cast(parent())) + l->sizeConstraintsChanged(); +} + +/*! \internal + + Subclasses reimplement this method to update the position and sizes of the child elements/cells + via calling their \ref QCPLayoutElement::setOuterRect. The default implementation does nothing. + + The geometry used as a reference is the inner \ref rect of this layout. Child elements should stay + within that rect. + + \ref getSectionSizes may help with the reimplementation of this function. + + \see update +*/ +void QCPLayout::updateLayout() +{ +} + + +/*! \internal + + Associates \a el with this layout. This is done by setting the \ref QCPLayoutElement::layout, the + \ref QCPLayerable::parentLayerable and the QObject parent to this layout. + + Further, if \a el didn't previously have a parent plot, calls \ref + QCPLayerable::initializeParentPlot on \a el to set the paret plot. + + This method is used by subclass specific methods that add elements to the layout. Note that this + method only changes properties in \a el. The removal from the old layout and the insertion into + the new layout must be done additionally. +*/ +void QCPLayout::adoptElement(QCPLayoutElement *el) +{ + if (el) + { + el->mParentLayout = this; + el->setParentLayerable(this); + el->setParent(this); + if (!el->parentPlot()) + el->initializeParentPlot(mParentPlot); + el->layoutChanged(); + } else + qDebug() << Q_FUNC_INFO << "Null element passed"; +} + +/*! \internal + + Disassociates \a el from this layout. This is done by setting the \ref QCPLayoutElement::layout + and the \ref QCPLayerable::parentLayerable to zero. The QObject parent is set to the parent + QCustomPlot. + + This method is used by subclass specific methods that remove elements from the layout (e.g. \ref + take or \ref takeAt). Note that this method only changes properties in \a el. The removal from + the old layout must be done additionally. +*/ +void QCPLayout::releaseElement(QCPLayoutElement *el) +{ + if (el) + { + el->mParentLayout = 0; + el->setParentLayerable(0); + el->setParent(mParentPlot); + // Note: Don't initializeParentPlot(0) here, because layout element will stay in same parent plot + } else + qDebug() << Q_FUNC_INFO << "Null element passed"; +} + +/*! \internal + + This is a helper function for the implementation of \ref updateLayout in subclasses. + + It calculates the sizes of one-dimensional sections with provided constraints on maximum section + sizes, minimum section sizes, relative stretch factors and the final total size of all sections. + + The QVector entries refer to the sections. Thus all QVectors must have the same size. + + \a maxSizes gives the maximum allowed size of each section. If there shall be no maximum size + imposed, set all vector values to Qt's QWIDGETSIZE_MAX. + + \a minSizes gives the minimum allowed size of each section. If there shall be no minimum size + imposed, set all vector values to zero. If the \a minSizes entries add up to a value greater than + \a totalSize, sections will be scaled smaller than the proposed minimum sizes. (In other words, + not exceeding the allowed total size is taken to be more important than not going below minimum + section sizes.) + + \a stretchFactors give the relative proportions of the sections to each other. If all sections + shall be scaled equally, set all values equal. If the first section shall be double the size of + each individual other section, set the first number of \a stretchFactors to double the value of + the other individual values (e.g. {2, 1, 1, 1}). + + \a totalSize is the value that the final section sizes will add up to. Due to rounding, the + actual sum may differ slightly. If you want the section sizes to sum up to exactly that value, + you could distribute the remaining difference on the sections. + + The return value is a QVector containing the section sizes. +*/ +QVector QCPLayout::getSectionSizes(QVector maxSizes, QVector minSizes, QVector stretchFactors, int totalSize) const +{ + if (maxSizes.size() != minSizes.size() || minSizes.size() != stretchFactors.size()) + { + qDebug() << Q_FUNC_INFO << "Passed vector sizes aren't equal:" << maxSizes << minSizes << stretchFactors; + return QVector(); + } + if (stretchFactors.isEmpty()) + return QVector(); + int sectionCount = stretchFactors.size(); + QVector sectionSizes(sectionCount); + // if provided total size is forced smaller than total minimum size, ignore minimum sizes (squeeze sections): + int minSizeSum = 0; + for (int i=0; i minimumLockedSections; + QList unfinishedSections; + for (int i=0; i result(sectionCount); + for (int i=0; iminimumOuterSizeHint(); + QSize minOuter = el->minimumSize(); // depending on sizeConstraitRect this might be with respect to inner rect, so possibly add margins in next four lines (preserving unset minimum of 0) + if (minOuter.width() > 0 && el->sizeConstraintRect() == QCPLayoutElement::scrInnerRect) + minOuter.rwidth() += el->margins().left() + el->margins().right(); + if (minOuter.height() > 0 && el->sizeConstraintRect() == QCPLayoutElement::scrInnerRect) + minOuter.rheight() += el->margins().top() + el->margins().bottom(); + + return QSize(minOuter.width() > 0 ? minOuter.width() : minOuterHint.width(), + minOuter.height() > 0 ? minOuter.height() : minOuterHint.height());; +} + +/*! \internal + + This is a helper function for the implementation of subclasses. + + It returns the maximum size that should finally be used for the outer rect of the passed layout + element \a el. + + It takes into account whether a manual maximum size is set (\ref + QCPLayoutElement::setMaximumSize), which size constraint is set (\ref + QCPLayoutElement::setSizeConstraintRect), as well as the maximum size hint, if no manual maximum + size was set (\ref QCPLayoutElement::maximumOuterSizeHint). +*/ +QSize QCPLayout::getFinalMaximumOuterSize(const QCPLayoutElement *el) +{ + QSize maxOuterHint = el->maximumOuterSizeHint(); + QSize maxOuter = el->maximumSize(); // depending on sizeConstraitRect this might be with respect to inner rect, so possibly add margins in next four lines (preserving unset maximum of QWIDGETSIZE_MAX) + if (maxOuter.width() < QWIDGETSIZE_MAX && el->sizeConstraintRect() == QCPLayoutElement::scrInnerRect) + maxOuter.rwidth() += el->margins().left() + el->margins().right(); + if (maxOuter.height() < QWIDGETSIZE_MAX && el->sizeConstraintRect() == QCPLayoutElement::scrInnerRect) + maxOuter.rheight() += el->margins().top() + el->margins().bottom(); + + return QSize(maxOuter.width() < QWIDGETSIZE_MAX ? maxOuter.width() : maxOuterHint.width(), + maxOuter.height() < QWIDGETSIZE_MAX ? maxOuter.height() : maxOuterHint.height()); +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPLayoutGrid +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPLayoutGrid + \brief A layout that arranges child elements in a grid + + Elements are laid out in a grid with configurable stretch factors (\ref setColumnStretchFactor, + \ref setRowStretchFactor) and spacing (\ref setColumnSpacing, \ref setRowSpacing). + + Elements can be added to cells via \ref addElement. The grid is expanded if the specified row or + column doesn't exist yet. Whether a cell contains a valid layout element can be checked with \ref + hasElement, that element can be retrieved with \ref element. If rows and columns that only have + empty cells shall be removed, call \ref simplify. Removal of elements is either done by just + adding the element to a different layout or by using the QCPLayout interface \ref take or \ref + remove. + + If you use \ref addElement(QCPLayoutElement*) without explicit parameters for \a row and \a + column, the grid layout will choose the position according to the current \ref setFillOrder and + the wrapping (\ref setWrap). + + Row and column insertion can be performed with \ref insertRow and \ref insertColumn. +*/ + +/* start documentation of inline functions */ + +/*! \fn int QCPLayoutGrid::rowCount() const + + Returns the number of rows in the layout. + + \see columnCount +*/ + +/*! \fn int QCPLayoutGrid::columnCount() const + + Returns the number of columns in the layout. + + \see rowCount +*/ + +/* end documentation of inline functions */ + +/*! + Creates an instance of QCPLayoutGrid and sets default values. +*/ +QCPLayoutGrid::QCPLayoutGrid() : + mColumnSpacing(5), + mRowSpacing(5), + mWrap(0), + mFillOrder(foColumnsFirst) +{ +} + +QCPLayoutGrid::~QCPLayoutGrid() +{ + // clear all child layout elements. This is important because only the specific layouts know how + // to handle removing elements (clear calls virtual removeAt method to do that). + clear(); +} + +/*! + Returns the element in the cell in \a row and \a column. + + Returns 0 if either the row/column is invalid or if the cell is empty. In those cases, a qDebug + message is printed. To check whether a cell exists and isn't empty, use \ref hasElement. + + \see addElement, hasElement +*/ +QCPLayoutElement *QCPLayoutGrid::element(int row, int column) const +{ + if (row >= 0 && row < mElements.size()) + { + if (column >= 0 && column < mElements.first().size()) + { + if (QCPLayoutElement *result = mElements.at(row).at(column)) + return result; + else + qDebug() << Q_FUNC_INFO << "Requested cell is empty. Row:" << row << "Column:" << column; + } else + qDebug() << Q_FUNC_INFO << "Invalid column. Row:" << row << "Column:" << column; + } else + qDebug() << Q_FUNC_INFO << "Invalid row. Row:" << row << "Column:" << column; + return 0; +} + + +/*! \overload + + Adds the \a element to cell with \a row and \a column. If \a element is already in a layout, it + is first removed from there. If \a row or \a column don't exist yet, the layout is expanded + accordingly. + + Returns true if the element was added successfully, i.e. if the cell at \a row and \a column + didn't already have an element. + + Use the overload of this method without explicit row/column index to place the element according + to the configured fill order and wrapping settings. + + \see element, hasElement, take, remove +*/ +bool QCPLayoutGrid::addElement(int row, int column, QCPLayoutElement *element) +{ + if (!hasElement(row, column)) + { + if (element && element->layout()) // remove from old layout first + element->layout()->take(element); + expandTo(row+1, column+1); + mElements[row][column] = element; + if (element) + adoptElement(element); + return true; + } else + qDebug() << Q_FUNC_INFO << "There is already an element in the specified row/column:" << row << column; + return false; +} + +/*! \overload + + Adds the \a element to the next empty cell according to the current fill order (\ref + setFillOrder) and wrapping (\ref setWrap). If \a element is already in a layout, it is first + removed from there. If necessary, the layout is expanded to hold the new element. + + Returns true if the element was added successfully. + + \see setFillOrder, setWrap, element, hasElement, take, remove +*/ +bool QCPLayoutGrid::addElement(QCPLayoutElement *element) +{ + int rowIndex = 0; + int colIndex = 0; + if (mFillOrder == foColumnsFirst) + { + while (hasElement(rowIndex, colIndex)) + { + ++colIndex; + if (colIndex >= mWrap && mWrap > 0) + { + colIndex = 0; + ++rowIndex; + } + } + } else + { + while (hasElement(rowIndex, colIndex)) + { + ++rowIndex; + if (rowIndex >= mWrap && mWrap > 0) + { + rowIndex = 0; + ++colIndex; + } + } + } + return addElement(rowIndex, colIndex, element); +} + +/*! + Returns whether the cell at \a row and \a column exists and contains a valid element, i.e. isn't + empty. + + \see element +*/ +bool QCPLayoutGrid::hasElement(int row, int column) +{ + if (row >= 0 && row < rowCount() && column >= 0 && column < columnCount()) + return mElements.at(row).at(column); + else + return false; +} + +/*! + Sets the stretch \a factor of \a column. + + Stretch factors control the relative sizes of rows and columns. Cells will not be resized beyond + their minimum and maximum widths/heights, regardless of the stretch factor. (see \ref + QCPLayoutElement::setMinimumSize, \ref QCPLayoutElement::setMaximumSize, \ref + QCPLayoutElement::setSizeConstraintRect.) + + The default stretch factor of newly created rows/columns is 1. + + \see setColumnStretchFactors, setRowStretchFactor +*/ +void QCPLayoutGrid::setColumnStretchFactor(int column, double factor) +{ + if (column >= 0 && column < columnCount()) + { + if (factor > 0) + mColumnStretchFactors[column] = factor; + else + qDebug() << Q_FUNC_INFO << "Invalid stretch factor, must be positive:" << factor; + } else + qDebug() << Q_FUNC_INFO << "Invalid column:" << column; +} + +/*! + Sets the stretch \a factors of all columns. \a factors must have the size \ref columnCount. + + Stretch factors control the relative sizes of rows and columns. Cells will not be resized beyond + their minimum and maximum widths/heights, regardless of the stretch factor. (see \ref + QCPLayoutElement::setMinimumSize, \ref QCPLayoutElement::setMaximumSize, \ref + QCPLayoutElement::setSizeConstraintRect.) + + The default stretch factor of newly created rows/columns is 1. + + \see setColumnStretchFactor, setRowStretchFactors +*/ +void QCPLayoutGrid::setColumnStretchFactors(const QList &factors) +{ + if (factors.size() == mColumnStretchFactors.size()) + { + mColumnStretchFactors = factors; + for (int i=0; i= 0 && row < rowCount()) + { + if (factor > 0) + mRowStretchFactors[row] = factor; + else + qDebug() << Q_FUNC_INFO << "Invalid stretch factor, must be positive:" << factor; + } else + qDebug() << Q_FUNC_INFO << "Invalid row:" << row; +} + +/*! + Sets the stretch \a factors of all rows. \a factors must have the size \ref rowCount. + + Stretch factors control the relative sizes of rows and columns. Cells will not be resized beyond + their minimum and maximum widths/heights, regardless of the stretch factor. (see \ref + QCPLayoutElement::setMinimumSize, \ref QCPLayoutElement::setMaximumSize, \ref + QCPLayoutElement::setSizeConstraintRect.) + + The default stretch factor of newly created rows/columns is 1. + + \see setRowStretchFactor, setColumnStretchFactors +*/ +void QCPLayoutGrid::setRowStretchFactors(const QList &factors) +{ + if (factors.size() == mRowStretchFactors.size()) + { + mRowStretchFactors = factors; + for (int i=0; i tempElements; + if (rearrange) + { + tempElements.reserve(elCount); + for (int i=0; i()); + mRowStretchFactors.append(1); + } + // go through rows and expand columns as necessary: + int newColCount = qMax(columnCount(), newColumnCount); + for (int i=0; i rowCount()) + newIndex = rowCount(); + + mRowStretchFactors.insert(newIndex, 1); + QList newRow; + for (int col=0; col columnCount()) + newIndex = columnCount(); + + mColumnStretchFactors.insert(newIndex, 1); + for (int row=0; row= 0 && row < rowCount()) + { + if (column >= 0 && column < columnCount()) + { + switch (mFillOrder) + { + case foRowsFirst: return column*rowCount() + row; + case foColumnsFirst: return row*columnCount() + column; + } + } else + qDebug() << Q_FUNC_INFO << "row index out of bounds:" << row; + } else + qDebug() << Q_FUNC_INFO << "column index out of bounds:" << column; + return 0; +} + +/*! + Converts the linear index to row and column indices and writes the result to \a row and \a + column. + + The way the cells are indexed depends on \ref setFillOrder. If it is \ref foRowsFirst, the + indices increase left to right and then top to bottom. If it is \ref foColumnsFirst, the indices + increase top to bottom and then left to right. + + If there are no cells (i.e. column or row count is zero), sets \a row and \a column to -1. + + For the retrieved \a row and \a column to be valid, the passed \a index must be valid itself, + i.e. greater or equal to zero and smaller than the current \ref elementCount. + + \see rowColToIndex +*/ +void QCPLayoutGrid::indexToRowCol(int index, int &row, int &column) const +{ + row = -1; + column = -1; + const int nCols = columnCount(); + const int nRows = rowCount(); + if (nCols == 0 || nRows == 0) + return; + if (index < 0 || index >= elementCount()) + { + qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; + return; + } + + switch (mFillOrder) + { + case foRowsFirst: + { + column = index / nRows; + row = index % nRows; + break; + } + case foColumnsFirst: + { + row = index / nCols; + column = index % nCols; + break; + } + } +} + +/* inherits documentation from base class */ +void QCPLayoutGrid::updateLayout() +{ + QVector minColWidths, minRowHeights, maxColWidths, maxRowHeights; + getMinimumRowColSizes(&minColWidths, &minRowHeights); + getMaximumRowColSizes(&maxColWidths, &maxRowHeights); + + int totalRowSpacing = (rowCount()-1) * mRowSpacing; + int totalColSpacing = (columnCount()-1) * mColumnSpacing; + QVector colWidths = getSectionSizes(maxColWidths, minColWidths, mColumnStretchFactors.toVector(), mRect.width()-totalColSpacing); + QVector rowHeights = getSectionSizes(maxRowHeights, minRowHeights, mRowStretchFactors.toVector(), mRect.height()-totalRowSpacing); + + // go through cells and set rects accordingly: + int yOffset = mRect.top(); + for (int row=0; row 0) + yOffset += rowHeights.at(row-1)+mRowSpacing; + int xOffset = mRect.left(); + for (int col=0; col 0) + xOffset += colWidths.at(col-1)+mColumnSpacing; + if (mElements.at(row).at(col)) + mElements.at(row).at(col)->setOuterRect(QRect(xOffset, yOffset, colWidths.at(col), rowHeights.at(row))); + } + } +} + +/*! + \seebaseclassmethod + + Note that the association of the linear \a index to the row/column based cells depends on the + current setting of \ref setFillOrder. + + \see rowColToIndex +*/ +QCPLayoutElement *QCPLayoutGrid::elementAt(int index) const +{ + if (index >= 0 && index < elementCount()) + { + int row, col; + indexToRowCol(index, row, col); + return mElements.at(row).at(col); + } else + return 0; +} + +/*! + \seebaseclassmethod + + Note that the association of the linear \a index to the row/column based cells depends on the + current setting of \ref setFillOrder. + + \see rowColToIndex +*/ +QCPLayoutElement *QCPLayoutGrid::takeAt(int index) +{ + if (QCPLayoutElement *el = elementAt(index)) + { + releaseElement(el); + int row, col; + indexToRowCol(index, row, col); + mElements[row][col] = 0; + return el; + } else + { + qDebug() << Q_FUNC_INFO << "Attempt to take invalid index:" << index; + return 0; + } +} + +/* inherits documentation from base class */ +bool QCPLayoutGrid::take(QCPLayoutElement *element) +{ + if (element) + { + for (int i=0; i QCPLayoutGrid::elements(bool recursive) const +{ + QList result; + const int elCount = elementCount(); +#if QT_VERSION >= QT_VERSION_CHECK(4, 7, 0) + result.reserve(elCount); +#endif + for (int i=0; ielements(recursive); + } + } + return result; +} + +/*! + Simplifies the layout by collapsing rows and columns which only contain empty cells. +*/ +void QCPLayoutGrid::simplify() +{ + // remove rows with only empty cells: + for (int row=rowCount()-1; row>=0; --row) + { + bool hasElements = false; + for (int col=0; col=0; --col) + { + bool hasElements = false; + for (int row=0; row minColWidths, minRowHeights; + getMinimumRowColSizes(&minColWidths, &minRowHeights); + QSize result(0, 0); + for (int i=0; i maxColWidths, maxRowHeights; + getMaximumRowColSizes(&maxColWidths, &maxRowHeights); + + QSize result(0, 0); + for (int i=0; i QWIDGETSIZE_MAX) + result.setHeight(QWIDGETSIZE_MAX); + if (result.width() > QWIDGETSIZE_MAX) + result.setWidth(QWIDGETSIZE_MAX); + return result; +} + +/*! \internal + + Places the minimum column widths and row heights into \a minColWidths and \a minRowHeights + respectively. + + The minimum height of a row is the largest minimum height of any element's outer rect in that + row. The minimum width of a column is the largest minimum width of any element's outer rect in + that column. + + This is a helper function for \ref updateLayout. + + \see getMaximumRowColSizes +*/ +void QCPLayoutGrid::getMinimumRowColSizes(QVector *minColWidths, QVector *minRowHeights) const +{ + *minColWidths = QVector(columnCount(), 0); + *minRowHeights = QVector(rowCount(), 0); + for (int row=0; rowat(col) < minSize.width()) + (*minColWidths)[col] = minSize.width(); + if (minRowHeights->at(row) < minSize.height()) + (*minRowHeights)[row] = minSize.height(); + } + } + } +} + +/*! \internal + + Places the maximum column widths and row heights into \a maxColWidths and \a maxRowHeights + respectively. + + The maximum height of a row is the smallest maximum height of any element's outer rect in that + row. The maximum width of a column is the smallest maximum width of any element's outer rect in + that column. + + This is a helper function for \ref updateLayout. + + \see getMinimumRowColSizes +*/ +void QCPLayoutGrid::getMaximumRowColSizes(QVector *maxColWidths, QVector *maxRowHeights) const +{ + *maxColWidths = QVector(columnCount(), QWIDGETSIZE_MAX); + *maxRowHeights = QVector(rowCount(), QWIDGETSIZE_MAX); + for (int row=0; rowat(col) > maxSize.width()) + (*maxColWidths)[col] = maxSize.width(); + if (maxRowHeights->at(row) > maxSize.height()) + (*maxRowHeights)[row] = maxSize.height(); + } + } + } +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPLayoutInset +//////////////////////////////////////////////////////////////////////////////////////////////////// +/*! \class QCPLayoutInset + \brief A layout that places child elements aligned to the border or arbitrarily positioned + + Elements are placed either aligned to the border or at arbitrary position in the area of the + layout. Which placement applies is controlled with the \ref InsetPlacement (\ref + setInsetPlacement). + + Elements are added via \ref addElement(QCPLayoutElement *element, Qt::Alignment alignment) or + addElement(QCPLayoutElement *element, const QRectF &rect). If the first method is used, the inset + placement will default to \ref ipBorderAligned and the element will be aligned according to the + \a alignment parameter. The second method defaults to \ref ipFree and allows placing elements at + arbitrary position and size, defined by \a rect. + + The alignment or rect can be set via \ref setInsetAlignment or \ref setInsetRect, respectively. + + This is the layout that every QCPAxisRect has as \ref QCPAxisRect::insetLayout. +*/ + +/* start documentation of inline functions */ + +/*! \fn virtual void QCPLayoutInset::simplify() + + The QCPInsetLayout does not need simplification since it can never have empty cells due to its + linear index structure. This method does nothing. +*/ + +/* end documentation of inline functions */ + +/*! + Creates an instance of QCPLayoutInset and sets default values. +*/ +QCPLayoutInset::QCPLayoutInset() +{ +} + +QCPLayoutInset::~QCPLayoutInset() +{ + // clear all child layout elements. This is important because only the specific layouts know how + // to handle removing elements (clear calls virtual removeAt method to do that). + clear(); +} + +/*! + Returns the placement type of the element with the specified \a index. +*/ +QCPLayoutInset::InsetPlacement QCPLayoutInset::insetPlacement(int index) const +{ + if (elementAt(index)) + return mInsetPlacement.at(index); + else + { + qDebug() << Q_FUNC_INFO << "Invalid element index:" << index; + return ipFree; + } +} + +/*! + Returns the alignment of the element with the specified \a index. The alignment only has a + meaning, if the inset placement (\ref setInsetPlacement) is \ref ipBorderAligned. +*/ +Qt::Alignment QCPLayoutInset::insetAlignment(int index) const +{ + if (elementAt(index)) + return mInsetAlignment.at(index); + else + { + qDebug() << Q_FUNC_INFO << "Invalid element index:" << index; + return 0; + } +} + +/*! + Returns the rect of the element with the specified \a index. The rect only has a + meaning, if the inset placement (\ref setInsetPlacement) is \ref ipFree. +*/ +QRectF QCPLayoutInset::insetRect(int index) const +{ + if (elementAt(index)) + return mInsetRect.at(index); + else + { + qDebug() << Q_FUNC_INFO << "Invalid element index:" << index; + return QRectF(); + } +} + +/*! + Sets the inset placement type of the element with the specified \a index to \a placement. + + \see InsetPlacement +*/ +void QCPLayoutInset::setInsetPlacement(int index, QCPLayoutInset::InsetPlacement placement) +{ + if (elementAt(index)) + mInsetPlacement[index] = placement; + else + qDebug() << Q_FUNC_INFO << "Invalid element index:" << index; +} + +/*! + If the inset placement (\ref setInsetPlacement) is \ref ipBorderAligned, this function + is used to set the alignment of the element with the specified \a index to \a alignment. + + \a alignment is an or combination of the following alignment flags: Qt::AlignLeft, + Qt::AlignHCenter, Qt::AlighRight, Qt::AlignTop, Qt::AlignVCenter, Qt::AlignBottom. Any other + alignment flags will be ignored. +*/ +void QCPLayoutInset::setInsetAlignment(int index, Qt::Alignment alignment) +{ + if (elementAt(index)) + mInsetAlignment[index] = alignment; + else + qDebug() << Q_FUNC_INFO << "Invalid element index:" << index; +} + +/*! + If the inset placement (\ref setInsetPlacement) is \ref ipFree, this function is used to set the + position and size of the element with the specified \a index to \a rect. + + \a rect is given in fractions of the whole inset layout rect. So an inset with rect (0, 0, 1, 1) + will span the entire layout. An inset with rect (0.6, 0.1, 0.35, 0.35) will be in the top right + corner of the layout, with 35% width and height of the parent layout. + + Note that the minimum and maximum sizes of the embedded element (\ref + QCPLayoutElement::setMinimumSize, \ref QCPLayoutElement::setMaximumSize) are enforced. +*/ +void QCPLayoutInset::setInsetRect(int index, const QRectF &rect) +{ + if (elementAt(index)) + mInsetRect[index] = rect; + else + qDebug() << Q_FUNC_INFO << "Invalid element index:" << index; +} + +/* inherits documentation from base class */ +void QCPLayoutInset::updateLayout() +{ + for (int i=0; i finalMaxSize.width()) + insetRect.setWidth(finalMaxSize.width()); + if (insetRect.size().height() > finalMaxSize.height()) + insetRect.setHeight(finalMaxSize.height()); + } else if (mInsetPlacement.at(i) == ipBorderAligned) + { + insetRect.setSize(finalMinSize); + Qt::Alignment al = mInsetAlignment.at(i); + if (al.testFlag(Qt::AlignLeft)) insetRect.moveLeft(rect().x()); + else if (al.testFlag(Qt::AlignRight)) insetRect.moveRight(rect().x()+rect().width()); + else insetRect.moveLeft(rect().x()+rect().width()*0.5-finalMinSize.width()*0.5); // default to Qt::AlignHCenter + if (al.testFlag(Qt::AlignTop)) insetRect.moveTop(rect().y()); + else if (al.testFlag(Qt::AlignBottom)) insetRect.moveBottom(rect().y()+rect().height()); + else insetRect.moveTop(rect().y()+rect().height()*0.5-finalMinSize.height()*0.5); // default to Qt::AlignVCenter + } + mElements.at(i)->setOuterRect(insetRect); + } +} + +/* inherits documentation from base class */ +int QCPLayoutInset::elementCount() const +{ + return mElements.size(); +} + +/* inherits documentation from base class */ +QCPLayoutElement *QCPLayoutInset::elementAt(int index) const +{ + if (index >= 0 && index < mElements.size()) + return mElements.at(index); + else + return 0; +} + +/* inherits documentation from base class */ +QCPLayoutElement *QCPLayoutInset::takeAt(int index) +{ + if (QCPLayoutElement *el = elementAt(index)) + { + releaseElement(el); + mElements.removeAt(index); + mInsetPlacement.removeAt(index); + mInsetAlignment.removeAt(index); + mInsetRect.removeAt(index); + return el; + } else + { + qDebug() << Q_FUNC_INFO << "Attempt to take invalid index:" << index; + return 0; + } +} + +/* inherits documentation from base class */ +bool QCPLayoutInset::take(QCPLayoutElement *element) +{ + if (element) + { + for (int i=0; irealVisibility() && mElements.at(i)->selectTest(pos, onlySelectable) >= 0) + return mParentPlot->selectionTolerance()*0.99; + } + return -1; +} + +/*! + Adds the specified \a element to the layout as an inset aligned at the border (\ref + setInsetAlignment is initialized with \ref ipBorderAligned). The alignment is set to \a + alignment. + + \a alignment is an or combination of the following alignment flags: Qt::AlignLeft, + Qt::AlignHCenter, Qt::AlighRight, Qt::AlignTop, Qt::AlignVCenter, Qt::AlignBottom. Any other + alignment flags will be ignored. + + \see addElement(QCPLayoutElement *element, const QRectF &rect) +*/ +void QCPLayoutInset::addElement(QCPLayoutElement *element, Qt::Alignment alignment) +{ + if (element) + { + if (element->layout()) // remove from old layout first + element->layout()->take(element); + mElements.append(element); + mInsetPlacement.append(ipBorderAligned); + mInsetAlignment.append(alignment); + mInsetRect.append(QRectF(0.6, 0.6, 0.4, 0.4)); + adoptElement(element); + } else + qDebug() << Q_FUNC_INFO << "Can't add null element"; +} + +/*! + Adds the specified \a element to the layout as an inset with free positioning/sizing (\ref + setInsetAlignment is initialized with \ref ipFree). The position and size is set to \a + rect. + + \a rect is given in fractions of the whole inset layout rect. So an inset with rect (0, 0, 1, 1) + will span the entire layout. An inset with rect (0.6, 0.1, 0.35, 0.35) will be in the top right + corner of the layout, with 35% width and height of the parent layout. + + \see addElement(QCPLayoutElement *element, Qt::Alignment alignment) +*/ +void QCPLayoutInset::addElement(QCPLayoutElement *element, const QRectF &rect) +{ + if (element) + { + if (element->layout()) // remove from old layout first + element->layout()->take(element); + mElements.append(element); + mInsetPlacement.append(ipFree); + mInsetAlignment.append(Qt::AlignRight|Qt::AlignTop); + mInsetRect.append(rect); + adoptElement(element); + } else + qDebug() << Q_FUNC_INFO << "Can't add null element"; +} +/* end of 'src/layout.cpp' */ + + +/* including file 'src/lineending.cpp', size 11536 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPLineEnding +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPLineEnding + \brief Handles the different ending decorations for line-like items + + \image html QCPLineEnding.png "The various ending styles currently supported" + + For every ending a line-like item has, an instance of this class exists. For example, QCPItemLine + has two endings which can be set with QCPItemLine::setHead and QCPItemLine::setTail. + + The styles themselves are defined via the enum QCPLineEnding::EndingStyle. Most decorations can + be modified regarding width and length, see \ref setWidth and \ref setLength. The direction of + the ending decoration (e.g. direction an arrow is pointing) is controlled by the line-like item. + For example, when both endings of a QCPItemLine are set to be arrows, they will point to opposite + directions, e.g. "outward". This can be changed by \ref setInverted, which would make the + respective arrow point inward. + + Note that due to the overloaded QCPLineEnding constructor, you may directly specify a + QCPLineEnding::EndingStyle where actually a QCPLineEnding is expected, e.g. + \snippet documentation/doc-code-snippets/mainwindow.cpp qcplineending-sethead +*/ + +/*! + Creates a QCPLineEnding instance with default values (style \ref esNone). +*/ +QCPLineEnding::QCPLineEnding() : + mStyle(esNone), + mWidth(8), + mLength(10), + mInverted(false) +{ +} + +/*! + Creates a QCPLineEnding instance with the specified values. +*/ +QCPLineEnding::QCPLineEnding(QCPLineEnding::EndingStyle style, double width, double length, bool inverted) : + mStyle(style), + mWidth(width), + mLength(length), + mInverted(inverted) +{ +} + +/*! + Sets the style of the ending decoration. +*/ +void QCPLineEnding::setStyle(QCPLineEnding::EndingStyle style) +{ + mStyle = style; +} + +/*! + Sets the width of the ending decoration, if the style supports it. On arrows, for example, the + width defines the size perpendicular to the arrow's pointing direction. + + \see setLength +*/ +void QCPLineEnding::setWidth(double width) +{ + mWidth = width; +} + +/*! + Sets the length of the ending decoration, if the style supports it. On arrows, for example, the + length defines the size in pointing direction. + + \see setWidth +*/ +void QCPLineEnding::setLength(double length) +{ + mLength = length; +} + +/*! + Sets whether the ending decoration shall be inverted. For example, an arrow decoration will point + inward when \a inverted is set to true. + + Note that also the \a width direction is inverted. For symmetrical ending styles like arrows or + discs, this doesn't make a difference. However, asymmetric styles like \ref esHalfBar are + affected by it, which can be used to control to which side the half bar points to. +*/ +void QCPLineEnding::setInverted(bool inverted) +{ + mInverted = inverted; +} + +/*! \internal + + Returns the maximum pixel radius the ending decoration might cover, starting from the position + the decoration is drawn at (typically a line ending/\ref QCPItemPosition of an item). + + This is relevant for clipping. Only omit painting of the decoration when the position where the + decoration is supposed to be drawn is farther away from the clipping rect than the returned + distance. +*/ +double QCPLineEnding::boundingDistance() const +{ + switch (mStyle) + { + case esNone: + return 0; + + case esFlatArrow: + case esSpikeArrow: + case esLineArrow: + case esSkewedBar: + return qSqrt(mWidth*mWidth+mLength*mLength); // items that have width and length + + case esDisc: + case esSquare: + case esDiamond: + case esBar: + case esHalfBar: + return mWidth*1.42; // items that only have a width -> width*sqrt(2) + + } + return 0; +} + +/*! + Starting from the origin of this line ending (which is style specific), returns the length + covered by the line ending symbol, in backward direction. + + For example, the \ref esSpikeArrow has a shorter real length than a \ref esFlatArrow, even if + both have the same \ref setLength value, because the spike arrow has an inward curved back, which + reduces the length along its center axis (the drawing origin for arrows is at the tip). + + This function is used for precise, style specific placement of line endings, for example in + QCPAxes. +*/ +double QCPLineEnding::realLength() const +{ + switch (mStyle) + { + case esNone: + case esLineArrow: + case esSkewedBar: + case esBar: + case esHalfBar: + return 0; + + case esFlatArrow: + return mLength; + + case esDisc: + case esSquare: + case esDiamond: + return mWidth*0.5; + + case esSpikeArrow: + return mLength*0.8; + } + return 0; +} + +/*! \internal + + Draws the line ending with the specified \a painter at the position \a pos. The direction of the + line ending is controlled with \a dir. +*/ +void QCPLineEnding::draw(QCPPainter *painter, const QCPVector2D &pos, const QCPVector2D &dir) const +{ + if (mStyle == esNone) + return; + + QCPVector2D lengthVec = dir.normalized() * mLength*(mInverted ? -1 : 1); + if (lengthVec.isNull()) + lengthVec = QCPVector2D(1, 0); + QCPVector2D widthVec = dir.normalized().perpendicular() * mWidth*0.5*(mInverted ? -1 : 1); + + QPen penBackup = painter->pen(); + QBrush brushBackup = painter->brush(); + QPen miterPen = penBackup; + miterPen.setJoinStyle(Qt::MiterJoin); // to make arrow heads spikey + QBrush brush(painter->pen().color(), Qt::SolidPattern); + switch (mStyle) + { + case esNone: break; + case esFlatArrow: + { + QPointF points[3] = {pos.toPointF(), + (pos-lengthVec+widthVec).toPointF(), + (pos-lengthVec-widthVec).toPointF() + }; + painter->setPen(miterPen); + painter->setBrush(brush); + painter->drawConvexPolygon(points, 3); + painter->setBrush(brushBackup); + painter->setPen(penBackup); + break; + } + case esSpikeArrow: + { + QPointF points[4] = {pos.toPointF(), + (pos-lengthVec+widthVec).toPointF(), + (pos-lengthVec*0.8).toPointF(), + (pos-lengthVec-widthVec).toPointF() + }; + painter->setPen(miterPen); + painter->setBrush(brush); + painter->drawConvexPolygon(points, 4); + painter->setBrush(brushBackup); + painter->setPen(penBackup); + break; + } + case esLineArrow: + { + QPointF points[3] = {(pos-lengthVec+widthVec).toPointF(), + pos.toPointF(), + (pos-lengthVec-widthVec).toPointF() + }; + painter->setPen(miterPen); + painter->drawPolyline(points, 3); + painter->setPen(penBackup); + break; + } + case esDisc: + { + painter->setBrush(brush); + painter->drawEllipse(pos.toPointF(), mWidth*0.5, mWidth*0.5); + painter->setBrush(brushBackup); + break; + } + case esSquare: + { + QCPVector2D widthVecPerp = widthVec.perpendicular(); + QPointF points[4] = {(pos-widthVecPerp+widthVec).toPointF(), + (pos-widthVecPerp-widthVec).toPointF(), + (pos+widthVecPerp-widthVec).toPointF(), + (pos+widthVecPerp+widthVec).toPointF() + }; + painter->setPen(miterPen); + painter->setBrush(brush); + painter->drawConvexPolygon(points, 4); + painter->setBrush(brushBackup); + painter->setPen(penBackup); + break; + } + case esDiamond: + { + QCPVector2D widthVecPerp = widthVec.perpendicular(); + QPointF points[4] = {(pos-widthVecPerp).toPointF(), + (pos-widthVec).toPointF(), + (pos+widthVecPerp).toPointF(), + (pos+widthVec).toPointF() + }; + painter->setPen(miterPen); + painter->setBrush(brush); + painter->drawConvexPolygon(points, 4); + painter->setBrush(brushBackup); + painter->setPen(penBackup); + break; + } + case esBar: + { + painter->drawLine((pos+widthVec).toPointF(), (pos-widthVec).toPointF()); + break; + } + case esHalfBar: + { + painter->drawLine((pos+widthVec).toPointF(), pos.toPointF()); + break; + } + case esSkewedBar: + { + if (qFuzzyIsNull(painter->pen().widthF()) && !painter->modes().testFlag(QCPPainter::pmNonCosmetic)) + { + // if drawing with cosmetic pen (perfectly thin stroke, happens only in vector exports), draw bar exactly on tip of line + painter->drawLine((pos+widthVec+lengthVec*0.2*(mInverted?-1:1)).toPointF(), + (pos-widthVec-lengthVec*0.2*(mInverted?-1:1)).toPointF()); + } else + { + // if drawing with thick (non-cosmetic) pen, shift bar a little in line direction to prevent line from sticking through bar slightly + painter->drawLine((pos+widthVec+lengthVec*0.2*(mInverted?-1:1)+dir.normalized()*qMax(1.0f, (float)painter->pen().widthF())*0.5f).toPointF(), + (pos-widthVec-lengthVec*0.2*(mInverted?-1:1)+dir.normalized()*qMax(1.0f, (float)painter->pen().widthF())*0.5f).toPointF()); + } + break; + } + } +} + +/*! \internal + \overload + + Draws the line ending. The direction is controlled with the \a angle parameter in radians. +*/ +void QCPLineEnding::draw(QCPPainter *painter, const QCPVector2D &pos, double angle) const +{ + draw(painter, pos, QCPVector2D(qCos(angle), qSin(angle))); +} +/* end of 'src/lineending.cpp' */ + + +/* including file 'src/axis/axisticker.cpp', size 18664 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAxisTicker +//////////////////////////////////////////////////////////////////////////////////////////////////// +/*! \class QCPAxisTicker + \brief The base class tick generator used by QCPAxis to create tick positions and tick labels + + Each QCPAxis has an internal QCPAxisTicker (or a subclass) in order to generate tick positions + and tick labels for the current axis range. The ticker of an axis can be set via \ref + QCPAxis::setTicker. Since that method takes a QSharedPointer, multiple + axes can share the same ticker instance. + + This base class generates normal tick coordinates and numeric labels for linear axes. It picks a + reasonable tick step (the separation between ticks) which results in readable tick labels. The + number of ticks that should be approximately generated can be set via \ref setTickCount. + Depending on the current tick step strategy (\ref setTickStepStrategy), the algorithm either + sacrifices readability to better match the specified tick count (\ref + QCPAxisTicker::tssMeetTickCount) or relaxes the tick count in favor of better tick steps (\ref + QCPAxisTicker::tssReadability), which is the default. + + The following more specialized axis ticker subclasses are available, see details in the + respective class documentation: + +
+ + + + + + + +
QCPAxisTickerFixed\image html axisticker-fixed.png
QCPAxisTickerLog\image html axisticker-log.png
QCPAxisTickerPi\image html axisticker-pi.png
QCPAxisTickerText\image html axisticker-text.png
QCPAxisTickerDateTime\image html axisticker-datetime.png
QCPAxisTickerTime\image html axisticker-time.png + \image html axisticker-time2.png
+
+ + \section axisticker-subclassing Creating own axis tickers + + Creating own axis tickers can be achieved very easily by sublassing QCPAxisTicker and + reimplementing some or all of the available virtual methods. + + In the simplest case you might wish to just generate different tick steps than the other tickers, + so you only reimplement the method \ref getTickStep. If you additionally want control over the + string that will be shown as tick label, reimplement \ref getTickLabel. + + If you wish to have complete control, you can generate the tick vectors and tick label vectors + yourself by reimplementing \ref createTickVector and \ref createLabelVector. The default + implementations use the previously mentioned virtual methods \ref getTickStep and \ref + getTickLabel, but your reimplementations don't necessarily need to do so. For example in the case + of unequal tick steps, the method \ref getTickStep loses its usefulness and can be ignored. + + The sub tick count between major ticks can be controlled with \ref getSubTickCount. Full sub tick + placement control is obtained by reimplementing \ref createSubTickVector. + + See the documentation of all these virtual methods in QCPAxisTicker for detailed information + about the parameters and expected return values. +*/ + +/*! + Constructs the ticker and sets reasonable default values. Axis tickers are commonly created + managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker. +*/ +QCPAxisTicker::QCPAxisTicker() : + mTickStepStrategy(tssReadability), + mTickCount(5), + mTickOrigin(0) +{ +} + +QCPAxisTicker::~QCPAxisTicker() +{ + +} + +/*! + Sets which strategy the axis ticker follows when choosing the size of the tick step. For the + available strategies, see \ref TickStepStrategy. +*/ +void QCPAxisTicker::setTickStepStrategy(QCPAxisTicker::TickStepStrategy strategy) +{ + mTickStepStrategy = strategy; +} + +/*! + Sets how many ticks this ticker shall aim to generate across the axis range. Note that \a count + is not guaranteed to be matched exactly, as generating readable tick intervals may conflict with + the requested number of ticks. + + Whether the readability has priority over meeting the requested \a count can be specified with + \ref setTickStepStrategy. +*/ +void QCPAxisTicker::setTickCount(int count) +{ + if (count > 0) + mTickCount = count; + else + qDebug() << Q_FUNC_INFO << "tick count must be greater than zero:" << count; +} + +/*! + Sets the mathematical coordinate (or "offset") of the zeroth tick. This tick coordinate is just a + concept and doesn't need to be inside the currently visible axis range. + + By default \a origin is zero, which for example yields ticks {-5, 0, 5, 10, 15,...} when the tick + step is five. If \a origin is now set to 1 instead, the correspondingly generated ticks would be + {-4, 1, 6, 11, 16,...}. +*/ +void QCPAxisTicker::setTickOrigin(double origin) +{ + mTickOrigin = origin; +} + +/*! + This is the method called by QCPAxis in order to actually generate tick coordinates (\a ticks), + tick label strings (\a tickLabels) and sub tick coordinates (\a subTicks). + + The ticks are generated for the specified \a range. The generated labels typically follow the + specified \a locale, \a formatChar and number \a precision, however this might be different (or + even irrelevant) for certain QCPAxisTicker subclasses. + + The output parameter \a ticks is filled with the generated tick positions in axis coordinates. + The output parameters \a subTicks and \a tickLabels are optional (set them to 0 if not needed) + and are respectively filled with sub tick coordinates, and tick label strings belonging to \a + ticks by index. +*/ +void QCPAxisTicker::generate(const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector &ticks, QVector *subTicks, QVector *tickLabels) +{ + // generate (major) ticks: + double tickStep = getTickStep(range); + ticks = createTickVector(tickStep, range); + trimTicks(range, ticks, true); // trim ticks to visible range plus one outer tick on each side (incase a subclass createTickVector creates more) + + // generate sub ticks between major ticks: + if (subTicks) + { + if (ticks.size() > 0) + { + *subTicks = createSubTickVector(getSubTickCount(tickStep), ticks); + trimTicks(range, *subTicks, false); + } else + *subTicks = QVector(); + } + + // finally trim also outliers (no further clipping happens in axis drawing): + trimTicks(range, ticks, false); + // generate labels for visible ticks if requested: + if (tickLabels) + *tickLabels = createLabelVector(ticks, locale, formatChar, precision); +} + +/*! \internal + + Takes the entire currently visible axis range and returns a sensible tick step in + order to provide readable tick labels as well as a reasonable number of tick counts (see \ref + setTickCount, \ref setTickStepStrategy). + + If a QCPAxisTicker subclass only wants a different tick step behaviour than the default + implementation, it should reimplement this method. See \ref cleanMantissa for a possible helper + function. +*/ +double QCPAxisTicker::getTickStep(const QCPRange &range) +{ + double exactStep = range.size()/(double)(mTickCount+1e-10); // mTickCount ticks on average, the small addition is to prevent jitter on exact integers + return cleanMantissa(exactStep); +} + +/*! \internal + + Takes the \a tickStep, i.e. the distance between two consecutive ticks, and returns + an appropriate number of sub ticks for that specific tick step. + + Note that a returned sub tick count of e.g. 4 will split each tick interval into 5 sections. +*/ +int QCPAxisTicker::getSubTickCount(double tickStep) +{ + int result = 1; // default to 1, if no proper value can be found + + // separate integer and fractional part of mantissa: + double epsilon = 0.01; + double intPartf; + int intPart; + double fracPart = modf(getMantissa(tickStep), &intPartf); + intPart = intPartf; + + // handle cases with (almost) integer mantissa: + if (fracPart < epsilon || 1.0-fracPart < epsilon) + { + if (1.0-fracPart < epsilon) + ++intPart; + switch (intPart) + { + case 1: result = 4; break; // 1.0 -> 0.2 substep + case 2: result = 3; break; // 2.0 -> 0.5 substep + case 3: result = 2; break; // 3.0 -> 1.0 substep + case 4: result = 3; break; // 4.0 -> 1.0 substep + case 5: result = 4; break; // 5.0 -> 1.0 substep + case 6: result = 2; break; // 6.0 -> 2.0 substep + case 7: result = 6; break; // 7.0 -> 1.0 substep + case 8: result = 3; break; // 8.0 -> 2.0 substep + case 9: result = 2; break; // 9.0 -> 3.0 substep + } + } else + { + // handle cases with significantly fractional mantissa: + if (qAbs(fracPart-0.5) < epsilon) // *.5 mantissa + { + switch (intPart) + { + case 1: result = 2; break; // 1.5 -> 0.5 substep + case 2: result = 4; break; // 2.5 -> 0.5 substep + case 3: result = 4; break; // 3.5 -> 0.7 substep + case 4: result = 2; break; // 4.5 -> 1.5 substep + case 5: result = 4; break; // 5.5 -> 1.1 substep (won't occur with default getTickStep from here on) + case 6: result = 4; break; // 6.5 -> 1.3 substep + case 7: result = 2; break; // 7.5 -> 2.5 substep + case 8: result = 4; break; // 8.5 -> 1.7 substep + case 9: result = 4; break; // 9.5 -> 1.9 substep + } + } + // if mantissa fraction isn't 0.0 or 0.5, don't bother finding good sub tick marks, leave default + } + + return result; +} + +/*! \internal + + This method returns the tick label string as it should be printed under the \a tick coordinate. + If a textual number is returned, it should respect the provided \a locale, \a formatChar and \a + precision. + + If the returned value contains exponentials of the form "2e5" and beautifully typeset powers is + enabled in the QCPAxis number format (\ref QCPAxis::setNumberFormat), the exponential part will + be formatted accordingly using multiplication symbol and superscript during rendering of the + label automatically. +*/ +QString QCPAxisTicker::getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision) +{ + return locale.toString(tick, formatChar.toLatin1(), precision); +} + +/*! \internal + + Returns a vector containing all coordinates of sub ticks that should be drawn. It generates \a + subTickCount sub ticks between each tick pair given in \a ticks. + + If a QCPAxisTicker subclass needs maximal control over the generated sub ticks, it should + reimplement this method. Depending on the purpose of the subclass it doesn't necessarily need to + base its result on \a subTickCount or \a ticks. +*/ +QVector QCPAxisTicker::createSubTickVector(int subTickCount, const QVector &ticks) +{ + QVector result; + if (subTickCount <= 0 || ticks.size() < 2) + return result; + + result.reserve((ticks.size()-1)*subTickCount); + for (int i=1; i QCPAxisTicker::createTickVector(double tickStep, const QCPRange &range) +{ + QVector result; + // Generate tick positions according to tickStep: + qint64 firstStep = floor((range.lower-mTickOrigin)/tickStep); // do not use qFloor here, or we'll lose 64 bit precision + qint64 lastStep = ceil((range.upper-mTickOrigin)/tickStep); // do not use qCeil here, or we'll lose 64 bit precision + int tickcount = lastStep-firstStep+1; + if (tickcount < 0) tickcount = 0; + result.resize(tickcount); + for (int i=0; i QCPAxisTicker::createLabelVector(const QVector &ticks, const QLocale &locale, QChar formatChar, int precision) +{ + QVector result; + result.reserve(ticks.size()); + for (int i=0; i &ticks, bool keepOneOutlier) const +{ + bool lowFound = false; + bool highFound = false; + int lowIndex = 0; + int highIndex = -1; + + for (int i=0; i < ticks.size(); ++i) + { + if (ticks.at(i) >= range.lower) + { + lowFound = true; + lowIndex = i; + break; + } + } + for (int i=ticks.size()-1; i >= 0; --i) + { + if (ticks.at(i) <= range.upper) + { + highFound = true; + highIndex = i; + break; + } + } + + if (highFound && lowFound) + { + int trimFront = qMax(0, lowIndex-(keepOneOutlier ? 1 : 0)); + int trimBack = qMax(0, ticks.size()-(keepOneOutlier ? 2 : 1)-highIndex); + if (trimFront > 0 || trimBack > 0) + ticks = ticks.mid(trimFront, ticks.size()-trimFront-trimBack); + } else // all ticks are either all below or all above the range + ticks.clear(); +} + +/*! \internal + + Returns the coordinate contained in \a candidates which is closest to the provided \a target. + + This method assumes \a candidates is not empty and sorted in ascending order. +*/ +double QCPAxisTicker::pickClosest(double target, const QVector &candidates) const +{ + if (candidates.size() == 1) + return candidates.first(); + QVector::const_iterator it = std::lower_bound(candidates.constBegin(), candidates.constEnd(), target); + if (it == candidates.constEnd()) + return *(it-1); + else if (it == candidates.constBegin()) + return *it; + else + return target-*(it-1) < *it-target ? *(it-1) : *it; +} + +/*! \internal + + Returns the decimal mantissa of \a input. Optionally, if \a magnitude is not set to zero, it also + returns the magnitude of \a input as a power of 10. + + For example, an input of 142.6 will return a mantissa of 1.426 and a magnitude of 100. +*/ +double QCPAxisTicker::getMantissa(double input, double *magnitude) const +{ + const double mag = qPow(10.0, qFloor(qLn(input)/qLn(10.0))); + if (magnitude) *magnitude = mag; + return input/mag; +} + +/*! \internal + + Returns a number that is close to \a input but has a clean, easier human readable mantissa. How + strongly the mantissa is altered, and thus how strong the result deviates from the original \a + input, depends on the current tick step strategy (see \ref setTickStepStrategy). +*/ +double QCPAxisTicker::cleanMantissa(double input) const +{ + double magnitude; + const double mantissa = getMantissa(input, &magnitude); + switch (mTickStepStrategy) + { + case tssReadability: + { + return pickClosest(mantissa, QVector() << 1.0 << 2.0 << 2.5 << 5.0 << 10.0)*magnitude; + } + case tssMeetTickCount: + { + // this gives effectively a mantissa of 1.0, 1.5, 2.0, 2.5, 3.0, 3.5, 4.0, 4.5, 5.0, 6.0, 8.0, 10.0 + if (mantissa <= 5.0) + return (int)(mantissa*2)/2.0*magnitude; // round digit after decimal point to 0.5 + else + return (int)(mantissa/2.0)*2.0*magnitude; // round to first digit in multiples of 2 + } + } + return input; +} +/* end of 'src/axis/axisticker.cpp' */ + + +/* including file 'src/axis/axistickerdatetime.cpp', size 14443 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAxisTickerDateTime +//////////////////////////////////////////////////////////////////////////////////////////////////// +/*! \class QCPAxisTickerDateTime + \brief Specialized axis ticker for calendar dates and times as axis ticks + + \image html axisticker-datetime.png + + This QCPAxisTicker subclass generates ticks that correspond to real calendar dates and times. The + plot axis coordinate is interpreted as Unix Time, so seconds since Epoch (January 1, 1970, 00:00 + UTC). This is also used for example by QDateTime in the toTime_t()/setTime_t() methods + with a precision of one second. Since Qt 4.7, millisecond accuracy can be obtained from QDateTime + by using QDateTime::fromMSecsSinceEpoch()/1000.0. The static methods \ref dateTimeToKey + and \ref keyToDateTime conveniently perform this conversion achieving a precision of one + millisecond on all Qt versions. + + The format of the date/time display in the tick labels is controlled with \ref setDateTimeFormat. + If a different time spec (time zone) shall be used, see \ref setDateTimeSpec. + + This ticker produces unequal tick spacing in order to provide intuitive date and time-of-day + ticks. For example, if the axis range spans a few years such that there is one tick per year, + ticks will be positioned on 1. January of every year. This is intuitive but, due to leap years, + will result in slightly unequal tick intervals (visually unnoticeable). The same can be seen in + the image above: even though the number of days varies month by month, this ticker generates + ticks on the same day of each month. + + If you would like to change the date/time that is used as a (mathematical) starting date for the + ticks, use the \ref setTickOrigin(const QDateTime &origin) method overload, which takes a + QDateTime. If you pass 15. July, 9:45 to this method, the yearly ticks will end up on 15. July at + 9:45 of every year. + + The ticker can be created and assigned to an axis like this: + \snippet documentation/doc-image-generator/mainwindow.cpp axistickerdatetime-creation + + \note If you rather wish to display relative times in terms of days, hours, minutes, seconds and + milliseconds, and are not interested in the intricacies of real calendar dates with months and + (leap) years, have a look at QCPAxisTickerTime instead. +*/ + +/*! + Constructs the ticker and sets reasonable default values. Axis tickers are commonly created + managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker. +*/ +QCPAxisTickerDateTime::QCPAxisTickerDateTime() : + mDateTimeFormat(QLatin1String("hh:mm:ss\ndd.MM.yy")), + mDateTimeSpec(Qt::LocalTime), + mDateStrategy(dsNone) +{ + setTickCount(4); +} + +/*! + Sets the format in which dates and times are displayed as tick labels. For details about the \a + format string, see the documentation of QDateTime::toString(). + + Newlines can be inserted with "\n". + + \see setDateTimeSpec +*/ +void QCPAxisTickerDateTime::setDateTimeFormat(const QString &format) +{ + mDateTimeFormat = format; +} + +/*! + Sets the time spec that is used for creating the tick labels from corresponding dates/times. + + The default value of QDateTime objects (and also QCPAxisTickerDateTime) is + Qt::LocalTime. However, if the date time values passed to QCustomPlot (e.g. in the form + of axis ranges or keys of a plottable) are given in the UTC spec, set \a spec to Qt::UTC + to get the correct axis labels. + + \see setDateTimeFormat +*/ +void QCPAxisTickerDateTime::setDateTimeSpec(Qt::TimeSpec spec) +{ + mDateTimeSpec = spec; +} + +/*! + Sets the tick origin (see \ref QCPAxisTicker::setTickOrigin) in seconds since Epoch (1. Jan 1970, + 00:00 UTC). For the date time ticker it might be more intuitive to use the overload which + directly takes a QDateTime, see \ref setTickOrigin(const QDateTime &origin). + + This is useful to define the month/day/time recurring at greater tick interval steps. For + example, If you pass 15. July, 9:45 to this method and the tick interval happens to be one tick + per year, the ticks will end up on 15. July at 9:45 of every year. +*/ +void QCPAxisTickerDateTime::setTickOrigin(double origin) +{ + QCPAxisTicker::setTickOrigin(origin); +} + +/*! + Sets the tick origin (see \ref QCPAxisTicker::setTickOrigin) as a QDateTime \a origin. + + This is useful to define the month/day/time recurring at greater tick interval steps. For + example, If you pass 15. July, 9:45 to this method and the tick interval happens to be one tick + per year, the ticks will end up on 15. July at 9:45 of every year. +*/ +void QCPAxisTickerDateTime::setTickOrigin(const QDateTime &origin) +{ + setTickOrigin(dateTimeToKey(origin)); +} + +/*! \internal + + Returns a sensible tick step with intervals appropriate for a date-time-display, such as weekly, + monthly, bi-monthly, etc. + + Note that this tick step isn't used exactly when generating the tick vector in \ref + createTickVector, but only as a guiding value requiring some correction for each individual tick + interval. Otherwise this would lead to unintuitive date displays, e.g. jumping between first day + in the month to the last day in the previous month from tick to tick, due to the non-uniform + length of months. The same problem arises with leap years. + + \seebaseclassmethod +*/ +double QCPAxisTickerDateTime::getTickStep(const QCPRange &range) +{ + double result = range.size()/(double)(mTickCount+1e-10); // mTickCount ticks on average, the small addition is to prevent jitter on exact integers + + mDateStrategy = dsNone; + if (result < 1) // ideal tick step is below 1 second -> use normal clean mantissa algorithm in units of seconds + { + result = cleanMantissa(result); + } else if (result < 86400*30.4375*12) // below a year + { + result = pickClosest(result, QVector() + << 1 << 2.5 << 5 << 10 << 15 << 30 << 60 << 2.5*60 << 5*60 << 10*60 << 15*60 << 30*60 << 60*60 // second, minute, hour range + << 3600*2 << 3600*3 << 3600*6 << 3600*12 << 3600*24 // hour to day range + << 86400*2 << 86400*5 << 86400*7 << 86400*14 << 86400*30.4375 << 86400*30.4375*2 << 86400*30.4375*3 << 86400*30.4375*6 << 86400*30.4375*12); // day, week, month range (avg. days per month includes leap years) + if (result > 86400*30.4375-1) // month tick intervals or larger + mDateStrategy = dsUniformDayInMonth; + else if (result > 3600*24-1) // day tick intervals or larger + mDateStrategy = dsUniformTimeInDay; + } else // more than a year, go back to normal clean mantissa algorithm but in units of years + { + const double secondsPerYear = 86400*30.4375*12; // average including leap years + result = cleanMantissa(result/secondsPerYear)*secondsPerYear; + mDateStrategy = dsUniformDayInMonth; + } + return result; +} + +/*! \internal + + Returns a sensible sub tick count with intervals appropriate for a date-time-display, such as weekly, + monthly, bi-monthly, etc. + + \seebaseclassmethod +*/ +int QCPAxisTickerDateTime::getSubTickCount(double tickStep) +{ + int result = QCPAxisTicker::getSubTickCount(tickStep); + switch (qRound(tickStep)) // hand chosen subticks for specific minute/hour/day/week/month range (as specified in getTickStep) + { + case 5*60: result = 4; break; + case 10*60: result = 1; break; + case 15*60: result = 2; break; + case 30*60: result = 1; break; + case 60*60: result = 3; break; + case 3600*2: result = 3; break; + case 3600*3: result = 2; break; + case 3600*6: result = 1; break; + case 3600*12: result = 3; break; + case 3600*24: result = 3; break; + case 86400*2: result = 1; break; + case 86400*5: result = 4; break; + case 86400*7: result = 6; break; + case 86400*14: result = 1; break; + case (int)(86400*30.4375+0.5): result = 3; break; + case (int)(86400*30.4375*2+0.5): result = 1; break; + case (int)(86400*30.4375*3+0.5): result = 2; break; + case (int)(86400*30.4375*6+0.5): result = 5; break; + case (int)(86400*30.4375*12+0.5): result = 3; break; + } + return result; +} + +/*! \internal + + Generates a date/time tick label for tick coordinate \a tick, based on the currently set format + (\ref setDateTimeFormat) and time spec (\ref setDateTimeSpec). + + \seebaseclassmethod +*/ +QString QCPAxisTickerDateTime::getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision) +{ + Q_UNUSED(precision) + Q_UNUSED(formatChar) + return locale.toString(keyToDateTime(tick).toTimeSpec(mDateTimeSpec), mDateTimeFormat); +} + +/*! \internal + + Uses the passed \a tickStep as a guiding value and applies corrections in order to obtain + non-uniform tick intervals but intuitive tick labels, e.g. falling on the same day of each month. + + \seebaseclassmethod +*/ +QVector QCPAxisTickerDateTime::createTickVector(double tickStep, const QCPRange &range) +{ + QVector result = QCPAxisTicker::createTickVector(tickStep, range); + if (!result.isEmpty()) + { + if (mDateStrategy == dsUniformTimeInDay) + { + QDateTime uniformDateTime = keyToDateTime(mTickOrigin); // the time of this datetime will be set for all other ticks, if possible + QDateTime tickDateTime; + for (int i=0; i 15) // with leap years involved, date month may jump backwards or forwards, and needs to be corrected before setting day + tickDateTime = tickDateTime.addMonths(-1); + tickDateTime.setDate(QDate(tickDateTime.date().year(), tickDateTime.date().month(), thisUniformDay)); + result[i] = dateTimeToKey(tickDateTime); + } + } + } + return result; +} + +/*! + A convenience method which turns \a key (in seconds since Epoch 1. Jan 1970, 00:00 UTC) into a + QDateTime object. This can be used to turn axis coordinates to actual QDateTimes. + + The accuracy achieved by this method is one millisecond, irrespective of the used Qt version (it + works around the lack of a QDateTime::fromMSecsSinceEpoch in Qt 4.6) + + \see dateTimeToKey +*/ +QDateTime QCPAxisTickerDateTime::keyToDateTime(double key) +{ +# if QT_VERSION < QT_VERSION_CHECK(4, 7, 0) + return QDateTime::fromTime_t(key).addMSecs((key-(qint64)key)*1000); +# else + return QDateTime::fromMSecsSinceEpoch(key*1000.0); +# endif +} + +/*! \overload + + A convenience method which turns a QDateTime object into a double value that corresponds to + seconds since Epoch (1. Jan 1970, 00:00 UTC). This is the format used as axis coordinates by + QCPAxisTickerDateTime. + + The accuracy achieved by this method is one millisecond, irrespective of the used Qt version (it + works around the lack of a QDateTime::toMSecsSinceEpoch in Qt 4.6) + + \see keyToDateTime +*/ +double QCPAxisTickerDateTime::dateTimeToKey(const QDateTime dateTime) +{ +# if QT_VERSION < QT_VERSION_CHECK(4, 7, 0) + return dateTime.toTime_t()+dateTime.time().msec()/1000.0; +# else + return dateTime.toMSecsSinceEpoch()/1000.0; +# endif +} + +/*! \overload + + A convenience method which turns a QDate object into a double value that corresponds to + seconds since Epoch (1. Jan 1970, 00:00 UTC). This is the format used as axis coordinates by + QCPAxisTickerDateTime. + + \see keyToDateTime +*/ +double QCPAxisTickerDateTime::dateTimeToKey(const QDate date) +{ +# if QT_VERSION < QT_VERSION_CHECK(4, 7, 0) + return QDateTime(date).toTime_t(); +# else + return QDateTime(date).toMSecsSinceEpoch()/1000.0; +# endif +} +/* end of 'src/axis/axistickerdatetime.cpp' */ + + +/* including file 'src/axis/axistickertime.cpp', size 11747 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAxisTickerTime +//////////////////////////////////////////////////////////////////////////////////////////////////// +/*! \class QCPAxisTickerTime + \brief Specialized axis ticker for time spans in units of milliseconds to days + + \image html axisticker-time.png + + This QCPAxisTicker subclass generates ticks that corresponds to time intervals. + + The format of the time display in the tick labels is controlled with \ref setTimeFormat and \ref + setFieldWidth. The time coordinate is in the unit of seconds with respect to the time coordinate + zero. Unlike with QCPAxisTickerDateTime, the ticks don't correspond to a specific calendar date + and time. + + The time can be displayed in milliseconds, seconds, minutes, hours and days. Depending on the + largest available unit in the format specified with \ref setTimeFormat, any time spans above will + be carried in that largest unit. So for example if the format string is "%m:%s" and a tick at + coordinate value 7815 (being 2 hours, 10 minutes and 15 seconds) is created, the resulting tick + label will show "130:15" (130 minutes, 15 seconds). If the format string is "%h:%m:%s", the hour + unit will be used and the label will thus be "02:10:15". Negative times with respect to the axis + zero will carry a leading minus sign. + + The ticker can be created and assigned to an axis like this: + \snippet documentation/doc-image-generator/mainwindow.cpp axistickertime-creation + + Here is an example of a time axis providing time information in days, hours and minutes. Due to + the axis range spanning a few days and the wanted tick count (\ref setTickCount), the ticker + decided to use tick steps of 12 hours: + + \image html axisticker-time2.png + + The format string for this example is + \snippet documentation/doc-image-generator/mainwindow.cpp axistickertime-creation-2 + + \note If you rather wish to display calendar dates and times, have a look at QCPAxisTickerDateTime + instead. +*/ + +/*! + Constructs the ticker and sets reasonable default values. Axis tickers are commonly created + managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker. +*/ +QCPAxisTickerTime::QCPAxisTickerTime() : + mTimeFormat(QLatin1String("%h:%m:%s")), + mSmallestUnit(tuSeconds), + mBiggestUnit(tuHours) +{ + setTickCount(4); + mFieldWidth[tuMilliseconds] = 3; + mFieldWidth[tuSeconds] = 2; + mFieldWidth[tuMinutes] = 2; + mFieldWidth[tuHours] = 2; + mFieldWidth[tuDays] = 1; + + mFormatPattern[tuMilliseconds] = QLatin1String("%z"); + mFormatPattern[tuSeconds] = QLatin1String("%s"); + mFormatPattern[tuMinutes] = QLatin1String("%m"); + mFormatPattern[tuHours] = QLatin1String("%h"); + mFormatPattern[tuDays] = QLatin1String("%d"); +} + +/*! + Sets the format that will be used to display time in the tick labels. + + The available patterns are: + - %%z for milliseconds + - %%s for seconds + - %%m for minutes + - %%h for hours + - %%d for days + + The field width (zero padding) can be controlled for each unit with \ref setFieldWidth. + + The largest unit that appears in \a format will carry all the remaining time of a certain tick + coordinate, even if it overflows the natural limit of the unit. For example, if %%m is the + largest unit it might become larger than 59 in order to consume larger time values. If on the + other hand %%h is available, the minutes will wrap around to zero after 59 and the time will + carry to the hour digit. +*/ +void QCPAxisTickerTime::setTimeFormat(const QString &format) +{ + mTimeFormat = format; + + // determine smallest and biggest unit in format, to optimize unit replacement and allow biggest + // unit to consume remaining time of a tick value and grow beyond its modulo (e.g. min > 59) + mSmallestUnit = tuMilliseconds; + mBiggestUnit = tuMilliseconds; + bool hasSmallest = false; + for (int i = tuMilliseconds; i <= tuDays; ++i) + { + TimeUnit unit = static_cast(i); + if (mTimeFormat.contains(mFormatPattern.value(unit))) + { + if (!hasSmallest) + { + mSmallestUnit = unit; + hasSmallest = true; + } + mBiggestUnit = unit; + } + } +} + +/*! + Sets the field widh of the specified \a unit to be \a width digits, when displayed in the tick + label. If the number for the specific unit is shorter than \a width, it will be padded with an + according number of zeros to the left in order to reach the field width. + + \see setTimeFormat +*/ +void QCPAxisTickerTime::setFieldWidth(QCPAxisTickerTime::TimeUnit unit, int width) +{ + mFieldWidth[unit] = qMax(width, 1); +} + +/*! \internal + + Returns the tick step appropriate for time displays, depending on the provided \a range and the + smallest available time unit in the current format (\ref setTimeFormat). For example if the unit + of seconds isn't available in the format, this method will not generate steps (like 2.5 minutes) + that require sub-minute precision to be displayed correctly. + + \seebaseclassmethod +*/ +double QCPAxisTickerTime::getTickStep(const QCPRange &range) +{ + double result = range.size()/(double)(mTickCount+1e-10); // mTickCount ticks on average, the small addition is to prevent jitter on exact integers + + if (result < 1) // ideal tick step is below 1 second -> use normal clean mantissa algorithm in units of seconds + { + if (mSmallestUnit == tuMilliseconds) + result = qMax(cleanMantissa(result), 0.001); // smallest tick step is 1 millisecond + else // have no milliseconds available in format, so stick with 1 second tickstep + result = 1.0; + } else if (result < 3600*24) // below a day + { + // the filling of availableSteps seems a bit contorted but it fills in a sorted fashion and thus saves a post-fill sorting run + QVector availableSteps; + // seconds range: + if (mSmallestUnit <= tuSeconds) + availableSteps << 1; + if (mSmallestUnit == tuMilliseconds) + availableSteps << 2.5; // only allow half second steps if milliseconds are there to display it + else if (mSmallestUnit == tuSeconds) + availableSteps << 2; + if (mSmallestUnit <= tuSeconds) + availableSteps << 5 << 10 << 15 << 30; + // minutes range: + if (mSmallestUnit <= tuMinutes) + availableSteps << 1*60; + if (mSmallestUnit <= tuSeconds) + availableSteps << 2.5*60; // only allow half minute steps if seconds are there to display it + else if (mSmallestUnit == tuMinutes) + availableSteps << 2*60; + if (mSmallestUnit <= tuMinutes) + availableSteps << 5*60 << 10*60 << 15*60 << 30*60; + // hours range: + if (mSmallestUnit <= tuHours) + availableSteps << 1*3600 << 2*3600 << 3*3600 << 6*3600 << 12*3600 << 24*3600; + // pick available step that is most appropriate to approximate ideal step: + result = pickClosest(result, availableSteps); + } else // more than a day, go back to normal clean mantissa algorithm but in units of days + { + const double secondsPerDay = 3600*24; + result = cleanMantissa(result/secondsPerDay)*secondsPerDay; + } + return result; +} + +/*! \internal + + Returns the sub tick count appropriate for the provided \a tickStep and time displays. + + \seebaseclassmethod +*/ +int QCPAxisTickerTime::getSubTickCount(double tickStep) +{ + int result = QCPAxisTicker::getSubTickCount(tickStep); + switch (qRound(tickStep)) // hand chosen subticks for specific minute/hour/day range (as specified in getTickStep) + { + case 5*60: result = 4; break; + case 10*60: result = 1; break; + case 15*60: result = 2; break; + case 30*60: result = 1; break; + case 60*60: result = 3; break; + case 3600*2: result = 3; break; + case 3600*3: result = 2; break; + case 3600*6: result = 1; break; + case 3600*12: result = 3; break; + case 3600*24: result = 3; break; + } + return result; +} + +/*! \internal + + Returns the tick label corresponding to the provided \a tick and the configured format and field + widths (\ref setTimeFormat, \ref setFieldWidth). + + \seebaseclassmethod +*/ +QString QCPAxisTickerTime::getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision) +{ + Q_UNUSED(precision) + Q_UNUSED(formatChar) + Q_UNUSED(locale) + bool negative = tick < 0; + if (negative) tick *= -1; + double values[tuDays+1]; // contains the msec/sec/min/... value with its respective modulo (e.g. minute 0..59) + double restValues[tuDays+1]; // contains the msec/sec/min/... value as if it's the largest available unit and thus consumes the remaining time + + restValues[tuMilliseconds] = tick*1000; + values[tuMilliseconds] = modf(restValues[tuMilliseconds]/1000, &restValues[tuSeconds])*1000; + values[tuSeconds] = modf(restValues[tuSeconds]/60, &restValues[tuMinutes])*60; + values[tuMinutes] = modf(restValues[tuMinutes]/60, &restValues[tuHours])*60; + values[tuHours] = modf(restValues[tuHours]/24, &restValues[tuDays])*24; + // no need to set values[tuDays] because days are always a rest value (there is no higher unit so it consumes all remaining time) + + QString result = mTimeFormat; + for (int i = mSmallestUnit; i <= mBiggestUnit; ++i) + { + TimeUnit iUnit = static_cast(i); + replaceUnit(result, iUnit, qRound(iUnit == mBiggestUnit ? restValues[iUnit] : values[iUnit])); + } + if (negative) + result.prepend(QLatin1Char('-')); + return result; +} + +/*! \internal + + Replaces all occurrences of the format pattern belonging to \a unit in \a text with the specified + \a value, using the field width as specified with \ref setFieldWidth for the \a unit. +*/ +void QCPAxisTickerTime::replaceUnit(QString &text, QCPAxisTickerTime::TimeUnit unit, int value) const +{ + QString valueStr = QString::number(value); + while (valueStr.size() < mFieldWidth.value(unit)) + valueStr.prepend(QLatin1Char('0')); + + text.replace(mFormatPattern.value(unit), valueStr); +} +/* end of 'src/axis/axistickertime.cpp' */ + + +/* including file 'src/axis/axistickerfixed.cpp', size 5583 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAxisTickerFixed +//////////////////////////////////////////////////////////////////////////////////////////////////// +/*! \class QCPAxisTickerFixed + \brief Specialized axis ticker with a fixed tick step + + \image html axisticker-fixed.png + + This QCPAxisTicker subclass generates ticks with a fixed tick step set with \ref setTickStep. It + is also possible to allow integer multiples and integer powers of the specified tick step with + \ref setScaleStrategy. + + A typical application of this ticker is to make an axis only display integers, by setting the + tick step of the ticker to 1.0 and the scale strategy to \ref ssMultiples. + + Another case is when a certain number has a special meaning and axis ticks should only appear at + multiples of that value. In this case you might also want to consider \ref QCPAxisTickerPi + because despite the name it is not limited to only pi symbols/values. + + The ticker can be created and assigned to an axis like this: + \snippet documentation/doc-image-generator/mainwindow.cpp axistickerfixed-creation +*/ + +/*! + Constructs the ticker and sets reasonable default values. Axis tickers are commonly created + managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker. +*/ +QCPAxisTickerFixed::QCPAxisTickerFixed() : + mTickStep(1.0), + mScaleStrategy(ssNone) +{ +} + +/*! + Sets the fixed tick interval to \a step. + + The axis ticker will only use this tick step when generating axis ticks. This might cause a very + high tick density and overlapping labels if the axis range is zoomed out. Using \ref + setScaleStrategy it is possible to relax the fixed step and also allow multiples or powers of \a + step. This will enable the ticker to reduce the number of ticks to a reasonable amount (see \ref + setTickCount). +*/ +void QCPAxisTickerFixed::setTickStep(double step) +{ + if (step > 0) + mTickStep = step; + else + qDebug() << Q_FUNC_INFO << "tick step must be greater than zero:" << step; +} + +/*! + Sets whether the specified tick step (\ref setTickStep) is absolutely fixed or whether + modifications may be applied to it before calculating the finally used tick step, such as + permitting multiples or powers. See \ref ScaleStrategy for details. + + The default strategy is \ref ssNone, which means the tick step is absolutely fixed. +*/ +void QCPAxisTickerFixed::setScaleStrategy(QCPAxisTickerFixed::ScaleStrategy strategy) +{ + mScaleStrategy = strategy; +} + +/*! \internal + + Determines the actually used tick step from the specified tick step and scale strategy (\ref + setTickStep, \ref setScaleStrategy). + + This method either returns the specified tick step exactly, or, if the scale strategy is not \ref + ssNone, a modification of it to allow varying the number of ticks in the current axis range. + + \seebaseclassmethod +*/ +double QCPAxisTickerFixed::getTickStep(const QCPRange &range) +{ + switch (mScaleStrategy) + { + case ssNone: + { + return mTickStep; + } + case ssMultiples: + { + double exactStep = range.size()/(double)(mTickCount+1e-10); // mTickCount ticks on average, the small addition is to prevent jitter on exact integers + if (exactStep < mTickStep) + return mTickStep; + else + return (qint64)(cleanMantissa(exactStep/mTickStep)+0.5)*mTickStep; + } + case ssPowers: + { + double exactStep = range.size()/(double)(mTickCount+1e-10); // mTickCount ticks on average, the small addition is to prevent jitter on exact integers + return qPow(mTickStep, (int)(qLn(exactStep)/qLn(mTickStep)+0.5)); + } + } + return mTickStep; +} +/* end of 'src/axis/axistickerfixed.cpp' */ + + +/* including file 'src/axis/axistickertext.cpp', size 8661 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAxisTickerText +//////////////////////////////////////////////////////////////////////////////////////////////////// +/*! \class QCPAxisTickerText + \brief Specialized axis ticker which allows arbitrary labels at specified coordinates + + \image html axisticker-text.png + + This QCPAxisTicker subclass generates ticks which can be directly specified by the user as + coordinates and associated strings. They can be passed as a whole with \ref setTicks or one at a + time with \ref addTick. Alternatively you can directly access the internal storage via \ref ticks + and modify the tick/label data there. + + This is useful for cases where the axis represents categories rather than numerical values. + + If you are updating the ticks of this ticker regularly and in a dynamic fasion (e.g. dependent on + the axis range), it is a sign that you should probably create an own ticker by subclassing + QCPAxisTicker, instead of using this one. + + The ticker can be created and assigned to an axis like this: + \snippet documentation/doc-image-generator/mainwindow.cpp axistickertext-creation +*/ + +/* start of documentation of inline functions */ + +/*! \fn QMap &QCPAxisTickerText::ticks() + + Returns a non-const reference to the internal map which stores the tick coordinates and their + labels. + + You can access the map directly in order to add, remove or manipulate ticks, as an alternative to + using the methods provided by QCPAxisTickerText, such as \ref setTicks and \ref addTick. +*/ + +/* end of documentation of inline functions */ + +/*! + Constructs the ticker and sets reasonable default values. Axis tickers are commonly created + managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker. +*/ +QCPAxisTickerText::QCPAxisTickerText() : + mSubTickCount(0) +{ +} + +/*! \overload + + Sets the ticks that shall appear on the axis. The map key of \a ticks corresponds to the axis + coordinate, and the map value is the string that will appear as tick label. + + An alternative to manipulate ticks is to directly access the internal storage with the \ref ticks + getter. + + \see addTicks, addTick, clear +*/ +void QCPAxisTickerText::setTicks(const QMap &ticks) +{ + mTicks = ticks; +} + +/*! \overload + + Sets the ticks that shall appear on the axis. The entries of \a positions correspond to the axis + coordinates, and the entries of \a labels are the respective strings that will appear as tick + labels. + + \see addTicks, addTick, clear +*/ +void QCPAxisTickerText::setTicks(const QVector &positions, const QVector &labels) +{ + clear(); + addTicks(positions, labels); +} + +/*! + Sets the number of sub ticks that shall appear between ticks. For QCPAxisTickerText, there is no + automatic sub tick count calculation. So if sub ticks are needed, they must be configured with this + method. +*/ +void QCPAxisTickerText::setSubTickCount(int subTicks) +{ + if (subTicks >= 0) + mSubTickCount = subTicks; + else + qDebug() << Q_FUNC_INFO << "sub tick count can't be negative:" << subTicks; +} + +/*! + Clears all ticks. + + An alternative to manipulate ticks is to directly access the internal storage with the \ref ticks + getter. + + \see setTicks, addTicks, addTick +*/ +void QCPAxisTickerText::clear() +{ + mTicks.clear(); +} + +/*! + Adds a single tick to the axis at the given axis coordinate \a position, with the provided tick \a + label. + + \see addTicks, setTicks, clear +*/ +void QCPAxisTickerText::addTick(double position, const QString &label) +{ + mTicks.insert(position, label); +} + +/*! \overload + + Adds the provided \a ticks to the ones already existing. The map key of \a ticks corresponds to + the axis coordinate, and the map value is the string that will appear as tick label. + + An alternative to manipulate ticks is to directly access the internal storage with the \ref ticks + getter. + + \see addTick, setTicks, clear +*/ +void QCPAxisTickerText::addTicks(const QMap &ticks) +{ + mTicks.unite(ticks); +} + +/*! \overload + + Adds the provided ticks to the ones already existing. The entries of \a positions correspond to + the axis coordinates, and the entries of \a labels are the respective strings that will appear as + tick labels. + + An alternative to manipulate ticks is to directly access the internal storage with the \ref ticks + getter. + + \see addTick, setTicks, clear +*/ +void QCPAxisTickerText::addTicks(const QVector &positions, const QVector &labels) +{ + if (positions.size() != labels.size()) + qDebug() << Q_FUNC_INFO << "passed unequal length vectors for positions and labels:" << positions.size() << labels.size(); + int n = qMin(positions.size(), labels.size()); + for (int i=0; i QCPAxisTickerText::createTickVector(double tickStep, const QCPRange &range) +{ + Q_UNUSED(tickStep) + QVector result; + if (mTicks.isEmpty()) + return result; + + QMap::const_iterator start = mTicks.lowerBound(range.lower); + QMap::const_iterator end = mTicks.upperBound(range.upper); + // this method should try to give one tick outside of range so proper subticks can be generated: + if (start != mTicks.constBegin()) --start; + if (end != mTicks.constEnd()) ++end; + for (QMap::const_iterator it = start; it != end; ++it) + result.append(it.key()); + + return result; +} +/* end of 'src/axis/axistickertext.cpp' */ + + +/* including file 'src/axis/axistickerpi.cpp', size 11170 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAxisTickerPi +//////////////////////////////////////////////////////////////////////////////////////////////////// +/*! \class QCPAxisTickerPi + \brief Specialized axis ticker to display ticks in units of an arbitrary constant, for example pi + + \image html axisticker-pi.png + + This QCPAxisTicker subclass generates ticks that are expressed with respect to a given symbolic + constant with a numerical value specified with \ref setPiValue and an appearance in the tick + labels specified with \ref setPiSymbol. + + Ticks may be generated at fractions of the symbolic constant. How these fractions appear in the + tick label can be configured with \ref setFractionStyle. + + The ticker can be created and assigned to an axis like this: + \snippet documentation/doc-image-generator/mainwindow.cpp axistickerpi-creation +*/ + +/*! + Constructs the ticker and sets reasonable default values. Axis tickers are commonly created + managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker. +*/ +QCPAxisTickerPi::QCPAxisTickerPi() : + mPiSymbol(QLatin1String(" ")+QChar(0x03C0)), + mPiValue(M_PI), + mPeriodicity(0), + mFractionStyle(fsUnicodeFractions), + mPiTickStep(0) +{ + setTickCount(4); +} + +/*! + Sets how the symbol part (which is always a suffix to the number) shall appear in the axis tick + label. + + If a space shall appear between the number and the symbol, make sure the space is contained in \a + symbol. +*/ +void QCPAxisTickerPi::setPiSymbol(QString symbol) +{ + mPiSymbol = symbol; +} + +/*! + Sets the numerical value that the symbolic constant has. + + This will be used to place the appropriate fractions of the symbol at the respective axis + coordinates. +*/ +void QCPAxisTickerPi::setPiValue(double pi) +{ + mPiValue = pi; +} + +/*! + Sets whether the axis labels shall appear periodicly and if so, at which multiplicity of the + symbolic constant. + + To disable periodicity, set \a multiplesOfPi to zero. + + For example, an axis that identifies 0 with 2pi would set \a multiplesOfPi to two. +*/ +void QCPAxisTickerPi::setPeriodicity(int multiplesOfPi) +{ + mPeriodicity = qAbs(multiplesOfPi); +} + +/*! + Sets how the numerical/fractional part preceding the symbolic constant is displayed in tick + labels. See \ref FractionStyle for the various options. +*/ +void QCPAxisTickerPi::setFractionStyle(QCPAxisTickerPi::FractionStyle style) +{ + mFractionStyle = style; +} + +/*! \internal + + Returns the tick step, using the constant's value (\ref setPiValue) as base unit. In consequence + the numerical/fractional part preceding the symbolic constant is made to have a readable + mantissa. + + \seebaseclassmethod +*/ +double QCPAxisTickerPi::getTickStep(const QCPRange &range) +{ + mPiTickStep = range.size()/mPiValue/(double)(mTickCount+1e-10); // mTickCount ticks on average, the small addition is to prevent jitter on exact integers + mPiTickStep = cleanMantissa(mPiTickStep); + return mPiTickStep*mPiValue; +} + +/*! \internal + + Returns the sub tick count, using the constant's value (\ref setPiValue) as base unit. In + consequence the sub ticks divide the numerical/fractional part preceding the symbolic constant + reasonably, and not the total tick coordinate. + + \seebaseclassmethod +*/ +int QCPAxisTickerPi::getSubTickCount(double tickStep) +{ + return QCPAxisTicker::getSubTickCount(tickStep/mPiValue); +} + +/*! \internal + + Returns the tick label as a fractional/numerical part and a symbolic string as suffix. The + formatting of the fraction is done according to the specified \ref setFractionStyle. The appended + symbol is specified with \ref setPiSymbol. + + \seebaseclassmethod +*/ +QString QCPAxisTickerPi::getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision) +{ + double tickInPis = tick/mPiValue; + if (mPeriodicity > 0) + tickInPis = fmod(tickInPis, mPeriodicity); + + if (mFractionStyle != fsFloatingPoint && mPiTickStep > 0.09 && mPiTickStep < 50) + { + // simply construct fraction from decimal like 1.234 -> 1234/1000 and then simplify fraction, smaller digits are irrelevant due to mPiTickStep conditional above + int denominator = 1000; + int numerator = qRound(tickInPis*denominator); + simplifyFraction(numerator, denominator); + if (qAbs(numerator) == 1 && denominator == 1) + return (numerator < 0 ? QLatin1String("-") : QLatin1String("")) + mPiSymbol.trimmed(); + else if (numerator == 0) + return QLatin1String("0"); + else + return fractionToString(numerator, denominator) + mPiSymbol; + } else + { + if (qFuzzyIsNull(tickInPis)) + return QLatin1String("0"); + else if (qFuzzyCompare(qAbs(tickInPis), 1.0)) + return (tickInPis < 0 ? QLatin1String("-") : QLatin1String("")) + mPiSymbol.trimmed(); + else + return QCPAxisTicker::getTickLabel(tickInPis, locale, formatChar, precision) + mPiSymbol; + } +} + +/*! \internal + + Takes the fraction given by \a numerator and \a denominator and modifies the values to make sure + the fraction is in irreducible form, i.e. numerator and denominator don't share any common + factors which could be cancelled. +*/ +void QCPAxisTickerPi::simplifyFraction(int &numerator, int &denominator) const +{ + if (numerator == 0 || denominator == 0) + return; + + int num = numerator; + int denom = denominator; + while (denom != 0) // euclidean gcd algorithm + { + int oldDenom = denom; + denom = num % denom; + num = oldDenom; + } + // num is now gcd of numerator and denominator + numerator /= num; + denominator /= num; +} + +/*! \internal + + Takes the fraction given by \a numerator and \a denominator and returns a string representation. + The result depends on the configured fraction style (\ref setFractionStyle). + + This method is used to format the numerical/fractional part when generating tick labels. It + simplifies the passed fraction to an irreducible form using \ref simplifyFraction and factors out + any integer parts of the fraction (e.g. "10/4" becomes "2 1/2"). +*/ +QString QCPAxisTickerPi::fractionToString(int numerator, int denominator) const +{ + if (denominator == 0) + { + qDebug() << Q_FUNC_INFO << "called with zero denominator"; + return QString(); + } + if (mFractionStyle == fsFloatingPoint) // should never be the case when calling this function + { + qDebug() << Q_FUNC_INFO << "shouldn't be called with fraction style fsDecimal"; + return QString::number(numerator/(double)denominator); // failsafe + } + int sign = numerator*denominator < 0 ? -1 : 1; + numerator = qAbs(numerator); + denominator = qAbs(denominator); + + if (denominator == 1) + { + return QString::number(sign*numerator); + } else + { + int integerPart = numerator/denominator; + int remainder = numerator%denominator; + if (remainder == 0) + { + return QString::number(sign*integerPart); + } else + { + if (mFractionStyle == fsAsciiFractions) + { + return QString(QLatin1String("%1%2%3/%4")) + .arg(sign == -1 ? QLatin1String("-") : QLatin1String("")) + .arg(integerPart > 0 ? QString::number(integerPart)+QLatin1String(" ") : QLatin1String("")) + .arg(remainder) + .arg(denominator); + } else if (mFractionStyle == fsUnicodeFractions) + { + return QString(QLatin1String("%1%2%3")) + .arg(sign == -1 ? QLatin1String("-") : QLatin1String("")) + .arg(integerPart > 0 ? QString::number(integerPart) : QLatin1String("")) + .arg(unicodeFraction(remainder, denominator)); + } + } + } + return QString(); +} + +/*! \internal + + Returns the unicode string representation of the fraction given by \a numerator and \a + denominator. This is the representation used in \ref fractionToString when the fraction style + (\ref setFractionStyle) is \ref fsUnicodeFractions. + + This method doesn't use the single-character common fractions but builds each fraction from a + superscript unicode number, the unicode fraction character, and a subscript unicode number. +*/ +QString QCPAxisTickerPi::unicodeFraction(int numerator, int denominator) const +{ + return unicodeSuperscript(numerator)+QChar(0x2044)+unicodeSubscript(denominator); +} + +/*! \internal + + Returns the unicode string representing \a number as superscript. This is used to build + unicode fractions in \ref unicodeFraction. +*/ +QString QCPAxisTickerPi::unicodeSuperscript(int number) const +{ + if (number == 0) + return QString(QChar(0x2070)); + + QString result; + while (number > 0) + { + const int digit = number%10; + switch (digit) + { + case 1: { result.prepend(QChar(0x00B9)); break; } + case 2: { result.prepend(QChar(0x00B2)); break; } + case 3: { result.prepend(QChar(0x00B3)); break; } + default: { result.prepend(QChar(0x2070+digit)); break; } + } + number /= 10; + } + return result; +} + +/*! \internal + + Returns the unicode string representing \a number as subscript. This is used to build unicode + fractions in \ref unicodeFraction. +*/ +QString QCPAxisTickerPi::unicodeSubscript(int number) const +{ + if (number == 0) + return QString(QChar(0x2080)); + + QString result; + while (number > 0) + { + result.prepend(QChar(0x2080+number%10)); + number /= 10; + } + return result; +} +/* end of 'src/axis/axistickerpi.cpp' */ + + +/* including file 'src/axis/axistickerlog.cpp', size 7106 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAxisTickerLog +//////////////////////////////////////////////////////////////////////////////////////////////////// +/*! \class QCPAxisTickerLog + \brief Specialized axis ticker suited for logarithmic axes + + \image html axisticker-log.png + + This QCPAxisTicker subclass generates ticks with unequal tick intervals suited for logarithmic + axis scales. The ticks are placed at powers of the specified log base (\ref setLogBase). + + Especially in the case of a log base equal to 10 (the default), it might be desirable to have + tick labels in the form of powers of ten without mantissa display. To achieve this, set the + number precision (\ref QCPAxis::setNumberPrecision) to zero and the number format (\ref + QCPAxis::setNumberFormat) to scientific (exponential) display with beautifully typeset decimal + powers, so a format string of "eb". This will result in the following axis tick labels: + + \image html axisticker-log-powers.png + + The ticker can be created and assigned to an axis like this: + \snippet documentation/doc-image-generator/mainwindow.cpp axistickerlog-creation +*/ + +/*! + Constructs the ticker and sets reasonable default values. Axis tickers are commonly created + managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker. +*/ +QCPAxisTickerLog::QCPAxisTickerLog() : + mLogBase(10.0), + mSubTickCount(8), // generates 10 intervals + mLogBaseLnInv(1.0/qLn(mLogBase)) +{ +} + +/*! + Sets the logarithm base used for tick coordinate generation. The ticks will be placed at integer + powers of \a base. +*/ +void QCPAxisTickerLog::setLogBase(double base) +{ + if (base > 0) + { + mLogBase = base; + mLogBaseLnInv = 1.0/qLn(mLogBase); + } else + qDebug() << Q_FUNC_INFO << "log base has to be greater than zero:" << base; +} + +/*! + Sets the number of sub ticks in a tick interval. Within each interval, the sub ticks are spaced + linearly to provide a better visual guide, so the sub tick density increases toward the higher + tick. + + Note that \a subTicks is the number of sub ticks (not sub intervals) in one tick interval. So in + the case of logarithm base 10 an intuitive sub tick spacing would be achieved with eight sub + ticks (the default). This means e.g. between the ticks 10 and 100 there will be eight ticks, + namely at 20, 30, 40, 50, 60, 70, 80 and 90. +*/ +void QCPAxisTickerLog::setSubTickCount(int subTicks) +{ + if (subTicks >= 0) + mSubTickCount = subTicks; + else + qDebug() << Q_FUNC_INFO << "sub tick count can't be negative:" << subTicks; +} + +/*! \internal + + Since logarithmic tick steps are necessarily different for each tick interval, this method does + nothing in the case of QCPAxisTickerLog + + \seebaseclassmethod +*/ +double QCPAxisTickerLog::getTickStep(const QCPRange &range) +{ + // Logarithmic axis ticker has unequal tick spacing, so doesn't need this method + Q_UNUSED(range) + return 1.0; +} + +/*! \internal + + Returns the sub tick count specified in \ref setSubTickCount. For QCPAxisTickerLog, there is no + automatic sub tick count calculation necessary. + + \seebaseclassmethod +*/ +int QCPAxisTickerLog::getSubTickCount(double tickStep) +{ + Q_UNUSED(tickStep) + return mSubTickCount; +} + +/*! \internal + + Creates ticks with a spacing given by the logarithm base and an increasing integer power in the + provided \a range. The step in which the power increases tick by tick is chosen in order to keep + the total number of ticks as close as possible to the tick count (\ref setTickCount). The + parameter \a tickStep is ignored for QCPAxisTickerLog + + \seebaseclassmethod +*/ +QVector QCPAxisTickerLog::createTickVector(double tickStep, const QCPRange &range) +{ + Q_UNUSED(tickStep) + QVector result; + if (range.lower > 0 && range.upper > 0) // positive range + { + double exactPowerStep = qLn(range.upper/range.lower)*mLogBaseLnInv/(double)(mTickCount+1e-10); + double newLogBase = qPow(mLogBase, qMax((int)cleanMantissa(exactPowerStep), 1)); + double currentTick = qPow(newLogBase, qFloor(qLn(range.lower)/qLn(newLogBase))); + result.append(currentTick); + while (currentTick < range.upper && currentTick > 0) // currentMag might be zero for ranges ~1e-300, just cancel in that case + { + currentTick *= newLogBase; + result.append(currentTick); + } + } else if (range.lower < 0 && range.upper < 0) // negative range + { + double exactPowerStep = qLn(range.lower/range.upper)*mLogBaseLnInv/(double)(mTickCount+1e-10); + double newLogBase = qPow(mLogBase, qMax((int)cleanMantissa(exactPowerStep), 1)); + double currentTick = -qPow(newLogBase, qCeil(qLn(-range.lower)/qLn(newLogBase))); + result.append(currentTick); + while (currentTick < range.upper && currentTick < 0) // currentMag might be zero for ranges ~1e-300, just cancel in that case + { + currentTick /= newLogBase; + result.append(currentTick); + } + } else // invalid range for logarithmic scale, because lower and upper have different sign + { + qDebug() << Q_FUNC_INFO << "Invalid range for logarithmic plot: " << range.lower << ".." << range.upper; + } + + return result; +} +/* end of 'src/axis/axistickerlog.cpp' */ + + +/* including file 'src/axis/axis.cpp', size 99515 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPGrid +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPGrid + \brief Responsible for drawing the grid of a QCPAxis. + + This class is tightly bound to QCPAxis. Every axis owns a grid instance and uses it to draw the + grid lines, sub grid lines and zero-line. You can interact with the grid of an axis via \ref + QCPAxis::grid. Normally, you don't need to create an instance of QCPGrid yourself. + + The axis and grid drawing was split into two classes to allow them to be placed on different + layers (both QCPAxis and QCPGrid inherit from QCPLayerable). Thus it is possible to have the grid + in the background and the axes in the foreground, and any plottables/items in between. This + described situation is the default setup, see the QCPLayer documentation. +*/ + +/*! + Creates a QCPGrid instance and sets default values. + + You shouldn't instantiate grids on their own, since every QCPAxis brings its own QCPGrid. +*/ +QCPGrid::QCPGrid(QCPAxis *parentAxis) : + QCPLayerable(parentAxis->parentPlot(), QString(), parentAxis), + mParentAxis(parentAxis) +{ + // warning: this is called in QCPAxis constructor, so parentAxis members should not be accessed/called + setParent(parentAxis); + setPen(QPen(QColor(200,200,200), 0, Qt::DotLine)); + setSubGridPen(QPen(QColor(220,220,220), 0, Qt::DotLine)); + setZeroLinePen(QPen(QColor(200,200,200), 0, Qt::SolidLine)); + setSubGridVisible(false); + setAntialiased(false); + setAntialiasedSubGrid(false); + setAntialiasedZeroLine(false); +} + +/*! + Sets whether grid lines at sub tick marks are drawn. + + \see setSubGridPen +*/ +void QCPGrid::setSubGridVisible(bool visible) +{ + mSubGridVisible = visible; +} + +/*! + Sets whether sub grid lines are drawn antialiased. +*/ +void QCPGrid::setAntialiasedSubGrid(bool enabled) +{ + mAntialiasedSubGrid = enabled; +} + +/*! + Sets whether zero lines are drawn antialiased. +*/ +void QCPGrid::setAntialiasedZeroLine(bool enabled) +{ + mAntialiasedZeroLine = enabled; +} + +/*! + Sets the pen with which (major) grid lines are drawn. +*/ +void QCPGrid::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the pen with which sub grid lines are drawn. +*/ +void QCPGrid::setSubGridPen(const QPen &pen) +{ + mSubGridPen = pen; +} + +/*! + Sets the pen with which zero lines are drawn. + + Zero lines are lines at value coordinate 0 which may be drawn with a different pen than other grid + lines. To disable zero lines and just draw normal grid lines at zero, set \a pen to Qt::NoPen. +*/ +void QCPGrid::setZeroLinePen(const QPen &pen) +{ + mZeroLinePen = pen; +} + +/*! \internal + + A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter + before drawing the major grid lines. + + This is the antialiasing state the painter passed to the \ref draw method is in by default. + + This function takes into account the local setting of the antialiasing flag as well as the + overrides set with \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. + + \see setAntialiased +*/ +void QCPGrid::applyDefaultAntialiasingHint(QCPPainter *painter) const +{ + applyAntialiasingHint(painter, mAntialiased, QCP::aeGrid); +} + +/*! \internal + + Draws grid lines and sub grid lines at the positions of (sub) ticks of the parent axis, spanning + over the complete axis rect. Also draws the zero line, if appropriate (\ref setZeroLinePen). +*/ +void QCPGrid::draw(QCPPainter *painter) +{ + if (!mParentAxis) { qDebug() << Q_FUNC_INFO << "invalid parent axis"; return; } + + if (mParentAxis->subTicks() && mSubGridVisible) + drawSubGridLines(painter); + drawGridLines(painter); +} + +/*! \internal + + Draws the main grid lines and possibly a zero line with the specified painter. + + This is a helper function called by \ref draw. +*/ +void QCPGrid::drawGridLines(QCPPainter *painter) const +{ + if (!mParentAxis) { qDebug() << Q_FUNC_INFO << "invalid parent axis"; return; } + + const int tickCount = mParentAxis->mTickVector.size(); + double t; // helper variable, result of coordinate-to-pixel transforms + if (mParentAxis->orientation() == Qt::Horizontal) + { + // draw zeroline: + int zeroLineIndex = -1; + if (mZeroLinePen.style() != Qt::NoPen && mParentAxis->mRange.lower < 0 && mParentAxis->mRange.upper > 0) + { + applyAntialiasingHint(painter, mAntialiasedZeroLine, QCP::aeZeroLine); + painter->setPen(mZeroLinePen); + double epsilon = mParentAxis->range().size()*1E-6; // for comparing double to zero + for (int i=0; imTickVector.at(i)) < epsilon) + { + zeroLineIndex = i; + t = mParentAxis->coordToPixel(mParentAxis->mTickVector.at(i)); // x + painter->drawLine(QLineF(t, mParentAxis->mAxisRect->bottom(), t, mParentAxis->mAxisRect->top())); + break; + } + } + } + // draw grid lines: + applyDefaultAntialiasingHint(painter); + painter->setPen(mPen); + for (int i=0; icoordToPixel(mParentAxis->mTickVector.at(i)); // x + painter->drawLine(QLineF(t, mParentAxis->mAxisRect->bottom(), t, mParentAxis->mAxisRect->top())); + } + } else + { + // draw zeroline: + int zeroLineIndex = -1; + if (mZeroLinePen.style() != Qt::NoPen && mParentAxis->mRange.lower < 0 && mParentAxis->mRange.upper > 0) + { + applyAntialiasingHint(painter, mAntialiasedZeroLine, QCP::aeZeroLine); + painter->setPen(mZeroLinePen); + double epsilon = mParentAxis->mRange.size()*1E-6; // for comparing double to zero + for (int i=0; imTickVector.at(i)) < epsilon) + { + zeroLineIndex = i; + t = mParentAxis->coordToPixel(mParentAxis->mTickVector.at(i)); // y + painter->drawLine(QLineF(mParentAxis->mAxisRect->left(), t, mParentAxis->mAxisRect->right(), t)); + break; + } + } + } + // draw grid lines: + applyDefaultAntialiasingHint(painter); + painter->setPen(mPen); + for (int i=0; icoordToPixel(mParentAxis->mTickVector.at(i)); // y + painter->drawLine(QLineF(mParentAxis->mAxisRect->left(), t, mParentAxis->mAxisRect->right(), t)); + } + } +} + +/*! \internal + + Draws the sub grid lines with the specified painter. + + This is a helper function called by \ref draw. +*/ +void QCPGrid::drawSubGridLines(QCPPainter *painter) const +{ + if (!mParentAxis) { qDebug() << Q_FUNC_INFO << "invalid parent axis"; return; } + + applyAntialiasingHint(painter, mAntialiasedSubGrid, QCP::aeSubGrid); + double t; // helper variable, result of coordinate-to-pixel transforms + painter->setPen(mSubGridPen); + if (mParentAxis->orientation() == Qt::Horizontal) + { + for (int i=0; imSubTickVector.size(); ++i) + { + t = mParentAxis->coordToPixel(mParentAxis->mSubTickVector.at(i)); // x + painter->drawLine(QLineF(t, mParentAxis->mAxisRect->bottom(), t, mParentAxis->mAxisRect->top())); + } + } else + { + for (int i=0; imSubTickVector.size(); ++i) + { + t = mParentAxis->coordToPixel(mParentAxis->mSubTickVector.at(i)); // y + painter->drawLine(QLineF(mParentAxis->mAxisRect->left(), t, mParentAxis->mAxisRect->right(), t)); + } + } +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAxis +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPAxis + \brief Manages a single axis inside a QCustomPlot. + + Usually doesn't need to be instantiated externally. Access %QCustomPlot's default four axes via + QCustomPlot::xAxis (bottom), QCustomPlot::yAxis (left), QCustomPlot::xAxis2 (top) and + QCustomPlot::yAxis2 (right). + + Axes are always part of an axis rect, see QCPAxisRect. + \image html AxisNamesOverview.png +
Naming convention of axis parts
+ \n + + \image html AxisRectSpacingOverview.png +
Overview of the spacings and paddings that define the geometry of an axis. The dashed gray line + on the left represents the QCustomPlot widget border.
+ + Each axis holds an instance of QCPAxisTicker which is used to generate the tick coordinates and + tick labels. You can access the currently installed \ref ticker or set a new one (possibly one of + the specialized subclasses, or your own subclass) via \ref setTicker. For details, see the + documentation of QCPAxisTicker. +*/ + +/* start of documentation of inline functions */ + +/*! \fn Qt::Orientation QCPAxis::orientation() const + + Returns the orientation of this axis. The axis orientation (horizontal or vertical) is deduced + from the axis type (left, top, right or bottom). + + \see orientation(AxisType type), pixelOrientation +*/ + +/*! \fn QCPGrid *QCPAxis::grid() const + + Returns the \ref QCPGrid instance belonging to this axis. Access it to set details about the way the + grid is displayed. +*/ + +/*! \fn static Qt::Orientation QCPAxis::orientation(AxisType type) + + Returns the orientation of the specified axis type + + \see orientation(), pixelOrientation +*/ + +/*! \fn int QCPAxis::pixelOrientation() const + + Returns which direction points towards higher coordinate values/keys, in pixel space. + + This method returns either 1 or -1. If it returns 1, then going in the positive direction along + the orientation of the axis in pixels corresponds to going from lower to higher axis coordinates. + On the other hand, if this method returns -1, going to smaller pixel values corresponds to going + from lower to higher axis coordinates. + + For example, this is useful to easily shift axis coordinates by a certain amount given in pixels, + without having to care about reversed or vertically aligned axes: + + \code + double newKey = keyAxis->pixelToCoord(keyAxis->coordToPixel(oldKey)+10*keyAxis->pixelOrientation()); + \endcode + + \a newKey will then contain a key that is ten pixels towards higher keys, starting from \a oldKey. +*/ + +/*! \fn QSharedPointer QCPAxis::ticker() const + + Returns a modifiable shared pointer to the currently installed axis ticker. The axis ticker is + responsible for generating the tick positions and tick labels of this axis. You can access the + \ref QCPAxisTicker with this method and modify basic properties such as the approximate tick count + (\ref QCPAxisTicker::setTickCount). + + You can gain more control over the axis ticks by setting a different \ref QCPAxisTicker subclass, see + the documentation there. A new axis ticker can be set with \ref setTicker. + + Since the ticker is stored in the axis as a shared pointer, multiple axes may share the same axis + ticker simply by passing the same shared pointer to multiple axes. + + \see setTicker +*/ + +/* end of documentation of inline functions */ +/* start of documentation of signals */ + +/*! \fn void QCPAxis::rangeChanged(const QCPRange &newRange) + + This signal is emitted when the range of this axis has changed. You can connect it to the \ref + setRange slot of another axis to communicate the new range to the other axis, in order for it to + be synchronized. + + You may also manipulate/correct the range with \ref setRange in a slot connected to this signal. + This is useful if for example a maximum range span shall not be exceeded, or if the lower/upper + range shouldn't go beyond certain values (see \ref QCPRange::bounded). For example, the following + slot would limit the x axis to ranges between 0 and 10: + \code + customPlot->xAxis->setRange(newRange.bounded(0, 10)) + \endcode +*/ + +/*! \fn void QCPAxis::rangeChanged(const QCPRange &newRange, const QCPRange &oldRange) + \overload + + Additionally to the new range, this signal also provides the previous range held by the axis as + \a oldRange. +*/ + +/*! \fn void QCPAxis::scaleTypeChanged(QCPAxis::ScaleType scaleType); + + This signal is emitted when the scale type changes, by calls to \ref setScaleType +*/ + +/*! \fn void QCPAxis::selectionChanged(QCPAxis::SelectableParts selection) + + This signal is emitted when the selection state of this axis has changed, either by user interaction + or by a direct call to \ref setSelectedParts. +*/ + +/*! \fn void QCPAxis::selectableChanged(const QCPAxis::SelectableParts &parts); + + This signal is emitted when the selectability changes, by calls to \ref setSelectableParts +*/ + +/* end of documentation of signals */ + +/*! + Constructs an Axis instance of Type \a type for the axis rect \a parent. + + Usually it isn't necessary to instantiate axes directly, because you can let QCustomPlot create + them for you with \ref QCPAxisRect::addAxis. If you want to use own QCPAxis-subclasses however, + create them manually and then inject them also via \ref QCPAxisRect::addAxis. +*/ +QCPAxis::QCPAxis(QCPAxisRect *parent, AxisType type) : + QCPLayerable(parent->parentPlot(), QString(), parent), + // axis base: + mAxisType(type), + mAxisRect(parent), + mPadding(5), + mOrientation(orientation(type)), + mSelectableParts(spAxis | spTickLabels | spAxisLabel), + mSelectedParts(spNone), + mBasePen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), + mSelectedBasePen(QPen(Qt::blue, 2)), + // axis label: + mLabel(), + mLabelFont(mParentPlot->font()), + mSelectedLabelFont(QFont(mLabelFont.family(), mLabelFont.pointSize(), QFont::Bold)), + mLabelColor(Qt::black), + mSelectedLabelColor(Qt::blue), + // tick labels: + mTickLabels(true), + mTickLabelFont(mParentPlot->font()), + mSelectedTickLabelFont(QFont(mTickLabelFont.family(), mTickLabelFont.pointSize(), QFont::Bold)), + mTickLabelColor(Qt::black), + mSelectedTickLabelColor(Qt::blue), + mNumberPrecision(6), + mNumberFormatChar('g'), + mNumberBeautifulPowers(true), + // ticks and subticks: + mTicks(true), + mSubTicks(true), + mTickPen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), + mSelectedTickPen(QPen(Qt::blue, 2)), + mSubTickPen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), + mSelectedSubTickPen(QPen(Qt::blue, 2)), + // scale and range: + mRange(0, 5), + mRangeReversed(false), + mScaleType(stLinear), + // internal members: + mGrid(new QCPGrid(this)), + mAxisPainter(new QCPAxisPainterPrivate(parent->parentPlot())), + mTicker(new QCPAxisTicker), + mCachedMarginValid(false), + mCachedMargin(0) +{ + setParent(parent); + mGrid->setVisible(false); + setAntialiased(false); + setLayer(mParentPlot->currentLayer()); // it's actually on that layer already, but we want it in front of the grid, so we place it on there again + + if (type == atTop) + { + setTickLabelPadding(3); + setLabelPadding(6); + } else if (type == atRight) + { + setTickLabelPadding(7); + setLabelPadding(12); + } else if (type == atBottom) + { + setTickLabelPadding(3); + setLabelPadding(3); + } else if (type == atLeft) + { + setTickLabelPadding(5); + setLabelPadding(10); + } +} + +QCPAxis::~QCPAxis() +{ + delete mAxisPainter; + delete mGrid; // delete grid here instead of via parent ~QObject for better defined deletion order +} + +/* No documentation as it is a property getter */ +int QCPAxis::tickLabelPadding() const +{ + return mAxisPainter->tickLabelPadding; +} + +/* No documentation as it is a property getter */ +double QCPAxis::tickLabelRotation() const +{ + return mAxisPainter->tickLabelRotation; +} + +/* No documentation as it is a property getter */ +QCPAxis::LabelSide QCPAxis::tickLabelSide() const +{ + return mAxisPainter->tickLabelSide; +} + +/* No documentation as it is a property getter */ +QString QCPAxis::numberFormat() const +{ + QString result; + result.append(mNumberFormatChar); + if (mNumberBeautifulPowers) + { + result.append(QLatin1Char('b')); + if (mAxisPainter->numberMultiplyCross) + result.append(QLatin1Char('c')); + } + return result; +} + +/* No documentation as it is a property getter */ +int QCPAxis::tickLengthIn() const +{ + return mAxisPainter->tickLengthIn; +} + +/* No documentation as it is a property getter */ +int QCPAxis::tickLengthOut() const +{ + return mAxisPainter->tickLengthOut; +} + +/* No documentation as it is a property getter */ +int QCPAxis::subTickLengthIn() const +{ + return mAxisPainter->subTickLengthIn; +} + +/* No documentation as it is a property getter */ +int QCPAxis::subTickLengthOut() const +{ + return mAxisPainter->subTickLengthOut; +} + +/* No documentation as it is a property getter */ +int QCPAxis::labelPadding() const +{ + return mAxisPainter->labelPadding; +} + +/* No documentation as it is a property getter */ +int QCPAxis::offset() const +{ + return mAxisPainter->offset; +} + +/* No documentation as it is a property getter */ +QCPLineEnding QCPAxis::lowerEnding() const +{ + return mAxisPainter->lowerEnding; +} + +/* No documentation as it is a property getter */ +QCPLineEnding QCPAxis::upperEnding() const +{ + return mAxisPainter->upperEnding; +} + +/*! + Sets whether the axis uses a linear scale or a logarithmic scale. + + Note that this method controls the coordinate transformation. For logarithmic scales, you will + likely also want to use a logarithmic tick spacing and labeling, which can be achieved by setting + the axis ticker to an instance of \ref QCPAxisTickerLog : + + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpaxisticker-log-creation + + See the documentation of \ref QCPAxisTickerLog about the details of logarithmic axis tick + creation. + + \ref setNumberPrecision +*/ +void QCPAxis::setScaleType(QCPAxis::ScaleType type) +{ + if (mScaleType != type) + { + mScaleType = type; + if (mScaleType == stLogarithmic) + setRange(mRange.sanitizedForLogScale()); + mCachedMarginValid = false; + emit scaleTypeChanged(mScaleType); + } +} + +/*! + Sets the range of the axis. + + This slot may be connected with the \ref rangeChanged signal of another axis so this axis + is always synchronized with the other axis range, when it changes. + + To invert the direction of an axis, use \ref setRangeReversed. +*/ +void QCPAxis::setRange(const QCPRange &range) +{ + if (range.lower == mRange.lower && range.upper == mRange.upper) + return; + + if (!QCPRange::validRange(range)) return; + QCPRange oldRange = mRange; + if (mScaleType == stLogarithmic) + { + mRange = range.sanitizedForLogScale(); + } else + { + mRange = range.sanitizedForLinScale(); + } + emit rangeChanged(mRange); + emit rangeChanged(mRange, oldRange); +} + +/*! + Sets whether the user can (de-)select the parts in \a selectable by clicking on the QCustomPlot surface. + (When \ref QCustomPlot::setInteractions contains iSelectAxes.) + + However, even when \a selectable is set to a value not allowing the selection of a specific part, + it is still possible to set the selection of this part manually, by calling \ref setSelectedParts + directly. + + \see SelectablePart, setSelectedParts +*/ +void QCPAxis::setSelectableParts(const SelectableParts &selectable) +{ + if (mSelectableParts != selectable) + { + mSelectableParts = selectable; + emit selectableChanged(mSelectableParts); + } +} + +/*! + Sets the selected state of the respective axis parts described by \ref SelectablePart. When a part + is selected, it uses a different pen/font. + + The entire selection mechanism for axes is handled automatically when \ref + QCustomPlot::setInteractions contains iSelectAxes. You only need to call this function when you + wish to change the selection state manually. + + This function can change the selection state of a part, independent of the \ref setSelectableParts setting. + + emits the \ref selectionChanged signal when \a selected is different from the previous selection state. + + \see SelectablePart, setSelectableParts, selectTest, setSelectedBasePen, setSelectedTickPen, setSelectedSubTickPen, + setSelectedTickLabelFont, setSelectedLabelFont, setSelectedTickLabelColor, setSelectedLabelColor +*/ +void QCPAxis::setSelectedParts(const SelectableParts &selected) +{ + if (mSelectedParts != selected) + { + mSelectedParts = selected; + emit selectionChanged(mSelectedParts); + } +} + +/*! + \overload + + Sets the lower and upper bound of the axis range. + + To invert the direction of an axis, use \ref setRangeReversed. + + There is also a slot to set a range, see \ref setRange(const QCPRange &range). +*/ +void QCPAxis::setRange(double lower, double upper) +{ + if (lower == mRange.lower && upper == mRange.upper) + return; + + if (!QCPRange::validRange(lower, upper)) return; + QCPRange oldRange = mRange; + mRange.lower = lower; + mRange.upper = upper; + if (mScaleType == stLogarithmic) + { + mRange = mRange.sanitizedForLogScale(); + } else + { + mRange = mRange.sanitizedForLinScale(); + } + emit rangeChanged(mRange); + emit rangeChanged(mRange, oldRange); +} + +/*! + \overload + + Sets the range of the axis. + + The \a position coordinate indicates together with the \a alignment parameter, where the new + range will be positioned. \a size defines the size of the new axis range. \a alignment may be + Qt::AlignLeft, Qt::AlignRight or Qt::AlignCenter. This will cause the left border, right border, + or center of the range to be aligned with \a position. Any other values of \a alignment will + default to Qt::AlignCenter. +*/ +void QCPAxis::setRange(double position, double size, Qt::AlignmentFlag alignment) +{ + if (alignment == Qt::AlignLeft) + setRange(position, position+size); + else if (alignment == Qt::AlignRight) + setRange(position-size, position); + else // alignment == Qt::AlignCenter + setRange(position-size/2.0, position+size/2.0); +} + +/*! + Sets the lower bound of the axis range. The upper bound is not changed. + \see setRange +*/ +void QCPAxis::setRangeLower(double lower) +{ + if (mRange.lower == lower) + return; + + QCPRange oldRange = mRange; + mRange.lower = lower; + if (mScaleType == stLogarithmic) + { + mRange = mRange.sanitizedForLogScale(); + } else + { + mRange = mRange.sanitizedForLinScale(); + } + emit rangeChanged(mRange); + emit rangeChanged(mRange, oldRange); +} + +/*! + Sets the upper bound of the axis range. The lower bound is not changed. + \see setRange +*/ +void QCPAxis::setRangeUpper(double upper) +{ + if (mRange.upper == upper) + return; + + QCPRange oldRange = mRange; + mRange.upper = upper; + if (mScaleType == stLogarithmic) + { + mRange = mRange.sanitizedForLogScale(); + } else + { + mRange = mRange.sanitizedForLinScale(); + } + emit rangeChanged(mRange); + emit rangeChanged(mRange, oldRange); +} + +/*! + Sets whether the axis range (direction) is displayed reversed. Normally, the values on horizontal + axes increase left to right, on vertical axes bottom to top. When \a reversed is set to true, the + direction of increasing values is inverted. + + Note that the range and data interface stays the same for reversed axes, e.g. the \a lower part + of the \ref setRange interface will still reference the mathematically smaller number than the \a + upper part. +*/ +void QCPAxis::setRangeReversed(bool reversed) +{ + mRangeReversed = reversed; +} + +/*! + The axis ticker is responsible for generating the tick positions and tick labels. See the + documentation of QCPAxisTicker for details on how to work with axis tickers. + + You can change the tick positioning/labeling behaviour of this axis by setting a different + QCPAxisTicker subclass using this method. If you only wish to modify the currently installed axis + ticker, access it via \ref ticker. + + Since the ticker is stored in the axis as a shared pointer, multiple axes may share the same axis + ticker simply by passing the same shared pointer to multiple axes. + + \see ticker +*/ +void QCPAxis::setTicker(QSharedPointer ticker) +{ + if (ticker) + mTicker = ticker; + else + qDebug() << Q_FUNC_INFO << "can not set 0 as axis ticker"; + // no need to invalidate margin cache here because produced tick labels are checked for changes in setupTickVector +} + +/*! + Sets whether tick marks are displayed. + + Note that setting \a show to false does not imply that tick labels are invisible, too. To achieve + that, see \ref setTickLabels. + + \see setSubTicks +*/ +void QCPAxis::setTicks(bool show) +{ + if (mTicks != show) + { + mTicks = show; + mCachedMarginValid = false; + } +} + +/*! + Sets whether tick labels are displayed. Tick labels are the numbers drawn next to tick marks. +*/ +void QCPAxis::setTickLabels(bool show) +{ + if (mTickLabels != show) + { + mTickLabels = show; + mCachedMarginValid = false; + if (!mTickLabels) + mTickVectorLabels.clear(); + } +} + +/*! + Sets the distance between the axis base line (including any outward ticks) and the tick labels. + \see setLabelPadding, setPadding +*/ +void QCPAxis::setTickLabelPadding(int padding) +{ + if (mAxisPainter->tickLabelPadding != padding) + { + mAxisPainter->tickLabelPadding = padding; + mCachedMarginValid = false; + } +} + +/*! + Sets the font of the tick labels. + + \see setTickLabels, setTickLabelColor +*/ +void QCPAxis::setTickLabelFont(const QFont &font) +{ + if (font != mTickLabelFont) + { + mTickLabelFont = font; + mCachedMarginValid = false; + } +} + +/*! + Sets the color of the tick labels. + + \see setTickLabels, setTickLabelFont +*/ +void QCPAxis::setTickLabelColor(const QColor &color) +{ + mTickLabelColor = color; +} + +/*! + Sets the rotation of the tick labels. If \a degrees is zero, the labels are drawn normally. Else, + the tick labels are drawn rotated by \a degrees clockwise. The specified angle is bound to values + from -90 to 90 degrees. + + If \a degrees is exactly -90, 0 or 90, the tick labels are centered on the tick coordinate. For + other angles, the label is drawn with an offset such that it seems to point toward or away from + the tick mark. +*/ +void QCPAxis::setTickLabelRotation(double degrees) +{ + if (!qFuzzyIsNull(degrees-mAxisPainter->tickLabelRotation)) + { + mAxisPainter->tickLabelRotation = qBound(-90.0, degrees, 90.0); + mCachedMarginValid = false; + } +} + +/*! + Sets whether the tick labels (numbers) shall appear inside or outside the axis rect. + + The usual and default setting is \ref lsOutside. Very compact plots sometimes require tick labels + to be inside the axis rect, to save space. If \a side is set to \ref lsInside, the tick labels + appear on the inside are additionally clipped to the axis rect. +*/ +void QCPAxis::setTickLabelSide(LabelSide side) +{ + mAxisPainter->tickLabelSide = side; + mCachedMarginValid = false; +} + +/*! + Sets the number format for the numbers in tick labels. This \a formatCode is an extended version + of the format code used e.g. by QString::number() and QLocale::toString(). For reference about + that, see the "Argument Formats" section in the detailed description of the QString class. + + \a formatCode is a string of one, two or three characters. The first character is identical to + the normal format code used by Qt. In short, this means: 'e'/'E' scientific format, 'f' fixed + format, 'g'/'G' scientific or fixed, whichever is shorter. + + The second and third characters are optional and specific to QCustomPlot:\n + If the first char was 'e' or 'g', numbers are/might be displayed in the scientific format, e.g. + "5.5e9", which is ugly in a plot. So when the second char of \a formatCode is set to 'b' (for + "beautiful"), those exponential numbers are formatted in a more natural way, i.e. "5.5 + [multiplication sign] 10 [superscript] 9". By default, the multiplication sign is a centered dot. + If instead a cross should be shown (as is usual in the USA), the third char of \a formatCode can + be set to 'c'. The inserted multiplication signs are the UTF-8 characters 215 (0xD7) for the + cross and 183 (0xB7) for the dot. + + Examples for \a formatCode: + \li \c g normal format code behaviour. If number is small, fixed format is used, if number is large, + normal scientific format is used + \li \c gb If number is small, fixed format is used, if number is large, scientific format is used with + beautifully typeset decimal powers and a dot as multiplication sign + \li \c ebc All numbers are in scientific format with beautifully typeset decimal power and a cross as + multiplication sign + \li \c fb illegal format code, since fixed format doesn't support (or need) beautifully typeset decimal + powers. Format code will be reduced to 'f'. + \li \c hello illegal format code, since first char is not 'e', 'E', 'f', 'g' or 'G'. Current format + code will not be changed. +*/ +void QCPAxis::setNumberFormat(const QString &formatCode) +{ + if (formatCode.isEmpty()) + { + qDebug() << Q_FUNC_INFO << "Passed formatCode is empty"; + return; + } + mCachedMarginValid = false; + + // interpret first char as number format char: + QString allowedFormatChars(QLatin1String("eEfgG")); + if (allowedFormatChars.contains(formatCode.at(0))) + { + mNumberFormatChar = QLatin1Char(formatCode.at(0).toLatin1()); + } else + { + qDebug() << Q_FUNC_INFO << "Invalid number format code (first char not in 'eEfgG'):" << formatCode; + return; + } + if (formatCode.length() < 2) + { + mNumberBeautifulPowers = false; + mAxisPainter->numberMultiplyCross = false; + return; + } + + // interpret second char as indicator for beautiful decimal powers: + if (formatCode.at(1) == QLatin1Char('b') && (mNumberFormatChar == QLatin1Char('e') || mNumberFormatChar == QLatin1Char('g'))) + { + mNumberBeautifulPowers = true; + } else + { + qDebug() << Q_FUNC_INFO << "Invalid number format code (second char not 'b' or first char neither 'e' nor 'g'):" << formatCode; + return; + } + if (formatCode.length() < 3) + { + mAxisPainter->numberMultiplyCross = false; + return; + } + + // interpret third char as indicator for dot or cross multiplication symbol: + if (formatCode.at(2) == QLatin1Char('c')) + { + mAxisPainter->numberMultiplyCross = true; + } else if (formatCode.at(2) == QLatin1Char('d')) + { + mAxisPainter->numberMultiplyCross = false; + } else + { + qDebug() << Q_FUNC_INFO << "Invalid number format code (third char neither 'c' nor 'd'):" << formatCode; + return; + } +} + +/*! + Sets the precision of the tick label numbers. See QLocale::toString(double i, char f, int prec) + for details. The effect of precisions are most notably for number Formats starting with 'e', see + \ref setNumberFormat +*/ +void QCPAxis::setNumberPrecision(int precision) +{ + if (mNumberPrecision != precision) + { + mNumberPrecision = precision; + mCachedMarginValid = false; + } +} + +/*! + Sets the length of the ticks in pixels. \a inside is the length the ticks will reach inside the + plot and \a outside is the length they will reach outside the plot. If \a outside is greater than + zero, the tick labels and axis label will increase their distance to the axis accordingly, so + they won't collide with the ticks. + + \see setSubTickLength, setTickLengthIn, setTickLengthOut +*/ +void QCPAxis::setTickLength(int inside, int outside) +{ + setTickLengthIn(inside); + setTickLengthOut(outside); +} + +/*! + Sets the length of the inward ticks in pixels. \a inside is the length the ticks will reach + inside the plot. + + \see setTickLengthOut, setTickLength, setSubTickLength +*/ +void QCPAxis::setTickLengthIn(int inside) +{ + if (mAxisPainter->tickLengthIn != inside) + { + mAxisPainter->tickLengthIn = inside; + } +} + +/*! + Sets the length of the outward ticks in pixels. \a outside is the length the ticks will reach + outside the plot. If \a outside is greater than zero, the tick labels and axis label will + increase their distance to the axis accordingly, so they won't collide with the ticks. + + \see setTickLengthIn, setTickLength, setSubTickLength +*/ +void QCPAxis::setTickLengthOut(int outside) +{ + if (mAxisPainter->tickLengthOut != outside) + { + mAxisPainter->tickLengthOut = outside; + mCachedMarginValid = false; // only outside tick length can change margin + } +} + +/*! + Sets whether sub tick marks are displayed. + + Sub ticks are only potentially visible if (major) ticks are also visible (see \ref setTicks) + + \see setTicks +*/ +void QCPAxis::setSubTicks(bool show) +{ + if (mSubTicks != show) + { + mSubTicks = show; + mCachedMarginValid = false; + } +} + +/*! + Sets the length of the subticks in pixels. \a inside is the length the subticks will reach inside + the plot and \a outside is the length they will reach outside the plot. If \a outside is greater + than zero, the tick labels and axis label will increase their distance to the axis accordingly, + so they won't collide with the ticks. + + \see setTickLength, setSubTickLengthIn, setSubTickLengthOut +*/ +void QCPAxis::setSubTickLength(int inside, int outside) +{ + setSubTickLengthIn(inside); + setSubTickLengthOut(outside); +} + +/*! + Sets the length of the inward subticks in pixels. \a inside is the length the subticks will reach inside + the plot. + + \see setSubTickLengthOut, setSubTickLength, setTickLength +*/ +void QCPAxis::setSubTickLengthIn(int inside) +{ + if (mAxisPainter->subTickLengthIn != inside) + { + mAxisPainter->subTickLengthIn = inside; + } +} + +/*! + Sets the length of the outward subticks in pixels. \a outside is the length the subticks will reach + outside the plot. If \a outside is greater than zero, the tick labels will increase their + distance to the axis accordingly, so they won't collide with the ticks. + + \see setSubTickLengthIn, setSubTickLength, setTickLength +*/ +void QCPAxis::setSubTickLengthOut(int outside) +{ + if (mAxisPainter->subTickLengthOut != outside) + { + mAxisPainter->subTickLengthOut = outside; + mCachedMarginValid = false; // only outside tick length can change margin + } +} + +/*! + Sets the pen, the axis base line is drawn with. + + \see setTickPen, setSubTickPen +*/ +void QCPAxis::setBasePen(const QPen &pen) +{ + mBasePen = pen; +} + +/*! + Sets the pen, tick marks will be drawn with. + + \see setTickLength, setBasePen +*/ +void QCPAxis::setTickPen(const QPen &pen) +{ + mTickPen = pen; +} + +/*! + Sets the pen, subtick marks will be drawn with. + + \see setSubTickCount, setSubTickLength, setBasePen +*/ +void QCPAxis::setSubTickPen(const QPen &pen) +{ + mSubTickPen = pen; +} + +/*! + Sets the font of the axis label. + + \see setLabelColor +*/ +void QCPAxis::setLabelFont(const QFont &font) +{ + if (mLabelFont != font) + { + mLabelFont = font; + mCachedMarginValid = false; + } +} + +/*! + Sets the color of the axis label. + + \see setLabelFont +*/ +void QCPAxis::setLabelColor(const QColor &color) +{ + mLabelColor = color; +} + +/*! + Sets the text of the axis label that will be shown below/above or next to the axis, depending on + its orientation. To disable axis labels, pass an empty string as \a str. +*/ +void QCPAxis::setLabel(const QString &str) +{ + if (mLabel != str) + { + mLabel = str; + mCachedMarginValid = false; + } +} + +/*! + Sets the distance between the tick labels and the axis label. + + \see setTickLabelPadding, setPadding +*/ +void QCPAxis::setLabelPadding(int padding) +{ + if (mAxisPainter->labelPadding != padding) + { + mAxisPainter->labelPadding = padding; + mCachedMarginValid = false; + } +} + +/*! + Sets the padding of the axis. + + When \ref QCPAxisRect::setAutoMargins is enabled, the padding is the additional outer most space, + that is left blank. + + The axis padding has no meaning if \ref QCPAxisRect::setAutoMargins is disabled. + + \see setLabelPadding, setTickLabelPadding +*/ +void QCPAxis::setPadding(int padding) +{ + if (mPadding != padding) + { + mPadding = padding; + mCachedMarginValid = false; + } +} + +/*! + Sets the offset the axis has to its axis rect side. + + If an axis rect side has multiple axes and automatic margin calculation is enabled for that side, + only the offset of the inner most axis has meaning (even if it is set to be invisible). The + offset of the other, outer axes is controlled automatically, to place them at appropriate + positions. +*/ +void QCPAxis::setOffset(int offset) +{ + mAxisPainter->offset = offset; +} + +/*! + Sets the font that is used for tick labels when they are selected. + + \see setTickLabelFont, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions +*/ +void QCPAxis::setSelectedTickLabelFont(const QFont &font) +{ + if (font != mSelectedTickLabelFont) + { + mSelectedTickLabelFont = font; + // don't set mCachedMarginValid to false here because margin calculation is always done with non-selected fonts + } +} + +/*! + Sets the font that is used for the axis label when it is selected. + + \see setLabelFont, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions +*/ +void QCPAxis::setSelectedLabelFont(const QFont &font) +{ + mSelectedLabelFont = font; + // don't set mCachedMarginValid to false here because margin calculation is always done with non-selected fonts +} + +/*! + Sets the color that is used for tick labels when they are selected. + + \see setTickLabelColor, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions +*/ +void QCPAxis::setSelectedTickLabelColor(const QColor &color) +{ + if (color != mSelectedTickLabelColor) + { + mSelectedTickLabelColor = color; + } +} + +/*! + Sets the color that is used for the axis label when it is selected. + + \see setLabelColor, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions +*/ +void QCPAxis::setSelectedLabelColor(const QColor &color) +{ + mSelectedLabelColor = color; +} + +/*! + Sets the pen that is used to draw the axis base line when selected. + + \see setBasePen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions +*/ +void QCPAxis::setSelectedBasePen(const QPen &pen) +{ + mSelectedBasePen = pen; +} + +/*! + Sets the pen that is used to draw the (major) ticks when selected. + + \see setTickPen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions +*/ +void QCPAxis::setSelectedTickPen(const QPen &pen) +{ + mSelectedTickPen = pen; +} + +/*! + Sets the pen that is used to draw the subticks when selected. + + \see setSubTickPen, setSelectableParts, setSelectedParts, QCustomPlot::setInteractions +*/ +void QCPAxis::setSelectedSubTickPen(const QPen &pen) +{ + mSelectedSubTickPen = pen; +} + +/*! + Sets the style for the lower axis ending. See the documentation of QCPLineEnding for available + styles. + + For horizontal axes, this method refers to the left ending, for vertical axes the bottom ending. + Note that this meaning does not change when the axis range is reversed with \ref + setRangeReversed. + + \see setUpperEnding +*/ +void QCPAxis::setLowerEnding(const QCPLineEnding &ending) +{ + mAxisPainter->lowerEnding = ending; +} + +/*! + Sets the style for the upper axis ending. See the documentation of QCPLineEnding for available + styles. + + For horizontal axes, this method refers to the right ending, for vertical axes the top ending. + Note that this meaning does not change when the axis range is reversed with \ref + setRangeReversed. + + \see setLowerEnding +*/ +void QCPAxis::setUpperEnding(const QCPLineEnding &ending) +{ + mAxisPainter->upperEnding = ending; +} + +/*! + If the scale type (\ref setScaleType) is \ref stLinear, \a diff is added to the lower and upper + bounds of the range. The range is simply moved by \a diff. + + If the scale type is \ref stLogarithmic, the range bounds are multiplied by \a diff. This + corresponds to an apparent "linear" move in logarithmic scaling by a distance of log(diff). +*/ +void QCPAxis::moveRange(double diff) +{ + QCPRange oldRange = mRange; + if (mScaleType == stLinear) + { + mRange.lower += diff; + mRange.upper += diff; + } else // mScaleType == stLogarithmic + { + mRange.lower *= diff; + mRange.upper *= diff; + } + emit rangeChanged(mRange); + emit rangeChanged(mRange, oldRange); +} + +/*! + Scales the range of this axis by \a factor around the center of the current axis range. For + example, if \a factor is 2.0, then the axis range will double its size, and the point at the axis + range center won't have changed its position in the QCustomPlot widget (i.e. coordinates around + the center will have moved symmetrically closer). + + If you wish to scale around a different coordinate than the current axis range center, use the + overload \ref scaleRange(double factor, double center). +*/ +void QCPAxis::scaleRange(double factor) +{ + scaleRange(factor, range().center()); +} + +/*! \overload + + Scales the range of this axis by \a factor around the coordinate \a center. For example, if \a + factor is 2.0, \a center is 1.0, then the axis range will double its size, and the point at + coordinate 1.0 won't have changed its position in the QCustomPlot widget (i.e. coordinates + around 1.0 will have moved symmetrically closer to 1.0). + + \see scaleRange(double factor) +*/ +void QCPAxis::scaleRange(double factor, double center) +{ + QCPRange oldRange = mRange; + if (mScaleType == stLinear) + { + QCPRange newRange; + newRange.lower = (mRange.lower-center)*factor + center; + newRange.upper = (mRange.upper-center)*factor + center; + if (QCPRange::validRange(newRange)) + mRange = newRange.sanitizedForLinScale(); + } else // mScaleType == stLogarithmic + { + if ((mRange.upper < 0 && center < 0) || (mRange.upper > 0 && center > 0)) // make sure center has same sign as range + { + QCPRange newRange; + newRange.lower = qPow(mRange.lower/center, factor)*center; + newRange.upper = qPow(mRange.upper/center, factor)*center; + if (QCPRange::validRange(newRange)) + mRange = newRange.sanitizedForLogScale(); + } else + qDebug() << Q_FUNC_INFO << "Center of scaling operation doesn't lie in same logarithmic sign domain as range:" << center; + } + emit rangeChanged(mRange); + emit rangeChanged(mRange, oldRange); +} + +/*! + Scales the range of this axis to have a certain scale \a ratio to \a otherAxis. The scaling will + be done around the center of the current axis range. + + For example, if \a ratio is 1, this axis is the \a yAxis and \a otherAxis is \a xAxis, graphs + plotted with those axes will appear in a 1:1 aspect ratio, independent of the aspect ratio the + axis rect has. + + This is an operation that changes the range of this axis once, it doesn't fix the scale ratio + indefinitely. Note that calling this function in the constructor of the QCustomPlot's parent + won't have the desired effect, since the widget dimensions aren't defined yet, and a resizeEvent + will follow. +*/ +void QCPAxis::setScaleRatio(const QCPAxis *otherAxis, double ratio) +{ + int otherPixelSize, ownPixelSize; + + if (otherAxis->orientation() == Qt::Horizontal) + otherPixelSize = otherAxis->axisRect()->width(); + else + otherPixelSize = otherAxis->axisRect()->height(); + + if (orientation() == Qt::Horizontal) + ownPixelSize = axisRect()->width(); + else + ownPixelSize = axisRect()->height(); + + double newRangeSize = ratio*otherAxis->range().size()*ownPixelSize/(double)otherPixelSize; + setRange(range().center(), newRangeSize, Qt::AlignCenter); +} + +/*! + Changes the axis range such that all plottables associated with this axis are fully visible in + that dimension. + + \see QCPAbstractPlottable::rescaleAxes, QCustomPlot::rescaleAxes +*/ +void QCPAxis::rescale(bool onlyVisiblePlottables) +{ + QList p = plottables(); + QCPRange newRange; + bool haveRange = false; + for (int i=0; irealVisibility() && onlyVisiblePlottables) + continue; + QCPRange plottableRange; + bool currentFoundRange; + QCP::SignDomain signDomain = QCP::sdBoth; + if (mScaleType == stLogarithmic) + signDomain = (mRange.upper < 0 ? QCP::sdNegative : QCP::sdPositive); + if (p.at(i)->keyAxis() == this) + plottableRange = p.at(i)->getKeyRange(currentFoundRange, signDomain); + else + plottableRange = p.at(i)->getValueRange(currentFoundRange, signDomain); + if (currentFoundRange) + { + if (!haveRange) + newRange = plottableRange; + else + newRange.expand(plottableRange); + haveRange = true; + } + } + if (haveRange) + { + if (!QCPRange::validRange(newRange)) // likely due to range being zero (plottable has only constant data in this axis dimension), shift current range to at least center the plottable + { + double center = (newRange.lower+newRange.upper)*0.5; // upper and lower should be equal anyway, but just to make sure, incase validRange returned false for other reason + if (mScaleType == stLinear) + { + newRange.lower = center-mRange.size()/2.0; + newRange.upper = center+mRange.size()/2.0; + } else // mScaleType == stLogarithmic + { + newRange.lower = center/qSqrt(mRange.upper/mRange.lower); + newRange.upper = center*qSqrt(mRange.upper/mRange.lower); + } + } + setRange(newRange); + } +} + +/*! + Transforms \a value, in pixel coordinates of the QCustomPlot widget, to axis coordinates. +*/ +double QCPAxis::pixelToCoord(double value) const +{ + if (orientation() == Qt::Horizontal) + { + if (mScaleType == stLinear) + { + if (!mRangeReversed) + return (value-mAxisRect->left())/(double)mAxisRect->width()*mRange.size()+mRange.lower; + else + return -(value-mAxisRect->left())/(double)mAxisRect->width()*mRange.size()+mRange.upper; + } else // mScaleType == stLogarithmic + { + if (!mRangeReversed) + return qPow(mRange.upper/mRange.lower, (value-mAxisRect->left())/(double)mAxisRect->width())*mRange.lower; + else + return qPow(mRange.upper/mRange.lower, (mAxisRect->left()-value)/(double)mAxisRect->width())*mRange.upper; + } + } else // orientation() == Qt::Vertical + { + if (mScaleType == stLinear) + { + if (!mRangeReversed) + return (mAxisRect->bottom()-value)/(double)mAxisRect->height()*mRange.size()+mRange.lower; + else + return -(mAxisRect->bottom()-value)/(double)mAxisRect->height()*mRange.size()+mRange.upper; + } else // mScaleType == stLogarithmic + { + if (!mRangeReversed) + return qPow(mRange.upper/mRange.lower, (mAxisRect->bottom()-value)/(double)mAxisRect->height())*mRange.lower; + else + return qPow(mRange.upper/mRange.lower, (value-mAxisRect->bottom())/(double)mAxisRect->height())*mRange.upper; + } + } +} + +/*! + Transforms \a value, in coordinates of the axis, to pixel coordinates of the QCustomPlot widget. +*/ +double QCPAxis::coordToPixel(double value) const +{ + if (orientation() == Qt::Horizontal) + { + if (mScaleType == stLinear) + { + if (!mRangeReversed) + return (value-mRange.lower)/mRange.size()*mAxisRect->width()+mAxisRect->left(); + else + return (mRange.upper-value)/mRange.size()*mAxisRect->width()+mAxisRect->left(); + } else // mScaleType == stLogarithmic + { + if (value >= 0.0 && mRange.upper < 0.0) // invalid value for logarithmic scale, just draw it outside visible range + return !mRangeReversed ? mAxisRect->right()+200 : mAxisRect->left()-200; + else if (value <= 0.0 && mRange.upper >= 0.0) // invalid value for logarithmic scale, just draw it outside visible range + return !mRangeReversed ? mAxisRect->left()-200 : mAxisRect->right()+200; + else + { + if (!mRangeReversed) + return qLn(value/mRange.lower)/qLn(mRange.upper/mRange.lower)*mAxisRect->width()+mAxisRect->left(); + else + return qLn(mRange.upper/value)/qLn(mRange.upper/mRange.lower)*mAxisRect->width()+mAxisRect->left(); + } + } + } else // orientation() == Qt::Vertical + { + if (mScaleType == stLinear) + { + if (!mRangeReversed) + return mAxisRect->bottom()-(value-mRange.lower)/mRange.size()*mAxisRect->height(); + else + return mAxisRect->bottom()-(mRange.upper-value)/mRange.size()*mAxisRect->height(); + } else // mScaleType == stLogarithmic + { + if (value >= 0.0 && mRange.upper < 0.0) // invalid value for logarithmic scale, just draw it outside visible range + return !mRangeReversed ? mAxisRect->top()-200 : mAxisRect->bottom()+200; + else if (value <= 0.0 && mRange.upper >= 0.0) // invalid value for logarithmic scale, just draw it outside visible range + return !mRangeReversed ? mAxisRect->bottom()+200 : mAxisRect->top()-200; + else + { + if (!mRangeReversed) + return mAxisRect->bottom()-qLn(value/mRange.lower)/qLn(mRange.upper/mRange.lower)*mAxisRect->height(); + else + return mAxisRect->bottom()-qLn(mRange.upper/value)/qLn(mRange.upper/mRange.lower)*mAxisRect->height(); + } + } + } +} + +/*! + Returns the part of the axis that is hit by \a pos (in pixels). The return value of this function + is independent of the user-selectable parts defined with \ref setSelectableParts. Further, this + function does not change the current selection state of the axis. + + If the axis is not visible (\ref setVisible), this function always returns \ref spNone. + + \see setSelectedParts, setSelectableParts, QCustomPlot::setInteractions +*/ +QCPAxis::SelectablePart QCPAxis::getPartAt(const QPointF &pos) const +{ + if (!mVisible) + return spNone; + + if (mAxisPainter->axisSelectionBox().contains(pos.toPoint())) + return spAxis; + else if (mAxisPainter->tickLabelsSelectionBox().contains(pos.toPoint())) + return spTickLabels; + else if (mAxisPainter->labelSelectionBox().contains(pos.toPoint())) + return spAxisLabel; + else + return spNone; +} + +/* inherits documentation from base class */ +double QCPAxis::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + if (!mParentPlot) return -1; + SelectablePart part = getPartAt(pos); + if ((onlySelectable && !mSelectableParts.testFlag(part)) || part == spNone) + return -1; + + if (details) + details->setValue(part); + return mParentPlot->selectionTolerance()*0.99; +} + +/*! + Returns a list of all the plottables that have this axis as key or value axis. + + If you are only interested in plottables of type QCPGraph, see \ref graphs. + + \see graphs, items +*/ +QList QCPAxis::plottables() const +{ + QList result; + if (!mParentPlot) return result; + + for (int i=0; imPlottables.size(); ++i) + { + if (mParentPlot->mPlottables.at(i)->keyAxis() == this ||mParentPlot->mPlottables.at(i)->valueAxis() == this) + result.append(mParentPlot->mPlottables.at(i)); + } + return result; +} + +/*! + Returns a list of all the graphs that have this axis as key or value axis. + + \see plottables, items +*/ +QList QCPAxis::graphs() const +{ + QList result; + if (!mParentPlot) return result; + + for (int i=0; imGraphs.size(); ++i) + { + if (mParentPlot->mGraphs.at(i)->keyAxis() == this || mParentPlot->mGraphs.at(i)->valueAxis() == this) + result.append(mParentPlot->mGraphs.at(i)); + } + return result; +} + +/*! + Returns a list of all the items that are associated with this axis. An item is considered + associated with an axis if at least one of its positions uses the axis as key or value axis. + + \see plottables, graphs +*/ +QList QCPAxis::items() const +{ + QList result; + if (!mParentPlot) return result; + + for (int itemId=0; itemIdmItems.size(); ++itemId) + { + QList positions = mParentPlot->mItems.at(itemId)->positions(); + for (int posId=0; posIdkeyAxis() == this || positions.at(posId)->valueAxis() == this) + { + result.append(mParentPlot->mItems.at(itemId)); + break; + } + } + } + return result; +} + +/*! + Transforms a margin side to the logically corresponding axis type. (QCP::msLeft to + QCPAxis::atLeft, QCP::msRight to QCPAxis::atRight, etc.) +*/ +QCPAxis::AxisType QCPAxis::marginSideToAxisType(QCP::MarginSide side) +{ + switch (side) + { + case QCP::msLeft: return atLeft; + case QCP::msRight: return atRight; + case QCP::msTop: return atTop; + case QCP::msBottom: return atBottom; + default: break; + } + qDebug() << Q_FUNC_INFO << "Invalid margin side passed:" << (int)side; + return atLeft; +} + +/*! + Returns the axis type that describes the opposite axis of an axis with the specified \a type. +*/ +QCPAxis::AxisType QCPAxis::opposite(QCPAxis::AxisType type) +{ + switch (type) + { + case atLeft: return atRight; break; + case atRight: return atLeft; break; + case atBottom: return atTop; break; + case atTop: return atBottom; break; + default: qDebug() << Q_FUNC_INFO << "invalid axis type"; return atLeft; break; + } +} + +/* inherits documentation from base class */ +void QCPAxis::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) +{ + Q_UNUSED(event) + SelectablePart part = details.value(); + if (mSelectableParts.testFlag(part)) + { + SelectableParts selBefore = mSelectedParts; + setSelectedParts(additive ? mSelectedParts^part : part); + if (selectionStateChanged) + *selectionStateChanged = mSelectedParts != selBefore; + } +} + +/* inherits documentation from base class */ +void QCPAxis::deselectEvent(bool *selectionStateChanged) +{ + SelectableParts selBefore = mSelectedParts; + setSelectedParts(mSelectedParts & ~mSelectableParts); + if (selectionStateChanged) + *selectionStateChanged = mSelectedParts != selBefore; +} + +/*! \internal + + This mouse event reimplementation provides the functionality to let the user drag individual axes + exclusively, by startig the drag on top of the axis. + + For the axis to accept this event and perform the single axis drag, the parent \ref QCPAxisRect + must be configured accordingly, i.e. it must allow range dragging in the orientation of this axis + (\ref QCPAxisRect::setRangeDrag) and this axis must be a draggable axis (\ref + QCPAxisRect::setRangeDragAxes) + + \seebaseclassmethod + + \note The dragging of possibly multiple axes at once by starting the drag anywhere in the axis + rect is handled by the axis rect's mouse event, e.g. \ref QCPAxisRect::mousePressEvent. +*/ +void QCPAxis::mousePressEvent(QMouseEvent *event, const QVariant &details) +{ + Q_UNUSED(details) + if (!mParentPlot->interactions().testFlag(QCP::iRangeDrag) || + !mAxisRect->rangeDrag().testFlag(orientation()) || + !mAxisRect->rangeDragAxes(orientation()).contains(this)) + { + event->ignore(); + return; + } + + if (event->buttons() & Qt::LeftButton) + { + mDragging = true; + // initialize antialiasing backup in case we start dragging: + if (mParentPlot->noAntialiasingOnDrag()) + { + mAADragBackup = mParentPlot->antialiasedElements(); + mNotAADragBackup = mParentPlot->notAntialiasedElements(); + } + // Mouse range dragging interaction: + if (mParentPlot->interactions().testFlag(QCP::iRangeDrag)) + mDragStartRange = mRange; + } +} + +/*! \internal + + This mouse event reimplementation provides the functionality to let the user drag individual axes + exclusively, by startig the drag on top of the axis. + + \seebaseclassmethod + + \note The dragging of possibly multiple axes at once by starting the drag anywhere in the axis + rect is handled by the axis rect's mouse event, e.g. \ref QCPAxisRect::mousePressEvent. + + \see QCPAxis::mousePressEvent +*/ +void QCPAxis::mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) +{ + if (mDragging) + { + const double startPixel = orientation() == Qt::Horizontal ? startPos.x() : startPos.y(); + const double currentPixel = orientation() == Qt::Horizontal ? event->pos().x() : event->pos().y(); + if (mScaleType == QCPAxis::stLinear) + { + const double diff = pixelToCoord(startPixel) - pixelToCoord(currentPixel); + setRange(mDragStartRange.lower+diff, mDragStartRange.upper+diff); + } else if (mScaleType == QCPAxis::stLogarithmic) + { + const double diff = pixelToCoord(startPixel) / pixelToCoord(currentPixel); + setRange(mDragStartRange.lower*diff, mDragStartRange.upper*diff); + } + + if (mParentPlot->noAntialiasingOnDrag()) + mParentPlot->setNotAntialiasedElements(QCP::aeAll); + mParentPlot->replot(QCustomPlot::rpQueuedReplot); + } +} + +/*! \internal + + This mouse event reimplementation provides the functionality to let the user drag individual axes + exclusively, by startig the drag on top of the axis. + + \seebaseclassmethod + + \note The dragging of possibly multiple axes at once by starting the drag anywhere in the axis + rect is handled by the axis rect's mouse event, e.g. \ref QCPAxisRect::mousePressEvent. + + \see QCPAxis::mousePressEvent +*/ +void QCPAxis::mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) +{ + Q_UNUSED(event) + Q_UNUSED(startPos) + mDragging = false; + if (mParentPlot->noAntialiasingOnDrag()) + { + mParentPlot->setAntialiasedElements(mAADragBackup); + mParentPlot->setNotAntialiasedElements(mNotAADragBackup); + } +} + +/*! \internal + + This mouse event reimplementation provides the functionality to let the user zoom individual axes + exclusively, by performing the wheel event on top of the axis. + + For the axis to accept this event and perform the single axis zoom, the parent \ref QCPAxisRect + must be configured accordingly, i.e. it must allow range zooming in the orientation of this axis + (\ref QCPAxisRect::setRangeZoom) and this axis must be a zoomable axis (\ref + QCPAxisRect::setRangeZoomAxes) + + \seebaseclassmethod + + \note The zooming of possibly multiple axes at once by performing the wheel event anywhere in the + axis rect is handled by the axis rect's mouse event, e.g. \ref QCPAxisRect::wheelEvent. +*/ +void QCPAxis::wheelEvent(QWheelEvent *event) +{ + // Mouse range zooming interaction: + if (!mParentPlot->interactions().testFlag(QCP::iRangeZoom) || + !mAxisRect->rangeZoom().testFlag(orientation()) || + !mAxisRect->rangeZoomAxes(orientation()).contains(this)) + { + event->ignore(); + return; + } + + const double wheelSteps = event->delta()/120.0; // a single step delta is +/-120 usually + const double factor = qPow(mAxisRect->rangeZoomFactor(orientation()), wheelSteps); + scaleRange(factor, pixelToCoord(orientation() == Qt::Horizontal ? event->pos().x() : event->pos().y())); + mParentPlot->replot(); +} + +/*! \internal + + A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter + before drawing axis lines. + + This is the antialiasing state the painter passed to the \ref draw method is in by default. + + This function takes into account the local setting of the antialiasing flag as well as the + overrides set with \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. + + \seebaseclassmethod + + \see setAntialiased +*/ +void QCPAxis::applyDefaultAntialiasingHint(QCPPainter *painter) const +{ + applyAntialiasingHint(painter, mAntialiased, QCP::aeAxes); +} + +/*! \internal + + Draws the axis with the specified \a painter, using the internal QCPAxisPainterPrivate instance. + + \seebaseclassmethod +*/ +void QCPAxis::draw(QCPPainter *painter) +{ + QVector subTickPositions; // the final coordToPixel transformed vector passed to QCPAxisPainter + QVector tickPositions; // the final coordToPixel transformed vector passed to QCPAxisPainter + QVector tickLabels; // the final vector passed to QCPAxisPainter + tickPositions.reserve(mTickVector.size()); + tickLabels.reserve(mTickVector.size()); + subTickPositions.reserve(mSubTickVector.size()); + + if (mTicks) + { + for (int i=0; itype = mAxisType; + mAxisPainter->basePen = getBasePen(); + mAxisPainter->labelFont = getLabelFont(); + mAxisPainter->labelColor = getLabelColor(); + mAxisPainter->label = mLabel; + mAxisPainter->substituteExponent = mNumberBeautifulPowers; + mAxisPainter->tickPen = getTickPen(); + mAxisPainter->subTickPen = getSubTickPen(); + mAxisPainter->tickLabelFont = getTickLabelFont(); + mAxisPainter->tickLabelColor = getTickLabelColor(); + mAxisPainter->axisRect = mAxisRect->rect(); + mAxisPainter->viewportRect = mParentPlot->viewport(); + mAxisPainter->abbreviateDecimalPowers = mScaleType == stLogarithmic; + mAxisPainter->reversedEndings = mRangeReversed; + mAxisPainter->tickPositions = tickPositions; + mAxisPainter->tickLabels = tickLabels; + mAxisPainter->subTickPositions = subTickPositions; + mAxisPainter->draw(painter); +} + +/*! \internal + + Prepares the internal tick vector, sub tick vector and tick label vector. This is done by calling + QCPAxisTicker::generate on the currently installed ticker. + + If a change in the label text/count is detected, the cached axis margin is invalidated to make + sure the next margin calculation recalculates the label sizes and returns an up-to-date value. +*/ +void QCPAxis::setupTickVectors() +{ + if (!mParentPlot) return; + if ((!mTicks && !mTickLabels && !mGrid->visible()) || mRange.size() <= 0) return; + + QVector oldLabels = mTickVectorLabels; + mTicker->generate(mRange, mParentPlot->locale(), mNumberFormatChar, mNumberPrecision, mTickVector, mSubTicks ? &mSubTickVector : 0, mTickLabels ? &mTickVectorLabels : 0); + mCachedMarginValid &= mTickVectorLabels == oldLabels; // if labels have changed, margin might have changed, too +} + +/*! \internal + + Returns the pen that is used to draw the axis base line. Depending on the selection state, this + is either mSelectedBasePen or mBasePen. +*/ +QPen QCPAxis::getBasePen() const +{ + return mSelectedParts.testFlag(spAxis) ? mSelectedBasePen : mBasePen; +} + +/*! \internal + + Returns the pen that is used to draw the (major) ticks. Depending on the selection state, this + is either mSelectedTickPen or mTickPen. +*/ +QPen QCPAxis::getTickPen() const +{ + return mSelectedParts.testFlag(spAxis) ? mSelectedTickPen : mTickPen; +} + +/*! \internal + + Returns the pen that is used to draw the subticks. Depending on the selection state, this + is either mSelectedSubTickPen or mSubTickPen. +*/ +QPen QCPAxis::getSubTickPen() const +{ + return mSelectedParts.testFlag(spAxis) ? mSelectedSubTickPen : mSubTickPen; +} + +/*! \internal + + Returns the font that is used to draw the tick labels. Depending on the selection state, this + is either mSelectedTickLabelFont or mTickLabelFont. +*/ +QFont QCPAxis::getTickLabelFont() const +{ + return mSelectedParts.testFlag(spTickLabels) ? mSelectedTickLabelFont : mTickLabelFont; +} + +/*! \internal + + Returns the font that is used to draw the axis label. Depending on the selection state, this + is either mSelectedLabelFont or mLabelFont. +*/ +QFont QCPAxis::getLabelFont() const +{ + return mSelectedParts.testFlag(spAxisLabel) ? mSelectedLabelFont : mLabelFont; +} + +/*! \internal + + Returns the color that is used to draw the tick labels. Depending on the selection state, this + is either mSelectedTickLabelColor or mTickLabelColor. +*/ +QColor QCPAxis::getTickLabelColor() const +{ + return mSelectedParts.testFlag(spTickLabels) ? mSelectedTickLabelColor : mTickLabelColor; +} + +/*! \internal + + Returns the color that is used to draw the axis label. Depending on the selection state, this + is either mSelectedLabelColor or mLabelColor. +*/ +QColor QCPAxis::getLabelColor() const +{ + return mSelectedParts.testFlag(spAxisLabel) ? mSelectedLabelColor : mLabelColor; +} + +/*! \internal + + Returns the appropriate outward margin for this axis. It is needed if \ref + QCPAxisRect::setAutoMargins is set to true on the parent axis rect. An axis with axis type \ref + atLeft will return an appropriate left margin, \ref atBottom will return an appropriate bottom + margin and so forth. For the calculation, this function goes through similar steps as \ref draw, + so changing one function likely requires the modification of the other one as well. + + The margin consists of the outward tick length, tick label padding, tick label size, label + padding, label size, and padding. + + The margin is cached internally, so repeated calls while leaving the axis range, fonts, etc. + unchanged are very fast. +*/ +int QCPAxis::calculateMargin() +{ + if (!mVisible) // if not visible, directly return 0, don't cache 0 because we can't react to setVisible in QCPAxis + return 0; + + if (mCachedMarginValid) + return mCachedMargin; + + // run through similar steps as QCPAxis::draw, and calculate margin needed to fit axis and its labels + int margin = 0; + + QVector tickPositions; // the final coordToPixel transformed vector passed to QCPAxisPainter + QVector tickLabels; // the final vector passed to QCPAxisPainter + tickPositions.reserve(mTickVector.size()); + tickLabels.reserve(mTickVector.size()); + + if (mTicks) + { + for (int i=0; itype = mAxisType; + mAxisPainter->labelFont = getLabelFont(); + mAxisPainter->label = mLabel; + mAxisPainter->tickLabelFont = mTickLabelFont; + mAxisPainter->axisRect = mAxisRect->rect(); + mAxisPainter->viewportRect = mParentPlot->viewport(); + mAxisPainter->tickPositions = tickPositions; + mAxisPainter->tickLabels = tickLabels; + margin += mAxisPainter->size(); + margin += mPadding; + + mCachedMargin = margin; + mCachedMarginValid = true; + return margin; +} + +/* inherits documentation from base class */ +QCP::Interaction QCPAxis::selectionCategory() const +{ + return QCP::iSelectAxes; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAxisPainterPrivate +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPAxisPainterPrivate + + \internal + \brief (Private) + + This is a private class and not part of the public QCustomPlot interface. + + It is used by QCPAxis to do the low-level drawing of axis backbone, tick marks, tick labels and + axis label. It also buffers the labels to reduce replot times. The parameters are configured by + directly accessing the public member variables. +*/ + +/*! + Constructs a QCPAxisPainterPrivate instance. Make sure to not create a new instance on every + redraw, to utilize the caching mechanisms. +*/ +QCPAxisPainterPrivate::QCPAxisPainterPrivate(QCustomPlot *parentPlot) : + type(QCPAxis::atLeft), + basePen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), + lowerEnding(QCPLineEnding::esNone), + upperEnding(QCPLineEnding::esNone), + labelPadding(0), + tickLabelPadding(0), + tickLabelRotation(0), + tickLabelSide(QCPAxis::lsOutside), + substituteExponent(true), + numberMultiplyCross(false), + tickLengthIn(5), + tickLengthOut(0), + subTickLengthIn(2), + subTickLengthOut(0), + tickPen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), + subTickPen(QPen(Qt::black, 0, Qt::SolidLine, Qt::SquareCap)), + offset(0), + abbreviateDecimalPowers(false), + reversedEndings(false), + mParentPlot(parentPlot), + mLabelCache(16) // cache at most 16 (tick) labels +{ +} + +QCPAxisPainterPrivate::~QCPAxisPainterPrivate() +{ +} + +/*! \internal + + Draws the axis with the specified \a painter. + + The selection boxes (mAxisSelectionBox, mTickLabelsSelectionBox, mLabelSelectionBox) are set + here, too. +*/ +void QCPAxisPainterPrivate::draw(QCPPainter *painter) +{ + QByteArray newHash = generateLabelParameterHash(); + if (newHash != mLabelParameterHash) + { + mLabelCache.clear(); + mLabelParameterHash = newHash; + } + + QPoint origin; + switch (type) + { + case QCPAxis::atLeft: origin = axisRect.bottomLeft() +QPoint(-offset, 0); break; + case QCPAxis::atRight: origin = axisRect.bottomRight()+QPoint(+offset, 0); break; + case QCPAxis::atTop: origin = axisRect.topLeft() +QPoint(0, -offset); break; + case QCPAxis::atBottom: origin = axisRect.bottomLeft() +QPoint(0, +offset); break; + } + + double xCor = 0, yCor = 0; // paint system correction, for pixel exact matches (affects baselines and ticks of top/right axes) + switch (type) + { + case QCPAxis::atTop: yCor = -1; break; + case QCPAxis::atRight: xCor = 1; break; + default: break; + } + int margin = 0; + // draw baseline: + QLineF baseLine; + painter->setPen(basePen); + if (QCPAxis::orientation(type) == Qt::Horizontal) + baseLine.setPoints(origin+QPointF(xCor, yCor), origin+QPointF(axisRect.width()+xCor, yCor)); + else + baseLine.setPoints(origin+QPointF(xCor, yCor), origin+QPointF(xCor, -axisRect.height()+yCor)); + if (reversedEndings) + baseLine = QLineF(baseLine.p2(), baseLine.p1()); // won't make a difference for line itself, but for line endings later + painter->drawLine(baseLine); + + // draw ticks: + if (!tickPositions.isEmpty()) + { + painter->setPen(tickPen); + int tickDir = (type == QCPAxis::atBottom || type == QCPAxis::atRight) ? -1 : 1; // direction of ticks ("inward" is right for left axis and left for right axis) + if (QCPAxis::orientation(type) == Qt::Horizontal) + { + for (int i=0; idrawLine(QLineF(tickPositions.at(i)+xCor, origin.y()-tickLengthOut*tickDir+yCor, tickPositions.at(i)+xCor, origin.y()+tickLengthIn*tickDir+yCor)); + } else + { + for (int i=0; idrawLine(QLineF(origin.x()-tickLengthOut*tickDir+xCor, tickPositions.at(i)+yCor, origin.x()+tickLengthIn*tickDir+xCor, tickPositions.at(i)+yCor)); + } + } + + // draw subticks: + if (!subTickPositions.isEmpty()) + { + painter->setPen(subTickPen); + // direction of ticks ("inward" is right for left axis and left for right axis) + int tickDir = (type == QCPAxis::atBottom || type == QCPAxis::atRight) ? -1 : 1; + if (QCPAxis::orientation(type) == Qt::Horizontal) + { + for (int i=0; idrawLine(QLineF(subTickPositions.at(i)+xCor, origin.y()-subTickLengthOut*tickDir+yCor, subTickPositions.at(i)+xCor, origin.y()+subTickLengthIn*tickDir+yCor)); + } else + { + for (int i=0; idrawLine(QLineF(origin.x()-subTickLengthOut*tickDir+xCor, subTickPositions.at(i)+yCor, origin.x()+subTickLengthIn*tickDir+xCor, subTickPositions.at(i)+yCor)); + } + } + margin += qMax(0, qMax(tickLengthOut, subTickLengthOut)); + + // draw axis base endings: + bool antialiasingBackup = painter->antialiasing(); + painter->setAntialiasing(true); // always want endings to be antialiased, even if base and ticks themselves aren't + painter->setBrush(QBrush(basePen.color())); + QCPVector2D baseLineVector(baseLine.dx(), baseLine.dy()); + if (lowerEnding.style() != QCPLineEnding::esNone) + lowerEnding.draw(painter, QCPVector2D(baseLine.p1())-baseLineVector.normalized()*lowerEnding.realLength()*(lowerEnding.inverted()?-1:1), -baseLineVector); + if (upperEnding.style() != QCPLineEnding::esNone) + upperEnding.draw(painter, QCPVector2D(baseLine.p2())+baseLineVector.normalized()*upperEnding.realLength()*(upperEnding.inverted()?-1:1), baseLineVector); + painter->setAntialiasing(antialiasingBackup); + + // tick labels: + QRect oldClipRect; + if (tickLabelSide == QCPAxis::lsInside) // if using inside labels, clip them to the axis rect + { + oldClipRect = painter->clipRegion().boundingRect(); + painter->setClipRect(axisRect); + } + QSize tickLabelsSize(0, 0); // size of largest tick label, for offset calculation of axis label + if (!tickLabels.isEmpty()) + { + if (tickLabelSide == QCPAxis::lsOutside) + margin += tickLabelPadding; + painter->setFont(tickLabelFont); + painter->setPen(QPen(tickLabelColor)); + const int maxLabelIndex = qMin(tickPositions.size(), tickLabels.size()); + int distanceToAxis = margin; + if (tickLabelSide == QCPAxis::lsInside) + distanceToAxis = -(qMax(tickLengthIn, subTickLengthIn)+tickLabelPadding); + for (int i=0; isetClipRect(oldClipRect); + + // axis label: + QRect labelBounds; + if (!label.isEmpty()) + { + margin += labelPadding; + painter->setFont(labelFont); + painter->setPen(QPen(labelColor)); + labelBounds = painter->fontMetrics().boundingRect(0, 0, 0, 0, Qt::TextDontClip, label); + if (type == QCPAxis::atLeft) + { + QTransform oldTransform = painter->transform(); + painter->translate((origin.x()-margin-labelBounds.height()), origin.y()); + painter->rotate(-90); + painter->drawText(0, 0, axisRect.height(), labelBounds.height(), Qt::TextDontClip | Qt::AlignCenter, label); + painter->setTransform(oldTransform); + } + else if (type == QCPAxis::atRight) + { + QTransform oldTransform = painter->transform(); + painter->translate((origin.x()+margin+labelBounds.height()), origin.y()-axisRect.height()); + painter->rotate(90); + painter->drawText(0, 0, axisRect.height(), labelBounds.height(), Qt::TextDontClip | Qt::AlignCenter, label); + painter->setTransform(oldTransform); + } + else if (type == QCPAxis::atTop) + painter->drawText(origin.x(), origin.y()-margin-labelBounds.height(), axisRect.width(), labelBounds.height(), Qt::TextDontClip | Qt::AlignCenter, label); + else if (type == QCPAxis::atBottom) + painter->drawText(origin.x(), origin.y()+margin, axisRect.width(), labelBounds.height(), Qt::TextDontClip | Qt::AlignCenter, label); + } + + // set selection boxes: + int selectionTolerance = 0; + if (mParentPlot) + selectionTolerance = mParentPlot->selectionTolerance(); + else + qDebug() << Q_FUNC_INFO << "mParentPlot is null"; + int selAxisOutSize = qMax(qMax(tickLengthOut, subTickLengthOut), selectionTolerance); + int selAxisInSize = selectionTolerance; + int selTickLabelSize; + int selTickLabelOffset; + if (tickLabelSide == QCPAxis::lsOutside) + { + selTickLabelSize = (QCPAxis::orientation(type) == Qt::Horizontal ? tickLabelsSize.height() : tickLabelsSize.width()); + selTickLabelOffset = qMax(tickLengthOut, subTickLengthOut)+tickLabelPadding; + } else + { + selTickLabelSize = -(QCPAxis::orientation(type) == Qt::Horizontal ? tickLabelsSize.height() : tickLabelsSize.width()); + selTickLabelOffset = -(qMax(tickLengthIn, subTickLengthIn)+tickLabelPadding); + } + int selLabelSize = labelBounds.height(); + int selLabelOffset = qMax(tickLengthOut, subTickLengthOut)+(!tickLabels.isEmpty() && tickLabelSide == QCPAxis::lsOutside ? tickLabelPadding+selTickLabelSize : 0)+labelPadding; + if (type == QCPAxis::atLeft) + { + mAxisSelectionBox.setCoords(origin.x()-selAxisOutSize, axisRect.top(), origin.x()+selAxisInSize, axisRect.bottom()); + mTickLabelsSelectionBox.setCoords(origin.x()-selTickLabelOffset-selTickLabelSize, axisRect.top(), origin.x()-selTickLabelOffset, axisRect.bottom()); + mLabelSelectionBox.setCoords(origin.x()-selLabelOffset-selLabelSize, axisRect.top(), origin.x()-selLabelOffset, axisRect.bottom()); + } else if (type == QCPAxis::atRight) + { + mAxisSelectionBox.setCoords(origin.x()-selAxisInSize, axisRect.top(), origin.x()+selAxisOutSize, axisRect.bottom()); + mTickLabelsSelectionBox.setCoords(origin.x()+selTickLabelOffset+selTickLabelSize, axisRect.top(), origin.x()+selTickLabelOffset, axisRect.bottom()); + mLabelSelectionBox.setCoords(origin.x()+selLabelOffset+selLabelSize, axisRect.top(), origin.x()+selLabelOffset, axisRect.bottom()); + } else if (type == QCPAxis::atTop) + { + mAxisSelectionBox.setCoords(axisRect.left(), origin.y()-selAxisOutSize, axisRect.right(), origin.y()+selAxisInSize); + mTickLabelsSelectionBox.setCoords(axisRect.left(), origin.y()-selTickLabelOffset-selTickLabelSize, axisRect.right(), origin.y()-selTickLabelOffset); + mLabelSelectionBox.setCoords(axisRect.left(), origin.y()-selLabelOffset-selLabelSize, axisRect.right(), origin.y()-selLabelOffset); + } else if (type == QCPAxis::atBottom) + { + mAxisSelectionBox.setCoords(axisRect.left(), origin.y()-selAxisInSize, axisRect.right(), origin.y()+selAxisOutSize); + mTickLabelsSelectionBox.setCoords(axisRect.left(), origin.y()+selTickLabelOffset+selTickLabelSize, axisRect.right(), origin.y()+selTickLabelOffset); + mLabelSelectionBox.setCoords(axisRect.left(), origin.y()+selLabelOffset+selLabelSize, axisRect.right(), origin.y()+selLabelOffset); + } + mAxisSelectionBox = mAxisSelectionBox.normalized(); + mTickLabelsSelectionBox = mTickLabelsSelectionBox.normalized(); + mLabelSelectionBox = mLabelSelectionBox.normalized(); + // draw hitboxes for debug purposes: + //painter->setBrush(Qt::NoBrush); + //painter->drawRects(QVector() << mAxisSelectionBox << mTickLabelsSelectionBox << mLabelSelectionBox); +} + +/*! \internal + + Returns the size ("margin" in QCPAxisRect context, so measured perpendicular to the axis backbone + direction) needed to fit the axis. +*/ +int QCPAxisPainterPrivate::size() const +{ + int result = 0; + + // get length of tick marks pointing outwards: + if (!tickPositions.isEmpty()) + result += qMax(0, qMax(tickLengthOut, subTickLengthOut)); + + // calculate size of tick labels: + if (tickLabelSide == QCPAxis::lsOutside) + { + QSize tickLabelsSize(0, 0); + if (!tickLabels.isEmpty()) + { + for (int i=0; ibufferDevicePixelRatio())); + result.append(QByteArray::number(tickLabelRotation)); + result.append(QByteArray::number((int)tickLabelSide)); + result.append(QByteArray::number((int)substituteExponent)); + result.append(QByteArray::number((int)numberMultiplyCross)); + result.append(tickLabelColor.name().toLatin1()+QByteArray::number(tickLabelColor.alpha(), 16)); + result.append(tickLabelFont.toString().toLatin1()); + return result; +} + +/*! \internal + + Draws a single tick label with the provided \a painter, utilizing the internal label cache to + significantly speed up drawing of labels that were drawn in previous calls. The tick label is + always bound to an axis, the distance to the axis is controllable via \a distanceToAxis in + pixels. The pixel position in the axis direction is passed in the \a position parameter. Hence + for the bottom axis, \a position would indicate the horizontal pixel position (not coordinate), + at which the label should be drawn. + + In order to later draw the axis label in a place that doesn't overlap with the tick labels, the + largest tick label size is needed. This is acquired by passing a \a tickLabelsSize to the \ref + drawTickLabel calls during the process of drawing all tick labels of one axis. In every call, \a + tickLabelsSize is expanded, if the drawn label exceeds the value \a tickLabelsSize currently + holds. + + The label is drawn with the font and pen that are currently set on the \a painter. To draw + superscripted powers, the font is temporarily made smaller by a fixed factor (see \ref + getTickLabelData). +*/ +void QCPAxisPainterPrivate::placeTickLabel(QCPPainter *painter, double position, int distanceToAxis, const QString &text, QSize *tickLabelsSize) +{ + // warning: if you change anything here, also adapt getMaxTickLabelSize() accordingly! + if (text.isEmpty()) return; + QSize finalSize; + QPointF labelAnchor; + switch (type) + { + case QCPAxis::atLeft: labelAnchor = QPointF(axisRect.left()-distanceToAxis-offset, position); break; + case QCPAxis::atRight: labelAnchor = QPointF(axisRect.right()+distanceToAxis+offset, position); break; + case QCPAxis::atTop: labelAnchor = QPointF(position, axisRect.top()-distanceToAxis-offset); break; + case QCPAxis::atBottom: labelAnchor = QPointF(position, axisRect.bottom()+distanceToAxis+offset); break; + } + if (mParentPlot->plottingHints().testFlag(QCP::phCacheLabels) && !painter->modes().testFlag(QCPPainter::pmNoCaching)) // label caching enabled + { + CachedLabel *cachedLabel = mLabelCache.take(text); // attempt to get label from cache + if (!cachedLabel) // no cached label existed, create it + { + cachedLabel = new CachedLabel; + TickLabelData labelData = getTickLabelData(painter->font(), text); + cachedLabel->offset = getTickLabelDrawOffset(labelData)+labelData.rotatedTotalBounds.topLeft(); + if (!qFuzzyCompare(1.0, mParentPlot->bufferDevicePixelRatio())) + { + cachedLabel->pixmap = QPixmap(labelData.rotatedTotalBounds.size()*mParentPlot->bufferDevicePixelRatio()); +#ifdef QCP_DEVICEPIXELRATIO_SUPPORTED +# ifdef QCP_DEVICEPIXELRATIO_FLOAT + cachedLabel->pixmap.setDevicePixelRatio(mParentPlot->devicePixelRatioF()); +# else + cachedLabel->pixmap.setDevicePixelRatio(mParentPlot->devicePixelRatio()); +# endif +#endif + } else + cachedLabel->pixmap = QPixmap(labelData.rotatedTotalBounds.size()); + cachedLabel->pixmap.fill(Qt::transparent); + QCPPainter cachePainter(&cachedLabel->pixmap); + cachePainter.setPen(painter->pen()); + drawTickLabel(&cachePainter, -labelData.rotatedTotalBounds.topLeft().x(), -labelData.rotatedTotalBounds.topLeft().y(), labelData); + } + // if label would be partly clipped by widget border on sides, don't draw it (only for outside tick labels): + bool labelClippedByBorder = false; + if (tickLabelSide == QCPAxis::lsOutside) + { + if (QCPAxis::orientation(type) == Qt::Horizontal) + labelClippedByBorder = labelAnchor.x()+cachedLabel->offset.x()+cachedLabel->pixmap.width()/mParentPlot->bufferDevicePixelRatio() > viewportRect.right() || labelAnchor.x()+cachedLabel->offset.x() < viewportRect.left(); + else + labelClippedByBorder = labelAnchor.y()+cachedLabel->offset.y()+cachedLabel->pixmap.height()/mParentPlot->bufferDevicePixelRatio() > viewportRect.bottom() || labelAnchor.y()+cachedLabel->offset.y() < viewportRect.top(); + } + if (!labelClippedByBorder) + { + painter->drawPixmap(labelAnchor+cachedLabel->offset, cachedLabel->pixmap); + finalSize = cachedLabel->pixmap.size()/mParentPlot->bufferDevicePixelRatio(); + } + mLabelCache.insert(text, cachedLabel); // return label to cache or insert for the first time if newly created + } else // label caching disabled, draw text directly on surface: + { + TickLabelData labelData = getTickLabelData(painter->font(), text); + QPointF finalPosition = labelAnchor + getTickLabelDrawOffset(labelData); + // if label would be partly clipped by widget border on sides, don't draw it (only for outside tick labels): + bool labelClippedByBorder = false; + if (tickLabelSide == QCPAxis::lsOutside) + { + if (QCPAxis::orientation(type) == Qt::Horizontal) + labelClippedByBorder = finalPosition.x()+(labelData.rotatedTotalBounds.width()+labelData.rotatedTotalBounds.left()) > viewportRect.right() || finalPosition.x()+labelData.rotatedTotalBounds.left() < viewportRect.left(); + else + labelClippedByBorder = finalPosition.y()+(labelData.rotatedTotalBounds.height()+labelData.rotatedTotalBounds.top()) > viewportRect.bottom() || finalPosition.y()+labelData.rotatedTotalBounds.top() < viewportRect.top(); + } + if (!labelClippedByBorder) + { + drawTickLabel(painter, finalPosition.x(), finalPosition.y(), labelData); + finalSize = labelData.rotatedTotalBounds.size(); + } + } + + // expand passed tickLabelsSize if current tick label is larger: + if (finalSize.width() > tickLabelsSize->width()) + tickLabelsSize->setWidth(finalSize.width()); + if (finalSize.height() > tickLabelsSize->height()) + tickLabelsSize->setHeight(finalSize.height()); +} + +/*! \internal + + This is a \ref placeTickLabel helper function. + + Draws the tick label specified in \a labelData with \a painter at the pixel positions \a x and \a + y. This function is used by \ref placeTickLabel to create new tick labels for the cache, or to + directly draw the labels on the QCustomPlot surface when label caching is disabled, i.e. when + QCP::phCacheLabels plotting hint is not set. +*/ +void QCPAxisPainterPrivate::drawTickLabel(QCPPainter *painter, double x, double y, const TickLabelData &labelData) const +{ + // backup painter settings that we're about to change: + QTransform oldTransform = painter->transform(); + QFont oldFont = painter->font(); + + // transform painter to position/rotation: + painter->translate(x, y); + if (!qFuzzyIsNull(tickLabelRotation)) + painter->rotate(tickLabelRotation); + + // draw text: + if (!labelData.expPart.isEmpty()) // indicator that beautiful powers must be used + { + painter->setFont(labelData.baseFont); + painter->drawText(0, 0, 0, 0, Qt::TextDontClip, labelData.basePart); + if (!labelData.suffixPart.isEmpty()) + painter->drawText(labelData.baseBounds.width()+1+labelData.expBounds.width(), 0, 0, 0, Qt::TextDontClip, labelData.suffixPart); + painter->setFont(labelData.expFont); + painter->drawText(labelData.baseBounds.width()+1, 0, labelData.expBounds.width(), labelData.expBounds.height(), Qt::TextDontClip, labelData.expPart); + } else + { + painter->setFont(labelData.baseFont); + painter->drawText(0, 0, labelData.totalBounds.width(), labelData.totalBounds.height(), Qt::TextDontClip | Qt::AlignHCenter, labelData.basePart); + } + + // reset painter settings to what it was before: + painter->setTransform(oldTransform); + painter->setFont(oldFont); +} + +/*! \internal + + This is a \ref placeTickLabel helper function. + + Transforms the passed \a text and \a font to a tickLabelData structure that can then be further + processed by \ref getTickLabelDrawOffset and \ref drawTickLabel. It splits the text into base and + exponent if necessary (member substituteExponent) and calculates appropriate bounding boxes. +*/ +QCPAxisPainterPrivate::TickLabelData QCPAxisPainterPrivate::getTickLabelData(const QFont &font, const QString &text) const +{ + TickLabelData result; + + // determine whether beautiful decimal powers should be used + bool useBeautifulPowers = false; + int ePos = -1; // first index of exponent part, text before that will be basePart, text until eLast will be expPart + int eLast = -1; // last index of exponent part, rest of text after this will be suffixPart + if (substituteExponent) + { + ePos = text.indexOf(QLatin1Char('e')); + if (ePos > 0 && text.at(ePos-1).isDigit()) + { + eLast = ePos; + while (eLast+1 < text.size() && (text.at(eLast+1) == QLatin1Char('+') || text.at(eLast+1) == QLatin1Char('-') || text.at(eLast+1).isDigit())) + ++eLast; + if (eLast > ePos) // only if also to right of 'e' is a digit/+/- interpret it as beautifiable power + useBeautifulPowers = true; + } + } + + // calculate text bounding rects and do string preparation for beautiful decimal powers: + result.baseFont = font; + if (result.baseFont.pointSizeF() > 0) // might return -1 if specified with setPixelSize, in that case we can't do correction in next line + result.baseFont.setPointSizeF(result.baseFont.pointSizeF()+0.05); // QFontMetrics.boundingRect has a bug for exact point sizes that make the results oscillate due to internal rounding + if (useBeautifulPowers) + { + // split text into parts of number/symbol that will be drawn normally and part that will be drawn as exponent: + result.basePart = text.left(ePos); + result.suffixPart = text.mid(eLast+1); // also drawn normally but after exponent + // in log scaling, we want to turn "1*10^n" into "10^n", else add multiplication sign and decimal base: + if (abbreviateDecimalPowers && result.basePart == QLatin1String("1")) + result.basePart = QLatin1String("10"); + else + result.basePart += (numberMultiplyCross ? QString(QChar(215)) : QString(QChar(183))) + QLatin1String("10"); + result.expPart = text.mid(ePos+1, eLast-ePos); + // clip "+" and leading zeros off expPart: + while (result.expPart.length() > 2 && result.expPart.at(1) == QLatin1Char('0')) // length > 2 so we leave one zero when numberFormatChar is 'e' + result.expPart.remove(1, 1); + if (!result.expPart.isEmpty() && result.expPart.at(0) == QLatin1Char('+')) + result.expPart.remove(0, 1); + // prepare smaller font for exponent: + result.expFont = font; + if (result.expFont.pointSize() > 0) + result.expFont.setPointSize(result.expFont.pointSize()*0.75); + else + result.expFont.setPixelSize(result.expFont.pixelSize()*0.75); + // calculate bounding rects of base part(s), exponent part and total one: + result.baseBounds = QFontMetrics(result.baseFont).boundingRect(0, 0, 0, 0, Qt::TextDontClip, result.basePart); + result.expBounds = QFontMetrics(result.expFont).boundingRect(0, 0, 0, 0, Qt::TextDontClip, result.expPart); + if (!result.suffixPart.isEmpty()) + result.suffixBounds = QFontMetrics(result.baseFont).boundingRect(0, 0, 0, 0, Qt::TextDontClip, result.suffixPart); + result.totalBounds = result.baseBounds.adjusted(0, 0, result.expBounds.width()+result.suffixBounds.width()+2, 0); // +2 consists of the 1 pixel spacing between base and exponent (see drawTickLabel) and an extra pixel to include AA + } else // useBeautifulPowers == false + { + result.basePart = text; + result.totalBounds = QFontMetrics(result.baseFont).boundingRect(0, 0, 0, 0, Qt::TextDontClip | Qt::AlignHCenter, result.basePart); + } + result.totalBounds.moveTopLeft(QPoint(0, 0)); // want bounding box aligned top left at origin, independent of how it was created, to make further processing simpler + + // calculate possibly different bounding rect after rotation: + result.rotatedTotalBounds = result.totalBounds; + if (!qFuzzyIsNull(tickLabelRotation)) + { + QTransform transform; + transform.rotate(tickLabelRotation); + result.rotatedTotalBounds = transform.mapRect(result.rotatedTotalBounds); + } + + return result; +} + +/*! \internal + + This is a \ref placeTickLabel helper function. + + Calculates the offset at which the top left corner of the specified tick label shall be drawn. + The offset is relative to a point right next to the tick the label belongs to. + + This function is thus responsible for e.g. centering tick labels under ticks and positioning them + appropriately when they are rotated. +*/ +QPointF QCPAxisPainterPrivate::getTickLabelDrawOffset(const TickLabelData &labelData) const +{ + /* + calculate label offset from base point at tick (non-trivial, for best visual appearance): short + explanation for bottom axis: The anchor, i.e. the point in the label that is placed + horizontally under the corresponding tick is always on the label side that is closer to the + axis (e.g. the left side of the text when we're rotating clockwise). On that side, the height + is halved and the resulting point is defined the anchor. This way, a 90 degree rotated text + will be centered under the tick (i.e. displaced horizontally by half its height). At the same + time, a 45 degree rotated text will "point toward" its tick, as is typical for rotated tick + labels. + */ + bool doRotation = !qFuzzyIsNull(tickLabelRotation); + bool flip = qFuzzyCompare(qAbs(tickLabelRotation), 90.0); // perfect +/-90 degree flip. Indicates vertical label centering on vertical axes. + double radians = tickLabelRotation/180.0*M_PI; + int x=0, y=0; + if ((type == QCPAxis::atLeft && tickLabelSide == QCPAxis::lsOutside) || (type == QCPAxis::atRight && tickLabelSide == QCPAxis::lsInside)) // Anchor at right side of tick label + { + if (doRotation) + { + if (tickLabelRotation > 0) + { + x = -qCos(radians)*labelData.totalBounds.width(); + y = flip ? -labelData.totalBounds.width()/2.0 : -qSin(radians)*labelData.totalBounds.width()-qCos(radians)*labelData.totalBounds.height()/2.0; + } else + { + x = -qCos(-radians)*labelData.totalBounds.width()-qSin(-radians)*labelData.totalBounds.height(); + y = flip ? +labelData.totalBounds.width()/2.0 : +qSin(-radians)*labelData.totalBounds.width()-qCos(-radians)*labelData.totalBounds.height()/2.0; + } + } else + { + x = -labelData.totalBounds.width(); + y = -labelData.totalBounds.height()/2.0; + } + } else if ((type == QCPAxis::atRight && tickLabelSide == QCPAxis::lsOutside) || (type == QCPAxis::atLeft && tickLabelSide == QCPAxis::lsInside)) // Anchor at left side of tick label + { + if (doRotation) + { + if (tickLabelRotation > 0) + { + x = +qSin(radians)*labelData.totalBounds.height(); + y = flip ? -labelData.totalBounds.width()/2.0 : -qCos(radians)*labelData.totalBounds.height()/2.0; + } else + { + x = 0; + y = flip ? +labelData.totalBounds.width()/2.0 : -qCos(-radians)*labelData.totalBounds.height()/2.0; + } + } else + { + x = 0; + y = -labelData.totalBounds.height()/2.0; + } + } else if ((type == QCPAxis::atTop && tickLabelSide == QCPAxis::lsOutside) || (type == QCPAxis::atBottom && tickLabelSide == QCPAxis::lsInside)) // Anchor at bottom side of tick label + { + if (doRotation) + { + if (tickLabelRotation > 0) + { + x = -qCos(radians)*labelData.totalBounds.width()+qSin(radians)*labelData.totalBounds.height()/2.0; + y = -qSin(radians)*labelData.totalBounds.width()-qCos(radians)*labelData.totalBounds.height(); + } else + { + x = -qSin(-radians)*labelData.totalBounds.height()/2.0; + y = -qCos(-radians)*labelData.totalBounds.height(); + } + } else + { + x = -labelData.totalBounds.width()/2.0; + y = -labelData.totalBounds.height(); + } + } else if ((type == QCPAxis::atBottom && tickLabelSide == QCPAxis::lsOutside) || (type == QCPAxis::atTop && tickLabelSide == QCPAxis::lsInside)) // Anchor at top side of tick label + { + if (doRotation) + { + if (tickLabelRotation > 0) + { + x = +qSin(radians)*labelData.totalBounds.height()/2.0; + y = 0; + } else + { + x = -qCos(-radians)*labelData.totalBounds.width()-qSin(-radians)*labelData.totalBounds.height()/2.0; + y = +qSin(-radians)*labelData.totalBounds.width(); + } + } else + { + x = -labelData.totalBounds.width()/2.0; + y = 0; + } + } + + return QPointF(x, y); +} + +/*! \internal + + Simulates the steps done by \ref placeTickLabel by calculating bounding boxes of the text label + to be drawn, depending on number format etc. Since only the largest tick label is wanted for the + margin calculation, the passed \a tickLabelsSize is only expanded, if it's currently set to a + smaller width/height. +*/ +void QCPAxisPainterPrivate::getMaxTickLabelSize(const QFont &font, const QString &text, QSize *tickLabelsSize) const +{ + // note: this function must return the same tick label sizes as the placeTickLabel function. + QSize finalSize; + if (mParentPlot->plottingHints().testFlag(QCP::phCacheLabels) && mLabelCache.contains(text)) // label caching enabled and have cached label + { + const CachedLabel *cachedLabel = mLabelCache.object(text); + finalSize = cachedLabel->pixmap.size()/mParentPlot->bufferDevicePixelRatio(); + } else // label caching disabled or no label with this text cached: + { + TickLabelData labelData = getTickLabelData(font, text); + finalSize = labelData.rotatedTotalBounds.size(); + } + + // expand passed tickLabelsSize if current tick label is larger: + if (finalSize.width() > tickLabelsSize->width()) + tickLabelsSize->setWidth(finalSize.width()); + if (finalSize.height() > tickLabelsSize->height()) + tickLabelsSize->setHeight(finalSize.height()); +} +/* end of 'src/axis/axis.cpp' */ + + +/* including file 'src/scatterstyle.cpp', size 17450 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPScatterStyle +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPScatterStyle + \brief Represents the visual appearance of scatter points + + This class holds information about shape, color and size of scatter points. In plottables like + QCPGraph it is used to store how scatter points shall be drawn. For example, \ref + QCPGraph::setScatterStyle takes a QCPScatterStyle instance. + + A scatter style consists of a shape (\ref setShape), a line color (\ref setPen) and possibly a + fill (\ref setBrush), if the shape provides a fillable area. Further, the size of the shape can + be controlled with \ref setSize. + + \section QCPScatterStyle-defining Specifying a scatter style + + You can set all these configurations either by calling the respective functions on an instance: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpscatterstyle-creation-1 + + Or you can use one of the various constructors that take different parameter combinations, making + it easy to specify a scatter style in a single call, like so: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpscatterstyle-creation-2 + + \section QCPScatterStyle-undefinedpen Leaving the color/pen up to the plottable + + There are two constructors which leave the pen undefined: \ref QCPScatterStyle() and \ref + QCPScatterStyle(ScatterShape shape, double size). If those constructors are used, a call to \ref + isPenDefined will return false. It leads to scatter points that inherit the pen from the + plottable that uses the scatter style. Thus, if such a scatter style is passed to QCPGraph, the line + color of the graph (\ref QCPGraph::setPen) will be used by the scatter points. This makes + it very convenient to set up typical scatter settings: + + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpscatterstyle-shortcreation + + Notice that it wasn't even necessary to explicitly call a QCPScatterStyle constructor. This works + because QCPScatterStyle provides a constructor that can transform a \ref ScatterShape directly + into a QCPScatterStyle instance (that's the \ref QCPScatterStyle(ScatterShape shape, double size) + constructor with a default for \a size). In those cases, C++ allows directly supplying a \ref + ScatterShape, where actually a QCPScatterStyle is expected. + + \section QCPScatterStyle-custompath-and-pixmap Custom shapes and pixmaps + + QCPScatterStyle supports drawing custom shapes and arbitrary pixmaps as scatter points. + + For custom shapes, you can provide a QPainterPath with the desired shape to the \ref + setCustomPath function or call the constructor that takes a painter path. The scatter shape will + automatically be set to \ref ssCustom. + + For pixmaps, you call \ref setPixmap with the desired QPixmap. Alternatively you can use the + constructor that takes a QPixmap. The scatter shape will automatically be set to \ref ssPixmap. + Note that \ref setSize does not influence the appearance of the pixmap. +*/ + +/* start documentation of inline functions */ + +/*! \fn bool QCPScatterStyle::isNone() const + + Returns whether the scatter shape is \ref ssNone. + + \see setShape +*/ + +/*! \fn bool QCPScatterStyle::isPenDefined() const + + Returns whether a pen has been defined for this scatter style. + + The pen is undefined if a constructor is called that does not carry \a pen as parameter. Those + are \ref QCPScatterStyle() and \ref QCPScatterStyle(ScatterShape shape, double size). If the pen + is undefined, the pen of the respective plottable will be used for drawing scatters. + + If a pen was defined for this scatter style instance, and you now wish to undefine the pen, call + \ref undefinePen. + + \see setPen +*/ + +/* end documentation of inline functions */ + +/*! + Creates a new QCPScatterStyle instance with size set to 6. No shape, pen or brush is defined. + + Since the pen is undefined (\ref isPenDefined returns false), the scatter color will be inherited + from the plottable that uses this scatter style. +*/ +QCPScatterStyle::QCPScatterStyle() : + mSize(6), + mShape(ssNone), + mPen(Qt::NoPen), + mBrush(Qt::NoBrush), + mPenDefined(false) +{ +} + +/*! + Creates a new QCPScatterStyle instance with shape set to \a shape and size to \a size. No pen or + brush is defined. + + Since the pen is undefined (\ref isPenDefined returns false), the scatter color will be inherited + from the plottable that uses this scatter style. +*/ +QCPScatterStyle::QCPScatterStyle(ScatterShape shape, double size) : + mSize(size), + mShape(shape), + mPen(Qt::NoPen), + mBrush(Qt::NoBrush), + mPenDefined(false) +{ +} + +/*! + Creates a new QCPScatterStyle instance with shape set to \a shape, the pen color set to \a color, + and size to \a size. No brush is defined, i.e. the scatter point will not be filled. +*/ +QCPScatterStyle::QCPScatterStyle(ScatterShape shape, const QColor &color, double size) : + mSize(size), + mShape(shape), + mPen(QPen(color)), + mBrush(Qt::NoBrush), + mPenDefined(true) +{ +} + +/*! + Creates a new QCPScatterStyle instance with shape set to \a shape, the pen color set to \a color, + the brush color to \a fill (with a solid pattern), and size to \a size. +*/ +QCPScatterStyle::QCPScatterStyle(ScatterShape shape, const QColor &color, const QColor &fill, double size) : + mSize(size), + mShape(shape), + mPen(QPen(color)), + mBrush(QBrush(fill)), + mPenDefined(true) +{ +} + +/*! + Creates a new QCPScatterStyle instance with shape set to \a shape, the pen set to \a pen, the + brush to \a brush, and size to \a size. + + \warning In some cases it might be tempting to directly use a pen style like Qt::NoPen as \a pen + and a color like Qt::blue as \a brush. Notice however, that the corresponding call\n + QCPScatterStyle(QCPScatterShape::ssCircle, Qt::NoPen, Qt::blue, 5)\n + doesn't necessarily lead C++ to use this constructor in some cases, but might mistake + Qt::NoPen for a QColor and use the + \ref QCPScatterStyle(ScatterShape shape, const QColor &color, const QColor &fill, double size) + constructor instead (which will lead to an unexpected look of the scatter points). To prevent + this, be more explicit with the parameter types. For example, use QBrush(Qt::blue) + instead of just Qt::blue, to clearly point out to the compiler that this constructor is + wanted. +*/ +QCPScatterStyle::QCPScatterStyle(ScatterShape shape, const QPen &pen, const QBrush &brush, double size) : + mSize(size), + mShape(shape), + mPen(pen), + mBrush(brush), + mPenDefined(pen.style() != Qt::NoPen) +{ +} + +/*! + Creates a new QCPScatterStyle instance which will show the specified \a pixmap. The scatter shape + is set to \ref ssPixmap. +*/ +QCPScatterStyle::QCPScatterStyle(const QPixmap &pixmap) : + mSize(5), + mShape(ssPixmap), + mPen(Qt::NoPen), + mBrush(Qt::NoBrush), + mPixmap(pixmap), + mPenDefined(false) +{ +} + +/*! + Creates a new QCPScatterStyle instance with a custom shape that is defined via \a customPath. The + scatter shape is set to \ref ssCustom. + + The custom shape line will be drawn with \a pen and filled with \a brush. The size has a slightly + different meaning than for built-in scatter points: The custom path will be drawn scaled by a + factor of \a size/6.0. Since the default \a size is 6, the custom path will appear in its + original size by default. To for example double the size of the path, set \a size to 12. +*/ +QCPScatterStyle::QCPScatterStyle(const QPainterPath &customPath, const QPen &pen, const QBrush &brush, double size) : + mSize(size), + mShape(ssCustom), + mPen(pen), + mBrush(brush), + mCustomPath(customPath), + mPenDefined(pen.style() != Qt::NoPen) +{ +} + +/*! + Copies the specified \a properties from the \a other scatter style to this scatter style. +*/ +void QCPScatterStyle::setFromOther(const QCPScatterStyle &other, ScatterProperties properties) +{ + if (properties.testFlag(spPen)) + { + setPen(other.pen()); + if (!other.isPenDefined()) + undefinePen(); + } + if (properties.testFlag(spBrush)) + setBrush(other.brush()); + if (properties.testFlag(spSize)) + setSize(other.size()); + if (properties.testFlag(spShape)) + { + setShape(other.shape()); + if (other.shape() == ssPixmap) + setPixmap(other.pixmap()); + else if (other.shape() == ssCustom) + setCustomPath(other.customPath()); + } +} + +/*! + Sets the size (pixel diameter) of the drawn scatter points to \a size. + + \see setShape +*/ +void QCPScatterStyle::setSize(double size) +{ + mSize = size; +} + +/*! + Sets the shape to \a shape. + + Note that the calls \ref setPixmap and \ref setCustomPath automatically set the shape to \ref + ssPixmap and \ref ssCustom, respectively. + + \see setSize +*/ +void QCPScatterStyle::setShape(QCPScatterStyle::ScatterShape shape) +{ + mShape = shape; +} + +/*! + Sets the pen that will be used to draw scatter points to \a pen. + + If the pen was previously undefined (see \ref isPenDefined), the pen is considered defined after + a call to this function, even if \a pen is Qt::NoPen. If you have defined a pen + previously by calling this function and now wish to undefine the pen, call \ref undefinePen. + + \see setBrush +*/ +void QCPScatterStyle::setPen(const QPen &pen) +{ + mPenDefined = true; + mPen = pen; +} + +/*! + Sets the brush that will be used to fill scatter points to \a brush. Note that not all scatter + shapes have fillable areas. For example, \ref ssPlus does not while \ref ssCircle does. + + \see setPen +*/ +void QCPScatterStyle::setBrush(const QBrush &brush) +{ + mBrush = brush; +} + +/*! + Sets the pixmap that will be drawn as scatter point to \a pixmap. + + Note that \ref setSize does not influence the appearance of the pixmap. + + The scatter shape is automatically set to \ref ssPixmap. +*/ +void QCPScatterStyle::setPixmap(const QPixmap &pixmap) +{ + setShape(ssPixmap); + mPixmap = pixmap; +} + +/*! + Sets the custom shape that will be drawn as scatter point to \a customPath. + + The scatter shape is automatically set to \ref ssCustom. +*/ +void QCPScatterStyle::setCustomPath(const QPainterPath &customPath) +{ + setShape(ssCustom); + mCustomPath = customPath; +} + +/*! + Sets this scatter style to have an undefined pen (see \ref isPenDefined for what an undefined pen + implies). + + A call to \ref setPen will define a pen. +*/ +void QCPScatterStyle::undefinePen() +{ + mPenDefined = false; +} + +/*! + Applies the pen and the brush of this scatter style to \a painter. If this scatter style has an + undefined pen (\ref isPenDefined), sets the pen of \a painter to \a defaultPen instead. + + This function is used by plottables (or any class that wants to draw scatters) just before a + number of scatters with this style shall be drawn with the \a painter. + + \see drawShape +*/ +void QCPScatterStyle::applyTo(QCPPainter *painter, const QPen &defaultPen) const +{ + painter->setPen(mPenDefined ? mPen : defaultPen); + painter->setBrush(mBrush); +} + +/*! + Draws the scatter shape with \a painter at position \a pos. + + This function does not modify the pen or the brush on the painter, as \ref applyTo is meant to be + called before scatter points are drawn with \ref drawShape. + + \see applyTo +*/ +void QCPScatterStyle::drawShape(QCPPainter *painter, const QPointF &pos) const +{ + drawShape(painter, pos.x(), pos.y()); +} + +/*! \overload + Draws the scatter shape with \a painter at position \a x and \a y. +*/ +void QCPScatterStyle::drawShape(QCPPainter *painter, double x, double y) const +{ + double w = mSize/2.0; + switch (mShape) + { + case ssNone: break; + case ssDot: + { + painter->drawLine(QPointF(x, y), QPointF(x+0.0001, y)); + break; + } + case ssCross: + { + painter->drawLine(QLineF(x-w, y-w, x+w, y+w)); + painter->drawLine(QLineF(x-w, y+w, x+w, y-w)); + break; + } + case ssPlus: + { + painter->drawLine(QLineF(x-w, y, x+w, y)); + painter->drawLine(QLineF( x, y+w, x, y-w)); + break; + } + case ssCircle: + { + painter->drawEllipse(QPointF(x , y), w, w); + break; + } + case ssDisc: + { + QBrush b = painter->brush(); + painter->setBrush(painter->pen().color()); + painter->drawEllipse(QPointF(x , y), w, w); + painter->setBrush(b); + break; + } + case ssSquare: + { + painter->drawRect(QRectF(x-w, y-w, mSize, mSize)); + break; + } + case ssDiamond: + { + QPointF lineArray[4] = {QPointF(x-w, y), + QPointF( x, y-w), + QPointF(x+w, y), + QPointF( x, y+w)}; + painter->drawPolygon(lineArray, 4); + break; + } + case ssStar: + { + painter->drawLine(QLineF(x-w, y, x+w, y)); + painter->drawLine(QLineF( x, y+w, x, y-w)); + painter->drawLine(QLineF(x-w*0.707, y-w*0.707, x+w*0.707, y+w*0.707)); + painter->drawLine(QLineF(x-w*0.707, y+w*0.707, x+w*0.707, y-w*0.707)); + break; + } + case ssTriangle: + { + QPointF lineArray[3] = {QPointF(x-w, y+0.755*w), + QPointF(x+w, y+0.755*w), + QPointF( x, y-0.977*w)}; + painter->drawPolygon(lineArray, 3); + break; + } + case ssTriangleInverted: + { + QPointF lineArray[3] = {QPointF(x-w, y-0.755*w), + QPointF(x+w, y-0.755*w), + QPointF( x, y+0.977*w)}; + painter->drawPolygon(lineArray, 3); + break; + } + case ssCrossSquare: + { + painter->drawRect(QRectF(x-w, y-w, mSize, mSize)); + painter->drawLine(QLineF(x-w, y-w, x+w*0.95, y+w*0.95)); + painter->drawLine(QLineF(x-w, y+w*0.95, x+w*0.95, y-w)); + break; + } + case ssPlusSquare: + { + painter->drawRect(QRectF(x-w, y-w, mSize, mSize)); + painter->drawLine(QLineF(x-w, y, x+w*0.95, y)); + painter->drawLine(QLineF( x, y+w, x, y-w)); + break; + } + case ssCrossCircle: + { + painter->drawEllipse(QPointF(x, y), w, w); + painter->drawLine(QLineF(x-w*0.707, y-w*0.707, x+w*0.670, y+w*0.670)); + painter->drawLine(QLineF(x-w*0.707, y+w*0.670, x+w*0.670, y-w*0.707)); + break; + } + case ssPlusCircle: + { + painter->drawEllipse(QPointF(x, y), w, w); + painter->drawLine(QLineF(x-w, y, x+w, y)); + painter->drawLine(QLineF( x, y+w, x, y-w)); + break; + } + case ssPeace: + { + painter->drawEllipse(QPointF(x, y), w, w); + painter->drawLine(QLineF(x, y-w, x, y+w)); + painter->drawLine(QLineF(x, y, x-w*0.707, y+w*0.707)); + painter->drawLine(QLineF(x, y, x+w*0.707, y+w*0.707)); + break; + } + case ssPixmap: + { + const double widthHalf = mPixmap.width()*0.5; + const double heightHalf = mPixmap.height()*0.5; +#if QT_VERSION < QT_VERSION_CHECK(4, 8, 0) + const QRectF clipRect = painter->clipRegion().boundingRect().adjusted(-widthHalf, -heightHalf, widthHalf, heightHalf); +#else + const QRectF clipRect = painter->clipBoundingRect().adjusted(-widthHalf, -heightHalf, widthHalf, heightHalf); +#endif + if (clipRect.contains(x, y)) + painter->drawPixmap(x-widthHalf, y-heightHalf, mPixmap); + break; + } + case ssCustom: + { + QTransform oldTransform = painter->transform(); + painter->translate(x, y); + painter->scale(mSize/6.0, mSize/6.0); + painter->drawPath(mCustomPath); + painter->setTransform(oldTransform); + break; + } + } +} +/* end of 'src/scatterstyle.cpp' */ + +//amalgamation: add datacontainer.cpp + +/* including file 'src/plottable.cpp', size 38845 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPSelectionDecorator +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPSelectionDecorator + \brief Controls how a plottable's data selection is drawn + + Each \ref QCPAbstractPlottable instance has one \ref QCPSelectionDecorator (accessible via \ref + QCPAbstractPlottable::selectionDecorator) and uses it when drawing selected segments of its data. + + The selection decorator controls both pen (\ref setPen) and brush (\ref setBrush), as well as the + scatter style (\ref setScatterStyle) if the plottable draws scatters. Since a \ref + QCPScatterStyle is itself composed of different properties such as color shape and size, the + decorator allows specifying exactly which of those properties shall be used for the selected data + point, via \ref setUsedScatterProperties. + + A \ref QCPSelectionDecorator subclass instance can be passed to a plottable via \ref + QCPAbstractPlottable::setSelectionDecorator, allowing greater customizability of the appearance + of selected segments. + + Use \ref copyFrom to easily transfer the settings of one decorator to another one. This is + especially useful since plottables take ownership of the passed selection decorator, and thus the + same decorator instance can not be passed to multiple plottables. + + Selection decorators can also themselves perform drawing operations by reimplementing \ref + drawDecoration, which is called by the plottable's draw method. The base class \ref + QCPSelectionDecorator does not make use of this however. For example, \ref + QCPSelectionDecoratorBracket draws brackets around selected data segments. +*/ + +/*! + Creates a new QCPSelectionDecorator instance with default values +*/ +QCPSelectionDecorator::QCPSelectionDecorator() : + mPen(QColor(80, 80, 255), 2.5), + mBrush(Qt::NoBrush), + mScatterStyle(), + mUsedScatterProperties(QCPScatterStyle::spNone), + mPlottable(0) +{ +} + +QCPSelectionDecorator::~QCPSelectionDecorator() +{ +} + +/*! + Sets the pen that will be used by the parent plottable to draw selected data segments. +*/ +void QCPSelectionDecorator::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the brush that will be used by the parent plottable to draw selected data segments. +*/ +void QCPSelectionDecorator::setBrush(const QBrush &brush) +{ + mBrush = brush; +} + +/*! + Sets the scatter style that will be used by the parent plottable to draw scatters in selected + data segments. + + \a usedProperties specifies which parts of the passed \a scatterStyle will be used by the + plottable. The used properties can also be changed via \ref setUsedScatterProperties. +*/ +void QCPSelectionDecorator::setScatterStyle(const QCPScatterStyle &scatterStyle, QCPScatterStyle::ScatterProperties usedProperties) +{ + mScatterStyle = scatterStyle; + setUsedScatterProperties(usedProperties); +} + +/*! + Use this method to define which properties of the scatter style (set via \ref setScatterStyle) + will be used for selected data segments. All properties of the scatter style that are not + specified in \a properties will remain as specified in the plottable's original scatter style. + + \see QCPScatterStyle::ScatterProperty +*/ +void QCPSelectionDecorator::setUsedScatterProperties(const QCPScatterStyle::ScatterProperties &properties) +{ + mUsedScatterProperties = properties; +} + +/*! + Sets the pen of \a painter to the pen of this selection decorator. + + \see applyBrush, getFinalScatterStyle +*/ +void QCPSelectionDecorator::applyPen(QCPPainter *painter) const +{ + painter->setPen(mPen); +} + +/*! + Sets the brush of \a painter to the brush of this selection decorator. + + \see applyPen, getFinalScatterStyle +*/ +void QCPSelectionDecorator::applyBrush(QCPPainter *painter) const +{ + painter->setBrush(mBrush); +} + +/*! + Returns the scatter style that the parent plottable shall use for selected scatter points. The + plottable's original (unselected) scatter style must be passed as \a unselectedStyle. Depending + on the setting of \ref setUsedScatterProperties, the returned scatter style is a mixture of this + selecion decorator's scatter style (\ref setScatterStyle), and \a unselectedStyle. + + \see applyPen, applyBrush, setScatterStyle +*/ +QCPScatterStyle QCPSelectionDecorator::getFinalScatterStyle(const QCPScatterStyle &unselectedStyle) const +{ + QCPScatterStyle result(unselectedStyle); + result.setFromOther(mScatterStyle, mUsedScatterProperties); + + // if style shall inherit pen from plottable (has no own pen defined), give it the selected + // plottable pen explicitly, so it doesn't use the unselected plottable pen when used in the + // plottable: + if (!result.isPenDefined()) + result.setPen(mPen); + + return result; +} + +/*! + Copies all properties (e.g. color, fill, scatter style) of the \a other selection decorator to + this selection decorator. +*/ +void QCPSelectionDecorator::copyFrom(const QCPSelectionDecorator *other) +{ + setPen(other->pen()); + setBrush(other->brush()); + setScatterStyle(other->scatterStyle(), other->usedScatterProperties()); +} + +/*! + This method is called by all plottables' draw methods to allow custom selection decorations to be + drawn. Use the passed \a painter to perform the drawing operations. \a selection carries the data + selection for which the decoration shall be drawn. + + The default base class implementation of \ref QCPSelectionDecorator has no special decoration, so + this method does nothing. +*/ +void QCPSelectionDecorator::drawDecoration(QCPPainter *painter, QCPDataSelection selection) +{ + Q_UNUSED(painter) + Q_UNUSED(selection) +} + +/*! \internal + + This method is called as soon as a selection decorator is associated with a plottable, by a call + to \ref QCPAbstractPlottable::setSelectionDecorator. This way the selection decorator can obtain a pointer to the plottable that uses it (e.g. to access + data points via the \ref QCPAbstractPlottable::interface1D interface). + + If the selection decorator was already added to a different plottable before, this method aborts + the registration and returns false. +*/ +bool QCPSelectionDecorator::registerWithPlottable(QCPAbstractPlottable *plottable) +{ + if (!mPlottable) + { + mPlottable = plottable; + return true; + } else + { + qDebug() << Q_FUNC_INFO << "This selection decorator is already registered with plottable:" << reinterpret_cast(mPlottable); + return false; + } +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAbstractPlottable +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPAbstractPlottable + \brief The abstract base class for all data representing objects in a plot. + + It defines a very basic interface like name, pen, brush, visibility etc. Since this class is + abstract, it can't be instantiated. Use one of the subclasses or create a subclass yourself to + create new ways of displaying data (see "Creating own plottables" below). Plottables that display + one-dimensional data (i.e. data points have a single key dimension and one or multiple values at + each key) are based off of the template subclass \ref QCPAbstractPlottable1D, see details + there. + + All further specifics are in the subclasses, for example: + \li A normal graph with possibly a line and/or scatter points \ref QCPGraph + (typically created with \ref QCustomPlot::addGraph) + \li A parametric curve: \ref QCPCurve + \li A bar chart: \ref QCPBars + \li A statistical box plot: \ref QCPStatisticalBox + \li A color encoded two-dimensional map: \ref QCPColorMap + \li An OHLC/Candlestick chart: \ref QCPFinancial + + \section plottables-subclassing Creating own plottables + + Subclassing directly from QCPAbstractPlottable is only recommended if you wish to display + two-dimensional data like \ref QCPColorMap, i.e. two logical key dimensions and one (or more) + data dimensions. If you want to display data with only one logical key dimension, you should + rather derive from \ref QCPAbstractPlottable1D. + + If subclassing QCPAbstractPlottable directly, these are the pure virtual functions you must + implement: + \li \ref selectTest + \li \ref draw + \li \ref drawLegendIcon + \li \ref getKeyRange + \li \ref getValueRange + + See the documentation of those functions for what they need to do. + + For drawing your plot, you can use the \ref coordsToPixels functions to translate a point in plot + coordinates to pixel coordinates. This function is quite convenient, because it takes the + orientation of the key and value axes into account for you (x and y are swapped when the key axis + is vertical and the value axis horizontal). If you are worried about performance (i.e. you need + to translate many points in a loop like QCPGraph), you can directly use \ref + QCPAxis::coordToPixel. However, you must then take care about the orientation of the axis + yourself. + + Here are some important members you inherit from QCPAbstractPlottable: + + + + + + + + + + + + + + + + + + + + + + + + + + +
QCustomPlot *\b mParentPlotA pointer to the parent QCustomPlot instance. The parent plot is inferred from the axes that are passed in the constructor.
QString \b mNameThe name of the plottable.
QPen \b mPenThe generic pen of the plottable. You should use this pen for the most prominent data representing lines in the plottable + (e.g QCPGraph uses this pen for its graph lines and scatters)
QBrush \b mBrushThe generic brush of the plottable. You should use this brush for the most prominent fillable structures in the plottable + (e.g. QCPGraph uses this brush to control filling under the graph)
QPointer<\ref QCPAxis> \b mKeyAxis, \b mValueAxisThe key and value axes this plottable is attached to. Call their QCPAxis::coordToPixel functions to translate coordinates + to pixels in either the key or value dimension. Make sure to check whether the pointer is null before using it. If one of + the axes is null, don't draw the plottable.
\ref QCPSelectionDecorator \b mSelectionDecoratorThe currently set selection decorator which specifies how selected data of the plottable shall be drawn and decorated. + When drawing your data, you must consult this decorator for the appropriate pen/brush before drawing unselected/selected data segments. + Finally, you should call its \ref QCPSelectionDecorator::drawDecoration method at the end of your \ref draw implementation.
\ref QCP::SelectionType \b mSelectableIn which composition, if at all, this plottable's data may be selected. Enforcing this setting on the data selection is done + by QCPAbstractPlottable automatically.
\ref QCPDataSelection \b mSelectionHolds the current selection state of the plottable's data, i.e. the selected data ranges (\ref QCPDataRange).
+*/ + +/* start of documentation of inline functions */ + +/*! \fn QCPSelectionDecorator *QCPAbstractPlottable::selectionDecorator() const + + Provides access to the selection decorator of this plottable. The selection decorator controls + how selected data ranges are drawn (e.g. their pen color and fill), see \ref + QCPSelectionDecorator for details. + + If you wish to use an own \ref QCPSelectionDecorator subclass, pass an instance of it to \ref + setSelectionDecorator. +*/ + +/*! \fn bool QCPAbstractPlottable::selected() const + + Returns true if there are any data points of the plottable currently selected. Use \ref selection + to retrieve the current \ref QCPDataSelection. +*/ + +/*! \fn QCPDataSelection QCPAbstractPlottable::selection() const + + Returns a \ref QCPDataSelection encompassing all the data points that are currently selected on + this plottable. + + \see selected, setSelection, setSelectable +*/ + +/*! \fn virtual QCPPlottableInterface1D *QCPAbstractPlottable::interface1D() + + If this plottable is a one-dimensional plottable, i.e. it implements the \ref + QCPPlottableInterface1D, returns the \a this pointer with that type. Otherwise (e.g. in the case + of a \ref QCPColorMap) returns zero. + + You can use this method to gain read access to data coordinates while holding a pointer to the + abstract base class only. +*/ + +/* end of documentation of inline functions */ +/* start of documentation of pure virtual functions */ + +/*! \fn void QCPAbstractPlottable::drawLegendIcon(QCPPainter *painter, const QRect &rect) const = 0 + \internal + + called by QCPLegend::draw (via QCPPlottableLegendItem::draw) to create a graphical representation + of this plottable inside \a rect, next to the plottable name. + + The passed \a painter has its cliprect set to \a rect, so painting outside of \a rect won't + appear outside the legend icon border. +*/ + +/*! \fn QCPRange QCPAbstractPlottable::getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain) const = 0 + + Returns the coordinate range that all data in this plottable span in the key axis dimension. For + logarithmic plots, one can set \a inSignDomain to either \ref QCP::sdNegative or \ref + QCP::sdPositive in order to restrict the returned range to that sign domain. E.g. when only + negative range is wanted, set \a inSignDomain to \ref QCP::sdNegative and all positive points + will be ignored for range calculation. For no restriction, just set \a inSignDomain to \ref + QCP::sdBoth (default). \a foundRange is an output parameter that indicates whether a range could + be found or not. If this is false, you shouldn't use the returned range (e.g. no points in data). + + Note that \a foundRange is not the same as \ref QCPRange::validRange, since the range returned by + this function may have size zero (e.g. when there is only one data point). In this case \a + foundRange would return true, but the returned range is not a valid range in terms of \ref + QCPRange::validRange. + + \see rescaleAxes, getValueRange +*/ + +/*! \fn QCPRange QCPAbstractPlottable::getValueRange(bool &foundRange, QCP::SignDomain inSignDomain, const QCPRange &inKeyRange) const = 0 + + Returns the coordinate range that the data points in the specified key range (\a inKeyRange) span + in the value axis dimension. For logarithmic plots, one can set \a inSignDomain to either \ref + QCP::sdNegative or \ref QCP::sdPositive in order to restrict the returned range to that sign + domain. E.g. when only negative range is wanted, set \a inSignDomain to \ref QCP::sdNegative and + all positive points will be ignored for range calculation. For no restriction, just set \a + inSignDomain to \ref QCP::sdBoth (default). \a foundRange is an output parameter that indicates + whether a range could be found or not. If this is false, you shouldn't use the returned range + (e.g. no points in data). + + If \a inKeyRange has both lower and upper bound set to zero (is equal to QCPRange()), + all data points are considered, without any restriction on the keys. + + Note that \a foundRange is not the same as \ref QCPRange::validRange, since the range returned by + this function may have size zero (e.g. when there is only one data point). In this case \a + foundRange would return true, but the returned range is not a valid range in terms of \ref + QCPRange::validRange. + + \see rescaleAxes, getKeyRange +*/ + +/* end of documentation of pure virtual functions */ +/* start of documentation of signals */ + +/*! \fn void QCPAbstractPlottable::selectionChanged(bool selected) + + This signal is emitted when the selection state of this plottable has changed, either by user + interaction or by a direct call to \ref setSelection. The parameter \a selected indicates whether + there are any points selected or not. + + \see selectionChanged(const QCPDataSelection &selection) +*/ + +/*! \fn void QCPAbstractPlottable::selectionChanged(const QCPDataSelection &selection) + + This signal is emitted when the selection state of this plottable has changed, either by user + interaction or by a direct call to \ref setSelection. The parameter \a selection holds the + currently selected data ranges. + + \see selectionChanged(bool selected) +*/ + +/*! \fn void QCPAbstractPlottable::selectableChanged(QCP::SelectionType selectable); + + This signal is emitted when the selectability of this plottable has changed. + + \see setSelectable +*/ + +/* end of documentation of signals */ + +/*! + Constructs an abstract plottable which uses \a keyAxis as its key axis ("x") and \a valueAxis as + its value axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance + and have perpendicular orientations. If either of these restrictions is violated, a corresponding + message is printed to the debug output (qDebug), the construction is not aborted, though. + + Since QCPAbstractPlottable is an abstract class that defines the basic interface to plottables, + it can't be directly instantiated. + + You probably want one of the subclasses like \ref QCPGraph or \ref QCPCurve instead. +*/ +QCPAbstractPlottable::QCPAbstractPlottable(QCPAxis *keyAxis, QCPAxis *valueAxis) : + QCPLayerable(keyAxis->parentPlot(), QString(), keyAxis->axisRect()), + mName(), + mAntialiasedFill(true), + mAntialiasedScatters(true), + mPen(Qt::black), + mBrush(Qt::NoBrush), + mKeyAxis(keyAxis), + mValueAxis(valueAxis), + mSelectable(QCP::stWhole), + mSelectionDecorator(0) +{ + if (keyAxis->parentPlot() != valueAxis->parentPlot()) + qDebug() << Q_FUNC_INFO << "Parent plot of keyAxis is not the same as that of valueAxis."; + if (keyAxis->orientation() == valueAxis->orientation()) + qDebug() << Q_FUNC_INFO << "keyAxis and valueAxis must be orthogonal to each other."; + + mParentPlot->registerPlottable(this); + setSelectionDecorator(new QCPSelectionDecorator); +} + +QCPAbstractPlottable::~QCPAbstractPlottable() +{ + if (mSelectionDecorator) + { + delete mSelectionDecorator; + mSelectionDecorator = 0; + } +} + +/*! + The name is the textual representation of this plottable as it is displayed in the legend + (\ref QCPLegend). It may contain any UTF-8 characters, including newlines. +*/ +void QCPAbstractPlottable::setName(const QString &name) +{ + mName = name; +} + +/*! + Sets whether fills of this plottable are drawn antialiased or not. + + Note that this setting may be overridden by \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. +*/ +void QCPAbstractPlottable::setAntialiasedFill(bool enabled) +{ + mAntialiasedFill = enabled; +} + +/*! + Sets whether the scatter symbols of this plottable are drawn antialiased or not. + + Note that this setting may be overridden by \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. +*/ +void QCPAbstractPlottable::setAntialiasedScatters(bool enabled) +{ + mAntialiasedScatters = enabled; +} + +/*! + The pen is used to draw basic lines that make up the plottable representation in the + plot. + + For example, the \ref QCPGraph subclass draws its graph lines with this pen. + + \see setBrush +*/ +void QCPAbstractPlottable::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + The brush is used to draw basic fills of the plottable representation in the + plot. The Fill can be a color, gradient or texture, see the usage of QBrush. + + For example, the \ref QCPGraph subclass draws the fill under the graph with this brush, when + it's not set to Qt::NoBrush. + + \see setPen +*/ +void QCPAbstractPlottable::setBrush(const QBrush &brush) +{ + mBrush = brush; +} + +/*! + The key axis of a plottable can be set to any axis of a QCustomPlot, as long as it is orthogonal + to the plottable's value axis. This function performs no checks to make sure this is the case. + The typical mathematical choice is to use the x-axis (QCustomPlot::xAxis) as key axis and the + y-axis (QCustomPlot::yAxis) as value axis. + + Normally, the key and value axes are set in the constructor of the plottable (or \ref + QCustomPlot::addGraph when working with QCPGraphs through the dedicated graph interface). + + \see setValueAxis +*/ +void QCPAbstractPlottable::setKeyAxis(QCPAxis *axis) +{ + mKeyAxis = axis; +} + +/*! + The value axis of a plottable can be set to any axis of a QCustomPlot, as long as it is + orthogonal to the plottable's key axis. This function performs no checks to make sure this is the + case. The typical mathematical choice is to use the x-axis (QCustomPlot::xAxis) as key axis and + the y-axis (QCustomPlot::yAxis) as value axis. + + Normally, the key and value axes are set in the constructor of the plottable (or \ref + QCustomPlot::addGraph when working with QCPGraphs through the dedicated graph interface). + + \see setKeyAxis +*/ +void QCPAbstractPlottable::setValueAxis(QCPAxis *axis) +{ + mValueAxis = axis; +} + + +/*! + Sets which data ranges of this plottable are selected. Selected data ranges are drawn differently + (e.g. color) in the plot. This can be controlled via the selection decorator (see \ref + selectionDecorator). + + The entire selection mechanism for plottables is handled automatically when \ref + QCustomPlot::setInteractions contains iSelectPlottables. You only need to call this function when + you wish to change the selection state programmatically. + + Using \ref setSelectable you can further specify for each plottable whether and to which + granularity it is selectable. If \a selection is not compatible with the current \ref + QCP::SelectionType set via \ref setSelectable, the resulting selection will be adjusted + accordingly (see \ref QCPDataSelection::enforceType). + + emits the \ref selectionChanged signal when \a selected is different from the previous selection state. + + \see setSelectable, selectTest +*/ +void QCPAbstractPlottable::setSelection(QCPDataSelection selection) +{ + selection.enforceType(mSelectable); + if (mSelection != selection) + { + mSelection = selection; + emit selectionChanged(selected()); + emit selectionChanged(mSelection); + } +} + +/*! + Use this method to set an own QCPSelectionDecorator (subclass) instance. This allows you to + customize the visual representation of selected data ranges further than by using the default + QCPSelectionDecorator. + + The plottable takes ownership of the \a decorator. + + The currently set decorator can be accessed via \ref selectionDecorator. +*/ +void QCPAbstractPlottable::setSelectionDecorator(QCPSelectionDecorator *decorator) +{ + if (decorator) + { + if (decorator->registerWithPlottable(this)) + { + if (mSelectionDecorator) // delete old decorator if necessary + delete mSelectionDecorator; + mSelectionDecorator = decorator; + } + } else if (mSelectionDecorator) // just clear decorator + { + delete mSelectionDecorator; + mSelectionDecorator = 0; + } +} + +/*! + Sets whether and to which granularity this plottable can be selected. + + A selection can happen by clicking on the QCustomPlot surface (When \ref + QCustomPlot::setInteractions contains \ref QCP::iSelectPlottables), by dragging a selection rect + (When \ref QCustomPlot::setSelectionRectMode is \ref QCP::srmSelect), or programmatically by + calling \ref setSelection. + + \see setSelection, QCP::SelectionType +*/ +void QCPAbstractPlottable::setSelectable(QCP::SelectionType selectable) +{ + if (mSelectable != selectable) + { + mSelectable = selectable; + QCPDataSelection oldSelection = mSelection; + mSelection.enforceType(mSelectable); + emit selectableChanged(mSelectable); + if (mSelection != oldSelection) + { + emit selectionChanged(selected()); + emit selectionChanged(mSelection); + } + } +} + + +/*! + Convenience function for transforming a key/value pair to pixels on the QCustomPlot surface, + taking the orientations of the axes associated with this plottable into account (e.g. whether key + represents x or y). + + \a key and \a value are transformed to the coodinates in pixels and are written to \a x and \a y. + + \see pixelsToCoords, QCPAxis::coordToPixel +*/ +void QCPAbstractPlottable::coordsToPixels(double key, double value, double &x, double &y) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + + if (keyAxis->orientation() == Qt::Horizontal) + { + x = keyAxis->coordToPixel(key); + y = valueAxis->coordToPixel(value); + } else + { + y = keyAxis->coordToPixel(key); + x = valueAxis->coordToPixel(value); + } +} + +/*! \overload + + Transforms the given \a key and \a value to pixel coordinates and returns them in a QPointF. +*/ +const QPointF QCPAbstractPlottable::coordsToPixels(double key, double value) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return QPointF(); } + + if (keyAxis->orientation() == Qt::Horizontal) + return QPointF(keyAxis->coordToPixel(key), valueAxis->coordToPixel(value)); + else + return QPointF(valueAxis->coordToPixel(value), keyAxis->coordToPixel(key)); +} + +/*! + Convenience function for transforming a x/y pixel pair on the QCustomPlot surface to plot coordinates, + taking the orientations of the axes associated with this plottable into account (e.g. whether key + represents x or y). + + \a x and \a y are transformed to the plot coodinates and are written to \a key and \a value. + + \see coordsToPixels, QCPAxis::coordToPixel +*/ +void QCPAbstractPlottable::pixelsToCoords(double x, double y, double &key, double &value) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + + if (keyAxis->orientation() == Qt::Horizontal) + { + key = keyAxis->pixelToCoord(x); + value = valueAxis->pixelToCoord(y); + } else + { + key = keyAxis->pixelToCoord(y); + value = valueAxis->pixelToCoord(x); + } +} + +/*! \overload + + Returns the pixel input \a pixelPos as plot coordinates \a key and \a value. +*/ +void QCPAbstractPlottable::pixelsToCoords(const QPointF &pixelPos, double &key, double &value) const +{ + pixelsToCoords(pixelPos.x(), pixelPos.y(), key, value); +} + +/*! + Rescales the key and value axes associated with this plottable to contain all displayed data, so + the whole plottable is visible. If the scaling of an axis is logarithmic, rescaleAxes will make + sure not to rescale to an illegal range i.e. a range containing different signs and/or zero. + Instead it will stay in the current sign domain and ignore all parts of the plottable that lie + outside of that domain. + + \a onlyEnlarge makes sure the ranges are only expanded, never reduced. So it's possible to show + multiple plottables in their entirety by multiple calls to rescaleAxes where the first call has + \a onlyEnlarge set to false (the default), and all subsequent set to true. + + \see rescaleKeyAxis, rescaleValueAxis, QCustomPlot::rescaleAxes, QCPAxis::rescale +*/ +void QCPAbstractPlottable::rescaleAxes(bool onlyEnlarge) const +{ + rescaleKeyAxis(onlyEnlarge); + rescaleValueAxis(onlyEnlarge); +} + +/*! + Rescales the key axis of the plottable so the whole plottable is visible. + + See \ref rescaleAxes for detailed behaviour. +*/ +void QCPAbstractPlottable::rescaleKeyAxis(bool onlyEnlarge) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + if (!keyAxis) { qDebug() << Q_FUNC_INFO << "invalid key axis"; return; } + + QCP::SignDomain signDomain = QCP::sdBoth; + if (keyAxis->scaleType() == QCPAxis::stLogarithmic) + signDomain = (keyAxis->range().upper < 0 ? QCP::sdNegative : QCP::sdPositive); + + bool foundRange; + QCPRange newRange = getKeyRange(foundRange, signDomain); + if (foundRange) + { + if (onlyEnlarge) + newRange.expand(keyAxis->range()); + if (!QCPRange::validRange(newRange)) // likely due to range being zero (plottable has only constant data in this axis dimension), shift current range to at least center the plottable + { + double center = (newRange.lower+newRange.upper)*0.5; // upper and lower should be equal anyway, but just to make sure, incase validRange returned false for other reason + if (keyAxis->scaleType() == QCPAxis::stLinear) + { + newRange.lower = center-keyAxis->range().size()/2.0; + newRange.upper = center+keyAxis->range().size()/2.0; + } else // scaleType() == stLogarithmic + { + newRange.lower = center/qSqrt(keyAxis->range().upper/keyAxis->range().lower); + newRange.upper = center*qSqrt(keyAxis->range().upper/keyAxis->range().lower); + } + } + keyAxis->setRange(newRange); + } +} + +/*! + Rescales the value axis of the plottable so the whole plottable is visible. If \a inKeyRange is + set to true, only the data points which are in the currently visible key axis range are + considered. + + Returns true if the axis was actually scaled. This might not be the case if this plottable has an + invalid range, e.g. because it has no data points. + + See \ref rescaleAxes for detailed behaviour. +*/ +void QCPAbstractPlottable::rescaleValueAxis(bool onlyEnlarge, bool inKeyRange) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + + QCP::SignDomain signDomain = QCP::sdBoth; + if (valueAxis->scaleType() == QCPAxis::stLogarithmic) + signDomain = (valueAxis->range().upper < 0 ? QCP::sdNegative : QCP::sdPositive); + + bool foundRange; + QCPRange newRange = getValueRange(foundRange, signDomain, inKeyRange ? keyAxis->range() : QCPRange()); + if (foundRange) + { + if (onlyEnlarge) + newRange.expand(valueAxis->range()); + if (!QCPRange::validRange(newRange)) // likely due to range being zero (plottable has only constant data in this axis dimension), shift current range to at least center the plottable + { + double center = (newRange.lower+newRange.upper)*0.5; // upper and lower should be equal anyway, but just to make sure, incase validRange returned false for other reason + if (valueAxis->scaleType() == QCPAxis::stLinear) + { + newRange.lower = center-valueAxis->range().size()/2.0; + newRange.upper = center+valueAxis->range().size()/2.0; + } else // scaleType() == stLogarithmic + { + newRange.lower = center/qSqrt(valueAxis->range().upper/valueAxis->range().lower); + newRange.upper = center*qSqrt(valueAxis->range().upper/valueAxis->range().lower); + } + } + valueAxis->setRange(newRange); + } +} + +/*! \overload + + Adds this plottable to the specified \a legend. + + Creates a QCPPlottableLegendItem which is inserted into the legend. Returns true on success, i.e. + when the legend exists and a legend item associated with this plottable isn't already in the + legend. + + If the plottable needs a more specialized representation in the legend, you can create a + corresponding subclass of \ref QCPPlottableLegendItem and add it to the legend manually instead + of calling this method. + + \see removeFromLegend, QCPLegend::addItem +*/ +bool QCPAbstractPlottable::addToLegend(QCPLegend *legend) +{ + if (!legend) + { + qDebug() << Q_FUNC_INFO << "passed legend is null"; + return false; + } + if (legend->parentPlot() != mParentPlot) + { + qDebug() << Q_FUNC_INFO << "passed legend isn't in the same QCustomPlot as this plottable"; + return false; + } + + if (!legend->hasItemWithPlottable(this)) + { + legend->addItem(new QCPPlottableLegendItem(legend, this)); + return true; + } else + return false; +} + +/*! \overload + + Adds this plottable to the legend of the parent QCustomPlot (\ref QCustomPlot::legend). + + \see removeFromLegend +*/ +bool QCPAbstractPlottable::addToLegend() +{ + if (!mParentPlot || !mParentPlot->legend) + return false; + else + return addToLegend(mParentPlot->legend); +} + +/*! \overload + + Removes the plottable from the specifed \a legend. This means the \ref QCPPlottableLegendItem + that is associated with this plottable is removed. + + Returns true on success, i.e. if the legend exists and a legend item associated with this + plottable was found and removed. + + \see addToLegend, QCPLegend::removeItem +*/ +bool QCPAbstractPlottable::removeFromLegend(QCPLegend *legend) const +{ + if (!legend) + { + qDebug() << Q_FUNC_INFO << "passed legend is null"; + return false; + } + + if (QCPPlottableLegendItem *lip = legend->itemWithPlottable(this)) + return legend->removeItem(lip); + else + return false; +} + +/*! \overload + + Removes the plottable from the legend of the parent QCustomPlot. + + \see addToLegend +*/ +bool QCPAbstractPlottable::removeFromLegend() const +{ + if (!mParentPlot || !mParentPlot->legend) + return false; + else + return removeFromLegend(mParentPlot->legend); +} + +/* inherits documentation from base class */ +QRect QCPAbstractPlottable::clipRect() const +{ + if (mKeyAxis && mValueAxis) + return mKeyAxis.data()->axisRect()->rect() & mValueAxis.data()->axisRect()->rect(); + else + return QRect(); +} + +/* inherits documentation from base class */ +QCP::Interaction QCPAbstractPlottable::selectionCategory() const +{ + return QCP::iSelectPlottables; +} + +/*! \internal + + A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter + before drawing plottable lines. + + This is the antialiasing state the painter passed to the \ref draw method is in by default. + + This function takes into account the local setting of the antialiasing flag as well as the + overrides set with \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. + + \seebaseclassmethod + + \see setAntialiased, applyFillAntialiasingHint, applyScattersAntialiasingHint +*/ +void QCPAbstractPlottable::applyDefaultAntialiasingHint(QCPPainter *painter) const +{ + applyAntialiasingHint(painter, mAntialiased, QCP::aePlottables); +} + +/*! \internal + + A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter + before drawing plottable fills. + + This function takes into account the local setting of the antialiasing flag as well as the + overrides set with \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. + + \see setAntialiased, applyDefaultAntialiasingHint, applyScattersAntialiasingHint +*/ +void QCPAbstractPlottable::applyFillAntialiasingHint(QCPPainter *painter) const +{ + applyAntialiasingHint(painter, mAntialiasedFill, QCP::aeFills); +} + +/*! \internal + + A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter + before drawing plottable scatter points. + + This function takes into account the local setting of the antialiasing flag as well as the + overrides set with \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. + + \see setAntialiased, applyFillAntialiasingHint, applyDefaultAntialiasingHint +*/ +void QCPAbstractPlottable::applyScattersAntialiasingHint(QCPPainter *painter) const +{ + applyAntialiasingHint(painter, mAntialiasedScatters, QCP::aeScatters); +} + +/* inherits documentation from base class */ +void QCPAbstractPlottable::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) +{ + Q_UNUSED(event) + + if (mSelectable != QCP::stNone) + { + QCPDataSelection newSelection = details.value(); + QCPDataSelection selectionBefore = mSelection; + if (additive) + { + if (mSelectable == QCP::stWhole) // in whole selection mode, we toggle to no selection even if currently unselected point was hit + { + if (selected()) + setSelection(QCPDataSelection()); + else + setSelection(newSelection); + } else // in all other selection modes we toggle selections of homogeneously selected/unselected segments + { + if (mSelection.contains(newSelection)) // if entire newSelection is already selected, toggle selection + setSelection(mSelection-newSelection); + else + setSelection(mSelection+newSelection); + } + } else + setSelection(newSelection); + if (selectionStateChanged) + *selectionStateChanged = mSelection != selectionBefore; + } +} + +/* inherits documentation from base class */ +void QCPAbstractPlottable::deselectEvent(bool *selectionStateChanged) +{ + if (mSelectable != QCP::stNone) + { + QCPDataSelection selectionBefore = mSelection; + setSelection(QCPDataSelection()); + if (selectionStateChanged) + *selectionStateChanged = mSelection != selectionBefore; + } +} +/* end of 'src/plottable.cpp' */ + + +/* including file 'src/item.cpp', size 49271 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemAnchor +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemAnchor + \brief An anchor of an item to which positions can be attached to. + + An item (QCPAbstractItem) may have one or more anchors. Unlike QCPItemPosition, an anchor doesn't + control anything on its item, but provides a way to tie other items via their positions to the + anchor. + + For example, a QCPItemRect is defined by its positions \a topLeft and \a bottomRight. + Additionally it has various anchors like \a top, \a topRight or \a bottomLeft etc. So you can + attach the \a start (which is a QCPItemPosition) of a QCPItemLine to one of the anchors by + calling QCPItemPosition::setParentAnchor on \a start, passing the wanted anchor of the + QCPItemRect. This way the start of the line will now always follow the respective anchor location + on the rect item. + + Note that QCPItemPosition derives from QCPItemAnchor, so every position can also serve as an + anchor to other positions. + + To learn how to provide anchors in your own item subclasses, see the subclassing section of the + QCPAbstractItem documentation. +*/ + +/* start documentation of inline functions */ + +/*! \fn virtual QCPItemPosition *QCPItemAnchor::toQCPItemPosition() + + Returns 0 if this instance is merely a QCPItemAnchor, and a valid pointer of type QCPItemPosition* if + it actually is a QCPItemPosition (which is a subclass of QCPItemAnchor). + + This safe downcast functionality could also be achieved with a dynamic_cast. However, QCustomPlot avoids + dynamic_cast to work with projects that don't have RTTI support enabled (e.g. -fno-rtti flag with + gcc compiler). +*/ + +/* end documentation of inline functions */ + +/*! + Creates a new QCPItemAnchor. You shouldn't create QCPItemAnchor instances directly, even if + you want to make a new item subclass. Use \ref QCPAbstractItem::createAnchor instead, as + explained in the subclassing section of the QCPAbstractItem documentation. +*/ +QCPItemAnchor::QCPItemAnchor(QCustomPlot *parentPlot, QCPAbstractItem *parentItem, const QString &name, int anchorId) : + mName(name), + mParentPlot(parentPlot), + mParentItem(parentItem), + mAnchorId(anchorId) +{ +} + +QCPItemAnchor::~QCPItemAnchor() +{ + // unregister as parent at children: + foreach (QCPItemPosition *child, mChildrenX.toList()) + { + if (child->parentAnchorX() == this) + child->setParentAnchorX(0); // this acts back on this anchor and child removes itself from mChildrenX + } + foreach (QCPItemPosition *child, mChildrenY.toList()) + { + if (child->parentAnchorY() == this) + child->setParentAnchorY(0); // this acts back on this anchor and child removes itself from mChildrenY + } +} + +/*! + Returns the final absolute pixel position of the QCPItemAnchor on the QCustomPlot surface. + + The pixel information is internally retrieved via QCPAbstractItem::anchorPixelPosition of the + parent item, QCPItemAnchor is just an intermediary. +*/ +QPointF QCPItemAnchor::pixelPosition() const +{ + if (mParentItem) + { + if (mAnchorId > -1) + { + return mParentItem->anchorPixelPosition(mAnchorId); + } else + { + qDebug() << Q_FUNC_INFO << "no valid anchor id set:" << mAnchorId; + return QPointF(); + } + } else + { + qDebug() << Q_FUNC_INFO << "no parent item set"; + return QPointF(); + } +} + +/*! \internal + + Adds \a pos to the childX list of this anchor, which keeps track of which children use this + anchor as parent anchor for the respective coordinate. This is necessary to notify the children + prior to destruction of the anchor. + + Note that this function does not change the parent setting in \a pos. +*/ +void QCPItemAnchor::addChildX(QCPItemPosition *pos) +{ + if (!mChildrenX.contains(pos)) + mChildrenX.insert(pos); + else + qDebug() << Q_FUNC_INFO << "provided pos is child already" << reinterpret_cast(pos); +} + +/*! \internal + + Removes \a pos from the childX list of this anchor. + + Note that this function does not change the parent setting in \a pos. +*/ +void QCPItemAnchor::removeChildX(QCPItemPosition *pos) +{ + if (!mChildrenX.remove(pos)) + qDebug() << Q_FUNC_INFO << "provided pos isn't child" << reinterpret_cast(pos); +} + +/*! \internal + + Adds \a pos to the childY list of this anchor, which keeps track of which children use this + anchor as parent anchor for the respective coordinate. This is necessary to notify the children + prior to destruction of the anchor. + + Note that this function does not change the parent setting in \a pos. +*/ +void QCPItemAnchor::addChildY(QCPItemPosition *pos) +{ + if (!mChildrenY.contains(pos)) + mChildrenY.insert(pos); + else + qDebug() << Q_FUNC_INFO << "provided pos is child already" << reinterpret_cast(pos); +} + +/*! \internal + + Removes \a pos from the childY list of this anchor. + + Note that this function does not change the parent setting in \a pos. +*/ +void QCPItemAnchor::removeChildY(QCPItemPosition *pos) +{ + if (!mChildrenY.remove(pos)) + qDebug() << Q_FUNC_INFO << "provided pos isn't child" << reinterpret_cast(pos); +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemPosition +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemPosition + \brief Manages the position of an item. + + Every item has at least one public QCPItemPosition member pointer which provides ways to position the + item on the QCustomPlot surface. Some items have multiple positions, for example QCPItemRect has two: + \a topLeft and \a bottomRight. + + QCPItemPosition has a type (\ref PositionType) that can be set with \ref setType. This type + defines how coordinates passed to \ref setCoords are to be interpreted, e.g. as absolute pixel + coordinates, as plot coordinates of certain axes, etc. For more advanced plots it is also + possible to assign different types per X/Y coordinate of the position (see \ref setTypeX, \ref + setTypeY). This way an item could be positioned at a fixed pixel distance from the top in the Y + direction, while following a plot coordinate in the X direction. + + A QCPItemPosition may have a parent QCPItemAnchor, see \ref setParentAnchor. This way you can tie + multiple items together. If the QCPItemPosition has a parent, its coordinates (\ref setCoords) + are considered to be absolute pixels in the reference frame of the parent anchor, where (0, 0) + means directly ontop of the parent anchor. For example, You could attach the \a start position of + a QCPItemLine to the \a bottom anchor of a QCPItemText to make the starting point of the line + always be centered under the text label, no matter where the text is moved to. For more advanced + plots, it is possible to assign different parent anchors per X/Y coordinate of the position, see + \ref setParentAnchorX, \ref setParentAnchorY. This way an item could follow another item in the X + direction but stay at a fixed position in the Y direction. Or even follow item A in X, and item B + in Y. + + Note that every QCPItemPosition inherits from QCPItemAnchor and thus can itself be used as parent + anchor for other positions. + + To set the apparent pixel position on the QCustomPlot surface directly, use \ref setPixelPosition. This + works no matter what type this QCPItemPosition is or what parent-child situation it is in, as \ref + setPixelPosition transforms the coordinates appropriately, to make the position appear at the specified + pixel values. +*/ + +/* start documentation of inline functions */ + +/*! \fn QCPItemPosition::PositionType *QCPItemPosition::type() const + + Returns the current position type. + + If different types were set for X and Y (\ref setTypeX, \ref setTypeY), this method returns the + type of the X coordinate. In that case rather use \a typeX() and \a typeY(). + + \see setType +*/ + +/*! \fn QCPItemAnchor *QCPItemPosition::parentAnchor() const + + Returns the current parent anchor. + + If different parent anchors were set for X and Y (\ref setParentAnchorX, \ref setParentAnchorY), + this method returns the parent anchor of the Y coordinate. In that case rather use \a + parentAnchorX() and \a parentAnchorY(). + + \see setParentAnchor +*/ + +/* end documentation of inline functions */ + +/*! + Creates a new QCPItemPosition. You shouldn't create QCPItemPosition instances directly, even if + you want to make a new item subclass. Use \ref QCPAbstractItem::createPosition instead, as + explained in the subclassing section of the QCPAbstractItem documentation. +*/ +QCPItemPosition::QCPItemPosition(QCustomPlot *parentPlot, QCPAbstractItem *parentItem, const QString &name) : + QCPItemAnchor(parentPlot, parentItem, name), + mPositionTypeX(ptAbsolute), + mPositionTypeY(ptAbsolute), + mKey(0), + mValue(0), + mParentAnchorX(0), + mParentAnchorY(0) +{ +} + +QCPItemPosition::~QCPItemPosition() +{ + // unregister as parent at children: + // Note: this is done in ~QCPItemAnchor again, but it's important QCPItemPosition does it itself, because only then + // the setParentAnchor(0) call the correct QCPItemPosition::pixelPosition function instead of QCPItemAnchor::pixelPosition + foreach (QCPItemPosition *child, mChildrenX.toList()) + { + if (child->parentAnchorX() == this) + child->setParentAnchorX(0); // this acts back on this anchor and child removes itself from mChildrenX + } + foreach (QCPItemPosition *child, mChildrenY.toList()) + { + if (child->parentAnchorY() == this) + child->setParentAnchorY(0); // this acts back on this anchor and child removes itself from mChildrenY + } + // unregister as child in parent: + if (mParentAnchorX) + mParentAnchorX->removeChildX(this); + if (mParentAnchorY) + mParentAnchorY->removeChildY(this); +} + +/* can't make this a header inline function, because QPointer breaks with forward declared types, see QTBUG-29588 */ +QCPAxisRect *QCPItemPosition::axisRect() const +{ + return mAxisRect.data(); +} + +/*! + Sets the type of the position. The type defines how the coordinates passed to \ref setCoords + should be handled and how the QCPItemPosition should behave in the plot. + + The possible values for \a type can be separated in two main categories: + + \li The position is regarded as a point in plot coordinates. This corresponds to \ref ptPlotCoords + and requires two axes that define the plot coordinate system. They can be specified with \ref setAxes. + By default, the QCustomPlot's x- and yAxis are used. + + \li The position is fixed on the QCustomPlot surface, i.e. independent of axis ranges. This + corresponds to all other types, i.e. \ref ptAbsolute, \ref ptViewportRatio and \ref + ptAxisRectRatio. They differ only in the way the absolute position is described, see the + documentation of \ref PositionType for details. For \ref ptAxisRectRatio, note that you can specify + the axis rect with \ref setAxisRect. By default this is set to the main axis rect. + + Note that the position type \ref ptPlotCoords is only available (and sensible) when the position + has no parent anchor (\ref setParentAnchor). + + If the type is changed, the apparent pixel position on the plot is preserved. This means + the coordinates as retrieved with coords() and set with \ref setCoords may change in the process. + + This method sets the type for both X and Y directions. It is also possible to set different types + for X and Y, see \ref setTypeX, \ref setTypeY. +*/ +void QCPItemPosition::setType(QCPItemPosition::PositionType type) +{ + setTypeX(type); + setTypeY(type); +} + +/*! + This method sets the position type of the X coordinate to \a type. + + For a detailed description of what a position type is, see the documentation of \ref setType. + + \see setType, setTypeY +*/ +void QCPItemPosition::setTypeX(QCPItemPosition::PositionType type) +{ + if (mPositionTypeX != type) + { + // if switching from or to coordinate type that isn't valid (e.g. because axes or axis rect + // were deleted), don't try to recover the pixelPosition() because it would output a qDebug warning. + bool retainPixelPosition = true; + if ((mPositionTypeX == ptPlotCoords || type == ptPlotCoords) && (!mKeyAxis || !mValueAxis)) + retainPixelPosition = false; + if ((mPositionTypeX == ptAxisRectRatio || type == ptAxisRectRatio) && (!mAxisRect)) + retainPixelPosition = false; + + QPointF pixel; + if (retainPixelPosition) + pixel = pixelPosition(); + + mPositionTypeX = type; + + if (retainPixelPosition) + setPixelPosition(pixel); + } +} + +/*! + This method sets the position type of the Y coordinate to \a type. + + For a detailed description of what a position type is, see the documentation of \ref setType. + + \see setType, setTypeX +*/ +void QCPItemPosition::setTypeY(QCPItemPosition::PositionType type) +{ + if (mPositionTypeY != type) + { + // if switching from or to coordinate type that isn't valid (e.g. because axes or axis rect + // were deleted), don't try to recover the pixelPosition() because it would output a qDebug warning. + bool retainPixelPosition = true; + if ((mPositionTypeY == ptPlotCoords || type == ptPlotCoords) && (!mKeyAxis || !mValueAxis)) + retainPixelPosition = false; + if ((mPositionTypeY == ptAxisRectRatio || type == ptAxisRectRatio) && (!mAxisRect)) + retainPixelPosition = false; + + QPointF pixel; + if (retainPixelPosition) + pixel = pixelPosition(); + + mPositionTypeY = type; + + if (retainPixelPosition) + setPixelPosition(pixel); + } +} + +/*! + Sets the parent of this QCPItemPosition to \a parentAnchor. This means the position will now + follow any position changes of the anchor. The local coordinate system of positions with a parent + anchor always is absolute pixels, with (0, 0) being exactly on top of the parent anchor. (Hence + the type shouldn't be set to \ref ptPlotCoords for positions with parent anchors.) + + if \a keepPixelPosition is true, the current pixel position of the QCPItemPosition is preserved + during reparenting. If it's set to false, the coordinates are set to (0, 0), i.e. the position + will be exactly on top of the parent anchor. + + To remove this QCPItemPosition from any parent anchor, set \a parentAnchor to 0. + + If the QCPItemPosition previously had no parent and the type is \ref ptPlotCoords, the type is + set to \ref ptAbsolute, to keep the position in a valid state. + + This method sets the parent anchor for both X and Y directions. It is also possible to set + different parents for X and Y, see \ref setParentAnchorX, \ref setParentAnchorY. +*/ +bool QCPItemPosition::setParentAnchor(QCPItemAnchor *parentAnchor, bool keepPixelPosition) +{ + bool successX = setParentAnchorX(parentAnchor, keepPixelPosition); + bool successY = setParentAnchorY(parentAnchor, keepPixelPosition); + return successX && successY; +} + +/*! + This method sets the parent anchor of the X coordinate to \a parentAnchor. + + For a detailed description of what a parent anchor is, see the documentation of \ref setParentAnchor. + + \see setParentAnchor, setParentAnchorY +*/ +bool QCPItemPosition::setParentAnchorX(QCPItemAnchor *parentAnchor, bool keepPixelPosition) +{ + // make sure self is not assigned as parent: + if (parentAnchor == this) + { + qDebug() << Q_FUNC_INFO << "can't set self as parent anchor" << reinterpret_cast(parentAnchor); + return false; + } + // make sure no recursive parent-child-relationships are created: + QCPItemAnchor *currentParent = parentAnchor; + while (currentParent) + { + if (QCPItemPosition *currentParentPos = currentParent->toQCPItemPosition()) + { + // is a QCPItemPosition, might have further parent, so keep iterating + if (currentParentPos == this) + { + qDebug() << Q_FUNC_INFO << "can't create recursive parent-child-relationship" << reinterpret_cast(parentAnchor); + return false; + } + currentParent = currentParentPos->parentAnchorX(); + } else + { + // is a QCPItemAnchor, can't have further parent. Now make sure the parent items aren't the + // same, to prevent a position being child of an anchor which itself depends on the position, + // because they're both on the same item: + if (currentParent->mParentItem == mParentItem) + { + qDebug() << Q_FUNC_INFO << "can't set parent to be an anchor which itself depends on this position" << reinterpret_cast(parentAnchor); + return false; + } + break; + } + } + + // if previously no parent set and PosType is still ptPlotCoords, set to ptAbsolute: + if (!mParentAnchorX && mPositionTypeX == ptPlotCoords) + setTypeX(ptAbsolute); + + // save pixel position: + QPointF pixelP; + if (keepPixelPosition) + pixelP = pixelPosition(); + // unregister at current parent anchor: + if (mParentAnchorX) + mParentAnchorX->removeChildX(this); + // register at new parent anchor: + if (parentAnchor) + parentAnchor->addChildX(this); + mParentAnchorX = parentAnchor; + // restore pixel position under new parent: + if (keepPixelPosition) + setPixelPosition(pixelP); + else + setCoords(0, coords().y()); + return true; +} + +/*! + This method sets the parent anchor of the Y coordinate to \a parentAnchor. + + For a detailed description of what a parent anchor is, see the documentation of \ref setParentAnchor. + + \see setParentAnchor, setParentAnchorX +*/ +bool QCPItemPosition::setParentAnchorY(QCPItemAnchor *parentAnchor, bool keepPixelPosition) +{ + // make sure self is not assigned as parent: + if (parentAnchor == this) + { + qDebug() << Q_FUNC_INFO << "can't set self as parent anchor" << reinterpret_cast(parentAnchor); + return false; + } + // make sure no recursive parent-child-relationships are created: + QCPItemAnchor *currentParent = parentAnchor; + while (currentParent) + { + if (QCPItemPosition *currentParentPos = currentParent->toQCPItemPosition()) + { + // is a QCPItemPosition, might have further parent, so keep iterating + if (currentParentPos == this) + { + qDebug() << Q_FUNC_INFO << "can't create recursive parent-child-relationship" << reinterpret_cast(parentAnchor); + return false; + } + currentParent = currentParentPos->parentAnchorY(); + } else + { + // is a QCPItemAnchor, can't have further parent. Now make sure the parent items aren't the + // same, to prevent a position being child of an anchor which itself depends on the position, + // because they're both on the same item: + if (currentParent->mParentItem == mParentItem) + { + qDebug() << Q_FUNC_INFO << "can't set parent to be an anchor which itself depends on this position" << reinterpret_cast(parentAnchor); + return false; + } + break; + } + } + + // if previously no parent set and PosType is still ptPlotCoords, set to ptAbsolute: + if (!mParentAnchorY && mPositionTypeY == ptPlotCoords) + setTypeY(ptAbsolute); + + // save pixel position: + QPointF pixelP; + if (keepPixelPosition) + pixelP = pixelPosition(); + // unregister at current parent anchor: + if (mParentAnchorY) + mParentAnchorY->removeChildY(this); + // register at new parent anchor: + if (parentAnchor) + parentAnchor->addChildY(this); + mParentAnchorY = parentAnchor; + // restore pixel position under new parent: + if (keepPixelPosition) + setPixelPosition(pixelP); + else + setCoords(coords().x(), 0); + return true; +} + +/*! + Sets the coordinates of this QCPItemPosition. What the coordinates mean, is defined by the type + (\ref setType, \ref setTypeX, \ref setTypeY). + + For example, if the type is \ref ptAbsolute, \a key and \a value mean the x and y pixel position + on the QCustomPlot surface. In that case the origin (0, 0) is in the top left corner of the + QCustomPlot viewport. If the type is \ref ptPlotCoords, \a key and \a value mean a point in the + plot coordinate system defined by the axes set by \ref setAxes. By default those are the + QCustomPlot's xAxis and yAxis. See the documentation of \ref setType for other available + coordinate types and their meaning. + + If different types were configured for X and Y (\ref setTypeX, \ref setTypeY), \a key and \a + value must also be provided in the different coordinate systems. Here, the X type refers to \a + key, and the Y type refers to \a value. + + \see setPixelPosition +*/ +void QCPItemPosition::setCoords(double key, double value) +{ + mKey = key; + mValue = value; +} + +/*! \overload + + Sets the coordinates as a QPointF \a pos where pos.x has the meaning of \a key and pos.y the + meaning of \a value of the \ref setCoords(double key, double value) method. +*/ +void QCPItemPosition::setCoords(const QPointF &pos) +{ + setCoords(pos.x(), pos.y()); +} + +/*! + Returns the final absolute pixel position of the QCPItemPosition on the QCustomPlot surface. It + includes all effects of type (\ref setType) and possible parent anchors (\ref setParentAnchor). + + \see setPixelPosition +*/ +QPointF QCPItemPosition::pixelPosition() const +{ + QPointF result; + + // determine X: + switch (mPositionTypeX) + { + case ptAbsolute: + { + result.rx() = mKey; + if (mParentAnchorX) + result.rx() += mParentAnchorX->pixelPosition().x(); + break; + } + case ptViewportRatio: + { + result.rx() = mKey*mParentPlot->viewport().width(); + if (mParentAnchorX) + result.rx() += mParentAnchorX->pixelPosition().x(); + else + result.rx() += mParentPlot->viewport().left(); + break; + } + case ptAxisRectRatio: + { + if (mAxisRect) + { + result.rx() = mKey*mAxisRect.data()->width(); + if (mParentAnchorX) + result.rx() += mParentAnchorX->pixelPosition().x(); + else + result.rx() += mAxisRect.data()->left(); + } else + qDebug() << Q_FUNC_INFO << "Item position type x is ptAxisRectRatio, but no axis rect was defined"; + break; + } + case ptPlotCoords: + { + if (mKeyAxis && mKeyAxis.data()->orientation() == Qt::Horizontal) + result.rx() = mKeyAxis.data()->coordToPixel(mKey); + else if (mValueAxis && mValueAxis.data()->orientation() == Qt::Horizontal) + result.rx() = mValueAxis.data()->coordToPixel(mValue); + else + qDebug() << Q_FUNC_INFO << "Item position type x is ptPlotCoords, but no axes were defined"; + break; + } + } + + // determine Y: + switch (mPositionTypeY) + { + case ptAbsolute: + { + result.ry() = mValue; + if (mParentAnchorY) + result.ry() += mParentAnchorY->pixelPosition().y(); + break; + } + case ptViewportRatio: + { + result.ry() = mValue*mParentPlot->viewport().height(); + if (mParentAnchorY) + result.ry() += mParentAnchorY->pixelPosition().y(); + else + result.ry() += mParentPlot->viewport().top(); + break; + } + case ptAxisRectRatio: + { + if (mAxisRect) + { + result.ry() = mValue*mAxisRect.data()->height(); + if (mParentAnchorY) + result.ry() += mParentAnchorY->pixelPosition().y(); + else + result.ry() += mAxisRect.data()->top(); + } else + qDebug() << Q_FUNC_INFO << "Item position type y is ptAxisRectRatio, but no axis rect was defined"; + break; + } + case ptPlotCoords: + { + if (mKeyAxis && mKeyAxis.data()->orientation() == Qt::Vertical) + result.ry() = mKeyAxis.data()->coordToPixel(mKey); + else if (mValueAxis && mValueAxis.data()->orientation() == Qt::Vertical) + result.ry() = mValueAxis.data()->coordToPixel(mValue); + else + qDebug() << Q_FUNC_INFO << "Item position type y is ptPlotCoords, but no axes were defined"; + break; + } + } + + return result; +} + +/*! + When \ref setType is \ref ptPlotCoords, this function may be used to specify the axes the + coordinates set with \ref setCoords relate to. By default they are set to the initial xAxis and + yAxis of the QCustomPlot. +*/ +void QCPItemPosition::setAxes(QCPAxis *keyAxis, QCPAxis *valueAxis) +{ + mKeyAxis = keyAxis; + mValueAxis = valueAxis; +} + +/*! + When \ref setType is \ref ptAxisRectRatio, this function may be used to specify the axis rect the + coordinates set with \ref setCoords relate to. By default this is set to the main axis rect of + the QCustomPlot. +*/ +void QCPItemPosition::setAxisRect(QCPAxisRect *axisRect) +{ + mAxisRect = axisRect; +} + +/*! + Sets the apparent pixel position. This works no matter what type (\ref setType) this + QCPItemPosition is or what parent-child situation it is in, as coordinates are transformed + appropriately, to make the position finally appear at the specified pixel values. + + Only if the type is \ref ptAbsolute and no parent anchor is set, this function's effect is + identical to that of \ref setCoords. + + \see pixelPosition, setCoords +*/ +void QCPItemPosition::setPixelPosition(const QPointF &pixelPosition) +{ + double x = pixelPosition.x(); + double y = pixelPosition.y(); + + switch (mPositionTypeX) + { + case ptAbsolute: + { + if (mParentAnchorX) + x -= mParentAnchorX->pixelPosition().x(); + break; + } + case ptViewportRatio: + { + if (mParentAnchorX) + x -= mParentAnchorX->pixelPosition().x(); + else + x -= mParentPlot->viewport().left(); + x /= (double)mParentPlot->viewport().width(); + break; + } + case ptAxisRectRatio: + { + if (mAxisRect) + { + if (mParentAnchorX) + x -= mParentAnchorX->pixelPosition().x(); + else + x -= mAxisRect.data()->left(); + x /= (double)mAxisRect.data()->width(); + } else + qDebug() << Q_FUNC_INFO << "Item position type x is ptAxisRectRatio, but no axis rect was defined"; + break; + } + case ptPlotCoords: + { + if (mKeyAxis && mKeyAxis.data()->orientation() == Qt::Horizontal) + x = mKeyAxis.data()->pixelToCoord(x); + else if (mValueAxis && mValueAxis.data()->orientation() == Qt::Horizontal) + y = mValueAxis.data()->pixelToCoord(x); + else + qDebug() << Q_FUNC_INFO << "Item position type x is ptPlotCoords, but no axes were defined"; + break; + } + } + + switch (mPositionTypeY) + { + case ptAbsolute: + { + if (mParentAnchorY) + y -= mParentAnchorY->pixelPosition().y(); + break; + } + case ptViewportRatio: + { + if (mParentAnchorY) + y -= mParentAnchorY->pixelPosition().y(); + else + y -= mParentPlot->viewport().top(); + y /= (double)mParentPlot->viewport().height(); + break; + } + case ptAxisRectRatio: + { + if (mAxisRect) + { + if (mParentAnchorY) + y -= mParentAnchorY->pixelPosition().y(); + else + y -= mAxisRect.data()->top(); + y /= (double)mAxisRect.data()->height(); + } else + qDebug() << Q_FUNC_INFO << "Item position type y is ptAxisRectRatio, but no axis rect was defined"; + break; + } + case ptPlotCoords: + { + if (mKeyAxis && mKeyAxis.data()->orientation() == Qt::Vertical) + x = mKeyAxis.data()->pixelToCoord(y); + else if (mValueAxis && mValueAxis.data()->orientation() == Qt::Vertical) + y = mValueAxis.data()->pixelToCoord(y); + else + qDebug() << Q_FUNC_INFO << "Item position type y is ptPlotCoords, but no axes were defined"; + break; + } + } + + setCoords(x, y); +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAbstractItem +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPAbstractItem + \brief The abstract base class for all items in a plot. + + In QCustomPlot, items are supplemental graphical elements that are neither plottables + (QCPAbstractPlottable) nor axes (QCPAxis). While plottables are always tied to two axes and thus + plot coordinates, items can also be placed in absolute coordinates independent of any axes. Each + specific item has at least one QCPItemPosition member which controls the positioning. Some items + are defined by more than one coordinate and thus have two or more QCPItemPosition members (For + example, QCPItemRect has \a topLeft and \a bottomRight). + + This abstract base class defines a very basic interface like visibility and clipping. Since this + class is abstract, it can't be instantiated. Use one of the subclasses or create a subclass + yourself to create new items. + + The built-in items are: + + + + + + + + + + +
QCPItemLineA line defined by a start and an end point. May have different ending styles on each side (e.g. arrows).
QCPItemStraightLineA straight line defined by a start and a direction point. Unlike QCPItemLine, the straight line is infinitely long and has no endings.
QCPItemCurveA curve defined by start, end and two intermediate control points. May have different ending styles on each side (e.g. arrows).
QCPItemRectA rectangle
QCPItemEllipseAn ellipse
QCPItemPixmapAn arbitrary pixmap
QCPItemTextA text label
QCPItemBracketA bracket which may be used to reference/highlight certain parts in the plot.
QCPItemTracerAn item that can be attached to a QCPGraph and sticks to its data points, given a key coordinate.
+ + \section items-clipping Clipping + + Items are by default clipped to the main axis rect (they are only visible inside the axis rect). + To make an item visible outside that axis rect, disable clipping via \ref setClipToAxisRect + "setClipToAxisRect(false)". + + On the other hand if you want the item to be clipped to a different axis rect, specify it via + \ref setClipAxisRect. This clipAxisRect property of an item is only used for clipping behaviour, and + in principle is independent of the coordinate axes the item might be tied to via its position + members (\ref QCPItemPosition::setAxes). However, it is common that the axis rect for clipping + also contains the axes used for the item positions. + + \section items-using Using items + + First you instantiate the item you want to use and add it to the plot: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpitemline-creation-1 + by default, the positions of the item are bound to the x- and y-Axis of the plot. So we can just + set the plot coordinates where the line should start/end: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpitemline-creation-2 + If we don't want the line to be positioned in plot coordinates but a different coordinate system, + e.g. absolute pixel positions on the QCustomPlot surface, we need to change the position type like this: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpitemline-creation-3 + Then we can set the coordinates, this time in pixels: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpitemline-creation-4 + and make the line visible on the entire QCustomPlot, by disabling clipping to the axis rect: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpitemline-creation-5 + + For more advanced plots, it is even possible to set different types and parent anchors per X/Y + coordinate of an item position, using for example \ref QCPItemPosition::setTypeX or \ref + QCPItemPosition::setParentAnchorX. For details, see the documentation of \ref QCPItemPosition. + + \section items-subclassing Creating own items + + To create an own item, you implement a subclass of QCPAbstractItem. These are the pure + virtual functions, you must implement: + \li \ref selectTest + \li \ref draw + + See the documentation of those functions for what they need to do. + + \subsection items-positioning Allowing the item to be positioned + + As mentioned, item positions are represented by QCPItemPosition members. Let's assume the new item shall + have only one point as its position (as opposed to two like a rect or multiple like a polygon). You then add + a public member of type QCPItemPosition like so: + + \code QCPItemPosition * const myPosition;\endcode + + the const makes sure the pointer itself can't be modified from the user of your new item (the QCPItemPosition + instance it points to, can be modified, of course). + The initialization of this pointer is made easy with the \ref createPosition function. Just assign + the return value of this function to each QCPItemPosition in the constructor of your item. \ref createPosition + takes a string which is the name of the position, typically this is identical to the variable name. + For example, the constructor of QCPItemExample could look like this: + + \code + QCPItemExample::QCPItemExample(QCustomPlot *parentPlot) : + QCPAbstractItem(parentPlot), + myPosition(createPosition("myPosition")) + { + // other constructor code + } + \endcode + + \subsection items-drawing The draw function + + To give your item a visual representation, reimplement the \ref draw function and use the passed + QCPPainter to draw the item. You can retrieve the item position in pixel coordinates from the + position member(s) via \ref QCPItemPosition::pixelPosition. + + To optimize performance you should calculate a bounding rect first (don't forget to take the pen + width into account), check whether it intersects the \ref clipRect, and only draw the item at all + if this is the case. + + \subsection items-selection The selectTest function + + Your implementation of the \ref selectTest function may use the helpers \ref + QCPVector2D::distanceSquaredToLine and \ref rectDistance. With these, the implementation of the + selection test becomes significantly simpler for most items. See the documentation of \ref + selectTest for what the function parameters mean and what the function should return. + + \subsection anchors Providing anchors + + Providing anchors (QCPItemAnchor) starts off like adding a position. First you create a public + member, e.g. + + \code QCPItemAnchor * const bottom;\endcode + + and create it in the constructor with the \ref createAnchor function, assigning it a name and an + anchor id (an integer enumerating all anchors on the item, you may create an own enum for this). + Since anchors can be placed anywhere, relative to the item's position(s), your item needs to + provide the position of every anchor with the reimplementation of the \ref anchorPixelPosition(int + anchorId) function. + + In essence the QCPItemAnchor is merely an intermediary that itself asks your item for the pixel + position when anything attached to the anchor needs to know the coordinates. +*/ + +/* start of documentation of inline functions */ + +/*! \fn QList QCPAbstractItem::positions() const + + Returns all positions of the item in a list. + + \see anchors, position +*/ + +/*! \fn QList QCPAbstractItem::anchors() const + + Returns all anchors of the item in a list. Note that since a position (QCPItemPosition) is always + also an anchor, the list will also contain the positions of this item. + + \see positions, anchor +*/ + +/* end of documentation of inline functions */ +/* start documentation of pure virtual functions */ + +/*! \fn void QCPAbstractItem::draw(QCPPainter *painter) = 0 + \internal + + Draws this item with the provided \a painter. + + The cliprect of the provided painter is set to the rect returned by \ref clipRect before this + function is called. The clipRect depends on the clipping settings defined by \ref + setClipToAxisRect and \ref setClipAxisRect. +*/ + +/* end documentation of pure virtual functions */ +/* start documentation of signals */ + +/*! \fn void QCPAbstractItem::selectionChanged(bool selected) + This signal is emitted when the selection state of this item has changed, either by user interaction + or by a direct call to \ref setSelected. +*/ + +/* end documentation of signals */ + +/*! + Base class constructor which initializes base class members. +*/ +QCPAbstractItem::QCPAbstractItem(QCustomPlot *parentPlot) : + QCPLayerable(parentPlot), + mClipToAxisRect(false), + mSelectable(true), + mSelected(false) +{ + parentPlot->registerItem(this); + + QList rects = parentPlot->axisRects(); + if (rects.size() > 0) + { + setClipToAxisRect(true); + setClipAxisRect(rects.first()); + } +} + +QCPAbstractItem::~QCPAbstractItem() +{ + // don't delete mPositions because every position is also an anchor and thus in mAnchors + qDeleteAll(mAnchors); +} + +/* can't make this a header inline function, because QPointer breaks with forward declared types, see QTBUG-29588 */ +QCPAxisRect *QCPAbstractItem::clipAxisRect() const +{ + return mClipAxisRect.data(); +} + +/*! + Sets whether the item shall be clipped to an axis rect or whether it shall be visible on the + entire QCustomPlot. The axis rect can be set with \ref setClipAxisRect. + + \see setClipAxisRect +*/ +void QCPAbstractItem::setClipToAxisRect(bool clip) +{ + mClipToAxisRect = clip; + if (mClipToAxisRect) + setParentLayerable(mClipAxisRect.data()); +} + +/*! + Sets the clip axis rect. It defines the rect that will be used to clip the item when \ref + setClipToAxisRect is set to true. + + \see setClipToAxisRect +*/ +void QCPAbstractItem::setClipAxisRect(QCPAxisRect *rect) +{ + mClipAxisRect = rect; + if (mClipToAxisRect) + setParentLayerable(mClipAxisRect.data()); +} + +/*! + Sets whether the user can (de-)select this item by clicking on the QCustomPlot surface. + (When \ref QCustomPlot::setInteractions contains QCustomPlot::iSelectItems.) + + However, even when \a selectable was set to false, it is possible to set the selection manually, + by calling \ref setSelected. + + \see QCustomPlot::setInteractions, setSelected +*/ +void QCPAbstractItem::setSelectable(bool selectable) +{ + if (mSelectable != selectable) + { + mSelectable = selectable; + emit selectableChanged(mSelectable); + } +} + +/*! + Sets whether this item is selected or not. When selected, it might use a different visual + appearance (e.g. pen and brush), this depends on the specific item though. + + The entire selection mechanism for items is handled automatically when \ref + QCustomPlot::setInteractions contains QCustomPlot::iSelectItems. You only need to call this + function when you wish to change the selection state manually. + + This function can change the selection state even when \ref setSelectable was set to false. + + emits the \ref selectionChanged signal when \a selected is different from the previous selection state. + + \see setSelectable, selectTest +*/ +void QCPAbstractItem::setSelected(bool selected) +{ + if (mSelected != selected) + { + mSelected = selected; + emit selectionChanged(mSelected); + } +} + +/*! + Returns the QCPItemPosition with the specified \a name. If this item doesn't have a position by + that name, returns 0. + + This function provides an alternative way to access item positions. Normally, you access + positions direcly by their member pointers (which typically have the same variable name as \a + name). + + \see positions, anchor +*/ +QCPItemPosition *QCPAbstractItem::position(const QString &name) const +{ + for (int i=0; iname() == name) + return mPositions.at(i); + } + qDebug() << Q_FUNC_INFO << "position with name not found:" << name; + return 0; +} + +/*! + Returns the QCPItemAnchor with the specified \a name. If this item doesn't have an anchor by + that name, returns 0. + + This function provides an alternative way to access item anchors. Normally, you access + anchors direcly by their member pointers (which typically have the same variable name as \a + name). + + \see anchors, position +*/ +QCPItemAnchor *QCPAbstractItem::anchor(const QString &name) const +{ + for (int i=0; iname() == name) + return mAnchors.at(i); + } + qDebug() << Q_FUNC_INFO << "anchor with name not found:" << name; + return 0; +} + +/*! + Returns whether this item has an anchor with the specified \a name. + + Note that you can check for positions with this function, too. This is because every position is + also an anchor (QCPItemPosition inherits from QCPItemAnchor). + + \see anchor, position +*/ +bool QCPAbstractItem::hasAnchor(const QString &name) const +{ + for (int i=0; iname() == name) + return true; + } + return false; +} + +/*! \internal + + Returns the rect the visual representation of this item is clipped to. This depends on the + current setting of \ref setClipToAxisRect as well as the axis rect set with \ref setClipAxisRect. + + If the item is not clipped to an axis rect, QCustomPlot's viewport rect is returned. + + \see draw +*/ +QRect QCPAbstractItem::clipRect() const +{ + if (mClipToAxisRect && mClipAxisRect) + return mClipAxisRect.data()->rect(); + else + return mParentPlot->viewport(); +} + +/*! \internal + + A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter + before drawing item lines. + + This is the antialiasing state the painter passed to the \ref draw method is in by default. + + This function takes into account the local setting of the antialiasing flag as well as the + overrides set with \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. + + \see setAntialiased +*/ +void QCPAbstractItem::applyDefaultAntialiasingHint(QCPPainter *painter) const +{ + applyAntialiasingHint(painter, mAntialiased, QCP::aeItems); +} + +/*! \internal + + A convenience function which returns the selectTest value for a specified \a rect and a specified + click position \a pos. \a filledRect defines whether a click inside the rect should also be + considered a hit or whether only the rect border is sensitive to hits. + + This function may be used to help with the implementation of the \ref selectTest function for + specific items. + + For example, if your item consists of four rects, call this function four times, once for each + rect, in your \ref selectTest reimplementation. Finally, return the minimum (non -1) of all four + returned values. +*/ +double QCPAbstractItem::rectDistance(const QRectF &rect, const QPointF &pos, bool filledRect) const +{ + double result = -1; + + // distance to border: + QList lines; + lines << QLineF(rect.topLeft(), rect.topRight()) << QLineF(rect.bottomLeft(), rect.bottomRight()) + << QLineF(rect.topLeft(), rect.bottomLeft()) << QLineF(rect.topRight(), rect.bottomRight()); + double minDistSqr = (std::numeric_limits::max)(); + for (int i=0; i mParentPlot->selectionTolerance()*0.99) + { + if (rect.contains(pos)) + result = mParentPlot->selectionTolerance()*0.99; + } + return result; +} + +/*! \internal + + Returns the pixel position of the anchor with Id \a anchorId. This function must be reimplemented in + item subclasses if they want to provide anchors (QCPItemAnchor). + + For example, if the item has two anchors with id 0 and 1, this function takes one of these anchor + ids and returns the respective pixel points of the specified anchor. + + \see createAnchor +*/ +QPointF QCPAbstractItem::anchorPixelPosition(int anchorId) const +{ + qDebug() << Q_FUNC_INFO << "called on item which shouldn't have any anchors (this method not reimplemented). anchorId" << anchorId; + return QPointF(); +} + +/*! \internal + + Creates a QCPItemPosition, registers it with this item and returns a pointer to it. The specified + \a name must be a unique string that is usually identical to the variable name of the position + member (This is needed to provide the name-based \ref position access to positions). + + Don't delete positions created by this function manually, as the item will take care of it. + + Use this function in the constructor (initialization list) of the specific item subclass to + create each position member. Don't create QCPItemPositions with \b new yourself, because they + won't be registered with the item properly. + + \see createAnchor +*/ +QCPItemPosition *QCPAbstractItem::createPosition(const QString &name) +{ + if (hasAnchor(name)) + qDebug() << Q_FUNC_INFO << "anchor/position with name exists already:" << name; + QCPItemPosition *newPosition = new QCPItemPosition(mParentPlot, this, name); + mPositions.append(newPosition); + mAnchors.append(newPosition); // every position is also an anchor + newPosition->setAxes(mParentPlot->xAxis, mParentPlot->yAxis); + newPosition->setType(QCPItemPosition::ptPlotCoords); + if (mParentPlot->axisRect()) + newPosition->setAxisRect(mParentPlot->axisRect()); + newPosition->setCoords(0, 0); + return newPosition; +} + +/*! \internal + + Creates a QCPItemAnchor, registers it with this item and returns a pointer to it. The specified + \a name must be a unique string that is usually identical to the variable name of the anchor + member (This is needed to provide the name based \ref anchor access to anchors). + + The \a anchorId must be a number identifying the created anchor. It is recommended to create an + enum (e.g. "AnchorIndex") for this on each item that uses anchors. This id is used by the anchor + to identify itself when it calls QCPAbstractItem::anchorPixelPosition. That function then returns + the correct pixel coordinates for the passed anchor id. + + Don't delete anchors created by this function manually, as the item will take care of it. + + Use this function in the constructor (initialization list) of the specific item subclass to + create each anchor member. Don't create QCPItemAnchors with \b new yourself, because then they + won't be registered with the item properly. + + \see createPosition +*/ +QCPItemAnchor *QCPAbstractItem::createAnchor(const QString &name, int anchorId) +{ + if (hasAnchor(name)) + qDebug() << Q_FUNC_INFO << "anchor/position with name exists already:" << name; + QCPItemAnchor *newAnchor = new QCPItemAnchor(mParentPlot, this, name, anchorId); + mAnchors.append(newAnchor); + return newAnchor; +} + +/* inherits documentation from base class */ +void QCPAbstractItem::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) +{ + Q_UNUSED(event) + Q_UNUSED(details) + if (mSelectable) + { + bool selBefore = mSelected; + setSelected(additive ? !mSelected : true); + if (selectionStateChanged) + *selectionStateChanged = mSelected != selBefore; + } +} + +/* inherits documentation from base class */ +void QCPAbstractItem::deselectEvent(bool *selectionStateChanged) +{ + if (mSelectable) + { + bool selBefore = mSelected; + setSelected(false); + if (selectionStateChanged) + *selectionStateChanged = mSelected != selBefore; + } +} + +/* inherits documentation from base class */ +QCP::Interaction QCPAbstractItem::selectionCategory() const +{ + return QCP::iSelectItems; +} +/* end of 'src/item.cpp' */ + + +/* including file 'src/core.cpp', size 126207 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCustomPlot +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCustomPlot + + \brief The central class of the library. This is the QWidget which displays the plot and + interacts with the user. + + For tutorials on how to use QCustomPlot, see the website\n + http://www.qcustomplot.com/ +*/ + +/* start of documentation of inline functions */ + +/*! \fn QCPSelectionRect *QCustomPlot::selectionRect() const + + Allows access to the currently used QCPSelectionRect instance (or subclass thereof), that is used + to handle and draw selection rect interactions (see \ref setSelectionRectMode). + + \see setSelectionRect +*/ + +/*! \fn QCPLayoutGrid *QCustomPlot::plotLayout() const + + Returns the top level layout of this QCustomPlot instance. It is a \ref QCPLayoutGrid, initially containing just + one cell with the main QCPAxisRect inside. +*/ + +/* end of documentation of inline functions */ +/* start of documentation of signals */ + +/*! \fn void QCustomPlot::mouseDoubleClick(QMouseEvent *event) + + This signal is emitted when the QCustomPlot receives a mouse double click event. +*/ + +/*! \fn void QCustomPlot::mousePress(QMouseEvent *event) + + This signal is emitted when the QCustomPlot receives a mouse press event. + + It is emitted before QCustomPlot handles any other mechanism like range dragging. So a slot + connected to this signal can still influence the behaviour e.g. with \ref QCPAxisRect::setRangeDrag or \ref + QCPAxisRect::setRangeDragAxes. +*/ + +/*! \fn void QCustomPlot::mouseMove(QMouseEvent *event) + + This signal is emitted when the QCustomPlot receives a mouse move event. + + It is emitted before QCustomPlot handles any other mechanism like range dragging. So a slot + connected to this signal can still influence the behaviour e.g. with \ref QCPAxisRect::setRangeDrag or \ref + QCPAxisRect::setRangeDragAxes. + + \warning It is discouraged to change the drag-axes with \ref QCPAxisRect::setRangeDragAxes here, + because the dragging starting point was saved the moment the mouse was pressed. Thus it only has + a meaning for the range drag axes that were set at that moment. If you want to change the drag + axes, consider doing this in the \ref mousePress signal instead. +*/ + +/*! \fn void QCustomPlot::mouseRelease(QMouseEvent *event) + + This signal is emitted when the QCustomPlot receives a mouse release event. + + It is emitted before QCustomPlot handles any other mechanisms like object selection. So a + slot connected to this signal can still influence the behaviour e.g. with \ref setInteractions or + \ref QCPAbstractPlottable::setSelectable. +*/ + +/*! \fn void QCustomPlot::mouseWheel(QMouseEvent *event) + + This signal is emitted when the QCustomPlot receives a mouse wheel event. + + It is emitted before QCustomPlot handles any other mechanisms like range zooming. So a slot + connected to this signal can still influence the behaviour e.g. with \ref QCPAxisRect::setRangeZoom, \ref + QCPAxisRect::setRangeZoomAxes or \ref QCPAxisRect::setRangeZoomFactor. +*/ + +/*! \fn void QCustomPlot::plottableClick(QCPAbstractPlottable *plottable, int dataIndex, QMouseEvent *event) + + This signal is emitted when a plottable is clicked. + + \a event is the mouse event that caused the click and \a plottable is the plottable that received + the click. The parameter \a dataIndex indicates the data point that was closest to the click + position. + + \see plottableDoubleClick +*/ + +/*! \fn void QCustomPlot::plottableDoubleClick(QCPAbstractPlottable *plottable, int dataIndex, QMouseEvent *event) + + This signal is emitted when a plottable is double clicked. + + \a event is the mouse event that caused the click and \a plottable is the plottable that received + the click. The parameter \a dataIndex indicates the data point that was closest to the click + position. + + \see plottableClick +*/ + +/*! \fn void QCustomPlot::itemClick(QCPAbstractItem *item, QMouseEvent *event) + + This signal is emitted when an item is clicked. + + \a event is the mouse event that caused the click and \a item is the item that received the + click. + + \see itemDoubleClick +*/ + +/*! \fn void QCustomPlot::itemDoubleClick(QCPAbstractItem *item, QMouseEvent *event) + + This signal is emitted when an item is double clicked. + + \a event is the mouse event that caused the click and \a item is the item that received the + click. + + \see itemClick +*/ + +/*! \fn void QCustomPlot::axisClick(QCPAxis *axis, QCPAxis::SelectablePart part, QMouseEvent *event) + + This signal is emitted when an axis is clicked. + + \a event is the mouse event that caused the click, \a axis is the axis that received the click and + \a part indicates the part of the axis that was clicked. + + \see axisDoubleClick +*/ + +/*! \fn void QCustomPlot::axisDoubleClick(QCPAxis *axis, QCPAxis::SelectablePart part, QMouseEvent *event) + + This signal is emitted when an axis is double clicked. + + \a event is the mouse event that caused the click, \a axis is the axis that received the click and + \a part indicates the part of the axis that was clicked. + + \see axisClick +*/ + +/*! \fn void QCustomPlot::legendClick(QCPLegend *legend, QCPAbstractLegendItem *item, QMouseEvent *event) + + This signal is emitted when a legend (item) is clicked. + + \a event is the mouse event that caused the click, \a legend is the legend that received the + click and \a item is the legend item that received the click. If only the legend and no item is + clicked, \a item is 0. This happens for a click inside the legend padding or the space between + two items. + + \see legendDoubleClick +*/ + +/*! \fn void QCustomPlot::legendDoubleClick(QCPLegend *legend, QCPAbstractLegendItem *item, QMouseEvent *event) + + This signal is emitted when a legend (item) is double clicked. + + \a event is the mouse event that caused the click, \a legend is the legend that received the + click and \a item is the legend item that received the click. If only the legend and no item is + clicked, \a item is 0. This happens for a click inside the legend padding or the space between + two items. + + \see legendClick +*/ + +/*! \fn void QCustomPlot::selectionChangedByUser() + + This signal is emitted after the user has changed the selection in the QCustomPlot, e.g. by + clicking. It is not emitted when the selection state of an object has changed programmatically by + a direct call to setSelected()/setSelection() on an object or by calling \ref + deselectAll. + + In addition to this signal, selectable objects also provide individual signals, for example \ref + QCPAxis::selectionChanged or \ref QCPAbstractPlottable::selectionChanged. Note that those signals + are emitted even if the selection state is changed programmatically. + + See the documentation of \ref setInteractions for details about the selection mechanism. + + \see selectedPlottables, selectedGraphs, selectedItems, selectedAxes, selectedLegends +*/ + +/*! \fn void QCustomPlot::beforeReplot() + + This signal is emitted immediately before a replot takes place (caused by a call to the slot \ref + replot). + + It is safe to mutually connect the replot slot with this signal on two QCustomPlots to make them + replot synchronously, it won't cause an infinite recursion. + + \see replot, afterReplot +*/ + +/*! \fn void QCustomPlot::afterReplot() + + This signal is emitted immediately after a replot has taken place (caused by a call to the slot \ref + replot). + + It is safe to mutually connect the replot slot with this signal on two QCustomPlots to make them + replot synchronously, it won't cause an infinite recursion. + + \see replot, beforeReplot +*/ + +/* end of documentation of signals */ +/* start of documentation of public members */ + +/*! \var QCPAxis *QCustomPlot::xAxis + + A pointer to the primary x Axis (bottom) of the main axis rect of the plot. + + QCustomPlot offers convenient pointers to the axes (\ref xAxis, \ref yAxis, \ref xAxis2, \ref + yAxis2) and the \ref legend. They make it very easy working with plots that only have a single + axis rect and at most one axis at each axis rect side. If you use \link thelayoutsystem the + layout system\endlink to add multiple axis rects or multiple axes to one side, use the \ref + QCPAxisRect::axis interface to access the new axes. If one of the four default axes or the + default legend is removed due to manipulation of the layout system (e.g. by removing the main + axis rect), the corresponding pointers become 0. + + If an axis convenience pointer is currently zero and a new axis rect or a corresponding axis is + added in the place of the main axis rect, QCustomPlot resets the convenience pointers to the + according new axes. Similarly the \ref legend convenience pointer will be reset if a legend is + added after the main legend was removed before. +*/ + +/*! \var QCPAxis *QCustomPlot::yAxis + + A pointer to the primary y Axis (left) of the main axis rect of the plot. + + QCustomPlot offers convenient pointers to the axes (\ref xAxis, \ref yAxis, \ref xAxis2, \ref + yAxis2) and the \ref legend. They make it very easy working with plots that only have a single + axis rect and at most one axis at each axis rect side. If you use \link thelayoutsystem the + layout system\endlink to add multiple axis rects or multiple axes to one side, use the \ref + QCPAxisRect::axis interface to access the new axes. If one of the four default axes or the + default legend is removed due to manipulation of the layout system (e.g. by removing the main + axis rect), the corresponding pointers become 0. + + If an axis convenience pointer is currently zero and a new axis rect or a corresponding axis is + added in the place of the main axis rect, QCustomPlot resets the convenience pointers to the + according new axes. Similarly the \ref legend convenience pointer will be reset if a legend is + added after the main legend was removed before. +*/ + +/*! \var QCPAxis *QCustomPlot::xAxis2 + + A pointer to the secondary x Axis (top) of the main axis rect of the plot. Secondary axes are + invisible by default. Use QCPAxis::setVisible to change this (or use \ref + QCPAxisRect::setupFullAxesBox). + + QCustomPlot offers convenient pointers to the axes (\ref xAxis, \ref yAxis, \ref xAxis2, \ref + yAxis2) and the \ref legend. They make it very easy working with plots that only have a single + axis rect and at most one axis at each axis rect side. If you use \link thelayoutsystem the + layout system\endlink to add multiple axis rects or multiple axes to one side, use the \ref + QCPAxisRect::axis interface to access the new axes. If one of the four default axes or the + default legend is removed due to manipulation of the layout system (e.g. by removing the main + axis rect), the corresponding pointers become 0. + + If an axis convenience pointer is currently zero and a new axis rect or a corresponding axis is + added in the place of the main axis rect, QCustomPlot resets the convenience pointers to the + according new axes. Similarly the \ref legend convenience pointer will be reset if a legend is + added after the main legend was removed before. +*/ + +/*! \var QCPAxis *QCustomPlot::yAxis2 + + A pointer to the secondary y Axis (right) of the main axis rect of the plot. Secondary axes are + invisible by default. Use QCPAxis::setVisible to change this (or use \ref + QCPAxisRect::setupFullAxesBox). + + QCustomPlot offers convenient pointers to the axes (\ref xAxis, \ref yAxis, \ref xAxis2, \ref + yAxis2) and the \ref legend. They make it very easy working with plots that only have a single + axis rect and at most one axis at each axis rect side. If you use \link thelayoutsystem the + layout system\endlink to add multiple axis rects or multiple axes to one side, use the \ref + QCPAxisRect::axis interface to access the new axes. If one of the four default axes or the + default legend is removed due to manipulation of the layout system (e.g. by removing the main + axis rect), the corresponding pointers become 0. + + If an axis convenience pointer is currently zero and a new axis rect or a corresponding axis is + added in the place of the main axis rect, QCustomPlot resets the convenience pointers to the + according new axes. Similarly the \ref legend convenience pointer will be reset if a legend is + added after the main legend was removed before. +*/ + +/*! \var QCPLegend *QCustomPlot::legend + + A pointer to the default legend of the main axis rect. The legend is invisible by default. Use + QCPLegend::setVisible to change this. + + QCustomPlot offers convenient pointers to the axes (\ref xAxis, \ref yAxis, \ref xAxis2, \ref + yAxis2) and the \ref legend. They make it very easy working with plots that only have a single + axis rect and at most one axis at each axis rect side. If you use \link thelayoutsystem the + layout system\endlink to add multiple legends to the plot, use the layout system interface to + access the new legend. For example, legends can be placed inside an axis rect's \ref + QCPAxisRect::insetLayout "inset layout", and must then also be accessed via the inset layout. If + the default legend is removed due to manipulation of the layout system (e.g. by removing the main + axis rect), the corresponding pointer becomes 0. + + If an axis convenience pointer is currently zero and a new axis rect or a corresponding axis is + added in the place of the main axis rect, QCustomPlot resets the convenience pointers to the + according new axes. Similarly the \ref legend convenience pointer will be reset if a legend is + added after the main legend was removed before. +*/ + +/* end of documentation of public members */ + +/*! + Constructs a QCustomPlot and sets reasonable default values. +*/ +QCustomPlot::QCustomPlot(QWidget *parent) : + QWidget(parent), + xAxis(0), + yAxis(0), + xAxis2(0), + yAxis2(0), + legend(0), + mBufferDevicePixelRatio(1.0), // will be adapted to primary screen below + mPlotLayout(0), + mAutoAddPlottableToLegend(true), + mAntialiasedElements(QCP::aeNone), + mNotAntialiasedElements(QCP::aeNone), + mInteractions(0), + mSelectionTolerance(8), + mNoAntialiasingOnDrag(false), + mBackgroundBrush(Qt::white, Qt::SolidPattern), + mBackgroundScaled(true), + mBackgroundScaledMode(Qt::KeepAspectRatioByExpanding), + mCurrentLayer(0), + mPlottingHints(QCP::phCacheLabels|QCP::phImmediateRefresh), + mMultiSelectModifier(Qt::ControlModifier), + mSelectionRectMode(QCP::srmNone), + mSelectionRect(0), + mOpenGl(false), + mMouseHasMoved(false), + mMouseEventLayerable(0), + mMouseSignalLayerable(0), + mReplotting(false), + mReplotQueued(false), + mOpenGlMultisamples(16), + mOpenGlAntialiasedElementsBackup(QCP::aeNone), + mOpenGlCacheLabelsBackup(true) +{ + setAttribute(Qt::WA_NoMousePropagation); + setAttribute(Qt::WA_OpaquePaintEvent); + setFocusPolicy(Qt::ClickFocus); + setMouseTracking(true); + QLocale currentLocale = locale(); + currentLocale.setNumberOptions(QLocale::OmitGroupSeparator); + setLocale(currentLocale); +#ifdef QCP_DEVICEPIXELRATIO_SUPPORTED +# ifdef QCP_DEVICEPIXELRATIO_FLOAT + setBufferDevicePixelRatio(QWidget::devicePixelRatioF()); +# else + setBufferDevicePixelRatio(QWidget::devicePixelRatio()); +# endif +#endif + + mOpenGlAntialiasedElementsBackup = mAntialiasedElements; + mOpenGlCacheLabelsBackup = mPlottingHints.testFlag(QCP::phCacheLabels); + // create initial layers: + 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"))); + updateLayerIndices(); + setCurrentLayer(QLatin1String("main")); + layer(QLatin1String("overlay"))->setMode(QCPLayer::lmBuffered); + + // create initial layout, axis rect and legend: + mPlotLayout = new QCPLayoutGrid; + mPlotLayout->initializeParentPlot(this); + mPlotLayout->setParent(this); // important because if parent is QWidget, QCPLayout::sizeConstraintsChanged will call QWidget::updateGeometry + mPlotLayout->setLayer(QLatin1String("main")); + QCPAxisRect *defaultAxisRect = new QCPAxisRect(this, true); + mPlotLayout->addElement(0, 0, defaultAxisRect); + xAxis = defaultAxisRect->axis(QCPAxis::atBottom); + yAxis = defaultAxisRect->axis(QCPAxis::atLeft); + xAxis2 = defaultAxisRect->axis(QCPAxis::atTop); + yAxis2 = defaultAxisRect->axis(QCPAxis::atRight); + legend = new QCPLegend; + legend->setVisible(false); + defaultAxisRect->insetLayout()->addElement(legend, Qt::AlignRight|Qt::AlignTop); + defaultAxisRect->insetLayout()->setMargins(QMargins(12, 12, 12, 12)); + + defaultAxisRect->setLayer(QLatin1String("background")); + xAxis->setLayer(QLatin1String("axes")); + yAxis->setLayer(QLatin1String("axes")); + xAxis2->setLayer(QLatin1String("axes")); + yAxis2->setLayer(QLatin1String("axes")); + xAxis->grid()->setLayer(QLatin1String("grid")); + yAxis->grid()->setLayer(QLatin1String("grid")); + xAxis2->grid()->setLayer(QLatin1String("grid")); + yAxis2->grid()->setLayer(QLatin1String("grid")); + legend->setLayer(QLatin1String("legend")); + + // create selection rect instance: + mSelectionRect = new QCPSelectionRect(this); + mSelectionRect->setLayer(QLatin1String("overlay")); + + setViewport(rect()); // needs to be called after mPlotLayout has been created + + replot(rpQueuedReplot); +} + +QCustomPlot::~QCustomPlot() +{ + clearPlottables(); + clearItems(); + + if (mPlotLayout) + { + delete mPlotLayout; + mPlotLayout = 0; + } + + mCurrentLayer = 0; + qDeleteAll(mLayers); // don't use removeLayer, because it would prevent the last layer to be removed + mLayers.clear(); +} + +/*! + Sets which elements are forcibly drawn antialiased as an \a or combination of QCP::AntialiasedElement. + + This overrides the antialiasing settings for whole element groups, normally controlled with the + \a setAntialiasing function on the individual elements. If an element is neither specified in + \ref setAntialiasedElements nor in \ref setNotAntialiasedElements, the antialiasing setting on + each individual element instance is used. + + For example, if \a antialiasedElements contains \ref QCP::aePlottables, all plottables will be + drawn antialiased, no matter what the specific QCPAbstractPlottable::setAntialiased value was set + to. + + if an element in \a antialiasedElements is already set in \ref setNotAntialiasedElements, it is + removed from there. + + \see setNotAntialiasedElements +*/ +void QCustomPlot::setAntialiasedElements(const QCP::AntialiasedElements &antialiasedElements) +{ + mAntialiasedElements = antialiasedElements; + + // make sure elements aren't in mNotAntialiasedElements and mAntialiasedElements simultaneously: + if ((mNotAntialiasedElements & mAntialiasedElements) != 0) + mNotAntialiasedElements |= ~mAntialiasedElements; +} + +/*! + Sets whether the specified \a antialiasedElement is forcibly drawn antialiased. + + See \ref setAntialiasedElements for details. + + \see setNotAntialiasedElement +*/ +void QCustomPlot::setAntialiasedElement(QCP::AntialiasedElement antialiasedElement, bool enabled) +{ + if (!enabled && mAntialiasedElements.testFlag(antialiasedElement)) + mAntialiasedElements &= ~antialiasedElement; + else if (enabled && !mAntialiasedElements.testFlag(antialiasedElement)) + mAntialiasedElements |= antialiasedElement; + + // make sure elements aren't in mNotAntialiasedElements and mAntialiasedElements simultaneously: + if ((mNotAntialiasedElements & mAntialiasedElements) != 0) + mNotAntialiasedElements |= ~mAntialiasedElements; +} + +/*! + Sets which elements are forcibly drawn not antialiased as an \a or combination of + QCP::AntialiasedElement. + + This overrides the antialiasing settings for whole element groups, normally controlled with the + \a setAntialiasing function on the individual elements. If an element is neither specified in + \ref setAntialiasedElements nor in \ref setNotAntialiasedElements, the antialiasing setting on + each individual element instance is used. + + For example, if \a notAntialiasedElements contains \ref QCP::aePlottables, no plottables will be + drawn antialiased, no matter what the specific QCPAbstractPlottable::setAntialiased value was set + to. + + if an element in \a notAntialiasedElements is already set in \ref setAntialiasedElements, it is + removed from there. + + \see setAntialiasedElements +*/ +void QCustomPlot::setNotAntialiasedElements(const QCP::AntialiasedElements ¬AntialiasedElements) +{ + mNotAntialiasedElements = notAntialiasedElements; + + // make sure elements aren't in mNotAntialiasedElements and mAntialiasedElements simultaneously: + if ((mNotAntialiasedElements & mAntialiasedElements) != 0) + mAntialiasedElements |= ~mNotAntialiasedElements; +} + +/*! + Sets whether the specified \a notAntialiasedElement is forcibly drawn not antialiased. + + See \ref setNotAntialiasedElements for details. + + \see setAntialiasedElement +*/ +void QCustomPlot::setNotAntialiasedElement(QCP::AntialiasedElement notAntialiasedElement, bool enabled) +{ + if (!enabled && mNotAntialiasedElements.testFlag(notAntialiasedElement)) + mNotAntialiasedElements &= ~notAntialiasedElement; + else if (enabled && !mNotAntialiasedElements.testFlag(notAntialiasedElement)) + mNotAntialiasedElements |= notAntialiasedElement; + + // make sure elements aren't in mNotAntialiasedElements and mAntialiasedElements simultaneously: + if ((mNotAntialiasedElements & mAntialiasedElements) != 0) + mAntialiasedElements |= ~mNotAntialiasedElements; +} + +/*! + If set to true, adding a plottable (e.g. a graph) to the QCustomPlot automatically also adds the + plottable to the legend (QCustomPlot::legend). + + \see addGraph, QCPLegend::addItem +*/ +void QCustomPlot::setAutoAddPlottableToLegend(bool on) +{ + mAutoAddPlottableToLegend = on; +} + +/*! + Sets the possible interactions of this QCustomPlot as an or-combination of \ref QCP::Interaction + enums. There are the following types of interactions: + + Axis range manipulation is controlled via \ref QCP::iRangeDrag and \ref QCP::iRangeZoom. When the + respective interaction is enabled, the user may drag axes ranges and zoom with the mouse wheel. + For details how to control which axes the user may drag/zoom and in what orientations, see \ref + QCPAxisRect::setRangeDrag, \ref QCPAxisRect::setRangeZoom, \ref QCPAxisRect::setRangeDragAxes, + \ref QCPAxisRect::setRangeZoomAxes. + + Plottable data selection is controlled by \ref QCP::iSelectPlottables. If \ref + QCP::iSelectPlottables is set, the user may select plottables (graphs, curves, bars,...) and + their data by clicking on them or in their vicinity (\ref setSelectionTolerance). Whether the + user can actually select a plottable and its data can further be restricted with the \ref + QCPAbstractPlottable::setSelectable method on the specific plottable. For details, see the + special page about the \ref dataselection "data selection mechanism". To retrieve a list of all + currently selected plottables, call \ref selectedPlottables. If you're only interested in + QCPGraphs, you may use the convenience function \ref selectedGraphs. + + Item selection is controlled by \ref QCP::iSelectItems. If \ref QCP::iSelectItems is set, the user + may select items (QCPItemLine, QCPItemText,...) by clicking on them or in their vicinity. To find + out whether a specific item is selected, call QCPAbstractItem::selected(). To retrieve a list of + all currently selected items, call \ref selectedItems. + + Axis selection is controlled with \ref QCP::iSelectAxes. If \ref QCP::iSelectAxes is set, the user + may select parts of the axes by clicking on them. What parts exactly (e.g. Axis base line, tick + labels, axis label) are selectable can be controlled via \ref QCPAxis::setSelectableParts for + each axis. To retrieve a list of all axes that currently contain selected parts, call \ref + selectedAxes. Which parts of an axis are selected, can be retrieved with QCPAxis::selectedParts(). + + Legend selection is controlled with \ref QCP::iSelectLegend. If this is set, the user may + select the legend itself or individual items by clicking on them. What parts exactly are + selectable can be controlled via \ref QCPLegend::setSelectableParts. To find out whether the + legend or any of its child items are selected, check the value of QCPLegend::selectedParts. To + find out which child items are selected, call \ref QCPLegend::selectedItems. + + All other selectable elements The selection of all other selectable objects (e.g. + QCPTextElement, or your own layerable subclasses) is controlled with \ref QCP::iSelectOther. If set, the + user may select those objects by clicking on them. To find out which are currently selected, you + need to check their selected state explicitly. + + If the selection state has changed by user interaction, the \ref selectionChangedByUser signal is + emitted. Each selectable object additionally emits an individual selectionChanged signal whenever + their selection state has changed, i.e. not only by user interaction. + + To allow multiple objects to be selected by holding the selection modifier (\ref + setMultiSelectModifier), set the flag \ref QCP::iMultiSelect. + + \note In addition to the selection mechanism presented here, QCustomPlot always emits + corresponding signals, when an object is clicked or double clicked. see \ref plottableClick and + \ref plottableDoubleClick for example. + + \see setInteraction, setSelectionTolerance +*/ +void QCustomPlot::setInteractions(const QCP::Interactions &interactions) +{ + mInteractions = interactions; +} + +/*! + Sets the single \a interaction of this QCustomPlot to \a enabled. + + For details about the interaction system, see \ref setInteractions. + + \see setInteractions +*/ +void QCustomPlot::setInteraction(const QCP::Interaction &interaction, bool enabled) +{ + if (!enabled && mInteractions.testFlag(interaction)) + mInteractions &= ~interaction; + else if (enabled && !mInteractions.testFlag(interaction)) + mInteractions |= interaction; +} + +/*! + Sets the tolerance that is used to decide whether a click selects an object (e.g. a plottable) or + not. + + If the user clicks in the vicinity of the line of e.g. a QCPGraph, it's only regarded as a + potential selection when the minimum distance between the click position and the graph line is + smaller than \a pixels. Objects that are defined by an area (e.g. QCPBars) only react to clicks + directly inside the area and ignore this selection tolerance. In other words, it only has meaning + for parts of objects that are too thin to exactly hit with a click and thus need such a + tolerance. + + \see setInteractions, QCPLayerable::selectTest +*/ +void QCustomPlot::setSelectionTolerance(int pixels) +{ + mSelectionTolerance = pixels; +} + +/*! + Sets whether antialiasing is disabled for this QCustomPlot while the user is dragging axes + ranges. If many objects, especially plottables, are drawn antialiased, this greatly improves + performance during dragging. Thus it creates a more responsive user experience. As soon as the + user stops dragging, the last replot is done with normal antialiasing, to restore high image + quality. + + \see setAntialiasedElements, setNotAntialiasedElements +*/ +void QCustomPlot::setNoAntialiasingOnDrag(bool enabled) +{ + mNoAntialiasingOnDrag = enabled; +} + +/*! + Sets the plotting hints for this QCustomPlot instance as an \a or combination of QCP::PlottingHint. + + \see setPlottingHint +*/ +void QCustomPlot::setPlottingHints(const QCP::PlottingHints &hints) +{ + mPlottingHints = hints; +} + +/*! + Sets the specified plotting \a hint to \a enabled. + + \see setPlottingHints +*/ +void QCustomPlot::setPlottingHint(QCP::PlottingHint hint, bool enabled) +{ + QCP::PlottingHints newHints = mPlottingHints; + if (!enabled) + newHints &= ~hint; + else + newHints |= hint; + + if (newHints != mPlottingHints) + setPlottingHints(newHints); +} + +/*! + Sets the keyboard modifier that will be recognized as multi-select-modifier. + + If \ref QCP::iMultiSelect is specified in \ref setInteractions, the user may select multiple + objects (or data points) by clicking on them one after the other while holding down \a modifier. + + By default the multi-select-modifier is set to Qt::ControlModifier. + + \see setInteractions +*/ +void QCustomPlot::setMultiSelectModifier(Qt::KeyboardModifier modifier) +{ + mMultiSelectModifier = modifier; +} + +/*! + Sets how QCustomPlot processes mouse click-and-drag interactions by the user. + + If \a mode is \ref QCP::srmNone, the mouse drag is forwarded to the underlying objects. For + example, QCPAxisRect may process a mouse drag by dragging axis ranges, see \ref + QCPAxisRect::setRangeDrag. If \a mode is not \ref QCP::srmNone, the current selection rect (\ref + selectionRect) becomes activated and allows e.g. rect zooming and data point selection. + + If you wish to provide your user both with axis range dragging and data selection/range zooming, + use this method to switch between the modes just before the interaction is processed, e.g. in + reaction to the \ref mousePress or \ref mouseMove signals. For example you could check whether + the user is holding a certain keyboard modifier, and then decide which \a mode shall be set. + + If a selection rect interaction is currently active, and \a mode is set to \ref QCP::srmNone, the + interaction is canceled (\ref QCPSelectionRect::cancel). Switching between any of the other modes + will keep the selection rect active. Upon completion of the interaction, the behaviour is as + defined by the currently set \a mode, not the mode that was set when the interaction started. + + \see setInteractions, setSelectionRect, QCPSelectionRect +*/ +void QCustomPlot::setSelectionRectMode(QCP::SelectionRectMode mode) +{ + if (mSelectionRect) + { + if (mode == QCP::srmNone) + mSelectionRect->cancel(); // when switching to none, we immediately want to abort a potentially active selection rect + + // disconnect old connections: + if (mSelectionRectMode == QCP::srmSelect) + disconnect(mSelectionRect, SIGNAL(accepted(QRect,QMouseEvent*)), this, SLOT(processRectSelection(QRect,QMouseEvent*))); + else if (mSelectionRectMode == QCP::srmZoom) + disconnect(mSelectionRect, SIGNAL(accepted(QRect,QMouseEvent*)), this, SLOT(processRectZoom(QRect,QMouseEvent*))); + + // establish new ones: + if (mode == QCP::srmSelect) + connect(mSelectionRect, SIGNAL(accepted(QRect,QMouseEvent*)), this, SLOT(processRectSelection(QRect,QMouseEvent*))); + else if (mode == QCP::srmZoom) + connect(mSelectionRect, SIGNAL(accepted(QRect,QMouseEvent*)), this, SLOT(processRectZoom(QRect,QMouseEvent*))); + } + + mSelectionRectMode = mode; +} + +/*! + Sets the \ref QCPSelectionRect instance that QCustomPlot will use if \a mode is not \ref + QCP::srmNone and the user performs a click-and-drag interaction. QCustomPlot takes ownership of + the passed \a selectionRect. It can be accessed later via \ref selectionRect. + + This method is useful if you wish to replace the default QCPSelectionRect instance with an + instance of a QCPSelectionRect subclass, to introduce custom behaviour of the selection rect. + + \see setSelectionRectMode +*/ +void QCustomPlot::setSelectionRect(QCPSelectionRect *selectionRect) +{ + if (mSelectionRect) + delete mSelectionRect; + + mSelectionRect = selectionRect; + + if (mSelectionRect) + { + // establish connections with new selection rect: + if (mSelectionRectMode == QCP::srmSelect) + connect(mSelectionRect, SIGNAL(accepted(QRect,QMouseEvent*)), this, SLOT(processRectSelection(QRect,QMouseEvent*))); + else if (mSelectionRectMode == QCP::srmZoom) + connect(mSelectionRect, SIGNAL(accepted(QRect,QMouseEvent*)), this, SLOT(processRectZoom(QRect,QMouseEvent*))); + } +} + +/*! + \warning This is still an experimental feature and its performance depends on the system that it + runs on. Having multiple QCustomPlot widgets in one application with enabled OpenGL rendering + might cause context conflicts on some systems. + + This method allows to enable OpenGL plot rendering, for increased plotting performance of + graphically demanding plots (thick lines, translucent fills, etc.). + + If \a enabled is set to true, QCustomPlot will try to initialize OpenGL and, if successful, + continue plotting with hardware acceleration. The parameter \a multisampling controls how many + samples will be used per pixel, it essentially controls the antialiasing quality. If \a + multisampling is set too high for the current graphics hardware, the maximum allowed value will + be used. + + You can test whether switching to OpenGL rendering was successful by checking whether the + according getter \a QCustomPlot::openGl() returns true. If the OpenGL initialization fails, + rendering continues with the regular software rasterizer, and an according qDebug output is + generated. + + If switching to OpenGL was successful, this method disables label caching (\ref setPlottingHint + "setPlottingHint(QCP::phCacheLabels, false)") and turns on QCustomPlot's antialiasing override + for all elements (\ref setAntialiasedElements "setAntialiasedElements(QCP::aeAll)"), leading to a + higher quality output. The antialiasing override allows for pixel-grid aligned drawing in the + OpenGL paint device. As stated before, in OpenGL rendering the actual antialiasing of the plot is + controlled with \a multisampling. If \a enabled is set to false, the antialiasing/label caching + settings are restored to what they were before OpenGL was enabled, if they weren't altered in the + meantime. + + \note OpenGL support is only enabled if QCustomPlot is compiled with the macro \c QCUSTOMPLOT_USE_OPENGL + defined. This define must be set before including the QCustomPlot header both during compilation + of the QCustomPlot library as well as when compiling your application. It is best to just include + the line DEFINES += QCUSTOMPLOT_USE_OPENGL in the respective qmake project files. + \note If you are using a Qt version before 5.0, you must also add the module "opengl" to your \c + QT variable in the qmake project files. For Qt versions 5.0 and higher, QCustomPlot switches to a + newer OpenGL interface which is already in the "gui" module. +*/ +void QCustomPlot::setOpenGl(bool enabled, int multisampling) +{ + mOpenGlMultisamples = qMax(0, multisampling); +#ifdef QCUSTOMPLOT_USE_OPENGL + mOpenGl = enabled; + if (mOpenGl) + { + if (setupOpenGl()) + { + // backup antialiasing override and labelcaching setting so we can restore upon disabling OpenGL + mOpenGlAntialiasedElementsBackup = mAntialiasedElements; + mOpenGlCacheLabelsBackup = mPlottingHints.testFlag(QCP::phCacheLabels); + // set antialiasing override to antialias all (aligns gl pixel grid properly), and disable label caching (would use software rasterizer for pixmap caches): + setAntialiasedElements(QCP::aeAll); + setPlottingHint(QCP::phCacheLabels, false); + } else + { + qDebug() << Q_FUNC_INFO << "Failed to enable OpenGL, continuing plotting without hardware acceleration."; + mOpenGl = false; + } + } else + { + // restore antialiasing override and labelcaching to what it was before enabling OpenGL, if nobody changed it in the meantime: + if (mAntialiasedElements == QCP::aeAll) + setAntialiasedElements(mOpenGlAntialiasedElementsBackup); + if (!mPlottingHints.testFlag(QCP::phCacheLabels)) + setPlottingHint(QCP::phCacheLabels, mOpenGlCacheLabelsBackup); + freeOpenGl(); + } + // recreate all paint buffers: + mPaintBuffers.clear(); + setupPaintBuffers(); +#else + Q_UNUSED(enabled) + qDebug() << Q_FUNC_INFO << "QCustomPlot can't use OpenGL because QCUSTOMPLOT_USE_OPENGL was not defined during compilation (add 'DEFINES += QCUSTOMPLOT_USE_OPENGL' to your qmake .pro file)"; +#endif +} + +/*! + Sets the viewport of this QCustomPlot. Usually users of QCustomPlot don't need to change the + viewport manually. + + The viewport is the area in which the plot is drawn. All mechanisms, e.g. margin caluclation take + the viewport to be the outer border of the plot. The viewport normally is the rect() of the + QCustomPlot widget, i.e. a rect with top left (0, 0) and size of the QCustomPlot widget. + + Don't confuse the viewport with the axis rect (QCustomPlot::axisRect). An axis rect is typically + an area enclosed by four axes, where the graphs/plottables are drawn in. The viewport is larger + and contains also the axes themselves, their tick numbers, their labels, or even additional axis + rects, color scales and other layout elements. + + This function is used to allow arbitrary size exports with \ref toPixmap, \ref savePng, \ref + savePdf, etc. by temporarily changing the viewport size. +*/ +void QCustomPlot::setViewport(const QRect &rect) +{ + mViewport = rect; + if (mPlotLayout) + mPlotLayout->setOuterRect(mViewport); +} + +/*! + Sets the device pixel ratio used by the paint buffers of this QCustomPlot instance. + + Normally, this doesn't need to be set manually, because it is initialized with the regular \a + QWidget::devicePixelRatio which is configured by Qt to fit the display device (e.g. 1 for normal + displays, 2 for High-DPI displays). + + Device pixel ratios are supported by Qt only for Qt versions since 5.4. If this method is called + when QCustomPlot is being used with older Qt versions, outputs an according qDebug message and + leaves the internal buffer device pixel ratio at 1.0. +*/ +void QCustomPlot::setBufferDevicePixelRatio(double ratio) +{ + if (!qFuzzyCompare(ratio, mBufferDevicePixelRatio)) + { +#ifdef QCP_DEVICEPIXELRATIO_SUPPORTED + mBufferDevicePixelRatio = ratio; + for (int i=0; isetDevicePixelRatio(mBufferDevicePixelRatio); + // Note: axis label cache has devicePixelRatio as part of cache hash, so no need to manually clear cache here +#else + qDebug() << Q_FUNC_INFO << "Device pixel ratios not supported for Qt versions before 5.4"; + mBufferDevicePixelRatio = 1.0; +#endif + } +} + +/*! + Sets \a pm as the viewport background pixmap (see \ref setViewport). The pixmap is always drawn + below all other objects in the plot. + + For cases where the provided pixmap doesn't have the same size as the viewport, scaling can be + enabled with \ref setBackgroundScaled and the scaling mode (whether and how the aspect ratio is + preserved) can be set with \ref setBackgroundScaledMode. To set all these options in one call, + consider using the overloaded version of this function. + + If a background brush was set with \ref setBackground(const QBrush &brush), the viewport will + first be filled with that brush, before drawing the background pixmap. This can be useful for + background pixmaps with translucent areas. + + \see setBackgroundScaled, setBackgroundScaledMode +*/ +void QCustomPlot::setBackground(const QPixmap &pm) +{ + mBackgroundPixmap = pm; + mScaledBackgroundPixmap = QPixmap(); +} + +/*! + Sets the background brush of the viewport (see \ref setViewport). + + Before drawing everything else, the background is filled with \a brush. If a background pixmap + was set with \ref setBackground(const QPixmap &pm), this brush will be used to fill the viewport + before the background pixmap is drawn. This can be useful for background pixmaps with translucent + areas. + + Set \a brush to Qt::NoBrush or Qt::Transparent to leave background transparent. This can be + useful for exporting to image formats which support transparency, e.g. \ref savePng. + + \see setBackgroundScaled, setBackgroundScaledMode +*/ +void QCustomPlot::setBackground(const QBrush &brush) +{ + mBackgroundBrush = brush; +} + +/*! \overload + + Allows setting the background pixmap of the viewport, whether it shall be scaled and how it + shall be scaled in one call. + + \see setBackground(const QPixmap &pm), setBackgroundScaled, setBackgroundScaledMode +*/ +void QCustomPlot::setBackground(const QPixmap &pm, bool scaled, Qt::AspectRatioMode mode) +{ + mBackgroundPixmap = pm; + mScaledBackgroundPixmap = QPixmap(); + mBackgroundScaled = scaled; + mBackgroundScaledMode = mode; +} + +/*! + Sets whether the viewport background pixmap shall be scaled to fit the viewport. If \a scaled is + set to true, control whether and how the aspect ratio of the original pixmap is preserved with + \ref setBackgroundScaledMode. + + Note that the scaled version of the original pixmap is buffered, so there is no performance + penalty on replots. (Except when the viewport dimensions are changed continuously.) + + \see setBackground, setBackgroundScaledMode +*/ +void QCustomPlot::setBackgroundScaled(bool scaled) +{ + mBackgroundScaled = scaled; +} + +/*! + If scaling of the viewport background pixmap is enabled (\ref setBackgroundScaled), use this + function to define whether and how the aspect ratio of the original pixmap is preserved. + + \see setBackground, setBackgroundScaled +*/ +void QCustomPlot::setBackgroundScaledMode(Qt::AspectRatioMode mode) +{ + mBackgroundScaledMode = mode; +} + +/*! + Returns the plottable with \a index. If the index is invalid, returns 0. + + There is an overloaded version of this function with no parameter which returns the last added + plottable, see QCustomPlot::plottable() + + \see plottableCount +*/ +QCPAbstractPlottable *QCustomPlot::plottable(int index) +{ + if (index >= 0 && index < mPlottables.size()) + { + return mPlottables.at(index); + } else + { + qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; + return 0; + } +} + +/*! \overload + + Returns the last plottable that was added to the plot. If there are no plottables in the plot, + returns 0. + + \see plottableCount +*/ +QCPAbstractPlottable *QCustomPlot::plottable() +{ + if (!mPlottables.isEmpty()) + { + return mPlottables.last(); + } else + return 0; +} + +/*! + Removes the specified plottable from the plot and deletes it. If necessary, the corresponding + legend item is also removed from the default legend (QCustomPlot::legend). + + Returns true on success. + + \see clearPlottables +*/ +bool QCustomPlot::removePlottable(QCPAbstractPlottable *plottable) +{ + if (!mPlottables.contains(plottable)) + { + qDebug() << Q_FUNC_INFO << "plottable not in list:" << reinterpret_cast(plottable); + return false; + } + + // remove plottable from legend: + plottable->removeFromLegend(); + // special handling for QCPGraphs to maintain the simple graph interface: + if (QCPGraph *graph = qobject_cast(plottable)) + mGraphs.removeOne(graph); + // remove plottable: + delete plottable; + mPlottables.removeOne(plottable); + return true; +} + +/*! \overload + + Removes and deletes the plottable by its \a index. +*/ +bool QCustomPlot::removePlottable(int index) +{ + if (index >= 0 && index < mPlottables.size()) + return removePlottable(mPlottables[index]); + else + { + qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; + return false; + } +} + +/*! + Removes all plottables from the plot and deletes them. Corresponding legend items are also + removed from the default legend (QCustomPlot::legend). + + Returns the number of plottables removed. + + \see removePlottable +*/ +int QCustomPlot::clearPlottables() +{ + int c = mPlottables.size(); + for (int i=c-1; i >= 0; --i) + removePlottable(mPlottables[i]); + return c; +} + +/*! + Returns the number of currently existing plottables in the plot + + \see plottable +*/ +int QCustomPlot::plottableCount() const +{ + return mPlottables.size(); +} + +/*! + Returns a list of the selected plottables. If no plottables are currently selected, the list is empty. + + There is a convenience function if you're only interested in selected graphs, see \ref selectedGraphs. + + \see setInteractions, QCPAbstractPlottable::setSelectable, QCPAbstractPlottable::setSelection +*/ +QList QCustomPlot::selectedPlottables() const +{ + QList result; + foreach (QCPAbstractPlottable *plottable, mPlottables) + { + if (plottable->selected()) + result.append(plottable); + } + return result; +} + +/*! + Returns the plottable at the pixel position \a pos. Plottables that only consist of single lines + (like graphs) have a tolerance band around them, see \ref setSelectionTolerance. If multiple + plottables come into consideration, the one closest to \a pos is returned. + + If \a onlySelectable is true, only plottables that are selectable + (QCPAbstractPlottable::setSelectable) are considered. + + If there is no plottable at \a pos, the return value is 0. + + \see itemAt, layoutElementAt +*/ +QCPAbstractPlottable *QCustomPlot::plottableAt(const QPointF &pos, bool onlySelectable) const +{ + QCPAbstractPlottable *resultPlottable = 0; + double resultDistance = mSelectionTolerance; // only regard clicks with distances smaller than mSelectionTolerance as selections, so initialize with that value + + foreach (QCPAbstractPlottable *plottable, mPlottables) + { + if (onlySelectable && !plottable->selectable()) // we could have also passed onlySelectable to the selectTest function, but checking here is faster, because we have access to QCPabstractPlottable::selectable + continue; + if ((plottable->keyAxis()->axisRect()->rect() & plottable->valueAxis()->axisRect()->rect()).contains(pos.toPoint())) // only consider clicks inside the rect that is spanned by the plottable's key/value axes + { + double currentDistance = plottable->selectTest(pos, false); + if (currentDistance >= 0 && currentDistance < resultDistance) + { + resultPlottable = plottable; + resultDistance = currentDistance; + } + } + } + + return resultPlottable; +} + +/*! + Returns whether this QCustomPlot instance contains the \a plottable. +*/ +bool QCustomPlot::hasPlottable(QCPAbstractPlottable *plottable) const +{ + return mPlottables.contains(plottable); +} + +/*! + Returns the graph with \a index. If the index is invalid, returns 0. + + There is an overloaded version of this function with no parameter which returns the last created + graph, see QCustomPlot::graph() + + \see graphCount, addGraph +*/ +QCPGraph *QCustomPlot::graph(int index) const +{ + if (index >= 0 && index < mGraphs.size()) + { + return mGraphs.at(index); + } else + { + qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; + return 0; + } +} + +/*! \overload + + Returns the last graph, that was created with \ref addGraph. If there are no graphs in the plot, + returns 0. + + \see graphCount, addGraph +*/ +QCPGraph *QCustomPlot::graph() const +{ + if (!mGraphs.isEmpty()) + { + return mGraphs.last(); + } else + return 0; +} + +/*! + Creates a new graph inside the plot. If \a keyAxis and \a valueAxis are left unspecified (0), the + bottom (xAxis) is used as key and the left (yAxis) is used as value axis. If specified, \a + keyAxis and \a valueAxis must reside in this QCustomPlot. + + \a keyAxis will be used as key axis (typically "x") and \a valueAxis as value axis (typically + "y") for the graph. + + Returns a pointer to the newly created graph, or 0 if adding the graph failed. + + \see graph, graphCount, removeGraph, clearGraphs +*/ +QCPGraph *QCustomPlot::addGraph(QCPAxis *keyAxis, QCPAxis *valueAxis) +{ + if (!keyAxis) keyAxis = xAxis; + if (!valueAxis) valueAxis = yAxis; + if (!keyAxis || !valueAxis) + { + qDebug() << Q_FUNC_INFO << "can't use default QCustomPlot xAxis or yAxis, because at least one is invalid (has been deleted)"; + return 0; + } + if (keyAxis->parentPlot() != this || valueAxis->parentPlot() != this) + { + qDebug() << Q_FUNC_INFO << "passed keyAxis or valueAxis doesn't have this QCustomPlot as parent"; + return 0; + } + + QCPGraph *newGraph = new QCPGraph(keyAxis, valueAxis); + newGraph->setName(QLatin1String("Graph ")+QString::number(mGraphs.size())); + return newGraph; +} + +/*! + Removes the specified \a graph from the plot and deletes it. If necessary, the corresponding + legend item is also removed from the default legend (QCustomPlot::legend). If any other graphs in + the plot have a channel fill set towards the removed graph, the channel fill property of those + graphs is reset to zero (no channel fill). + + Returns true on success. + + \see clearGraphs +*/ +bool QCustomPlot::removeGraph(QCPGraph *graph) +{ + return removePlottable(graph); +} + +/*! \overload + + Removes and deletes the graph by its \a index. +*/ +bool QCustomPlot::removeGraph(int index) +{ + if (index >= 0 && index < mGraphs.size()) + return removeGraph(mGraphs[index]); + else + return false; +} + +/*! + Removes all graphs from the plot and deletes them. Corresponding legend items are also removed + from the default legend (QCustomPlot::legend). + + Returns the number of graphs removed. + + \see removeGraph +*/ +int QCustomPlot::clearGraphs() +{ + int c = mGraphs.size(); + for (int i=c-1; i >= 0; --i) + removeGraph(mGraphs[i]); + return c; +} + +/*! + Returns the number of currently existing graphs in the plot + + \see graph, addGraph +*/ +int QCustomPlot::graphCount() const +{ + return mGraphs.size(); +} + +/*! + Returns a list of the selected graphs. If no graphs are currently selected, the list is empty. + + If you are not only interested in selected graphs but other plottables like QCPCurve, QCPBars, + etc., use \ref selectedPlottables. + + \see setInteractions, selectedPlottables, QCPAbstractPlottable::setSelectable, QCPAbstractPlottable::setSelection +*/ +QList QCustomPlot::selectedGraphs() const +{ + QList result; + foreach (QCPGraph *graph, mGraphs) + { + if (graph->selected()) + result.append(graph); + } + return result; +} + +/*! + Returns the item with \a index. If the index is invalid, returns 0. + + There is an overloaded version of this function with no parameter which returns the last added + item, see QCustomPlot::item() + + \see itemCount +*/ +QCPAbstractItem *QCustomPlot::item(int index) const +{ + if (index >= 0 && index < mItems.size()) + { + return mItems.at(index); + } else + { + qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; + return 0; + } +} + +/*! \overload + + Returns the last item that was added to this plot. If there are no items in the plot, + returns 0. + + \see itemCount +*/ +QCPAbstractItem *QCustomPlot::item() const +{ + if (!mItems.isEmpty()) + { + return mItems.last(); + } else + return 0; +} + +/*! + Removes the specified item from the plot and deletes it. + + Returns true on success. + + \see clearItems +*/ +bool QCustomPlot::removeItem(QCPAbstractItem *item) +{ + if (mItems.contains(item)) + { + delete item; + mItems.removeOne(item); + return true; + } else + { + qDebug() << Q_FUNC_INFO << "item not in list:" << reinterpret_cast(item); + return false; + } +} + +/*! \overload + + Removes and deletes the item by its \a index. +*/ +bool QCustomPlot::removeItem(int index) +{ + if (index >= 0 && index < mItems.size()) + return removeItem(mItems[index]); + else + { + qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; + return false; + } +} + +/*! + Removes all items from the plot and deletes them. + + Returns the number of items removed. + + \see removeItem +*/ +int QCustomPlot::clearItems() +{ + int c = mItems.size(); + for (int i=c-1; i >= 0; --i) + removeItem(mItems[i]); + return c; +} + +/*! + Returns the number of currently existing items in the plot + + \see item +*/ +int QCustomPlot::itemCount() const +{ + return mItems.size(); +} + +/*! + Returns a list of the selected items. If no items are currently selected, the list is empty. + + \see setInteractions, QCPAbstractItem::setSelectable, QCPAbstractItem::setSelected +*/ +QList QCustomPlot::selectedItems() const +{ + QList result; + foreach (QCPAbstractItem *item, mItems) + { + if (item->selected()) + result.append(item); + } + return result; +} + +/*! + Returns the item at the pixel position \a pos. Items that only consist of single lines (e.g. \ref + QCPItemLine or \ref QCPItemCurve) have a tolerance band around them, see \ref + setSelectionTolerance. If multiple items come into consideration, the one closest to \a pos is + returned. + + If \a onlySelectable is true, only items that are selectable (QCPAbstractItem::setSelectable) are + considered. + + If there is no item at \a pos, the return value is 0. + + \see plottableAt, layoutElementAt +*/ +QCPAbstractItem *QCustomPlot::itemAt(const QPointF &pos, bool onlySelectable) const +{ + QCPAbstractItem *resultItem = 0; + double resultDistance = mSelectionTolerance; // only regard clicks with distances smaller than mSelectionTolerance as selections, so initialize with that value + + foreach (QCPAbstractItem *item, mItems) + { + if (onlySelectable && !item->selectable()) // we could have also passed onlySelectable to the selectTest function, but checking here is faster, because we have access to QCPAbstractItem::selectable + continue; + if (!item->clipToAxisRect() || item->clipRect().contains(pos.toPoint())) // only consider clicks inside axis cliprect of the item if actually clipped to it + { + double currentDistance = item->selectTest(pos, false); + if (currentDistance >= 0 && currentDistance < resultDistance) + { + resultItem = item; + resultDistance = currentDistance; + } + } + } + + return resultItem; +} + +/*! + Returns whether this QCustomPlot contains the \a item. + + \see item +*/ +bool QCustomPlot::hasItem(QCPAbstractItem *item) const +{ + return mItems.contains(item); +} + +/*! + Returns the layer with the specified \a name. If there is no layer with the specified name, 0 is + returned. + + Layer names are case-sensitive. + + \see addLayer, moveLayer, removeLayer +*/ +QCPLayer *QCustomPlot::layer(const QString &name) const +{ + foreach (QCPLayer *layer, mLayers) + { + if (layer->name() == name) + return layer; + } + return 0; +} + +/*! \overload + + Returns the layer by \a index. If the index is invalid, 0 is returned. + + \see addLayer, moveLayer, removeLayer +*/ +QCPLayer *QCustomPlot::layer(int index) const +{ + if (index >= 0 && index < mLayers.size()) + { + return mLayers.at(index); + } else + { + qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; + return 0; + } +} + +/*! + Returns the layer that is set as current layer (see \ref setCurrentLayer). +*/ +QCPLayer *QCustomPlot::currentLayer() const +{ + return mCurrentLayer; +} + +/*! + Sets the layer with the specified \a name to be the current layer. All layerables (\ref + QCPLayerable), e.g. plottables and items, are created on the current layer. + + Returns true on success, i.e. if there is a layer with the specified \a name in the QCustomPlot. + + Layer names are case-sensitive. + + \see addLayer, moveLayer, removeLayer, QCPLayerable::setLayer +*/ +bool QCustomPlot::setCurrentLayer(const QString &name) +{ + if (QCPLayer *newCurrentLayer = layer(name)) + { + return setCurrentLayer(newCurrentLayer); + } else + { + qDebug() << Q_FUNC_INFO << "layer with name doesn't exist:" << name; + return false; + } +} + +/*! \overload + + Sets the provided \a layer to be the current layer. + + Returns true on success, i.e. when \a layer is a valid layer in the QCustomPlot. + + \see addLayer, moveLayer, removeLayer +*/ +bool QCustomPlot::setCurrentLayer(QCPLayer *layer) +{ + if (!mLayers.contains(layer)) + { + qDebug() << Q_FUNC_INFO << "layer not a layer of this QCustomPlot:" << reinterpret_cast(layer); + return false; + } + + mCurrentLayer = layer; + return true; +} + +/*! + Returns the number of currently existing layers in the plot + + \see layer, addLayer +*/ +int QCustomPlot::layerCount() const +{ + return mLayers.size(); +} + +/*! + Adds a new layer to this QCustomPlot instance. The new layer will have the name \a name, which + must be unique. Depending on \a insertMode, it is positioned either below or above \a otherLayer. + + Returns true on success, i.e. if there is no other layer named \a name and \a otherLayer is a + valid layer inside this QCustomPlot. + + If \a otherLayer is 0, the highest layer in the QCustomPlot will be used. + + For an explanation of what layers are in QCustomPlot, see the documentation of \ref QCPLayer. + + \see layer, moveLayer, removeLayer +*/ +bool QCustomPlot::addLayer(const QString &name, QCPLayer *otherLayer, QCustomPlot::LayerInsertMode insertMode) +{ + if (!otherLayer) + otherLayer = mLayers.last(); + if (!mLayers.contains(otherLayer)) + { + qDebug() << Q_FUNC_INFO << "otherLayer not a layer of this QCustomPlot:" << reinterpret_cast(otherLayer); + return false; + } + if (layer(name)) + { + qDebug() << Q_FUNC_INFO << "A layer exists already with the name" << name; + return false; + } + + QCPLayer *newLayer = new QCPLayer(this, name); + mLayers.insert(otherLayer->index() + (insertMode==limAbove ? 1:0), newLayer); + updateLayerIndices(); + setupPaintBuffers(); // associates new layer with the appropriate paint buffer + return true; +} + +/*! + Removes the specified \a layer and returns true on success. + + All layerables (e.g. plottables and items) on the removed layer will be moved to the layer below + \a layer. If \a layer is the bottom layer, the layerables are moved to the layer above. In both + cases, the total rendering order of all layerables in the QCustomPlot is preserved. + + If \a layer is the current layer (\ref setCurrentLayer), the layer below (or above, if bottom + layer) becomes the new current layer. + + It is not possible to remove the last layer of the plot. + + \see layer, addLayer, moveLayer +*/ +bool QCustomPlot::removeLayer(QCPLayer *layer) +{ + if (!mLayers.contains(layer)) + { + qDebug() << Q_FUNC_INFO << "layer not a layer of this QCustomPlot:" << reinterpret_cast(layer); + return false; + } + if (mLayers.size() < 2) + { + qDebug() << Q_FUNC_INFO << "can't remove last layer"; + return false; + } + + // append all children of this layer to layer below (if this is lowest layer, prepend to layer above) + int removedIndex = layer->index(); + bool isFirstLayer = removedIndex==0; + QCPLayer *targetLayer = isFirstLayer ? mLayers.at(removedIndex+1) : mLayers.at(removedIndex-1); + QList children = layer->children(); + if (isFirstLayer) // prepend in reverse order (so order relative to each other stays the same) + { + for (int i=children.size()-1; i>=0; --i) + children.at(i)->moveToLayer(targetLayer, true); + } else // append normally + { + for (int i=0; imoveToLayer(targetLayer, false); + } + // if removed layer is current layer, change current layer to layer below/above: + if (layer == mCurrentLayer) + setCurrentLayer(targetLayer); + // invalidate the paint buffer that was responsible for this layer: + if (!layer->mPaintBuffer.isNull()) + layer->mPaintBuffer.data()->setInvalidated(); + // remove layer: + delete layer; + mLayers.removeOne(layer); + updateLayerIndices(); + return true; +} + +/*! + Moves the specified \a layer either above or below \a otherLayer. Whether it's placed above or + below is controlled with \a insertMode. + + Returns true on success, i.e. when both \a layer and \a otherLayer are valid layers in the + QCustomPlot. + + \see layer, addLayer, moveLayer +*/ +bool QCustomPlot::moveLayer(QCPLayer *layer, QCPLayer *otherLayer, QCustomPlot::LayerInsertMode insertMode) +{ + if (!mLayers.contains(layer)) + { + qDebug() << Q_FUNC_INFO << "layer not a layer of this QCustomPlot:" << reinterpret_cast(layer); + return false; + } + if (!mLayers.contains(otherLayer)) + { + qDebug() << Q_FUNC_INFO << "otherLayer not a layer of this QCustomPlot:" << reinterpret_cast(otherLayer); + return false; + } + + if (layer->index() > otherLayer->index()) + mLayers.move(layer->index(), otherLayer->index() + (insertMode==limAbove ? 1:0)); + else if (layer->index() < otherLayer->index()) + mLayers.move(layer->index(), otherLayer->index() + (insertMode==limAbove ? 0:-1)); + + // invalidate the paint buffers that are responsible for the layers: + if (!layer->mPaintBuffer.isNull()) + layer->mPaintBuffer.data()->setInvalidated(); + if (!otherLayer->mPaintBuffer.isNull()) + otherLayer->mPaintBuffer.data()->setInvalidated(); + + updateLayerIndices(); + return true; +} + +/*! + Returns the number of axis rects in the plot. + + All axis rects can be accessed via QCustomPlot::axisRect(). + + Initially, only one axis rect exists in the plot. + + \see axisRect, axisRects +*/ +int QCustomPlot::axisRectCount() const +{ + return axisRects().size(); +} + +/*! + Returns the axis rect with \a index. + + Initially, only one axis rect (with index 0) exists in the plot. If multiple axis rects were + added, all of them may be accessed with this function in a linear fashion (even when they are + nested in a layout hierarchy or inside other axis rects via QCPAxisRect::insetLayout). + + The order of the axis rects is given by the fill order of the \ref QCPLayout that is holding + them. For example, if the axis rects are in the top level grid layout (accessible via \ref + QCustomPlot::plotLayout), they are ordered from left to right, top to bottom, if the layout's + default \ref QCPLayoutGrid::setFillOrder "setFillOrder" of \ref QCPLayoutGrid::foColumnsFirst + "foColumnsFirst" wasn't changed. + + If you want to access axis rects by their row and column index, use the layout interface. For + example, use \ref QCPLayoutGrid::element of the top level grid layout, and \c qobject_cast the + returned layout element to \ref QCPAxisRect. (See also \ref thelayoutsystem.) + + \see axisRectCount, axisRects, QCPLayoutGrid::setFillOrder +*/ +QCPAxisRect *QCustomPlot::axisRect(int index) const +{ + const QList rectList = axisRects(); + if (index >= 0 && index < rectList.size()) + { + return rectList.at(index); + } else + { + qDebug() << Q_FUNC_INFO << "invalid axis rect index" << index; + return 0; + } +} + +/*! + Returns all axis rects in the plot. + + The order of the axis rects is given by the fill order of the \ref QCPLayout that is holding + them. For example, if the axis rects are in the top level grid layout (accessible via \ref + QCustomPlot::plotLayout), they are ordered from left to right, top to bottom, if the layout's + default \ref QCPLayoutGrid::setFillOrder "setFillOrder" of \ref QCPLayoutGrid::foColumnsFirst + "foColumnsFirst" wasn't changed. + + \see axisRectCount, axisRect, QCPLayoutGrid::setFillOrder +*/ +QList QCustomPlot::axisRects() const +{ + QList result; + QStack elementStack; + if (mPlotLayout) + elementStack.push(mPlotLayout); + + while (!elementStack.isEmpty()) + { + foreach (QCPLayoutElement *element, elementStack.pop()->elements(false)) + { + if (element) + { + elementStack.push(element); + if (QCPAxisRect *ar = qobject_cast(element)) + result.append(ar); + } + } + } + + return result; +} + +/*! + Returns the layout element at pixel position \a pos. If there is no element at that position, + returns 0. + + Only visible elements are used. If \ref QCPLayoutElement::setVisible on the element itself or on + any of its parent elements is set to false, it will not be considered. + + \see itemAt, plottableAt +*/ +QCPLayoutElement *QCustomPlot::layoutElementAt(const QPointF &pos) const +{ + QCPLayoutElement *currentElement = mPlotLayout; + bool searchSubElements = true; + while (searchSubElements && currentElement) + { + searchSubElements = false; + foreach (QCPLayoutElement *subElement, currentElement->elements(false)) + { + if (subElement && subElement->realVisibility() && subElement->selectTest(pos, false) >= 0) + { + currentElement = subElement; + searchSubElements = true; + break; + } + } + } + return currentElement; +} + +/*! + Returns the layout element of type \ref QCPAxisRect at pixel position \a pos. This method ignores + other layout elements even if they are visually in front of the axis rect (e.g. a \ref + QCPLegend). If there is no axis rect at that position, returns 0. + + Only visible axis rects are used. If \ref QCPLayoutElement::setVisible on the axis rect itself or + on any of its parent elements is set to false, it will not be considered. + + \see layoutElementAt +*/ +QCPAxisRect *QCustomPlot::axisRectAt(const QPointF &pos) const +{ + QCPAxisRect *result = 0; + QCPLayoutElement *currentElement = mPlotLayout; + bool searchSubElements = true; + while (searchSubElements && currentElement) + { + searchSubElements = false; + foreach (QCPLayoutElement *subElement, currentElement->elements(false)) + { + if (subElement && subElement->realVisibility() && subElement->selectTest(pos, false) >= 0) + { + currentElement = subElement; + searchSubElements = true; + if (QCPAxisRect *ar = qobject_cast(currentElement)) + result = ar; + break; + } + } + } + return result; +} + +/*! + Returns the axes that currently have selected parts, i.e. whose selection state is not \ref + QCPAxis::spNone. + + \see selectedPlottables, selectedLegends, setInteractions, QCPAxis::setSelectedParts, + QCPAxis::setSelectableParts +*/ +QList QCustomPlot::selectedAxes() const +{ + QList result, allAxes; + foreach (QCPAxisRect *rect, axisRects()) + allAxes << rect->axes(); + + foreach (QCPAxis *axis, allAxes) + { + if (axis->selectedParts() != QCPAxis::spNone) + result.append(axis); + } + + return result; +} + +/*! + Returns the legends that currently have selected parts, i.e. whose selection state is not \ref + QCPLegend::spNone. + + \see selectedPlottables, selectedAxes, setInteractions, QCPLegend::setSelectedParts, + QCPLegend::setSelectableParts, QCPLegend::selectedItems +*/ +QList QCustomPlot::selectedLegends() const +{ + QList result; + + QStack elementStack; + if (mPlotLayout) + elementStack.push(mPlotLayout); + + while (!elementStack.isEmpty()) + { + foreach (QCPLayoutElement *subElement, elementStack.pop()->elements(false)) + { + if (subElement) + { + elementStack.push(subElement); + if (QCPLegend *leg = qobject_cast(subElement)) + { + if (leg->selectedParts() != QCPLegend::spNone) + result.append(leg); + } + } + } + } + + return result; +} + +/*! + Deselects all layerables (plottables, items, axes, legends,...) of the QCustomPlot. + + Since calling this function is not a user interaction, this does not emit the \ref + selectionChangedByUser signal. The individual selectionChanged signals are emitted though, if the + objects were previously selected. + + \see setInteractions, selectedPlottables, selectedItems, selectedAxes, selectedLegends +*/ +void QCustomPlot::deselectAll() +{ + foreach (QCPLayer *layer, mLayers) + { + foreach (QCPLayerable *layerable, layer->children()) + layerable->deselectEvent(0); + } +} + +/*! + Causes a complete replot into the internal paint buffer(s). Finally, the widget surface is + refreshed with the new buffer contents. This is the method that must be called to make changes to + the plot, e.g. on the axis ranges or data points of graphs, visible. + + The parameter \a refreshPriority can be used to fine-tune the timing of the replot. For example + if your application calls \ref replot very quickly in succession (e.g. multiple independent + functions change some aspects of the plot and each wants to make sure the change gets replotted), + it is advisable to set \a refreshPriority to \ref QCustomPlot::rpQueuedReplot. This way, the + actual replotting is deferred to the next event loop iteration. Multiple successive calls of \ref + replot with this priority will only cause a single replot, avoiding redundant replots and + improving performance. + + Under a few circumstances, QCustomPlot causes a replot by itself. Those are resize events of the + QCustomPlot widget and user interactions (object selection and range dragging/zooming). + + Before the replot happens, the signal \ref beforeReplot is emitted. After the replot, \ref + afterReplot is emitted. It is safe to mutually connect the replot slot with any of those two + signals on two QCustomPlots to make them replot synchronously, it won't cause an infinite + recursion. + + If a layer is in mode \ref QCPLayer::lmBuffered (\ref QCPLayer::setMode), it is also possible to + replot only that specific layer via \ref QCPLayer::replot. See the documentation there for + details. +*/ +void QCustomPlot::replot(QCustomPlot::RefreshPriority refreshPriority) +{ + if (refreshPriority == QCustomPlot::rpQueuedReplot) + { + if (!mReplotQueued) + { + mReplotQueued = true; + QTimer::singleShot(0, this, SLOT(replot())); + } + return; + } + + if (mReplotting) // incase signals loop back to replot slot + return; + mReplotting = true; + mReplotQueued = false; + emit beforeReplot(); + + updateLayout(); + // draw all layered objects (grid, axes, plottables, items, legend,...) into their buffers: + setupPaintBuffers(); + foreach (QCPLayer *layer, mLayers) + layer->drawToPaintBuffer(); + for (int i=0; isetInvalidated(false); + + if ((refreshPriority == rpRefreshHint && mPlottingHints.testFlag(QCP::phImmediateRefresh)) || refreshPriority==rpImmediateRefresh) + repaint(); + else + update(); + + emit afterReplot(); + mReplotting = false; +} + +/*! + Rescales the axes such that all plottables (like graphs) in the plot are fully visible. + + if \a onlyVisiblePlottables is set to true, only the plottables that have their visibility set to true + (QCPLayerable::setVisible), will be used to rescale the axes. + + \see QCPAbstractPlottable::rescaleAxes, QCPAxis::rescale +*/ +void QCustomPlot::rescaleAxes(bool onlyVisiblePlottables) +{ + QList allAxes; + foreach (QCPAxisRect *rect, axisRects()) + allAxes << rect->axes(); + + foreach (QCPAxis *axis, allAxes) + axis->rescale(onlyVisiblePlottables); +} + +/*! + Saves a PDF with the vectorized plot to the file \a fileName. The axis ratio as well as the scale + of texts and lines will be derived from the specified \a width and \a height. This means, the + output will look like the normal on-screen output of a QCustomPlot widget with the corresponding + pixel width and height. If either \a width or \a height is zero, the exported image will have the + same dimensions as the QCustomPlot widget currently has. + + Setting \a exportPen to \ref QCP::epNoCosmetic allows to disable the use of cosmetic pens when + drawing to the PDF file. Cosmetic pens are pens with numerical width 0, which are always drawn as + a one pixel wide line, no matter what zoom factor is set in the PDF-Viewer. For more information + about cosmetic pens, see the QPainter and QPen documentation. + + The objects of the plot will appear in the current selection state. If you don't want any + selected objects to be painted in their selected look, deselect everything with \ref deselectAll + before calling this function. + + Returns true on success. + + \warning + \li If you plan on editing the exported PDF file with a vector graphics editor like Inkscape, it + is advised to set \a exportPen to \ref QCP::epNoCosmetic to avoid losing those cosmetic lines + (which might be quite many, because cosmetic pens are the default for e.g. axes and tick marks). + \li If calling this function inside the constructor of the parent of the QCustomPlot widget + (i.e. the MainWindow constructor, if QCustomPlot is inside the MainWindow), always provide + explicit non-zero widths and heights. If you leave \a width or \a height as 0 (default), this + function uses the current width and height of the QCustomPlot widget. However, in Qt, these + aren't defined yet inside the constructor, so you would get an image that has strange + widths/heights. + + \a pdfCreator and \a pdfTitle may be used to set the according metadata fields in the resulting + PDF file. + + \note On Android systems, this method does nothing and issues an according qDebug warning + message. This is also the case if for other reasons the define flag \c QT_NO_PRINTER is set. + + \see savePng, saveBmp, saveJpg, saveRastered +*/ +bool QCustomPlot::savePdf(const QString &fileName, int width, int height, QCP::ExportPen exportPen, const QString &pdfCreator, const QString &pdfTitle) +{ + bool success = false; +#ifdef QT_NO_PRINTER + Q_UNUSED(fileName) + Q_UNUSED(exportPen) + Q_UNUSED(width) + Q_UNUSED(height) + Q_UNUSED(pdfCreator) + Q_UNUSED(pdfTitle) + qDebug() << Q_FUNC_INFO << "Qt was built without printer support (QT_NO_PRINTER). PDF not created."; +#else + int newWidth, newHeight; + if (width == 0 || height == 0) + { + newWidth = this->width(); + newHeight = this->height(); + } else + { + newWidth = width; + newHeight = height; + } + + QPrinter printer(QPrinter::ScreenResolution); + printer.setOutputFileName(fileName); + printer.setOutputFormat(QPrinter::PdfFormat); + printer.setColorMode(QPrinter::Color); + printer.printEngine()->setProperty(QPrintEngine::PPK_Creator, pdfCreator); + printer.printEngine()->setProperty(QPrintEngine::PPK_DocumentName, pdfTitle); + QRect oldViewport = viewport(); + setViewport(QRect(0, 0, newWidth, newHeight)); +#if QT_VERSION < QT_VERSION_CHECK(5, 3, 0) + printer.setFullPage(true); + printer.setPaperSize(viewport().size(), QPrinter::DevicePixel); +#else + QPageLayout pageLayout; + pageLayout.setMode(QPageLayout::FullPageMode); + pageLayout.setOrientation(QPageLayout::Portrait); + pageLayout.setMargins(QMarginsF(0, 0, 0, 0)); + pageLayout.setPageSize(QPageSize(viewport().size(), QPageSize::Point, QString(), QPageSize::ExactMatch)); + printer.setPageLayout(pageLayout); +#endif + QCPPainter printpainter; + if (printpainter.begin(&printer)) + { + printpainter.setMode(QCPPainter::pmVectorized); + printpainter.setMode(QCPPainter::pmNoCaching); + printpainter.setMode(QCPPainter::pmNonCosmetic, exportPen==QCP::epNoCosmetic); + printpainter.setWindow(mViewport); + if (mBackgroundBrush.style() != Qt::NoBrush && + mBackgroundBrush.color() != Qt::white && + mBackgroundBrush.color() != Qt::transparent && + mBackgroundBrush.color().alpha() > 0) // draw pdf background color if not white/transparent + printpainter.fillRect(viewport(), mBackgroundBrush); + draw(&printpainter); + printpainter.end(); + success = true; + } + setViewport(oldViewport); +#endif // QT_NO_PRINTER + return success; +} + +/*! + Saves a PNG image file to \a fileName on disc. The output plot will have the dimensions \a width + and \a height in pixels, multiplied by \a scale. If either \a width or \a height is zero, the + current width and height of the QCustomPlot widget is used instead. Line widths and texts etc. + are not scaled up when larger widths/heights are used. If you want that effect, use the \a scale + parameter. + + For example, if you set both \a width and \a height to 100 and \a scale to 2, you will end up with an + image file of size 200*200 in which all graphical elements are scaled up by factor 2 (line widths, + texts, etc.). This scaling is not done by stretching a 100*100 image, the result will have full + 200*200 pixel resolution. + + If you use a high scaling factor, it is recommended to enable antialiasing for all elements by + temporarily setting \ref QCustomPlot::setAntialiasedElements to \ref QCP::aeAll as this allows + QCustomPlot to place objects with sub-pixel accuracy. + + image compression can be controlled with the \a quality parameter which must be between 0 and 100 + or -1 to use the default setting. + + The \a resolution will be written to the image file header and has no direct consequence for the + quality or the pixel size. However, if opening the image with a tool which respects the metadata, + it will be able to scale the image to match either a given size in real units of length (inch, + centimeters, etc.), or the target display DPI. You can specify in which units \a resolution is + given, by setting \a resolutionUnit. The \a resolution is converted to the format's expected + resolution unit internally. + + Returns true on success. If this function fails, most likely the PNG format isn't supported by + the system, see Qt docs about QImageWriter::supportedImageFormats(). + + The objects of the plot will appear in the current selection state. If you don't want any selected + objects to be painted in their selected look, deselect everything with \ref deselectAll before calling + this function. + + If you want the PNG to have a transparent background, call \ref setBackground(const QBrush &brush) + with no brush (Qt::NoBrush) or a transparent color (Qt::transparent), before saving. + + \warning If calling this function inside the constructor of the parent of the QCustomPlot widget + (i.e. the MainWindow constructor, if QCustomPlot is inside the MainWindow), always provide + explicit non-zero widths and heights. If you leave \a width or \a height as 0 (default), this + function uses the current width and height of the QCustomPlot widget. However, in Qt, these + aren't defined yet inside the constructor, so you would get an image that has strange + widths/heights. + + \see savePdf, saveBmp, saveJpg, saveRastered +*/ +bool QCustomPlot::savePng(const QString &fileName, int width, int height, double scale, int quality, int resolution, QCP::ResolutionUnit resolutionUnit) +{ + return saveRastered(fileName, width, height, scale, "PNG", quality, resolution, resolutionUnit); +} + +/*! + Saves a JPEG image file to \a fileName on disc. The output plot will have the dimensions \a width + and \a height in pixels, multiplied by \a scale. If either \a width or \a height is zero, the + current width and height of the QCustomPlot widget is used instead. Line widths and texts etc. + are not scaled up when larger widths/heights are used. If you want that effect, use the \a scale + parameter. + + For example, if you set both \a width and \a height to 100 and \a scale to 2, you will end up with an + image file of size 200*200 in which all graphical elements are scaled up by factor 2 (line widths, + texts, etc.). This scaling is not done by stretching a 100*100 image, the result will have full + 200*200 pixel resolution. + + If you use a high scaling factor, it is recommended to enable antialiasing for all elements by + temporarily setting \ref QCustomPlot::setAntialiasedElements to \ref QCP::aeAll as this allows + QCustomPlot to place objects with sub-pixel accuracy. + + image compression can be controlled with the \a quality parameter which must be between 0 and 100 + or -1 to use the default setting. + + The \a resolution will be written to the image file header and has no direct consequence for the + quality or the pixel size. However, if opening the image with a tool which respects the metadata, + it will be able to scale the image to match either a given size in real units of length (inch, + centimeters, etc.), or the target display DPI. You can specify in which units \a resolution is + given, by setting \a resolutionUnit. The \a resolution is converted to the format's expected + resolution unit internally. + + Returns true on success. If this function fails, most likely the JPEG format isn't supported by + the system, see Qt docs about QImageWriter::supportedImageFormats(). + + The objects of the plot will appear in the current selection state. If you don't want any selected + objects to be painted in their selected look, deselect everything with \ref deselectAll before calling + this function. + + \warning If calling this function inside the constructor of the parent of the QCustomPlot widget + (i.e. the MainWindow constructor, if QCustomPlot is inside the MainWindow), always provide + explicit non-zero widths and heights. If you leave \a width or \a height as 0 (default), this + function uses the current width and height of the QCustomPlot widget. However, in Qt, these + aren't defined yet inside the constructor, so you would get an image that has strange + widths/heights. + + \see savePdf, savePng, saveBmp, saveRastered +*/ +bool QCustomPlot::saveJpg(const QString &fileName, int width, int height, double scale, int quality, int resolution, QCP::ResolutionUnit resolutionUnit) +{ + return saveRastered(fileName, width, height, scale, "JPG", quality, resolution, resolutionUnit); +} + +/*! + Saves a BMP image file to \a fileName on disc. The output plot will have the dimensions \a width + and \a height in pixels, multiplied by \a scale. If either \a width or \a height is zero, the + current width and height of the QCustomPlot widget is used instead. Line widths and texts etc. + are not scaled up when larger widths/heights are used. If you want that effect, use the \a scale + parameter. + + For example, if you set both \a width and \a height to 100 and \a scale to 2, you will end up with an + image file of size 200*200 in which all graphical elements are scaled up by factor 2 (line widths, + texts, etc.). This scaling is not done by stretching a 100*100 image, the result will have full + 200*200 pixel resolution. + + If you use a high scaling factor, it is recommended to enable antialiasing for all elements by + temporarily setting \ref QCustomPlot::setAntialiasedElements to \ref QCP::aeAll as this allows + QCustomPlot to place objects with sub-pixel accuracy. + + The \a resolution will be written to the image file header and has no direct consequence for the + quality or the pixel size. However, if opening the image with a tool which respects the metadata, + it will be able to scale the image to match either a given size in real units of length (inch, + centimeters, etc.), or the target display DPI. You can specify in which units \a resolution is + given, by setting \a resolutionUnit. The \a resolution is converted to the format's expected + resolution unit internally. + + Returns true on success. If this function fails, most likely the BMP format isn't supported by + the system, see Qt docs about QImageWriter::supportedImageFormats(). + + The objects of the plot will appear in the current selection state. If you don't want any selected + objects to be painted in their selected look, deselect everything with \ref deselectAll before calling + this function. + + \warning If calling this function inside the constructor of the parent of the QCustomPlot widget + (i.e. the MainWindow constructor, if QCustomPlot is inside the MainWindow), always provide + explicit non-zero widths and heights. If you leave \a width or \a height as 0 (default), this + function uses the current width and height of the QCustomPlot widget. However, in Qt, these + aren't defined yet inside the constructor, so you would get an image that has strange + widths/heights. + + \see savePdf, savePng, saveJpg, saveRastered +*/ +bool QCustomPlot::saveBmp(const QString &fileName, int width, int height, double scale, int resolution, QCP::ResolutionUnit resolutionUnit) +{ + return saveRastered(fileName, width, height, scale, "BMP", -1, resolution, resolutionUnit); +} + +/*! \internal + + Returns a minimum size hint that corresponds to the minimum size of the top level layout + (\ref plotLayout). To prevent QCustomPlot from being collapsed to size/width zero, set a minimum + size (setMinimumSize) either on the whole QCustomPlot or on any layout elements inside the plot. + This is especially important, when placed in a QLayout where other components try to take in as + much space as possible (e.g. QMdiArea). +*/ +QSize QCustomPlot::minimumSizeHint() const +{ + return mPlotLayout->minimumOuterSizeHint(); +} + +/*! \internal + + Returns a size hint that is the same as \ref minimumSizeHint. + +*/ +QSize QCustomPlot::sizeHint() const +{ + return mPlotLayout->minimumOuterSizeHint(); +} + +/*! \internal + + Event handler for when the QCustomPlot widget needs repainting. This does not cause a \ref replot, but + draws the internal buffer on the widget surface. +*/ +void QCustomPlot::paintEvent(QPaintEvent *event) +{ + Q_UNUSED(event); + QCPPainter painter(this); + if (painter.isActive()) + { + painter.setRenderHint(QPainter::HighQualityAntialiasing); // to make Antialiasing look good if using the OpenGL graphicssystem + if (mBackgroundBrush.style() != Qt::NoBrush) + painter.fillRect(mViewport, mBackgroundBrush); + drawBackground(&painter); + for (int bufferIndex = 0; bufferIndex < mPaintBuffers.size(); ++bufferIndex) + mPaintBuffers.at(bufferIndex)->draw(&painter); + } +} + +/*! \internal + + Event handler for a resize of the QCustomPlot widget. The viewport (which becomes the outer rect + of mPlotLayout) is resized appropriately. Finally a \ref replot is performed. +*/ +void QCustomPlot::resizeEvent(QResizeEvent *event) +{ + Q_UNUSED(event) + // resize and repaint the buffer: + setViewport(rect()); + replot(rpQueuedRefresh); // queued refresh is important here, to prevent painting issues in some contexts (e.g. MDI subwindow) +} + +/*! \internal + + Event handler for when a double click occurs. Emits the \ref mouseDoubleClick signal, then + determines the layerable under the cursor and forwards the event to it. Finally, emits the + specialized signals when certain objecs are clicked (e.g. \ref plottableDoubleClick, \ref + axisDoubleClick, etc.). + + \see mousePressEvent, mouseReleaseEvent +*/ +void QCustomPlot::mouseDoubleClickEvent(QMouseEvent *event) +{ + emit mouseDoubleClick(event); + mMouseHasMoved = false; + mMousePressPos = event->pos(); + + // determine layerable under the cursor (this event is called instead of the second press event in a double-click): + QList details; + QList candidates = layerableListAt(mMousePressPos, false, &details); + for (int i=0; iaccept(); // default impl of QCPLayerable's mouse events ignore the event, in that case propagate to next candidate in list + candidates.at(i)->mouseDoubleClickEvent(event, details.at(i)); + if (event->isAccepted()) + { + mMouseEventLayerable = candidates.at(i); + mMouseEventLayerableDetails = details.at(i); + break; + } + } + + // emit specialized object double click signals: + if (!candidates.isEmpty()) + { + if (QCPAbstractPlottable *ap = qobject_cast(candidates.first())) + { + int dataIndex = 0; + if (!details.first().value().isEmpty()) + dataIndex = details.first().value().dataRange().begin(); + emit plottableDoubleClick(ap, dataIndex, event); + } else if (QCPAxis *ax = qobject_cast(candidates.first())) + emit axisDoubleClick(ax, details.first().value(), event); + else if (QCPAbstractItem *ai = qobject_cast(candidates.first())) + emit itemDoubleClick(ai, event); + else if (QCPLegend *lg = qobject_cast(candidates.first())) + emit legendDoubleClick(lg, 0, event); + else if (QCPAbstractLegendItem *li = qobject_cast(candidates.first())) + emit legendDoubleClick(li->parentLegend(), li, event); + } + + event->accept(); // in case QCPLayerable reimplementation manipulates event accepted state. In QWidget event system, QCustomPlot wants to accept the event. +} + +/*! \internal + + Event handler for when a mouse button is pressed. Emits the mousePress signal. + + If the current \ref setSelectionRectMode is not \ref QCP::srmNone, passes the event to the + selection rect. Otherwise determines the layerable under the cursor and forwards the event to it. + + \see mouseMoveEvent, mouseReleaseEvent +*/ +void QCustomPlot::mousePressEvent(QMouseEvent *event) +{ + emit mousePress(event); + // save some state to tell in releaseEvent whether it was a click: + mMouseHasMoved = false; + mMousePressPos = event->pos(); + + if (mSelectionRect && mSelectionRectMode != QCP::srmNone) + { + if (mSelectionRectMode != QCP::srmZoom || qobject_cast(axisRectAt(mMousePressPos))) // in zoom mode only activate selection rect if on an axis rect + mSelectionRect->startSelection(event); + } else + { + // no selection rect interaction, prepare for click signal emission and forward event to layerable under the cursor: + QList details; + QList candidates = layerableListAt(mMousePressPos, false, &details); + if (!candidates.isEmpty()) + { + mMouseSignalLayerable = candidates.first(); // candidate for signal emission is always topmost hit layerable (signal emitted in release event) + mMouseSignalLayerableDetails = details.first(); + } + // forward event to topmost candidate which accepts the event: + for (int i=0; iaccept(); // default impl of QCPLayerable's mouse events call ignore() on the event, in that case propagate to next candidate in list + candidates.at(i)->mousePressEvent(event, details.at(i)); + if (event->isAccepted()) + { + mMouseEventLayerable = candidates.at(i); + mMouseEventLayerableDetails = details.at(i); + break; + } + } + } + + event->accept(); // in case QCPLayerable reimplementation manipulates event accepted state. In QWidget event system, QCustomPlot wants to accept the event. +} + +/*! \internal + + Event handler for when the cursor is moved. Emits the \ref mouseMove signal. + + If the selection rect (\ref setSelectionRect) is currently active, the event is forwarded to it + in order to update the rect geometry. + + Otherwise, if a layout element has mouse capture focus (a mousePressEvent happened on top of the + layout element before), the mouseMoveEvent is forwarded to that element. + + \see mousePressEvent, mouseReleaseEvent +*/ +void QCustomPlot::mouseMoveEvent(QMouseEvent *event) +{ + emit mouseMove(event); + + if (!mMouseHasMoved && (mMousePressPos-event->pos()).manhattanLength() > 3) + mMouseHasMoved = true; // moved too far from mouse press position, don't handle as click on mouse release + + if (mSelectionRect && mSelectionRect->isActive()) + mSelectionRect->moveSelection(event); + else if (mMouseEventLayerable) // call event of affected layerable: + mMouseEventLayerable->mouseMoveEvent(event, mMousePressPos); + + event->accept(); // in case QCPLayerable reimplementation manipulates event accepted state. In QWidget event system, QCustomPlot wants to accept the event. +} + +/*! \internal + + Event handler for when a mouse button is released. Emits the \ref mouseRelease signal. + + If the mouse was moved less than a certain threshold in any direction since the \ref + mousePressEvent, it is considered a click which causes the selection mechanism (if activated via + \ref setInteractions) to possibly change selection states accordingly. Further, specialized mouse + click signals are emitted (e.g. \ref plottableClick, \ref axisClick, etc.) + + If a layerable is the mouse capturer (a \ref mousePressEvent happened on top of the layerable + before), the \ref mouseReleaseEvent is forwarded to that element. + + \see mousePressEvent, mouseMoveEvent +*/ +void QCustomPlot::mouseReleaseEvent(QMouseEvent *event) +{ + emit mouseRelease(event); + + if (!mMouseHasMoved) // mouse hasn't moved (much) between press and release, so handle as click + { + if (mSelectionRect && mSelectionRect->isActive()) // a simple click shouldn't successfully finish a selection rect, so cancel it here + mSelectionRect->cancel(); + if (event->button() == Qt::LeftButton) + processPointSelection(event); + + // emit specialized click signals of QCustomPlot instance: + if (QCPAbstractPlottable *ap = qobject_cast(mMouseSignalLayerable)) + { + int dataIndex = 0; + if (!mMouseSignalLayerableDetails.value().isEmpty()) + dataIndex = mMouseSignalLayerableDetails.value().dataRange().begin(); + emit plottableClick(ap, dataIndex, event); + } else if (QCPAxis *ax = qobject_cast(mMouseSignalLayerable)) + emit axisClick(ax, mMouseSignalLayerableDetails.value(), event); + else if (QCPAbstractItem *ai = qobject_cast(mMouseSignalLayerable)) + emit itemClick(ai, event); + else if (QCPLegend *lg = qobject_cast(mMouseSignalLayerable)) + emit legendClick(lg, 0, event); + else if (QCPAbstractLegendItem *li = qobject_cast(mMouseSignalLayerable)) + emit legendClick(li->parentLegend(), li, event); + mMouseSignalLayerable = 0; + } + + if (mSelectionRect && mSelectionRect->isActive()) // Note: if a click was detected above, the selection rect is canceled there + { + // finish selection rect, the appropriate action will be taken via signal-slot connection: + mSelectionRect->endSelection(event); + } else + { + // call event of affected layerable: + if (mMouseEventLayerable) + { + mMouseEventLayerable->mouseReleaseEvent(event, mMousePressPos); + mMouseEventLayerable = 0; + } + } + + if (noAntialiasingOnDrag()) + replot(rpQueuedReplot); + + event->accept(); // in case QCPLayerable reimplementation manipulates event accepted state. In QWidget event system, QCustomPlot wants to accept the event. +} + +/*! \internal + + Event handler for mouse wheel events. First, the \ref mouseWheel signal is emitted. Then + determines the affected layerable and forwards the event to it. +*/ +void QCustomPlot::wheelEvent(QWheelEvent *event) +{ + emit mouseWheel(event); + // forward event to layerable under cursor: + QList candidates = layerableListAt(event->pos(), false); + for (int i=0; iaccept(); // default impl of QCPLayerable's mouse events ignore the event, in that case propagate to next candidate in list + candidates.at(i)->wheelEvent(event); + if (event->isAccepted()) + break; + } + event->accept(); // in case QCPLayerable reimplementation manipulates event accepted state. In QWidget event system, QCustomPlot wants to accept the event. +} + +/*! \internal + + This function draws the entire plot, including background pixmap, with the specified \a painter. + It does not make use of the paint buffers like \ref replot, so this is the function typically + used by saving/exporting methods such as \ref savePdf or \ref toPainter. + + Note that it does not fill the background with the background brush (as the user may specify with + \ref setBackground(const QBrush &brush)), this is up to the respective functions calling this + method. +*/ +void QCustomPlot::draw(QCPPainter *painter) +{ + updateLayout(); + + // draw viewport background pixmap: + drawBackground(painter); + + // draw all layered objects (grid, axes, plottables, items, legend,...): + foreach (QCPLayer *layer, mLayers) + layer->draw(painter); + + /* Debug code to draw all layout element rects + foreach (QCPLayoutElement* el, findChildren()) + { + painter->setBrush(Qt::NoBrush); + painter->setPen(QPen(QColor(0, 0, 0, 100), 0, Qt::DashLine)); + painter->drawRect(el->rect()); + painter->setPen(QPen(QColor(255, 0, 0, 100), 0, Qt::DashLine)); + painter->drawRect(el->outerRect()); + } + */ +} + +/*! \internal + + Performs the layout update steps defined by \ref QCPLayoutElement::UpdatePhase, by calling \ref + QCPLayoutElement::update on the main plot layout. + + Here, the layout elements calculate their positions and margins, and prepare for the following + draw call. +*/ +void QCustomPlot::updateLayout() +{ + // run through layout phases: + mPlotLayout->update(QCPLayoutElement::upPreparation); + mPlotLayout->update(QCPLayoutElement::upMargins); + mPlotLayout->update(QCPLayoutElement::upLayout); +} + +/*! \internal + + Draws the viewport background pixmap of the plot. + + If a pixmap was provided via \ref setBackground, this function buffers the scaled version + depending on \ref setBackgroundScaled and \ref setBackgroundScaledMode and then draws it inside + the viewport with the provided \a painter. The scaled version is buffered in + mScaledBackgroundPixmap to prevent expensive rescaling at every redraw. It is only updated, when + the axis rect has changed in a way that requires a rescale of the background pixmap (this is + dependent on the \ref setBackgroundScaledMode), or when a differend axis background pixmap was + set. + + Note that this function does not draw a fill with the background brush + (\ref setBackground(const QBrush &brush)) beneath the pixmap. + + \see setBackground, setBackgroundScaled, setBackgroundScaledMode +*/ +void QCustomPlot::drawBackground(QCPPainter *painter) +{ + // Note: background color is handled in individual replot/save functions + + // draw background pixmap (on top of fill, if brush specified): + if (!mBackgroundPixmap.isNull()) + { + if (mBackgroundScaled) + { + // check whether mScaledBackground needs to be updated: + QSize scaledSize(mBackgroundPixmap.size()); + scaledSize.scale(mViewport.size(), mBackgroundScaledMode); + if (mScaledBackgroundPixmap.size() != scaledSize) + mScaledBackgroundPixmap = mBackgroundPixmap.scaled(mViewport.size(), mBackgroundScaledMode, Qt::SmoothTransformation); + painter->drawPixmap(mViewport.topLeft(), mScaledBackgroundPixmap, QRect(0, 0, mViewport.width(), mViewport.height()) & mScaledBackgroundPixmap.rect()); + } else + { + painter->drawPixmap(mViewport.topLeft(), mBackgroundPixmap, QRect(0, 0, mViewport.width(), mViewport.height())); + } + } +} + +/*! \internal + + Goes through the layers and makes sure this QCustomPlot instance holds the correct number of + paint buffers and that they have the correct configuration (size, pixel ratio, etc.). + Allocations, reallocations and deletions of paint buffers are performed as necessary. It also + associates the paint buffers with the layers, so they draw themselves into the right buffer when + \ref QCPLayer::drawToPaintBuffer is called. This means it associates adjacent \ref + QCPLayer::lmLogical layers to a mutual paint buffer and creates dedicated paint buffers for + layers in \ref QCPLayer::lmBuffered mode. + + This method uses \ref createPaintBuffer to create new paint buffers. + + After this method, the paint buffers are empty (filled with \c Qt::transparent) and invalidated + (so an attempt to replot only a single buffered layer causes a full replot). + + This method is called in every \ref replot call, prior to actually drawing the layers (into their + associated paint buffer). If the paint buffers don't need changing/reallocating, this method + basically leaves them alone and thus finishes very fast. +*/ +void QCustomPlot::setupPaintBuffers() +{ + int bufferIndex = 0; + if (mPaintBuffers.isEmpty()) + mPaintBuffers.append(QSharedPointer(createPaintBuffer())); + + for (int layerIndex = 0; layerIndex < mLayers.size(); ++layerIndex) + { + QCPLayer *layer = mLayers.at(layerIndex); + if (layer->mode() == QCPLayer::lmLogical) + { + layer->mPaintBuffer = mPaintBuffers.at(bufferIndex).toWeakRef(); + } else if (layer->mode() == QCPLayer::lmBuffered) + { + ++bufferIndex; + if (bufferIndex >= mPaintBuffers.size()) + mPaintBuffers.append(QSharedPointer(createPaintBuffer())); + layer->mPaintBuffer = mPaintBuffers.at(bufferIndex).toWeakRef(); + if (layerIndex < mLayers.size()-1 && mLayers.at(layerIndex+1)->mode() == QCPLayer::lmLogical) // not last layer, and next one is logical, so prepare another buffer for next layerables + { + ++bufferIndex; + if (bufferIndex >= mPaintBuffers.size()) + mPaintBuffers.append(QSharedPointer(createPaintBuffer())); + } + } + } + // remove unneeded buffers: + while (mPaintBuffers.size()-1 > bufferIndex) + mPaintBuffers.removeLast(); + // resize buffers to viewport size and clear contents: + for (int i=0; isetSize(viewport().size()); // won't do anything if already correct size + mPaintBuffers.at(i)->clear(Qt::transparent); + mPaintBuffers.at(i)->setInvalidated(); + } +} + +/*! \internal + + This method is used by \ref setupPaintBuffers when it needs to create new paint buffers. + + Depending on the current setting of \ref setOpenGl, and the current Qt version, different + backends (subclasses of \ref QCPAbstractPaintBuffer) are created, initialized with the proper + size and device pixel ratio, and returned. +*/ +QCPAbstractPaintBuffer *QCustomPlot::createPaintBuffer() +{ + if (mOpenGl) + { +#if defined(QCP_OPENGL_FBO) + return new QCPPaintBufferGlFbo(viewport().size(), mBufferDevicePixelRatio, mGlContext, mGlPaintDevice); +#elif defined(QCP_OPENGL_PBUFFER) + return new QCPPaintBufferGlPbuffer(viewport().size(), mBufferDevicePixelRatio, mOpenGlMultisamples); +#else + qDebug() << Q_FUNC_INFO << "OpenGL enabled even though no support for it compiled in, this shouldn't have happened. Falling back to pixmap paint buffer."; + return new QCPPaintBufferPixmap(viewport().size(), mBufferDevicePixelRatio); +#endif + } else + return new QCPPaintBufferPixmap(viewport().size(), mBufferDevicePixelRatio); +} + +/*! + This method returns whether any of the paint buffers held by this QCustomPlot instance are + invalidated. + + If any buffer is invalidated, a partial replot (\ref QCPLayer::replot) is not allowed and always + causes a full replot (\ref QCustomPlot::replot) of all layers. This is the case when for example + the layer order has changed, new layers were added, layers were removed, or layer modes were + changed (\ref QCPLayer::setMode). + + \see QCPAbstractPaintBuffer::setInvalidated +*/ +bool QCustomPlot::hasInvalidatedPaintBuffers() +{ + for (int i=0; iinvalidated()) + return true; + } + return false; +} + +/*! \internal + + When \ref setOpenGl is set to true, this method is used to initialize OpenGL (create a context, + surface, paint device). + + Returns true on success. + + If this method is successful, all paint buffers should be deleted and then reallocated by calling + \ref setupPaintBuffers, so the OpenGL-based paint buffer subclasses (\ref + QCPPaintBufferGlPbuffer, \ref QCPPaintBufferGlFbo) are used for subsequent replots. + + \see freeOpenGl +*/ +bool QCustomPlot::setupOpenGl() +{ +#ifdef QCP_OPENGL_FBO + freeOpenGl(); + QSurfaceFormat proposedSurfaceFormat; + proposedSurfaceFormat.setSamples(mOpenGlMultisamples); +#ifdef QCP_OPENGL_OFFSCREENSURFACE + QOffscreenSurface *surface = new QOffscreenSurface; +#else + QWindow *surface = new QWindow; + surface->setSurfaceType(QSurface::OpenGLSurface); +#endif + surface->setFormat(proposedSurfaceFormat); + surface->create(); + mGlSurface = QSharedPointer(surface); + mGlContext = QSharedPointer(new QOpenGLContext); + mGlContext->setFormat(mGlSurface->format()); + if (!mGlContext->create()) + { + qDebug() << Q_FUNC_INFO << "Failed to create OpenGL context"; + mGlContext.clear(); + mGlSurface.clear(); + return false; + } + if (!mGlContext->makeCurrent(mGlSurface.data())) // context needs to be current to create paint device + { + qDebug() << Q_FUNC_INFO << "Failed to make opengl context current"; + mGlContext.clear(); + mGlSurface.clear(); + return false; + } + if (!QOpenGLFramebufferObject::hasOpenGLFramebufferObjects()) + { + qDebug() << Q_FUNC_INFO << "OpenGL of this system doesn't support frame buffer objects"; + mGlContext.clear(); + mGlSurface.clear(); + return false; + } + mGlPaintDevice = QSharedPointer(new QOpenGLPaintDevice); + return true; +#elif defined(QCP_OPENGL_PBUFFER) + return QGLFormat::hasOpenGL(); +#else + return false; +#endif +} + +/*! \internal + + When \ref setOpenGl is set to false, this method is used to deinitialize OpenGL (releases the + context and frees resources). + + After OpenGL is disabled, all paint buffers should be deleted and then reallocated by calling + \ref setupPaintBuffers, so the standard software rendering paint buffer subclass (\ref + QCPPaintBufferPixmap) is used for subsequent replots. + + \see setupOpenGl +*/ +void QCustomPlot::freeOpenGl() +{ +#ifdef QCP_OPENGL_FBO + mGlPaintDevice.clear(); + mGlContext.clear(); + mGlSurface.clear(); +#endif +} + +/*! \internal + + This method is used by \ref QCPAxisRect::removeAxis to report removed axes to the QCustomPlot + so it may clear its QCustomPlot::xAxis, yAxis, xAxis2 and yAxis2 members accordingly. +*/ +void QCustomPlot::axisRemoved(QCPAxis *axis) +{ + if (xAxis == axis) + xAxis = 0; + if (xAxis2 == axis) + xAxis2 = 0; + if (yAxis == axis) + yAxis = 0; + if (yAxis2 == axis) + yAxis2 = 0; + + // Note: No need to take care of range drag axes and range zoom axes, because they are stored in smart pointers +} + +/*! \internal + + This method is used by the QCPLegend destructor to report legend removal to the QCustomPlot so + it may clear its QCustomPlot::legend member accordingly. +*/ +void QCustomPlot::legendRemoved(QCPLegend *legend) +{ + if (this->legend == legend) + this->legend = 0; +} + +/*! \internal + + This slot is connected to the selection rect's \ref QCPSelectionRect::accepted signal when \ref + setSelectionRectMode is set to \ref QCP::srmSelect. + + First, it determines which axis rect was the origin of the selection rect judging by the starting + point of the selection. Then it goes through the plottables (\ref QCPAbstractPlottable1D to be + precise) associated with that axis rect and finds the data points that are in \a rect. It does + this by querying their \ref QCPAbstractPlottable1D::selectTestRect method. + + Then, the actual selection is done by calling the plottables' \ref + QCPAbstractPlottable::selectEvent, placing the found selected data points in the \a details + parameter as QVariant(\ref QCPDataSelection). All plottables that weren't touched by \a + rect receive a \ref QCPAbstractPlottable::deselectEvent. + + \see processRectZoom +*/ +void QCustomPlot::processRectSelection(QRect rect, QMouseEvent *event) +{ + bool selectionStateChanged = false; + + if (mInteractions.testFlag(QCP::iSelectPlottables)) + { + QMap > potentialSelections; // map key is number of selected data points, so we have selections sorted by size + QRectF rectF(rect.normalized()); + if (QCPAxisRect *affectedAxisRect = axisRectAt(rectF.topLeft())) + { + // determine plottables that were hit by the rect and thus are candidates for selection: + foreach (QCPAbstractPlottable *plottable, affectedAxisRect->plottables()) + { + if (QCPPlottableInterface1D *plottableInterface = plottable->interface1D()) + { + QCPDataSelection dataSel = plottableInterface->selectTestRect(rectF, true); + if (!dataSel.isEmpty()) + potentialSelections.insertMulti(dataSel.dataPointCount(), QPair(plottable, dataSel)); + } + } + + if (!mInteractions.testFlag(QCP::iMultiSelect)) + { + // only leave plottable with most selected points in map, since we will only select a single plottable: + if (!potentialSelections.isEmpty()) + { + QMap >::iterator it = potentialSelections.begin(); + while (it != potentialSelections.end()-1) // erase all except last element + it = potentialSelections.erase(it); + } + } + + bool additive = event->modifiers().testFlag(mMultiSelectModifier); + // deselect all other layerables if not additive selection: + if (!additive) + { + // emit deselection except to those plottables who will be selected afterwards: + foreach (QCPLayer *layer, mLayers) + { + foreach (QCPLayerable *layerable, layer->children()) + { + if ((potentialSelections.isEmpty() || potentialSelections.constBegin()->first != layerable) && mInteractions.testFlag(layerable->selectionCategory())) + { + bool selChanged = false; + layerable->deselectEvent(&selChanged); + selectionStateChanged |= selChanged; + } + } + } + } + + // go through selections in reverse (largest selection first) and emit select events: + QMap >::const_iterator it = potentialSelections.constEnd(); + while (it != potentialSelections.constBegin()) + { + --it; + if (mInteractions.testFlag(it.value().first->selectionCategory())) + { + bool selChanged = false; + it.value().first->selectEvent(event, additive, QVariant::fromValue(it.value().second), &selChanged); + selectionStateChanged |= selChanged; + } + } + } + } + + if (selectionStateChanged) + { + emit selectionChangedByUser(); + replot(rpQueuedReplot); + } else if (mSelectionRect) + mSelectionRect->layer()->replot(); +} + +/*! \internal + + This slot is connected to the selection rect's \ref QCPSelectionRect::accepted signal when \ref + setSelectionRectMode is set to \ref QCP::srmZoom. + + It determines which axis rect was the origin of the selection rect judging by the starting point + of the selection, and then zooms the axes defined via \ref QCPAxisRect::setRangeZoomAxes to the + provided \a rect (see \ref QCPAxisRect::zoom). + + \see processRectSelection +*/ +void QCustomPlot::processRectZoom(QRect rect, QMouseEvent *event) +{ + Q_UNUSED(event) + if (QCPAxisRect *axisRect = axisRectAt(rect.topLeft())) + { + QList affectedAxes = QList() << axisRect->rangeZoomAxes(Qt::Horizontal) << axisRect->rangeZoomAxes(Qt::Vertical); + affectedAxes.removeAll(static_cast(0)); + axisRect->zoom(QRectF(rect), affectedAxes); + } + replot(rpQueuedReplot); // always replot to make selection rect disappear +} + +/*! \internal + + This method is called when a simple left mouse click was detected on the QCustomPlot surface. + + It first determines the layerable that was hit by the click, and then calls its \ref + QCPLayerable::selectEvent. All other layerables receive a QCPLayerable::deselectEvent (unless the + multi-select modifier was pressed, see \ref setMultiSelectModifier). + + In this method the hit layerable is determined a second time using \ref layerableAt (after the + one in \ref mousePressEvent), because we want \a onlySelectable set to true this time. This + implies that the mouse event grabber (mMouseEventLayerable) may be a different one from the + clicked layerable determined here. For example, if a non-selectable layerable is in front of a + selectable layerable at the click position, the front layerable will receive mouse events but the + selectable one in the back will receive the \ref QCPLayerable::selectEvent. + + \see processRectSelection, QCPLayerable::selectTest +*/ +void QCustomPlot::processPointSelection(QMouseEvent *event) +{ + QVariant details; + QCPLayerable *clickedLayerable = layerableAt(event->pos(), true, &details); + bool selectionStateChanged = false; + bool additive = mInteractions.testFlag(QCP::iMultiSelect) && event->modifiers().testFlag(mMultiSelectModifier); + // deselect all other layerables if not additive selection: + if (!additive) + { + foreach (QCPLayer *layer, mLayers) + { + foreach (QCPLayerable *layerable, layer->children()) + { + if (layerable != clickedLayerable && mInteractions.testFlag(layerable->selectionCategory())) + { + bool selChanged = false; + layerable->deselectEvent(&selChanged); + selectionStateChanged |= selChanged; + } + } + } + } + if (clickedLayerable && mInteractions.testFlag(clickedLayerable->selectionCategory())) + { + // a layerable was actually clicked, call its selectEvent: + bool selChanged = false; + clickedLayerable->selectEvent(event, additive, details, &selChanged); + selectionStateChanged |= selChanged; + } + if (selectionStateChanged) + { + emit selectionChangedByUser(); + replot(rpQueuedReplot); + } +} + +/*! \internal + + Registers the specified plottable with this QCustomPlot and, if \ref setAutoAddPlottableToLegend + is enabled, adds it to the legend (QCustomPlot::legend). QCustomPlot takes ownership of the + plottable. + + Returns true on success, i.e. when \a plottable isn't already in this plot and the parent plot of + \a plottable is this QCustomPlot. + + This method is called automatically in the QCPAbstractPlottable base class constructor. +*/ +bool QCustomPlot::registerPlottable(QCPAbstractPlottable *plottable) +{ + if (mPlottables.contains(plottable)) + { + qDebug() << Q_FUNC_INFO << "plottable already added to this QCustomPlot:" << reinterpret_cast(plottable); + return false; + } + if (plottable->parentPlot() != this) + { + qDebug() << Q_FUNC_INFO << "plottable not created with this QCustomPlot as parent:" << reinterpret_cast(plottable); + return false; + } + + mPlottables.append(plottable); + // possibly add plottable to legend: + if (mAutoAddPlottableToLegend) + plottable->addToLegend(); + if (!plottable->layer()) // usually the layer is already set in the constructor of the plottable (via QCPLayerable constructor) + plottable->setLayer(currentLayer()); + return true; +} + +/*! \internal + + In order to maintain the simplified graph interface of QCustomPlot, this method is called by the + QCPGraph constructor to register itself with this QCustomPlot's internal graph list. Returns true + on success, i.e. if \a graph is valid and wasn't already registered with this QCustomPlot. + + This graph specific registration happens in addition to the call to \ref registerPlottable by the + QCPAbstractPlottable base class. +*/ +bool QCustomPlot::registerGraph(QCPGraph *graph) +{ + if (!graph) + { + qDebug() << Q_FUNC_INFO << "passed graph is zero"; + return false; + } + if (mGraphs.contains(graph)) + { + qDebug() << Q_FUNC_INFO << "graph already registered with this QCustomPlot"; + return false; + } + + mGraphs.append(graph); + return true; +} + + +/*! \internal + + Registers the specified item with this QCustomPlot. QCustomPlot takes ownership of the item. + + Returns true on success, i.e. when \a item wasn't already in the plot and the parent plot of \a + item is this QCustomPlot. + + This method is called automatically in the QCPAbstractItem base class constructor. +*/ +bool QCustomPlot::registerItem(QCPAbstractItem *item) +{ + if (mItems.contains(item)) + { + qDebug() << Q_FUNC_INFO << "item already added to this QCustomPlot:" << reinterpret_cast(item); + return false; + } + if (item->parentPlot() != this) + { + qDebug() << Q_FUNC_INFO << "item not created with this QCustomPlot as parent:" << reinterpret_cast(item); + return false; + } + + mItems.append(item); + if (!item->layer()) // usually the layer is already set in the constructor of the item (via QCPLayerable constructor) + item->setLayer(currentLayer()); + return true; +} + +/*! \internal + + Assigns all layers their index (QCPLayer::mIndex) in the mLayers list. This method is thus called + after every operation that changes the layer indices, like layer removal, layer creation, layer + moving. +*/ +void QCustomPlot::updateLayerIndices() const +{ + for (int i=0; imIndex = i; +} + +/*! \internal + + Returns the top-most layerable at pixel position \a pos. If \a onlySelectable is set to true, + only those layerables that are selectable will be considered. (Layerable subclasses communicate + their selectability via the QCPLayerable::selectTest method, by returning -1.) + + \a selectionDetails is an output parameter that contains selection specifics of the affected + layerable. This is useful if the respective layerable shall be given a subsequent + QCPLayerable::selectEvent (like in \ref mouseReleaseEvent). \a selectionDetails usually contains + information about which part of the layerable was hit, in multi-part layerables (e.g. + QCPAxis::SelectablePart). If the layerable is a plottable, \a selectionDetails contains a \ref + QCPDataSelection instance with the single data point which is closest to \a pos. + + \see layerableListAt, layoutElementAt, axisRectAt +*/ +QCPLayerable *QCustomPlot::layerableAt(const QPointF &pos, bool onlySelectable, QVariant *selectionDetails) const +{ + QList details; + QList candidates = layerableListAt(pos, onlySelectable, selectionDetails ? &details : 0); + if (selectionDetails && !details.isEmpty()) + *selectionDetails = details.first(); + if (!candidates.isEmpty()) + return candidates.first(); + else + return 0; +} + +/*! \internal + + Returns the layerables at pixel position \a pos. If \a onlySelectable is set to true, only those + layerables that are selectable will be considered. (Layerable subclasses communicate their + selectability via the QCPLayerable::selectTest method, by returning -1.) + + The returned list is sorted by the layerable/drawing order. If you only need to know the top-most + layerable, rather use \ref layerableAt. + + \a selectionDetails is an output parameter that contains selection specifics of the affected + layerable. This is useful if the respective layerable shall be given a subsequent + QCPLayerable::selectEvent (like in \ref mouseReleaseEvent). \a selectionDetails usually contains + information about which part of the layerable was hit, in multi-part layerables (e.g. + QCPAxis::SelectablePart). If the layerable is a plottable, \a selectionDetails contains a \ref + QCPDataSelection instance with the single data point which is closest to \a pos. + + \see layerableAt, layoutElementAt, axisRectAt +*/ +QList QCustomPlot::layerableListAt(const QPointF &pos, bool onlySelectable, QList *selectionDetails) const +{ + QList result; + for (int layerIndex=mLayers.size()-1; layerIndex>=0; --layerIndex) + { + const QList layerables = mLayers.at(layerIndex)->children(); + for (int i=layerables.size()-1; i>=0; --i) + { + if (!layerables.at(i)->realVisibility()) + continue; + QVariant details; + double dist = layerables.at(i)->selectTest(pos, onlySelectable, selectionDetails ? &details : 0); + if (dist >= 0 && dist < selectionTolerance()) + { + result.append(layerables.at(i)); + if (selectionDetails) + selectionDetails->append(details); + } + } + } + return result; +} + +/*! + Saves the plot to a rastered image file \a fileName in the image format \a format. The plot is + sized to \a width and \a height in pixels and scaled with \a scale. (width 100 and scale 2.0 lead + to a full resolution file with width 200.) If the \a format supports compression, \a quality may + be between 0 and 100 to control it. + + Returns true on success. If this function fails, most likely the given \a format isn't supported + by the system, see Qt docs about QImageWriter::supportedImageFormats(). + + The \a resolution will be written to the image file header (if the file format supports this) and + has no direct consequence for the quality or the pixel size. However, if opening the image with a + tool which respects the metadata, it will be able to scale the image to match either a given size + in real units of length (inch, centimeters, etc.), or the target display DPI. You can specify in + which units \a resolution is given, by setting \a resolutionUnit. The \a resolution is converted + to the format's expected resolution unit internally. + + \see saveBmp, saveJpg, savePng, savePdf +*/ +bool QCustomPlot::saveRastered(const QString &fileName, int width, int height, double scale, const char *format, int quality, int resolution, QCP::ResolutionUnit resolutionUnit) +{ + QImage buffer = toPixmap(width, height, scale).toImage(); + + int dotsPerMeter = 0; + switch (resolutionUnit) + { + case QCP::ruDotsPerMeter: dotsPerMeter = resolution; break; + case QCP::ruDotsPerCentimeter: dotsPerMeter = resolution*100; break; + case QCP::ruDotsPerInch: dotsPerMeter = resolution/0.0254; break; + } + buffer.setDotsPerMeterX(dotsPerMeter); // this is saved together with some image formats, e.g. PNG, and is relevant when opening image in other tools + buffer.setDotsPerMeterY(dotsPerMeter); // this is saved together with some image formats, e.g. PNG, and is relevant when opening image in other tools + if (!buffer.isNull()) + return buffer.save(fileName, format, quality); + else + return false; +} + +/*! + Renders the plot to a pixmap and returns it. + + The plot is sized to \a width and \a height in pixels and scaled with \a scale. (width 100 and + scale 2.0 lead to a full resolution pixmap with width 200.) + + \see toPainter, saveRastered, saveBmp, savePng, saveJpg, savePdf +*/ +QPixmap QCustomPlot::toPixmap(int width, int height, double scale) +{ + // this method is somewhat similar to toPainter. Change something here, and a change in toPainter might be necessary, too. + int newWidth, newHeight; + if (width == 0 || height == 0) + { + newWidth = this->width(); + newHeight = this->height(); + } else + { + newWidth = width; + newHeight = height; + } + int scaledWidth = qRound(scale*newWidth); + int scaledHeight = qRound(scale*newHeight); + + QPixmap result(scaledWidth, scaledHeight); + result.fill(mBackgroundBrush.style() == Qt::SolidPattern ? mBackgroundBrush.color() : Qt::transparent); // if using non-solid pattern, make transparent now and draw brush pattern later + QCPPainter painter; + painter.begin(&result); + if (painter.isActive()) + { + QRect oldViewport = viewport(); + setViewport(QRect(0, 0, newWidth, newHeight)); + painter.setMode(QCPPainter::pmNoCaching); + if (!qFuzzyCompare(scale, 1.0)) + { + if (scale > 1.0) // for scale < 1 we always want cosmetic pens where possible, because else lines might disappear for very small scales + painter.setMode(QCPPainter::pmNonCosmetic); + painter.scale(scale, scale); + } + if (mBackgroundBrush.style() != Qt::SolidPattern && mBackgroundBrush.style() != Qt::NoBrush) // solid fills were done a few lines above with QPixmap::fill + painter.fillRect(mViewport, mBackgroundBrush); + draw(&painter); + setViewport(oldViewport); + painter.end(); + } else // might happen if pixmap has width or height zero + { + qDebug() << Q_FUNC_INFO << "Couldn't activate painter on pixmap"; + return QPixmap(); + } + return result; +} + +/*! + Renders the plot using the passed \a painter. + + The plot is sized to \a width and \a height in pixels. If the \a painter's scale is not 1.0, the resulting plot will + appear scaled accordingly. + + \note If you are restricted to using a QPainter (instead of QCPPainter), create a temporary QPicture and open a QCPPainter + on it. Then call \ref toPainter with this QCPPainter. After ending the paint operation on the picture, draw it with + the QPainter. This will reproduce the painter actions the QCPPainter took, with a QPainter. + + \see toPixmap +*/ +void QCustomPlot::toPainter(QCPPainter *painter, int width, int height) +{ + // this method is somewhat similar to toPixmap. Change something here, and a change in toPixmap might be necessary, too. + int newWidth, newHeight; + if (width == 0 || height == 0) + { + newWidth = this->width(); + newHeight = this->height(); + } else + { + newWidth = width; + newHeight = height; + } + + if (painter->isActive()) + { + QRect oldViewport = viewport(); + setViewport(QRect(0, 0, newWidth, newHeight)); + painter->setMode(QCPPainter::pmNoCaching); + if (mBackgroundBrush.style() != Qt::NoBrush) // unlike in toPixmap, we can't do QPixmap::fill for Qt::SolidPattern brush style, so we also draw solid fills with fillRect here + painter->fillRect(mViewport, mBackgroundBrush); + draw(painter); + setViewport(oldViewport); + } else + qDebug() << Q_FUNC_INFO << "Passed painter is not active"; +} +/* end of 'src/core.cpp' */ + +//amalgamation: add plottable1d.cpp + +/* including file 'src/colorgradient.cpp', size 25342 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPColorGradient +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPColorGradient + \brief Defines a color gradient for use with e.g. \ref QCPColorMap + + This class describes a color gradient which can be used to encode data with color. For example, + QCPColorMap and QCPColorScale have \ref QCPColorMap::setGradient "setGradient" methods which + take an instance of this class. Colors are set with \ref setColorStopAt(double position, const QColor &color) + with a \a position from 0 to 1. In between these defined color positions, the + color will be interpolated linearly either in RGB or HSV space, see \ref setColorInterpolation. + + Alternatively, load one of the preset color gradients shown in the image below, with \ref + loadPreset, or by directly specifying the preset in the constructor. + + Apart from red, green and blue components, the gradient also interpolates the alpha values of the + configured color stops. This allows to display some portions of the data range as transparent in + the plot. + + \image html QCPColorGradient.png + + The \ref QCPColorGradient(GradientPreset preset) constructor allows directly converting a \ref + GradientPreset to a QCPColorGradient. This means that you can directly pass \ref GradientPreset + to all the \a setGradient methods, e.g.: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcolorgradient-setgradient + + The total number of levels used in the gradient can be set with \ref setLevelCount. Whether the + color gradient shall be applied periodically (wrapping around) to data values that lie outside + the data range specified on the plottable instance can be controlled with \ref setPeriodic. +*/ + +/*! + Constructs a new, empty QCPColorGradient with no predefined color stops. You can add own color + stops with \ref setColorStopAt. + + The color level count is initialized to 350. +*/ +QCPColorGradient::QCPColorGradient() : + mLevelCount(350), + mColorInterpolation(ciRGB), + mPeriodic(false), + mColorBufferInvalidated(true) +{ + mColorBuffer.fill(qRgb(0, 0, 0), mLevelCount); +} + +/*! + Constructs a new QCPColorGradient initialized with the colors and color interpolation according + to \a preset. + + The color level count is initialized to 350. +*/ +QCPColorGradient::QCPColorGradient(GradientPreset preset) : + mLevelCount(350), + mColorInterpolation(ciRGB), + mPeriodic(false), + mColorBufferInvalidated(true) +{ + mColorBuffer.fill(qRgb(0, 0, 0), mLevelCount); + loadPreset(preset); +} + +/* undocumented operator */ +bool QCPColorGradient::operator==(const QCPColorGradient &other) const +{ + return ((other.mLevelCount == this->mLevelCount) && + (other.mColorInterpolation == this->mColorInterpolation) && + (other.mPeriodic == this->mPeriodic) && + (other.mColorStops == this->mColorStops)); +} + +/*! + Sets the number of discretization levels of the color gradient to \a n. The default is 350 which + is typically enough to create a smooth appearance. The minimum number of levels is 2. + + \image html QCPColorGradient-levelcount.png +*/ +void QCPColorGradient::setLevelCount(int n) +{ + if (n < 2) + { + qDebug() << Q_FUNC_INFO << "n must be greater or equal 2 but was" << n; + n = 2; + } + if (n != mLevelCount) + { + mLevelCount = n; + mColorBufferInvalidated = true; + } +} + +/*! + Sets at which positions from 0 to 1 which color shall occur. The positions are the keys, the + colors are the values of the passed QMap \a colorStops. In between these color stops, the color + is interpolated according to \ref setColorInterpolation. + + A more convenient way to create a custom gradient may be to clear all color stops with \ref + clearColorStops (or creating a new, empty QCPColorGradient) and then adding them one by one with + \ref setColorStopAt. + + \see clearColorStops +*/ +void QCPColorGradient::setColorStops(const QMap &colorStops) +{ + mColorStops = colorStops; + mColorBufferInvalidated = true; +} + +/*! + Sets the \a color the gradient will have at the specified \a position (from 0 to 1). In between + these color stops, the color is interpolated according to \ref setColorInterpolation. + + \see setColorStops, clearColorStops +*/ +void QCPColorGradient::setColorStopAt(double position, const QColor &color) +{ + mColorStops.insert(position, color); + mColorBufferInvalidated = true; +} + +/*! + Sets whether the colors in between the configured color stops (see \ref setColorStopAt) shall be + interpolated linearly in RGB or in HSV color space. + + For example, a sweep in RGB space from red to green will have a muddy brown intermediate color, + whereas in HSV space the intermediate color is yellow. +*/ +void QCPColorGradient::setColorInterpolation(QCPColorGradient::ColorInterpolation interpolation) +{ + if (interpolation != mColorInterpolation) + { + mColorInterpolation = interpolation; + mColorBufferInvalidated = true; + } +} + +/*! + Sets whether data points that are outside the configured data range (e.g. \ref + QCPColorMap::setDataRange) are colored by periodically repeating the color gradient or whether + they all have the same color, corresponding to the respective gradient boundary color. + + \image html QCPColorGradient-periodic.png + + As shown in the image above, gradients that have the same start and end color are especially + suitable for a periodic gradient mapping, since they produce smooth color transitions throughout + the color map. A preset that has this property is \ref gpHues. + + In practice, using periodic color gradients makes sense when the data corresponds to a periodic + dimension, such as an angle or a phase. If this is not the case, the color encoding might become + ambiguous, because multiple different data values are shown as the same color. +*/ +void QCPColorGradient::setPeriodic(bool enabled) +{ + mPeriodic = enabled; +} + +/*! \overload + + This method is used to quickly convert a \a data array to colors. The colors will be output in + the array \a scanLine. Both \a data and \a scanLine must have the length \a n when passed to this + function. The data range that shall be used for mapping the data value to the gradient is passed + in \a range. \a logarithmic indicates whether the data values shall be mapped to colors + logarithmically. + + if \a data actually contains 2D-data linearized via [row*columnCount + column], you can + set \a dataIndexFactor to columnCount to convert a column instead of a row of the data + array, in \a scanLine. \a scanLine will remain a regular (1D) array. This works because \a data + is addressed data[i*dataIndexFactor]. + + Use the overloaded method to additionally provide alpha map data. + + The QRgb values that are placed in \a scanLine have their r, g and b components premultiplied + with alpha (see QImage::Format_ARGB32_Premultiplied). +*/ +void QCPColorGradient::colorize(const double *data, const QCPRange &range, QRgb *scanLine, int n, int dataIndexFactor, bool logarithmic) +{ + // If you change something here, make sure to also adapt color() and the other colorize() overload + if (!data) + { + qDebug() << Q_FUNC_INFO << "null pointer given as data"; + return; + } + if (!scanLine) + { + qDebug() << Q_FUNC_INFO << "null pointer given as scanLine"; + return; + } + if (mColorBufferInvalidated) + updateColorBuffer(); + + if (!logarithmic) + { + const double posToIndexFactor = (mLevelCount-1)/range.size(); + if (mPeriodic) + { + for (int i=0; i= mLevelCount) + index = mLevelCount-1; + scanLine[i] = mColorBuffer.at(index); + } + } + } else // logarithmic == true + { + if (mPeriodic) + { + for (int i=0; i= mLevelCount) + index = mLevelCount-1; + scanLine[i] = mColorBuffer.at(index); + } + } + } +} + +/*! \overload + + Additionally to the other overload of \ref colorize, this method takes the array \a alpha, which + has the same size and structure as \a data and encodes the alpha information per data point. + + The QRgb values that are placed in \a scanLine have their r, g and b components premultiplied + with alpha (see QImage::Format_ARGB32_Premultiplied). +*/ +void QCPColorGradient::colorize(const double *data, const unsigned char *alpha, const QCPRange &range, QRgb *scanLine, int n, int dataIndexFactor, bool logarithmic) +{ + // If you change something here, make sure to also adapt color() and the other colorize() overload + if (!data) + { + qDebug() << Q_FUNC_INFO << "null pointer given as data"; + return; + } + if (!alpha) + { + qDebug() << Q_FUNC_INFO << "null pointer given as alpha"; + return; + } + if (!scanLine) + { + qDebug() << Q_FUNC_INFO << "null pointer given as scanLine"; + return; + } + if (mColorBufferInvalidated) + updateColorBuffer(); + + if (!logarithmic) + { + const double posToIndexFactor = (mLevelCount-1)/range.size(); + if (mPeriodic) + { + for (int i=0; i= mLevelCount) + index = mLevelCount-1; + if (alpha[dataIndexFactor*i] == 255) + { + scanLine[i] = mColorBuffer.at(index); + } else + { + const QRgb rgb = mColorBuffer.at(index); + const float alphaF = alpha[dataIndexFactor*i]/255.0f; + scanLine[i] = qRgba(qRed(rgb)*alphaF, qGreen(rgb)*alphaF, qBlue(rgb)*alphaF, qAlpha(rgb)*alphaF); + } + } + } + } else // logarithmic == true + { + if (mPeriodic) + { + for (int i=0; i= mLevelCount) + index = mLevelCount-1; + if (alpha[dataIndexFactor*i] == 255) + { + scanLine[i] = mColorBuffer.at(index); + } else + { + const QRgb rgb = mColorBuffer.at(index); + const float alphaF = alpha[dataIndexFactor*i]/255.0f; + scanLine[i] = qRgba(qRed(rgb)*alphaF, qGreen(rgb)*alphaF, qBlue(rgb)*alphaF, qAlpha(rgb)*alphaF); + } + } + } + } +} + +/*! \internal + + This method is used to colorize a single data value given in \a position, to colors. The data + range that shall be used for mapping the data value to the gradient is passed in \a range. \a + logarithmic indicates whether the data value shall be mapped to a color logarithmically. + + If an entire array of data values shall be converted, rather use \ref colorize, for better + performance. + + The returned QRgb has its r, g and b components premultiplied with alpha (see + QImage::Format_ARGB32_Premultiplied). +*/ +QRgb QCPColorGradient::color(double position, const QCPRange &range, bool logarithmic) +{ + // If you change something here, make sure to also adapt ::colorize() + if (mColorBufferInvalidated) + updateColorBuffer(); + int index = 0; + if (!logarithmic) + index = (position-range.lower)*(mLevelCount-1)/range.size(); + else + index = qLn(position/range.lower)/qLn(range.upper/range.lower)*(mLevelCount-1); + if (mPeriodic) + { + index = index % mLevelCount; + if (index < 0) + index += mLevelCount; + } else + { + if (index < 0) + index = 0; + else if (index >= mLevelCount) + index = mLevelCount-1; + } + return mColorBuffer.at(index); +} + +/*! + Clears the current color stops and loads the specified \a preset. A preset consists of predefined + color stops and the corresponding color interpolation method. + + The available presets are: + \image html QCPColorGradient.png +*/ +void QCPColorGradient::loadPreset(GradientPreset preset) +{ + clearColorStops(); + switch (preset) + { + case gpGrayscale: + setColorInterpolation(ciRGB); + setColorStopAt(0, Qt::black); + setColorStopAt(1, Qt::white); + break; + case gpHot: + setColorInterpolation(ciRGB); + setColorStopAt(0, QColor(50, 0, 0)); + setColorStopAt(0.2, QColor(180, 10, 0)); + setColorStopAt(0.4, QColor(245, 50, 0)); + setColorStopAt(0.6, QColor(255, 150, 10)); + setColorStopAt(0.8, QColor(255, 255, 50)); + setColorStopAt(1, QColor(255, 255, 255)); + break; + case gpCold: + setColorInterpolation(ciRGB); + setColorStopAt(0, QColor(0, 0, 50)); + setColorStopAt(0.2, QColor(0, 10, 180)); + setColorStopAt(0.4, QColor(0, 50, 245)); + setColorStopAt(0.6, QColor(10, 150, 255)); + setColorStopAt(0.8, QColor(50, 255, 255)); + setColorStopAt(1, QColor(255, 255, 255)); + break; + case gpNight: + setColorInterpolation(ciHSV); + setColorStopAt(0, QColor(10, 20, 30)); + setColorStopAt(1, QColor(250, 255, 250)); + break; + case gpCandy: + setColorInterpolation(ciHSV); + setColorStopAt(0, QColor(0, 0, 255)); + setColorStopAt(1, QColor(255, 250, 250)); + break; + case gpGeography: + setColorInterpolation(ciRGB); + setColorStopAt(0, QColor(70, 170, 210)); + setColorStopAt(0.20, QColor(90, 160, 180)); + setColorStopAt(0.25, QColor(45, 130, 175)); + setColorStopAt(0.30, QColor(100, 140, 125)); + setColorStopAt(0.5, QColor(100, 140, 100)); + setColorStopAt(0.6, QColor(130, 145, 120)); + setColorStopAt(0.7, QColor(140, 130, 120)); + setColorStopAt(0.9, QColor(180, 190, 190)); + setColorStopAt(1, QColor(210, 210, 230)); + break; + case gpIon: + setColorInterpolation(ciHSV); + setColorStopAt(0, QColor(50, 10, 10)); + setColorStopAt(0.45, QColor(0, 0, 255)); + setColorStopAt(0.8, QColor(0, 255, 255)); + setColorStopAt(1, QColor(0, 255, 0)); + break; + case gpThermal: + setColorInterpolation(ciRGB); + setColorStopAt(0, QColor(0, 0, 50)); + setColorStopAt(0.15, QColor(20, 0, 120)); + setColorStopAt(0.33, QColor(200, 30, 140)); + setColorStopAt(0.6, QColor(255, 100, 0)); + setColorStopAt(0.85, QColor(255, 255, 40)); + setColorStopAt(1, QColor(255, 255, 255)); + break; + case gpPolar: + setColorInterpolation(ciRGB); + setColorStopAt(0, QColor(50, 255, 255)); + setColorStopAt(0.18, QColor(10, 70, 255)); + setColorStopAt(0.28, QColor(10, 10, 190)); + setColorStopAt(0.5, QColor(0, 0, 0)); + setColorStopAt(0.72, QColor(190, 10, 10)); + setColorStopAt(0.82, QColor(255, 70, 10)); + setColorStopAt(1, QColor(255, 255, 50)); + break; + case gpSpectrum: + setColorInterpolation(ciHSV); + setColorStopAt(0, QColor(50, 0, 50)); + setColorStopAt(0.15, QColor(0, 0, 255)); + setColorStopAt(0.35, QColor(0, 255, 255)); + setColorStopAt(0.6, QColor(255, 255, 0)); + setColorStopAt(0.75, QColor(255, 30, 0)); + setColorStopAt(1, QColor(50, 0, 0)); + break; + case gpJet: + setColorInterpolation(ciRGB); + setColorStopAt(0, QColor(0, 0, 100)); + setColorStopAt(0.15, QColor(0, 50, 255)); + setColorStopAt(0.35, QColor(0, 255, 255)); + setColorStopAt(0.65, QColor(255, 255, 0)); + setColorStopAt(0.85, QColor(255, 30, 0)); + setColorStopAt(1, QColor(100, 0, 0)); + break; + case gpHues: + setColorInterpolation(ciHSV); + setColorStopAt(0, QColor(255, 0, 0)); + setColorStopAt(1.0/3.0, QColor(0, 0, 255)); + setColorStopAt(2.0/3.0, QColor(0, 255, 0)); + setColorStopAt(1, QColor(255, 0, 0)); + break; + } +} + +/*! + Clears all color stops. + + \see setColorStops, setColorStopAt +*/ +void QCPColorGradient::clearColorStops() +{ + mColorStops.clear(); + mColorBufferInvalidated = true; +} + +/*! + Returns an inverted gradient. The inverted gradient has all properties as this \ref + QCPColorGradient, but the order of the color stops is inverted. + + \see setColorStops, setColorStopAt +*/ +QCPColorGradient QCPColorGradient::inverted() const +{ + QCPColorGradient result(*this); + result.clearColorStops(); + for (QMap::const_iterator it=mColorStops.constBegin(); it!=mColorStops.constEnd(); ++it) + result.setColorStopAt(1.0-it.key(), it.value()); + return result; +} + +/*! \internal + + Returns true if the color gradient uses transparency, i.e. if any of the configured color stops + has an alpha value below 255. +*/ +bool QCPColorGradient::stopsUseAlpha() const +{ + for (QMap::const_iterator it=mColorStops.constBegin(); it!=mColorStops.constEnd(); ++it) + { + if (it.value().alpha() < 255) + return true; + } + return false; +} + +/*! \internal + + Updates the internal color buffer which will be used by \ref colorize and \ref color, to quickly + convert positions to colors. This is where the interpolation between color stops is calculated. +*/ +void QCPColorGradient::updateColorBuffer() +{ + if (mColorBuffer.size() != mLevelCount) + mColorBuffer.resize(mLevelCount); + if (mColorStops.size() > 1) + { + double indexToPosFactor = 1.0/(double)(mLevelCount-1); + const bool useAlpha = stopsUseAlpha(); + for (int i=0; i::const_iterator it = mColorStops.lowerBound(position); + if (it == mColorStops.constEnd()) // position is on or after last stop, use color of last stop + { + if (useAlpha) + { + const QColor col = (it-1).value(); + const float alphaPremultiplier = col.alpha()/255.0f; // since we use QImage::Format_ARGB32_Premultiplied + mColorBuffer[i] = qRgba(col.red()*alphaPremultiplier, col.green()*alphaPremultiplier, col.blue()*alphaPremultiplier, col.alpha()); + } else + mColorBuffer[i] = (it-1).value().rgba(); + } else if (it == mColorStops.constBegin()) // position is on or before first stop, use color of first stop + { + if (useAlpha) + { + const QColor col = it.value(); + const float alphaPremultiplier = col.alpha()/255.0f; // since we use QImage::Format_ARGB32_Premultiplied + mColorBuffer[i] = qRgba(col.red()*alphaPremultiplier, col.green()*alphaPremultiplier, col.blue()*alphaPremultiplier, col.alpha()); + } else + mColorBuffer[i] = it.value().rgba(); + } else // position is in between stops (or on an intermediate stop), interpolate color + { + QMap::const_iterator high = it; + QMap::const_iterator low = it-1; + double t = (position-low.key())/(high.key()-low.key()); // interpolation factor 0..1 + switch (mColorInterpolation) + { + case ciRGB: + { + if (useAlpha) + { + const int alpha = (1-t)*low.value().alpha() + t*high.value().alpha(); + const float alphaPremultiplier = alpha/255.0f; // since we use QImage::Format_ARGB32_Premultiplied + mColorBuffer[i] = qRgba(((1-t)*low.value().red() + t*high.value().red())*alphaPremultiplier, + ((1-t)*low.value().green() + t*high.value().green())*alphaPremultiplier, + ((1-t)*low.value().blue() + t*high.value().blue())*alphaPremultiplier, + alpha); + } else + { + mColorBuffer[i] = qRgb(((1-t)*low.value().red() + t*high.value().red()), + ((1-t)*low.value().green() + t*high.value().green()), + ((1-t)*low.value().blue() + t*high.value().blue())); + } + break; + } + case ciHSV: + { + QColor lowHsv = low.value().toHsv(); + QColor highHsv = high.value().toHsv(); + double hue = 0; + double hueDiff = highHsv.hueF()-lowHsv.hueF(); + if (hueDiff > 0.5) + hue = lowHsv.hueF() - t*(1.0-hueDiff); + else if (hueDiff < -0.5) + hue = lowHsv.hueF() + t*(1.0+hueDiff); + else + hue = lowHsv.hueF() + t*hueDiff; + if (hue < 0) hue += 1.0; + else if (hue >= 1.0) hue -= 1.0; + if (useAlpha) + { + const QRgb rgb = QColor::fromHsvF(hue, + (1-t)*lowHsv.saturationF() + t*highHsv.saturationF(), + (1-t)*lowHsv.valueF() + t*highHsv.valueF()).rgb(); + const float alpha = (1-t)*lowHsv.alphaF() + t*highHsv.alphaF(); + mColorBuffer[i] = qRgba(qRed(rgb)*alpha, qGreen(rgb)*alpha, qBlue(rgb)*alpha, 255*alpha); + } + else + { + mColorBuffer[i] = QColor::fromHsvF(hue, + (1-t)*lowHsv.saturationF() + t*highHsv.saturationF(), + (1-t)*lowHsv.valueF() + t*highHsv.valueF()).rgb(); + } + break; + } + } + } + } + } else if (mColorStops.size() == 1) + { + const QRgb rgb = mColorStops.constBegin().value().rgb(); + const float alpha = mColorStops.constBegin().value().alphaF(); + mColorBuffer.fill(qRgba(qRed(rgb)*alpha, qGreen(rgb)*alpha, qBlue(rgb)*alpha, 255*alpha)); + } else // mColorStops is empty, fill color buffer with black + { + mColorBuffer.fill(qRgb(0, 0, 0)); + } + mColorBufferInvalidated = false; +} +/* end of 'src/colorgradient.cpp' */ + + +/* including file 'src/selectiondecorator-bracket.cpp', size 12313 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPSelectionDecoratorBracket +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPSelectionDecoratorBracket + \brief A selection decorator which draws brackets around each selected data segment + + Additionally to the regular highlighting of selected segments via color, fill and scatter style, + this \ref QCPSelectionDecorator subclass draws markers at the begin and end of each selected data + segment of the plottable. + + The shape of the markers can be controlled with \ref setBracketStyle, \ref setBracketWidth and + \ref setBracketHeight. The color/fill can be controlled with \ref setBracketPen and \ref + setBracketBrush. + + To introduce custom bracket styles, it is only necessary to sublcass \ref + QCPSelectionDecoratorBracket and reimplement \ref drawBracket. The rest will be managed by the + base class. +*/ + +/*! + Creates a new QCPSelectionDecoratorBracket instance with default values. +*/ +QCPSelectionDecoratorBracket::QCPSelectionDecoratorBracket() : + mBracketPen(QPen(Qt::black)), + mBracketBrush(Qt::NoBrush), + mBracketWidth(5), + mBracketHeight(50), + mBracketStyle(bsSquareBracket), + mTangentToData(false), + mTangentAverage(2) +{ + +} + +QCPSelectionDecoratorBracket::~QCPSelectionDecoratorBracket() +{ +} + +/*! + Sets the pen that will be used to draw the brackets at the beginning and end of each selected + data segment. +*/ +void QCPSelectionDecoratorBracket::setBracketPen(const QPen &pen) +{ + mBracketPen = pen; +} + +/*! + Sets the brush that will be used to draw the brackets at the beginning and end of each selected + data segment. +*/ +void QCPSelectionDecoratorBracket::setBracketBrush(const QBrush &brush) +{ + mBracketBrush = brush; +} + +/*! + Sets the width of the drawn bracket. The width dimension is always parallel to the key axis of + the data, or the tangent direction of the current data slope, if \ref setTangentToData is + enabled. +*/ +void QCPSelectionDecoratorBracket::setBracketWidth(int width) +{ + mBracketWidth = width; +} + +/*! + Sets the height of the drawn bracket. The height dimension is always perpendicular to the key axis + of the data, or the tangent direction of the current data slope, if \ref setTangentToData is + enabled. +*/ +void QCPSelectionDecoratorBracket::setBracketHeight(int height) +{ + mBracketHeight = height; +} + +/*! + Sets the shape that the bracket/marker will have. + + \see setBracketWidth, setBracketHeight +*/ +void QCPSelectionDecoratorBracket::setBracketStyle(QCPSelectionDecoratorBracket::BracketStyle style) +{ + mBracketStyle = style; +} + +/*! + Sets whether the brackets will be rotated such that they align with the slope of the data at the + position that they appear in. + + For noisy data, it might be more visually appealing to average the slope over multiple data + points. This can be configured via \ref setTangentAverage. +*/ +void QCPSelectionDecoratorBracket::setTangentToData(bool enabled) +{ + mTangentToData = enabled; +} + +/*! + Controls over how many data points the slope shall be averaged, when brackets shall be aligned + with the data (if \ref setTangentToData is true). + + From the position of the bracket, \a pointCount points towards the selected data range will be + taken into account. The smallest value of \a pointCount is 1, which is effectively equivalent to + disabling \ref setTangentToData. +*/ +void QCPSelectionDecoratorBracket::setTangentAverage(int pointCount) +{ + mTangentAverage = pointCount; + if (mTangentAverage < 1) + mTangentAverage = 1; +} + +/*! + Draws the bracket shape with \a painter. The parameter \a direction is either -1 or 1 and + indicates whether the bracket shall point to the left or the right (i.e. is a closing or opening + bracket, respectively). + + The passed \a painter already contains all transformations that are necessary to position and + rotate the bracket appropriately. Painting operations can be performed as if drawing upright + brackets on flat data with horizontal key axis, with (0, 0) being the center of the bracket. + + If you wish to sublcass \ref QCPSelectionDecoratorBracket in order to provide custom bracket + shapes (see \ref QCPSelectionDecoratorBracket::bsUserStyle), this is the method you should + reimplement. +*/ +void QCPSelectionDecoratorBracket::drawBracket(QCPPainter *painter, int direction) const +{ + switch (mBracketStyle) + { + case bsSquareBracket: + { + painter->drawLine(QLineF(mBracketWidth*direction, -mBracketHeight*0.5, 0, -mBracketHeight*0.5)); + painter->drawLine(QLineF(mBracketWidth*direction, mBracketHeight*0.5, 0, mBracketHeight*0.5)); + painter->drawLine(QLineF(0, -mBracketHeight*0.5, 0, mBracketHeight*0.5)); + break; + } + case bsHalfEllipse: + { + painter->drawArc(-mBracketWidth*0.5, -mBracketHeight*0.5, mBracketWidth, mBracketHeight, -90*16, -180*16*direction); + break; + } + case bsEllipse: + { + painter->drawEllipse(-mBracketWidth*0.5, -mBracketHeight*0.5, mBracketWidth, mBracketHeight); + break; + } + case bsPlus: + { + painter->drawLine(QLineF(0, -mBracketHeight*0.5, 0, mBracketHeight*0.5)); + painter->drawLine(QLineF(-mBracketWidth*0.5, 0, mBracketWidth*0.5, 0)); + break; + } + default: + { + qDebug() << Q_FUNC_INFO << "unknown/custom bracket style can't be handeld by default implementation:" << static_cast(mBracketStyle); + break; + } + } +} + +/*! + Draws the bracket decoration on the data points at the begin and end of each selected data + segment given in \a seletion. + + It uses the method \ref drawBracket to actually draw the shapes. + + \seebaseclassmethod +*/ +void QCPSelectionDecoratorBracket::drawDecoration(QCPPainter *painter, QCPDataSelection selection) +{ + if (!mPlottable || selection.isEmpty()) return; + + if (QCPPlottableInterface1D *interface1d = mPlottable->interface1D()) + { + foreach (const QCPDataRange &dataRange, selection.dataRanges()) + { + // determine position and (if tangent mode is enabled) angle of brackets: + int openBracketDir = (mPlottable->keyAxis() && !mPlottable->keyAxis()->rangeReversed()) ? 1 : -1; + int closeBracketDir = -openBracketDir; + QPointF openBracketPos = getPixelCoordinates(interface1d, dataRange.begin()); + QPointF closeBracketPos = getPixelCoordinates(interface1d, dataRange.end()-1); + double openBracketAngle = 0; + double closeBracketAngle = 0; + if (mTangentToData) + { + openBracketAngle = getTangentAngle(interface1d, dataRange.begin(), openBracketDir); + closeBracketAngle = getTangentAngle(interface1d, dataRange.end()-1, closeBracketDir); + } + // draw opening bracket: + QTransform oldTransform = painter->transform(); + painter->setPen(mBracketPen); + painter->setBrush(mBracketBrush); + painter->translate(openBracketPos); + painter->rotate(openBracketAngle/M_PI*180.0); + drawBracket(painter, openBracketDir); + painter->setTransform(oldTransform); + // draw closing bracket: + painter->setPen(mBracketPen); + painter->setBrush(mBracketBrush); + painter->translate(closeBracketPos); + painter->rotate(closeBracketAngle/M_PI*180.0); + drawBracket(painter, closeBracketDir); + painter->setTransform(oldTransform); + } + } +} + +/*! \internal + + If \ref setTangentToData is enabled, brackets need to be rotated according to the data slope. + This method returns the angle in radians by which a bracket at the given \a dataIndex must be + rotated. + + The parameter \a direction must be set to either -1 or 1, representing whether it is an opening + or closing bracket. Since for slope calculation multiple data points are required, this defines + the direction in which the algorithm walks, starting at \a dataIndex, to average those data + points. (see \ref setTangentToData and \ref setTangentAverage) + + \a interface1d is the interface to the plottable's data which is used to query data coordinates. +*/ +double QCPSelectionDecoratorBracket::getTangentAngle(const QCPPlottableInterface1D *interface1d, int dataIndex, int direction) const +{ + if (!interface1d || dataIndex < 0 || dataIndex >= interface1d->dataCount()) + return 0; + direction = direction < 0 ? -1 : 1; // enforce direction is either -1 or 1 + + // how many steps we can actually go from index in the given direction without exceeding data bounds: + int averageCount; + if (direction < 0) + averageCount = qMin(mTangentAverage, dataIndex); + else + averageCount = qMin(mTangentAverage, interface1d->dataCount()-1-dataIndex); + qDebug() << averageCount; + // calculate point average of averageCount points: + QVector points(averageCount); + QPointF pointsAverage; + int currentIndex = dataIndex; + for (int i=0; ikeyAxis(); + QCPAxis *valueAxis = mPlottable->valueAxis(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return QPointF(0, 0); } + + if (keyAxis->orientation() == Qt::Horizontal) + return QPointF(keyAxis->coordToPixel(interface1d->dataMainKey(dataIndex)), valueAxis->coordToPixel(interface1d->dataMainValue(dataIndex))); + else + return QPointF(valueAxis->coordToPixel(interface1d->dataMainValue(dataIndex)), keyAxis->coordToPixel(interface1d->dataMainKey(dataIndex))); +} +/* end of 'src/selectiondecorator-bracket.cpp' */ + + +/* including file 'src/layoutelements/layoutelement-axisrect.cpp', size 47584 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAxisRect +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPAxisRect + \brief Holds multiple axes and arranges them in a rectangular shape. + + This class represents an axis rect, a rectangular area that is bounded on all sides with an + arbitrary number of axes. + + Initially QCustomPlot has one axis rect, accessible via QCustomPlot::axisRect(). However, the + layout system allows to have multiple axis rects, e.g. arranged in a grid layout + (QCustomPlot::plotLayout). + + By default, QCPAxisRect comes with four axes, at bottom, top, left and right. They can be + accessed via \ref axis by providing the respective axis type (\ref QCPAxis::AxisType) and index. + If you need all axes in the axis rect, use \ref axes. The top and right axes are set to be + invisible initially (QCPAxis::setVisible). To add more axes to a side, use \ref addAxis or \ref + addAxes. To remove an axis, use \ref removeAxis. + + The axis rect layerable itself only draws a background pixmap or color, if specified (\ref + setBackground). It is placed on the "background" layer initially (see \ref QCPLayer for an + explanation of the QCustomPlot layer system). The axes that are held by the axis rect can be + placed on other layers, independently of the axis rect. + + Every axis rect has a child layout of type \ref QCPLayoutInset. It is accessible via \ref + insetLayout and can be used to have other layout elements (or even other layouts with multiple + elements) hovering inside the axis rect. + + If an axis rect is clicked and dragged, it processes this by moving certain axis ranges. The + behaviour can be controlled with \ref setRangeDrag and \ref setRangeDragAxes. If the mouse wheel + is scrolled while the cursor is on the axis rect, certain axes are scaled. This is controllable + via \ref setRangeZoom, \ref setRangeZoomAxes and \ref setRangeZoomFactor. These interactions are + only enabled if \ref QCustomPlot::setInteractions contains \ref QCP::iRangeDrag and \ref + QCP::iRangeZoom. + + \image html AxisRectSpacingOverview.png +
Overview of the spacings and paddings that define the geometry of an axis. The dashed + line on the far left indicates the viewport/widget border.
+*/ + +/* start documentation of inline functions */ + +/*! \fn QCPLayoutInset *QCPAxisRect::insetLayout() const + + Returns the inset layout of this axis rect. It can be used to place other layout elements (or + even layouts with multiple other elements) inside/on top of an axis rect. + + \see QCPLayoutInset +*/ + +/*! \fn int QCPAxisRect::left() const + + Returns the pixel position of the left border of this axis rect. Margins are not taken into + account here, so the returned value is with respect to the inner \ref rect. +*/ + +/*! \fn int QCPAxisRect::right() const + + Returns the pixel position of the right border of this axis rect. Margins are not taken into + account here, so the returned value is with respect to the inner \ref rect. +*/ + +/*! \fn int QCPAxisRect::top() const + + Returns the pixel position of the top border of this axis rect. Margins are not taken into + account here, so the returned value is with respect to the inner \ref rect. +*/ + +/*! \fn int QCPAxisRect::bottom() const + + Returns the pixel position of the bottom border of this axis rect. Margins are not taken into + account here, so the returned value is with respect to the inner \ref rect. +*/ + +/*! \fn int QCPAxisRect::width() const + + Returns the pixel width of this axis rect. Margins are not taken into account here, so the + returned value is with respect to the inner \ref rect. +*/ + +/*! \fn int QCPAxisRect::height() const + + Returns the pixel height of this axis rect. Margins are not taken into account here, so the + returned value is with respect to the inner \ref rect. +*/ + +/*! \fn QSize QCPAxisRect::size() const + + Returns the pixel size of this axis rect. Margins are not taken into account here, so the + returned value is with respect to the inner \ref rect. +*/ + +/*! \fn QPoint QCPAxisRect::topLeft() const + + Returns the top left corner of this axis rect in pixels. Margins are not taken into account here, + so the returned value is with respect to the inner \ref rect. +*/ + +/*! \fn QPoint QCPAxisRect::topRight() const + + Returns the top right corner of this axis rect in pixels. Margins are not taken into account + here, so the returned value is with respect to the inner \ref rect. +*/ + +/*! \fn QPoint QCPAxisRect::bottomLeft() const + + Returns the bottom left corner of this axis rect in pixels. Margins are not taken into account + here, so the returned value is with respect to the inner \ref rect. +*/ + +/*! \fn QPoint QCPAxisRect::bottomRight() const + + Returns the bottom right corner of this axis rect in pixels. Margins are not taken into account + here, so the returned value is with respect to the inner \ref rect. +*/ + +/*! \fn QPoint QCPAxisRect::center() const + + Returns the center of this axis rect in pixels. Margins are not taken into account here, so the + returned value is with respect to the inner \ref rect. +*/ + +/* end documentation of inline functions */ + +/*! + Creates a QCPAxisRect instance and sets default values. An axis is added for each of the four + sides, the top and right axes are set invisible initially. +*/ +QCPAxisRect::QCPAxisRect(QCustomPlot *parentPlot, bool setupDefaultAxes) : + QCPLayoutElement(parentPlot), + mBackgroundBrush(Qt::NoBrush), + mBackgroundScaled(true), + mBackgroundScaledMode(Qt::KeepAspectRatioByExpanding), + mInsetLayout(new QCPLayoutInset), + mRangeDrag(Qt::Horizontal|Qt::Vertical), + mRangeZoom(Qt::Horizontal|Qt::Vertical), + mRangeZoomFactorHorz(0.85), + mRangeZoomFactorVert(0.85), + mDragging(false) +{ + mInsetLayout->initializeParentPlot(mParentPlot); + mInsetLayout->setParentLayerable(this); + mInsetLayout->setParent(this); + + setMinimumSize(50, 50); + setMinimumMargins(QMargins(15, 15, 15, 15)); + mAxes.insert(QCPAxis::atLeft, QList()); + mAxes.insert(QCPAxis::atRight, QList()); + mAxes.insert(QCPAxis::atTop, QList()); + mAxes.insert(QCPAxis::atBottom, QList()); + + if (setupDefaultAxes) + { + QCPAxis *xAxis = addAxis(QCPAxis::atBottom); + QCPAxis *yAxis = addAxis(QCPAxis::atLeft); + QCPAxis *xAxis2 = addAxis(QCPAxis::atTop); + QCPAxis *yAxis2 = addAxis(QCPAxis::atRight); + setRangeDragAxes(xAxis, yAxis); + setRangeZoomAxes(xAxis, yAxis); + xAxis2->setVisible(false); + yAxis2->setVisible(false); + xAxis->grid()->setVisible(true); + yAxis->grid()->setVisible(true); + xAxis2->grid()->setVisible(false); + yAxis2->grid()->setVisible(false); + xAxis2->grid()->setZeroLinePen(Qt::NoPen); + yAxis2->grid()->setZeroLinePen(Qt::NoPen); + xAxis2->grid()->setVisible(false); + yAxis2->grid()->setVisible(false); + } +} + +QCPAxisRect::~QCPAxisRect() +{ + delete mInsetLayout; + mInsetLayout = 0; + + QList axesList = axes(); + for (int i=0; i ax(mAxes.value(type)); + if (index >= 0 && index < ax.size()) + { + return ax.at(index); + } else + { + qDebug() << Q_FUNC_INFO << "Axis index out of bounds:" << index; + return 0; + } +} + +/*! + Returns all axes on the axis rect sides specified with \a types. + + \a types may be a single \ref QCPAxis::AxisType or an or-combination, to get the axes of + multiple sides. + + \see axis +*/ +QList QCPAxisRect::axes(QCPAxis::AxisTypes types) const +{ + QList result; + if (types.testFlag(QCPAxis::atLeft)) + result << mAxes.value(QCPAxis::atLeft); + if (types.testFlag(QCPAxis::atRight)) + result << mAxes.value(QCPAxis::atRight); + if (types.testFlag(QCPAxis::atTop)) + result << mAxes.value(QCPAxis::atTop); + if (types.testFlag(QCPAxis::atBottom)) + result << mAxes.value(QCPAxis::atBottom); + return result; +} + +/*! \overload + + Returns all axes of this axis rect. +*/ +QList QCPAxisRect::axes() const +{ + QList result; + QHashIterator > it(mAxes); + while (it.hasNext()) + { + it.next(); + result << it.value(); + } + return result; +} + +/*! + Adds a new axis to the axis rect side specified with \a type, and returns it. If \a axis is 0, a + new QCPAxis instance is created internally. QCustomPlot owns the returned axis, so if you want to + remove an axis, use \ref removeAxis instead of deleting it manually. + + You may inject QCPAxis instances (or subclasses of QCPAxis) by setting \a axis to an axis that was + previously created outside QCustomPlot. It is important to note that QCustomPlot takes ownership + of the axis, so you may not delete it afterwards. Further, the \a axis must have been created + with this axis rect as parent and with the same axis type as specified in \a type. If this is not + the case, a debug output is generated, the axis is not added, and the method returns 0. + + This method can not be used to move \a axis between axis rects. The same \a axis instance must + not be added multiple times to the same or different axis rects. + + If an axis rect side already contains one or more axes, the lower and upper endings of the new + axis (\ref QCPAxis::setLowerEnding, \ref QCPAxis::setUpperEnding) are set to \ref + QCPLineEnding::esHalfBar. + + \see addAxes, setupFullAxesBox +*/ +QCPAxis *QCPAxisRect::addAxis(QCPAxis::AxisType type, QCPAxis *axis) +{ + QCPAxis *newAxis = axis; + if (!newAxis) + { + newAxis = new QCPAxis(this, type); + } else // user provided existing axis instance, do some sanity checks + { + if (newAxis->axisType() != type) + { + qDebug() << Q_FUNC_INFO << "passed axis has different axis type than specified in type parameter"; + return 0; + } + if (newAxis->axisRect() != this) + { + qDebug() << Q_FUNC_INFO << "passed axis doesn't have this axis rect as parent axis rect"; + return 0; + } + if (axes().contains(newAxis)) + { + qDebug() << Q_FUNC_INFO << "passed axis is already owned by this axis rect"; + return 0; + } + } + if (mAxes[type].size() > 0) // multiple axes on one side, add half-bar axis ending to additional axes with offset + { + bool invert = (type == QCPAxis::atRight) || (type == QCPAxis::atBottom); + newAxis->setLowerEnding(QCPLineEnding(QCPLineEnding::esHalfBar, 6, 10, !invert)); + newAxis->setUpperEnding(QCPLineEnding(QCPLineEnding::esHalfBar, 6, 10, invert)); + } + mAxes[type].append(newAxis); + + // reset convenience axis pointers on parent QCustomPlot if they are unset: + if (mParentPlot && mParentPlot->axisRectCount() > 0 && mParentPlot->axisRect(0) == this) + { + switch (type) + { + case QCPAxis::atBottom: { if (!mParentPlot->xAxis) mParentPlot->xAxis = newAxis; break; } + case QCPAxis::atLeft: { if (!mParentPlot->yAxis) mParentPlot->yAxis = newAxis; break; } + case QCPAxis::atTop: { if (!mParentPlot->xAxis2) mParentPlot->xAxis2 = newAxis; break; } + case QCPAxis::atRight: { if (!mParentPlot->yAxis2) mParentPlot->yAxis2 = newAxis; break; } + } + } + + return newAxis; +} + +/*! + Adds a new axis with \ref addAxis to each axis rect side specified in \a types. This may be an + or-combination of QCPAxis::AxisType, so axes can be added to multiple sides at once. + + Returns a list of the added axes. + + \see addAxis, setupFullAxesBox +*/ +QList QCPAxisRect::addAxes(QCPAxis::AxisTypes types) +{ + QList result; + if (types.testFlag(QCPAxis::atLeft)) + result << addAxis(QCPAxis::atLeft); + if (types.testFlag(QCPAxis::atRight)) + result << addAxis(QCPAxis::atRight); + if (types.testFlag(QCPAxis::atTop)) + result << addAxis(QCPAxis::atTop); + if (types.testFlag(QCPAxis::atBottom)) + result << addAxis(QCPAxis::atBottom); + return result; +} + +/*! + Removes the specified \a axis from the axis rect and deletes it. + + Returns true on success, i.e. if \a axis was a valid axis in this axis rect. + + \see addAxis +*/ +bool QCPAxisRect::removeAxis(QCPAxis *axis) +{ + // don't access axis->axisType() to provide safety when axis is an invalid pointer, rather go through all axis containers: + QHashIterator > it(mAxes); + while (it.hasNext()) + { + it.next(); + if (it.value().contains(axis)) + { + if (it.value().first() == axis && it.value().size() > 1) // if removing first axis, transfer axis offset to the new first axis (which at this point is the second axis, if it exists) + it.value()[1]->setOffset(axis->offset()); + mAxes[it.key()].removeOne(axis); + if (qobject_cast(parentPlot())) // make sure this isn't called from QObject dtor when QCustomPlot is already destructed (happens when the axis rect is not in any layout and thus QObject-child of QCustomPlot) + parentPlot()->axisRemoved(axis); + delete axis; + return true; + } + } + qDebug() << Q_FUNC_INFO << "Axis isn't in axis rect:" << reinterpret_cast(axis); + return false; +} + +/*! + Zooms in (or out) to the passed rectangular region \a pixelRect, given in pixel coordinates. + + All axes of this axis rect will have their range zoomed accordingly. If you only wish to zoom + specific axes, use the overloaded version of this method. + + \see QCustomPlot::setSelectionRectMode +*/ +void QCPAxisRect::zoom(const QRectF &pixelRect) +{ + zoom(pixelRect, axes()); +} + +/*! \overload + + Zooms in (or out) to the passed rectangular region \a pixelRect, given in pixel coordinates. + + Only the axes passed in \a affectedAxes will have their ranges zoomed accordingly. + + \see QCustomPlot::setSelectionRectMode +*/ +void QCPAxisRect::zoom(const QRectF &pixelRect, const QList &affectedAxes) +{ + foreach (QCPAxis *axis, affectedAxes) + { + if (!axis) + { + qDebug() << Q_FUNC_INFO << "a passed axis was zero"; + continue; + } + QCPRange pixelRange; + if (axis->orientation() == Qt::Horizontal) + pixelRange = QCPRange(pixelRect.left(), pixelRect.right()); + else + pixelRange = QCPRange(pixelRect.top(), pixelRect.bottom()); + axis->setRange(axis->pixelToCoord(pixelRange.lower), axis->pixelToCoord(pixelRange.upper)); + } +} + +/*! + Convenience function to create an axis on each side that doesn't have any axes yet and set their + visibility to true. Further, the top/right axes are assigned the following properties of the + bottom/left axes: + + \li range (\ref QCPAxis::setRange) + \li range reversed (\ref QCPAxis::setRangeReversed) + \li scale type (\ref QCPAxis::setScaleType) + \li tick visibility (\ref QCPAxis::setTicks) + \li number format (\ref QCPAxis::setNumberFormat) + \li number precision (\ref QCPAxis::setNumberPrecision) + \li tick count of ticker (\ref QCPAxisTicker::setTickCount) + \li tick origin of ticker (\ref QCPAxisTicker::setTickOrigin) + + Tick label visibility (\ref QCPAxis::setTickLabels) of the right and top axes are set to false. + + If \a connectRanges is true, the \ref QCPAxis::rangeChanged "rangeChanged" signals of the bottom + and left axes are connected to the \ref QCPAxis::setRange slots of the top and right axes. +*/ +void QCPAxisRect::setupFullAxesBox(bool connectRanges) +{ + QCPAxis *xAxis, *yAxis, *xAxis2, *yAxis2; + if (axisCount(QCPAxis::atBottom) == 0) + xAxis = addAxis(QCPAxis::atBottom); + else + xAxis = axis(QCPAxis::atBottom); + + if (axisCount(QCPAxis::atLeft) == 0) + yAxis = addAxis(QCPAxis::atLeft); + else + yAxis = axis(QCPAxis::atLeft); + + if (axisCount(QCPAxis::atTop) == 0) + xAxis2 = addAxis(QCPAxis::atTop); + else + xAxis2 = axis(QCPAxis::atTop); + + if (axisCount(QCPAxis::atRight) == 0) + yAxis2 = addAxis(QCPAxis::atRight); + else + yAxis2 = axis(QCPAxis::atRight); + + xAxis->setVisible(true); + yAxis->setVisible(true); + xAxis2->setVisible(true); + yAxis2->setVisible(true); + xAxis2->setTickLabels(false); + yAxis2->setTickLabels(false); + + xAxis2->setRange(xAxis->range()); + xAxis2->setRangeReversed(xAxis->rangeReversed()); + xAxis2->setScaleType(xAxis->scaleType()); + xAxis2->setTicks(xAxis->ticks()); + xAxis2->setNumberFormat(xAxis->numberFormat()); + xAxis2->setNumberPrecision(xAxis->numberPrecision()); + xAxis2->ticker()->setTickCount(xAxis->ticker()->tickCount()); + xAxis2->ticker()->setTickOrigin(xAxis->ticker()->tickOrigin()); + + yAxis2->setRange(yAxis->range()); + yAxis2->setRangeReversed(yAxis->rangeReversed()); + yAxis2->setScaleType(yAxis->scaleType()); + yAxis2->setTicks(yAxis->ticks()); + yAxis2->setNumberFormat(yAxis->numberFormat()); + yAxis2->setNumberPrecision(yAxis->numberPrecision()); + yAxis2->ticker()->setTickCount(yAxis->ticker()->tickCount()); + yAxis2->ticker()->setTickOrigin(yAxis->ticker()->tickOrigin()); + + if (connectRanges) + { + connect(xAxis, SIGNAL(rangeChanged(QCPRange)), xAxis2, SLOT(setRange(QCPRange))); + connect(yAxis, SIGNAL(rangeChanged(QCPRange)), yAxis2, SLOT(setRange(QCPRange))); + } +} + +/*! + Returns a list of all the plottables that are associated with this axis rect. + + A plottable is considered associated with an axis rect if its key or value axis (or both) is in + this axis rect. + + \see graphs, items +*/ +QList QCPAxisRect::plottables() const +{ + // Note: don't append all QCPAxis::plottables() into a list, because we might get duplicate entries + QList result; + for (int i=0; imPlottables.size(); ++i) + { + if (mParentPlot->mPlottables.at(i)->keyAxis()->axisRect() == this || mParentPlot->mPlottables.at(i)->valueAxis()->axisRect() == this) + result.append(mParentPlot->mPlottables.at(i)); + } + return result; +} + +/*! + Returns a list of all the graphs that are associated with this axis rect. + + A graph is considered associated with an axis rect if its key or value axis (or both) is in + this axis rect. + + \see plottables, items +*/ +QList QCPAxisRect::graphs() const +{ + // Note: don't append all QCPAxis::graphs() into a list, because we might get duplicate entries + QList result; + for (int i=0; imGraphs.size(); ++i) + { + if (mParentPlot->mGraphs.at(i)->keyAxis()->axisRect() == this || mParentPlot->mGraphs.at(i)->valueAxis()->axisRect() == this) + result.append(mParentPlot->mGraphs.at(i)); + } + return result; +} + +/*! + Returns a list of all the items that are associated with this axis rect. + + An item is considered associated with an axis rect if any of its positions has key or value axis + set to an axis that is in this axis rect, or if any of its positions has \ref + QCPItemPosition::setAxisRect set to the axis rect, or if the clip axis rect (\ref + QCPAbstractItem::setClipAxisRect) is set to this axis rect. + + \see plottables, graphs +*/ +QList QCPAxisRect::items() const +{ + // Note: don't just append all QCPAxis::items() into a list, because we might get duplicate entries + // and miss those items that have this axis rect as clipAxisRect. + QList result; + for (int itemId=0; itemIdmItems.size(); ++itemId) + { + if (mParentPlot->mItems.at(itemId)->clipAxisRect() == this) + { + result.append(mParentPlot->mItems.at(itemId)); + continue; + } + QList positions = mParentPlot->mItems.at(itemId)->positions(); + for (int posId=0; posIdaxisRect() == this || + positions.at(posId)->keyAxis()->axisRect() == this || + positions.at(posId)->valueAxis()->axisRect() == this) + { + result.append(mParentPlot->mItems.at(itemId)); + break; + } + } + } + return result; +} + +/*! + This method is called automatically upon replot and doesn't need to be called by users of + QCPAxisRect. + + Calls the base class implementation to update the margins (see \ref QCPLayoutElement::update), + and finally passes the \ref rect to the inset layout (\ref insetLayout) and calls its + QCPInsetLayout::update function. + + \seebaseclassmethod +*/ +void QCPAxisRect::update(UpdatePhase phase) +{ + QCPLayoutElement::update(phase); + + switch (phase) + { + case upPreparation: + { + QList allAxes = axes(); + for (int i=0; isetupTickVectors(); + break; + } + case upLayout: + { + mInsetLayout->setOuterRect(rect()); + break; + } + default: break; + } + + // pass update call on to inset layout (doesn't happen automatically, because QCPAxisRect doesn't derive from QCPLayout): + mInsetLayout->update(phase); +} + +/* inherits documentation from base class */ +QList QCPAxisRect::elements(bool recursive) const +{ + QList result; + if (mInsetLayout) + { + result << mInsetLayout; + if (recursive) + result << mInsetLayout->elements(recursive); + } + return result; +} + +/* inherits documentation from base class */ +void QCPAxisRect::applyDefaultAntialiasingHint(QCPPainter *painter) const +{ + painter->setAntialiasing(false); +} + +/* inherits documentation from base class */ +void QCPAxisRect::draw(QCPPainter *painter) +{ + drawBackground(painter); +} + +/*! + Sets \a pm as the axis background pixmap. The axis background pixmap will be drawn inside the + axis rect. Since axis rects place themselves on the "background" layer by default, the axis rect + backgrounds are usually drawn below everything else. + + For cases where the provided pixmap doesn't have the same size as the axis rect, scaling can be + enabled with \ref setBackgroundScaled and the scaling mode (i.e. whether and how the aspect ratio + is preserved) can be set with \ref setBackgroundScaledMode. To set all these options in one call, + consider using the overloaded version of this function. + + Below the pixmap, the axis rect may be optionally filled with a brush, if specified with \ref + setBackground(const QBrush &brush). + + \see setBackgroundScaled, setBackgroundScaledMode, setBackground(const QBrush &brush) +*/ +void QCPAxisRect::setBackground(const QPixmap &pm) +{ + mBackgroundPixmap = pm; + mScaledBackgroundPixmap = QPixmap(); +} + +/*! \overload + + Sets \a brush as the background brush. The axis rect background will be filled with this brush. + Since axis rects place themselves on the "background" layer by default, the axis rect backgrounds + are usually drawn below everything else. + + The brush will be drawn before (under) any background pixmap, which may be specified with \ref + setBackground(const QPixmap &pm). + + To disable drawing of a background brush, set \a brush to Qt::NoBrush. + + \see setBackground(const QPixmap &pm) +*/ +void QCPAxisRect::setBackground(const QBrush &brush) +{ + mBackgroundBrush = brush; +} + +/*! \overload + + Allows setting the background pixmap of the axis rect, whether it shall be scaled and how it + shall be scaled in one call. + + \see setBackground(const QPixmap &pm), setBackgroundScaled, setBackgroundScaledMode +*/ +void QCPAxisRect::setBackground(const QPixmap &pm, bool scaled, Qt::AspectRatioMode mode) +{ + mBackgroundPixmap = pm; + mScaledBackgroundPixmap = QPixmap(); + mBackgroundScaled = scaled; + mBackgroundScaledMode = mode; +} + +/*! + Sets whether the axis background pixmap shall be scaled to fit the axis rect or not. If \a scaled + is set to true, you may control whether and how the aspect ratio of the original pixmap is + preserved with \ref setBackgroundScaledMode. + + Note that the scaled version of the original pixmap is buffered, so there is no performance + penalty on replots. (Except when the axis rect dimensions are changed continuously.) + + \see setBackground, setBackgroundScaledMode +*/ +void QCPAxisRect::setBackgroundScaled(bool scaled) +{ + mBackgroundScaled = scaled; +} + +/*! + If scaling of the axis background pixmap is enabled (\ref setBackgroundScaled), use this function to + define whether and how the aspect ratio of the original pixmap passed to \ref setBackground is preserved. + \see setBackground, setBackgroundScaled +*/ +void QCPAxisRect::setBackgroundScaledMode(Qt::AspectRatioMode mode) +{ + mBackgroundScaledMode = mode; +} + +/*! + Returns the range drag axis of the \a orientation provided. If multiple axes were set, returns + the first one (use \ref rangeDragAxes to retrieve a list with all set axes). + + \see setRangeDragAxes +*/ +QCPAxis *QCPAxisRect::rangeDragAxis(Qt::Orientation orientation) +{ + if (orientation == Qt::Horizontal) + return mRangeDragHorzAxis.isEmpty() ? 0 : mRangeDragHorzAxis.first().data(); + else + return mRangeDragVertAxis.isEmpty() ? 0 : mRangeDragVertAxis.first().data(); +} + +/*! + Returns the range zoom axis of the \a orientation provided. If multiple axes were set, returns + the first one (use \ref rangeZoomAxes to retrieve a list with all set axes). + + \see setRangeZoomAxes +*/ +QCPAxis *QCPAxisRect::rangeZoomAxis(Qt::Orientation orientation) +{ + if (orientation == Qt::Horizontal) + return mRangeZoomHorzAxis.isEmpty() ? 0 : mRangeZoomHorzAxis.first().data(); + else + return mRangeZoomVertAxis.isEmpty() ? 0 : mRangeZoomVertAxis.first().data(); +} + +/*! + Returns all range drag axes of the \a orientation provided. + + \see rangeZoomAxis, setRangeZoomAxes +*/ +QList QCPAxisRect::rangeDragAxes(Qt::Orientation orientation) +{ + QList result; + if (orientation == Qt::Horizontal) + { + for (int i=0; i QCPAxisRect::rangeZoomAxes(Qt::Orientation orientation) +{ + QList result; + if (orientation == Qt::Horizontal) + { + for (int i=0; iQt::Horizontal | + Qt::Vertical as \a orientations. + + In addition to setting \a orientations to a non-zero value, make sure \ref QCustomPlot::setInteractions + contains \ref QCP::iRangeDrag to enable the range dragging interaction. + + \see setRangeZoom, setRangeDragAxes, QCustomPlot::setNoAntialiasingOnDrag +*/ +void QCPAxisRect::setRangeDrag(Qt::Orientations orientations) +{ + mRangeDrag = orientations; +} + +/*! + Sets which axis orientation may be zoomed by the user with the mouse wheel. What orientation + corresponds to which specific axis can be set with \ref setRangeZoomAxes(QCPAxis *horizontal, + QCPAxis *vertical). By default, the horizontal axis is the bottom axis (xAxis) and the vertical + axis is the left axis (yAxis). + + To disable range zooming entirely, pass 0 as \a orientations or remove \ref QCP::iRangeZoom from \ref + QCustomPlot::setInteractions. To enable range zooming for both directions, pass Qt::Horizontal | + Qt::Vertical as \a orientations. + + In addition to setting \a orientations to a non-zero value, make sure \ref QCustomPlot::setInteractions + contains \ref QCP::iRangeZoom to enable the range zooming interaction. + + \see setRangeZoomFactor, setRangeZoomAxes, setRangeDrag +*/ +void QCPAxisRect::setRangeZoom(Qt::Orientations orientations) +{ + mRangeZoom = orientations; +} + +/*! \overload + + Sets the axes whose range will be dragged when \ref setRangeDrag enables mouse range dragging on + the QCustomPlot widget. Pass 0 if no axis shall be dragged in the respective orientation. + + Use the overload taking a list of axes, if multiple axes (more than one per orientation) shall + react to dragging interactions. + + \see setRangeZoomAxes +*/ +void QCPAxisRect::setRangeDragAxes(QCPAxis *horizontal, QCPAxis *vertical) +{ + QList horz, vert; + if (horizontal) + horz.append(horizontal); + if (vertical) + vert.append(vertical); + setRangeDragAxes(horz, vert); +} + +/*! \overload + + This method allows to set up multiple axes to react to horizontal and vertical dragging. The drag + orientation that the respective axis will react to is deduced from its orientation (\ref + QCPAxis::orientation). + + In the unusual case that you wish to e.g. drag a vertically oriented axis with a horizontal drag + motion, use the overload taking two separate lists for horizontal and vertical dragging. +*/ +void QCPAxisRect::setRangeDragAxes(QList axes) +{ + QList horz, vert; + foreach (QCPAxis *ax, axes) + { + if (ax->orientation() == Qt::Horizontal) + horz.append(ax); + else + vert.append(ax); + } + setRangeDragAxes(horz, vert); +} + +/*! \overload + + This method allows to set multiple axes up to react to horizontal and vertical dragging, and + define specifically which axis reacts to which drag orientation (irrespective of the axis + orientation). +*/ +void QCPAxisRect::setRangeDragAxes(QList horizontal, QList vertical) +{ + mRangeDragHorzAxis.clear(); + foreach (QCPAxis *ax, horizontal) + { + QPointer axPointer(ax); + if (!axPointer.isNull()) + mRangeDragHorzAxis.append(axPointer); + else + qDebug() << Q_FUNC_INFO << "invalid axis passed in horizontal list:" << reinterpret_cast(ax); + } + mRangeDragVertAxis.clear(); + foreach (QCPAxis *ax, vertical) + { + QPointer axPointer(ax); + if (!axPointer.isNull()) + mRangeDragVertAxis.append(axPointer); + else + qDebug() << Q_FUNC_INFO << "invalid axis passed in vertical list:" << reinterpret_cast(ax); + } +} + +/*! + Sets the axes whose range will be zoomed when \ref setRangeZoom enables mouse wheel zooming on + the QCustomPlot widget. Pass 0 if no axis shall be zoomed in the respective orientation. + + The two axes can be zoomed with different strengths, when different factors are passed to \ref + setRangeZoomFactor(double horizontalFactor, double verticalFactor). + + Use the overload taking a list of axes, if multiple axes (more than one per orientation) shall + react to zooming interactions. + + \see setRangeDragAxes +*/ +void QCPAxisRect::setRangeZoomAxes(QCPAxis *horizontal, QCPAxis *vertical) +{ + QList horz, vert; + if (horizontal) + horz.append(horizontal); + if (vertical) + vert.append(vertical); + setRangeZoomAxes(horz, vert); +} + +/*! \overload + + This method allows to set up multiple axes to react to horizontal and vertical range zooming. The + zoom orientation that the respective axis will react to is deduced from its orientation (\ref + QCPAxis::orientation). + + In the unusual case that you wish to e.g. zoom a vertically oriented axis with a horizontal zoom + interaction, use the overload taking two separate lists for horizontal and vertical zooming. +*/ +void QCPAxisRect::setRangeZoomAxes(QList axes) +{ + QList horz, vert; + foreach (QCPAxis *ax, axes) + { + if (ax->orientation() == Qt::Horizontal) + horz.append(ax); + else + vert.append(ax); + } + setRangeZoomAxes(horz, vert); +} + +/*! \overload + + This method allows to set multiple axes up to react to horizontal and vertical zooming, and + define specifically which axis reacts to which zoom orientation (irrespective of the axis + orientation). +*/ +void QCPAxisRect::setRangeZoomAxes(QList horizontal, QList vertical) +{ + mRangeZoomHorzAxis.clear(); + foreach (QCPAxis *ax, horizontal) + { + QPointer axPointer(ax); + if (!axPointer.isNull()) + mRangeZoomHorzAxis.append(axPointer); + else + qDebug() << Q_FUNC_INFO << "invalid axis passed in horizontal list:" << reinterpret_cast(ax); + } + mRangeZoomVertAxis.clear(); + foreach (QCPAxis *ax, vertical) + { + QPointer axPointer(ax); + if (!axPointer.isNull()) + mRangeZoomVertAxis.append(axPointer); + else + qDebug() << Q_FUNC_INFO << "invalid axis passed in vertical list:" << reinterpret_cast(ax); + } +} + +/*! + Sets how strong one rotation step of the mouse wheel zooms, when range zoom was activated with + \ref setRangeZoom. The two parameters \a horizontalFactor and \a verticalFactor provide a way to + let the horizontal axis zoom at different rates than the vertical axis. Which axis is horizontal + and which is vertical, can be set with \ref setRangeZoomAxes. + + When the zoom factor is greater than one, scrolling the mouse wheel backwards (towards the user) + will zoom in (make the currently visible range smaller). For zoom factors smaller than one, the + same scrolling direction will zoom out. +*/ +void QCPAxisRect::setRangeZoomFactor(double horizontalFactor, double verticalFactor) +{ + mRangeZoomFactorHorz = horizontalFactor; + mRangeZoomFactorVert = verticalFactor; +} + +/*! \overload + + Sets both the horizontal and vertical zoom \a factor. +*/ +void QCPAxisRect::setRangeZoomFactor(double factor) +{ + mRangeZoomFactorHorz = factor; + mRangeZoomFactorVert = factor; +} + +/*! \internal + + Draws the background of this axis rect. It may consist of a background fill (a QBrush) and a + pixmap. + + If a brush was given via \ref setBackground(const QBrush &brush), this function first draws an + according filling inside the axis rect with the provided \a painter. + + Then, if a pixmap was provided via \ref setBackground, this function buffers the scaled version + depending on \ref setBackgroundScaled and \ref setBackgroundScaledMode and then draws it inside + the axis rect with the provided \a painter. The scaled version is buffered in + mScaledBackgroundPixmap to prevent expensive rescaling at every redraw. It is only updated, when + the axis rect has changed in a way that requires a rescale of the background pixmap (this is + dependent on the \ref setBackgroundScaledMode), or when a differend axis background pixmap was + set. + + \see setBackground, setBackgroundScaled, setBackgroundScaledMode +*/ +void QCPAxisRect::drawBackground(QCPPainter *painter) +{ + // draw background fill: + if (mBackgroundBrush != Qt::NoBrush) + painter->fillRect(mRect, mBackgroundBrush); + + // draw background pixmap (on top of fill, if brush specified): + if (!mBackgroundPixmap.isNull()) + { + if (mBackgroundScaled) + { + // check whether mScaledBackground needs to be updated: + QSize scaledSize(mBackgroundPixmap.size()); + scaledSize.scale(mRect.size(), mBackgroundScaledMode); + if (mScaledBackgroundPixmap.size() != scaledSize) + mScaledBackgroundPixmap = mBackgroundPixmap.scaled(mRect.size(), mBackgroundScaledMode, Qt::SmoothTransformation); + painter->drawPixmap(mRect.topLeft()+QPoint(0, -1), mScaledBackgroundPixmap, QRect(0, 0, mRect.width(), mRect.height()) & mScaledBackgroundPixmap.rect()); + } else + { + painter->drawPixmap(mRect.topLeft()+QPoint(0, -1), mBackgroundPixmap, QRect(0, 0, mRect.width(), mRect.height())); + } + } +} + +/*! \internal + + This function makes sure multiple axes on the side specified with \a type don't collide, but are + distributed according to their respective space requirement (QCPAxis::calculateMargin). + + It does this by setting an appropriate offset (\ref QCPAxis::setOffset) on all axes except the + one with index zero. + + This function is called by \ref calculateAutoMargin. +*/ +void QCPAxisRect::updateAxesOffset(QCPAxis::AxisType type) +{ + const QList axesList = mAxes.value(type); + if (axesList.isEmpty()) + return; + + bool isFirstVisible = !axesList.first()->visible(); // if the first axis is visible, the second axis (which is where the loop starts) isn't the first visible axis, so initialize with false + for (int i=1; ioffset() + axesList.at(i-1)->calculateMargin(); + if (axesList.at(i)->visible()) // only add inner tick length to offset if this axis is visible and it's not the first visible one (might happen if true first axis is invisible) + { + if (!isFirstVisible) + offset += axesList.at(i)->tickLengthIn(); + isFirstVisible = false; + } + axesList.at(i)->setOffset(offset); + } +} + +/* inherits documentation from base class */ +int QCPAxisRect::calculateAutoMargin(QCP::MarginSide side) +{ + if (!mAutoMargins.testFlag(side)) + qDebug() << Q_FUNC_INFO << "Called with side that isn't specified as auto margin"; + + updateAxesOffset(QCPAxis::marginSideToAxisType(side)); + + // note: only need to look at the last (outer most) axis to determine the total margin, due to updateAxisOffset call + const QList axesList = mAxes.value(QCPAxis::marginSideToAxisType(side)); + if (axesList.size() > 0) + return axesList.last()->offset() + axesList.last()->calculateMargin(); + else + return 0; +} + +/*! \internal + + Reacts to a change in layout to potentially set the convenience axis pointers \ref + QCustomPlot::xAxis, \ref QCustomPlot::yAxis, etc. of the parent QCustomPlot to the respective + axes of this axis rect. This is only done if the respective convenience pointer is currently zero + and if there is no QCPAxisRect at position (0, 0) of the plot layout. + + This automation makes it simpler to replace the main axis rect with a newly created one, without + the need to manually reset the convenience pointers. +*/ +void QCPAxisRect::layoutChanged() +{ + if (mParentPlot && mParentPlot->axisRectCount() > 0 && mParentPlot->axisRect(0) == this) + { + if (axisCount(QCPAxis::atBottom) > 0 && !mParentPlot->xAxis) + mParentPlot->xAxis = axis(QCPAxis::atBottom); + if (axisCount(QCPAxis::atLeft) > 0 && !mParentPlot->yAxis) + mParentPlot->yAxis = axis(QCPAxis::atLeft); + if (axisCount(QCPAxis::atTop) > 0 && !mParentPlot->xAxis2) + mParentPlot->xAxis2 = axis(QCPAxis::atTop); + if (axisCount(QCPAxis::atRight) > 0 && !mParentPlot->yAxis2) + mParentPlot->yAxis2 = axis(QCPAxis::atRight); + } +} + +/*! \internal + + Event handler for when a mouse button is pressed on the axis rect. If the left mouse button is + pressed, the range dragging interaction is initialized (the actual range manipulation happens in + the \ref mouseMoveEvent). + + The mDragging flag is set to true and some anchor points are set that are needed to determine the + distance the mouse was dragged in the mouse move/release events later. + + \see mouseMoveEvent, mouseReleaseEvent +*/ +void QCPAxisRect::mousePressEvent(QMouseEvent *event, const QVariant &details) +{ + Q_UNUSED(details) + if (event->buttons() & Qt::LeftButton) + { + mDragging = true; + // initialize antialiasing backup in case we start dragging: + if (mParentPlot->noAntialiasingOnDrag()) + { + mAADragBackup = mParentPlot->antialiasedElements(); + mNotAADragBackup = mParentPlot->notAntialiasedElements(); + } + // Mouse range dragging interaction: + if (mParentPlot->interactions().testFlag(QCP::iRangeDrag)) + { + mDragStartHorzRange.clear(); + for (int i=0; irange()); + mDragStartVertRange.clear(); + for (int i=0; irange()); + } + } +} + +/*! \internal + + Event handler for when the mouse is moved on the axis rect. If range dragging was activated in a + preceding \ref mousePressEvent, the range is moved accordingly. + + \see mousePressEvent, mouseReleaseEvent +*/ +void QCPAxisRect::mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) +{ + Q_UNUSED(startPos) + // Mouse range dragging interaction: + if (mDragging && mParentPlot->interactions().testFlag(QCP::iRangeDrag)) + { + + if (mRangeDrag.testFlag(Qt::Horizontal)) + { + for (int i=0; i= mDragStartHorzRange.size()) + break; + if (ax->mScaleType == QCPAxis::stLinear) + { + double diff = ax->pixelToCoord(startPos.x()) - ax->pixelToCoord(event->pos().x()); + ax->setRange(mDragStartHorzRange.at(i).lower+diff, mDragStartHorzRange.at(i).upper+diff); + } else if (ax->mScaleType == QCPAxis::stLogarithmic) + { + double diff = ax->pixelToCoord(startPos.x()) / ax->pixelToCoord(event->pos().x()); + ax->setRange(mDragStartHorzRange.at(i).lower*diff, mDragStartHorzRange.at(i).upper*diff); + } + } + } + + if (mRangeDrag.testFlag(Qt::Vertical)) + { + for (int i=0; i= mDragStartVertRange.size()) + break; + if (ax->mScaleType == QCPAxis::stLinear) + { + double diff = ax->pixelToCoord(startPos.y()) - ax->pixelToCoord(event->pos().y()); + ax->setRange(mDragStartVertRange.at(i).lower+diff, mDragStartVertRange.at(i).upper+diff); + } else if (ax->mScaleType == QCPAxis::stLogarithmic) + { + double diff = ax->pixelToCoord(startPos.y()) / ax->pixelToCoord(event->pos().y()); + ax->setRange(mDragStartVertRange.at(i).lower*diff, mDragStartVertRange.at(i).upper*diff); + } + } + } + + if (mRangeDrag != 0) // if either vertical or horizontal drag was enabled, do a replot + { + if (mParentPlot->noAntialiasingOnDrag()) + mParentPlot->setNotAntialiasedElements(QCP::aeAll); + mParentPlot->replot(QCustomPlot::rpQueuedReplot); + } + + } +} + +/* inherits documentation from base class */ +void QCPAxisRect::mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) +{ + Q_UNUSED(event) + Q_UNUSED(startPos) + mDragging = false; + if (mParentPlot->noAntialiasingOnDrag()) + { + mParentPlot->setAntialiasedElements(mAADragBackup); + mParentPlot->setNotAntialiasedElements(mNotAADragBackup); + } +} + +/*! \internal + + Event handler for mouse wheel events. If rangeZoom is Qt::Horizontal, Qt::Vertical or both, the + ranges of the axes defined as rangeZoomHorzAxis and rangeZoomVertAxis are scaled. The center of + the scaling operation is the current cursor position inside the axis rect. The scaling factor is + dependent on the mouse wheel delta (which direction the wheel was rotated) to provide a natural + zooming feel. The Strength of the zoom can be controlled via \ref setRangeZoomFactor. + + Note, that event->delta() is usually +/-120 for single rotation steps. However, if the mouse + wheel is turned rapidly, many steps may bunch up to one event, so the event->delta() may then be + multiples of 120. This is taken into account here, by calculating \a wheelSteps and using it as + exponent of the range zoom factor. This takes care of the wheel direction automatically, by + inverting the factor, when the wheel step is negative (f^-1 = 1/f). +*/ +void QCPAxisRect::wheelEvent(QWheelEvent *event) +{ + // Mouse range zooming interaction: + if (mParentPlot->interactions().testFlag(QCP::iRangeZoom)) + { + if (mRangeZoom != 0) + { + double factor; + double wheelSteps = event->delta()/120.0; // a single step delta is +/-120 usually + if (mRangeZoom.testFlag(Qt::Horizontal)) + { + factor = qPow(mRangeZoomFactorHorz, wheelSteps); + for (int i=0; iscaleRange(factor, mRangeZoomHorzAxis.at(i)->pixelToCoord(event->pos().x())); + } + } + if (mRangeZoom.testFlag(Qt::Vertical)) + { + factor = qPow(mRangeZoomFactorVert, wheelSteps); + for (int i=0; iscaleRange(factor, mRangeZoomVertAxis.at(i)->pixelToCoord(event->pos().y())); + } + } + mParentPlot->replot(); + } + } +} +/* end of 'src/layoutelements/layoutelement-axisrect.cpp' */ + + +/* including file 'src/layoutelements/layoutelement-legend.cpp', size 31153 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAbstractLegendItem +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPAbstractLegendItem + \brief The abstract base class for all entries in a QCPLegend. + + It defines a very basic interface for entries in a QCPLegend. For representing plottables in the + legend, the subclass \ref QCPPlottableLegendItem is more suitable. + + Only derive directly from this class when you need absolute freedom (e.g. a custom legend entry + that's not even associated with a plottable). + + You must implement the following pure virtual functions: + \li \ref draw (from QCPLayerable) + + You inherit the following members you may use: + + + + + + + + +
QCPLegend *\b mParentLegendA pointer to the parent QCPLegend.
QFont \b mFontThe generic font of the item. You should use this font for all or at least the most prominent text of the item.
+*/ + +/* start of documentation of signals */ + +/*! \fn void QCPAbstractLegendItem::selectionChanged(bool selected) + + This signal is emitted when the selection state of this legend item has changed, either by user + interaction or by a direct call to \ref setSelected. +*/ + +/* end of documentation of signals */ + +/*! + Constructs a QCPAbstractLegendItem and associates it with the QCPLegend \a parent. This does not + cause the item to be added to \a parent, so \ref QCPLegend::addItem must be called separately. +*/ +QCPAbstractLegendItem::QCPAbstractLegendItem(QCPLegend *parent) : + QCPLayoutElement(parent->parentPlot()), + mParentLegend(parent), + mFont(parent->font()), + mTextColor(parent->textColor()), + mSelectedFont(parent->selectedFont()), + mSelectedTextColor(parent->selectedTextColor()), + mSelectable(true), + mSelected(false) +{ + setLayer(QLatin1String("legend")); + setMargins(QMargins(0, 0, 0, 0)); +} + +/*! + Sets the default font of this specific legend item to \a font. + + \see setTextColor, QCPLegend::setFont +*/ +void QCPAbstractLegendItem::setFont(const QFont &font) +{ + mFont = font; +} + +/*! + Sets the default text color of this specific legend item to \a color. + + \see setFont, QCPLegend::setTextColor +*/ +void QCPAbstractLegendItem::setTextColor(const QColor &color) +{ + mTextColor = color; +} + +/*! + When this legend item is selected, \a font is used to draw generic text, instead of the normal + font set with \ref setFont. + + \see setFont, QCPLegend::setSelectedFont +*/ +void QCPAbstractLegendItem::setSelectedFont(const QFont &font) +{ + mSelectedFont = font; +} + +/*! + When this legend item is selected, \a color is used to draw generic text, instead of the normal + color set with \ref setTextColor. + + \see setTextColor, QCPLegend::setSelectedTextColor +*/ +void QCPAbstractLegendItem::setSelectedTextColor(const QColor &color) +{ + mSelectedTextColor = color; +} + +/*! + Sets whether this specific legend item is selectable. + + \see setSelectedParts, QCustomPlot::setInteractions +*/ +void QCPAbstractLegendItem::setSelectable(bool selectable) +{ + if (mSelectable != selectable) + { + mSelectable = selectable; + emit selectableChanged(mSelectable); + } +} + +/*! + Sets whether this specific legend item is selected. + + It is possible to set the selection state of this item by calling this function directly, even if + setSelectable is set to false. + + \see setSelectableParts, QCustomPlot::setInteractions +*/ +void QCPAbstractLegendItem::setSelected(bool selected) +{ + if (mSelected != selected) + { + mSelected = selected; + emit selectionChanged(mSelected); + } +} + +/* inherits documentation from base class */ +double QCPAbstractLegendItem::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (!mParentPlot) return -1; + if (onlySelectable && (!mSelectable || !mParentLegend->selectableParts().testFlag(QCPLegend::spItems))) + return -1; + + if (mRect.contains(pos.toPoint())) + return mParentPlot->selectionTolerance()*0.99; + else + return -1; +} + +/* inherits documentation from base class */ +void QCPAbstractLegendItem::applyDefaultAntialiasingHint(QCPPainter *painter) const +{ + applyAntialiasingHint(painter, mAntialiased, QCP::aeLegendItems); +} + +/* inherits documentation from base class */ +QRect QCPAbstractLegendItem::clipRect() const +{ + return mOuterRect; +} + +/* inherits documentation from base class */ +void QCPAbstractLegendItem::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) +{ + Q_UNUSED(event) + Q_UNUSED(details) + if (mSelectable && mParentLegend->selectableParts().testFlag(QCPLegend::spItems)) + { + bool selBefore = mSelected; + setSelected(additive ? !mSelected : true); + if (selectionStateChanged) + *selectionStateChanged = mSelected != selBefore; + } +} + +/* inherits documentation from base class */ +void QCPAbstractLegendItem::deselectEvent(bool *selectionStateChanged) +{ + if (mSelectable && mParentLegend->selectableParts().testFlag(QCPLegend::spItems)) + { + bool selBefore = mSelected; + setSelected(false); + if (selectionStateChanged) + *selectionStateChanged = mSelected != selBefore; + } +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPPlottableLegendItem +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPPlottableLegendItem + \brief A legend item representing a plottable with an icon and the plottable name. + + This is the standard legend item for plottables. It displays an icon of the plottable next to the + plottable name. The icon is drawn by the respective plottable itself (\ref + QCPAbstractPlottable::drawLegendIcon), and tries to give an intuitive symbol for the plottable. + For example, the QCPGraph draws a centered horizontal line and/or a single scatter point in the + middle. + + Legend items of this type are always associated with one plottable (retrievable via the + plottable() function and settable with the constructor). You may change the font of the plottable + name with \ref setFont. Icon padding and border pen is taken from the parent QCPLegend, see \ref + QCPLegend::setIconBorderPen and \ref QCPLegend::setIconTextPadding. + + The function \ref QCPAbstractPlottable::addToLegend/\ref QCPAbstractPlottable::removeFromLegend + creates/removes legend items of this type. + + Since QCPLegend is based on QCPLayoutGrid, a legend item itself is just a subclass of + QCPLayoutElement. While it could be added to a legend (or any other layout) via the normal layout + interface, QCPLegend has specialized functions for handling legend items conveniently, see the + documentation of \ref QCPLegend. +*/ + +/*! + Creates a new legend item associated with \a plottable. + + Once it's created, it can be added to the legend via \ref QCPLegend::addItem. + + A more convenient way of adding/removing a plottable to/from the legend is via the functions \ref + QCPAbstractPlottable::addToLegend and \ref QCPAbstractPlottable::removeFromLegend. +*/ +QCPPlottableLegendItem::QCPPlottableLegendItem(QCPLegend *parent, QCPAbstractPlottable *plottable) : + QCPAbstractLegendItem(parent), + mPlottable(plottable) +{ + setAntialiased(false); +} + +/*! \internal + + Returns the pen that shall be used to draw the icon border, taking into account the selection + state of this item. +*/ +QPen QCPPlottableLegendItem::getIconBorderPen() const +{ + return mSelected ? mParentLegend->selectedIconBorderPen() : mParentLegend->iconBorderPen(); +} + +/*! \internal + + Returns the text color that shall be used to draw text, taking into account the selection state + of this item. +*/ +QColor QCPPlottableLegendItem::getTextColor() const +{ + return mSelected ? mSelectedTextColor : mTextColor; +} + +/*! \internal + + Returns the font that shall be used to draw text, taking into account the selection state of this + item. +*/ +QFont QCPPlottableLegendItem::getFont() const +{ + return mSelected ? mSelectedFont : mFont; +} + +/*! \internal + + Draws the item with \a painter. The size and position of the drawn legend item is defined by the + parent layout (typically a \ref QCPLegend) and the \ref minimumOuterSizeHint and \ref + maximumOuterSizeHint of this legend item. +*/ +void QCPPlottableLegendItem::draw(QCPPainter *painter) +{ + if (!mPlottable) return; + painter->setFont(getFont()); + painter->setPen(QPen(getTextColor())); + QSizeF iconSize = mParentLegend->iconSize(); + QRectF textRect = painter->fontMetrics().boundingRect(0, 0, 0, iconSize.height(), Qt::TextDontClip, mPlottable->name()); + QRectF iconRect(mRect.topLeft(), iconSize); + int textHeight = qMax(textRect.height(), iconSize.height()); // if text has smaller height than icon, center text vertically in icon height, else align tops + painter->drawText(mRect.x()+iconSize.width()+mParentLegend->iconTextPadding(), mRect.y(), textRect.width(), textHeight, Qt::TextDontClip, mPlottable->name()); + // draw icon: + painter->save(); + painter->setClipRect(iconRect, Qt::IntersectClip); + mPlottable->drawLegendIcon(painter, iconRect); + painter->restore(); + // draw icon border: + if (getIconBorderPen().style() != Qt::NoPen) + { + painter->setPen(getIconBorderPen()); + painter->setBrush(Qt::NoBrush); + int halfPen = qCeil(painter->pen().widthF()*0.5)+1; + painter->setClipRect(mOuterRect.adjusted(-halfPen, -halfPen, halfPen, halfPen)); // extend default clip rect so thicker pens (especially during selection) are not clipped + painter->drawRect(iconRect); + } +} + +/*! \internal + + Calculates and returns the size of this item. This includes the icon, the text and the padding in + between. + + \seebaseclassmethod +*/ +QSize QCPPlottableLegendItem::minimumOuterSizeHint() const +{ + if (!mPlottable) return QSize(); + QSize result(0, 0); + QRect textRect; + QFontMetrics fontMetrics(getFont()); + QSize iconSize = mParentLegend->iconSize(); + textRect = fontMetrics.boundingRect(0, 0, 0, iconSize.height(), Qt::TextDontClip, mPlottable->name()); + result.setWidth(iconSize.width() + mParentLegend->iconTextPadding() + textRect.width()); + result.setHeight(qMax(textRect.height(), iconSize.height())); + result.rwidth() += mMargins.left()+mMargins.right(); + result.rheight() += mMargins.top()+mMargins.bottom(); + return result; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPLegend +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPLegend + \brief Manages a legend inside a QCustomPlot. + + A legend is a small box somewhere in the plot which lists plottables with their name and icon. + + A legend is populated with legend items by calling \ref QCPAbstractPlottable::addToLegend on the + plottable, for which a legend item shall be created. In the case of the main legend (\ref + QCustomPlot::legend), simply adding plottables to the plot while \ref + QCustomPlot::setAutoAddPlottableToLegend is set to true (the default) creates corresponding + legend items. The legend item associated with a certain plottable can be removed with \ref + QCPAbstractPlottable::removeFromLegend. However, QCPLegend also offers an interface to add and + manipulate legend items directly: \ref item, \ref itemWithPlottable, \ref itemCount, \ref + addItem, \ref removeItem, etc. + + Since \ref QCPLegend derives from \ref QCPLayoutGrid, it can be placed in any position a \ref + QCPLayoutElement may be positioned. The legend items are themselves \ref QCPLayoutElement + "QCPLayoutElements" which are placed in the grid layout of the legend. \ref QCPLegend only adds + an interface specialized for handling child elements of type \ref QCPAbstractLegendItem, as + mentioned above. In principle, any other layout elements may also be added to a legend via the + normal \ref QCPLayoutGrid interface. See the special page about \link thelayoutsystem The Layout + System\endlink for examples on how to add other elements to the legend and move it outside the axis + rect. + + Use the methods \ref setFillOrder and \ref setWrap inherited from \ref QCPLayoutGrid to control + in which order (column first or row first) the legend is filled up when calling \ref addItem, and + at which column or row wrapping occurs. The default fill order for legends is \ref foRowsFirst. + + By default, every QCustomPlot has one legend (\ref QCustomPlot::legend) which is placed in the + inset layout of the main axis rect (\ref QCPAxisRect::insetLayout). To move the legend to another + position inside the axis rect, use the methods of the \ref QCPLayoutInset. To move the legend + outside of the axis rect, place it anywhere else with the \ref QCPLayout/\ref QCPLayoutElement + interface. +*/ + +/* start of documentation of signals */ + +/*! \fn void QCPLegend::selectionChanged(QCPLegend::SelectableParts selection); + + This signal is emitted when the selection state of this legend has changed. + + \see setSelectedParts, setSelectableParts +*/ + +/* end of documentation of signals */ + +/*! + Constructs a new QCPLegend instance with default values. + + Note that by default, QCustomPlot already contains a legend ready to be used as \ref + QCustomPlot::legend +*/ +QCPLegend::QCPLegend() +{ + setFillOrder(QCPLayoutGrid::foRowsFirst); + setWrap(0); + + setRowSpacing(3); + setColumnSpacing(8); + setMargins(QMargins(7, 5, 7, 4)); + setAntialiased(false); + setIconSize(32, 18); + + setIconTextPadding(7); + + setSelectableParts(spLegendBox | spItems); + setSelectedParts(spNone); + + setBorderPen(QPen(Qt::black, 0)); + setSelectedBorderPen(QPen(Qt::blue, 2)); + setIconBorderPen(Qt::NoPen); + setSelectedIconBorderPen(QPen(Qt::blue, 2)); + setBrush(Qt::white); + setSelectedBrush(Qt::white); + setTextColor(Qt::black); + setSelectedTextColor(Qt::blue); +} + +QCPLegend::~QCPLegend() +{ + clearItems(); + if (qobject_cast(mParentPlot)) // make sure this isn't called from QObject dtor when QCustomPlot is already destructed (happens when the legend is not in any layout and thus QObject-child of QCustomPlot) + mParentPlot->legendRemoved(this); +} + +/* no doc for getter, see setSelectedParts */ +QCPLegend::SelectableParts QCPLegend::selectedParts() const +{ + // check whether any legend elements selected, if yes, add spItems to return value + bool hasSelectedItems = false; + for (int i=0; iselected()) + { + hasSelectedItems = true; + break; + } + } + if (hasSelectedItems) + return mSelectedParts | spItems; + else + return mSelectedParts & ~spItems; +} + +/*! + Sets the pen, the border of the entire legend is drawn with. +*/ +void QCPLegend::setBorderPen(const QPen &pen) +{ + mBorderPen = pen; +} + +/*! + Sets the brush of the legend background. +*/ +void QCPLegend::setBrush(const QBrush &brush) +{ + mBrush = brush; +} + +/*! + Sets the default font of legend text. Legend items that draw text (e.g. the name of a graph) will + use this font by default. However, a different font can be specified on a per-item-basis by + accessing the specific legend item. + + This function will also set \a font on all already existing legend items. + + \see QCPAbstractLegendItem::setFont +*/ +void QCPLegend::setFont(const QFont &font) +{ + mFont = font; + for (int i=0; isetFont(mFont); + } +} + +/*! + Sets the default color of legend text. Legend items that draw text (e.g. the name of a graph) + will use this color by default. However, a different colors can be specified on a per-item-basis + by accessing the specific legend item. + + This function will also set \a color on all already existing legend items. + + \see QCPAbstractLegendItem::setTextColor +*/ +void QCPLegend::setTextColor(const QColor &color) +{ + mTextColor = color; + for (int i=0; isetTextColor(color); + } +} + +/*! + Sets the size of legend icons. Legend items that draw an icon (e.g. a visual + representation of the graph) will use this size by default. +*/ +void QCPLegend::setIconSize(const QSize &size) +{ + mIconSize = size; +} + +/*! \overload +*/ +void QCPLegend::setIconSize(int width, int height) +{ + mIconSize.setWidth(width); + mIconSize.setHeight(height); +} + +/*! + Sets the horizontal space in pixels between the legend icon and the text next to it. + Legend items that draw an icon (e.g. a visual representation of the graph) and text (e.g. the + name of the graph) will use this space by default. +*/ +void QCPLegend::setIconTextPadding(int padding) +{ + mIconTextPadding = padding; +} + +/*! + Sets the pen used to draw a border around each legend icon. Legend items that draw an + icon (e.g. a visual representation of the graph) will use this pen by default. + + If no border is wanted, set this to \a Qt::NoPen. +*/ +void QCPLegend::setIconBorderPen(const QPen &pen) +{ + mIconBorderPen = pen; +} + +/*! + Sets whether the user can (de-)select the parts in \a selectable by clicking on the QCustomPlot surface. + (When \ref QCustomPlot::setInteractions contains \ref QCP::iSelectLegend.) + + However, even when \a selectable is set to a value not allowing the selection of a specific part, + it is still possible to set the selection of this part manually, by calling \ref setSelectedParts + directly. + + \see SelectablePart, setSelectedParts +*/ +void QCPLegend::setSelectableParts(const SelectableParts &selectable) +{ + if (mSelectableParts != selectable) + { + mSelectableParts = selectable; + emit selectableChanged(mSelectableParts); + } +} + +/*! + Sets the selected state of the respective legend parts described by \ref SelectablePart. When a part + is selected, it uses a different pen/font and brush. If some legend items are selected and \a selected + doesn't contain \ref spItems, those items become deselected. + + The entire selection mechanism is handled automatically when \ref QCustomPlot::setInteractions + contains iSelectLegend. You only need to call this function when you wish to change the selection + state manually. + + This function can change the selection state of a part even when \ref setSelectableParts was set to a + value that actually excludes the part. + + emits the \ref selectionChanged signal when \a selected is different from the previous selection state. + + Note that it doesn't make sense to set the selected state \ref spItems here when it wasn't set + before, because there's no way to specify which exact items to newly select. Do this by calling + \ref QCPAbstractLegendItem::setSelected directly on the legend item you wish to select. + + \see SelectablePart, setSelectableParts, selectTest, setSelectedBorderPen, setSelectedIconBorderPen, setSelectedBrush, + setSelectedFont +*/ +void QCPLegend::setSelectedParts(const SelectableParts &selected) +{ + SelectableParts newSelected = selected; + mSelectedParts = this->selectedParts(); // update mSelectedParts in case item selection changed + + if (mSelectedParts != newSelected) + { + if (!mSelectedParts.testFlag(spItems) && newSelected.testFlag(spItems)) // attempt to set spItems flag (can't do that) + { + qDebug() << Q_FUNC_INFO << "spItems flag can not be set, it can only be unset with this function"; + newSelected &= ~spItems; + } + if (mSelectedParts.testFlag(spItems) && !newSelected.testFlag(spItems)) // spItems flag was unset, so clear item selection + { + for (int i=0; isetSelected(false); + } + } + mSelectedParts = newSelected; + emit selectionChanged(mSelectedParts); + } +} + +/*! + When the legend box is selected, this pen is used to draw the border instead of the normal pen + set via \ref setBorderPen. + + \see setSelectedParts, setSelectableParts, setSelectedBrush +*/ +void QCPLegend::setSelectedBorderPen(const QPen &pen) +{ + mSelectedBorderPen = pen; +} + +/*! + Sets the pen legend items will use to draw their icon borders, when they are selected. + + \see setSelectedParts, setSelectableParts, setSelectedFont +*/ +void QCPLegend::setSelectedIconBorderPen(const QPen &pen) +{ + mSelectedIconBorderPen = pen; +} + +/*! + When the legend box is selected, this brush is used to draw the legend background instead of the normal brush + set via \ref setBrush. + + \see setSelectedParts, setSelectableParts, setSelectedBorderPen +*/ +void QCPLegend::setSelectedBrush(const QBrush &brush) +{ + mSelectedBrush = brush; +} + +/*! + Sets the default font that is used by legend items when they are selected. + + This function will also set \a font on all already existing legend items. + + \see setFont, QCPAbstractLegendItem::setSelectedFont +*/ +void QCPLegend::setSelectedFont(const QFont &font) +{ + mSelectedFont = font; + for (int i=0; isetSelectedFont(font); + } +} + +/*! + Sets the default text color that is used by legend items when they are selected. + + This function will also set \a color on all already existing legend items. + + \see setTextColor, QCPAbstractLegendItem::setSelectedTextColor +*/ +void QCPLegend::setSelectedTextColor(const QColor &color) +{ + mSelectedTextColor = color; + for (int i=0; isetSelectedTextColor(color); + } +} + +/*! + Returns the item with index \a i. + + Note that the linear index depends on the current fill order (\ref setFillOrder). + + \see itemCount, addItem, itemWithPlottable +*/ +QCPAbstractLegendItem *QCPLegend::item(int index) const +{ + return qobject_cast(elementAt(index)); +} + +/*! + Returns the QCPPlottableLegendItem which is associated with \a plottable (e.g. a \ref QCPGraph*). + If such an item isn't in the legend, returns 0. + + \see hasItemWithPlottable +*/ +QCPPlottableLegendItem *QCPLegend::itemWithPlottable(const QCPAbstractPlottable *plottable) const +{ + for (int i=0; i(item(i))) + { + if (pli->plottable() == plottable) + return pli; + } + } + return 0; +} + +/*! + Returns the number of items currently in the legend. + + Note that if empty cells are in the legend (e.g. by calling methods of the \ref QCPLayoutGrid + base class which allows creating empty cells), they are included in the returned count. + + \see item +*/ +int QCPLegend::itemCount() const +{ + return elementCount(); +} + +/*! + Returns whether the legend contains \a item. + + \see hasItemWithPlottable +*/ +bool QCPLegend::hasItem(QCPAbstractLegendItem *item) const +{ + for (int i=0; iitem(i)) + return true; + } + return false; +} + +/*! + Returns whether the legend contains a QCPPlottableLegendItem which is associated with \a plottable (e.g. a \ref QCPGraph*). + If such an item isn't in the legend, returns false. + + \see itemWithPlottable +*/ +bool QCPLegend::hasItemWithPlottable(const QCPAbstractPlottable *plottable) const +{ + return itemWithPlottable(plottable); +} + +/*! + Adds \a item to the legend, if it's not present already. The element is arranged according to the + current fill order (\ref setFillOrder) and wrapping (\ref setWrap). + + Returns true on sucess, i.e. if the item wasn't in the list already and has been successfuly added. + + The legend takes ownership of the item. + + \see removeItem, item, hasItem +*/ +bool QCPLegend::addItem(QCPAbstractLegendItem *item) +{ + return addElement(item); +} + +/*! \overload + + Removes the item with the specified \a index from the legend and deletes it. + + After successful removal, the legend is reordered according to the current fill order (\ref + setFillOrder) and wrapping (\ref setWrap), so no empty cell remains where the removed \a item + was. If you don't want this, rather use the raw element interface of \ref QCPLayoutGrid. + + Returns true, if successful. Unlike \ref QCPLayoutGrid::removeAt, this method only removes + elements derived from \ref QCPAbstractLegendItem. + + \see itemCount, clearItems +*/ +bool QCPLegend::removeItem(int index) +{ + if (QCPAbstractLegendItem *ali = item(index)) + { + bool success = remove(ali); + if (success) + setFillOrder(fillOrder(), true); // gets rid of empty cell by reordering + return success; + } else + return false; +} + +/*! \overload + + Removes \a item from the legend and deletes it. + + After successful removal, the legend is reordered according to the current fill order (\ref + setFillOrder) and wrapping (\ref setWrap), so no empty cell remains where the removed \a item + was. If you don't want this, rather use the raw element interface of \ref QCPLayoutGrid. + + Returns true, if successful. + + \see clearItems +*/ +bool QCPLegend::removeItem(QCPAbstractLegendItem *item) +{ + bool success = remove(item); + if (success) + setFillOrder(fillOrder(), true); // gets rid of empty cell by reordering + return success; +} + +/*! + Removes all items from the legend. +*/ +void QCPLegend::clearItems() +{ + for (int i=itemCount()-1; i>=0; --i) + removeItem(i); +} + +/*! + Returns the legend items that are currently selected. If no items are selected, + the list is empty. + + \see QCPAbstractLegendItem::setSelected, setSelectable +*/ +QList QCPLegend::selectedItems() const +{ + QList result; + for (int i=0; iselected()) + result.append(ali); + } + } + return result; +} + +/*! \internal + + A convenience function to easily set the QPainter::Antialiased hint on the provided \a painter + before drawing main legend elements. + + This is the antialiasing state the painter passed to the \ref draw method is in by default. + + This function takes into account the local setting of the antialiasing flag as well as the + overrides set with \ref QCustomPlot::setAntialiasedElements and \ref + QCustomPlot::setNotAntialiasedElements. + + \seebaseclassmethod + + \see setAntialiased +*/ +void QCPLegend::applyDefaultAntialiasingHint(QCPPainter *painter) const +{ + applyAntialiasingHint(painter, mAntialiased, QCP::aeLegend); +} + +/*! \internal + + Returns the pen used to paint the border of the legend, taking into account the selection state + of the legend box. +*/ +QPen QCPLegend::getBorderPen() const +{ + return mSelectedParts.testFlag(spLegendBox) ? mSelectedBorderPen : mBorderPen; +} + +/*! \internal + + Returns the brush used to paint the background of the legend, taking into account the selection + state of the legend box. +*/ +QBrush QCPLegend::getBrush() const +{ + return mSelectedParts.testFlag(spLegendBox) ? mSelectedBrush : mBrush; +} + +/*! \internal + + Draws the legend box with the provided \a painter. The individual legend items are layerables + themselves, thus are drawn independently. +*/ +void QCPLegend::draw(QCPPainter *painter) +{ + // draw background rect: + painter->setBrush(getBrush()); + painter->setPen(getBorderPen()); + painter->drawRect(mOuterRect); +} + +/* inherits documentation from base class */ +double QCPLegend::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + if (!mParentPlot) return -1; + if (onlySelectable && !mSelectableParts.testFlag(spLegendBox)) + return -1; + + if (mOuterRect.contains(pos.toPoint())) + { + if (details) details->setValue(spLegendBox); + return mParentPlot->selectionTolerance()*0.99; + } + return -1; +} + +/* inherits documentation from base class */ +void QCPLegend::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) +{ + Q_UNUSED(event) + mSelectedParts = selectedParts(); // in case item selection has changed + if (details.value() == spLegendBox && mSelectableParts.testFlag(spLegendBox)) + { + SelectableParts selBefore = mSelectedParts; + setSelectedParts(additive ? mSelectedParts^spLegendBox : mSelectedParts|spLegendBox); // no need to unset spItems in !additive case, because they will be deselected by QCustomPlot (they're normal QCPLayerables with own deselectEvent) + if (selectionStateChanged) + *selectionStateChanged = mSelectedParts != selBefore; + } +} + +/* inherits documentation from base class */ +void QCPLegend::deselectEvent(bool *selectionStateChanged) +{ + mSelectedParts = selectedParts(); // in case item selection has changed + if (mSelectableParts.testFlag(spLegendBox)) + { + SelectableParts selBefore = mSelectedParts; + setSelectedParts(selectedParts() & ~spLegendBox); + if (selectionStateChanged) + *selectionStateChanged = mSelectedParts != selBefore; + } +} + +/* inherits documentation from base class */ +QCP::Interaction QCPLegend::selectionCategory() const +{ + return QCP::iSelectLegend; +} + +/* inherits documentation from base class */ +QCP::Interaction QCPAbstractLegendItem::selectionCategory() const +{ + return QCP::iSelectLegend; +} + +/* inherits documentation from base class */ +void QCPLegend::parentPlotInitialized(QCustomPlot *parentPlot) +{ + if (parentPlot && !parentPlot->legend) + parentPlot->legend = this; +} +/* end of 'src/layoutelements/layoutelement-legend.cpp' */ + + +/* including file 'src/layoutelements/layoutelement-textelement.cpp', size 12761 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPTextElement +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPTextElement + \brief A layout element displaying a text + + The text may be specified with \ref setText, the formatting can be controlled with \ref setFont, + \ref setTextColor, and \ref setTextFlags. + + A text element can be added as follows: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcptextelement-creation +*/ + +/* start documentation of signals */ + +/*! \fn void QCPTextElement::selectionChanged(bool selected) + + This signal is emitted when the selection state has changed to \a selected, either by user + interaction or by a direct call to \ref setSelected. + + \see setSelected, setSelectable +*/ + +/*! \fn void QCPTextElement::clicked(QMouseEvent *event) + + This signal is emitted when the text element is clicked. + + \see doubleClicked, selectTest +*/ + +/*! \fn void QCPTextElement::doubleClicked(QMouseEvent *event) + + This signal is emitted when the text element is double clicked. + + \see clicked, selectTest +*/ + +/* end documentation of signals */ + +/*! \overload + + Creates a new QCPTextElement instance and sets default values. The initial text is empty (\ref + setText). +*/ +QCPTextElement::QCPTextElement(QCustomPlot *parentPlot) : + QCPLayoutElement(parentPlot), + mText(), + mTextFlags(Qt::AlignCenter|Qt::TextWordWrap), + mFont(QFont(QLatin1String("sans serif"), 12)), // will be taken from parentPlot if available, see below + mTextColor(Qt::black), + mSelectedFont(QFont(QLatin1String("sans serif"), 12)), // will be taken from parentPlot if available, see below + mSelectedTextColor(Qt::blue), + mSelectable(false), + mSelected(false) +{ + if (parentPlot) + { + mFont = parentPlot->font(); + mSelectedFont = parentPlot->font(); + } + setMargins(QMargins(2, 2, 2, 2)); +} + +/*! \overload + + Creates a new QCPTextElement instance and sets default values. + + The initial text is set to \a text. +*/ +QCPTextElement::QCPTextElement(QCustomPlot *parentPlot, const QString &text) : + QCPLayoutElement(parentPlot), + mText(text), + mTextFlags(Qt::AlignCenter|Qt::TextWordWrap), + mFont(QFont(QLatin1String("sans serif"), 12)), // will be taken from parentPlot if available, see below + mTextColor(Qt::black), + mSelectedFont(QFont(QLatin1String("sans serif"), 12)), // will be taken from parentPlot if available, see below + mSelectedTextColor(Qt::blue), + mSelectable(false), + mSelected(false) +{ + if (parentPlot) + { + mFont = parentPlot->font(); + mSelectedFont = parentPlot->font(); + } + setMargins(QMargins(2, 2, 2, 2)); +} + +/*! \overload + + Creates a new QCPTextElement instance and sets default values. + + The initial text is set to \a text with \a pointSize. +*/ +QCPTextElement::QCPTextElement(QCustomPlot *parentPlot, const QString &text, double pointSize) : + QCPLayoutElement(parentPlot), + mText(text), + mTextFlags(Qt::AlignCenter|Qt::TextWordWrap), + mFont(QFont(QLatin1String("sans serif"), pointSize)), // will be taken from parentPlot if available, see below + mTextColor(Qt::black), + mSelectedFont(QFont(QLatin1String("sans serif"), pointSize)), // will be taken from parentPlot if available, see below + mSelectedTextColor(Qt::blue), + mSelectable(false), + mSelected(false) +{ + if (parentPlot) + { + mFont = parentPlot->font(); + mFont.setPointSizeF(pointSize); + mSelectedFont = parentPlot->font(); + mSelectedFont.setPointSizeF(pointSize); + } + setMargins(QMargins(2, 2, 2, 2)); +} + +/*! \overload + + Creates a new QCPTextElement instance and sets default values. + + The initial text is set to \a text with \a pointSize and the specified \a fontFamily. +*/ +QCPTextElement::QCPTextElement(QCustomPlot *parentPlot, const QString &text, const QString &fontFamily, double pointSize) : + QCPLayoutElement(parentPlot), + mText(text), + mTextFlags(Qt::AlignCenter|Qt::TextWordWrap), + mFont(QFont(fontFamily, pointSize)), + mTextColor(Qt::black), + mSelectedFont(QFont(fontFamily, pointSize)), + mSelectedTextColor(Qt::blue), + mSelectable(false), + mSelected(false) +{ + setMargins(QMargins(2, 2, 2, 2)); +} + +/*! \overload + + Creates a new QCPTextElement instance and sets default values. + + The initial text is set to \a text with the specified \a font. +*/ +QCPTextElement::QCPTextElement(QCustomPlot *parentPlot, const QString &text, const QFont &font) : + QCPLayoutElement(parentPlot), + mText(text), + mTextFlags(Qt::AlignCenter|Qt::TextWordWrap), + mFont(font), + mTextColor(Qt::black), + mSelectedFont(font), + mSelectedTextColor(Qt::blue), + mSelectable(false), + mSelected(false) +{ + setMargins(QMargins(2, 2, 2, 2)); +} + +/*! + Sets the text that will be displayed to \a text. Multiple lines can be created by insertion of "\n". + + \see setFont, setTextColor, setTextFlags +*/ +void QCPTextElement::setText(const QString &text) +{ + mText = text; +} + +/*! + Sets options for text alignment and wrapping behaviour. \a flags is a bitwise OR-combination of + \c Qt::AlignmentFlag and \c Qt::TextFlag enums. + + Possible enums are: + - Qt::AlignLeft + - Qt::AlignRight + - Qt::AlignHCenter + - Qt::AlignJustify + - Qt::AlignTop + - Qt::AlignBottom + - Qt::AlignVCenter + - Qt::AlignCenter + - Qt::TextDontClip + - Qt::TextSingleLine + - Qt::TextExpandTabs + - Qt::TextShowMnemonic + - Qt::TextWordWrap + - Qt::TextIncludeTrailingSpaces +*/ +void QCPTextElement::setTextFlags(int flags) +{ + mTextFlags = flags; +} + +/*! + Sets the \a font of the text. + + \see setTextColor, setSelectedFont +*/ +void QCPTextElement::setFont(const QFont &font) +{ + mFont = font; +} + +/*! + Sets the \a color of the text. + + \see setFont, setSelectedTextColor +*/ +void QCPTextElement::setTextColor(const QColor &color) +{ + mTextColor = color; +} + +/*! + Sets the \a font of the text that will be used if the text element is selected (\ref setSelected). + + \see setFont +*/ +void QCPTextElement::setSelectedFont(const QFont &font) +{ + mSelectedFont = font; +} + +/*! + Sets the \a color of the text that will be used if the text element is selected (\ref setSelected). + + \see setTextColor +*/ +void QCPTextElement::setSelectedTextColor(const QColor &color) +{ + mSelectedTextColor = color; +} + +/*! + Sets whether the user may select this text element. + + Note that even when \a selectable is set to false, the selection state may be changed + programmatically via \ref setSelected. +*/ +void QCPTextElement::setSelectable(bool selectable) +{ + if (mSelectable != selectable) + { + mSelectable = selectable; + emit selectableChanged(mSelectable); + } +} + +/*! + Sets the selection state of this text element to \a selected. If the selection has changed, \ref + selectionChanged is emitted. + + Note that this function can change the selection state independently of the current \ref + setSelectable state. +*/ +void QCPTextElement::setSelected(bool selected) +{ + if (mSelected != selected) + { + mSelected = selected; + emit selectionChanged(mSelected); + } +} + +/* inherits documentation from base class */ +void QCPTextElement::applyDefaultAntialiasingHint(QCPPainter *painter) const +{ + applyAntialiasingHint(painter, mAntialiased, QCP::aeOther); +} + +/* inherits documentation from base class */ +void QCPTextElement::draw(QCPPainter *painter) +{ + painter->setFont(mainFont()); + painter->setPen(QPen(mainTextColor())); + painter->drawText(mRect, Qt::AlignCenter, mText, &mTextBoundingRect); +} + +/* inherits documentation from base class */ +QSize QCPTextElement::minimumOuterSizeHint() const +{ + QFontMetrics metrics(mFont); + QSize result(metrics.boundingRect(0, 0, 0, 0, Qt::AlignCenter, mText).size()); + result.rwidth() += mMargins.left()+mMargins.right(); + result.rheight() += mMargins.top()+mMargins.bottom(); + return result; +} + +/* inherits documentation from base class */ +QSize QCPTextElement::maximumOuterSizeHint() const +{ + QFontMetrics metrics(mFont); + QSize result(metrics.boundingRect(0, 0, 0, 0, Qt::AlignCenter, mText).size()); + result.setWidth(QWIDGETSIZE_MAX); + result.rheight() += mMargins.top()+mMargins.bottom(); + return result; +} + +/* inherits documentation from base class */ +void QCPTextElement::selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) +{ + Q_UNUSED(event) + Q_UNUSED(details) + if (mSelectable) + { + bool selBefore = mSelected; + setSelected(additive ? !mSelected : true); + if (selectionStateChanged) + *selectionStateChanged = mSelected != selBefore; + } +} + +/* inherits documentation from base class */ +void QCPTextElement::deselectEvent(bool *selectionStateChanged) +{ + if (mSelectable) + { + bool selBefore = mSelected; + setSelected(false); + if (selectionStateChanged) + *selectionStateChanged = mSelected != selBefore; + } +} + +/*! + Returns 0.99*selectionTolerance (see \ref QCustomPlot::setSelectionTolerance) when \a pos is + within the bounding box of the text element's text. Note that this bounding box is updated in the + draw call. + + If \a pos is outside the text's bounding box or if \a onlySelectable is true and this text + element is not selectable (\ref setSelectable), returns -1. + + \seebaseclassmethod +*/ +double QCPTextElement::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + + if (mTextBoundingRect.contains(pos.toPoint())) + return mParentPlot->selectionTolerance()*0.99; + else + return -1; +} + +/*! + Accepts the mouse event in order to emit the according click signal in the \ref + mouseReleaseEvent. + + \seebaseclassmethod +*/ +void QCPTextElement::mousePressEvent(QMouseEvent *event, const QVariant &details) +{ + Q_UNUSED(details) + event->accept(); +} + +/*! + Emits the \ref clicked signal if the cursor hasn't moved by more than a few pixels since the \ref + mousePressEvent. + + \seebaseclassmethod +*/ +void QCPTextElement::mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) +{ + if ((QPointF(event->pos())-startPos).manhattanLength() <= 3) + emit clicked(event); +} + +/*! + Emits the \ref doubleClicked signal. + + \seebaseclassmethod +*/ +void QCPTextElement::mouseDoubleClickEvent(QMouseEvent *event, const QVariant &details) +{ + Q_UNUSED(details) + emit doubleClicked(event); +} + +/*! \internal + + Returns the main font to be used. This is mSelectedFont if \ref setSelected is set to + true, else mFont is returned. +*/ +QFont QCPTextElement::mainFont() const +{ + return mSelected ? mSelectedFont : mFont; +} + +/*! \internal + + Returns the main color to be used. This is mSelectedTextColor if \ref setSelected is set to + true, else mTextColor is returned. +*/ +QColor QCPTextElement::mainTextColor() const +{ + return mSelected ? mSelectedTextColor : mTextColor; +} +/* end of 'src/layoutelements/layoutelement-textelement.cpp' */ + + +/* including file 'src/layoutelements/layoutelement-colorscale.cpp', size 26246 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPColorScale +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPColorScale + \brief A color scale for use with color coding data such as QCPColorMap + + This layout element can be placed on the plot to correlate a color gradient with data values. It + is usually used in combination with one or multiple \ref QCPColorMap "QCPColorMaps". + + \image html QCPColorScale.png + + The color scale can be either horizontal or vertical, as shown in the image above. The + orientation and the side where the numbers appear is controlled with \ref setType. + + Use \ref QCPColorMap::setColorScale to connect a color map with a color scale. Once they are + connected, they share their gradient, data range and data scale type (\ref setGradient, \ref + setDataRange, \ref setDataScaleType). Multiple color maps may be associated with a single color + scale, to make them all synchronize these properties. + + To have finer control over the number display and axis behaviour, you can directly access the + \ref axis. See the documentation of QCPAxis for details about configuring axes. For example, if + you want to change the number of automatically generated ticks, call + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcolorscale-tickcount + + Placing a color scale next to the main axis rect works like with any other layout element: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcolorscale-creation + In this case we have placed it to the right of the default axis rect, so it wasn't necessary to + call \ref setType, since \ref QCPAxis::atRight is already the default. The text next to the color + scale can be set with \ref setLabel. + + For optimum appearance (like in the image above), it may be desirable to line up the axis rect and + the borders of the color scale. Use a \ref QCPMarginGroup to achieve this: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcolorscale-margingroup + + Color scales are initialized with a non-zero minimum top and bottom margin (\ref + setMinimumMargins), because vertical color scales are most common and the minimum top/bottom + margin makes sure it keeps some distance to the top/bottom widget border. So if you change to a + horizontal color scale by setting \ref setType to \ref QCPAxis::atBottom or \ref QCPAxis::atTop, you + might want to also change the minimum margins accordingly, e.g. setMinimumMargins(QMargins(6, 0, 6, 0)). +*/ + +/* start documentation of inline functions */ + +/*! \fn QCPAxis *QCPColorScale::axis() const + + Returns the internal \ref QCPAxis instance of this color scale. You can access it to alter the + appearance and behaviour of the axis. \ref QCPColorScale duplicates some properties in its + interface for convenience. Those are \ref setDataRange (\ref QCPAxis::setRange), \ref + setDataScaleType (\ref QCPAxis::setScaleType), and the method \ref setLabel (\ref + QCPAxis::setLabel). As they each are connected, it does not matter whether you use the method on + the QCPColorScale or on its QCPAxis. + + If the type of the color scale is changed with \ref setType, the axis returned by this method + will change, too, to either the left, right, bottom or top axis, depending on which type was set. +*/ + +/* end documentation of signals */ +/* start documentation of signals */ + +/*! \fn void QCPColorScale::dataRangeChanged(const QCPRange &newRange); + + This signal is emitted when the data range changes. + + \see setDataRange +*/ + +/*! \fn void QCPColorScale::dataScaleTypeChanged(QCPAxis::ScaleType scaleType); + + This signal is emitted when the data scale type changes. + + \see setDataScaleType +*/ + +/*! \fn void QCPColorScale::gradientChanged(const QCPColorGradient &newGradient); + + This signal is emitted when the gradient changes. + + \see setGradient +*/ + +/* end documentation of signals */ + +/*! + Constructs a new QCPColorScale. +*/ +QCPColorScale::QCPColorScale(QCustomPlot *parentPlot) : + QCPLayoutElement(parentPlot), + mType(QCPAxis::atTop), // set to atTop such that setType(QCPAxis::atRight) below doesn't skip work because it thinks it's already atRight + mDataScaleType(QCPAxis::stLinear), + mBarWidth(20), + mAxisRect(new QCPColorScaleAxisRectPrivate(this)) +{ + setMinimumMargins(QMargins(0, 6, 0, 6)); // for default right color scale types, keep some room at bottom and top (important if no margin group is used) + setType(QCPAxis::atRight); + setDataRange(QCPRange(0, 6)); +} + +QCPColorScale::~QCPColorScale() +{ + delete mAxisRect; +} + +/* undocumented getter */ +QString QCPColorScale::label() const +{ + if (!mColorAxis) + { + qDebug() << Q_FUNC_INFO << "internal color axis undefined"; + return QString(); + } + + return mColorAxis.data()->label(); +} + +/* undocumented getter */ +bool QCPColorScale::rangeDrag() const +{ + if (!mAxisRect) + { + qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; + return false; + } + + return mAxisRect.data()->rangeDrag().testFlag(QCPAxis::orientation(mType)) && + mAxisRect.data()->rangeDragAxis(QCPAxis::orientation(mType)) && + mAxisRect.data()->rangeDragAxis(QCPAxis::orientation(mType))->orientation() == QCPAxis::orientation(mType); +} + +/* undocumented getter */ +bool QCPColorScale::rangeZoom() const +{ + if (!mAxisRect) + { + qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; + return false; + } + + return mAxisRect.data()->rangeZoom().testFlag(QCPAxis::orientation(mType)) && + mAxisRect.data()->rangeZoomAxis(QCPAxis::orientation(mType)) && + mAxisRect.data()->rangeZoomAxis(QCPAxis::orientation(mType))->orientation() == QCPAxis::orientation(mType); +} + +/*! + Sets at which side of the color scale the axis is placed, and thus also its orientation. + + Note that after setting \a type to a different value, the axis returned by \ref axis() will + be a different one. The new axis will adopt the following properties from the previous axis: The + range, scale type, label and ticker (the latter will be shared and not copied). +*/ +void QCPColorScale::setType(QCPAxis::AxisType type) +{ + if (!mAxisRect) + { + qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; + return; + } + if (mType != type) + { + mType = type; + QCPRange rangeTransfer(0, 6); + QString labelTransfer; + QSharedPointer tickerTransfer; + // transfer/revert some settings on old axis if it exists: + bool doTransfer = (bool)mColorAxis; + if (doTransfer) + { + rangeTransfer = mColorAxis.data()->range(); + labelTransfer = mColorAxis.data()->label(); + tickerTransfer = mColorAxis.data()->ticker(); + mColorAxis.data()->setLabel(QString()); + disconnect(mColorAxis.data(), SIGNAL(rangeChanged(QCPRange)), this, SLOT(setDataRange(QCPRange))); + disconnect(mColorAxis.data(), SIGNAL(scaleTypeChanged(QCPAxis::ScaleType)), this, SLOT(setDataScaleType(QCPAxis::ScaleType))); + } + QList allAxisTypes = QList() << QCPAxis::atLeft << QCPAxis::atRight << QCPAxis::atBottom << QCPAxis::atTop; + foreach (QCPAxis::AxisType atype, allAxisTypes) + { + mAxisRect.data()->axis(atype)->setTicks(atype == mType); + mAxisRect.data()->axis(atype)->setTickLabels(atype== mType); + } + // set new mColorAxis pointer: + mColorAxis = mAxisRect.data()->axis(mType); + // transfer settings to new axis: + if (doTransfer) + { + mColorAxis.data()->setRange(rangeTransfer); // range transfer necessary if axis changes from vertical to horizontal or vice versa (axes with same orientation are synchronized via signals) + mColorAxis.data()->setLabel(labelTransfer); + mColorAxis.data()->setTicker(tickerTransfer); + } + connect(mColorAxis.data(), SIGNAL(rangeChanged(QCPRange)), this, SLOT(setDataRange(QCPRange))); + connect(mColorAxis.data(), SIGNAL(scaleTypeChanged(QCPAxis::ScaleType)), this, SLOT(setDataScaleType(QCPAxis::ScaleType))); + mAxisRect.data()->setRangeDragAxes(QList() << mColorAxis.data()); + } +} + +/*! + Sets the range spanned by the color gradient and that is shown by the axis in the color scale. + + It is equivalent to calling QCPColorMap::setDataRange on any of the connected color maps. It is + also equivalent to directly accessing the \ref axis and setting its range with \ref + QCPAxis::setRange. + + \see setDataScaleType, setGradient, rescaleDataRange +*/ +void QCPColorScale::setDataRange(const QCPRange &dataRange) +{ + if (mDataRange.lower != dataRange.lower || mDataRange.upper != dataRange.upper) + { + mDataRange = dataRange; + if (mColorAxis) + mColorAxis.data()->setRange(mDataRange); + emit dataRangeChanged(mDataRange); + } +} + +/*! + Sets the scale type of the color scale, i.e. whether values are associated with colors linearly + or logarithmically. + + It is equivalent to calling QCPColorMap::setDataScaleType on any of the connected color maps. It is + also equivalent to directly accessing the \ref axis and setting its scale type with \ref + QCPAxis::setScaleType. + + Note that this method controls the coordinate transformation. For logarithmic scales, you will + likely also want to use a logarithmic tick spacing and labeling, which can be achieved by setting + the color scale's \ref axis ticker to an instance of \ref QCPAxisTickerLog : + + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpaxisticker-log-colorscale + + See the documentation of \ref QCPAxisTickerLog about the details of logarithmic axis tick + creation. + + \see setDataRange, setGradient +*/ +void QCPColorScale::setDataScaleType(QCPAxis::ScaleType scaleType) +{ + if (mDataScaleType != scaleType) + { + mDataScaleType = scaleType; + if (mColorAxis) + mColorAxis.data()->setScaleType(mDataScaleType); + if (mDataScaleType == QCPAxis::stLogarithmic) + setDataRange(mDataRange.sanitizedForLogScale()); + emit dataScaleTypeChanged(mDataScaleType); + } +} + +/*! + Sets the color gradient that will be used to represent data values. + + It is equivalent to calling QCPColorMap::setGradient on any of the connected color maps. + + \see setDataRange, setDataScaleType +*/ +void QCPColorScale::setGradient(const QCPColorGradient &gradient) +{ + if (mGradient != gradient) + { + mGradient = gradient; + if (mAxisRect) + mAxisRect.data()->mGradientImageInvalidated = true; + emit gradientChanged(mGradient); + } +} + +/*! + Sets the axis label of the color scale. This is equivalent to calling \ref QCPAxis::setLabel on + the internal \ref axis. +*/ +void QCPColorScale::setLabel(const QString &str) +{ + if (!mColorAxis) + { + qDebug() << Q_FUNC_INFO << "internal color axis undefined"; + return; + } + + mColorAxis.data()->setLabel(str); +} + +/*! + Sets the width (or height, for horizontal color scales) the bar where the gradient is displayed + will have. +*/ +void QCPColorScale::setBarWidth(int width) +{ + mBarWidth = width; +} + +/*! + Sets whether the user can drag the data range (\ref setDataRange). + + Note that \ref QCP::iRangeDrag must be in the QCustomPlot's interactions (\ref + QCustomPlot::setInteractions) to allow range dragging. +*/ +void QCPColorScale::setRangeDrag(bool enabled) +{ + if (!mAxisRect) + { + qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; + return; + } + + if (enabled) + mAxisRect.data()->setRangeDrag(QCPAxis::orientation(mType)); + else + mAxisRect.data()->setRangeDrag(0); +} + +/*! + Sets whether the user can zoom the data range (\ref setDataRange) by scrolling the mouse wheel. + + Note that \ref QCP::iRangeZoom must be in the QCustomPlot's interactions (\ref + QCustomPlot::setInteractions) to allow range dragging. +*/ +void QCPColorScale::setRangeZoom(bool enabled) +{ + if (!mAxisRect) + { + qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; + return; + } + + if (enabled) + mAxisRect.data()->setRangeZoom(QCPAxis::orientation(mType)); + else + mAxisRect.data()->setRangeZoom(0); +} + +/*! + Returns a list of all the color maps associated with this color scale. +*/ +QList QCPColorScale::colorMaps() const +{ + QList result; + for (int i=0; iplottableCount(); ++i) + { + if (QCPColorMap *cm = qobject_cast(mParentPlot->plottable(i))) + if (cm->colorScale() == this) + result.append(cm); + } + return result; +} + +/*! + Changes the data range such that all color maps associated with this color scale are fully mapped + to the gradient in the data dimension. + + \see setDataRange +*/ +void QCPColorScale::rescaleDataRange(bool onlyVisibleMaps) +{ + QList maps = colorMaps(); + QCPRange newRange; + bool haveRange = false; + QCP::SignDomain sign = QCP::sdBoth; + if (mDataScaleType == QCPAxis::stLogarithmic) + sign = (mDataRange.upper < 0 ? QCP::sdNegative : QCP::sdPositive); + for (int i=0; irealVisibility() && onlyVisibleMaps) + continue; + QCPRange mapRange; + if (maps.at(i)->colorScale() == this) + { + bool currentFoundRange = true; + mapRange = maps.at(i)->data()->dataBounds(); + if (sign == QCP::sdPositive) + { + if (mapRange.lower <= 0 && mapRange.upper > 0) + mapRange.lower = mapRange.upper*1e-3; + else if (mapRange.lower <= 0 && mapRange.upper <= 0) + currentFoundRange = false; + } else if (sign == QCP::sdNegative) + { + if (mapRange.upper >= 0 && mapRange.lower < 0) + mapRange.upper = mapRange.lower*1e-3; + else if (mapRange.upper >= 0 && mapRange.lower >= 0) + currentFoundRange = false; + } + if (currentFoundRange) + { + if (!haveRange) + newRange = mapRange; + else + newRange.expand(mapRange); + haveRange = true; + } + } + } + if (haveRange) + { + if (!QCPRange::validRange(newRange)) // likely due to range being zero (plottable has only constant data in this dimension), shift current range to at least center the data + { + double center = (newRange.lower+newRange.upper)*0.5; // upper and lower should be equal anyway, but just to make sure, incase validRange returned false for other reason + if (mDataScaleType == QCPAxis::stLinear) + { + newRange.lower = center-mDataRange.size()/2.0; + newRange.upper = center+mDataRange.size()/2.0; + } else // mScaleType == stLogarithmic + { + newRange.lower = center/qSqrt(mDataRange.upper/mDataRange.lower); + newRange.upper = center*qSqrt(mDataRange.upper/mDataRange.lower); + } + } + setDataRange(newRange); + } +} + +/* inherits documentation from base class */ +void QCPColorScale::update(UpdatePhase phase) +{ + QCPLayoutElement::update(phase); + if (!mAxisRect) + { + qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; + return; + } + + mAxisRect.data()->update(phase); + + switch (phase) + { + case upMargins: + { + if (mType == QCPAxis::atBottom || mType == QCPAxis::atTop) + { + setMaximumSize(QWIDGETSIZE_MAX, mBarWidth+mAxisRect.data()->margins().top()+mAxisRect.data()->margins().bottom()); + setMinimumSize(0, mBarWidth+mAxisRect.data()->margins().top()+mAxisRect.data()->margins().bottom()); + } else + { + setMaximumSize(mBarWidth+mAxisRect.data()->margins().left()+mAxisRect.data()->margins().right(), QWIDGETSIZE_MAX); + setMinimumSize(mBarWidth+mAxisRect.data()->margins().left()+mAxisRect.data()->margins().right(), 0); + } + break; + } + case upLayout: + { + mAxisRect.data()->setOuterRect(rect()); + break; + } + default: break; + } +} + +/* inherits documentation from base class */ +void QCPColorScale::applyDefaultAntialiasingHint(QCPPainter *painter) const +{ + painter->setAntialiasing(false); +} + +/* inherits documentation from base class */ +void QCPColorScale::mousePressEvent(QMouseEvent *event, const QVariant &details) +{ + if (!mAxisRect) + { + qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; + return; + } + mAxisRect.data()->mousePressEvent(event, details); +} + +/* inherits documentation from base class */ +void QCPColorScale::mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) +{ + if (!mAxisRect) + { + qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; + return; + } + mAxisRect.data()->mouseMoveEvent(event, startPos); +} + +/* inherits documentation from base class */ +void QCPColorScale::mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) +{ + if (!mAxisRect) + { + qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; + return; + } + mAxisRect.data()->mouseReleaseEvent(event, startPos); +} + +/* inherits documentation from base class */ +void QCPColorScale::wheelEvent(QWheelEvent *event) +{ + if (!mAxisRect) + { + qDebug() << Q_FUNC_INFO << "internal axis rect was deleted"; + return; + } + mAxisRect.data()->wheelEvent(event); +} + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPColorScaleAxisRectPrivate +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPColorScaleAxisRectPrivate + + \internal + \brief An axis rect subclass for use in a QCPColorScale + + This is a private class and not part of the public QCustomPlot interface. + + It provides the axis rect functionality for the QCPColorScale class. +*/ + + +/*! + Creates a new instance, as a child of \a parentColorScale. +*/ +QCPColorScaleAxisRectPrivate::QCPColorScaleAxisRectPrivate(QCPColorScale *parentColorScale) : + QCPAxisRect(parentColorScale->parentPlot(), true), + mParentColorScale(parentColorScale), + mGradientImageInvalidated(true) +{ + setParentLayerable(parentColorScale); + setMinimumMargins(QMargins(0, 0, 0, 0)); + QList allAxisTypes = QList() << QCPAxis::atBottom << QCPAxis::atTop << QCPAxis::atLeft << QCPAxis::atRight; + foreach (QCPAxis::AxisType type, allAxisTypes) + { + axis(type)->setVisible(true); + axis(type)->grid()->setVisible(false); + axis(type)->setPadding(0); + connect(axis(type), SIGNAL(selectionChanged(QCPAxis::SelectableParts)), this, SLOT(axisSelectionChanged(QCPAxis::SelectableParts))); + connect(axis(type), SIGNAL(selectableChanged(QCPAxis::SelectableParts)), this, SLOT(axisSelectableChanged(QCPAxis::SelectableParts))); + } + + connect(axis(QCPAxis::atLeft), SIGNAL(rangeChanged(QCPRange)), axis(QCPAxis::atRight), SLOT(setRange(QCPRange))); + connect(axis(QCPAxis::atRight), SIGNAL(rangeChanged(QCPRange)), axis(QCPAxis::atLeft), SLOT(setRange(QCPRange))); + connect(axis(QCPAxis::atBottom), SIGNAL(rangeChanged(QCPRange)), axis(QCPAxis::atTop), SLOT(setRange(QCPRange))); + connect(axis(QCPAxis::atTop), SIGNAL(rangeChanged(QCPRange)), axis(QCPAxis::atBottom), SLOT(setRange(QCPRange))); + connect(axis(QCPAxis::atLeft), SIGNAL(scaleTypeChanged(QCPAxis::ScaleType)), axis(QCPAxis::atRight), SLOT(setScaleType(QCPAxis::ScaleType))); + connect(axis(QCPAxis::atRight), SIGNAL(scaleTypeChanged(QCPAxis::ScaleType)), axis(QCPAxis::atLeft), SLOT(setScaleType(QCPAxis::ScaleType))); + connect(axis(QCPAxis::atBottom), SIGNAL(scaleTypeChanged(QCPAxis::ScaleType)), axis(QCPAxis::atTop), SLOT(setScaleType(QCPAxis::ScaleType))); + connect(axis(QCPAxis::atTop), SIGNAL(scaleTypeChanged(QCPAxis::ScaleType)), axis(QCPAxis::atBottom), SLOT(setScaleType(QCPAxis::ScaleType))); + + // make layer transfers of color scale transfer to axis rect and axes + // the axes must be set after axis rect, such that they appear above color gradient drawn by axis rect: + connect(parentColorScale, SIGNAL(layerChanged(QCPLayer*)), this, SLOT(setLayer(QCPLayer*))); + foreach (QCPAxis::AxisType type, allAxisTypes) + connect(parentColorScale, SIGNAL(layerChanged(QCPLayer*)), axis(type), SLOT(setLayer(QCPLayer*))); +} + +/*! \internal + + Updates the color gradient image if necessary, by calling \ref updateGradientImage, then draws + it. Then the axes are drawn by calling the \ref QCPAxisRect::draw base class implementation. + + \seebaseclassmethod +*/ +void QCPColorScaleAxisRectPrivate::draw(QCPPainter *painter) +{ + if (mGradientImageInvalidated) + updateGradientImage(); + + bool mirrorHorz = false; + bool mirrorVert = false; + if (mParentColorScale->mColorAxis) + { + mirrorHorz = mParentColorScale->mColorAxis.data()->rangeReversed() && (mParentColorScale->type() == QCPAxis::atBottom || mParentColorScale->type() == QCPAxis::atTop); + mirrorVert = mParentColorScale->mColorAxis.data()->rangeReversed() && (mParentColorScale->type() == QCPAxis::atLeft || mParentColorScale->type() == QCPAxis::atRight); + } + + painter->drawImage(rect().adjusted(0, -1, 0, -1), mGradientImage.mirrored(mirrorHorz, mirrorVert)); + QCPAxisRect::draw(painter); +} + +/*! \internal + + Uses the current gradient of the parent \ref QCPColorScale (specified in the constructor) to + generate a gradient image. This gradient image will be used in the \ref draw method. +*/ +void QCPColorScaleAxisRectPrivate::updateGradientImage() +{ + if (rect().isEmpty()) + return; + + const QImage::Format format = QImage::Format_ARGB32_Premultiplied; + int n = mParentColorScale->mGradient.levelCount(); + int w, h; + QVector data(n); + for (int i=0; imType == QCPAxis::atBottom || mParentColorScale->mType == QCPAxis::atTop) + { + w = n; + h = rect().height(); + mGradientImage = QImage(w, h, format); + QVector pixels; + for (int y=0; y(mGradientImage.scanLine(y))); + mParentColorScale->mGradient.colorize(data.constData(), QCPRange(0, n-1), pixels.first(), n); + for (int y=1; y(mGradientImage.scanLine(y)); + const QRgb lineColor = mParentColorScale->mGradient.color(data[h-1-y], QCPRange(0, n-1)); + for (int x=0; x allAxisTypes = QList() << QCPAxis::atBottom << QCPAxis::atTop << QCPAxis::atLeft << QCPAxis::atRight; + foreach (QCPAxis::AxisType type, allAxisTypes) + { + if (QCPAxis *senderAxis = qobject_cast(sender())) + if (senderAxis->axisType() == type) + continue; + + if (axis(type)->selectableParts().testFlag(QCPAxis::spAxis)) + { + if (selectedParts.testFlag(QCPAxis::spAxis)) + axis(type)->setSelectedParts(axis(type)->selectedParts() | QCPAxis::spAxis); + else + axis(type)->setSelectedParts(axis(type)->selectedParts() & ~QCPAxis::spAxis); + } + } +} + +/*! \internal + + This slot is connected to the selectableChanged signals of the four axes in the constructor. It + synchronizes the selectability of the axes. +*/ +void QCPColorScaleAxisRectPrivate::axisSelectableChanged(QCPAxis::SelectableParts selectableParts) +{ + // synchronize axis base selectability: + QList allAxisTypes = QList() << QCPAxis::atBottom << QCPAxis::atTop << QCPAxis::atLeft << QCPAxis::atRight; + foreach (QCPAxis::AxisType type, allAxisTypes) + { + if (QCPAxis *senderAxis = qobject_cast(sender())) + if (senderAxis->axisType() == type) + continue; + + if (axis(type)->selectableParts().testFlag(QCPAxis::spAxis)) + { + if (selectableParts.testFlag(QCPAxis::spAxis)) + axis(type)->setSelectableParts(axis(type)->selectableParts() | QCPAxis::spAxis); + else + axis(type)->setSelectableParts(axis(type)->selectableParts() & ~QCPAxis::spAxis); + } + } +} +/* end of 'src/layoutelements/layoutelement-colorscale.cpp' */ + + +/* including file 'src/plottables/plottable-graph.cpp', size 74194 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPGraphData +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPGraphData + \brief Holds the data of one single data point for QCPGraph. + + The stored data is: + \li \a key: coordinate on the key axis of this data point (this is the \a mainKey and the \a sortKey) + \li \a value: coordinate on the value axis of this data point (this is the \a mainValue) + + The container for storing multiple data points is \ref QCPGraphDataContainer. It is a typedef for + \ref QCPDataContainer with \ref QCPGraphData as the DataType template parameter. See the + documentation there for an explanation regarding the data type's generic methods. + + \see QCPGraphDataContainer +*/ + +/* start documentation of inline functions */ + +/*! \fn double QCPGraphData::sortKey() const + + Returns the \a key member of this data point. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn static QCPGraphData QCPGraphData::fromSortKey(double sortKey) + + Returns a data point with the specified \a sortKey. All other members are set to zero. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn static static bool QCPGraphData::sortKeyIsMainKey() + + Since the member \a key is both the data point key coordinate and the data ordering parameter, + this method returns true. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn double QCPGraphData::mainKey() const + + Returns the \a key member of this data point. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn double QCPGraphData::mainValue() const + + Returns the \a value member of this data point. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn QCPRange QCPGraphData::valueRange() const + + Returns a QCPRange with both lower and upper boundary set to \a value of this data point. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/* end documentation of inline functions */ + +/*! + Constructs a data point with key and value set to zero. +*/ +QCPGraphData::QCPGraphData() : + key(0), + value(0) +{ +} + +/*! + Constructs a data point with the specified \a key and \a value. +*/ +QCPGraphData::QCPGraphData(double key, double value) : + key(key), + value(value) +{ +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPGraph +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPGraph + \brief A plottable representing a graph in a plot. + + \image html QCPGraph.png + + Usually you create new graphs by calling QCustomPlot::addGraph. The resulting instance can be + accessed via QCustomPlot::graph. + + To plot data, assign it with the \ref setData or \ref addData functions. Alternatively, you can + also access and modify the data via the \ref data method, which returns a pointer to the internal + \ref QCPGraphDataContainer. + + Graphs are used to display single-valued data. Single-valued means that there should only be one + data point per unique key coordinate. In other words, the graph can't have \a loops. If you do + want to plot non-single-valued curves, rather use the QCPCurve plottable. + + Gaps in the graph line can be created by adding data points with NaN as value + (qQNaN() or std::numeric_limits::quiet_NaN()) in between the two data points that shall be + separated. + + \section qcpgraph-appearance Changing the appearance + + The appearance of the graph is mainly determined by the line style, scatter style, brush and pen + of the graph (\ref setLineStyle, \ref setScatterStyle, \ref setBrush, \ref setPen). + + \subsection filling Filling under or between graphs + + QCPGraph knows two types of fills: Normal graph fills towards the zero-value-line parallel to + the key axis of the graph, and fills between two graphs, called channel fills. To enable a fill, + just set a brush with \ref setBrush which is neither Qt::NoBrush nor fully transparent. + + By default, a normal fill towards the zero-value-line will be drawn. To set up a channel fill + between this graph and another one, call \ref setChannelFillGraph with the other graph as + parameter. + + \see QCustomPlot::addGraph, QCustomPlot::graph +*/ + +/* start of documentation of inline functions */ + +/*! \fn QSharedPointer QCPGraph::data() const + + Returns a shared pointer to the internal data storage of type \ref QCPGraphDataContainer. You may + use it to directly manipulate the data, which may be more convenient and faster than using the + regular \ref setData or \ref addData methods. +*/ + +/* end of documentation of inline functions */ + +/*! + Constructs a graph which uses \a keyAxis as its key axis ("x") and \a valueAxis as its value + axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance and not have + the same orientation. If either of these restrictions is violated, a corresponding message is + printed to the debug output (qDebug), the construction is not aborted, though. + + The created QCPGraph is automatically registered with the QCustomPlot instance inferred from \a + keyAxis. This QCustomPlot instance takes ownership of the QCPGraph, so do not delete it manually + but use QCustomPlot::removePlottable() instead. + + To directly create a graph inside a plot, you can also use the simpler QCustomPlot::addGraph function. +*/ +QCPGraph::QCPGraph(QCPAxis *keyAxis, QCPAxis *valueAxis) : + QCPAbstractPlottable1D(keyAxis, valueAxis) +{ + // special handling for QCPGraphs to maintain the simple graph interface: + mParentPlot->registerGraph(this); + + setPen(QPen(Qt::blue, 0)); + setBrush(Qt::NoBrush); + + setLineStyle(lsLine); + setScatterSkip(0); + setChannelFillGraph(0); + setAdaptiveSampling(true); +} + +QCPGraph::~QCPGraph() +{ +} + +/*! \overload + + Replaces the current data container with the provided \a data container. + + Since a QSharedPointer is used, multiple QCPGraphs may share the same data container safely. + Modifying the data in the container will then affect all graphs that share the container. Sharing + can be achieved by simply exchanging the data containers wrapped in shared pointers: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpgraph-datasharing-1 + + If you do not wish to share containers, but create a copy from an existing container, rather use + the \ref QCPDataContainer::set method on the graph's data container directly: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpgraph-datasharing-2 + + \see addData +*/ +void QCPGraph::setData(QSharedPointer data) +{ + mDataContainer = data; +} + +/*! \overload + + Replaces the current data with the provided points in \a keys and \a values. The provided + vectors should have equal length. Else, the number of added points will be the size of the + smallest vector. + + If you can guarantee that the passed data points are sorted by \a keys in ascending order, you + can set \a alreadySorted to true, to improve performance by saving a sorting run. + + \see addData +*/ +void QCPGraph::setData(const QVector &keys, const QVector &values, bool alreadySorted) +{ + mDataContainer->clear(); + addData(keys, values, alreadySorted); +} + +/*! + Sets how the single data points are connected in the plot. For scatter-only plots, set \a ls to + \ref lsNone and \ref setScatterStyle to the desired scatter style. + + \see setScatterStyle +*/ +void QCPGraph::setLineStyle(LineStyle ls) +{ + mLineStyle = ls; +} + +/*! + Sets the visual appearance of single data points in the plot. If set to \ref QCPScatterStyle::ssNone, no scatter points + are drawn (e.g. for line-only-plots with appropriate line style). + + \see QCPScatterStyle, setLineStyle +*/ +void QCPGraph::setScatterStyle(const QCPScatterStyle &style) +{ + mScatterStyle = style; +} + +/*! + If scatters are displayed (scatter style not \ref QCPScatterStyle::ssNone), \a skip number of + scatter points are skipped/not drawn after every drawn scatter point. + + This can be used to make the data appear sparser while for example still having a smooth line, + and to improve performance for very high density plots. + + If \a skip is set to 0 (default), all scatter points are drawn. + + \see setScatterStyle +*/ +void QCPGraph::setScatterSkip(int skip) +{ + mScatterSkip = qMax(0, skip); +} + +/*! + Sets the target graph for filling the area between this graph and \a targetGraph with the current + brush (\ref setBrush). + + When \a targetGraph is set to 0, a normal graph fill to the zero-value-line will be shown. To + disable any filling, set the brush to Qt::NoBrush. + + \see setBrush +*/ +void QCPGraph::setChannelFillGraph(QCPGraph *targetGraph) +{ + // prevent setting channel target to this graph itself: + if (targetGraph == this) + { + qDebug() << Q_FUNC_INFO << "targetGraph is this graph itself"; + mChannelFillGraph = 0; + return; + } + // prevent setting channel target to a graph not in the plot: + if (targetGraph && targetGraph->mParentPlot != mParentPlot) + { + qDebug() << Q_FUNC_INFO << "targetGraph not in same plot"; + mChannelFillGraph = 0; + return; + } + + mChannelFillGraph = targetGraph; +} + +/*! + Sets whether adaptive sampling shall be used when plotting this graph. QCustomPlot's adaptive + sampling technique can drastically improve the replot performance for graphs with a larger number + of points (e.g. above 10,000), without notably changing the appearance of the graph. + + By default, adaptive sampling is enabled. Even if enabled, QCustomPlot decides whether adaptive + sampling shall actually be used on a per-graph basis. So leaving adaptive sampling enabled has no + disadvantage in almost all cases. + + \image html adaptive-sampling-line.png "A line plot of 500,000 points without and with adaptive sampling" + + As can be seen, line plots experience no visual degradation from adaptive sampling. Outliers are + reproduced reliably, as well as the overall shape of the data set. The replot time reduces + dramatically though. This allows QCustomPlot to display large amounts of data in realtime. + + \image html adaptive-sampling-scatter.png "A scatter plot of 100,000 points without and with adaptive sampling" + + Care must be taken when using high-density scatter plots in combination with adaptive sampling. + The adaptive sampling algorithm treats scatter plots more carefully than line plots which still + gives a significant reduction of replot times, but not quite as much as for line plots. This is + because scatter plots inherently need more data points to be preserved in order to still resemble + the original, non-adaptive-sampling plot. As shown above, the results still aren't quite + identical, as banding occurs for the outer data points. This is in fact intentional, such that + the boundaries of the data cloud stay visible to the viewer. How strong the banding appears, + depends on the point density, i.e. the number of points in the plot. + + For some situations with scatter plots it might thus be desirable to manually turn adaptive + sampling off. For example, when saving the plot to disk. This can be achieved by setting \a + enabled to false before issuing a command like \ref QCustomPlot::savePng, and setting \a enabled + back to true afterwards. +*/ +void QCPGraph::setAdaptiveSampling(bool enabled) +{ + mAdaptiveSampling = enabled; +} + +/*! \overload + + Adds the provided points in \a keys and \a values to the current data. The provided vectors + should have equal length. Else, the number of added points will be the size of the smallest + vector. + + If you can guarantee that the passed data points are sorted by \a keys in ascending order, you + can set \a alreadySorted to true, to improve performance by saving a sorting run. + + Alternatively, you can also access and modify the data directly via the \ref data method, which + returns a pointer to the internal data container. +*/ +void QCPGraph::addData(const QVector &keys, const QVector &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 tempData(n); + QVector::iterator it = tempData.begin(); + const QVector::iterator itEnd = tempData.end(); + int i = 0; + while (it != itEnd) + { + it->key = keys[i]; + it->value = values[i]; + ++it; + ++i; + } + mDataContainer->add(tempData, alreadySorted); // don't modify tempData beyond this to prevent copy on write +} + +/*! \overload + + Adds the provided data point as \a key and \a value to the current data. + + Alternatively, you can also access and modify the data directly via the \ref data method, which + returns a pointer to the internal data container. +*/ +void QCPGraph::addData(double key, double value) +{ + mDataContainer->add(QCPGraphData(key, value)); +} + +/*! + Implements a selectTest specific to this plottable's point geometry. + + If \a details is not 0, it will be set to a \ref QCPDataSelection, describing the closest data + point to \a pos. + + \seebaseclassmethod \ref QCPAbstractPlottable::selectTest +*/ +double QCPGraph::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) + return -1; + if (!mKeyAxis || !mValueAxis) + return -1; + + if (mKeyAxis.data()->axisRect()->rect().contains(pos.toPoint())) + { + QCPGraphDataContainer::const_iterator closestDataPoint = mDataContainer->constEnd(); + double result = pointDistance(pos, closestDataPoint); + if (details) + { + int pointIndex = closestDataPoint-mDataContainer->constBegin(); + details->setValue(QCPDataSelection(QCPDataRange(pointIndex, pointIndex+1))); + } + return result; + } else + return -1; +} + +/* inherits documentation from base class */ +QCPRange QCPGraph::getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain) const +{ + return mDataContainer->keyRange(foundRange, inSignDomain); +} + +/* inherits documentation from base class */ +QCPRange QCPGraph::getValueRange(bool &foundRange, QCP::SignDomain inSignDomain, const QCPRange &inKeyRange) const +{ + return mDataContainer->valueRange(foundRange, inSignDomain, inKeyRange); +} + +/* inherits documentation from base class */ +void QCPGraph::draw(QCPPainter *painter) +{ + if (!mKeyAxis || !mValueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + if (mKeyAxis.data()->range().size() <= 0 || mDataContainer->isEmpty()) return; + if (mLineStyle == lsNone && mScatterStyle.isNone()) return; + + QVector lines, scatters; // line and (if necessary) scatter pixel coordinates will be stored here while iterating over segments + + // loop over and draw segments of unselected/selected data: + QList selectedSegments, unselectedSegments, allSegments; + getDataSegments(selectedSegments, unselectedSegments); + allSegments << unselectedSegments << selectedSegments; + for (int i=0; i= unselectedSegments.size(); + // get line pixel points appropriate to line style: + QCPDataRange lineDataRange = isSelectedSegment ? allSegments.at(i) : allSegments.at(i).adjusted(-1, 1); // unselected segments extend lines to bordering selected data point (safe to exceed total data bounds in first/last segment, getLines takes care) + getLines(&lines, lineDataRange); + + // check data validity if flag set: +#ifdef QCUSTOMPLOT_CHECK_DATA + QCPGraphDataContainer::const_iterator it; + for (it = mDataContainer->constBegin(); it != mDataContainer->constEnd(); ++it) + { + if (QCP::isInvalidData(it->key, it->value)) + qDebug() << Q_FUNC_INFO << "Data point at" << it->key << "invalid." << "Plottable name:" << name(); + } +#endif + + // draw fill of graph: + if (isSelectedSegment && mSelectionDecorator) + mSelectionDecorator->applyBrush(painter); + else + painter->setBrush(mBrush); + painter->setPen(Qt::NoPen); + drawFill(painter, &lines); + + // draw line: + if (mLineStyle != lsNone) + { + if (isSelectedSegment && mSelectionDecorator) + mSelectionDecorator->applyPen(painter); + else + painter->setPen(mPen); + painter->setBrush(Qt::NoBrush); + if (mLineStyle == lsImpulse) + drawImpulsePlot(painter, lines); + else + drawLinePlot(painter, lines); // also step plots can be drawn as a line plot + } + + // draw scatters: + QCPScatterStyle finalScatterStyle = mScatterStyle; + if (isSelectedSegment && mSelectionDecorator) + finalScatterStyle = mSelectionDecorator->getFinalScatterStyle(mScatterStyle); + if (!finalScatterStyle.isNone()) + { + getScatters(&scatters, allSegments.at(i)); + drawScatterPlot(painter, scatters, finalScatterStyle); + } + } + + // draw other selection decoration that isn't just line/scatter pens and brushes: + if (mSelectionDecorator) + mSelectionDecorator->drawDecoration(painter, selection()); +} + +/* inherits documentation from base class */ +void QCPGraph::drawLegendIcon(QCPPainter *painter, const QRectF &rect) const +{ + // draw fill: + if (mBrush.style() != Qt::NoBrush) + { + applyFillAntialiasingHint(painter); + painter->fillRect(QRectF(rect.left(), rect.top()+rect.height()/2.0, rect.width(), rect.height()/3.0), mBrush); + } + // draw line vertically centered: + if (mLineStyle != lsNone) + { + applyDefaultAntialiasingHint(painter); + painter->setPen(mPen); + painter->drawLine(QLineF(rect.left(), rect.top()+rect.height()/2.0, rect.right()+5, rect.top()+rect.height()/2.0)); // +5 on x2 else last segment is missing from dashed/dotted pens + } + // draw scatter symbol: + if (!mScatterStyle.isNone()) + { + applyScattersAntialiasingHint(painter); + // scale scatter pixmap if it's too large to fit in legend icon rect: + if (mScatterStyle.shape() == QCPScatterStyle::ssPixmap && (mScatterStyle.pixmap().size().width() > rect.width() || mScatterStyle.pixmap().size().height() > rect.height())) + { + QCPScatterStyle scaledStyle(mScatterStyle); + scaledStyle.setPixmap(scaledStyle.pixmap().scaled(rect.size().toSize(), Qt::KeepAspectRatio, Qt::SmoothTransformation)); + scaledStyle.applyTo(painter, mPen); + scaledStyle.drawShape(painter, QRectF(rect).center()); + } else + { + mScatterStyle.applyTo(painter, mPen); + mScatterStyle.drawShape(painter, QRectF(rect).center()); + } + } +} + +/*! \internal + + This method retrieves an optimized set of data points via \ref getOptimizedLineData, an branches + out to the line style specific functions such as \ref dataToLines, \ref dataToStepLeftLines, etc. + according to the line style of the graph. + + \a lines will be filled with points in pixel coordinates, that can be drawn with the according + draw functions like \ref drawLinePlot and \ref drawImpulsePlot. The points returned in \a lines + aren't necessarily the original data points. For example, step line styles require additional + points to form the steps when drawn. If the line style of the graph is \ref lsNone, the \a + lines vector will be empty. + + \a dataRange specifies the beginning and ending data indices that will be taken into account for + conversion. In this function, the specified range may exceed the total data bounds without harm: + a correspondingly trimmed data range will be used. This takes the burden off the user of this + function to check for valid indices in \a dataRange, e.g. when extending ranges coming from \ref + getDataSegments. + + \see getScatters +*/ +void QCPGraph::getLines(QVector *lines, const QCPDataRange &dataRange) const +{ + if (!lines) return; + QCPGraphDataContainer::const_iterator begin, end; + getVisibleDataBounds(begin, end, dataRange); + if (begin == end) + { + lines->clear(); + return; + } + + QVector lineData; + if (mLineStyle != lsNone) + getOptimizedLineData(&lineData, begin, end); + + if (mKeyAxis->rangeReversed() != (mKeyAxis->orientation() == Qt::Vertical)) // make sure key pixels are sorted ascending in lineData (significantly simplifies following processing) + std::reverse(lineData.begin(), lineData.end()); + + switch (mLineStyle) + { + case lsNone: lines->clear(); break; + case lsLine: *lines = dataToLines(lineData); break; + case lsStepLeft: *lines = dataToStepLeftLines(lineData); break; + case lsStepRight: *lines = dataToStepRightLines(lineData); break; + case lsStepCenter: *lines = dataToStepCenterLines(lineData); break; + case lsImpulse: *lines = dataToImpulseLines(lineData); break; + } +} + +/*! \internal + + This method retrieves an optimized set of data points via \ref getOptimizedScatterData and then + converts them to pixel coordinates. The resulting points are returned in \a scatters, and can be + passed to \ref drawScatterPlot. + + \a dataRange specifies the beginning and ending data indices that will be taken into account for + conversion. In this function, the specified range may exceed the total data bounds without harm: + a correspondingly trimmed data range will be used. This takes the burden off the user of this + function to check for valid indices in \a dataRange, e.g. when extending ranges coming from \ref + getDataSegments. +*/ +void QCPGraph::getScatters(QVector *scatters, const QCPDataRange &dataRange) const +{ + if (!scatters) return; + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; scatters->clear(); return; } + + QCPGraphDataContainer::const_iterator begin, end; + getVisibleDataBounds(begin, end, dataRange); + if (begin == end) + { + scatters->clear(); + return; + } + + QVector data; + getOptimizedScatterData(&data, begin, end); + + if (mKeyAxis->rangeReversed() != (mKeyAxis->orientation() == Qt::Vertical)) // make sure key pixels are sorted ascending in data (significantly simplifies following processing) + std::reverse(data.begin(), data.end()); + + scatters->resize(data.size()); + if (keyAxis->orientation() == Qt::Vertical) + { + for (int i=0; icoordToPixel(data.at(i).value)); + (*scatters)[i].setY(keyAxis->coordToPixel(data.at(i).key)); + } + } + } else + { + for (int i=0; icoordToPixel(data.at(i).key)); + (*scatters)[i].setY(valueAxis->coordToPixel(data.at(i).value)); + } + } + } +} + +/*! \internal + + Takes raw data points in plot coordinates as \a data, and returns a vector containing pixel + coordinate points which are suitable for drawing the line style \ref lsLine. + + The source of \a data is usually \ref getOptimizedLineData, and this method is called in \a + getLines if the line style is set accordingly. + + \see dataToStepLeftLines, dataToStepRightLines, dataToStepCenterLines, dataToImpulseLines, getLines, drawLinePlot +*/ +QVector QCPGraph::dataToLines(const QVector &data) const +{ + QVector result; + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return result; } + + result.resize(data.size()); + + // transform data points to pixels: + if (keyAxis->orientation() == Qt::Vertical) + { + for (int i=0; icoordToPixel(data.at(i).value)); + result[i].setY(keyAxis->coordToPixel(data.at(i).key)); + } + } else // key axis is horizontal + { + for (int i=0; icoordToPixel(data.at(i).key)); + result[i].setY(valueAxis->coordToPixel(data.at(i).value)); + } + } + return result; +} + +/*! \internal + + Takes raw data points in plot coordinates as \a data, and returns a vector containing pixel + coordinate points which are suitable for drawing the line style \ref lsStepLeft. + + The source of \a data is usually \ref getOptimizedLineData, and this method is called in \a + getLines if the line style is set accordingly. + + \see dataToLines, dataToStepRightLines, dataToStepCenterLines, dataToImpulseLines, getLines, drawLinePlot +*/ +QVector QCPGraph::dataToStepLeftLines(const QVector &data) const +{ + QVector result; + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return result; } + + result.resize(data.size()*2); + + // calculate steps from data and transform to pixel coordinates: + if (keyAxis->orientation() == Qt::Vertical) + { + double lastValue = valueAxis->coordToPixel(data.first().value); + for (int i=0; icoordToPixel(data.at(i).key); + result[i*2+0].setX(lastValue); + result[i*2+0].setY(key); + lastValue = valueAxis->coordToPixel(data.at(i).value); + result[i*2+1].setX(lastValue); + result[i*2+1].setY(key); + } + } else // key axis is horizontal + { + double lastValue = valueAxis->coordToPixel(data.first().value); + for (int i=0; icoordToPixel(data.at(i).key); + result[i*2+0].setX(key); + result[i*2+0].setY(lastValue); + lastValue = valueAxis->coordToPixel(data.at(i).value); + result[i*2+1].setX(key); + result[i*2+1].setY(lastValue); + } + } + return result; +} + +/*! \internal + + Takes raw data points in plot coordinates as \a data, and returns a vector containing pixel + coordinate points which are suitable for drawing the line style \ref lsStepRight. + + The source of \a data is usually \ref getOptimizedLineData, and this method is called in \a + getLines if the line style is set accordingly. + + \see dataToLines, dataToStepLeftLines, dataToStepCenterLines, dataToImpulseLines, getLines, drawLinePlot +*/ +QVector QCPGraph::dataToStepRightLines(const QVector &data) const +{ + QVector result; + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return result; } + + result.resize(data.size()*2); + + // calculate steps from data and transform to pixel coordinates: + if (keyAxis->orientation() == Qt::Vertical) + { + double lastKey = keyAxis->coordToPixel(data.first().key); + for (int i=0; icoordToPixel(data.at(i).value); + result[i*2+0].setX(value); + result[i*2+0].setY(lastKey); + lastKey = keyAxis->coordToPixel(data.at(i).key); + result[i*2+1].setX(value); + result[i*2+1].setY(lastKey); + } + } else // key axis is horizontal + { + double lastKey = keyAxis->coordToPixel(data.first().key); + for (int i=0; icoordToPixel(data.at(i).value); + result[i*2+0].setX(lastKey); + result[i*2+0].setY(value); + lastKey = keyAxis->coordToPixel(data.at(i).key); + result[i*2+1].setX(lastKey); + result[i*2+1].setY(value); + } + } + return result; +} + +/*! \internal + + Takes raw data points in plot coordinates as \a data, and returns a vector containing pixel + coordinate points which are suitable for drawing the line style \ref lsStepCenter. + + The source of \a data is usually \ref getOptimizedLineData, and this method is called in \a + getLines if the line style is set accordingly. + + \see dataToLines, dataToStepLeftLines, dataToStepRightLines, dataToImpulseLines, getLines, drawLinePlot +*/ +QVector QCPGraph::dataToStepCenterLines(const QVector &data) const +{ + QVector result; + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return result; } + + result.resize(data.size()*2); + + // calculate steps from data and transform to pixel coordinates: + if (keyAxis->orientation() == Qt::Vertical) + { + double lastKey = keyAxis->coordToPixel(data.first().key); + double lastValue = valueAxis->coordToPixel(data.first().value); + result[0].setX(lastValue); + result[0].setY(lastKey); + for (int i=1; icoordToPixel(data.at(i).key)+lastKey)*0.5; + result[i*2-1].setX(lastValue); + result[i*2-1].setY(key); + lastValue = valueAxis->coordToPixel(data.at(i).value); + lastKey = keyAxis->coordToPixel(data.at(i).key); + result[i*2+0].setX(lastValue); + result[i*2+0].setY(key); + } + result[data.size()*2-1].setX(lastValue); + result[data.size()*2-1].setY(lastKey); + } else // key axis is horizontal + { + double lastKey = keyAxis->coordToPixel(data.first().key); + double lastValue = valueAxis->coordToPixel(data.first().value); + result[0].setX(lastKey); + result[0].setY(lastValue); + for (int i=1; icoordToPixel(data.at(i).key)+lastKey)*0.5; + result[i*2-1].setX(key); + result[i*2-1].setY(lastValue); + lastValue = valueAxis->coordToPixel(data.at(i).value); + lastKey = keyAxis->coordToPixel(data.at(i).key); + result[i*2+0].setX(key); + result[i*2+0].setY(lastValue); + } + result[data.size()*2-1].setX(lastKey); + result[data.size()*2-1].setY(lastValue); + } + return result; +} + +/*! \internal + + Takes raw data points in plot coordinates as \a data, and returns a vector containing pixel + coordinate points which are suitable for drawing the line style \ref lsImpulse. + + The source of \a data is usually \ref getOptimizedLineData, and this method is called in \a + getLines if the line style is set accordingly. + + \see dataToLines, dataToStepLeftLines, dataToStepRightLines, dataToStepCenterLines, getLines, drawImpulsePlot +*/ +QVector QCPGraph::dataToImpulseLines(const QVector &data) const +{ + QVector result; + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return result; } + + result.resize(data.size()*2); + + // transform data points to pixels: + if (keyAxis->orientation() == Qt::Vertical) + { + for (int i=0; icoordToPixel(data.at(i).key); + result[i*2+0].setX(valueAxis->coordToPixel(0)); + result[i*2+0].setY(key); + result[i*2+1].setX(valueAxis->coordToPixel(data.at(i).value)); + result[i*2+1].setY(key); + } + } else // key axis is horizontal + { + for (int i=0; icoordToPixel(data.at(i).key); + result[i*2+0].setX(key); + result[i*2+0].setY(valueAxis->coordToPixel(0)); + result[i*2+1].setX(key); + result[i*2+1].setY(valueAxis->coordToPixel(data.at(i).value)); + } + } + return result; +} + +/*! \internal + + Draws the fill of the graph using the specified \a painter, with the currently set brush. + + Depending on whether a normal fill or a channel fill (\ref setChannelFillGraph) is needed, \ref + getFillPolygon or \ref getChannelFillPolygon are used to find the according fill polygons. + + In order to handle NaN Data points correctly (the fill needs to be split into disjoint areas), + this method first determines a list of non-NaN segments with \ref getNonNanSegments, on which to + operate. In the channel fill case, \ref getOverlappingSegments is used to consolidate the non-NaN + segments of the two involved graphs, before passing the overlapping pairs to \ref + getChannelFillPolygon. + + Pass the points of this graph's line as \a lines, in pixel coordinates. + + \see drawLinePlot, drawImpulsePlot, drawScatterPlot +*/ +void QCPGraph::drawFill(QCPPainter *painter, QVector *lines) const +{ + if (mLineStyle == lsImpulse) return; // fill doesn't make sense for impulse plot + if (painter->brush().style() == Qt::NoBrush || painter->brush().color().alpha() == 0) return; + + applyFillAntialiasingHint(painter); + QVector segments = getNonNanSegments(lines, keyAxis()->orientation()); + if (!mChannelFillGraph) + { + // draw base fill under graph, fill goes all the way to the zero-value-line: + for (int i=0; idrawPolygon(getFillPolygon(lines, segments.at(i))); + } else + { + // draw fill between this graph and mChannelFillGraph: + QVector otherLines; + mChannelFillGraph->getLines(&otherLines, QCPDataRange(0, mChannelFillGraph->dataCount())); + if (!otherLines.isEmpty()) + { + QVector otherSegments = getNonNanSegments(&otherLines, mChannelFillGraph->keyAxis()->orientation()); + QVector > segmentPairs = getOverlappingSegments(segments, lines, otherSegments, &otherLines); + for (int i=0; idrawPolygon(getChannelFillPolygon(lines, segmentPairs.at(i).first, &otherLines, segmentPairs.at(i).second)); + } + } +} + +/*! \internal + + Draws scatter symbols at every point passed in \a scatters, given in pixel coordinates. The + scatters will be drawn with \a painter and have the appearance as specified in \a style. + + \see drawLinePlot, drawImpulsePlot +*/ +void QCPGraph::drawScatterPlot(QCPPainter *painter, const QVector &scatters, const QCPScatterStyle &style) const +{ + applyScattersAntialiasingHint(painter); + style.applyTo(painter, mPen); + for (int i=0; i &lines) const +{ + if (painter->pen().style() != Qt::NoPen && painter->pen().color().alpha() != 0) + { + applyDefaultAntialiasingHint(painter); + drawPolyline(painter, lines); + } +} + +/*! \internal + + Draws impulses from the provided data, i.e. it connects all line pairs in \a lines, given in + pixel coordinates. The \a lines necessary for impulses are generated by \ref dataToImpulseLines + from the regular graph data points. + + \see drawLinePlot, drawScatterPlot +*/ +void QCPGraph::drawImpulsePlot(QCPPainter *painter, const QVector &lines) const +{ + if (painter->pen().style() != Qt::NoPen && painter->pen().color().alpha() != 0) + { + applyDefaultAntialiasingHint(painter); + QPen oldPen = painter->pen(); + QPen newPen = painter->pen(); + newPen.setCapStyle(Qt::FlatCap); // so impulse line doesn't reach beyond zero-line + painter->setPen(newPen); + painter->drawLines(lines); + painter->setPen(oldPen); + } +} + +/*! \internal + + Returns via \a lineData the data points that need to be visualized for this graph when plotting + graph lines, taking into consideration the currently visible axis ranges and, if \ref + setAdaptiveSampling is enabled, local point densities. The considered data can be restricted + further by \a begin and \a end, e.g. to only plot a certain segment of the data (see \ref + getDataSegments). + + This method is used by \ref getLines to retrieve the basic working set of data. + + \see getOptimizedScatterData +*/ +void QCPGraph::getOptimizedLineData(QVector *lineData, const QCPGraphDataContainer::const_iterator &begin, const QCPGraphDataContainer::const_iterator &end) const +{ + if (!lineData) return; + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + if (begin == end) return; + + int dataCount = end-begin; + int maxCount = (std::numeric_limits::max)(); + if (mAdaptiveSampling) + { + double keyPixelSpan = qAbs(keyAxis->coordToPixel(begin->key)-keyAxis->coordToPixel((end-1)->key)); + if (2*keyPixelSpan+2 < static_cast((std::numeric_limits::max)())) + maxCount = 2*keyPixelSpan+2; + } + + if (mAdaptiveSampling && dataCount >= maxCount) // use adaptive sampling only if there are at least two points per pixel on average + { + QCPGraphDataContainer::const_iterator it = begin; + double minValue = it->value; + double maxValue = it->value; + QCPGraphDataContainer::const_iterator currentIntervalFirstPoint = it; + int reversedFactor = keyAxis->pixelOrientation(); // is used to calculate keyEpsilon pixel into the correct direction + int reversedRound = reversedFactor==-1 ? 1 : 0; // is used to switch between floor (normal) and ceil (reversed) rounding of currentIntervalStartKey + double currentIntervalStartKey = keyAxis->pixelToCoord((int)(keyAxis->coordToPixel(begin->key)+reversedRound)); + double lastIntervalEndKey = currentIntervalStartKey; + double keyEpsilon = qAbs(currentIntervalStartKey-keyAxis->pixelToCoord(keyAxis->coordToPixel(currentIntervalStartKey)+1.0*reversedFactor)); // interval of one pixel on screen when mapped to plot key coordinates + bool keyEpsilonVariable = keyAxis->scaleType() == QCPAxis::stLogarithmic; // indicates whether keyEpsilon needs to be updated after every interval (for log axes) + int intervalDataCount = 1; + ++it; // advance iterator to second data point because adaptive sampling works in 1 point retrospect + while (it != end) + { + if (it->key < currentIntervalStartKey+keyEpsilon) // data point is still within same pixel, so skip it and expand value span of this cluster if necessary + { + if (it->value < minValue) + minValue = it->value; + else if (it->value > maxValue) + maxValue = it->value; + ++intervalDataCount; + } else // new pixel interval started + { + if (intervalDataCount >= 2) // last pixel had multiple data points, consolidate them to a cluster + { + if (lastIntervalEndKey < currentIntervalStartKey-keyEpsilon) // last point is further away, so first point of this cluster must be at a real data point + lineData->append(QCPGraphData(currentIntervalStartKey+keyEpsilon*0.2, currentIntervalFirstPoint->value)); + lineData->append(QCPGraphData(currentIntervalStartKey+keyEpsilon*0.25, minValue)); + lineData->append(QCPGraphData(currentIntervalStartKey+keyEpsilon*0.75, maxValue)); + if (it->key > currentIntervalStartKey+keyEpsilon*2) // new pixel started further away from previous cluster, so make sure the last point of the cluster is at a real data point + lineData->append(QCPGraphData(currentIntervalStartKey+keyEpsilon*0.8, (it-1)->value)); + } else + lineData->append(QCPGraphData(currentIntervalFirstPoint->key, currentIntervalFirstPoint->value)); + lastIntervalEndKey = (it-1)->key; + minValue = it->value; + maxValue = it->value; + currentIntervalFirstPoint = it; + currentIntervalStartKey = keyAxis->pixelToCoord((int)(keyAxis->coordToPixel(it->key)+reversedRound)); + if (keyEpsilonVariable) + keyEpsilon = qAbs(currentIntervalStartKey-keyAxis->pixelToCoord(keyAxis->coordToPixel(currentIntervalStartKey)+1.0*reversedFactor)); + intervalDataCount = 1; + } + ++it; + } + // handle last interval: + if (intervalDataCount >= 2) // last pixel had multiple data points, consolidate them to a cluster + { + if (lastIntervalEndKey < currentIntervalStartKey-keyEpsilon) // last point wasn't a cluster, so first point of this cluster must be at a real data point + lineData->append(QCPGraphData(currentIntervalStartKey+keyEpsilon*0.2, currentIntervalFirstPoint->value)); + lineData->append(QCPGraphData(currentIntervalStartKey+keyEpsilon*0.25, minValue)); + lineData->append(QCPGraphData(currentIntervalStartKey+keyEpsilon*0.75, maxValue)); + } else + lineData->append(QCPGraphData(currentIntervalFirstPoint->key, currentIntervalFirstPoint->value)); + + } else // don't use adaptive sampling algorithm, transfer points one-to-one from the data container into the output + { + lineData->resize(dataCount); + std::copy(begin, end, lineData->begin()); + } +} + +/*! \internal + + Returns via \a scatterData the data points that need to be visualized for this graph when + plotting scatter points, taking into consideration the currently visible axis ranges and, if \ref + setAdaptiveSampling is enabled, local point densities. The considered data can be restricted + further by \a begin and \a end, e.g. to only plot a certain segment of the data (see \ref + getDataSegments). + + This method is used by \ref getScatters to retrieve the basic working set of data. + + \see getOptimizedLineData +*/ +void QCPGraph::getOptimizedScatterData(QVector *scatterData, QCPGraphDataContainer::const_iterator begin, QCPGraphDataContainer::const_iterator end) const +{ + if (!scatterData) return; + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + + const int scatterModulo = mScatterSkip+1; + const bool doScatterSkip = mScatterSkip > 0; + int beginIndex = begin-mDataContainer->constBegin(); + int endIndex = end-mDataContainer->constBegin(); + while (doScatterSkip && begin != end && beginIndex % scatterModulo != 0) // advance begin iterator to first non-skipped scatter + { + ++beginIndex; + ++begin; + } + if (begin == end) return; + int dataCount = end-begin; + int maxCount = (std::numeric_limits::max)(); + if (mAdaptiveSampling) + { + int keyPixelSpan = qAbs(keyAxis->coordToPixel(begin->key)-keyAxis->coordToPixel((end-1)->key)); + maxCount = 2*keyPixelSpan+2; + } + + if (mAdaptiveSampling && dataCount >= maxCount) // use adaptive sampling only if there are at least two points per pixel on average + { + double valueMaxRange = valueAxis->range().upper; + double valueMinRange = valueAxis->range().lower; + QCPGraphDataContainer::const_iterator it = begin; + int itIndex = beginIndex; + double minValue = it->value; + double maxValue = it->value; + QCPGraphDataContainer::const_iterator minValueIt = it; + QCPGraphDataContainer::const_iterator maxValueIt = it; + QCPGraphDataContainer::const_iterator currentIntervalStart = it; + int reversedFactor = keyAxis->pixelOrientation(); // is used to calculate keyEpsilon pixel into the correct direction + int reversedRound = reversedFactor==-1 ? 1 : 0; // is used to switch between floor (normal) and ceil (reversed) rounding of currentIntervalStartKey + double currentIntervalStartKey = keyAxis->pixelToCoord((int)(keyAxis->coordToPixel(begin->key)+reversedRound)); + double keyEpsilon = qAbs(currentIntervalStartKey-keyAxis->pixelToCoord(keyAxis->coordToPixel(currentIntervalStartKey)+1.0*reversedFactor)); // interval of one pixel on screen when mapped to plot key coordinates + bool keyEpsilonVariable = keyAxis->scaleType() == QCPAxis::stLogarithmic; // indicates whether keyEpsilon needs to be updated after every interval (for log axes) + int intervalDataCount = 1; + // advance iterator to second (non-skipped) data point because adaptive sampling works in 1 point retrospect: + if (!doScatterSkip) + ++it; + else + { + itIndex += scatterModulo; + if (itIndex < endIndex) // make sure we didn't jump over end + it += scatterModulo; + else + { + it = end; + itIndex = endIndex; + } + } + // main loop over data points: + while (it != end) + { + if (it->key < currentIntervalStartKey+keyEpsilon) // data point is still within same pixel, so skip it and expand value span of this pixel if necessary + { + if (it->value < minValue && it->value > valueMinRange && it->value < valueMaxRange) + { + minValue = it->value; + minValueIt = it; + } else if (it->value > maxValue && it->value > valueMinRange && it->value < valueMaxRange) + { + maxValue = it->value; + maxValueIt = it; + } + ++intervalDataCount; + } else // new pixel started + { + if (intervalDataCount >= 2) // last pixel had multiple data points, consolidate them + { + // determine value pixel span and add as many points in interval to maintain certain vertical data density (this is specific to scatter plot): + double valuePixelSpan = qAbs(valueAxis->coordToPixel(minValue)-valueAxis->coordToPixel(maxValue)); + int dataModulo = qMax(1, qRound(intervalDataCount/(valuePixelSpan/4.0))); // approximately every 4 value pixels one data point on average + QCPGraphDataContainer::const_iterator intervalIt = currentIntervalStart; + int c = 0; + while (intervalIt != it) + { + if ((c % dataModulo == 0 || intervalIt == minValueIt || intervalIt == maxValueIt) && intervalIt->value > valueMinRange && intervalIt->value < valueMaxRange) + scatterData->append(*intervalIt); + ++c; + if (!doScatterSkip) + ++intervalIt; + else + intervalIt += scatterModulo; // since we know indices of "currentIntervalStart", "intervalIt" and "it" are multiples of scatterModulo, we can't accidentally jump over "it" here + } + } else if (currentIntervalStart->value > valueMinRange && currentIntervalStart->value < valueMaxRange) + scatterData->append(*currentIntervalStart); + minValue = it->value; + maxValue = it->value; + currentIntervalStart = it; + currentIntervalStartKey = keyAxis->pixelToCoord((int)(keyAxis->coordToPixel(it->key)+reversedRound)); + if (keyEpsilonVariable) + keyEpsilon = qAbs(currentIntervalStartKey-keyAxis->pixelToCoord(keyAxis->coordToPixel(currentIntervalStartKey)+1.0*reversedFactor)); + intervalDataCount = 1; + } + // advance to next data point: + if (!doScatterSkip) + ++it; + else + { + itIndex += scatterModulo; + if (itIndex < endIndex) // make sure we didn't jump over end + it += scatterModulo; + else + { + it = end; + itIndex = endIndex; + } + } + } + // handle last interval: + if (intervalDataCount >= 2) // last pixel had multiple data points, consolidate them + { + // determine value pixel span and add as many points in interval to maintain certain vertical data density (this is specific to scatter plot): + double valuePixelSpan = qAbs(valueAxis->coordToPixel(minValue)-valueAxis->coordToPixel(maxValue)); + int dataModulo = qMax(1, qRound(intervalDataCount/(valuePixelSpan/4.0))); // approximately every 4 value pixels one data point on average + QCPGraphDataContainer::const_iterator intervalIt = currentIntervalStart; + int intervalItIndex = intervalIt-mDataContainer->constBegin(); + int c = 0; + while (intervalIt != it) + { + if ((c % dataModulo == 0 || intervalIt == minValueIt || intervalIt == maxValueIt) && intervalIt->value > valueMinRange && intervalIt->value < valueMaxRange) + scatterData->append(*intervalIt); + ++c; + if (!doScatterSkip) + ++intervalIt; + else // here we can't guarantee that adding scatterModulo doesn't exceed "it" (because "it" is equal to "end" here, and "end" isn't scatterModulo-aligned), so check via index comparison: + { + intervalItIndex += scatterModulo; + if (intervalItIndex < itIndex) + intervalIt += scatterModulo; + else + { + intervalIt = it; + intervalItIndex = itIndex; + } + } + } + } else if (currentIntervalStart->value > valueMinRange && currentIntervalStart->value < valueMaxRange) + scatterData->append(*currentIntervalStart); + + } else // don't use adaptive sampling algorithm, transfer points one-to-one from the data container into the output + { + QCPGraphDataContainer::const_iterator it = begin; + int itIndex = beginIndex; + scatterData->reserve(dataCount); + while (it != end) + { + scatterData->append(*it); + // advance to next data point: + if (!doScatterSkip) + ++it; + else + { + itIndex += scatterModulo; + if (itIndex < endIndex) + it += scatterModulo; + else + { + it = end; + itIndex = endIndex; + } + } + } + } +} + +/*! + This method outputs the currently visible data range via \a begin and \a end. The returned range + will also never exceed \a rangeRestriction. + + This method takes into account that the drawing of data lines at the axis rect border always + requires the points just outside the visible axis range. So \a begin and \a end may actually + indicate a range that contains one additional data point to the left and right of the visible + axis range. +*/ +void QCPGraph::getVisibleDataBounds(QCPGraphDataContainer::const_iterator &begin, QCPGraphDataContainer::const_iterator &end, const QCPDataRange &rangeRestriction) const +{ + if (rangeRestriction.isEmpty()) + { + end = mDataContainer->constEnd(); + begin = end; + } else + { + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + // get visible data range: + begin = mDataContainer->findBegin(keyAxis->range().lower); + end = mDataContainer->findEnd(keyAxis->range().upper); + // limit lower/upperEnd to rangeRestriction: + mDataContainer->limitIteratorsToDataRange(begin, end, rangeRestriction); // this also ensures rangeRestriction outside data bounds doesn't break anything + } +} + +/*! \internal + + This method goes through the passed points in \a lineData and returns a list of the segments + which don't contain NaN data points. + + \a keyOrientation defines whether the \a x or \a y member of the passed QPointF is used to check + for NaN. If \a keyOrientation is \c Qt::Horizontal, the \a y member is checked, if it is \c + Qt::Vertical, the \a x member is checked. + + \see getOverlappingSegments, drawFill +*/ +QVector QCPGraph::getNonNanSegments(const QVector *lineData, Qt::Orientation keyOrientation) const +{ + QVector result; + const int n = lineData->size(); + + QCPDataRange currentSegment(-1, -1); + int i = 0; + + if (keyOrientation == Qt::Horizontal) + { + while (i < n) + { + while (i < n && qIsNaN(lineData->at(i).y())) // seek next non-NaN data point + ++i; + if (i == n) + break; + currentSegment.setBegin(i++); + while (i < n && !qIsNaN(lineData->at(i).y())) // seek next NaN data point or end of data + ++i; + currentSegment.setEnd(i++); + result.append(currentSegment); + } + } else // keyOrientation == Qt::Vertical + { + while (i < n) + { + while (i < n && qIsNaN(lineData->at(i).x())) // seek next non-NaN data point + ++i; + if (i == n) + break; + currentSegment.setBegin(i++); + while (i < n && !qIsNaN(lineData->at(i).x())) // seek next NaN data point or end of data + ++i; + currentSegment.setEnd(i++); + result.append(currentSegment); + } + } + return result; +} + +/*! \internal + + This method takes two segment lists (e.g. created by \ref getNonNanSegments) \a thisSegments and + \a otherSegments, and their associated point data \a thisData and \a otherData. + + It returns all pairs of segments (the first from \a thisSegments, the second from \a + otherSegments), which overlap in plot coordinates. + + This method is useful in the case of a channel fill between two graphs, when only those non-NaN + segments which actually overlap in their key coordinate shall be considered for drawing a channel + fill polygon. + + It is assumed that the passed segments in \a thisSegments are ordered ascending by index, and + that the segments don't overlap themselves. The same is assumed for the segments in \a + otherSegments. This is fulfilled when the segments are obtained via \ref getNonNanSegments. + + \see getNonNanSegments, segmentsIntersect, drawFill, getChannelFillPolygon +*/ +QVector > QCPGraph::getOverlappingSegments(QVector thisSegments, const QVector *thisData, QVector otherSegments, const QVector *otherData) const +{ + QVector > result; + if (thisData->isEmpty() || otherData->isEmpty() || thisSegments.isEmpty() || otherSegments.isEmpty()) + return result; + + int thisIndex = 0; + int otherIndex = 0; + const bool verticalKey = mKeyAxis->orientation() == Qt::Vertical; + while (thisIndex < thisSegments.size() && otherIndex < otherSegments.size()) + { + if (thisSegments.at(thisIndex).size() < 2) // segments with fewer than two points won't have a fill anyhow + { + ++thisIndex; + continue; + } + if (otherSegments.at(otherIndex).size() < 2) // segments with fewer than two points won't have a fill anyhow + { + ++otherIndex; + continue; + } + double thisLower, thisUpper, otherLower, otherUpper; + if (!verticalKey) + { + thisLower = thisData->at(thisSegments.at(thisIndex).begin()).x(); + thisUpper = thisData->at(thisSegments.at(thisIndex).end()-1).x(); + otherLower = otherData->at(otherSegments.at(otherIndex).begin()).x(); + otherUpper = otherData->at(otherSegments.at(otherIndex).end()-1).x(); + } else + { + thisLower = thisData->at(thisSegments.at(thisIndex).begin()).y(); + thisUpper = thisData->at(thisSegments.at(thisIndex).end()-1).y(); + otherLower = otherData->at(otherSegments.at(otherIndex).begin()).y(); + otherUpper = otherData->at(otherSegments.at(otherIndex).end()-1).y(); + } + + int bPrecedence; + if (segmentsIntersect(thisLower, thisUpper, otherLower, otherUpper, bPrecedence)) + result.append(QPair(thisSegments.at(thisIndex), otherSegments.at(otherIndex))); + + if (bPrecedence <= 0) // otherSegment doesn't reach as far as thisSegment, so continue with next otherSegment, keeping current thisSegment + ++otherIndex; + else // otherSegment reaches further than thisSegment, so continue with next thisSegment, keeping current otherSegment + ++thisIndex; + } + + return result; +} + +/*! \internal + + Returns whether the segments defined by the coordinates (aLower, aUpper) and (bLower, bUpper) + have overlap. + + The output parameter \a bPrecedence indicates whether the \a b segment reaches farther than the + \a a segment or not. If \a bPrecedence returns 1, segment \a b reaches the farthest to higher + coordinates (i.e. bUpper > aUpper). If it returns -1, segment \a a reaches the farthest. Only if + both segment's upper bounds are identical, 0 is returned as \a bPrecedence. + + It is assumed that the lower bounds always have smaller or equal values than the upper bounds. + + \see getOverlappingSegments +*/ +bool QCPGraph::segmentsIntersect(double aLower, double aUpper, double bLower, double bUpper, int &bPrecedence) const +{ + bPrecedence = 0; + if (aLower > bUpper) + { + bPrecedence = -1; + return false; + } else if (bLower > aUpper) + { + bPrecedence = 1; + return false; + } else + { + if (aUpper > bUpper) + bPrecedence = -1; + else if (aUpper < bUpper) + bPrecedence = 1; + + return true; + } +} + +/*! \internal + + Returns the point which closes the fill polygon on the zero-value-line parallel to the key axis. + The logarithmic axis scale case is a bit special, since the zero-value-line in pixel coordinates + is in positive or negative infinity. So this case is handled separately by just closing the fill + polygon on the axis which lies in the direction towards the zero value. + + \a matchingDataPoint will provide the key (in pixels) of the returned point. Depending on whether + the key axis of this graph is horizontal or vertical, \a matchingDataPoint will provide the x or + y value of the returned point, respectively. +*/ +QPointF QCPGraph::getFillBasePoint(QPointF matchingDataPoint) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return QPointF(); } + + QPointF result; + if (valueAxis->scaleType() == QCPAxis::stLinear) + { + if (keyAxis->orientation() == Qt::Horizontal) + { + result.setX(matchingDataPoint.x()); + result.setY(valueAxis->coordToPixel(0)); + } else // keyAxis->orientation() == Qt::Vertical + { + result.setX(valueAxis->coordToPixel(0)); + result.setY(matchingDataPoint.y()); + } + } else // valueAxis->mScaleType == QCPAxis::stLogarithmic + { + // In logarithmic scaling we can't just draw to value 0 so we just fill all the way + // to the axis which is in the direction towards 0 + if (keyAxis->orientation() == Qt::Vertical) + { + if ((valueAxis->range().upper < 0 && !valueAxis->rangeReversed()) || + (valueAxis->range().upper > 0 && valueAxis->rangeReversed())) // if range is negative, zero is on opposite side of key axis + result.setX(keyAxis->axisRect()->right()); + else + result.setX(keyAxis->axisRect()->left()); + result.setY(matchingDataPoint.y()); + } else if (keyAxis->axisType() == QCPAxis::atTop || keyAxis->axisType() == QCPAxis::atBottom) + { + result.setX(matchingDataPoint.x()); + if ((valueAxis->range().upper < 0 && !valueAxis->rangeReversed()) || + (valueAxis->range().upper > 0 && valueAxis->rangeReversed())) // if range is negative, zero is on opposite side of key axis + result.setY(keyAxis->axisRect()->top()); + else + result.setY(keyAxis->axisRect()->bottom()); + } + } + return result; +} + +/*! \internal + + Returns the polygon needed for drawing normal fills between this graph and the key axis. + + Pass the graph's data points (in pixel coordinates) as \a lineData, and specify the \a segment + which shall be used for the fill. The collection of \a lineData points described by \a segment + must not contain NaN data points (see \ref getNonNanSegments). + + The returned fill polygon will be closed at the key axis (the zero-value line) for linear value + axes. For logarithmic value axes the polygon will reach just beyond the corresponding axis rect + side (see \ref getFillBasePoint). + + For increased performance (due to implicit sharing), keep the returned QPolygonF const. + + \see drawFill, getNonNanSegments +*/ +const QPolygonF QCPGraph::getFillPolygon(const QVector *lineData, QCPDataRange segment) const +{ + if (segment.size() < 2) + return QPolygonF(); + QPolygonF result(segment.size()+2); + + result[0] = getFillBasePoint(lineData->at(segment.begin())); + std::copy(lineData->constBegin()+segment.begin(), lineData->constBegin()+segment.end(), result.begin()+1); + result[result.size()-1] = getFillBasePoint(lineData->at(segment.end()-1)); + + return result; +} + +/*! \internal + + Returns the polygon needed for drawing (partial) channel fills between this graph and the graph + specified by \ref setChannelFillGraph. + + The data points of this graph are passed as pixel coordinates via \a thisData, the data of the + other graph as \a otherData. The returned polygon will be calculated for the specified data + segments \a thisSegment and \a otherSegment, pertaining to the respective \a thisData and \a + otherData, respectively. + + The passed \a thisSegment and \a otherSegment should correspond to the segment pairs returned by + \ref getOverlappingSegments, to make sure only segments that actually have key coordinate overlap + need to be processed here. + + For increased performance due to implicit sharing, keep the returned QPolygonF const. + + \see drawFill, getOverlappingSegments, getNonNanSegments +*/ +const QPolygonF QCPGraph::getChannelFillPolygon(const QVector *thisData, QCPDataRange thisSegment, const QVector *otherData, QCPDataRange otherSegment) const +{ + if (!mChannelFillGraph) + return QPolygonF(); + + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return QPolygonF(); } + if (!mChannelFillGraph.data()->mKeyAxis) { qDebug() << Q_FUNC_INFO << "channel fill target key axis invalid"; return QPolygonF(); } + + if (mChannelFillGraph.data()->mKeyAxis.data()->orientation() != keyAxis->orientation()) + return QPolygonF(); // don't have same axis orientation, can't fill that (Note: if keyAxis fits, valueAxis will fit too, because it's always orthogonal to keyAxis) + + if (thisData->isEmpty()) return QPolygonF(); + QVector thisSegmentData(thisSegment.size()); + QVector otherSegmentData(otherSegment.size()); + std::copy(thisData->constBegin()+thisSegment.begin(), thisData->constBegin()+thisSegment.end(), thisSegmentData.begin()); + std::copy(otherData->constBegin()+otherSegment.begin(), otherData->constBegin()+otherSegment.end(), otherSegmentData.begin()); + // pointers to be able to swap them, depending which data range needs cropping: + QVector *staticData = &thisSegmentData; + QVector *croppedData = &otherSegmentData; + + // crop both vectors to ranges in which the keys overlap (which coord is key, depends on axisType): + if (keyAxis->orientation() == Qt::Horizontal) + { + // x is key + // crop lower bound: + if (staticData->first().x() < croppedData->first().x()) // other one must be cropped + qSwap(staticData, croppedData); + const int lowBound = findIndexBelowX(croppedData, staticData->first().x()); + if (lowBound == -1) return QPolygonF(); // key ranges have no overlap + croppedData->remove(0, lowBound); + // set lowest point of cropped data to fit exactly key position of first static data point via linear interpolation: + if (croppedData->size() < 2) return QPolygonF(); // need at least two points for interpolation + double slope; + if (!qFuzzyCompare(croppedData->at(1).x(), croppedData->at(0).x())) + slope = (croppedData->at(1).y()-croppedData->at(0).y())/(croppedData->at(1).x()-croppedData->at(0).x()); + else + slope = 0; + (*croppedData)[0].setY(croppedData->at(0).y()+slope*(staticData->first().x()-croppedData->at(0).x())); + (*croppedData)[0].setX(staticData->first().x()); + + // crop upper bound: + if (staticData->last().x() > croppedData->last().x()) // other one must be cropped + qSwap(staticData, croppedData); + int highBound = findIndexAboveX(croppedData, staticData->last().x()); + if (highBound == -1) return QPolygonF(); // key ranges have no overlap + croppedData->remove(highBound+1, croppedData->size()-(highBound+1)); + // set highest point of cropped data to fit exactly key position of last static data point via linear interpolation: + if (croppedData->size() < 2) return QPolygonF(); // need at least two points for interpolation + const int li = croppedData->size()-1; // last index + if (!qFuzzyCompare(croppedData->at(li).x(), croppedData->at(li-1).x())) + slope = (croppedData->at(li).y()-croppedData->at(li-1).y())/(croppedData->at(li).x()-croppedData->at(li-1).x()); + else + slope = 0; + (*croppedData)[li].setY(croppedData->at(li-1).y()+slope*(staticData->last().x()-croppedData->at(li-1).x())); + (*croppedData)[li].setX(staticData->last().x()); + } else // mKeyAxis->orientation() == Qt::Vertical + { + // y is key + // crop lower bound: + if (staticData->first().y() < croppedData->first().y()) // other one must be cropped + qSwap(staticData, croppedData); + int lowBound = findIndexBelowY(croppedData, staticData->first().y()); + if (lowBound == -1) return QPolygonF(); // key ranges have no overlap + croppedData->remove(0, lowBound); + // set lowest point of cropped data to fit exactly key position of first static data point via linear interpolation: + if (croppedData->size() < 2) return QPolygonF(); // need at least two points for interpolation + double slope; + if (!qFuzzyCompare(croppedData->at(1).y(), croppedData->at(0).y())) // avoid division by zero in step plots + slope = (croppedData->at(1).x()-croppedData->at(0).x())/(croppedData->at(1).y()-croppedData->at(0).y()); + else + slope = 0; + (*croppedData)[0].setX(croppedData->at(0).x()+slope*(staticData->first().y()-croppedData->at(0).y())); + (*croppedData)[0].setY(staticData->first().y()); + + // crop upper bound: + if (staticData->last().y() > croppedData->last().y()) // other one must be cropped + qSwap(staticData, croppedData); + int highBound = findIndexAboveY(croppedData, staticData->last().y()); + if (highBound == -1) return QPolygonF(); // key ranges have no overlap + croppedData->remove(highBound+1, croppedData->size()-(highBound+1)); + // set highest point of cropped data to fit exactly key position of last static data point via linear interpolation: + if (croppedData->size() < 2) return QPolygonF(); // need at least two points for interpolation + int li = croppedData->size()-1; // last index + if (!qFuzzyCompare(croppedData->at(li).y(), croppedData->at(li-1).y())) // avoid division by zero in step plots + slope = (croppedData->at(li).x()-croppedData->at(li-1).x())/(croppedData->at(li).y()-croppedData->at(li-1).y()); + else + slope = 0; + (*croppedData)[li].setX(croppedData->at(li-1).x()+slope*(staticData->last().y()-croppedData->at(li-1).y())); + (*croppedData)[li].setY(staticData->last().y()); + } + + // return joined: + for (int i=otherSegmentData.size()-1; i>=0; --i) // insert reversed, otherwise the polygon will be twisted + thisSegmentData << otherSegmentData.at(i); + return QPolygonF(thisSegmentData); +} + +/*! \internal + + Finds the smallest index of \a data, whose points x value is just above \a x. Assumes x values in + \a data points are ordered ascending, as is ensured by \ref getLines/\ref getScatters if the key + axis is horizontal. + + Used to calculate the channel fill polygon, see \ref getChannelFillPolygon. +*/ +int QCPGraph::findIndexAboveX(const QVector *data, double x) const +{ + for (int i=data->size()-1; i>=0; --i) + { + if (data->at(i).x() < x) + { + if (isize()-1) + return i+1; + else + return data->size()-1; + } + } + return -1; +} + +/*! \internal + + Finds the highest index of \a data, whose points x value is just below \a x. Assumes x values in + \a data points are ordered ascending, as is ensured by \ref getLines/\ref getScatters if the key + axis is horizontal. + + Used to calculate the channel fill polygon, see \ref getChannelFillPolygon. +*/ +int QCPGraph::findIndexBelowX(const QVector *data, double x) const +{ + for (int i=0; isize(); ++i) + { + if (data->at(i).x() > x) + { + if (i>0) + return i-1; + else + return 0; + } + } + return -1; +} + +/*! \internal + + Finds the smallest index of \a data, whose points y value is just above \a y. Assumes y values in + \a data points are ordered ascending, as is ensured by \ref getLines/\ref getScatters if the key + axis is vertical. + + Used to calculate the channel fill polygon, see \ref getChannelFillPolygon. +*/ +int QCPGraph::findIndexAboveY(const QVector *data, double y) const +{ + for (int i=data->size()-1; i>=0; --i) + { + if (data->at(i).y() < y) + { + if (isize()-1) + return i+1; + else + return data->size()-1; + } + } + return -1; +} + +/*! \internal + + Calculates the minimum distance in pixels the graph's representation has from the given \a + pixelPoint. This is used to determine whether the graph was clicked or not, e.g. in \ref + selectTest. The closest data point to \a pixelPoint is returned in \a closestData. Note that if + the graph has a line representation, the returned distance may be smaller than the distance to + the \a closestData point, since the distance to the graph line is also taken into account. + + If either the graph has no data or if the line style is \ref lsNone and the scatter style's shape + is \ref QCPScatterStyle::ssNone (i.e. there is no visual representation of the graph), returns -1.0. +*/ +double QCPGraph::pointDistance(const QPointF &pixelPoint, QCPGraphDataContainer::const_iterator &closestData) const +{ + closestData = mDataContainer->constEnd(); + if (mDataContainer->isEmpty()) + return -1.0; + if (mLineStyle == lsNone && mScatterStyle.isNone()) + return -1.0; + + // calculate minimum distances to graph data points and find closestData iterator: + double minDistSqr = (std::numeric_limits::max)(); + // determine which key range comes into question, taking selection tolerance around pos into account: + double posKeyMin, posKeyMax, dummy; + pixelsToCoords(pixelPoint-QPointF(mParentPlot->selectionTolerance(), mParentPlot->selectionTolerance()), posKeyMin, dummy); + pixelsToCoords(pixelPoint+QPointF(mParentPlot->selectionTolerance(), mParentPlot->selectionTolerance()), posKeyMax, dummy); + if (posKeyMin > posKeyMax) + qSwap(posKeyMin, posKeyMax); + // iterate over found data points and then choose the one with the shortest distance to pos: + QCPGraphDataContainer::const_iterator begin = mDataContainer->findBegin(posKeyMin, true); + QCPGraphDataContainer::const_iterator end = mDataContainer->findEnd(posKeyMax, true); + for (QCPGraphDataContainer::const_iterator it=begin; it!=end; ++it) + { + const double currentDistSqr = QCPVector2D(coordsToPixels(it->key, it->value)-pixelPoint).lengthSquared(); + if (currentDistSqr < minDistSqr) + { + minDistSqr = currentDistSqr; + closestData = it; + } + } + + // calculate distance to graph line if there is one (if so, will probably be smaller than distance to closest data point): + if (mLineStyle != lsNone) + { + // line displayed, calculate distance to line segments: + QVector lineData; + getLines(&lineData, QCPDataRange(0, dataCount())); + QCPVector2D p(pixelPoint); + const int step = mLineStyle==lsImpulse ? 2 : 1; // impulse plot differs from other line styles in that the lineData points are only pairwise connected + for (int i=0; i *data, double y) const +{ + for (int i=0; isize(); ++i) + { + if (data->at(i).y() > y) + { + if (i>0) + return i-1; + else + return 0; + } + } + return -1; +} +/* end of 'src/plottables/plottable-graph.cpp' */ + + +/* including file 'src/plottables/plottable-curve.cpp', size 63742 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPCurveData +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPCurveData + \brief Holds the data of one single data point for QCPCurve. + + The stored data is: + \li \a t: the free ordering parameter of this curve point, like in the mathematical vector (x(t), y(t)). (This is the \a sortKey) + \li \a key: coordinate on the key axis of this curve point (this is the \a mainKey) + \li \a value: coordinate on the value axis of this curve point (this is the \a mainValue) + + The container for storing multiple data points is \ref QCPCurveDataContainer. It is a typedef for + \ref QCPDataContainer with \ref QCPCurveData as the DataType template parameter. See the + documentation there for an explanation regarding the data type's generic methods. + + \see QCPCurveDataContainer +*/ + +/* start documentation of inline functions */ + +/*! \fn double QCPCurveData::sortKey() const + + Returns the \a t member of this data point. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn static QCPCurveData QCPCurveData::fromSortKey(double sortKey) + + Returns a data point with the specified \a sortKey (assigned to the data point's \a t member). + All other members are set to zero. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn static static bool QCPCurveData::sortKeyIsMainKey() + + Since the member \a key is the data point key coordinate and the member \a t is the data ordering + parameter, this method returns false. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn double QCPCurveData::mainKey() const + + Returns the \a key member of this data point. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn double QCPCurveData::mainValue() const + + Returns the \a value member of this data point. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn QCPRange QCPCurveData::valueRange() const + + Returns a QCPRange with both lower and upper boundary set to \a value of this data point. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/* end documentation of inline functions */ + +/*! + Constructs a curve data point with t, key and value set to zero. +*/ +QCPCurveData::QCPCurveData() : + t(0), + key(0), + value(0) +{ +} + +/*! + Constructs a curve data point with the specified \a t, \a key and \a value. +*/ +QCPCurveData::QCPCurveData(double t, double key, double value) : + t(t), + key(key), + value(value) +{ +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPCurve +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPCurve + \brief A plottable representing a parametric curve in a plot. + + \image html QCPCurve.png + + Unlike QCPGraph, plottables of this type may have multiple points with the same key coordinate, + so their visual representation can have \a loops. This is realized by introducing a third + coordinate \a t, which defines the order of the points described by the other two coordinates \a + x and \a y. + + To plot data, assign it with the \ref setData or \ref addData functions. Alternatively, you can + also access and modify the curve's data via the \ref data method, which returns a pointer to the + internal \ref QCPCurveDataContainer. + + Gaps in the curve can be created by adding data points with NaN as key and value + (qQNaN() or std::numeric_limits::quiet_NaN()) in between the two data points that shall be + separated. + + \section qcpcurve-appearance Changing the appearance + + The appearance of the curve is determined by the pen and the brush (\ref setPen, \ref setBrush). + + \section qcpcurve-usage Usage + + Like all data representing objects in QCustomPlot, the QCPCurve is a plottable + (QCPAbstractPlottable). So the plottable-interface of QCustomPlot applies + (QCustomPlot::plottable, QCustomPlot::removePlottable, etc.) + + Usually, you first create an instance: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcurve-creation-1 + which registers it with the QCustomPlot instance of the passed axes. Note that this QCustomPlot instance takes + ownership of the plottable, so do not delete it manually but use QCustomPlot::removePlottable() instead. + The newly created plottable can be modified, e.g.: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcurve-creation-2 +*/ + +/* start of documentation of inline functions */ + +/*! \fn QSharedPointer QCPCurve::data() const + + Returns a shared pointer to the internal data storage of type \ref QCPCurveDataContainer. You may + use it to directly manipulate the data, which may be more convenient and faster than using the + regular \ref setData or \ref addData methods. +*/ + +/* end of documentation of inline functions */ + +/*! + Constructs a curve which uses \a keyAxis as its key axis ("x") and \a valueAxis as its value + axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance and not have + the same orientation. If either of these restrictions is violated, a corresponding message is + printed to the debug output (qDebug), the construction is not aborted, though. + + The created QCPCurve is automatically registered with the QCustomPlot instance inferred from \a + keyAxis. This QCustomPlot instance takes ownership of the QCPCurve, so do not delete it manually + but use QCustomPlot::removePlottable() instead. +*/ +QCPCurve::QCPCurve(QCPAxis *keyAxis, QCPAxis *valueAxis) : + QCPAbstractPlottable1D(keyAxis, valueAxis) +{ + // modify inherited properties from abstract plottable: + setPen(QPen(Qt::blue, 0)); + setBrush(Qt::NoBrush); + + setScatterStyle(QCPScatterStyle()); + setLineStyle(lsLine); + setScatterSkip(0); +} + +QCPCurve::~QCPCurve() +{ +} + +/*! \overload + + Replaces the current data container with the provided \a data container. + + Since a QSharedPointer is used, multiple QCPCurves may share the same data container safely. + Modifying the data in the container will then affect all curves that share the container. Sharing + can be achieved by simply exchanging the data containers wrapped in shared pointers: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcurve-datasharing-1 + + If you do not wish to share containers, but create a copy from an existing container, rather use + the \ref QCPDataContainer::set method on the curve's data container directly: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpcurve-datasharing-2 + + \see addData +*/ +void QCPCurve::setData(QSharedPointer data) +{ + mDataContainer = data; +} + +/*! \overload + + Replaces the current data with the provided points in \a t, \a keys and \a values. The provided + vectors should have equal length. Else, the number of added points will be the size of the + smallest vector. + + If you can guarantee that the passed data points are sorted by \a t in ascending order, you can + set \a alreadySorted to true, to improve performance by saving a sorting run. + + \see addData +*/ +void QCPCurve::setData(const QVector &t, const QVector &keys, const QVector &values, bool alreadySorted) +{ + mDataContainer->clear(); + addData(t, keys, values, alreadySorted); +} + + +/*! \overload + + Replaces the current data with the provided points in \a keys and \a values. The provided vectors + should have equal length. Else, the number of added points will be the size of the smallest + vector. + + The t parameter of each data point will be set to the integer index of the respective key/value + pair. + + \see addData +*/ +void QCPCurve::setData(const QVector &keys, const QVector &values) +{ + mDataContainer->clear(); + addData(keys, values); +} + +/*! + Sets the visual appearance of single data points in the plot. If set to \ref + QCPScatterStyle::ssNone, no scatter points are drawn (e.g. for line-only plots with appropriate + line style). + + \see QCPScatterStyle, setLineStyle +*/ +void QCPCurve::setScatterStyle(const QCPScatterStyle &style) +{ + mScatterStyle = style; +} + +/*! + If scatters are displayed (scatter style not \ref QCPScatterStyle::ssNone), \a skip number of + scatter points are skipped/not drawn after every drawn scatter point. + + This can be used to make the data appear sparser while for example still having a smooth line, + and to improve performance for very high density plots. + + If \a skip is set to 0 (default), all scatter points are drawn. + + \see setScatterStyle +*/ +void QCPCurve::setScatterSkip(int skip) +{ + mScatterSkip = qMax(0, skip); +} + +/*! + Sets how the single data points are connected in the plot or how they are represented visually + apart from the scatter symbol. For scatter-only plots, set \a style to \ref lsNone and \ref + setScatterStyle to the desired scatter style. + + \see setScatterStyle +*/ +void QCPCurve::setLineStyle(QCPCurve::LineStyle style) +{ + mLineStyle = style; +} + +/*! \overload + + Adds the provided points in \a t, \a keys and \a values to the current data. The provided vectors + should have equal length. Else, the number of added points will be the size of the smallest + vector. + + If you can guarantee that the passed data points are sorted by \a keys in ascending order, you + can set \a alreadySorted to true, to improve performance by saving a sorting run. + + Alternatively, you can also access and modify the data directly via the \ref data method, which + returns a pointer to the internal data container. +*/ +void QCPCurve::addData(const QVector &t, const QVector &keys, const QVector &values, bool alreadySorted) +{ + if (t.size() != keys.size() || t.size() != values.size()) + qDebug() << Q_FUNC_INFO << "ts, keys and values have different sizes:" << t.size() << keys.size() << values.size(); + const int n = qMin(qMin(t.size(), keys.size()), values.size()); + QVector tempData(n); + QVector::iterator it = tempData.begin(); + const QVector::iterator itEnd = tempData.end(); + int i = 0; + while (it != itEnd) + { + it->t = t[i]; + it->key = keys[i]; + it->value = values[i]; + ++it; + ++i; + } + mDataContainer->add(tempData, alreadySorted); // don't modify tempData beyond this to prevent copy on write +} + +/*! \overload + + Adds the provided points in \a keys and \a values to the current data. The provided vectors + should have equal length. Else, the number of added points will be the size of the smallest + vector. + + The t parameter of each data point will be set to the integer index of the respective key/value + pair. + + Alternatively, you can also access and modify the data directly via the \ref data method, which + returns a pointer to the internal data container. +*/ +void QCPCurve::addData(const QVector &keys, const QVector &values) +{ + 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()); + double tStart; + if (!mDataContainer->isEmpty()) + tStart = (mDataContainer->constEnd()-1)->t + 1.0; + else + tStart = 0; + QVector tempData(n); + QVector::iterator it = tempData.begin(); + const QVector::iterator itEnd = tempData.end(); + int i = 0; + while (it != itEnd) + { + it->t = tStart + i; + it->key = keys[i]; + it->value = values[i]; + ++it; + ++i; + } + mDataContainer->add(tempData, true); // don't modify tempData beyond this to prevent copy on write +} + +/*! \overload + Adds the provided data point as \a t, \a key and \a value to the current data. + + Alternatively, you can also access and modify the data directly via the \ref data method, which + returns a pointer to the internal data container. +*/ +void QCPCurve::addData(double t, double key, double value) +{ + mDataContainer->add(QCPCurveData(t, key, value)); +} + +/*! \overload + + Adds the provided data point as \a key and \a value to the current data. + + The t parameter is generated automatically by increments of 1 for each point, starting at the + highest t of previously existing data or 0, if the curve data is empty. + + Alternatively, you can also access and modify the data directly via the \ref data method, which + returns a pointer to the internal data container. +*/ +void QCPCurve::addData(double key, double value) +{ + if (!mDataContainer->isEmpty()) + mDataContainer->add(QCPCurveData((mDataContainer->constEnd()-1)->t + 1.0, key, value)); + else + mDataContainer->add(QCPCurveData(0.0, key, value)); +} + +/*! + Implements a selectTest specific to this plottable's point geometry. + + If \a details is not 0, it will be set to a \ref QCPDataSelection, describing the closest data + point to \a pos. + + \seebaseclassmethod \ref QCPAbstractPlottable::selectTest +*/ +double QCPCurve::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) + return -1; + if (!mKeyAxis || !mValueAxis) + return -1; + + if (mKeyAxis.data()->axisRect()->rect().contains(pos.toPoint())) + { + QCPCurveDataContainer::const_iterator closestDataPoint = mDataContainer->constEnd(); + double result = pointDistance(pos, closestDataPoint); + if (details) + { + int pointIndex = closestDataPoint-mDataContainer->constBegin(); + details->setValue(QCPDataSelection(QCPDataRange(pointIndex, pointIndex+1))); + } + return result; + } else + return -1; +} + +/* inherits documentation from base class */ +QCPRange QCPCurve::getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain) const +{ + return mDataContainer->keyRange(foundRange, inSignDomain); +} + +/* inherits documentation from base class */ +QCPRange QCPCurve::getValueRange(bool &foundRange, QCP::SignDomain inSignDomain, const QCPRange &inKeyRange) const +{ + return mDataContainer->valueRange(foundRange, inSignDomain, inKeyRange); +} + +/* inherits documentation from base class */ +void QCPCurve::draw(QCPPainter *painter) +{ + if (mDataContainer->isEmpty()) return; + + // allocate line vector: + QVector lines, scatters; + + // loop over and draw segments of unselected/selected data: + QList selectedSegments, unselectedSegments, allSegments; + getDataSegments(selectedSegments, unselectedSegments); + allSegments << unselectedSegments << selectedSegments; + for (int i=0; i= unselectedSegments.size(); + + // fill with curve data: + QPen finalCurvePen = mPen; // determine the final pen already here, because the line optimization depends on its stroke width + if (isSelectedSegment && mSelectionDecorator) + finalCurvePen = mSelectionDecorator->pen(); + + QCPDataRange lineDataRange = isSelectedSegment ? allSegments.at(i) : allSegments.at(i).adjusted(-1, 1); // unselected segments extend lines to bordering selected data point (safe to exceed total data bounds in first/last segment, getCurveLines takes care) + getCurveLines(&lines, lineDataRange, finalCurvePen.widthF()); + + // check data validity if flag set: + #ifdef QCUSTOMPLOT_CHECK_DATA + for (QCPCurveDataContainer::const_iterator it = mDataContainer->constBegin(); it != mDataContainer->constEnd(); ++it) + { + if (QCP::isInvalidData(it->t) || + QCP::isInvalidData(it->key, it->value)) + qDebug() << Q_FUNC_INFO << "Data point at" << it->key << "invalid." << "Plottable name:" << name(); + } + #endif + + // draw curve fill: + applyFillAntialiasingHint(painter); + if (isSelectedSegment && mSelectionDecorator) + mSelectionDecorator->applyBrush(painter); + else + painter->setBrush(mBrush); + painter->setPen(Qt::NoPen); + if (painter->brush().style() != Qt::NoBrush && painter->brush().color().alpha() != 0) + painter->drawPolygon(QPolygonF(lines)); + + // draw curve line: + if (mLineStyle != lsNone) + { + painter->setPen(finalCurvePen); + painter->setBrush(Qt::NoBrush); + drawCurveLine(painter, lines); + } + + // draw scatters: + QCPScatterStyle finalScatterStyle = mScatterStyle; + if (isSelectedSegment && mSelectionDecorator) + finalScatterStyle = mSelectionDecorator->getFinalScatterStyle(mScatterStyle); + if (!finalScatterStyle.isNone()) + { + getScatters(&scatters, allSegments.at(i), finalScatterStyle.size()); + drawScatterPlot(painter, scatters, finalScatterStyle); + } + } + + // draw other selection decoration that isn't just line/scatter pens and brushes: + if (mSelectionDecorator) + mSelectionDecorator->drawDecoration(painter, selection()); +} + +/* inherits documentation from base class */ +void QCPCurve::drawLegendIcon(QCPPainter *painter, const QRectF &rect) const +{ + // draw fill: + if (mBrush.style() != Qt::NoBrush) + { + applyFillAntialiasingHint(painter); + painter->fillRect(QRectF(rect.left(), rect.top()+rect.height()/2.0, rect.width(), rect.height()/3.0), mBrush); + } + // draw line vertically centered: + if (mLineStyle != lsNone) + { + applyDefaultAntialiasingHint(painter); + painter->setPen(mPen); + painter->drawLine(QLineF(rect.left(), rect.top()+rect.height()/2.0, rect.right()+5, rect.top()+rect.height()/2.0)); // +5 on x2 else last segment is missing from dashed/dotted pens + } + // draw scatter symbol: + if (!mScatterStyle.isNone()) + { + applyScattersAntialiasingHint(painter); + // scale scatter pixmap if it's too large to fit in legend icon rect: + if (mScatterStyle.shape() == QCPScatterStyle::ssPixmap && (mScatterStyle.pixmap().size().width() > rect.width() || mScatterStyle.pixmap().size().height() > rect.height())) + { + QCPScatterStyle scaledStyle(mScatterStyle); + scaledStyle.setPixmap(scaledStyle.pixmap().scaled(rect.size().toSize(), Qt::KeepAspectRatio, Qt::SmoothTransformation)); + scaledStyle.applyTo(painter, mPen); + scaledStyle.drawShape(painter, QRectF(rect).center()); + } else + { + mScatterStyle.applyTo(painter, mPen); + mScatterStyle.drawShape(painter, QRectF(rect).center()); + } + } +} + +/*! \internal + + Draws lines between the points in \a lines, given in pixel coordinates. + + \see drawScatterPlot, getCurveLines +*/ +void QCPCurve::drawCurveLine(QCPPainter *painter, const QVector &lines) const +{ + if (painter->pen().style() != Qt::NoPen && painter->pen().color().alpha() != 0) + { + applyDefaultAntialiasingHint(painter); + drawPolyline(painter, lines); + } +} + +/*! \internal + + Draws scatter symbols at every point passed in \a points, given in pixel coordinates. The + scatters will be drawn with \a painter and have the appearance as specified in \a style. + + \see drawCurveLine, getCurveLines +*/ +void QCPCurve::drawScatterPlot(QCPPainter *painter, const QVector &points, const QCPScatterStyle &style) const +{ + // draw scatter point symbols: + applyScattersAntialiasingHint(painter); + style.applyTo(painter, mPen); + for (int i=0; i *lines, const QCPDataRange &dataRange, double penWidth) const +{ + if (!lines) return; + lines->clear(); + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + + // add margins to rect to compensate for stroke width + const double strokeMargin = qMax(qreal(1.0), qreal(penWidth*0.75)); // stroke radius + 50% safety + const double keyMin = keyAxis->pixelToCoord(keyAxis->coordToPixel(keyAxis->range().lower)-strokeMargin*keyAxis->pixelOrientation()); + const double keyMax = keyAxis->pixelToCoord(keyAxis->coordToPixel(keyAxis->range().upper)+strokeMargin*keyAxis->pixelOrientation()); + const double valueMin = valueAxis->pixelToCoord(valueAxis->coordToPixel(valueAxis->range().lower)-strokeMargin*valueAxis->pixelOrientation()); + const double valueMax = valueAxis->pixelToCoord(valueAxis->coordToPixel(valueAxis->range().upper)+strokeMargin*valueAxis->pixelOrientation()); + QCPCurveDataContainer::const_iterator itBegin = mDataContainer->constBegin(); + QCPCurveDataContainer::const_iterator itEnd = mDataContainer->constEnd(); + mDataContainer->limitIteratorsToDataRange(itBegin, itEnd, dataRange); + if (itBegin == itEnd) + return; + QCPCurveDataContainer::const_iterator it = itBegin; + QCPCurveDataContainer::const_iterator prevIt = itEnd-1; + int prevRegion = getRegion(prevIt->key, prevIt->value, keyMin, valueMax, keyMax, valueMin); + QVector trailingPoints; // points that must be applied after all other points (are generated only when handling first point to get virtual segment between last and first point right) + while (it != itEnd) + { + const int currentRegion = getRegion(it->key, it->value, keyMin, valueMax, keyMax, valueMin); + if (currentRegion != prevRegion) // changed region, possibly need to add some optimized edge points or original points if entering R + { + if (currentRegion != 5) // segment doesn't end in R, so it's a candidate for removal + { + QPointF crossA, crossB; + if (prevRegion == 5) // we're coming from R, so add this point optimized + { + lines->append(getOptimizedPoint(currentRegion, it->key, it->value, prevIt->key, prevIt->value, keyMin, valueMax, keyMax, valueMin)); + // in the situations 5->1/7/9/3 the segment may leave R and directly cross through two outer regions. In these cases we need to add an additional corner point + *lines << getOptimizedCornerPoints(prevRegion, currentRegion, prevIt->key, prevIt->value, it->key, it->value, keyMin, valueMax, keyMax, valueMin); + } else if (mayTraverse(prevRegion, currentRegion) && + getTraverse(prevIt->key, prevIt->value, it->key, it->value, keyMin, valueMax, keyMax, valueMin, crossA, crossB)) + { + // add the two cross points optimized if segment crosses R and if segment isn't virtual zeroth segment between last and first curve point: + QVector beforeTraverseCornerPoints, afterTraverseCornerPoints; + getTraverseCornerPoints(prevRegion, currentRegion, keyMin, valueMax, keyMax, valueMin, beforeTraverseCornerPoints, afterTraverseCornerPoints); + if (it != itBegin) + { + *lines << beforeTraverseCornerPoints; + lines->append(crossA); + lines->append(crossB); + *lines << afterTraverseCornerPoints; + } else + { + lines->append(crossB); + *lines << afterTraverseCornerPoints; + trailingPoints << beforeTraverseCornerPoints << crossA ; + } + } else // doesn't cross R, line is just moving around in outside regions, so only need to add optimized point(s) at the boundary corner(s) + { + *lines << getOptimizedCornerPoints(prevRegion, currentRegion, prevIt->key, prevIt->value, it->key, it->value, keyMin, valueMax, keyMax, valueMin); + } + } else // segment does end in R, so we add previous point optimized and this point at original position + { + if (it == itBegin) // it is first point in curve and prevIt is last one. So save optimized point for adding it to the lineData in the end + trailingPoints << getOptimizedPoint(prevRegion, prevIt->key, prevIt->value, it->key, it->value, keyMin, valueMax, keyMax, valueMin); + else + lines->append(getOptimizedPoint(prevRegion, prevIt->key, prevIt->value, it->key, it->value, keyMin, valueMax, keyMax, valueMin)); + lines->append(coordsToPixels(it->key, it->value)); + } + } else // region didn't change + { + if (currentRegion == 5) // still in R, keep adding original points + { + lines->append(coordsToPixels(it->key, it->value)); + } else // still outside R, no need to add anything + { + // see how this is not doing anything? That's the main optimization... + } + } + prevIt = it; + prevRegion = currentRegion; + ++it; + } + *lines << trailingPoints; +} + +/*! \internal + + Called by \ref draw to generate points in pixel coordinates which represent the scatters of the + curve. If a scatter skip is configured (\ref setScatterSkip), the returned points are accordingly + sparser. + + Scatters that aren't visible in the current axis rect are optimized away. + + \a scatters will be filled with points in pixel coordinates, that can be drawn with \ref + drawScatterPlot. + + \a dataRange specifies the beginning and ending data indices that will be taken into account for + conversion. + + \a scatterWidth specifies the scatter width that will be used to later draw the scatters at pixel + coordinates generated by this function. This is needed here to calculate an accordingly wider + margin around the axis rect when performing the data point reduction. + + \see draw, drawScatterPlot +*/ +void QCPCurve::getScatters(QVector *scatters, const QCPDataRange &dataRange, double scatterWidth) const +{ + if (!scatters) return; + scatters->clear(); + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + + QCPCurveDataContainer::const_iterator begin = mDataContainer->constBegin(); + QCPCurveDataContainer::const_iterator end = mDataContainer->constEnd(); + mDataContainer->limitIteratorsToDataRange(begin, end, dataRange); + if (begin == end) + return; + const int scatterModulo = mScatterSkip+1; + const bool doScatterSkip = mScatterSkip > 0; + int endIndex = end-mDataContainer->constBegin(); + + QCPRange keyRange = keyAxis->range(); + QCPRange valueRange = valueAxis->range(); + // extend range to include width of scatter symbols: + keyRange.lower = keyAxis->pixelToCoord(keyAxis->coordToPixel(keyRange.lower)-scatterWidth*keyAxis->pixelOrientation()); + keyRange.upper = keyAxis->pixelToCoord(keyAxis->coordToPixel(keyRange.upper)+scatterWidth*keyAxis->pixelOrientation()); + valueRange.lower = valueAxis->pixelToCoord(valueAxis->coordToPixel(valueRange.lower)-scatterWidth*valueAxis->pixelOrientation()); + valueRange.upper = valueAxis->pixelToCoord(valueAxis->coordToPixel(valueRange.upper)+scatterWidth*valueAxis->pixelOrientation()); + + QCPCurveDataContainer::const_iterator it = begin; + int itIndex = begin-mDataContainer->constBegin(); + while (doScatterSkip && it != end && itIndex % scatterModulo != 0) // advance begin iterator to first non-skipped scatter + { + ++itIndex; + ++it; + } + if (keyAxis->orientation() == Qt::Vertical) + { + while (it != end) + { + if (!qIsNaN(it->value) && keyRange.contains(it->key) && valueRange.contains(it->value)) + scatters->append(QPointF(valueAxis->coordToPixel(it->value), keyAxis->coordToPixel(it->key))); + + // advance iterator to next (non-skipped) data point: + if (!doScatterSkip) + ++it; + else + { + itIndex += scatterModulo; + if (itIndex < endIndex) // make sure we didn't jump over end + it += scatterModulo; + else + { + it = end; + itIndex = endIndex; + } + } + } + } else + { + while (it != end) + { + if (!qIsNaN(it->value) && keyRange.contains(it->key) && valueRange.contains(it->value)) + scatters->append(QPointF(keyAxis->coordToPixel(it->key), valueAxis->coordToPixel(it->value))); + + // advance iterator to next (non-skipped) data point: + if (!doScatterSkip) + ++it; + else + { + itIndex += scatterModulo; + if (itIndex < endIndex) // make sure we didn't jump over end + it += scatterModulo; + else + { + it = end; + itIndex = endIndex; + } + } + } + } +} + +/*! \internal + + This function is part of the curve optimization algorithm of \ref getCurveLines. + + It returns the region of the given point (\a key, \a value) with respect to a rectangle defined + by \a keyMin, \a keyMax, \a valueMin, and \a valueMax. + + The regions are enumerated from top to bottom (\a valueMin to \a valueMax) and left to right (\a + keyMin to \a keyMax): + + + + + +
147
258
369
+ + With the rectangle being region 5, and the outer regions extending infinitely outwards. In the + curve optimization algorithm, region 5 is considered to be the visible portion of the plot. +*/ +int QCPCurve::getRegion(double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const +{ + if (key < keyMin) // region 123 + { + if (value > valueMax) + return 1; + else if (value < valueMin) + return 3; + else + return 2; + } else if (key > keyMax) // region 789 + { + if (value > valueMax) + return 7; + else if (value < valueMin) + return 9; + else + return 8; + } else // region 456 + { + if (value > valueMax) + return 4; + else if (value < valueMin) + return 6; + else + return 5; + } +} + +/*! \internal + + This function is part of the curve optimization algorithm of \ref getCurveLines. + + This method is used in case the current segment passes from inside the visible rect (region 5, + see \ref getRegion) to any of the outer regions (\a otherRegion). The current segment is given by + the line connecting (\a key, \a value) with (\a otherKey, \a otherValue). + + It returns the intersection point of the segment with the border of region 5. + + For this function it doesn't matter whether (\a key, \a value) is the point inside region 5 or + whether it's (\a otherKey, \a otherValue), i.e. whether the segment is coming from region 5 or + leaving it. It is important though that \a otherRegion correctly identifies the other region not + equal to 5. +*/ +QPointF QCPCurve::getOptimizedPoint(int otherRegion, double otherKey, double otherValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const +{ + // The intersection point interpolation here is done in pixel coordinates, so we don't need to + // differentiate between different axis scale types. Note that the nomenclature + // top/left/bottom/right/min/max is with respect to the rect in plot coordinates, wich may be + // different in pixel coordinates (horz/vert key axes, reversed ranges) + + const double keyMinPx = mKeyAxis->coordToPixel(keyMin); + const double keyMaxPx = mKeyAxis->coordToPixel(keyMax); + const double valueMinPx = mValueAxis->coordToPixel(valueMin); + const double valueMaxPx = mValueAxis->coordToPixel(valueMax); + const double otherValuePx = mValueAxis->coordToPixel(otherValue); + const double valuePx = mValueAxis->coordToPixel(value); + const double otherKeyPx = mKeyAxis->coordToPixel(otherKey); + const double keyPx = mKeyAxis->coordToPixel(key); + double intersectKeyPx = keyMinPx; // initial key just a fail-safe + double intersectValuePx = valueMinPx; // initial value just a fail-safe + switch (otherRegion) + { + case 1: // top and left edge + { + intersectValuePx = valueMaxPx; + intersectKeyPx = otherKeyPx + (keyPx-otherKeyPx)/(valuePx-otherValuePx)*(intersectValuePx-otherValuePx); + if (intersectKeyPx < qMin(keyMinPx, keyMaxPx) || intersectKeyPx > qMax(keyMinPx, keyMaxPx)) // check whether top edge is not intersected, then it must be left edge (qMin/qMax necessary since axes may be reversed) + { + intersectKeyPx = keyMinPx; + intersectValuePx = otherValuePx + (valuePx-otherValuePx)/(keyPx-otherKeyPx)*(intersectKeyPx-otherKeyPx); + } + break; + } + case 2: // left edge + { + intersectKeyPx = keyMinPx; + intersectValuePx = otherValuePx + (valuePx-otherValuePx)/(keyPx-otherKeyPx)*(intersectKeyPx-otherKeyPx); + break; + } + case 3: // bottom and left edge + { + intersectValuePx = valueMinPx; + intersectKeyPx = otherKeyPx + (keyPx-otherKeyPx)/(valuePx-otherValuePx)*(intersectValuePx-otherValuePx); + if (intersectKeyPx < qMin(keyMinPx, keyMaxPx) || intersectKeyPx > qMax(keyMinPx, keyMaxPx)) // check whether bottom edge is not intersected, then it must be left edge (qMin/qMax necessary since axes may be reversed) + { + intersectKeyPx = keyMinPx; + intersectValuePx = otherValuePx + (valuePx-otherValuePx)/(keyPx-otherKeyPx)*(intersectKeyPx-otherKeyPx); + } + break; + } + case 4: // top edge + { + intersectValuePx = valueMaxPx; + intersectKeyPx = otherKeyPx + (keyPx-otherKeyPx)/(valuePx-otherValuePx)*(intersectValuePx-otherValuePx); + break; + } + case 5: + { + break; // case 5 shouldn't happen for this function but we add it anyway to prevent potential discontinuity in branch table + } + case 6: // bottom edge + { + intersectValuePx = valueMinPx; + intersectKeyPx = otherKeyPx + (keyPx-otherKeyPx)/(valuePx-otherValuePx)*(intersectValuePx-otherValuePx); + break; + } + case 7: // top and right edge + { + intersectValuePx = valueMaxPx; + intersectKeyPx = otherKeyPx + (keyPx-otherKeyPx)/(valuePx-otherValuePx)*(intersectValuePx-otherValuePx); + if (intersectKeyPx < qMin(keyMinPx, keyMaxPx) || intersectKeyPx > qMax(keyMinPx, keyMaxPx)) // check whether top edge is not intersected, then it must be right edge (qMin/qMax necessary since axes may be reversed) + { + intersectKeyPx = keyMaxPx; + intersectValuePx = otherValuePx + (valuePx-otherValuePx)/(keyPx-otherKeyPx)*(intersectKeyPx-otherKeyPx); + } + break; + } + case 8: // right edge + { + intersectKeyPx = keyMaxPx; + intersectValuePx = otherValuePx + (valuePx-otherValuePx)/(keyPx-otherKeyPx)*(intersectKeyPx-otherKeyPx); + break; + } + case 9: // bottom and right edge + { + intersectValuePx = valueMinPx; + intersectKeyPx = otherKeyPx + (keyPx-otherKeyPx)/(valuePx-otherValuePx)*(intersectValuePx-otherValuePx); + if (intersectKeyPx < qMin(keyMinPx, keyMaxPx) || intersectKeyPx > qMax(keyMinPx, keyMaxPx)) // check whether bottom edge is not intersected, then it must be right edge (qMin/qMax necessary since axes may be reversed) + { + intersectKeyPx = keyMaxPx; + intersectValuePx = otherValuePx + (valuePx-otherValuePx)/(keyPx-otherKeyPx)*(intersectKeyPx-otherKeyPx); + } + break; + } + } + if (mKeyAxis->orientation() == Qt::Horizontal) + return QPointF(intersectKeyPx, intersectValuePx); + else + return QPointF(intersectValuePx, intersectKeyPx); +} + +/*! \internal + + This function is part of the curve optimization algorithm of \ref getCurveLines. + + In situations where a single segment skips over multiple regions it might become necessary to add + extra points at the corners of region 5 (see \ref getRegion) such that the optimized segment + doesn't unintentionally cut through the visible area of the axis rect and create plot artifacts. + This method provides these points that must be added, assuming the original segment doesn't + start, end, or traverse region 5. (Corner points where region 5 is traversed are calculated by + \ref getTraverseCornerPoints.) + + For example, consider a segment which directly goes from region 4 to 2 but originally is far out + to the top left such that it doesn't cross region 5. Naively optimizing these points by + projecting them on the top and left borders of region 5 will create a segment that surely crosses + 5, creating a visual artifact in the plot. This method prevents this by providing extra points at + the top left corner, making the optimized curve correctly pass from region 4 to 1 to 2 without + traversing 5. +*/ +QVector QCPCurve::getOptimizedCornerPoints(int prevRegion, int currentRegion, double prevKey, double prevValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const +{ + QVector result; + switch (prevRegion) + { + case 1: + { + switch (currentRegion) + { + case 2: { result << coordsToPixels(keyMin, valueMax); break; } + case 4: { result << coordsToPixels(keyMin, valueMax); break; } + case 3: { result << coordsToPixels(keyMin, valueMax) << coordsToPixels(keyMin, valueMin); break; } + case 7: { result << coordsToPixels(keyMin, valueMax) << coordsToPixels(keyMax, valueMax); break; } + case 6: { result << coordsToPixels(keyMin, valueMax) << coordsToPixels(keyMin, valueMin); result.append(result.last()); break; } + case 8: { result << coordsToPixels(keyMin, valueMax) << coordsToPixels(keyMax, valueMax); result.append(result.last()); break; } + case 9: { // in this case we need another distinction of cases: segment may pass below or above rect, requiring either bottom right or top left corner points + if ((value-prevValue)/(key-prevKey)*(keyMin-key)+value < valueMin) // segment passes below R + { result << coordsToPixels(keyMin, valueMax) << coordsToPixels(keyMin, valueMin); result.append(result.last()); result << coordsToPixels(keyMax, valueMin); } + else + { result << coordsToPixels(keyMin, valueMax) << coordsToPixels(keyMax, valueMax); result.append(result.last()); result << coordsToPixels(keyMax, valueMin); } + break; + } + } + break; + } + case 2: + { + switch (currentRegion) + { + case 1: { result << coordsToPixels(keyMin, valueMax); break; } + case 3: { result << coordsToPixels(keyMin, valueMin); break; } + case 4: { result << coordsToPixels(keyMin, valueMax); result.append(result.last()); break; } + case 6: { result << coordsToPixels(keyMin, valueMin); result.append(result.last()); break; } + case 7: { result << coordsToPixels(keyMin, valueMax); result.append(result.last()); result << coordsToPixels(keyMax, valueMax); break; } + case 9: { result << coordsToPixels(keyMin, valueMin); result.append(result.last()); result << coordsToPixels(keyMax, valueMin); break; } + } + break; + } + case 3: + { + switch (currentRegion) + { + case 2: { result << coordsToPixels(keyMin, valueMin); break; } + case 6: { result << coordsToPixels(keyMin, valueMin); break; } + case 1: { result << coordsToPixels(keyMin, valueMin) << coordsToPixels(keyMin, valueMax); break; } + case 9: { result << coordsToPixels(keyMin, valueMin) << coordsToPixels(keyMax, valueMin); break; } + case 4: { result << coordsToPixels(keyMin, valueMin) << coordsToPixels(keyMin, valueMax); result.append(result.last()); break; } + case 8: { result << coordsToPixels(keyMin, valueMin) << coordsToPixels(keyMax, valueMin); result.append(result.last()); break; } + case 7: { // in this case we need another distinction of cases: segment may pass below or above rect, requiring either bottom right or top left corner points + if ((value-prevValue)/(key-prevKey)*(keyMax-key)+value < valueMin) // segment passes below R + { result << coordsToPixels(keyMin, valueMin) << coordsToPixels(keyMax, valueMin); result.append(result.last()); result << coordsToPixels(keyMax, valueMax); } + else + { result << coordsToPixels(keyMin, valueMin) << coordsToPixels(keyMin, valueMax); result.append(result.last()); result << coordsToPixels(keyMax, valueMax); } + break; + } + } + break; + } + case 4: + { + switch (currentRegion) + { + case 1: { result << coordsToPixels(keyMin, valueMax); break; } + case 7: { result << coordsToPixels(keyMax, valueMax); break; } + case 2: { result << coordsToPixels(keyMin, valueMax); result.append(result.last()); break; } + case 8: { result << coordsToPixels(keyMax, valueMax); result.append(result.last()); break; } + case 3: { result << coordsToPixels(keyMin, valueMax); result.append(result.last()); result << coordsToPixels(keyMin, valueMin); break; } + case 9: { result << coordsToPixels(keyMax, valueMax); result.append(result.last()); result << coordsToPixels(keyMax, valueMin); break; } + } + break; + } + case 5: + { + switch (currentRegion) + { + case 1: { result << coordsToPixels(keyMin, valueMax); break; } + case 7: { result << coordsToPixels(keyMax, valueMax); break; } + case 9: { result << coordsToPixels(keyMax, valueMin); break; } + case 3: { result << coordsToPixels(keyMin, valueMin); break; } + } + break; + } + case 6: + { + switch (currentRegion) + { + case 3: { result << coordsToPixels(keyMin, valueMin); break; } + case 9: { result << coordsToPixels(keyMax, valueMin); break; } + case 2: { result << coordsToPixels(keyMin, valueMin); result.append(result.last()); break; } + case 8: { result << coordsToPixels(keyMax, valueMin); result.append(result.last()); break; } + case 1: { result << coordsToPixels(keyMin, valueMin); result.append(result.last()); result << coordsToPixels(keyMin, valueMax); break; } + case 7: { result << coordsToPixels(keyMax, valueMin); result.append(result.last()); result << coordsToPixels(keyMax, valueMax); break; } + } + break; + } + case 7: + { + switch (currentRegion) + { + case 4: { result << coordsToPixels(keyMax, valueMax); break; } + case 8: { result << coordsToPixels(keyMax, valueMax); break; } + case 1: { result << coordsToPixels(keyMax, valueMax) << coordsToPixels(keyMin, valueMax); break; } + case 9: { result << coordsToPixels(keyMax, valueMax) << coordsToPixels(keyMax, valueMin); break; } + case 2: { result << coordsToPixels(keyMax, valueMax) << coordsToPixels(keyMin, valueMax); result.append(result.last()); break; } + case 6: { result << coordsToPixels(keyMax, valueMax) << coordsToPixels(keyMax, valueMin); result.append(result.last()); break; } + case 3: { // in this case we need another distinction of cases: segment may pass below or above rect, requiring either bottom right or top left corner points + if ((value-prevValue)/(key-prevKey)*(keyMax-key)+value < valueMin) // segment passes below R + { result << coordsToPixels(keyMax, valueMax) << coordsToPixels(keyMax, valueMin); result.append(result.last()); result << coordsToPixels(keyMin, valueMin); } + else + { result << coordsToPixels(keyMax, valueMax) << coordsToPixels(keyMin, valueMax); result.append(result.last()); result << coordsToPixels(keyMin, valueMin); } + break; + } + } + break; + } + case 8: + { + switch (currentRegion) + { + case 7: { result << coordsToPixels(keyMax, valueMax); break; } + case 9: { result << coordsToPixels(keyMax, valueMin); break; } + case 4: { result << coordsToPixels(keyMax, valueMax); result.append(result.last()); break; } + case 6: { result << coordsToPixels(keyMax, valueMin); result.append(result.last()); break; } + case 1: { result << coordsToPixels(keyMax, valueMax); result.append(result.last()); result << coordsToPixels(keyMin, valueMax); break; } + case 3: { result << coordsToPixels(keyMax, valueMin); result.append(result.last()); result << coordsToPixels(keyMin, valueMin); break; } + } + break; + } + case 9: + { + switch (currentRegion) + { + case 6: { result << coordsToPixels(keyMax, valueMin); break; } + case 8: { result << coordsToPixels(keyMax, valueMin); break; } + case 3: { result << coordsToPixels(keyMax, valueMin) << coordsToPixels(keyMin, valueMin); break; } + case 7: { result << coordsToPixels(keyMax, valueMin) << coordsToPixels(keyMax, valueMax); break; } + case 2: { result << coordsToPixels(keyMax, valueMin) << coordsToPixels(keyMin, valueMin); result.append(result.last()); break; } + case 4: { result << coordsToPixels(keyMax, valueMin) << coordsToPixels(keyMax, valueMax); result.append(result.last()); break; } + case 1: { // in this case we need another distinction of cases: segment may pass below or above rect, requiring either bottom right or top left corner points + if ((value-prevValue)/(key-prevKey)*(keyMin-key)+value < valueMin) // segment passes below R + { result << coordsToPixels(keyMax, valueMin) << coordsToPixels(keyMin, valueMin); result.append(result.last()); result << coordsToPixels(keyMin, valueMax); } + else + { result << coordsToPixels(keyMax, valueMin) << coordsToPixels(keyMax, valueMax); result.append(result.last()); result << coordsToPixels(keyMin, valueMax); } + break; + } + } + break; + } + } + return result; +} + +/*! \internal + + This function is part of the curve optimization algorithm of \ref getCurveLines. + + This method returns whether a segment going from \a prevRegion to \a currentRegion (see \ref + getRegion) may traverse the visible region 5. This function assumes that neither \a prevRegion + nor \a currentRegion is 5 itself. + + If this method returns false, the segment for sure doesn't pass region 5. If it returns true, the + segment may or may not pass region 5 and a more fine-grained calculation must be used (\ref + getTraverse). +*/ +bool QCPCurve::mayTraverse(int prevRegion, int currentRegion) const +{ + switch (prevRegion) + { + case 1: + { + switch (currentRegion) + { + case 4: + case 7: + case 2: + case 3: return false; + default: return true; + } + } + case 2: + { + switch (currentRegion) + { + case 1: + case 3: return false; + default: return true; + } + } + case 3: + { + switch (currentRegion) + { + case 1: + case 2: + case 6: + case 9: return false; + default: return true; + } + } + case 4: + { + switch (currentRegion) + { + case 1: + case 7: return false; + default: return true; + } + } + case 5: return false; // should never occur + case 6: + { + switch (currentRegion) + { + case 3: + case 9: return false; + default: return true; + } + } + case 7: + { + switch (currentRegion) + { + case 1: + case 4: + case 8: + case 9: return false; + default: return true; + } + } + case 8: + { + switch (currentRegion) + { + case 7: + case 9: return false; + default: return true; + } + } + case 9: + { + switch (currentRegion) + { + case 3: + case 6: + case 8: + case 7: return false; + default: return true; + } + } + default: return true; + } +} + + +/*! \internal + + This function is part of the curve optimization algorithm of \ref getCurveLines. + + This method assumes that the \ref mayTraverse test has returned true, so there is a chance the + segment defined by (\a prevKey, \a prevValue) and (\a key, \a value) goes through the visible + region 5. + + The return value of this method indicates whether the segment actually traverses region 5 or not. + + If the segment traverses 5, the output parameters \a crossA and \a crossB indicate the entry and + exit points of region 5. They will become the optimized points for that segment. +*/ +bool QCPCurve::getTraverse(double prevKey, double prevValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin, QPointF &crossA, QPointF &crossB) const +{ + // The intersection point interpolation here is done in pixel coordinates, so we don't need to + // differentiate between different axis scale types. Note that the nomenclature + // top/left/bottom/right/min/max is with respect to the rect in plot coordinates, wich may be + // different in pixel coordinates (horz/vert key axes, reversed ranges) + + QList intersections; + const double valueMinPx = mValueAxis->coordToPixel(valueMin); + const double valueMaxPx = mValueAxis->coordToPixel(valueMax); + const double keyMinPx = mKeyAxis->coordToPixel(keyMin); + const double keyMaxPx = mKeyAxis->coordToPixel(keyMax); + const double keyPx = mKeyAxis->coordToPixel(key); + const double valuePx = mValueAxis->coordToPixel(value); + const double prevKeyPx = mKeyAxis->coordToPixel(prevKey); + const double prevValuePx = mValueAxis->coordToPixel(prevValue); + if (qFuzzyIsNull(key-prevKey)) // line is parallel to value axis + { + // due to region filter in mayTraverse(), if line is parallel to value or key axis, region 5 is traversed here + intersections.append(mKeyAxis->orientation() == Qt::Horizontal ? QPointF(keyPx, valueMinPx) : QPointF(valueMinPx, keyPx)); // direction will be taken care of at end of method + intersections.append(mKeyAxis->orientation() == Qt::Horizontal ? QPointF(keyPx, valueMaxPx) : QPointF(valueMaxPx, keyPx)); + } else if (qFuzzyIsNull(value-prevValue)) // line is parallel to key axis + { + // due to region filter in mayTraverse(), if line is parallel to value or key axis, region 5 is traversed here + intersections.append(mKeyAxis->orientation() == Qt::Horizontal ? QPointF(keyMinPx, valuePx) : QPointF(valuePx, keyMinPx)); // direction will be taken care of at end of method + intersections.append(mKeyAxis->orientation() == Qt::Horizontal ? QPointF(keyMaxPx, valuePx) : QPointF(valuePx, keyMaxPx)); + } else // line is skewed + { + double gamma; + double keyPerValuePx = (keyPx-prevKeyPx)/(valuePx-prevValuePx); + // check top of rect: + gamma = prevKeyPx + (valueMaxPx-prevValuePx)*keyPerValuePx; + if (gamma >= qMin(keyMinPx, keyMaxPx) && gamma <= qMax(keyMinPx, keyMaxPx)) // qMin/qMax necessary since axes may be reversed + intersections.append(mKeyAxis->orientation() == Qt::Horizontal ? QPointF(gamma, valueMaxPx) : QPointF(valueMaxPx, gamma)); + // check bottom of rect: + gamma = prevKeyPx + (valueMinPx-prevValuePx)*keyPerValuePx; + if (gamma >= qMin(keyMinPx, keyMaxPx) && gamma <= qMax(keyMinPx, keyMaxPx)) // qMin/qMax necessary since axes may be reversed + intersections.append(mKeyAxis->orientation() == Qt::Horizontal ? QPointF(gamma, valueMinPx) : QPointF(valueMinPx, gamma)); + const double valuePerKeyPx = 1.0/keyPerValuePx; + // check left of rect: + gamma = prevValuePx + (keyMinPx-prevKeyPx)*valuePerKeyPx; + if (gamma >= qMin(valueMinPx, valueMaxPx) && gamma <= qMax(valueMinPx, valueMaxPx)) // qMin/qMax necessary since axes may be reversed + intersections.append(mKeyAxis->orientation() == Qt::Horizontal ? QPointF(keyMinPx, gamma) : QPointF(gamma, keyMinPx)); + // check right of rect: + gamma = prevValuePx + (keyMaxPx-prevKeyPx)*valuePerKeyPx; + if (gamma >= qMin(valueMinPx, valueMaxPx) && gamma <= qMax(valueMinPx, valueMaxPx)) // qMin/qMax necessary since axes may be reversed + intersections.append(mKeyAxis->orientation() == Qt::Horizontal ? QPointF(keyMaxPx, gamma) : QPointF(gamma, keyMaxPx)); + } + + // handle cases where found points isn't exactly 2: + if (intersections.size() > 2) + { + // line probably goes through corner of rect, and we got duplicate points there. single out the point pair with greatest distance in between: + double distSqrMax = 0; + QPointF pv1, pv2; + for (int i=0; i distSqrMax) + { + pv1 = intersections.at(i); + pv2 = intersections.at(k); + distSqrMax = distSqr; + } + } + } + intersections = QList() << pv1 << pv2; + } else if (intersections.size() != 2) + { + // one or even zero points found (shouldn't happen unless line perfectly tangent to corner), no need to draw segment + return false; + } + + // possibly re-sort points so optimized point segment has same direction as original segment: + double xDelta = keyPx-prevKeyPx; + double yDelta = valuePx-prevValuePx; + if (mKeyAxis->orientation() != Qt::Horizontal) + qSwap(xDelta, yDelta); + if (xDelta*(intersections.at(1).x()-intersections.at(0).x()) + yDelta*(intersections.at(1).y()-intersections.at(0).y()) < 0) // scalar product of both segments < 0 -> opposite direction + intersections.move(0, 1); + crossA = intersections.at(0); + crossB = intersections.at(1); + return true; +} + +/*! \internal + + This function is part of the curve optimization algorithm of \ref getCurveLines. + + This method assumes that the \ref getTraverse test has returned true, so the segment definitely + traverses the visible region 5 when going from \a prevRegion to \a currentRegion. + + In certain situations it is not sufficient to merely generate the entry and exit points of the + segment into/out of region 5, as \ref getTraverse provides. It may happen that a single segment, in + addition to traversing region 5, skips another region outside of region 5, which makes it + necessary to add an optimized corner point there (very similar to the job \ref + getOptimizedCornerPoints does for segments that are completely in outside regions and don't + traverse 5). + + As an example, consider a segment going from region 1 to region 6, traversing the lower left + corner of region 5. In this configuration, the segment additionally crosses the border between + region 1 and 2 before entering region 5. This makes it necessary to add an additional point in + the top left corner, before adding the optimized traverse points. So in this case, the output + parameter \a beforeTraverse will contain the top left corner point, and \a afterTraverse will be + empty. + + In some cases, such as when going from region 1 to 9, it may even be necessary to add additional + corner points before and after the traverse. Then both \a beforeTraverse and \a afterTraverse + return the respective corner points. +*/ +void QCPCurve::getTraverseCornerPoints(int prevRegion, int currentRegion, double keyMin, double valueMax, double keyMax, double valueMin, QVector &beforeTraverse, QVector &afterTraverse) const +{ + switch (prevRegion) + { + case 1: + { + switch (currentRegion) + { + case 6: { beforeTraverse << coordsToPixels(keyMin, valueMax); break; } + case 9: { beforeTraverse << coordsToPixels(keyMin, valueMax); afterTraverse << coordsToPixels(keyMax, valueMin); break; } + case 8: { beforeTraverse << coordsToPixels(keyMin, valueMax); break; } + } + break; + } + case 2: + { + switch (currentRegion) + { + case 7: { afterTraverse << coordsToPixels(keyMax, valueMax); break; } + case 9: { afterTraverse << coordsToPixels(keyMax, valueMin); break; } + } + break; + } + case 3: + { + switch (currentRegion) + { + case 4: { beforeTraverse << coordsToPixels(keyMin, valueMin); break; } + case 7: { beforeTraverse << coordsToPixels(keyMin, valueMin); afterTraverse << coordsToPixels(keyMax, valueMax); break; } + case 8: { beforeTraverse << coordsToPixels(keyMin, valueMin); break; } + } + break; + } + case 4: + { + switch (currentRegion) + { + case 3: { afterTraverse << coordsToPixels(keyMin, valueMin); break; } + case 9: { afterTraverse << coordsToPixels(keyMax, valueMin); break; } + } + break; + } + case 5: { break; } // shouldn't happen because this method only handles full traverses + case 6: + { + switch (currentRegion) + { + case 1: { afterTraverse << coordsToPixels(keyMin, valueMax); break; } + case 7: { afterTraverse << coordsToPixels(keyMax, valueMax); break; } + } + break; + } + case 7: + { + switch (currentRegion) + { + case 2: { beforeTraverse << coordsToPixels(keyMax, valueMax); break; } + case 3: { beforeTraverse << coordsToPixels(keyMax, valueMax); afterTraverse << coordsToPixels(keyMin, valueMin); break; } + case 6: { beforeTraverse << coordsToPixels(keyMax, valueMax); break; } + } + break; + } + case 8: + { + switch (currentRegion) + { + case 1: { afterTraverse << coordsToPixels(keyMin, valueMax); break; } + case 3: { afterTraverse << coordsToPixels(keyMin, valueMin); break; } + } + break; + } + case 9: + { + switch (currentRegion) + { + case 2: { beforeTraverse << coordsToPixels(keyMax, valueMin); break; } + case 1: { beforeTraverse << coordsToPixels(keyMax, valueMin); afterTraverse << coordsToPixels(keyMin, valueMax); break; } + case 4: { beforeTraverse << coordsToPixels(keyMax, valueMin); break; } + } + break; + } + } +} + +/*! \internal + + Calculates the (minimum) distance (in pixels) the curve's representation has from the given \a + pixelPoint in pixels. This is used to determine whether the curve was clicked or not, e.g. in + \ref selectTest. The closest data point to \a pixelPoint is returned in \a closestData. Note that + if the curve has a line representation, the returned distance may be smaller than the distance to + the \a closestData point, since the distance to the curve line is also taken into account. + + If either the curve has no data or if the line style is \ref lsNone and the scatter style's shape + is \ref QCPScatterStyle::ssNone (i.e. there is no visual representation of the curve), returns + -1.0. +*/ +double QCPCurve::pointDistance(const QPointF &pixelPoint, QCPCurveDataContainer::const_iterator &closestData) const +{ + closestData = mDataContainer->constEnd(); + if (mDataContainer->isEmpty()) + return -1.0; + if (mLineStyle == lsNone && mScatterStyle.isNone()) + return -1.0; + + if (mDataContainer->size() == 1) + { + QPointF dataPoint = coordsToPixels(mDataContainer->constBegin()->key, mDataContainer->constBegin()->value); + closestData = mDataContainer->constBegin(); + return QCPVector2D(dataPoint-pixelPoint).length(); + } + + // calculate minimum distances to curve data points and find closestData iterator: + double minDistSqr = (std::numeric_limits::max)(); + // iterate over found data points and then choose the one with the shortest distance to pos: + QCPCurveDataContainer::const_iterator begin = mDataContainer->constBegin(); + QCPCurveDataContainer::const_iterator end = mDataContainer->constEnd(); + for (QCPCurveDataContainer::const_iterator it=begin; it!=end; ++it) + { + const double currentDistSqr = QCPVector2D(coordsToPixels(it->key, it->value)-pixelPoint).lengthSquared(); + if (currentDistSqr < minDistSqr) + { + minDistSqr = currentDistSqr; + closestData = it; + } + } + + // calculate distance to line if there is one (if so, will probably be smaller than distance to closest data point): + if (mLineStyle != lsNone) + { + QVector lines; + getCurveLines(&lines, QCPDataRange(0, dataCount()), mParentPlot->selectionTolerance()*1.2); // optimized lines outside axis rect shouldn't respond to clicks at the edge, so use 1.2*tolerance as pen width + for (int i=0; i QCPBarsGroup::bars() const + + Returns all bars currently in this group. + + \see bars(int index) +*/ + +/*! \fn int QCPBarsGroup::size() const + + Returns the number of QCPBars plottables that are part of this group. + +*/ + +/*! \fn bool QCPBarsGroup::isEmpty() const + + Returns whether this bars group is empty. + + \see size +*/ + +/*! \fn bool QCPBarsGroup::contains(QCPBars *bars) + + Returns whether the specified \a bars plottable is part of this group. + +*/ + +/* end of documentation of inline functions */ + +/*! + Constructs a new bars group for the specified QCustomPlot instance. +*/ +QCPBarsGroup::QCPBarsGroup(QCustomPlot *parentPlot) : + QObject(parentPlot), + mParentPlot(parentPlot), + mSpacingType(stAbsolute), + mSpacing(4) +{ +} + +QCPBarsGroup::~QCPBarsGroup() +{ + clear(); +} + +/*! + Sets how the spacing between adjacent bars is interpreted. See \ref SpacingType. + + The actual spacing can then be specified with \ref setSpacing. + + \see setSpacing +*/ +void QCPBarsGroup::setSpacingType(SpacingType spacingType) +{ + mSpacingType = spacingType; +} + +/*! + Sets the spacing between adjacent bars. What the number passed as \a spacing actually means, is + defined by the current \ref SpacingType, which can be set with \ref setSpacingType. + + \see setSpacingType +*/ +void QCPBarsGroup::setSpacing(double spacing) +{ + mSpacing = spacing; +} + +/*! + Returns the QCPBars instance with the specified \a index in this group. If no such QCPBars + exists, returns 0. + + \see bars(), size +*/ +QCPBars *QCPBarsGroup::bars(int index) const +{ + if (index >= 0 && index < mBars.size()) + { + return mBars.at(index); + } else + { + qDebug() << Q_FUNC_INFO << "index out of bounds:" << index; + return 0; + } +} + +/*! + Removes all QCPBars plottables from this group. + + \see isEmpty +*/ +void QCPBarsGroup::clear() +{ + foreach (QCPBars *bars, mBars) // since foreach takes a copy, removing bars in the loop is okay + bars->setBarsGroup(0); // removes itself via removeBars +} + +/*! + Adds the specified \a bars plottable to this group. Alternatively, you can also use \ref + QCPBars::setBarsGroup on the \a bars instance. + + \see insert, remove +*/ +void QCPBarsGroup::append(QCPBars *bars) +{ + if (!bars) + { + qDebug() << Q_FUNC_INFO << "bars is 0"; + return; + } + + if (!mBars.contains(bars)) + bars->setBarsGroup(this); + else + qDebug() << Q_FUNC_INFO << "bars plottable is already in this bars group:" << reinterpret_cast(bars); +} + +/*! + Inserts the specified \a bars plottable into this group at the specified index position \a i. + This gives you full control over the ordering of the bars. + + \a bars may already be part of this group. In that case, \a bars is just moved to the new index + position. + + \see append, remove +*/ +void QCPBarsGroup::insert(int i, QCPBars *bars) +{ + if (!bars) + { + qDebug() << Q_FUNC_INFO << "bars is 0"; + return; + } + + // first append to bars list normally: + if (!mBars.contains(bars)) + bars->setBarsGroup(this); + // then move to according position: + mBars.move(mBars.indexOf(bars), qBound(0, i, mBars.size()-1)); +} + +/*! + Removes the specified \a bars plottable from this group. + + \see contains, clear +*/ +void QCPBarsGroup::remove(QCPBars *bars) +{ + if (!bars) + { + qDebug() << Q_FUNC_INFO << "bars is 0"; + return; + } + + if (mBars.contains(bars)) + bars->setBarsGroup(0); + else + qDebug() << Q_FUNC_INFO << "bars plottable is not in this bars group:" << reinterpret_cast(bars); +} + +/*! \internal + + Adds the specified \a bars to the internal mBars list of bars. This method does not change the + barsGroup property on \a bars. + + \see unregisterBars +*/ +void QCPBarsGroup::registerBars(QCPBars *bars) +{ + if (!mBars.contains(bars)) + mBars.append(bars); +} + +/*! \internal + + Removes the specified \a bars from the internal mBars list of bars. This method does not change + the barsGroup property on \a bars. + + \see registerBars +*/ +void QCPBarsGroup::unregisterBars(QCPBars *bars) +{ + mBars.removeOne(bars); +} + +/*! \internal + + Returns the pixel offset in the key dimension the specified \a bars plottable should have at the + given key coordinate \a keyCoord. The offset is relative to the pixel position of the key + coordinate \a keyCoord. +*/ +double QCPBarsGroup::keyPixelOffset(const QCPBars *bars, double keyCoord) +{ + // find list of all base bars in case some mBars are stacked: + QList baseBars; + foreach (const QCPBars *b, mBars) + { + while (b->barBelow()) + b = b->barBelow(); + if (!baseBars.contains(b)) + baseBars.append(b); + } + // find base bar this "bars" is stacked on: + const QCPBars *thisBase = bars; + while (thisBase->barBelow()) + thisBase = thisBase->barBelow(); + + // determine key pixel offset of this base bars considering all other base bars in this barsgroup: + double result = 0; + int index = baseBars.indexOf(thisBase); + if (index >= 0) + { + if (baseBars.size() % 2 == 1 && index == (baseBars.size()-1)/2) // is center bar (int division on purpose) + { + return result; + } else + { + double lowerPixelWidth, upperPixelWidth; + int startIndex; + int dir = (index <= (baseBars.size()-1)/2) ? -1 : 1; // if bar is to lower keys of center, dir is negative + if (baseBars.size() % 2 == 0) // even number of bars + { + startIndex = baseBars.size()/2 + (dir < 0 ? -1 : 0); + result += getPixelSpacing(baseBars.at(startIndex), keyCoord)*0.5; // half of middle spacing + } else // uneven number of bars + { + startIndex = (baseBars.size()-1)/2+dir; + baseBars.at((baseBars.size()-1)/2)->getPixelWidth(keyCoord, lowerPixelWidth, upperPixelWidth); + result += qAbs(upperPixelWidth-lowerPixelWidth)*0.5; // half of center bar + result += getPixelSpacing(baseBars.at((baseBars.size()-1)/2), keyCoord); // center bar spacing + } + for (int i = startIndex; i != index; i += dir) // add widths and spacings of bars in between center and our bars + { + baseBars.at(i)->getPixelWidth(keyCoord, lowerPixelWidth, upperPixelWidth); + result += qAbs(upperPixelWidth-lowerPixelWidth); + result += getPixelSpacing(baseBars.at(i), keyCoord); + } + // finally half of our bars width: + baseBars.at(index)->getPixelWidth(keyCoord, lowerPixelWidth, upperPixelWidth); + result += qAbs(upperPixelWidth-lowerPixelWidth)*0.5; + // correct sign of result depending on orientation and direction of key axis: + result *= dir*thisBase->keyAxis()->pixelOrientation(); + } + } + return result; +} + +/*! \internal + + Returns the spacing in pixels which is between this \a bars and the following one, both at the + key coordinate \a keyCoord. + + \note Typically the returned value doesn't depend on \a bars or \a keyCoord. \a bars is only + needed to get access to the key axis transformation and axis rect for the modes \ref + stAxisRectRatio and \ref stPlotCoords. The \a keyCoord is only relevant for spacings given in + \ref stPlotCoords on a logarithmic axis. +*/ +double QCPBarsGroup::getPixelSpacing(const QCPBars *bars, double keyCoord) +{ + switch (mSpacingType) + { + case stAbsolute: + { + return mSpacing; + } + case stAxisRectRatio: + { + if (bars->keyAxis()->orientation() == Qt::Horizontal) + return bars->keyAxis()->axisRect()->width()*mSpacing; + else + return bars->keyAxis()->axisRect()->height()*mSpacing; + } + case stPlotCoords: + { + double keyPixel = bars->keyAxis()->coordToPixel(keyCoord); + return qAbs(bars->keyAxis()->coordToPixel(keyCoord+mSpacing)-keyPixel); + } + } + return 0; +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPBarsData +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPBarsData + \brief Holds the data of one single data point (one bar) for QCPBars. + + The stored data is: + \li \a key: coordinate on the key axis of this bar (this is the \a mainKey and the \a sortKey) + \li \a value: height coordinate on the value axis of this bar (this is the \a mainValue) + + The container for storing multiple data points is \ref QCPBarsDataContainer. It is a typedef for + \ref QCPDataContainer with \ref QCPBarsData as the DataType template parameter. See the + documentation there for an explanation regarding the data type's generic methods. + + \see QCPBarsDataContainer +*/ + +/* start documentation of inline functions */ + +/*! \fn double QCPBarsData::sortKey() const + + Returns the \a key member of this data point. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn static QCPBarsData QCPBarsData::fromSortKey(double sortKey) + + Returns a data point with the specified \a sortKey. All other members are set to zero. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn static static bool QCPBarsData::sortKeyIsMainKey() + + Since the member \a key is both the data point key coordinate and the data ordering parameter, + this method returns true. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn double QCPBarsData::mainKey() const + + Returns the \a key member of this data point. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn double QCPBarsData::mainValue() const + + Returns the \a value member of this data point. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn QCPRange QCPBarsData::valueRange() const + + Returns a QCPRange with both lower and upper boundary set to \a value of this data point. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/* end documentation of inline functions */ + +/*! + Constructs a bar data point with key and value set to zero. +*/ +QCPBarsData::QCPBarsData() : + key(0), + value(0) +{ +} + +/*! + Constructs a bar data point with the specified \a key and \a value. +*/ +QCPBarsData::QCPBarsData(double key, double value) : + key(key), + value(value) +{ +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPBars +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPBars + \brief A plottable representing a bar chart in a plot. + + \image html QCPBars.png + + To plot data, assign it with the \ref setData or \ref addData functions. + + \section qcpbars-appearance Changing the appearance + + The appearance of the bars is determined by the pen and the brush (\ref setPen, \ref setBrush). + The width of the individual bars can be controlled with \ref setWidthType and \ref setWidth. + + Bar charts are stackable. This means, two QCPBars plottables can be placed on top of each other + (see \ref QCPBars::moveAbove). So when two bars are at the same key position, they will appear + stacked. + + If you would like to group multiple QCPBars plottables together so they appear side by side as + shown below, use QCPBarsGroup. + + \image html QCPBarsGroup.png + + \section qcpbars-usage Usage + + Like all data representing objects in QCustomPlot, the QCPBars is a plottable + (QCPAbstractPlottable). So the plottable-interface of QCustomPlot applies + (QCustomPlot::plottable, QCustomPlot::removePlottable, etc.) + + Usually, you first create an instance: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpbars-creation-1 + which registers it with the QCustomPlot instance of the passed axes. Note that this QCustomPlot instance takes + ownership of the plottable, so do not delete it manually but use QCustomPlot::removePlottable() instead. + The newly created plottable can be modified, e.g.: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpbars-creation-2 +*/ + +/* start of documentation of inline functions */ + +/*! \fn QSharedPointer QCPBars::data() const + + Returns a shared pointer to the internal data storage of type \ref QCPBarsDataContainer. You may + use it to directly manipulate the data, which may be more convenient and faster than using the + regular \ref setData or \ref addData methods. +*/ + +/*! \fn QCPBars *QCPBars::barBelow() const + Returns the bars plottable that is directly below this bars plottable. + If there is no such plottable, returns 0. + + \see barAbove, moveBelow, moveAbove +*/ + +/*! \fn QCPBars *QCPBars::barAbove() const + Returns the bars plottable that is directly above this bars plottable. + If there is no such plottable, returns 0. + + \see barBelow, moveBelow, moveAbove +*/ + +/* end of documentation of inline functions */ + +/*! + Constructs a bar chart which uses \a keyAxis as its key axis ("x") and \a valueAxis as its value + axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance and not have + the same orientation. If either of these restrictions is violated, a corresponding message is + printed to the debug output (qDebug), the construction is not aborted, though. + + The created QCPBars is automatically registered with the QCustomPlot instance inferred from \a + keyAxis. This QCustomPlot instance takes ownership of the QCPBars, so do not delete it manually + but use QCustomPlot::removePlottable() instead. +*/ +QCPBars::QCPBars(QCPAxis *keyAxis, QCPAxis *valueAxis) : + QCPAbstractPlottable1D(keyAxis, valueAxis), + mWidth(0.75), + mWidthType(wtPlotCoords), + mBarsGroup(0), + mBaseValue(0), + mStackingGap(0) +{ + // modify inherited properties from abstract plottable: + mPen.setColor(Qt::blue); + mPen.setStyle(Qt::SolidLine); + mBrush.setColor(QColor(40, 50, 255, 30)); + mBrush.setStyle(Qt::SolidPattern); + mSelectionDecorator->setBrush(QBrush(QColor(160, 160, 255))); +} + +QCPBars::~QCPBars() +{ + setBarsGroup(0); + if (mBarBelow || mBarAbove) + connectBars(mBarBelow.data(), mBarAbove.data()); // take this bar out of any stacking +} + +/*! \overload + + Replaces the current data container with the provided \a data container. + + Since a QSharedPointer is used, multiple QCPBars may share the same data container safely. + Modifying the data in the container will then affect all bars that share the container. Sharing + can be achieved by simply exchanging the data containers wrapped in shared pointers: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpbars-datasharing-1 + + If you do not wish to share containers, but create a copy from an existing container, rather use + the \ref QCPDataContainer::set method on the bar's data container directly: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpbars-datasharing-2 + + \see addData +*/ +void QCPBars::setData(QSharedPointer data) +{ + mDataContainer = data; +} + +/*! \overload + + Replaces the current data with the provided points in \a keys and \a values. The provided + vectors should have equal length. Else, the number of added points will be the size of the + smallest vector. + + If you can guarantee that the passed data points are sorted by \a keys in ascending order, you + can set \a alreadySorted to true, to improve performance by saving a sorting run. + + \see addData +*/ +void QCPBars::setData(const QVector &keys, const QVector &values, bool alreadySorted) +{ + mDataContainer->clear(); + addData(keys, values, alreadySorted); +} + +/*! + Sets the width of the bars. + + How the number passed as \a width is interpreted (e.g. screen pixels, plot coordinates,...), + depends on the currently set width type, see \ref setWidthType and \ref WidthType. +*/ +void QCPBars::setWidth(double width) +{ + mWidth = width; +} + +/*! + Sets how the width of the bars is defined. See the documentation of \ref WidthType for an + explanation of the possible values for \a widthType. + + The default value is \ref wtPlotCoords. + + \see setWidth +*/ +void QCPBars::setWidthType(QCPBars::WidthType widthType) +{ + mWidthType = widthType; +} + +/*! + Sets to which QCPBarsGroup this QCPBars instance belongs to. Alternatively, you can also use \ref + QCPBarsGroup::append. + + To remove this QCPBars from any group, set \a barsGroup to 0. +*/ +void QCPBars::setBarsGroup(QCPBarsGroup *barsGroup) +{ + // deregister at old group: + if (mBarsGroup) + mBarsGroup->unregisterBars(this); + mBarsGroup = barsGroup; + // register at new group: + if (mBarsGroup) + mBarsGroup->registerBars(this); +} + +/*! + Sets the base value of this bars plottable. + + The base value defines where on the value coordinate the bars start. How far the bars extend from + the base value is given by their individual value data. For example, if the base value is set to + 1, a bar with data value 2 will have its lowest point at value coordinate 1 and highest point at + 3. + + For stacked bars, only the base value of the bottom-most QCPBars has meaning. + + The default base value is 0. +*/ +void QCPBars::setBaseValue(double baseValue) +{ + mBaseValue = baseValue; +} + +/*! + If this bars plottable is stacked on top of another bars plottable (\ref moveAbove), this method + allows specifying a distance in \a pixels, by which the drawn bar rectangles will be separated by + the bars below it. +*/ +void QCPBars::setStackingGap(double pixels) +{ + mStackingGap = pixels; +} + +/*! \overload + + Adds the provided points in \a keys and \a values to the current data. The provided vectors + should have equal length. Else, the number of added points will be the size of the smallest + vector. + + If you can guarantee that the passed data points are sorted by \a keys in ascending order, you + can set \a alreadySorted to true, to improve performance by saving a sorting run. + + Alternatively, you can also access and modify the data directly via the \ref data method, which + returns a pointer to the internal data container. +*/ +void QCPBars::addData(const QVector &keys, const QVector &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 tempData(n); + QVector::iterator it = tempData.begin(); + const QVector::iterator itEnd = tempData.end(); + int i = 0; + while (it != itEnd) + { + it->key = keys[i]; + it->value = values[i]; + ++it; + ++i; + } + mDataContainer->add(tempData, alreadySorted); // don't modify tempData beyond this to prevent copy on write +} + +/*! \overload + Adds the provided data point as \a key and \a value to the current data. + + Alternatively, you can also access and modify the data directly via the \ref data method, which + returns a pointer to the internal data container. +*/ +void QCPBars::addData(double key, double value) +{ + mDataContainer->add(QCPBarsData(key, value)); +} + +/*! + Moves this bars plottable below \a bars. In other words, the bars of this plottable will appear + below the bars of \a bars. The move target \a bars must use the same key and value axis as this + plottable. + + Inserting into and removing from existing bar stacking is handled gracefully. If \a bars already + has a bars object below itself, this bars object is inserted between the two. If this bars object + is already between two other bars, the two other bars will be stacked on top of each other after + the operation. + + To remove this bars plottable from any stacking, set \a bars to 0. + + \see moveBelow, barAbove, barBelow +*/ +void QCPBars::moveBelow(QCPBars *bars) +{ + if (bars == this) return; + if (bars && (bars->keyAxis() != mKeyAxis.data() || bars->valueAxis() != mValueAxis.data())) + { + qDebug() << Q_FUNC_INFO << "passed QCPBars* doesn't have same key and value axis as this QCPBars"; + return; + } + // remove from stacking: + connectBars(mBarBelow.data(), mBarAbove.data()); // Note: also works if one (or both) of them is 0 + // if new bar given, insert this bar below it: + if (bars) + { + if (bars->mBarBelow) + connectBars(bars->mBarBelow.data(), this); + connectBars(this, bars); + } +} + +/*! + Moves this bars plottable above \a bars. In other words, the bars of this plottable will appear + above the bars of \a bars. The move target \a bars must use the same key and value axis as this + plottable. + + Inserting into and removing from existing bar stacking is handled gracefully. If \a bars already + has a bars object above itself, this bars object is inserted between the two. If this bars object + is already between two other bars, the two other bars will be stacked on top of each other after + the operation. + + To remove this bars plottable from any stacking, set \a bars to 0. + + \see moveBelow, barBelow, barAbove +*/ +void QCPBars::moveAbove(QCPBars *bars) +{ + if (bars == this) return; + if (bars && (bars->keyAxis() != mKeyAxis.data() || bars->valueAxis() != mValueAxis.data())) + { + qDebug() << Q_FUNC_INFO << "passed QCPBars* doesn't have same key and value axis as this QCPBars"; + return; + } + // remove from stacking: + connectBars(mBarBelow.data(), mBarAbove.data()); // Note: also works if one (or both) of them is 0 + // if new bar given, insert this bar above it: + if (bars) + { + if (bars->mBarAbove) + connectBars(this, bars->mBarAbove.data()); + connectBars(bars, this); + } +} + +/*! + \copydoc QCPPlottableInterface1D::selectTestRect +*/ +QCPDataSelection QCPBars::selectTestRect(const QRectF &rect, bool onlySelectable) const +{ + QCPDataSelection result; + if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) + return result; + if (!mKeyAxis || !mValueAxis) + return result; + + QCPBarsDataContainer::const_iterator visibleBegin, visibleEnd; + getVisibleDataBounds(visibleBegin, visibleEnd); + + for (QCPBarsDataContainer::const_iterator it=visibleBegin; it!=visibleEnd; ++it) + { + if (rect.intersects(getBarRect(it->key, it->value))) + result.addDataRange(QCPDataRange(it-mDataContainer->constBegin(), it-mDataContainer->constBegin()+1), false); + } + result.simplify(); + return result; +} + +/*! + Implements a selectTest specific to this plottable's point geometry. + + If \a details is not 0, it will be set to a \ref QCPDataSelection, describing the closest data + point to \a pos. + + \seebaseclassmethod \ref QCPAbstractPlottable::selectTest +*/ +double QCPBars::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) + return -1; + if (!mKeyAxis || !mValueAxis) + return -1; + + if (mKeyAxis.data()->axisRect()->rect().contains(pos.toPoint())) + { + // get visible data range: + QCPBarsDataContainer::const_iterator visibleBegin, visibleEnd; + getVisibleDataBounds(visibleBegin, visibleEnd); + for (QCPBarsDataContainer::const_iterator it=visibleBegin; it!=visibleEnd; ++it) + { + if (getBarRect(it->key, it->value).contains(pos)) + { + if (details) + { + int pointIndex = it-mDataContainer->constBegin(); + details->setValue(QCPDataSelection(QCPDataRange(pointIndex, pointIndex+1))); + } + return mParentPlot->selectionTolerance()*0.99; + } + } + } + return -1; +} + +/* inherits documentation from base class */ +QCPRange QCPBars::getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain) const +{ + /* Note: If this QCPBars uses absolute pixels as width (or is in a QCPBarsGroup with spacing in + absolute pixels), using this method to adapt the key axis range to fit the bars into the + currently visible axis range will not work perfectly. Because in the moment the axis range is + changed to the new range, the fixed pixel widths/spacings will represent different coordinate + spans than before, which in turn would require a different key range to perfectly fit, and so on. + The only solution would be to iteratively approach the perfect fitting axis range, but the + mismatch isn't large enough in most applications, to warrant this here. If a user does need a + better fit, he should call the corresponding axis rescale multiple times in a row. + */ + QCPRange range; + range = mDataContainer->keyRange(foundRange, inSignDomain); + + // determine exact range of bars by including bar width and barsgroup offset: + if (foundRange && mKeyAxis) + { + double lowerPixelWidth, upperPixelWidth, keyPixel; + // lower range bound: + getPixelWidth(range.lower, lowerPixelWidth, upperPixelWidth); + keyPixel = mKeyAxis.data()->coordToPixel(range.lower) + lowerPixelWidth; + if (mBarsGroup) + keyPixel += mBarsGroup->keyPixelOffset(this, range.lower); + const double lowerCorrected = mKeyAxis.data()->pixelToCoord(keyPixel); + if (!qIsNaN(lowerCorrected) && qIsFinite(lowerCorrected) && range.lower > lowerCorrected) + range.lower = lowerCorrected; + // upper range bound: + getPixelWidth(range.upper, lowerPixelWidth, upperPixelWidth); + keyPixel = mKeyAxis.data()->coordToPixel(range.upper) + upperPixelWidth; + if (mBarsGroup) + keyPixel += mBarsGroup->keyPixelOffset(this, range.upper); + const double upperCorrected = mKeyAxis.data()->pixelToCoord(keyPixel); + if (!qIsNaN(upperCorrected) && qIsFinite(upperCorrected) && range.upper < upperCorrected) + range.upper = upperCorrected; + } + return range; +} + +/* inherits documentation from base class */ +QCPRange QCPBars::getValueRange(bool &foundRange, QCP::SignDomain inSignDomain, const QCPRange &inKeyRange) const +{ + // Note: can't simply use mDataContainer->valueRange here because we need to + // take into account bar base value and possible stacking of multiple bars + QCPRange range; + range.lower = mBaseValue; + range.upper = mBaseValue; + bool haveLower = true; // set to true, because baseValue should always be visible in bar charts + bool haveUpper = true; // set to true, because baseValue should always be visible in bar charts + QCPBarsDataContainer::const_iterator itBegin = mDataContainer->constBegin(); + QCPBarsDataContainer::const_iterator itEnd = mDataContainer->constEnd(); + if (inKeyRange != QCPRange()) + { + itBegin = mDataContainer->findBegin(inKeyRange.lower); + itEnd = mDataContainer->findEnd(inKeyRange.upper); + } + for (QCPBarsDataContainer::const_iterator it = itBegin; it != itEnd; ++it) + { + const double current = it->value + getStackedBaseValue(it->key, it->value >= 0); + if (qIsNaN(current)) continue; + if (inSignDomain == QCP::sdBoth || (inSignDomain == QCP::sdNegative && current < 0) || (inSignDomain == QCP::sdPositive && current > 0)) + { + if (current < range.lower || !haveLower) + { + range.lower = current; + haveLower = true; + } + if (current > range.upper || !haveUpper) + { + range.upper = current; + haveUpper = true; + } + } + } + + foundRange = true; // return true because bar charts always have the 0-line visible + return range; +} + +/* inherits documentation from base class */ +QPointF QCPBars::dataPixelPosition(int index) const +{ + if (index >= 0 && index < mDataContainer->size()) + { + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return QPointF(); } + + const QCPDataContainer::const_iterator it = mDataContainer->constBegin()+index; + const double valuePixel = valueAxis->coordToPixel(getStackedBaseValue(it->key, it->value >= 0) + it->value); + const double keyPixel = keyAxis->coordToPixel(it->key) + (mBarsGroup ? mBarsGroup->keyPixelOffset(this, it->key) : 0); + if (keyAxis->orientation() == Qt::Horizontal) + return QPointF(keyPixel, valuePixel); + else + return QPointF(valuePixel, keyPixel); + } else + { + qDebug() << Q_FUNC_INFO << "Index out of bounds" << index; + return QPointF(); + } +} + +/* inherits documentation from base class */ +void QCPBars::draw(QCPPainter *painter) +{ + if (!mKeyAxis || !mValueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + if (mDataContainer->isEmpty()) return; + + QCPBarsDataContainer::const_iterator visibleBegin, visibleEnd; + getVisibleDataBounds(visibleBegin, visibleEnd); + + // loop over and draw segments of unselected/selected data: + QList selectedSegments, unselectedSegments, allSegments; + getDataSegments(selectedSegments, unselectedSegments); + allSegments << unselectedSegments << selectedSegments; + for (int i=0; i= unselectedSegments.size(); + QCPBarsDataContainer::const_iterator begin = visibleBegin; + QCPBarsDataContainer::const_iterator end = visibleEnd; + mDataContainer->limitIteratorsToDataRange(begin, end, allSegments.at(i)); + if (begin == end) + continue; + + for (QCPBarsDataContainer::const_iterator it=begin; it!=end; ++it) + { + // check data validity if flag set: +#ifdef QCUSTOMPLOT_CHECK_DATA + if (QCP::isInvalidData(it->key, it->value)) + qDebug() << Q_FUNC_INFO << "Data point at" << it->key << "of drawn range invalid." << "Plottable name:" << name(); +#endif + // draw bar: + if (isSelectedSegment && mSelectionDecorator) + { + mSelectionDecorator->applyBrush(painter); + mSelectionDecorator->applyPen(painter); + } else + { + painter->setBrush(mBrush); + painter->setPen(mPen); + } + applyDefaultAntialiasingHint(painter); + painter->drawPolygon(getBarRect(it->key, it->value)); + } + } + + // draw other selection decoration that isn't just line/scatter pens and brushes: + if (mSelectionDecorator) + mSelectionDecorator->drawDecoration(painter, selection()); +} + +/* inherits documentation from base class */ +void QCPBars::drawLegendIcon(QCPPainter *painter, const QRectF &rect) const +{ + // draw filled rect: + applyDefaultAntialiasingHint(painter); + painter->setBrush(mBrush); + painter->setPen(mPen); + QRectF r = QRectF(0, 0, rect.width()*0.67, rect.height()*0.67); + r.moveCenter(rect.center()); + painter->drawRect(r); +} + +/*! \internal + + called by \ref draw to determine which data (key) range is visible at the current key axis range + setting, so only that needs to be processed. It also takes into account the bar width. + + \a begin returns an iterator to the lowest data point that needs to be taken into account when + plotting. Note that in order to get a clean plot all the way to the edge of the axis rect, \a + lower may still be just outside the visible range. + + \a end returns an iterator one higher than the highest visible data point. Same as before, \a end + may also lie just outside of the visible range. + + if the plottable contains no data, both \a begin and \a end point to constEnd. +*/ +void QCPBars::getVisibleDataBounds(QCPBarsDataContainer::const_iterator &begin, QCPBarsDataContainer::const_iterator &end) const +{ + if (!mKeyAxis) + { + qDebug() << Q_FUNC_INFO << "invalid key axis"; + begin = mDataContainer->constEnd(); + end = mDataContainer->constEnd(); + return; + } + if (mDataContainer->isEmpty()) + { + begin = mDataContainer->constEnd(); + end = mDataContainer->constEnd(); + return; + } + + // get visible data range as QMap iterators + begin = mDataContainer->findBegin(mKeyAxis.data()->range().lower); + end = mDataContainer->findEnd(mKeyAxis.data()->range().upper); + double lowerPixelBound = mKeyAxis.data()->coordToPixel(mKeyAxis.data()->range().lower); + double upperPixelBound = mKeyAxis.data()->coordToPixel(mKeyAxis.data()->range().upper); + bool isVisible = false; + // walk left from begin to find lower bar that actually is completely outside visible pixel range: + QCPBarsDataContainer::const_iterator it = begin; + while (it != mDataContainer->constBegin()) + { + --it; + const QRectF barRect = getBarRect(it->key, it->value); + if (mKeyAxis.data()->orientation() == Qt::Horizontal) + isVisible = ((!mKeyAxis.data()->rangeReversed() && barRect.right() >= lowerPixelBound) || (mKeyAxis.data()->rangeReversed() && barRect.left() <= lowerPixelBound)); + else // keyaxis is vertical + isVisible = ((!mKeyAxis.data()->rangeReversed() && barRect.top() <= lowerPixelBound) || (mKeyAxis.data()->rangeReversed() && barRect.bottom() >= lowerPixelBound)); + if (isVisible) + begin = it; + else + break; + } + // walk right from ubound to find upper bar that actually is completely outside visible pixel range: + it = end; + while (it != mDataContainer->constEnd()) + { + const QRectF barRect = getBarRect(it->key, it->value); + if (mKeyAxis.data()->orientation() == Qt::Horizontal) + isVisible = ((!mKeyAxis.data()->rangeReversed() && barRect.left() <= upperPixelBound) || (mKeyAxis.data()->rangeReversed() && barRect.right() >= upperPixelBound)); + else // keyaxis is vertical + isVisible = ((!mKeyAxis.data()->rangeReversed() && barRect.bottom() >= upperPixelBound) || (mKeyAxis.data()->rangeReversed() && barRect.top() <= upperPixelBound)); + if (isVisible) + end = it+1; + else + break; + ++it; + } +} + +/*! \internal + + Returns the rect in pixel coordinates of a single bar with the specified \a key and \a value. The + rect is shifted according to the bar stacking (see \ref moveAbove) and base value (see \ref + setBaseValue), and to have non-overlapping border lines with the bars stacked below. +*/ +QRectF QCPBars::getBarRect(double key, double value) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return QRectF(); } + + double lowerPixelWidth, upperPixelWidth; + getPixelWidth(key, lowerPixelWidth, upperPixelWidth); + double base = getStackedBaseValue(key, value >= 0); + double basePixel = valueAxis->coordToPixel(base); + double valuePixel = valueAxis->coordToPixel(base+value); + double keyPixel = keyAxis->coordToPixel(key); + if (mBarsGroup) + keyPixel += mBarsGroup->keyPixelOffset(this, key); + double bottomOffset = (mBarBelow && mPen != Qt::NoPen ? 1 : 0)*(mPen.isCosmetic() ? 1 : mPen.widthF()); + bottomOffset += mBarBelow ? mStackingGap : 0; + bottomOffset *= (value<0 ? -1 : 1)*valueAxis->pixelOrientation(); + if (qAbs(valuePixel-basePixel) <= qAbs(bottomOffset)) + bottomOffset = valuePixel-basePixel; + if (keyAxis->orientation() == Qt::Horizontal) + { + return QRectF(QPointF(keyPixel+lowerPixelWidth, valuePixel), QPointF(keyPixel+upperPixelWidth, basePixel+bottomOffset)).normalized(); + } else + { + return QRectF(QPointF(basePixel+bottomOffset, keyPixel+lowerPixelWidth), QPointF(valuePixel, keyPixel+upperPixelWidth)).normalized(); + } +} + +/*! \internal + + This function is used to determine the width of the bar at coordinate \a key, according to the + specified width (\ref setWidth) and width type (\ref setWidthType). + + The output parameters \a lower and \a upper return the number of pixels the bar extends to lower + and higher keys, relative to the \a key coordinate (so with a non-reversed horizontal axis, \a + lower is negative and \a upper positive). +*/ +void QCPBars::getPixelWidth(double key, double &lower, double &upper) const +{ + lower = 0; + upper = 0; + switch (mWidthType) + { + case wtAbsolute: + { + upper = mWidth*0.5*mKeyAxis.data()->pixelOrientation(); + lower = -upper; + break; + } + case wtAxisRectRatio: + { + if (mKeyAxis && mKeyAxis.data()->axisRect()) + { + if (mKeyAxis.data()->orientation() == Qt::Horizontal) + upper = mKeyAxis.data()->axisRect()->width()*mWidth*0.5*mKeyAxis.data()->pixelOrientation(); + else + upper = mKeyAxis.data()->axisRect()->height()*mWidth*0.5*mKeyAxis.data()->pixelOrientation(); + lower = -upper; + } else + qDebug() << Q_FUNC_INFO << "No key axis or axis rect defined"; + break; + } + case wtPlotCoords: + { + if (mKeyAxis) + { + double keyPixel = mKeyAxis.data()->coordToPixel(key); + upper = mKeyAxis.data()->coordToPixel(key+mWidth*0.5)-keyPixel; + lower = mKeyAxis.data()->coordToPixel(key-mWidth*0.5)-keyPixel; + // no need to qSwap(lower, higher) when range reversed, because higher/lower are gained by + // coordinate transform which includes range direction + } else + qDebug() << Q_FUNC_INFO << "No key axis defined"; + break; + } + } +} + +/*! \internal + + This function is called to find at which value to start drawing the base of a bar at \a key, when + it is stacked on top of another QCPBars (e.g. with \ref moveAbove). + + positive and negative bars are separated per stack (positive are stacked above baseValue upwards, + negative are stacked below baseValue downwards). This can be indicated with \a positive. So if the + bar for which we need the base value is negative, set \a positive to false. +*/ +double QCPBars::getStackedBaseValue(double key, bool positive) const +{ + if (mBarBelow) + { + double max = 0; // don't initialize with mBaseValue here because only base value of bottom-most bar has meaning in a bar stack + // find bars of mBarBelow that are approximately at key and find largest one: + double epsilon = qAbs(key)*(sizeof(key)==4 ? 1e-6 : 1e-14); // should be safe even when changed to use float at some point + if (key == 0) + epsilon = (sizeof(key)==4 ? 1e-6 : 1e-14); + QCPBarsDataContainer::const_iterator it = mBarBelow.data()->mDataContainer->findBegin(key-epsilon); + QCPBarsDataContainer::const_iterator itEnd = mBarBelow.data()->mDataContainer->findEnd(key+epsilon); + while (it != itEnd) + { + if (it->key > key-epsilon && it->key < key+epsilon) + { + if ((positive && it->value > max) || + (!positive && it->value < max)) + max = it->value; + } + ++it; + } + // recurse down the bar-stack to find the total height: + return max + mBarBelow.data()->getStackedBaseValue(key, positive); + } else + return mBaseValue; +} + +/*! \internal + + Connects \a below and \a above to each other via their mBarAbove/mBarBelow properties. The bar(s) + currently above lower and below upper will become disconnected to lower/upper. + + If lower is zero, upper will be disconnected at the bottom. + If upper is zero, lower will be disconnected at the top. +*/ +void QCPBars::connectBars(QCPBars *lower, QCPBars *upper) +{ + if (!lower && !upper) return; + + if (!lower) // disconnect upper at bottom + { + // disconnect old bar below upper: + if (upper->mBarBelow && upper->mBarBelow.data()->mBarAbove.data() == upper) + upper->mBarBelow.data()->mBarAbove = 0; + upper->mBarBelow = 0; + } else if (!upper) // disconnect lower at top + { + // disconnect old bar above lower: + if (lower->mBarAbove && lower->mBarAbove.data()->mBarBelow.data() == lower) + lower->mBarAbove.data()->mBarBelow = 0; + lower->mBarAbove = 0; + } else // connect lower and upper + { + // disconnect old bar above lower: + if (lower->mBarAbove && lower->mBarAbove.data()->mBarBelow.data() == lower) + lower->mBarAbove.data()->mBarBelow = 0; + // disconnect old bar below upper: + if (upper->mBarBelow && upper->mBarBelow.data()->mBarAbove.data() == upper) + upper->mBarBelow.data()->mBarAbove = 0; + lower->mBarAbove = upper; + upper->mBarBelow = lower; + } +} +/* end of 'src/plottables/plottable-bars.cpp' */ + + +/* including file 'src/plottables/plottable-statisticalbox.cpp', size 28837 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPStatisticalBoxData +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPStatisticalBoxData + \brief Holds the data of one single data point for QCPStatisticalBox. + + The stored data is: + + \li \a key: coordinate on the key axis of this data point (this is the \a mainKey and the \a sortKey) + + \li \a minimum: the position of the lower whisker, typically the minimum measurement of the + sample that's not considered an outlier. + + \li \a lowerQuartile: the lower end of the box. The lower and the upper quartiles are the two + statistical quartiles around the median of the sample, they should contain 50% of the sample + data. + + \li \a median: the value of the median mark inside the quartile box. The median separates the + sample data in half (50% of the sample data is below/above the median). (This is the \a mainValue) + + \li \a upperQuartile: the upper end of the box. The lower and the upper quartiles are the two + statistical quartiles around the median of the sample, they should contain 50% of the sample + data. + + \li \a maximum: the position of the upper whisker, typically the maximum measurement of the + sample that's not considered an outlier. + + \li \a outliers: a QVector of outlier values that will be drawn as scatter points at the \a key + coordinate of this data point (see \ref QCPStatisticalBox::setOutlierStyle) + + The container for storing multiple data points is \ref QCPStatisticalBoxDataContainer. It is a + typedef for \ref QCPDataContainer with \ref QCPStatisticalBoxData as the DataType template + parameter. See the documentation there for an explanation regarding the data type's generic + methods. + + \see QCPStatisticalBoxDataContainer +*/ + +/* start documentation of inline functions */ + +/*! \fn double QCPStatisticalBoxData::sortKey() const + + Returns the \a key member of this data point. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn static QCPStatisticalBoxData QCPStatisticalBoxData::fromSortKey(double sortKey) + + Returns a data point with the specified \a sortKey. All other members are set to zero. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn static static bool QCPStatisticalBoxData::sortKeyIsMainKey() + + Since the member \a key is both the data point key coordinate and the data ordering parameter, + this method returns true. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn double QCPStatisticalBoxData::mainKey() const + + Returns the \a key member of this data point. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn double QCPStatisticalBoxData::mainValue() const + + Returns the \a median member of this data point. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn QCPRange QCPStatisticalBoxData::valueRange() const + + Returns a QCPRange spanning from the \a minimum to the \a maximum member of this statistical box + data point, possibly further expanded by outliers. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/* end documentation of inline functions */ + +/*! + Constructs a data point with key and all values set to zero. +*/ +QCPStatisticalBoxData::QCPStatisticalBoxData() : + key(0), + minimum(0), + lowerQuartile(0), + median(0), + upperQuartile(0), + maximum(0) +{ +} + +/*! + Constructs a data point with the specified \a key, \a minimum, \a lowerQuartile, \a median, \a + upperQuartile, \a maximum and optionally a number of \a outliers. +*/ +QCPStatisticalBoxData::QCPStatisticalBoxData(double key, double minimum, double lowerQuartile, double median, double upperQuartile, double maximum, const QVector &outliers) : + key(key), + minimum(minimum), + lowerQuartile(lowerQuartile), + median(median), + upperQuartile(upperQuartile), + maximum(maximum), + outliers(outliers) +{ +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPStatisticalBox +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPStatisticalBox + \brief A plottable representing a single statistical box in a plot. + + \image html QCPStatisticalBox.png + + To plot data, assign it with the \ref setData or \ref addData functions. Alternatively, you can + also access and modify the data via the \ref data method, which returns a pointer to the internal + \ref QCPStatisticalBoxDataContainer. + + Additionally each data point can itself have a list of outliers, drawn as scatter points at the + key coordinate of the respective statistical box data point. They can either be set by using the + respective \ref addData(double,double,double,double,double,double,const QVector&) + "addData" method or accessing the individual data points through \ref data, and setting the + QVector outliers of the data points directly. + + \section qcpstatisticalbox-appearance Changing the appearance + + The appearance of each data point box, ranging from the lower to the upper quartile, is + controlled via \ref setPen and \ref setBrush. You may change the width of the boxes with \ref + setWidth in plot coordinates. + + Each data point's visual representation also consists of two whiskers. Whiskers are the lines + which reach from the upper quartile to the maximum, and from the lower quartile to the minimum. + The appearance of the whiskers can be modified with: \ref setWhiskerPen, \ref setWhiskerBarPen, + \ref setWhiskerWidth. The whisker width is the width of the bar perpendicular to the whisker at + the top (for maximum) and bottom (for minimum). If the whisker pen is changed, make sure to set + the \c capStyle to \c Qt::FlatCap. Otherwise the backbone line might exceed the whisker bars by a + few pixels due to the pen cap being not perfectly flat. + + The median indicator line inside the box has its own pen, \ref setMedianPen. + + The outlier data points are drawn as normal scatter points. Their look can be controlled with + \ref setOutlierStyle + + \section qcpstatisticalbox-usage Usage + + Like all data representing objects in QCustomPlot, the QCPStatisticalBox is a plottable + (QCPAbstractPlottable). So the plottable-interface of QCustomPlot applies + (QCustomPlot::plottable, QCustomPlot::removePlottable, etc.) + + Usually, you first create an instance: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpstatisticalbox-creation-1 + which registers it with the QCustomPlot instance of the passed axes. Note that this QCustomPlot instance takes + ownership of the plottable, so do not delete it manually but use QCustomPlot::removePlottable() instead. + The newly created plottable can be modified, e.g.: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpstatisticalbox-creation-2 +*/ + +/* start documentation of inline functions */ + +/*! \fn QSharedPointer QCPStatisticalBox::data() const + + Returns a shared pointer to the internal data storage of type \ref + QCPStatisticalBoxDataContainer. You may use it to directly manipulate the data, which may be more + convenient and faster than using the regular \ref setData or \ref addData methods. +*/ + +/* end documentation of inline functions */ + +/*! + Constructs a statistical box which uses \a keyAxis as its key axis ("x") and \a valueAxis as its + value axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance and + not have the same orientation. If either of these restrictions is violated, a corresponding + message is printed to the debug output (qDebug), the construction is not aborted, though. + + The created QCPStatisticalBox is automatically registered with the QCustomPlot instance inferred + from \a keyAxis. This QCustomPlot instance takes ownership of the QCPStatisticalBox, so do not + delete it manually but use QCustomPlot::removePlottable() instead. +*/ +QCPStatisticalBox::QCPStatisticalBox(QCPAxis *keyAxis, QCPAxis *valueAxis) : + QCPAbstractPlottable1D(keyAxis, valueAxis), + mWidth(0.5), + mWhiskerWidth(0.2), + mWhiskerPen(Qt::black, 0, Qt::DashLine, Qt::FlatCap), + mWhiskerBarPen(Qt::black), + mWhiskerAntialiased(false), + mMedianPen(Qt::black, 3, Qt::SolidLine, Qt::FlatCap), + mOutlierStyle(QCPScatterStyle::ssCircle, Qt::blue, 6) +{ + setPen(QPen(Qt::black)); + setBrush(Qt::NoBrush); +} + +/*! \overload + + Replaces the current data container with the provided \a data container. + + Since a QSharedPointer is used, multiple QCPStatisticalBoxes may share the same data container + safely. Modifying the data in the container will then affect all statistical boxes that share the + container. Sharing can be achieved by simply exchanging the data containers wrapped in shared + pointers: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpstatisticalbox-datasharing-1 + + If you do not wish to share containers, but create a copy from an existing container, rather use + the \ref QCPDataContainer::set method on the statistical box data container directly: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpstatisticalbox-datasharing-2 + + \see addData +*/ +void QCPStatisticalBox::setData(QSharedPointer data) +{ + mDataContainer = data; +} +/*! \overload + + Replaces the current data with the provided points in \a keys, \a minimum, \a lowerQuartile, \a + median, \a upperQuartile and \a maximum. The provided vectors should have equal length. Else, the + number of added points will be the size of the smallest vector. + + If you can guarantee that the passed data points are sorted by \a keys in ascending order, you + can set \a alreadySorted to true, to improve performance by saving a sorting run. + + \see addData +*/ +void QCPStatisticalBox::setData(const QVector &keys, const QVector &minimum, const QVector &lowerQuartile, const QVector &median, const QVector &upperQuartile, const QVector &maximum, bool alreadySorted) +{ + mDataContainer->clear(); + addData(keys, minimum, lowerQuartile, median, upperQuartile, maximum, alreadySorted); +} + +/*! + Sets the width of the boxes in key coordinates. + + \see setWhiskerWidth +*/ +void QCPStatisticalBox::setWidth(double width) +{ + mWidth = width; +} + +/*! + Sets the width of the whiskers in key coordinates. + + Whiskers are the lines which reach from the upper quartile to the maximum, and from the lower + quartile to the minimum. + + \see setWidth +*/ +void QCPStatisticalBox::setWhiskerWidth(double width) +{ + mWhiskerWidth = width; +} + +/*! + Sets the pen used for drawing the whisker backbone. + + Whiskers are the lines which reach from the upper quartile to the maximum, and from the lower + quartile to the minimum. + + Make sure to set the \c capStyle of the passed \a pen to \c Qt::FlatCap. Otherwise the backbone + line might exceed the whisker bars by a few pixels due to the pen cap being not perfectly flat. + + \see setWhiskerBarPen +*/ +void QCPStatisticalBox::setWhiskerPen(const QPen &pen) +{ + mWhiskerPen = pen; +} + +/*! + Sets the pen used for drawing the whisker bars. Those are the lines parallel to the key axis at + each end of the whisker backbone. + + Whiskers are the lines which reach from the upper quartile to the maximum, and from the lower + quartile to the minimum. + + \see setWhiskerPen +*/ +void QCPStatisticalBox::setWhiskerBarPen(const QPen &pen) +{ + mWhiskerBarPen = pen; +} + +/*! + Sets whether the statistical boxes whiskers are drawn with antialiasing or not. + + Note that antialiasing settings may be overridden by QCustomPlot::setAntialiasedElements and + QCustomPlot::setNotAntialiasedElements. +*/ +void QCPStatisticalBox::setWhiskerAntialiased(bool enabled) +{ + mWhiskerAntialiased = enabled; +} + +/*! + Sets the pen used for drawing the median indicator line inside the statistical boxes. +*/ +void QCPStatisticalBox::setMedianPen(const QPen &pen) +{ + mMedianPen = pen; +} + +/*! + Sets the appearance of the outlier data points. + + Outliers can be specified with the method + \ref addData(double key, double minimum, double lowerQuartile, double median, double upperQuartile, double maximum, const QVector &outliers) +*/ +void QCPStatisticalBox::setOutlierStyle(const QCPScatterStyle &style) +{ + mOutlierStyle = style; +} + +/*! \overload + + Adds the provided points in \a keys, \a minimum, \a lowerQuartile, \a median, \a upperQuartile and + \a maximum to the current data. The provided vectors should have equal length. Else, the number + of added points will be the size of the smallest vector. + + If you can guarantee that the passed data points are sorted by \a keys in ascending order, you + can set \a alreadySorted to true, to improve performance by saving a sorting run. + + Alternatively, you can also access and modify the data directly via the \ref data method, which + returns a pointer to the internal data container. +*/ +void QCPStatisticalBox::addData(const QVector &keys, const QVector &minimum, const QVector &lowerQuartile, const QVector &median, const QVector &upperQuartile, const QVector &maximum, bool alreadySorted) +{ + if (keys.size() != minimum.size() || minimum.size() != lowerQuartile.size() || lowerQuartile.size() != median.size() || + median.size() != upperQuartile.size() || upperQuartile.size() != maximum.size() || maximum.size() != keys.size()) + qDebug() << Q_FUNC_INFO << "keys, minimum, lowerQuartile, median, upperQuartile, maximum have different sizes:" + << keys.size() << minimum.size() << lowerQuartile.size() << median.size() << upperQuartile.size() << maximum.size(); + const int n = qMin(keys.size(), qMin(minimum.size(), qMin(lowerQuartile.size(), qMin(median.size(), qMin(upperQuartile.size(), maximum.size()))))); + QVector tempData(n); + QVector::iterator it = tempData.begin(); + const QVector::iterator itEnd = tempData.end(); + int i = 0; + while (it != itEnd) + { + it->key = keys[i]; + it->minimum = minimum[i]; + it->lowerQuartile = lowerQuartile[i]; + it->median = median[i]; + it->upperQuartile = upperQuartile[i]; + it->maximum = maximum[i]; + ++it; + ++i; + } + mDataContainer->add(tempData, alreadySorted); // don't modify tempData beyond this to prevent copy on write +} + +/*! \overload + + Adds the provided data point as \a key, \a minimum, \a lowerQuartile, \a median, \a upperQuartile + and \a maximum to the current data. + + Alternatively, you can also access and modify the data directly via the \ref data method, which + returns a pointer to the internal data container. +*/ +void QCPStatisticalBox::addData(double key, double minimum, double lowerQuartile, double median, double upperQuartile, double maximum, const QVector &outliers) +{ + mDataContainer->add(QCPStatisticalBoxData(key, minimum, lowerQuartile, median, upperQuartile, maximum, outliers)); +} + +/*! + \copydoc QCPPlottableInterface1D::selectTestRect +*/ +QCPDataSelection QCPStatisticalBox::selectTestRect(const QRectF &rect, bool onlySelectable) const +{ + QCPDataSelection result; + if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) + return result; + if (!mKeyAxis || !mValueAxis) + return result; + + QCPStatisticalBoxDataContainer::const_iterator visibleBegin, visibleEnd; + getVisibleDataBounds(visibleBegin, visibleEnd); + + for (QCPStatisticalBoxDataContainer::const_iterator it=visibleBegin; it!=visibleEnd; ++it) + { + if (rect.intersects(getQuartileBox(it))) + result.addDataRange(QCPDataRange(it-mDataContainer->constBegin(), it-mDataContainer->constBegin()+1), false); + } + result.simplify(); + return result; +} + +/*! + Implements a selectTest specific to this plottable's point geometry. + + If \a details is not 0, it will be set to a \ref QCPDataSelection, describing the closest data + point to \a pos. + + \seebaseclassmethod \ref QCPAbstractPlottable::selectTest +*/ +double QCPStatisticalBox::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) + return -1; + if (!mKeyAxis || !mValueAxis) + return -1; + + if (mKeyAxis->axisRect()->rect().contains(pos.toPoint())) + { + // get visible data range: + QCPStatisticalBoxDataContainer::const_iterator visibleBegin, visibleEnd; + QCPStatisticalBoxDataContainer::const_iterator closestDataPoint = mDataContainer->constEnd(); + getVisibleDataBounds(visibleBegin, visibleEnd); + double minDistSqr = (std::numeric_limits::max)(); + for (QCPStatisticalBoxDataContainer::const_iterator it=visibleBegin; it!=visibleEnd; ++it) + { + if (getQuartileBox(it).contains(pos)) // quartile box + { + double currentDistSqr = mParentPlot->selectionTolerance()*0.99 * mParentPlot->selectionTolerance()*0.99; + if (currentDistSqr < minDistSqr) + { + minDistSqr = currentDistSqr; + closestDataPoint = it; + } + } else // whiskers + { + const QVector whiskerBackbones(getWhiskerBackboneLines(it)); + for (int i=0; iconstBegin(); + details->setValue(QCPDataSelection(QCPDataRange(pointIndex, pointIndex+1))); + } + return qSqrt(minDistSqr); + } + return -1; +} + +/* inherits documentation from base class */ +QCPRange QCPStatisticalBox::getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain) const +{ + QCPRange range = mDataContainer->keyRange(foundRange, inSignDomain); + // determine exact range by including width of bars/flags: + if (foundRange) + { + if (inSignDomain != QCP::sdPositive || range.lower-mWidth*0.5 > 0) + range.lower -= mWidth*0.5; + if (inSignDomain != QCP::sdNegative || range.upper+mWidth*0.5 < 0) + range.upper += mWidth*0.5; + } + return range; +} + +/* inherits documentation from base class */ +QCPRange QCPStatisticalBox::getValueRange(bool &foundRange, QCP::SignDomain inSignDomain, const QCPRange &inKeyRange) const +{ + return mDataContainer->valueRange(foundRange, inSignDomain, inKeyRange); +} + +/* inherits documentation from base class */ +void QCPStatisticalBox::draw(QCPPainter *painter) +{ + if (mDataContainer->isEmpty()) return; + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + + QCPStatisticalBoxDataContainer::const_iterator visibleBegin, visibleEnd; + getVisibleDataBounds(visibleBegin, visibleEnd); + + // loop over and draw segments of unselected/selected data: + QList selectedSegments, unselectedSegments, allSegments; + getDataSegments(selectedSegments, unselectedSegments); + allSegments << unselectedSegments << selectedSegments; + for (int i=0; i= unselectedSegments.size(); + QCPStatisticalBoxDataContainer::const_iterator begin = visibleBegin; + QCPStatisticalBoxDataContainer::const_iterator end = visibleEnd; + mDataContainer->limitIteratorsToDataRange(begin, end, allSegments.at(i)); + if (begin == end) + continue; + + for (QCPStatisticalBoxDataContainer::const_iterator it=begin; it!=end; ++it) + { + // check data validity if flag set: +# ifdef QCUSTOMPLOT_CHECK_DATA + if (QCP::isInvalidData(it->key, it->minimum) || + QCP::isInvalidData(it->lowerQuartile, it->median) || + QCP::isInvalidData(it->upperQuartile, it->maximum)) + qDebug() << Q_FUNC_INFO << "Data point at" << it->key << "of drawn range has invalid data." << "Plottable name:" << name(); + for (int i=0; ioutliers.size(); ++i) + if (QCP::isInvalidData(it->outliers.at(i))) + qDebug() << Q_FUNC_INFO << "Data point outlier at" << it->key << "of drawn range invalid." << "Plottable name:" << name(); +# endif + + if (isSelectedSegment && mSelectionDecorator) + { + mSelectionDecorator->applyPen(painter); + mSelectionDecorator->applyBrush(painter); + } else + { + painter->setPen(mPen); + painter->setBrush(mBrush); + } + QCPScatterStyle finalOutlierStyle = mOutlierStyle; + if (isSelectedSegment && mSelectionDecorator) + finalOutlierStyle = mSelectionDecorator->getFinalScatterStyle(mOutlierStyle); + drawStatisticalBox(painter, it, finalOutlierStyle); + } + } + + // draw other selection decoration that isn't just line/scatter pens and brushes: + if (mSelectionDecorator) + mSelectionDecorator->drawDecoration(painter, selection()); +} + +/* inherits documentation from base class */ +void QCPStatisticalBox::drawLegendIcon(QCPPainter *painter, const QRectF &rect) const +{ + // draw filled rect: + applyDefaultAntialiasingHint(painter); + painter->setPen(mPen); + painter->setBrush(mBrush); + QRectF r = QRectF(0, 0, rect.width()*0.67, rect.height()*0.67); + r.moveCenter(rect.center()); + painter->drawRect(r); +} + +/*! + Draws the graphical representation of a single statistical box with the data given by the + iterator \a it with the provided \a painter. + + If the statistical box has a set of outlier data points, they are drawn with \a outlierStyle. + + \see getQuartileBox, getWhiskerBackboneLines, getWhiskerBarLines +*/ +void QCPStatisticalBox::drawStatisticalBox(QCPPainter *painter, QCPStatisticalBoxDataContainer::const_iterator it, const QCPScatterStyle &outlierStyle) const +{ + // draw quartile box: + applyDefaultAntialiasingHint(painter); + const QRectF quartileBox = getQuartileBox(it); + painter->drawRect(quartileBox); + // draw median line with cliprect set to quartile box: + painter->save(); + painter->setClipRect(quartileBox, Qt::IntersectClip); + painter->setPen(mMedianPen); + painter->drawLine(QLineF(coordsToPixels(it->key-mWidth*0.5, it->median), coordsToPixels(it->key+mWidth*0.5, it->median))); + painter->restore(); + // draw whisker lines: + applyAntialiasingHint(painter, mWhiskerAntialiased, QCP::aePlottables); + painter->setPen(mWhiskerPen); + painter->drawLines(getWhiskerBackboneLines(it)); + painter->setPen(mWhiskerBarPen); + painter->drawLines(getWhiskerBarLines(it)); + // draw outliers: + applyScattersAntialiasingHint(painter); + outlierStyle.applyTo(painter, mPen); + for (int i=0; ioutliers.size(); ++i) + outlierStyle.drawShape(painter, coordsToPixels(it->key, it->outliers.at(i))); +} + +/*! \internal + + called by \ref draw to determine which data (key) range is visible at the current key axis range + setting, so only that needs to be processed. It also takes into account the bar width. + + \a begin returns an iterator to the lowest data point that needs to be taken into account when + plotting. Note that in order to get a clean plot all the way to the edge of the axis rect, \a + lower may still be just outside the visible range. + + \a end returns an iterator one higher than the highest visible data point. Same as before, \a end + may also lie just outside of the visible range. + + if the plottable contains no data, both \a begin and \a end point to constEnd. +*/ +void QCPStatisticalBox::getVisibleDataBounds(QCPStatisticalBoxDataContainer::const_iterator &begin, QCPStatisticalBoxDataContainer::const_iterator &end) const +{ + if (!mKeyAxis) + { + qDebug() << Q_FUNC_INFO << "invalid key axis"; + begin = mDataContainer->constEnd(); + end = mDataContainer->constEnd(); + return; + } + begin = mDataContainer->findBegin(mKeyAxis.data()->range().lower-mWidth*0.5); // subtract half width of box to include partially visible data points + end = mDataContainer->findEnd(mKeyAxis.data()->range().upper+mWidth*0.5); // add half width of box to include partially visible data points +} + +/*! \internal + + Returns the box in plot coordinates (keys in x, values in y of the returned rect) that covers the + value range from the lower to the upper quartile, of the data given by \a it. + + \see drawStatisticalBox, getWhiskerBackboneLines, getWhiskerBarLines +*/ +QRectF QCPStatisticalBox::getQuartileBox(QCPStatisticalBoxDataContainer::const_iterator it) const +{ + QRectF result; + result.setTopLeft(coordsToPixels(it->key-mWidth*0.5, it->upperQuartile)); + result.setBottomRight(coordsToPixels(it->key+mWidth*0.5, it->lowerQuartile)); + return result; +} + +/*! \internal + + Returns the whisker backbones (keys in x, values in y of the returned lines) that cover the value + range from the minimum to the lower quartile, and from the upper quartile to the maximum of the + data given by \a it. + + \see drawStatisticalBox, getQuartileBox, getWhiskerBarLines +*/ +QVector QCPStatisticalBox::getWhiskerBackboneLines(QCPStatisticalBoxDataContainer::const_iterator it) const +{ + QVector result(2); + result[0].setPoints(coordsToPixels(it->key, it->lowerQuartile), coordsToPixels(it->key, it->minimum)); // min backbone + result[1].setPoints(coordsToPixels(it->key, it->upperQuartile), coordsToPixels(it->key, it->maximum)); // max backbone + return result; +} + +/*! \internal + + Returns the whisker bars (keys in x, values in y of the returned lines) that are placed at the + end of the whisker backbones, at the minimum and maximum of the data given by \a it. + + \see drawStatisticalBox, getQuartileBox, getWhiskerBackboneLines +*/ +QVector QCPStatisticalBox::getWhiskerBarLines(QCPStatisticalBoxDataContainer::const_iterator it) const +{ + QVector result(2); + result[0].setPoints(coordsToPixels(it->key-mWhiskerWidth*0.5, it->minimum), coordsToPixels(it->key+mWhiskerWidth*0.5, it->minimum)); // min bar + result[1].setPoints(coordsToPixels(it->key-mWhiskerWidth*0.5, it->maximum), coordsToPixels(it->key+mWhiskerWidth*0.5, it->maximum)); // max bar + return result; +} +/* end of 'src/plottables/plottable-statisticalbox.cpp' */ + + +/* including file 'src/plottables/plottable-colormap.cpp', size 47881 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPColorMapData +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPColorMapData + \brief Holds the two-dimensional data of a QCPColorMap plottable. + + This class is a data storage for \ref QCPColorMap. It holds a two-dimensional array, which \ref + QCPColorMap then displays as a 2D image in the plot, where the array values are represented by a + color, depending on the value. + + The size of the array can be controlled via \ref setSize (or \ref setKeySize, \ref setValueSize). + Which plot coordinates these cells correspond to can be configured with \ref setRange (or \ref + setKeyRange, \ref setValueRange). + + The data cells can be accessed in two ways: They can be directly addressed by an integer index + with \ref setCell. This is the fastest method. Alternatively, they can be addressed by their plot + coordinate with \ref setData. plot coordinate to cell index transformations and vice versa are + provided by the functions \ref coordToCell and \ref cellToCoord. + + A \ref QCPColorMapData also holds an on-demand two-dimensional array of alpha values which (if + allocated) has the same size as the data map. It can be accessed via \ref setAlpha, \ref + fillAlpha and \ref clearAlpha. The memory for the alpha map is only allocated if needed, i.e. on + the first call of \ref setAlpha. \ref clearAlpha restores full opacity and frees the alpha map. + + This class also buffers the minimum and maximum values that are in the data set, to provide + QCPColorMap::rescaleDataRange with the necessary information quickly. Setting a cell to a value + that is greater than the current maximum increases this maximum to the new value. However, + setting the cell that currently holds the maximum value to a smaller value doesn't decrease the + maximum again, because finding the true new maximum would require going through the entire data + array, which might be time consuming. The same holds for the data minimum. This functionality is + given by \ref recalculateDataBounds, such that you can decide when it is sensible to find the + true current minimum and maximum. The method QCPColorMap::rescaleDataRange offers a convenience + parameter \a recalculateDataBounds which may be set to true to automatically call \ref + recalculateDataBounds internally. +*/ + +/* start of documentation of inline functions */ + +/*! \fn bool QCPColorMapData::isEmpty() const + + Returns whether this instance carries no data. This is equivalent to having a size where at least + one of the dimensions is 0 (see \ref setSize). +*/ + +/* end of documentation of inline functions */ + +/*! + Constructs a new QCPColorMapData instance. The instance has \a keySize cells in the key direction + and \a valueSize cells in the value direction. These cells will be displayed by the \ref QCPColorMap + at the coordinates \a keyRange and \a valueRange. + + \see setSize, setKeySize, setValueSize, setRange, setKeyRange, setValueRange +*/ +QCPColorMapData::QCPColorMapData(int keySize, int valueSize, const QCPRange &keyRange, const QCPRange &valueRange) : + mKeySize(0), + mValueSize(0), + mKeyRange(keyRange), + mValueRange(valueRange), + mIsEmpty(true), + mData(0), + mAlpha(0), + mDataModified(true) +{ + setSize(keySize, valueSize); + fill(0); +} + +QCPColorMapData::~QCPColorMapData() +{ + if (mData) + delete[] mData; + if (mAlpha) + delete[] mAlpha; +} + +/*! + Constructs a new QCPColorMapData instance copying the data and range of \a other. +*/ +QCPColorMapData::QCPColorMapData(const QCPColorMapData &other) : + mKeySize(0), + mValueSize(0), + mIsEmpty(true), + mData(0), + mAlpha(0), + mDataModified(true) +{ + *this = other; +} + +/*! + Overwrites this color map data instance with the data stored in \a other. The alpha map state is + transferred, too. +*/ +QCPColorMapData &QCPColorMapData::operator=(const QCPColorMapData &other) +{ + if (&other != this) + { + const int keySize = other.keySize(); + const int valueSize = other.valueSize(); + if (!other.mAlpha && mAlpha) + clearAlpha(); + setSize(keySize, valueSize); + if (other.mAlpha && !mAlpha) + createAlpha(false); + setRange(other.keyRange(), other.valueRange()); + if (!isEmpty()) + { + memcpy(mData, other.mData, sizeof(mData[0])*keySize*valueSize); + if (mAlpha) + memcpy(mAlpha, other.mAlpha, sizeof(mAlpha[0])*keySize*valueSize); + } + mDataBounds = other.mDataBounds; + mDataModified = true; + } + return *this; +} + +/* undocumented getter */ +double QCPColorMapData::data(double key, double value) +{ + int keyCell = (key-mKeyRange.lower)/(mKeyRange.upper-mKeyRange.lower)*(mKeySize-1)+0.5; + int valueCell = (value-mValueRange.lower)/(mValueRange.upper-mValueRange.lower)*(mValueSize-1)+0.5; + if (keyCell >= 0 && keyCell < mKeySize && valueCell >= 0 && valueCell < mValueSize) + return mData[valueCell*mKeySize + keyCell]; + else + return 0; +} + +/* undocumented getter */ +double QCPColorMapData::cell(int keyIndex, int valueIndex) +{ + if (keyIndex >= 0 && keyIndex < mKeySize && valueIndex >= 0 && valueIndex < mValueSize) + return mData[valueIndex*mKeySize + keyIndex]; + else + return 0; +} + +/*! + Returns the alpha map value of the cell with the indices \a keyIndex and \a valueIndex. + + If this color map data doesn't have an alpha map (because \ref setAlpha was never called after + creation or after a call to \ref clearAlpha), returns 255, which corresponds to full opacity. + + \see setAlpha +*/ +unsigned char QCPColorMapData::alpha(int keyIndex, int valueIndex) +{ + if (mAlpha && keyIndex >= 0 && keyIndex < mKeySize && valueIndex >= 0 && valueIndex < mValueSize) + return mAlpha[valueIndex*mKeySize + keyIndex]; + else + return 255; +} + +/*! + Resizes the data array to have \a keySize cells in the key dimension and \a valueSize cells in + the value dimension. + + The current data is discarded and the map cells are set to 0, unless the map had already the + requested size. + + Setting at least one of \a keySize or \a valueSize to zero frees the internal data array and \ref + isEmpty returns true. + + \see setRange, setKeySize, setValueSize +*/ +void QCPColorMapData::setSize(int keySize, int valueSize) +{ + if (keySize != mKeySize || valueSize != mValueSize) + { + mKeySize = keySize; + mValueSize = valueSize; + if (mData) + delete[] mData; + mIsEmpty = mKeySize == 0 || mValueSize == 0; + if (!mIsEmpty) + { +#ifdef __EXCEPTIONS + try { // 2D arrays get memory intensive fast. So if the allocation fails, at least output debug message +#endif + mData = new double[mKeySize*mValueSize]; +#ifdef __EXCEPTIONS + } catch (...) { mData = 0; } +#endif + if (mData) + fill(0); + else + qDebug() << Q_FUNC_INFO << "out of memory for data dimensions "<< mKeySize << "*" << mValueSize; + } else + mData = 0; + + if (mAlpha) // if we had an alpha map, recreate it with new size + createAlpha(); + + mDataModified = true; + } +} + +/*! + Resizes the data array to have \a keySize cells in the key dimension. + + The current data is discarded and the map cells are set to 0, unless the map had already the + requested size. + + Setting \a keySize to zero frees the internal data array and \ref isEmpty returns true. + + \see setKeyRange, setSize, setValueSize +*/ +void QCPColorMapData::setKeySize(int keySize) +{ + setSize(keySize, mValueSize); +} + +/*! + Resizes the data array to have \a valueSize cells in the value dimension. + + The current data is discarded and the map cells are set to 0, unless the map had already the + requested size. + + Setting \a valueSize to zero frees the internal data array and \ref isEmpty returns true. + + \see setValueRange, setSize, setKeySize +*/ +void QCPColorMapData::setValueSize(int valueSize) +{ + setSize(mKeySize, valueSize); +} + +/*! + Sets the coordinate ranges the data shall be distributed over. This defines the rectangular area + covered by the color map in plot coordinates. + + The outer cells will be centered on the range boundaries given to this function. For example, if + the key size (\ref setKeySize) is 3 and \a keyRange is set to QCPRange(2, 3) there will + be cells centered on the key coordinates 2, 2.5 and 3. + + \see setSize +*/ +void QCPColorMapData::setRange(const QCPRange &keyRange, const QCPRange &valueRange) +{ + setKeyRange(keyRange); + setValueRange(valueRange); +} + +/*! + Sets the coordinate range the data shall be distributed over in the key dimension. Together with + the value range, This defines the rectangular area covered by the color map in plot coordinates. + + The outer cells will be centered on the range boundaries given to this function. For example, if + the key size (\ref setKeySize) is 3 and \a keyRange is set to QCPRange(2, 3) there will + be cells centered on the key coordinates 2, 2.5 and 3. + + \see setRange, setValueRange, setSize +*/ +void QCPColorMapData::setKeyRange(const QCPRange &keyRange) +{ + mKeyRange = keyRange; +} + +/*! + Sets the coordinate range the data shall be distributed over in the value dimension. Together with + the key range, This defines the rectangular area covered by the color map in plot coordinates. + + The outer cells will be centered on the range boundaries given to this function. For example, if + the value size (\ref setValueSize) is 3 and \a valueRange is set to QCPRange(2, 3) there + will be cells centered on the value coordinates 2, 2.5 and 3. + + \see setRange, setKeyRange, setSize +*/ +void QCPColorMapData::setValueRange(const QCPRange &valueRange) +{ + mValueRange = valueRange; +} + +/*! + Sets the data of the cell, which lies at the plot coordinates given by \a key and \a value, to \a + z. + + \note The QCPColorMap always displays the data at equal key/value intervals, even if the key or + value axis is set to a logarithmic scaling. If you want to use QCPColorMap with logarithmic axes, + you shouldn't use the \ref QCPColorMapData::setData method as it uses a linear transformation to + determine the cell index. Rather directly access the cell index with \ref + QCPColorMapData::setCell. + + \see setCell, setRange +*/ +void QCPColorMapData::setData(double key, double value, double z) +{ + int keyCell = (key-mKeyRange.lower)/(mKeyRange.upper-mKeyRange.lower)*(mKeySize-1)+0.5; + int valueCell = (value-mValueRange.lower)/(mValueRange.upper-mValueRange.lower)*(mValueSize-1)+0.5; + if (keyCell >= 0 && keyCell < mKeySize && valueCell >= 0 && valueCell < mValueSize) + { + mData[valueCell*mKeySize + keyCell] = z; + if (z < mDataBounds.lower) + mDataBounds.lower = z; + if (z > mDataBounds.upper) + mDataBounds.upper = z; + mDataModified = true; + } +} + +/*! + Sets the data of the cell with indices \a keyIndex and \a valueIndex to \a z. The indices + enumerate the cells starting from zero, up to the map's size-1 in the respective dimension (see + \ref setSize). + + In the standard plot configuration (horizontal key axis and vertical value axis, both not + range-reversed), the cell with indices (0, 0) is in the bottom left corner and the cell with + indices (keySize-1, valueSize-1) is in the top right corner of the color map. + + \see setData, setSize +*/ +void QCPColorMapData::setCell(int keyIndex, int valueIndex, double z) +{ + if (keyIndex >= 0 && keyIndex < mKeySize && valueIndex >= 0 && valueIndex < mValueSize) + { + mData[valueIndex*mKeySize + keyIndex] = z; + if (z < mDataBounds.lower) + mDataBounds.lower = z; + if (z > mDataBounds.upper) + mDataBounds.upper = z; + mDataModified = true; + } else + qDebug() << Q_FUNC_INFO << "index out of bounds:" << keyIndex << valueIndex; +} + +/*! + Sets the alpha of the color map cell given by \a keyIndex and \a valueIndex to \a alpha. A value + of 0 for \a alpha results in a fully transparent cell, and a value of 255 results in a fully + opaque cell. + + If an alpha map doesn't exist yet for this color map data, it will be created here. If you wish + to restore full opacity and free any allocated memory of the alpha map, call \ref clearAlpha. + + Note that the cell-wise alpha which can be configured here is independent of any alpha configured + in the color map's gradient (\ref QCPColorGradient). If a cell is affected both by the cell-wise + and gradient alpha, the alpha values will be blended accordingly during rendering of the color + map. + + \see fillAlpha, clearAlpha +*/ +void QCPColorMapData::setAlpha(int keyIndex, int valueIndex, unsigned char alpha) +{ + if (keyIndex >= 0 && keyIndex < mKeySize && valueIndex >= 0 && valueIndex < mValueSize) + { + if (mAlpha || createAlpha()) + { + mAlpha[valueIndex*mKeySize + keyIndex] = alpha; + mDataModified = true; + } + } else + qDebug() << Q_FUNC_INFO << "index out of bounds:" << keyIndex << valueIndex; +} + +/*! + Goes through the data and updates the buffered minimum and maximum data values. + + Calling this method is only advised if you are about to call \ref QCPColorMap::rescaleDataRange + and can not guarantee that the cells holding the maximum or minimum data haven't been overwritten + with a smaller or larger value respectively, since the buffered maximum/minimum values have been + updated the last time. Why this is the case is explained in the class description (\ref + QCPColorMapData). + + Note that the method \ref QCPColorMap::rescaleDataRange provides a parameter \a + recalculateDataBounds for convenience. Setting this to true will call this method for you, before + doing the rescale. +*/ +void QCPColorMapData::recalculateDataBounds() +{ + if (mKeySize > 0 && mValueSize > 0) + { + double minHeight = mData[0]; + double maxHeight = mData[0]; + const int dataCount = mValueSize*mKeySize; + for (int i=0; i maxHeight) + maxHeight = mData[i]; + if (mData[i] < minHeight) + minHeight = mData[i]; + } + mDataBounds.lower = minHeight; + mDataBounds.upper = maxHeight; + } +} + +/*! + Frees the internal data memory. + + This is equivalent to calling \ref setSize "setSize(0, 0)". +*/ +void QCPColorMapData::clear() +{ + setSize(0, 0); +} + +/*! + Frees the internal alpha map. The color map will have full opacity again. +*/ +void QCPColorMapData::clearAlpha() +{ + if (mAlpha) + { + delete[] mAlpha; + mAlpha = 0; + mDataModified = true; + } +} + +/*! + Sets all cells to the value \a z. +*/ +void QCPColorMapData::fill(double z) +{ + const int dataCount = mValueSize*mKeySize; + for (int i=0; i(data); + return; + } + if (copy) + { + *mMapData = *data; + } else + { + delete mMapData; + mMapData = data; + } + mMapImageInvalidated = true; +} + +/*! + Sets the data range of this color map to \a dataRange. The data range defines which data values + are mapped to the color gradient. + + To make the data range span the full range of the data set, use \ref rescaleDataRange. + + \see QCPColorScale::setDataRange +*/ +void QCPColorMap::setDataRange(const QCPRange &dataRange) +{ + if (!QCPRange::validRange(dataRange)) return; + if (mDataRange.lower != dataRange.lower || mDataRange.upper != dataRange.upper) + { + if (mDataScaleType == QCPAxis::stLogarithmic) + mDataRange = dataRange.sanitizedForLogScale(); + else + mDataRange = dataRange.sanitizedForLinScale(); + mMapImageInvalidated = true; + emit dataRangeChanged(mDataRange); + } +} + +/*! + Sets whether the data is correlated with the color gradient linearly or logarithmically. + + \see QCPColorScale::setDataScaleType +*/ +void QCPColorMap::setDataScaleType(QCPAxis::ScaleType scaleType) +{ + if (mDataScaleType != scaleType) + { + mDataScaleType = scaleType; + mMapImageInvalidated = true; + emit dataScaleTypeChanged(mDataScaleType); + if (mDataScaleType == QCPAxis::stLogarithmic) + setDataRange(mDataRange.sanitizedForLogScale()); + } +} + +/*! + Sets the color gradient that is used to represent the data. For more details on how to create an + own gradient or use one of the preset gradients, see \ref QCPColorGradient. + + The colors defined by the gradient will be used to represent data values in the currently set + data range, see \ref setDataRange. Data points that are outside this data range will either be + colored uniformly with the respective gradient boundary color, or the gradient will repeat, + depending on \ref QCPColorGradient::setPeriodic. + + \see QCPColorScale::setGradient +*/ +void QCPColorMap::setGradient(const QCPColorGradient &gradient) +{ + if (mGradient != gradient) + { + mGradient = gradient; + mMapImageInvalidated = true; + emit gradientChanged(mGradient); + } +} + +/*! + Sets whether the color map image shall use bicubic interpolation when displaying the color map + shrinked or expanded, and not at a 1:1 pixel-to-data scale. + + \image html QCPColorMap-interpolate.png "A 10*10 color map, with interpolation and without interpolation enabled" +*/ +void QCPColorMap::setInterpolate(bool enabled) +{ + mInterpolate = enabled; + mMapImageInvalidated = true; // because oversampling factors might need to change +} + +/*! + Sets whether the outer most data rows and columns are clipped to the specified key and value + range (see \ref QCPColorMapData::setKeyRange, \ref QCPColorMapData::setValueRange). + + if \a enabled is set to false, the data points at the border of the color map are drawn with the + same width and height as all other data points. Since the data points are represented by + rectangles of one color centered on the data coordinate, this means that the shown color map + extends by half a data point over the specified key/value range in each direction. + + \image html QCPColorMap-tightboundary.png "A color map, with tight boundary enabled and disabled" +*/ +void QCPColorMap::setTightBoundary(bool enabled) +{ + mTightBoundary = enabled; +} + +/*! + Associates the color scale \a colorScale with this color map. + + This means that both the color scale and the color map synchronize their gradient, data range and + data scale type (\ref setGradient, \ref setDataRange, \ref setDataScaleType). Multiple color maps + can be associated with one single color scale. This causes the color maps to also synchronize + those properties, via the mutual color scale. + + This function causes the color map to adopt the current color gradient, data range and data scale + type of \a colorScale. After this call, you may change these properties at either the color map + or the color scale, and the setting will be applied to both. + + Pass 0 as \a colorScale to disconnect the color scale from this color map again. +*/ +void QCPColorMap::setColorScale(QCPColorScale *colorScale) +{ + if (mColorScale) // unconnect signals from old color scale + { + disconnect(this, SIGNAL(dataRangeChanged(QCPRange)), mColorScale.data(), SLOT(setDataRange(QCPRange))); + disconnect(this, SIGNAL(dataScaleTypeChanged(QCPAxis::ScaleType)), mColorScale.data(), SLOT(setDataScaleType(QCPAxis::ScaleType))); + disconnect(this, SIGNAL(gradientChanged(QCPColorGradient)), mColorScale.data(), SLOT(setGradient(QCPColorGradient))); + disconnect(mColorScale.data(), SIGNAL(dataRangeChanged(QCPRange)), this, SLOT(setDataRange(QCPRange))); + disconnect(mColorScale.data(), SIGNAL(gradientChanged(QCPColorGradient)), this, SLOT(setGradient(QCPColorGradient))); + disconnect(mColorScale.data(), SIGNAL(dataScaleTypeChanged(QCPAxis::ScaleType)), this, SLOT(setDataScaleType(QCPAxis::ScaleType))); + } + mColorScale = colorScale; + if (mColorScale) // connect signals to new color scale + { + setGradient(mColorScale.data()->gradient()); + setDataRange(mColorScale.data()->dataRange()); + setDataScaleType(mColorScale.data()->dataScaleType()); + connect(this, SIGNAL(dataRangeChanged(QCPRange)), mColorScale.data(), SLOT(setDataRange(QCPRange))); + connect(this, SIGNAL(dataScaleTypeChanged(QCPAxis::ScaleType)), mColorScale.data(), SLOT(setDataScaleType(QCPAxis::ScaleType))); + connect(this, SIGNAL(gradientChanged(QCPColorGradient)), mColorScale.data(), SLOT(setGradient(QCPColorGradient))); + connect(mColorScale.data(), SIGNAL(dataRangeChanged(QCPRange)), this, SLOT(setDataRange(QCPRange))); + connect(mColorScale.data(), SIGNAL(gradientChanged(QCPColorGradient)), this, SLOT(setGradient(QCPColorGradient))); + connect(mColorScale.data(), SIGNAL(dataScaleTypeChanged(QCPAxis::ScaleType)), this, SLOT(setDataScaleType(QCPAxis::ScaleType))); + } +} + +/*! + Sets the data range (\ref setDataRange) to span the minimum and maximum values that occur in the + current data set. This corresponds to the \ref rescaleKeyAxis or \ref rescaleValueAxis methods, + only for the third data dimension of the color map. + + The minimum and maximum values of the data set are buffered in the internal QCPColorMapData + instance (\ref data). As data is updated via its \ref QCPColorMapData::setCell or \ref + QCPColorMapData::setData, the buffered minimum and maximum values are updated, too. For + performance reasons, however, they are only updated in an expanding fashion. So the buffered + maximum can only increase and the buffered minimum can only decrease. In consequence, changes to + the data that actually lower the maximum of the data set (by overwriting the cell holding the + current maximum with a smaller value), aren't recognized and the buffered maximum overestimates + the true maximum of the data set. The same happens for the buffered minimum. To recalculate the + true minimum and maximum by explicitly looking at each cell, the method + QCPColorMapData::recalculateDataBounds can be used. For convenience, setting the parameter \a + recalculateDataBounds calls this method before setting the data range to the buffered minimum and + maximum. + + \see setDataRange +*/ +void QCPColorMap::rescaleDataRange(bool recalculateDataBounds) +{ + if (recalculateDataBounds) + mMapData->recalculateDataBounds(); + setDataRange(mMapData->dataBounds()); +} + +/*! + Takes the current appearance of the color map and updates the legend icon, which is used to + represent this color map in the legend (see \ref QCPLegend). + + The \a transformMode specifies whether the rescaling is done by a faster, low quality image + scaling algorithm (Qt::FastTransformation) or by a slower, higher quality algorithm + (Qt::SmoothTransformation). + + The current color map appearance is scaled down to \a thumbSize. Ideally, this should be equal to + the size of the legend icon (see \ref QCPLegend::setIconSize). If it isn't exactly the configured + legend icon size, the thumb will be rescaled during drawing of the legend item. + + \see setDataRange +*/ +void QCPColorMap::updateLegendIcon(Qt::TransformationMode transformMode, const QSize &thumbSize) +{ + if (mMapImage.isNull() && !data()->isEmpty()) + updateMapImage(); // try to update map image if it's null (happens if no draw has happened yet) + + if (!mMapImage.isNull()) // might still be null, e.g. if data is empty, so check here again + { + bool mirrorX = (keyAxis()->orientation() == Qt::Horizontal ? keyAxis() : valueAxis())->rangeReversed(); + bool mirrorY = (valueAxis()->orientation() == Qt::Vertical ? valueAxis() : keyAxis())->rangeReversed(); + mLegendIcon = QPixmap::fromImage(mMapImage.mirrored(mirrorX, mirrorY)).scaled(thumbSize, Qt::KeepAspectRatio, transformMode); + } +} + +/* inherits documentation from base class */ +double QCPColorMap::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if ((onlySelectable && mSelectable == QCP::stNone) || mMapData->isEmpty()) + return -1; + if (!mKeyAxis || !mValueAxis) + return -1; + + if (mKeyAxis.data()->axisRect()->rect().contains(pos.toPoint())) + { + double posKey, posValue; + pixelsToCoords(pos, posKey, posValue); + if (mMapData->keyRange().contains(posKey) && mMapData->valueRange().contains(posValue)) + { + if (details) + details->setValue(QCPDataSelection(QCPDataRange(0, 1))); // temporary solution, to facilitate whole-plottable selection. Replace in future version with segmented 2D selection. + return mParentPlot->selectionTolerance()*0.99; + } + } + return -1; +} + +/* inherits documentation from base class */ +QCPRange QCPColorMap::getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain) const +{ + foundRange = true; + QCPRange result = mMapData->keyRange(); + result.normalize(); + if (inSignDomain == QCP::sdPositive) + { + if (result.lower <= 0 && result.upper > 0) + result.lower = result.upper*1e-3; + else if (result.lower <= 0 && result.upper <= 0) + foundRange = false; + } else if (inSignDomain == QCP::sdNegative) + { + if (result.upper >= 0 && result.lower < 0) + result.upper = result.lower*1e-3; + else if (result.upper >= 0 && result.lower >= 0) + foundRange = false; + } + return result; +} + +/* inherits documentation from base class */ +QCPRange QCPColorMap::getValueRange(bool &foundRange, QCP::SignDomain inSignDomain, const QCPRange &inKeyRange) const +{ + if (inKeyRange != QCPRange()) + { + if (mMapData->keyRange().upper < inKeyRange.lower || mMapData->keyRange().lower > inKeyRange.upper) + { + foundRange = false; + return QCPRange(); + } + } + + foundRange = true; + QCPRange result = mMapData->valueRange(); + result.normalize(); + if (inSignDomain == QCP::sdPositive) + { + if (result.lower <= 0 && result.upper > 0) + result.lower = result.upper*1e-3; + else if (result.lower <= 0 && result.upper <= 0) + foundRange = false; + } else if (inSignDomain == QCP::sdNegative) + { + if (result.upper >= 0 && result.lower < 0) + result.upper = result.lower*1e-3; + else if (result.upper >= 0 && result.lower >= 0) + foundRange = false; + } + return result; +} + +/*! \internal + + Updates the internal map image buffer by going through the internal \ref QCPColorMapData and + turning the data values into color pixels with \ref QCPColorGradient::colorize. + + This method is called by \ref QCPColorMap::draw if either the data has been modified or the map image + has been invalidated for a different reason (e.g. a change of the data range with \ref + setDataRange). + + If the map cell count is low, the image created will be oversampled in order to avoid a + QPainter::drawImage bug which makes inner pixel boundaries jitter when stretch-drawing images + without smooth transform enabled. Accordingly, oversampling isn't performed if \ref + setInterpolate is true. +*/ +void QCPColorMap::updateMapImage() +{ + QCPAxis *keyAxis = mKeyAxis.data(); + if (!keyAxis) return; + if (mMapData->isEmpty()) return; + + const QImage::Format format = QImage::Format_ARGB32_Premultiplied; + const int keySize = mMapData->keySize(); + const int valueSize = mMapData->valueSize(); + int keyOversamplingFactor = mInterpolate ? 1 : (int)(1.0+100.0/(double)keySize); // make mMapImage have at least size 100, factor becomes 1 if size > 200 or interpolation is on + int valueOversamplingFactor = mInterpolate ? 1 : (int)(1.0+100.0/(double)valueSize); // make mMapImage have at least size 100, factor becomes 1 if size > 200 or interpolation is on + + // resize mMapImage to correct dimensions including possible oversampling factors, according to key/value axes orientation: + if (keyAxis->orientation() == Qt::Horizontal && (mMapImage.width() != keySize*keyOversamplingFactor || mMapImage.height() != valueSize*valueOversamplingFactor)) + mMapImage = QImage(QSize(keySize*keyOversamplingFactor, valueSize*valueOversamplingFactor), format); + else if (keyAxis->orientation() == Qt::Vertical && (mMapImage.width() != valueSize*valueOversamplingFactor || mMapImage.height() != keySize*keyOversamplingFactor)) + mMapImage = QImage(QSize(valueSize*valueOversamplingFactor, keySize*keyOversamplingFactor), format); + + if (mMapImage.isNull()) + { + qDebug() << Q_FUNC_INFO << "Couldn't create map image (possibly too large for memory)"; + mMapImage = QImage(QSize(10, 10), format); + mMapImage.fill(Qt::black); + } else + { + QImage *localMapImage = &mMapImage; // this is the image on which the colorization operates. Either the final mMapImage, or if we need oversampling, mUndersampledMapImage + if (keyOversamplingFactor > 1 || valueOversamplingFactor > 1) + { + // resize undersampled map image to actual key/value cell sizes: + if (keyAxis->orientation() == Qt::Horizontal && (mUndersampledMapImage.width() != keySize || mUndersampledMapImage.height() != valueSize)) + mUndersampledMapImage = QImage(QSize(keySize, valueSize), format); + else if (keyAxis->orientation() == Qt::Vertical && (mUndersampledMapImage.width() != valueSize || mUndersampledMapImage.height() != keySize)) + mUndersampledMapImage = QImage(QSize(valueSize, keySize), format); + localMapImage = &mUndersampledMapImage; // make the colorization run on the undersampled image + } else if (!mUndersampledMapImage.isNull()) + mUndersampledMapImage = QImage(); // don't need oversampling mechanism anymore (map size has changed) but mUndersampledMapImage still has nonzero size, free it + + const double *rawData = mMapData->mData; + const unsigned char *rawAlpha = mMapData->mAlpha; + if (keyAxis->orientation() == Qt::Horizontal) + { + const int lineCount = valueSize; + const int rowCount = keySize; + for (int line=0; line(localMapImage->scanLine(lineCount-1-line)); // invert scanline index because QImage counts scanlines from top, but our vertical index counts from bottom (mathematical coordinate system) + if (rawAlpha) + mGradient.colorize(rawData+line*rowCount, rawAlpha+line*rowCount, mDataRange, pixels, rowCount, 1, mDataScaleType==QCPAxis::stLogarithmic); + else + mGradient.colorize(rawData+line*rowCount, mDataRange, pixels, rowCount, 1, mDataScaleType==QCPAxis::stLogarithmic); + } + } else // keyAxis->orientation() == Qt::Vertical + { + const int lineCount = keySize; + const int rowCount = valueSize; + for (int line=0; line(localMapImage->scanLine(lineCount-1-line)); // invert scanline index because QImage counts scanlines from top, but our vertical index counts from bottom (mathematical coordinate system) + if (rawAlpha) + mGradient.colorize(rawData+line, rawAlpha+line, mDataRange, pixels, rowCount, lineCount, mDataScaleType==QCPAxis::stLogarithmic); + else + mGradient.colorize(rawData+line, mDataRange, pixels, rowCount, lineCount, mDataScaleType==QCPAxis::stLogarithmic); + } + } + + if (keyOversamplingFactor > 1 || valueOversamplingFactor > 1) + { + if (keyAxis->orientation() == Qt::Horizontal) + mMapImage = mUndersampledMapImage.scaled(keySize*keyOversamplingFactor, valueSize*valueOversamplingFactor, Qt::IgnoreAspectRatio, Qt::FastTransformation); + else + mMapImage = mUndersampledMapImage.scaled(valueSize*valueOversamplingFactor, keySize*keyOversamplingFactor, Qt::IgnoreAspectRatio, Qt::FastTransformation); + } + } + mMapData->mDataModified = false; + mMapImageInvalidated = false; +} + +/* inherits documentation from base class */ +void QCPColorMap::draw(QCPPainter *painter) +{ + if (mMapData->isEmpty()) return; + if (!mKeyAxis || !mValueAxis) return; + applyDefaultAntialiasingHint(painter); + + if (mMapData->mDataModified || mMapImageInvalidated) + updateMapImage(); + + // use buffer if painting vectorized (PDF): + const bool useBuffer = painter->modes().testFlag(QCPPainter::pmVectorized); + QCPPainter *localPainter = painter; // will be redirected to paint on mapBuffer if painting vectorized + QRectF mapBufferTarget; // the rect in absolute widget coordinates where the visible map portion/buffer will end up in + QPixmap mapBuffer; + if (useBuffer) + { + const double mapBufferPixelRatio = 3; // factor by which DPI is increased in embedded bitmaps + mapBufferTarget = painter->clipRegion().boundingRect(); + mapBuffer = QPixmap((mapBufferTarget.size()*mapBufferPixelRatio).toSize()); + mapBuffer.fill(Qt::transparent); + localPainter = new QCPPainter(&mapBuffer); + localPainter->scale(mapBufferPixelRatio, mapBufferPixelRatio); + localPainter->translate(-mapBufferTarget.topLeft()); + } + + QRectF imageRect = QRectF(coordsToPixels(mMapData->keyRange().lower, mMapData->valueRange().lower), + coordsToPixels(mMapData->keyRange().upper, mMapData->valueRange().upper)).normalized(); + // extend imageRect to contain outer halves/quarters of bordering/cornering pixels (cells are centered on map range boundary): + double halfCellWidth = 0; // in pixels + double halfCellHeight = 0; // in pixels + if (keyAxis()->orientation() == Qt::Horizontal) + { + if (mMapData->keySize() > 1) + halfCellWidth = 0.5*imageRect.width()/(double)(mMapData->keySize()-1); + if (mMapData->valueSize() > 1) + halfCellHeight = 0.5*imageRect.height()/(double)(mMapData->valueSize()-1); + } else // keyAxis orientation is Qt::Vertical + { + if (mMapData->keySize() > 1) + halfCellHeight = 0.5*imageRect.height()/(double)(mMapData->keySize()-1); + if (mMapData->valueSize() > 1) + halfCellWidth = 0.5*imageRect.width()/(double)(mMapData->valueSize()-1); + } + imageRect.adjust(-halfCellWidth, -halfCellHeight, halfCellWidth, halfCellHeight); + const bool mirrorX = (keyAxis()->orientation() == Qt::Horizontal ? keyAxis() : valueAxis())->rangeReversed(); + const bool mirrorY = (valueAxis()->orientation() == Qt::Vertical ? valueAxis() : keyAxis())->rangeReversed(); + const bool smoothBackup = localPainter->renderHints().testFlag(QPainter::SmoothPixmapTransform); + localPainter->setRenderHint(QPainter::SmoothPixmapTransform, mInterpolate); + QRegion clipBackup; + if (mTightBoundary) + { + clipBackup = localPainter->clipRegion(); + QRectF tightClipRect = QRectF(coordsToPixels(mMapData->keyRange().lower, mMapData->valueRange().lower), + coordsToPixels(mMapData->keyRange().upper, mMapData->valueRange().upper)).normalized(); + localPainter->setClipRect(tightClipRect, Qt::IntersectClip); + } + localPainter->drawImage(imageRect, mMapImage.mirrored(mirrorX, mirrorY)); + if (mTightBoundary) + localPainter->setClipRegion(clipBackup); + localPainter->setRenderHint(QPainter::SmoothPixmapTransform, smoothBackup); + + if (useBuffer) // localPainter painted to mapBuffer, so now draw buffer with original painter + { + delete localPainter; + painter->drawPixmap(mapBufferTarget.toRect(), mapBuffer); + } +} + +/* inherits documentation from base class */ +void QCPColorMap::drawLegendIcon(QCPPainter *painter, const QRectF &rect) const +{ + applyDefaultAntialiasingHint(painter); + // draw map thumbnail: + if (!mLegendIcon.isNull()) + { + QPixmap scaledIcon = mLegendIcon.scaled(rect.size().toSize(), Qt::KeepAspectRatio, Qt::FastTransformation); + QRectF iconRect = QRectF(0, 0, scaledIcon.width(), scaledIcon.height()); + iconRect.moveCenter(rect.center()); + painter->drawPixmap(iconRect.topLeft(), scaledIcon); + } + /* + // draw frame: + painter->setBrush(Qt::NoBrush); + painter->setPen(Qt::black); + painter->drawRect(rect.adjusted(1, 1, 0, 0)); + */ +} +/* end of 'src/plottables/plottable-colormap.cpp' */ + + +/* including file 'src/plottables/plottable-financial.cpp', size 42827 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPFinancialData +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPFinancialData + \brief Holds the data of one single data point for QCPFinancial. + + The stored data is: + \li \a key: coordinate on the key axis of this data point (this is the \a mainKey and the \a sortKey) + \li \a open: The opening value at the data point (this is the \a mainValue) + \li \a high: The high/maximum value at the data point + \li \a low: The low/minimum value at the data point + \li \a close: The closing value at the data point + + The container for storing multiple data points is \ref QCPFinancialDataContainer. It is a typedef + for \ref QCPDataContainer with \ref QCPFinancialData as the DataType template parameter. See the + documentation there for an explanation regarding the data type's generic methods. + + \see QCPFinancialDataContainer +*/ + +/* start documentation of inline functions */ + +/*! \fn double QCPFinancialData::sortKey() const + + Returns the \a key member of this data point. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn static QCPFinancialData QCPFinancialData::fromSortKey(double sortKey) + + Returns a data point with the specified \a sortKey. All other members are set to zero. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn static static bool QCPFinancialData::sortKeyIsMainKey() + + Since the member \a key is both the data point key coordinate and the data ordering parameter, + this method returns true. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn double QCPFinancialData::mainKey() const + + Returns the \a key member of this data point. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn double QCPFinancialData::mainValue() const + + Returns the \a open member of this data point. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/*! \fn QCPRange QCPFinancialData::valueRange() const + + Returns a QCPRange spanning from the \a low to the \a high value of this data point. + + For a general explanation of what this method is good for in the context of the data container, + see the documentation of \ref QCPDataContainer. +*/ + +/* end documentation of inline functions */ + +/*! + Constructs a data point with key and all values set to zero. +*/ +QCPFinancialData::QCPFinancialData() : + key(0), + open(0), + high(0), + low(0), + close(0) +{ +} + +/*! + Constructs a data point with the specified \a key and OHLC values. +*/ +QCPFinancialData::QCPFinancialData(double key, double open, double high, double low, double close) : + key(key), + open(open), + high(high), + low(low), + close(close) +{ +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPFinancial +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPFinancial + \brief A plottable representing a financial stock chart + + \image html QCPFinancial.png + + This plottable represents time series data binned to certain intervals, mainly used for stock + charts. The two common representations OHLC (Open-High-Low-Close) bars and Candlesticks can be + set via \ref setChartStyle. + + The data is passed via \ref setData as a set of open/high/low/close values at certain keys + (typically times). This means the data must be already binned appropriately. If data is only + available as a series of values (e.g. \a price against \a time), you can use the static + convenience function \ref timeSeriesToOhlc to generate binned OHLC-data which can then be passed + to \ref setData. + + The width of the OHLC bars/candlesticks can be controlled with \ref setWidth and \ref + setWidthType. A typical choice is to set the width type to \ref wtPlotCoords (the default) and + the width to (or slightly less than) one time bin interval width. + + \section qcpfinancial-appearance Changing the appearance + + Charts can be either single- or two-colored (\ref setTwoColored). If set to be single-colored, + lines are drawn with the plottable's pen (\ref setPen) and fills with the brush (\ref setBrush). + + If set to two-colored, positive changes of the value during an interval (\a close >= \a open) are + represented with a different pen and brush than negative changes (\a close < \a open). These can + be configured with \ref setPenPositive, \ref setPenNegative, \ref setBrushPositive, and \ref + setBrushNegative. In two-colored mode, the normal plottable pen/brush is ignored. Upon selection + however, the normal selected pen/brush (provided by the \ref selectionDecorator) is used, + irrespective of whether the chart is single- or two-colored. + + \section qcpfinancial-usage Usage + + Like all data representing objects in QCustomPlot, the QCPFinancial is a plottable + (QCPAbstractPlottable). So the plottable-interface of QCustomPlot applies + (QCustomPlot::plottable, QCustomPlot::removePlottable, etc.) + + Usually, you first create an instance: + + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpfinancial-creation-1 + which registers it with the QCustomPlot instance of the passed axes. Note that this QCustomPlot + instance takes ownership of the plottable, so do not delete it manually but use + QCustomPlot::removePlottable() instead. The newly created plottable can be modified, e.g.: + + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpfinancial-creation-2 + Here we have used the static helper method \ref timeSeriesToOhlc, to turn a time-price data + series into a 24-hour binned open-high-low-close data series as QCPFinancial uses. +*/ + +/* start of documentation of inline functions */ + +/*! \fn QCPFinancialDataContainer *QCPFinancial::data() const + + Returns a pointer to the internal data storage of type \ref QCPFinancialDataContainer. You may + use it to directly manipulate the data, which may be more convenient and faster than using the + regular \ref setData or \ref addData methods, in certain situations. +*/ + +/* end of documentation of inline functions */ + +/*! + Constructs a financial chart which uses \a keyAxis as its key axis ("x") and \a valueAxis as its value + axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance and not have + the same orientation. If either of these restrictions is violated, a corresponding message is + printed to the debug output (qDebug), the construction is not aborted, though. + + The created QCPFinancial is automatically registered with the QCustomPlot instance inferred from \a + keyAxis. This QCustomPlot instance takes ownership of the QCPFinancial, so do not delete it manually + but use QCustomPlot::removePlottable() instead. +*/ +QCPFinancial::QCPFinancial(QCPAxis *keyAxis, QCPAxis *valueAxis) : + QCPAbstractPlottable1D(keyAxis, valueAxis), + mChartStyle(csCandlestick), + mWidth(0.5), + mWidthType(wtPlotCoords), + mTwoColored(true), + mBrushPositive(QBrush(QColor(50, 160, 0))), + mBrushNegative(QBrush(QColor(180, 0, 15))), + mPenPositive(QPen(QColor(40, 150, 0))), + mPenNegative(QPen(QColor(170, 5, 5))) +{ + mSelectionDecorator->setBrush(QBrush(QColor(160, 160, 255))); +} + +QCPFinancial::~QCPFinancial() +{ +} + +/*! \overload + + Replaces the current data container with the provided \a data container. + + Since a QSharedPointer is used, multiple QCPFinancials may share the same data container safely. + Modifying the data in the container will then affect all financials that share the container. + Sharing can be achieved by simply exchanging the data containers wrapped in shared pointers: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpfinancial-datasharing-1 + + If you do not wish to share containers, but create a copy from an existing container, rather use + the \ref QCPDataContainer::set method on the financial's data container directly: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcpfinancial-datasharing-2 + + \see addData, timeSeriesToOhlc +*/ +void QCPFinancial::setData(QSharedPointer data) +{ + mDataContainer = data; +} + +/*! \overload + + Replaces the current data with the provided points in \a keys, \a open, \a high, \a low and \a + close. The provided vectors should have equal length. Else, the number of added points will be + the size of the smallest vector. + + If you can guarantee that the passed data points are sorted by \a keys in ascending order, you + can set \a alreadySorted to true, to improve performance by saving a sorting run. + + \see addData, timeSeriesToOhlc +*/ +void QCPFinancial::setData(const QVector &keys, const QVector &open, const QVector &high, const QVector &low, const QVector &close, bool alreadySorted) +{ + mDataContainer->clear(); + addData(keys, open, high, low, close, alreadySorted); +} + +/*! + Sets which representation style shall be used to display the OHLC data. +*/ +void QCPFinancial::setChartStyle(QCPFinancial::ChartStyle style) +{ + mChartStyle = style; +} + +/*! + Sets the width of the individual bars/candlesticks to \a width in plot key coordinates. + + A typical choice is to set it to (or slightly less than) one bin interval width. +*/ +void QCPFinancial::setWidth(double width) +{ + mWidth = width; +} + +/*! + Sets how the width of the financial bars is defined. See the documentation of \ref WidthType for + an explanation of the possible values for \a widthType. + + The default value is \ref wtPlotCoords. + + \see setWidth +*/ +void QCPFinancial::setWidthType(QCPFinancial::WidthType widthType) +{ + mWidthType = widthType; +} + +/*! + Sets whether this chart shall contrast positive from negative trends per data point by using two + separate colors to draw the respective bars/candlesticks. + + If \a twoColored is false, the normal plottable's pen and brush are used (\ref setPen, \ref + setBrush). + + \see setPenPositive, setPenNegative, setBrushPositive, setBrushNegative +*/ +void QCPFinancial::setTwoColored(bool twoColored) +{ + mTwoColored = twoColored; +} + +/*! + If \ref setTwoColored is set to true, this function controls the brush that is used to draw fills + of data points with a positive trend (i.e. bars/candlesticks with close >= open). + + If \a twoColored is false, the normal plottable's pen and brush are used (\ref setPen, \ref + setBrush). + + \see setBrushNegative, setPenPositive, setPenNegative +*/ +void QCPFinancial::setBrushPositive(const QBrush &brush) +{ + mBrushPositive = brush; +} + +/*! + If \ref setTwoColored is set to true, this function controls the brush that is used to draw fills + of data points with a negative trend (i.e. bars/candlesticks with close < open). + + If \a twoColored is false, the normal plottable's pen and brush are used (\ref setPen, \ref + setBrush). + + \see setBrushPositive, setPenNegative, setPenPositive +*/ +void QCPFinancial::setBrushNegative(const QBrush &brush) +{ + mBrushNegative = brush; +} + +/*! + If \ref setTwoColored is set to true, this function controls the pen that is used to draw + outlines of data points with a positive trend (i.e. bars/candlesticks with close >= open). + + If \a twoColored is false, the normal plottable's pen and brush are used (\ref setPen, \ref + setBrush). + + \see setPenNegative, setBrushPositive, setBrushNegative +*/ +void QCPFinancial::setPenPositive(const QPen &pen) +{ + mPenPositive = pen; +} + +/*! + If \ref setTwoColored is set to true, this function controls the pen that is used to draw + outlines of data points with a negative trend (i.e. bars/candlesticks with close < open). + + If \a twoColored is false, the normal plottable's pen and brush are used (\ref setPen, \ref + setBrush). + + \see setPenPositive, setBrushNegative, setBrushPositive +*/ +void QCPFinancial::setPenNegative(const QPen &pen) +{ + mPenNegative = pen; +} + +/*! \overload + + Adds the provided points in \a keys, \a open, \a high, \a low and \a close to the current data. + The provided vectors should have equal length. Else, the number of added points will be the size + of the smallest vector. + + If you can guarantee that the passed data points are sorted by \a keys in ascending order, you + can set \a alreadySorted to true, to improve performance by saving a sorting run. + + Alternatively, you can also access and modify the data directly via the \ref data method, which + returns a pointer to the internal data container. + + \see timeSeriesToOhlc +*/ +void QCPFinancial::addData(const QVector &keys, const QVector &open, const QVector &high, const QVector &low, const QVector &close, bool alreadySorted) +{ + if (keys.size() != open.size() || open.size() != high.size() || high.size() != low.size() || low.size() != close.size() || close.size() != keys.size()) + qDebug() << Q_FUNC_INFO << "keys, open, high, low, close have different sizes:" << keys.size() << open.size() << high.size() << low.size() << close.size(); + const int n = qMin(keys.size(), qMin(open.size(), qMin(high.size(), qMin(low.size(), close.size())))); + QVector tempData(n); + QVector::iterator it = tempData.begin(); + const QVector::iterator itEnd = tempData.end(); + int i = 0; + while (it != itEnd) + { + it->key = keys[i]; + it->open = open[i]; + it->high = high[i]; + it->low = low[i]; + it->close = close[i]; + ++it; + ++i; + } + mDataContainer->add(tempData, alreadySorted); // don't modify tempData beyond this to prevent copy on write +} + +/*! \overload + + Adds the provided data point as \a key, \a open, \a high, \a low and \a close to the current + data. + + Alternatively, you can also access and modify the data directly via the \ref data method, which + returns a pointer to the internal data container. + + \see timeSeriesToOhlc +*/ +void QCPFinancial::addData(double key, double open, double high, double low, double close) +{ + mDataContainer->add(QCPFinancialData(key, open, high, low, close)); +} + +/*! + \copydoc QCPPlottableInterface1D::selectTestRect +*/ +QCPDataSelection QCPFinancial::selectTestRect(const QRectF &rect, bool onlySelectable) const +{ + QCPDataSelection result; + if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) + return result; + if (!mKeyAxis || !mValueAxis) + return result; + + QCPFinancialDataContainer::const_iterator visibleBegin, visibleEnd; + getVisibleDataBounds(visibleBegin, visibleEnd); + + for (QCPFinancialDataContainer::const_iterator it=visibleBegin; it!=visibleEnd; ++it) + { + if (rect.intersects(selectionHitBox(it))) + result.addDataRange(QCPDataRange(it-mDataContainer->constBegin(), it-mDataContainer->constBegin()+1), false); + } + result.simplify(); + return result; +} + +/*! + Implements a selectTest specific to this plottable's point geometry. + + If \a details is not 0, it will be set to a \ref QCPDataSelection, describing the closest data + point to \a pos. + + \seebaseclassmethod \ref QCPAbstractPlottable::selectTest +*/ +double QCPFinancial::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) + return -1; + if (!mKeyAxis || !mValueAxis) + return -1; + + if (mKeyAxis.data()->axisRect()->rect().contains(pos.toPoint())) + { + // get visible data range: + QCPFinancialDataContainer::const_iterator visibleBegin, visibleEnd; + QCPFinancialDataContainer::const_iterator closestDataPoint = mDataContainer->constEnd(); + getVisibleDataBounds(visibleBegin, visibleEnd); + // perform select test according to configured style: + double result = -1; + switch (mChartStyle) + { + case QCPFinancial::csOhlc: + result = ohlcSelectTest(pos, visibleBegin, visibleEnd, closestDataPoint); break; + case QCPFinancial::csCandlestick: + result = candlestickSelectTest(pos, visibleBegin, visibleEnd, closestDataPoint); break; + } + if (details) + { + int pointIndex = closestDataPoint-mDataContainer->constBegin(); + details->setValue(QCPDataSelection(QCPDataRange(pointIndex, pointIndex+1))); + } + return result; + } + + return -1; +} + +/* inherits documentation from base class */ +QCPRange QCPFinancial::getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain) const +{ + QCPRange range = mDataContainer->keyRange(foundRange, inSignDomain); + // determine exact range by including width of bars/flags: + if (foundRange) + { + if (inSignDomain != QCP::sdPositive || range.lower-mWidth*0.5 > 0) + range.lower -= mWidth*0.5; + if (inSignDomain != QCP::sdNegative || range.upper+mWidth*0.5 < 0) + range.upper += mWidth*0.5; + } + return range; +} + +/* inherits documentation from base class */ +QCPRange QCPFinancial::getValueRange(bool &foundRange, QCP::SignDomain inSignDomain, const QCPRange &inKeyRange) const +{ + return mDataContainer->valueRange(foundRange, inSignDomain, inKeyRange); +} + +/*! + A convenience function that converts time series data (\a value against \a time) to OHLC binned + data points. The return value can then be passed on to \ref QCPFinancialDataContainer::set(const + QCPFinancialDataContainer&). + + The size of the bins can be controlled with \a timeBinSize in the same units as \a time is given. + For example, if the unit of \a time is seconds and single OHLC/Candlesticks should span an hour + each, set \a timeBinSize to 3600. + + \a timeBinOffset allows to control precisely at what \a time coordinate a bin should start. The + value passed as \a timeBinOffset doesn't need to be in the range encompassed by the \a time keys. + It merely defines the mathematical offset/phase of the bins that will be used to process the + data. +*/ +QCPFinancialDataContainer QCPFinancial::timeSeriesToOhlc(const QVector &time, const QVector &value, double timeBinSize, double timeBinOffset) +{ + QCPFinancialDataContainer data; + int count = qMin(time.size(), value.size()); + if (count == 0) + return QCPFinancialDataContainer(); + + QCPFinancialData currentBinData(0, value.first(), value.first(), value.first(), value.first()); + int currentBinIndex = qFloor((time.first()-timeBinOffset)/timeBinSize+0.5); + for (int i=0; i currentBinData.high) currentBinData.high = value.at(i); + if (i == count-1) // last data point is in current bin, finalize bin: + { + currentBinData.close = value.at(i); + currentBinData.key = timeBinOffset+(index)*timeBinSize; + data.add(currentBinData); + } + } else // data point not anymore in current bin, set close of old and open of new bin, and add old to map: + { + // finalize current bin: + currentBinData.close = value.at(i-1); + currentBinData.key = timeBinOffset+(index-1)*timeBinSize; + data.add(currentBinData); + // start next bin: + currentBinIndex = index; + currentBinData.open = value.at(i); + currentBinData.high = value.at(i); + currentBinData.low = value.at(i); + } + } + + return data; +} + +/* inherits documentation from base class */ +void QCPFinancial::draw(QCPPainter *painter) +{ + // get visible data range: + QCPFinancialDataContainer::const_iterator visibleBegin, visibleEnd; + getVisibleDataBounds(visibleBegin, visibleEnd); + + // loop over and draw segments of unselected/selected data: + QList selectedSegments, unselectedSegments, allSegments; + getDataSegments(selectedSegments, unselectedSegments); + allSegments << unselectedSegments << selectedSegments; + for (int i=0; i= unselectedSegments.size(); + QCPFinancialDataContainer::const_iterator begin = visibleBegin; + QCPFinancialDataContainer::const_iterator end = visibleEnd; + mDataContainer->limitIteratorsToDataRange(begin, end, allSegments.at(i)); + if (begin == end) + continue; + + // draw data segment according to configured style: + switch (mChartStyle) + { + case QCPFinancial::csOhlc: + drawOhlcPlot(painter, begin, end, isSelectedSegment); break; + case QCPFinancial::csCandlestick: + drawCandlestickPlot(painter, begin, end, isSelectedSegment); break; + } + } + + // draw other selection decoration that isn't just line/scatter pens and brushes: + if (mSelectionDecorator) + mSelectionDecorator->drawDecoration(painter, selection()); +} + +/* inherits documentation from base class */ +void QCPFinancial::drawLegendIcon(QCPPainter *painter, const QRectF &rect) const +{ + painter->setAntialiasing(false); // legend icon especially of csCandlestick looks better without antialiasing + if (mChartStyle == csOhlc) + { + if (mTwoColored) + { + // draw upper left half icon with positive color: + painter->setBrush(mBrushPositive); + painter->setPen(mPenPositive); + painter->setClipRegion(QRegion(QPolygon() << rect.bottomLeft().toPoint() << rect.topRight().toPoint() << rect.topLeft().toPoint())); + painter->drawLine(QLineF(0, rect.height()*0.5, rect.width(), rect.height()*0.5).translated(rect.topLeft())); + painter->drawLine(QLineF(rect.width()*0.2, rect.height()*0.3, rect.width()*0.2, rect.height()*0.5).translated(rect.topLeft())); + painter->drawLine(QLineF(rect.width()*0.8, rect.height()*0.5, rect.width()*0.8, rect.height()*0.7).translated(rect.topLeft())); + // draw bottom right half icon with negative color: + painter->setBrush(mBrushNegative); + painter->setPen(mPenNegative); + painter->setClipRegion(QRegion(QPolygon() << rect.bottomLeft().toPoint() << rect.topRight().toPoint() << rect.bottomRight().toPoint())); + painter->drawLine(QLineF(0, rect.height()*0.5, rect.width(), rect.height()*0.5).translated(rect.topLeft())); + painter->drawLine(QLineF(rect.width()*0.2, rect.height()*0.3, rect.width()*0.2, rect.height()*0.5).translated(rect.topLeft())); + painter->drawLine(QLineF(rect.width()*0.8, rect.height()*0.5, rect.width()*0.8, rect.height()*0.7).translated(rect.topLeft())); + } else + { + painter->setBrush(mBrush); + painter->setPen(mPen); + painter->drawLine(QLineF(0, rect.height()*0.5, rect.width(), rect.height()*0.5).translated(rect.topLeft())); + painter->drawLine(QLineF(rect.width()*0.2, rect.height()*0.3, rect.width()*0.2, rect.height()*0.5).translated(rect.topLeft())); + painter->drawLine(QLineF(rect.width()*0.8, rect.height()*0.5, rect.width()*0.8, rect.height()*0.7).translated(rect.topLeft())); + } + } else if (mChartStyle == csCandlestick) + { + if (mTwoColored) + { + // draw upper left half icon with positive color: + painter->setBrush(mBrushPositive); + painter->setPen(mPenPositive); + painter->setClipRegion(QRegion(QPolygon() << rect.bottomLeft().toPoint() << rect.topRight().toPoint() << rect.topLeft().toPoint())); + painter->drawLine(QLineF(0, rect.height()*0.5, rect.width()*0.25, rect.height()*0.5).translated(rect.topLeft())); + painter->drawLine(QLineF(rect.width()*0.75, rect.height()*0.5, rect.width(), rect.height()*0.5).translated(rect.topLeft())); + painter->drawRect(QRectF(rect.width()*0.25, rect.height()*0.25, rect.width()*0.5, rect.height()*0.5).translated(rect.topLeft())); + // draw bottom right half icon with negative color: + painter->setBrush(mBrushNegative); + painter->setPen(mPenNegative); + painter->setClipRegion(QRegion(QPolygon() << rect.bottomLeft().toPoint() << rect.topRight().toPoint() << rect.bottomRight().toPoint())); + painter->drawLine(QLineF(0, rect.height()*0.5, rect.width()*0.25, rect.height()*0.5).translated(rect.topLeft())); + painter->drawLine(QLineF(rect.width()*0.75, rect.height()*0.5, rect.width(), rect.height()*0.5).translated(rect.topLeft())); + painter->drawRect(QRectF(rect.width()*0.25, rect.height()*0.25, rect.width()*0.5, rect.height()*0.5).translated(rect.topLeft())); + } else + { + painter->setBrush(mBrush); + painter->setPen(mPen); + painter->drawLine(QLineF(0, rect.height()*0.5, rect.width()*0.25, rect.height()*0.5).translated(rect.topLeft())); + painter->drawLine(QLineF(rect.width()*0.75, rect.height()*0.5, rect.width(), rect.height()*0.5).translated(rect.topLeft())); + painter->drawRect(QRectF(rect.width()*0.25, rect.height()*0.25, rect.width()*0.5, rect.height()*0.5).translated(rect.topLeft())); + } + } +} + +/*! \internal + + Draws the data from \a begin to \a end-1 as OHLC bars with the provided \a painter. + + This method is a helper function for \ref draw. It is used when the chart style is \ref csOhlc. +*/ +void QCPFinancial::drawOhlcPlot(QCPPainter *painter, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, bool isSelected) +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + + if (keyAxis->orientation() == Qt::Horizontal) + { + for (QCPFinancialDataContainer::const_iterator it = begin; it != end; ++it) + { + if (isSelected && mSelectionDecorator) + mSelectionDecorator->applyPen(painter); + else if (mTwoColored) + painter->setPen(it->close >= it->open ? mPenPositive : mPenNegative); + else + painter->setPen(mPen); + double keyPixel = keyAxis->coordToPixel(it->key); + double openPixel = valueAxis->coordToPixel(it->open); + double closePixel = valueAxis->coordToPixel(it->close); + // draw backbone: + painter->drawLine(QPointF(keyPixel, valueAxis->coordToPixel(it->high)), QPointF(keyPixel, valueAxis->coordToPixel(it->low))); + // draw open: + double pixelWidth = getPixelWidth(it->key, keyPixel); // sign of this makes sure open/close are on correct sides + painter->drawLine(QPointF(keyPixel-pixelWidth, openPixel), QPointF(keyPixel, openPixel)); + // draw close: + painter->drawLine(QPointF(keyPixel, closePixel), QPointF(keyPixel+pixelWidth, closePixel)); + } + } else + { + for (QCPFinancialDataContainer::const_iterator it = begin; it != end; ++it) + { + if (isSelected && mSelectionDecorator) + mSelectionDecorator->applyPen(painter); + else if (mTwoColored) + painter->setPen(it->close >= it->open ? mPenPositive : mPenNegative); + else + painter->setPen(mPen); + double keyPixel = keyAxis->coordToPixel(it->key); + double openPixel = valueAxis->coordToPixel(it->open); + double closePixel = valueAxis->coordToPixel(it->close); + // draw backbone: + painter->drawLine(QPointF(valueAxis->coordToPixel(it->high), keyPixel), QPointF(valueAxis->coordToPixel(it->low), keyPixel)); + // draw open: + double pixelWidth = getPixelWidth(it->key, keyPixel); // sign of this makes sure open/close are on correct sides + painter->drawLine(QPointF(openPixel, keyPixel-pixelWidth), QPointF(openPixel, keyPixel)); + // draw close: + painter->drawLine(QPointF(closePixel, keyPixel), QPointF(closePixel, keyPixel+pixelWidth)); + } + } +} + +/*! \internal + + Draws the data from \a begin to \a end-1 as Candlesticks with the provided \a painter. + + This method is a helper function for \ref draw. It is used when the chart style is \ref csCandlestick. +*/ +void QCPFinancial::drawCandlestickPlot(QCPPainter *painter, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, bool isSelected) +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + + if (keyAxis->orientation() == Qt::Horizontal) + { + for (QCPFinancialDataContainer::const_iterator it = begin; it != end; ++it) + { + if (isSelected && mSelectionDecorator) + { + mSelectionDecorator->applyPen(painter); + mSelectionDecorator->applyBrush(painter); + } else if (mTwoColored) + { + painter->setPen(it->close >= it->open ? mPenPositive : mPenNegative); + painter->setBrush(it->close >= it->open ? mBrushPositive : mBrushNegative); + } else + { + painter->setPen(mPen); + painter->setBrush(mBrush); + } + double keyPixel = keyAxis->coordToPixel(it->key); + double openPixel = valueAxis->coordToPixel(it->open); + double closePixel = valueAxis->coordToPixel(it->close); + // draw high: + painter->drawLine(QPointF(keyPixel, valueAxis->coordToPixel(it->high)), QPointF(keyPixel, valueAxis->coordToPixel(qMax(it->open, it->close)))); + // draw low: + painter->drawLine(QPointF(keyPixel, valueAxis->coordToPixel(it->low)), QPointF(keyPixel, valueAxis->coordToPixel(qMin(it->open, it->close)))); + // draw open-close box: + double pixelWidth = getPixelWidth(it->key, keyPixel); + painter->drawRect(QRectF(QPointF(keyPixel-pixelWidth, closePixel), QPointF(keyPixel+pixelWidth, openPixel))); + } + } else // keyAxis->orientation() == Qt::Vertical + { + for (QCPFinancialDataContainer::const_iterator it = begin; it != end; ++it) + { + if (isSelected && mSelectionDecorator) + { + mSelectionDecorator->applyPen(painter); + mSelectionDecorator->applyBrush(painter); + } else if (mTwoColored) + { + painter->setPen(it->close >= it->open ? mPenPositive : mPenNegative); + painter->setBrush(it->close >= it->open ? mBrushPositive : mBrushNegative); + } else + { + painter->setPen(mPen); + painter->setBrush(mBrush); + } + double keyPixel = keyAxis->coordToPixel(it->key); + double openPixel = valueAxis->coordToPixel(it->open); + double closePixel = valueAxis->coordToPixel(it->close); + // draw high: + painter->drawLine(QPointF(valueAxis->coordToPixel(it->high), keyPixel), QPointF(valueAxis->coordToPixel(qMax(it->open, it->close)), keyPixel)); + // draw low: + painter->drawLine(QPointF(valueAxis->coordToPixel(it->low), keyPixel), QPointF(valueAxis->coordToPixel(qMin(it->open, it->close)), keyPixel)); + // draw open-close box: + double pixelWidth = getPixelWidth(it->key, keyPixel); + painter->drawRect(QRectF(QPointF(closePixel, keyPixel-pixelWidth), QPointF(openPixel, keyPixel+pixelWidth))); + } + } +} + +/*! \internal + + This function is used to determine the width of the bar at coordinate \a key, according to the + specified width (\ref setWidth) and width type (\ref setWidthType). Provide the pixel position of + \a key in \a keyPixel (because usually this was already calculated via \ref QCPAxis::coordToPixel + when this function is called). + + It returns the number of pixels the bar extends to higher keys, relative to the \a key + coordinate. So with a non-reversed horizontal axis, the return value is positive. With a reversed + horizontal axis, the return value is negative. This is important so the open/close flags on the + \ref csOhlc bar are drawn to the correct side. +*/ +double QCPFinancial::getPixelWidth(double key, double keyPixel) const +{ + double result = 0; + switch (mWidthType) + { + case wtAbsolute: + { + if (mKeyAxis) + result = mWidth*0.5*mKeyAxis.data()->pixelOrientation(); + break; + } + case wtAxisRectRatio: + { + if (mKeyAxis && mKeyAxis.data()->axisRect()) + { + if (mKeyAxis.data()->orientation() == Qt::Horizontal) + result = mKeyAxis.data()->axisRect()->width()*mWidth*0.5*mKeyAxis.data()->pixelOrientation(); + else + result = mKeyAxis.data()->axisRect()->height()*mWidth*0.5*mKeyAxis.data()->pixelOrientation(); + } else + qDebug() << Q_FUNC_INFO << "No key axis or axis rect defined"; + break; + } + case wtPlotCoords: + { + if (mKeyAxis) + result = mKeyAxis.data()->coordToPixel(key+mWidth*0.5)-keyPixel; + else + qDebug() << Q_FUNC_INFO << "No key axis defined"; + break; + } + } + return result; +} + +/*! \internal + + This method is a helper function for \ref selectTest. It is used to test for selection when the + chart style is \ref csOhlc. It only tests against the data points between \a begin and \a end. + + Like \ref selectTest, this method returns the shortest distance of \a pos to the graphical + representation of the plottable, and \a closestDataPoint will point to the respective data point. +*/ +double QCPFinancial::ohlcSelectTest(const QPointF &pos, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, QCPFinancialDataContainer::const_iterator &closestDataPoint) const +{ + closestDataPoint = mDataContainer->constEnd(); + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return -1; } + + double minDistSqr = (std::numeric_limits::max)(); + if (keyAxis->orientation() == Qt::Horizontal) + { + for (QCPFinancialDataContainer::const_iterator it=begin; it!=end; ++it) + { + double keyPixel = keyAxis->coordToPixel(it->key); + // calculate distance to backbone: + double currentDistSqr = QCPVector2D(pos).distanceSquaredToLine(QCPVector2D(keyPixel, valueAxis->coordToPixel(it->high)), QCPVector2D(keyPixel, valueAxis->coordToPixel(it->low))); + if (currentDistSqr < minDistSqr) + { + minDistSqr = currentDistSqr; + closestDataPoint = it; + } + } + } else // keyAxis->orientation() == Qt::Vertical + { + for (QCPFinancialDataContainer::const_iterator it=begin; it!=end; ++it) + { + double keyPixel = keyAxis->coordToPixel(it->key); + // calculate distance to backbone: + double currentDistSqr = QCPVector2D(pos).distanceSquaredToLine(QCPVector2D(valueAxis->coordToPixel(it->high), keyPixel), QCPVector2D(valueAxis->coordToPixel(it->low), keyPixel)); + if (currentDistSqr < minDistSqr) + { + minDistSqr = currentDistSqr; + closestDataPoint = it; + } + } + } + return qSqrt(minDistSqr); +} + +/*! \internal + + This method is a helper function for \ref selectTest. It is used to test for selection when the + chart style is \ref csCandlestick. It only tests against the data points between \a begin and \a + end. + + Like \ref selectTest, this method returns the shortest distance of \a pos to the graphical + representation of the plottable, and \a closestDataPoint will point to the respective data point. +*/ +double QCPFinancial::candlestickSelectTest(const QPointF &pos, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, QCPFinancialDataContainer::const_iterator &closestDataPoint) const +{ + closestDataPoint = mDataContainer->constEnd(); + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return -1; } + + double minDistSqr = (std::numeric_limits::max)(); + if (keyAxis->orientation() == Qt::Horizontal) + { + for (QCPFinancialDataContainer::const_iterator it=begin; it!=end; ++it) + { + double currentDistSqr; + // determine whether pos is in open-close-box: + QCPRange boxKeyRange(it->key-mWidth*0.5, it->key+mWidth*0.5); + QCPRange boxValueRange(it->close, it->open); + double posKey, posValue; + pixelsToCoords(pos, posKey, posValue); + if (boxKeyRange.contains(posKey) && boxValueRange.contains(posValue)) // is in open-close-box + { + currentDistSqr = mParentPlot->selectionTolerance()*0.99 * mParentPlot->selectionTolerance()*0.99; + } else + { + // calculate distance to high/low lines: + double keyPixel = keyAxis->coordToPixel(it->key); + double highLineDistSqr = QCPVector2D(pos).distanceSquaredToLine(QCPVector2D(keyPixel, valueAxis->coordToPixel(it->high)), QCPVector2D(keyPixel, valueAxis->coordToPixel(qMax(it->open, it->close)))); + double lowLineDistSqr = QCPVector2D(pos).distanceSquaredToLine(QCPVector2D(keyPixel, valueAxis->coordToPixel(it->low)), QCPVector2D(keyPixel, valueAxis->coordToPixel(qMin(it->open, it->close)))); + currentDistSqr = qMin(highLineDistSqr, lowLineDistSqr); + } + if (currentDistSqr < minDistSqr) + { + minDistSqr = currentDistSqr; + closestDataPoint = it; + } + } + } else // keyAxis->orientation() == Qt::Vertical + { + for (QCPFinancialDataContainer::const_iterator it=begin; it!=end; ++it) + { + double currentDistSqr; + // determine whether pos is in open-close-box: + QCPRange boxKeyRange(it->key-mWidth*0.5, it->key+mWidth*0.5); + QCPRange boxValueRange(it->close, it->open); + double posKey, posValue; + pixelsToCoords(pos, posKey, posValue); + if (boxKeyRange.contains(posKey) && boxValueRange.contains(posValue)) // is in open-close-box + { + currentDistSqr = mParentPlot->selectionTolerance()*0.99 * mParentPlot->selectionTolerance()*0.99; + } else + { + // calculate distance to high/low lines: + double keyPixel = keyAxis->coordToPixel(it->key); + double highLineDistSqr = QCPVector2D(pos).distanceSquaredToLine(QCPVector2D(valueAxis->coordToPixel(it->high), keyPixel), QCPVector2D(valueAxis->coordToPixel(qMax(it->open, it->close)), keyPixel)); + double lowLineDistSqr = QCPVector2D(pos).distanceSquaredToLine(QCPVector2D(valueAxis->coordToPixel(it->low), keyPixel), QCPVector2D(valueAxis->coordToPixel(qMin(it->open, it->close)), keyPixel)); + currentDistSqr = qMin(highLineDistSqr, lowLineDistSqr); + } + if (currentDistSqr < minDistSqr) + { + minDistSqr = currentDistSqr; + closestDataPoint = it; + } + } + } + return qSqrt(minDistSqr); +} + +/*! \internal + + called by the drawing methods to determine which data (key) range is visible at the current key + axis range setting, so only that needs to be processed. + + \a begin returns an iterator to the lowest data point that needs to be taken into account when + plotting. Note that in order to get a clean plot all the way to the edge of the axis rect, \a + begin may still be just outside the visible range. + + \a end returns the iterator just above the highest data point that needs to be taken into + account. Same as before, \a end may also lie just outside of the visible range + + if the plottable contains no data, both \a begin and \a end point to \c constEnd. +*/ +void QCPFinancial::getVisibleDataBounds(QCPFinancialDataContainer::const_iterator &begin, QCPFinancialDataContainer::const_iterator &end) const +{ + if (!mKeyAxis) + { + qDebug() << Q_FUNC_INFO << "invalid key axis"; + begin = mDataContainer->constEnd(); + end = mDataContainer->constEnd(); + return; + } + begin = mDataContainer->findBegin(mKeyAxis.data()->range().lower-mWidth*0.5); // subtract half width of ohlc/candlestick to include partially visible data points + end = mDataContainer->findEnd(mKeyAxis.data()->range().upper+mWidth*0.5); // add half width of ohlc/candlestick to include partially visible data points +} + +/*! \internal + + Returns the hit box in pixel coordinates that will be used for data selection with the selection + rect (\ref selectTestRect), of the data point given by \a it. +*/ +QRectF QCPFinancial::selectionHitBox(QCPFinancialDataContainer::const_iterator it) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return QRectF(); } + + double keyPixel = keyAxis->coordToPixel(it->key); + double highPixel = valueAxis->coordToPixel(it->high); + double lowPixel = valueAxis->coordToPixel(it->low); + double keyWidthPixels = keyPixel-keyAxis->coordToPixel(it->key-mWidth*0.5); + if (keyAxis->orientation() == Qt::Horizontal) + return QRectF(keyPixel-keyWidthPixels, highPixel, keyWidthPixels*2, lowPixel-highPixel).normalized(); + else + return QRectF(highPixel, keyPixel-keyWidthPixels, lowPixel-highPixel, keyWidthPixels*2).normalized(); +} +/* end of 'src/plottables/plottable-financial.cpp' */ + + +/* including file 'src/plottables/plottable-errorbar.cpp', size 37570 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPErrorBarsData +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPErrorBarsData + \brief Holds the data of one single error bar for QCPErrorBars. + + The stored data is: + \li \a errorMinus: how much the error bar extends towards negative coordinates from the data + point position + \li \a errorPlus: how much the error bar extends towards positive coordinates from the data point + position + + The container for storing the error bar information is \ref QCPErrorBarsDataContainer. It is a + typedef for QVector<\ref QCPErrorBarsData>. + + \see QCPErrorBarsDataContainer +*/ + +/*! + Constructs an error bar with errors set to zero. +*/ +QCPErrorBarsData::QCPErrorBarsData() : + errorMinus(0), + errorPlus(0) +{ +} + +/*! + Constructs an error bar with equal \a error in both negative and positive direction. +*/ +QCPErrorBarsData::QCPErrorBarsData(double error) : + errorMinus(error), + errorPlus(error) +{ +} + +/*! + Constructs an error bar with negative and positive errors set to \a errorMinus and \a errorPlus, + respectively. +*/ +QCPErrorBarsData::QCPErrorBarsData(double errorMinus, double errorPlus) : + errorMinus(errorMinus), + errorPlus(errorPlus) +{ +} + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPErrorBars +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPErrorBars + \brief A plottable that adds a set of error bars to other plottables. + + \image html QCPErrorBars.png + + The \ref QCPErrorBars plottable can be attached to other one-dimensional plottables (e.g. \ref + QCPGraph, \ref QCPCurve, \ref QCPBars, etc.) and equips them with error bars. + + Use \ref setDataPlottable to define for which plottable the \ref QCPErrorBars shall display the + error bars. The orientation of the error bars can be controlled with \ref setErrorType. + + By using \ref setData, you can supply the actual error data, either as symmetric error or + plus/minus asymmetric errors. \ref QCPErrorBars only stores the error data. The absolute + key/value position of each error bar will be adopted from the configured data plottable. The + error data of the \ref QCPErrorBars are associated one-to-one via their index to the data points + of the data plottable. You can directly access and manipulate the error bar data via \ref data. + + Set either of the plus/minus errors to NaN (qQNaN() or + std::numeric_limits::quiet_NaN()) to not show the respective error bar on the data point at + that index. + + \section qcperrorbars-appearance Changing the appearance + + The appearance of the error bars is defined by the pen (\ref setPen), and the width of the + whiskers (\ref setWhiskerWidth). Further, the error bar backbones may leave a gap around the data + point center to prevent that error bars are drawn too close to or even through scatter points. + This gap size can be controlled via \ref setSymbolGap. +*/ + +/* start of documentation of inline functions */ + +/*! \fn QSharedPointer QCPErrorBars::data() const + + Returns a shared pointer to the internal data storage of type \ref QCPErrorBarsDataContainer. You + may use it to directly manipulate the error values, which may be more convenient and faster than + using the regular \ref setData methods. +*/ + +/* end of documentation of inline functions */ + +/*! + Constructs an error bars plottable which uses \a keyAxis as its key axis ("x") and \a valueAxis as its value + axis ("y"). \a keyAxis and \a valueAxis must reside in the same QCustomPlot instance and not have + the same orientation. If either of these restrictions is violated, a corresponding message is + printed to the debug output (qDebug), the construction is not aborted, though. + + It is also important that the \a keyAxis and \a valueAxis are the same for the error bars + plottable and the data plottable that the error bars shall be drawn on (\ref setDataPlottable). + + The created \ref QCPErrorBars is automatically registered with the QCustomPlot instance inferred + from \a keyAxis. This QCustomPlot instance takes ownership of the \ref QCPErrorBars, so do not + delete it manually but use \ref QCustomPlot::removePlottable() instead. +*/ +QCPErrorBars::QCPErrorBars(QCPAxis *keyAxis, QCPAxis *valueAxis) : + QCPAbstractPlottable(keyAxis, valueAxis), + mDataContainer(new QVector), + mErrorType(etValueError), + mWhiskerWidth(9), + mSymbolGap(10) +{ + setPen(QPen(Qt::black, 0)); + setBrush(Qt::NoBrush); +} + +QCPErrorBars::~QCPErrorBars() +{ +} + +/*! \overload + + Replaces the current data container with the provided \a data container. + + Since a QSharedPointer is used, multiple \ref QCPErrorBars instances may share the same data + container safely. Modifying the data in the container will then affect all \ref QCPErrorBars + instances that share the container. Sharing can be achieved by simply exchanging the data + containers wrapped in shared pointers: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcperrorbars-datasharing-1 + + If you do not wish to share containers, but create a copy from an existing container, assign the + data containers directly: + \snippet documentation/doc-code-snippets/mainwindow.cpp qcperrorbars-datasharing-2 + (This uses different notation compared with other plottables, because the \ref QCPErrorBars + uses a \c QVector as its data container, instead of a \ref QCPDataContainer.) + + \see addData +*/ +void QCPErrorBars::setData(QSharedPointer data) +{ + mDataContainer = data; +} + +/*! \overload + + Sets symmetrical error values as specified in \a error. The errors will be associated one-to-one + by the data point index to the associated data plottable (\ref setDataPlottable). + + You can directly access and manipulate the error bar data via \ref data. + + \see addData +*/ +void QCPErrorBars::setData(const QVector &error) +{ + mDataContainer->clear(); + addData(error); +} + +/*! \overload + + Sets asymmetrical errors as specified in \a errorMinus and \a errorPlus. The errors will be + associated one-to-one by the data point index to the associated data plottable (\ref + setDataPlottable). + + You can directly access and manipulate the error bar data via \ref data. + + \see addData +*/ +void QCPErrorBars::setData(const QVector &errorMinus, const QVector &errorPlus) +{ + mDataContainer->clear(); + addData(errorMinus, errorPlus); +} + +/*! + Sets the data plottable to which the error bars will be applied. The error values specified e.g. + via \ref setData will be associated one-to-one by the data point index to the data points of \a + plottable. This means that the error bars will adopt the key/value coordinates of the data point + with the same index. + + The passed \a plottable must be a one-dimensional plottable, i.e. it must implement the \ref + QCPPlottableInterface1D. Further, it must not be a \ref QCPErrorBars instance itself. If either + of these restrictions is violated, a corresponding qDebug output is generated, and the data + plottable of this \ref QCPErrorBars instance is set to zero. + + For proper display, care must also be taken that the key and value axes of the \a plottable match + those configured for this \ref QCPErrorBars instance. +*/ +void QCPErrorBars::setDataPlottable(QCPAbstractPlottable *plottable) +{ + if (plottable && qobject_cast(plottable)) + { + mDataPlottable = 0; + qDebug() << Q_FUNC_INFO << "can't set another QCPErrorBars instance as data plottable"; + return; + } + if (plottable && !plottable->interface1D()) + { + mDataPlottable = 0; + qDebug() << Q_FUNC_INFO << "passed plottable doesn't implement 1d interface, can't associate with QCPErrorBars"; + return; + } + + mDataPlottable = plottable; +} + +/*! + Sets in which orientation the error bars shall appear on the data points. If your data needs both + error dimensions, create two \ref QCPErrorBars with different \a type. +*/ +void QCPErrorBars::setErrorType(ErrorType type) +{ + mErrorType = type; +} + +/*! + Sets the width of the whiskers (the short bars at the end of the actual error bar backbones) to + \a pixels. +*/ +void QCPErrorBars::setWhiskerWidth(double pixels) +{ + mWhiskerWidth = pixels; +} + +/*! + Sets the gap diameter around the data points that will be left out when drawing the error bar + backbones. This gap prevents that error bars are drawn too close to or even through scatter + points. +*/ +void QCPErrorBars::setSymbolGap(double pixels) +{ + mSymbolGap = pixels; +} + +/*! \overload + + Adds symmetrical error values as specified in \a error. The errors will be associated one-to-one + by the data point index to the associated data plottable (\ref setDataPlottable). + + You can directly access and manipulate the error bar data via \ref data. + + \see setData +*/ +void QCPErrorBars::addData(const QVector &error) +{ + addData(error, error); +} + +/*! \overload + + Adds asymmetrical errors as specified in \a errorMinus and \a errorPlus. The errors will be + associated one-to-one by the data point index to the associated data plottable (\ref + setDataPlottable). + + You can directly access and manipulate the error bar data via \ref data. + + \see setData +*/ +void QCPErrorBars::addData(const QVector &errorMinus, const QVector &errorPlus) +{ + if (errorMinus.size() != errorPlus.size()) + qDebug() << Q_FUNC_INFO << "minus and plus error vectors have different sizes:" << errorMinus.size() << errorPlus.size(); + const int n = qMin(errorMinus.size(), errorPlus.size()); + mDataContainer->reserve(n); + for (int i=0; iappend(QCPErrorBarsData(errorMinus.at(i), errorPlus.at(i))); +} + +/*! \overload + + Adds a single symmetrical error bar as specified in \a error. The errors will be associated + one-to-one by the data point index to the associated data plottable (\ref setDataPlottable). + + You can directly access and manipulate the error bar data via \ref data. + + \see setData +*/ +void QCPErrorBars::addData(double error) +{ + mDataContainer->append(QCPErrorBarsData(error)); +} + +/*! \overload + + Adds a single asymmetrical error bar as specified in \a errorMinus and \a errorPlus. The errors + will be associated one-to-one by the data point index to the associated data plottable (\ref + setDataPlottable). + + You can directly access and manipulate the error bar data via \ref data. + + \see setData +*/ +void QCPErrorBars::addData(double errorMinus, double errorPlus) +{ + mDataContainer->append(QCPErrorBarsData(errorMinus, errorPlus)); +} + +/* inherits documentation from base class */ +int QCPErrorBars::dataCount() const +{ + return mDataContainer->size(); +} + +/* inherits documentation from base class */ +double QCPErrorBars::dataMainKey(int index) const +{ + if (mDataPlottable) + return mDataPlottable->interface1D()->dataMainKey(index); + else + qDebug() << Q_FUNC_INFO << "no data plottable set"; + return 0; +} + +/* inherits documentation from base class */ +double QCPErrorBars::dataSortKey(int index) const +{ + if (mDataPlottable) + return mDataPlottable->interface1D()->dataSortKey(index); + else + qDebug() << Q_FUNC_INFO << "no data plottable set"; + return 0; +} + +/* inherits documentation from base class */ +double QCPErrorBars::dataMainValue(int index) const +{ + if (mDataPlottable) + return mDataPlottable->interface1D()->dataMainValue(index); + else + qDebug() << Q_FUNC_INFO << "no data plottable set"; + return 0; +} + +/* inherits documentation from base class */ +QCPRange QCPErrorBars::dataValueRange(int index) const +{ + if (mDataPlottable) + { + const double value = mDataPlottable->interface1D()->dataMainValue(index); + if (index >= 0 && index < mDataContainer->size() && mErrorType == etValueError) + return QCPRange(value-mDataContainer->at(index).errorMinus, value+mDataContainer->at(index).errorPlus); + else + return QCPRange(value, value); + } else + { + qDebug() << Q_FUNC_INFO << "no data plottable set"; + return QCPRange(); + } +} + +/* inherits documentation from base class */ +QPointF QCPErrorBars::dataPixelPosition(int index) const +{ + if (mDataPlottable) + return mDataPlottable->interface1D()->dataPixelPosition(index); + else + qDebug() << Q_FUNC_INFO << "no data plottable set"; + return QPointF(); +} + +/* inherits documentation from base class */ +bool QCPErrorBars::sortKeyIsMainKey() const +{ + if (mDataPlottable) + { + return mDataPlottable->interface1D()->sortKeyIsMainKey(); + } else + { + qDebug() << Q_FUNC_INFO << "no data plottable set"; + return true; + } +} + +/*! + \copydoc QCPPlottableInterface1D::selectTestRect +*/ +QCPDataSelection QCPErrorBars::selectTestRect(const QRectF &rect, bool onlySelectable) const +{ + QCPDataSelection result; + if (!mDataPlottable) + return result; + if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) + return result; + if (!mKeyAxis || !mValueAxis) + return result; + + QCPErrorBarsDataContainer::const_iterator visibleBegin, visibleEnd; + getVisibleDataBounds(visibleBegin, visibleEnd, QCPDataRange(0, dataCount())); + + QVector backbones, whiskers; + for (QCPErrorBarsDataContainer::const_iterator it=visibleBegin; it!=visibleEnd; ++it) + { + backbones.clear(); + whiskers.clear(); + getErrorBarLines(it, backbones, whiskers); + for (int i=0; iconstBegin(), it-mDataContainer->constBegin()+1), false); + break; + } + } + } + result.simplify(); + return result; +} + +/* inherits documentation from base class */ +int QCPErrorBars::findBegin(double sortKey, bool expandedRange) const +{ + if (mDataPlottable) + { + if (mDataContainer->isEmpty()) + return 0; + int beginIndex = mDataPlottable->interface1D()->findBegin(sortKey, expandedRange); + if (beginIndex >= mDataContainer->size()) + beginIndex = mDataContainer->size()-1; + return beginIndex; + } else + qDebug() << Q_FUNC_INFO << "no data plottable set"; + return 0; +} + +/* inherits documentation from base class */ +int QCPErrorBars::findEnd(double sortKey, bool expandedRange) const +{ + if (mDataPlottable) + { + if (mDataContainer->isEmpty()) + return 0; + int endIndex = mDataPlottable->interface1D()->findEnd(sortKey, expandedRange); + if (endIndex > mDataContainer->size()) + endIndex = mDataContainer->size(); + return endIndex; + } else + qDebug() << Q_FUNC_INFO << "no data plottable set"; + return 0; +} + +/*! + Implements a selectTest specific to this plottable's point geometry. + + If \a details is not 0, it will be set to a \ref QCPDataSelection, describing the closest data + point to \a pos. + + \seebaseclassmethod \ref QCPAbstractPlottable::selectTest +*/ +double QCPErrorBars::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + if (!mDataPlottable) return -1; + + if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) + return -1; + if (!mKeyAxis || !mValueAxis) + return -1; + + if (mKeyAxis.data()->axisRect()->rect().contains(pos.toPoint())) + { + QCPErrorBarsDataContainer::const_iterator closestDataPoint = mDataContainer->constEnd(); + double result = pointDistance(pos, closestDataPoint); + if (details) + { + int pointIndex = closestDataPoint-mDataContainer->constBegin(); + details->setValue(QCPDataSelection(QCPDataRange(pointIndex, pointIndex+1))); + } + return result; + } else + return -1; +} + +/* inherits documentation from base class */ +void QCPErrorBars::draw(QCPPainter *painter) +{ + if (!mDataPlottable) return; + if (!mKeyAxis || !mValueAxis) { qDebug() << Q_FUNC_INFO << "invalid key or value axis"; return; } + if (mKeyAxis.data()->range().size() <= 0 || mDataContainer->isEmpty()) return; + + // if the sort key isn't the main key, we must check the visibility for each data point/error bar individually + // (getVisibleDataBounds applies range restriction, but otherwise can only return full data range): + bool checkPointVisibility = !mDataPlottable->interface1D()->sortKeyIsMainKey(); + + // check data validity if flag set: +#ifdef QCUSTOMPLOT_CHECK_DATA + QCPErrorBarsDataContainer::const_iterator it; + for (it = mDataContainer->constBegin(); it != mDataContainer->constEnd(); ++it) + { + if (QCP::isInvalidData(it->errorMinus, it->errorPlus)) + qDebug() << Q_FUNC_INFO << "Data point at index" << it-mDataContainer->constBegin() << "invalid." << "Plottable name:" << name(); + } +#endif + + applyDefaultAntialiasingHint(painter); + painter->setBrush(Qt::NoBrush); + // loop over and draw segments of unselected/selected data: + QList selectedSegments, unselectedSegments, allSegments; + getDataSegments(selectedSegments, unselectedSegments); + allSegments << unselectedSegments << selectedSegments; + QVector backbones, whiskers; + for (int i=0; i= unselectedSegments.size(); + if (isSelectedSegment && mSelectionDecorator) + mSelectionDecorator->applyPen(painter); + else + painter->setPen(mPen); + if (painter->pen().capStyle() == Qt::SquareCap) + { + QPen capFixPen(painter->pen()); + capFixPen.setCapStyle(Qt::FlatCap); + painter->setPen(capFixPen); + } + backbones.clear(); + whiskers.clear(); + for (QCPErrorBarsDataContainer::const_iterator it=begin; it!=end; ++it) + { + if (!checkPointVisibility || errorBarVisible(it-mDataContainer->constBegin())) + getErrorBarLines(it, backbones, whiskers); + } + painter->drawLines(backbones); + painter->drawLines(whiskers); + } + + // draw other selection decoration that isn't just line/scatter pens and brushes: + if (mSelectionDecorator) + mSelectionDecorator->drawDecoration(painter, selection()); +} + +/* inherits documentation from base class */ +void QCPErrorBars::drawLegendIcon(QCPPainter *painter, const QRectF &rect) const +{ + applyDefaultAntialiasingHint(painter); + painter->setPen(mPen); + if (mErrorType == etValueError && mValueAxis && mValueAxis->orientation() == Qt::Vertical) + { + painter->drawLine(QLineF(rect.center().x(), rect.top()+2, rect.center().x(), rect.bottom()-1)); + painter->drawLine(QLineF(rect.center().x()-4, rect.top()+2, rect.center().x()+4, rect.top()+2)); + painter->drawLine(QLineF(rect.center().x()-4, rect.bottom()-1, rect.center().x()+4, rect.bottom()-1)); + } else + { + painter->drawLine(QLineF(rect.left()+2, rect.center().y(), rect.right()-2, rect.center().y())); + painter->drawLine(QLineF(rect.left()+2, rect.center().y()-4, rect.left()+2, rect.center().y()+4)); + painter->drawLine(QLineF(rect.right()-2, rect.center().y()-4, rect.right()-2, rect.center().y()+4)); + } +} + +/* inherits documentation from base class */ +QCPRange QCPErrorBars::getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain) const +{ + if (!mDataPlottable) + { + foundRange = false; + return QCPRange(); + } + + QCPRange range; + bool haveLower = false; + bool haveUpper = false; + QCPErrorBarsDataContainer::const_iterator it; + for (it = mDataContainer->constBegin(); it != mDataContainer->constEnd(); ++it) + { + if (mErrorType == etValueError) + { + // error bar doesn't extend in key dimension (except whisker but we ignore that here), so only use data point center + const double current = mDataPlottable->interface1D()->dataMainKey(it-mDataContainer->constBegin()); + if (qIsNaN(current)) continue; + if (inSignDomain == QCP::sdBoth || (inSignDomain == QCP::sdNegative && current < 0) || (inSignDomain == QCP::sdPositive && current > 0)) + { + if (current < range.lower || !haveLower) + { + range.lower = current; + haveLower = true; + } + if (current > range.upper || !haveUpper) + { + range.upper = current; + haveUpper = true; + } + } + } else // mErrorType == etKeyError + { + const double dataKey = mDataPlottable->interface1D()->dataMainKey(it-mDataContainer->constBegin()); + if (qIsNaN(dataKey)) continue; + // plus error: + double current = dataKey + (qIsNaN(it->errorPlus) ? 0 : it->errorPlus); + if (inSignDomain == QCP::sdBoth || (inSignDomain == QCP::sdNegative && current < 0) || (inSignDomain == QCP::sdPositive && current > 0)) + { + if (current > range.upper || !haveUpper) + { + range.upper = current; + haveUpper = true; + } + } + // minus error: + current = dataKey - (qIsNaN(it->errorMinus) ? 0 : it->errorMinus); + if (inSignDomain == QCP::sdBoth || (inSignDomain == QCP::sdNegative && current < 0) || (inSignDomain == QCP::sdPositive && current > 0)) + { + if (current < range.lower || !haveLower) + { + range.lower = current; + haveLower = true; + } + } + } + } + + if (haveUpper && !haveLower) + { + range.lower = range.upper; + haveLower = true; + } else if (haveLower && !haveUpper) + { + range.upper = range.lower; + haveUpper = true; + } + + foundRange = haveLower && haveUpper; + return range; +} + +/* inherits documentation from base class */ +QCPRange QCPErrorBars::getValueRange(bool &foundRange, QCP::SignDomain inSignDomain, const QCPRange &inKeyRange) const +{ + if (!mDataPlottable) + { + foundRange = false; + return QCPRange(); + } + + QCPRange range; + const bool restrictKeyRange = inKeyRange != QCPRange(); + bool haveLower = false; + bool haveUpper = false; + QCPErrorBarsDataContainer::const_iterator itBegin = mDataContainer->constBegin(); + QCPErrorBarsDataContainer::const_iterator itEnd = mDataContainer->constEnd(); + if (mDataPlottable->interface1D()->sortKeyIsMainKey() && restrictKeyRange) + { + itBegin = mDataContainer->constBegin()+findBegin(inKeyRange.lower); + itEnd = mDataContainer->constBegin()+findEnd(inKeyRange.upper); + } + for (QCPErrorBarsDataContainer::const_iterator it = itBegin; it != itEnd; ++it) + { + if (restrictKeyRange) + { + const double dataKey = mDataPlottable->interface1D()->dataMainKey(it-mDataContainer->constBegin()); + if (dataKey < inKeyRange.lower || dataKey > inKeyRange.upper) + continue; + } + if (mErrorType == etValueError) + { + const double dataValue = mDataPlottable->interface1D()->dataMainValue(it-mDataContainer->constBegin()); + if (qIsNaN(dataValue)) continue; + // plus error: + double current = dataValue + (qIsNaN(it->errorPlus) ? 0 : it->errorPlus); + if (inSignDomain == QCP::sdBoth || (inSignDomain == QCP::sdNegative && current < 0) || (inSignDomain == QCP::sdPositive && current > 0)) + { + if (current > range.upper || !haveUpper) + { + range.upper = current; + haveUpper = true; + } + } + // minus error: + current = dataValue - (qIsNaN(it->errorMinus) ? 0 : it->errorMinus); + if (inSignDomain == QCP::sdBoth || (inSignDomain == QCP::sdNegative && current < 0) || (inSignDomain == QCP::sdPositive && current > 0)) + { + if (current < range.lower || !haveLower) + { + range.lower = current; + haveLower = true; + } + } + } else // mErrorType == etKeyError + { + // error bar doesn't extend in value dimension (except whisker but we ignore that here), so only use data point center + const double current = mDataPlottable->interface1D()->dataMainValue(it-mDataContainer->constBegin()); + if (qIsNaN(current)) continue; + if (inSignDomain == QCP::sdBoth || (inSignDomain == QCP::sdNegative && current < 0) || (inSignDomain == QCP::sdPositive && current > 0)) + { + if (current < range.lower || !haveLower) + { + range.lower = current; + haveLower = true; + } + if (current > range.upper || !haveUpper) + { + range.upper = current; + haveUpper = true; + } + } + } + } + + if (haveUpper && !haveLower) + { + range.lower = range.upper; + haveLower = true; + } else if (haveLower && !haveUpper) + { + range.upper = range.lower; + haveUpper = true; + } + + foundRange = haveLower && haveUpper; + return range; +} + +/*! \internal + + Calculates the lines that make up the error bar belonging to the data point \a it. + + The resulting lines are added to \a backbones and \a whiskers. The vectors are not cleared, so + calling this method with different \a it but the same \a backbones and \a whiskers allows to + accumulate lines for multiple data points. + + This method assumes that \a it is a valid iterator within the bounds of this \ref QCPErrorBars + instance and within the bounds of the associated data plottable. +*/ +void QCPErrorBars::getErrorBarLines(QCPErrorBarsDataContainer::const_iterator it, QVector &backbones, QVector &whiskers) const +{ + if (!mDataPlottable) return; + + int index = it-mDataContainer->constBegin(); + QPointF centerPixel = mDataPlottable->interface1D()->dataPixelPosition(index); + if (qIsNaN(centerPixel.x()) || qIsNaN(centerPixel.y())) + return; + QCPAxis *errorAxis = mErrorType == etValueError ? mValueAxis.data() : mKeyAxis.data(); + QCPAxis *orthoAxis = mErrorType == etValueError ? mKeyAxis.data() : mValueAxis.data(); + const double centerErrorAxisPixel = errorAxis->orientation() == Qt::Horizontal ? centerPixel.x() : centerPixel.y(); + const double centerOrthoAxisPixel = orthoAxis->orientation() == Qt::Horizontal ? centerPixel.x() : centerPixel.y(); + const double centerErrorAxisCoord = errorAxis->pixelToCoord(centerErrorAxisPixel); // depending on plottable, this might be different from just mDataPlottable->interface1D()->dataMainKey/Value + const double symbolGap = mSymbolGap*0.5*errorAxis->pixelOrientation(); + // plus error: + double errorStart, errorEnd; + if (!qIsNaN(it->errorPlus)) + { + errorStart = centerErrorAxisPixel+symbolGap; + errorEnd = errorAxis->coordToPixel(centerErrorAxisCoord+it->errorPlus); + if (errorAxis->orientation() == Qt::Vertical) + { + if ((errorStart > errorEnd) != errorAxis->rangeReversed()) + backbones.append(QLineF(centerOrthoAxisPixel, errorStart, centerOrthoAxisPixel, errorEnd)); + whiskers.append(QLineF(centerOrthoAxisPixel-mWhiskerWidth*0.5, errorEnd, centerOrthoAxisPixel+mWhiskerWidth*0.5, errorEnd)); + } else + { + if ((errorStart < errorEnd) != errorAxis->rangeReversed()) + backbones.append(QLineF(errorStart, centerOrthoAxisPixel, errorEnd, centerOrthoAxisPixel)); + whiskers.append(QLineF(errorEnd, centerOrthoAxisPixel-mWhiskerWidth*0.5, errorEnd, centerOrthoAxisPixel+mWhiskerWidth*0.5)); + } + } + // minus error: + if (!qIsNaN(it->errorMinus)) + { + errorStart = centerErrorAxisPixel-symbolGap; + errorEnd = errorAxis->coordToPixel(centerErrorAxisCoord-it->errorMinus); + if (errorAxis->orientation() == Qt::Vertical) + { + if ((errorStart < errorEnd) != errorAxis->rangeReversed()) + backbones.append(QLineF(centerOrthoAxisPixel, errorStart, centerOrthoAxisPixel, errorEnd)); + whiskers.append(QLineF(centerOrthoAxisPixel-mWhiskerWidth*0.5, errorEnd, centerOrthoAxisPixel+mWhiskerWidth*0.5, errorEnd)); + } else + { + if ((errorStart > errorEnd) != errorAxis->rangeReversed()) + backbones.append(QLineF(errorStart, centerOrthoAxisPixel, errorEnd, centerOrthoAxisPixel)); + whiskers.append(QLineF(errorEnd, centerOrthoAxisPixel-mWhiskerWidth*0.5, errorEnd, centerOrthoAxisPixel+mWhiskerWidth*0.5)); + } + } +} + +/*! \internal + + This method outputs the currently visible data range via \a begin and \a end. The returned range + will also never exceed \a rangeRestriction. + + Since error bars with type \ref etKeyError may extend to arbitrarily positive and negative key + coordinates relative to their data point key, this method checks all outer error bars whether + they truly don't reach into the visible portion of the axis rect, by calling \ref + errorBarVisible. On the other hand error bars with type \ref etValueError that are associated + with data plottables whose sort key is equal to the main key (see \ref qcpdatacontainer-datatype + "QCPDataContainer DataType") can be handled very efficiently by finding the visible range of + error bars through binary search (\ref QCPPlottableInterface1D::findBegin and \ref + QCPPlottableInterface1D::findEnd). + + If the plottable's sort key is not equal to the main key, this method returns the full data + range, only restricted by \a rangeRestriction. Drawing optimization then has to be done on a + point-by-point basis in the \ref draw method. +*/ +void QCPErrorBars::getVisibleDataBounds(QCPErrorBarsDataContainer::const_iterator &begin, QCPErrorBarsDataContainer::const_iterator &end, const QCPDataRange &rangeRestriction) const +{ + QCPAxis *keyAxis = mKeyAxis.data(); + QCPAxis *valueAxis = mValueAxis.data(); + if (!keyAxis || !valueAxis) + { + qDebug() << Q_FUNC_INFO << "invalid key or value axis"; + end = mDataContainer->constEnd(); + begin = end; + return; + } + if (!mDataPlottable || rangeRestriction.isEmpty()) + { + end = mDataContainer->constEnd(); + begin = end; + return; + } + if (!mDataPlottable->interface1D()->sortKeyIsMainKey()) + { + // if the sort key isn't the main key, it's not possible to find a contiguous range of visible + // data points, so this method then only applies the range restriction and otherwise returns + // the full data range. Visibility checks must be done on a per-datapoin-basis during drawing + QCPDataRange dataRange(0, mDataContainer->size()); + dataRange = dataRange.bounded(rangeRestriction); + begin = mDataContainer->constBegin()+dataRange.begin(); + end = mDataContainer->constBegin()+dataRange.end(); + return; + } + + // get visible data range via interface from data plottable, and then restrict to available error data points: + const int n = qMin(mDataContainer->size(), mDataPlottable->interface1D()->dataCount()); + int beginIndex = mDataPlottable->interface1D()->findBegin(keyAxis->range().lower); + int endIndex = mDataPlottable->interface1D()->findEnd(keyAxis->range().upper); + int i = beginIndex; + while (i > 0 && i < n && i > rangeRestriction.begin()) + { + if (errorBarVisible(i)) + beginIndex = i; + --i; + } + i = endIndex; + while (i >= 0 && i < n && i < rangeRestriction.end()) + { + if (errorBarVisible(i)) + endIndex = i+1; + ++i; + } + QCPDataRange dataRange(beginIndex, endIndex); + dataRange = dataRange.bounded(rangeRestriction.bounded(QCPDataRange(0, mDataContainer->size()))); + begin = mDataContainer->constBegin()+dataRange.begin(); + end = mDataContainer->constBegin()+dataRange.end(); +} + +/*! \internal + + Calculates the minimum distance in pixels the error bars' representation has from the given \a + pixelPoint. This is used to determine whether the error bar was clicked or not, e.g. in \ref + selectTest. The closest data point to \a pixelPoint is returned in \a closestData. +*/ +double QCPErrorBars::pointDistance(const QPointF &pixelPoint, QCPErrorBarsDataContainer::const_iterator &closestData) const +{ + closestData = mDataContainer->constEnd(); + if (!mDataPlottable || mDataContainer->isEmpty()) + return -1.0; + if (!mKeyAxis || !mValueAxis) + { + qDebug() << Q_FUNC_INFO << "invalid key or value axis"; + return -1.0; + } + + QCPErrorBarsDataContainer::const_iterator begin, end; + getVisibleDataBounds(begin, end, QCPDataRange(0, dataCount())); + + // calculate minimum distances to error backbones (whiskers are ignored for speed) and find closestData iterator: + double minDistSqr = (std::numeric_limits::max)(); + QVector backbones, whiskers; + for (QCPErrorBarsDataContainer::const_iterator it=begin; it!=end; ++it) + { + getErrorBarLines(it, backbones, whiskers); + for (int i=0; i &selectedSegments, QList &unselectedSegments) const +{ + selectedSegments.clear(); + unselectedSegments.clear(); + if (mSelectable == QCP::stWhole) // stWhole selection type draws the entire plottable with selected style if mSelection isn't empty + { + if (selected()) + selectedSegments << QCPDataRange(0, dataCount()); + else + unselectedSegments << QCPDataRange(0, dataCount()); + } else + { + QCPDataSelection sel(selection()); + sel.simplify(); + selectedSegments = sel.dataRanges(); + unselectedSegments = sel.inverse(QCPDataRange(0, dataCount())).dataRanges(); + } +} + +/*! \internal + + Returns whether the error bar at the specified \a index is visible within the current key axis + range. + + This method assumes for performance reasons without checking that the key axis, the value axis, + and the data plottable (\ref setDataPlottable) are not zero and that \a index is within valid + bounds of this \ref QCPErrorBars instance and the bounds of the data plottable. +*/ +bool QCPErrorBars::errorBarVisible(int index) const +{ + QPointF centerPixel = mDataPlottable->interface1D()->dataPixelPosition(index); + const double centerKeyPixel = mKeyAxis->orientation() == Qt::Horizontal ? centerPixel.x() : centerPixel.y(); + if (qIsNaN(centerKeyPixel)) + return false; + + double keyMin, keyMax; + if (mErrorType == etKeyError) + { + const double centerKey = mKeyAxis->pixelToCoord(centerKeyPixel); + const double errorPlus = mDataContainer->at(index).errorPlus; + const double errorMinus = mDataContainer->at(index).errorMinus; + keyMax = centerKey+(qIsNaN(errorPlus) ? 0 : errorPlus); + keyMin = centerKey-(qIsNaN(errorMinus) ? 0 : errorMinus); + } else // mErrorType == etValueError + { + keyMax = mKeyAxis->pixelToCoord(centerKeyPixel+mWhiskerWidth*0.5*mKeyAxis->pixelOrientation()); + keyMin = mKeyAxis->pixelToCoord(centerKeyPixel-mWhiskerWidth*0.5*mKeyAxis->pixelOrientation()); + } + return ((keyMax > mKeyAxis->range().lower) && (keyMin < mKeyAxis->range().upper)); +} + +/*! \internal + + Returns whether \a line intersects (or is contained in) \a pixelRect. + + \a line is assumed to be either perfectly horizontal or perfectly vertical, as is the case for + error bar lines. +*/ +bool QCPErrorBars::rectIntersectsLine(const QRectF &pixelRect, const QLineF &line) const +{ + if (pixelRect.left() > line.x1() && pixelRect.left() > line.x2()) + return false; + else if (pixelRect.right() < line.x1() && pixelRect.right() < line.x2()) + return false; + else if (pixelRect.top() > line.y1() && pixelRect.top() > line.y2()) + return false; + else if (pixelRect.bottom() < line.y1() && pixelRect.bottom() < line.y2()) + return false; + else + return true; +} +/* end of 'src/plottables/plottable-errorbar.cpp' */ + + +/* including file 'src/items/item-straightline.cpp', size 7592 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemStraightLine +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemStraightLine + \brief A straight line that spans infinitely in both directions + + \image html QCPItemStraightLine.png "Straight line example. Blue dotted circles are anchors, solid blue discs are positions." + + It has two positions, \a point1 and \a point2, which define the straight line. +*/ + +/*! + Creates a straight line item and sets default values. + + The created item is automatically registered with \a parentPlot. This QCustomPlot instance takes + ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead. +*/ +QCPItemStraightLine::QCPItemStraightLine(QCustomPlot *parentPlot) : + QCPAbstractItem(parentPlot), + point1(createPosition(QLatin1String("point1"))), + point2(createPosition(QLatin1String("point2"))) +{ + point1->setCoords(0, 0); + point2->setCoords(1, 1); + + setPen(QPen(Qt::black)); + setSelectedPen(QPen(Qt::blue,2)); +} + +QCPItemStraightLine::~QCPItemStraightLine() +{ +} + +/*! + Sets the pen that will be used to draw the line + + \see setSelectedPen +*/ +void QCPItemStraightLine::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the pen that will be used to draw the line when selected + + \see setPen, setSelected +*/ +void QCPItemStraightLine::setSelectedPen(const QPen &pen) +{ + mSelectedPen = pen; +} + +/* inherits documentation from base class */ +double QCPItemStraightLine::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + + return QCPVector2D(pos).distanceToStraightLine(point1->pixelPosition(), point2->pixelPosition()-point1->pixelPosition()); +} + +/* inherits documentation from base class */ +void QCPItemStraightLine::draw(QCPPainter *painter) +{ + QCPVector2D start(point1->pixelPosition()); + QCPVector2D end(point2->pixelPosition()); + // get visible segment of straight line inside clipRect: + double clipPad = mainPen().widthF(); + QLineF line = getRectClippedStraightLine(start, end-start, clipRect().adjusted(-clipPad, -clipPad, clipPad, clipPad)); + // paint visible segment, if existent: + if (!line.isNull()) + { + painter->setPen(mainPen()); + painter->drawLine(line); + } +} + +/*! \internal + + Returns the section of the straight line defined by \a base and direction vector \a + vec, that is visible in the specified \a rect. + + This is a helper function for \ref draw. +*/ +QLineF QCPItemStraightLine::getRectClippedStraightLine(const QCPVector2D &base, const QCPVector2D &vec, const QRect &rect) const +{ + double bx, by; + double gamma; + QLineF result; + if (vec.x() == 0 && vec.y() == 0) + return result; + if (qFuzzyIsNull(vec.x())) // line is vertical + { + // check top of rect: + bx = rect.left(); + by = rect.top(); + gamma = base.x()-bx + (by-base.y())*vec.x()/vec.y(); + if (gamma >= 0 && gamma <= rect.width()) + result.setLine(bx+gamma, rect.top(), bx+gamma, rect.bottom()); // no need to check bottom because we know line is vertical + } else if (qFuzzyIsNull(vec.y())) // line is horizontal + { + // check left of rect: + bx = rect.left(); + by = rect.top(); + gamma = base.y()-by + (bx-base.x())*vec.y()/vec.x(); + if (gamma >= 0 && gamma <= rect.height()) + result.setLine(rect.left(), by+gamma, rect.right(), by+gamma); // no need to check right because we know line is horizontal + } else // line is skewed + { + QList pointVectors; + // check top of rect: + bx = rect.left(); + by = rect.top(); + gamma = base.x()-bx + (by-base.y())*vec.x()/vec.y(); + if (gamma >= 0 && gamma <= rect.width()) + pointVectors.append(QCPVector2D(bx+gamma, by)); + // check bottom of rect: + bx = rect.left(); + by = rect.bottom(); + gamma = base.x()-bx + (by-base.y())*vec.x()/vec.y(); + if (gamma >= 0 && gamma <= rect.width()) + pointVectors.append(QCPVector2D(bx+gamma, by)); + // check left of rect: + bx = rect.left(); + by = rect.top(); + gamma = base.y()-by + (bx-base.x())*vec.y()/vec.x(); + if (gamma >= 0 && gamma <= rect.height()) + pointVectors.append(QCPVector2D(bx, by+gamma)); + // check right of rect: + bx = rect.right(); + by = rect.top(); + gamma = base.y()-by + (bx-base.x())*vec.y()/vec.x(); + if (gamma >= 0 && gamma <= rect.height()) + pointVectors.append(QCPVector2D(bx, by+gamma)); + + // evaluate points: + if (pointVectors.size() == 2) + { + result.setPoints(pointVectors.at(0).toPointF(), pointVectors.at(1).toPointF()); + } else if (pointVectors.size() > 2) + { + // line probably goes through corner of rect, and we got two points there. single out the point pair with greatest distance: + double distSqrMax = 0; + QCPVector2D pv1, pv2; + for (int i=0; i distSqrMax) + { + pv1 = pointVectors.at(i); + pv2 = pointVectors.at(k); + distSqrMax = distSqr; + } + } + } + result.setPoints(pv1.toPointF(), pv2.toPointF()); + } + } + return result; +} + +/*! \internal + + Returns the pen that should be used for drawing lines. Returns mPen when the + item is not selected and mSelectedPen when it is. +*/ +QPen QCPItemStraightLine::mainPen() const +{ + return mSelected ? mSelectedPen : mPen; +} +/* end of 'src/items/item-straightline.cpp' */ + + +/* including file 'src/items/item-line.cpp', size 8498 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemLine +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemLine + \brief A line from one point to another + + \image html QCPItemLine.png "Line example. Blue dotted circles are anchors, solid blue discs are positions." + + It has two positions, \a start and \a end, which define the end points of the line. + + With \ref setHead and \ref setTail you may set different line ending styles, e.g. to create an arrow. +*/ + +/*! + Creates a line item and sets default values. + + The created item is automatically registered with \a parentPlot. This QCustomPlot instance takes + ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead. +*/ +QCPItemLine::QCPItemLine(QCustomPlot *parentPlot) : + QCPAbstractItem(parentPlot), + start(createPosition(QLatin1String("start"))), + end(createPosition(QLatin1String("end"))) +{ + start->setCoords(0, 0); + end->setCoords(1, 1); + + setPen(QPen(Qt::black)); + setSelectedPen(QPen(Qt::blue,2)); +} + +QCPItemLine::~QCPItemLine() +{ +} + +/*! + Sets the pen that will be used to draw the line + + \see setSelectedPen +*/ +void QCPItemLine::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the pen that will be used to draw the line when selected + + \see setPen, setSelected +*/ +void QCPItemLine::setSelectedPen(const QPen &pen) +{ + mSelectedPen = pen; +} + +/*! + Sets the line ending style of the head. The head corresponds to the \a end position. + + Note that due to the overloaded QCPLineEnding constructor, you may directly specify + a QCPLineEnding::EndingStyle here, e.g. \code setHead(QCPLineEnding::esSpikeArrow) \endcode + + \see setTail +*/ +void QCPItemLine::setHead(const QCPLineEnding &head) +{ + mHead = head; +} + +/*! + Sets the line ending style of the tail. The tail corresponds to the \a start position. + + Note that due to the overloaded QCPLineEnding constructor, you may directly specify + a QCPLineEnding::EndingStyle here, e.g. \code setTail(QCPLineEnding::esSpikeArrow) \endcode + + \see setHead +*/ +void QCPItemLine::setTail(const QCPLineEnding &tail) +{ + mTail = tail; +} + +/* inherits documentation from base class */ +double QCPItemLine::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + + return qSqrt(QCPVector2D(pos).distanceSquaredToLine(start->pixelPosition(), end->pixelPosition())); +} + +/* inherits documentation from base class */ +void QCPItemLine::draw(QCPPainter *painter) +{ + QCPVector2D startVec(start->pixelPosition()); + QCPVector2D endVec(end->pixelPosition()); + if (qFuzzyIsNull((startVec-endVec).lengthSquared())) + return; + // get visible segment of straight line inside clipRect: + double clipPad = qMax(mHead.boundingDistance(), mTail.boundingDistance()); + clipPad = qMax(clipPad, (double)mainPen().widthF()); + QLineF line = getRectClippedLine(startVec, endVec, clipRect().adjusted(-clipPad, -clipPad, clipPad, clipPad)); + // paint visible segment, if existent: + if (!line.isNull()) + { + painter->setPen(mainPen()); + painter->drawLine(line); + painter->setBrush(Qt::SolidPattern); + if (mTail.style() != QCPLineEnding::esNone) + mTail.draw(painter, startVec, startVec-endVec); + if (mHead.style() != QCPLineEnding::esNone) + mHead.draw(painter, endVec, endVec-startVec); + } +} + +/*! \internal + + Returns the section of the line defined by \a start and \a end, that is visible in the specified + \a rect. + + This is a helper function for \ref draw. +*/ +QLineF QCPItemLine::getRectClippedLine(const QCPVector2D &start, const QCPVector2D &end, const QRect &rect) const +{ + bool containsStart = rect.contains(start.x(), start.y()); + bool containsEnd = rect.contains(end.x(), end.y()); + if (containsStart && containsEnd) + return QLineF(start.toPointF(), end.toPointF()); + + QCPVector2D base = start; + QCPVector2D vec = end-start; + double bx, by; + double gamma, mu; + QLineF result; + QList pointVectors; + + if (!qFuzzyIsNull(vec.y())) // line is not horizontal + { + // check top of rect: + bx = rect.left(); + by = rect.top(); + mu = (by-base.y())/vec.y(); + if (mu >= 0 && mu <= 1) + { + gamma = base.x()-bx + mu*vec.x(); + if (gamma >= 0 && gamma <= rect.width()) + pointVectors.append(QCPVector2D(bx+gamma, by)); + } + // check bottom of rect: + bx = rect.left(); + by = rect.bottom(); + mu = (by-base.y())/vec.y(); + if (mu >= 0 && mu <= 1) + { + gamma = base.x()-bx + mu*vec.x(); + if (gamma >= 0 && gamma <= rect.width()) + pointVectors.append(QCPVector2D(bx+gamma, by)); + } + } + if (!qFuzzyIsNull(vec.x())) // line is not vertical + { + // check left of rect: + bx = rect.left(); + by = rect.top(); + mu = (bx-base.x())/vec.x(); + if (mu >= 0 && mu <= 1) + { + gamma = base.y()-by + mu*vec.y(); + if (gamma >= 0 && gamma <= rect.height()) + pointVectors.append(QCPVector2D(bx, by+gamma)); + } + // check right of rect: + bx = rect.right(); + by = rect.top(); + mu = (bx-base.x())/vec.x(); + if (mu >= 0 && mu <= 1) + { + gamma = base.y()-by + mu*vec.y(); + if (gamma >= 0 && gamma <= rect.height()) + pointVectors.append(QCPVector2D(bx, by+gamma)); + } + } + + if (containsStart) + pointVectors.append(start); + if (containsEnd) + pointVectors.append(end); + + // evaluate points: + if (pointVectors.size() == 2) + { + result.setPoints(pointVectors.at(0).toPointF(), pointVectors.at(1).toPointF()); + } else if (pointVectors.size() > 2) + { + // line probably goes through corner of rect, and we got two points there. single out the point pair with greatest distance: + double distSqrMax = 0; + QCPVector2D pv1, pv2; + for (int i=0; i distSqrMax) + { + pv1 = pointVectors.at(i); + pv2 = pointVectors.at(k); + distSqrMax = distSqr; + } + } + } + result.setPoints(pv1.toPointF(), pv2.toPointF()); + } + return result; +} + +/*! \internal + + Returns the pen that should be used for drawing lines. Returns mPen when the + item is not selected and mSelectedPen when it is. +*/ +QPen QCPItemLine::mainPen() const +{ + return mSelected ? mSelectedPen : mPen; +} +/* end of 'src/items/item-line.cpp' */ + + +/* including file 'src/items/item-curve.cpp', size 7248 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemCurve +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemCurve + \brief A curved line from one point to another + + \image html QCPItemCurve.png "Curve example. Blue dotted circles are anchors, solid blue discs are positions." + + It has four positions, \a start and \a end, which define the end points of the line, and two + control points which define the direction the line exits from the start and the direction from + which it approaches the end: \a startDir and \a endDir. + + With \ref setHead and \ref setTail you may set different line ending styles, e.g. to create an + arrow. + + Often it is desirable for the control points to stay at fixed relative positions to the start/end + point. This can be achieved by setting the parent anchor e.g. of \a startDir simply to \a start, + and then specify the desired pixel offset with QCPItemPosition::setCoords on \a startDir. +*/ + +/*! + Creates a curve item and sets default values. + + The created item is automatically registered with \a parentPlot. This QCustomPlot instance takes + ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead. +*/ +QCPItemCurve::QCPItemCurve(QCustomPlot *parentPlot) : + QCPAbstractItem(parentPlot), + start(createPosition(QLatin1String("start"))), + startDir(createPosition(QLatin1String("startDir"))), + endDir(createPosition(QLatin1String("endDir"))), + end(createPosition(QLatin1String("end"))) +{ + start->setCoords(0, 0); + startDir->setCoords(0.5, 0); + endDir->setCoords(0, 0.5); + end->setCoords(1, 1); + + setPen(QPen(Qt::black)); + setSelectedPen(QPen(Qt::blue,2)); +} + +QCPItemCurve::~QCPItemCurve() +{ +} + +/*! + Sets the pen that will be used to draw the line + + \see setSelectedPen +*/ +void QCPItemCurve::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the pen that will be used to draw the line when selected + + \see setPen, setSelected +*/ +void QCPItemCurve::setSelectedPen(const QPen &pen) +{ + mSelectedPen = pen; +} + +/*! + Sets the line ending style of the head. The head corresponds to the \a end position. + + Note that due to the overloaded QCPLineEnding constructor, you may directly specify + a QCPLineEnding::EndingStyle here, e.g. \code setHead(QCPLineEnding::esSpikeArrow) \endcode + + \see setTail +*/ +void QCPItemCurve::setHead(const QCPLineEnding &head) +{ + mHead = head; +} + +/*! + Sets the line ending style of the tail. The tail corresponds to the \a start position. + + Note that due to the overloaded QCPLineEnding constructor, you may directly specify + a QCPLineEnding::EndingStyle here, e.g. \code setTail(QCPLineEnding::esSpikeArrow) \endcode + + \see setHead +*/ +void QCPItemCurve::setTail(const QCPLineEnding &tail) +{ + mTail = tail; +} + +/* inherits documentation from base class */ +double QCPItemCurve::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + + QPointF startVec(start->pixelPosition()); + QPointF startDirVec(startDir->pixelPosition()); + QPointF endDirVec(endDir->pixelPosition()); + QPointF endVec(end->pixelPosition()); + + QPainterPath cubicPath(startVec); + cubicPath.cubicTo(startDirVec, endDirVec, endVec); + + QList polygons = cubicPath.toSubpathPolygons(); + if (polygons.isEmpty()) + return -1; + const QPolygonF polygon = polygons.first(); + QCPVector2D p(pos); + double minDistSqr = (std::numeric_limits::max)(); + for (int i=1; ipixelPosition()); + QCPVector2D startDirVec(startDir->pixelPosition()); + QCPVector2D endDirVec(endDir->pixelPosition()); + QCPVector2D endVec(end->pixelPosition()); + if ((endVec-startVec).length() > 1e10) // too large curves cause crash + return; + + QPainterPath cubicPath(startVec.toPointF()); + cubicPath.cubicTo(startDirVec.toPointF(), endDirVec.toPointF(), endVec.toPointF()); + + // paint visible segment, if existent: + QRect clip = clipRect().adjusted(-mainPen().widthF(), -mainPen().widthF(), mainPen().widthF(), mainPen().widthF()); + QRect cubicRect = cubicPath.controlPointRect().toRect(); + if (cubicRect.isEmpty()) // may happen when start and end exactly on same x or y position + cubicRect.adjust(0, 0, 1, 1); + if (clip.intersects(cubicRect)) + { + painter->setPen(mainPen()); + painter->drawPath(cubicPath); + painter->setBrush(Qt::SolidPattern); + if (mTail.style() != QCPLineEnding::esNone) + mTail.draw(painter, startVec, M_PI-cubicPath.angleAtPercent(0)/180.0*M_PI); + if (mHead.style() != QCPLineEnding::esNone) + mHead.draw(painter, endVec, -cubicPath.angleAtPercent(1)/180.0*M_PI); + } +} + +/*! \internal + + Returns the pen that should be used for drawing lines. Returns mPen when the + item is not selected and mSelectedPen when it is. +*/ +QPen QCPItemCurve::mainPen() const +{ + return mSelected ? mSelectedPen : mPen; +} +/* end of 'src/items/item-curve.cpp' */ + + +/* including file 'src/items/item-rect.cpp', size 6479 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemRect +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemRect + \brief A rectangle + + \image html QCPItemRect.png "Rectangle example. Blue dotted circles are anchors, solid blue discs are positions." + + It has two positions, \a topLeft and \a bottomRight, which define the rectangle. +*/ + +/*! + Creates a rectangle item and sets default values. + + The created item is automatically registered with \a parentPlot. This QCustomPlot instance takes + ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead. +*/ +QCPItemRect::QCPItemRect(QCustomPlot *parentPlot) : + QCPAbstractItem(parentPlot), + topLeft(createPosition(QLatin1String("topLeft"))), + bottomRight(createPosition(QLatin1String("bottomRight"))), + top(createAnchor(QLatin1String("top"), aiTop)), + topRight(createAnchor(QLatin1String("topRight"), aiTopRight)), + right(createAnchor(QLatin1String("right"), aiRight)), + bottom(createAnchor(QLatin1String("bottom"), aiBottom)), + bottomLeft(createAnchor(QLatin1String("bottomLeft"), aiBottomLeft)), + left(createAnchor(QLatin1String("left"), aiLeft)) +{ + topLeft->setCoords(0, 1); + bottomRight->setCoords(1, 0); + + setPen(QPen(Qt::black)); + setSelectedPen(QPen(Qt::blue,2)); + setBrush(Qt::NoBrush); + setSelectedBrush(Qt::NoBrush); +} + +QCPItemRect::~QCPItemRect() +{ +} + +/*! + Sets the pen that will be used to draw the line of the rectangle + + \see setSelectedPen, setBrush +*/ +void QCPItemRect::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the pen that will be used to draw the line of the rectangle when selected + + \see setPen, setSelected +*/ +void QCPItemRect::setSelectedPen(const QPen &pen) +{ + mSelectedPen = pen; +} + +/*! + Sets the brush that will be used to fill the rectangle. To disable filling, set \a brush to + Qt::NoBrush. + + \see setSelectedBrush, setPen +*/ +void QCPItemRect::setBrush(const QBrush &brush) +{ + mBrush = brush; +} + +/*! + Sets the brush that will be used to fill the rectangle when selected. To disable filling, set \a + brush to Qt::NoBrush. + + \see setBrush +*/ +void QCPItemRect::setSelectedBrush(const QBrush &brush) +{ + mSelectedBrush = brush; +} + +/* inherits documentation from base class */ +double QCPItemRect::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + + QRectF rect = QRectF(topLeft->pixelPosition(), bottomRight->pixelPosition()).normalized(); + bool filledRect = mBrush.style() != Qt::NoBrush && mBrush.color().alpha() != 0; + return rectDistance(rect, pos, filledRect); +} + +/* inherits documentation from base class */ +void QCPItemRect::draw(QCPPainter *painter) +{ + QPointF p1 = topLeft->pixelPosition(); + QPointF p2 = bottomRight->pixelPosition(); + if (p1.toPoint() == p2.toPoint()) + return; + QRectF rect = QRectF(p1, p2).normalized(); + double clipPad = mainPen().widthF(); + QRectF boundingRect = rect.adjusted(-clipPad, -clipPad, clipPad, clipPad); + if (boundingRect.intersects(clipRect())) // only draw if bounding rect of rect item is visible in cliprect + { + painter->setPen(mainPen()); + painter->setBrush(mainBrush()); + painter->drawRect(rect); + } +} + +/* inherits documentation from base class */ +QPointF QCPItemRect::anchorPixelPosition(int anchorId) const +{ + QRectF rect = QRectF(topLeft->pixelPosition(), bottomRight->pixelPosition()); + switch (anchorId) + { + case aiTop: return (rect.topLeft()+rect.topRight())*0.5; + case aiTopRight: return rect.topRight(); + case aiRight: return (rect.topRight()+rect.bottomRight())*0.5; + case aiBottom: return (rect.bottomLeft()+rect.bottomRight())*0.5; + case aiBottomLeft: return rect.bottomLeft(); + case aiLeft: return (rect.topLeft()+rect.bottomLeft())*0.5; + } + + qDebug() << Q_FUNC_INFO << "invalid anchorId" << anchorId; + return QPointF(); +} + +/*! \internal + + Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected + and mSelectedPen when it is. +*/ +QPen QCPItemRect::mainPen() const +{ + return mSelected ? mSelectedPen : mPen; +} + +/*! \internal + + Returns the brush that should be used for drawing fills of the item. Returns mBrush when the item + is not selected and mSelectedBrush when it is. +*/ +QBrush QCPItemRect::mainBrush() const +{ + return mSelected ? mSelectedBrush : mBrush; +} +/* end of 'src/items/item-rect.cpp' */ + + +/* including file 'src/items/item-text.cpp', size 13338 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemText +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemText + \brief A text label + + \image html QCPItemText.png "Text example. Blue dotted circles are anchors, solid blue discs are positions." + + Its position is defined by the member \a position and the setting of \ref setPositionAlignment. + The latter controls which part of the text rect shall be aligned with \a position. + + The text alignment itself (i.e. left, center, right) can be controlled with \ref + setTextAlignment. + + The text may be rotated around the \a position point with \ref setRotation. +*/ + +/*! + Creates a text item and sets default values. + + The created item is automatically registered with \a parentPlot. This QCustomPlot instance takes + ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead. +*/ +QCPItemText::QCPItemText(QCustomPlot *parentPlot) : + QCPAbstractItem(parentPlot), + position(createPosition(QLatin1String("position"))), + topLeft(createAnchor(QLatin1String("topLeft"), aiTopLeft)), + top(createAnchor(QLatin1String("top"), aiTop)), + topRight(createAnchor(QLatin1String("topRight"), aiTopRight)), + right(createAnchor(QLatin1String("right"), aiRight)), + bottomRight(createAnchor(QLatin1String("bottomRight"), aiBottomRight)), + bottom(createAnchor(QLatin1String("bottom"), aiBottom)), + bottomLeft(createAnchor(QLatin1String("bottomLeft"), aiBottomLeft)), + left(createAnchor(QLatin1String("left"), aiLeft)), + mText(QLatin1String("text")), + mPositionAlignment(Qt::AlignCenter), + mTextAlignment(Qt::AlignTop|Qt::AlignHCenter), + mRotation(0) +{ + position->setCoords(0, 0); + + setPen(Qt::NoPen); + setSelectedPen(Qt::NoPen); + setBrush(Qt::NoBrush); + setSelectedBrush(Qt::NoBrush); + setColor(Qt::black); + setSelectedColor(Qt::blue); +} + +QCPItemText::~QCPItemText() +{ +} + +/*! + Sets the color of the text. +*/ +void QCPItemText::setColor(const QColor &color) +{ + mColor = color; +} + +/*! + Sets the color of the text that will be used when the item is selected. +*/ +void QCPItemText::setSelectedColor(const QColor &color) +{ + mSelectedColor = color; +} + +/*! + Sets the pen that will be used do draw a rectangular border around the text. To disable the + border, set \a pen to Qt::NoPen. + + \see setSelectedPen, setBrush, setPadding +*/ +void QCPItemText::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the pen that will be used do draw a rectangular border around the text, when the item is + selected. To disable the border, set \a pen to Qt::NoPen. + + \see setPen +*/ +void QCPItemText::setSelectedPen(const QPen &pen) +{ + mSelectedPen = pen; +} + +/*! + Sets the brush that will be used do fill the background of the text. To disable the + background, set \a brush to Qt::NoBrush. + + \see setSelectedBrush, setPen, setPadding +*/ +void QCPItemText::setBrush(const QBrush &brush) +{ + mBrush = brush; +} + +/*! + Sets the brush that will be used do fill the background of the text, when the item is selected. To disable the + background, set \a brush to Qt::NoBrush. + + \see setBrush +*/ +void QCPItemText::setSelectedBrush(const QBrush &brush) +{ + mSelectedBrush = brush; +} + +/*! + Sets the font of the text. + + \see setSelectedFont, setColor +*/ +void QCPItemText::setFont(const QFont &font) +{ + mFont = font; +} + +/*! + Sets the font of the text that will be used when the item is selected. + + \see setFont +*/ +void QCPItemText::setSelectedFont(const QFont &font) +{ + mSelectedFont = font; +} + +/*! + Sets the text that will be displayed. Multi-line texts are supported by inserting a line break + character, e.g. '\n'. + + \see setFont, setColor, setTextAlignment +*/ +void QCPItemText::setText(const QString &text) +{ + mText = text; +} + +/*! + Sets which point of the text rect shall be aligned with \a position. + + Examples: + \li If \a alignment is Qt::AlignHCenter | Qt::AlignTop, the text will be positioned such + that the top of the text rect will be horizontally centered on \a position. + \li If \a alignment is Qt::AlignLeft | Qt::AlignBottom, \a position will indicate the + bottom left corner of the text rect. + + If you want to control the alignment of (multi-lined) text within the text rect, use \ref + setTextAlignment. +*/ +void QCPItemText::setPositionAlignment(Qt::Alignment alignment) +{ + mPositionAlignment = alignment; +} + +/*! + Controls how (multi-lined) text is aligned inside the text rect (typically Qt::AlignLeft, Qt::AlignCenter or Qt::AlignRight). +*/ +void QCPItemText::setTextAlignment(Qt::Alignment alignment) +{ + mTextAlignment = alignment; +} + +/*! + Sets the angle in degrees by which the text (and the text rectangle, if visible) will be rotated + around \a position. +*/ +void QCPItemText::setRotation(double degrees) +{ + mRotation = degrees; +} + +/*! + Sets the distance between the border of the text rectangle and the text. The appearance (and + visibility) of the text rectangle can be controlled with \ref setPen and \ref setBrush. +*/ +void QCPItemText::setPadding(const QMargins &padding) +{ + mPadding = padding; +} + +/* inherits documentation from base class */ +double QCPItemText::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + + // The rect may be rotated, so we transform the actual clicked pos to the rotated + // coordinate system, so we can use the normal rectDistance function for non-rotated rects: + QPointF positionPixels(position->pixelPosition()); + QTransform inputTransform; + inputTransform.translate(positionPixels.x(), positionPixels.y()); + inputTransform.rotate(-mRotation); + inputTransform.translate(-positionPixels.x(), -positionPixels.y()); + QPointF rotatedPos = inputTransform.map(pos); + QFontMetrics fontMetrics(mFont); + QRect textRect = fontMetrics.boundingRect(0, 0, 0, 0, Qt::TextDontClip|mTextAlignment, mText); + QRect textBoxRect = textRect.adjusted(-mPadding.left(), -mPadding.top(), mPadding.right(), mPadding.bottom()); + QPointF textPos = getTextDrawPoint(positionPixels, textBoxRect, mPositionAlignment); + textBoxRect.moveTopLeft(textPos.toPoint()); + + return rectDistance(textBoxRect, rotatedPos, true); +} + +/* inherits documentation from base class */ +void QCPItemText::draw(QCPPainter *painter) +{ + QPointF pos(position->pixelPosition()); + QTransform transform = painter->transform(); + transform.translate(pos.x(), pos.y()); + if (!qFuzzyIsNull(mRotation)) + transform.rotate(mRotation); + painter->setFont(mainFont()); + QRect textRect = painter->fontMetrics().boundingRect(0, 0, 0, 0, Qt::TextDontClip|mTextAlignment, mText); + QRect textBoxRect = textRect.adjusted(-mPadding.left(), -mPadding.top(), mPadding.right(), mPadding.bottom()); + QPointF textPos = getTextDrawPoint(QPointF(0, 0), textBoxRect, mPositionAlignment); // 0, 0 because the transform does the translation + textRect.moveTopLeft(textPos.toPoint()+QPoint(mPadding.left(), mPadding.top())); + textBoxRect.moveTopLeft(textPos.toPoint()); + double clipPad = mainPen().widthF(); + QRect boundingRect = textBoxRect.adjusted(-clipPad, -clipPad, clipPad, clipPad); + if (transform.mapRect(boundingRect).intersects(painter->transform().mapRect(clipRect()))) + { + painter->setTransform(transform); + if ((mainBrush().style() != Qt::NoBrush && mainBrush().color().alpha() != 0) || + (mainPen().style() != Qt::NoPen && mainPen().color().alpha() != 0)) + { + painter->setPen(mainPen()); + painter->setBrush(mainBrush()); + painter->drawRect(textBoxRect); + } + painter->setBrush(Qt::NoBrush); + painter->setPen(QPen(mainColor())); + painter->drawText(textRect, Qt::TextDontClip|mTextAlignment, mText); + } +} + +/* inherits documentation from base class */ +QPointF QCPItemText::anchorPixelPosition(int anchorId) const +{ + // get actual rect points (pretty much copied from draw function): + QPointF pos(position->pixelPosition()); + QTransform transform; + transform.translate(pos.x(), pos.y()); + if (!qFuzzyIsNull(mRotation)) + transform.rotate(mRotation); + QFontMetrics fontMetrics(mainFont()); + QRect textRect = fontMetrics.boundingRect(0, 0, 0, 0, Qt::TextDontClip|mTextAlignment, mText); + QRectF textBoxRect = textRect.adjusted(-mPadding.left(), -mPadding.top(), mPadding.right(), mPadding.bottom()); + QPointF textPos = getTextDrawPoint(QPointF(0, 0), textBoxRect, mPositionAlignment); // 0, 0 because the transform does the translation + textBoxRect.moveTopLeft(textPos.toPoint()); + QPolygonF rectPoly = transform.map(QPolygonF(textBoxRect)); + + switch (anchorId) + { + case aiTopLeft: return rectPoly.at(0); + case aiTop: return (rectPoly.at(0)+rectPoly.at(1))*0.5; + case aiTopRight: return rectPoly.at(1); + case aiRight: return (rectPoly.at(1)+rectPoly.at(2))*0.5; + case aiBottomRight: return rectPoly.at(2); + case aiBottom: return (rectPoly.at(2)+rectPoly.at(3))*0.5; + case aiBottomLeft: return rectPoly.at(3); + case aiLeft: return (rectPoly.at(3)+rectPoly.at(0))*0.5; + } + + qDebug() << Q_FUNC_INFO << "invalid anchorId" << anchorId; + return QPointF(); +} + +/*! \internal + + Returns the point that must be given to the QPainter::drawText function (which expects the top + left point of the text rect), according to the position \a pos, the text bounding box \a rect and + the requested \a positionAlignment. + + For example, if \a positionAlignment is Qt::AlignLeft | Qt::AlignBottom the returned point + will be shifted upward by the height of \a rect, starting from \a pos. So if the text is finally + drawn at that point, the lower left corner of the resulting text rect is at \a pos. +*/ +QPointF QCPItemText::getTextDrawPoint(const QPointF &pos, const QRectF &rect, Qt::Alignment positionAlignment) const +{ + if (positionAlignment == 0 || positionAlignment == (Qt::AlignLeft|Qt::AlignTop)) + return pos; + + QPointF result = pos; // start at top left + if (positionAlignment.testFlag(Qt::AlignHCenter)) + result.rx() -= rect.width()/2.0; + else if (positionAlignment.testFlag(Qt::AlignRight)) + result.rx() -= rect.width(); + if (positionAlignment.testFlag(Qt::AlignVCenter)) + result.ry() -= rect.height()/2.0; + else if (positionAlignment.testFlag(Qt::AlignBottom)) + result.ry() -= rect.height(); + return result; +} + +/*! \internal + + Returns the font that should be used for drawing text. Returns mFont when the item is not selected + and mSelectedFont when it is. +*/ +QFont QCPItemText::mainFont() const +{ + return mSelected ? mSelectedFont : mFont; +} + +/*! \internal + + Returns the color that should be used for drawing text. Returns mColor when the item is not + selected and mSelectedColor when it is. +*/ +QColor QCPItemText::mainColor() const +{ + return mSelected ? mSelectedColor : mColor; +} + +/*! \internal + + Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected + and mSelectedPen when it is. +*/ +QPen QCPItemText::mainPen() const +{ + return mSelected ? mSelectedPen : mPen; +} + +/*! \internal + + Returns the brush that should be used for drawing fills of the item. Returns mBrush when the item + is not selected and mSelectedBrush when it is. +*/ +QBrush QCPItemText::mainBrush() const +{ + return mSelected ? mSelectedBrush : mBrush; +} +/* end of 'src/items/item-text.cpp' */ + + +/* including file 'src/items/item-ellipse.cpp', size 7863 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemEllipse +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemEllipse + \brief An ellipse + + \image html QCPItemEllipse.png "Ellipse example. Blue dotted circles are anchors, solid blue discs are positions." + + It has two positions, \a topLeft and \a bottomRight, which define the rect the ellipse will be drawn in. +*/ + +/*! + Creates an ellipse item and sets default values. + + The created item is automatically registered with \a parentPlot. This QCustomPlot instance takes + ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead. +*/ +QCPItemEllipse::QCPItemEllipse(QCustomPlot *parentPlot) : + QCPAbstractItem(parentPlot), + topLeft(createPosition(QLatin1String("topLeft"))), + bottomRight(createPosition(QLatin1String("bottomRight"))), + topLeftRim(createAnchor(QLatin1String("topLeftRim"), aiTopLeftRim)), + top(createAnchor(QLatin1String("top"), aiTop)), + topRightRim(createAnchor(QLatin1String("topRightRim"), aiTopRightRim)), + right(createAnchor(QLatin1String("right"), aiRight)), + bottomRightRim(createAnchor(QLatin1String("bottomRightRim"), aiBottomRightRim)), + bottom(createAnchor(QLatin1String("bottom"), aiBottom)), + bottomLeftRim(createAnchor(QLatin1String("bottomLeftRim"), aiBottomLeftRim)), + left(createAnchor(QLatin1String("left"), aiLeft)), + center(createAnchor(QLatin1String("center"), aiCenter)) +{ + topLeft->setCoords(0, 1); + bottomRight->setCoords(1, 0); + + setPen(QPen(Qt::black)); + setSelectedPen(QPen(Qt::blue, 2)); + setBrush(Qt::NoBrush); + setSelectedBrush(Qt::NoBrush); +} + +QCPItemEllipse::~QCPItemEllipse() +{ +} + +/*! + Sets the pen that will be used to draw the line of the ellipse + + \see setSelectedPen, setBrush +*/ +void QCPItemEllipse::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the pen that will be used to draw the line of the ellipse when selected + + \see setPen, setSelected +*/ +void QCPItemEllipse::setSelectedPen(const QPen &pen) +{ + mSelectedPen = pen; +} + +/*! + Sets the brush that will be used to fill the ellipse. To disable filling, set \a brush to + Qt::NoBrush. + + \see setSelectedBrush, setPen +*/ +void QCPItemEllipse::setBrush(const QBrush &brush) +{ + mBrush = brush; +} + +/*! + Sets the brush that will be used to fill the ellipse when selected. To disable filling, set \a + brush to Qt::NoBrush. + + \see setBrush +*/ +void QCPItemEllipse::setSelectedBrush(const QBrush &brush) +{ + mSelectedBrush = brush; +} + +/* inherits documentation from base class */ +double QCPItemEllipse::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + + QPointF p1 = topLeft->pixelPosition(); + QPointF p2 = bottomRight->pixelPosition(); + QPointF center((p1+p2)/2.0); + double a = qAbs(p1.x()-p2.x())/2.0; + double b = qAbs(p1.y()-p2.y())/2.0; + double x = pos.x()-center.x(); + double y = pos.y()-center.y(); + + // distance to border: + double c = 1.0/qSqrt(x*x/(a*a)+y*y/(b*b)); + double result = qAbs(c-1)*qSqrt(x*x+y*y); + // filled ellipse, allow click inside to count as hit: + if (result > mParentPlot->selectionTolerance()*0.99 && mBrush.style() != Qt::NoBrush && mBrush.color().alpha() != 0) + { + if (x*x/(a*a) + y*y/(b*b) <= 1) + result = mParentPlot->selectionTolerance()*0.99; + } + return result; +} + +/* inherits documentation from base class */ +void QCPItemEllipse::draw(QCPPainter *painter) +{ + QPointF p1 = topLeft->pixelPosition(); + QPointF p2 = bottomRight->pixelPosition(); + if (p1.toPoint() == p2.toPoint()) + return; + QRectF ellipseRect = QRectF(p1, p2).normalized(); + QRect clip = clipRect().adjusted(-mainPen().widthF(), -mainPen().widthF(), mainPen().widthF(), mainPen().widthF()); + if (ellipseRect.intersects(clip)) // only draw if bounding rect of ellipse is visible in cliprect + { + painter->setPen(mainPen()); + painter->setBrush(mainBrush()); +#ifdef __EXCEPTIONS + try // drawEllipse sometimes throws exceptions if ellipse is too big + { +#endif + painter->drawEllipse(ellipseRect); +#ifdef __EXCEPTIONS + } catch (...) + { + qDebug() << Q_FUNC_INFO << "Item too large for memory, setting invisible"; + setVisible(false); + } +#endif + } +} + +/* inherits documentation from base class */ +QPointF QCPItemEllipse::anchorPixelPosition(int anchorId) const +{ + QRectF rect = QRectF(topLeft->pixelPosition(), bottomRight->pixelPosition()); + switch (anchorId) + { + case aiTopLeftRim: return rect.center()+(rect.topLeft()-rect.center())*1/qSqrt(2); + case aiTop: return (rect.topLeft()+rect.topRight())*0.5; + case aiTopRightRim: return rect.center()+(rect.topRight()-rect.center())*1/qSqrt(2); + case aiRight: return (rect.topRight()+rect.bottomRight())*0.5; + case aiBottomRightRim: return rect.center()+(rect.bottomRight()-rect.center())*1/qSqrt(2); + case aiBottom: return (rect.bottomLeft()+rect.bottomRight())*0.5; + case aiBottomLeftRim: return rect.center()+(rect.bottomLeft()-rect.center())*1/qSqrt(2); + case aiLeft: return (rect.topLeft()+rect.bottomLeft())*0.5; + case aiCenter: return (rect.topLeft()+rect.bottomRight())*0.5; + } + + qDebug() << Q_FUNC_INFO << "invalid anchorId" << anchorId; + return QPointF(); +} + +/*! \internal + + Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected + and mSelectedPen when it is. +*/ +QPen QCPItemEllipse::mainPen() const +{ + return mSelected ? mSelectedPen : mPen; +} + +/*! \internal + + Returns the brush that should be used for drawing fills of the item. Returns mBrush when the item + is not selected and mSelectedBrush when it is. +*/ +QBrush QCPItemEllipse::mainBrush() const +{ + return mSelected ? mSelectedBrush : mBrush; +} +/* end of 'src/items/item-ellipse.cpp' */ + + +/* including file 'src/items/item-pixmap.cpp', size 10615 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemPixmap +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemPixmap + \brief An arbitrary pixmap + + \image html QCPItemPixmap.png "Pixmap example. Blue dotted circles are anchors, solid blue discs are positions." + + It has two positions, \a topLeft and \a bottomRight, which define the rectangle the pixmap will + be drawn in. Depending on the scale setting (\ref setScaled), the pixmap will be either scaled to + fit the rectangle or be drawn aligned to the topLeft position. + + If scaling is enabled and \a topLeft is further to the bottom/right than \a bottomRight (as shown + on the right side of the example image), the pixmap will be flipped in the respective + orientations. +*/ + +/*! + Creates a rectangle item and sets default values. + + The created item is automatically registered with \a parentPlot. This QCustomPlot instance takes + ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead. +*/ +QCPItemPixmap::QCPItemPixmap(QCustomPlot *parentPlot) : + QCPAbstractItem(parentPlot), + topLeft(createPosition(QLatin1String("topLeft"))), + bottomRight(createPosition(QLatin1String("bottomRight"))), + top(createAnchor(QLatin1String("top"), aiTop)), + topRight(createAnchor(QLatin1String("topRight"), aiTopRight)), + right(createAnchor(QLatin1String("right"), aiRight)), + bottom(createAnchor(QLatin1String("bottom"), aiBottom)), + bottomLeft(createAnchor(QLatin1String("bottomLeft"), aiBottomLeft)), + left(createAnchor(QLatin1String("left"), aiLeft)), + mScaled(false), + mScaledPixmapInvalidated(true), + mAspectRatioMode(Qt::KeepAspectRatio), + mTransformationMode(Qt::SmoothTransformation) +{ + topLeft->setCoords(0, 1); + bottomRight->setCoords(1, 0); + + setPen(Qt::NoPen); + setSelectedPen(QPen(Qt::blue)); +} + +QCPItemPixmap::~QCPItemPixmap() +{ +} + +/*! + Sets the pixmap that will be displayed. +*/ +void QCPItemPixmap::setPixmap(const QPixmap &pixmap) +{ + mPixmap = pixmap; + mScaledPixmapInvalidated = true; + if (mPixmap.isNull()) + qDebug() << Q_FUNC_INFO << "pixmap is null"; +} + +/*! + Sets whether the pixmap will be scaled to fit the rectangle defined by the \a topLeft and \a + bottomRight positions. +*/ +void QCPItemPixmap::setScaled(bool scaled, Qt::AspectRatioMode aspectRatioMode, Qt::TransformationMode transformationMode) +{ + mScaled = scaled; + mAspectRatioMode = aspectRatioMode; + mTransformationMode = transformationMode; + mScaledPixmapInvalidated = true; +} + +/*! + Sets the pen that will be used to draw a border around the pixmap. + + \see setSelectedPen, setBrush +*/ +void QCPItemPixmap::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the pen that will be used to draw a border around the pixmap when selected + + \see setPen, setSelected +*/ +void QCPItemPixmap::setSelectedPen(const QPen &pen) +{ + mSelectedPen = pen; +} + +/* inherits documentation from base class */ +double QCPItemPixmap::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + + return rectDistance(getFinalRect(), pos, true); +} + +/* inherits documentation from base class */ +void QCPItemPixmap::draw(QCPPainter *painter) +{ + bool flipHorz = false; + bool flipVert = false; + QRect rect = getFinalRect(&flipHorz, &flipVert); + double clipPad = mainPen().style() == Qt::NoPen ? 0 : mainPen().widthF(); + QRect boundingRect = rect.adjusted(-clipPad, -clipPad, clipPad, clipPad); + if (boundingRect.intersects(clipRect())) + { + updateScaledPixmap(rect, flipHorz, flipVert); + painter->drawPixmap(rect.topLeft(), mScaled ? mScaledPixmap : mPixmap); + QPen pen = mainPen(); + if (pen.style() != Qt::NoPen) + { + painter->setPen(pen); + painter->setBrush(Qt::NoBrush); + painter->drawRect(rect); + } + } +} + +/* inherits documentation from base class */ +QPointF QCPItemPixmap::anchorPixelPosition(int anchorId) const +{ + bool flipHorz; + bool flipVert; + QRect rect = getFinalRect(&flipHorz, &flipVert); + // we actually want denormal rects (negative width/height) here, so restore + // the flipped state: + if (flipHorz) + rect.adjust(rect.width(), 0, -rect.width(), 0); + if (flipVert) + rect.adjust(0, rect.height(), 0, -rect.height()); + + switch (anchorId) + { + case aiTop: return (rect.topLeft()+rect.topRight())*0.5; + case aiTopRight: return rect.topRight(); + case aiRight: return (rect.topRight()+rect.bottomRight())*0.5; + case aiBottom: return (rect.bottomLeft()+rect.bottomRight())*0.5; + case aiBottomLeft: return rect.bottomLeft(); + case aiLeft: return (rect.topLeft()+rect.bottomLeft())*0.5;; + } + + qDebug() << Q_FUNC_INFO << "invalid anchorId" << anchorId; + return QPointF(); +} + +/*! \internal + + Creates the buffered scaled image (\a mScaledPixmap) to fit the specified \a finalRect. The + parameters \a flipHorz and \a flipVert control whether the resulting image shall be flipped + horizontally or vertically. (This is used when \a topLeft is further to the bottom/right than \a + bottomRight.) + + This function only creates the scaled pixmap when the buffered pixmap has a different size than + the expected result, so calling this function repeatedly, e.g. in the \ref draw function, does + not cause expensive rescaling every time. + + If scaling is disabled, sets mScaledPixmap to a null QPixmap. +*/ +void QCPItemPixmap::updateScaledPixmap(QRect finalRect, bool flipHorz, bool flipVert) +{ + if (mPixmap.isNull()) + return; + + if (mScaled) + { +#ifdef QCP_DEVICEPIXELRATIO_SUPPORTED + double devicePixelRatio = mPixmap.devicePixelRatio(); +#else + double devicePixelRatio = 1.0; +#endif + if (finalRect.isNull()) + finalRect = getFinalRect(&flipHorz, &flipVert); + if (mScaledPixmapInvalidated || finalRect.size() != mScaledPixmap.size()/devicePixelRatio) + { + mScaledPixmap = mPixmap.scaled(finalRect.size()*devicePixelRatio, mAspectRatioMode, mTransformationMode); + if (flipHorz || flipVert) + mScaledPixmap = QPixmap::fromImage(mScaledPixmap.toImage().mirrored(flipHorz, flipVert)); +#ifdef QCP_DEVICEPIXELRATIO_SUPPORTED + mScaledPixmap.setDevicePixelRatio(devicePixelRatio); +#endif + } + } else if (!mScaledPixmap.isNull()) + mScaledPixmap = QPixmap(); + mScaledPixmapInvalidated = false; +} + +/*! \internal + + Returns the final (tight) rect the pixmap is drawn in, depending on the current item positions + and scaling settings. + + The output parameters \a flippedHorz and \a flippedVert return whether the pixmap should be drawn + flipped horizontally or vertically in the returned rect. (The returned rect itself is always + normalized, i.e. the top left corner of the rect is actually further to the top/left than the + bottom right corner). This is the case when the item position \a topLeft is further to the + bottom/right than \a bottomRight. + + If scaling is disabled, returns a rect with size of the original pixmap and the top left corner + aligned with the item position \a topLeft. The position \a bottomRight is ignored. +*/ +QRect QCPItemPixmap::getFinalRect(bool *flippedHorz, bool *flippedVert) const +{ + QRect result; + bool flipHorz = false; + bool flipVert = false; + QPoint p1 = topLeft->pixelPosition().toPoint(); + QPoint p2 = bottomRight->pixelPosition().toPoint(); + if (p1 == p2) + return QRect(p1, QSize(0, 0)); + if (mScaled) + { + QSize newSize = QSize(p2.x()-p1.x(), p2.y()-p1.y()); + QPoint topLeft = p1; + if (newSize.width() < 0) + { + flipHorz = true; + newSize.rwidth() *= -1; + topLeft.setX(p2.x()); + } + if (newSize.height() < 0) + { + flipVert = true; + newSize.rheight() *= -1; + topLeft.setY(p2.y()); + } + QSize scaledSize = mPixmap.size(); +#ifdef QCP_DEVICEPIXELRATIO_SUPPORTED + scaledSize /= mPixmap.devicePixelRatio(); + scaledSize.scale(newSize*mPixmap.devicePixelRatio(), mAspectRatioMode); +#else + scaledSize.scale(newSize, mAspectRatioMode); +#endif + result = QRect(topLeft, scaledSize); + } else + { +#ifdef QCP_DEVICEPIXELRATIO_SUPPORTED + result = QRect(p1, mPixmap.size()/mPixmap.devicePixelRatio()); +#else + result = QRect(p1, mPixmap.size()); +#endif + } + if (flippedHorz) + *flippedHorz = flipHorz; + if (flippedVert) + *flippedVert = flipVert; + return result; +} + +/*! \internal + + Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected + and mSelectedPen when it is. +*/ +QPen QCPItemPixmap::mainPen() const +{ + return mSelected ? mSelectedPen : mPen; +} +/* end of 'src/items/item-pixmap.cpp' */ + + +/* including file 'src/items/item-tracer.cpp', size 14624 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemTracer +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemTracer + \brief Item that sticks to QCPGraph data points + + \image html QCPItemTracer.png "Tracer example. Blue dotted circles are anchors, solid blue discs are positions." + + The tracer can be connected with a QCPGraph via \ref setGraph. Then it will automatically adopt + the coordinate axes of the graph and update its \a position to be on the graph's data. This means + the key stays controllable via \ref setGraphKey, but the value will follow the graph data. If a + QCPGraph is connected, note that setting the coordinates of the tracer item directly via \a + position will have no effect because they will be overriden in the next redraw (this is when the + coordinate update happens). + + If the specified key in \ref setGraphKey is outside the key bounds of the graph, the tracer will + stay at the corresponding end of the graph. + + With \ref setInterpolating you may specify whether the tracer may only stay exactly on data + points or whether it interpolates data points linearly, if given a key that lies between two data + points of the graph. + + The tracer has different visual styles, see \ref setStyle. It is also possible to make the tracer + have no own visual appearance (set the style to \ref tsNone), and just connect other item + positions to the tracer \a position (used as an anchor) via \ref + QCPItemPosition::setParentAnchor. + + \note The tracer position is only automatically updated upon redraws. So when the data of the + graph changes and immediately afterwards (without a redraw) the position coordinates of the + tracer are retrieved, they will not reflect the updated data of the graph. In this case \ref + updatePosition must be called manually, prior to reading the tracer coordinates. +*/ + +/*! + Creates a tracer item and sets default values. + + The created item is automatically registered with \a parentPlot. This QCustomPlot instance takes + ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead. +*/ +QCPItemTracer::QCPItemTracer(QCustomPlot *parentPlot) : + QCPAbstractItem(parentPlot), + position(createPosition(QLatin1String("position"))), + mSize(6), + mStyle(tsCrosshair), + mGraph(0), + mGraphKey(0), + mInterpolating(false) +{ + position->setCoords(0, 0); + + setBrush(Qt::NoBrush); + setSelectedBrush(Qt::NoBrush); + setPen(QPen(Qt::black)); + setSelectedPen(QPen(Qt::blue, 2)); +} + +QCPItemTracer::~QCPItemTracer() +{ +} + +/*! + Sets the pen that will be used to draw the line of the tracer + + \see setSelectedPen, setBrush +*/ +void QCPItemTracer::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the pen that will be used to draw the line of the tracer when selected + + \see setPen, setSelected +*/ +void QCPItemTracer::setSelectedPen(const QPen &pen) +{ + mSelectedPen = pen; +} + +/*! + Sets the brush that will be used to draw any fills of the tracer + + \see setSelectedBrush, setPen +*/ +void QCPItemTracer::setBrush(const QBrush &brush) +{ + mBrush = brush; +} + +/*! + Sets the brush that will be used to draw any fills of the tracer, when selected. + + \see setBrush, setSelected +*/ +void QCPItemTracer::setSelectedBrush(const QBrush &brush) +{ + mSelectedBrush = brush; +} + +/*! + Sets the size of the tracer in pixels, if the style supports setting a size (e.g. \ref tsSquare + does, \ref tsCrosshair does not). +*/ +void QCPItemTracer::setSize(double size) +{ + mSize = size; +} + +/*! + Sets the style/visual appearance of the tracer. + + If you only want to use the tracer \a position as an anchor for other items, set \a style to + \ref tsNone. +*/ +void QCPItemTracer::setStyle(QCPItemTracer::TracerStyle style) +{ + mStyle = style; +} + +/*! + Sets the QCPGraph this tracer sticks to. The tracer \a position will be set to type + QCPItemPosition::ptPlotCoords and the axes will be set to the axes of \a graph. + + To free the tracer from any graph, set \a graph to 0. The tracer \a position can then be placed + freely like any other item position. This is the state the tracer will assume when its graph gets + deleted while still attached to it. + + \see setGraphKey +*/ +void QCPItemTracer::setGraph(QCPGraph *graph) +{ + if (graph) + { + if (graph->parentPlot() == mParentPlot) + { + position->setType(QCPItemPosition::ptPlotCoords); + position->setAxes(graph->keyAxis(), graph->valueAxis()); + mGraph = graph; + updatePosition(); + } else + qDebug() << Q_FUNC_INFO << "graph isn't in same QCustomPlot instance as this item"; + } else + { + mGraph = 0; + } +} + +/*! + Sets the key of the graph's data point the tracer will be positioned at. This is the only free + coordinate of a tracer when attached to a graph. + + Depending on \ref setInterpolating, the tracer will be either positioned on the data point + closest to \a key, or will stay exactly at \a key and interpolate the value linearly. + + \see setGraph, setInterpolating +*/ +void QCPItemTracer::setGraphKey(double key) +{ + mGraphKey = key; +} + +/*! + Sets whether the value of the graph's data points shall be interpolated, when positioning the + tracer. + + If \a enabled is set to false and a key is given with \ref setGraphKey, the tracer is placed on + the data point of the graph which is closest to the key, but which is not necessarily exactly + there. If \a enabled is true, the tracer will be positioned exactly at the specified key, and + the appropriate value will be interpolated from the graph's data points linearly. + + \see setGraph, setGraphKey +*/ +void QCPItemTracer::setInterpolating(bool enabled) +{ + mInterpolating = enabled; +} + +/* inherits documentation from base class */ +double QCPItemTracer::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + + QPointF center(position->pixelPosition()); + double w = mSize/2.0; + QRect clip = clipRect(); + switch (mStyle) + { + case tsNone: return -1; + case tsPlus: + { + if (clipRect().intersects(QRectF(center-QPointF(w, w), center+QPointF(w, w)).toRect())) + return qSqrt(qMin(QCPVector2D(pos).distanceSquaredToLine(center+QPointF(-w, 0), center+QPointF(w, 0)), + QCPVector2D(pos).distanceSquaredToLine(center+QPointF(0, -w), center+QPointF(0, w)))); + break; + } + case tsCrosshair: + { + return qSqrt(qMin(QCPVector2D(pos).distanceSquaredToLine(QCPVector2D(clip.left(), center.y()), QCPVector2D(clip.right(), center.y())), + QCPVector2D(pos).distanceSquaredToLine(QCPVector2D(center.x(), clip.top()), QCPVector2D(center.x(), clip.bottom())))); + } + case tsCircle: + { + if (clip.intersects(QRectF(center-QPointF(w, w), center+QPointF(w, w)).toRect())) + { + // distance to border: + double centerDist = QCPVector2D(center-pos).length(); + double circleLine = w; + double result = qAbs(centerDist-circleLine); + // filled ellipse, allow click inside to count as hit: + if (result > mParentPlot->selectionTolerance()*0.99 && mBrush.style() != Qt::NoBrush && mBrush.color().alpha() != 0) + { + if (centerDist <= circleLine) + result = mParentPlot->selectionTolerance()*0.99; + } + return result; + } + break; + } + case tsSquare: + { + if (clip.intersects(QRectF(center-QPointF(w, w), center+QPointF(w, w)).toRect())) + { + QRectF rect = QRectF(center-QPointF(w, w), center+QPointF(w, w)); + bool filledRect = mBrush.style() != Qt::NoBrush && mBrush.color().alpha() != 0; + return rectDistance(rect, pos, filledRect); + } + break; + } + } + return -1; +} + +/* inherits documentation from base class */ +void QCPItemTracer::draw(QCPPainter *painter) +{ + updatePosition(); + if (mStyle == tsNone) + return; + + painter->setPen(mainPen()); + painter->setBrush(mainBrush()); + QPointF center(position->pixelPosition()); + double w = mSize/2.0; + QRect clip = clipRect(); + switch (mStyle) + { + case tsNone: return; + case tsPlus: + { + if (clip.intersects(QRectF(center-QPointF(w, w), center+QPointF(w, w)).toRect())) + { + painter->drawLine(QLineF(center+QPointF(-w, 0), center+QPointF(w, 0))); + painter->drawLine(QLineF(center+QPointF(0, -w), center+QPointF(0, w))); + } + break; + } + case tsCrosshair: + { + if (center.y() > clip.top() && center.y() < clip.bottom()) + painter->drawLine(QLineF(clip.left(), center.y(), clip.right(), center.y())); + if (center.x() > clip.left() && center.x() < clip.right()) + painter->drawLine(QLineF(center.x(), clip.top(), center.x(), clip.bottom())); + break; + } + case tsCircle: + { + if (clip.intersects(QRectF(center-QPointF(w, w), center+QPointF(w, w)).toRect())) + painter->drawEllipse(center, w, w); + break; + } + case tsSquare: + { + if (clip.intersects(QRectF(center-QPointF(w, w), center+QPointF(w, w)).toRect())) + painter->drawRect(QRectF(center-QPointF(w, w), center+QPointF(w, w))); + break; + } + } +} + +/*! + If the tracer is connected with a graph (\ref setGraph), this function updates the tracer's \a + position to reside on the graph data, depending on the configured key (\ref setGraphKey). + + It is called automatically on every redraw and normally doesn't need to be called manually. One + exception is when you want to read the tracer coordinates via \a position and are not sure that + the graph's data (or the tracer key with \ref setGraphKey) hasn't changed since the last redraw. + In that situation, call this function before accessing \a position, to make sure you don't get + out-of-date coordinates. + + If there is no graph set on this tracer, this function does nothing. +*/ +void QCPItemTracer::updatePosition() +{ + if (mGraph) + { + if (mParentPlot->hasPlottable(mGraph)) + { + if (mGraph->data()->size() > 1) + { + QCPGraphDataContainer::const_iterator first = mGraph->data()->constBegin(); + QCPGraphDataContainer::const_iterator last = mGraph->data()->constEnd()-1; + if (mGraphKey <= first->key) + position->setCoords(first->key, first->value); + else if (mGraphKey >= last->key) + position->setCoords(last->key, last->value); + else + { + QCPGraphDataContainer::const_iterator it = mGraph->data()->findBegin(mGraphKey); + if (it != mGraph->data()->constEnd()) // mGraphKey is not exactly on last iterator, but somewhere between iterators + { + QCPGraphDataContainer::const_iterator prevIt = it; + ++it; // won't advance to constEnd because we handled that case (mGraphKey >= last->key) before + if (mInterpolating) + { + // interpolate between iterators around mGraphKey: + double slope = 0; + if (!qFuzzyCompare((double)it->key, (double)prevIt->key)) + slope = (it->value-prevIt->value)/(it->key-prevIt->key); + position->setCoords(mGraphKey, (mGraphKey-prevIt->key)*slope+prevIt->value); + } else + { + // find iterator with key closest to mGraphKey: + if (mGraphKey < (prevIt->key+it->key)*0.5) + position->setCoords(prevIt->key, prevIt->value); + else + position->setCoords(it->key, it->value); + } + } else // mGraphKey is exactly on last iterator (should actually be caught when comparing first/last keys, but this is a failsafe for fp uncertainty) + position->setCoords(it->key, it->value); + } + } else if (mGraph->data()->size() == 1) + { + QCPGraphDataContainer::const_iterator it = mGraph->data()->constBegin(); + position->setCoords(it->key, it->value); + } else + qDebug() << Q_FUNC_INFO << "graph has no data"; + } else + qDebug() << Q_FUNC_INFO << "graph not contained in QCustomPlot instance (anymore)"; + } +} + +/*! \internal + + Returns the pen that should be used for drawing lines. Returns mPen when the item is not selected + and mSelectedPen when it is. +*/ +QPen QCPItemTracer::mainPen() const +{ + return mSelected ? mSelectedPen : mPen; +} + +/*! \internal + + Returns the brush that should be used for drawing fills of the item. Returns mBrush when the item + is not selected and mSelectedBrush when it is. +*/ +QBrush QCPItemTracer::mainBrush() const +{ + return mSelected ? mSelectedBrush : mBrush; +} +/* end of 'src/items/item-tracer.cpp' */ + + +/* including file 'src/items/item-bracket.cpp', size 10687 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPItemBracket +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPItemBracket + \brief A bracket for referencing/highlighting certain parts in the plot. + + \image html QCPItemBracket.png "Bracket example. Blue dotted circles are anchors, solid blue discs are positions." + + It has two positions, \a left and \a right, which define the span of the bracket. If \a left is + actually farther to the left than \a right, the bracket is opened to the bottom, as shown in the + example image. + + The bracket supports multiple styles via \ref setStyle. The length, i.e. how far the bracket + stretches away from the embraced span, can be controlled with \ref setLength. + + \image html QCPItemBracket-length.png +
Demonstrating the effect of different values for \ref setLength, for styles \ref + bsCalligraphic and \ref bsSquare. Anchors and positions are displayed for reference.
+ + It provides an anchor \a center, to allow connection of other items, e.g. an arrow (QCPItemLine + or QCPItemCurve) or a text label (QCPItemText), to the bracket. +*/ + +/*! + Creates a bracket item and sets default values. + + The created item is automatically registered with \a parentPlot. This QCustomPlot instance takes + ownership of the item, so do not delete it manually but use QCustomPlot::removeItem() instead. +*/ +QCPItemBracket::QCPItemBracket(QCustomPlot *parentPlot) : + QCPAbstractItem(parentPlot), + left(createPosition(QLatin1String("left"))), + right(createPosition(QLatin1String("right"))), + center(createAnchor(QLatin1String("center"), aiCenter)), + mLength(8), + mStyle(bsCalligraphic) +{ + left->setCoords(0, 0); + right->setCoords(1, 1); + + setPen(QPen(Qt::black)); + setSelectedPen(QPen(Qt::blue, 2)); +} + +QCPItemBracket::~QCPItemBracket() +{ +} + +/*! + Sets the pen that will be used to draw the bracket. + + Note that when the style is \ref bsCalligraphic, only the color will be taken from the pen, the + stroke and width are ignored. To change the apparent stroke width of a calligraphic bracket, use + \ref setLength, which has a similar effect. + + \see setSelectedPen +*/ +void QCPItemBracket::setPen(const QPen &pen) +{ + mPen = pen; +} + +/*! + Sets the pen that will be used to draw the bracket when selected + + \see setPen, setSelected +*/ +void QCPItemBracket::setSelectedPen(const QPen &pen) +{ + mSelectedPen = pen; +} + +/*! + Sets the \a length in pixels how far the bracket extends in the direction towards the embraced + span of the bracket (i.e. perpendicular to the left-right-direction) + + \image html QCPItemBracket-length.png +
Demonstrating the effect of different values for \ref setLength, for styles \ref + bsCalligraphic and \ref bsSquare. Anchors and positions are displayed for reference.
+*/ +void QCPItemBracket::setLength(double length) +{ + mLength = length; +} + +/*! + Sets the style of the bracket, i.e. the shape/visual appearance. + + \see setPen +*/ +void QCPItemBracket::setStyle(QCPItemBracket::BracketStyle style) +{ + mStyle = style; +} + +/* inherits documentation from base class */ +double QCPItemBracket::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + Q_UNUSED(details) + if (onlySelectable && !mSelectable) + return -1; + + QCPVector2D p(pos); + QCPVector2D leftVec(left->pixelPosition()); + QCPVector2D rightVec(right->pixelPosition()); + if (leftVec.toPoint() == rightVec.toPoint()) + return -1; + + QCPVector2D widthVec = (rightVec-leftVec)*0.5; + QCPVector2D lengthVec = widthVec.perpendicular().normalized()*mLength; + QCPVector2D centerVec = (rightVec+leftVec)*0.5-lengthVec; + + switch (mStyle) + { + case QCPItemBracket::bsSquare: + case QCPItemBracket::bsRound: + { + double a = p.distanceSquaredToLine(centerVec-widthVec, centerVec+widthVec); + double b = p.distanceSquaredToLine(centerVec-widthVec+lengthVec, centerVec-widthVec); + double c = p.distanceSquaredToLine(centerVec+widthVec+lengthVec, centerVec+widthVec); + return qSqrt(qMin(qMin(a, b), c)); + } + case QCPItemBracket::bsCurly: + case QCPItemBracket::bsCalligraphic: + { + double a = p.distanceSquaredToLine(centerVec-widthVec*0.75+lengthVec*0.15, centerVec+lengthVec*0.3); + double b = p.distanceSquaredToLine(centerVec-widthVec+lengthVec*0.7, centerVec-widthVec*0.75+lengthVec*0.15); + double c = p.distanceSquaredToLine(centerVec+widthVec*0.75+lengthVec*0.15, centerVec+lengthVec*0.3); + double d = p.distanceSquaredToLine(centerVec+widthVec+lengthVec*0.7, centerVec+widthVec*0.75+lengthVec*0.15); + return qSqrt(qMin(qMin(a, b), qMin(c, d))); + } + } + return -1; +} + +/* inherits documentation from base class */ +void QCPItemBracket::draw(QCPPainter *painter) +{ + QCPVector2D leftVec(left->pixelPosition()); + QCPVector2D rightVec(right->pixelPosition()); + if (leftVec.toPoint() == rightVec.toPoint()) + return; + + QCPVector2D widthVec = (rightVec-leftVec)*0.5; + QCPVector2D lengthVec = widthVec.perpendicular().normalized()*mLength; + QCPVector2D centerVec = (rightVec+leftVec)*0.5-lengthVec; + + QPolygon boundingPoly; + boundingPoly << leftVec.toPoint() << rightVec.toPoint() + << (rightVec-lengthVec).toPoint() << (leftVec-lengthVec).toPoint(); + QRect clip = clipRect().adjusted(-mainPen().widthF(), -mainPen().widthF(), mainPen().widthF(), mainPen().widthF()); + if (clip.intersects(boundingPoly.boundingRect())) + { + painter->setPen(mainPen()); + switch (mStyle) + { + case bsSquare: + { + painter->drawLine((centerVec+widthVec).toPointF(), (centerVec-widthVec).toPointF()); + painter->drawLine((centerVec+widthVec).toPointF(), (centerVec+widthVec+lengthVec).toPointF()); + painter->drawLine((centerVec-widthVec).toPointF(), (centerVec-widthVec+lengthVec).toPointF()); + break; + } + case bsRound: + { + painter->setBrush(Qt::NoBrush); + QPainterPath path; + path.moveTo((centerVec+widthVec+lengthVec).toPointF()); + path.cubicTo((centerVec+widthVec).toPointF(), (centerVec+widthVec).toPointF(), centerVec.toPointF()); + path.cubicTo((centerVec-widthVec).toPointF(), (centerVec-widthVec).toPointF(), (centerVec-widthVec+lengthVec).toPointF()); + painter->drawPath(path); + break; + } + case bsCurly: + { + painter->setBrush(Qt::NoBrush); + QPainterPath path; + path.moveTo((centerVec+widthVec+lengthVec).toPointF()); + path.cubicTo((centerVec+widthVec-lengthVec*0.8).toPointF(), (centerVec+0.4*widthVec+lengthVec).toPointF(), centerVec.toPointF()); + path.cubicTo((centerVec-0.4*widthVec+lengthVec).toPointF(), (centerVec-widthVec-lengthVec*0.8).toPointF(), (centerVec-widthVec+lengthVec).toPointF()); + painter->drawPath(path); + break; + } + case bsCalligraphic: + { + painter->setPen(Qt::NoPen); + painter->setBrush(QBrush(mainPen().color())); + QPainterPath path; + path.moveTo((centerVec+widthVec+lengthVec).toPointF()); + + path.cubicTo((centerVec+widthVec-lengthVec*0.8).toPointF(), (centerVec+0.4*widthVec+0.8*lengthVec).toPointF(), centerVec.toPointF()); + path.cubicTo((centerVec-0.4*widthVec+0.8*lengthVec).toPointF(), (centerVec-widthVec-lengthVec*0.8).toPointF(), (centerVec-widthVec+lengthVec).toPointF()); + + path.cubicTo((centerVec-widthVec-lengthVec*0.5).toPointF(), (centerVec-0.2*widthVec+1.2*lengthVec).toPointF(), (centerVec+lengthVec*0.2).toPointF()); + path.cubicTo((centerVec+0.2*widthVec+1.2*lengthVec).toPointF(), (centerVec+widthVec-lengthVec*0.5).toPointF(), (centerVec+widthVec+lengthVec).toPointF()); + + painter->drawPath(path); + break; + } + } + } +} + +/* inherits documentation from base class */ +QPointF QCPItemBracket::anchorPixelPosition(int anchorId) const +{ + QCPVector2D leftVec(left->pixelPosition()); + QCPVector2D rightVec(right->pixelPosition()); + if (leftVec.toPoint() == rightVec.toPoint()) + return leftVec.toPointF(); + + QCPVector2D widthVec = (rightVec-leftVec)*0.5; + QCPVector2D lengthVec = widthVec.perpendicular().normalized()*mLength; + QCPVector2D centerVec = (rightVec+leftVec)*0.5-lengthVec; + + switch (anchorId) + { + case aiCenter: + return centerVec.toPointF(); + } + qDebug() << Q_FUNC_INFO << "invalid anchorId" << anchorId; + return QPointF(); +} + +/*! \internal + + Returns the pen that should be used for drawing lines. Returns mPen when the + item is not selected and mSelectedPen when it is. +*/ +QPen QCPItemBracket::mainPen() const +{ + return mSelected ? mSelectedPen : mPen; +} +/* end of 'src/items/item-bracket.cpp' */ + + diff --git a/third/3rd_qcustomplot/v2_0/qcustomplot.h b/third/3rd_qcustomplot/v2_0/qcustomplot.h new file mode 100644 index 0000000..3b046e5 --- /dev/null +++ b/third/3rd_qcustomplot/v2_0/qcustomplot.h @@ -0,0 +1,6673 @@ +/*************************************************************************** +** ** +** QCustomPlot, an easy to use, modern plotting widget for Qt ** +** Copyright (C) 2011-2018 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 3 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/ ** +** Date: 25.06.18 ** +** Version: 2.0.1 ** +****************************************************************************/ + +#ifndef QCUSTOMPLOT_H +#define QCUSTOMPLOT_H + +#include + +// some Qt version/configuration dependent macros to include or exclude certain code paths: +#ifdef QCUSTOMPLOT_USE_OPENGL +# if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) +# define QCP_OPENGL_PBUFFER +# else +# define QCP_OPENGL_FBO +# endif +# if QT_VERSION >= QT_VERSION_CHECK(5, 3, 0) +# define QCP_OPENGL_OFFSCREENSURFACE +# endif +#endif + +#if QT_VERSION >= QT_VERSION_CHECK(5, 4, 0) +# define QCP_DEVICEPIXELRATIO_SUPPORTED +# if QT_VERSION >= QT_VERSION_CHECK(5, 6, 0) +# define QCP_DEVICEPIXELRATIO_FLOAT +# endif +#endif + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#ifdef QCP_OPENGL_FBO +# include +# include +# ifdef QCP_OPENGL_OFFSCREENSURFACE +# include +# else +# include +# endif +#endif +#ifdef QCP_OPENGL_PBUFFER +# include +#endif +#if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) +# include +# include +# include +# include +#else +# include +# include +# include +#endif + +class QCPPainter; +class QCustomPlot; +class QCPLayerable; +class QCPLayoutElement; +class QCPLayout; +class QCPAxis; +class QCPAxisRect; +class QCPAxisPainterPrivate; +class QCPAbstractPlottable; +class QCPGraph; +class QCPAbstractItem; +class QCPPlottableInterface1D; +class QCPLegend; +class QCPItemPosition; +class QCPLayer; +class QCPAbstractLegendItem; +class QCPSelectionRect; +class QCPColorMap; +class QCPColorScale; +class QCPBars; + +/* including file 'src/global.h', size 16357 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +#define QCUSTOMPLOT_VERSION_STR "2.0.1" +#define QCUSTOMPLOT_VERSION 0x020001 + +// decl definitions for shared library compilation/usage: +#if defined(QT_STATIC_BUILD) +# define QCP_LIB_DECL +#elif 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 + +// define empty macro for Q_DECL_OVERRIDE if it doesn't exist (Qt < 5) +#ifndef Q_DECL_OVERRIDE +# define Q_DECL_OVERRIDE +#endif + +/*! + The QCP Namespace contains general enums, QFlags and functions used throughout the QCustomPlot + library. + + It provides QMetaObject-based reflection of its enums and flags via \a QCP::staticMetaObject. +*/ +#ifndef Q_MOC_RUN +namespace QCP { +#else +class QCP { // when in moc-run, make it look like a class, so we get Q_GADGET, Q_ENUMS/Q_FLAGS features in namespace + Q_GADGET + Q_ENUMS(ExportPen) + Q_ENUMS(ResolutionUnit) + Q_ENUMS(SignDomain) + Q_ENUMS(MarginSide) + Q_FLAGS(MarginSides) + Q_ENUMS(AntialiasedElement) + Q_FLAGS(AntialiasedElements) + Q_ENUMS(PlottingHint) + Q_FLAGS(PlottingHints) + Q_ENUMS(Interaction) + Q_FLAGS(Interactions) + Q_ENUMS(SelectionRectMode) + Q_ENUMS(SelectionType) +public: +#endif + +/*! + Defines the different units in which the image resolution can be specified in the export + functions. + + \see QCustomPlot::savePng, QCustomPlot::saveJpg, QCustomPlot::saveBmp, QCustomPlot::saveRastered +*/ +enum ResolutionUnit { ruDotsPerMeter ///< Resolution is given in dots per meter (dpm) + ,ruDotsPerCentimeter ///< Resolution is given in dots per centimeter (dpcm) + ,ruDotsPerInch ///< Resolution is given in dots per inch (DPI/PPI) + }; + +/*! + Defines how cosmetic pens (pens with numerical width 0) are handled during export. + + \see QCustomPlot::savePdf +*/ +enum ExportPen { epNoCosmetic ///< Cosmetic pens are converted to pens with pixel width 1 when exporting + ,epAllowCosmetic ///< Cosmetic pens are exported normally (e.g. in PDF exports, cosmetic pens always appear as 1 pixel on screen, independent of viewer zoom level) + }; + +/*! + Represents negative and positive sign domain, e.g. for passing to \ref + QCPAbstractPlottable::getKeyRange and \ref QCPAbstractPlottable::getValueRange. + + This is primarily needed when working with logarithmic axis scales, since only one of the sign + domains can be visible at a time. +*/ +enum SignDomain { sdNegative ///< The negative sign domain, i.e. numbers smaller than zero + ,sdBoth ///< Both sign domains, including zero, i.e. all numbers + ,sdPositive ///< The positive sign domain, i.e. numbers greater than zero + }; + +/*! + Defines the sides of a rectangular entity to which margins can be applied. + + \see QCPLayoutElement::setAutoMargins, QCPAxisRect::setAutoMargins +*/ +enum MarginSide { msLeft = 0x01 ///< 0x01 left margin + ,msRight = 0x02 ///< 0x02 right margin + ,msTop = 0x04 ///< 0x04 top margin + ,msBottom = 0x08 ///< 0x08 bottom margin + ,msAll = 0xFF ///< 0xFF all margins + ,msNone = 0x00 ///< 0x00 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 ///< 0x0001 Axis base line and tick marks + ,aeGrid = 0x0002 ///< 0x0002 Grid lines + ,aeSubGrid = 0x0004 ///< 0x0004 Sub grid lines + ,aeLegend = 0x0008 ///< 0x0008 Legend box + ,aeLegendItems = 0x0010 ///< 0x0010 Legend items + ,aePlottables = 0x0020 ///< 0x0020 Main lines of plottables + ,aeItems = 0x0040 ///< 0x0040 Main lines of items + ,aeScatters = 0x0080 ///< 0x0080 Scatter symbols of plottables (excluding scatter symbols of type ssPixmap) + ,aeFills = 0x0100 ///< 0x0100 Borders of fills (e.g. under or between graphs) + ,aeZeroLine = 0x0200 ///< 0x0200 Zero-lines, see \ref QCPGrid::setZeroLinePen + ,aeOther = 0x8000 ///< 0x8000 Other elements that don't fit into any of the existing categories + ,aeAll = 0xFFFF ///< 0xFFFF All elements + ,aeNone = 0x0000 ///< 0x0000 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 ///< 0x000 No hints are set + ,phFastPolylines = 0x001 ///< 0x001 Graph/Curve lines are drawn with a faster method. This reduces the quality especially of the line segment + ///< joins, thus is most effective for pen sizes larger than 1. It is only used for solid line pens. + ,phImmediateRefresh = 0x002 ///< 0x002 causes an immediate repaint() instead of a soft update() when QCustomPlot::replot() is called with parameter \ref QCustomPlot::rpRefreshHint. + ///< This is set by default to prevent the plot from freezing on fast consecutive replots (e.g. user drags ranges with mouse). + ,phCacheLabels = 0x004 ///< 0x004 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 ///< 0x001 Axis ranges are draggable (see \ref QCPAxisRect::setRangeDrag, \ref QCPAxisRect::setRangeDragAxes) + ,iRangeZoom = 0x002 ///< 0x002 Axis ranges are zoomable with the mouse wheel (see \ref QCPAxisRect::setRangeZoom, \ref QCPAxisRect::setRangeZoomAxes) + ,iMultiSelect = 0x004 ///< 0x004 The user can select multiple objects by holding the modifier set by \ref QCustomPlot::setMultiSelectModifier while clicking + ,iSelectPlottables = 0x008 ///< 0x008 Plottables are selectable (e.g. graphs, curves, bars,... see QCPAbstractPlottable) + ,iSelectAxes = 0x010 ///< 0x010 Axes are selectable (or parts of them, see QCPAxis::setSelectableParts) + ,iSelectLegend = 0x020 ///< 0x020 Legends are selectable (or their child items, see QCPLegend::setSelectableParts) + ,iSelectItems = 0x040 ///< 0x040 Items are selectable (Rectangles, Arrows, Textitems, etc. see \ref QCPAbstractItem) + ,iSelectOther = 0x080 ///< 0x080 All other objects are selectable (e.g. your own derived layerables, other layout elements,...) + }; +Q_DECLARE_FLAGS(Interactions, Interaction) + +/*! + Defines the behaviour of the selection rect. + + \see QCustomPlot::setSelectionRectMode, QCustomPlot::selectionRect, QCPSelectionRect +*/ +enum SelectionRectMode { srmNone ///< The selection rect is disabled, and all mouse events are forwarded to the underlying objects, e.g. for axis range dragging + ,srmZoom ///< When dragging the mouse, a selection rect becomes active. Upon releasing, the axes that are currently set as range zoom axes (\ref QCPAxisRect::setRangeZoomAxes) will have their ranges zoomed accordingly. + ,srmSelect ///< When dragging the mouse, a selection rect becomes active. Upon releasing, plottable data points that were within the selection rect are selected, if the plottable's selectability setting permits. (See \ref dataselection "data selection mechanism" for details.) + ,srmCustom ///< When dragging the mouse, a selection rect becomes active. It is the programmer's responsibility to connect according slots to the selection rect's signals (e.g. \ref QCPSelectionRect::accepted) in order to process the user interaction. + }; + +/*! + Defines the different ways a plottable can be selected. These images show the effect of the + different selection types, when the indicated selection rect was dragged: + +
+ + + + + + + + +
\image html selectiontype-none.png stNone\image html selectiontype-whole.png stWhole\image html selectiontype-singledata.png stSingleData\image html selectiontype-datarange.png stDataRange\image html selectiontype-multipledataranges.png stMultipleDataRanges
+
+ + \see QCPAbstractPlottable::setSelectable, QCPDataSelection::enforceType +*/ +enum SelectionType { stNone ///< The plottable is not selectable + ,stWhole ///< Selection behaves like \ref stMultipleDataRanges, but if there are any data points selected, the entire plottable is drawn as selected. + ,stSingleData ///< One individual data point can be selected at a time + ,stDataRange ///< Multiple contiguous data points (a data range) can be selected + ,stMultipleDataRanges ///< Any combination of data points/ranges can be selected + }; + +/*! \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; +} + + +extern const QMetaObject staticMetaObject; // in moc-run we create a static meta object for QCP "fake" object. This line is the link to it via QCP::staticMetaObject in normal operation as namespace + +} // 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) +Q_DECLARE_METATYPE(QCP::ExportPen) +Q_DECLARE_METATYPE(QCP::ResolutionUnit) +Q_DECLARE_METATYPE(QCP::SignDomain) +Q_DECLARE_METATYPE(QCP::MarginSide) +Q_DECLARE_METATYPE(QCP::AntialiasedElement) +Q_DECLARE_METATYPE(QCP::PlottingHint) +Q_DECLARE_METATYPE(QCP::Interaction) +Q_DECLARE_METATYPE(QCP::SelectionRectMode) +Q_DECLARE_METATYPE(QCP::SelectionType) + +/* end of 'src/global.h' */ + + +/* including file 'src/vector2d.h', size 4928 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCP_LIB_DECL QCPVector2D +{ +public: + QCPVector2D(); + QCPVector2D(double x, double y); + QCPVector2D(const QPoint &point); + QCPVector2D(const QPointF &point); + + // getters: + double x() const { return mX; } + double y() const { return mY; } + double &rx() { return mX; } + double &ry() { return mY; } + + // setters: + void setX(double x) { mX = x; } + void setY(double y) { mY = y; } + + // non-virtual methods: + double length() const { return qSqrt(mX*mX+mY*mY); } + double lengthSquared() const { return mX*mX+mY*mY; } + QPoint toPoint() const { return QPoint(mX, mY); } + QPointF toPointF() const { return QPointF(mX, mY); } + + bool isNull() const { return qIsNull(mX) && qIsNull(mY); } + void normalize(); + QCPVector2D normalized() const; + QCPVector2D perpendicular() const { return QCPVector2D(-mY, mX); } + double dot(const QCPVector2D &vec) const { return mX*vec.mX+mY*vec.mY; } + double distanceSquaredToLine(const QCPVector2D &start, const QCPVector2D &end) const; + double distanceSquaredToLine(const QLineF &line) const; + double distanceToStraightLine(const QCPVector2D &base, const QCPVector2D &direction) const; + + QCPVector2D &operator*=(double factor); + QCPVector2D &operator/=(double divisor); + QCPVector2D &operator+=(const QCPVector2D &vector); + QCPVector2D &operator-=(const QCPVector2D &vector); + +private: + // property members: + double mX, mY; + + friend inline const QCPVector2D operator*(double factor, const QCPVector2D &vec); + friend inline const QCPVector2D operator*(const QCPVector2D &vec, double factor); + friend inline const QCPVector2D operator/(const QCPVector2D &vec, double divisor); + friend inline const QCPVector2D operator+(const QCPVector2D &vec1, const QCPVector2D &vec2); + friend inline const QCPVector2D operator-(const QCPVector2D &vec1, const QCPVector2D &vec2); + friend inline const QCPVector2D operator-(const QCPVector2D &vec); +}; +Q_DECLARE_TYPEINFO(QCPVector2D, Q_MOVABLE_TYPE); + +inline const QCPVector2D operator*(double factor, const QCPVector2D &vec) { return QCPVector2D(vec.mX*factor, vec.mY*factor); } +inline const QCPVector2D operator*(const QCPVector2D &vec, double factor) { return QCPVector2D(vec.mX*factor, vec.mY*factor); } +inline const QCPVector2D operator/(const QCPVector2D &vec, double divisor) { return QCPVector2D(vec.mX/divisor, vec.mY/divisor); } +inline const QCPVector2D operator+(const QCPVector2D &vec1, const QCPVector2D &vec2) { return QCPVector2D(vec1.mX+vec2.mX, vec1.mY+vec2.mY); } +inline const QCPVector2D operator-(const QCPVector2D &vec1, const QCPVector2D &vec2) { return QCPVector2D(vec1.mX-vec2.mX, vec1.mY-vec2.mY); } +inline const QCPVector2D operator-(const QCPVector2D &vec) { return QCPVector2D(-vec.mX, -vec.mY); } + +/*! \relates QCPVector2D + + Prints \a vec in a human readable format to the qDebug output. +*/ +inline QDebug operator<< (QDebug d, const QCPVector2D &vec) +{ + d.nospace() << "QCPVector2D(" << vec.x() << ", " << vec.y() << ")"; + return d.space(); +} + +/* end of 'src/vector2d.h' */ + + +/* including file 'src/painter.h', size 4035 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +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 ///< 0x00 Default mode for painting on screen devices + ,pmVectorized = 0x01 ///< 0x01 Mode for vectorized painting (e.g. PDF export). For example, this prevents some antialiasing fixes. + ,pmNoCaching = 0x02 ///< 0x02 Mode for all sorts of exports (e.g. PNG, PDF,...). For example, this prevents using cached pixmap labels + ,pmNonCosmetic = 0x04 ///< 0x04 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_ENUMS(PainterMode) + Q_FLAGS(PainterModes) + Q_DECLARE_FLAGS(PainterModes, PainterMode) + + QCPPainter(); + explicit QCPPainter(QPaintDevice *device); + + // 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 mAntialiasingStack; +}; +Q_DECLARE_OPERATORS_FOR_FLAGS(QCPPainter::PainterModes) +Q_DECLARE_METATYPE(QCPPainter::PainterMode) + +/* end of 'src/painter.h' */ + + +/* including file 'src/paintbuffer.h', size 4958 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCP_LIB_DECL QCPAbstractPaintBuffer +{ +public: + explicit QCPAbstractPaintBuffer(const QSize &size, double devicePixelRatio); + virtual ~QCPAbstractPaintBuffer(); + + // getters: + QSize size() const { return mSize; } + bool invalidated() const { return mInvalidated; } + double devicePixelRatio() const { return mDevicePixelRatio; } + + // setters: + void setSize(const QSize &size); + void setInvalidated(bool invalidated=true); + void setDevicePixelRatio(double ratio); + + // introduced virtual methods: + virtual QCPPainter *startPainting() = 0; + virtual void donePainting() {} + virtual void draw(QCPPainter *painter) const = 0; + virtual void clear(const QColor &color) = 0; + +protected: + // property members: + QSize mSize; + double mDevicePixelRatio; + + // non-property members: + bool mInvalidated; + + // introduced virtual methods: + virtual void reallocateBuffer() = 0; +}; + + +class QCP_LIB_DECL QCPPaintBufferPixmap : public QCPAbstractPaintBuffer +{ +public: + explicit QCPPaintBufferPixmap(const QSize &size, double devicePixelRatio); + virtual ~QCPPaintBufferPixmap(); + + // reimplemented virtual methods: + virtual QCPPainter *startPainting() Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) const Q_DECL_OVERRIDE; + void clear(const QColor &color) Q_DECL_OVERRIDE; + +protected: + // non-property members: + QPixmap mBuffer; + + // reimplemented virtual methods: + virtual void reallocateBuffer() Q_DECL_OVERRIDE; +}; + + +#ifdef QCP_OPENGL_PBUFFER +class QCP_LIB_DECL QCPPaintBufferGlPbuffer : public QCPAbstractPaintBuffer +{ +public: + explicit QCPPaintBufferGlPbuffer(const QSize &size, double devicePixelRatio, int multisamples); + virtual ~QCPPaintBufferGlPbuffer(); + + // reimplemented virtual methods: + virtual QCPPainter *startPainting() Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) const Q_DECL_OVERRIDE; + void clear(const QColor &color) Q_DECL_OVERRIDE; + +protected: + // non-property members: + QGLPixelBuffer *mGlPBuffer; + int mMultisamples; + + // reimplemented virtual methods: + virtual void reallocateBuffer() Q_DECL_OVERRIDE; +}; +#endif // QCP_OPENGL_PBUFFER + + +#ifdef QCP_OPENGL_FBO +class QCP_LIB_DECL QCPPaintBufferGlFbo : public QCPAbstractPaintBuffer +{ +public: + explicit QCPPaintBufferGlFbo(const QSize &size, double devicePixelRatio, QWeakPointer glContext, QWeakPointer glPaintDevice); + virtual ~QCPPaintBufferGlFbo(); + + // reimplemented virtual methods: + virtual QCPPainter *startPainting() Q_DECL_OVERRIDE; + virtual void donePainting() Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) const Q_DECL_OVERRIDE; + void clear(const QColor &color) Q_DECL_OVERRIDE; + +protected: + // non-property members: + QWeakPointer mGlContext; + QWeakPointer mGlPaintDevice; + QOpenGLFramebufferObject *mGlFrameBuffer; + + // reimplemented virtual methods: + virtual void reallocateBuffer() Q_DECL_OVERRIDE; +}; +#endif // QCP_OPENGL_FBO + +/* end of 'src/paintbuffer.h' */ + + +/* including file 'src/layer.h', size 6885 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +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 children READ children) + Q_PROPERTY(bool visible READ visible WRITE setVisible) + Q_PROPERTY(LayerMode mode READ mode WRITE setMode) + /// \endcond +public: + + /*! + Defines the different rendering modes of a layer. Depending on the mode, certain layers can be + replotted individually, without the need to replot (possibly complex) layerables on other + layers. + + \see setMode + */ + 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). + }; + Q_ENUMS(LayerMode) + + QCPLayer(QCustomPlot* parentPlot, const QString &layerName); + virtual ~QCPLayer(); + + // getters: + QCustomPlot *parentPlot() const { return mParentPlot; } + QString name() const { return mName; } + int index() const { return mIndex; } + QList children() const { return mChildren; } + bool visible() const { return mVisible; } + LayerMode mode() const { return mMode; } + + // setters: + void setVisible(bool visible); + void setMode(LayerMode mode); + + // non-virtual methods: + void replot(); + +protected: + // property members: + QCustomPlot *mParentPlot; + QString mName; + int mIndex; + QList mChildren; + bool mVisible; + LayerMode mMode; + + // non-property members: + QWeakPointer mPaintBuffer; + + // non-virtual methods: + void draw(QCPPainter *painter); + void drawToPaintBuffer(); + void addChild(QCPLayerable *layerable, bool prepend); + void removeChild(QCPLayerable *layerable); + +private: + Q_DISABLE_COPY(QCPLayer) + + friend class QCustomPlot; + friend class QCPLayerable; +}; +Q_DECLARE_METATYPE(QCPLayer::LayerMode) + +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); + virtual ~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 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; + // selection events: + virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged); + virtual void deselectEvent(bool *selectionStateChanged); + // low-level mouse events: + virtual void mousePressEvent(QMouseEvent *event, const QVariant &details); + virtual void mouseMoveEvent(QMouseEvent *event, const QPointF &startPos); + virtual void mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos); + virtual void mouseDoubleClickEvent(QMouseEvent *event, const QVariant &details); + virtual void wheelEvent(QWheelEvent *event); + + // 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 QCPLayer; + friend class QCPAxisRect; +}; + +/* end of 'src/layer.h' */ + + +/* including file 'src/axis/range.h', size 5280 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +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 { return upper-lower; } + double center() const { return (upper+lower)*0.5; } + void normalize() { if (lower > upper) qSwap(lower, upper); } + void expand(const QCPRange &otherRange); + void expand(double includeCoord); + QCPRange expanded(const QCPRange &otherRange) const; + QCPRange expanded(double includeCoord) const; + QCPRange bounded(double lowerBound, double upperBound) const; + QCPRange sanitizedForLogScale() const; + QCPRange sanitizedForLinScale() const; + bool contains(double value) const { return value >= lower && value <= upper; } + + static bool validRange(double lower, double upper); + static bool validRange(const QCPRange &range); + static const double minRange; + static const double maxRange; + +}; +Q_DECLARE_TYPEINFO(QCPRange, Q_MOVABLE_TYPE); + +/*! \relates QCPRange + + Prints \a range in a human readable format to the qDebug output. +*/ +inline QDebug operator<< (QDebug d, const QCPRange &range) +{ + d.nospace() << "QCPRange(" << range.lower << ", " << range.upper << ")"; + return d.space(); +} + +/*! + 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; +} + +/* end of 'src/axis/range.h' */ + + +/* including file 'src/selection.h', size 8569 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCP_LIB_DECL QCPDataRange +{ +public: + QCPDataRange(); + QCPDataRange(int begin, int end); + + bool operator==(const QCPDataRange& other) const { return mBegin == other.mBegin && mEnd == other.mEnd; } + bool operator!=(const QCPDataRange& other) const { return !(*this == other); } + + // getters: + int begin() const { return mBegin; } + int end() const { return mEnd; } + int size() const { return mEnd-mBegin; } + int length() const { return size(); } + + // setters: + void setBegin(int begin) { mBegin = begin; } + void setEnd(int end) { mEnd = end; } + + // non-property methods: + bool isValid() const { return (mEnd >= mBegin) && (mBegin >= 0); } + bool isEmpty() const { return length() == 0; } + QCPDataRange bounded(const QCPDataRange &other) const; + QCPDataRange expanded(const QCPDataRange &other) const; + QCPDataRange intersection(const QCPDataRange &other) const; + QCPDataRange adjusted(int changeBegin, int changeEnd) const { return QCPDataRange(mBegin+changeBegin, mEnd+changeEnd); } + bool intersects(const QCPDataRange &other) const; + bool contains(const QCPDataRange &other) const; + +private: + // property members: + int mBegin, mEnd; + +}; +Q_DECLARE_TYPEINFO(QCPDataRange, Q_MOVABLE_TYPE); + + +class QCP_LIB_DECL QCPDataSelection +{ +public: + explicit QCPDataSelection(); + explicit QCPDataSelection(const QCPDataRange &range); + + bool operator==(const QCPDataSelection& other) const; + bool operator!=(const QCPDataSelection& other) const { return !(*this == other); } + QCPDataSelection &operator+=(const QCPDataSelection& other); + QCPDataSelection &operator+=(const QCPDataRange& other); + QCPDataSelection &operator-=(const QCPDataSelection& other); + QCPDataSelection &operator-=(const QCPDataRange& other); + friend inline const QCPDataSelection operator+(const QCPDataSelection& a, const QCPDataSelection& b); + friend inline const QCPDataSelection operator+(const QCPDataRange& a, const QCPDataSelection& b); + friend inline const QCPDataSelection operator+(const QCPDataSelection& a, const QCPDataRange& b); + friend inline const QCPDataSelection operator+(const QCPDataRange& a, const QCPDataRange& b); + friend inline const QCPDataSelection operator-(const QCPDataSelection& a, const QCPDataSelection& b); + friend inline const QCPDataSelection operator-(const QCPDataRange& a, const QCPDataSelection& b); + friend inline const QCPDataSelection operator-(const QCPDataSelection& a, const QCPDataRange& b); + friend inline const QCPDataSelection operator-(const QCPDataRange& a, const QCPDataRange& b); + + // getters: + int dataRangeCount() const { return mDataRanges.size(); } + int dataPointCount() const; + QCPDataRange dataRange(int index=0) const; + QList dataRanges() const { return mDataRanges; } + QCPDataRange span() const; + + // non-property methods: + void addDataRange(const QCPDataRange &dataRange, bool simplify=true); + void clear(); + bool isEmpty() const { return mDataRanges.isEmpty(); } + void simplify(); + void enforceType(QCP::SelectionType type); + bool contains(const QCPDataSelection &other) const; + QCPDataSelection intersection(const QCPDataRange &other) const; + QCPDataSelection intersection(const QCPDataSelection &other) const; + QCPDataSelection inverse(const QCPDataRange &outerRange) const; + +private: + // property members: + QList mDataRanges; + + inline static bool lessThanDataRangeBegin(const QCPDataRange &a, const QCPDataRange &b) { return a.begin() < b.begin(); } +}; +Q_DECLARE_METATYPE(QCPDataSelection) + + +/*! + Return a \ref QCPDataSelection with the data points in \a a joined with the data points in \a b. + The resulting data selection is already simplified (see \ref QCPDataSelection::simplify). +*/ +inline const QCPDataSelection operator+(const QCPDataSelection& a, const QCPDataSelection& b) +{ + QCPDataSelection result(a); + result += b; + return result; +} + +/*! + Return a \ref QCPDataSelection with the data points in \a a joined with the data points in \a b. + The resulting data selection is already simplified (see \ref QCPDataSelection::simplify). +*/ +inline const QCPDataSelection operator+(const QCPDataRange& a, const QCPDataSelection& b) +{ + QCPDataSelection result(a); + result += b; + return result; +} + +/*! + Return a \ref QCPDataSelection with the data points in \a a joined with the data points in \a b. + The resulting data selection is already simplified (see \ref QCPDataSelection::simplify). +*/ +inline const QCPDataSelection operator+(const QCPDataSelection& a, const QCPDataRange& b) +{ + QCPDataSelection result(a); + result += b; + return result; +} + +/*! + Return a \ref QCPDataSelection with the data points in \a a joined with the data points in \a b. + The resulting data selection is already simplified (see \ref QCPDataSelection::simplify). +*/ +inline const QCPDataSelection operator+(const QCPDataRange& a, const QCPDataRange& b) +{ + QCPDataSelection result(a); + result += b; + return result; +} + +/*! + Return a \ref QCPDataSelection with the data points which are in \a a but not in \a b. +*/ +inline const QCPDataSelection operator-(const QCPDataSelection& a, const QCPDataSelection& b) +{ + QCPDataSelection result(a); + result -= b; + return result; +} + +/*! + Return a \ref QCPDataSelection with the data points which are in \a a but not in \a b. +*/ +inline const QCPDataSelection operator-(const QCPDataRange& a, const QCPDataSelection& b) +{ + QCPDataSelection result(a); + result -= b; + return result; +} + +/*! + Return a \ref QCPDataSelection with the data points which are in \a a but not in \a b. +*/ +inline const QCPDataSelection operator-(const QCPDataSelection& a, const QCPDataRange& b) +{ + QCPDataSelection result(a); + result -= b; + return result; +} + +/*! + Return a \ref QCPDataSelection with the data points which are in \a a but not in \a b. +*/ +inline const QCPDataSelection operator-(const QCPDataRange& a, const QCPDataRange& b) +{ + QCPDataSelection result(a); + result -= b; + return result; +} + +/*! \relates QCPDataRange + + Prints \a dataRange in a human readable format to the qDebug output. +*/ +inline QDebug operator<< (QDebug d, const QCPDataRange &dataRange) +{ + d.nospace() << "QCPDataRange(" << dataRange.begin() << ", " << dataRange.end() << ")"; + return d; +} + +/*! \relates QCPDataSelection + + Prints \a selection in a human readable format to the qDebug output. +*/ +inline QDebug operator<< (QDebug d, const QCPDataSelection &selection) +{ + d.nospace() << "QCPDataSelection("; + for (int i=0; i elements(QCP::MarginSide side) const { return mChildren.value(side); } + bool isEmpty() const; + void clear(); + +protected: + // non-property members: + QCustomPlot *mParentPlot; + QHash > mChildren; + + // introduced virtual methods: + virtual int commonMargin(QCP::MarginSide side) const; + + // non-virtual methods: + 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) + Q_PROPERTY(SizeConstraintRect sizeConstraintRect READ sizeConstraintRect WRITE setSizeConstraintRect) + /// \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) + + /*! + Defines to which rect of a layout element the size constraints that can be set via \ref + setMinimumSize and \ref setMaximumSize apply. The outer rect (\ref outerRect) includes the + margins (e.g. in the case of a QCPAxisRect the axis labels), whereas the inner rect (\ref rect) + does not. + + \see setSizeConstraintRect + */ + enum SizeConstraintRect { scrInnerRect ///< Minimum/Maximum size constraints apply to inner rect + , scrOuterRect ///< Minimum/Maximum size constraints apply to outer rect, thus include layout element margins + }; + Q_ENUMS(SizeConstraintRect) + + 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; } + SizeConstraintRect sizeConstraintRect() const { return mSizeConstraintRect; } + QCPMarginGroup *marginGroup(QCP::MarginSide side) const { return mMarginGroups.value(side, (QCPMarginGroup*)0); } + QHash 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 setSizeConstraintRect(SizeConstraintRect constraintRect); + void setMarginGroup(QCP::MarginSides sides, QCPMarginGroup *group); + + // introduced virtual methods: + virtual void update(UpdatePhase phase); + virtual QSize minimumOuterSizeHint() const; + virtual QSize maximumOuterSizeHint() const; + virtual QList elements(bool recursive) const; + + // reimplemented virtual methods: + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const Q_DECL_OVERRIDE; + +protected: + // property members: + QCPLayout *mParentLayout; + QSize mMinimumSize, mMaximumSize; + SizeConstraintRect mSizeConstraintRect; + QRect mRect, mOuterRect; + QMargins mMargins, mMinimumMargins; + QCP::MarginSides mAutoMargins; + QHash mMarginGroups; + + // introduced virtual methods: + virtual int calculateAutoMargin(QCP::MarginSide side); + virtual void layoutChanged(); + + // reimplemented virtual methods: + virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE { Q_UNUSED(painter) } + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE { Q_UNUSED(painter) } + virtual void parentPlotInitialized(QCustomPlot *parentPlot) Q_DECL_OVERRIDE; + +private: + Q_DISABLE_COPY(QCPLayoutElement) + + friend class QCustomPlot; + friend class QCPLayout; + friend class QCPMarginGroup; +}; +Q_DECLARE_METATYPE(QCPLayoutElement::UpdatePhase) + + +class QCP_LIB_DECL QCPLayout : public QCPLayoutElement +{ + Q_OBJECT +public: + explicit QCPLayout(); + + // reimplemented virtual methods: + virtual void update(UpdatePhase phase) Q_DECL_OVERRIDE; + virtual QList elements(bool recursive) const Q_DECL_OVERRIDE; + + // 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 getSectionSizes(QVector maxSizes, QVector minSizes, QVector stretchFactors, int totalSize) const; + static QSize getFinalMinimumOuterSize(const QCPLayoutElement *el); + static QSize getFinalMaximumOuterSize(const QCPLayoutElement *el); + +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 columnStretchFactors READ columnStretchFactors WRITE setColumnStretchFactors) + Q_PROPERTY(QList rowStretchFactors READ rowStretchFactors WRITE setRowStretchFactors) + Q_PROPERTY(int columnSpacing READ columnSpacing WRITE setColumnSpacing) + Q_PROPERTY(int rowSpacing READ rowSpacing WRITE setRowSpacing) + Q_PROPERTY(FillOrder fillOrder READ fillOrder WRITE setFillOrder) + Q_PROPERTY(int wrap READ wrap WRITE setWrap) + /// \endcond +public: + + /*! + Defines in which direction the grid is filled when using \ref addElement(QCPLayoutElement*). + The column/row at which wrapping into the next row/column occurs can be specified with \ref + setWrap. + + \see setFillOrder + */ + enum FillOrder { foRowsFirst ///< Rows are filled first, and a new element is wrapped to the next column if the row count would exceed \ref setWrap. + ,foColumnsFirst ///< Columns are filled first, and a new element is wrapped to the next row if the column count would exceed \ref setWrap. + }; + Q_ENUMS(FillOrder) + + explicit QCPLayoutGrid(); + virtual ~QCPLayoutGrid(); + + // getters: + int rowCount() const { return mElements.size(); } + int columnCount() const { return mElements.size() > 0 ? mElements.first().size() : 0; } + QList columnStretchFactors() const { return mColumnStretchFactors; } + QList rowStretchFactors() const { return mRowStretchFactors; } + int columnSpacing() const { return mColumnSpacing; } + int rowSpacing() const { return mRowSpacing; } + int wrap() const { return mWrap; } + FillOrder fillOrder() const { return mFillOrder; } + + // setters: + void setColumnStretchFactor(int column, double factor); + void setColumnStretchFactors(const QList &factors); + void setRowStretchFactor(int row, double factor); + void setRowStretchFactors(const QList &factors); + void setColumnSpacing(int pixels); + void setRowSpacing(int pixels); + void setWrap(int count); + void setFillOrder(FillOrder order, bool rearrange=true); + + // reimplemented virtual methods: + virtual void updateLayout() Q_DECL_OVERRIDE; + virtual int elementCount() const Q_DECL_OVERRIDE { return rowCount()*columnCount(); } + virtual QCPLayoutElement* elementAt(int index) const Q_DECL_OVERRIDE; + virtual QCPLayoutElement* takeAt(int index) Q_DECL_OVERRIDE; + virtual bool take(QCPLayoutElement* element) Q_DECL_OVERRIDE; + virtual QList elements(bool recursive) const Q_DECL_OVERRIDE; + virtual void simplify() Q_DECL_OVERRIDE; + virtual QSize minimumOuterSizeHint() const Q_DECL_OVERRIDE; + virtual QSize maximumOuterSizeHint() const Q_DECL_OVERRIDE; + + // non-virtual methods: + QCPLayoutElement *element(int row, int column) const; + bool addElement(int row, int column, QCPLayoutElement *element); + bool addElement(QCPLayoutElement *element); + bool hasElement(int row, int column); + void expandTo(int newRowCount, int newColumnCount); + void insertRow(int newIndex); + void insertColumn(int newIndex); + int rowColToIndex(int row, int column) const; + void indexToRowCol(int index, int &row, int &column) const; + +protected: + // property members: + QList > mElements; + QList mColumnStretchFactors; + QList mRowStretchFactors; + int mColumnSpacing, mRowSpacing; + int mWrap; + FillOrder mFillOrder; + + // non-virtual methods: + void getMinimumRowColSizes(QVector *minColWidths, QVector *minRowHeights) const; + void getMaximumRowColSizes(QVector *maxColWidths, QVector *maxRowHeights) const; + +private: + Q_DISABLE_COPY(QCPLayoutGrid) +}; +Q_DECLARE_METATYPE(QCPLayoutGrid::FillOrder) + + +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 + }; + Q_ENUMS(InsetPlacement) + + 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() Q_DECL_OVERRIDE; + virtual int elementCount() const Q_DECL_OVERRIDE; + virtual QCPLayoutElement* elementAt(int index) const Q_DECL_OVERRIDE; + virtual QCPLayoutElement* takeAt(int index) Q_DECL_OVERRIDE; + virtual bool take(QCPLayoutElement* element) Q_DECL_OVERRIDE; + virtual void simplify() Q_DECL_OVERRIDE {} + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const Q_DECL_OVERRIDE; + + // non-virtual methods: + void addElement(QCPLayoutElement *element, Qt::Alignment alignment); + void addElement(QCPLayoutElement *element, const QRectF &rect); + +protected: + // property members: + QList mElements; + QList mInsetPlacement; + QList mInsetAlignment; + QList mInsetRect; + +private: + Q_DISABLE_COPY(QCPLayoutInset) +}; +Q_DECLARE_METATYPE(QCPLayoutInset::InsetPlacement) + +/* end of 'src/layout.h' */ + + +/* including file 'src/lineending.h', size 4426 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +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 + */ + 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) + }; + Q_ENUMS(EndingStyle) + + 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 QCPVector2D &pos, const QCPVector2D &dir) const; + void draw(QCPPainter *painter, const QCPVector2D &pos, double angle) const; + +protected: + // property members: + EndingStyle mStyle; + double mWidth, mLength; + bool mInverted; +}; +Q_DECLARE_TYPEINFO(QCPLineEnding, Q_MOVABLE_TYPE); +Q_DECLARE_METATYPE(QCPLineEnding::EndingStyle) + +/* end of 'src/lineending.h' */ + + +/* including file 'src/axis/axisticker.h', size 4224 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCP_LIB_DECL QCPAxisTicker +{ + Q_GADGET +public: + /*! + Defines the strategies that the axis ticker may follow when choosing the size of the tick step. + + \see setTickStepStrategy + */ + enum TickStepStrategy + { + tssReadability ///< A nicely readable tick step is prioritized over matching the requested number of ticks (see \ref setTickCount) + ,tssMeetTickCount ///< Less readable tick steps are allowed which in turn facilitates getting closer to the requested tick count + }; + Q_ENUMS(TickStepStrategy) + + QCPAxisTicker(); + virtual ~QCPAxisTicker(); + + // getters: + TickStepStrategy tickStepStrategy() const { return mTickStepStrategy; } + int tickCount() const { return mTickCount; } + double tickOrigin() const { return mTickOrigin; } + + // setters: + void setTickStepStrategy(TickStepStrategy strategy); + void setTickCount(int count); + void setTickOrigin(double origin); + + // introduced virtual methods: + virtual void generate(const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector &ticks, QVector *subTicks, QVector *tickLabels); + +protected: + // property members: + TickStepStrategy mTickStepStrategy; + int mTickCount; + double mTickOrigin; + + // introduced virtual methods: + virtual double getTickStep(const QCPRange &range); + virtual int getSubTickCount(double tickStep); + virtual QString getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision); + virtual QVector createTickVector(double tickStep, const QCPRange &range); + virtual QVector createSubTickVector(int subTickCount, const QVector &ticks); + virtual QVector createLabelVector(const QVector &ticks, const QLocale &locale, QChar formatChar, int precision); + + // non-virtual methods: + void trimTicks(const QCPRange &range, QVector &ticks, bool keepOneOutlier) const; + double pickClosest(double target, const QVector &candidates) const; + double getMantissa(double input, double *magnitude=0) const; + double cleanMantissa(double input) const; + +private: + Q_DISABLE_COPY(QCPAxisTicker) + +}; +Q_DECLARE_METATYPE(QCPAxisTicker::TickStepStrategy) +Q_DECLARE_METATYPE(QSharedPointer) + +/* end of 'src/axis/axisticker.h' */ + + +/* including file 'src/axis/axistickerdatetime.h', size 3289 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCP_LIB_DECL QCPAxisTickerDateTime : public QCPAxisTicker +{ +public: + QCPAxisTickerDateTime(); + + // getters: + QString dateTimeFormat() const { return mDateTimeFormat; } + Qt::TimeSpec dateTimeSpec() const { return mDateTimeSpec; } + + // setters: + void setDateTimeFormat(const QString &format); + void setDateTimeSpec(Qt::TimeSpec spec); + void setTickOrigin(double origin); // hides base class method but calls baseclass implementation ("using" throws off IDEs and doxygen) + void setTickOrigin(const QDateTime &origin); + + // static methods: + static QDateTime keyToDateTime(double key); + static double dateTimeToKey(const QDateTime dateTime); + static double dateTimeToKey(const QDate date); + +protected: + // property members: + QString mDateTimeFormat; + Qt::TimeSpec mDateTimeSpec; + + // non-property members: + enum DateStrategy {dsNone, dsUniformTimeInDay, dsUniformDayInMonth} mDateStrategy; + + // reimplemented virtual methods: + virtual double getTickStep(const QCPRange &range) Q_DECL_OVERRIDE; + virtual int getSubTickCount(double tickStep) Q_DECL_OVERRIDE; + virtual QString getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE; + virtual QVector createTickVector(double tickStep, const QCPRange &range) Q_DECL_OVERRIDE; +}; + +/* end of 'src/axis/axistickerdatetime.h' */ + + +/* including file 'src/axis/axistickertime.h', size 3542 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCP_LIB_DECL QCPAxisTickerTime : public QCPAxisTicker +{ + Q_GADGET +public: + /*! + Defines the logical units in which fractions of time spans can be expressed. + + \see setFieldWidth, setTimeFormat + */ + enum TimeUnit { tuMilliseconds ///< Milliseconds, one thousandth of a second (%%z in \ref setTimeFormat) + ,tuSeconds ///< Seconds (%%s in \ref setTimeFormat) + ,tuMinutes ///< Minutes (%%m in \ref setTimeFormat) + ,tuHours ///< Hours (%%h in \ref setTimeFormat) + ,tuDays ///< Days (%%d in \ref setTimeFormat) + }; + Q_ENUMS(TimeUnit) + + QCPAxisTickerTime(); + + // getters: + QString timeFormat() const { return mTimeFormat; } + int fieldWidth(TimeUnit unit) const { return mFieldWidth.value(unit); } + + // setters: + void setTimeFormat(const QString &format); + void setFieldWidth(TimeUnit unit, int width); + +protected: + // property members: + QString mTimeFormat; + QHash mFieldWidth; + + // non-property members: + TimeUnit mSmallestUnit, mBiggestUnit; + QHash mFormatPattern; + + // reimplemented virtual methods: + virtual double getTickStep(const QCPRange &range) Q_DECL_OVERRIDE; + virtual int getSubTickCount(double tickStep) Q_DECL_OVERRIDE; + virtual QString getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE; + + // non-virtual methods: + void replaceUnit(QString &text, TimeUnit unit, int value) const; +}; +Q_DECLARE_METATYPE(QCPAxisTickerTime::TimeUnit) + +/* end of 'src/axis/axistickertime.h' */ + + +/* including file 'src/axis/axistickerfixed.h', size 3308 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCP_LIB_DECL QCPAxisTickerFixed : public QCPAxisTicker +{ + Q_GADGET +public: + /*! + Defines how the axis ticker may modify the specified tick step (\ref setTickStep) in order to + control the number of ticks in the axis range. + + \see setScaleStrategy + */ + enum ScaleStrategy { ssNone ///< Modifications are not allowed, the specified tick step is absolutely fixed. This might cause a high tick density and overlapping labels if the axis range is zoomed out. + ,ssMultiples ///< An integer multiple of the specified tick step is allowed. The used factor follows the base class properties of \ref setTickStepStrategy and \ref setTickCount. + ,ssPowers ///< An integer power of the specified tick step is allowed. + }; + Q_ENUMS(ScaleStrategy) + + QCPAxisTickerFixed(); + + // getters: + double tickStep() const { return mTickStep; } + ScaleStrategy scaleStrategy() const { return mScaleStrategy; } + + // setters: + void setTickStep(double step); + void setScaleStrategy(ScaleStrategy strategy); + +protected: + // property members: + double mTickStep; + ScaleStrategy mScaleStrategy; + + // reimplemented virtual methods: + virtual double getTickStep(const QCPRange &range) Q_DECL_OVERRIDE; +}; +Q_DECLARE_METATYPE(QCPAxisTickerFixed::ScaleStrategy) + +/* end of 'src/axis/axistickerfixed.h' */ + + +/* including file 'src/axis/axistickertext.h', size 3090 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCP_LIB_DECL QCPAxisTickerText : public QCPAxisTicker +{ +public: + QCPAxisTickerText(); + + // getters: + QMap &ticks() { return mTicks; } + int subTickCount() const { return mSubTickCount; } + + // setters: + void setTicks(const QMap &ticks); + void setTicks(const QVector &positions, const QVector &labels); + void setSubTickCount(int subTicks); + + // non-virtual methods: + void clear(); + void addTick(double position, const QString &label); + void addTicks(const QMap &ticks); + void addTicks(const QVector &positions, const QVector &labels); + +protected: + // property members: + QMap mTicks; + int mSubTickCount; + + // reimplemented virtual methods: + virtual double getTickStep(const QCPRange &range) Q_DECL_OVERRIDE; + virtual int getSubTickCount(double tickStep) Q_DECL_OVERRIDE; + virtual QString getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE; + virtual QVector createTickVector(double tickStep, const QCPRange &range) Q_DECL_OVERRIDE; +}; + +/* end of 'src/axis/axistickertext.h' */ + + +/* including file 'src/axis/axistickerpi.h', size 3911 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCP_LIB_DECL QCPAxisTickerPi : public QCPAxisTicker +{ + Q_GADGET +public: + /*! + Defines how fractions should be displayed in tick labels. + + \see setFractionStyle + */ + enum FractionStyle { fsFloatingPoint ///< Fractions are displayed as regular decimal floating point numbers, e.g. "0.25" or "0.125". + ,fsAsciiFractions ///< Fractions are written as rationals using ASCII characters only, e.g. "1/4" or "1/8" + ,fsUnicodeFractions ///< Fractions are written using sub- and superscript UTF-8 digits and the fraction symbol. + }; + Q_ENUMS(FractionStyle) + + QCPAxisTickerPi(); + + // getters: + QString piSymbol() const { return mPiSymbol; } + double piValue() const { return mPiValue; } + bool periodicity() const { return mPeriodicity; } + FractionStyle fractionStyle() const { return mFractionStyle; } + + // setters: + void setPiSymbol(QString symbol); + void setPiValue(double pi); + void setPeriodicity(int multiplesOfPi); + void setFractionStyle(FractionStyle style); + +protected: + // property members: + QString mPiSymbol; + double mPiValue; + int mPeriodicity; + FractionStyle mFractionStyle; + + // non-property members: + double mPiTickStep; // size of one tick step in units of mPiValue + + // reimplemented virtual methods: + virtual double getTickStep(const QCPRange &range) Q_DECL_OVERRIDE; + virtual int getSubTickCount(double tickStep) Q_DECL_OVERRIDE; + virtual QString getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE; + + // non-virtual methods: + void simplifyFraction(int &numerator, int &denominator) const; + QString fractionToString(int numerator, int denominator) const; + QString unicodeFraction(int numerator, int denominator) const; + QString unicodeSuperscript(int number) const; + QString unicodeSubscript(int number) const; +}; +Q_DECLARE_METATYPE(QCPAxisTickerPi::FractionStyle) + +/* end of 'src/axis/axistickerpi.h' */ + + +/* including file 'src/axis/axistickerlog.h', size 2663 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCP_LIB_DECL QCPAxisTickerLog : public QCPAxisTicker +{ +public: + QCPAxisTickerLog(); + + // getters: + double logBase() const { return mLogBase; } + int subTickCount() const { return mSubTickCount; } + + // setters: + void setLogBase(double base); + void setSubTickCount(int subTicks); + +protected: + // property members: + double mLogBase; + int mSubTickCount; + + // non-property members: + double mLogBaseLnInv; + + // reimplemented virtual methods: + virtual double getTickStep(const QCPRange &range) Q_DECL_OVERRIDE; + virtual int getSubTickCount(double tickStep) Q_DECL_OVERRIDE; + virtual QVector createTickVector(double tickStep, const QCPRange &range) Q_DECL_OVERRIDE; +}; + +/* end of 'src/axis/axistickerlog.h' */ + + +/* including file 'src/axis/axis.h', size 20698 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +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: + explicit 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 Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + + // 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(QCPRange range READ range WRITE setRange NOTIFY rangeChanged) + Q_PROPERTY(bool rangeReversed READ rangeReversed WRITE setRangeReversed) + Q_PROPERTY(QSharedPointer ticker READ ticker WRITE setTicker) + 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(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 numberFormat READ numberFormat WRITE setNumberFormat) + Q_PROPERTY(int numberPrecision READ numberPrecision WRITE setNumberPrecision) + Q_PROPERTY(QVector tickVector READ tickVector) + Q_PROPERTY(QVector tickVectorLabels READ tickVectorLabels) + Q_PROPERTY(int tickLengthIn READ tickLengthIn WRITE setTickLengthIn) + Q_PROPERTY(int tickLengthOut READ tickLengthOut WRITE setTickLengthOut) + Q_PROPERTY(bool subTicks READ subTicks WRITE setSubTicks) + 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 ///< 0x01 Axis is vertical and on the left side of the axis rect + ,atRight = 0x02 ///< 0x02 Axis is vertical and on the right side of the axis rect + ,atTop = 0x04 ///< 0x04 Axis is horizontal and on the top side of the axis rect + ,atBottom = 0x08 ///< 0x08 Axis is horizontal and on the bottom side of the axis rect + }; + Q_ENUMS(AxisType) + Q_FLAGS(AxisTypes) + Q_DECLARE_FLAGS(AxisTypes, AxisType) + /*! + 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 axis coordinates (possibly also \ref setTicker to a \ref QCPAxisTickerLog instance). + }; + 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_ENUMS(SelectablePart) + Q_FLAGS(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; } + const QCPRange range() const { return mRange; } + bool rangeReversed() const { return mRangeReversed; } + QSharedPointer ticker() const { return mTicker; } + bool ticks() const { return mTicks; } + bool tickLabels() const { return mTickLabels; } + int tickLabelPadding() const; + QFont tickLabelFont() const { return mTickLabelFont; } + QColor tickLabelColor() const { return mTickLabelColor; } + double tickLabelRotation() const; + LabelSide tickLabelSide() const; + QString numberFormat() const; + int numberPrecision() const { return mNumberPrecision; } + QVector tickVector() const { return mTickVector; } + QVector tickVectorLabels() const { return mTickVectorLabels; } + int tickLengthIn() const; + int tickLengthOut() const; + bool subTicks() const { return mSubTicks; } + 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); + 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 setTicker(QSharedPointer ticker); + void setTicks(bool show); + void setTickLabels(bool show); + void setTickLabelPadding(int padding); + void setTickLabelFont(const QFont &font); + void setTickLabelColor(const QColor &color); + void setTickLabelRotation(double degrees); + void setTickLabelSide(LabelSide side); + void setNumberFormat(const QString &formatCode); + void setNumberPrecision(int precision); + void setTickLength(int inside, int outside=0); + void setTickLengthIn(int inside); + void setTickLengthOut(int outside); + void setSubTicks(bool show); + 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 Q_DECL_OVERRIDE; + + // non-property methods: + Qt::Orientation orientation() const { return mOrientation; } + int pixelOrientation() const { return rangeReversed() != (orientation()==Qt::Vertical) ? -1 : 1; } + void moveRange(double diff); + void scaleRange(double factor); + 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 plottables() const; + QList graphs() const; + QList 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 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; + //double mTickLabelRotation; // in QCPAxisPainter + QFont mTickLabelFont, mSelectedTickLabelFont; + QColor mTickLabelColor, mSelectedTickLabelColor; + int mNumberPrecision; + QLatin1Char mNumberFormatChar; + bool mNumberBeautifulPowers; + //bool mNumberMultiplyCross; // QCPAxisPainter + // ticks and subticks: + bool mTicks; + bool mSubTicks; + //int mTickLengthIn, mTickLengthOut, mSubTickLengthIn, mSubTickLengthOut; // QCPAxisPainter + QPen mTickPen, mSelectedTickPen; + QPen mSubTickPen, mSelectedSubTickPen; + // scale and range: + QCPRange mRange; + bool mRangeReversed; + ScaleType mScaleType; + + // non-property members: + QCPGrid *mGrid; + QCPAxisPainterPrivate *mAxisPainter; + QSharedPointer mTicker; + QVector mTickVector; + QVector mTickVectorLabels; + QVector mSubTickVector; + bool mCachedMarginValid; + int mCachedMargin; + bool mDragging; + QCPRange mDragStartRange; + QCP::AntialiasedElements mAADragBackup, mNotAADragBackup; + + // introduced virtual methods: + virtual int calculateMargin(); + + // reimplemented virtual methods: + virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual QCP::Interaction selectionCategory() const Q_DECL_OVERRIDE; + // events: + virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE; + virtual void deselectEvent(bool *selectionStateChanged) Q_DECL_OVERRIDE; + // mouse events: + virtual void mousePressEvent(QMouseEvent *event, const QVariant &details) Q_DECL_OVERRIDE; + virtual void mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; + virtual void mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; + virtual void wheelEvent(QWheelEvent *event) Q_DECL_OVERRIDE; + + // non-virtual methods: + void setupTickVectors(); + 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::AxisType) +Q_DECLARE_METATYPE(QCPAxis::LabelSide) +Q_DECLARE_METATYPE(QCPAxis::ScaleType) +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 subTickPositions; + QVector tickPositions; + QVector tickLabels; + +protected: + struct CachedLabel + { + QPointF offset; + QPixmap pixmap; + }; + struct TickLabelData + { + QString basePart, expPart, suffixPart; + QRect baseBounds, expBounds, suffixBounds, totalBounds, rotatedTotalBounds; + QFont baseFont, expFont; + }; + QCustomPlot *mParentPlot; + QByteArray mLabelParameterHash; // to determine whether mLabelCache needs to be cleared due to changed parameters + QCache 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; +}; + +/* end of 'src/axis/axis.h' */ + + +/* including file 'src/scatterstyle.h', size 7275 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCP_LIB_DECL QCPScatterStyle +{ + Q_GADGET +public: + /*! + Represents the various properties of a scatter style instance. For example, this enum is used + to specify which properties of \ref QCPSelectionDecorator::setScatterStyle will be used when + highlighting selected data points. + + Specific scatter properties can be transferred between \ref QCPScatterStyle instances via \ref + setFromOther. + */ + enum ScatterProperty { spNone = 0x00 ///< 0x00 None + ,spPen = 0x01 ///< 0x01 The pen property, see \ref setPen + ,spBrush = 0x02 ///< 0x02 The brush property, see \ref setBrush + ,spSize = 0x04 ///< 0x04 The size property, see \ref setSize + ,spShape = 0x08 ///< 0x08 The shape property, see \ref setShape + ,spAll = 0xFF ///< 0xFF All properties + }; + Q_ENUMS(ScatterProperty) + Q_FLAGS(ScatterProperties) + Q_DECLARE_FLAGS(ScatterProperties, ScatterProperty) + + /*! + 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. + */ + 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) + }; + Q_ENUMS(ScatterShape) + + 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 setFromOther(const QCPScatterStyle &other, ScatterProperties properties); + 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 undefinePen(); + void applyTo(QCPPainter *painter, const QPen &defaultPen) const; + void drawShape(QCPPainter *painter, const 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); +Q_DECLARE_OPERATORS_FOR_FLAGS(QCPScatterStyle::ScatterProperties) +Q_DECLARE_METATYPE(QCPScatterStyle::ScatterProperty) +Q_DECLARE_METATYPE(QCPScatterStyle::ScatterShape) + +/* end of 'src/scatterstyle.h' */ + + +/* including file 'src/datacontainer.h', size 4596 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +/*! \relates QCPDataContainer + Returns whether the sort key of \a a is less than the sort key of \a b. + + \see QCPDataContainer::sort +*/ +template +inline bool qcpLessThanSortKey(const DataType &a, const DataType &b) { return a.sortKey() < b.sortKey(); } + +template +class QCPDataContainer // no QCP_LIB_DECL, template class ends up in header (cpp included below) +{ +public: + typedef typename QVector::const_iterator const_iterator; + typedef typename QVector::iterator iterator; + + QCPDataContainer(); + + // getters: + int size() const { return mData.size()-mPreallocSize; } + bool isEmpty() const { return size() == 0; } + bool autoSqueeze() const { return mAutoSqueeze; } + + // setters: + void setAutoSqueeze(bool enabled); + + // non-virtual methods: + void set(const QCPDataContainer &data); + void set(const QVector &data, bool alreadySorted=false); + void add(const QCPDataContainer &data); + void add(const QVector &data, bool alreadySorted=false); + void add(const DataType &data); + void removeBefore(double sortKey); + void removeAfter(double sortKey); + void remove(double sortKeyFrom, double sortKeyTo); + void remove(double sortKey); + void clear(); + void sort(); + void squeeze(bool preAllocation=true, bool postAllocation=true); + + const_iterator constBegin() const { return mData.constBegin()+mPreallocSize; } + const_iterator constEnd() const { return mData.constEnd(); } + iterator begin() { return mData.begin()+mPreallocSize; } + iterator end() { return mData.end(); } + const_iterator findBegin(double sortKey, bool expandedRange=true) const; + const_iterator findEnd(double sortKey, bool expandedRange=true) const; + const_iterator at(int index) const { return constBegin()+qBound(0, index, size()); } + QCPRange keyRange(bool &foundRange, QCP::SignDomain signDomain=QCP::sdBoth); + QCPRange valueRange(bool &foundRange, QCP::SignDomain signDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()); + QCPDataRange dataRange() const { return QCPDataRange(0, size()); } + void limitIteratorsToDataRange(const_iterator &begin, const_iterator &end, const QCPDataRange &dataRange) const; + +protected: + // property members: + bool mAutoSqueeze; + + // non-property memebers: + QVector mData; + int mPreallocSize; + int mPreallocIteration; + + // non-virtual methods: + void preallocateGrow(int minimumPreallocSize); + void performAutoSqueeze(); +}; + +// include implementation in header since it is a class template: + +/* including file 'src/datacontainer.cpp', size 31349 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPDataContainer +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPDataContainer + \brief The generic data container for one-dimensional plottables + + This class template provides a fast container for data storage of one-dimensional data. The data + type is specified as template parameter (called \a DataType in the following) and must provide + some methods as described in the \ref qcpdatacontainer-datatype "next section". + + The data is stored in a sorted fashion, which allows very quick lookups by the sorted key as well + as retrieval of ranges (see \ref findBegin, \ref findEnd, \ref keyRange) using binary search. The + container uses a preallocation and a postallocation scheme, such that appending and prepending + data (with respect to the sort key) is very fast and minimizes reallocations. If data is added + which needs to be inserted between existing keys, the merge usually can be done quickly too, + using the fact that existing data is always sorted. The user can further improve performance by + specifying that added data is already itself sorted by key, if he can guarantee that this is the + case (see for example \ref add(const QVector &data, bool alreadySorted)). + + The data can be accessed with the provided const iterators (\ref constBegin, \ref constEnd). If + it is necessary to alter existing data in-place, the non-const iterators can be used (\ref begin, + \ref end). Changing data members that are not the sort key (for most data types called \a key) is + safe from the container's perspective. + + Great care must be taken however if the sort key is modified through the non-const iterators. For + performance reasons, the iterators don't automatically cause a re-sorting upon their + manipulation. It is thus the responsibility of the user to leave the container in a sorted state + when finished with the data manipulation, before calling any other methods on the container. A + complete re-sort (e.g. after finishing all sort key manipulation) can be done by calling \ref + sort. Failing to do so can not be detected by the container efficiently and will cause both + rendering artifacts and potential data loss. + + Implementing one-dimensional plottables that make use of a \ref QCPDataContainer is usually + done by subclassing from \ref QCPAbstractPlottable1D "QCPAbstractPlottable1D", which + introduces an according \a mDataContainer member and some convenience methods. + + \section qcpdatacontainer-datatype Requirements for the DataType template parameter + + The template parameter DataType is the type of the stored data points. It must be + trivially copyable and have the following public methods, preferably inline: + + \li double sortKey() const\n Returns the member variable of this data point that is the + sort key, defining the ordering in the container. Often this variable is simply called \a key. + + \li static DataType fromSortKey(double sortKey)\n Returns a new instance of the data + type initialized with its sort key set to \a sortKey. + + \li static bool sortKeyIsMainKey()\n Returns true if the sort key is equal to the main + key (see method \c mainKey below). For most plottables this is the case. It is not the case for + example for \ref QCPCurve, which uses \a t as sort key and \a key as main key. This is the reason + why QCPCurve unlike QCPGraph can display parametric curves with loops. + + \li double mainKey() const\n Returns the variable of this data point considered the main + key. This is commonly the variable that is used as the coordinate of this data point on the key + axis of the plottable. This method is used for example when determining the automatic axis + rescaling of key axes (\ref QCPAxis::rescale). + + \li double mainValue() const\n Returns the variable of this data point considered the + main value. This is commonly the variable that is used as the coordinate of this data point on + the value axis of the plottable. + + \li QCPRange valueRange() const\n Returns the range this data point spans in the value + axis coordinate. If the data is single-valued (e.g. QCPGraphData), this is simply a range with + both lower and upper set to the main data point value. However if the data points can represent + multiple values at once (e.g QCPFinancialData with its \a high, \a low, \a open and \a close + values at each \a key) this method should return the range those values span. This method is used + for example when determining the automatic axis rescaling of value axes (\ref + QCPAxis::rescale). +*/ + +/* start documentation of inline functions */ + +/*! \fn int QCPDataContainer::size() const + + Returns the number of data points in the container. +*/ + +/*! \fn bool QCPDataContainer::isEmpty() const + + Returns whether this container holds no data points. +*/ + +/*! \fn QCPDataContainer::const_iterator QCPDataContainer::constBegin() const + + Returns a const iterator to the first data point in this container. +*/ + +/*! \fn QCPDataContainer::const_iterator QCPDataContainer::constEnd() const + + Returns a const iterator to the element past the last data point in this container. +*/ + +/*! \fn QCPDataContainer::iterator QCPDataContainer::begin() const + + Returns a non-const iterator to the first data point in this container. + + You can manipulate the data points in-place through the non-const iterators, but great care must + be taken when manipulating the sort key of a data point, see \ref sort, or the detailed + description of this class. +*/ + +/*! \fn QCPDataContainer::iterator QCPDataContainer::end() const + + Returns a non-const iterator to the element past the last data point in this container. + + You can manipulate the data points in-place through the non-const iterators, but great care must + be taken when manipulating the sort key of a data point, see \ref sort, or the detailed + description of this class. +*/ + +/*! \fn QCPDataContainer::const_iterator QCPDataContainer::at(int index) const + + Returns a const iterator to the element with the specified \a index. If \a index points beyond + the available elements in this container, returns \ref constEnd, i.e. an iterator past the last + valid element. + + You can use this method to easily obtain iterators from a \ref QCPDataRange, see the \ref + dataselection-accessing "data selection page" for an example. +*/ + +/*! \fn QCPDataRange QCPDataContainer::dataRange() const + + Returns a \ref QCPDataRange encompassing the entire data set of this container. This means the + begin index of the returned range is 0, and the end index is \ref size. +*/ + +/* end documentation of inline functions */ + +/*! + Constructs a QCPDataContainer used for plottable classes that represent a series of key-sorted + data +*/ +template +QCPDataContainer::QCPDataContainer() : + mAutoSqueeze(true), + mPreallocSize(0), + mPreallocIteration(0) +{ +} + +/*! + Sets whether the container automatically decides when to release memory from its post- and + preallocation pools when data points are removed. By default this is enabled and for typical + applications shouldn't be changed. + + If auto squeeze is disabled, you can manually decide when to release pre-/postallocation with + \ref squeeze. +*/ +template +void QCPDataContainer::setAutoSqueeze(bool enabled) +{ + if (mAutoSqueeze != enabled) + { + mAutoSqueeze = enabled; + if (mAutoSqueeze) + performAutoSqueeze(); + } +} + +/*! \overload + + Replaces the current data in this container with the provided \a data. + + \see add, remove +*/ +template +void QCPDataContainer::set(const QCPDataContainer &data) +{ + clear(); + add(data); +} + +/*! \overload + + Replaces the current data in this container with the provided \a data + + If you can guarantee that the data points in \a data have ascending order with respect to the + DataType's sort key, set \a alreadySorted to true to avoid an unnecessary sorting run. + + \see add, remove +*/ +template +void QCPDataContainer::set(const QVector &data, bool alreadySorted) +{ + mData = data; + mPreallocSize = 0; + mPreallocIteration = 0; + if (!alreadySorted) + sort(); +} + +/*! \overload + + Adds the provided \a data to the current data in this container. + + \see set, remove +*/ +template +void QCPDataContainer::add(const QCPDataContainer &data) +{ + if (data.isEmpty()) + return; + + const int n = data.size(); + const int oldSize = size(); + + if (oldSize > 0 && !qcpLessThanSortKey(*constBegin(), *(data.constEnd()-1))) // prepend if new data keys are all smaller than or equal to existing ones + { + if (mPreallocSize < n) + preallocateGrow(n); + mPreallocSize -= n; + std::copy(data.constBegin(), data.constEnd(), begin()); + } else // don't need to prepend, so append and merge if necessary + { + mData.resize(mData.size()+n); + std::copy(data.constBegin(), data.constEnd(), end()-n); + if (oldSize > 0 && !qcpLessThanSortKey(*(constEnd()-n-1), *(constEnd()-n))) // if appended range keys aren't all greater than existing ones, merge the two partitions + std::inplace_merge(begin(), end()-n, end(), qcpLessThanSortKey); + } +} + +/*! + Adds the provided data points in \a data to the current data. + + If you can guarantee that the data points in \a data have ascending order with respect to the + DataType's sort key, set \a alreadySorted to true to avoid an unnecessary sorting run. + + \see set, remove +*/ +template +void QCPDataContainer::add(const QVector &data, bool alreadySorted) +{ + if (data.isEmpty()) + return; + if (isEmpty()) + { + set(data, alreadySorted); + return; + } + + const int n = data.size(); + const int oldSize = size(); + + if (alreadySorted && oldSize > 0 && !qcpLessThanSortKey(*constBegin(), *(data.constEnd()-1))) // prepend if new data is sorted and keys are all smaller than or equal to existing ones + { + if (mPreallocSize < n) + preallocateGrow(n); + mPreallocSize -= n; + std::copy(data.constBegin(), data.constEnd(), begin()); + } else // don't need to prepend, so append and then sort and merge if necessary + { + mData.resize(mData.size()+n); + std::copy(data.constBegin(), data.constEnd(), end()-n); + if (!alreadySorted) // sort appended subrange if it wasn't already sorted + std::sort(end()-n, end(), qcpLessThanSortKey); + if (oldSize > 0 && !qcpLessThanSortKey(*(constEnd()-n-1), *(constEnd()-n))) // if appended range keys aren't all greater than existing ones, merge the two partitions + std::inplace_merge(begin(), end()-n, end(), qcpLessThanSortKey); + } +} + +/*! \overload + + Adds the provided single data point to the current data. + + \see remove +*/ +template +void QCPDataContainer::add(const DataType &data) +{ + if (isEmpty() || !qcpLessThanSortKey(data, *(constEnd()-1))) // quickly handle appends if new data key is greater or equal to existing ones + { + mData.append(data); + } else if (qcpLessThanSortKey(data, *constBegin())) // quickly handle prepends using preallocated space + { + if (mPreallocSize < 1) + preallocateGrow(1); + --mPreallocSize; + *begin() = data; + } else // handle inserts, maintaining sorted keys + { + QCPDataContainer::iterator insertionPoint = std::lower_bound(begin(), end(), data, qcpLessThanSortKey); + mData.insert(insertionPoint, data); + } +} + +/*! + Removes all data points with (sort-)keys smaller than or equal to \a sortKey. + + \see removeAfter, remove, clear +*/ +template +void QCPDataContainer::removeBefore(double sortKey) +{ + QCPDataContainer::iterator it = begin(); + QCPDataContainer::iterator itEnd = std::lower_bound(begin(), end(), DataType::fromSortKey(sortKey), qcpLessThanSortKey); + mPreallocSize += itEnd-it; // don't actually delete, just add it to the preallocated block (if it gets too large, squeeze will take care of it) + if (mAutoSqueeze) + performAutoSqueeze(); +} + +/*! + Removes all data points with (sort-)keys greater than or equal to \a sortKey. + + \see removeBefore, remove, clear +*/ +template +void QCPDataContainer::removeAfter(double sortKey) +{ + QCPDataContainer::iterator it = std::upper_bound(begin(), end(), DataType::fromSortKey(sortKey), qcpLessThanSortKey); + QCPDataContainer::iterator itEnd = end(); + mData.erase(it, itEnd); // typically adds it to the postallocated block + if (mAutoSqueeze) + performAutoSqueeze(); +} + +/*! + Removes all data points with (sort-)keys between \a sortKeyFrom and \a sortKeyTo. if \a + sortKeyFrom is greater or equal to \a sortKeyTo, the function does nothing. To remove a single + data point with known (sort-)key, use \ref remove(double sortKey). + + \see removeBefore, removeAfter, clear +*/ +template +void QCPDataContainer::remove(double sortKeyFrom, double sortKeyTo) +{ + if (sortKeyFrom >= sortKeyTo || isEmpty()) + return; + + QCPDataContainer::iterator it = std::lower_bound(begin(), end(), DataType::fromSortKey(sortKeyFrom), qcpLessThanSortKey); + QCPDataContainer::iterator itEnd = std::upper_bound(it, end(), DataType::fromSortKey(sortKeyTo), qcpLessThanSortKey); + mData.erase(it, itEnd); + if (mAutoSqueeze) + performAutoSqueeze(); +} + +/*! \overload + + Removes a single data point at \a sortKey. If the position is not known with absolute (binary) + precision, consider using \ref remove(double sortKeyFrom, double sortKeyTo) with a small + fuzziness interval around the suspected position, depeding on the precision with which the + (sort-)key is known. + + \see removeBefore, removeAfter, clear +*/ +template +void QCPDataContainer::remove(double sortKey) +{ + QCPDataContainer::iterator it = std::lower_bound(begin(), end(), DataType::fromSortKey(sortKey), qcpLessThanSortKey); + if (it != end() && it->sortKey() == sortKey) + { + if (it == begin()) + ++mPreallocSize; // don't actually delete, just add it to the preallocated block (if it gets too large, squeeze will take care of it) + else + mData.erase(it); + } + if (mAutoSqueeze) + performAutoSqueeze(); +} + +/*! + Removes all data points. + + \see remove, removeAfter, removeBefore +*/ +template +void QCPDataContainer::clear() +{ + mData.clear(); + mPreallocIteration = 0; + mPreallocSize = 0; +} + +/*! + Re-sorts all data points in the container by their sort key. + + When setting, adding or removing points using the QCPDataContainer interface (\ref set, \ref add, + \ref remove, etc.), the container makes sure to always stay in a sorted state such that a full + resort is never necessary. However, if you choose to directly manipulate the sort key on data + points by accessing and modifying it through the non-const iterators (\ref begin, \ref end), it + is your responsibility to bring the container back into a sorted state before any other methods + are called on it. This can be achieved by calling this method immediately after finishing the + sort key manipulation. +*/ +template +void QCPDataContainer::sort() +{ + std::sort(begin(), end(), qcpLessThanSortKey); +} + +/*! + Frees all unused memory that is currently in the preallocation and postallocation pools. + + Note that QCPDataContainer automatically decides whether squeezing is necessary, if \ref + setAutoSqueeze is left enabled. It should thus not be necessary to use this method for typical + applications. + + The parameters \a preAllocation and \a postAllocation control whether pre- and/or post allocation + should be freed, respectively. +*/ +template +void QCPDataContainer::squeeze(bool preAllocation, bool postAllocation) +{ + if (preAllocation) + { + if (mPreallocSize > 0) + { + std::copy(begin(), end(), mData.begin()); + mData.resize(size()); + mPreallocSize = 0; + } + mPreallocIteration = 0; + } + if (postAllocation) + mData.squeeze(); +} + +/*! + Returns an iterator to the data point with a (sort-)key that is equal to, just below, or just + above \a sortKey. If \a expandedRange is true, the data point just below \a sortKey will be + considered, otherwise the one just above. + + This can be used in conjunction with \ref findEnd to iterate over data points within a given key + range, including or excluding the bounding data points that are just beyond the specified range. + + If \a expandedRange is true but there are no data points below \a sortKey, \ref constBegin is + returned. + + If the container is empty, returns \ref constEnd. + + \see findEnd, QCPPlottableInterface1D::findBegin +*/ +template +typename QCPDataContainer::const_iterator QCPDataContainer::findBegin(double sortKey, bool expandedRange) const +{ + if (isEmpty()) + return constEnd(); + + QCPDataContainer::const_iterator it = std::lower_bound(constBegin(), constEnd(), DataType::fromSortKey(sortKey), qcpLessThanSortKey); + if (expandedRange && it != constBegin()) // also covers it == constEnd case, and we know --constEnd is valid because mData isn't empty + --it; + return it; +} + +/*! + Returns an iterator to the element after the data point with a (sort-)key that is equal to, just + above or just below \a sortKey. If \a expandedRange is true, the data point just above \a sortKey + will be considered, otherwise the one just below. + + This can be used in conjunction with \ref findBegin to iterate over data points within a given + key range, including the bounding data points that are just below and above the specified range. + + If \a expandedRange is true but there are no data points above \a sortKey, \ref constEnd is + returned. + + If the container is empty, \ref constEnd is returned. + + \see findBegin, QCPPlottableInterface1D::findEnd +*/ +template +typename QCPDataContainer::const_iterator QCPDataContainer::findEnd(double sortKey, bool expandedRange) const +{ + if (isEmpty()) + return constEnd(); + + QCPDataContainer::const_iterator it = std::upper_bound(constBegin(), constEnd(), DataType::fromSortKey(sortKey), qcpLessThanSortKey); + if (expandedRange && it != constEnd()) + ++it; + return it; +} + +/*! + Returns the range encompassed by the (main-)key coordinate of all data points. The output + parameter \a foundRange indicates whether a sensible range was found. If this is false, you + should not use the returned QCPRange (e.g. the data container is empty or all points have the + same key). + + Use \a signDomain to control which sign of the key coordinates should be considered. This is + relevant e.g. for logarithmic plots which can mathematically only display one sign domain at a + time. + + If the DataType reports that its main key is equal to the sort key (\a sortKeyIsMainKey), as is + the case for most plottables, this method uses this fact and finds the range very quickly. + + \see valueRange +*/ +template +QCPRange QCPDataContainer::keyRange(bool &foundRange, QCP::SignDomain signDomain) +{ + if (isEmpty()) + { + foundRange = false; + return QCPRange(); + } + QCPRange range; + bool haveLower = false; + bool haveUpper = false; + double current; + + QCPDataContainer::const_iterator it = constBegin(); + QCPDataContainer::const_iterator itEnd = constEnd(); + if (signDomain == QCP::sdBoth) // range may be anywhere + { + if (DataType::sortKeyIsMainKey()) // if DataType is sorted by main key (e.g. QCPGraph, but not QCPCurve), use faster algorithm by finding just first and last key with non-NaN value + { + while (it != itEnd) // find first non-nan going up from left + { + if (!qIsNaN(it->mainValue())) + { + range.lower = it->mainKey(); + haveLower = true; + break; + } + ++it; + } + it = itEnd; + while (it != constBegin()) // find first non-nan going down from right + { + --it; + if (!qIsNaN(it->mainValue())) + { + range.upper = it->mainKey(); + haveUpper = true; + break; + } + } + } else // DataType is not sorted by main key, go through all data points and accordingly expand range + { + while (it != itEnd) + { + if (!qIsNaN(it->mainValue())) + { + current = it->mainKey(); + if (current < range.lower || !haveLower) + { + range.lower = current; + haveLower = true; + } + if (current > range.upper || !haveUpper) + { + range.upper = current; + haveUpper = true; + } + } + ++it; + } + } + } else if (signDomain == QCP::sdNegative) // range may only be in the negative sign domain + { + while (it != itEnd) + { + if (!qIsNaN(it->mainValue())) + { + current = it->mainKey(); + if ((current < range.lower || !haveLower) && current < 0) + { + range.lower = current; + haveLower = true; + } + if ((current > range.upper || !haveUpper) && current < 0) + { + range.upper = current; + haveUpper = true; + } + } + ++it; + } + } else if (signDomain == QCP::sdPositive) // range may only be in the positive sign domain + { + while (it != itEnd) + { + if (!qIsNaN(it->mainValue())) + { + current = it->mainKey(); + if ((current < range.lower || !haveLower) && current > 0) + { + range.lower = current; + haveLower = true; + } + if ((current > range.upper || !haveUpper) && current > 0) + { + range.upper = current; + haveUpper = true; + } + } + ++it; + } + } + + foundRange = haveLower && haveUpper; + return range; +} + +/*! + Returns the range encompassed by the value coordinates of the data points in the specified key + range (\a inKeyRange), using the full \a DataType::valueRange reported by the data points. The + output parameter \a foundRange indicates whether a sensible range was found. If this is false, + you should not use the returned QCPRange (e.g. the data container is empty or all points have the + same value). + + If \a inKeyRange has both lower and upper bound set to zero (is equal to QCPRange()), + all data points are considered, without any restriction on the keys. + + Use \a signDomain to control which sign of the value coordinates should be considered. This is + relevant e.g. for logarithmic plots which can mathematically only display one sign domain at a + time. + + \see keyRange +*/ +template +QCPRange QCPDataContainer::valueRange(bool &foundRange, QCP::SignDomain signDomain, const QCPRange &inKeyRange) +{ + if (isEmpty()) + { + foundRange = false; + return QCPRange(); + } + QCPRange range; + const bool restrictKeyRange = inKeyRange != QCPRange(); + bool haveLower = false; + bool haveUpper = false; + QCPRange current; + QCPDataContainer::const_iterator itBegin = constBegin(); + QCPDataContainer::const_iterator itEnd = constEnd(); + if (DataType::sortKeyIsMainKey() && restrictKeyRange) + { + itBegin = findBegin(inKeyRange.lower); + itEnd = findEnd(inKeyRange.upper); + } + if (signDomain == QCP::sdBoth) // range may be anywhere + { + for (QCPDataContainer::const_iterator it = itBegin; it != itEnd; ++it) + { + if (restrictKeyRange && (it->mainKey() < inKeyRange.lower || it->mainKey() > inKeyRange.upper)) + continue; + current = it->valueRange(); + if ((current.lower < range.lower || !haveLower) && !qIsNaN(current.lower)) + { + range.lower = current.lower; + haveLower = true; + } + if ((current.upper > range.upper || !haveUpper) && !qIsNaN(current.upper)) + { + range.upper = current.upper; + haveUpper = true; + } + } + } else if (signDomain == QCP::sdNegative) // range may only be in the negative sign domain + { + for (QCPDataContainer::const_iterator it = itBegin; it != itEnd; ++it) + { + if (restrictKeyRange && (it->mainKey() < inKeyRange.lower || it->mainKey() > inKeyRange.upper)) + continue; + current = it->valueRange(); + if ((current.lower < range.lower || !haveLower) && current.lower < 0 && !qIsNaN(current.lower)) + { + range.lower = current.lower; + haveLower = true; + } + if ((current.upper > range.upper || !haveUpper) && current.upper < 0 && !qIsNaN(current.upper)) + { + range.upper = current.upper; + haveUpper = true; + } + } + } else if (signDomain == QCP::sdPositive) // range may only be in the positive sign domain + { + for (QCPDataContainer::const_iterator it = itBegin; it != itEnd; ++it) + { + if (restrictKeyRange && (it->mainKey() < inKeyRange.lower || it->mainKey() > inKeyRange.upper)) + continue; + current = it->valueRange(); + if ((current.lower < range.lower || !haveLower) && current.lower > 0 && !qIsNaN(current.lower)) + { + range.lower = current.lower; + haveLower = true; + } + if ((current.upper > range.upper || !haveUpper) && current.upper > 0 && !qIsNaN(current.upper)) + { + range.upper = current.upper; + haveUpper = true; + } + } + } + + foundRange = haveLower && haveUpper; + return range; +} + +/*! + Makes sure \a begin and \a end mark a data range that is both within the bounds of this data + container's data, as well as within the specified \a dataRange. The initial range described by + the passed iterators \a begin and \a end is never expanded, only contracted if necessary. + + This function doesn't require for \a dataRange to be within the bounds of this data container's + valid range. +*/ +template +void QCPDataContainer::limitIteratorsToDataRange(const_iterator &begin, const_iterator &end, const QCPDataRange &dataRange) const +{ + QCPDataRange iteratorRange(begin-constBegin(), end-constBegin()); + iteratorRange = iteratorRange.bounded(dataRange.bounded(this->dataRange())); + begin = constBegin()+iteratorRange.begin(); + end = constBegin()+iteratorRange.end(); +} + +/*! \internal + + Increases the preallocation pool to have a size of at least \a minimumPreallocSize. Depending on + the preallocation history, the container will grow by more than requested, to speed up future + consecutive size increases. + + if \a minimumPreallocSize is smaller than or equal to the current preallocation pool size, this + method does nothing. +*/ +template +void QCPDataContainer::preallocateGrow(int minimumPreallocSize) +{ + if (minimumPreallocSize <= mPreallocSize) + return; + + int newPreallocSize = minimumPreallocSize; + newPreallocSize += (1u< +void QCPDataContainer::performAutoSqueeze() +{ + const int totalAlloc = mData.capacity(); + const int postAllocSize = totalAlloc-mData.size(); + const int usedSize = size(); + bool shrinkPostAllocation = false; + bool shrinkPreAllocation = false; + if (totalAlloc > 650000) // if allocation is larger, shrink earlier with respect to total used size + { + shrinkPostAllocation = postAllocSize > usedSize*1.5; // QVector grow strategy is 2^n for static data. Watch out not to oscillate! + shrinkPreAllocation = mPreallocSize*10 > usedSize; + } else if (totalAlloc > 1000) // below 10 MiB raw data be generous with preallocated memory, below 1k points don't even bother + { + shrinkPostAllocation = postAllocSize > usedSize*5; + shrinkPreAllocation = mPreallocSize > usedSize*1.5; // preallocation can grow into postallocation, so can be smaller + } + + if (shrinkPreAllocation || shrinkPostAllocation) + squeeze(shrinkPreAllocation, shrinkPostAllocation); +} +/* end of 'src/datacontainer.cpp' */ + + +/* end of 'src/datacontainer.h' */ + + +/* including file 'src/plottable.h', size 8433 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCP_LIB_DECL QCPSelectionDecorator +{ + Q_GADGET +public: + QCPSelectionDecorator(); + virtual ~QCPSelectionDecorator(); + + // getters: + QPen pen() const { return mPen; } + QBrush brush() const { return mBrush; } + QCPScatterStyle scatterStyle() const { return mScatterStyle; } + QCPScatterStyle::ScatterProperties usedScatterProperties() const { return mUsedScatterProperties; } + + // setters: + void setPen(const QPen &pen); + void setBrush(const QBrush &brush); + void setScatterStyle(const QCPScatterStyle &scatterStyle, QCPScatterStyle::ScatterProperties usedProperties=QCPScatterStyle::spPen); + void setUsedScatterProperties(const QCPScatterStyle::ScatterProperties &properties); + + // non-virtual methods: + void applyPen(QCPPainter *painter) const; + void applyBrush(QCPPainter *painter) const; + QCPScatterStyle getFinalScatterStyle(const QCPScatterStyle &unselectedStyle) const; + + // introduced virtual methods: + virtual void copyFrom(const QCPSelectionDecorator *other); + virtual void drawDecoration(QCPPainter *painter, QCPDataSelection selection); + +protected: + // property members: + QPen mPen; + QBrush mBrush; + QCPScatterStyle mScatterStyle; + QCPScatterStyle::ScatterProperties mUsedScatterProperties; + // non-property members: + QCPAbstractPlottable *mPlottable; + + // introduced virtual methods: + virtual bool registerWithPlottable(QCPAbstractPlottable *plottable); + +private: + Q_DISABLE_COPY(QCPSelectionDecorator) + friend class QCPAbstractPlottable; +}; +Q_DECLARE_METATYPE(QCPSelectionDecorator*) + + +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(QPen pen READ pen WRITE setPen) + Q_PROPERTY(QBrush brush READ brush WRITE setBrush) + Q_PROPERTY(QCPAxis* keyAxis READ keyAxis WRITE setKeyAxis) + Q_PROPERTY(QCPAxis* valueAxis READ valueAxis WRITE setValueAxis) + Q_PROPERTY(QCP::SelectionType selectable READ selectable WRITE setSelectable NOTIFY selectableChanged) + Q_PROPERTY(QCPDataSelection selection READ selection WRITE setSelection NOTIFY selectionChanged) + Q_PROPERTY(QCPSelectionDecorator* selectionDecorator READ selectionDecorator WRITE setSelectionDecorator) + /// \endcond +public: + QCPAbstractPlottable(QCPAxis *keyAxis, QCPAxis *valueAxis); + virtual ~QCPAbstractPlottable(); + + // getters: + QString name() const { return mName; } + bool antialiasedFill() const { return mAntialiasedFill; } + bool antialiasedScatters() const { return mAntialiasedScatters; } + QPen pen() const { return mPen; } + QBrush brush() const { return mBrush; } + QCPAxis *keyAxis() const { return mKeyAxis.data(); } + QCPAxis *valueAxis() const { return mValueAxis.data(); } + QCP::SelectionType selectable() const { return mSelectable; } + bool selected() const { return !mSelection.isEmpty(); } + QCPDataSelection selection() const { return mSelection; } + QCPSelectionDecorator *selectionDecorator() const { return mSelectionDecorator; } + + // setters: + void setName(const QString &name); + void setAntialiasedFill(bool enabled); + void setAntialiasedScatters(bool enabled); + void setPen(const QPen &pen); + void setBrush(const QBrush &brush); + void setKeyAxis(QCPAxis *axis); + void setValueAxis(QCPAxis *axis); + Q_SLOT void setSelectable(QCP::SelectionType selectable); + Q_SLOT void setSelection(QCPDataSelection selection); + void setSelectionDecorator(QCPSelectionDecorator *decorator); + + // introduced virtual methods: + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const Q_DECL_OVERRIDE = 0; // actually introduced in QCPLayerable as non-pure, but we want to force reimplementation for plottables + virtual QCPPlottableInterface1D *interface1D() { return 0; } + virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const = 0; + virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const = 0; + + // non-property 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; + void rescaleAxes(bool onlyEnlarge=false) const; + void rescaleKeyAxis(bool onlyEnlarge=false) const; + void rescaleValueAxis(bool onlyEnlarge=false, bool inKeyRange=false) const; + bool addToLegend(QCPLegend *legend); + bool addToLegend(); + bool removeFromLegend(QCPLegend *legend) const; + bool removeFromLegend() const; + +signals: + void selectionChanged(bool selected); + void selectionChanged(const QCPDataSelection &selection); + void selectableChanged(QCP::SelectionType selectable); + +protected: + // property members: + QString mName; + bool mAntialiasedFill, mAntialiasedScatters; + QPen mPen; + QBrush mBrush; + QPointer mKeyAxis, mValueAxis; + QCP::SelectionType mSelectable; + QCPDataSelection mSelection; + QCPSelectionDecorator *mSelectionDecorator; + + // reimplemented virtual methods: + virtual QRect clipRect() const Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE = 0; + virtual QCP::Interaction selectionCategory() const Q_DECL_OVERRIDE; + void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; + // events: + virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE; + virtual void deselectEvent(bool *selectionStateChanged) Q_DECL_OVERRIDE; + + // introduced virtual methods: + virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const = 0; + + // non-virtual methods: + void applyFillAntialiasingHint(QCPPainter *painter) const; + void applyScattersAntialiasingHint(QCPPainter *painter) const; + +private: + Q_DISABLE_COPY(QCPAbstractPlottable) + + friend class QCustomPlot; + friend class QCPAxis; + friend class QCPPlottableLegendItem; +}; + + +/* end of 'src/plottable.h' */ + + +/* including file 'src/item.h', size 9384 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCP_LIB_DECL QCPItemAnchor +{ + Q_GADGET +public: + QCPItemAnchor(QCustomPlot *parentPlot, QCPAbstractItem *parentItem, const QString &name, int anchorId=-1); + virtual ~QCPItemAnchor(); + + // getters: + QString name() const { return mName; } + virtual QPointF pixelPosition() const; + +protected: + // property members: + QString mName; + + // non-property members: + QCustomPlot *mParentPlot; + QCPAbstractItem *mParentItem; + int mAnchorId; + QSet 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 +{ + Q_GADGET +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). + }; + Q_ENUMS(PositionType) + + 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 pixelPosition() const Q_DECL_OVERRIDE; + + // 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 setPixelPosition(const QPointF &pixelPosition); + +protected: + // property members: + PositionType mPositionTypeX, mPositionTypeY; + QPointer mKeyAxis, mValueAxis; + QPointer mAxisRect; + double mKey, mValue; + QCPItemAnchor *mParentAnchorX, *mParentAnchorY; + + // reimplemented virtual methods: + virtual QCPItemPosition *toQCPItemPosition() Q_DECL_OVERRIDE { return this; } + +private: + Q_DISABLE_COPY(QCPItemPosition) + +}; +Q_DECLARE_METATYPE(QCPItemPosition::PositionType) + + +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: + explicit 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 Q_DECL_OVERRIDE = 0; + + // non-virtual methods: + QList positions() const { return mPositions; } + QList 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 mClipAxisRect; + QList mPositions; + QList mAnchors; + bool mSelectable, mSelected; + + // reimplemented virtual methods: + virtual QCP::Interaction selectionCategory() const Q_DECL_OVERRIDE; + virtual QRect clipRect() const Q_DECL_OVERRIDE; + virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE = 0; + // events: + virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE; + virtual void deselectEvent(bool *selectionStateChanged) Q_DECL_OVERRIDE; + + // introduced virtual methods: + virtual QPointF anchorPixelPosition(int anchorId) const; + + // non-virtual methods: + double rectDistance(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; +}; + +/* end of 'src/item.h' */ + + +/* including file 'src/core.h', size 14886 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +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) + Q_PROPERTY(bool openGl READ openGl WRITE setOpenGl) + /// \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 { rpImmediateRefresh ///< Replots immediately and repaints the widget immediately by calling QWidget::repaint() after the replot + ,rpQueuedRefresh ///< Replots immediately, but queues the widget repaint, by calling QWidget::update() after the replot. This way multiple redundant widget repaints can be avoided. + ,rpRefreshHint ///< Whether to use immediate or queued refresh depends on whether the plotting hint \ref QCP::phImmediateRefresh is set, see \ref setPlottingHints. + ,rpQueuedReplot ///< Queues the entire replot for the next event loop iteration. This way multiple redundant replots can be avoided. The actual replot is then done with \ref rpRefreshHint priority. + }; + Q_ENUMS(RefreshPriority) + + explicit QCustomPlot(QWidget *parent = 0); + virtual ~QCustomPlot(); + + // getters: + QRect viewport() const { return mViewport; } + double bufferDevicePixelRatio() const { return mBufferDevicePixelRatio; } + 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; } + QCP::SelectionRectMode selectionRectMode() const { return mSelectionRectMode; } + QCPSelectionRect *selectionRect() const { return mSelectionRect; } + bool openGl() const { return mOpenGl; } + + // setters: + void setViewport(const QRect &rect); + void setBufferDevicePixelRatio(double ratio); + 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); + void setSelectionRectMode(QCP::SelectionRectMode mode); + void setSelectionRect(QCPSelectionRect *selectionRect); + void setOpenGl(bool enabled, int multisampling=16); + + // non-property methods: + // plottable interface: + QCPAbstractPlottable *plottable(int index); + QCPAbstractPlottable *plottable(); + bool removePlottable(QCPAbstractPlottable *plottable); + bool removePlottable(int index); + int clearPlottables(); + int plottableCount() const; + QList 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 selectedGraphs() const; + + // item interface: + QCPAbstractItem *item(int index) const; + QCPAbstractItem *item() const; + bool removeItem(QCPAbstractItem *item); + bool removeItem(int index); + int clearItems(); + int itemCount() const; + QList 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 axisRects() const; + QCPLayoutElement* layoutElementAt(const QPointF &pos) const; + QCPAxisRect* axisRectAt(const QPointF &pos) const; + Q_SLOT void rescaleAxes(bool onlyVisiblePlottables=false); + + QList selectedAxes() const; + QList selectedLegends() const; + Q_SLOT void deselectAll(); + + bool savePdf(const QString &fileName, int width=0, int height=0, QCP::ExportPen exportPen=QCP::epAllowCosmetic, 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, int resolution=96, QCP::ResolutionUnit resolutionUnit=QCP::ruDotsPerInch); + bool saveJpg(const QString &fileName, int width=0, int height=0, double scale=1.0, int quality=-1, int resolution=96, QCP::ResolutionUnit resolutionUnit=QCP::ruDotsPerInch); + bool saveBmp(const QString &fileName, int width=0, int height=0, double scale=1.0, int resolution=96, QCP::ResolutionUnit resolutionUnit=QCP::ruDotsPerInch); + bool saveRastered(const QString &fileName, int width, int height, double scale, const char *format, int quality=-1, int resolution=96, QCP::ResolutionUnit resolutionUnit=QCP::ruDotsPerInch); + 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::rpRefreshHint); + + 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, int dataIndex, QMouseEvent *event); + void plottableDoubleClick(QCPAbstractPlottable *plottable, int dataIndex, 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 selectionChangedByUser(); + void beforeReplot(); + void afterReplot(); + +protected: + // property members: + QRect mViewport; + double mBufferDevicePixelRatio; + QCPLayoutGrid *mPlotLayout; + bool mAutoAddPlottableToLegend; + QList mPlottables; + QList mGraphs; // extra list of plottables also in mPlottables that are of type QCPGraph + QList mItems; + QList 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; + QCP::SelectionRectMode mSelectionRectMode; + QCPSelectionRect *mSelectionRect; + bool mOpenGl; + + // non-property members: + QList > mPaintBuffers; + QPoint mMousePressPos; + bool mMouseHasMoved; + QPointer mMouseEventLayerable; + QPointer mMouseSignalLayerable; + QVariant mMouseEventLayerableDetails; + QVariant mMouseSignalLayerableDetails; + bool mReplotting; + bool mReplotQueued; + int mOpenGlMultisamples; + QCP::AntialiasedElements mOpenGlAntialiasedElementsBackup; + bool mOpenGlCacheLabelsBackup; +#ifdef QCP_OPENGL_FBO + QSharedPointer mGlContext; + QSharedPointer mGlSurface; + QSharedPointer mGlPaintDevice; +#endif + + // reimplemented virtual methods: + virtual QSize minimumSizeHint() const Q_DECL_OVERRIDE; + virtual QSize sizeHint() const Q_DECL_OVERRIDE; + virtual void paintEvent(QPaintEvent *event) Q_DECL_OVERRIDE; + virtual void resizeEvent(QResizeEvent *event) Q_DECL_OVERRIDE; + virtual void mouseDoubleClickEvent(QMouseEvent *event) Q_DECL_OVERRIDE; + virtual void mousePressEvent(QMouseEvent *event) Q_DECL_OVERRIDE; + virtual void mouseMoveEvent(QMouseEvent *event) Q_DECL_OVERRIDE; + virtual void mouseReleaseEvent(QMouseEvent *event) Q_DECL_OVERRIDE; + virtual void wheelEvent(QWheelEvent *event) Q_DECL_OVERRIDE; + + // introduced virtual methods: + virtual void draw(QCPPainter *painter); + virtual void updateLayout(); + virtual void axisRemoved(QCPAxis *axis); + virtual void legendRemoved(QCPLegend *legend); + Q_SLOT virtual void processRectSelection(QRect rect, QMouseEvent *event); + Q_SLOT virtual void processRectZoom(QRect rect, QMouseEvent *event); + Q_SLOT virtual void processPointSelection(QMouseEvent *event); + + // non-virtual methods: + bool registerPlottable(QCPAbstractPlottable *plottable); + bool registerGraph(QCPGraph *graph); + bool registerItem(QCPAbstractItem* item); + void updateLayerIndices() const; + QCPLayerable *layerableAt(const QPointF &pos, bool onlySelectable, QVariant *selectionDetails=0) const; + QList layerableListAt(const QPointF &pos, bool onlySelectable, QList *selectionDetails=0) const; + void drawBackground(QCPPainter *painter); + void setupPaintBuffers(); + QCPAbstractPaintBuffer *createPaintBuffer(); + bool hasInvalidatedPaintBuffers(); + bool setupOpenGl(); + void freeOpenGl(); + + friend class QCPLegend; + friend class QCPAxis; + friend class QCPLayer; + friend class QCPAxisRect; + friend class QCPAbstractPlottable; + friend class QCPGraph; + friend class QCPAbstractItem; +}; +Q_DECLARE_METATYPE(QCustomPlot::LayerInsertMode) +Q_DECLARE_METATYPE(QCustomPlot::RefreshPriority) + +/* end of 'src/core.h' */ + + +/* including file 'src/plottable1d.h', size 4544 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCPPlottableInterface1D +{ +public: + virtual ~QCPPlottableInterface1D() {} + // introduced pure virtual methods: + virtual int dataCount() const = 0; + virtual double dataMainKey(int index) const = 0; + virtual double dataSortKey(int index) const = 0; + virtual double dataMainValue(int index) const = 0; + virtual QCPRange dataValueRange(int index) const = 0; + virtual QPointF dataPixelPosition(int index) const = 0; + virtual bool sortKeyIsMainKey() const = 0; + virtual QCPDataSelection selectTestRect(const QRectF &rect, bool onlySelectable) const = 0; + virtual int findBegin(double sortKey, bool expandedRange=true) const = 0; + virtual int findEnd(double sortKey, bool expandedRange=true) const = 0; +}; + +template +class QCPAbstractPlottable1D : public QCPAbstractPlottable, public QCPPlottableInterface1D // no QCP_LIB_DECL, template class ends up in header (cpp included below) +{ + // 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 Q_DECL_OVERRIDE; + virtual double dataMainKey(int index) const Q_DECL_OVERRIDE; + virtual double dataSortKey(int index) const Q_DECL_OVERRIDE; + virtual double dataMainValue(int index) const Q_DECL_OVERRIDE; + virtual QCPRange dataValueRange(int index) const Q_DECL_OVERRIDE; + virtual QPointF dataPixelPosition(int index) const Q_DECL_OVERRIDE; + virtual bool sortKeyIsMainKey() const Q_DECL_OVERRIDE; + virtual QCPDataSelection selectTestRect(const QRectF &rect, bool onlySelectable) const Q_DECL_OVERRIDE; + virtual int findBegin(double sortKey, bool expandedRange=true) const Q_DECL_OVERRIDE; + virtual int findEnd(double sortKey, bool expandedRange=true) const Q_DECL_OVERRIDE; + + // reimplemented virtual methods: + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const Q_DECL_OVERRIDE; + virtual QCPPlottableInterface1D *interface1D() Q_DECL_OVERRIDE { return this; } + +protected: + // property members: + QSharedPointer > mDataContainer; + + // helpers for subclasses: + void getDataSegments(QList &selectedSegments, QList &unselectedSegments) const; + void drawPolyline(QCPPainter *painter, const QVector &lineData) const; + +private: + Q_DISABLE_COPY(QCPAbstractPlottable1D) + +}; + +// include implementation in header since it is a class template: + +/* including file 'src/plottable1d.cpp', size 22361 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPPlottableInterface1D +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPPlottableInterface1D + \brief Defines an abstract interface for one-dimensional plottables + + This class contains only pure virtual methods which define a common interface to the data + of one-dimensional plottables. + + For example, it is implemented by the template class \ref QCPAbstractPlottable1D (the preferred + base class for one-dimensional plottables). So if you use that template class as base class of + your one-dimensional plottable, you won't have to care about implementing the 1d interface + yourself. + + If your plottable doesn't derive from \ref QCPAbstractPlottable1D but still wants to provide a 1d + interface (e.g. like \ref QCPErrorBars does), you should inherit from both \ref + QCPAbstractPlottable and \ref QCPPlottableInterface1D and accordingly reimplement the pure + virtual methods of the 1d interface, matching your data container. Also, reimplement \ref + QCPAbstractPlottable::interface1D to return the \c this pointer. + + If you have a \ref QCPAbstractPlottable pointer, you can check whether it implements this + interface by calling \ref QCPAbstractPlottable::interface1D and testing it for a non-zero return + value. If it indeed implements this interface, you may use it to access the plottable's data + without needing to know the exact type of the plottable or its data point type. +*/ + +/* start documentation of pure virtual functions */ + +/*! \fn virtual int QCPPlottableInterface1D::dataCount() const = 0; + + Returns the number of data points of the plottable. +*/ + +/*! \fn virtual QCPDataSelection QCPPlottableInterface1D::selectTestRect(const QRectF &rect, bool onlySelectable) const = 0; + + Returns a data selection containing all the data points of this plottable which are contained (or + hit by) \a rect. This is used mainly in the selection rect interaction for data selection (\ref + dataselection "data selection mechanism"). + + If \a onlySelectable is true, an empty QCPDataSelection is returned if this plottable is not + selectable (i.e. if \ref QCPAbstractPlottable::setSelectable is \ref QCP::stNone). + + \note \a rect must be a normalized rect (positive or zero width and height). This is especially + important when using the rect of \ref QCPSelectionRect::accepted, which is not necessarily + normalized. Use QRect::normalized() when passing a rect which might not be normalized. +*/ + +/*! \fn virtual double QCPPlottableInterface1D::dataMainKey(int index) const = 0 + + Returns the main key of the data point at the given \a index. + + What the main key is, is defined by the plottable's data type. See the \ref + qcpdatacontainer-datatype "QCPDataContainer DataType" documentation for details about this naming + convention. +*/ + +/*! \fn virtual double QCPPlottableInterface1D::dataSortKey(int index) const = 0 + + Returns the sort key of the data point at the given \a index. + + What the sort key is, is defined by the plottable's data type. See the \ref + qcpdatacontainer-datatype "QCPDataContainer DataType" documentation for details about this naming + convention. +*/ + +/*! \fn virtual double QCPPlottableInterface1D::dataMainValue(int index) const = 0 + + Returns the main value of the data point at the given \a index. + + What the main value is, is defined by the plottable's data type. See the \ref + qcpdatacontainer-datatype "QCPDataContainer DataType" documentation for details about this naming + convention. +*/ + +/*! \fn virtual QCPRange QCPPlottableInterface1D::dataValueRange(int index) const = 0 + + Returns the value range of the data point at the given \a index. + + What the value range is, is defined by the plottable's data type. See the \ref + qcpdatacontainer-datatype "QCPDataContainer DataType" documentation for details about this naming + convention. +*/ + +/*! \fn virtual QPointF QCPPlottableInterface1D::dataPixelPosition(int index) const = 0 + + Returns the pixel position on the widget surface at which the data point at the given \a index + appears. + + Usually this corresponds to the point of \ref dataMainKey/\ref dataMainValue, in pixel + coordinates. However, depending on the plottable, this might be a different apparent position + than just a coord-to-pixel transform of those values. For example, \ref QCPBars apparent data + values can be shifted depending on their stacking, bar grouping or configured base value. +*/ + +/*! \fn virtual bool QCPPlottableInterface1D::sortKeyIsMainKey() const = 0 + + Returns whether the sort key (\ref dataSortKey) is identical to the main key (\ref dataMainKey). + + What the sort and main keys are, is defined by the plottable's data type. See the \ref + qcpdatacontainer-datatype "QCPDataContainer DataType" documentation for details about this naming + convention. +*/ + +/*! \fn virtual int QCPPlottableInterface1D::findBegin(double sortKey, bool expandedRange) const = 0 + + Returns the index of the data point with a (sort-)key that is equal to, just below, or just above + \a sortKey. If \a expandedRange is true, the data point just below \a sortKey will be considered, + otherwise the one just above. + + This can be used in conjunction with \ref findEnd to iterate over data points within a given key + range, including or excluding the bounding data points that are just beyond the specified range. + + If \a expandedRange is true but there are no data points below \a sortKey, 0 is returned. + + If the container is empty, returns 0 (in that case, \ref findEnd will also return 0, so a loop + using these methods will not iterate over the index 0). + + \see findEnd, QCPDataContainer::findBegin +*/ + +/*! \fn virtual int QCPPlottableInterface1D::findEnd(double sortKey, bool expandedRange) const = 0 + + Returns the index one after the data point with a (sort-)key that is equal to, just above, or + just below \a sortKey. If \a expandedRange is true, the data point just above \a sortKey will be + considered, otherwise the one just below. + + This can be used in conjunction with \ref findBegin to iterate over data points within a given + key range, including the bounding data points that are just below and above the specified range. + + If \a expandedRange is true but there are no data points above \a sortKey, the index just above the + highest data point is returned. + + If the container is empty, returns 0. + + \see findBegin, QCPDataContainer::findEnd +*/ + +/* end documentation of pure virtual functions */ + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAbstractPlottable1D +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPAbstractPlottable1D + \brief A template base class for plottables with one-dimensional data + + This template class derives from \ref QCPAbstractPlottable and from the abstract interface \ref + QCPPlottableInterface1D. It serves as a base class for all one-dimensional data (i.e. data with + one key dimension), such as \ref QCPGraph and QCPCurve. + + The template parameter \a DataType is the type of the data points of this plottable (e.g. \ref + QCPGraphData or \ref QCPCurveData). The main purpose of this base class is to provide the member + \a mDataContainer (a shared pointer to a \ref QCPDataContainer "QCPDataContainer") and + implement the according virtual methods of the \ref QCPPlottableInterface1D, such that most + subclassed plottables don't need to worry about this anymore. + + Further, it provides a convenience method for retrieving selected/unselected data segments via + \ref getDataSegments. This is useful when subclasses implement their \ref draw method and need to + draw selected segments with a different pen/brush than unselected segments (also see \ref + QCPSelectionDecorator). + + This class implements basic functionality of \ref QCPAbstractPlottable::selectTest and \ref + QCPPlottableInterface1D::selectTestRect, assuming point-like data points, based on the 1D data + interface. In spite of that, most plottable subclasses will want to reimplement those methods + again, to provide a more accurate hit test based on their specific data visualization geometry. +*/ + +/* start documentation of inline functions */ + +/*! \fn QCPPlottableInterface1D *QCPAbstractPlottable1D::interface1D() + + Returns a \ref QCPPlottableInterface1D pointer to this plottable, providing access to its 1D + interface. + + \seebaseclassmethod +*/ + +/* end documentation of inline functions */ + +/*! + Forwards \a keyAxis and \a valueAxis to the \ref QCPAbstractPlottable::QCPAbstractPlottable + "QCPAbstractPlottable" constructor and allocates the \a mDataContainer. +*/ +template +QCPAbstractPlottable1D::QCPAbstractPlottable1D(QCPAxis *keyAxis, QCPAxis *valueAxis) : + QCPAbstractPlottable(keyAxis, valueAxis), + mDataContainer(new QCPDataContainer) +{ +} + +template +QCPAbstractPlottable1D::~QCPAbstractPlottable1D() +{ +} + +/*! + \copydoc QCPPlottableInterface1D::dataCount +*/ +template +int QCPAbstractPlottable1D::dataCount() const +{ + return mDataContainer->size(); +} + +/*! + \copydoc QCPPlottableInterface1D::dataMainKey +*/ +template +double QCPAbstractPlottable1D::dataMainKey(int index) const +{ + if (index >= 0 && index < mDataContainer->size()) + { + return (mDataContainer->constBegin()+index)->mainKey(); + } else + { + qDebug() << Q_FUNC_INFO << "Index out of bounds" << index; + return 0; + } +} + +/*! + \copydoc QCPPlottableInterface1D::dataSortKey +*/ +template +double QCPAbstractPlottable1D::dataSortKey(int index) const +{ + if (index >= 0 && index < mDataContainer->size()) + { + return (mDataContainer->constBegin()+index)->sortKey(); + } else + { + qDebug() << Q_FUNC_INFO << "Index out of bounds" << index; + return 0; + } +} + +/*! + \copydoc QCPPlottableInterface1D::dataMainValue +*/ +template +double QCPAbstractPlottable1D::dataMainValue(int index) const +{ + if (index >= 0 && index < mDataContainer->size()) + { + return (mDataContainer->constBegin()+index)->mainValue(); + } else + { + qDebug() << Q_FUNC_INFO << "Index out of bounds" << index; + return 0; + } +} + +/*! + \copydoc QCPPlottableInterface1D::dataValueRange +*/ +template +QCPRange QCPAbstractPlottable1D::dataValueRange(int index) const +{ + if (index >= 0 && index < mDataContainer->size()) + { + return (mDataContainer->constBegin()+index)->valueRange(); + } else + { + qDebug() << Q_FUNC_INFO << "Index out of bounds" << index; + return QCPRange(0, 0); + } +} + +/*! + \copydoc QCPPlottableInterface1D::dataPixelPosition +*/ +template +QPointF QCPAbstractPlottable1D::dataPixelPosition(int index) const +{ + if (index >= 0 && index < mDataContainer->size()) + { + const typename QCPDataContainer::const_iterator it = mDataContainer->constBegin()+index; + return coordsToPixels(it->mainKey(), it->mainValue()); + } else + { + qDebug() << Q_FUNC_INFO << "Index out of bounds" << index; + return QPointF(); + } +} + +/*! + \copydoc QCPPlottableInterface1D::sortKeyIsMainKey +*/ +template +bool QCPAbstractPlottable1D::sortKeyIsMainKey() const +{ + return DataType::sortKeyIsMainKey(); +} + +/*! + Implements a rect-selection algorithm assuming the data (accessed via the 1D data interface) is + point-like. Most subclasses will want to reimplement this method again, to provide a more + accurate hit test based on the true data visualization geometry. + + \seebaseclassmethod +*/ +template +QCPDataSelection QCPAbstractPlottable1D::selectTestRect(const QRectF &rect, bool onlySelectable) const +{ + QCPDataSelection result; + if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) + return result; + if (!mKeyAxis || !mValueAxis) + return result; + + // convert rect given in pixels to ranges given in plot coordinates: + double key1, value1, key2, value2; + pixelsToCoords(rect.topLeft(), key1, value1); + pixelsToCoords(rect.bottomRight(), key2, value2); + QCPRange keyRange(key1, key2); // QCPRange normalizes internally so we don't have to care about whether key1 < key2 + QCPRange valueRange(value1, value2); + typename QCPDataContainer::const_iterator begin = mDataContainer->constBegin(); + typename QCPDataContainer::const_iterator end = mDataContainer->constEnd(); + if (DataType::sortKeyIsMainKey()) // we can assume that data is sorted by main key, so can reduce the searched key interval: + { + begin = mDataContainer->findBegin(keyRange.lower, false); + end = mDataContainer->findEnd(keyRange.upper, false); + } + if (begin == end) + return result; + + int currentSegmentBegin = -1; // -1 means we're currently not in a segment that's contained in rect + for (typename QCPDataContainer::const_iterator it=begin; it!=end; ++it) + { + if (currentSegmentBegin == -1) + { + if (valueRange.contains(it->mainValue()) && keyRange.contains(it->mainKey())) // start segment + currentSegmentBegin = it-mDataContainer->constBegin(); + } else if (!valueRange.contains(it->mainValue()) || !keyRange.contains(it->mainKey())) // segment just ended + { + result.addDataRange(QCPDataRange(currentSegmentBegin, it-mDataContainer->constBegin()), false); + currentSegmentBegin = -1; + } + } + // process potential last segment: + if (currentSegmentBegin != -1) + result.addDataRange(QCPDataRange(currentSegmentBegin, end-mDataContainer->constBegin()), false); + + result.simplify(); + return result; +} + +/*! + \copydoc QCPPlottableInterface1D::findBegin +*/ +template +int QCPAbstractPlottable1D::findBegin(double sortKey, bool expandedRange) const +{ + return mDataContainer->findBegin(sortKey, expandedRange)-mDataContainer->constBegin(); +} + +/*! + \copydoc QCPPlottableInterface1D::findEnd +*/ +template +int QCPAbstractPlottable1D::findEnd(double sortKey, bool expandedRange) const +{ + return mDataContainer->findEnd(sortKey, expandedRange)-mDataContainer->constBegin(); +} + +/*! + Implements a point-selection algorithm assuming the data (accessed via the 1D data interface) is + point-like. Most subclasses will want to reimplement this method again, to provide a more + accurate hit test based on the true data visualization geometry. + + If \a details is not 0, it will be set to a \ref QCPDataSelection, describing the closest data point + to \a pos. + + \seebaseclassmethod +*/ +template +double QCPAbstractPlottable1D::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) + return -1; + if (!mKeyAxis || !mValueAxis) + return -1; + + QCPDataSelection selectionResult; + double minDistSqr = (std::numeric_limits::max)(); + int minDistIndex = mDataContainer->size(); + + typename QCPDataContainer::const_iterator begin = mDataContainer->constBegin(); + typename QCPDataContainer::const_iterator end = mDataContainer->constEnd(); + if (DataType::sortKeyIsMainKey()) // we can assume that data is sorted by main key, so can reduce the searched key interval: + { + // determine which key range comes into question, taking selection tolerance around pos into account: + double posKeyMin, posKeyMax, dummy; + pixelsToCoords(pos-QPointF(mParentPlot->selectionTolerance(), mParentPlot->selectionTolerance()), posKeyMin, dummy); + pixelsToCoords(pos+QPointF(mParentPlot->selectionTolerance(), mParentPlot->selectionTolerance()), posKeyMax, dummy); + if (posKeyMin > posKeyMax) + qSwap(posKeyMin, posKeyMax); + begin = mDataContainer->findBegin(posKeyMin, true); + end = mDataContainer->findEnd(posKeyMax, true); + } + if (begin == end) + return -1; + QCPRange keyRange(mKeyAxis->range()); + QCPRange valueRange(mValueAxis->range()); + for (typename QCPDataContainer::const_iterator it=begin; it!=end; ++it) + { + const double mainKey = it->mainKey(); + const double mainValue = it->mainValue(); + if (keyRange.contains(mainKey) && valueRange.contains(mainValue)) // make sure data point is inside visible range, for speedup in cases where sort key isn't main key and we iterate over all points + { + const double currentDistSqr = QCPVector2D(coordsToPixels(mainKey, mainValue)-pos).lengthSquared(); + if (currentDistSqr < minDistSqr) + { + minDistSqr = currentDistSqr; + minDistIndex = it-mDataContainer->constBegin(); + } + } + } + if (minDistIndex != mDataContainer->size()) + selectionResult.addDataRange(QCPDataRange(minDistIndex, minDistIndex+1), false); + + selectionResult.simplify(); + if (details) + details->setValue(selectionResult); + return qSqrt(minDistSqr); +} + +/*! + Splits all data into selected and unselected segments and outputs them via \a selectedSegments + and \a unselectedSegments, respectively. + + This is useful when subclasses implement their \ref draw method and need to draw selected + segments with a different pen/brush than unselected segments (also see \ref + QCPSelectionDecorator). + + \see setSelection +*/ +template +void QCPAbstractPlottable1D::getDataSegments(QList &selectedSegments, QList &unselectedSegments) const +{ + selectedSegments.clear(); + unselectedSegments.clear(); + if (mSelectable == QCP::stWhole) // stWhole selection type draws the entire plottable with selected style if mSelection isn't empty + { + if (selected()) + selectedSegments << QCPDataRange(0, dataCount()); + else + unselectedSegments << QCPDataRange(0, dataCount()); + } else + { + QCPDataSelection sel(selection()); + sel.simplify(); + selectedSegments = sel.dataRanges(); + unselectedSegments = sel.inverse(QCPDataRange(0, dataCount())).dataRanges(); + } +} + +/*! + A helper method which draws a line with the passed \a painter, according to the pixel data in \a + lineData. NaN points create gaps in the line, as expected from QCustomPlot's plottables (this is + the main difference to QPainter's regular drawPolyline, which handles NaNs by lagging or + crashing). + + Further it uses a faster line drawing technique based on \ref QCPPainter::drawLine rather than \c + QPainter::drawPolyline if the configured \ref QCustomPlot::setPlottingHints() and \a painter + style allows. +*/ +template +void QCPAbstractPlottable1D::drawPolyline(QCPPainter *painter, const QVector &lineData) const +{ + // if drawing solid line and not in PDF, use much faster line drawing instead of polyline: + if (mParentPlot->plottingHints().testFlag(QCP::phFastPolylines) && + painter->pen().style() == Qt::SolidLine && + !painter->modes().testFlag(QCPPainter::pmVectorized) && + !painter->modes().testFlag(QCPPainter::pmNoCaching)) + { + int i = 0; + bool lastIsNan = false; + const int lineDataSize = lineData.size(); + while (i < lineDataSize && (qIsNaN(lineData.at(i).y()) || qIsNaN(lineData.at(i).x()))) // make sure first point is not NaN + ++i; + ++i; // because drawing works in 1 point retrospect + while (i < lineDataSize) + { + if (!qIsNaN(lineData.at(i).y()) && !qIsNaN(lineData.at(i).x())) // NaNs create a gap in the line + { + if (!lastIsNan) + painter->drawLine(lineData.at(i-1), lineData.at(i)); + else + lastIsNan = false; + } else + lastIsNan = true; + ++i; + } + } else + { + int segmentStart = 0; + int i = 0; + const int lineDataSize = lineData.size(); + while (i < lineDataSize) + { + if (qIsNaN(lineData.at(i).y()) || qIsNaN(lineData.at(i).x()) || qIsInf(lineData.at(i).y())) // NaNs create a gap in the line. Also filter Infs which make drawPolyline block + { + painter->drawPolyline(lineData.constData()+segmentStart, i-segmentStart); // i, because we don't want to include the current NaN point + segmentStart = i+1; + } + ++i; + } + // draw last segment: + painter->drawPolyline(lineData.constData()+segmentStart, lineDataSize-segmentStart); + } +} +/* end of 'src/plottable1d.cpp' */ + + +/* end of 'src/plottable1d.h' */ + + +/* including file 'src/colorgradient.h', size 6243 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +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(); + QCPColorGradient(GradientPreset preset); + bool operator==(const QCPColorGradient &other) const; + bool operator!=(const QCPColorGradient &other) const { return !(*this == other); } + + // getters: + int levelCount() const { return mLevelCount; } + QMap colorStops() const { return mColorStops; } + ColorInterpolation colorInterpolation() const { return mColorInterpolation; } + bool periodic() const { return mPeriodic; } + + // setters: + void setLevelCount(int n); + void setColorStops(const QMap &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); + void colorize(const double *data, const unsigned char *alpha, 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: + // property members: + int mLevelCount; + QMap mColorStops; + ColorInterpolation mColorInterpolation; + bool mPeriodic; + + // non-property members: + QVector mColorBuffer; // have colors premultiplied with alpha (for usage with QImage::Format_ARGB32_Premultiplied) + bool mColorBufferInvalidated; + + // non-virtual methods: + bool stopsUseAlpha() const; + void updateColorBuffer(); +}; +Q_DECLARE_METATYPE(QCPColorGradient::ColorInterpolation) +Q_DECLARE_METATYPE(QCPColorGradient::GradientPreset) + +/* end of 'src/colorgradient.h' */ + + +/* including file 'src/selectiondecorator-bracket.h', size 4442 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCP_LIB_DECL QCPSelectionDecoratorBracket : public QCPSelectionDecorator +{ + Q_GADGET +public: + + /*! + Defines which shape is drawn at the boundaries of selected data ranges. + + Some of the bracket styles further allow specifying a height and/or width, see \ref + setBracketHeight and \ref setBracketWidth. + */ + enum BracketStyle { bsSquareBracket ///< A square bracket is drawn. + ,bsHalfEllipse ///< A half ellipse is drawn. The size of the ellipse is given by the bracket width/height properties. + ,bsEllipse ///< An ellipse is drawn. The size of the ellipse is given by the bracket width/height properties. + ,bsPlus ///< A plus is drawn. + ,bsUserStyle ///< Start custom bracket styles at this index when subclassing and reimplementing \ref drawBracket. + }; + Q_ENUMS(BracketStyle) + + QCPSelectionDecoratorBracket(); + virtual ~QCPSelectionDecoratorBracket(); + + // getters: + QPen bracketPen() const { return mBracketPen; } + QBrush bracketBrush() const { return mBracketBrush; } + int bracketWidth() const { return mBracketWidth; } + int bracketHeight() const { return mBracketHeight; } + BracketStyle bracketStyle() const { return mBracketStyle; } + bool tangentToData() const { return mTangentToData; } + int tangentAverage() const { return mTangentAverage; } + + // setters: + void setBracketPen(const QPen &pen); + void setBracketBrush(const QBrush &brush); + void setBracketWidth(int width); + void setBracketHeight(int height); + void setBracketStyle(BracketStyle style); + void setTangentToData(bool enabled); + void setTangentAverage(int pointCount); + + // introduced virtual methods: + virtual void drawBracket(QCPPainter *painter, int direction) const; + + // virtual methods: + virtual void drawDecoration(QCPPainter *painter, QCPDataSelection selection) Q_DECL_OVERRIDE; + +protected: + // property members: + QPen mBracketPen; + QBrush mBracketBrush; + int mBracketWidth; + int mBracketHeight; + BracketStyle mBracketStyle; + bool mTangentToData; + int mTangentAverage; + + // non-virtual methods: + double getTangentAngle(const QCPPlottableInterface1D *interface1d, int dataIndex, int direction) const; + QPointF getPixelCoordinates(const QCPPlottableInterface1D *interface1d, int dataIndex) const; + +}; +Q_DECLARE_METATYPE(QCPSelectionDecoratorBracket::BracketStyle) + +/* end of 'src/selectiondecorator-bracket.h' */ + + +/* including file 'src/layoutelements/layoutelement-axisrect.h', size 7507 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +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; } + QBrush backgroundBrush() const { return mBackgroundBrush; } + 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); + QList rangeDragAxes(Qt::Orientation orientation); + QList rangeZoomAxes(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 setRangeDragAxes(QList axes); + void setRangeDragAxes(QList horizontal, QList vertical); + void setRangeZoomAxes(QCPAxis *horizontal, QCPAxis *vertical); + void setRangeZoomAxes(QList axes); + void setRangeZoomAxes(QList horizontal, QList 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 axes(QCPAxis::AxisTypes types) const; + QList axes() const; + QCPAxis *addAxis(QCPAxis::AxisType type, QCPAxis *axis=0); + QList addAxes(QCPAxis::AxisTypes types); + bool removeAxis(QCPAxis *axis); + QCPLayoutInset *insetLayout() const { return mInsetLayout; } + + void zoom(const QRectF &pixelRect); + void zoom(const QRectF &pixelRect, const QList &affectedAxes); + void setupFullAxesBox(bool connectRanges=false); + QList plottables() const; + QList graphs() const; + QList 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) Q_DECL_OVERRIDE; + virtual QList elements(bool recursive) const Q_DECL_OVERRIDE; + +protected: + // property members: + QBrush mBackgroundBrush; + QPixmap mBackgroundPixmap; + QPixmap mScaledBackgroundPixmap; + bool mBackgroundScaled; + Qt::AspectRatioMode mBackgroundScaledMode; + QCPLayoutInset *mInsetLayout; + Qt::Orientations mRangeDrag, mRangeZoom; + QList > mRangeDragHorzAxis, mRangeDragVertAxis; + QList > mRangeZoomHorzAxis, mRangeZoomVertAxis; + double mRangeZoomFactorHorz, mRangeZoomFactorVert; + + // non-property members: + QList mDragStartHorzRange, mDragStartVertRange; + QCP::AntialiasedElements mAADragBackup, mNotAADragBackup; + bool mDragging; + QHash > mAxes; + + // reimplemented virtual methods: + virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual int calculateAutoMargin(QCP::MarginSide side) Q_DECL_OVERRIDE; + virtual void layoutChanged() Q_DECL_OVERRIDE; + // events: + virtual void mousePressEvent(QMouseEvent *event, const QVariant &details) Q_DECL_OVERRIDE; + virtual void mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; + virtual void mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; + virtual void wheelEvent(QWheelEvent *event) Q_DECL_OVERRIDE; + + // non-property methods: + void drawBackground(QCPPainter *painter); + void updateAxesOffset(QCPAxis::AxisType type); + +private: + Q_DISABLE_COPY(QCPAxisRect) + + friend class QCustomPlot; +}; + + +/* end of 'src/layoutelements/layoutelement-axisrect.h' */ + + +/* including file 'src/layoutelements/layoutelement-legend.h', size 10397 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +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 Q_DECL_OVERRIDE; + +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 Q_DECL_OVERRIDE; + virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; + virtual QRect clipRect() const Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE = 0; + // events: + virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE; + virtual void deselectEvent(bool *selectionStateChanged) Q_DECL_OVERRIDE; + +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) Q_DECL_OVERRIDE; + virtual QSize minimumOuterSizeHint() const Q_DECL_OVERRIDE; + + // 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 ///< 0x000 None + ,spLegendBox = 0x001 ///< 0x001 The legend box (frame) + ,spItems = 0x002 ///< 0x002 Legend items individually (see \ref selectedItems) + }; + Q_ENUMS(SelectablePart) + Q_FLAGS(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 Q_DECL_OVERRIDE; + + // 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 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) Q_DECL_OVERRIDE; + virtual QCP::Interaction selectionCategory() const Q_DECL_OVERRIDE; + virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + // events: + virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE; + virtual void deselectEvent(bool *selectionStateChanged) Q_DECL_OVERRIDE; + + // 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) + +/* end of 'src/layoutelements/layoutelement-legend.h' */ + + +/* including file 'src/layoutelements/layoutelement-textelement.h', size 5353 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCP_LIB_DECL QCPTextElement : 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 QCPTextElement(QCustomPlot *parentPlot); + QCPTextElement(QCustomPlot *parentPlot, const QString &text); + QCPTextElement(QCustomPlot *parentPlot, const QString &text, double pointSize); + QCPTextElement(QCustomPlot *parentPlot, const QString &text, const QString &fontFamily, double pointSize); + QCPTextElement(QCustomPlot *parentPlot, const QString &text, const QFont &font); + + // getters: + QString text() const { return mText; } + int textFlags() const { return mTextFlags; } + 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 setTextFlags(int flags); + 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 Q_DECL_OVERRIDE; + virtual void mousePressEvent(QMouseEvent *event, const QVariant &details) Q_DECL_OVERRIDE; + virtual void mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; + virtual void mouseDoubleClickEvent(QMouseEvent *event, const QVariant &details) Q_DECL_OVERRIDE; + +signals: + void selectionChanged(bool selected); + void selectableChanged(bool selectable); + void clicked(QMouseEvent *event); + void doubleClicked(QMouseEvent *event); + +protected: + // property members: + QString mText; + int mTextFlags; + QFont mFont; + QColor mTextColor; + QFont mSelectedFont; + QColor mSelectedTextColor; + QRect mTextBoundingRect; + bool mSelectable, mSelected; + + // reimplemented virtual methods: + virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual QSize minimumOuterSizeHint() const Q_DECL_OVERRIDE; + virtual QSize maximumOuterSizeHint() const Q_DECL_OVERRIDE; + // events: + virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE; + virtual void deselectEvent(bool *selectionStateChanged) Q_DECL_OVERRIDE; + + // non-virtual methods: + QFont mainFont() const; + QColor mainTextColor() const; + +private: + Q_DISABLE_COPY(QCPTextElement) +}; + + + +/* end of 'src/layoutelements/layoutelement-textelement.h' */ + + +/* including file 'src/layoutelements/layoutelement-colorscale.h', size 5923 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + + +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) Q_DECL_OVERRIDE; + 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 colorMaps() const; + void rescaleDataRange(bool onlyVisibleMaps); + + // reimplemented virtual methods: + virtual void update(UpdatePhase phase) Q_DECL_OVERRIDE; + +signals: + void dataRangeChanged(const QCPRange &newRange); + void dataScaleTypeChanged(QCPAxis::ScaleType scaleType); + void gradientChanged(const QCPColorGradient &newGradient); + +protected: + // property members: + QCPAxis::AxisType mType; + QCPRange mDataRange; + QCPAxis::ScaleType mDataScaleType; + QCPColorGradient mGradient; + int mBarWidth; + + // non-property members: + QPointer mAxisRect; + QPointer mColorAxis; + + // reimplemented virtual methods: + virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; + // events: + virtual void mousePressEvent(QMouseEvent *event, const QVariant &details) Q_DECL_OVERRIDE; + virtual void mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; + virtual void mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; + virtual void wheelEvent(QWheelEvent *event) Q_DECL_OVERRIDE; + +private: + Q_DISABLE_COPY(QCPColorScale) + + friend class QCPColorScaleAxisRectPrivate; +}; + + +/* end of 'src/layoutelements/layoutelement-colorscale.h' */ + + +/* including file 'src/plottables/plottable-graph.h', size 9294 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCP_LIB_DECL QCPGraphData +{ +public: + QCPGraphData(); + QCPGraphData(double key, double value); + + inline double sortKey() const { return key; } + inline static QCPGraphData fromSortKey(double sortKey) { return QCPGraphData(sortKey, 0); } + inline static bool sortKeyIsMainKey() { return true; } + + inline double mainKey() const { return key; } + inline double mainValue() const { return value; } + + inline QCPRange valueRange() const { return QCPRange(value, value); } + + double key, value; +}; +Q_DECLARE_TYPEINFO(QCPGraphData, Q_PRIMITIVE_TYPE); + + +/*! \typedef QCPGraphDataContainer + + Container for storing \ref QCPGraphData points. The data is stored sorted by \a key. + + This template instantiation is the container in which QCPGraph holds its data. For details about + the generic container, see the documentation of the class template \ref QCPDataContainer. + + \see QCPGraphData, QCPGraph::setData +*/ +typedef QCPDataContainer QCPGraphDataContainer; + +class QCP_LIB_DECL QCPGraph : public QCPAbstractPlottable1D +{ + Q_OBJECT + /// \cond INCLUDE_QPROPERTIES + Q_PROPERTY(LineStyle lineStyle READ lineStyle WRITE setLineStyle) + Q_PROPERTY(QCPScatterStyle scatterStyle READ scatterStyle WRITE setScatterStyle) + Q_PROPERTY(int scatterSkip READ scatterSkip WRITE setScatterSkip) + 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) + + explicit QCPGraph(QCPAxis *keyAxis, QCPAxis *valueAxis); + virtual ~QCPGraph(); + + // getters: + QSharedPointer data() const { return mDataContainer; } + LineStyle lineStyle() const { return mLineStyle; } + QCPScatterStyle scatterStyle() const { return mScatterStyle; } + int scatterSkip() const { return mScatterSkip; } + QCPGraph *channelFillGraph() const { return mChannelFillGraph.data(); } + bool adaptiveSampling() const { return mAdaptiveSampling; } + + // setters: + void setData(QSharedPointer data); + void setData(const QVector &keys, const QVector &values, bool alreadySorted=false); + void setLineStyle(LineStyle ls); + void setScatterStyle(const QCPScatterStyle &style); + void setScatterSkip(int skip); + void setChannelFillGraph(QCPGraph *targetGraph); + void setAdaptiveSampling(bool enabled); + + // non-property methods: + void addData(const QVector &keys, const QVector &values, bool alreadySorted=false); + void addData(double key, double value); + + // reimplemented virtual methods: + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const Q_DECL_OVERRIDE; + virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; + virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; + +protected: + // property members: + LineStyle mLineStyle; + QCPScatterStyle mScatterStyle; + int mScatterSkip; + QPointer mChannelFillGraph; + bool mAdaptiveSampling; + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; + + // introduced virtual methods: + virtual void drawFill(QCPPainter *painter, QVector *lines) const; + virtual void drawScatterPlot(QCPPainter *painter, const QVector &scatters, const QCPScatterStyle &style) const; + virtual void drawLinePlot(QCPPainter *painter, const QVector &lines) const; + virtual void drawImpulsePlot(QCPPainter *painter, const QVector &lines) const; + + virtual void getOptimizedLineData(QVector *lineData, const QCPGraphDataContainer::const_iterator &begin, const QCPGraphDataContainer::const_iterator &end) const; + virtual void getOptimizedScatterData(QVector *scatterData, QCPGraphDataContainer::const_iterator begin, QCPGraphDataContainer::const_iterator end) const; + + // non-virtual methods: + void getVisibleDataBounds(QCPGraphDataContainer::const_iterator &begin, QCPGraphDataContainer::const_iterator &end, const QCPDataRange &rangeRestriction) const; + void getLines(QVector *lines, const QCPDataRange &dataRange) const; + void getScatters(QVector *scatters, const QCPDataRange &dataRange) const; + QVector dataToLines(const QVector &data) const; + QVector dataToStepLeftLines(const QVector &data) const; + QVector dataToStepRightLines(const QVector &data) const; + QVector dataToStepCenterLines(const QVector &data) const; + QVector dataToImpulseLines(const QVector &data) const; + QVector getNonNanSegments(const QVector *lineData, Qt::Orientation keyOrientation) const; + QVector > getOverlappingSegments(QVector thisSegments, const QVector *thisData, QVector otherSegments, const QVector *otherData) const; + bool segmentsIntersect(double aLower, double aUpper, double bLower, double bUpper, int &bPrecedence) const; + QPointF getFillBasePoint(QPointF matchingDataPoint) const; + const QPolygonF getFillPolygon(const QVector *lineData, QCPDataRange segment) const; + const QPolygonF getChannelFillPolygon(const QVector *lineData, QCPDataRange thisSegment, const QVector *otherData, QCPDataRange otherSegment) const; + int findIndexBelowX(const QVector *data, double x) const; + int findIndexAboveX(const QVector *data, double x) const; + int findIndexBelowY(const QVector *data, double y) const; + int findIndexAboveY(const QVector *data, double y) const; + double pointDistance(const QPointF &pixelPoint, QCPGraphDataContainer::const_iterator &closestData) const; + + friend class QCustomPlot; + friend class QCPLegend; +}; +Q_DECLARE_METATYPE(QCPGraph::LineStyle) + +/* end of 'src/plottables/plottable-graph.h' */ + + +/* including file 'src/plottables/plottable-curve.h', size 7409 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCP_LIB_DECL QCPCurveData +{ +public: + QCPCurveData(); + QCPCurveData(double t, double key, double value); + + inline double sortKey() const { return t; } + inline static QCPCurveData fromSortKey(double sortKey) { return QCPCurveData(sortKey, 0, 0); } + inline static bool sortKeyIsMainKey() { return false; } + + inline double mainKey() const { return key; } + inline double mainValue() const { return value; } + + inline QCPRange valueRange() const { return QCPRange(value, value); } + + double t, key, value; +}; +Q_DECLARE_TYPEINFO(QCPCurveData, Q_PRIMITIVE_TYPE); + + +/*! \typedef QCPCurveDataContainer + + Container for storing \ref QCPCurveData points. The data is stored sorted by \a t, so the \a + sortKey() (returning \a t) is different from \a mainKey() (returning \a key). + + This template instantiation is the container in which QCPCurve holds its data. For details about + the generic container, see the documentation of the class template \ref QCPDataContainer. + + \see QCPCurveData, QCPCurve::setData +*/ +typedef QCPDataContainer QCPCurveDataContainer; + +class QCP_LIB_DECL QCPCurve : public QCPAbstractPlottable1D +{ + Q_OBJECT + /// \cond INCLUDE_QPROPERTIES + Q_PROPERTY(QCPScatterStyle scatterStyle READ scatterStyle WRITE setScatterStyle) + Q_PROPERTY(int scatterSkip READ scatterSkip WRITE setScatterSkip) + 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 + }; + Q_ENUMS(LineStyle) + + explicit QCPCurve(QCPAxis *keyAxis, QCPAxis *valueAxis); + virtual ~QCPCurve(); + + // getters: + QSharedPointer data() const { return mDataContainer; } + QCPScatterStyle scatterStyle() const { return mScatterStyle; } + int scatterSkip() const { return mScatterSkip; } + LineStyle lineStyle() const { return mLineStyle; } + + // setters: + void setData(QSharedPointer data); + void setData(const QVector &t, const QVector &keys, const QVector &values, bool alreadySorted=false); + void setData(const QVector &keys, const QVector &values); + void setScatterStyle(const QCPScatterStyle &style); + void setScatterSkip(int skip); + void setLineStyle(LineStyle style); + + // non-property methods: + void addData(const QVector &t, const QVector &keys, const QVector &values, bool alreadySorted=false); + void addData(const QVector &keys, const QVector &values); + void addData(double t, double key, double value); + void addData(double key, double value); + + // reimplemented virtual methods: + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const Q_DECL_OVERRIDE; + virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; + virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; + +protected: + // property members: + QCPScatterStyle mScatterStyle; + int mScatterSkip; + LineStyle mLineStyle; + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; + + // introduced virtual methods: + virtual void drawCurveLine(QCPPainter *painter, const QVector &lines) const; + virtual void drawScatterPlot(QCPPainter *painter, const QVector &points, const QCPScatterStyle &style) const; + + // non-virtual methods: + void getCurveLines(QVector *lines, const QCPDataRange &dataRange, double penWidth) const; + void getScatters(QVector *scatters, const QCPDataRange &dataRange, double scatterWidth) const; + int getRegion(double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const; + QPointF getOptimizedPoint(int prevRegion, double prevKey, double prevValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const; + QVector getOptimizedCornerPoints(int prevRegion, int currentRegion, double prevKey, double prevValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const; + bool mayTraverse(int prevRegion, int currentRegion) const; + bool getTraverse(double prevKey, double prevValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin, QPointF &crossA, QPointF &crossB) const; + void getTraverseCornerPoints(int prevRegion, int currentRegion, double keyMin, double valueMax, double keyMax, double valueMin, QVector &beforeTraverse, QVector &afterTraverse) const; + double pointDistance(const QPointF &pixelPoint, QCPCurveDataContainer::const_iterator &closestData) const; + + friend class QCustomPlot; + friend class QCPLegend; +}; +Q_DECLARE_METATYPE(QCPCurve::LineStyle) + +/* end of 'src/plottables/plottable-curve.h' */ + + +/* including file 'src/plottables/plottable-bars.h', size 8933 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +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 + }; + Q_ENUMS(SpacingType) + + explicit QCPBarsGroup(QCustomPlot *parentPlot); + virtual ~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 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 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; +}; +Q_DECLARE_METATYPE(QCPBarsGroup::SpacingType) + + +class QCP_LIB_DECL QCPBarsData +{ +public: + QCPBarsData(); + QCPBarsData(double key, double value); + + inline double sortKey() const { return key; } + inline static QCPBarsData fromSortKey(double sortKey) { return QCPBarsData(sortKey, 0); } + inline static bool sortKeyIsMainKey() { return true; } + + inline double mainKey() const { return key; } + inline double mainValue() const { return value; } + + inline QCPRange valueRange() const { return QCPRange(value, value); } // note that bar base value isn't held in each QCPBarsData and thus can't/shouldn't be returned here + + double key, value; +}; +Q_DECLARE_TYPEINFO(QCPBarsData, Q_PRIMITIVE_TYPE); + + +/*! \typedef QCPBarsDataContainer + + Container for storing \ref QCPBarsData points. The data is stored sorted by \a key. + + This template instantiation is the container in which QCPBars holds its data. For details about + the generic container, see the documentation of the class template \ref QCPDataContainer. + + \see QCPBarsData, QCPBars::setData +*/ +typedef QCPDataContainer QCPBarsDataContainer; + +class QCP_LIB_DECL QCPBars : public QCPAbstractPlottable1D +{ + 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(double stackingGap READ stackingGap WRITE setStackingGap) + 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; } + double stackingGap() const { return mStackingGap; } + QCPBars *barBelow() const { return mBarBelow.data(); } + QCPBars *barAbove() const { return mBarAbove.data(); } + QSharedPointer data() const { return mDataContainer; } + + // setters: + void setData(QSharedPointer data); + void setData(const QVector &keys, const QVector &values, bool alreadySorted=false); + void setWidth(double width); + void setWidthType(WidthType widthType); + void setBarsGroup(QCPBarsGroup *barsGroup); + void setBaseValue(double baseValue); + void setStackingGap(double pixels); + + // non-property methods: + void addData(const QVector &keys, const QVector &values, bool alreadySorted=false); + void addData(double key, double value); + void moveBelow(QCPBars *bars); + void moveAbove(QCPBars *bars); + + // reimplemented virtual methods: + virtual QCPDataSelection selectTestRect(const QRectF &rect, bool onlySelectable) const Q_DECL_OVERRIDE; + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const Q_DECL_OVERRIDE; + virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; + virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; + virtual QPointF dataPixelPosition(int index) const Q_DECL_OVERRIDE; + +protected: + // property members: + double mWidth; + WidthType mWidthType; + QCPBarsGroup *mBarsGroup; + double mBaseValue; + double mStackingGap; + QPointer mBarBelow, mBarAbove; + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; + + // non-virtual methods: + void getVisibleDataBounds(QCPBarsDataContainer::const_iterator &begin, QCPBarsDataContainer::const_iterator &end) const; + QRectF getBarRect(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; +}; +Q_DECLARE_METATYPE(QCPBars::WidthType) + +/* end of 'src/plottables/plottable-bars.h' */ + + +/* including file 'src/plottables/plottable-statisticalbox.h', size 7516 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCP_LIB_DECL QCPStatisticalBoxData +{ +public: + QCPStatisticalBoxData(); + QCPStatisticalBoxData(double key, double minimum, double lowerQuartile, double median, double upperQuartile, double maximum, const QVector& outliers=QVector()); + + inline double sortKey() const { return key; } + inline static QCPStatisticalBoxData fromSortKey(double sortKey) { return QCPStatisticalBoxData(sortKey, 0, 0, 0, 0, 0); } + inline static bool sortKeyIsMainKey() { return true; } + + inline double mainKey() const { return key; } + inline double mainValue() const { return median; } + + inline QCPRange valueRange() const + { + QCPRange result(minimum, maximum); + for (QVector::const_iterator it = outliers.constBegin(); it != outliers.constEnd(); ++it) + result.expand(*it); + return result; + } + + double key, minimum, lowerQuartile, median, upperQuartile, maximum; + QVector outliers; +}; +Q_DECLARE_TYPEINFO(QCPStatisticalBoxData, Q_MOVABLE_TYPE); + + +/*! \typedef QCPStatisticalBoxDataContainer + + Container for storing \ref QCPStatisticalBoxData points. The data is stored sorted by \a key. + + This template instantiation is the container in which QCPStatisticalBox holds its data. For + details about the generic container, see the documentation of the class template \ref + QCPDataContainer. + + \see QCPStatisticalBoxData, QCPStatisticalBox::setData +*/ +typedef QCPDataContainer QCPStatisticalBoxDataContainer; + +class QCP_LIB_DECL QCPStatisticalBox : public QCPAbstractPlottable1D +{ + Q_OBJECT + /// \cond INCLUDE_QPROPERTIES + 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(bool whiskerAntialiased READ whiskerAntialiased WRITE setWhiskerAntialiased) + 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: + QSharedPointer data() const { return mDataContainer; } + double width() const { return mWidth; } + double whiskerWidth() const { return mWhiskerWidth; } + QPen whiskerPen() const { return mWhiskerPen; } + QPen whiskerBarPen() const { return mWhiskerBarPen; } + bool whiskerAntialiased() const { return mWhiskerAntialiased; } + QPen medianPen() const { return mMedianPen; } + QCPScatterStyle outlierStyle() const { return mOutlierStyle; } + + // setters: + void setData(QSharedPointer data); + void setData(const QVector &keys, const QVector &minimum, const QVector &lowerQuartile, const QVector &median, const QVector &upperQuartile, const QVector &maximum, bool alreadySorted=false); + void setWidth(double width); + void setWhiskerWidth(double width); + void setWhiskerPen(const QPen &pen); + void setWhiskerBarPen(const QPen &pen); + void setWhiskerAntialiased(bool enabled); + void setMedianPen(const QPen &pen); + void setOutlierStyle(const QCPScatterStyle &style); + + // non-property methods: + void addData(const QVector &keys, const QVector &minimum, const QVector &lowerQuartile, const QVector &median, const QVector &upperQuartile, const QVector &maximum, bool alreadySorted=false); + void addData(double key, double minimum, double lowerQuartile, double median, double upperQuartile, double maximum, const QVector &outliers=QVector()); + + // reimplemented virtual methods: + virtual QCPDataSelection selectTestRect(const QRectF &rect, bool onlySelectable) const Q_DECL_OVERRIDE; + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const Q_DECL_OVERRIDE; + virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; + virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; + +protected: + // property members: + double mWidth; + double mWhiskerWidth; + QPen mWhiskerPen, mWhiskerBarPen; + bool mWhiskerAntialiased; + QPen mMedianPen; + QCPScatterStyle mOutlierStyle; + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; + + // introduced virtual methods: + virtual void drawStatisticalBox(QCPPainter *painter, QCPStatisticalBoxDataContainer::const_iterator it, const QCPScatterStyle &outlierStyle) const; + + // non-virtual methods: + void getVisibleDataBounds(QCPStatisticalBoxDataContainer::const_iterator &begin, QCPStatisticalBoxDataContainer::const_iterator &end) const; + QRectF getQuartileBox(QCPStatisticalBoxDataContainer::const_iterator it) const; + QVector getWhiskerBackboneLines(QCPStatisticalBoxDataContainer::const_iterator it) const; + QVector getWhiskerBarLines(QCPStatisticalBoxDataContainer::const_iterator it) const; + + friend class QCustomPlot; + friend class QCPLegend; +}; + +/* end of 'src/plottables/plottable-statisticalbox.h' */ + + +/* including file 'src/plottables/plottable-colormap.h', size 7070 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +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); + unsigned char alpha(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); + void setAlpha(int keyIndex, int valueIndex, unsigned char alpha); + + // non-property methods: + void recalculateDataBounds(); + void clear(); + void clearAlpha(); + void fill(double z); + void fillAlpha(unsigned char alpha); + 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; + unsigned char *mAlpha; + QCPRange mDataBounds; + bool mDataModified; + + bool createAlpha(bool initializeOpaque=true); + + 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 double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const Q_DECL_OVERRIDE; + virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; + virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; + +signals: + void dataRangeChanged(const QCPRange &newRange); + void dataScaleTypeChanged(QCPAxis::ScaleType scaleType); + void gradientChanged(const QCPColorGradient &newGradient); + +protected: + // property members: + QCPRange mDataRange; + QCPAxis::ScaleType mDataScaleType; + QCPColorMapData *mMapData; + QCPColorGradient mGradient; + bool mInterpolate; + bool mTightBoundary; + QPointer mColorScale; + + // non-property members: + QImage mMapImage, mUndersampledMapImage; + QPixmap mLegendIcon; + bool mMapImageInvalidated; + + // introduced virtual methods: + virtual void updateMapImage(); + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; + + friend class QCustomPlot; + friend class QCPLegend; +}; + +/* end of 'src/plottables/plottable-colormap.h' */ + + +/* including file 'src/plottables/plottable-financial.h', size 8622 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCP_LIB_DECL QCPFinancialData +{ +public: + QCPFinancialData(); + QCPFinancialData(double key, double open, double high, double low, double close); + + inline double sortKey() const { return key; } + inline static QCPFinancialData fromSortKey(double sortKey) { return QCPFinancialData(sortKey, 0, 0, 0, 0); } + inline static bool sortKeyIsMainKey() { return true; } + + inline double mainKey() const { return key; } + inline double mainValue() const { return open; } + + inline QCPRange valueRange() const { return QCPRange(low, high); } // open and close must lie between low and high, so we don't need to check them + + double key, open, high, low, close; +}; +Q_DECLARE_TYPEINFO(QCPFinancialData, Q_PRIMITIVE_TYPE); + + +/*! \typedef QCPFinancialDataContainer + + Container for storing \ref QCPFinancialData points. The data is stored sorted by \a key. + + This template instantiation is the container in which QCPFinancial holds its data. For details + about the generic container, see the documentation of the class template \ref QCPDataContainer. + + \see QCPFinancialData, QCPFinancial::setData +*/ +typedef QCPDataContainer QCPFinancialDataContainer; + +class QCP_LIB_DECL QCPFinancial : public QCPAbstractPlottable1D +{ + Q_OBJECT + /// \cond INCLUDE_QPROPERTIES + Q_PROPERTY(ChartStyle chartStyle READ chartStyle WRITE setChartStyle) + Q_PROPERTY(double width READ width WRITE setWidth) + Q_PROPERTY(WidthType widthType READ widthType WRITE setWidthType) + 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 ways the width of the financial bar can be specified. Thus it defines what the + number passed to \ref setWidth actually means. + + \see setWidthType, setWidth + */ + enum WidthType { wtAbsolute ///< width is in absolute pixels + ,wtAxisRectRatio ///< width is given by a fraction of the axis rect size + ,wtPlotCoords ///< width is in key coordinates and thus scales with the key axis range + }; + Q_ENUMS(WidthType) + + /*! + 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: + QSharedPointer data() const { return mDataContainer; } + ChartStyle chartStyle() const { return mChartStyle; } + double width() const { return mWidth; } + WidthType widthType() const { return mWidthType; } + 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(QSharedPointer data); + void setData(const QVector &keys, const QVector &open, const QVector &high, const QVector &low, const QVector &close, bool alreadySorted=false); + void setChartStyle(ChartStyle style); + void setWidth(double width); + void setWidthType(WidthType widthType); + 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 QVector &keys, const QVector &open, const QVector &high, const QVector &low, const QVector &close, bool alreadySorted=false); + void addData(double key, double open, double high, double low, double close); + + // reimplemented virtual methods: + virtual QCPDataSelection selectTestRect(const QRectF &rect, bool onlySelectable) const Q_DECL_OVERRIDE; + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const Q_DECL_OVERRIDE; + virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; + virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; + + // static methods: + static QCPFinancialDataContainer timeSeriesToOhlc(const QVector &time, const QVector &value, double timeBinSize, double timeBinOffset = 0); + +protected: + // property members: + ChartStyle mChartStyle; + double mWidth; + WidthType mWidthType; + bool mTwoColored; + QBrush mBrushPositive, mBrushNegative; + QPen mPenPositive, mPenNegative; + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; + + // non-virtual methods: + void drawOhlcPlot(QCPPainter *painter, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, bool isSelected); + void drawCandlestickPlot(QCPPainter *painter, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, bool isSelected); + double getPixelWidth(double key, double keyPixel) const; + double ohlcSelectTest(const QPointF &pos, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, QCPFinancialDataContainer::const_iterator &closestDataPoint) const; + double candlestickSelectTest(const QPointF &pos, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, QCPFinancialDataContainer::const_iterator &closestDataPoint) const; + void getVisibleDataBounds(QCPFinancialDataContainer::const_iterator &begin, QCPFinancialDataContainer::const_iterator &end) const; + QRectF selectionHitBox(QCPFinancialDataContainer::const_iterator it) const; + + friend class QCustomPlot; + friend class QCPLegend; +}; +Q_DECLARE_METATYPE(QCPFinancial::ChartStyle) + +/* end of 'src/plottables/plottable-financial.h' */ + + +/* including file 'src/plottables/plottable-errorbar.h', size 7727 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +class QCP_LIB_DECL QCPErrorBarsData +{ +public: + QCPErrorBarsData(); + explicit QCPErrorBarsData(double error); + QCPErrorBarsData(double errorMinus, double errorPlus); + + double errorMinus, errorPlus; +}; +Q_DECLARE_TYPEINFO(QCPErrorBarsData, Q_PRIMITIVE_TYPE); + + +/*! \typedef QCPErrorBarsDataContainer + + Container for storing \ref QCPErrorBarsData points. It is a typedef for QVector<\ref + QCPErrorBarsData>. + + This is the container in which \ref QCPErrorBars holds its data. Unlike most other data + containers for plottables, it is not based on \ref QCPDataContainer. This is because the error + bars plottable is special in that it doesn't store its own key and value coordinate per error + bar. It adopts the key and value from the plottable to which the error bars shall be applied + (\ref QCPErrorBars::setDataPlottable). So the stored \ref QCPErrorBarsData doesn't need a + sortable key, but merely an index (as \c QVector provides), which maps one-to-one to the indices + of the other plottable's data. + + \see QCPErrorBarsData, QCPErrorBars::setData +*/ +typedef QVector QCPErrorBarsDataContainer; + +class QCP_LIB_DECL QCPErrorBars : public QCPAbstractPlottable, public QCPPlottableInterface1D +{ + Q_OBJECT + /// \cond INCLUDE_QPROPERTIES + Q_PROPERTY(QSharedPointer data READ data WRITE setData) + Q_PROPERTY(QCPAbstractPlottable* dataPlottable READ dataPlottable WRITE setDataPlottable) + Q_PROPERTY(ErrorType errorType READ errorType WRITE setErrorType) + Q_PROPERTY(double whiskerWidth READ whiskerWidth WRITE setWhiskerWidth) + Q_PROPERTY(double symbolGap READ symbolGap WRITE setSymbolGap) + /// \endcond +public: + + /*! + Defines in which orientation the error bars shall appear. If your data needs both error + dimensions, create two \ref QCPErrorBars with different \ref ErrorType. + + \see setErrorType + */ + enum ErrorType { etKeyError ///< The errors are for the key dimension (bars appear parallel to the key axis) + ,etValueError ///< The errors are for the value dimension (bars appear parallel to the value axis) + }; + Q_ENUMS(ErrorType) + + explicit QCPErrorBars(QCPAxis *keyAxis, QCPAxis *valueAxis); + virtual ~QCPErrorBars(); + // getters: + QSharedPointer data() const { return mDataContainer; } + QCPAbstractPlottable *dataPlottable() const { return mDataPlottable.data(); } + ErrorType errorType() const { return mErrorType; } + double whiskerWidth() const { return mWhiskerWidth; } + double symbolGap() const { return mSymbolGap; } + + // setters: + void setData(QSharedPointer data); + void setData(const QVector &error); + void setData(const QVector &errorMinus, const QVector &errorPlus); + void setDataPlottable(QCPAbstractPlottable* plottable); + void setErrorType(ErrorType type); + void setWhiskerWidth(double pixels); + void setSymbolGap(double pixels); + + // non-property methods: + void addData(const QVector &error); + void addData(const QVector &errorMinus, const QVector &errorPlus); + void addData(double error); + void addData(double errorMinus, double errorPlus); + + // virtual methods of 1d plottable interface: + virtual int dataCount() const Q_DECL_OVERRIDE; + virtual double dataMainKey(int index) const Q_DECL_OVERRIDE; + virtual double dataSortKey(int index) const Q_DECL_OVERRIDE; + virtual double dataMainValue(int index) const Q_DECL_OVERRIDE; + virtual QCPRange dataValueRange(int index) const Q_DECL_OVERRIDE; + virtual QPointF dataPixelPosition(int index) const Q_DECL_OVERRIDE; + virtual bool sortKeyIsMainKey() const Q_DECL_OVERRIDE; + virtual QCPDataSelection selectTestRect(const QRectF &rect, bool onlySelectable) const Q_DECL_OVERRIDE; + virtual int findBegin(double sortKey, bool expandedRange=true) const Q_DECL_OVERRIDE; + virtual int findEnd(double sortKey, bool expandedRange=true) const Q_DECL_OVERRIDE; + + // reimplemented virtual methods: + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const Q_DECL_OVERRIDE; + virtual QCPPlottableInterface1D *interface1D() Q_DECL_OVERRIDE { return this; } + +protected: + // property members: + QSharedPointer mDataContainer; + QPointer mDataPlottable; + ErrorType mErrorType; + double mWhiskerWidth; + double mSymbolGap; + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; + virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; + virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; + + // non-virtual methods: + void getErrorBarLines(QCPErrorBarsDataContainer::const_iterator it, QVector &backbones, QVector &whiskers) const; + void getVisibleDataBounds(QCPErrorBarsDataContainer::const_iterator &begin, QCPErrorBarsDataContainer::const_iterator &end, const QCPDataRange &rangeRestriction) const; + double pointDistance(const QPointF &pixelPoint, QCPErrorBarsDataContainer::const_iterator &closestData) const; + // helpers: + void getDataSegments(QList &selectedSegments, QList &unselectedSegments) const; + bool errorBarVisible(int index) const; + bool rectIntersectsLine(const QRectF &pixelRect, const QLineF &line) const; + + friend class QCustomPlot; + friend class QCPLegend; +}; + +/* end of 'src/plottables/plottable-errorbar.h' */ + + +/* including file 'src/items/item-straightline.h', size 3117 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +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: + explicit 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 Q_DECL_OVERRIDE; + + QCPItemPosition * const point1; + QCPItemPosition * const point2; + +protected: + // property members: + QPen mPen, mSelectedPen; + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + + // non-virtual methods: + QLineF getRectClippedStraightLine(const QCPVector2D &point1, const QCPVector2D &vec, const QRect &rect) const; + QPen mainPen() const; +}; + +/* end of 'src/items/item-straightline.h' */ + + +/* including file 'src/items/item-line.h', size 3407 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +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: + explicit 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 Q_DECL_OVERRIDE; + + QCPItemPosition * const start; + QCPItemPosition * const end; + +protected: + // property members: + QPen mPen, mSelectedPen; + QCPLineEnding mHead, mTail; + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + + // non-virtual methods: + QLineF getRectClippedLine(const QCPVector2D &start, const QCPVector2D &end, const QRect &rect) const; + QPen mainPen() const; +}; + +/* end of 'src/items/item-line.h' */ + + +/* including file 'src/items/item-curve.h', size 3379 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +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: + explicit 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 Q_DECL_OVERRIDE; + + 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) Q_DECL_OVERRIDE; + + // non-virtual methods: + QPen mainPen() const; +}; + +/* end of 'src/items/item-curve.h' */ + + +/* including file 'src/items/item-rect.h', size 3688 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +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: + explicit 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 Q_DECL_OVERRIDE; + + 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) Q_DECL_OVERRIDE; + virtual QPointF anchorPixelPosition(int anchorId) const Q_DECL_OVERRIDE; + + // non-virtual methods: + QPen mainPen() const; + QBrush mainBrush() const; +}; + +/* end of 'src/items/item-rect.h' */ + + +/* including file 'src/items/item-text.h', size 5554 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +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: + explicit 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 Q_DECL_OVERRIDE; + + 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) Q_DECL_OVERRIDE; + virtual QPointF anchorPixelPosition(int anchorId) const Q_DECL_OVERRIDE; + + // 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; +}; + +/* end of 'src/items/item-text.h' */ + + +/* including file 'src/items/item-ellipse.h', size 3868 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +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: + explicit 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 Q_DECL_OVERRIDE; + + 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) Q_DECL_OVERRIDE; + virtual QPointF anchorPixelPosition(int anchorId) const Q_DECL_OVERRIDE; + + // non-virtual methods: + QPen mainPen() const; + QBrush mainBrush() const; +}; + +/* end of 'src/items/item-ellipse.h' */ + + +/* including file 'src/items/item-pixmap.h', size 4373 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +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: + explicit 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 Q_DECL_OVERRIDE; + + 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; + bool mScaledPixmapInvalidated; + Qt::AspectRatioMode mAspectRatioMode; + Qt::TransformationMode mTransformationMode; + QPen mPen, mSelectedPen; + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual QPointF anchorPixelPosition(int anchorId) const Q_DECL_OVERRIDE; + + // 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; +}; + +/* end of 'src/items/item-pixmap.h' */ + + +/* including file 'src/items/item-tracer.h', size 4762 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +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) + + explicit 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 Q_DECL_OVERRIDE; + + // 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) Q_DECL_OVERRIDE; + + // non-virtual methods: + QPen mainPen() const; + QBrush mainBrush() const; +}; +Q_DECLARE_METATYPE(QCPItemTracer::TracerStyle) + +/* end of 'src/items/item-tracer.h' */ + + +/* including file 'src/items/item-bracket.h', size 3969 */ +/* commit ce344b3f96a62e5f652585e55f1ae7c7883cd45b 2018-06-25 01:03:39 +0200 */ + +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: + /*! + Defines the various visual shapes of the bracket item. The appearance can be further modified + by \ref setLength and \ref setPen. + + \see setStyle + */ + 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 + }; + Q_ENUMS(BracketStyle) + + explicit 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 Q_DECL_OVERRIDE; + + 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) Q_DECL_OVERRIDE; + virtual QPointF anchorPixelPosition(int anchorId) const Q_DECL_OVERRIDE; + + // non-virtual methods: + QPen mainPen() const; +}; +Q_DECLARE_METATYPE(QCPItemBracket::BracketStyle) + +/* end of 'src/items/item-bracket.h' */ + + +#endif // QCUSTOMPLOT_H + diff --git a/third/3rd_qcustomplot/qcustomplot.cpp b/third/3rd_qcustomplot/v2_1/qcustomplot.cpp similarity index 100% rename from third/3rd_qcustomplot/qcustomplot.cpp rename to third/3rd_qcustomplot/v2_1/qcustomplot.cpp diff --git a/third/3rd_qcustomplot/qcustomplot.h b/third/3rd_qcustomplot/v2_1/qcustomplot.h similarity index 100% rename from third/3rd_qcustomplot/qcustomplot.h rename to third/3rd_qcustomplot/v2_1/qcustomplot.h diff --git a/third/3rd_qcustomplot/v2_1_6/qcustomplot.h b/third/3rd_qcustomplot/v2_1_6/qcustomplot.h new file mode 100644 index 0000000..8990c4f --- /dev/null +++ b/third/3rd_qcustomplot/v2_1_6/qcustomplot.h @@ -0,0 +1,7722 @@ +/*************************************************************************** +** ** +** QCustomPlot, an easy to use, modern plotting widget for Qt ** +** Copyright (C) 2011-2021 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 3 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/ ** +** Date: 29.03.21 ** +** Version: 2.1.0 ** +****************************************************************************/ + +#ifndef QCUSTOMPLOT_H +#define QCUSTOMPLOT_H + +#include + +// some Qt version/configuration dependent macros to include or exclude certain code paths: +#ifdef QCUSTOMPLOT_USE_OPENGL +# if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) +# define QCP_OPENGL_PBUFFER +# else +# define QCP_OPENGL_FBO +# endif +# if QT_VERSION >= QT_VERSION_CHECK(5, 3, 0) +# define QCP_OPENGL_OFFSCREENSURFACE +# endif +#endif + +#if QT_VERSION >= QT_VERSION_CHECK(5, 4, 0) +# define QCP_DEVICEPIXELRATIO_SUPPORTED +# if QT_VERSION >= QT_VERSION_CHECK(5, 6, 0) +# define QCP_DEVICEPIXELRATIO_FLOAT +# endif +#endif + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#ifdef QCP_OPENGL_FBO +# include +# if QT_VERSION < QT_VERSION_CHECK(6, 0, 0) +# include +# else +# include +# include +# endif +# ifdef QCP_OPENGL_OFFSCREENSURFACE +# include +# else +# include +# endif +#endif +#ifdef QCP_OPENGL_PBUFFER +# include +#endif +#if QT_VERSION < QT_VERSION_CHECK(5, 0, 0) +# include +# include +# include +# include +#else +# include +# include +# include +#endif +#if QT_VERSION >= QT_VERSION_CHECK(4, 8, 0) +# include +#endif +# if QT_VERSION >= QT_VERSION_CHECK(5, 2, 0) +# include +#endif + +class QCPPainter; +class QCustomPlot; +class QCPLayerable; +class QCPLayoutElement; +class QCPLayout; +class QCPAxis; +class QCPAxisRect; +class QCPAxisPainterPrivate; +class QCPAbstractPlottable; +class QCPGraph; +class QCPAbstractItem; +class QCPPlottableInterface1D; +class QCPLegend; +class QCPItemPosition; +class QCPLayer; +class QCPAbstractLegendItem; +class QCPSelectionRect; +class QCPColorMap; +class QCPColorScale; +class QCPBars; +class QCPPolarAxisRadial; +class QCPPolarAxisAngular; +class QCPPolarGrid; +class QCPPolarGraph; + +/* including file 'src/global.h' */ +/* modified 2021-03-29T02:30:44, size 16981 */ + +#define QCUSTOMPLOT_VERSION_STR "2.1.0" +#define QCUSTOMPLOT_VERSION 0x020100 + +// decl definitions for shared library compilation/usage: +#if defined(QT_STATIC_BUILD) +# define QCP_LIB_DECL +#elif 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 + +// define empty macro for Q_DECL_OVERRIDE if it doesn't exist (Qt < 5) +#ifndef Q_DECL_OVERRIDE +# define Q_DECL_OVERRIDE +#endif + +/*! + The QCP Namespace contains general enums, QFlags and functions used throughout the QCustomPlot + library. + + It provides QMetaObject-based reflection of its enums and flags via \a QCP::staticMetaObject. +*/ +namespace QCP { + Q_NAMESPACE + +/*! + Defines the different units in which the image resolution can be specified in the export + functions. + + \see QCustomPlot::savePng, QCustomPlot::saveJpg, QCustomPlot::saveBmp, QCustomPlot::saveRastered +*/ +enum ResolutionUnit { ruDotsPerMeter ///< Resolution is given in dots per meter (dpm) + ,ruDotsPerCentimeter ///< Resolution is given in dots per centimeter (dpcm) + ,ruDotsPerInch ///< Resolution is given in dots per inch (DPI/PPI) + }; + +/*! + Defines how cosmetic pens (pens with numerical width 0) are handled during export. + + \see QCustomPlot::savePdf +*/ +enum ExportPen { epNoCosmetic ///< Cosmetic pens are converted to pens with pixel width 1 when exporting + ,epAllowCosmetic ///< Cosmetic pens are exported normally (e.g. in PDF exports, cosmetic pens always appear as 1 pixel on screen, independent of viewer zoom level) + }; + +/*! + Represents negative and positive sign domain, e.g. for passing to \ref + QCPAbstractPlottable::getKeyRange and \ref QCPAbstractPlottable::getValueRange. + + This is primarily needed when working with logarithmic axis scales, since only one of the sign + domains can be visible at a time. +*/ +enum SignDomain { sdNegative ///< The negative sign domain, i.e. numbers smaller than zero + ,sdBoth ///< Both sign domains, including zero, i.e. all numbers + ,sdPositive ///< The positive sign domain, i.e. numbers greater than zero + }; + +/*! + Defines the sides of a rectangular entity to which margins can be applied. + + \see QCPLayoutElement::setAutoMargins, QCPAxisRect::setAutoMargins +*/ +enum MarginSide { msLeft = 0x01 ///< 0x01 left margin + ,msRight = 0x02 ///< 0x02 right margin + ,msTop = 0x04 ///< 0x04 top margin + ,msBottom = 0x08 ///< 0x08 bottom margin + ,msAll = 0xFF ///< 0xFF all margins + ,msNone = 0x00 ///< 0x00 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 ///< 0x0001 Axis base line and tick marks + ,aeGrid = 0x0002 ///< 0x0002 Grid lines + ,aeSubGrid = 0x0004 ///< 0x0004 Sub grid lines + ,aeLegend = 0x0008 ///< 0x0008 Legend box + ,aeLegendItems = 0x0010 ///< 0x0010 Legend items + ,aePlottables = 0x0020 ///< 0x0020 Main lines of plottables + ,aeItems = 0x0040 ///< 0x0040 Main lines of items + ,aeScatters = 0x0080 ///< 0x0080 Scatter symbols of plottables (excluding scatter symbols of type ssPixmap) + ,aeFills = 0x0100 ///< 0x0100 Borders of fills (e.g. under or between graphs) + ,aeZeroLine = 0x0200 ///< 0x0200 Zero-lines, see \ref QCPGrid::setZeroLinePen + ,aeOther = 0x8000 ///< 0x8000 Other elements that don't fit into any of the existing categories + ,aeAll = 0xFFFF ///< 0xFFFF All elements + ,aeNone = 0x0000 ///< 0x0000 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 ///< 0x000 No hints are set + ,phFastPolylines = 0x001 ///< 0x001 Graph/Curve lines are drawn with a faster method. This reduces the quality especially of the line segment + ///< joins, thus is most effective for pen sizes larger than 1. It is only used for solid line pens. + ,phImmediateRefresh = 0x002 ///< 0x002 causes an immediate repaint() instead of a soft update() when QCustomPlot::replot() is called with parameter \ref QCustomPlot::rpRefreshHint. + ///< This is set by default to prevent the plot from freezing on fast consecutive replots (e.g. user drags ranges with mouse). + ,phCacheLabels = 0x004 ///< 0x004 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 { iNone = 0x000 ///< 0x000 None of the interactions are possible + ,iRangeDrag = 0x001 ///< 0x001 Axis ranges are draggable (see \ref QCPAxisRect::setRangeDrag, \ref QCPAxisRect::setRangeDragAxes) + ,iRangeZoom = 0x002 ///< 0x002 Axis ranges are zoomable with the mouse wheel (see \ref QCPAxisRect::setRangeZoom, \ref QCPAxisRect::setRangeZoomAxes) + ,iMultiSelect = 0x004 ///< 0x004 The user can select multiple objects by holding the modifier set by \ref QCustomPlot::setMultiSelectModifier while clicking + ,iSelectPlottables = 0x008 ///< 0x008 Plottables are selectable (e.g. graphs, curves, bars,... see QCPAbstractPlottable) + ,iSelectAxes = 0x010 ///< 0x010 Axes are selectable (or parts of them, see QCPAxis::setSelectableParts) + ,iSelectLegend = 0x020 ///< 0x020 Legends are selectable (or their child items, see QCPLegend::setSelectableParts) + ,iSelectItems = 0x040 ///< 0x040 Items are selectable (Rectangles, Arrows, Textitems, etc. see \ref QCPAbstractItem) + ,iSelectOther = 0x080 ///< 0x080 All other objects are selectable (e.g. your own derived layerables, other layout elements,...) + ,iSelectPlottablesBeyondAxisRect = 0x100 ///< 0x100 When performing plottable selection/hit tests, this flag extends the sensitive area beyond the axis rect + }; +Q_DECLARE_FLAGS(Interactions, Interaction) + +/*! + Defines the behaviour of the selection rect. + + \see QCustomPlot::setSelectionRectMode, QCustomPlot::selectionRect, QCPSelectionRect +*/ +enum SelectionRectMode { srmNone ///< The selection rect is disabled, and all mouse events are forwarded to the underlying objects, e.g. for axis range dragging + ,srmZoom ///< When dragging the mouse, a selection rect becomes active. Upon releasing, the axes that are currently set as range zoom axes (\ref QCPAxisRect::setRangeZoomAxes) will have their ranges zoomed accordingly. + ,srmSelect ///< When dragging the mouse, a selection rect becomes active. Upon releasing, plottable data points that were within the selection rect are selected, if the plottable's selectability setting permits. (See \ref dataselection "data selection mechanism" for details.) + ,srmCustom ///< When dragging the mouse, a selection rect becomes active. It is the programmer's responsibility to connect according slots to the selection rect's signals (e.g. \ref QCPSelectionRect::accepted) in order to process the user interaction. + }; + +/*! + Defines the different ways a plottable can be selected. These images show the effect of the + different selection types, when the indicated selection rect was dragged: + +
+ + + + + + + + +
\image html selectiontype-none.png stNone\image html selectiontype-whole.png stWhole\image html selectiontype-singledata.png stSingleData\image html selectiontype-datarange.png stDataRange\image html selectiontype-multipledataranges.png stMultipleDataRanges
+
+ + \see QCPAbstractPlottable::setSelectable, QCPDataSelection::enforceType +*/ +enum SelectionType { stNone ///< The plottable is not selectable + ,stWhole ///< Selection behaves like \ref stMultipleDataRanges, but if there are any data points selected, the entire plottable is drawn as selected. + ,stSingleData ///< One individual data point can be selected at a time + ,stDataRange ///< Multiple contiguous data points (a data range) can be selected + ,stMultipleDataRanges ///< Any combination of data points/ranges can be selected + }; + + Q_ENUM_NS(ExportPen) + Q_ENUM_NS(ResolutionUnit) + Q_ENUM_NS(SignDomain) + Q_ENUM_NS(MarginSide) + Q_FLAG_NS(MarginSides) + Q_ENUM_NS(AntialiasedElement) + Q_FLAG_NS(AntialiasedElements) + Q_ENUM_NS(PlottingHint) + Q_FLAG_NS(PlottingHints) + Q_ENUM_NS(Interaction) + Q_FLAG_NS(Interactions) + Q_ENUM_NS(SelectionRectMode) + Q_ENUM_NS(SelectionType) + +/*! \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) +//no need to use Q_DECLARE_METATYPE on enum since Q_ENUM_NS adds enum as metatype automatically + +/* end of 'src/global.h' */ + + +/* including file 'src/vector2d.h' */ +/* modified 2021-03-29T02:30:44, size 4988 */ + +class QCP_LIB_DECL QCPVector2D +{ +public: + QCPVector2D(); + QCPVector2D(double x, double y); + QCPVector2D(const QPoint &point); + QCPVector2D(const QPointF &point); + + // getters: + double x() const { return mX; } + double y() const { return mY; } + double &rx() { return mX; } + double &ry() { return mY; } + + // setters: + void setX(double x) { mX = x; } + void setY(double y) { mY = y; } + + // non-virtual methods: + double length() const { return qSqrt(mX*mX+mY*mY); } + double lengthSquared() const { return mX*mX+mY*mY; } + double angle() const { return qAtan2(mY, mX); } + QPoint toPoint() const { return QPoint(int(mX), int(mY)); } + QPointF toPointF() const { return QPointF(mX, mY); } + + bool isNull() const { return qIsNull(mX) && qIsNull(mY); } + void normalize(); + QCPVector2D normalized() const; + QCPVector2D perpendicular() const { return QCPVector2D(-mY, mX); } + double dot(const QCPVector2D &vec) const { return mX*vec.mX+mY*vec.mY; } + double distanceSquaredToLine(const QCPVector2D &start, const QCPVector2D &end) const; + double distanceSquaredToLine(const QLineF &line) const; + double distanceToStraightLine(const QCPVector2D &base, const QCPVector2D &direction) const; + + QCPVector2D &operator*=(double factor); + QCPVector2D &operator/=(double divisor); + QCPVector2D &operator+=(const QCPVector2D &vector); + QCPVector2D &operator-=(const QCPVector2D &vector); + +private: + // property members: + double mX, mY; + + friend inline const QCPVector2D operator*(double factor, const QCPVector2D &vec); + friend inline const QCPVector2D operator*(const QCPVector2D &vec, double factor); + friend inline const QCPVector2D operator/(const QCPVector2D &vec, double divisor); + friend inline const QCPVector2D operator+(const QCPVector2D &vec1, const QCPVector2D &vec2); + friend inline const QCPVector2D operator-(const QCPVector2D &vec1, const QCPVector2D &vec2); + friend inline const QCPVector2D operator-(const QCPVector2D &vec); +}; +Q_DECLARE_TYPEINFO(QCPVector2D, Q_MOVABLE_TYPE); + +inline const QCPVector2D operator*(double factor, const QCPVector2D &vec) { return QCPVector2D(vec.mX*factor, vec.mY*factor); } +inline const QCPVector2D operator*(const QCPVector2D &vec, double factor) { return QCPVector2D(vec.mX*factor, vec.mY*factor); } +inline const QCPVector2D operator/(const QCPVector2D &vec, double divisor) { return QCPVector2D(vec.mX/divisor, vec.mY/divisor); } +inline const QCPVector2D operator+(const QCPVector2D &vec1, const QCPVector2D &vec2) { return QCPVector2D(vec1.mX+vec2.mX, vec1.mY+vec2.mY); } +inline const QCPVector2D operator-(const QCPVector2D &vec1, const QCPVector2D &vec2) { return QCPVector2D(vec1.mX-vec2.mX, vec1.mY-vec2.mY); } +inline const QCPVector2D operator-(const QCPVector2D &vec) { return QCPVector2D(-vec.mX, -vec.mY); } + +/*! \relates QCPVector2D + + Prints \a vec in a human readable format to the qDebug output. +*/ +inline QDebug operator<< (QDebug d, const QCPVector2D &vec) +{ + d.nospace() << "QCPVector2D(" << vec.x() << ", " << vec.y() << ")"; + return d.space(); +} + +/* end of 'src/vector2d.h' */ + + +/* including file 'src/painter.h' */ +/* modified 2021-03-29T02:30:44, size 4035 */ + +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 ///< 0x00 Default mode for painting on screen devices + ,pmVectorized = 0x01 ///< 0x01 Mode for vectorized painting (e.g. PDF export). For example, this prevents some antialiasing fixes. + ,pmNoCaching = 0x02 ///< 0x02 Mode for all sorts of exports (e.g. PNG, PDF,...). For example, this prevents using cached pixmap labels + ,pmNonCosmetic = 0x04 ///< 0x04 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_ENUMS(PainterMode) + Q_FLAGS(PainterModes) + Q_DECLARE_FLAGS(PainterModes, PainterMode) + + QCPPainter(); + explicit QCPPainter(QPaintDevice *device); + + // 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 mAntialiasingStack; +}; +Q_DECLARE_OPERATORS_FOR_FLAGS(QCPPainter::PainterModes) +Q_DECLARE_METATYPE(QCPPainter::PainterMode) + +/* end of 'src/painter.h' */ + + +/* including file 'src/paintbuffer.h' */ +/* modified 2021-03-29T02:30:44, size 5006 */ + +class QCP_LIB_DECL QCPAbstractPaintBuffer +{ +public: + explicit QCPAbstractPaintBuffer(const QSize &size, double devicePixelRatio); + virtual ~QCPAbstractPaintBuffer(); + + // getters: + QSize size() const { return mSize; } + bool invalidated() const { return mInvalidated; } + double devicePixelRatio() const { return mDevicePixelRatio; } + + // setters: + void setSize(const QSize &size); + void setInvalidated(bool invalidated=true); + void setDevicePixelRatio(double ratio); + + // introduced virtual methods: + virtual QCPPainter *startPainting() = 0; + virtual void donePainting() {} + virtual void draw(QCPPainter *painter) const = 0; + virtual void clear(const QColor &color) = 0; + +protected: + // property members: + QSize mSize; + double mDevicePixelRatio; + + // non-property members: + bool mInvalidated; + + // introduced virtual methods: + virtual void reallocateBuffer() = 0; +}; + + +class QCP_LIB_DECL QCPPaintBufferPixmap : public QCPAbstractPaintBuffer +{ +public: + explicit QCPPaintBufferPixmap(const QSize &size, double devicePixelRatio); + virtual ~QCPPaintBufferPixmap() Q_DECL_OVERRIDE; + + // reimplemented virtual methods: + virtual QCPPainter *startPainting() Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) const Q_DECL_OVERRIDE; + void clear(const QColor &color) Q_DECL_OVERRIDE; + +protected: + // non-property members: + QPixmap mBuffer; + + // reimplemented virtual methods: + virtual void reallocateBuffer() Q_DECL_OVERRIDE; +}; + + +#ifdef QCP_OPENGL_PBUFFER +class QCP_LIB_DECL QCPPaintBufferGlPbuffer : public QCPAbstractPaintBuffer +{ +public: + explicit QCPPaintBufferGlPbuffer(const QSize &size, double devicePixelRatio, int multisamples); + virtual ~QCPPaintBufferGlPbuffer() Q_DECL_OVERRIDE; + + // reimplemented virtual methods: + virtual QCPPainter *startPainting() Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) const Q_DECL_OVERRIDE; + void clear(const QColor &color) Q_DECL_OVERRIDE; + +protected: + // non-property members: + QGLPixelBuffer *mGlPBuffer; + int mMultisamples; + + // reimplemented virtual methods: + virtual void reallocateBuffer() Q_DECL_OVERRIDE; +}; +#endif // QCP_OPENGL_PBUFFER + + +#ifdef QCP_OPENGL_FBO +class QCP_LIB_DECL QCPPaintBufferGlFbo : public QCPAbstractPaintBuffer +{ +public: + explicit QCPPaintBufferGlFbo(const QSize &size, double devicePixelRatio, QWeakPointer glContext, QWeakPointer glPaintDevice); + virtual ~QCPPaintBufferGlFbo() Q_DECL_OVERRIDE; + + // reimplemented virtual methods: + virtual QCPPainter *startPainting() Q_DECL_OVERRIDE; + virtual void donePainting() Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) const Q_DECL_OVERRIDE; + void clear(const QColor &color) Q_DECL_OVERRIDE; + +protected: + // non-property members: + QWeakPointer mGlContext; + QWeakPointer mGlPaintDevice; + QOpenGLFramebufferObject *mGlFrameBuffer; + + // reimplemented virtual methods: + virtual void reallocateBuffer() Q_DECL_OVERRIDE; +}; +#endif // QCP_OPENGL_FBO + +/* end of 'src/paintbuffer.h' */ + + +/* including file 'src/layer.h' */ +/* modified 2021-03-29T02:30:44, size 7038 */ + +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 children READ children) + Q_PROPERTY(bool visible READ visible WRITE setVisible) + Q_PROPERTY(LayerMode mode READ mode WRITE setMode) + /// \endcond +public: + + /*! + Defines the different rendering modes of a layer. Depending on the mode, certain layers can be + replotted individually, without the need to replot (possibly complex) layerables on other + layers. + + \see setMode + */ + 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). + }; + Q_ENUMS(LayerMode) + + QCPLayer(QCustomPlot* parentPlot, const QString &layerName); + virtual ~QCPLayer(); + + // getters: + QCustomPlot *parentPlot() const { return mParentPlot; } + QString name() const { return mName; } + int index() const { return mIndex; } + QList children() const { return mChildren; } + bool visible() const { return mVisible; } + LayerMode mode() const { return mMode; } + + // setters: + void setVisible(bool visible); + void setMode(LayerMode mode); + + // non-virtual methods: + void replot(); + +protected: + // property members: + QCustomPlot *mParentPlot; + QString mName; + int mIndex; + QList mChildren; + bool mVisible; + LayerMode mMode; + + // non-property members: + QWeakPointer mPaintBuffer; + + // non-virtual methods: + void draw(QCPPainter *painter); + void drawToPaintBuffer(); + void addChild(QCPLayerable *layerable, bool prepend); + void removeChild(QCPLayerable *layerable); + +private: + Q_DISABLE_COPY(QCPLayer) + + friend class QCustomPlot; + friend class QCPLayerable; +}; +Q_DECLARE_METATYPE(QCPLayer::LayerMode) + +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=nullptr); + virtual ~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=nullptr) const; + + // non-property methods: + bool realVisibility() const; + +signals: + void layerChanged(QCPLayer *newLayer); + +protected: + // property members: + bool mVisible; + QCustomPlot *mParentPlot; + QPointer 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; + // selection events: + virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged); + virtual void deselectEvent(bool *selectionStateChanged); + // low-level mouse events: + virtual void mousePressEvent(QMouseEvent *event, const QVariant &details); + virtual void mouseMoveEvent(QMouseEvent *event, const QPointF &startPos); + virtual void mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos); + virtual void mouseDoubleClickEvent(QMouseEvent *event, const QVariant &details); + virtual void wheelEvent(QWheelEvent *event); + + // 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 QCPLayer; + friend class QCPAxisRect; +}; + +/* end of 'src/layer.h' */ + + +/* including file 'src/axis/range.h' */ +/* modified 2021-03-29T02:30:44, size 5280 */ + +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 { return upper-lower; } + double center() const { return (upper+lower)*0.5; } + void normalize() { if (lower > upper) qSwap(lower, upper); } + void expand(const QCPRange &otherRange); + void expand(double includeCoord); + QCPRange expanded(const QCPRange &otherRange) const; + QCPRange expanded(double includeCoord) const; + QCPRange bounded(double lowerBound, double upperBound) const; + QCPRange sanitizedForLogScale() const; + QCPRange sanitizedForLinScale() const; + bool contains(double value) const { return value >= lower && value <= upper; } + + static bool validRange(double lower, double upper); + static bool validRange(const QCPRange &range); + static const double minRange; + static const double maxRange; + +}; +Q_DECLARE_TYPEINFO(QCPRange, Q_MOVABLE_TYPE); + +/*! \relates QCPRange + + Prints \a range in a human readable format to the qDebug output. +*/ +inline QDebug operator<< (QDebug d, const QCPRange &range) +{ + d.nospace() << "QCPRange(" << range.lower << ", " << range.upper << ")"; + return d.space(); +} + +/*! + 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; +} + +/* end of 'src/axis/range.h' */ + + +/* including file 'src/selection.h' */ +/* modified 2021-03-29T02:30:44, size 8569 */ + +class QCP_LIB_DECL QCPDataRange +{ +public: + QCPDataRange(); + QCPDataRange(int begin, int end); + + bool operator==(const QCPDataRange& other) const { return mBegin == other.mBegin && mEnd == other.mEnd; } + bool operator!=(const QCPDataRange& other) const { return !(*this == other); } + + // getters: + int begin() const { return mBegin; } + int end() const { return mEnd; } + int size() const { return mEnd-mBegin; } + int length() const { return size(); } + + // setters: + void setBegin(int begin) { mBegin = begin; } + void setEnd(int end) { mEnd = end; } + + // non-property methods: + bool isValid() const { return (mEnd >= mBegin) && (mBegin >= 0); } + bool isEmpty() const { return length() == 0; } + QCPDataRange bounded(const QCPDataRange &other) const; + QCPDataRange expanded(const QCPDataRange &other) const; + QCPDataRange intersection(const QCPDataRange &other) const; + QCPDataRange adjusted(int changeBegin, int changeEnd) const { return QCPDataRange(mBegin+changeBegin, mEnd+changeEnd); } + bool intersects(const QCPDataRange &other) const; + bool contains(const QCPDataRange &other) const; + +private: + // property members: + int mBegin, mEnd; + +}; +Q_DECLARE_TYPEINFO(QCPDataRange, Q_MOVABLE_TYPE); + + +class QCP_LIB_DECL QCPDataSelection +{ +public: + explicit QCPDataSelection(); + explicit QCPDataSelection(const QCPDataRange &range); + + bool operator==(const QCPDataSelection& other) const; + bool operator!=(const QCPDataSelection& other) const { return !(*this == other); } + QCPDataSelection &operator+=(const QCPDataSelection& other); + QCPDataSelection &operator+=(const QCPDataRange& other); + QCPDataSelection &operator-=(const QCPDataSelection& other); + QCPDataSelection &operator-=(const QCPDataRange& other); + friend inline const QCPDataSelection operator+(const QCPDataSelection& a, const QCPDataSelection& b); + friend inline const QCPDataSelection operator+(const QCPDataRange& a, const QCPDataSelection& b); + friend inline const QCPDataSelection operator+(const QCPDataSelection& a, const QCPDataRange& b); + friend inline const QCPDataSelection operator+(const QCPDataRange& a, const QCPDataRange& b); + friend inline const QCPDataSelection operator-(const QCPDataSelection& a, const QCPDataSelection& b); + friend inline const QCPDataSelection operator-(const QCPDataRange& a, const QCPDataSelection& b); + friend inline const QCPDataSelection operator-(const QCPDataSelection& a, const QCPDataRange& b); + friend inline const QCPDataSelection operator-(const QCPDataRange& a, const QCPDataRange& b); + + // getters: + int dataRangeCount() const { return mDataRanges.size(); } + int dataPointCount() const; + QCPDataRange dataRange(int index=0) const; + QList dataRanges() const { return mDataRanges; } + QCPDataRange span() const; + + // non-property methods: + void addDataRange(const QCPDataRange &dataRange, bool simplify=true); + void clear(); + bool isEmpty() const { return mDataRanges.isEmpty(); } + void simplify(); + void enforceType(QCP::SelectionType type); + bool contains(const QCPDataSelection &other) const; + QCPDataSelection intersection(const QCPDataRange &other) const; + QCPDataSelection intersection(const QCPDataSelection &other) const; + QCPDataSelection inverse(const QCPDataRange &outerRange) const; + +private: + // property members: + QList mDataRanges; + + inline static bool lessThanDataRangeBegin(const QCPDataRange &a, const QCPDataRange &b) { return a.begin() < b.begin(); } +}; +Q_DECLARE_METATYPE(QCPDataSelection) + + +/*! + Return a \ref QCPDataSelection with the data points in \a a joined with the data points in \a b. + The resulting data selection is already simplified (see \ref QCPDataSelection::simplify). +*/ +inline const QCPDataSelection operator+(const QCPDataSelection& a, const QCPDataSelection& b) +{ + QCPDataSelection result(a); + result += b; + return result; +} + +/*! + Return a \ref QCPDataSelection with the data points in \a a joined with the data points in \a b. + The resulting data selection is already simplified (see \ref QCPDataSelection::simplify). +*/ +inline const QCPDataSelection operator+(const QCPDataRange& a, const QCPDataSelection& b) +{ + QCPDataSelection result(a); + result += b; + return result; +} + +/*! + Return a \ref QCPDataSelection with the data points in \a a joined with the data points in \a b. + The resulting data selection is already simplified (see \ref QCPDataSelection::simplify). +*/ +inline const QCPDataSelection operator+(const QCPDataSelection& a, const QCPDataRange& b) +{ + QCPDataSelection result(a); + result += b; + return result; +} + +/*! + Return a \ref QCPDataSelection with the data points in \a a joined with the data points in \a b. + The resulting data selection is already simplified (see \ref QCPDataSelection::simplify). +*/ +inline const QCPDataSelection operator+(const QCPDataRange& a, const QCPDataRange& b) +{ + QCPDataSelection result(a); + result += b; + return result; +} + +/*! + Return a \ref QCPDataSelection with the data points which are in \a a but not in \a b. +*/ +inline const QCPDataSelection operator-(const QCPDataSelection& a, const QCPDataSelection& b) +{ + QCPDataSelection result(a); + result -= b; + return result; +} + +/*! + Return a \ref QCPDataSelection with the data points which are in \a a but not in \a b. +*/ +inline const QCPDataSelection operator-(const QCPDataRange& a, const QCPDataSelection& b) +{ + QCPDataSelection result(a); + result -= b; + return result; +} + +/*! + Return a \ref QCPDataSelection with the data points which are in \a a but not in \a b. +*/ +inline const QCPDataSelection operator-(const QCPDataSelection& a, const QCPDataRange& b) +{ + QCPDataSelection result(a); + result -= b; + return result; +} + +/*! + Return a \ref QCPDataSelection with the data points which are in \a a but not in \a b. +*/ +inline const QCPDataSelection operator-(const QCPDataRange& a, const QCPDataRange& b) +{ + QCPDataSelection result(a); + result -= b; + return result; +} + +/*! \relates QCPDataRange + + Prints \a dataRange in a human readable format to the qDebug output. +*/ +inline QDebug operator<< (QDebug d, const QCPDataRange &dataRange) +{ + d.nospace() << "QCPDataRange(" << dataRange.begin() << ", " << dataRange.end() << ")"; + return d; +} + +/*! \relates QCPDataSelection + + Prints \a selection in a human readable format to the qDebug output. +*/ +inline QDebug operator<< (QDebug d, const QCPDataSelection &selection) +{ + d.nospace() << "QCPDataSelection("; + for (int i=0; i elements(QCP::MarginSide side) const { return mChildren.value(side); } + bool isEmpty() const; + void clear(); + +protected: + // non-property members: + QCustomPlot *mParentPlot; + QHash > mChildren; + + // introduced virtual methods: + virtual int commonMargin(QCP::MarginSide side) const; + + // non-virtual methods: + 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) + Q_PROPERTY(SizeConstraintRect sizeConstraintRect READ sizeConstraintRect WRITE setSizeConstraintRect) + /// \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) + + /*! + Defines to which rect of a layout element the size constraints that can be set via \ref + setMinimumSize and \ref setMaximumSize apply. The outer rect (\ref outerRect) includes the + margins (e.g. in the case of a QCPAxisRect the axis labels), whereas the inner rect (\ref rect) + does not. + + \see setSizeConstraintRect + */ + enum SizeConstraintRect { scrInnerRect ///< Minimum/Maximum size constraints apply to inner rect + , scrOuterRect ///< Minimum/Maximum size constraints apply to outer rect, thus include layout element margins + }; + Q_ENUMS(SizeConstraintRect) + + explicit QCPLayoutElement(QCustomPlot *parentPlot=nullptr); + virtual ~QCPLayoutElement() Q_DECL_OVERRIDE; + + // 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; } + SizeConstraintRect sizeConstraintRect() const { return mSizeConstraintRect; } + QCPMarginGroup *marginGroup(QCP::MarginSide side) const { return mMarginGroups.value(side, nullptr); } + QHash 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 setSizeConstraintRect(SizeConstraintRect constraintRect); + void setMarginGroup(QCP::MarginSides sides, QCPMarginGroup *group); + + // introduced virtual methods: + virtual void update(UpdatePhase phase); + virtual QSize minimumOuterSizeHint() const; + virtual QSize maximumOuterSizeHint() const; + virtual QList elements(bool recursive) const; + + // reimplemented virtual methods: + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; + +protected: + // property members: + QCPLayout *mParentLayout; + QSize mMinimumSize, mMaximumSize; + SizeConstraintRect mSizeConstraintRect; + QRect mRect, mOuterRect; + QMargins mMargins, mMinimumMargins; + QCP::MarginSides mAutoMargins; + QHash mMarginGroups; + + // introduced virtual methods: + virtual int calculateAutoMargin(QCP::MarginSide side); + virtual void layoutChanged(); + + // reimplemented virtual methods: + virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE { Q_UNUSED(painter) } + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE { Q_UNUSED(painter) } + virtual void parentPlotInitialized(QCustomPlot *parentPlot) Q_DECL_OVERRIDE; + +private: + Q_DISABLE_COPY(QCPLayoutElement) + + friend class QCustomPlot; + friend class QCPLayout; + friend class QCPMarginGroup; +}; +Q_DECLARE_METATYPE(QCPLayoutElement::UpdatePhase) + + +class QCP_LIB_DECL QCPLayout : public QCPLayoutElement +{ + Q_OBJECT +public: + explicit QCPLayout(); + + // reimplemented virtual methods: + virtual void update(UpdatePhase phase) Q_DECL_OVERRIDE; + virtual QList elements(bool recursive) const Q_DECL_OVERRIDE; + + // 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 getSectionSizes(QVector maxSizes, QVector minSizes, QVector stretchFactors, int totalSize) const; + static QSize getFinalMinimumOuterSize(const QCPLayoutElement *el); + static QSize getFinalMaximumOuterSize(const QCPLayoutElement *el); + +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 columnStretchFactors READ columnStretchFactors WRITE setColumnStretchFactors) + Q_PROPERTY(QList rowStretchFactors READ rowStretchFactors WRITE setRowStretchFactors) + Q_PROPERTY(int columnSpacing READ columnSpacing WRITE setColumnSpacing) + Q_PROPERTY(int rowSpacing READ rowSpacing WRITE setRowSpacing) + Q_PROPERTY(FillOrder fillOrder READ fillOrder WRITE setFillOrder) + Q_PROPERTY(int wrap READ wrap WRITE setWrap) + /// \endcond +public: + + /*! + Defines in which direction the grid is filled when using \ref addElement(QCPLayoutElement*). + The column/row at which wrapping into the next row/column occurs can be specified with \ref + setWrap. + + \see setFillOrder + */ + enum FillOrder { foRowsFirst ///< Rows are filled first, and a new element is wrapped to the next column if the row count would exceed \ref setWrap. + ,foColumnsFirst ///< Columns are filled first, and a new element is wrapped to the next row if the column count would exceed \ref setWrap. + }; + Q_ENUMS(FillOrder) + + explicit QCPLayoutGrid(); + virtual ~QCPLayoutGrid() Q_DECL_OVERRIDE; + + // getters: + int rowCount() const { return mElements.size(); } + int columnCount() const { return mElements.size() > 0 ? mElements.first().size() : 0; } + QList columnStretchFactors() const { return mColumnStretchFactors; } + QList rowStretchFactors() const { return mRowStretchFactors; } + int columnSpacing() const { return mColumnSpacing; } + int rowSpacing() const { return mRowSpacing; } + int wrap() const { return mWrap; } + FillOrder fillOrder() const { return mFillOrder; } + + // setters: + void setColumnStretchFactor(int column, double factor); + void setColumnStretchFactors(const QList &factors); + void setRowStretchFactor(int row, double factor); + void setRowStretchFactors(const QList &factors); + void setColumnSpacing(int pixels); + void setRowSpacing(int pixels); + void setWrap(int count); + void setFillOrder(FillOrder order, bool rearrange=true); + + // reimplemented virtual methods: + virtual void updateLayout() Q_DECL_OVERRIDE; + virtual int elementCount() const Q_DECL_OVERRIDE { return rowCount()*columnCount(); } + virtual QCPLayoutElement* elementAt(int index) const Q_DECL_OVERRIDE; + virtual QCPLayoutElement* takeAt(int index) Q_DECL_OVERRIDE; + virtual bool take(QCPLayoutElement* element) Q_DECL_OVERRIDE; + virtual QList elements(bool recursive) const Q_DECL_OVERRIDE; + virtual void simplify() Q_DECL_OVERRIDE; + virtual QSize minimumOuterSizeHint() const Q_DECL_OVERRIDE; + virtual QSize maximumOuterSizeHint() const Q_DECL_OVERRIDE; + + // non-virtual methods: + QCPLayoutElement *element(int row, int column) const; + bool addElement(int row, int column, QCPLayoutElement *element); + bool addElement(QCPLayoutElement *element); + bool hasElement(int row, int column); + void expandTo(int newRowCount, int newColumnCount); + void insertRow(int newIndex); + void insertColumn(int newIndex); + int rowColToIndex(int row, int column) const; + void indexToRowCol(int index, int &row, int &column) const; + +protected: + // property members: + QList > mElements; + QList mColumnStretchFactors; + QList mRowStretchFactors; + int mColumnSpacing, mRowSpacing; + int mWrap; + FillOrder mFillOrder; + + // non-virtual methods: + void getMinimumRowColSizes(QVector *minColWidths, QVector *minRowHeights) const; + void getMaximumRowColSizes(QVector *maxColWidths, QVector *maxRowHeights) const; + +private: + Q_DISABLE_COPY(QCPLayoutGrid) +}; +Q_DECLARE_METATYPE(QCPLayoutGrid::FillOrder) + + +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 + }; + Q_ENUMS(InsetPlacement) + + explicit QCPLayoutInset(); + virtual ~QCPLayoutInset() Q_DECL_OVERRIDE; + + // 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() Q_DECL_OVERRIDE; + virtual int elementCount() const Q_DECL_OVERRIDE; + virtual QCPLayoutElement* elementAt(int index) const Q_DECL_OVERRIDE; + virtual QCPLayoutElement* takeAt(int index) Q_DECL_OVERRIDE; + virtual bool take(QCPLayoutElement* element) Q_DECL_OVERRIDE; + virtual void simplify() Q_DECL_OVERRIDE {} + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; + + // non-virtual methods: + void addElement(QCPLayoutElement *element, Qt::Alignment alignment); + void addElement(QCPLayoutElement *element, const QRectF &rect); + +protected: + // property members: + QList mElements; + QList mInsetPlacement; + QList mInsetAlignment; + QList mInsetRect; + +private: + Q_DISABLE_COPY(QCPLayoutInset) +}; +Q_DECLARE_METATYPE(QCPLayoutInset::InsetPlacement) + +/* end of 'src/layout.h' */ + + +/* including file 'src/lineending.h' */ +/* modified 2021-03-29T02:30:44, size 4426 */ + +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 + */ + 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) + }; + Q_ENUMS(EndingStyle) + + 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 QCPVector2D &pos, const QCPVector2D &dir) const; + void draw(QCPPainter *painter, const QCPVector2D &pos, double angle) const; + +protected: + // property members: + EndingStyle mStyle; + double mWidth, mLength; + bool mInverted; +}; +Q_DECLARE_TYPEINFO(QCPLineEnding, Q_MOVABLE_TYPE); +Q_DECLARE_METATYPE(QCPLineEnding::EndingStyle) + +/* end of 'src/lineending.h' */ + + +/* including file 'src/axis/labelpainter.h' */ +/* modified 2021-03-29T02:30:44, size 7086 */ + +class QCPLabelPainterPrivate +{ + Q_GADGET +public: + /*! + TODO + */ + enum AnchorMode { amRectangular ///< + ,amSkewedUpright ///< + ,amSkewedRotated ///< + }; + Q_ENUMS(AnchorMode) + + /*! + TODO + */ + enum AnchorReferenceType { artNormal ///< + ,artTangent ///< + }; + Q_ENUMS(AnchorReferenceType) + + /*! + TODO + */ + enum AnchorSide { asLeft ///< + ,asRight ///< + ,asTop ///< + ,asBottom ///< + ,asTopLeft + ,asTopRight + ,asBottomRight + ,asBottomLeft + }; + Q_ENUMS(AnchorSide) + + explicit QCPLabelPainterPrivate(QCustomPlot *parentPlot); + virtual ~QCPLabelPainterPrivate(); + + // setters: + void setAnchorSide(AnchorSide side); + void setAnchorMode(AnchorMode mode); + void setAnchorReference(const QPointF &pixelPoint); + void setAnchorReferenceType(AnchorReferenceType type); + void setFont(const QFont &font); + void setColor(const QColor &color); + void setPadding(int padding); + void setRotation(double rotation); + void setSubstituteExponent(bool enabled); + void setMultiplicationSymbol(QChar symbol); + void setAbbreviateDecimalPowers(bool enabled); + void setCacheSize(int labelCount); + + // getters: + AnchorMode anchorMode() const { return mAnchorMode; } + AnchorSide anchorSide() const { return mAnchorSide; } + QPointF anchorReference() const { return mAnchorReference; } + AnchorReferenceType anchorReferenceType() const { return mAnchorReferenceType; } + QFont font() const { return mFont; } + QColor color() const { return mColor; } + int padding() const { return mPadding; } + double rotation() const { return mRotation; } + bool substituteExponent() const { return mSubstituteExponent; } + QChar multiplicationSymbol() const { return mMultiplicationSymbol; } + bool abbreviateDecimalPowers() const { return mAbbreviateDecimalPowers; } + int cacheSize() const; + + //virtual int size() const; + + // non-property methods: + void drawTickLabel(QCPPainter *painter, const QPointF &tickPos, const QString &text); + void clearCache(); + + // constants that may be used with setMultiplicationSymbol: + static const QChar SymbolDot; + static const QChar SymbolCross; + +protected: + struct CachedLabel + { + QPoint offset; + QPixmap pixmap; + }; + struct LabelData + { + AnchorSide side; + double rotation; // angle in degrees + QTransform transform; // the transform about the label anchor which is at (0, 0). Does not contain final absolute x/y positioning on the plot/axis + QString basePart, expPart, suffixPart; + QRect baseBounds, expBounds, suffixBounds; + QRect totalBounds; // is in a coordinate system where label top left is at (0, 0) + QRect rotatedTotalBounds; // is in a coordinate system where the label anchor is at (0, 0) + QFont baseFont, expFont; + QColor color; + }; + + // property members: + AnchorMode mAnchorMode; + AnchorSide mAnchorSide; + QPointF mAnchorReference; + AnchorReferenceType mAnchorReferenceType; + QFont mFont; + QColor mColor; + int mPadding; + double mRotation; // this is the rotation applied uniformly to all labels, not the heterogeneous rotation in amCircularRotated mode + bool mSubstituteExponent; + QChar mMultiplicationSymbol; + bool mAbbreviateDecimalPowers; + // non-property members: + QCustomPlot *mParentPlot; + QByteArray mLabelParameterHash; // to determine whether mLabelCache needs to be cleared due to changed parameters + QCache mLabelCache; + QRect mAxisSelectionBox, mTickLabelsSelectionBox, mLabelSelectionBox; + int mLetterCapHeight, mLetterDescent; + + // introduced virtual methods: + virtual void drawLabelMaybeCached(QCPPainter *painter, const QFont &font, const QColor &color, const QPointF &pos, AnchorSide side, double rotation, const QString &text); + virtual QByteArray generateLabelParameterHash() const; // TODO: get rid of this in favor of invalidation flag upon setters? + + // non-virtual methods: + QPointF getAnchorPos(const QPointF &tickPos); + void drawText(QCPPainter *painter, const QPointF &pos, const LabelData &labelData) const; + LabelData getTickLabelData(const QFont &font, const QColor &color, double rotation, AnchorSide side, const QString &text) const; + void applyAnchorTransform(LabelData &labelData) const; + //void getMaxTickLabelSize(const QFont &font, const QString &text, QSize *tickLabelsSize) const; + CachedLabel *createCachedLabel(const LabelData &labelData) const; + QByteArray cacheKey(const QString &text, const QColor &color, double rotation, AnchorSide side) const; + AnchorSide skewedAnchorSide(const QPointF &tickPos, double sideExpandHorz, double sideExpandVert) const; + AnchorSide rotationCorrectedSide(AnchorSide side, double rotation) const; + void analyzeFontMetrics(); +}; +Q_DECLARE_METATYPE(QCPLabelPainterPrivate::AnchorMode) +Q_DECLARE_METATYPE(QCPLabelPainterPrivate::AnchorSide) + + +/* end of 'src/axis/labelpainter.h' */ + + +/* including file 'src/axis/axisticker.h' */ +/* modified 2021-03-29T02:30:44, size 4230 */ + +class QCP_LIB_DECL QCPAxisTicker +{ + Q_GADGET +public: + /*! + Defines the strategies that the axis ticker may follow when choosing the size of the tick step. + + \see setTickStepStrategy + */ + enum TickStepStrategy + { + tssReadability ///< A nicely readable tick step is prioritized over matching the requested number of ticks (see \ref setTickCount) + ,tssMeetTickCount ///< Less readable tick steps are allowed which in turn facilitates getting closer to the requested tick count + }; + Q_ENUMS(TickStepStrategy) + + QCPAxisTicker(); + virtual ~QCPAxisTicker(); + + // getters: + TickStepStrategy tickStepStrategy() const { return mTickStepStrategy; } + int tickCount() const { return mTickCount; } + double tickOrigin() const { return mTickOrigin; } + + // setters: + void setTickStepStrategy(TickStepStrategy strategy); + void setTickCount(int count); + void setTickOrigin(double origin); + + // introduced virtual methods: + virtual void generate(const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector &ticks, QVector *subTicks, QVector *tickLabels); + +protected: + // property members: + TickStepStrategy mTickStepStrategy; + int mTickCount; + double mTickOrigin; + + // introduced virtual methods: + virtual double getTickStep(const QCPRange &range); + virtual int getSubTickCount(double tickStep); + virtual QString getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision); + virtual QVector createTickVector(double tickStep, const QCPRange &range); + virtual QVector createSubTickVector(int subTickCount, const QVector &ticks); + virtual QVector createLabelVector(const QVector &ticks, const QLocale &locale, QChar formatChar, int precision); + + // non-virtual methods: + void trimTicks(const QCPRange &range, QVector &ticks, bool keepOneOutlier) const; + double pickClosest(double target, const QVector &candidates) const; + double getMantissa(double input, double *magnitude=nullptr) const; + double cleanMantissa(double input) const; + +private: + Q_DISABLE_COPY(QCPAxisTicker) + +}; +Q_DECLARE_METATYPE(QCPAxisTicker::TickStepStrategy) +Q_DECLARE_METATYPE(QSharedPointer) + +/* end of 'src/axis/axisticker.h' */ + + +/* including file 'src/axis/axistickerdatetime.h' */ +/* modified 2021-03-29T02:30:44, size 3600 */ + +class QCP_LIB_DECL QCPAxisTickerDateTime : public QCPAxisTicker +{ +public: + QCPAxisTickerDateTime(); + + // getters: + QString dateTimeFormat() const { return mDateTimeFormat; } + Qt::TimeSpec dateTimeSpec() const { return mDateTimeSpec; } +# if QT_VERSION >= QT_VERSION_CHECK(5, 2, 0) + QTimeZone timeZone() const { return mTimeZone; } +#endif + + // setters: + void setDateTimeFormat(const QString &format); + void setDateTimeSpec(Qt::TimeSpec spec); +# if QT_VERSION >= QT_VERSION_CHECK(5, 2, 0) + void setTimeZone(const QTimeZone &zone); +# endif + void setTickOrigin(double origin); // hides base class method but calls baseclass implementation ("using" throws off IDEs and doxygen) + void setTickOrigin(const QDateTime &origin); + + // static methods: + static QDateTime keyToDateTime(double key); + static double dateTimeToKey(const QDateTime &dateTime); + static double dateTimeToKey(const QDate &date, Qt::TimeSpec timeSpec=Qt::LocalTime); + +protected: + // property members: + QString mDateTimeFormat; + Qt::TimeSpec mDateTimeSpec; +# if QT_VERSION >= QT_VERSION_CHECK(5, 2, 0) + QTimeZone mTimeZone; +# endif + // non-property members: + enum DateStrategy {dsNone, dsUniformTimeInDay, dsUniformDayInMonth} mDateStrategy; + + // reimplemented virtual methods: + virtual double getTickStep(const QCPRange &range) Q_DECL_OVERRIDE; + virtual int getSubTickCount(double tickStep) Q_DECL_OVERRIDE; + virtual QString getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE; + virtual QVector createTickVector(double tickStep, const QCPRange &range) Q_DECL_OVERRIDE; +}; + +/* end of 'src/axis/axistickerdatetime.h' */ + + +/* including file 'src/axis/axistickertime.h' */ +/* modified 2021-03-29T02:30:44, size 3542 */ + +class QCP_LIB_DECL QCPAxisTickerTime : public QCPAxisTicker +{ + Q_GADGET +public: + /*! + Defines the logical units in which fractions of time spans can be expressed. + + \see setFieldWidth, setTimeFormat + */ + enum TimeUnit { tuMilliseconds ///< Milliseconds, one thousandth of a second (%%z in \ref setTimeFormat) + ,tuSeconds ///< Seconds (%%s in \ref setTimeFormat) + ,tuMinutes ///< Minutes (%%m in \ref setTimeFormat) + ,tuHours ///< Hours (%%h in \ref setTimeFormat) + ,tuDays ///< Days (%%d in \ref setTimeFormat) + }; + Q_ENUMS(TimeUnit) + + QCPAxisTickerTime(); + + // getters: + QString timeFormat() const { return mTimeFormat; } + int fieldWidth(TimeUnit unit) const { return mFieldWidth.value(unit); } + + // setters: + void setTimeFormat(const QString &format); + void setFieldWidth(TimeUnit unit, int width); + +protected: + // property members: + QString mTimeFormat; + QHash mFieldWidth; + + // non-property members: + TimeUnit mSmallestUnit, mBiggestUnit; + QHash mFormatPattern; + + // reimplemented virtual methods: + virtual double getTickStep(const QCPRange &range) Q_DECL_OVERRIDE; + virtual int getSubTickCount(double tickStep) Q_DECL_OVERRIDE; + virtual QString getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE; + + // non-virtual methods: + void replaceUnit(QString &text, TimeUnit unit, int value) const; +}; +Q_DECLARE_METATYPE(QCPAxisTickerTime::TimeUnit) + +/* end of 'src/axis/axistickertime.h' */ + + +/* including file 'src/axis/axistickerfixed.h' */ +/* modified 2021-03-29T02:30:44, size 3308 */ + +class QCP_LIB_DECL QCPAxisTickerFixed : public QCPAxisTicker +{ + Q_GADGET +public: + /*! + Defines how the axis ticker may modify the specified tick step (\ref setTickStep) in order to + control the number of ticks in the axis range. + + \see setScaleStrategy + */ + enum ScaleStrategy { ssNone ///< Modifications are not allowed, the specified tick step is absolutely fixed. This might cause a high tick density and overlapping labels if the axis range is zoomed out. + ,ssMultiples ///< An integer multiple of the specified tick step is allowed. The used factor follows the base class properties of \ref setTickStepStrategy and \ref setTickCount. + ,ssPowers ///< An integer power of the specified tick step is allowed. + }; + Q_ENUMS(ScaleStrategy) + + QCPAxisTickerFixed(); + + // getters: + double tickStep() const { return mTickStep; } + ScaleStrategy scaleStrategy() const { return mScaleStrategy; } + + // setters: + void setTickStep(double step); + void setScaleStrategy(ScaleStrategy strategy); + +protected: + // property members: + double mTickStep; + ScaleStrategy mScaleStrategy; + + // reimplemented virtual methods: + virtual double getTickStep(const QCPRange &range) Q_DECL_OVERRIDE; +}; +Q_DECLARE_METATYPE(QCPAxisTickerFixed::ScaleStrategy) + +/* end of 'src/axis/axistickerfixed.h' */ + + +/* including file 'src/axis/axistickertext.h' */ +/* modified 2021-03-29T02:30:44, size 3090 */ + +class QCP_LIB_DECL QCPAxisTickerText : public QCPAxisTicker +{ +public: + QCPAxisTickerText(); + + // getters: + QMap &ticks() { return mTicks; } + int subTickCount() const { return mSubTickCount; } + + // setters: + void setTicks(const QMap &ticks); + void setTicks(const QVector &positions, const QVector &labels); + void setSubTickCount(int subTicks); + + // non-virtual methods: + void clear(); + void addTick(double position, const QString &label); + void addTicks(const QMap &ticks); + void addTicks(const QVector &positions, const QVector &labels); + +protected: + // property members: + QMap mTicks; + int mSubTickCount; + + // reimplemented virtual methods: + virtual double getTickStep(const QCPRange &range) Q_DECL_OVERRIDE; + virtual int getSubTickCount(double tickStep) Q_DECL_OVERRIDE; + virtual QString getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE; + virtual QVector createTickVector(double tickStep, const QCPRange &range) Q_DECL_OVERRIDE; +}; + +/* end of 'src/axis/axistickertext.h' */ + + +/* including file 'src/axis/axistickerpi.h' */ +/* modified 2021-03-29T02:30:44, size 3911 */ + +class QCP_LIB_DECL QCPAxisTickerPi : public QCPAxisTicker +{ + Q_GADGET +public: + /*! + Defines how fractions should be displayed in tick labels. + + \see setFractionStyle + */ + enum FractionStyle { fsFloatingPoint ///< Fractions are displayed as regular decimal floating point numbers, e.g. "0.25" or "0.125". + ,fsAsciiFractions ///< Fractions are written as rationals using ASCII characters only, e.g. "1/4" or "1/8" + ,fsUnicodeFractions ///< Fractions are written using sub- and superscript UTF-8 digits and the fraction symbol. + }; + Q_ENUMS(FractionStyle) + + QCPAxisTickerPi(); + + // getters: + QString piSymbol() const { return mPiSymbol; } + double piValue() const { return mPiValue; } + bool periodicity() const { return mPeriodicity; } + FractionStyle fractionStyle() const { return mFractionStyle; } + + // setters: + void setPiSymbol(QString symbol); + void setPiValue(double pi); + void setPeriodicity(int multiplesOfPi); + void setFractionStyle(FractionStyle style); + +protected: + // property members: + QString mPiSymbol; + double mPiValue; + int mPeriodicity; + FractionStyle mFractionStyle; + + // non-property members: + double mPiTickStep; // size of one tick step in units of mPiValue + + // reimplemented virtual methods: + virtual double getTickStep(const QCPRange &range) Q_DECL_OVERRIDE; + virtual int getSubTickCount(double tickStep) Q_DECL_OVERRIDE; + virtual QString getTickLabel(double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE; + + // non-virtual methods: + void simplifyFraction(int &numerator, int &denominator) const; + QString fractionToString(int numerator, int denominator) const; + QString unicodeFraction(int numerator, int denominator) const; + QString unicodeSuperscript(int number) const; + QString unicodeSubscript(int number) const; +}; +Q_DECLARE_METATYPE(QCPAxisTickerPi::FractionStyle) + +/* end of 'src/axis/axistickerpi.h' */ + + +/* including file 'src/axis/axistickerlog.h' */ +/* modified 2021-03-29T02:30:44, size 2594 */ + +class QCP_LIB_DECL QCPAxisTickerLog : public QCPAxisTicker +{ +public: + QCPAxisTickerLog(); + + // getters: + double logBase() const { return mLogBase; } + int subTickCount() const { return mSubTickCount; } + + // setters: + void setLogBase(double base); + void setSubTickCount(int subTicks); + +protected: + // property members: + double mLogBase; + int mSubTickCount; + + // non-property members: + double mLogBaseLnInv; + + // reimplemented virtual methods: + virtual int getSubTickCount(double tickStep) Q_DECL_OVERRIDE; + virtual QVector createTickVector(double tickStep, const QCPRange &range) Q_DECL_OVERRIDE; +}; + +/* end of 'src/axis/axistickerlog.h' */ + + +/* including file 'src/axis/axis.h' */ +/* modified 2021-03-29T02:30:44, size 20913 */ + +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: + explicit 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 Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + + // 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(QCPRange range READ range WRITE setRange NOTIFY rangeChanged) + Q_PROPERTY(bool rangeReversed READ rangeReversed WRITE setRangeReversed) + Q_PROPERTY(QSharedPointer ticker READ ticker WRITE setTicker) + 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(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 numberFormat READ numberFormat WRITE setNumberFormat) + Q_PROPERTY(int numberPrecision READ numberPrecision WRITE setNumberPrecision) + Q_PROPERTY(QVector tickVector READ tickVector) + Q_PROPERTY(QVector tickVectorLabels READ tickVectorLabels) + Q_PROPERTY(int tickLengthIn READ tickLengthIn WRITE setTickLengthIn) + Q_PROPERTY(int tickLengthOut READ tickLengthOut WRITE setTickLengthOut) + Q_PROPERTY(bool subTicks READ subTicks WRITE setSubTicks) + 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 ///< 0x01 Axis is vertical and on the left side of the axis rect + ,atRight = 0x02 ///< 0x02 Axis is vertical and on the right side of the axis rect + ,atTop = 0x04 ///< 0x04 Axis is horizontal and on the top side of the axis rect + ,atBottom = 0x08 ///< 0x08 Axis is horizontal and on the bottom side of the axis rect + }; + Q_ENUMS(AxisType) + Q_FLAGS(AxisTypes) + Q_DECLARE_FLAGS(AxisTypes, AxisType) + /*! + 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 axis coordinates (possibly also \ref setTicker to a \ref QCPAxisTickerLog instance). + }; + 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_ENUMS(SelectablePart) + Q_FLAGS(SelectableParts) + Q_DECLARE_FLAGS(SelectableParts, SelectablePart) + + explicit QCPAxis(QCPAxisRect *parent, AxisType type); + virtual ~QCPAxis() Q_DECL_OVERRIDE; + + // getters: + AxisType axisType() const { return mAxisType; } + QCPAxisRect *axisRect() const { return mAxisRect; } + ScaleType scaleType() const { return mScaleType; } + const QCPRange range() const { return mRange; } + bool rangeReversed() const { return mRangeReversed; } + QSharedPointer ticker() const { return mTicker; } + bool ticks() const { return mTicks; } + bool tickLabels() const { return mTickLabels; } + int tickLabelPadding() const; + QFont tickLabelFont() const { return mTickLabelFont; } + QColor tickLabelColor() const { return mTickLabelColor; } + double tickLabelRotation() const; + LabelSide tickLabelSide() const; + QString numberFormat() const; + int numberPrecision() const { return mNumberPrecision; } + QVector tickVector() const { return mTickVector; } + QVector tickVectorLabels() const { return mTickVectorLabels; } + int tickLengthIn() const; + int tickLengthOut() const; + bool subTicks() const { return mSubTicks; } + 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); + 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 setTicker(QSharedPointer ticker); + void setTicks(bool show); + void setTickLabels(bool show); + void setTickLabelPadding(int padding); + void setTickLabelFont(const QFont &font); + void setTickLabelColor(const QColor &color); + void setTickLabelRotation(double degrees); + void setTickLabelSide(LabelSide side); + void setNumberFormat(const QString &formatCode); + void setNumberPrecision(int precision); + void setTickLength(int inside, int outside=0); + void setTickLengthIn(int inside); + void setTickLengthOut(int outside); + void setSubTicks(bool show); + 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=nullptr) const Q_DECL_OVERRIDE; + + // non-property methods: + Qt::Orientation orientation() const { return mOrientation; } + int pixelOrientation() const { return rangeReversed() != (orientation()==Qt::Vertical) ? -1 : 1; } + void moveRange(double diff); + void scaleRange(double factor); + 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 plottables() const; + QList graphs() const; + QList 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 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; + //double mTickLabelRotation; // in QCPAxisPainter + QFont mTickLabelFont, mSelectedTickLabelFont; + QColor mTickLabelColor, mSelectedTickLabelColor; + int mNumberPrecision; + QLatin1Char mNumberFormatChar; + bool mNumberBeautifulPowers; + //bool mNumberMultiplyCross; // QCPAxisPainter + // ticks and subticks: + bool mTicks; + bool mSubTicks; + //int mTickLengthIn, mTickLengthOut, mSubTickLengthIn, mSubTickLengthOut; // QCPAxisPainter + QPen mTickPen, mSelectedTickPen; + QPen mSubTickPen, mSelectedSubTickPen; + // scale and range: + QCPRange mRange; + bool mRangeReversed; + ScaleType mScaleType; + + // non-property members: + QCPGrid *mGrid; + QCPAxisPainterPrivate *mAxisPainter; + QSharedPointer mTicker; + QVector mTickVector; + QVector mTickVectorLabels; + QVector mSubTickVector; + bool mCachedMarginValid; + int mCachedMargin; + bool mDragging; + QCPRange mDragStartRange; + QCP::AntialiasedElements mAADragBackup, mNotAADragBackup; + + // introduced virtual methods: + virtual int calculateMargin(); + + // reimplemented virtual methods: + virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual QCP::Interaction selectionCategory() const Q_DECL_OVERRIDE; + // events: + virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE; + virtual void deselectEvent(bool *selectionStateChanged) Q_DECL_OVERRIDE; + // mouse events: + virtual void mousePressEvent(QMouseEvent *event, const QVariant &details) Q_DECL_OVERRIDE; + virtual void mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; + virtual void mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; + virtual void wheelEvent(QWheelEvent *event) Q_DECL_OVERRIDE; + + // non-virtual methods: + void setupTickVectors(); + 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::AxisType) +Q_DECLARE_METATYPE(QCPAxis::LabelSide) +Q_DECLARE_METATYPE(QCPAxis::ScaleType) +Q_DECLARE_METATYPE(QCPAxis::SelectablePart) + + +class QCPAxisPainterPrivate +{ +public: + explicit QCPAxisPainterPrivate(QCustomPlot *parentPlot); + virtual ~QCPAxisPainterPrivate(); + + virtual void draw(QCPPainter *painter); + virtual int size(); + 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; + int offset; // directly accessed by QCPAxis setters/getters + bool abbreviateDecimalPowers; + bool reversedEndings; + + QVector subTickPositions; + QVector tickPositions; + QVector tickLabels; + +protected: + struct CachedLabel + { + QPointF offset; + QPixmap pixmap; + }; + struct TickLabelData + { + QString basePart, expPart, suffixPart; + QRect baseBounds, expBounds, suffixBounds, totalBounds, rotatedTotalBounds; + QFont baseFont, expFont; + }; + QCustomPlot *mParentPlot; + QByteArray mLabelParameterHash; // to determine whether mLabelCache needs to be cleared due to changed parameters + QCache 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; +}; + +/* end of 'src/axis/axis.h' */ + + +/* including file 'src/scatterstyle.h' */ +/* modified 2021-03-29T02:30:44, size 7275 */ + +class QCP_LIB_DECL QCPScatterStyle +{ + Q_GADGET +public: + /*! + Represents the various properties of a scatter style instance. For example, this enum is used + to specify which properties of \ref QCPSelectionDecorator::setScatterStyle will be used when + highlighting selected data points. + + Specific scatter properties can be transferred between \ref QCPScatterStyle instances via \ref + setFromOther. + */ + enum ScatterProperty { spNone = 0x00 ///< 0x00 None + ,spPen = 0x01 ///< 0x01 The pen property, see \ref setPen + ,spBrush = 0x02 ///< 0x02 The brush property, see \ref setBrush + ,spSize = 0x04 ///< 0x04 The size property, see \ref setSize + ,spShape = 0x08 ///< 0x08 The shape property, see \ref setShape + ,spAll = 0xFF ///< 0xFF All properties + }; + Q_ENUMS(ScatterProperty) + Q_FLAGS(ScatterProperties) + Q_DECLARE_FLAGS(ScatterProperties, ScatterProperty) + + /*! + 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. + */ + 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) + }; + Q_ENUMS(ScatterShape) + + 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 setFromOther(const QCPScatterStyle &other, ScatterProperties properties); + 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 undefinePen(); + void applyTo(QCPPainter *painter, const QPen &defaultPen) const; + void drawShape(QCPPainter *painter, const 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); +Q_DECLARE_OPERATORS_FOR_FLAGS(QCPScatterStyle::ScatterProperties) +Q_DECLARE_METATYPE(QCPScatterStyle::ScatterProperty) +Q_DECLARE_METATYPE(QCPScatterStyle::ScatterShape) + +/* end of 'src/scatterstyle.h' */ + + +/* including file 'src/datacontainer.h' */ +/* modified 2021-03-29T02:30:44, size 34070 */ + +/*! \relates QCPDataContainer + Returns whether the sort key of \a a is less than the sort key of \a b. + + \see QCPDataContainer::sort +*/ +template +inline bool qcpLessThanSortKey(const DataType &a, const DataType &b) { return a.sortKey() < b.sortKey(); } + +template +class QCPDataContainer // no QCP_LIB_DECL, template class ends up in header (cpp included below) +{ +public: + typedef typename QVector::const_iterator const_iterator; + typedef typename QVector::iterator iterator; + + QCPDataContainer(); + + // getters: + int size() const { return mData.size()-mPreallocSize; } + bool isEmpty() const { return size() == 0; } + bool autoSqueeze() const { return mAutoSqueeze; } + + // setters: + void setAutoSqueeze(bool enabled); + + // non-virtual methods: + void set(const QCPDataContainer &data); + void set(const QVector &data, bool alreadySorted=false); + void add(const QCPDataContainer &data); + void add(const QVector &data, bool alreadySorted=false); + void add(const DataType &data); + void removeBefore(double sortKey); + void removeAfter(double sortKey); + void remove(double sortKeyFrom, double sortKeyTo); + void remove(double sortKey); + void clear(); + void sort(); + void squeeze(bool preAllocation=true, bool postAllocation=true); + + const_iterator constBegin() const { return mData.constBegin()+mPreallocSize; } + const_iterator constEnd() const { return mData.constEnd(); } + iterator begin() { return mData.begin()+mPreallocSize; } + iterator end() { return mData.end(); } + const_iterator findBegin(double sortKey, bool expandedRange=true) const; + const_iterator findEnd(double sortKey, bool expandedRange=true) const; + const_iterator at(int index) const { return constBegin()+qBound(0, index, size()); } + QCPRange keyRange(bool &foundRange, QCP::SignDomain signDomain=QCP::sdBoth); + QCPRange valueRange(bool &foundRange, QCP::SignDomain signDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()); + QCPDataRange dataRange() const { return QCPDataRange(0, size()); } + void limitIteratorsToDataRange(const_iterator &begin, const_iterator &end, const QCPDataRange &dataRange) const; + +protected: + // property members: + bool mAutoSqueeze; + + // non-property memebers: + QVector mData; + int mPreallocSize; + int mPreallocIteration; + + // non-virtual methods: + void preallocateGrow(int minimumPreallocSize); + void performAutoSqueeze(); +}; + + + +// include implementation in header since it is a class template: +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPDataContainer +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPDataContainer + \brief The generic data container for one-dimensional plottables + + This class template provides a fast container for data storage of one-dimensional data. The data + type is specified as template parameter (called \a DataType in the following) and must provide + some methods as described in the \ref qcpdatacontainer-datatype "next section". + + The data is stored in a sorted fashion, which allows very quick lookups by the sorted key as well + as retrieval of ranges (see \ref findBegin, \ref findEnd, \ref keyRange) using binary search. The + container uses a preallocation and a postallocation scheme, such that appending and prepending + data (with respect to the sort key) is very fast and minimizes reallocations. If data is added + which needs to be inserted between existing keys, the merge usually can be done quickly too, + using the fact that existing data is always sorted. The user can further improve performance by + specifying that added data is already itself sorted by key, if he can guarantee that this is the + case (see for example \ref add(const QVector &data, bool alreadySorted)). + + The data can be accessed with the provided const iterators (\ref constBegin, \ref constEnd). If + it is necessary to alter existing data in-place, the non-const iterators can be used (\ref begin, + \ref end). Changing data members that are not the sort key (for most data types called \a key) is + safe from the container's perspective. + + Great care must be taken however if the sort key is modified through the non-const iterators. For + performance reasons, the iterators don't automatically cause a re-sorting upon their + manipulation. It is thus the responsibility of the user to leave the container in a sorted state + when finished with the data manipulation, before calling any other methods on the container. A + complete re-sort (e.g. after finishing all sort key manipulation) can be done by calling \ref + sort. Failing to do so can not be detected by the container efficiently and will cause both + rendering artifacts and potential data loss. + + Implementing one-dimensional plottables that make use of a \ref QCPDataContainer is usually + done by subclassing from \ref QCPAbstractPlottable1D "QCPAbstractPlottable1D", which + introduces an according \a mDataContainer member and some convenience methods. + + \section qcpdatacontainer-datatype Requirements for the DataType template parameter + + The template parameter DataType is the type of the stored data points. It must be + trivially copyable and have the following public methods, preferably inline: + + \li double sortKey() const\n Returns the member variable of this data point that is the + sort key, defining the ordering in the container. Often this variable is simply called \a key. + + \li static DataType fromSortKey(double sortKey)\n Returns a new instance of the data + type initialized with its sort key set to \a sortKey. + + \li static bool sortKeyIsMainKey()\n Returns true if the sort key is equal to the main + key (see method \c mainKey below). For most plottables this is the case. It is not the case for + example for \ref QCPCurve, which uses \a t as sort key and \a key as main key. This is the reason + why QCPCurve unlike QCPGraph can display parametric curves with loops. + + \li double mainKey() const\n Returns the variable of this data point considered the main + key. This is commonly the variable that is used as the coordinate of this data point on the key + axis of the plottable. This method is used for example when determining the automatic axis + rescaling of key axes (\ref QCPAxis::rescale). + + \li double mainValue() const\n Returns the variable of this data point considered the + main value. This is commonly the variable that is used as the coordinate of this data point on + the value axis of the plottable. + + \li QCPRange valueRange() const\n Returns the range this data point spans in the value + axis coordinate. If the data is single-valued (e.g. QCPGraphData), this is simply a range with + both lower and upper set to the main data point value. However if the data points can represent + multiple values at once (e.g QCPFinancialData with its \a high, \a low, \a open and \a close + values at each \a key) this method should return the range those values span. This method is used + for example when determining the automatic axis rescaling of value axes (\ref + QCPAxis::rescale). +*/ + +/* start documentation of inline functions */ + +/*! \fn int QCPDataContainer::size() const + + Returns the number of data points in the container. +*/ + +/*! \fn bool QCPDataContainer::isEmpty() const + + Returns whether this container holds no data points. +*/ + +/*! \fn QCPDataContainer::const_iterator QCPDataContainer::constBegin() const + + Returns a const iterator to the first data point in this container. +*/ + +/*! \fn QCPDataContainer::const_iterator QCPDataContainer::constEnd() const + + Returns a const iterator to the element past the last data point in this container. +*/ + +/*! \fn QCPDataContainer::iterator QCPDataContainer::begin() const + + Returns a non-const iterator to the first data point in this container. + + You can manipulate the data points in-place through the non-const iterators, but great care must + be taken when manipulating the sort key of a data point, see \ref sort, or the detailed + description of this class. +*/ + +/*! \fn QCPDataContainer::iterator QCPDataContainer::end() const + + Returns a non-const iterator to the element past the last data point in this container. + + You can manipulate the data points in-place through the non-const iterators, but great care must + be taken when manipulating the sort key of a data point, see \ref sort, or the detailed + description of this class. +*/ + +/*! \fn QCPDataContainer::const_iterator QCPDataContainer::at(int index) const + + Returns a const iterator to the element with the specified \a index. If \a index points beyond + the available elements in this container, returns \ref constEnd, i.e. an iterator past the last + valid element. + + You can use this method to easily obtain iterators from a \ref QCPDataRange, see the \ref + dataselection-accessing "data selection page" for an example. +*/ + +/*! \fn QCPDataRange QCPDataContainer::dataRange() const + + Returns a \ref QCPDataRange encompassing the entire data set of this container. This means the + begin index of the returned range is 0, and the end index is \ref size. +*/ + +/* end documentation of inline functions */ + +/*! + Constructs a QCPDataContainer used for plottable classes that represent a series of key-sorted + data +*/ +template +QCPDataContainer::QCPDataContainer() : + mAutoSqueeze(true), + mPreallocSize(0), + mPreallocIteration(0) +{ +} + +/*! + Sets whether the container automatically decides when to release memory from its post- and + preallocation pools when data points are removed. By default this is enabled and for typical + applications shouldn't be changed. + + If auto squeeze is disabled, you can manually decide when to release pre-/postallocation with + \ref squeeze. +*/ +template +void QCPDataContainer::setAutoSqueeze(bool enabled) +{ + if (mAutoSqueeze != enabled) + { + mAutoSqueeze = enabled; + if (mAutoSqueeze) + performAutoSqueeze(); + } +} + +/*! \overload + + Replaces the current data in this container with the provided \a data. + + \see add, remove +*/ +template +void QCPDataContainer::set(const QCPDataContainer &data) +{ + clear(); + add(data); +} + +/*! \overload + + Replaces the current data in this container with the provided \a data + + If you can guarantee that the data points in \a data have ascending order with respect to the + DataType's sort key, set \a alreadySorted to true to avoid an unnecessary sorting run. + + \see add, remove +*/ +template +void QCPDataContainer::set(const QVector &data, bool alreadySorted) +{ + mData = data; + mPreallocSize = 0; + mPreallocIteration = 0; + if (!alreadySorted) + sort(); +} + +/*! \overload + + Adds the provided \a data to the current data in this container. + + \see set, remove +*/ +template +void QCPDataContainer::add(const QCPDataContainer &data) +{ + if (data.isEmpty()) + return; + + const int n = data.size(); + const int oldSize = size(); + + if (oldSize > 0 && !qcpLessThanSortKey(*constBegin(), *(data.constEnd()-1))) // prepend if new data keys are all smaller than or equal to existing ones + { + if (mPreallocSize < n) + preallocateGrow(n); + mPreallocSize -= n; + std::copy(data.constBegin(), data.constEnd(), begin()); + } else // don't need to prepend, so append and merge if necessary + { + mData.resize(mData.size()+n); + std::copy(data.constBegin(), data.constEnd(), end()-n); + if (oldSize > 0 && !qcpLessThanSortKey(*(constEnd()-n-1), *(constEnd()-n))) // if appended range keys aren't all greater than existing ones, merge the two partitions + std::inplace_merge(begin(), end()-n, end(), qcpLessThanSortKey); + } +} + +/*! + Adds the provided data points in \a data to the current data. + + If you can guarantee that the data points in \a data have ascending order with respect to the + DataType's sort key, set \a alreadySorted to true to avoid an unnecessary sorting run. + + \see set, remove +*/ +template +void QCPDataContainer::add(const QVector &data, bool alreadySorted) +{ + if (data.isEmpty()) + return; + if (isEmpty()) + { + set(data, alreadySorted); + return; + } + + const int n = data.size(); + const int oldSize = size(); + + if (alreadySorted && oldSize > 0 && !qcpLessThanSortKey(*constBegin(), *(data.constEnd()-1))) // prepend if new data is sorted and keys are all smaller than or equal to existing ones + { + if (mPreallocSize < n) + preallocateGrow(n); + mPreallocSize -= n; + std::copy(data.constBegin(), data.constEnd(), begin()); + } else // don't need to prepend, so append and then sort and merge if necessary + { + mData.resize(mData.size()+n); + std::copy(data.constBegin(), data.constEnd(), end()-n); + if (!alreadySorted) // sort appended subrange if it wasn't already sorted + std::sort(end()-n, end(), qcpLessThanSortKey); + if (oldSize > 0 && !qcpLessThanSortKey(*(constEnd()-n-1), *(constEnd()-n))) // if appended range keys aren't all greater than existing ones, merge the two partitions + std::inplace_merge(begin(), end()-n, end(), qcpLessThanSortKey); + } +} + +/*! \overload + + Adds the provided single data point to the current data. + + \see remove +*/ +template +void QCPDataContainer::add(const DataType &data) +{ + if (isEmpty() || !qcpLessThanSortKey(data, *(constEnd()-1))) // quickly handle appends if new data key is greater or equal to existing ones + { + mData.append(data); + } else if (qcpLessThanSortKey(data, *constBegin())) // quickly handle prepends using preallocated space + { + if (mPreallocSize < 1) + preallocateGrow(1); + --mPreallocSize; + *begin() = data; + } else // handle inserts, maintaining sorted keys + { + QCPDataContainer::iterator insertionPoint = std::lower_bound(begin(), end(), data, qcpLessThanSortKey); + mData.insert(insertionPoint, data); + } +} + +/*! + Removes all data points with (sort-)keys smaller than or equal to \a sortKey. + + \see removeAfter, remove, clear +*/ +template +void QCPDataContainer::removeBefore(double sortKey) +{ + QCPDataContainer::iterator it = begin(); + QCPDataContainer::iterator itEnd = std::lower_bound(begin(), end(), DataType::fromSortKey(sortKey), qcpLessThanSortKey); + mPreallocSize += int(itEnd-it); // don't actually delete, just add it to the preallocated block (if it gets too large, squeeze will take care of it) + if (mAutoSqueeze) + performAutoSqueeze(); +} + +/*! + Removes all data points with (sort-)keys greater than or equal to \a sortKey. + + \see removeBefore, remove, clear +*/ +template +void QCPDataContainer::removeAfter(double sortKey) +{ + QCPDataContainer::iterator it = std::upper_bound(begin(), end(), DataType::fromSortKey(sortKey), qcpLessThanSortKey); + QCPDataContainer::iterator itEnd = end(); + mData.erase(it, itEnd); // typically adds it to the postallocated block + if (mAutoSqueeze) + performAutoSqueeze(); +} + +/*! + Removes all data points with (sort-)keys between \a sortKeyFrom and \a sortKeyTo. if \a + sortKeyFrom is greater or equal to \a sortKeyTo, the function does nothing. To remove a single + data point with known (sort-)key, use \ref remove(double sortKey). + + \see removeBefore, removeAfter, clear +*/ +template +void QCPDataContainer::remove(double sortKeyFrom, double sortKeyTo) +{ + if (sortKeyFrom >= sortKeyTo || isEmpty()) + return; + + QCPDataContainer::iterator it = std::lower_bound(begin(), end(), DataType::fromSortKey(sortKeyFrom), qcpLessThanSortKey); + QCPDataContainer::iterator itEnd = std::upper_bound(it, end(), DataType::fromSortKey(sortKeyTo), qcpLessThanSortKey); + mData.erase(it, itEnd); + if (mAutoSqueeze) + performAutoSqueeze(); +} + +/*! \overload + + Removes a single data point at \a sortKey. If the position is not known with absolute (binary) + precision, consider using \ref remove(double sortKeyFrom, double sortKeyTo) with a small + fuzziness interval around the suspected position, depeding on the precision with which the + (sort-)key is known. + + \see removeBefore, removeAfter, clear +*/ +template +void QCPDataContainer::remove(double sortKey) +{ + QCPDataContainer::iterator it = std::lower_bound(begin(), end(), DataType::fromSortKey(sortKey), qcpLessThanSortKey); + if (it != end() && it->sortKey() == sortKey) + { + if (it == begin()) + ++mPreallocSize; // don't actually delete, just add it to the preallocated block (if it gets too large, squeeze will take care of it) + else + mData.erase(it); + } + if (mAutoSqueeze) + performAutoSqueeze(); +} + +/*! + Removes all data points. + + \see remove, removeAfter, removeBefore +*/ +template +void QCPDataContainer::clear() +{ + mData.clear(); + mPreallocIteration = 0; + mPreallocSize = 0; +} + +/*! + Re-sorts all data points in the container by their sort key. + + When setting, adding or removing points using the QCPDataContainer interface (\ref set, \ref add, + \ref remove, etc.), the container makes sure to always stay in a sorted state such that a full + resort is never necessary. However, if you choose to directly manipulate the sort key on data + points by accessing and modifying it through the non-const iterators (\ref begin, \ref end), it + is your responsibility to bring the container back into a sorted state before any other methods + are called on it. This can be achieved by calling this method immediately after finishing the + sort key manipulation. +*/ +template +void QCPDataContainer::sort() +{ + std::sort(begin(), end(), qcpLessThanSortKey); +} + +/*! + Frees all unused memory that is currently in the preallocation and postallocation pools. + + Note that QCPDataContainer automatically decides whether squeezing is necessary, if \ref + setAutoSqueeze is left enabled. It should thus not be necessary to use this method for typical + applications. + + The parameters \a preAllocation and \a postAllocation control whether pre- and/or post allocation + should be freed, respectively. +*/ +template +void QCPDataContainer::squeeze(bool preAllocation, bool postAllocation) +{ + if (preAllocation) + { + if (mPreallocSize > 0) + { + std::copy(begin(), end(), mData.begin()); + mData.resize(size()); + mPreallocSize = 0; + } + mPreallocIteration = 0; + } + if (postAllocation) + mData.squeeze(); +} + +/*! + Returns an iterator to the data point with a (sort-)key that is equal to, just below, or just + above \a sortKey. If \a expandedRange is true, the data point just below \a sortKey will be + considered, otherwise the one just above. + + This can be used in conjunction with \ref findEnd to iterate over data points within a given key + range, including or excluding the bounding data points that are just beyond the specified range. + + If \a expandedRange is true but there are no data points below \a sortKey, \ref constBegin is + returned. + + If the container is empty, returns \ref constEnd. + + \see findEnd, QCPPlottableInterface1D::findBegin +*/ +template +typename QCPDataContainer::const_iterator QCPDataContainer::findBegin(double sortKey, bool expandedRange) const +{ + if (isEmpty()) + return constEnd(); + + QCPDataContainer::const_iterator it = std::lower_bound(constBegin(), constEnd(), DataType::fromSortKey(sortKey), qcpLessThanSortKey); + if (expandedRange && it != constBegin()) // also covers it == constEnd case, and we know --constEnd is valid because mData isn't empty + --it; + return it; +} + +/*! + Returns an iterator to the element after the data point with a (sort-)key that is equal to, just + above or just below \a sortKey. If \a expandedRange is true, the data point just above \a sortKey + will be considered, otherwise the one just below. + + This can be used in conjunction with \ref findBegin to iterate over data points within a given + key range, including the bounding data points that are just below and above the specified range. + + If \a expandedRange is true but there are no data points above \a sortKey, \ref constEnd is + returned. + + If the container is empty, \ref constEnd is returned. + + \see findBegin, QCPPlottableInterface1D::findEnd +*/ +template +typename QCPDataContainer::const_iterator QCPDataContainer::findEnd(double sortKey, bool expandedRange) const +{ + if (isEmpty()) + return constEnd(); + + QCPDataContainer::const_iterator it = std::upper_bound(constBegin(), constEnd(), DataType::fromSortKey(sortKey), qcpLessThanSortKey); + if (expandedRange && it != constEnd()) + ++it; + return it; +} + +/*! + Returns the range encompassed by the (main-)key coordinate of all data points. The output + parameter \a foundRange indicates whether a sensible range was found. If this is false, you + should not use the returned QCPRange (e.g. the data container is empty or all points have the + same key). + + Use \a signDomain to control which sign of the key coordinates should be considered. This is + relevant e.g. for logarithmic plots which can mathematically only display one sign domain at a + time. + + If the DataType reports that its main key is equal to the sort key (\a sortKeyIsMainKey), as is + the case for most plottables, this method uses this fact and finds the range very quickly. + + \see valueRange +*/ +template +QCPRange QCPDataContainer::keyRange(bool &foundRange, QCP::SignDomain signDomain) +{ + if (isEmpty()) + { + foundRange = false; + return QCPRange(); + } + QCPRange range; + bool haveLower = false; + bool haveUpper = false; + double current; + + QCPDataContainer::const_iterator it = constBegin(); + QCPDataContainer::const_iterator itEnd = constEnd(); + if (signDomain == QCP::sdBoth) // range may be anywhere + { + if (DataType::sortKeyIsMainKey()) // if DataType is sorted by main key (e.g. QCPGraph, but not QCPCurve), use faster algorithm by finding just first and last key with non-NaN value + { + while (it != itEnd) // find first non-nan going up from left + { + if (!qIsNaN(it->mainValue())) + { + range.lower = it->mainKey(); + haveLower = true; + break; + } + ++it; + } + it = itEnd; + while (it != constBegin()) // find first non-nan going down from right + { + --it; + if (!qIsNaN(it->mainValue())) + { + range.upper = it->mainKey(); + haveUpper = true; + break; + } + } + } else // DataType is not sorted by main key, go through all data points and accordingly expand range + { + while (it != itEnd) + { + if (!qIsNaN(it->mainValue())) + { + current = it->mainKey(); + if (current < range.lower || !haveLower) + { + range.lower = current; + haveLower = true; + } + if (current > range.upper || !haveUpper) + { + range.upper = current; + haveUpper = true; + } + } + ++it; + } + } + } else if (signDomain == QCP::sdNegative) // range may only be in the negative sign domain + { + while (it != itEnd) + { + if (!qIsNaN(it->mainValue())) + { + current = it->mainKey(); + if ((current < range.lower || !haveLower) && current < 0) + { + range.lower = current; + haveLower = true; + } + if ((current > range.upper || !haveUpper) && current < 0) + { + range.upper = current; + haveUpper = true; + } + } + ++it; + } + } else if (signDomain == QCP::sdPositive) // range may only be in the positive sign domain + { + while (it != itEnd) + { + if (!qIsNaN(it->mainValue())) + { + current = it->mainKey(); + if ((current < range.lower || !haveLower) && current > 0) + { + range.lower = current; + haveLower = true; + } + if ((current > range.upper || !haveUpper) && current > 0) + { + range.upper = current; + haveUpper = true; + } + } + ++it; + } + } + + foundRange = haveLower && haveUpper; + return range; +} + +/*! + Returns the range encompassed by the value coordinates of the data points in the specified key + range (\a inKeyRange), using the full \a DataType::valueRange reported by the data points. The + output parameter \a foundRange indicates whether a sensible range was found. If this is false, + you should not use the returned QCPRange (e.g. the data container is empty or all points have the + same value). + + If \a inKeyRange has both lower and upper bound set to zero (is equal to QCPRange()), + all data points are considered, without any restriction on the keys. + + Use \a signDomain to control which sign of the value coordinates should be considered. This is + relevant e.g. for logarithmic plots which can mathematically only display one sign domain at a + time. + + \see keyRange +*/ +template +QCPRange QCPDataContainer::valueRange(bool &foundRange, QCP::SignDomain signDomain, const QCPRange &inKeyRange) +{ + if (isEmpty()) + { + foundRange = false; + return QCPRange(); + } + QCPRange range; + const bool restrictKeyRange = inKeyRange != QCPRange(); + bool haveLower = false; + bool haveUpper = false; + QCPRange current; + QCPDataContainer::const_iterator itBegin = constBegin(); + QCPDataContainer::const_iterator itEnd = constEnd(); + if (DataType::sortKeyIsMainKey() && restrictKeyRange) + { + itBegin = findBegin(inKeyRange.lower, false); + itEnd = findEnd(inKeyRange.upper, false); + } + if (signDomain == QCP::sdBoth) // range may be anywhere + { + for (QCPDataContainer::const_iterator it = itBegin; it != itEnd; ++it) + { + if (restrictKeyRange && (it->mainKey() < inKeyRange.lower || it->mainKey() > inKeyRange.upper)) + continue; + current = it->valueRange(); + if ((current.lower < range.lower || !haveLower) && !qIsNaN(current.lower)) + { + range.lower = current.lower; + haveLower = true; + } + if ((current.upper > range.upper || !haveUpper) && !qIsNaN(current.upper)) + { + range.upper = current.upper; + haveUpper = true; + } + } + } else if (signDomain == QCP::sdNegative) // range may only be in the negative sign domain + { + for (QCPDataContainer::const_iterator it = itBegin; it != itEnd; ++it) + { + if (restrictKeyRange && (it->mainKey() < inKeyRange.lower || it->mainKey() > inKeyRange.upper)) + continue; + current = it->valueRange(); + if ((current.lower < range.lower || !haveLower) && current.lower < 0 && !qIsNaN(current.lower)) + { + range.lower = current.lower; + haveLower = true; + } + if ((current.upper > range.upper || !haveUpper) && current.upper < 0 && !qIsNaN(current.upper)) + { + range.upper = current.upper; + haveUpper = true; + } + } + } else if (signDomain == QCP::sdPositive) // range may only be in the positive sign domain + { + for (QCPDataContainer::const_iterator it = itBegin; it != itEnd; ++it) + { + if (restrictKeyRange && (it->mainKey() < inKeyRange.lower || it->mainKey() > inKeyRange.upper)) + continue; + current = it->valueRange(); + if ((current.lower < range.lower || !haveLower) && current.lower > 0 && !qIsNaN(current.lower)) + { + range.lower = current.lower; + haveLower = true; + } + if ((current.upper > range.upper || !haveUpper) && current.upper > 0 && !qIsNaN(current.upper)) + { + range.upper = current.upper; + haveUpper = true; + } + } + } + + foundRange = haveLower && haveUpper; + return range; +} + +/*! + Makes sure \a begin and \a end mark a data range that is both within the bounds of this data + container's data, as well as within the specified \a dataRange. The initial range described by + the passed iterators \a begin and \a end is never expanded, only contracted if necessary. + + This function doesn't require for \a dataRange to be within the bounds of this data container's + valid range. +*/ +template +void QCPDataContainer::limitIteratorsToDataRange(const_iterator &begin, const_iterator &end, const QCPDataRange &dataRange) const +{ + QCPDataRange iteratorRange(int(begin-constBegin()), int(end-constBegin())); + iteratorRange = iteratorRange.bounded(dataRange.bounded(this->dataRange())); + begin = constBegin()+iteratorRange.begin(); + end = constBegin()+iteratorRange.end(); +} + +/*! \internal + + Increases the preallocation pool to have a size of at least \a minimumPreallocSize. Depending on + the preallocation history, the container will grow by more than requested, to speed up future + consecutive size increases. + + if \a minimumPreallocSize is smaller than or equal to the current preallocation pool size, this + method does nothing. +*/ +template +void QCPDataContainer::preallocateGrow(int minimumPreallocSize) +{ + if (minimumPreallocSize <= mPreallocSize) + return; + + int newPreallocSize = minimumPreallocSize; + newPreallocSize += (1u< +void QCPDataContainer::performAutoSqueeze() +{ + const int totalAlloc = mData.capacity(); + const int postAllocSize = totalAlloc-mData.size(); + const int usedSize = size(); + bool shrinkPostAllocation = false; + bool shrinkPreAllocation = false; + if (totalAlloc > 650000) // if allocation is larger, shrink earlier with respect to total used size + { + shrinkPostAllocation = postAllocSize > usedSize*1.5; // QVector grow strategy is 2^n for static data. Watch out not to oscillate! + shrinkPreAllocation = mPreallocSize*10 > usedSize; + } else if (totalAlloc > 1000) // below 10 MiB raw data be generous with preallocated memory, below 1k points don't even bother + { + shrinkPostAllocation = postAllocSize > usedSize*5; + shrinkPreAllocation = mPreallocSize > usedSize*1.5; // preallocation can grow into postallocation, so can be smaller + } + + if (shrinkPreAllocation || shrinkPostAllocation) + squeeze(shrinkPreAllocation, shrinkPostAllocation); +} + + +/* end of 'src/datacontainer.h' */ + + +/* including file 'src/plottable.h' */ +/* modified 2021-03-29T02:30:44, size 8461 */ + +class QCP_LIB_DECL QCPSelectionDecorator +{ + Q_GADGET +public: + QCPSelectionDecorator(); + virtual ~QCPSelectionDecorator(); + + // getters: + QPen pen() const { return mPen; } + QBrush brush() const { return mBrush; } + QCPScatterStyle scatterStyle() const { return mScatterStyle; } + QCPScatterStyle::ScatterProperties usedScatterProperties() const { return mUsedScatterProperties; } + + // setters: + void setPen(const QPen &pen); + void setBrush(const QBrush &brush); + void setScatterStyle(const QCPScatterStyle &scatterStyle, QCPScatterStyle::ScatterProperties usedProperties=QCPScatterStyle::spPen); + void setUsedScatterProperties(const QCPScatterStyle::ScatterProperties &properties); + + // non-virtual methods: + void applyPen(QCPPainter *painter) const; + void applyBrush(QCPPainter *painter) const; + QCPScatterStyle getFinalScatterStyle(const QCPScatterStyle &unselectedStyle) const; + + // introduced virtual methods: + virtual void copyFrom(const QCPSelectionDecorator *other); + virtual void drawDecoration(QCPPainter *painter, QCPDataSelection selection); + +protected: + // property members: + QPen mPen; + QBrush mBrush; + QCPScatterStyle mScatterStyle; + QCPScatterStyle::ScatterProperties mUsedScatterProperties; + // non-property members: + QCPAbstractPlottable *mPlottable; + + // introduced virtual methods: + virtual bool registerWithPlottable(QCPAbstractPlottable *plottable); + +private: + Q_DISABLE_COPY(QCPSelectionDecorator) + friend class QCPAbstractPlottable; +}; +Q_DECLARE_METATYPE(QCPSelectionDecorator*) + + +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(QPen pen READ pen WRITE setPen) + Q_PROPERTY(QBrush brush READ brush WRITE setBrush) + Q_PROPERTY(QCPAxis* keyAxis READ keyAxis WRITE setKeyAxis) + Q_PROPERTY(QCPAxis* valueAxis READ valueAxis WRITE setValueAxis) + Q_PROPERTY(QCP::SelectionType selectable READ selectable WRITE setSelectable NOTIFY selectableChanged) + Q_PROPERTY(QCPDataSelection selection READ selection WRITE setSelection NOTIFY selectionChanged) + Q_PROPERTY(QCPSelectionDecorator* selectionDecorator READ selectionDecorator WRITE setSelectionDecorator) + /// \endcond +public: + QCPAbstractPlottable(QCPAxis *keyAxis, QCPAxis *valueAxis); + virtual ~QCPAbstractPlottable() Q_DECL_OVERRIDE; + + // getters: + QString name() const { return mName; } + bool antialiasedFill() const { return mAntialiasedFill; } + bool antialiasedScatters() const { return mAntialiasedScatters; } + QPen pen() const { return mPen; } + QBrush brush() const { return mBrush; } + QCPAxis *keyAxis() const { return mKeyAxis.data(); } + QCPAxis *valueAxis() const { return mValueAxis.data(); } + QCP::SelectionType selectable() const { return mSelectable; } + bool selected() const { return !mSelection.isEmpty(); } + QCPDataSelection selection() const { return mSelection; } + QCPSelectionDecorator *selectionDecorator() const { return mSelectionDecorator; } + + // setters: + void setName(const QString &name); + void setAntialiasedFill(bool enabled); + void setAntialiasedScatters(bool enabled); + void setPen(const QPen &pen); + void setBrush(const QBrush &brush); + void setKeyAxis(QCPAxis *axis); + void setValueAxis(QCPAxis *axis); + Q_SLOT void setSelectable(QCP::SelectionType selectable); + Q_SLOT void setSelection(QCPDataSelection selection); + void setSelectionDecorator(QCPSelectionDecorator *decorator); + + // introduced virtual methods: + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE = 0; // actually introduced in QCPLayerable as non-pure, but we want to force reimplementation for plottables + virtual QCPPlottableInterface1D *interface1D() { return nullptr; } + virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const = 0; + virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const = 0; + + // non-property 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; + void rescaleAxes(bool onlyEnlarge=false) const; + void rescaleKeyAxis(bool onlyEnlarge=false) const; + void rescaleValueAxis(bool onlyEnlarge=false, bool inKeyRange=false) const; + bool addToLegend(QCPLegend *legend); + bool addToLegend(); + bool removeFromLegend(QCPLegend *legend) const; + bool removeFromLegend() const; + +signals: + void selectionChanged(bool selected); + void selectionChanged(const QCPDataSelection &selection); + void selectableChanged(QCP::SelectionType selectable); + +protected: + // property members: + QString mName; + bool mAntialiasedFill, mAntialiasedScatters; + QPen mPen; + QBrush mBrush; + QPointer mKeyAxis, mValueAxis; + QCP::SelectionType mSelectable; + QCPDataSelection mSelection; + QCPSelectionDecorator *mSelectionDecorator; + + // reimplemented virtual methods: + virtual QRect clipRect() const Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE = 0; + virtual QCP::Interaction selectionCategory() const Q_DECL_OVERRIDE; + void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; + // events: + virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE; + virtual void deselectEvent(bool *selectionStateChanged) Q_DECL_OVERRIDE; + + // introduced virtual methods: + virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const = 0; + + // non-virtual methods: + void applyFillAntialiasingHint(QCPPainter *painter) const; + void applyScattersAntialiasingHint(QCPPainter *painter) const; + +private: + Q_DISABLE_COPY(QCPAbstractPlottable) + + friend class QCustomPlot; + friend class QCPAxis; + friend class QCPPlottableLegendItem; +}; + + +/* end of 'src/plottable.h' */ + + +/* including file 'src/item.h' */ +/* modified 2021-03-29T02:30:44, size 9425 */ + +class QCP_LIB_DECL QCPItemAnchor +{ + Q_GADGET +public: + QCPItemAnchor(QCustomPlot *parentPlot, QCPAbstractItem *parentItem, const QString &name, int anchorId=-1); + virtual ~QCPItemAnchor(); + + // getters: + QString name() const { return mName; } + virtual QPointF pixelPosition() const; + +protected: + // property members: + QString mName; + + // non-property members: + QCustomPlot *mParentPlot; + QCPAbstractItem *mParentItem; + int mAnchorId; + QSet mChildrenX, mChildrenY; + + // introduced virtual methods: + virtual QCPItemPosition *toQCPItemPosition() { return nullptr; } + + // 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 +{ + Q_GADGET +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). + }; + Q_ENUMS(PositionType) + + QCPItemPosition(QCustomPlot *parentPlot, QCPAbstractItem *parentItem, const QString &name); + virtual ~QCPItemPosition() Q_DECL_OVERRIDE; + + // 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 pixelPosition() const Q_DECL_OVERRIDE; + + // 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 &pos); + void setAxes(QCPAxis* keyAxis, QCPAxis* valueAxis); + void setAxisRect(QCPAxisRect *axisRect); + void setPixelPosition(const QPointF &pixelPosition); + +protected: + // property members: + PositionType mPositionTypeX, mPositionTypeY; + QPointer mKeyAxis, mValueAxis; + QPointer mAxisRect; + double mKey, mValue; + QCPItemAnchor *mParentAnchorX, *mParentAnchorY; + + // reimplemented virtual methods: + virtual QCPItemPosition *toQCPItemPosition() Q_DECL_OVERRIDE { return this; } + +private: + Q_DISABLE_COPY(QCPItemPosition) + +}; +Q_DECLARE_METATYPE(QCPItemPosition::PositionType) + + +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: + explicit QCPAbstractItem(QCustomPlot *parentPlot); + virtual ~QCPAbstractItem() Q_DECL_OVERRIDE; + + // 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=nullptr) const Q_DECL_OVERRIDE = 0; + + // non-virtual methods: + QList positions() const { return mPositions; } + QList 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 mClipAxisRect; + QList mPositions; + QList mAnchors; + bool mSelectable, mSelected; + + // reimplemented virtual methods: + virtual QCP::Interaction selectionCategory() const Q_DECL_OVERRIDE; + virtual QRect clipRect() const Q_DECL_OVERRIDE; + virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE = 0; + // events: + virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE; + virtual void deselectEvent(bool *selectionStateChanged) Q_DECL_OVERRIDE; + + // introduced virtual methods: + virtual QPointF anchorPixelPosition(int anchorId) const; + + // non-virtual methods: + double rectDistance(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; +}; + +/* end of 'src/item.h' */ + + +/* including file 'src/core.h' */ +/* modified 2021-03-29T02:30:44, size 19304 */ + +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) + Q_PROPERTY(bool openGl READ openGl WRITE setOpenGl) + /// \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 { rpImmediateRefresh ///< Replots immediately and repaints the widget immediately by calling QWidget::repaint() after the replot + ,rpQueuedRefresh ///< Replots immediately, but queues the widget repaint, by calling QWidget::update() after the replot. This way multiple redundant widget repaints can be avoided. + ,rpRefreshHint ///< Whether to use immediate or queued refresh depends on whether the plotting hint \ref QCP::phImmediateRefresh is set, see \ref setPlottingHints. + ,rpQueuedReplot ///< Queues the entire replot for the next event loop iteration. This way multiple redundant replots can be avoided. The actual replot is then done with \ref rpRefreshHint priority. + }; + Q_ENUMS(RefreshPriority) + + explicit QCustomPlot(QWidget *parent = nullptr); + virtual ~QCustomPlot() Q_DECL_OVERRIDE; + + // getters: + QRect viewport() const { return mViewport; } + double bufferDevicePixelRatio() const { return mBufferDevicePixelRatio; } + 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; } + QCP::SelectionRectMode selectionRectMode() const { return mSelectionRectMode; } + QCPSelectionRect *selectionRect() const { return mSelectionRect; } + bool openGl() const { return mOpenGl; } + + // setters: + void setViewport(const QRect &rect); + void setBufferDevicePixelRatio(double ratio); + 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); + void setSelectionRectMode(QCP::SelectionRectMode mode); + void setSelectionRect(QCPSelectionRect *selectionRect); + void setOpenGl(bool enabled, int multisampling=16); + + // non-property methods: + // plottable interface: + QCPAbstractPlottable *plottable(int index); + QCPAbstractPlottable *plottable(); + bool removePlottable(QCPAbstractPlottable *plottable); + bool removePlottable(int index); + int clearPlottables(); + int plottableCount() const; + QList selectedPlottables() const; + template + PlottableType *plottableAt(const QPointF &pos, bool onlySelectable=false, int *dataIndex=nullptr) const; + QCPAbstractPlottable *plottableAt(const QPointF &pos, bool onlySelectable=false, int *dataIndex=nullptr) const; + bool hasPlottable(QCPAbstractPlottable *plottable) const; + + // specialized interface for QCPGraph: + QCPGraph *graph(int index) const; + QCPGraph *graph() const; + QCPGraph *addGraph(QCPAxis *keyAxis=nullptr, QCPAxis *valueAxis=nullptr); + bool removeGraph(QCPGraph *graph); + bool removeGraph(int index); + int clearGraphs(); + int graphCount() const; + QList selectedGraphs() const; + + // item interface: + QCPAbstractItem *item(int index) const; + QCPAbstractItem *item() const; + bool removeItem(QCPAbstractItem *item); + bool removeItem(int index); + int clearItems(); + int itemCount() const; + QList selectedItems() const; + template + ItemType *itemAt(const QPointF &pos, bool onlySelectable=false) 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=nullptr, 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 axisRects() const; + QCPLayoutElement* layoutElementAt(const QPointF &pos) const; + QCPAxisRect* axisRectAt(const QPointF &pos) const; + Q_SLOT void rescaleAxes(bool onlyVisiblePlottables=false); + + QList selectedAxes() const; + QList selectedLegends() const; + Q_SLOT void deselectAll(); + + bool savePdf(const QString &fileName, int width=0, int height=0, QCP::ExportPen exportPen=QCP::epAllowCosmetic, 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, int resolution=96, QCP::ResolutionUnit resolutionUnit=QCP::ruDotsPerInch); + bool saveJpg(const QString &fileName, int width=0, int height=0, double scale=1.0, int quality=-1, int resolution=96, QCP::ResolutionUnit resolutionUnit=QCP::ruDotsPerInch); + bool saveBmp(const QString &fileName, int width=0, int height=0, double scale=1.0, int resolution=96, QCP::ResolutionUnit resolutionUnit=QCP::ruDotsPerInch); + bool saveRastered(const QString &fileName, int width, int height, double scale, const char *format, int quality=-1, int resolution=96, QCP::ResolutionUnit resolutionUnit=QCP::ruDotsPerInch); + 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::rpRefreshHint); + double replotTime(bool average=false) const; + + 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, int dataIndex, QMouseEvent *event); + void plottableDoubleClick(QCPAbstractPlottable *plottable, int dataIndex, 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 selectionChangedByUser(); + void beforeReplot(); + void afterLayout(); + void afterReplot(); + +protected: + // property members: + QRect mViewport; + double mBufferDevicePixelRatio; + QCPLayoutGrid *mPlotLayout; + bool mAutoAddPlottableToLegend; + QList mPlottables; + QList mGraphs; // extra list of plottables also in mPlottables that are of type QCPGraph + QList mItems; + QList 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; + QCP::SelectionRectMode mSelectionRectMode; + QCPSelectionRect *mSelectionRect; + bool mOpenGl; + + // non-property members: + QList > mPaintBuffers; + QPoint mMousePressPos; + bool mMouseHasMoved; + QPointer mMouseEventLayerable; + QPointer mMouseSignalLayerable; + QVariant mMouseEventLayerableDetails; + QVariant mMouseSignalLayerableDetails; + bool mReplotting; + bool mReplotQueued; + double mReplotTime, mReplotTimeAverage; + int mOpenGlMultisamples; + QCP::AntialiasedElements mOpenGlAntialiasedElementsBackup; + bool mOpenGlCacheLabelsBackup; +#ifdef QCP_OPENGL_FBO + QSharedPointer mGlContext; + QSharedPointer mGlSurface; + QSharedPointer mGlPaintDevice; +#endif + + // reimplemented virtual methods: + virtual QSize minimumSizeHint() const Q_DECL_OVERRIDE; + virtual QSize sizeHint() const Q_DECL_OVERRIDE; + virtual void paintEvent(QPaintEvent *event) Q_DECL_OVERRIDE; + virtual void resizeEvent(QResizeEvent *event) Q_DECL_OVERRIDE; + virtual void mouseDoubleClickEvent(QMouseEvent *event) Q_DECL_OVERRIDE; + virtual void mousePressEvent(QMouseEvent *event) Q_DECL_OVERRIDE; + virtual void mouseMoveEvent(QMouseEvent *event) Q_DECL_OVERRIDE; + virtual void mouseReleaseEvent(QMouseEvent *event) Q_DECL_OVERRIDE; + virtual void wheelEvent(QWheelEvent *event) Q_DECL_OVERRIDE; + + // introduced virtual methods: + virtual void draw(QCPPainter *painter); + virtual void updateLayout(); + virtual void axisRemoved(QCPAxis *axis); + virtual void legendRemoved(QCPLegend *legend); + Q_SLOT virtual void processRectSelection(QRect rect, QMouseEvent *event); + Q_SLOT virtual void processRectZoom(QRect rect, QMouseEvent *event); + Q_SLOT virtual void processPointSelection(QMouseEvent *event); + + // non-virtual methods: + bool registerPlottable(QCPAbstractPlottable *plottable); + bool registerGraph(QCPGraph *graph); + bool registerItem(QCPAbstractItem* item); + void updateLayerIndices() const; + QCPLayerable *layerableAt(const QPointF &pos, bool onlySelectable, QVariant *selectionDetails=nullptr) const; + QList layerableListAt(const QPointF &pos, bool onlySelectable, QList *selectionDetails=nullptr) const; + void drawBackground(QCPPainter *painter); + void setupPaintBuffers(); + QCPAbstractPaintBuffer *createPaintBuffer(); + bool hasInvalidatedPaintBuffers(); + bool setupOpenGl(); + void freeOpenGl(); + + friend class QCPLegend; + friend class QCPAxis; + friend class QCPLayer; + friend class QCPAxisRect; + friend class QCPAbstractPlottable; + friend class QCPGraph; + friend class QCPAbstractItem; +}; +Q_DECLARE_METATYPE(QCustomPlot::LayerInsertMode) +Q_DECLARE_METATYPE(QCustomPlot::RefreshPriority) + + +// implementation of template functions: + +/*! + Returns the plottable at the pixel position \a pos. The plottable type (a QCPAbstractPlottable + subclass) that shall be taken into consideration can be specified via the template parameter. + + Plottables that only consist of single lines (like graphs) have a tolerance band around them, see + \ref setSelectionTolerance. If multiple plottables come into consideration, the one closest to \a + pos is returned. + + If \a onlySelectable is true, only plottables that are selectable + (QCPAbstractPlottable::setSelectable) are considered. + + if \a dataIndex is non-null, it is set to the index of the plottable's data point that is closest + to \a pos. + + If there is no plottable of the specified type at \a pos, returns \c nullptr. + + \see itemAt, layoutElementAt +*/ +template +PlottableType *QCustomPlot::plottableAt(const QPointF &pos, bool onlySelectable, int *dataIndex) const +{ + PlottableType *resultPlottable = 0; + QVariant resultDetails; + double resultDistance = mSelectionTolerance; // only regard clicks with distances smaller than mSelectionTolerance as selections, so initialize with that value + + foreach (QCPAbstractPlottable *plottable, mPlottables) + { + PlottableType *currentPlottable = qobject_cast(plottable); + if (!currentPlottable || (onlySelectable && !currentPlottable->selectable())) // we could have also passed onlySelectable to the selectTest function, but checking here is faster, because we have access to QCPAbstractPlottable::selectable + continue; + if (currentPlottable->clipRect().contains(pos.toPoint())) // only consider clicks where the plottable is actually visible + { + QVariant details; + double currentDistance = currentPlottable->selectTest(pos, false, dataIndex ? &details : nullptr); + if (currentDistance >= 0 && currentDistance < resultDistance) + { + resultPlottable = currentPlottable; + resultDetails = details; + resultDistance = currentDistance; + } + } + } + + if (resultPlottable && dataIndex) + { + QCPDataSelection sel = resultDetails.value(); + if (!sel.isEmpty()) + *dataIndex = sel.dataRange(0).begin(); + } + return resultPlottable; +} + +/*! + Returns the item at the pixel position \a pos. The item type (a QCPAbstractItem subclass) that shall be + taken into consideration can be specified via the template parameter. Items that only consist of single + lines (e.g. \ref QCPItemLine or \ref QCPItemCurve) have a tolerance band around them, see \ref + setSelectionTolerance. If multiple items come into consideration, the one closest to \a pos is returned. + + If \a onlySelectable is true, only items that are selectable (QCPAbstractItem::setSelectable) are + considered. + + If there is no item at \a pos, returns \c nullptr. + + \see plottableAt, layoutElementAt +*/ +template +ItemType *QCustomPlot::itemAt(const QPointF &pos, bool onlySelectable) const +{ + ItemType *resultItem = 0; + double resultDistance = mSelectionTolerance; // only regard clicks with distances smaller than mSelectionTolerance as selections, so initialize with that value + + foreach (QCPAbstractItem *item, mItems) + { + ItemType *currentItem = qobject_cast(item); + if (!currentItem || (onlySelectable && !currentItem->selectable())) // we could have also passed onlySelectable to the selectTest function, but checking here is faster, because we have access to QCPAbstractItem::selectable + continue; + if (!currentItem->clipToAxisRect() || currentItem->clipRect().contains(pos.toPoint())) // only consider clicks inside axis cliprect of the item if actually clipped to it + { + double currentDistance = currentItem->selectTest(pos, false); + if (currentDistance >= 0 && currentDistance < resultDistance) + { + resultItem = currentItem; + resultDistance = currentDistance; + } + } + } + + return resultItem; +} + + + +/* end of 'src/core.h' */ + + +/* including file 'src/plottable1d.h' */ +/* modified 2021-03-29T02:30:44, size 25638 */ + +class QCPPlottableInterface1D +{ +public: + virtual ~QCPPlottableInterface1D() = default; + // introduced pure virtual methods: + virtual int dataCount() const = 0; + virtual double dataMainKey(int index) const = 0; + virtual double dataSortKey(int index) const = 0; + virtual double dataMainValue(int index) const = 0; + virtual QCPRange dataValueRange(int index) const = 0; + virtual QPointF dataPixelPosition(int index) const = 0; + virtual bool sortKeyIsMainKey() const = 0; + virtual QCPDataSelection selectTestRect(const QRectF &rect, bool onlySelectable) const = 0; + virtual int findBegin(double sortKey, bool expandedRange=true) const = 0; + virtual int findEnd(double sortKey, bool expandedRange=true) const = 0; +}; + +template +class QCPAbstractPlottable1D : public QCPAbstractPlottable, public QCPPlottableInterface1D // no QCP_LIB_DECL, template class ends up in header (cpp included below) +{ + // No Q_OBJECT macro due to template class + +public: + QCPAbstractPlottable1D(QCPAxis *keyAxis, QCPAxis *valueAxis); + virtual ~QCPAbstractPlottable1D() Q_DECL_OVERRIDE; + + // virtual methods of 1d plottable interface: + virtual int dataCount() const Q_DECL_OVERRIDE; + virtual double dataMainKey(int index) const Q_DECL_OVERRIDE; + virtual double dataSortKey(int index) const Q_DECL_OVERRIDE; + virtual double dataMainValue(int index) const Q_DECL_OVERRIDE; + virtual QCPRange dataValueRange(int index) const Q_DECL_OVERRIDE; + virtual QPointF dataPixelPosition(int index) const Q_DECL_OVERRIDE; + virtual bool sortKeyIsMainKey() const Q_DECL_OVERRIDE; + virtual QCPDataSelection selectTestRect(const QRectF &rect, bool onlySelectable) const Q_DECL_OVERRIDE; + virtual int findBegin(double sortKey, bool expandedRange=true) const Q_DECL_OVERRIDE; + virtual int findEnd(double sortKey, bool expandedRange=true) const Q_DECL_OVERRIDE; + + // reimplemented virtual methods: + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; + virtual QCPPlottableInterface1D *interface1D() Q_DECL_OVERRIDE { return this; } + +protected: + // property members: + QSharedPointer > mDataContainer; + + // helpers for subclasses: + void getDataSegments(QList &selectedSegments, QList &unselectedSegments) const; + void drawPolyline(QCPPainter *painter, const QVector &lineData) const; + +private: + Q_DISABLE_COPY(QCPAbstractPlottable1D) + +}; + + + +// include implementation in header since it is a class template: +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPPlottableInterface1D +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPPlottableInterface1D + \brief Defines an abstract interface for one-dimensional plottables + + This class contains only pure virtual methods which define a common interface to the data + of one-dimensional plottables. + + For example, it is implemented by the template class \ref QCPAbstractPlottable1D (the preferred + base class for one-dimensional plottables). So if you use that template class as base class of + your one-dimensional plottable, you won't have to care about implementing the 1d interface + yourself. + + If your plottable doesn't derive from \ref QCPAbstractPlottable1D but still wants to provide a 1d + interface (e.g. like \ref QCPErrorBars does), you should inherit from both \ref + QCPAbstractPlottable and \ref QCPPlottableInterface1D and accordingly reimplement the pure + virtual methods of the 1d interface, matching your data container. Also, reimplement \ref + QCPAbstractPlottable::interface1D to return the \c this pointer. + + If you have a \ref QCPAbstractPlottable pointer, you can check whether it implements this + interface by calling \ref QCPAbstractPlottable::interface1D and testing it for a non-zero return + value. If it indeed implements this interface, you may use it to access the plottable's data + without needing to know the exact type of the plottable or its data point type. +*/ + +/* start documentation of pure virtual functions */ + +/*! \fn virtual int QCPPlottableInterface1D::dataCount() const = 0; + + Returns the number of data points of the plottable. +*/ + +/*! \fn virtual QCPDataSelection QCPPlottableInterface1D::selectTestRect(const QRectF &rect, bool onlySelectable) const = 0; + + Returns a data selection containing all the data points of this plottable which are contained (or + hit by) \a rect. This is used mainly in the selection rect interaction for data selection (\ref + dataselection "data selection mechanism"). + + If \a onlySelectable is true, an empty QCPDataSelection is returned if this plottable is not + selectable (i.e. if \ref QCPAbstractPlottable::setSelectable is \ref QCP::stNone). + + \note \a rect must be a normalized rect (positive or zero width and height). This is especially + important when using the rect of \ref QCPSelectionRect::accepted, which is not necessarily + normalized. Use QRect::normalized() when passing a rect which might not be normalized. +*/ + +/*! \fn virtual double QCPPlottableInterface1D::dataMainKey(int index) const = 0 + + Returns the main key of the data point at the given \a index. + + What the main key is, is defined by the plottable's data type. See the \ref + qcpdatacontainer-datatype "QCPDataContainer DataType" documentation for details about this naming + convention. +*/ + +/*! \fn virtual double QCPPlottableInterface1D::dataSortKey(int index) const = 0 + + Returns the sort key of the data point at the given \a index. + + What the sort key is, is defined by the plottable's data type. See the \ref + qcpdatacontainer-datatype "QCPDataContainer DataType" documentation for details about this naming + convention. +*/ + +/*! \fn virtual double QCPPlottableInterface1D::dataMainValue(int index) const = 0 + + Returns the main value of the data point at the given \a index. + + What the main value is, is defined by the plottable's data type. See the \ref + qcpdatacontainer-datatype "QCPDataContainer DataType" documentation for details about this naming + convention. +*/ + +/*! \fn virtual QCPRange QCPPlottableInterface1D::dataValueRange(int index) const = 0 + + Returns the value range of the data point at the given \a index. + + What the value range is, is defined by the plottable's data type. See the \ref + qcpdatacontainer-datatype "QCPDataContainer DataType" documentation for details about this naming + convention. +*/ + +/*! \fn virtual QPointF QCPPlottableInterface1D::dataPixelPosition(int index) const = 0 + + Returns the pixel position on the widget surface at which the data point at the given \a index + appears. + + Usually this corresponds to the point of \ref dataMainKey/\ref dataMainValue, in pixel + coordinates. However, depending on the plottable, this might be a different apparent position + than just a coord-to-pixel transform of those values. For example, \ref QCPBars apparent data + values can be shifted depending on their stacking, bar grouping or configured base value. +*/ + +/*! \fn virtual bool QCPPlottableInterface1D::sortKeyIsMainKey() const = 0 + + Returns whether the sort key (\ref dataSortKey) is identical to the main key (\ref dataMainKey). + + What the sort and main keys are, is defined by the plottable's data type. See the \ref + qcpdatacontainer-datatype "QCPDataContainer DataType" documentation for details about this naming + convention. +*/ + +/*! \fn virtual int QCPPlottableInterface1D::findBegin(double sortKey, bool expandedRange) const = 0 + + Returns the index of the data point with a (sort-)key that is equal to, just below, or just above + \a sortKey. If \a expandedRange is true, the data point just below \a sortKey will be considered, + otherwise the one just above. + + This can be used in conjunction with \ref findEnd to iterate over data points within a given key + range, including or excluding the bounding data points that are just beyond the specified range. + + If \a expandedRange is true but there are no data points below \a sortKey, 0 is returned. + + If the container is empty, returns 0 (in that case, \ref findEnd will also return 0, so a loop + using these methods will not iterate over the index 0). + + \see findEnd, QCPDataContainer::findBegin +*/ + +/*! \fn virtual int QCPPlottableInterface1D::findEnd(double sortKey, bool expandedRange) const = 0 + + Returns the index one after the data point with a (sort-)key that is equal to, just above, or + just below \a sortKey. If \a expandedRange is true, the data point just above \a sortKey will be + considered, otherwise the one just below. + + This can be used in conjunction with \ref findBegin to iterate over data points within a given + key range, including the bounding data points that are just below and above the specified range. + + If \a expandedRange is true but there are no data points above \a sortKey, the index just above the + highest data point is returned. + + If the container is empty, returns 0. + + \see findBegin, QCPDataContainer::findEnd +*/ + +/* end documentation of pure virtual functions */ + + +//////////////////////////////////////////////////////////////////////////////////////////////////// +//////////////////// QCPAbstractPlottable1D +//////////////////////////////////////////////////////////////////////////////////////////////////// + +/*! \class QCPAbstractPlottable1D + \brief A template base class for plottables with one-dimensional data + + This template class derives from \ref QCPAbstractPlottable and from the abstract interface \ref + QCPPlottableInterface1D. It serves as a base class for all one-dimensional data (i.e. data with + one key dimension), such as \ref QCPGraph and QCPCurve. + + The template parameter \a DataType is the type of the data points of this plottable (e.g. \ref + QCPGraphData or \ref QCPCurveData). The main purpose of this base class is to provide the member + \a mDataContainer (a shared pointer to a \ref QCPDataContainer "QCPDataContainer") and + implement the according virtual methods of the \ref QCPPlottableInterface1D, such that most + subclassed plottables don't need to worry about this anymore. + + Further, it provides a convenience method for retrieving selected/unselected data segments via + \ref getDataSegments. This is useful when subclasses implement their \ref draw method and need to + draw selected segments with a different pen/brush than unselected segments (also see \ref + QCPSelectionDecorator). + + This class implements basic functionality of \ref QCPAbstractPlottable::selectTest and \ref + QCPPlottableInterface1D::selectTestRect, assuming point-like data points, based on the 1D data + interface. In spite of that, most plottable subclasses will want to reimplement those methods + again, to provide a more accurate hit test based on their specific data visualization geometry. +*/ + +/* start documentation of inline functions */ + +/*! \fn QCPPlottableInterface1D *QCPAbstractPlottable1D::interface1D() + + Returns a \ref QCPPlottableInterface1D pointer to this plottable, providing access to its 1D + interface. + + \seebaseclassmethod +*/ + +/* end documentation of inline functions */ + +/*! + Forwards \a keyAxis and \a valueAxis to the \ref QCPAbstractPlottable::QCPAbstractPlottable + "QCPAbstractPlottable" constructor and allocates the \a mDataContainer. +*/ +template +QCPAbstractPlottable1D::QCPAbstractPlottable1D(QCPAxis *keyAxis, QCPAxis *valueAxis) : + QCPAbstractPlottable(keyAxis, valueAxis), + mDataContainer(new QCPDataContainer) +{ +} + +template +QCPAbstractPlottable1D::~QCPAbstractPlottable1D() +{ +} + +/*! + \copydoc QCPPlottableInterface1D::dataCount +*/ +template +int QCPAbstractPlottable1D::dataCount() const +{ + return mDataContainer->size(); +} + +/*! + \copydoc QCPPlottableInterface1D::dataMainKey +*/ +template +double QCPAbstractPlottable1D::dataMainKey(int index) const +{ + if (index >= 0 && index < mDataContainer->size()) + { + return (mDataContainer->constBegin()+index)->mainKey(); + } else + { + qDebug() << Q_FUNC_INFO << "Index out of bounds" << index; + return 0; + } +} + +/*! + \copydoc QCPPlottableInterface1D::dataSortKey +*/ +template +double QCPAbstractPlottable1D::dataSortKey(int index) const +{ + if (index >= 0 && index < mDataContainer->size()) + { + return (mDataContainer->constBegin()+index)->sortKey(); + } else + { + qDebug() << Q_FUNC_INFO << "Index out of bounds" << index; + return 0; + } +} + +/*! + \copydoc QCPPlottableInterface1D::dataMainValue +*/ +template +double QCPAbstractPlottable1D::dataMainValue(int index) const +{ + if (index >= 0 && index < mDataContainer->size()) + { + return (mDataContainer->constBegin()+index)->mainValue(); + } else + { + qDebug() << Q_FUNC_INFO << "Index out of bounds" << index; + return 0; + } +} + +/*! + \copydoc QCPPlottableInterface1D::dataValueRange +*/ +template +QCPRange QCPAbstractPlottable1D::dataValueRange(int index) const +{ + if (index >= 0 && index < mDataContainer->size()) + { + return (mDataContainer->constBegin()+index)->valueRange(); + } else + { + qDebug() << Q_FUNC_INFO << "Index out of bounds" << index; + return QCPRange(0, 0); + } +} + +/*! + \copydoc QCPPlottableInterface1D::dataPixelPosition +*/ +template +QPointF QCPAbstractPlottable1D::dataPixelPosition(int index) const +{ + if (index >= 0 && index < mDataContainer->size()) + { + const typename QCPDataContainer::const_iterator it = mDataContainer->constBegin()+index; + return coordsToPixels(it->mainKey(), it->mainValue()); + } else + { + qDebug() << Q_FUNC_INFO << "Index out of bounds" << index; + return QPointF(); + } +} + +/*! + \copydoc QCPPlottableInterface1D::sortKeyIsMainKey +*/ +template +bool QCPAbstractPlottable1D::sortKeyIsMainKey() const +{ + return DataType::sortKeyIsMainKey(); +} + +/*! + Implements a rect-selection algorithm assuming the data (accessed via the 1D data interface) is + point-like. Most subclasses will want to reimplement this method again, to provide a more + accurate hit test based on the true data visualization geometry. + + \seebaseclassmethod +*/ +template +QCPDataSelection QCPAbstractPlottable1D::selectTestRect(const QRectF &rect, bool onlySelectable) const +{ + QCPDataSelection result; + if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) + return result; + if (!mKeyAxis || !mValueAxis) + return result; + + // convert rect given in pixels to ranges given in plot coordinates: + double key1, value1, key2, value2; + pixelsToCoords(rect.topLeft(), key1, value1); + pixelsToCoords(rect.bottomRight(), key2, value2); + QCPRange keyRange(key1, key2); // QCPRange normalizes internally so we don't have to care about whether key1 < key2 + QCPRange valueRange(value1, value2); + typename QCPDataContainer::const_iterator begin = mDataContainer->constBegin(); + typename QCPDataContainer::const_iterator end = mDataContainer->constEnd(); + if (DataType::sortKeyIsMainKey()) // we can assume that data is sorted by main key, so can reduce the searched key interval: + { + begin = mDataContainer->findBegin(keyRange.lower, false); + end = mDataContainer->findEnd(keyRange.upper, false); + } + if (begin == end) + return result; + + int currentSegmentBegin = -1; // -1 means we're currently not in a segment that's contained in rect + for (typename QCPDataContainer::const_iterator it=begin; it!=end; ++it) + { + if (currentSegmentBegin == -1) + { + if (valueRange.contains(it->mainValue()) && keyRange.contains(it->mainKey())) // start segment + currentSegmentBegin = int(it-mDataContainer->constBegin()); + } else if (!valueRange.contains(it->mainValue()) || !keyRange.contains(it->mainKey())) // segment just ended + { + result.addDataRange(QCPDataRange(currentSegmentBegin, int(it-mDataContainer->constBegin())), false); + currentSegmentBegin = -1; + } + } + // process potential last segment: + if (currentSegmentBegin != -1) + result.addDataRange(QCPDataRange(currentSegmentBegin, int(end-mDataContainer->constBegin())), false); + + result.simplify(); + return result; +} + +/*! + \copydoc QCPPlottableInterface1D::findBegin +*/ +template +int QCPAbstractPlottable1D::findBegin(double sortKey, bool expandedRange) const +{ + return int(mDataContainer->findBegin(sortKey, expandedRange)-mDataContainer->constBegin()); +} + +/*! + \copydoc QCPPlottableInterface1D::findEnd +*/ +template +int QCPAbstractPlottable1D::findEnd(double sortKey, bool expandedRange) const +{ + return int(mDataContainer->findEnd(sortKey, expandedRange)-mDataContainer->constBegin()); +} + +/*! + Implements a point-selection algorithm assuming the data (accessed via the 1D data interface) is + point-like. Most subclasses will want to reimplement this method again, to provide a more + accurate hit test based on the true data visualization geometry. + + If \a details is not 0, it will be set to a \ref QCPDataSelection, describing the closest data point + to \a pos. + + \seebaseclassmethod +*/ +template +double QCPAbstractPlottable1D::selectTest(const QPointF &pos, bool onlySelectable, QVariant *details) const +{ + if ((onlySelectable && mSelectable == QCP::stNone) || mDataContainer->isEmpty()) + return -1; + if (!mKeyAxis || !mValueAxis) + return -1; + + QCPDataSelection selectionResult; + double minDistSqr = (std::numeric_limits::max)(); + int minDistIndex = mDataContainer->size(); + + typename QCPDataContainer::const_iterator begin = mDataContainer->constBegin(); + typename QCPDataContainer::const_iterator end = mDataContainer->constEnd(); + if (DataType::sortKeyIsMainKey()) // we can assume that data is sorted by main key, so can reduce the searched key interval: + { + // determine which key range comes into question, taking selection tolerance around pos into account: + double posKeyMin, posKeyMax, dummy; + pixelsToCoords(pos-QPointF(mParentPlot->selectionTolerance(), mParentPlot->selectionTolerance()), posKeyMin, dummy); + pixelsToCoords(pos+QPointF(mParentPlot->selectionTolerance(), mParentPlot->selectionTolerance()), posKeyMax, dummy); + if (posKeyMin > posKeyMax) + qSwap(posKeyMin, posKeyMax); + begin = mDataContainer->findBegin(posKeyMin, true); + end = mDataContainer->findEnd(posKeyMax, true); + } + if (begin == end) + return -1; + QCPRange keyRange(mKeyAxis->range()); + QCPRange valueRange(mValueAxis->range()); + for (typename QCPDataContainer::const_iterator it=begin; it!=end; ++it) + { + const double mainKey = it->mainKey(); + const double mainValue = it->mainValue(); + if (keyRange.contains(mainKey) && valueRange.contains(mainValue)) // make sure data point is inside visible range, for speedup in cases where sort key isn't main key and we iterate over all points + { + const double currentDistSqr = QCPVector2D(coordsToPixels(mainKey, mainValue)-pos).lengthSquared(); + if (currentDistSqr < minDistSqr) + { + minDistSqr = currentDistSqr; + minDistIndex = int(it-mDataContainer->constBegin()); + } + } + } + if (minDistIndex != mDataContainer->size()) + selectionResult.addDataRange(QCPDataRange(minDistIndex, minDistIndex+1), false); + + selectionResult.simplify(); + if (details) + details->setValue(selectionResult); + return qSqrt(minDistSqr); +} + +/*! + Splits all data into selected and unselected segments and outputs them via \a selectedSegments + and \a unselectedSegments, respectively. + + This is useful when subclasses implement their \ref draw method and need to draw selected + segments with a different pen/brush than unselected segments (also see \ref + QCPSelectionDecorator). + + \see setSelection +*/ +template +void QCPAbstractPlottable1D::getDataSegments(QList &selectedSegments, QList &unselectedSegments) const +{ + selectedSegments.clear(); + unselectedSegments.clear(); + if (mSelectable == QCP::stWhole) // stWhole selection type draws the entire plottable with selected style if mSelection isn't empty + { + if (selected()) + selectedSegments << QCPDataRange(0, dataCount()); + else + unselectedSegments << QCPDataRange(0, dataCount()); + } else + { + QCPDataSelection sel(selection()); + sel.simplify(); + selectedSegments = sel.dataRanges(); + unselectedSegments = sel.inverse(QCPDataRange(0, dataCount())).dataRanges(); + } +} + +/*! + A helper method which draws a line with the passed \a painter, according to the pixel data in \a + lineData. NaN points create gaps in the line, as expected from QCustomPlot's plottables (this is + the main difference to QPainter's regular drawPolyline, which handles NaNs by lagging or + crashing). + + Further it uses a faster line drawing technique based on \ref QCPPainter::drawLine rather than \c + QPainter::drawPolyline if the configured \ref QCustomPlot::setPlottingHints() and \a painter + style allows. +*/ +template +void QCPAbstractPlottable1D::drawPolyline(QCPPainter *painter, const QVector &lineData) const +{ + // if drawing lines in plot (instead of PDF), reduce 1px lines to cosmetic, because at least in + // Qt6 drawing of "1px" width lines is much slower even though it has same appearance apart from + // High-DPI. In High-DPI cases people must set a pen width slightly larger than 1.0 to get + // correct DPI scaling of width, but of course with performance penalty. + if (!painter->modes().testFlag(QCPPainter::pmVectorized) && + qFuzzyCompare(painter->pen().widthF(), 1.0)) + { + QPen newPen = painter->pen(); + newPen.setWidth(0); + painter->setPen(newPen); + } + + // if drawing solid line and not in PDF, use much faster line drawing instead of polyline: + if (mParentPlot->plottingHints().testFlag(QCP::phFastPolylines) && + painter->pen().style() == Qt::SolidLine && + !painter->modes().testFlag(QCPPainter::pmVectorized) && + !painter->modes().testFlag(QCPPainter::pmNoCaching)) + { + int i = 0; + bool lastIsNan = false; + const int lineDataSize = lineData.size(); + while (i < lineDataSize && (qIsNaN(lineData.at(i).y()) || qIsNaN(lineData.at(i).x()))) // make sure first point is not NaN + ++i; + ++i; // because drawing works in 1 point retrospect + while (i < lineDataSize) + { + if (!qIsNaN(lineData.at(i).y()) && !qIsNaN(lineData.at(i).x())) // NaNs create a gap in the line + { + if (!lastIsNan) + painter->drawLine(lineData.at(i-1), lineData.at(i)); + else + lastIsNan = false; + } else + lastIsNan = true; + ++i; + } + } else + { + int segmentStart = 0; + int i = 0; + const int lineDataSize = lineData.size(); + while (i < lineDataSize) + { + if (qIsNaN(lineData.at(i).y()) || qIsNaN(lineData.at(i).x()) || qIsInf(lineData.at(i).y())) // NaNs create a gap in the line. Also filter Infs which make drawPolyline block + { + painter->drawPolyline(lineData.constData()+segmentStart, i-segmentStart); // i, because we don't want to include the current NaN point + segmentStart = i+1; + } + ++i; + } + // draw last segment: + painter->drawPolyline(lineData.constData()+segmentStart, lineDataSize-segmentStart); + } +} + + +/* end of 'src/plottable1d.h' */ + + +/* including file 'src/colorgradient.h' */ +/* modified 2021-03-29T02:30:44, size 7262 */ + +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 how NaN data points shall appear in the plot. + + \see setNanHandling, setNanColor + */ + enum NanHandling { nhNone ///< NaN data points are not explicitly handled and shouldn't occur in the data (this gives slight performance improvement) + ,nhLowestColor ///< NaN data points appear as the lowest color defined in this QCPColorGradient + ,nhHighestColor ///< NaN data points appear as the highest color defined in this QCPColorGradient + ,nhTransparent ///< NaN data points appear transparent + ,nhNanColor ///< NaN data points appear as the color defined with \ref setNanColor + }; + Q_ENUMS(NanHandling) + + /*! + 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(); + QCPColorGradient(GradientPreset preset); + bool operator==(const QCPColorGradient &other) const; + bool operator!=(const QCPColorGradient &other) const { return !(*this == other); } + + // getters: + int levelCount() const { return mLevelCount; } + QMap colorStops() const { return mColorStops; } + ColorInterpolation colorInterpolation() const { return mColorInterpolation; } + NanHandling nanHandling() const { return mNanHandling; } + QColor nanColor() const { return mNanColor; } + bool periodic() const { return mPeriodic; } + + // setters: + void setLevelCount(int n); + void setColorStops(const QMap &colorStops); + void setColorStopAt(double position, const QColor &color); + void setColorInterpolation(ColorInterpolation interpolation); + void setNanHandling(NanHandling handling); + void setNanColor(const QColor &color); + 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); + void colorize(const double *data, const unsigned char *alpha, 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: + // property members: + int mLevelCount; + QMap mColorStops; + ColorInterpolation mColorInterpolation; + NanHandling mNanHandling; + QColor mNanColor; + bool mPeriodic; + + // non-property members: + QVector mColorBuffer; // have colors premultiplied with alpha (for usage with QImage::Format_ARGB32_Premultiplied) + bool mColorBufferInvalidated; + + // non-virtual methods: + bool stopsUseAlpha() const; + void updateColorBuffer(); +}; +Q_DECLARE_METATYPE(QCPColorGradient::ColorInterpolation) +Q_DECLARE_METATYPE(QCPColorGradient::NanHandling) +Q_DECLARE_METATYPE(QCPColorGradient::GradientPreset) + +/* end of 'src/colorgradient.h' */ + + +/* including file 'src/selectiondecorator-bracket.h' */ +/* modified 2021-03-29T02:30:44, size 4458 */ + +class QCP_LIB_DECL QCPSelectionDecoratorBracket : public QCPSelectionDecorator +{ + Q_GADGET +public: + + /*! + Defines which shape is drawn at the boundaries of selected data ranges. + + Some of the bracket styles further allow specifying a height and/or width, see \ref + setBracketHeight and \ref setBracketWidth. + */ + enum BracketStyle { bsSquareBracket ///< A square bracket is drawn. + ,bsHalfEllipse ///< A half ellipse is drawn. The size of the ellipse is given by the bracket width/height properties. + ,bsEllipse ///< An ellipse is drawn. The size of the ellipse is given by the bracket width/height properties. + ,bsPlus ///< A plus is drawn. + ,bsUserStyle ///< Start custom bracket styles at this index when subclassing and reimplementing \ref drawBracket. + }; + Q_ENUMS(BracketStyle) + + QCPSelectionDecoratorBracket(); + virtual ~QCPSelectionDecoratorBracket() Q_DECL_OVERRIDE; + + // getters: + QPen bracketPen() const { return mBracketPen; } + QBrush bracketBrush() const { return mBracketBrush; } + int bracketWidth() const { return mBracketWidth; } + int bracketHeight() const { return mBracketHeight; } + BracketStyle bracketStyle() const { return mBracketStyle; } + bool tangentToData() const { return mTangentToData; } + int tangentAverage() const { return mTangentAverage; } + + // setters: + void setBracketPen(const QPen &pen); + void setBracketBrush(const QBrush &brush); + void setBracketWidth(int width); + void setBracketHeight(int height); + void setBracketStyle(BracketStyle style); + void setTangentToData(bool enabled); + void setTangentAverage(int pointCount); + + // introduced virtual methods: + virtual void drawBracket(QCPPainter *painter, int direction) const; + + // virtual methods: + virtual void drawDecoration(QCPPainter *painter, QCPDataSelection selection) Q_DECL_OVERRIDE; + +protected: + // property members: + QPen mBracketPen; + QBrush mBracketBrush; + int mBracketWidth; + int mBracketHeight; + BracketStyle mBracketStyle; + bool mTangentToData; + int mTangentAverage; + + // non-virtual methods: + double getTangentAngle(const QCPPlottableInterface1D *interface1d, int dataIndex, int direction) const; + QPointF getPixelCoordinates(const QCPPlottableInterface1D *interface1d, int dataIndex) const; + +}; +Q_DECLARE_METATYPE(QCPSelectionDecoratorBracket::BracketStyle) + +/* end of 'src/selectiondecorator-bracket.h' */ + + +/* including file 'src/layoutelements/layoutelement-axisrect.h' */ +/* modified 2021-03-29T02:30:44, size 7529 */ + +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() Q_DECL_OVERRIDE; + + // getters: + QPixmap background() const { return mBackgroundPixmap; } + QBrush backgroundBrush() const { return mBackgroundBrush; } + 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); + QList rangeDragAxes(Qt::Orientation orientation); + QList rangeZoomAxes(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 setRangeDragAxes(QList axes); + void setRangeDragAxes(QList horizontal, QList vertical); + void setRangeZoomAxes(QCPAxis *horizontal, QCPAxis *vertical); + void setRangeZoomAxes(QList axes); + void setRangeZoomAxes(QList horizontal, QList 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 axes(QCPAxis::AxisTypes types) const; + QList axes() const; + QCPAxis *addAxis(QCPAxis::AxisType type, QCPAxis *axis=nullptr); + QList addAxes(QCPAxis::AxisTypes types); + bool removeAxis(QCPAxis *axis); + QCPLayoutInset *insetLayout() const { return mInsetLayout; } + + void zoom(const QRectF &pixelRect); + void zoom(const QRectF &pixelRect, const QList &affectedAxes); + void setupFullAxesBox(bool connectRanges=false); + QList plottables() const; + QList graphs() const; + QList 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) Q_DECL_OVERRIDE; + virtual QList elements(bool recursive) const Q_DECL_OVERRIDE; + +protected: + // property members: + QBrush mBackgroundBrush; + QPixmap mBackgroundPixmap; + QPixmap mScaledBackgroundPixmap; + bool mBackgroundScaled; + Qt::AspectRatioMode mBackgroundScaledMode; + QCPLayoutInset *mInsetLayout; + Qt::Orientations mRangeDrag, mRangeZoom; + QList > mRangeDragHorzAxis, mRangeDragVertAxis; + QList > mRangeZoomHorzAxis, mRangeZoomVertAxis; + double mRangeZoomFactorHorz, mRangeZoomFactorVert; + + // non-property members: + QList mDragStartHorzRange, mDragStartVertRange; + QCP::AntialiasedElements mAADragBackup, mNotAADragBackup; + bool mDragging; + QHash > mAxes; + + // reimplemented virtual methods: + virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual int calculateAutoMargin(QCP::MarginSide side) Q_DECL_OVERRIDE; + virtual void layoutChanged() Q_DECL_OVERRIDE; + // events: + virtual void mousePressEvent(QMouseEvent *event, const QVariant &details) Q_DECL_OVERRIDE; + virtual void mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; + virtual void mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; + virtual void wheelEvent(QWheelEvent *event) Q_DECL_OVERRIDE; + + // non-property methods: + void drawBackground(QCPPainter *painter); + void updateAxesOffset(QCPAxis::AxisType type); + +private: + Q_DISABLE_COPY(QCPAxisRect) + + friend class QCustomPlot; +}; + + +/* end of 'src/layoutelements/layoutelement-axisrect.h' */ + + +/* including file 'src/layoutelements/layoutelement-legend.h' */ +/* modified 2021-03-29T02:30:44, size 10425 */ + +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=nullptr) const Q_DECL_OVERRIDE; + +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 Q_DECL_OVERRIDE; + virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; + virtual QRect clipRect() const Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE = 0; + // events: + virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE; + virtual void deselectEvent(bool *selectionStateChanged) Q_DECL_OVERRIDE; + +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) Q_DECL_OVERRIDE; + virtual QSize minimumOuterSizeHint() const Q_DECL_OVERRIDE; + + // 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 ///< 0x000 None + ,spLegendBox = 0x001 ///< 0x001 The legend box (frame) + ,spItems = 0x002 ///< 0x002 Legend items individually (see \ref selectedItems) + }; + Q_ENUMS(SelectablePart) + Q_FLAGS(SelectableParts) + Q_DECLARE_FLAGS(SelectableParts, SelectablePart) + + explicit QCPLegend(); + virtual ~QCPLegend() Q_DECL_OVERRIDE; + + // 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=nullptr) const Q_DECL_OVERRIDE; + + // 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 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) Q_DECL_OVERRIDE; + virtual QCP::Interaction selectionCategory() const Q_DECL_OVERRIDE; + virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + // events: + virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE; + virtual void deselectEvent(bool *selectionStateChanged) Q_DECL_OVERRIDE; + + // 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) + +/* end of 'src/layoutelements/layoutelement-legend.h' */ + + +/* including file 'src/layoutelements/layoutelement-textelement.h' */ +/* modified 2021-03-29T02:30:44, size 5359 */ + +class QCP_LIB_DECL QCPTextElement : 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 QCPTextElement(QCustomPlot *parentPlot); + QCPTextElement(QCustomPlot *parentPlot, const QString &text); + QCPTextElement(QCustomPlot *parentPlot, const QString &text, double pointSize); + QCPTextElement(QCustomPlot *parentPlot, const QString &text, const QString &fontFamily, double pointSize); + QCPTextElement(QCustomPlot *parentPlot, const QString &text, const QFont &font); + + // getters: + QString text() const { return mText; } + int textFlags() const { return mTextFlags; } + 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 setTextFlags(int flags); + 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=nullptr) const Q_DECL_OVERRIDE; + virtual void mousePressEvent(QMouseEvent *event, const QVariant &details) Q_DECL_OVERRIDE; + virtual void mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; + virtual void mouseDoubleClickEvent(QMouseEvent *event, const QVariant &details) Q_DECL_OVERRIDE; + +signals: + void selectionChanged(bool selected); + void selectableChanged(bool selectable); + void clicked(QMouseEvent *event); + void doubleClicked(QMouseEvent *event); + +protected: + // property members: + QString mText; + int mTextFlags; + QFont mFont; + QColor mTextColor; + QFont mSelectedFont; + QColor mSelectedTextColor; + QRect mTextBoundingRect; + bool mSelectable, mSelected; + + // reimplemented virtual methods: + virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual QSize minimumOuterSizeHint() const Q_DECL_OVERRIDE; + virtual QSize maximumOuterSizeHint() const Q_DECL_OVERRIDE; + // events: + virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE; + virtual void deselectEvent(bool *selectionStateChanged) Q_DECL_OVERRIDE; + + // non-virtual methods: + QFont mainFont() const; + QColor mainTextColor() const; + +private: + Q_DISABLE_COPY(QCPTextElement) +}; + + + +/* end of 'src/layoutelements/layoutelement-textelement.h' */ + + +/* including file 'src/layoutelements/layoutelement-colorscale.h' */ +/* modified 2021-03-29T02:30:44, size 5939 */ + + +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) Q_DECL_OVERRIDE; + 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() Q_DECL_OVERRIDE; + + // 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 colorMaps() const; + void rescaleDataRange(bool onlyVisibleMaps); + + // reimplemented virtual methods: + virtual void update(UpdatePhase phase) Q_DECL_OVERRIDE; + +signals: + void dataRangeChanged(const QCPRange &newRange); + void dataScaleTypeChanged(QCPAxis::ScaleType scaleType); + void gradientChanged(const QCPColorGradient &newGradient); + +protected: + // property members: + QCPAxis::AxisType mType; + QCPRange mDataRange; + QCPAxis::ScaleType mDataScaleType; + QCPColorGradient mGradient; + int mBarWidth; + + // non-property members: + QPointer mAxisRect; + QPointer mColorAxis; + + // reimplemented virtual methods: + virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; + // events: + virtual void mousePressEvent(QMouseEvent *event, const QVariant &details) Q_DECL_OVERRIDE; + virtual void mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; + virtual void mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; + virtual void wheelEvent(QWheelEvent *event) Q_DECL_OVERRIDE; + +private: + Q_DISABLE_COPY(QCPColorScale) + + friend class QCPColorScaleAxisRectPrivate; +}; + + +/* end of 'src/layoutelements/layoutelement-colorscale.h' */ + + +/* including file 'src/plottables/plottable-graph.h' */ +/* modified 2021-03-29T02:30:44, size 9316 */ + +class QCP_LIB_DECL QCPGraphData +{ +public: + QCPGraphData(); + QCPGraphData(double key, double value); + + inline double sortKey() const { return key; } + inline static QCPGraphData fromSortKey(double sortKey) { return QCPGraphData(sortKey, 0); } + inline static bool sortKeyIsMainKey() { return true; } + + inline double mainKey() const { return key; } + inline double mainValue() const { return value; } + + inline QCPRange valueRange() const { return QCPRange(value, value); } + + double key, value; +}; +Q_DECLARE_TYPEINFO(QCPGraphData, Q_PRIMITIVE_TYPE); + + +/*! \typedef QCPGraphDataContainer + + Container for storing \ref QCPGraphData points. The data is stored sorted by \a key. + + This template instantiation is the container in which QCPGraph holds its data. For details about + the generic container, see the documentation of the class template \ref QCPDataContainer. + + \see QCPGraphData, QCPGraph::setData +*/ +typedef QCPDataContainer QCPGraphDataContainer; + +class QCP_LIB_DECL QCPGraph : public QCPAbstractPlottable1D +{ + Q_OBJECT + /// \cond INCLUDE_QPROPERTIES + Q_PROPERTY(LineStyle lineStyle READ lineStyle WRITE setLineStyle) + Q_PROPERTY(QCPScatterStyle scatterStyle READ scatterStyle WRITE setScatterStyle) + Q_PROPERTY(int scatterSkip READ scatterSkip WRITE setScatterSkip) + 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) + + explicit QCPGraph(QCPAxis *keyAxis, QCPAxis *valueAxis); + virtual ~QCPGraph() Q_DECL_OVERRIDE; + + // getters: + QSharedPointer data() const { return mDataContainer; } + LineStyle lineStyle() const { return mLineStyle; } + QCPScatterStyle scatterStyle() const { return mScatterStyle; } + int scatterSkip() const { return mScatterSkip; } + QCPGraph *channelFillGraph() const { return mChannelFillGraph.data(); } + bool adaptiveSampling() const { return mAdaptiveSampling; } + + // setters: + void setData(QSharedPointer data); + void setData(const QVector &keys, const QVector &values, bool alreadySorted=false); + void setLineStyle(LineStyle ls); + void setScatterStyle(const QCPScatterStyle &style); + void setScatterSkip(int skip); + void setChannelFillGraph(QCPGraph *targetGraph); + void setAdaptiveSampling(bool enabled); + + // non-property methods: + void addData(const QVector &keys, const QVector &values, bool alreadySorted=false); + void addData(double key, double value); + + // reimplemented virtual methods: + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; + virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; + virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; + +protected: + // property members: + LineStyle mLineStyle; + QCPScatterStyle mScatterStyle; + int mScatterSkip; + QPointer mChannelFillGraph; + bool mAdaptiveSampling; + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; + + // introduced virtual methods: + virtual void drawFill(QCPPainter *painter, QVector *lines) const; + virtual void drawScatterPlot(QCPPainter *painter, const QVector &scatters, const QCPScatterStyle &style) const; + virtual void drawLinePlot(QCPPainter *painter, const QVector &lines) const; + virtual void drawImpulsePlot(QCPPainter *painter, const QVector &lines) const; + + virtual void getOptimizedLineData(QVector *lineData, const QCPGraphDataContainer::const_iterator &begin, const QCPGraphDataContainer::const_iterator &end) const; + virtual void getOptimizedScatterData(QVector *scatterData, QCPGraphDataContainer::const_iterator begin, QCPGraphDataContainer::const_iterator end) const; + + // non-virtual methods: + void getVisibleDataBounds(QCPGraphDataContainer::const_iterator &begin, QCPGraphDataContainer::const_iterator &end, const QCPDataRange &rangeRestriction) const; + void getLines(QVector *lines, const QCPDataRange &dataRange) const; + void getScatters(QVector *scatters, const QCPDataRange &dataRange) const; + QVector dataToLines(const QVector &data) const; + QVector dataToStepLeftLines(const QVector &data) const; + QVector dataToStepRightLines(const QVector &data) const; + QVector dataToStepCenterLines(const QVector &data) const; + QVector dataToImpulseLines(const QVector &data) const; + QVector getNonNanSegments(const QVector *lineData, Qt::Orientation keyOrientation) const; + QVector > getOverlappingSegments(QVector thisSegments, const QVector *thisData, QVector otherSegments, const QVector *otherData) const; + bool segmentsIntersect(double aLower, double aUpper, double bLower, double bUpper, int &bPrecedence) const; + QPointF getFillBasePoint(QPointF matchingDataPoint) const; + const QPolygonF getFillPolygon(const QVector *lineData, QCPDataRange segment) const; + const QPolygonF getChannelFillPolygon(const QVector *thisData, QCPDataRange thisSegment, const QVector *otherData, QCPDataRange otherSegment) const; + int findIndexBelowX(const QVector *data, double x) const; + int findIndexAboveX(const QVector *data, double x) const; + int findIndexBelowY(const QVector *data, double y) const; + int findIndexAboveY(const QVector *data, double y) const; + double pointDistance(const QPointF &pixelPoint, QCPGraphDataContainer::const_iterator &closestData) const; + + friend class QCustomPlot; + friend class QCPLegend; +}; +Q_DECLARE_METATYPE(QCPGraph::LineStyle) + +/* end of 'src/plottables/plottable-graph.h' */ + + +/* including file 'src/plottables/plottable-curve.h' */ +/* modified 2021-03-29T02:30:44, size 7434 */ + +class QCP_LIB_DECL QCPCurveData +{ +public: + QCPCurveData(); + QCPCurveData(double t, double key, double value); + + inline double sortKey() const { return t; } + inline static QCPCurveData fromSortKey(double sortKey) { return QCPCurveData(sortKey, 0, 0); } + inline static bool sortKeyIsMainKey() { return false; } + + inline double mainKey() const { return key; } + inline double mainValue() const { return value; } + + inline QCPRange valueRange() const { return QCPRange(value, value); } + + double t, key, value; +}; +Q_DECLARE_TYPEINFO(QCPCurveData, Q_PRIMITIVE_TYPE); + + +/*! \typedef QCPCurveDataContainer + + Container for storing \ref QCPCurveData points. The data is stored sorted by \a t, so the \a + sortKey() (returning \a t) is different from \a mainKey() (returning \a key). + + This template instantiation is the container in which QCPCurve holds its data. For details about + the generic container, see the documentation of the class template \ref QCPDataContainer. + + \see QCPCurveData, QCPCurve::setData +*/ +typedef QCPDataContainer QCPCurveDataContainer; + +class QCP_LIB_DECL QCPCurve : public QCPAbstractPlottable1D +{ + Q_OBJECT + /// \cond INCLUDE_QPROPERTIES + Q_PROPERTY(QCPScatterStyle scatterStyle READ scatterStyle WRITE setScatterStyle) + Q_PROPERTY(int scatterSkip READ scatterSkip WRITE setScatterSkip) + 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 + }; + Q_ENUMS(LineStyle) + + explicit QCPCurve(QCPAxis *keyAxis, QCPAxis *valueAxis); + virtual ~QCPCurve() Q_DECL_OVERRIDE; + + // getters: + QSharedPointer data() const { return mDataContainer; } + QCPScatterStyle scatterStyle() const { return mScatterStyle; } + int scatterSkip() const { return mScatterSkip; } + LineStyle lineStyle() const { return mLineStyle; } + + // setters: + void setData(QSharedPointer data); + void setData(const QVector &t, const QVector &keys, const QVector &values, bool alreadySorted=false); + void setData(const QVector &keys, const QVector &values); + void setScatterStyle(const QCPScatterStyle &style); + void setScatterSkip(int skip); + void setLineStyle(LineStyle style); + + // non-property methods: + void addData(const QVector &t, const QVector &keys, const QVector &values, bool alreadySorted=false); + void addData(const QVector &keys, const QVector &values); + void addData(double t, double key, double value); + void addData(double key, double value); + + // reimplemented virtual methods: + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; + virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; + virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; + +protected: + // property members: + QCPScatterStyle mScatterStyle; + int mScatterSkip; + LineStyle mLineStyle; + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; + + // introduced virtual methods: + virtual void drawCurveLine(QCPPainter *painter, const QVector &lines) const; + virtual void drawScatterPlot(QCPPainter *painter, const QVector &points, const QCPScatterStyle &style) const; + + // non-virtual methods: + void getCurveLines(QVector *lines, const QCPDataRange &dataRange, double penWidth) const; + void getScatters(QVector *scatters, const QCPDataRange &dataRange, double scatterWidth) const; + int getRegion(double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const; + QPointF getOptimizedPoint(int otherRegion, double otherKey, double otherValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const; + QVector getOptimizedCornerPoints(int prevRegion, int currentRegion, double prevKey, double prevValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin) const; + bool mayTraverse(int prevRegion, int currentRegion) const; + bool getTraverse(double prevKey, double prevValue, double key, double value, double keyMin, double valueMax, double keyMax, double valueMin, QPointF &crossA, QPointF &crossB) const; + void getTraverseCornerPoints(int prevRegion, int currentRegion, double keyMin, double valueMax, double keyMax, double valueMin, QVector &beforeTraverse, QVector &afterTraverse) const; + double pointDistance(const QPointF &pixelPoint, QCPCurveDataContainer::const_iterator &closestData) const; + + friend class QCustomPlot; + friend class QCPLegend; +}; +Q_DECLARE_METATYPE(QCPCurve::LineStyle) + +/* end of 'src/plottables/plottable-curve.h' */ + + +/* including file 'src/plottables/plottable-bars.h' */ +/* modified 2021-03-29T02:30:44, size 8955 */ + +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 + }; + Q_ENUMS(SpacingType) + + explicit QCPBarsGroup(QCustomPlot *parentPlot); + virtual ~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 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 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; +}; +Q_DECLARE_METATYPE(QCPBarsGroup::SpacingType) + + +class QCP_LIB_DECL QCPBarsData +{ +public: + QCPBarsData(); + QCPBarsData(double key, double value); + + inline double sortKey() const { return key; } + inline static QCPBarsData fromSortKey(double sortKey) { return QCPBarsData(sortKey, 0); } + inline static bool sortKeyIsMainKey() { return true; } + + inline double mainKey() const { return key; } + inline double mainValue() const { return value; } + + inline QCPRange valueRange() const { return QCPRange(value, value); } // note that bar base value isn't held in each QCPBarsData and thus can't/shouldn't be returned here + + double key, value; +}; +Q_DECLARE_TYPEINFO(QCPBarsData, Q_PRIMITIVE_TYPE); + + +/*! \typedef QCPBarsDataContainer + + Container for storing \ref QCPBarsData points. The data is stored sorted by \a key. + + This template instantiation is the container in which QCPBars holds its data. For details about + the generic container, see the documentation of the class template \ref QCPDataContainer. + + \see QCPBarsData, QCPBars::setData +*/ +typedef QCPDataContainer QCPBarsDataContainer; + +class QCP_LIB_DECL QCPBars : public QCPAbstractPlottable1D +{ + 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(double stackingGap READ stackingGap WRITE setStackingGap) + 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() Q_DECL_OVERRIDE; + + // getters: + double width() const { return mWidth; } + WidthType widthType() const { return mWidthType; } + QCPBarsGroup *barsGroup() const { return mBarsGroup; } + double baseValue() const { return mBaseValue; } + double stackingGap() const { return mStackingGap; } + QCPBars *barBelow() const { return mBarBelow.data(); } + QCPBars *barAbove() const { return mBarAbove.data(); } + QSharedPointer data() const { return mDataContainer; } + + // setters: + void setData(QSharedPointer data); + void setData(const QVector &keys, const QVector &values, bool alreadySorted=false); + void setWidth(double width); + void setWidthType(WidthType widthType); + void setBarsGroup(QCPBarsGroup *barsGroup); + void setBaseValue(double baseValue); + void setStackingGap(double pixels); + + // non-property methods: + void addData(const QVector &keys, const QVector &values, bool alreadySorted=false); + void addData(double key, double value); + void moveBelow(QCPBars *bars); + void moveAbove(QCPBars *bars); + + // reimplemented virtual methods: + virtual QCPDataSelection selectTestRect(const QRectF &rect, bool onlySelectable) const Q_DECL_OVERRIDE; + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; + virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; + virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; + virtual QPointF dataPixelPosition(int index) const Q_DECL_OVERRIDE; + +protected: + // property members: + double mWidth; + WidthType mWidthType; + QCPBarsGroup *mBarsGroup; + double mBaseValue; + double mStackingGap; + QPointer mBarBelow, mBarAbove; + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; + + // non-virtual methods: + void getVisibleDataBounds(QCPBarsDataContainer::const_iterator &begin, QCPBarsDataContainer::const_iterator &end) const; + QRectF getBarRect(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; +}; +Q_DECLARE_METATYPE(QCPBars::WidthType) + +/* end of 'src/plottables/plottable-bars.h' */ + + +/* including file 'src/plottables/plottable-statisticalbox.h' */ +/* modified 2021-03-29T02:30:44, size 7522 */ + +class QCP_LIB_DECL QCPStatisticalBoxData +{ +public: + QCPStatisticalBoxData(); + QCPStatisticalBoxData(double key, double minimum, double lowerQuartile, double median, double upperQuartile, double maximum, const QVector& outliers=QVector()); + + inline double sortKey() const { return key; } + inline static QCPStatisticalBoxData fromSortKey(double sortKey) { return QCPStatisticalBoxData(sortKey, 0, 0, 0, 0, 0); } + inline static bool sortKeyIsMainKey() { return true; } + + inline double mainKey() const { return key; } + inline double mainValue() const { return median; } + + inline QCPRange valueRange() const + { + QCPRange result(minimum, maximum); + for (QVector::const_iterator it = outliers.constBegin(); it != outliers.constEnd(); ++it) + result.expand(*it); + return result; + } + + double key, minimum, lowerQuartile, median, upperQuartile, maximum; + QVector outliers; +}; +Q_DECLARE_TYPEINFO(QCPStatisticalBoxData, Q_MOVABLE_TYPE); + + +/*! \typedef QCPStatisticalBoxDataContainer + + Container for storing \ref QCPStatisticalBoxData points. The data is stored sorted by \a key. + + This template instantiation is the container in which QCPStatisticalBox holds its data. For + details about the generic container, see the documentation of the class template \ref + QCPDataContainer. + + \see QCPStatisticalBoxData, QCPStatisticalBox::setData +*/ +typedef QCPDataContainer QCPStatisticalBoxDataContainer; + +class QCP_LIB_DECL QCPStatisticalBox : public QCPAbstractPlottable1D +{ + Q_OBJECT + /// \cond INCLUDE_QPROPERTIES + 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(bool whiskerAntialiased READ whiskerAntialiased WRITE setWhiskerAntialiased) + 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: + QSharedPointer data() const { return mDataContainer; } + double width() const { return mWidth; } + double whiskerWidth() const { return mWhiskerWidth; } + QPen whiskerPen() const { return mWhiskerPen; } + QPen whiskerBarPen() const { return mWhiskerBarPen; } + bool whiskerAntialiased() const { return mWhiskerAntialiased; } + QPen medianPen() const { return mMedianPen; } + QCPScatterStyle outlierStyle() const { return mOutlierStyle; } + + // setters: + void setData(QSharedPointer data); + void setData(const QVector &keys, const QVector &minimum, const QVector &lowerQuartile, const QVector &median, const QVector &upperQuartile, const QVector &maximum, bool alreadySorted=false); + void setWidth(double width); + void setWhiskerWidth(double width); + void setWhiskerPen(const QPen &pen); + void setWhiskerBarPen(const QPen &pen); + void setWhiskerAntialiased(bool enabled); + void setMedianPen(const QPen &pen); + void setOutlierStyle(const QCPScatterStyle &style); + + // non-property methods: + void addData(const QVector &keys, const QVector &minimum, const QVector &lowerQuartile, const QVector &median, const QVector &upperQuartile, const QVector &maximum, bool alreadySorted=false); + void addData(double key, double minimum, double lowerQuartile, double median, double upperQuartile, double maximum, const QVector &outliers=QVector()); + + // reimplemented virtual methods: + virtual QCPDataSelection selectTestRect(const QRectF &rect, bool onlySelectable) const Q_DECL_OVERRIDE; + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; + virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; + virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; + +protected: + // property members: + double mWidth; + double mWhiskerWidth; + QPen mWhiskerPen, mWhiskerBarPen; + bool mWhiskerAntialiased; + QPen mMedianPen; + QCPScatterStyle mOutlierStyle; + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; + + // introduced virtual methods: + virtual void drawStatisticalBox(QCPPainter *painter, QCPStatisticalBoxDataContainer::const_iterator it, const QCPScatterStyle &outlierStyle) const; + + // non-virtual methods: + void getVisibleDataBounds(QCPStatisticalBoxDataContainer::const_iterator &begin, QCPStatisticalBoxDataContainer::const_iterator &end) const; + QRectF getQuartileBox(QCPStatisticalBoxDataContainer::const_iterator it) const; + QVector getWhiskerBackboneLines(QCPStatisticalBoxDataContainer::const_iterator it) const; + QVector getWhiskerBarLines(QCPStatisticalBoxDataContainer::const_iterator it) const; + + friend class QCustomPlot; + friend class QCPLegend; +}; + +/* end of 'src/plottables/plottable-statisticalbox.h' */ + + +/* including file 'src/plottables/plottable-colormap.h' */ +/* modified 2021-03-29T02:30:44, size 7092 */ + +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); + unsigned char alpha(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); + void setAlpha(int keyIndex, int valueIndex, unsigned char alpha); + + // non-property methods: + void recalculateDataBounds(); + void clear(); + void clearAlpha(); + void fill(double z); + void fillAlpha(unsigned char alpha); + 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; + unsigned char *mAlpha; + QCPRange mDataBounds; + bool mDataModified; + + bool createAlpha(bool initializeOpaque=true); + + 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() Q_DECL_OVERRIDE; + + // 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 double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; + virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; + virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; + +signals: + void dataRangeChanged(const QCPRange &newRange); + void dataScaleTypeChanged(QCPAxis::ScaleType scaleType); + void gradientChanged(const QCPColorGradient &newGradient); + +protected: + // property members: + QCPRange mDataRange; + QCPAxis::ScaleType mDataScaleType; + QCPColorMapData *mMapData; + QCPColorGradient mGradient; + bool mInterpolate; + bool mTightBoundary; + QPointer mColorScale; + + // non-property members: + QImage mMapImage, mUndersampledMapImage; + QPixmap mLegendIcon; + bool mMapImageInvalidated; + + // introduced virtual methods: + virtual void updateMapImage(); + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; + + friend class QCustomPlot; + friend class QCPLegend; +}; + +/* end of 'src/plottables/plottable-colormap.h' */ + + +/* including file 'src/plottables/plottable-financial.h' */ +/* modified 2021-03-29T02:30:44, size 8644 */ + +class QCP_LIB_DECL QCPFinancialData +{ +public: + QCPFinancialData(); + QCPFinancialData(double key, double open, double high, double low, double close); + + inline double sortKey() const { return key; } + inline static QCPFinancialData fromSortKey(double sortKey) { return QCPFinancialData(sortKey, 0, 0, 0, 0); } + inline static bool sortKeyIsMainKey() { return true; } + + inline double mainKey() const { return key; } + inline double mainValue() const { return open; } + + inline QCPRange valueRange() const { return QCPRange(low, high); } // open and close must lie between low and high, so we don't need to check them + + double key, open, high, low, close; +}; +Q_DECLARE_TYPEINFO(QCPFinancialData, Q_PRIMITIVE_TYPE); + + +/*! \typedef QCPFinancialDataContainer + + Container for storing \ref QCPFinancialData points. The data is stored sorted by \a key. + + This template instantiation is the container in which QCPFinancial holds its data. For details + about the generic container, see the documentation of the class template \ref QCPDataContainer. + + \see QCPFinancialData, QCPFinancial::setData +*/ +typedef QCPDataContainer QCPFinancialDataContainer; + +class QCP_LIB_DECL QCPFinancial : public QCPAbstractPlottable1D +{ + Q_OBJECT + /// \cond INCLUDE_QPROPERTIES + Q_PROPERTY(ChartStyle chartStyle READ chartStyle WRITE setChartStyle) + Q_PROPERTY(double width READ width WRITE setWidth) + Q_PROPERTY(WidthType widthType READ widthType WRITE setWidthType) + 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 ways the width of the financial bar can be specified. Thus it defines what the + number passed to \ref setWidth actually means. + + \see setWidthType, setWidth + */ + enum WidthType { wtAbsolute ///< width is in absolute pixels + ,wtAxisRectRatio ///< width is given by a fraction of the axis rect size + ,wtPlotCoords ///< width is in key coordinates and thus scales with the key axis range + }; + Q_ENUMS(WidthType) + + /*! + 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() Q_DECL_OVERRIDE; + + // getters: + QSharedPointer data() const { return mDataContainer; } + ChartStyle chartStyle() const { return mChartStyle; } + double width() const { return mWidth; } + WidthType widthType() const { return mWidthType; } + 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(QSharedPointer data); + void setData(const QVector &keys, const QVector &open, const QVector &high, const QVector &low, const QVector &close, bool alreadySorted=false); + void setChartStyle(ChartStyle style); + void setWidth(double width); + void setWidthType(WidthType widthType); + 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 QVector &keys, const QVector &open, const QVector &high, const QVector &low, const QVector &close, bool alreadySorted=false); + void addData(double key, double open, double high, double low, double close); + + // reimplemented virtual methods: + virtual QCPDataSelection selectTestRect(const QRectF &rect, bool onlySelectable) const Q_DECL_OVERRIDE; + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; + virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; + virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; + + // static methods: + static QCPFinancialDataContainer timeSeriesToOhlc(const QVector &time, const QVector &value, double timeBinSize, double timeBinOffset = 0); + +protected: + // property members: + ChartStyle mChartStyle; + double mWidth; + WidthType mWidthType; + bool mTwoColored; + QBrush mBrushPositive, mBrushNegative; + QPen mPenPositive, mPenNegative; + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; + + // non-virtual methods: + void drawOhlcPlot(QCPPainter *painter, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, bool isSelected); + void drawCandlestickPlot(QCPPainter *painter, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, bool isSelected); + double getPixelWidth(double key, double keyPixel) const; + double ohlcSelectTest(const QPointF &pos, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, QCPFinancialDataContainer::const_iterator &closestDataPoint) const; + double candlestickSelectTest(const QPointF &pos, const QCPFinancialDataContainer::const_iterator &begin, const QCPFinancialDataContainer::const_iterator &end, QCPFinancialDataContainer::const_iterator &closestDataPoint) const; + void getVisibleDataBounds(QCPFinancialDataContainer::const_iterator &begin, QCPFinancialDataContainer::const_iterator &end) const; + QRectF selectionHitBox(QCPFinancialDataContainer::const_iterator it) const; + + friend class QCustomPlot; + friend class QCPLegend; +}; +Q_DECLARE_METATYPE(QCPFinancial::ChartStyle) + +/* end of 'src/plottables/plottable-financial.h' */ + + +/* including file 'src/plottables/plottable-errorbar.h' */ +/* modified 2021-03-29T02:30:44, size 7749 */ + +class QCP_LIB_DECL QCPErrorBarsData +{ +public: + QCPErrorBarsData(); + explicit QCPErrorBarsData(double error); + QCPErrorBarsData(double errorMinus, double errorPlus); + + double errorMinus, errorPlus; +}; +Q_DECLARE_TYPEINFO(QCPErrorBarsData, Q_PRIMITIVE_TYPE); + + +/*! \typedef QCPErrorBarsDataContainer + + Container for storing \ref QCPErrorBarsData points. It is a typedef for QVector<\ref + QCPErrorBarsData>. + + This is the container in which \ref QCPErrorBars holds its data. Unlike most other data + containers for plottables, it is not based on \ref QCPDataContainer. This is because the error + bars plottable is special in that it doesn't store its own key and value coordinate per error + bar. It adopts the key and value from the plottable to which the error bars shall be applied + (\ref QCPErrorBars::setDataPlottable). So the stored \ref QCPErrorBarsData doesn't need a + sortable key, but merely an index (as \c QVector provides), which maps one-to-one to the indices + of the other plottable's data. + + \see QCPErrorBarsData, QCPErrorBars::setData +*/ +typedef QVector QCPErrorBarsDataContainer; + +class QCP_LIB_DECL QCPErrorBars : public QCPAbstractPlottable, public QCPPlottableInterface1D +{ + Q_OBJECT + /// \cond INCLUDE_QPROPERTIES + Q_PROPERTY(QSharedPointer data READ data WRITE setData) + Q_PROPERTY(QCPAbstractPlottable* dataPlottable READ dataPlottable WRITE setDataPlottable) + Q_PROPERTY(ErrorType errorType READ errorType WRITE setErrorType) + Q_PROPERTY(double whiskerWidth READ whiskerWidth WRITE setWhiskerWidth) + Q_PROPERTY(double symbolGap READ symbolGap WRITE setSymbolGap) + /// \endcond +public: + + /*! + Defines in which orientation the error bars shall appear. If your data needs both error + dimensions, create two \ref QCPErrorBars with different \ref ErrorType. + + \see setErrorType + */ + enum ErrorType { etKeyError ///< The errors are for the key dimension (bars appear parallel to the key axis) + ,etValueError ///< The errors are for the value dimension (bars appear parallel to the value axis) + }; + Q_ENUMS(ErrorType) + + explicit QCPErrorBars(QCPAxis *keyAxis, QCPAxis *valueAxis); + virtual ~QCPErrorBars() Q_DECL_OVERRIDE; + // getters: + QSharedPointer data() const { return mDataContainer; } + QCPAbstractPlottable *dataPlottable() const { return mDataPlottable.data(); } + ErrorType errorType() const { return mErrorType; } + double whiskerWidth() const { return mWhiskerWidth; } + double symbolGap() const { return mSymbolGap; } + + // setters: + void setData(QSharedPointer data); + void setData(const QVector &error); + void setData(const QVector &errorMinus, const QVector &errorPlus); + void setDataPlottable(QCPAbstractPlottable* plottable); + void setErrorType(ErrorType type); + void setWhiskerWidth(double pixels); + void setSymbolGap(double pixels); + + // non-property methods: + void addData(const QVector &error); + void addData(const QVector &errorMinus, const QVector &errorPlus); + void addData(double error); + void addData(double errorMinus, double errorPlus); + + // virtual methods of 1d plottable interface: + virtual int dataCount() const Q_DECL_OVERRIDE; + virtual double dataMainKey(int index) const Q_DECL_OVERRIDE; + virtual double dataSortKey(int index) const Q_DECL_OVERRIDE; + virtual double dataMainValue(int index) const Q_DECL_OVERRIDE; + virtual QCPRange dataValueRange(int index) const Q_DECL_OVERRIDE; + virtual QPointF dataPixelPosition(int index) const Q_DECL_OVERRIDE; + virtual bool sortKeyIsMainKey() const Q_DECL_OVERRIDE; + virtual QCPDataSelection selectTestRect(const QRectF &rect, bool onlySelectable) const Q_DECL_OVERRIDE; + virtual int findBegin(double sortKey, bool expandedRange=true) const Q_DECL_OVERRIDE; + virtual int findEnd(double sortKey, bool expandedRange=true) const Q_DECL_OVERRIDE; + + // reimplemented virtual methods: + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=nullptr) const Q_DECL_OVERRIDE; + virtual QCPPlottableInterface1D *interface1D() Q_DECL_OVERRIDE { return this; } + +protected: + // property members: + QSharedPointer mDataContainer; + QPointer mDataPlottable; + ErrorType mErrorType; + double mWhiskerWidth; + double mSymbolGap; + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const Q_DECL_OVERRIDE; + virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const Q_DECL_OVERRIDE; + virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const Q_DECL_OVERRIDE; + + // non-virtual methods: + void getErrorBarLines(QCPErrorBarsDataContainer::const_iterator it, QVector &backbones, QVector &whiskers) const; + void getVisibleDataBounds(QCPErrorBarsDataContainer::const_iterator &begin, QCPErrorBarsDataContainer::const_iterator &end, const QCPDataRange &rangeRestriction) const; + double pointDistance(const QPointF &pixelPoint, QCPErrorBarsDataContainer::const_iterator &closestData) const; + // helpers: + void getDataSegments(QList &selectedSegments, QList &unselectedSegments) const; + bool errorBarVisible(int index) const; + bool rectIntersectsLine(const QRectF &pixelRect, const QLineF &line) const; + + friend class QCustomPlot; + friend class QCPLegend; +}; + +/* end of 'src/plottables/plottable-errorbar.h' */ + + +/* including file 'src/items/item-straightline.h' */ +/* modified 2021-03-29T02:30:44, size 3137 */ + +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: + explicit QCPItemStraightLine(QCustomPlot *parentPlot); + virtual ~QCPItemStraightLine() Q_DECL_OVERRIDE; + + // 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=nullptr) const Q_DECL_OVERRIDE; + + QCPItemPosition * const point1; + QCPItemPosition * const point2; + +protected: + // property members: + QPen mPen, mSelectedPen; + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + + // non-virtual methods: + QLineF getRectClippedStraightLine(const QCPVector2D &base, const QCPVector2D &vec, const QRect &rect) const; + QPen mainPen() const; +}; + +/* end of 'src/items/item-straightline.h' */ + + +/* including file 'src/items/item-line.h' */ +/* modified 2021-03-29T02:30:44, size 3429 */ + +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: + explicit QCPItemLine(QCustomPlot *parentPlot); + virtual ~QCPItemLine() Q_DECL_OVERRIDE; + + // 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=nullptr) const Q_DECL_OVERRIDE; + + QCPItemPosition * const start; + QCPItemPosition * const end; + +protected: + // property members: + QPen mPen, mSelectedPen; + QCPLineEnding mHead, mTail; + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + + // non-virtual methods: + QLineF getRectClippedLine(const QCPVector2D &start, const QCPVector2D &end, const QRect &rect) const; + QPen mainPen() const; +}; + +/* end of 'src/items/item-line.h' */ + + +/* including file 'src/items/item-curve.h' */ +/* modified 2021-03-29T02:30:44, size 3401 */ + +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: + explicit QCPItemCurve(QCustomPlot *parentPlot); + virtual ~QCPItemCurve() Q_DECL_OVERRIDE; + + // 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=nullptr) const Q_DECL_OVERRIDE; + + 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) Q_DECL_OVERRIDE; + + // non-virtual methods: + QPen mainPen() const; +}; + +/* end of 'src/items/item-curve.h' */ + + +/* including file 'src/items/item-rect.h' */ +/* modified 2021-03-29T02:30:44, size 3710 */ + +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: + explicit QCPItemRect(QCustomPlot *parentPlot); + virtual ~QCPItemRect() Q_DECL_OVERRIDE; + + // 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=nullptr) const Q_DECL_OVERRIDE; + + 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) Q_DECL_OVERRIDE; + virtual QPointF anchorPixelPosition(int anchorId) const Q_DECL_OVERRIDE; + + // non-virtual methods: + QPen mainPen() const; + QBrush mainBrush() const; +}; + +/* end of 'src/items/item-rect.h' */ + + +/* including file 'src/items/item-text.h' */ +/* modified 2021-03-29T02:30:44, size 5576 */ + +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: + explicit QCPItemText(QCustomPlot *parentPlot); + virtual ~QCPItemText() Q_DECL_OVERRIDE; + + // 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=nullptr) const Q_DECL_OVERRIDE; + + 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) Q_DECL_OVERRIDE; + virtual QPointF anchorPixelPosition(int anchorId) const Q_DECL_OVERRIDE; + + // 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; +}; + +/* end of 'src/items/item-text.h' */ + + +/* including file 'src/items/item-ellipse.h' */ +/* modified 2021-03-29T02:30:44, size 3890 */ + +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: + explicit QCPItemEllipse(QCustomPlot *parentPlot); + virtual ~QCPItemEllipse() Q_DECL_OVERRIDE; + + // 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=nullptr) const Q_DECL_OVERRIDE; + + 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) Q_DECL_OVERRIDE; + virtual QPointF anchorPixelPosition(int anchorId) const Q_DECL_OVERRIDE; + + // non-virtual methods: + QPen mainPen() const; + QBrush mainBrush() const; +}; + +/* end of 'src/items/item-ellipse.h' */ + + +/* including file 'src/items/item-pixmap.h' */ +/* modified 2021-03-29T02:30:44, size 4407 */ + +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: + explicit QCPItemPixmap(QCustomPlot *parentPlot); + virtual ~QCPItemPixmap() Q_DECL_OVERRIDE; + + // 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=nullptr) const Q_DECL_OVERRIDE; + + 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; + bool mScaledPixmapInvalidated; + Qt::AspectRatioMode mAspectRatioMode; + Qt::TransformationMode mTransformationMode; + QPen mPen, mSelectedPen; + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual QPointF anchorPixelPosition(int anchorId) const Q_DECL_OVERRIDE; + + // non-virtual methods: + void updateScaledPixmap(QRect finalRect=QRect(), bool flipHorz=false, bool flipVert=false); + QRect getFinalRect(bool *flippedHorz=nullptr, bool *flippedVert=nullptr) const; + QPen mainPen() const; +}; + +/* end of 'src/items/item-pixmap.h' */ + + +/* including file 'src/items/item-tracer.h' */ +/* modified 2021-03-29T02:30:44, size 4811 */ + +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) + + explicit QCPItemTracer(QCustomPlot *parentPlot); + virtual ~QCPItemTracer() Q_DECL_OVERRIDE; + + // 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=nullptr) const Q_DECL_OVERRIDE; + + // 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) Q_DECL_OVERRIDE; + + // non-virtual methods: + QPen mainPen() const; + QBrush mainBrush() const; +}; +Q_DECLARE_METATYPE(QCPItemTracer::TracerStyle) + +/* end of 'src/items/item-tracer.h' */ + + +/* including file 'src/items/item-bracket.h' */ +/* modified 2021-03-29T02:30:44, size 3991 */ + +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: + /*! + Defines the various visual shapes of the bracket item. The appearance can be further modified + by \ref setLength and \ref setPen. + + \see setStyle + */ + 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 + }; + Q_ENUMS(BracketStyle) + + explicit QCPItemBracket(QCustomPlot *parentPlot); + virtual ~QCPItemBracket() Q_DECL_OVERRIDE; + + // 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=nullptr) const Q_DECL_OVERRIDE; + + 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) Q_DECL_OVERRIDE; + virtual QPointF anchorPixelPosition(int anchorId) const Q_DECL_OVERRIDE; + + // non-virtual methods: + QPen mainPen() const; +}; +Q_DECLARE_METATYPE(QCPItemBracket::BracketStyle) + +/* end of 'src/items/item-bracket.h' */ + + +/* including file 'src/polar/radialaxis.h' */ +/* modified 2021-03-29T02:30:44, size 12227 */ + + +class QCP_LIB_DECL QCPPolarAxisRadial : public QCPLayerable +{ + Q_OBJECT + /// \cond INCLUDE_QPROPERTIES + + /// \endcond +public: + /*! + Defines the reference of the angle at which a radial axis is tilted (\ref setAngle). + */ + enum AngleReference { arAbsolute ///< The axis tilt is given in absolute degrees. The zero is to the right and positive angles are measured counter-clockwise. + ,arAngularAxis ///< The axis tilt is measured in the angular coordinate system given by the parent angular axis. + }; + Q_ENUMS(AngleReference) + /*! + Defines the scale of an axis. + \see setScaleType + */ + enum ScaleType { stLinear ///< Linear scaling + ,stLogarithmic ///< Logarithmic scaling with correspondingly transformed axis coordinates (possibly also \ref setTicker to a \ref QCPAxisTickerLog instance). + }; + 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_ENUMS(SelectablePart) + Q_FLAGS(SelectableParts) + Q_DECLARE_FLAGS(SelectableParts, SelectablePart) + + enum LabelMode { lmUpright ///< + ,lmRotated ///< + }; + Q_ENUMS(LabelMode) + + explicit QCPPolarAxisRadial(QCPPolarAxisAngular *parent); + virtual ~QCPPolarAxisRadial(); + + // getters: + bool rangeDrag() const { return mRangeDrag; } + bool rangeZoom() const { return mRangeZoom; } + double rangeZoomFactor() const { return mRangeZoomFactor; } + + QCPPolarAxisAngular *angularAxis() const { return mAngularAxis; } + ScaleType scaleType() const { return mScaleType; } + const QCPRange range() const { return mRange; } + bool rangeReversed() const { return mRangeReversed; } + double angle() const { return mAngle; } + AngleReference angleReference() const { return mAngleReference; } + QSharedPointer ticker() const { return mTicker; } + bool ticks() const { return mTicks; } + bool tickLabels() const { return mTickLabels; } + int tickLabelPadding() const { return mLabelPainter.padding(); } + QFont tickLabelFont() const { return mTickLabelFont; } + QColor tickLabelColor() const { return mTickLabelColor; } + double tickLabelRotation() const { return mLabelPainter.rotation(); } + LabelMode tickLabelMode() const; + QString numberFormat() const; + int numberPrecision() const { return mNumberPrecision; } + QVector tickVector() const { return mTickVector; } + QVector subTickVector() const { return mSubTickVector; } + QVector tickVectorLabels() const { return mTickVectorLabels; } + int tickLengthIn() const; + int tickLengthOut() const; + bool subTicks() const { return mSubTicks; } + 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; + 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; } + + // setters: + void setRangeDrag(bool enabled); + void setRangeZoom(bool enabled); + void setRangeZoomFactor(double factor); + + Q_SLOT void setScaleType(QCPPolarAxisRadial::ScaleType type); + 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 setAngle(double degrees); + void setAngleReference(AngleReference reference); + void setTicker(QSharedPointer ticker); + void setTicks(bool show); + void setTickLabels(bool show); + void setTickLabelPadding(int padding); + void setTickLabelFont(const QFont &font); + void setTickLabelColor(const QColor &color); + void setTickLabelRotation(double degrees); + void setTickLabelMode(LabelMode mode); + void setNumberFormat(const QString &formatCode); + void setNumberPrecision(int precision); + void setTickLength(int inside, int outside=0); + void setTickLengthIn(int inside); + void setTickLengthOut(int outside); + void setSubTicks(bool show); + 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 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 QCPPolarAxisRadial::SelectableParts &selectableParts); + Q_SLOT void setSelectedParts(const QCPPolarAxisRadial::SelectableParts &selectedParts); + + // reimplemented virtual methods: + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const Q_DECL_OVERRIDE; + + // non-property methods: + void moveRange(double diff); + void scaleRange(double factor); + void scaleRange(double factor, double center); + void rescale(bool onlyVisiblePlottables=false); + void pixelToCoord(QPointF pixelPos, double &angleCoord, double &radiusCoord) const; + QPointF coordToPixel(double angleCoord, double radiusCoord) const; + double coordToRadius(double coord) const; + double radiusToCoord(double radius) const; + SelectablePart getPartAt(const QPointF &pos) const; + +signals: + void rangeChanged(const QCPRange &newRange); + void rangeChanged(const QCPRange &newRange, const QCPRange &oldRange); + void scaleTypeChanged(QCPPolarAxisRadial::ScaleType scaleType); + void selectionChanged(const QCPPolarAxisRadial::SelectableParts &parts); + void selectableChanged(const QCPPolarAxisRadial::SelectableParts &parts); + +protected: + // property members: + bool mRangeDrag; + bool mRangeZoom; + double mRangeZoomFactor; + + // axis base: + QCPPolarAxisAngular *mAngularAxis; + double mAngle; + AngleReference mAngleReference; + SelectableParts mSelectableParts, mSelectedParts; + QPen mBasePen, mSelectedBasePen; + // axis label: + int mLabelPadding; + QString mLabel; + QFont mLabelFont, mSelectedLabelFont; + QColor mLabelColor, mSelectedLabelColor; + // tick labels: + //int mTickLabelPadding; in label painter + bool mTickLabels; + //double mTickLabelRotation; in label painter + QFont mTickLabelFont, mSelectedTickLabelFont; + QColor mTickLabelColor, mSelectedTickLabelColor; + int mNumberPrecision; + QLatin1Char mNumberFormatChar; + bool mNumberBeautifulPowers; + bool mNumberMultiplyCross; + // ticks and subticks: + bool mTicks; + bool mSubTicks; + int mTickLengthIn, mTickLengthOut, mSubTickLengthIn, mSubTickLengthOut; + QPen mTickPen, mSelectedTickPen; + QPen mSubTickPen, mSelectedSubTickPen; + // scale and range: + QCPRange mRange; + bool mRangeReversed; + ScaleType mScaleType; + + // non-property members: + QPointF mCenter; + double mRadius; + QSharedPointer mTicker; + QVector mTickVector; + QVector mTickVectorLabels; + QVector mSubTickVector; + bool mDragging; + QCPRange mDragStartRange; + QCP::AntialiasedElements mAADragBackup, mNotAADragBackup; + QCPLabelPainterPrivate mLabelPainter; + + // reimplemented virtual methods: + virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual QCP::Interaction selectionCategory() const Q_DECL_OVERRIDE; + // events: + virtual void selectEvent(QMouseEvent *event, bool additive, const QVariant &details, bool *selectionStateChanged) Q_DECL_OVERRIDE; + virtual void deselectEvent(bool *selectionStateChanged) Q_DECL_OVERRIDE; + // mouse events: + virtual void mousePressEvent(QMouseEvent *event, const QVariant &details) Q_DECL_OVERRIDE; + virtual void mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; + virtual void mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; + virtual void wheelEvent(QWheelEvent *event) Q_DECL_OVERRIDE; + + // non-virtual methods: + void updateGeometry(const QPointF ¢er, double radius); + void setupTickVectors(); + 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(QCPPolarAxisRadial) + + friend class QCustomPlot; + friend class QCPPolarAxisAngular; +}; +Q_DECLARE_OPERATORS_FOR_FLAGS(QCPPolarAxisRadial::SelectableParts) +Q_DECLARE_METATYPE(QCPPolarAxisRadial::AngleReference) +Q_DECLARE_METATYPE(QCPPolarAxisRadial::ScaleType) +Q_DECLARE_METATYPE(QCPPolarAxisRadial::SelectablePart) + + + +/* end of 'src/polar/radialaxis.h' */ + + +/* including file 'src/polar/layoutelement-angularaxis.h' */ +/* modified 2021-03-29T02:30:44, size 13461 */ + +class QCP_LIB_DECL QCPPolarAxisAngular : public QCPLayoutElement +{ + Q_OBJECT + /// \cond INCLUDE_QPROPERTIES + + /// \endcond +public: + /*! + 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_ENUMS(SelectablePart) + Q_FLAGS(SelectableParts) + Q_DECLARE_FLAGS(SelectableParts, SelectablePart) + + /*! + TODO + */ + enum LabelMode { lmUpright ///< + ,lmRotated ///< + }; + Q_ENUMS(LabelMode) + + explicit QCPPolarAxisAngular(QCustomPlot *parentPlot); + virtual ~QCPPolarAxisAngular(); + + // getters: + QPixmap background() const { return mBackgroundPixmap; } + QBrush backgroundBrush() const { return mBackgroundBrush; } + bool backgroundScaled() const { return mBackgroundScaled; } + Qt::AspectRatioMode backgroundScaledMode() const { return mBackgroundScaledMode; } + bool rangeDrag() const { return mRangeDrag; } + bool rangeZoom() const { return mRangeZoom; } + double rangeZoomFactor() const { return mRangeZoomFactor; } + + const QCPRange range() const { return mRange; } + bool rangeReversed() const { return mRangeReversed; } + double angle() const { return mAngle; } + QSharedPointer ticker() const { return mTicker; } + bool ticks() const { return mTicks; } + bool tickLabels() const { return mTickLabels; } + int tickLabelPadding() const { return mLabelPainter.padding(); } + QFont tickLabelFont() const { return mTickLabelFont; } + QColor tickLabelColor() const { return mTickLabelColor; } + double tickLabelRotation() const { return mLabelPainter.rotation(); } + LabelMode tickLabelMode() const; + QString numberFormat() const; + int numberPrecision() const { return mNumberPrecision; } + QVector tickVector() const { return mTickVector; } + QVector tickVectorLabels() const { return mTickVectorLabels; } + int tickLengthIn() const { return mTickLengthIn; } + int tickLengthOut() const { return mTickLengthOut; } + bool subTicks() const { return mSubTicks; } + int subTickLengthIn() const { return mSubTickLengthIn; } + int subTickLengthOut() const { return mSubTickLengthOut; } + 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 { return mLabelPadding; } + 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; } + QCPPolarGrid *grid() const { return mGrid; } + + // 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(bool enabled); + void setRangeZoom(bool enabled); + void setRangeZoomFactor(double factor); + + 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 setAngle(double degrees); + void setTicker(QSharedPointer ticker); + void setTicks(bool show); + void setTickLabels(bool show); + void setTickLabelPadding(int padding); + void setTickLabelFont(const QFont &font); + void setTickLabelColor(const QColor &color); + void setTickLabelRotation(double degrees); + void setTickLabelMode(LabelMode mode); + void setNumberFormat(const QString &formatCode); + void setNumberPrecision(int precision); + void setTickLength(int inside, int outside=0); + void setTickLengthIn(int inside); + void setTickLengthOut(int outside); + void setSubTicks(bool show); + 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 setLabelPosition(Qt::AlignmentFlag position); + 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 QCPPolarAxisAngular::SelectableParts &selectableParts); + Q_SLOT void setSelectedParts(const QCPPolarAxisAngular::SelectableParts &selectedParts); + + // reimplemented virtual methods: + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const Q_DECL_OVERRIDE; + virtual void update(UpdatePhase phase) Q_DECL_OVERRIDE; + virtual QList elements(bool recursive) const Q_DECL_OVERRIDE; + + // non-property methods: + bool removeGraph(QCPPolarGraph *graph); + int radialAxisCount() const; + QCPPolarAxisRadial *radialAxis(int index=0) const; + QList radialAxes() const; + QCPPolarAxisRadial *addRadialAxis(QCPPolarAxisRadial *axis=0); + bool removeRadialAxis(QCPPolarAxisRadial *axis); + QCPLayoutInset *insetLayout() const { return mInsetLayout; } + QRegion exactClipRegion() const; + + void moveRange(double diff); + void scaleRange(double factor); + void scaleRange(double factor, double center); + void rescale(bool onlyVisiblePlottables=false); + double coordToAngleRad(double coord) const { return mAngleRad+(coord-mRange.lower)/mRange.size()*(mRangeReversed ? -2.0*M_PI : 2.0*M_PI); } // mention in doc that return doesn't wrap + double angleRadToCoord(double angleRad) const { return mRange.lower+(angleRad-mAngleRad)/(mRangeReversed ? -2.0*M_PI : 2.0*M_PI)*mRange.size(); } + void pixelToCoord(QPointF pixelPos, double &angleCoord, double &radiusCoord) const; + QPointF coordToPixel(double angleCoord, double radiusCoord) const; + SelectablePart getPartAt(const QPointF &pos) 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(); } + QPointF center() const { return mCenter; } + double radius() const { return mRadius; } + +signals: + void rangeChanged(const QCPRange &newRange); + void rangeChanged(const QCPRange &newRange, const QCPRange &oldRange); + void selectionChanged(const QCPPolarAxisAngular::SelectableParts &parts); + void selectableChanged(const QCPPolarAxisAngular::SelectableParts &parts); + +protected: + // property members: + QBrush mBackgroundBrush; + QPixmap mBackgroundPixmap; + QPixmap mScaledBackgroundPixmap; + bool mBackgroundScaled; + Qt::AspectRatioMode mBackgroundScaledMode; + QCPLayoutInset *mInsetLayout; + bool mRangeDrag; + bool mRangeZoom; + double mRangeZoomFactor; + + // axis base: + double mAngle, mAngleRad; + SelectableParts mSelectableParts, mSelectedParts; + QPen mBasePen, mSelectedBasePen; + // axis label: + int mLabelPadding; + QString mLabel; + QFont mLabelFont, mSelectedLabelFont; + QColor mLabelColor, mSelectedLabelColor; + // tick labels: + //int mTickLabelPadding; in label painter + bool mTickLabels; + //double mTickLabelRotation; in label painter + QFont mTickLabelFont, mSelectedTickLabelFont; + QColor mTickLabelColor, mSelectedTickLabelColor; + int mNumberPrecision; + QLatin1Char mNumberFormatChar; + bool mNumberBeautifulPowers; + bool mNumberMultiplyCross; + // ticks and subticks: + bool mTicks; + bool mSubTicks; + int mTickLengthIn, mTickLengthOut, mSubTickLengthIn, mSubTickLengthOut; + QPen mTickPen, mSelectedTickPen; + QPen mSubTickPen, mSelectedSubTickPen; + // scale and range: + QCPRange mRange; + bool mRangeReversed; + + // non-property members: + QPointF mCenter; + double mRadius; + QList mRadialAxes; + QCPPolarGrid *mGrid; + QList mGraphs; + QSharedPointer mTicker; + QVector mTickVector; + QVector mTickVectorLabels; + QVector mTickVectorCosSin; + QVector mSubTickVector; + QVector mSubTickVectorCosSin; + bool mDragging; + QCPRange mDragAngularStart; + QList mDragRadialStart; + QCP::AntialiasedElements mAADragBackup, mNotAADragBackup; + QCPLabelPainterPrivate mLabelPainter; + + // reimplemented virtual methods: + virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual QCP::Interaction selectionCategory() const Q_DECL_OVERRIDE; + // events: + virtual void mousePressEvent(QMouseEvent *event, const QVariant &details) Q_DECL_OVERRIDE; + virtual void mouseMoveEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; + virtual void mouseReleaseEvent(QMouseEvent *event, const QPointF &startPos) Q_DECL_OVERRIDE; + virtual void wheelEvent(QWheelEvent *event) Q_DECL_OVERRIDE; + + // non-virtual methods: + bool registerPolarGraph(QCPPolarGraph *graph); + void drawBackground(QCPPainter *painter, const QPointF ¢er, double radius); + void setupTickVectors(); + 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(QCPPolarAxisAngular) + + friend class QCustomPlot; + friend class QCPPolarGrid; + friend class QCPPolarGraph; +}; +Q_DECLARE_OPERATORS_FOR_FLAGS(QCPPolarAxisAngular::SelectableParts) +Q_DECLARE_METATYPE(QCPPolarAxisAngular::SelectablePart) + +/* end of 'src/polar/layoutelement-angularaxis.h' */ + + +/* including file 'src/polar/polargrid.h' */ +/* modified 2021-03-29T02:30:44, size 4506 */ + +class QCP_LIB_DECL QCPPolarGrid :public QCPLayerable +{ + Q_OBJECT + /// \cond INCLUDE_QPROPERTIES + + /// \endcond +public: + /*! + TODO + */ + enum GridType { gtAngular = 0x01 ///< + ,gtRadial = 0x02 ///< + ,gtAll = 0xFF ///< + ,gtNone = 0x00 ///< + }; + Q_ENUMS(GridType) + Q_FLAGS(GridTypes) + Q_DECLARE_FLAGS(GridTypes, GridType) + + explicit QCPPolarGrid(QCPPolarAxisAngular *parentAxis); + + // getters: + QCPPolarAxisRadial *radialAxis() const { return mRadialAxis.data(); } + GridTypes type() const { return mType; } + GridTypes subGridType() const { return mSubGridType; } + bool antialiasedSubGrid() const { return mAntialiasedSubGrid; } + bool antialiasedZeroLine() const { return mAntialiasedZeroLine; } + QPen angularPen() const { return mAngularPen; } + QPen angularSubGridPen() const { return mAngularSubGridPen; } + QPen radialPen() const { return mRadialPen; } + QPen radialSubGridPen() const { return mRadialSubGridPen; } + QPen radialZeroLinePen() const { return mRadialZeroLinePen; } + + // setters: + void setRadialAxis(QCPPolarAxisRadial *axis); + void setType(GridTypes type); + void setSubGridType(GridTypes type); + void setAntialiasedSubGrid(bool enabled); + void setAntialiasedZeroLine(bool enabled); + void setAngularPen(const QPen &pen); + void setAngularSubGridPen(const QPen &pen); + void setRadialPen(const QPen &pen); + void setRadialSubGridPen(const QPen &pen); + void setRadialZeroLinePen(const QPen &pen); + +protected: + // property members: + GridTypes mType; + GridTypes mSubGridType; + bool mAntialiasedSubGrid, mAntialiasedZeroLine; + QPen mAngularPen, mAngularSubGridPen; + QPen mRadialPen, mRadialSubGridPen, mRadialZeroLinePen; + + // non-property members: + QCPPolarAxisAngular *mParentAxis; + QPointer mRadialAxis; + + // reimplemented virtual methods: + virtual void applyDefaultAntialiasingHint(QCPPainter *painter) const Q_DECL_OVERRIDE; + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + + // non-virtual methods: + void drawRadialGrid(QCPPainter *painter, const QPointF ¢er, const QVector &coords, const QPen &pen, const QPen &zeroPen=Qt::NoPen); + void drawAngularGrid(QCPPainter *painter, const QPointF ¢er, double radius, const QVector &ticksCosSin, const QPen &pen); + +private: + Q_DISABLE_COPY(QCPPolarGrid) + +}; + +Q_DECLARE_OPERATORS_FOR_FLAGS(QCPPolarGrid::GridTypes) +Q_DECLARE_METATYPE(QCPPolarGrid::GridType) + + +/* end of 'src/polar/polargrid.h' */ + + +/* including file 'src/polar/polargraph.h' */ +/* modified 2021-03-29T02:30:44, size 9606 */ + + +class QCP_LIB_DECL QCPPolarLegendItem : public QCPAbstractLegendItem +{ + Q_OBJECT +public: + QCPPolarLegendItem(QCPLegend *parent, QCPPolarGraph *graph); + + // getters: + QCPPolarGraph *polarGraph() { return mPolarGraph; } + +protected: + // property members: + QCPPolarGraph *mPolarGraph; + + // reimplemented virtual methods: + virtual void draw(QCPPainter *painter) Q_DECL_OVERRIDE; + virtual QSize minimumOuterSizeHint() const Q_DECL_OVERRIDE; + + // non-virtual methods: + QPen getIconBorderPen() const; + QColor getTextColor() const; + QFont getFont() const; +}; + + +class QCP_LIB_DECL QCPPolarGraph : public QCPLayerable +{ + Q_OBJECT + /// \cond INCLUDE_QPROPERTIES + + /// \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 + }; + Q_ENUMS(LineStyle) + + QCPPolarGraph(QCPPolarAxisAngular *keyAxis, QCPPolarAxisRadial *valueAxis); + virtual ~QCPPolarGraph(); + + // getters: + QString name() const { return mName; } + bool antialiasedFill() const { return mAntialiasedFill; } + bool antialiasedScatters() const { return mAntialiasedScatters; } + QPen pen() const { return mPen; } + QBrush brush() const { return mBrush; } + bool periodic() const { return mPeriodic; } + QCPPolarAxisAngular *keyAxis() const { return mKeyAxis.data(); } + QCPPolarAxisRadial *valueAxis() const { return mValueAxis.data(); } + QCP::SelectionType selectable() const { return mSelectable; } + bool selected() const { return !mSelection.isEmpty(); } + QCPDataSelection selection() const { return mSelection; } + //QCPSelectionDecorator *selectionDecorator() const { return mSelectionDecorator; } + QSharedPointer data() const { return mDataContainer; } + LineStyle lineStyle() const { return mLineStyle; } + QCPScatterStyle scatterStyle() const { return mScatterStyle; } + + // setters: + void setName(const QString &name); + void setAntialiasedFill(bool enabled); + void setAntialiasedScatters(bool enabled); + void setPen(const QPen &pen); + void setBrush(const QBrush &brush); + void setPeriodic(bool enabled); + void setKeyAxis(QCPPolarAxisAngular *axis); + void setValueAxis(QCPPolarAxisRadial *axis); + Q_SLOT void setSelectable(QCP::SelectionType selectable); + Q_SLOT void setSelection(QCPDataSelection selection); + //void setSelectionDecorator(QCPSelectionDecorator *decorator); + void setData(QSharedPointer data); + void setData(const QVector &keys, const QVector &values, bool alreadySorted=false); + void setLineStyle(LineStyle ls); + void setScatterStyle(const QCPScatterStyle &style); + + // non-property methods: + void addData(const QVector &keys, const QVector &values, bool alreadySorted=false); + void addData(double key, double value); + 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; + void rescaleAxes(bool onlyEnlarge=false) const; + void rescaleKeyAxis(bool onlyEnlarge=false) const; + void rescaleValueAxis(bool onlyEnlarge=false, bool inKeyRange=false) const; + bool addToLegend(QCPLegend *legend); + bool addToLegend(); + bool removeFromLegend(QCPLegend *legend) const; + bool removeFromLegend() const; + + // introduced virtual methods: + virtual double selectTest(const QPointF &pos, bool onlySelectable, QVariant *details=0) const; // actually introduced in QCPLayerable as non-pure, but we want to force reimplementation for plottables + virtual QCPPlottableInterface1D *interface1D() { return 0; } // TODO: return this later, when QCPAbstractPolarPlottable is created + virtual QCPRange getKeyRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth) const; + virtual QCPRange getValueRange(bool &foundRange, QCP::SignDomain inSignDomain=QCP::sdBoth, const QCPRange &inKeyRange=QCPRange()) const; + +signals: + void selectionChanged(bool selected); + void selectionChanged(const QCPDataSelection &selection); + void selectableChanged(QCP::SelectionType selectable); + +protected: + // property members: + QSharedPointer mDataContainer; + LineStyle mLineStyle; + QCPScatterStyle mScatterStyle; + QString mName; + bool mAntialiasedFill, mAntialiasedScatters; + QPen mPen; + QBrush mBrush; + bool mPeriodic; + QPointer mKeyAxis; + QPointer mValueAxis; + QCP::SelectionType mSelectable; + QCPDataSelection mSelection; + //QCPSelectionDecorator *mSelectionDecorator; + + // introduced virtual methods (later reimplemented TODO from QCPAbstractPolarPlottable): + virtual QRect clipRect() const; + virtual void draw(QCPPainter *painter); + 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); + // virtual drawing helpers: + virtual void drawLinePlot(QCPPainter *painter, const QVector &lines) const; + virtual void drawFill(QCPPainter *painter, QVector *lines) const; + virtual void drawScatterPlot(QCPPainter *painter, const QVector &scatters, const QCPScatterStyle &style) const; + + // introduced virtual methods: + virtual void drawLegendIcon(QCPPainter *painter, const QRectF &rect) const; + + // non-virtual methods: + void applyFillAntialiasingHint(QCPPainter *painter) const; + void applyScattersAntialiasingHint(QCPPainter *painter) const; + double pointDistance(const QPointF &pixelPoint, QCPGraphDataContainer::const_iterator &closestData) const; + // drawing helpers: + virtual int dataCount() const; + void getDataSegments(QList &selectedSegments, QList &unselectedSegments) const; + void drawPolyline(QCPPainter *painter, const QVector &lineData) const; + void getVisibleDataBounds(QCPGraphDataContainer::const_iterator &begin, QCPGraphDataContainer::const_iterator &end, const QCPDataRange &rangeRestriction) const; + void getLines(QVector *lines, const QCPDataRange &dataRange) const; + void getScatters(QVector *scatters, const QCPDataRange &dataRange) const; + void getOptimizedLineData(QVector *lineData, const QCPGraphDataContainer::const_iterator &begin, const QCPGraphDataContainer::const_iterator &end) const; + void getOptimizedScatterData(QVector *scatterData, QCPGraphDataContainer::const_iterator begin, QCPGraphDataContainer::const_iterator end) const; + QVector dataToLines(const QVector &data) const; + +private: + Q_DISABLE_COPY(QCPPolarGraph) + + friend class QCPPolarLegendItem; +}; + +/* end of 'src/polar/polargraph.h' */ + + +#endif // QCUSTOMPLOT_H + diff --git a/third/qcustomplotdemo/data/data0.txt b/third/qcustomplotdemo/data/data0.txt new file mode 100644 index 0000000..6775e69 --- /dev/null +++ b/third/qcustomplotdemo/data/data0.txt @@ -0,0 +1 @@ +00 00 06 35 09 6E 0A 76 09 C2 09 03 07 BF 06 B5 05 59 04 51 03 74 03 30 03 2A 03 3A 03 52 03 63 03 77 03 86 03 96 03 A0 03 AC 03 B4 03 BE 03 C6 03 CB 03 CD 03 D1 03 D1 03 D1 03 D3 03 D7 03 D9 03 DB 03 DB 03 DD 03 DF 03 E3 03 E5 03 E6 03 E4 03 E4 03 E4 03 E5 03 E5 03 E4 03 E4 03 E6 03 E5 03 E1 03 DC 03 D6 03 D4 03 D2 03 D1 03 D0 03 D1 03 D2 03 D3 03 D5 03 D9 03 DF 03 E6 03 F4 04 05 04 21 04 39 04 5D 04 7A 04 A5 04 CB 05 01 05 30 05 6E 05 A1 05 E6 06 1D 06 68 06 9F 06 D8 06 F7 07 14 07 27 07 43 07 5B 07 7A 07 94 07 B2 07 C9 07 E0 07 EF 08 03 08 11 08 21 08 30 08 41 08 4D 08 5E 08 6C 08 7C 08 8A 08 9B 08 A8 08 B7 08 C3 08 D0 08 DB 08 EA 08 F8 09 05 09 0F 09 19 09 22 09 2F 09 3B 09 45 09 4C 09 55 09 61 09 6D 09 76 09 83 09 8E 09 9C 09 A6 09 B1 09 B9 09 C8 09 D2 09 E0 09 EC 09 F6 0A 01 0A 0F 0A 19 0A 24 0A 2E 0A 3A 0A 43 0A 55 0A 61 0A 53 0A 67 0A 83 0A 91 0A 98 0A A0 0A B2 0A BF 0A D2 0A E8 0A F9 0B 05 0B 14 0B 20 0B 30 0B 3C 0B 4B 0B 59 0B 68 0B 77 0B 87 0B 93 0B A1 0B AE 0B BF 0B CD 0B DB 0B E5 0B F4 0C 00 0C 0F 0C 19 0C 25 0C 34 0C 40 0C 49 0C 56 0C 62 0C 6D 0C 75 0C 81 0C 8B 0C 98 0C A2 0C AD 0C B5 0C C4 0C D0 0C DA 0C E1 0C ED 0C FA 0D 07 0D 11 0D 1A 0D 22 0D 2F 0D 36 0D 41 0D 4A 0D 58 0D 63 0D 70 0D 7C 0D 8E 0D 9E 0D B4 0D C8 0D E3 0D F7 0E 0F 0E 24 0E 3F 0E 55 0E 71 0E 87 0E 9F 0E B3 0E CC 0E E0 0E FC 0F 10 0F 28 0F 41 0F 60 0F 78 0F 96 0F B1 0F CE 0F EA 10 0B 10 27 10 4A 10 63 10 83 10 9B 10 B8 10 CD 10 E3 10 BF 10 40 0F C2 0F 24 0E B2 0E 2E 0D D4 0D 7C 0D 52 0D 44 0D 5A 0D 71 0D 7F 0D 9F 0D C5 0D EF 0E 01 0E 12 0E 1C 0E 1D 0E 1C 0E 1A 0E 14 0E 05 0D F6 0D E5 0D DF 0D D9 0D D5 0D CE 0D C5 0D C0 0D C0 0D BB 0D B5 0D A8 0D A2 0D 9C 0D 95 0D 8C 0D 84 0D 75 0D 69 0D 5C 0D 51 0D 3C 0D 2A 0D 10 0D 00 0C EC 0C DD 0C C2 0C AB 0C 99 0C 8D 0C 7D 0C 6D 0C 57 0C 49 0C 3C 0C 31 0C 1D 0C 07 0B F0 0B E4 0B D0 0B BE 0B A7 0B 94 0B 7B 0B 6C 0B 59 0B 43 0B 26 0B 15 0B 03 0A F2 0A DB 0A B7 0A 94 0A 82 0A 6B 0A 52 0A 2F 0A 14 09 F7 09 DF 09 C2 09 A6 09 83 09 6F 09 55 09 3F 09 23 09 0E 08 F2 08 DB 08 C4 08 B1 08 96 08 7F 08 65 08 51 08 3B 08 22 08 01 07 EF 07 D8 07 C6 07 AA 07 93 07 7C 07 6E 07 5A 07 43 07 23 07 0A 06 F1 06 DB 06 BE 06 A6 06 86 06 6B 06 49 06 2F 06 14 05 F9 05 D4 05 BB 05 A0 05 8B 05 6C 05 50 05 30 05 1C 05 02 04 E9 04 C9 04 B0 04 98 04 86 04 6B 04 55 04 39 04 26 04 14 04 07 03 EE 03 D8 03 C0 03 B5 03 A9 03 9A 03 7D 03 68 03 51 03 42 03 31 03 20 03 07 02 F0 02 D8 02 C6 02 AA 02 90 02 68 02 45 02 1F 02 1F 01 D3 01 AE 01 8A 01 68 01 39 01 1B 01 01 00 EA 00 CE 00 BE 00 B1 00 A7 00 99 00 93 00 90 00 8E 00 8E 00 8E 00 90 00 92 00 91 00 91 00 92 00 92 00 90 00 91 00 92 00 93 00 92 00 91 00 91 00 92 00 91 00 91 00 91 00 90 00 91 00 91 00 91 00 91 00 92 00 92 00 91 00 91 00 90 00 90 00 91 00 92 00 92 00 92 00 91 00 90 00 92 00 91 00 91 00 92 00 92 00 92 00 92 00 91 00 91 00 90 00 90 00 92 00 90 00 91 00 92 00 92 00 91 00 91 00 92 00 92 00 92 00 92 00 91 00 91 00 92 00 91 00 91 00 91 00 92 00 92 00 92 00 92 00 91 00 91 00 91 00 91 00 92 00 92 00 92 00 92 00 92 00 92 00 91 00 90 00 8F 00 90 00 91 00 91 00 91 00 91 00 91 00 92 00 92 00 92 00 92 00 92 00 92 00 92 00 91 00 90 00 92 00 90 00 90 00 92 00 92 00 91 00 \ No newline at end of file diff --git a/third/qcustomplotdemo/data/data1.txt b/third/qcustomplotdemo/data/data1.txt new file mode 100644 index 0000000..4e72d39 --- /dev/null +++ b/third/qcustomplotdemo/data/data1.txt @@ -0,0 +1 @@ +00 00 05 4D 07 E2 09 44 08 C6 07 FC 07 16 05 F4 05 05 03 E0 03 23 02 A3 02 9E 02 B3 02 B9 02 CE 02 DE 02 EF 02 FB 03 09 03 10 03 19 03 1E 03 23 03 28 03 29 03 29 03 2C 03 2C 03 2C 03 2E 03 31 03 31 03 32 03 31 03 32 03 30 03 2F 03 31 03 33 03 33 03 33 03 32 03 33 03 33 03 32 03 31 03 2F 03 2A 03 23 03 20 03 1F 03 1F 03 22 03 24 03 22 03 23 03 27 03 2B 03 32 03 39 03 47 03 55 03 6F 03 89 03 AF 03 D0 03 FF 04 2C 04 69 04 9D 04 E3 05 1E 05 61 05 9A 05 E1 06 1B 06 6A 06 A8 06 EE 07 18 07 41 07 5D 07 83 07 A3 07 CC 07 EA 08 0F 08 2A 08 4E 08 65 08 84 08 99 08 B0 08 C0 08 D8 08 E8 08 FB 09 09 09 1B 09 28 09 37 09 42 09 53 09 5D 09 68 09 72 09 80 09 8E 09 99 09 A2 09 AD 09 B7 09 C4 09 CE 09 DA 09 E4 09 F3 0A 00 0A 0E 0A 16 0A 20 0A 28 0A 35 0A 40 0A 4E 0A 57 0A 61 0A 69 0A 75 0A 7C 0A 96 0A A3 0A B6 0A C5 0A B8 0A C6 0A E0 0A ED 0A F6 0A FF 0B 0B 0B 16 0B 22 0B 2B 0B 33 0B 3C 0B 4A 0B 56 0B 65 0B 72 0B 81 0B 8F 0B 9E 0B AA 0B BC 0B C8 0B D8 0B E3 0B F1 0B FB 0C 08 0C 13 0C 23 0C 31 0C 41 0C 4E 0C 60 0C 6F 0C 7E 0C 88 0C 97 0C A5 0C B3 0C BD 0C C9 0C D5 0C E9 0C FA 0D 0E 0D 1A 0D 2C 0D 3A 0D 4A 0D 58 0D 69 0D 79 0D 89 0D 97 0D AA 0D B8 0D CE 0D DF 0D F3 0D FF 0E 13 0E 23 0E 34 0E 42 0E 55 0E 64 0E 79 0E 86 0E 98 0E A5 0E B7 0E C8 0E DD 0E ED 0E FF 0F 0B 0F 1B 0F 27 0F 33 0F 3D 0F 49 0F 54 0F 5F 0F 67 0F 6F 0F 77 0F 84 0F 8B 0F 93 0F 9C 0F A7 0F AE 0F B8 0F BF 0F C9 0F D0 0F D6 0F DF 0F E9 0F F2 0F FE 10 09 10 1A 10 27 10 35 10 41 10 4B 10 55 10 61 10 6C 10 7A 10 85 10 95 10 A4 10 B5 10 C6 10 D3 10 C6 10 5E 0F DD 0F 28 0E 9F 0E 09 0D 9A 0D 1A 0C BE 0C 69 0C 44 0C 64 0C 99 0C BB 0C CA 0C E8 0D 10 0D 33 0D 3A 0D 32 0D 2D 0D 1D 0D 08 0C E7 0C CD 0C AE 0C 97 0C 78 0C 63 0C 56 0C 4D 0C 3F 0C 33 0C 20 0C 12 0C 03 0B F7 0B DC 0B C6 0B B2 0B A2 0B 8D 0B 7B 0B 60 0B 52 0B 4A 0B 43 0B 32 0B 1A 0B 08 0B 03 0A FA 0A EE 0A DB 0A BD 0A B8 0A BC 0A C1 0A CA 0A A4 0A 99 0A 93 0A 8E 0A 7C 0A 5E 0A 4F 0A 4A 0A 3F 0A 31 0A 1B 0A 0B 09 FC 09 F4 09 E6 09 D4 09 BE 09 B1 09 A1 09 96 09 83 09 6F 09 57 09 49 09 3A 09 2A 09 11 08 FA 08 E5 08 D9 08 C4 08 B2 08 95 08 7E 08 6A 08 5B 08 45 08 2B 08 11 08 01 07 EE 07 DE 07 C1 07 A7 07 93 07 85 07 73 07 64 07 47 07 35 07 25 07 1A 07 06 06 F3 06 DD 06 D0 06 C4 06 B9 06 A7 06 96 06 86 06 7E 06 75 06 66 06 4E 06 3E 06 32 06 2A 06 19 06 08 05 F3 05 E6 05 DB 05 D0 05 BE 05 AC 05 96 05 8B 05 7E 05 72 05 5B 05 47 05 36 05 2B 05 1B 05 09 04 F1 04 E1 04 D2 04 C6 04 B2 04 9E 04 8A 04 7D 04 71 04 64 04 4B 04 38 04 21 04 13 04 01 03 F5 03 DB 03 C9 03 B3 03 A7 03 99 03 89 03 6F 03 59 03 35 03 35 03 23 03 0B 02 EA 02 D9 02 C2 02 A5 02 B8 02 A4 02 97 02 92 02 8A 02 88 02 86 02 86 02 86 02 86 02 85 02 83 02 83 02 81 02 80 02 80 02 7D 02 7B 02 7A 02 78 02 77 02 75 02 74 02 74 02 74 02 72 02 71 02 71 02 70 02 70 02 6F 02 6F 02 70 02 70 02 6F 02 6F 02 6F 02 6F 02 6F 02 70 02 70 02 70 02 71 02 71 02 72 02 72 02 74 02 76 02 74 02 74 02 74 02 75 02 75 02 75 02 75 02 75 02 76 02 76 02 76 02 76 02 75 02 75 02 76 02 77 02 74 02 74 02 74 02 76 02 75 02 74 02 74 02 76 02 75 02 74 02 74 02 76 02 76 02 75 02 75 02 75 02 74 02 75 02 75 02 74 02 76 02 76 02 75 02 75 02 75 02 75 02 76 02 76 02 75 02 75 02 74 02 74 02 75 02 75 02 74 02 74 02 74 02 74 02 75 02 75 02 76 02 75 02 74 02 74 02 74 02 74 02 \ No newline at end of file diff --git a/third/qcustomplotdemo/data/data2.txt b/third/qcustomplotdemo/data/data2.txt new file mode 100644 index 0000000..a4a9c9a --- /dev/null +++ b/third/qcustomplotdemo/data/data2.txt @@ -0,0 +1 @@ +00 08 00 27 00 36 00 56 00 68 00 68 00 6C 00 D7 01 6A 01 EB 02 4E 02 89 02 AE 02 DB 03 0F 03 3A 03 63 03 8B 03 BB 03 EA 04 15 04 34 04 50 04 65 04 7D 04 A2 04 BF 04 D5 04 EB 05 03 05 16 05 27 05 3D 05 49 05 4D 05 58 05 72 05 99 05 B3 05 BC 05 CB 05 F2 06 12 06 2E 06 3F 06 54 06 76 06 A0 06 C0 06 C2 06 BB 06 C6 06 F4 07 27 07 52 07 69 07 76 07 7C 07 9B 07 C0 07 E2 08 11 08 38 08 47 08 77 08 8F 08 B1 09 0A 08 F8 08 C6 08 E9 09 30 09 65 09 72 09 6B 09 6D 09 A5 09 F3 0A 11 0A 1D 0A 3A 0A 51 0A 6D 0A 95 0A C3 0A EC 0B 06 0B 15 0B 2A 0B 42 0B 54 0B 86 0B C7 0B FB 0C 08 0C 1D 0C 3E 0C 65 0C 7D 0C 75 0C 90 0C DE 0D 1A 0D 17 0D 15 0D 4D 0D 9E 0D E5 0E 10 0E 16 0E 19 0E 40 0E 6C 0E 86 0E A5 0E D0 0E F1 0F 01 0F 1C 0F 42 0F 5F 0F 89 0F A0 0F A2 0F B5 0F DC 0F F8 10 0B 10 23 10 43 10 5E 10 74 10 85 10 9B 10 BA 10 D8 10 F7 11 12 11 22 11 26 11 1F 11 2A 11 3B 11 40 11 49 11 60 11 6D 11 68 11 68 11 7C 11 9A 11 A6 11 A5 11 B9 11 DB 11 EB 11 F2 11 FF 12 1A 12 32 12 39 12 4A 12 80 12 94 12 A2 12 C9 12 F9 13 1E 13 2C 13 3A 13 4A 13 56 13 7D 13 B1 13 CA 13 E2 14 09 14 36 14 64 14 95 14 BF 14 87 12 8F 0D 98 09 93 08 2F 08 65 08 CD 08 93 07 B4 06 E9 06 C0 08 17 0A EF 0C 1E 0A CF 09 97 0A 3A 0B C7 0C 6E 0C 29 0C 30 0C A6 0C D3 0C C0 0C AB 0C 84 0C 6C 0C 26 0B B9 0B BB 0B E9 0B DB 0B A6 0B 5E 0B 40 0B 65 0B 9E 0B 71 0A F7 0A D2 0A FB 0B 09 0A EC 0A 85 0A 4C 0A 81 0A EA 0A DD 0A 21 09 9F 09 E3 0A 64 0A 71 0A 12 09 B8 09 BB 0A 0B 0A 60 0A 52 0A 08 09 C8 09 B5 0A 0B 0A 25 09 B8 09 56 09 78 09 CC 09 B2 09 3A 08 C0 08 CC 09 20 09 46 09 05 08 76 08 36 08 5D 08 88 08 86 08 44 07 C4 07 A1 07 E7 08 12 07 CA 07 55 07 2F 07 40 07 60 07 5B 07 0C 06 B3 06 A9 06 D0 06 D9 06 7C 06 22 06 23 06 5A 06 69 06 0D 05 7E 05 55 05 75 05 93 05 72 05 14 04 BC 04 AF 04 C8 04 CB 04 88 04 3D 04 28 04 3B 04 40 04 25 03 EC 03 C8 03 CE 03 E7 03 D4 03 82 03 51 03 55 03 77 03 85 03 4D 03 0D 03 01 03 10 03 18 03 0B 02 D8 02 A8 02 9D 02 A9 02 AD 02 7B 02 4C 02 38 02 3B 02 3D 02 1A 01 F5 01 D9 01 CF 01 D3 01 C2 01 9B 01 84 01 7D 01 7E 01 7B 01 5D 01 3A 01 1C 01 0C 01 06 00 FE 00 E5 00 C9 00 B3 00 A5 00 9C 00 8F 00 76 00 5D 00 4C 00 42 00 30 00 1D 00 18 00 16 00 17 00 16 00 14 00 16 00 1A 00 18 00 18 00 1A 00 1E 00 28 00 30 00 33 00 33 00 35 00 35 00 35 00 35 00 35 00 34 00 33 00 33 00 32 00 32 00 32 00 32 00 32 00 32 00 32 00 34 00 32 00 31 00 30 00 30 00 2F 00 2D 00 2B 00 2A 00 29 00 27 00 25 00 21 00 1D 00 19 00 15 00 11 00 0B 00 08 00 05 00 02 FF FF FF FF FF FF 00 00 FF FD 00 00 00 01 00 01 FF FE FF FF FF FE FF FC FF FF 00 01 00 01 00 00 FF FD FF FF 00 00 00 00 00 01 00 01 00 02 00 02 00 02 00 01 00 01 00 01 FF FF 00 02 00 02 00 00 00 00 00 00 00 01 00 03 00 03 00 03 00 04 00 04 00 04 00 02 00 03 00 05 00 02 00 04 00 06 00 07 00 04 00 05 00 04 00 \ No newline at end of file diff --git a/third/qcustomplotdemo/form/frmtest.cpp b/third/qcustomplotdemo/form/frmtest.cpp deleted file mode 100644 index c32ff38..0000000 --- a/third/qcustomplotdemo/form/frmtest.cpp +++ /dev/null @@ -1,19 +0,0 @@ -#include "frmtest.h" -#include "ui_frmtest.h" -#include "qdebug.h" - -frmTest::frmTest(QWidget *parent) : QWidget(parent), ui(new Ui::frmTest) -{ - ui->setupUi(this); - this->initForm(); -} - -frmTest::~frmTest() -{ - delete ui; -} - -void frmTest::initForm() -{ - -} diff --git a/third/qcustomplotdemo/form/frmtest.h b/third/qcustomplotdemo/form/frmtest.h deleted file mode 100644 index a5e5f44..0000000 --- a/third/qcustomplotdemo/form/frmtest.h +++ /dev/null @@ -1,25 +0,0 @@ -#ifndef FRMTEST_H -#define FRMTEST_H - -#include - -namespace Ui { -class frmTest; -} - -class frmTest : public QWidget -{ - Q_OBJECT - -public: - explicit frmTest(QWidget *parent = 0); - ~frmTest(); - -private: - Ui::frmTest *ui; - -private slots: - void initForm(); -}; - -#endif // FRMTEST_H diff --git a/third/qcustomplotdemo/frmcustom/frmcustom.pri b/third/qcustomplotdemo/frmcustom/frmcustom.pri new file mode 100644 index 0000000..c67d3e7 --- /dev/null +++ b/third/qcustomplotdemo/frmcustom/frmcustom.pri @@ -0,0 +1,13 @@ +FORMS += \ + $$PWD/frmmain.ui \ + $$PWD/frmmultiaxes.ui + +HEADERS += \ + $$PWD/frmmain.h \ + $$PWD/frmmultiaxes.h \ + $$PWD/iconhelper.h + +SOURCES += \ + $$PWD/frmmain.cpp \ + $$PWD/frmmultiaxes.cpp \ + $$PWD/iconhelper.cpp diff --git a/third/qcustomplotdemo/form/frmmain.cpp b/third/qcustomplotdemo/frmcustom/frmmain.cpp similarity index 88% rename from third/qcustomplotdemo/form/frmmain.cpp rename to third/qcustomplotdemo/frmcustom/frmmain.cpp index 709a185..3ca0fef 100644 --- a/third/qcustomplotdemo/form/frmmain.cpp +++ b/third/qcustomplotdemo/frmcustom/frmmain.cpp @@ -26,7 +26,11 @@ #include "frmcolormap.h" #include "frmfinancial.h" #include "frmpolarplot.h" -#include "frmtest.h" + +#include "frmaxistag.h" +#include "frminteraction.h" +#include "frmscrollbar.h" +#include "frmmultiaxes.h" frmMain::frmMain(QWidget *parent) : QWidget(parent), ui(new Ui::frmMain) { @@ -42,6 +46,13 @@ frmMain::~frmMain() delete ui; } +void frmMain::showEvent(QShowEvent *) +{ + //滚动到底部 + QScrollBar *bar = ui->scrollArea->verticalScrollBar(); + bar->setValue(bar->maximum()); +} + void frmMain::initForm() { ui->scrollArea->setFixedWidth(170); @@ -72,7 +83,10 @@ void frmMain::initWidget() ui->stackedWidget->addWidget(new frmColorMap); ui->stackedWidget->addWidget(new frmFinancial); ui->stackedWidget->addWidget(new frmPolarPlot); - ui->stackedWidget->addWidget(new frmTest); + ui->stackedWidget->addWidget(new frmAxisTag); + ui->stackedWidget->addWidget(new frmInterAction); + ui->stackedWidget->addWidget(new frmScrollBar); + ui->stackedWidget->addWidget(new frmMultiAxes); } void frmMain::initNav() @@ -83,7 +97,7 @@ void frmMain::initNav() << "曲线条样式" << "日期数据图" << "纹理画刷图" << "双坐标曲线" << "对数曲线图" << "动态正弦图" << "环形曲线图" << "垂直柱状图" << "箱形盒须图" << "静态指示线" << "动态指示线" << "曲线样式图" << "高级坐标轴" << "颜色热力图" << "金融曲线图" - << "南丁格尔图" << "测试曲线图"; + << "南丁格尔图" << "坐标轴指示" << "相互作用图" << "滚动条曲线" << "多坐标轴图"; //自动生成按钮 for (int i = 0; i < names.count(); i++) { diff --git a/third/qcustomplotdemo/form/frmmain.h b/third/qcustomplotdemo/frmcustom/frmmain.h similarity index 93% rename from third/qcustomplotdemo/form/frmmain.h rename to third/qcustomplotdemo/frmcustom/frmmain.h index b0fa692..5a7bc37 100644 --- a/third/qcustomplotdemo/form/frmmain.h +++ b/third/qcustomplotdemo/frmcustom/frmmain.h @@ -16,6 +16,9 @@ public: explicit frmMain(QWidget *parent = 0); ~frmMain(); +protected: + void showEvent(QShowEvent *); + private: Ui::frmMain *ui; diff --git a/third/qcustomplotdemo/form/frmmain.ui b/third/qcustomplotdemo/frmcustom/frmmain.ui similarity index 100% rename from third/qcustomplotdemo/form/frmmain.ui rename to third/qcustomplotdemo/frmcustom/frmmain.ui diff --git a/third/qcustomplotdemo/frmcustom/frmmultiaxes.cpp b/third/qcustomplotdemo/frmcustom/frmmultiaxes.cpp new file mode 100644 index 0000000..7a014d5 --- /dev/null +++ b/third/qcustomplotdemo/frmcustom/frmmultiaxes.cpp @@ -0,0 +1,186 @@ +#include "frmmultiaxes.h" +#include "ui_frmmultiaxes.h" +#include "qfile.h" +#include "qdebug.h" + +frmMultiAxes::frmMultiAxes(QWidget *parent) : QWidget(parent), ui(new Ui::frmMultiAxes) +{ + ui->setupUi(this); + this->initForm(); +} + +frmMultiAxes::~frmMultiAxes() +{ + delete ui; +} + +void frmMultiAxes::initForm() +{ + //Y坐标轴的数量 + count = 4; + + this->initPlot(ui->customPlot1, QCPAxis::atLeft, count); + this->initPlot(ui->customPlot2, QCPAxis::atRight, count); + + this->loadPlot(ui->customPlot1, QCPAxis::atLeft, count); + this->loadPlot(ui->customPlot2, QCPAxis::atRight, count); + + for (int i = 0; i < count; ++i) { + this->loadData(ui->customPlot1, i); + this->loadData(ui->customPlot2, i); + } +} + +void frmMultiAxes::selectionChangedByUser() +{ + //联动处理 坐标轴、刻度尺、画布曲线 选中一样则选中所有 + QCustomPlot *customPlot = (QCustomPlot *)sender(); + QCPAxis::AxisType type; + if (customPlot == ui->customPlot1) { + type = QCPAxis::atLeft; + } else if (customPlot == ui->customPlot2) { + type = QCPAxis::atRight; + } + + int selecteIndex = -1; + for (int i = 0; i < count; ++i) { + //获取对应的坐标轴 + QCPAxis *axis = customPlot->axisRect()->axis(type, i); + //获取对应的画布曲线 + QCPGraph *graph = customPlot->graph(i); + //判断 坐标轴、刻度尺、画布曲线 是否选中了一个 + if (axis->selectedParts().testFlag(QCPAxis::spAxis) || axis->selectedParts().testFlag(QCPAxis::spTickLabels) || graph->selected()) { + //设置坐标轴、刻度尺同时选中 + axis->setSelectedParts(QCPAxis::spAxis | QCPAxis::spTickLabels); + //设置画布曲线选中 + graph->setSelection(QCPDataSelection(graph->data()->dataRange())); + selecteIndex = i; + break; + } + } + + //存在选中则设置当前选中的可拖动和缩放 + //不存在则设置所有的可拖动和缩放 + QCPAxisRect *axisRect = customPlot->axisRect(); + if (selecteIndex >= 0) { + QCPAxis *axis = axisRect->axis(type, selecteIndex); + axisRect->setRangeDragAxes(customPlot->xAxis, axis); + axisRect->setRangeZoomAxes(customPlot->xAxis, axis); + } else { +#ifndef qcustomplot_v1_3 + axisRect->setRangeDragAxes(axisRect->axes()); + axisRect->setRangeZoomAxes(axisRect->axes()); +#endif + } +} + +void frmMultiAxes::initPlot(QCustomPlot *customPlot, const QCPAxis::AxisType &type, int count) +{ + //选中对应的坐标轴或者画布等 + connect(customPlot, SIGNAL(selectionChangedByUser()), this, SLOT(selectionChangedByUser())); + //connect(customPlot->yAxis2, SIGNAL(rangeChanged(QCPRange)), customPlot->yAxis, SLOT(setRange(QCPRange))); + + if (type == QCPAxis::atLeft) { + customPlot->yAxis->setVisible(true); + customPlot->yAxis2->setVisible(false); + } else if (type == QCPAxis::atRight) { + customPlot->yAxis->setVisible(false); + customPlot->yAxis2->setVisible(true); + } + + //添加多个坐标轴 + for (int i = 0; i < count - 1; ++i) { + customPlot->axisRect()->addAxis(type); + } + + //设置边距、范围值、网格可见、刻度数量等 + for (int i = 0; i < count; ++i) { + QCPAxis *axis = customPlot->axisRect()->axis(type, i); + axis->setPadding(10); + axis->setRange(0, 1); + axis->grid()->setVisible(true); + //axis->grid()->setSubGridVisible(true); + axis->ticker()->setTickCount(10); + } + + //设置初始范围值 + customPlot->xAxis->setRange(0.5, 10.5); + //设置刻度数量 + customPlot->xAxis->ticker()->setTickCount(10); + //设置可拖动和缩放选中等 + customPlot->setInteractions(QCP::iRangeDrag | QCP::iRangeZoom | QCP::iSelectAxes | QCP::iSelectPlottables); +} + +void frmMultiAxes::loadPlot(QCustomPlot *customPlot, const QCPAxis::AxisType &type, int count) +{ + //颜色集合 + QList colors; + colors << QColor(211, 78, 78) << QColor(29, 185, 242) << QColor(170, 162, 119) << QColor(255, 192, 1); + colors << QColor(0, 176, 180) << QColor(0, 113, 193) << QColor(255, 192, 0); + colors << QColor(72, 103, 149) << QColor(185, 87, 86) << QColor(0, 177, 125); + colors << QColor(214, 77, 84) << QColor(71, 164, 233) << QColor(34, 163, 169); + colors << QColor(59, 123, 156) << QColor(162, 121, 197) << QColor(72, 202, 245); + colors << QColor(0, 150, 121) << QColor(111, 9, 176) << QColor(250, 170, 20); + + for (int i = 0; i < count; ++i) { + //分配一种颜色 + QColor color; + if (i < colors.count()) { + color = colors.at(i); + } + + QPen pen(color); + QCPAxis *axis = customPlot->axisRect()->axis(type, i); + //刻度文本颜色 + axis->setTickLabelColor(color); + //刻度线条颜色 + axis->setBasePen(pen); + //大刻度尺颜色 + axis->setTickPen(pen); + //小刻度尺颜色 + axis->setSubTickPen(pen); + //画布线条颜色 + QCPGraph *graph = customPlot->addGraph(customPlot->xAxis, axis); + graph->setPen(pen); + } +} + +void frmMultiAxes::loadData(QCustomPlot *customPlot, int index) +{ + //下面演示从文本文件读取数据，具体格式可以自行打开文件查看 + //真实场景自己准备数据调用 setData 即可 + int flag = index > 2 ? 0 : index; + QString fileName = QString(":/data/data%1.txt").arg(flag); + QFile file(fileName); + if (file.open(QFile::ReadOnly | QIODevice::Text)) { + QString value = file.readAll(); + file.close(); + + QVector keys, values; + QStringList list = value.split(" "); + int len = list.length(); + + //如果不是2的倍数则长度要减去1 + if (len % 2 != 0) { + len = (len - 1); + } + + for (int i = 0; i < len / 2; i++) { + keys << i; + } + + //每两个16进制数字组合成一个数字 + for (int i = 0; i < len; i = i + 2) { + QString strHex = QString("%1%2").arg(list.at(i)).arg(list.at(i + 1)); + qint16 value = strHex.toUShort(NULL, 16); + values << value; + } + + //获取对应画布 + QCPGraph *graph = customPlot->graph(index); + //设置数据到画布 + graph->setData(keys, values); + //自适应坐标轴 + graph->rescaleAxes(); + } +} diff --git a/third/qcustomplotdemo/frmcustom/frmmultiaxes.h b/third/qcustomplotdemo/frmcustom/frmmultiaxes.h new file mode 100644 index 0000000..1c3d08b --- /dev/null +++ b/third/qcustomplotdemo/frmcustom/frmmultiaxes.h @@ -0,0 +1,36 @@ +#ifndef FRMMULTIAXES_H +#define FRMMULTIAXES_H + +#include +#include "qcustomplot.h" + +namespace Ui { +class frmMultiAxes; +} + +class frmMultiAxes : public QWidget +{ + Q_OBJECT + +public: + explicit frmMultiAxes(QWidget *parent = 0); + ~frmMultiAxes(); + +private: + Ui::frmMultiAxes *ui; + int count; + +private slots: + //初始化界面数据 + void initForm(); + //用户按下区域改变 + void selectionChangedByUser(); + //初始化图表控件 + void initPlot(QCustomPlot *customPlot, const QCPAxis::AxisType &type, int count); + //加载图表控件 + void loadPlot(QCustomPlot *customPlot, const QCPAxis::AxisType &type, int count); + //加载数据到图表控件 + void loadData(QCustomPlot *customPlot, int index); +}; + +#endif // FRMMULTIAXES_H diff --git a/third/qcustomplotdemo/frmcustom/frmmultiaxes.ui b/third/qcustomplotdemo/frmcustom/frmmultiaxes.ui new file mode 100644 index 0000000..8bf186a --- /dev/null +++ b/third/qcustomplotdemo/frmcustom/frmmultiaxes.ui @@ -0,0 +1,35 @@ + + + frmMultiAxes + + + + 0 + 0 + 400 + 300 + + + + Form + + + + + + + + + + + + + QCustomPlot + QWidget +
qcustomplot.h
+ 1 + + + + + diff --git a/third/qcustomplotdemo/iconhelper.cpp b/third/qcustomplotdemo/frmcustom/iconhelper.cpp similarity index 100% rename from third/qcustomplotdemo/iconhelper.cpp rename to third/qcustomplotdemo/frmcustom/iconhelper.cpp diff --git a/third/qcustomplotdemo/iconhelper.h b/third/qcustomplotdemo/frmcustom/iconhelper.h similarity index 100% rename from third/qcustomplotdemo/iconhelper.h rename to third/qcustomplotdemo/frmcustom/iconhelper.h diff --git a/third/qcustomplotdemo/form/frmadvancedaxes.cpp b/third/qcustomplotdemo/frmexample/frmadvancedaxes.cpp similarity index 99% rename from third/qcustomplotdemo/form/frmadvancedaxes.cpp rename to third/qcustomplotdemo/frmexample/frmadvancedaxes.cpp index eda0666..0250813 100644 --- a/third/qcustomplotdemo/form/frmadvancedaxes.cpp +++ b/third/qcustomplotdemo/frmexample/frmadvancedaxes.cpp @@ -15,6 +15,7 @@ frmAdvancedAxes::~frmAdvancedAxes() void frmAdvancedAxes::initForm() { +#ifndef qcustomplot_v1_3 // configure axis rect: ui->customPlot->plotLayout()->clear(); // clear default axis rect so we can start from scratch QCPAxisRect *wideAxisRect = new QCPAxisRect(ui->customPlot); @@ -109,4 +110,5 @@ void frmAdvancedAxes::initForm() subBars->keyAxis()->setTicker(intTicker); ui->customPlot->setInteractions(QCP::iRangeDrag | QCP::iRangeZoom); +#endif } diff --git a/third/qcustomplotdemo/form/frmadvancedaxes.h b/third/qcustomplotdemo/frmexample/frmadvancedaxes.h similarity index 100% rename from third/qcustomplotdemo/form/frmadvancedaxes.h rename to third/qcustomplotdemo/frmexample/frmadvancedaxes.h diff --git a/third/qcustomplotdemo/form/frmadvancedaxes.ui b/third/qcustomplotdemo/frmexample/frmadvancedaxes.ui similarity index 72% rename from third/qcustomplotdemo/form/frmadvancedaxes.ui rename to third/qcustomplotdemo/frmexample/frmadvancedaxes.ui index 4299bbf..73c861b 100644 --- a/third/qcustomplotdemo/form/frmadvancedaxes.ui +++ b/third/qcustomplotdemo/frmexample/frmadvancedaxes.ui @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - diff --git a/third/qcustomplotdemo/form/frmbarchart.cpp b/third/qcustomplotdemo/frmexample/frmbarchart.cpp similarity index 99% rename from third/qcustomplotdemo/form/frmbarchart.cpp rename to third/qcustomplotdemo/frmexample/frmbarchart.cpp index bd07c3d..7918438 100644 --- a/third/qcustomplotdemo/form/frmbarchart.cpp +++ b/third/qcustomplotdemo/frmexample/frmbarchart.cpp @@ -15,6 +15,7 @@ frmBarChart::~frmBarChart() void frmBarChart::initForm() { +#ifndef qcustomplot_v1_3 // set dark background gradient: QLinearGradient gradient(0, 0, 0, 400); gradient.setColorAt(0, QColor(90, 90, 90)); @@ -96,4 +97,5 @@ void frmBarChart::initForm() legendFont.setPointSize(10); ui->customPlot->legend->setFont(legendFont); ui->customPlot->setInteractions(QCP::iRangeDrag | QCP::iRangeZoom); +#endif } diff --git a/third/qcustomplotdemo/form/frmbarchart.h b/third/qcustomplotdemo/frmexample/frmbarchart.h similarity index 100% rename from third/qcustomplotdemo/form/frmbarchart.h rename to third/qcustomplotdemo/frmexample/frmbarchart.h diff --git a/third/qcustomplotdemo/form/frmbarchart.ui b/third/qcustomplotdemo/frmexample/frmbarchart.ui similarity index 72% rename from third/qcustomplotdemo/form/frmbarchart.ui rename to third/qcustomplotdemo/frmexample/frmbarchart.ui index 13fc413..6092870 100644 --- a/third/qcustomplotdemo/form/frmbarchart.ui +++ b/third/qcustomplotdemo/frmexample/frmbarchart.ui @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - diff --git a/third/qcustomplotdemo/form/frmcolormap.cpp b/third/qcustomplotdemo/frmexample/frmcolormap.cpp similarity index 100% rename from third/qcustomplotdemo/form/frmcolormap.cpp rename to third/qcustomplotdemo/frmexample/frmcolormap.cpp diff --git a/third/qcustomplotdemo/form/frmcolormap.h b/third/qcustomplotdemo/frmexample/frmcolormap.h similarity index 100% rename from third/qcustomplotdemo/form/frmcolormap.h rename to third/qcustomplotdemo/frmexample/frmcolormap.h diff --git a/third/qcustomplotdemo/form/frmcolormap.ui b/third/qcustomplotdemo/frmexample/frmcolormap.ui similarity index 72% rename from third/qcustomplotdemo/form/frmcolormap.ui rename to third/qcustomplotdemo/frmexample/frmcolormap.ui index 66c82e5..0a3d899 100644 --- a/third/qcustomplotdemo/form/frmcolormap.ui +++ b/third/qcustomplotdemo/frmexample/frmcolormap.ui @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - diff --git a/third/qcustomplotdemo/form/frmdate.cpp b/third/qcustomplotdemo/frmexample/frmdate.cpp similarity index 98% rename from third/qcustomplotdemo/form/frmdate.cpp rename to third/qcustomplotdemo/frmexample/frmdate.cpp index 8614cd0..58dbd36 100644 --- a/third/qcustomplotdemo/form/frmdate.cpp +++ b/third/qcustomplotdemo/frmexample/frmdate.cpp @@ -15,6 +15,7 @@ frmDate::~frmDate() void frmDate::initForm() { +#ifndef qcustomplot_v1_3 // set locale to english, so we get english month names: ui->customPlot->setLocale(QLocale(QLocale::English, QLocale::UnitedKingdom)); // seconds of current time, we'll use it as starting point in time for data: @@ -68,4 +69,5 @@ void frmDate::initForm() ui->customPlot->legend->setVisible(true); ui->customPlot->legend->setBrush(QColor(255, 255, 255, 150)); ui->customPlot->setInteractions(QCP::iRangeDrag | QCP::iRangeZoom); +#endif } diff --git a/third/qcustomplotdemo/form/frmdate.h b/third/qcustomplotdemo/frmexample/frmdate.h similarity index 100% rename from third/qcustomplotdemo/form/frmdate.h rename to third/qcustomplotdemo/frmexample/frmdate.h diff --git a/third/qcustomplotdemo/form/frmdate.ui b/third/qcustomplotdemo/frmexample/frmdate.ui similarity index 72% rename from third/qcustomplotdemo/form/frmdate.ui rename to third/qcustomplotdemo/frmexample/frmdate.ui index 9a2add7..6e131a1 100644 --- a/third/qcustomplotdemo/form/frmdate.ui +++ b/third/qcustomplotdemo/frmexample/frmdate.ui @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - diff --git a/third/qcustomplotdemo/form/form.pri b/third/qcustomplotdemo/frmexample/frmexample.pri similarity index 92% rename from third/qcustomplotdemo/form/form.pri rename to third/qcustomplotdemo/frmexample/frmexample.pri index 8ba635c..0f4d897 100644 --- a/third/qcustomplotdemo/form/form.pri +++ b/third/qcustomplotdemo/frmexample/frmexample.pri @@ -7,7 +7,6 @@ FORMS += \ $$PWD/frmitem.ui \ $$PWD/frmlinestyle.ui \ $$PWD/frmlogarithmic.ui \ - $$PWD/frmmain.ui \ $$PWD/frmmultiaxis.ui \ $$PWD/frmparametriccurve.ui \ $$PWD/frmpolarplot.ui \ @@ -20,7 +19,6 @@ FORMS += \ $$PWD/frmsincscatter.ui \ $$PWD/frmstatistical.ui \ $$PWD/frmstyled.ui \ - $$PWD/frmtest.ui \ $$PWD/frmtexturebrush.ui HEADERS += \ @@ -32,7 +30,6 @@ HEADERS += \ $$PWD/frmitem.h \ $$PWD/frmlinestyle.h \ $$PWD/frmlogarithmic.h \ - $$PWD/frmmain.h \ $$PWD/frmmultiaxis.h \ $$PWD/frmparametriccurve.h \ $$PWD/frmpolarplot.h \ @@ -45,7 +42,6 @@ HEADERS += \ $$PWD/frmsincscatter.h \ $$PWD/frmstatistical.h \ $$PWD/frmstyled.h \ - $$PWD/frmtest.h \ $$PWD/frmtexturebrush.h SOURCES += \ @@ -57,7 +53,6 @@ SOURCES += \ $$PWD/frmitem.cpp \ $$PWD/frmlinestyle.cpp \ $$PWD/frmlogarithmic.cpp \ - $$PWD/frmmain.cpp \ $$PWD/frmmultiaxis.cpp \ $$PWD/frmparametriccurve.cpp \ $$PWD/frmpolarplot.cpp \ @@ -70,5 +65,4 @@ SOURCES += \ $$PWD/frmsincscatter.cpp \ $$PWD/frmstatistical.cpp \ $$PWD/frmstyled.cpp \ - $$PWD/frmtest.cpp \ $$PWD/frmtexturebrush.cpp diff --git a/third/qcustomplotdemo/form/frmfinancial.cpp b/third/qcustomplotdemo/frmexample/frmfinancial.cpp similarity index 98% rename from third/qcustomplotdemo/form/frmfinancial.cpp rename to third/qcustomplotdemo/frmexample/frmfinancial.cpp index a9139e9..c3647e1 100644 --- a/third/qcustomplotdemo/form/frmfinancial.cpp +++ b/third/qcustomplotdemo/frmexample/frmfinancial.cpp @@ -20,7 +20,7 @@ void frmFinancial::initForm() // generate two sets of random walk data (one for candlestick and one for ohlc chart): int n = 500; QVector time(n), value1(n), value2(n); - QDateTime start(QDate(2014, 6, 11), QTime(0, 0)); + QDateTime start(QDate(2022, 1, 1), QTime(0, 0)); start.setTimeSpec(Qt::UTC); double startTime = start.toMSecsSinceEpoch() / 1000.0; double binSize = 3600 * 24; // bin data in 1 day intervals diff --git a/third/qcustomplotdemo/form/frmfinancial.h b/third/qcustomplotdemo/frmexample/frmfinancial.h similarity index 100% rename from third/qcustomplotdemo/form/frmfinancial.h rename to third/qcustomplotdemo/frmexample/frmfinancial.h diff --git a/third/qcustomplotdemo/form/frmfinancial.ui b/third/qcustomplotdemo/frmexample/frmfinancial.ui similarity index 72% rename from third/qcustomplotdemo/form/frmfinancial.ui rename to third/qcustomplotdemo/frmexample/frmfinancial.ui index faaae83..bebb192 100644 --- a/third/qcustomplotdemo/form/frmfinancial.ui +++ b/third/qcustomplotdemo/frmexample/frmfinancial.ui @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - diff --git a/third/qcustomplotdemo/form/frmitem.cpp b/third/qcustomplotdemo/frmexample/frmitem.cpp similarity index 100% rename from third/qcustomplotdemo/form/frmitem.cpp rename to third/qcustomplotdemo/frmexample/frmitem.cpp diff --git a/third/qcustomplotdemo/form/frmitem.h b/third/qcustomplotdemo/frmexample/frmitem.h similarity index 100% rename from third/qcustomplotdemo/form/frmitem.h rename to third/qcustomplotdemo/frmexample/frmitem.h diff --git a/third/qcustomplotdemo/form/frmitem.ui b/third/qcustomplotdemo/frmexample/frmitem.ui similarity index 72% rename from third/qcustomplotdemo/form/frmitem.ui rename to third/qcustomplotdemo/frmexample/frmitem.ui index 730660a..cd9d45e 100644 --- a/third/qcustomplotdemo/form/frmitem.ui +++ b/third/qcustomplotdemo/frmexample/frmitem.ui @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - diff --git a/third/qcustomplotdemo/form/frmlinestyle.cpp b/third/qcustomplotdemo/frmexample/frmlinestyle.cpp similarity index 100% rename from third/qcustomplotdemo/form/frmlinestyle.cpp rename to third/qcustomplotdemo/frmexample/frmlinestyle.cpp diff --git a/third/qcustomplotdemo/form/frmlinestyle.h b/third/qcustomplotdemo/frmexample/frmlinestyle.h similarity index 100% rename from third/qcustomplotdemo/form/frmlinestyle.h rename to third/qcustomplotdemo/frmexample/frmlinestyle.h diff --git a/third/qcustomplotdemo/form/frmlinestyle.ui b/third/qcustomplotdemo/frmexample/frmlinestyle.ui similarity index 72% rename from third/qcustomplotdemo/form/frmlinestyle.ui rename to third/qcustomplotdemo/frmexample/frmlinestyle.ui index aee5b12..59823a9 100644 --- a/third/qcustomplotdemo/form/frmlinestyle.ui +++ b/third/qcustomplotdemo/frmexample/frmlinestyle.ui @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - diff --git a/third/qcustomplotdemo/form/frmlogarithmic.cpp b/third/qcustomplotdemo/frmexample/frmlogarithmic.cpp similarity index 100% rename from third/qcustomplotdemo/form/frmlogarithmic.cpp rename to third/qcustomplotdemo/frmexample/frmlogarithmic.cpp diff --git a/third/qcustomplotdemo/form/frmlogarithmic.h b/third/qcustomplotdemo/frmexample/frmlogarithmic.h similarity index 100% rename from third/qcustomplotdemo/form/frmlogarithmic.h rename to third/qcustomplotdemo/frmexample/frmlogarithmic.h diff --git a/third/qcustomplotdemo/form/frmlogarithmic.ui b/third/qcustomplotdemo/frmexample/frmlogarithmic.ui similarity index 72% rename from third/qcustomplotdemo/form/frmlogarithmic.ui rename to third/qcustomplotdemo/frmexample/frmlogarithmic.ui index 811c9c8..c50d6b7 100644 --- a/third/qcustomplotdemo/form/frmlogarithmic.ui +++ b/third/qcustomplotdemo/frmexample/frmlogarithmic.ui @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - diff --git a/third/qcustomplotdemo/form/frmmultiaxis.cpp b/third/qcustomplotdemo/frmexample/frmmultiaxis.cpp similarity index 100% rename from third/qcustomplotdemo/form/frmmultiaxis.cpp rename to third/qcustomplotdemo/frmexample/frmmultiaxis.cpp diff --git a/third/qcustomplotdemo/form/frmmultiaxis.h b/third/qcustomplotdemo/frmexample/frmmultiaxis.h similarity index 100% rename from third/qcustomplotdemo/form/frmmultiaxis.h rename to third/qcustomplotdemo/frmexample/frmmultiaxis.h diff --git a/third/qcustomplotdemo/form/frmmultiaxis.ui b/third/qcustomplotdemo/frmexample/frmmultiaxis.ui similarity index 72% rename from third/qcustomplotdemo/form/frmmultiaxis.ui rename to third/qcustomplotdemo/frmexample/frmmultiaxis.ui index 986439e..fb79597 100644 --- a/third/qcustomplotdemo/form/frmmultiaxis.ui +++ b/third/qcustomplotdemo/frmexample/frmmultiaxis.ui @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - diff --git a/third/qcustomplotdemo/form/frmparametriccurve.cpp b/third/qcustomplotdemo/frmexample/frmparametriccurve.cpp similarity index 100% rename from third/qcustomplotdemo/form/frmparametriccurve.cpp rename to third/qcustomplotdemo/frmexample/frmparametriccurve.cpp diff --git a/third/qcustomplotdemo/form/frmparametriccurve.h b/third/qcustomplotdemo/frmexample/frmparametriccurve.h similarity index 100% rename from third/qcustomplotdemo/form/frmparametriccurve.h rename to third/qcustomplotdemo/frmexample/frmparametriccurve.h diff --git a/third/qcustomplotdemo/form/frmparametriccurve.ui b/third/qcustomplotdemo/frmexample/frmparametriccurve.ui similarity index 73% rename from third/qcustomplotdemo/form/frmparametriccurve.ui rename to third/qcustomplotdemo/frmexample/frmparametriccurve.ui index 025edaa..4532500 100644 --- a/third/qcustomplotdemo/form/frmparametriccurve.ui +++ b/third/qcustomplotdemo/frmexample/frmparametriccurve.ui @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - diff --git a/third/qcustomplotdemo/form/frmpolarplot.cpp b/third/qcustomplotdemo/frmexample/frmpolarplot.cpp similarity index 95% rename from third/qcustomplotdemo/form/frmpolarplot.cpp rename to third/qcustomplotdemo/frmexample/frmpolarplot.cpp index 6149a7a..74a6545 100644 --- a/third/qcustomplotdemo/form/frmpolarplot.cpp +++ b/third/qcustomplotdemo/frmexample/frmpolarplot.cpp @@ -15,6 +15,8 @@ frmPolarPlot::~frmPolarPlot() void frmPolarPlot::initForm() { + //南丁格尔图示 2.1 版本新增加的 +#ifdef qcustomplot_v2_1 // Warning: Polar plots are a still a tech preview ui->customPlot->plotLayout()->clear(); @@ -50,4 +52,5 @@ void frmPolarPlot::initForm() angularAxis->setRange(0, 360); angularAxis->radialAxis()->setRange(-10, 10); +#endif } diff --git a/third/qcustomplotdemo/form/frmpolarplot.h b/third/qcustomplotdemo/frmexample/frmpolarplot.h similarity index 100% rename from third/qcustomplotdemo/form/frmpolarplot.h rename to third/qcustomplotdemo/frmexample/frmpolarplot.h diff --git a/third/qcustomplotdemo/form/frmpolarplot.ui b/third/qcustomplotdemo/frmexample/frmpolarplot.ui similarity index 72% rename from third/qcustomplotdemo/form/frmpolarplot.ui rename to third/qcustomplotdemo/frmexample/frmpolarplot.ui index 12fe7c3..f149752 100644 --- a/third/qcustomplotdemo/form/frmpolarplot.ui +++ b/third/qcustomplotdemo/frmexample/frmpolarplot.ui @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - diff --git a/third/qcustomplotdemo/form/frmquadratic.cpp b/third/qcustomplotdemo/frmexample/frmquadratic.cpp similarity index 100% rename from third/qcustomplotdemo/form/frmquadratic.cpp rename to third/qcustomplotdemo/frmexample/frmquadratic.cpp diff --git a/third/qcustomplotdemo/form/frmquadratic.h b/third/qcustomplotdemo/frmexample/frmquadratic.h similarity index 100% rename from third/qcustomplotdemo/form/frmquadratic.h rename to third/qcustomplotdemo/frmexample/frmquadratic.h diff --git a/third/qcustomplotdemo/form/frmquadratic.ui b/third/qcustomplotdemo/frmexample/frmquadratic.ui similarity index 72% rename from third/qcustomplotdemo/form/frmquadratic.ui rename to third/qcustomplotdemo/frmexample/frmquadratic.ui index 9bfebde..e49b4e0 100644 --- a/third/qcustomplotdemo/form/frmquadratic.ui +++ b/third/qcustomplotdemo/frmexample/frmquadratic.ui @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - diff --git a/third/qcustomplotdemo/form/frmrealtimedata.cpp b/third/qcustomplotdemo/frmexample/frmrealtimedata.cpp similarity index 100% rename from third/qcustomplotdemo/form/frmrealtimedata.cpp rename to third/qcustomplotdemo/frmexample/frmrealtimedata.cpp diff --git a/third/qcustomplotdemo/form/frmrealtimedata.h b/third/qcustomplotdemo/frmexample/frmrealtimedata.h similarity index 100% rename from third/qcustomplotdemo/form/frmrealtimedata.h rename to third/qcustomplotdemo/frmexample/frmrealtimedata.h diff --git a/third/qcustomplotdemo/form/frmrealtimedata.ui b/third/qcustomplotdemo/frmexample/frmrealtimedata.ui similarity index 100% rename from third/qcustomplotdemo/form/frmrealtimedata.ui rename to third/qcustomplotdemo/frmexample/frmrealtimedata.ui diff --git a/third/qcustomplotdemo/form/frmscatterpixmap.cpp b/third/qcustomplotdemo/frmexample/frmscatterpixmap.cpp similarity index 100% rename from third/qcustomplotdemo/form/frmscatterpixmap.cpp rename to third/qcustomplotdemo/frmexample/frmscatterpixmap.cpp diff --git a/third/qcustomplotdemo/form/frmscatterpixmap.h b/third/qcustomplotdemo/frmexample/frmscatterpixmap.h similarity index 100% rename from third/qcustomplotdemo/form/frmscatterpixmap.h rename to third/qcustomplotdemo/frmexample/frmscatterpixmap.h diff --git a/third/qcustomplotdemo/form/frmscatterpixmap.ui b/third/qcustomplotdemo/frmexample/frmscatterpixmap.ui similarity index 72% rename from third/qcustomplotdemo/form/frmscatterpixmap.ui rename to third/qcustomplotdemo/frmexample/frmscatterpixmap.ui index 315a17a..f7b4e95 100644 --- a/third/qcustomplotdemo/form/frmscatterpixmap.ui +++ b/third/qcustomplotdemo/frmexample/frmscatterpixmap.ui @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - diff --git a/third/qcustomplotdemo/form/frmscatterstyle.cpp b/third/qcustomplotdemo/frmexample/frmscatterstyle.cpp similarity index 89% rename from third/qcustomplotdemo/form/frmscatterstyle.cpp rename to third/qcustomplotdemo/frmexample/frmscatterstyle.cpp index 4c50d82..09fab54 100644 --- a/third/qcustomplotdemo/form/frmscatterstyle.cpp +++ b/third/qcustomplotdemo/frmexample/frmscatterstyle.cpp @@ -1,5 +1,6 @@ #include "frmscatterstyle.h" #include "ui_frmscatterstyle.h" +#include "qmetaobject.h" #include "qdebug.h" frmScatterStyle::frmScatterStyle(QWidget *parent) : QWidget(parent), ui(new Ui::frmScatterStyle) @@ -18,6 +19,7 @@ void frmScatterStyle::initForm() ui->customPlot->legend->setVisible(true); ui->customPlot->legend->setFont(QFont("Helvetica", 9)); ui->customPlot->legend->setRowSpacing(-3); + QVector shapes; shapes << QCPScatterStyle::ssCross; shapes << QCPScatterStyle::ssPlus; @@ -49,7 +51,13 @@ void frmScatterStyle::initForm() ui->customPlot->graph()->setData(x, y); ui->customPlot->graph()->rescaleAxes(true); ui->customPlot->graph()->setPen(pen); - ui->customPlot->graph()->setName(QCPScatterStyle::staticMetaObject.enumerator(QCPScatterStyle::staticMetaObject.indexOfEnumerator("ScatterShape")).valueToKey(shapes.at(i))); + + //枚举值转字符串 + QMetaObject metaObject = QCPScatterStyle::staticMetaObject; + QMetaEnum metaEnum = metaObject.enumerator(metaObject.indexOfEnumerator("ScatterShape")); + QString name = metaEnum.valueToKey(shapes.at(i)); + ui->customPlot->graph()->setName(name); + ui->customPlot->graph()->setLineStyle(QCPGraph::lsLine); // set scatter style: if (shapes.at(i) != QCPScatterStyle::ssCustom) { diff --git a/third/qcustomplotdemo/form/frmscatterstyle.h b/third/qcustomplotdemo/frmexample/frmscatterstyle.h similarity index 100% rename from third/qcustomplotdemo/form/frmscatterstyle.h rename to third/qcustomplotdemo/frmexample/frmscatterstyle.h diff --git a/third/qcustomplotdemo/form/frmscatterstyle.ui b/third/qcustomplotdemo/frmexample/frmscatterstyle.ui similarity index 72% rename from third/qcustomplotdemo/form/frmscatterstyle.ui rename to third/qcustomplotdemo/frmexample/frmscatterstyle.ui index a8e7721..14a0571 100644 --- a/third/qcustomplotdemo/form/frmscatterstyle.ui +++ b/third/qcustomplotdemo/frmexample/frmscatterstyle.ui @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - diff --git a/third/qcustomplotdemo/form/frmsimple.cpp b/third/qcustomplotdemo/frmexample/frmsimple.cpp similarity index 100% rename from third/qcustomplotdemo/form/frmsimple.cpp rename to third/qcustomplotdemo/frmexample/frmsimple.cpp diff --git a/third/qcustomplotdemo/form/frmsimple.h b/third/qcustomplotdemo/frmexample/frmsimple.h similarity index 100% rename from third/qcustomplotdemo/form/frmsimple.h rename to third/qcustomplotdemo/frmexample/frmsimple.h diff --git a/third/qcustomplotdemo/form/frmsimple.ui b/third/qcustomplotdemo/frmexample/frmsimple.ui similarity index 72% rename from third/qcustomplotdemo/form/frmsimple.ui rename to third/qcustomplotdemo/frmexample/frmsimple.ui index 0072393..c40c4c6 100644 --- a/third/qcustomplotdemo/form/frmsimple.ui +++ b/third/qcustomplotdemo/frmexample/frmsimple.ui @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - diff --git a/third/qcustomplotdemo/form/frmsimpleitem.cpp b/third/qcustomplotdemo/frmexample/frmsimpleitem.cpp similarity index 100% rename from third/qcustomplotdemo/form/frmsimpleitem.cpp rename to third/qcustomplotdemo/frmexample/frmsimpleitem.cpp diff --git a/third/qcustomplotdemo/form/frmsimpleitem.h b/third/qcustomplotdemo/frmexample/frmsimpleitem.h similarity index 100% rename from third/qcustomplotdemo/form/frmsimpleitem.h rename to third/qcustomplotdemo/frmexample/frmsimpleitem.h diff --git a/third/qcustomplotdemo/form/frmsimpleitem.ui b/third/qcustomplotdemo/frmexample/frmsimpleitem.ui similarity index 72% rename from third/qcustomplotdemo/form/frmsimpleitem.ui rename to third/qcustomplotdemo/frmexample/frmsimpleitem.ui index 830ee3e..a0cea4f 100644 --- a/third/qcustomplotdemo/form/frmsimpleitem.ui +++ b/third/qcustomplotdemo/frmexample/frmsimpleitem.ui @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - diff --git a/third/qcustomplotdemo/form/frmsincscatter.cpp b/third/qcustomplotdemo/frmexample/frmsincscatter.cpp similarity index 100% rename from third/qcustomplotdemo/form/frmsincscatter.cpp rename to third/qcustomplotdemo/frmexample/frmsincscatter.cpp diff --git a/third/qcustomplotdemo/form/frmsincscatter.h b/third/qcustomplotdemo/frmexample/frmsincscatter.h similarity index 100% rename from third/qcustomplotdemo/form/frmsincscatter.h rename to third/qcustomplotdemo/frmexample/frmsincscatter.h diff --git a/third/qcustomplotdemo/form/frmsincscatter.ui b/third/qcustomplotdemo/frmexample/frmsincscatter.ui similarity index 72% rename from third/qcustomplotdemo/form/frmsincscatter.ui rename to third/qcustomplotdemo/frmexample/frmsincscatter.ui index c4b6759..599398f 100644 --- a/third/qcustomplotdemo/form/frmsincscatter.ui +++ b/third/qcustomplotdemo/frmexample/frmsincscatter.ui @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - diff --git a/third/qcustomplotdemo/form/frmstatistical.cpp b/third/qcustomplotdemo/frmexample/frmstatistical.cpp similarity index 100% rename from third/qcustomplotdemo/form/frmstatistical.cpp rename to third/qcustomplotdemo/frmexample/frmstatistical.cpp diff --git a/third/qcustomplotdemo/form/frmstatistical.h b/third/qcustomplotdemo/frmexample/frmstatistical.h similarity index 100% rename from third/qcustomplotdemo/form/frmstatistical.h rename to third/qcustomplotdemo/frmexample/frmstatistical.h diff --git a/third/qcustomplotdemo/form/frmstatistical.ui b/third/qcustomplotdemo/frmexample/frmstatistical.ui similarity index 72% rename from third/qcustomplotdemo/form/frmstatistical.ui rename to third/qcustomplotdemo/frmexample/frmstatistical.ui index 5c4c419..32f7a3b 100644 --- a/third/qcustomplotdemo/form/frmstatistical.ui +++ b/third/qcustomplotdemo/frmexample/frmstatistical.ui @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - diff --git a/third/qcustomplotdemo/form/frmstyled.cpp b/third/qcustomplotdemo/frmexample/frmstyled.cpp similarity index 100% rename from third/qcustomplotdemo/form/frmstyled.cpp rename to third/qcustomplotdemo/frmexample/frmstyled.cpp diff --git a/third/qcustomplotdemo/form/frmstyled.h b/third/qcustomplotdemo/frmexample/frmstyled.h similarity index 100% rename from third/qcustomplotdemo/form/frmstyled.h rename to third/qcustomplotdemo/frmexample/frmstyled.h diff --git a/third/qcustomplotdemo/form/frmstyled.ui b/third/qcustomplotdemo/frmexample/frmstyled.ui similarity index 72% rename from third/qcustomplotdemo/form/frmstyled.ui rename to third/qcustomplotdemo/frmexample/frmstyled.ui index 3f033a4..a7eb312 100644 --- a/third/qcustomplotdemo/form/frmstyled.ui +++ b/third/qcustomplotdemo/frmexample/frmstyled.ui @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - diff --git a/third/qcustomplotdemo/form/frmtexturebrush.cpp b/third/qcustomplotdemo/frmexample/frmtexturebrush.cpp similarity index 100% rename from third/qcustomplotdemo/form/frmtexturebrush.cpp rename to third/qcustomplotdemo/frmexample/frmtexturebrush.cpp diff --git a/third/qcustomplotdemo/form/frmtexturebrush.h b/third/qcustomplotdemo/frmexample/frmtexturebrush.h similarity index 100% rename from third/qcustomplotdemo/form/frmtexturebrush.h rename to third/qcustomplotdemo/frmexample/frmtexturebrush.h diff --git a/third/qcustomplotdemo/form/frmtexturebrush.ui b/third/qcustomplotdemo/frmexample/frmtexturebrush.ui similarity index 72% rename from third/qcustomplotdemo/form/frmtexturebrush.ui rename to third/qcustomplotdemo/frmexample/frmtexturebrush.ui index 202ba70..6b3f966 100644 --- a/third/qcustomplotdemo/form/frmtexturebrush.ui +++ b/third/qcustomplotdemo/frmexample/frmtexturebrush.ui @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - diff --git a/third/qcustomplotdemo/frmexample2/axistag.cpp b/third/qcustomplotdemo/frmexample2/axistag.cpp new file mode 100644 index 0000000..a22e2a2 --- /dev/null +++ b/third/qcustomplotdemo/frmexample2/axistag.cpp @@ -0,0 +1,112 @@ +/*************************************************************************** +** ** +** QCustomPlot, an easy to use, modern plotting widget for Qt ** +** Copyright (C) 2011-2021 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 3 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/ ** +** Date: 29.03.21 ** +** Version: 2.1.0 ** +****************************************************************************/ + +#include "axistag.h" + +AxisTag::AxisTag(QCPAxis *parentAxis) : + QObject(parentAxis), + mAxis(parentAxis) +{ + // The dummy tracer serves here as an invisible anchor which always sticks to the right side of + // the axis rect + mDummyTracer = new QCPItemTracer(mAxis->parentPlot()); + mDummyTracer->setVisible(false); + mDummyTracer->position->setTypeX(QCPItemPosition::ptAxisRectRatio); + mDummyTracer->position->setTypeY(QCPItemPosition::ptPlotCoords); + mDummyTracer->position->setAxisRect(mAxis->axisRect()); + mDummyTracer->position->setAxes(0, mAxis); + mDummyTracer->position->setCoords(1, 0); + + // the arrow end (head) is set to move along with the dummy tracer by setting it as its parent + // anchor. Its coordinate system (setCoords) is thus pixels, and this is how the needed horizontal + // offset for the tag of the second y axis is achieved. This horizontal offset gets dynamically + // updated in AxisTag::updatePosition. the arrow "start" is simply set to have the "end" as parent + // anchor. It is given a horizontal offset to the right, which results in a 15 pixel long arrow. + mArrow = new QCPItemLine(mAxis->parentPlot()); + mArrow->setLayer("overlay"); + mArrow->setClipToAxisRect(false); + mArrow->setHead(QCPLineEnding::esSpikeArrow); + mArrow->end->setParentAnchor(mDummyTracer->position); + mArrow->start->setParentAnchor(mArrow->end); + mArrow->start->setCoords(15, 0); + + // The text label is anchored at the arrow start (tail) and has its "position" aligned at the + // left, and vertically centered to the text label box. + mLabel = new QCPItemText(mAxis->parentPlot()); + mLabel->setLayer("overlay"); + mLabel->setClipToAxisRect(false); + mLabel->setPadding(QMargins(3, 0, 3, 0)); + mLabel->setBrush(QBrush(Qt::white)); + mLabel->setPen(QPen(Qt::blue)); + mLabel->setPositionAlignment(Qt::AlignLeft | Qt::AlignVCenter); + mLabel->position->setParentAnchor(mArrow->start); +} + +AxisTag::~AxisTag() +{ + if (mDummyTracer) { + mDummyTracer->parentPlot()->removeItem(mDummyTracer); + } + if (mArrow) { + mArrow->parentPlot()->removeItem(mArrow); + } + if (mLabel) { + mLabel->parentPlot()->removeItem(mLabel); + } +} + +void AxisTag::setPen(const QPen &pen) +{ + mArrow->setPen(pen); + mLabel->setPen(pen); +} + +void AxisTag::setBrush(const QBrush &brush) +{ + mLabel->setBrush(brush); +} + +void AxisTag::setText(const QString &text) +{ + mLabel->setText(text); +} + +void AxisTag::updatePosition(double value) +{ + // since both the arrow and the text label are chained to the dummy tracer (via anchor + // parent-child relationships) it is sufficient to update the dummy tracer coordinates. The + // Horizontal coordinate type was set to ptAxisRectRatio so to keep it aligned at the right side + // of the axis rect, it is always kept at 1. The vertical coordinate type was set to + // ptPlotCoordinates of the passed parent axis, so the vertical coordinate is set to the new + // value. + mDummyTracer->position->setCoords(1, value); + + // We want the arrow head to be at the same horizontal position as the axis backbone, even if + // the axis has a certain offset from the axis rect border (like the added second y axis). Thus we + // set the horizontal pixel position of the arrow end (head) to the axis offset (the pixel + // distance to the axis rect border). This works because the parent anchor of the arrow end is + // the dummy tracer, which, as described earlier, is tied to the right axis rect border. + mArrow->end->setCoords(mAxis->offset(), 0); +} diff --git a/third/qcustomplotdemo/frmexample2/axistag.h b/third/qcustomplotdemo/frmexample2/axistag.h new file mode 100644 index 0000000..0d441f5 --- /dev/null +++ b/third/qcustomplotdemo/frmexample2/axistag.h @@ -0,0 +1,60 @@ +/*************************************************************************** +** ** +** QCustomPlot, an easy to use, modern plotting widget for Qt ** +** Copyright (C) 2011-2021 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 3 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/ ** +** Date: 29.03.21 ** +** Version: 2.1.0 ** +****************************************************************************/ + +#ifndef AXISTAG_H +#define AXISTAG_H + +#include +#include "qcustomplot.h" + +class AxisTag : public QObject +{ + Q_OBJECT +public: + explicit AxisTag(QCPAxis *parentAxis); + virtual ~AxisTag(); + + // setters: + void setPen(const QPen &pen); + void setBrush(const QBrush &brush); + void setText(const QString &text); + + // getters: + QPen pen() const { return mLabel->pen(); } + QBrush brush() const { return mLabel->brush(); } + QString text() const { return mLabel->text(); } + + // other methods: + void updatePosition(double value); + +protected: + QCPAxis *mAxis; + QPointer mDummyTracer; + QPointer mArrow; + QPointer mLabel; +}; + + +#endif // AXISTAG_H diff --git a/third/qcustomplotdemo/frmexample2/frmaxistag.cpp b/third/qcustomplotdemo/frmexample2/frmaxistag.cpp new file mode 100644 index 0000000..c0b3a8d --- /dev/null +++ b/third/qcustomplotdemo/frmexample2/frmaxistag.cpp @@ -0,0 +1,67 @@ +#include "frmaxistag.h" +#include "ui_frmaxistag.h" +#include "qdebug.h" + +frmAxisTag::frmAxisTag(QWidget *parent) : QWidget(parent), ui(new Ui::frmAxisTag) +{ + ui->setupUi(this); + this->initForm(); +} + +frmAxisTag::~frmAxisTag() +{ + delete ui; +} + +void frmAxisTag::initForm() +{ + mPlot = ui->customPlot; + + // configure plot to have two right axes: + mPlot->yAxis->setTickLabels(false); + connect(mPlot->yAxis2, SIGNAL(rangeChanged(QCPRange)), mPlot->yAxis, SLOT(setRange(QCPRange))); // left axis only mirrors inner right axis + mPlot->yAxis2->setVisible(true); + mPlot->axisRect()->addAxis(QCPAxis::atRight); + mPlot->axisRect()->axis(QCPAxis::atRight, 0)->setPadding(30); // add some padding to have space for tags + mPlot->axisRect()->axis(QCPAxis::atRight, 1)->setPadding(30); // add some padding to have space for tags + + // create graphs: + mGraph1 = mPlot->addGraph(mPlot->xAxis, mPlot->axisRect()->axis(QCPAxis::atRight, 0)); + mGraph2 = mPlot->addGraph(mPlot->xAxis, mPlot->axisRect()->axis(QCPAxis::atRight, 1)); + mGraph1->setPen(QPen(QColor(250, 120, 0))); + mGraph2->setPen(QPen(QColor(0, 180, 60))); + + // create tags with newly introduced AxisTag class (see axistag.h/.cpp): + mTag1 = new AxisTag(mGraph1->valueAxis()); + mTag1->setPen(mGraph1->pen()); + mTag2 = new AxisTag(mGraph2->valueAxis()); + mTag2->setPen(mGraph2->pen()); + + connect(&mDataTimer, SIGNAL(timeout()), this, SLOT(timerSlot())); + mDataTimer.start(40); +} + +void frmAxisTag::timerSlot() +{ + // calculate and add a new data point to each graph: + int count1 = mGraph1->dataCount(); + mGraph1->addData(count1, qSin(count1 / 50.0) + qSin(count1 / 50.0 / 0.3843) * 0.25); + int count2 = mGraph2->dataCount(); + mGraph2->addData(count2, qCos(count2 / 50.0) + qSin(count2 / 50.0 / 0.4364) * 0.15); + + // make key axis range scroll with the data: + mPlot->xAxis->rescale(); + mGraph1->rescaleValueAxis(false, true); + mGraph2->rescaleValueAxis(false, true); + mPlot->xAxis->setRange(mPlot->xAxis->range().upper, 100, Qt::AlignRight); + + // update the vertical axis tag positions and texts to match the rightmost data point of the graphs: + double graph1Value = mGraph1->dataMainValue(mGraph1->dataCount() - 1); + double graph2Value = mGraph2->dataMainValue(mGraph2->dataCount() - 1); + mTag1->updatePosition(graph1Value); + mTag2->updatePosition(graph2Value); + mTag1->setText(QString::number(graph1Value, 'f', 2)); + mTag2->setText(QString::number(graph2Value, 'f', 2)); + + mPlot->replot(); +} diff --git a/third/qcustomplotdemo/frmexample2/frmaxistag.h b/third/qcustomplotdemo/frmexample2/frmaxistag.h new file mode 100644 index 0000000..9578bcb --- /dev/null +++ b/third/qcustomplotdemo/frmexample2/frmaxistag.h @@ -0,0 +1,34 @@ +#ifndef FRMAXISTAG_H +#define FRMAXISTAG_H + +#include +#include "qcustomplot.h" +#include "axistag.h" + +namespace Ui { +class frmAxisTag; +} + +class frmAxisTag : public QWidget +{ + Q_OBJECT + +public: + explicit frmAxisTag(QWidget *parent = 0); + ~frmAxisTag(); + +private: + Ui::frmAxisTag *ui; + QCustomPlot *mPlot; + QPointer mGraph1; + QPointer mGraph2; + AxisTag *mTag1; + AxisTag *mTag2; + QTimer mDataTimer; + +private slots: + void initForm(); + void timerSlot(); +}; + +#endif // FRMAXISTAG_H diff --git a/third/qcustomplotdemo/form/frmtest.ui b/third/qcustomplotdemo/frmexample2/frmaxistag.ui similarity index 60% rename from third/qcustomplotdemo/form/frmtest.ui rename to third/qcustomplotdemo/frmexample2/frmaxistag.ui index ea03c0c..24feb41 100644 --- a/third/qcustomplotdemo/form/frmtest.ui +++ b/third/qcustomplotdemo/frmexample2/frmaxistag.ui @@ -1,7 +1,7 @@ - frmTest - + frmAxisTag + 0 @@ -14,18 +14,6 @@ Form - - 0 - - - 0 - - - 0 - - - 0 - @@ -35,7 +23,7 @@ QCustomPlot QWidget -
qcustomplot.h
+
qcustomplot.h
1 diff --git a/third/qcustomplotdemo/frmexample2/frmexample2.pri b/third/qcustomplotdemo/frmexample2/frmexample2.pri new file mode 100644 index 0000000..da91d02 --- /dev/null +++ b/third/qcustomplotdemo/frmexample2/frmexample2.pri @@ -0,0 +1,16 @@ +FORMS += \ + $$PWD/frmaxistag.ui \ + $$PWD/frminteraction.ui \ + $$PWD/frmscrollbar.ui + +HEADERS += \ + $$PWD/axistag.h \ + $$PWD/frmaxistag.h \ + $$PWD/frminteraction.h \ + $$PWD/frmscrollbar.h + +SOURCES += \ + $$PWD/axistag.cpp \ + $$PWD/frmaxistag.cpp \ + $$PWD/frminteraction.cpp \ + $$PWD/frmscrollbar.cpp diff --git a/third/qcustomplotdemo/frmexample2/frminteraction.cpp b/third/qcustomplotdemo/frmexample2/frminteraction.cpp new file mode 100644 index 0000000..c1e5cdb --- /dev/null +++ b/third/qcustomplotdemo/frmexample2/frminteraction.cpp @@ -0,0 +1,266 @@ +#include "frminteraction.h" +#include "ui_frminteraction.h" +#include "qdebug.h" + +frmInterAction::frmInterAction(QWidget *parent) : QWidget(parent), ui(new Ui::frmInterAction) +{ + ui->setupUi(this); + this->initForm(); +} + +frmInterAction::~frmInterAction() +{ + delete ui; +} + +void frmInterAction::initForm() +{ + std::srand(QDateTime::currentDateTime().toMSecsSinceEpoch() / 1000.0); + + ui->customPlot->setInteractions(QCP::iRangeDrag | QCP::iRangeZoom | QCP::iSelectAxes | + QCP::iSelectLegend | QCP::iSelectPlottables | QCP::iSelectPlottablesBeyondAxisRect); + ui->customPlot->xAxis->setRange(-8, 8); + ui->customPlot->yAxis->setRange(-5, 5); + ui->customPlot->axisRect()->setupFullAxesBox(); + + ui->customPlot->plotLayout()->insertRow(0); + QCPTextElement *title = new QCPTextElement(ui->customPlot, "Interaction Example", QFont("sans", 17, QFont::Bold)); + ui->customPlot->plotLayout()->addElement(0, 0, title); + + ui->customPlot->xAxis->setLabel("x Axis"); + ui->customPlot->yAxis->setLabel("y Axis"); + ui->customPlot->legend->setVisible(true); + QFont legendFont = font(); + legendFont.setPointSize(10); + ui->customPlot->legend->setFont(legendFont); + ui->customPlot->legend->setSelectedFont(legendFont); + //ui->customPlot->legend->setSelectableParts(QCPLegend::spItems); // legend box shall not be selectable, only legend items + + addRandomGraph(); + addRandomGraph(); + addRandomGraph(); + addRandomGraph(); + ui->customPlot->rescaleAxes(); + + // // connect slot that ties some axis selections together (especially opposite axes): + connect(ui->customPlot, SIGNAL(selectionChangedByUser()), this, SLOT(selectionChanged())); + // // connect slots that takes care that when an axis is selected, only that direction can be dragged and zoomed: + connect(ui->customPlot, SIGNAL(mousePress(QMouseEvent *)), this, SLOT(mousePress())); + connect(ui->customPlot, SIGNAL(mouseWheel(QWheelEvent *)), this, SLOT(mouseWheel())); + + // make bottom and left axes transfer their ranges to top and right axes: + connect(ui->customPlot->xAxis, SIGNAL(rangeChanged(QCPRange)), ui->customPlot->xAxis2, SLOT(setRange(QCPRange))); + connect(ui->customPlot->yAxis, SIGNAL(rangeChanged(QCPRange)), ui->customPlot->yAxis2, SLOT(setRange(QCPRange))); + + // connect some interaction slots: + connect(ui->customPlot, SIGNAL(axisDoubleClick(QCPAxis *, QCPAxis::SelectablePart, QMouseEvent *)), this, SLOT(axisLabelDoubleClick(QCPAxis *, QCPAxis::SelectablePart))); + connect(ui->customPlot, SIGNAL(legendDoubleClick(QCPLegend *, QCPAbstractLegendItem *, QMouseEvent *)), this, SLOT(legendDoubleClick(QCPLegend *, QCPAbstractLegendItem *))); + connect(title, SIGNAL(doubleClicked(QMouseEvent *)), this, SLOT(titleDoubleClick(QMouseEvent *))); + + // connect slot that shows a message in the status bar when a graph is clicked: + connect(ui->customPlot, SIGNAL(plottableClick(QCPAbstractPlottable *, int, QMouseEvent *)), this, SLOT(graphClicked(QCPAbstractPlottable *, int))); + + // setup policy and connect slot for context menu popup: + ui->customPlot->setContextMenuPolicy(Qt::CustomContextMenu); + connect(ui->customPlot, SIGNAL(customContextMenuRequested(QPoint)), this, SLOT(contextMenuRequest(QPoint))); +} + +void frmInterAction::titleDoubleClick(QMouseEvent *event) +{ + Q_UNUSED(event) + if (QCPTextElement *title = qobject_cast(sender())) { + // Set the plot title by double clicking on it + bool ok; + QString newTitle = QInputDialog::getText(this, "QCustomPlot example", "New plot title:", QLineEdit::Normal, title->text(), &ok); + if (ok) { + title->setText(newTitle); + ui->customPlot->replot(); + } + } +} + +void frmInterAction::axisLabelDoubleClick(QCPAxis *axis, QCPAxis::SelectablePart part) +{ + // Set an axis label by double clicking on it + if (part == QCPAxis::spAxisLabel) { // only react when the actual axis label is clicked, not tick label or axis backbone + bool ok; + QString newLabel = QInputDialog::getText(this, "QCustomPlot example", "New axis label:", QLineEdit::Normal, axis->label(), &ok); + if (ok) { + axis->setLabel(newLabel); + ui->customPlot->replot(); + } + } +} + +void frmInterAction::legendDoubleClick(QCPLegend *legend, QCPAbstractLegendItem *item) +{ + // Rename a graph by double clicking on its legend item + Q_UNUSED(legend) + if (item) { // only react if item was clicked (user could have clicked on border padding of legend where there is no item, then item is 0) + QCPPlottableLegendItem *plItem = qobject_cast(item); + bool ok; + QString newName = QInputDialog::getText(this, "QCustomPlot example", "New graph name:", QLineEdit::Normal, plItem->plottable()->name(), &ok); + if (ok) { + plItem->plottable()->setName(newName); + ui->customPlot->replot(); + } + } +} + +void frmInterAction::selectionChanged() +{ + /* + normally, axis base line, axis tick labels and axis labels are selectable separately, but we want + the user only to be able to select the axis as a whole, so we tie the selected states of the tick labels + and the axis base line together. However, the axis label shall be selectable individually. + + The selection state of the left and right axes shall be synchronized as well as the state of the + bottom and top axes. + + Further, we want to synchronize the selection of the graphs with the selection state of the respective + legend item belonging to that graph. So the user can select a graph by either clicking on the graph itself + or on its legend item. + */ + + // make top and bottom axes be selected synchronously, and handle axis and tick labels as one selectable object: + if (ui->customPlot->xAxis->selectedParts().testFlag(QCPAxis::spAxis) || ui->customPlot->xAxis->selectedParts().testFlag(QCPAxis::spTickLabels) || + ui->customPlot->xAxis2->selectedParts().testFlag(QCPAxis::spAxis) || ui->customPlot->xAxis2->selectedParts().testFlag(QCPAxis::spTickLabels)) { + ui->customPlot->xAxis2->setSelectedParts(QCPAxis::spAxis | QCPAxis::spTickLabels); + ui->customPlot->xAxis->setSelectedParts(QCPAxis::spAxis | QCPAxis::spTickLabels); + } + // make left and right axes be selected synchronously, and handle axis and tick labels as one selectable object: + if (ui->customPlot->yAxis->selectedParts().testFlag(QCPAxis::spAxis) || ui->customPlot->yAxis->selectedParts().testFlag(QCPAxis::spTickLabels) || + ui->customPlot->yAxis2->selectedParts().testFlag(QCPAxis::spAxis) || ui->customPlot->yAxis2->selectedParts().testFlag(QCPAxis::spTickLabels)) { + ui->customPlot->yAxis2->setSelectedParts(QCPAxis::spAxis | QCPAxis::spTickLabels); + ui->customPlot->yAxis->setSelectedParts(QCPAxis::spAxis | QCPAxis::spTickLabels); + } + + // synchronize selection of graphs with selection of corresponding legend items: + for (int i = 0; i < ui->customPlot->graphCount(); ++i) { + QCPGraph *graph = ui->customPlot->graph(i); + QCPPlottableLegendItem *item = ui->customPlot->legend->itemWithPlottable(graph); + if (item->selected() || graph->selected()) { + item->setSelected(true); + graph->setSelection(QCPDataSelection(graph->data()->dataRange())); + } + } +} + +void frmInterAction::mousePress() +{ + // if an axis is selected, only allow the direction of that axis to be dragged + // if no axis is selected, both directions may be dragged + + if (ui->customPlot->xAxis->selectedParts().testFlag(QCPAxis::spAxis)) { + ui->customPlot->axisRect()->setRangeDrag(ui->customPlot->xAxis->orientation()); + } else if (ui->customPlot->yAxis->selectedParts().testFlag(QCPAxis::spAxis)) { + ui->customPlot->axisRect()->setRangeDrag(ui->customPlot->yAxis->orientation()); + } else { + ui->customPlot->axisRect()->setRangeDrag(Qt::Horizontal | Qt::Vertical); + } +} + +void frmInterAction::mouseWheel() +{ + // if an axis is selected, only allow the direction of that axis to be zoomed + // if no axis is selected, both directions may be zoomed + + if (ui->customPlot->xAxis->selectedParts().testFlag(QCPAxis::spAxis)) { + ui->customPlot->axisRect()->setRangeZoom(ui->customPlot->xAxis->orientation()); + } else if (ui->customPlot->yAxis->selectedParts().testFlag(QCPAxis::spAxis)) { + ui->customPlot->axisRect()->setRangeZoom(ui->customPlot->yAxis->orientation()); + } else { + ui->customPlot->axisRect()->setRangeZoom(Qt::Horizontal | Qt::Vertical); + } +} + +void frmInterAction::addRandomGraph() +{ + int n = 50; // number of points in graph + double xScale = (std::rand() / (double)RAND_MAX + 0.5) * 2; + double yScale = (std::rand() / (double)RAND_MAX + 0.5) * 2; + double xOffset = (std::rand() / (double)RAND_MAX - 0.5) * 4; + double yOffset = (std::rand() / (double)RAND_MAX - 0.5) * 10; + double r1 = (std::rand() / (double)RAND_MAX - 0.5) * 2; + double r2 = (std::rand() / (double)RAND_MAX - 0.5) * 2; + double r3 = (std::rand() / (double)RAND_MAX - 0.5) * 2; + double r4 = (std::rand() / (double)RAND_MAX - 0.5) * 2; + QVector x(n), y(n); + for (int i = 0; i < n; i++) { + x[i] = (i / (double)n - 0.5) * 10.0 * xScale + xOffset; + y[i] = (qSin(x[i] * r1 * 5) * qSin(qCos(x[i] * r2) * r4 * 3) + r3 * qCos(qSin(x[i]) * r4 * 2)) * yScale + yOffset; + } + + ui->customPlot->addGraph(); + ui->customPlot->graph()->setName(QString("New graph %1").arg(ui->customPlot->graphCount() - 1)); + ui->customPlot->graph()->setData(x, y); + ui->customPlot->graph()->setLineStyle((QCPGraph::LineStyle)(std::rand() % 5 + 1)); + if (std::rand() % 100 > 50) { + ui->customPlot->graph()->setScatterStyle(QCPScatterStyle((QCPScatterStyle::ScatterShape)(std::rand() % 14 + 1))); + } + + QPen graphPen; + graphPen.setColor(QColor(std::rand() % 245 + 10, std::rand() % 245 + 10, std::rand() % 245 + 10)); + graphPen.setWidthF(std::rand() / (double)RAND_MAX * 2 + 1); + ui->customPlot->graph()->setPen(graphPen); + ui->customPlot->replot(); +} + +void frmInterAction::removeSelectedGraph() +{ + if (ui->customPlot->selectedGraphs().size() > 0) { + ui->customPlot->removeGraph(ui->customPlot->selectedGraphs().first()); + ui->customPlot->replot(); + } +} + +void frmInterAction::removeAllGraphs() +{ + ui->customPlot->clearGraphs(); + ui->customPlot->replot(); +} + +void frmInterAction::contextMenuRequest(QPoint pos) +{ + QMenu *menu = new QMenu(this); + menu->setAttribute(Qt::WA_DeleteOnClose); + + if (ui->customPlot->legend->selectTest(pos, false) >= 0) { // context menu on legend requested + menu->addAction("Move to top left", this, SLOT(moveLegend()))->setData((int)(Qt::AlignTop | Qt::AlignLeft)); + menu->addAction("Move to top center", this, SLOT(moveLegend()))->setData((int)(Qt::AlignTop | Qt::AlignHCenter)); + menu->addAction("Move to top right", this, SLOT(moveLegend()))->setData((int)(Qt::AlignTop | Qt::AlignRight)); + menu->addAction("Move to bottom right", this, SLOT(moveLegend()))->setData((int)(Qt::AlignBottom | Qt::AlignRight)); + menu->addAction("Move to bottom left", this, SLOT(moveLegend()))->setData((int)(Qt::AlignBottom | Qt::AlignLeft)); + } else { // general context menu on graphs requested + menu->addAction("Add random graph", this, SLOT(addRandomGraph())); + if (ui->customPlot->selectedGraphs().size() > 0) { + menu->addAction("Remove selected graph", this, SLOT(removeSelectedGraph())); + } + if (ui->customPlot->graphCount() > 0) { + menu->addAction("Remove all graphs", this, SLOT(removeAllGraphs())); + } + } + + menu->popup(ui->customPlot->mapToGlobal(pos)); +} + +void frmInterAction::moveLegend() +{ + if (QAction *contextAction = qobject_cast(sender())) { // make sure this slot is really called by a context menu action, so it carries the data we need + bool ok; + int dataInt = contextAction->data().toInt(&ok); + if (ok) { + ui->customPlot->axisRect()->insetLayout()->setInsetAlignment(0, (Qt::Alignment)dataInt); + ui->customPlot->replot(); + } + } +} + +void frmInterAction::graphClicked(QCPAbstractPlottable *plottable, int dataIndex) +{ + // since we know we only have QCPGraphs in the plot, we can immediately access interface1D() + // usually it's better to first check whether interface1D() returns non-zero, and only then use it. + double dataValue = plottable->interface1D()->dataMainValue(dataIndex); + QString message = QString("Clicked on graph '%1' at data point #%2 with value %3.").arg(plottable->name()).arg(dataIndex).arg(dataValue); + //ui->statusBar->showMessage(message, 2500); +} diff --git a/third/qcustomplotdemo/frmexample2/frminteraction.h b/third/qcustomplotdemo/frmexample2/frminteraction.h new file mode 100644 index 0000000..037455b --- /dev/null +++ b/third/qcustomplotdemo/frmexample2/frminteraction.h @@ -0,0 +1,39 @@ +#ifndef FRMINTERACTION_H +#define FRMINTERACTION_H + +#include +#include +#include "qcustomplot.h" + +namespace Ui { +class frmInterAction; +} + +class frmInterAction : public QWidget +{ + Q_OBJECT + +public: + explicit frmInterAction(QWidget *parent = 0); + ~frmInterAction(); + +private: + Ui::frmInterAction *ui; + +private slots: + void initForm(); + void titleDoubleClick(QMouseEvent *event); + void axisLabelDoubleClick(QCPAxis* axis, QCPAxis::SelectablePart part); + void legendDoubleClick(QCPLegend* legend, QCPAbstractLegendItem* item); + void selectionChanged(); + void mousePress(); + void mouseWheel(); + void addRandomGraph(); + void removeSelectedGraph(); + void removeAllGraphs(); + void contextMenuRequest(QPoint pos); + void moveLegend(); + void graphClicked(QCPAbstractPlottable *plottable, int dataIndex); +}; + +#endif // FRMINTERACTION_H diff --git a/third/qcustomplotdemo/frmexample2/frminteraction.ui b/third/qcustomplotdemo/frmexample2/frminteraction.ui new file mode 100644 index 0000000..2ab0228 --- /dev/null +++ b/third/qcustomplotdemo/frmexample2/frminteraction.ui @@ -0,0 +1,32 @@ + + + frmInterAction + + + + 0 + 0 + 400 + 300 + + + + Form + + + + + + + + + + QCustomPlot + QWidget +
qcustomplot.h
+ 1 + + + + + diff --git a/third/qcustomplotdemo/frmexample2/frmscrollbar.cpp b/third/qcustomplotdemo/frmexample2/frmscrollbar.cpp new file mode 100644 index 0000000..be365f8 --- /dev/null +++ b/third/qcustomplotdemo/frmexample2/frmscrollbar.cpp @@ -0,0 +1,80 @@ +#include "frmscrollbar.h" +#include "ui_frmscrollbar.h" +#include "qdebug.h" + +frmScrollBar::frmScrollBar(QWidget *parent) : QWidget(parent), ui(new Ui::frmScrollBar) +{ + ui->setupUi(this); + this->initForm(); +} + +frmScrollBar::~frmScrollBar() +{ + delete ui; +} + +void frmScrollBar::initForm() +{ + // The following plot setup is mostly taken from the plot demos: + ui->plot->addGraph(); + ui->plot->graph()->setPen(QPen(Qt::blue)); + ui->plot->graph()->setBrush(QBrush(QColor(0, 0, 255, 20))); + ui->plot->addGraph(); + ui->plot->graph()->setPen(QPen(Qt::red)); + QVector x(500), y0(500), y1(500); + for (int i = 0; i < 500; ++i) { + x[i] = (i / 499.0 - 0.5) * 10; + y0[i] = qExp(-x[i] * x[i] * 0.25) * qSin(x[i] * 5) * 5; + y1[i] = qExp(-x[i] * x[i] * 0.25) * 5; + } + ui->plot->graph(0)->setData(x, y0); + ui->plot->graph(1)->setData(x, y1); + ui->plot->axisRect()->setupFullAxesBox(true); + ui->plot->setInteractions(QCP::iRangeDrag | QCP::iRangeZoom); + + // configure scroll bars: + // Since scroll bars only support integer values, we'll set a high default range of -500..500 and + // divide scroll bar position values by 100 to provide a scroll range -5..5 in floating point + // axis coordinates. if you want to dynamically grow the range accessible with the scroll bar, + // just increase the minimum/maximum values of the scroll bars as needed. + ui->horizontalScrollBar->setRange(-500, 500); + ui->verticalScrollBar->setRange(-500, 500); + + // create connection between axes and scroll bars: + connect(ui->horizontalScrollBar, SIGNAL(valueChanged(int)), this, SLOT(horzScrollBarChanged(int))); + connect(ui->verticalScrollBar, SIGNAL(valueChanged(int)), this, SLOT(vertScrollBarChanged(int))); + connect(ui->plot->xAxis, SIGNAL(rangeChanged(QCPRange)), this, SLOT(xAxisChanged(QCPRange))); + connect(ui->plot->yAxis, SIGNAL(rangeChanged(QCPRange)), this, SLOT(yAxisChanged(QCPRange))); + + // initialize axis range (and scroll bar positions via signals we just connected): + ui->plot->xAxis->setRange(0, 6, Qt::AlignCenter); + ui->plot->yAxis->setRange(0, 10, Qt::AlignCenter); +} + +void frmScrollBar::horzScrollBarChanged(int value) +{ + if (qAbs(ui->plot->xAxis->range().center() - value / 100.0) > 0.01) { // if user is dragging plot, we don't want to replot twice + ui->plot->xAxis->setRange(value / 100.0, ui->plot->xAxis->range().size(), Qt::AlignCenter); + ui->plot->replot(); + } +} + +void frmScrollBar::vertScrollBarChanged(int value) +{ + if (qAbs(ui->plot->yAxis->range().center() + value / 100.0) > 0.01) { // if user is dragging plot, we don't want to replot twice + ui->plot->yAxis->setRange(-value / 100.0, ui->plot->yAxis->range().size(), Qt::AlignCenter); + ui->plot->replot(); + } +} + +void frmScrollBar::xAxisChanged(QCPRange range) +{ + ui->horizontalScrollBar->setValue(qRound(range.center() * 100.0)); // adjust position of scroll bar slider + ui->horizontalScrollBar->setPageStep(qRound(range.size() * 100.0)); // adjust size of scroll bar slider +} + +void frmScrollBar::yAxisChanged(QCPRange range) +{ + ui->verticalScrollBar->setValue(qRound(-range.center() * 100.0)); // adjust position of scroll bar slider + ui->verticalScrollBar->setPageStep(qRound(range.size() * 100.0)); // adjust size of scroll bar slider +} diff --git a/third/qcustomplotdemo/frmexample2/frmscrollbar.h b/third/qcustomplotdemo/frmexample2/frmscrollbar.h new file mode 100644 index 0000000..cfc11b3 --- /dev/null +++ b/third/qcustomplotdemo/frmexample2/frmscrollbar.h @@ -0,0 +1,30 @@ +#ifndef FRMSCROLLBAR_H +#define FRMSCROLLBAR_H + +#include +#include "qcustomplot.h" + +namespace Ui { +class frmScrollBar; +} + +class frmScrollBar : public QWidget +{ + Q_OBJECT + +public: + explicit frmScrollBar(QWidget *parent = 0); + ~frmScrollBar(); + +private: + Ui::frmScrollBar *ui; + +private slots: + void initForm(); + void horzScrollBarChanged(int value); + void vertScrollBarChanged(int value); + void xAxisChanged(QCPRange range); + void yAxisChanged(QCPRange range); +}; + +#endif // FRMSCROLLBAR_H diff --git a/third/qcustomplotdemo/frmexample2/frmscrollbar.ui b/third/qcustomplotdemo/frmexample2/frmscrollbar.ui new file mode 100644 index 0000000..c70bf68 --- /dev/null +++ b/third/qcustomplotdemo/frmexample2/frmscrollbar.ui @@ -0,0 +1,53 @@ + + + frmScrollBar + + + + 0 + 0 + 400 + 300 + + + + Form + + + + + + + 0 + 0 + + + + + + + + Qt::Vertical + + + + + + + Qt::Horizontal + + + + + + + + QCustomPlot + QWidget +
qcustomplot.h
+ 1 + + + + + diff --git a/third/qcustomplotdemo/main.cpp b/third/qcustomplotdemo/main.cpp index 56c5956..9023a5b 100644 --- a/third/qcustomplotdemo/main.cpp +++ b/third/qcustomplotdemo/main.cpp @@ -3,6 +3,8 @@ #include "frmmain.h" #include #include +#include +#include int main(int argc, char *argv[]) { @@ -27,6 +29,10 @@ int main(int argc, char *argv[]) QTextCodec::setCodecForLocale(codec); #endif + //初始化随机数种子 + QTime t = QTime::currentTime(); + srand(t.msec() + t.second() * 1000); + frmMain w; w.setWindowTitle("qcustomplot示例 (QQ: 517216493 WX: feiyangqingyun)"); w.resize(1000, 650); diff --git a/third/qcustomplotdemo/main.qrc b/third/qcustomplotdemo/main.qrc index 091c426..1f90802 100644 --- a/third/qcustomplotdemo/main.qrc +++ b/third/qcustomplotdemo/main.qrc @@ -6,5 +6,8 @@ image/bg1.jpg image/bg2.jpg image/data.png + data/data0.txt + data/data1.txt + data/data2.txt diff --git a/third/qcustomplotdemo/qcustomplotdemo.pro b/third/qcustomplotdemo/qcustomplotdemo.pro index b38cb6a..a4afc73 100644 --- a/third/qcustomplotdemo/qcustomplotdemo.pro +++ b/third/qcustomplotdemo/qcustomplotdemo.pro @@ -2,9 +2,6 @@ QT += core gui greaterThan(QT_MAJOR_VERSION, 4): QT += widgets greaterThan(QT_MAJOR_VERSION, 5): QT += core5compat -greaterThan(QT_MAJOR_VERSION, 4): CONFIG += c++11 -lessThan(QT_MAJOR_VERSION, 5): QMAKE_CXXFLAGS += -std=c++11 - TARGET = qcustomplotdemo TEMPLATE = app DESTDIR = $$PWD/../bin @@ -12,12 +9,16 @@ DESTDIR = $$PWD/../bin CONFIG += warn_off RESOURCES += main.qrc SOURCES += main.cpp -HEADERS += iconhelper.h -SOURCES += iconhelper.cpp INCLUDEPATH += $$PWD -INCLUDEPATH += $$PWD/form -include ($$PWD/form/form.pri) +INCLUDEPATH += $$PWD/frmcustom +include ($$PWD/frmcustom/frmcustom.pri) + +INCLUDEPATH += $$PWD/frmexample +include ($$PWD/frmexample/frmexample.pri) + +INCLUDEPATH += $$PWD/frmexample2 +include ($$PWD/frmexample2/frmexample2.pri) INCLUDEPATH += $$PWD/../3rd_qcustomplot include ($$PWD/../3rd_qcustomplot/3rd_qcustomplot.pri) diff --git a/third/qcustomplotdemo/readme.md b/third/qcustomplotdemo/readme.md new file mode 100644 index 0000000..e3dc51e --- /dev/null +++ b/third/qcustomplotdemo/readme.md @@ -0,0 +1,77 @@ +按照国际惯例，先吹吹牛，QCustomPlot这个开源图表组件，作者绝对是全宇宙Qt领域的天花板，设计的极其巧妙和精美，各种情况都考虑到了，将每个功能细分到不同的类，又极具拓展性，当时阅读完代码的时候，我直接跪了8个小时，膝盖现在还是红的。 +## 一、功能特点 +1. 同时支持多个版本，比如1.3、2.0、2.1。 +2. 官方提供的最新的2.1不支持Qt4，也不支持Qt6.2，所以这里通过define判断Qt套件的版本来加载不同的版本。 +3. 提供修复不支持Qt6.2的BUG的头文件，自动选择识别。 +4. 官方的示例需要通过修改代码运行对应的demo，有时候想集中测试下效果。 +5. 同时集成了所有自带示例，通过精美导航栏切换。 +6. 集成了自己学习该模块中的经典示例，比如多轴示例。 +7. 后期不断持续更新完善示例。 +8. 可以直接编译成安卓和web版本。 + +## 二、功能模块 +### 2.1 平方二次元 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/1.jpg) + +### 2.2 简单曲线图 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/2.jpg) + +### 2.3 正弦散点图 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/3.jpg) + +### 2.4 数据点样式 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/4.jpg) + +### 2.5 数据点图片 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/5.jpg) + +### 2.6 曲线条样式 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/6.jpg) + +### 2.7 日期数据图 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/7.jpg) + +### 2.8 纹理画刷图 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/8.jpg) + +### 2.9 双坐标曲线 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/9.jpg) + +### 2.10 对数曲线图 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/10.jpg) + +### 2.11 动态正弦图 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/11.jpg) + +### 2.12 环形曲线图 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/12.jpg) + +### 2.13 垂直柱状图 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/13.jpg) + +### 2.14 箱形盒须图 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/14.jpg) + +### 2.15 静态指示线 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/15.jpg) + +### 2.16 动态指示线 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/16.jpg) + +### 2.17 曲线样式图 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/17.jpg) + +### 2.18 高级坐标轴 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/18.jpg) + +### 2.19 颜色热力图 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/19.jpg) + +### 2.20 金融曲线图 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/20.jpg) + +### 2.21 南丁格尔图 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/21.jpg) + +### 2.22 多坐标轴图 +![avatar](https://gitee.com/feiyangqingyun/QWidgetDemo/raw/master/third/qcustomplotdemo/snap/22.jpg) \ No newline at end of file diff --git a/third/qcustomplotdemo/snap/1.jpg b/third/qcustomplotdemo/snap/1.jpg new file mode 100644 index 0000000000000000000000000000000000000000..32196d60c3795e6d10418b12fdea47b3b561218e GIT binary patch literal 49353 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 literal 0 HcmV?d00001 diff --git a/third/qcustomplotdemo/snap/11.jpg b/third/qcustomplotdemo/snap/11.jpg new file mode 100644 index 0000000000000000000000000000000000000000..0aad7c9fe7a3b02a2cf6904bddd5b84dde38778e GIT binary patch literal 92501 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°KY1 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 MJBYr3;@ABD0c@GvLjV8( literal 0 HcmV?d00001 diff --git a/third/qcustomplotdemo/snap/13.jpg b/third/qcustomplotdemo/snap/13.jpg new file mode 100644 index 0000000000000000000000000000000000000000..7e797f355d10f36d51e82f5da002de4feebe18b5 GIT binary patch literal 66189 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 z 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 literal 0 HcmV?d00001 diff --git a/third/qcustomplotdemo/snap/15.jpg b/third/qcustomplotdemo/snap/15.jpg new file mode 100644 index 0000000000000000000000000000000000000000..deb685467fa76181d711f8f8f43c2abe5df872b6 GIT binary patch literal 47707 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�zPnZZTsRvSEK4Lt06 z46G_lml~YKN2RHy+ubbMjwZilNlD%e%DGKtO|v$7e#Shv7X2hpLP=4F+n{s~R@=Icm_w|h+5p~|1 z-%8wt(B+u^E4g*%>$PL;if#JEUs2>52jgn4L%_23XIWA=I;JOY(>sEtdlTWLq-N;nPR=tMZP$?v!n}m2JN?lG;6E zz3w+s`qjP~lL#7iYs}8AHi*tz?<{?`Jm6V+NK*+Ht#}GdUFuz(@+U^iTm)OPuFqjx zD1B;`0NMApA4(^GkN+ZeoND#M?h-(MfK^KS>HFKT*=htRo8ZFjM#?4X6W|`EcS!P} z|5Wn_biHfoB;_*dw}9YCcJ8~scAUT<2r7UzghNKKNJaXvoZNzVcbJeMpiSS>uWdi1f`?cm_f)DJr|?)c<)NgVySQ}oOE{s=<%{bK=ZxOR65h}RYYbs4@gfxo zJy%NZxh~XDJ%J^U;+bO+a@dBEOFIKY$~g73E^aXTqghuRsVVxk?FK#j6<-r4dtA>{Za60qX?m<2;%uic?&d^*z)qdPC_={3_}#eo8|AlvS`!5(gzmVx11*bXjA2e!cVvXBlkI9 z{MRSF?A$Ma6(DADRTqSw7BJg^fc*@3j^YXfL&e(c8el>7NF%-tXLmnfy|VDT&{_)c zxaE4+;=%{2*GcngWDWcpcgieJrdQ_L>7g~MzGx3TF42;Bt0l0b@Nf&2FOX=gm+hfT_EdwoSTzitP*MP|sJ%n`l8X{hjScO}DYjGG6%K&DI*+9_q zksJ?S5E0-BqGiB*=-?<8h&}MshzA?0?(#w9S*$lag1AR~HV(f46a8}(hyd3UNlKle z{_q>=z|)bxhG_X&7|7jbkpjq~G3*~KM(Z>9lL5c5^X`r&;pUCbKoVo0=b_h!-~WxO z&3PV{IW4WA;*ClWM!$wA$7G~^;kZ2&OQv3&JEGjZ=Jx7z#%8MS{88EMthM?xx0S>M zWEJoStF&mA0Su{nU#xF51R}2i)aC@U`)z$7RDBImO3BFh!gjMhT_1@iTtKn);MxV1 zl1cPcl8=gJ!*HkIA2S>JQXvrJ;IH@0TY`j`MbRB(W0< zk&=|P%VM~LN^yC(9|H+>8J7?vdtJh zdx{hgm~k&y_v+mpS-GzLvdD=3i9~Br?(`)5%oof}56+HnnfEPrhIbq9AP{%;MOD7- zMaAG`CK{L{p1XG+TQg)6iO@3Hn}cSNKS_y%(IhyT^s(RL7HZd}H#NDE4-ICL20vyU z%>~xdN&$<9pKjF^*B@FxCr<4%yyF}my)`^{Ahc;Xd?H~Wte$Sd*B(|}!TOCi%S^MY zM**Vzk#i_*&moUc_gjnZ;q$ZQ`yax+&}~Ek1~4}y_nX|cVyHG<1GZxg@4k{z2L>?j zd%yq^qaVUBY1{IFzP4(t%Cl;^lV4Ni8??~4@UbOnT-N@}HQI&!mPadGv)=DTm(VRM?vk#{x zH~N#7bZ`j0!~WK^4kM*RPkAI7W}_hcd8gCZ7e?ZJ8Qm>v5l`9tKR%yB@uE#Cpq-E-hr1a zQag%LsM*9K^mw! z!HH1#Qnms3`QYcF#C>P=zLwyIJUU9r!6Axx}UaaJh2i%{V$hG#Y@{SdP3Fnjh>eg)W_o+#`;S5Hq2d zU)&Q>LxYo5oWf=jf9K@&Jqx23K|Yu?G}Lgsr!IIMyf9Fh6`2q7@76IS(tvVHJHuGS{&T=easZ=D8HCun``xx#MlC+BQK6B4KG@5zk`wJ|aB}P@-@8 z1pi}5DC!9u4J;c*jOgwowzx;bxDf2=Y|cybf;6e2p%35OYqG}bK+*M5w54EO}tVN(r)hXh-q5DEET!Abbdrsatr8C6?f!#4Z77 zZ|}|NREdf{aa~WZ7$?eMcg5FvN^hp~yb9#e66I|Egaf z{7M|SOxq?1MTrMcq9QE3*?rNArwe8aH4E9?CZcyO*cEk zu&s+EtixFKF6!V3NetjYsa#D6)QhtSnaqn=J#B&an=ulK5T=@KvG8O$V|uk;29kk) z3rYmlsjy=#sz)jwZ`L|Oi0O+9WRECkK3%5r!0)#MR*_&vpACKnUDCg*fG&#fYM+2E=I8O?%iX=K^Z2`asjp1Gfi7>p(}FI*c|xGe zKTM{8pph`^epzYw(dn~I@Dqd9g^jnfs9&2OH@tpXNet>teqta1>SX!a1nxBa=m73) zU04Nm0!Mbg%$0D7==skU{O@x+r_!APw&x7jS50OlvYp-*USW-W8F}Q*1v5bEvOzG4 zRKEs7Qkfa_r%J&^Q!c$`zNE4TB7pPSAIVVC3U3~&m;wLviE{ja!<3F^ftPO!2vC&QimY>!wKfLHc=pUG~^SmJ|g~NsyKE{CP&v00W-9 z#N&6R3gjINyW%BcM#yPi8S#uNW%<_LN8HJS7$z!OJ^R-qF0y%zH=G6_t4`|v1=%$S@URT>)InmFbh zl2;b5mQZvJqM51}0Pjl)f2w$d7-if-p}_9lCm~f5pK2|Pwg0}fi2x(?bTIVg!F^Rl zKgBi6Fj!fVd&WfJv_U}}mjJAAxxRtkL^?$$SP3(d_|h3R7VGDBnE^;i#IbCc1UNX$ zcx*AD^_czFrc?Y>2^4G`b%)Bdo;R1XS`TK8Xx5YquT#oLa!7@V!c*9QBp_!4iyPo$ z`LuX#ls~F;uiWWCDr#_#gzg~=yK?0~qh~6iC~muc;I#GKT0&Z!l@{F3{v`zDSXiy4 zu8=2OVl*ZAWJvGOREHApSTC=AZkcLJkACb|#y@OF3&UcQL?>O`k)Geg%>AZOLaGcX zX5*EZ?9lOkV)GDpppRV?gb$$OL!S%9BGSL+37zf{x--Z8#*lp{FJL*Z{R1g?q)?*5 zYY2W7a`K)yOfo!V2=V@1cJV+&Y&z9kvEW*~#MoLl7zhX$SjlHSs=43?c)6l2GgIs7 z01jeZPOh^DBB=ajzWLOfHP35H+~;7~71Ccx52h|FX1rFr1QrSdtEE{8w^G@x6zFE4 z!75bTs-j&vbUMv3u5AAPy5xDxxN#H^p}1n5qVb>9LJ}Y;to2?cbi+@qPa3>V{kRIC z5`ZFe5gU_`!edh`xQL~M8*4Ly`z0=odA7)fMCig*hW;{vz&hVuM|@=r+}s+{f6eiL@Z9cnqf#P(IgTA z?A&hPaAuadQlB^@_LR6|iCQyYnBNz9oxL+I5X+v?GPaCDG9<{7O>7O$6m@WpN`nt- zLyBw|%8Lf}(C_7D%3{Ckg~qwWGJrNhLW1j-j{!mOuHA%~GSoW;3pU;V1Yy}AD_onF zW7?K>wO{i_Z_I!m0EL{IIP3$oqGnNAx%J`6otWLjR?3aXRV&`ywxKR~4 zg-*QGkDOfvAQoeZE*yy)YKBvkkA+JsngQ5$ybAB!Z<*MJAUInz!0!8s%Zpn;_x0D3 zVV#h#N{Yh5%aOr8cIHf~b`v!xH-LDjM{4u!lX(JZn@O*)`qNi;lz3$lwc;BHAN*=Pw%>A`bN5JTU67M8Rjh zj+obyub4_0yy_I7fSEf5dV!NOv(|MG`IX>7zDdj0E7Uc1IvbyhFI=9Q=EasBOsv^4 z7ACrvtAQeg9-O-Xpot+97l*Z!3NNDA_i0dwQ-VUw5O=^2$nt5PA)tsbLF9nDD2c7H zT#!!{a1nyXYm>fW$XRC{3P4zc?bZl^zVriczG*bp@uE+x0H7}Hp4 zJO~a^B|Hcse!G;xSkWIQdTP8cyYOUSu^3?De~&BkVghB+GMOnm)Cj97O>9N3vWy(OPaS8PmYZ7sHxwwu7R0=)spS=NO@)VJ4%Pd5|Y2#_j-)2hw?+H0wAZ^`1W|hyc=UP~ow1%d7Q;j|GltIL zf$8kQm3qcvAk(r&e4-QBI4BF4-bAS)On3nEyculWkNW{oWU26ecVX$neA97?=SIIC zn*t+kzz^QtO4xvht2A5Q^0-q_xx|V`_W6uCBv_>Y3L-vHKSEU{?F0?a3g56yF9M%w z0F$|vj|nuMIJ_}JcjF7G%p8iGl&j2XNjAIGPqwX_*YeyKI*=&7Q8c~>ie^b4!WO#A z*A}K43lXLow*&as2|Dy4*m7=lL%X29Hm1QwGG_KkQDydNgnS^{2swuk2swvztJ`NA zf%qRu+@>r}MV$0=88tT>jE-UcNDTo9NN$+lmc5yy==Ojz@2^Y##t9ieRNb}3prVxX za^U%~PjZIe)J~FF`kL&aOa`H1h(;nQ)X-{*W7klH@pyJ`m9udiDeOW_=?^jVJ+=>);1c7mf!(aEpL4kr!4o8U8 zUeQ_l{C1si<&Gc-foc|zAD&}2_hu6Fe|$81I|jm+L(ii_C0hpOATqB(q9R+T=;)V{ z(ZUnw-;`zp@&cM%1BR7|~r@;R+3pY_SPYEPwPfx&dUAW});W@} zmID+#0OeRoy{P`v=qoD%ERs7Xg(n9yY2!Inid1bxX0T;HaXk^%*$!)s?BALO_5QZW zk<@qL-+QJ89htWwR8DGYZ-U^XX2HiTX=qsx?{|R2>lZCIZG(4*TcdHL3+6TIKnem1 zV%Vn$JXy&FgezbC4GI}svj;yGm_b$jezwnrDX=R4LDbspSs{Atf+z{^T}sc2*$~2f z@ExYPtVoDUHN9SY`4^d+pmgp_LWrBKG_Do3sOS2$Y4YGV{agd~UqoF{8WY)jlLB@f9)c`Ng9}zL|ooleG;K_{c+n)xq>m%Vo-=aDYIzUorq{u076(KcccJh zY4+HcG&THdEOBgIACg=;@}X*IMd?!;2m@r?*u($;WmYa@d^zC@wcqy-SIHl^v#5Bl5FhN)%ZkXPfE) z;Ec!hX^jWxsk?)WF{n6*tV0hFaII+O*va7Ge%nb{0x}<@$Xhe2`xhU~+o5Bta3G>% zrNyVk?`iz|YlPT^j@626juf5p`4xY>AJ)l6euGTTI3?D(;QF_hJyqZAP24*VW#kYnq4 zRc41jyd8`FsK-EuEutS^K6Or@hLws_PU!pH8YzZDQsNm%MNlw4w&{Q-`T%ww#aL*R zOF$2EYO>^N)XFDWq!42=bZET#1~&vBehH`H=K(TW=+mJRmBI`eSpQ6O936O1i>ApD=gR=sy>U%AK%o( zWzc1r!Hb;NBbh`1?~)pZ1`QqJi}b&`dk?rKp6zcq2_YmjLy@kA5UPMQ>1qf8>0O$j zbOAw;CSW1-j&uVE(mT>Y5Ty5B1OyaBRJtH`1mDo~-k*BQ`#k@9pXW*P+3e2F&N+ML z%$ak(Gdp{KmXhcL8)+I@N|NSJGrtoxf02>OjYI+vW|TR&D4EXAmOHX}gSI;!tM9i% zY^z2TzmbHJS*05!3)j7Hrj1kPOwzl*dZ)kMiUI-Vb-=j3yc_@){Tt8Pn+!fK$d0e0 z0^_|Y=RwMVS6Ahl9EuN3rF^9|gFz0_wgwF#U{N4(SbTy|ppn;}$$EwRS$BWuMDND~ z>A<`SEbg_kVjAh&vup?&@u5HgMFxzoHx?V{#mFDIXc9Wj5G}H7vKAso%d|Q{G3cHI z@_8KlQ!qOS!HyFb{dZObhMKEJmpGGCjr7V$A{Ee`!;C2|+o^ErP8{LUwM9X4qF%y^ zl6PfZ0Oj@Ap%9--*k~e1++K_kDE_HuHm-M!V=vT@`TI!v*B#9swHq9cR8; zB$lLjTP~chR9fgF4@d(TF2!+*4gCs(>%P3561OY|m8S>{ZB7^a0H7vuLN(609SKCj z*>n&hQT+O1uKNl|a`ekRt*13}KNN63x}D*79wWjKN8$k{gEYWYHE>i4-V}gr;A%qM zF|$U_5WyQEXmmug3}ZG46v4Kj=lu>LCz}b{NCGr>UX$5Q`%E_8L%!#H?!XW`%0=)x zX;If3i(7OLWAK;79)PHjvlMg8+Cz@|!;+ zSW1~qy}E9Y6|S@6sttP@g!P*EA)f`V1Esv5E_=PA;1K{>a`Sii>M)v>aA%_j9({0? zZz$u!4t_u&mVGfSr;EIAK2W$b6~!y_UM8!W{jSU@FL4tA{ySN3I~4bzv4c)c$m5{n z4f1qc+lF?s^;klZ5PUu7=;SGYjW3Br?CjQ{*n0|eS}Rbe8Xo8uRcINJuiEgbRL#%1 ze11L9d6Prs?-D#3BM+4do~3gpAx-IhxUlL$claastS=?Ptg$0a7D07icr8tktW865 zLo!vCUhZL2i_tb_7pVSS9WSOLAogqD?vti)d#_v7=u{Ge$pzW0v^=_jHS8cw06;P7 z67#c?>+&tedR(W%yu@jt;$CAUdUGfO(Dfs{IdDvWVsIK69YineiOcB*&ddD%4=mHI zx`$i}*X#sAufVHW>OUjhMPgZhk1iMQYe{%uaPvn@S_Z%L@|S#d;mAO*$@C3PiMB8zPdW8 zoe>SinGCQt$lAHHF%2LWDCMpS5Y{Kmr6mC1$r9A-fkNFg3-{fBX{H3!%FPq#)y|17 zfdn#$vk8|;V+FdJa28Ah+v@pe1jK`H4s2X&Twq)&D0LN_dh(zzd=#fwtWsYyJJRQ%iyyZJ@dF&$K4SiT9j=tjnXW1g{WFS#!g0+ti`QW5xaSpE1cYw zJ^hgQmjZQ`pucq<|HevcdIKG>#vmywIu&!{JW?bz*GS3%4 z1VGFapa`0FS=9dCwi29qY9OoV%0IvfdFF=2h+m zK^$r6JxmV(hCFsPjH0uzPLFYatX40VB{q@pVts?`6E(`7*iB4Ds#J-vzOGiU z=(?5D5nUJtaDSk^;&}gZ%qCh;mjoYi)RFRyW!J6UL~G}-{)tZ5-Lr%O5H4uG_!Q;7 z)1>?5SL9d|!9lZvRF}PX3nW|wZ`7wWQE=}l3%k3+!44ILXue+P9u=F~7tce9@%(?J zcv)kB4#D1If*51{Bh_+fSKvjd2Ksx_en0q}2naFPIk%4P!_F^yDNzEF*+#CmN)fPT9U`mgirPd^Pa{(mej8E`*R&!`nq(q1TFpzZI~0R7{9y20CvF z9tiirq85))rTNM=!=+8kCD=mTcl6z+8^hiB5K!(Pv@NnBgFgk3#WW~9o#epeDd6uV zWmv4v0}zN7swg%%uv3z4P{NGij7s9&7xM+3lWJl&I?9@7O@J`(F;u}PHw|O;ymAOO4V6*RI(Z~hg@SXO-ibRgO@5E0^lYLA`%SG?I(4G#(Y==%_w6}ik1duD$ zPjR<18*vhFVq zkz-GhSBwE= zXh@hix~aP0dUYhyjp@y4&kTZaGQb!z!s(x11z!n<5)c%EG$9Sfh6N>aa|Zf}FM4r# zJuhWI(nL@+!tdcI6i(!yNd586D9XsLkG}=`Pkx~|xB|3>FhOniMR5dc4FJHC%*g@G zV7LrefbeS~XK02JwgSz+{~_9Fp1hU**bQ8lXL;A1yxm{uRJQu5y>_Et`nSJ#INa{y z-iMriU*2EoL`t$WDAfXZG_-rfhbcvx!vtQc5O#hR{&GKM_mny!?@P=IkJMA&h zzL%4CLsev$Qv6-`-XY5#Z)Ghc+Fsl!2uQDWzrc0%-JLK2$6my{0O^uDyNCN{xz+$p zfn2x_MC^XHe(B*|DvmqZST_2()^`s#)OWAylLk1EBZ$Za*l%j@rSIg~IaNm3HcM}G z?`G?lcG^vR*AF-ZE%qiyz%J76W!pHQyK~qh{qD|Q{{6G*tt0|7PypyB^FQeBUH)>n z*p1%3tHjs9YZ!6>4iLMp`WL!;hrD}N?cYMTG(ad^9EpRn-=u2hb?9ahY6q9>?wGZc z6LuWC2q`-|13Rb4OYXqc^#DN#-1`sK zhQRPa%W~Rf{#`#Cg4t`MaE&f4__DyLY&! zHqt+;4^X^oZFqF{vi+pHSL`p=rdA=W3P)fbzMp@;!S2iC-Jv}y2NFOZhapPQyxy5| z2RFOV)&8OE9+iFOr8Qt}uo0GDgR>IWUqh@3Xqu)DdPSBrzPPr&JCl8988$cy@CqQzq83q>&h@MUH&5Sm zh8kXdxKXBITHyBGx2{H?I{Zi8@X#rztQK`o5^CBp zuXZ=&pR;aii!8h+z0@l7mR_9%m*tYeop1{o@9M*$nxcK0`>wT+MQ7{`_kG$P3bS~v z^S<1P&Wmfb{lS*gve|mLESvIRtK>seDvzu!25Gw@RK+pzt}zB8OrZF6mAZ$!+t~Nd zLAzJpb(a}#-6^WO_K5URWPF?tM_|@@i`O{`6rzFmAcQ@yW~7zMk@L5tkyZ**1AKLF zV;}}2M5s`lMG!j?h?oex<9F?T2x1px z)qo=eWY!2`zvfjk7}@w@SL!?K*1-W$je-M*n_bVBK3zY2#TApImo)iGiUccY*HWQL zp^V`3(X4*kfjx7dHSX=g=H?pR%sbLWKjz8CH!)mY!5(gJ#Ax57(O&6&@%YgVJFX7d z>z;Qq#L!|=2!ltr9=>TpLZ7r>e7UXffiNZUe0%1U=9$QEK3{d<9-e0~byHa>MCopq zMv z9rqQC9U+mG*E31Tw*V3CmS~a)>D@U!VML3`U32IU%7R=Onn_Ek0pgBOsZ_o3EGGs? zr?Iv{uC(CQtlIQUVT+Xq<#pQ)?U3}gEiBt*5`rJpX5!R(wD*Vy;SDoHAP5kA@QeqL z3cxBOsEIbc<`ubC0!K8i3#1Od&@lP&hzI=k=Xq$}UA>chq;yI##6^mlTb`ecsvTc- z-{t=g{P~=Yf&wT2?L)p}SL8~qd`AWRMm@W#m=9shFwXre<(}&7?8)O=vO=tt)LI+evE;L)PBrtW+rw-f8n9en{}1&!BiS{V--Gm zV~E^kBwo=9R5T8IYYgaW0j+tF8Us|6jSNawsJOebLPQi;gHuJiv+WNzY*SNV{_Ll{ z0<^=TBN*@ScnX6q!RYvAHBG(z@A*@9Iv6AIQeGI2HDbEaP9pUgLj}Q{r~zAOeE#9+ zs2H7*C-yfck_%iSTIdGdO!4*#%%u^5F;$vO?5vSv*VmX(3}}a`xW2w+oGLq*@s`

mLiFj%@dKl_`@jN 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 W>j+$3Ol*!f?WI6;v0~ew+5ZAfL{4D< literal 0 HcmV?d00001 diff --git a/third/qcustomplotdemo/snap/19.jpg b/third/qcustomplotdemo/snap/19.jpg new file mode 100644 index 0000000000000000000000000000000000000000..c12cad83d97c1ff58206ffdf8d387995359c5c7d GIT binary patch literal 71479 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Ż*-8|B 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 CkvgdW literal 0 HcmV?d00001 diff --git a/third/qcustomplotdemo/snap/2.jpg b/third/qcustomplotdemo/snap/2.jpg new file mode 100644 index 0000000000000000000000000000000000000000..23f20d18540226f13039c864fe837aaa8968cdd7 GIT binary patch literal 65517 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 z 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

A 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 J-1h&!2>{e;)pGy< literal 0 HcmV?d00001 diff --git a/third/qcustomplotdemo/snap/20.jpg b/third/qcustomplotdemo/snap/20.jpg new file mode 100644 index 0000000000000000000000000000000000000000..3df8ea671afed78f5ccdd91d19784fda3681b202 GIT binary patch literal 71215 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 LDb;HE{Nld=lDt25 literal 0 HcmV?d00001 diff --git a/third/qcustomplotdemo/snap/23.jpg b/third/qcustomplotdemo/snap/23.jpg new file mode 100644 index 0000000000000000000000000000000000000000..794bc22efc4f27cdff8c3448dd24ebe8e6822515 GIT binary patch literal 89028 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

0b4oWIEu4m72sl{I)a*K%S;n4sG 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 literal 0 HcmV?d00001 diff --git a/third/qcustomplotdemo/snap/24.jpg b/third/qcustomplotdemo/snap/24.jpg new file mode 100644 index 0000000000000000000000000000000000000000..5da99f947ce7d5efd8d1be286c360f1e58406278 GIT binary patch literal 64510 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 literal 0 HcmV?d00001 diff --git a/third/qcustomplotdemo/snap/25.jpg b/third/qcustomplotdemo/snap/25.jpg new file mode 100644 index 0000000000000000000000000000000000000000..0fa6db0cdac25a72a8c929313286b5dd2233970a GIT binary patch literal 111202 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

}F@Dw%~7)j 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 z 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 z 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

iGm|DgAQ#cIVZ#dHKSZ;2<$HiAo!y>oO)<)) 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 UKzF8c|0)r?(ZHZH^=J7%0El`lBLDyZ literal 0 HcmV?d00001 diff --git a/third/qcustomplotdemo/snap/9.jpg b/third/qcustomplotdemo/snap/9.jpg new file mode 100644 index 0000000000000000000000000000000000000000..f3afa17bcd1ed1ab693af9f488b02136c645d3f7 GIT binary patch literal 85107 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

CKCqkguZY7o*2J=Bqt%DiASk%z?Mb^;Jt8 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%0AQjP#gCU#FF+4A>=1x8rTUc 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 LFh{=r`_umq1OI&W literal 0 HcmV?d00001 diff --git a/third/qcustomplotdemo/snap/16.jpg b/third/qcustomplotdemo/snap/16.jpg new file mode 100644 index 0000000000000000000000000000000000000000..2cbaa33401485142ea4f0a376d522634b0195384 GIT binary patch literal 70488 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 literal 0 HcmV?d00001 diff --git a/third/qcustomplotdemo/snap/17.jpg b/third/qcustomplotdemo/snap/17.jpg new file mode 100644 index 0000000000000000000000000000000000000000..b8ce6a5a9b48846c9974a25fd423e513f1075f89 GIT binary patch literal 72159 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�=@?56FhTsuG zUu7C8CJM%G?LD*F4ON5ga}_|MOaArC6C)#aK=o&dOGL;wz4Jxj81TZ0)gE#jwx=P_ zAwHbEA8YZ&X-riATMp)P_L4(>I}buBQqMQLfqIlN#!$@0wDcb``t?Nw40Y&YB>~(F zo3HrDCdH8@)p{8MEG;gS|^BAs%vHf&8*JDVL!Kc*`{lajLbEWxQSoBZ8 zYqU^e03Fhb8tH`IQ<`C~O=ap$ZpBhy&z=|rHP&vzsQDj_^xjQCp9I#Jcj*-{lyvjH zq|sfA26uig=D}FsYw+8tx;?r{2B^m6q;TcR>`2a=n7A1MiXPCXWK_IC^*g}j>uer4 z^Wy44R^JVxzk)txbowp+c8L=d9I7AGo$k~;?1@f+HQvV`u{ z%yN)SnSB?U6Uqq3Zn>zPns%xwB)w?Zdir0>1^&|J+&0lJu9tR_h*uUL<}GL1N? ztWX|iVUR7v)wg$7D)ik%anGClVAg#WsB)A`g({#bRqf+|Bguh^H$boy#K3$a4yf9N zhAzB?3}ImHJ9k<>Tx$H^M`Jt=p*HOmlP0m5k^4dorRVh6(~JiR_T9fiY6R*`Ji5@U z5$Cq;xn@8?uE+7z#psYRf?cUxZ;CueV_02X?lougTl0-42^B9j5mydTQ_YsVF2na9 z@k*+G#|hxxs8hw5Xs`D*rZA1YQo^e7&KX$O$;sxA&>$DPo0ep|3Ml2HbpFzK0#$4w zo=Ty5^?|8YQ`a%2Eu4-Tah)D9b*4H_iO}WQn z3oY=;@Sh%`R@`jEJth#cvkV!;Gbwa%JyF3IVe|!GZ+&!%PX$odS(TP^k|>-heDoKp zdb0h$8hb7ip9L|~+}2{0&te|0R@;*C2zkDgij{ckLz@$gN{z#E9M1vl!Q4VDHj&}s zdScVrTCwta@;ShW=xtgeE8>s@*bO?TV&T>UMABY#fTl}uCtj2|4)^Jad7I9MY$0fs zM8BV+2TNEU$>2ygp|<)YdYCW?(b3Enz(HRO7W@uvk5Q8DiD|`3>~d<-JXJ8~ub!4g zJq~_cvm+SS=D6mR0`VjF3Zg|q#sD$nHX}7ugd@$Sq}t$}o8j$#o0KfM`cp905ARM8 zpZ783gOmo#Du?LwwTAn&FFxuUM2$kaC2r0~9Y4N7B?^qOIqeFrJTBru9}yCfX6-?A zs$<6V9ji7MN(wYk{AMsQsv54DCImE(+G1&LlYxUe*YeJn@n6=-lbL_1Or;vb_oW#K zH<_#cn#}T_MZu{c@@~3DgJ2E4I<8!0M#jO``6w!qZUIx4N&!Z>Rz<#4SQ?|Z-ewMA zi$;7!h4w{#M)K_M>_Gghk=AyZPMqNozs7MgtQ+KdQ-j2DfA%96AWKwW@^^l64kl(f zFGZ=S3Q%O~z-@#3buL@#H2uzM1-1RxPVo8Sb(BR@JV!K^T2$dwZ20%lqZ+TcdC2k&LJEKB#ybhH13+b1grpvG3x~qsylo$s?N5tVcAc63v|^} zmjd(`>AX1tD5YTArNuMq4>ZrGl3fVG zX&<#P?m(Un{a=|OJ&Bjh?>WUw)t9@4%G9`R%#%w;GFOej z)?b+WJ>ENvlokSsH?s+>U%`jGEu=zF=adu8(J(HjoJvLVy&_iKF9vkanySc)PfWw$ zV}LZ%&iDU*D!tqeN&4sPzQ|iGoe!>l;E!u@bPIBRu~_M*G158ql8Qmdtx7XE{=d2J zf4h&0a3K(+z*Ly|O56W0?f=tH|D%mBo=kwF-sF!|>Cbci^F06UzW$r@F8I=7?5j0| z;&~naw%J-8d;&ELI?M@v^h)Wd%+Q(yG`l`n_*SmWnql;4%prks}CqSj$3XS^tFRu|O}qIpTmuE>LvYOmp=_Wq!1^;j(MG%6Fm;4R&((xLdc<0g@uTHkyoN%fcKCrNLMRVm ziZrFKg1EJ|n(Pt60k}-YC*r>Z^gjU)Q02MiWtw;Qe#`rghbw1~=b!0{E59t@_c>Uu zFYy~Zl9xjHhzmY;Gsb@i!{?$pS8lRm9oHt7)QY87p>vcVMDsxjCq_|aTe{SgepSkh zhS^)}zDgu&m{fVSDiU7ej*qPPif^&0FX}iBx-N=(l7CH*+woC0-k96b`)*moyD4*< zaN5dXy5Uy`pQK$?)BMC-9W{SZ)}H?cr1XDOIMsX3cs7j zl!!D0^E@qN?AM^4{QB-!49XwSVf-(KIsbd$_r=9VF6@LxcB;#bfI-zuVr#B6vc`+?FT7n45e{iNcAmW4{iD^1q&ueI zKT+v4wfk)k+MerP{KL_I%}YU_aknMLQ>9cm;6;n-Zut?^2O13U6FJ%$FF$HL^+MJ? zR9XrRp>kwEIvBsat*r9qJGeV<+DTsKR2QM7re!rD+JGm8>!EOu2+|%sWp#u*_L%v;7#6xY9woq%#uL)D0m?xaKLWg-g33^(FM(|n z?^gKP@<`KTt>K3jpcSFkcIJfxS|Vcl~s%@JM>D%O{pl2oFiskx(A?KqY!&27bl5F zv+PL2+sDUt2s-i!n(NkNX^fFNZlYP=257(r3|6dnOQ2jlXt#&5nul*QmlAVU%^8fJ z2cD4VM@umt()gZe>7g2*7Fe7H7TW){GB3s4Vnn|b67oJ??quamr;*GUI8pL;akYt= z0klr!xEgVCMs$bH7_7xxxW4S`BP{IVxoFa3~kJz;|nt;6i`h=0mv&YiSR`FREH&8yf9`B*g82bWmQl#U2E z_xwhw>!gcPjD8+hV*IJyPMT3Qa0HJ;-*;JE=0-o);Y$hnNi~q`dhx?+*>tG>$nvh@ zBp`HzZA+fh)(b3c$>NzjWp)LFchRp?a zI%-x{SRt-U@KvkmYG1ooXaS*MWh{q;jfIz9+#MD+|2T=KN64+PD`2cJ4B^X1YKq^X z{@_6mhlbvph!+%#CQLkyn%a%OuBFZAT@vVdcy{!HSti{iC%??K5AYv&IB3%2GUVRA zrC*bRF0|PYLO}{?jwe`uI%R_im(RA-aR20wx-B-dx%gt(u2K!uWs)_&TGCzGgLPNe z)oobgVytHvZzbX|B3CL_+iY2W-VFtqfcR6kZI$q*4azQgVwZ*BBDsgpqAsd$u` zv18VIU>R7dWK|1grRT7wCGN<~86gDtiHzsGeDgl#vGs$2nr_?-nMUQ_B3#jO(`&dq z8$z36LfU|L8Hq?73GVle9Ofxfl}@n?#vn?pQc;9>1`ID>tX&UXGUQv7aH9c@L?=IipavSA`^5M-p!|H$h;cGep8UcYA6QQx8>B{D_dh! zV|Z}`@SlW_?OLdKYBUQ|2<^nR$f^=eDYZ3nAXbKmKuvR>Rbf9g`nnK`d$wqa{Elxz z!?k8RC^mGjRuiNf zuV65lNy}+9R0K8-!u39NrD9X!j+wN`cn$8H;XEcODm>5pRHu4CR|1hq5KRyjgcp61 z^${7xNb#CSZKlsm3#uT)mZ&(*fp!O=+{KAr2ZclLHg6e)SVjLCdF8f`}&hpWapTL257@sh5F&Eyojik-o$0PCBIHx_f9~%7AR$ zT_}>pp|lufqTT33YsJ^e6i+NFRb<8neNPv<_E6G4$I;DENzPEdLiXHR`v z7hyyA=-s`&aD*O!-3ataZKe@stb}ia(BTHpr)?6n`1L}{sVUk&&e6Eri8=|56q|XNLjD~3x$hI48mV2 z%e#)H@)c?%&Ik-QWx$c^UJ@DOi}&vg&89fKT^WIclAsv`BBMsb?W9chNx4wY?UZ>Y zf!Wq|Sh}y8W}|*b1pyC{wR5$E4vCGVsU#qu2#t@OpSOX%SxmTgmHOVM@bm;(OoIMY zigO#ZW;)(;L*~iDkafT})yxn3D1;ki zGD?x@lwZd_fm)1kb&lujjm(Kz& zm=~fsLq6#5Khn?lwFZn+H;n}8UMv9_sF5SE4Y=EQTm2g$5G`UreA7cIN6CD2mT{UO z3;0F4%qjuT;f=t1m`Q}b-{3)<4@&h4{(GvM^z?SEZez4!t{S6$In}-D(bP#`EVK`I@Yb)GQ@yVGTmQ9A3}K*r_KEj+cbmJcmUf@YJ$JF^zq&Su4m|R!Qj(VCNJZFb#1y@@ z@LT!U7I4@ibPP0=Df*%IAOHRT_Sh%tvnM7Y(h&#jsj^AXu7O);&>%kfPR0Ej&4Ub$ zbhZE@AAS~G^%pETY-BC>Su7Tr`&3p->#Q86LG%$@pxLJSP*a|1vX2Xj1>|~_f;PFs zE&Yl*l+?0hy0)tYGexx6f)<*)!DJj>0z`V>*bU;&M(;aOrCVBj6^u3YJ2WcCsz>kL zp7<{K^+pA9t{fO+t;)4$v2gxtLk-S}CBNiUr}XdeWTP(XS(|osbu{Z`Fju{nOg!I! zgs4-nZl|XVQF%MRyy5p>Y^yi?Hhu#B{#yOzxi>%G{(KL@0?R7Mf?!}^KqkNs=;sPZ8ib69h=hoMjD&=Q zf`W{Sj)#GchK5dzgL@B;oP^>&ISCmVB`q5RB{d5T85tu#6AK3?4-XFogP^DYmk1j- z4;K^&38iwy&Z4fFFgh!g|^f`tRH z{quo?hk->vL;@ZX0o#D?SUC8f%OG?(U>X)276=4$zKBJ;PseA(N;jimZD^PG~@rHzPJfLE}-h!-N`Jv|>@xhld_B z3ho+4G1blO&=N2GApq(BuHxB_gIRbt*Di|%tnpR%ZI76rYUW(S6v>a+I5~#5^I03t z2in{87c|3$=N2bVuI=r253e`+cdv8jh98}Gu!3`KrT`EpM;9?Ly_??-+XbnZ2Y zH1ke?;xEm4_Aig^Q#$2}R%B`aJAS?rF8G7(@#>GbCC$2(OA-f@Y_rmdUJbgK`+4!c zQ;xiNCx6~EHtWe&``K4FugPPI=m~#XoiAbh zA^8w{#eJ3D1F}55!>W_73~dmb`z6y0#ta-6!v$<2yXB=mnUh~%2`6Zk_%dV#UPNF1 z0ZsC;l5oVo`Bd{!=`+2%?sKuu;p+n(d%d*Pdhnl-NQlP68w=+Jm^`8H5GIGzS^3+z;~z>RV|M`3cf_>!Ye8sDCj8yQrnv z_6H*GiUxbq5Bu%1dd2&Vxz6e}jclO?2PW|ZD37_eUu3=}{gl+xAje*Ku`ag=Zqy%d z*@;&BGyArN%$pwU%RrIkTPh~Fo;|iAbOt%dJ?I)7@^|Jx_{Uh#-}VY8IL{r_Qt(c) zQ?m1+HM}o{(YBxabKdGPr@vDE4#aB$1TklCY0V<0T4XzSIld=m%?bYi4pY0F_%!|K zF&%I8ql+9i&7#426e^OzH`-CWB)<`dK5^?1Y4i{9O7l1c8rUa7 zSvhgD+?o4=^1h}?3>EkCj|>WuI@-;Vg-9c^JG^N5JzYuPvuF0;J4dX&i{EM(7WBVw%m-- zAE@1Mi3{QWejH=vB3vB9{WRz?T)boS#6%XRiQ%$9VNPoDyC3?PXa(l3|L*bNTVVXJ zX&l3gEE&MG$^A25#8)81PP>Pvk87T$EC^CBILlD7rf_giSZr^e^3Gd0Wuf3UGCq?K}Z6eA)XMPFE9qWj`~GF zYN_}3GmQ(f&1!oR-gZs9Y~Ss4YyzXB9lj)T^h3pcKd;1#+3JNx)^@WL5J>O`=3_P3 z(r)*`9nx1I5EO3!6ll=J0$Tj7#83`=h;38*NWFvc@vz%967%_Wj?=q))oyM&=9Qub z5>PJhQ0U%qIq-J+zY{Tk8U%UrXm5_uY902~f3-c#010!Y>|jC4GRbFNv4OBCgIrL0 zBZ(JI?3052a`v~M>9uM+s(Olo5lLrsKEh|mNh?fj+b~pnE%$d#gS^3fA@~CXqJHPZ zz}8(4un;C@ixP?>XAbc#sz7N^%*VV;73>r9T)1OUlC{Q+4W^kC^4-O5L}X-Dvw=0X}qQ~BGy5o<|V7UR4J z`maU}{~_La#$~=D{_}-@6FT3?WusCJy2yAxOWw)Z65?dDp06n(ToyGY_5UUfZn`hq z5f1r7UDe~{G$z+dw4Kic&JPuJ21(HpICCsOs5pZk*)jP#NZ05T-JPXk4-uU;IuMzp zjK;ueC-!fHAyRs%+-oGeFN8H)UkCpL*|N0cIO6z6O{VA=)`wf_{-P^X`yhegA>5#=%Qwvu?dbn@y6{LO6RbiMfA6_uu;(2DPe)c0eLj|&)zgrZz z%(jMd*@}qD1v<8gpy+SDhce$Z4H1%h#}!y&&qAy}-G!XL-9_>N(0^ zv0erI=dH|^ov)o?SMQeTmc8O9@NRk0ZZ;w6D}OSZu{C0yKY968R0T3u?3)Rx)~j0! ze!{q3>u>Z2Em?ur`b0!_~9 z-B7v@F%;?+KHKir6)*eCKJhE~W9&P0TzKDdy?SSekrmrmFxVM)ReS2+pq;f~*~+33 z2tCbXhp7A&$I9LIea&eO9*~y`F0KVktJYfP9S79$P5};Hj6==@kkOe=MgK;Fj*nr& zcBwVXx=J(9eF3{R&@z?X$(zkrNnPi$&5r!=Ajo%ulyhP4oZI&OCw5GN*hBtSU~6~V z+R@nMj?tIy>Jm@`MVCvqPc`kh=L$fYTDfCR{s~Q7$^HKI^xUWSubUAhX!lZSOK*)eXYCf*dPcZ%o!d1riKD)op)*WY zT8$3z?$E>7SiTyYLB3bNO*s^9yG69{0|77R4v{PWcxliCT=wvVn92EdKj*DqtB#&% zFKDevuf$m&Vy?4PLp*M`;v1D~KI8lDm-q1Gfaz7IJ?(qA^!dH>Tg41DphUyr4i9sc zcoY6+J^{TBOVrZ9v|1)PhsYg5$viG!$Ycxu{?0PEU6ZW`)qz}|tZF{*`RxwI$v0=u zgVTM#;!0-ZfuGYa_b5!GG{U&uhy2Bkujr|eAA2NMg9QClpvD6DKs6^Km%v)C`_6*; zVgkA~;%)!0@`VZ1%;MFabx=3w`4DQs(;0_q1e$ZG;I}XUhh%CWk&zsUyG%s4`7EM% zf$5JkID88n>93YfGs2ueF%S;wM%+HU^&eo$_QRdz4Dt=*x-zC{kEk-BkDy!rQ<69_ zD{@GRx+!`O7yAY^uQ4UKGo42p#>X@6SY3|$y!U{d5^#fDuLGe=-I-iLYYh~$$#UI#^Ze<(rD+gs zyXp8r;JA|%U--})N4h&f2eegj$iHr zKnkctfXHqlME2oQoys-ii<-z$MLBzBhf`}b+f5ABUP^uWn`;6kA0WNMAhPwa`+*?P zpKwbVv*Gq3%s(BwzeykJHS1mt_=lL?M7D=T>0+V3E+AM3Lj}k*E!ma#XPPG5P^c#{wAIr6{XA6+da|eO&*r$7#4J!E^4Bf8r*kgdR zf$aM&gbyfV5Z!WM5oCvVzB61fJkM^;BCq6cvwOC_a;qqPcr5*{c zMTjLRbUyv^*`vO4&-oIGJ@tr3(dH1FVL6`7#;XKGc`*y4Uk{V-OmFvd$MNM=BzCbm40p>ngSzS-WP*ZvluieB7zD zc2K-cFWkl_w}@j}hIL(*Qpn|vKewlz&=p;tJkF5{{1rglN}yJ&hSS@&%}d5}U{=1B z-jOZY(X>|HS*3Z1&fbFDZk_L9X5hsO{C7fA{4$rS_?$=U;P$o7-D_*>09N87vs0ZZ zY5wG#^B4FZNFSb7IQHm3OT>h0;T5tn%AD>Ut7-`Pa9D3dy>w=9UVcYXFh)xzy% z%`{5^bQfyFj-42m! ziqS}#G;*tt)FtaM+1gxsv)HuFVY&9(`F8F6@dELRpF}9SQsF-r6$nPh z032RkQ~K1s(X4vuIb>up(l8K!_?I}2tS7BMpVrfTQK5N0cpG;}=uze7dU9&v{-LeJ zzVc+u{=(j|Cv~ymhxIeD6zHa)>S?j?cl^HdSoWDX~_|9atw8NpDXY+MT0DxQ212#q!Szr|zvTwgx0=dbu!qu51C zqKdiQaTGc}ZSl^~uE7yglf=2CCw<*p+=m(EecCuQ|3%hQ4sen;ws=;d;^-ZqW1OKr z!7T^>YLsuSE(SkHWA|zZ_9sZfr*>eKEHA)!WVm#nmr-u1!tHpS%+5cpel)vIWKpw7 zJ#HpbKmom0Yhr~+`g-=ucKVb#Y~>( zkd=An@OisHmY0>_nle8Knthn?{hb)-;&1=D>rCIB^@Ed#;K9N-JDx122?%|~q&v~% zV1sQvW|ACx=~dpnb#SmZT_fP0!<71FFtm===Ng4GKVNoR9+Di%*cbeqYc1kV_C=*J zk9{xRa4S(sbhUR+2r=k#6s*Obh-a7JBWOz(X`Zd|F*40vu>923s0 zoj|N{WQ8Dj*9m^j+||$!d-GgVGyU_9uB0arJ<1O*onEA9e@?8p{)FSLEP>!=zfB>1 zqLUQCS%TV@*W8DEr($hTF@sH~Jr{N@5uya@Ftw|iP0&t|{ZN-7q>~a_Zh-MPoJ+dRwqnxd8{_#BW-pVhjvKJ&UomKH!vWo zIBK>TS1t)mWFgG?PL5Bm5*&wi>_4z0igqZ#USYD&XwkLjWUNLw&t0X$y*Qc&A{)mzGe9CxEQe?FpSw(NMf5Wy#6~z$u!W8N4)L2(a3rtkgd0O%xdch z@4;fxT^>iUspiCVs-aE4XJz?9b6`;+rAqhIZfTgwxW4N7q=I8PnTL&rpXi6Ky0?(>F~^|-C8Wx7aTyu)WT zZIM;EwJQpvvTQM99anhYFJ^FlqhBf;tf|25FvYBX8tFoCati- zMOJUv&FJhj$6JmJWLH94u}T%}#h4BGHw!J+C*$O!b(-1~B&qR3!&z^14e3T8B{px$ z1*?}zjdc|2=4RDe795f^iH%1dNWTuB9-I$a4zOySaW_iv~AT$Ny1HgcB;>BWRoXv8@|N<$no@xa)a#?B(>|< zw4{F4MvK5rBhC`87#Rh5eP<~RdAS=B>!*WnV#b{(WGJ#C#d)#(?I^#`OMa~gIa5d4 zExPw#cB6l!w_xWPv<+={X)|OaL<{TN`0uQ6_qeTn_GIurs<3QgWuv?Q>4!+q#gxm~ zIU2a>f#efyDHH`Fo@rk>kOGxWfe0UicNtFWvMEdD{mr8@j~O^;o|C7#7CfV^SVvB$ zDJ6w0@^)Y`pL3jVi=u0Y&IMXkatDM658j+V#g)RN(nrOT}-liNurew~ghEg^|fm36_k$fgAe2-4v9g&3|)4JI+ zl2j^Ab7sSe{Ws%=rH;~!*w)#}(n*&7DtM*Cq%;@w4&`r`xyYWFH>f0unckxR4#~nx zfCufxL~?+q0B0r)^~6E+%#UzX%-Vp|IjR`WY}PECe59zjFhImx4N?iW0B&C=1nqPF!y z$g>#ZLf4?oyx(|mRpMgcVhq@pN(YA49m)H2qr0?Kx7kI{=0Hk>csP#*IOof0cn%Jh zU;F~~lss|u{WROlYw3NutJ)_$n8U{|HiSl7LO5C*GP|6tj55yi?Vk$hk9_R&u3?>8 zQyMgq`o=H87Q21C0ce`dPE^Fg~mQcWy+U!loe+nXKZ7LU$@Pz%F;s{?cnhniu% z(5#g)R{~S|meVcna&u*^hNY%aDpH#rQQ{#w>Qj}-({>F#{;h_Unqceik=10L?sBQ4 z5VnlCNhz|h427D`pxR4wo|5ZciT10mQ%914&bp!%!F{U%D$2hKC~Gs zmzZAe&L$Gm4ej)3P1wzyDR(FHA z!wp@9=RYm_&6#H%3W!-G`e2R3OEyo|3fiQ|LWUbx@wg0(CNK`^!4^*0$+qerb^g{;8*g@`dVQ0-m>7? zwpkRIhe~{RaL82m=>2SB?Vq2*JSF^L{Z9O7(-F3IlDb)V@0K;#(`SBgKcXH6tIpk& zPJbz(0NGvS+ga7p=0cH+h=Hb0dSx4jKpX^Q4EU(Kla`0eE%VC4>8E& zod>e+Ev0v-sq{xG{6qRnVFuEQR9ROdu4*ful z?iE|URxJGHjkTd6hPwIq*xTU_yT=Ky6Vi0Yej&EEeq4^Y#T==?6*Y_XL_on;#+~(Q z;RrMNgA;`$D|n&(7{70;bdZ^ii;$>mV33UyvT%XbHMD+ryuH@c%Wcd`R#TX_e}Xix zrmol8YJ2Ccc>47e5Kk3`-i-iG3i;$@uL2#tgH97`(+X4b8wDPbvHGmx*tXll=hgdb zXD_MRsrHByM}OhfYp-Yve-y*UM6$NVr{?6!;C&6FZM!yozVTm$CS<&`zNG5H;V^biGrb1cc zsmrFo#%l>*5=xL*K!XC8X>B z1X1m@EU)>oP_dMTCpgLWNRNP1$Shlonp^QBXi2luUa;k349?L@kMVx+zhipe zT$4TuZ(kS~pM@Z%v9Ms+@)_cz-?q+cO^?P#W^>#hwb!10#gz_a51+h+LUD(g>z$_c z{u=8Zn&2*hoyxrzY(o09L($KR-v0zuI{O;G<4;mCrQsnR)r{dzL7|nq#AhAoIJX!^ zuZuiL9mq5!9T2N5Kgf>WER)w*os)aIu0TxeM$0(DN}%|5a5MeO!#fqVYIu($3hu`> zb>MSrQnY2Odqo4xV*6FU&BrNWI#Z}+UB1#P9mMh6ievUnk8gA^nJ!&ffgk7jGndxl z>y+Dv4ze3jC%Nn`1KNH7x>Aqns!197;f^$IZDm{PlH5)5e}eEMC)*$^orHcG#Zi$LxE#9oJzTGiF-+-2Cv#$jvJ&Q2YFVq)sQYRLIy!^nS`Ru_$txnd-ISYsp{y^w<{yv;o2Fmo;)k` z&m^L#HJ{kyimoEFUe!2BJnG|z-@t8AH_Rw^mt=^;{jIo6a~u9V2gYC^q*KvbXr2 zuV6q@?!W({zML`Oz_Ew|t4c;om5xmkLA*F05&tzGf}(HeDMb=XK9+C!rftmU8AeC? z9ts&})S!SWO3~x}J_@^gF&hja0BU?+!3dQlGfbppyjR-{>^e}-RpNr~#>EDk(K?#`jm&H|I zfE8#z_sLa!hBR`I85CMdJkRyxH~)|&I#(Cf#~Aw>Abpgzd`cl^a&Wh%RMN_e`U8Uo zGTYZR*!l@$@vLPdC9qFp7ZVzivXV?&vQQpAD)FM**{K`ldW*KfAwDop^O@rvvE;nf zkfl#`Pgfaq1(+%lbn@gSthh4 zIeJXBaD!o1O1#or?tN_-ZWGREJ@TPOTfyfiAsa8X>e6shyT3c(m5e53#O`jHp*Ztr zM6q`ql0NxrkxKr)C~A3Za}Y;>A0d@S6cB#!>`|SMZH!!M zmu&@28$Gv;#|VR#xV%zp$|TALpZY8{cs_(VMY>wfdqjlpa~$=Fh5XYcMdDh%G__EU zK^5AjtUAbci|Z#zKK-=e$f$V5+UpWi_7>zVegv1S;$}|p+rSS0_Q)Frk(d(PXisTO zE>B^Kd2jLF8Nz4MHo7MR23}Kus621|BFugTIN_ZDO`li`A0|gHNk?xp@gve@zaUYN zQqmSUa$;qnnimYo%jEJtmVKXep#m8BVu4XO)rN$ldm@LLcAWYnO>9y%aU+{8Y8yY^ zzmRFID$f*ZAd@v$U(6&C$L&*vVQ=X_a4daYN*j7wD#JvDSaFh_w9=;dG1rYX96Rk* z?$%YTvcL!2N+|1fol>$=zwG2lKvudrSGu@DnVL(hn#p3)2CCbMS;HDUWV|nwv}zP$ zk~R0iN)9jI0bXM!PBK#qi7R<&$ZUflccHA$-t`N;4! z$N{S$UBG6`A??V3SZ4hXSyPQA`Gl! z1lytEm-b32Sn4Hh)9V+w9z{Nx#4<(7)l3*I_KuJxA%TNT1W{LlLyXxZnXcCvwyz6E zY!z7Uwi9Kmc>J2j5+zC_=*3qO$8PhF$&CrYjy!mM!5M0rsHmor5>ml|vta7;T#f<* zd6%r16=s3>#Gdq;_IO?Lw89}hVa-$*(&WM08 zZ6xhs!pin$-8JAH`=7mDYMNuRfx^*`(Hcl%B^q+V}-2hM5-wi~t?1x@RAWNV#LkI_3@>Whp-{ z8|?VLc1pdBV_xaVE&OhB>)CG}X(gNA1e~K>uDZV{HJ&RFD{5dxj`+*<%DEo^otoW%CD`E7D}i} znH)`pheCvK=#p}kwwWH;q$Z@YbNn?VnOCyisl_Iyf%r@38K%;2GN8Ew`xohO)k@Mg zva8`qmX;PI4)3+vV6t+~C<@Ucn6?3@Y*9sEGi_Hg2SseH4kO)$QNM!t;#2Hs z86N~1k9nNSh>>Kxg*~GYi$jH`N|ZgnvzzvI#_>Vv-I0>Wqz_MrtSg1cw=1tO8oYyk zyXzeVE_IbAYpu;ULCk_qB z=%>x<`Mc@E^DW=s@x1LL{`q1cotmL`C2EN_?|F2IVWJNlm&lz7k1bk`b(ys=xRoSV z50&Jw0k+T5s#KeOfb$5!WR#vTAd82FaM=>i8zXB}K2;Qi{53P7UhN=r!442@n|&C8 zHZ5bkwA#u)c3(_95r~JNl6}(Ebr+m|5x&jMcxijotwQ?z7M5}%ur}?aO2g!}>MBvw z@ToNVN|+`7w9rm@sWcFJuM;X!^2C ze+LR^pO3;pE%SkQ^k|%BJx`MV+&b-F<2T zEp<$(m<&5mk$!?=sNh4V!5=xp`jBWoHel7wEd^18p~0y?xF{|POpShugdnV8;0 zVUjBK>(u~YV)w1x$!Kn>X>LAV{l(fBK@}8Jdk`DNt-}aE@JvwL7Z4FL- z9GNiV*o&_iMMsXkjtlFmQg#M$Qw;CsjwvK*+P$I&Twb8XXlapDu@Smd@M;J{VWftW_~!=8l}z6r9iQR48@>e+VOOeer0k0a=jh4L{XAepK-!pAMx- zZjWLJN5+juVT1H|rD|I_8P8x9{qc)oz$tXuV(}M=HZv1V2T}=PG#Y;rFpm?y&|4(g z&mN;3_oYf!m>bK2*)-#ErQq^6kLx_1z+XYBQY&Y`Iac%B+dbhOVkU1>O$cKGcwELBKZne0u|u~XJsN>V#sQr+g863UuY{*|7*_=@?2 zg{SG@5fXL?HLFxpHO2!NjKVrQ6lH{{buotk;Qh`njC*)R%yjVKxg#)*kBl-eYuk1iv{?dk=t5PDuxO~qf=#eYjFQczd?GNv6FcXjqY?-N3% zec$(p$zQ<4R|P+P5x$$zp0ZlL$>i+tB{qehLa)db&rVfH{0LJhE%ClR;^J$G^1n7GDF71 zGC0n0)FP$7hCgFWo@-fA>O#@fvXMN_iK86rcus+($bvZQ5s(`RHb6_Wv$g8OMX%%HW<0b3(yWQ{?a7Jn)7q=mZZ_PsBRGDQo9}KK>`5N zUBx|l7PN~^88E?%2ly{K=Xmdpl;T2*E6F82)J=bF|F{rsnXI|CFIvxmUZ0?o4UjZl z0l@7dv5uXsr1O_t!e}b?gP(IX@K8*f#S6okJvv$-nNL?2;|_0k;A>`L1Y2``$Fw8|mO|9UjyUpPJoqLI2;WBouf1l!*{7251 z7NZ4I-0M#qa%~--UJSd^Dz($bQ4MPBTX8#>L34lrrbKkt9o`C0XIO_Cu-vj0^*1M& zYAVwx6t`C!Jl4$QSF$4TxooRQwrA#Y)?Ow#EgDI)l7+pnv3r@t(|TW;3+2sA21>i( z?V}l|Qv5~QH?@w+G9D`9j}w;Zcf%T8=BTc4#uPmt$UOWK3q^|7fAh#rx&9|e1a~ed zG#9}>=$lP~j4n39zgSx_*TkRFAm6k=TZlmF-M;r(?22%kqnY32+DJ`_fmk{bxId74 zA)4nYYm+Hu-jgBTnldFj%Z;~gZu_)e zbA`4QcuNBO6BNrP z*7V_EDl;)aq~eXC&kJHYjFQVn%(g8XDUB6)hep<&Hv@tMiWpQ%+}{m&#mB>AN4PwF z=i8o)os!;$0)V#I)sOfI`XfAQVIM(O3Jha{`Z|cIfz^ZLmZ7XdI*6IEr_h^=)yD~I z2CM=lB}u8h7V{P3tafpu3oXPDnK=u5^3)oomQqsmY+FZ+Vx~q(S(9WlCu#JS4LOV8 z;)YgM$gdu#zPY{{($!jhO+Hz~( z05VAkPTz-cmT-cKtL732Yl`e@);9*Y1VC@Tj$fO$x<>HBKZnmnJqGPtlxi`j8zM)> zmEecposHvHUak~hpi5!l?m01QT|nQSm=Ffndsh8EsCP0#+*RMLeSK438NLZuE+z`IU9 zOh!nCIdZE8z!KJgp#|AOA#@1lk%1Ke9attL?feM<3-RK)GB6mHw@Mp2$NqNCJ%d~* zVjE*pr#tBFQc8r%O0RvwPj^t1!2*`h912vLdoX`(^MZcKHmT5PikkLpJnAuQn3qUo zQXV9cLgX6hTNDLwZFDE!r*TnWoD8z1IHn3c#+VPohY3`bsP@^s6eE)!c*`2unlsdI z$G$K5I&|kPCsJf{gQaktcrjX<;?7j>P7h{qgrX{}vSd+UvYKUIa5yUvB1e$2bSG|3l6*uBV|LVS*uXg$1QJ8mTxlJ*{dB z#1)eoQB2?{o0}A1m%yR$+))WGYJ#_t+9D*XX#3nQF+PP6wQdp*@wkbTv+J!+&HD-3 znhkqk*VIbg&ntXiQj}epTm>()AxFYrdP2dV!Hrr-rDb~rS!zefDupq}RF#WXpj-O% zu}O|Wgcx&9JOVB)OK#e(>tpYz?M~&gWG#LRLE>*lGkrc+8KEaHt~GD<;BQ<0a;B2D zq!}Yk8~AQdhNG&j9`uUZHgk-AHk~Ytd`_S`(^emYD_oJPdNz7gUtoeX6C*;;ag(t+ zS$V*+9F+!sGWYp8=dmJd0Uq)JKdJOYisy)Y_$ZqEfWB#qDsXoVRl3l{hGv25pjI60 zinzB?*O;CNtE!-c+rXGIixjS33AQ?RY7&&cW^>)NK&6{ zl_)Q|rp5rOmIwN!>=PQ%1Xm)eyx}PevNRl2Lv!wgUZA@$8Hp}5IGt!pmncZyWK8>h zIbARUy-?6-oV3OO_YxAlkZfVJ-J`}#C zLxWv40M81G!6!7@_dCKLRG4)P7em3|0PiLN@4azhgJ9rb;Sk{w;NgC~_6Gdf0yrEh zPBkn_4hczhTrS9GYK_FgdicPg4U^uP+c)2UKV={eqxk}x8p{EBTj&E3TjIASlsmiXD?#KJa(ju+0-}lWC%!@YCKEIbEWu18iPu6a-$@Q>X>S9|6BIObBfRR7*RBdA$ml?)fD`DHw>E2 z?y}ix(&NSI3rllJu~bD{sKoC+{wNrfwH-|Pj{E7WD%Yluh>no>!9n|{{-RgZ)`o%H zTC2_^Tg0wz2g{(VD;dqu6%xt(03#MxSX`r+Ty&AJ0FO-ylLuLD$OP;`L%bL&Q(blvB-$oPDswl+oSC3P}>E^gn{oKEo>K&m|0IAQxg$Z&WccR z!{==rR8|@>O;W)k${~>xU;HxLU?b$^bdXWB-!s-AH0+>FLCufXP9s73cFa?Pa`OBH z5_wp&>h=yd>JVxyPB1k({WjQNqI#z3W<#2sfmUDksWdYi32M`%&tBvKjIg}Yv8H>X zdjz)C`GP?3Q5FNwhldKmhOoAkKS2Q#Q^W8#1N;h%HcUlIOqF}P?`I(r-~v60imc6j z+Ywl$HQTJF`EIo7>I<+n#KjwHaTB-tjHY=4$CSt=(JhuQ-?`5v1bLqvX6u});JL^K zhhn|VNQ&v((G!-BiCwT<7V#$7LRiV z##X~Fgo^axy1+jdm4utZb)DZEf800;Nd=f>u2L1O9lp4_^oAS8UP6rMaQG~v zq3~mHZyUAg4VhW!TS)-?UHoy~}lZxSU`V-VN#%1sso69=xgN}&+5811SD8QI1um#GVt;-2pbDf!|=G0 z>TdPDl++wt+&mhl5ZA<{SsIC;Bj9vmU0&=HAAh$UH^f9sdgNX7w~!uu)8sY$=~I&S5Iye?5R73ZeNIgpWS( zZk}EL1%xGFiQfY{jU~y}UfeCgZ~qS*ena>@;1OF)tQJ>Y*E$^Z9l{{IO<47d|# zmfk|QnX5vdFJPdeLVOaWZ zF7vq{SZ9i-u}@=5h4=9@W1TM~1j|GaZ48Y<9sLc~%v8o8O16(t=;Q-22TaSRm{bwU zPm--aF|rYt$yO>5gk*`$3^@HbcV(lrU{0-bF%{b2jk8fXF>TJI>xaaiIceq8XNr5H zsc}^!WHMmXSsQst?WT^PqG&Xr4AR1CGiCZM!P@r3gv(d_rc-0&xo#Z()e{r8s${WL0og?T zjaU*7*>l{Uw^SZUGO7Z?R54F`CLHZn^|o_N-&y496(>)mseO9eZ>0^cHKhSdY+PALtts9kih6`ofQhg&rB`_St=6>SM} z9=#*7+zM$bQ40IU$?5p{3$G4mV9N8KAnHa$NiA?6;Rhuj;?A`001gjR^b% zVZT-+>`JNqB1;}4p_P=WN|zXtBT&-f;-0eQ-Q4iqbZ7H*&XkV=mBVT8Ao*;zudC8U*}T-c$rvQ^_$p%dL!;iOs@q#MAtD-W;$vA_mr z4RDWA(orkGO8>YAMTW#t`-l!?^oAl}?Emy10xLpAkZ^I*tf{D z2ZosYZ;lmbK4R%KS^yU&L~h-60aX-t{W2eO;Vpx0+9c~_H9yC9ZxB)twGCE~nn&jo zjeIWj6)l3RYN=R{nQn+VAG0rCz=*zN;@>YLM~JEXI+0#> z%-8y{OFQvl<(M5Ysbqp(zHv)dz$ga6`%#zIf0Gr)*C{;df&X+E@=Oifm?+?A5252* z(pfp1B=38KVV0n*RY6>(9?}{DAJ&nz{o*+C38FUx(ORSOYqh2rnffn@Jo)RKpSBt-8%k}UjZ@=T8uaKA`#4AAB18R-|f^^izvN~SaPFtvRd%aHFN_V_&G*aw4*Xq(s8mnBP!=$MK4ws*ZMaBEkpem$;DfGce*dwIk_ z*Hisc=Y&%0g`Px)2WANpiIKK;+aT^w&^Gg533C~)tBwk5rt>aOv}(Hc(6aU2yI(?~ zVsja-yHfY$TW#ua+nQqSQ4C3Os&>eURb~iUUuvjMHU9|4D1P{6j)PX(53bBo#&0sq zO50ftClPw~$QAt&&onHo6T|UCUf{JnRFlsc0=_Y^7~?bcKbU*#s3^a#VR&eUl5Ql2 zZUiZ%Yv>pxrMnxXVL*qjL0VE^Xrx7?8w3O-L>d)PKm=*O0sP&!_wzl^yPmba?~j+Y zm^gE;ea=36pWWxWW;nDU$7x2#5-B6=*i!anNnhOqC3v=T#Gt`tWTKfwv9C!|k&iNoEA3x4S@76GflicBrr%c{--aUS^PEZi}v%l_RN9=>Hp z#V|SaRTYc`9{sl&J-AM~GM*`ELkvCm_r96v9Hi>l8Ju+Q=Xm-Jmg|=uqCDL%u3|W- z3*4ica3my4N)|QXLuO@SPEwlt`O`xtUbrH9*S?>1)96IR$iGA{aN&z7V7H-EB#Lt> z;ztENoa;6nU|WQ#QuxhM+tIzXfn*z~k%{j=Hcy)&edJh=$ywz&$?=r4)$lW!p{kDO zv20fWE_hns4+);mrjn_M;4Y6!a-QPD{#0$jBz}(?E8u7*%HG~rvT7`E$6svs0u{Kv z%}LGNxos#6xGxl!Cm^O!$QvsUhK)b}^E-ZaH6!3>T%o$;!r&J~V9I*53Pl!)$#5M) z!X6?g{<8dA0XADu2jA)+z_FG)LRw{cMi{`_Q}el?TJvA^orzm)z};aL+g6_ z?x{+XN-)UJInaiusj^H~M&;WW<-=S;@~IqM|B3leFJHRO_2|VhQ$S|G(zYX_4(zJ1 zY?(ew&i%dmREt@v;Y zgnPHMdYZWO&Sy#th66Tng$XXkbPSh$yTK_k>V2FXQp(OVjU7C1pS~^DZ=sv4_?R>K zjkKoO{5L>P>OWgnfYI)wmLst`;3zA7`6XToVCviv7E8E++7f&Eed=1jEw5#{-+;~J zT^lK<7ptf(D2CEPtMtDC+=*5k=O(`a*kqkJ!zeGXSa{3darF7oa|k}1$ZN3x1_l+Y z4{&)%xA)nGnPx8?{RU84UA#7bAQot{TpHQm{$m1~*jAsb74Zc$Z{h~K%skyA@M(??7Z9aUs^Ba(^RF`&H9SX%+!LR|m3lCMUa+fHAP_YV5 z=&}!S@(J{x^%;^Z(i#X6dEdRCj`fZG%3NzJ(Y^#Jqfw(r@@u2?!JLaTZaB|LD~Rux z@4O>ODbCu?g{4_YoLX(Be3h=0(bvHOLiaWk(^X4Q>o5$JX_<_wj0`PKtDU^Tb?QB! zBtqppcV z++doDCej~pAr2OAc|Dz!qFjy&GMx>0LVx6=nn=o0)WD&P2rhk{c$>Q|-F`m?MnF^H z1`(CT1Q?f0jh)})^&o|wO}tGo<5h|m*zgAW1)d@DxCW1qTF@WXqs3JR&4}QT7U|)^ zy%JiqDXre42|f^zYLZ$>RHHvkm`;K}%ei=y{EmKK>805E752~m-vB&culwkxsow{# z?Tw7ji6_kOf&CT5`&EzqdW064g-3s4b@LM&RkXxo08s}b^e@UPBR|7DkO}4)P{`X{a+aItKa#xstxO+39r@0!GKPMsz_!HGo z1fRS^ze+Y*@l&kv^ipcj=~#*kx08S4P*}#0Hh&dIQ^_V@WkPc+KHm)83Ud5OjQsD! zbu4&qd(k;`O$|vt;MH&8O_^{c`MkD$vKtLH*3BF9Wi@=CcYjcaEosD>bAI01RAJJG zLSfpJLfiZQ_;Km)e$z{Tbyr6MP$VhTug3qgz4S@JzFmbLL1tLLV&jVVdgV*WDTmfo zZ^b%IDV^N+{OVK40#lt&&zp+S4^3#X9s{JJjU{$ap~A-v6H!4@QwHi6S@lQKh0LH1b0jsbzH2~Ol-4oARbZqzP|y5{X4)(u1A>v-C~z;ozVYGAPHry ze4~ZYWG6{-9J+C%FFeE)2D~o%l0D+`?y2(d-dauWqLS<h3G|jt&r~5@M#ws~DP? zVL?N5CNO|vtDSCLm0X)mZRyV?()X|wZ8%R zAOV3CIFn}%4RmxPJBo~FOfmwCe9f<43!kZY)4IgZPi(j>no7mX)4$!a#p8{?$<#_lVsUmQAza4d zGvQR?m}2|d?jWWYhJO^X=1Di>$y4lFn@im2?)IOyktn&h>TK?4oZkJ!nzb1l>+cn* zl3%joQ1SXW7$JJuamoj>HbI|1%m6EwyqMhJ5hzstL~Y%+(#MW7C@Kt*9<(I4JEl?v zoG>-qZ_Og#-%B?{@Ssa8pLNxU*<{q-MR=rAj0XftFb5@-+x^1(YnzrO<>%BAXiLYA zO$L><`^z6|C&{l3)81MhOYq7eCLA4gizj+1sYlV*Xny?e8hWSOwh*ur8N+1lrbc~K z^5C15v+@$AZnId9hJK$4&89KST5;5hD#yoIg{cP3kJ0}vFZ-5Kh~Z7RKMzx>fUr|x znec1n<12j1n%A9Wrffvx+Q@VXL#^6{scCx5kO6lee&&Fkr|k`*YwTDnpw5$K#xk%_ z*1yN8$~voWzNhX8kROIx?S2bO%RVbCz_daLd|>4^Y`6q@7gl+{yWhSl^cyf+0Y!6Z z9r&*T%n#BV#U=<{d*v(=nahDng#$PTEiYvFfS3>%dh;GvoA|GFRN-&x9=FG-NNo1= z^lz9K)>aB?v!}Ft+Hil@4%feAW{X}`P1{VBf0{prrAO<#;~<&!Mn@Ie5vjS5-|E&dy;%tX1kA^zhsndht@XzXhH8x zBUa#?(q$LK5*QOtckExb9U>SJGsP^`R)tFWBX)WZ3 zBAF>RV!xFh$8`|$l-!D70xYbYZ!VTylI1Z=!W?D>!BjaPTsV!Ym2()Ul#OP-2^n7w z6G4Pa0wNh?2vgv=LcR5|cYv@ago2IgR~&H5AVgO+mI6ADk`pd$(Yma!)Rb;K-Zrp$ zF-&Q;g$R)vZNW+3%2SyV@F_X93DJa-t3iJ?(H(s_mThSo?uB8qpa=znnzZeqA2RCa z7^&P?IlZSzj+(y$y?z6XBHo6+TUrN$NZ0HCONzmN8o2)ksEH)RNJk~4pnSN{N%Nk?+WQ$*#6d1g zF{QRDLo;R0u<$HJPau*tgy^%lYSJ#b?0~v(yHp)mcgll#N3QHkOGwkV(w0xJE@a^o zDHl8+N%eKKVz)DmFLz*k36T(O{qhm!JiSNo2B5OqLQx8F36NS1&KH-Tv=R5KF}}9h z1A#-%s>F?DmzGuEK-)Cc?WGsKq9FmDzk>SpmKlA=G0rpWZs95{u8lo)dE;UCGb1K);5(q_K> z4bZ}G`uvZaY2o_%*7F~+H}REGg%_2zxGSN-iDlYqozFO;6;pWU=U7uKbph1vVUsK#PaWYO^mCeyj zb{Y}#Vw6Lyx1fY(8}>f#H(;)?X7MXog+blJA?t|RWP{C*aM~mpwP%23QAD_*Rur+4 z9*2FFWByV);j%oKPR@F!%E&_K?P(56nTk$>*4yE^yF!IE3JOw2#t#^c`{y{nB-Nm) zXsSU^vdG1ivChwQ9`RhM*ziNEfE?qw+V{TKbup71r3d$nTpR^q?TNZ?Dp#$#@De0d ztlLn^me@OZ?yvlp2!p#QHp5-9{p13;w+X$m$kghW0%o%Vxv%dafg(CPtuuPQcXm6y zVNj3Ptri+W!W9fL#VW>$!yk@9XIpfXsDB=BKr4e+#YyvWlGkleOv#Eb9lkeL{sxe; z9g2iJJuR*%UQ3*fVk>OCQ$;`&Y%F2UVv@`*2gToxs1)iL^6j%;l3^LdMv%E$f@ISx zpzP*@U^l_E0>?)*pb%mF`0uB_nMRdOCt5HP5W~xlFP0iQYToey*tk} z+ai8SG^IkgaHfJ8O>$bg!rnELXTMmV78n1rx%W4~mNb!I?wA3jc#yFfXAEnw`3OpQ zLG$|g`A&g)=nljzTC;?wqU7yC6OM*~qu&fkLGjNVdR1R-=offJ>M#x7LHfA_^F7MQU_i8y!O(QCH!(76Km&l`G^ zO@SV>K9v$A_L+QCTwJ;X)}71>!Yk9J&d_4(`l!;vwYR|y{6hNrV+{|{9Q79U2I1-Q z(+k<#dQFOCQC#U@I3z%qEB|ga${#b;%-0CVQ&#?msr)A9SL=EbXX`fn7s~svd9?E( zDu#cg7h2>rL!j`urLX!u9y&&Lhkz-3>_=dygQn=`lkUOJi*o8epCcAzC#>s^5?%C5 zWyAt4TTZ%jyV7KTM5YtAbEr_IaL`{8Ra|}fe*c<53m(wzMWu;WUrSW2C~p&uHo6_P zLfM4#Cy9r0R)r}wdpj~HBhHmMKb~fdB6^TknNXCQU(xqrU@PX_1`}#EMe>Hi5X4BR+0xlB^I4= z{syfyDG-&qnB;@~1{AbaPNWnrl0Hl-Y*fQ7dg3yM?Ui2}Lg7;IS*ZFkdC1R>xN)au z7koR8s&%>6?QvE{;8)RHuX$CR9gee5Qpw60?PeFUm!3&NvSx$aX4Z^A^rlp?&-^8+ zMvKiDJ_=Up_nWw>ijVqvl4=X@cjC(I#FG*{!_Y3vXqHwwo)bn#*8lqd#Q1NiQtyl%r#AS0aEE7}6eYu!^Z`I+p;^KvrGr5yYxufGWQS*H@* zbI!YzqPePFeJ-K++^5#Z~^h!=VUfp zm9O3lvj#%>nEK=v{TFdP1N(nPgDa#Gp$u?+!Hy_~%T;z4#UII{0l{p-hV|(=Us@hE zxkRx%e)Bm#8^$gTcBQ5LY!7R*V<%H@Ez@ZuHVe<;8UM2bEyO{NOC{=D*ynqkP=Ms`EsULfaEkGW@rJ|VDT=zLn z!{bK(=1U8V`bL)22j80H8tWX$Y%yGU=P&@!3dFl80zZ-KfWMYb0lyn2XLI<<;sj2` zJ;6-5K~4@ z{|jrtl$~U4iB!K-wzZqCt5;ic8%r`H8RxwCtGvg<*x>5oFl(D2&IafYG^scUWKvs* ze3bSTOd~*r-)Vfu7Q`&qWpOx;ofHN{%dpbXC4 z=0B{jF^J4kU@YYOr8JNLwY{ked#9KEx1dSoWuHLamP1%{{mn7Vgz&x8U-99lS`n?d zrEKpx2+DL)xo6u`uy-Q?B@`2Vutu3w!VEsX^bf~{Idqt`lnSz*Z7OH|<3~co`Aj>5NaYEOd&W2v-+dHv0 zOA;fp*+d|*N|B_{Z%HHPh#&?95kC?eAP;V*b8ve#0dg@;d0hfj`;3hA&Q@{RWf_7L zPevLh4aQm7vgSA!DZ6cc>0ykdj}4_8h33(p7J^A4v_PU+bkH?Tm%6BRo?~0xhx}Xs z0z+5B0QP>%&u{XA3LlOgvvGM>F!!JTx=w8n%{>?z-@48`;NTk*sC0Vx>sr_drnvji zuq_gBQN?k(kFE_1e>X(3Sn!l0C#MhF^JN)yR5t${^ey5TL>p;(C6fBOwd|wAnIa87 z*;j->Vir^RV)@=F4edQjWZb9O5ihuz=2w7et@R@}6&s_k*9H~(XtA)uL6F&Xmf=5M z_HPYz4D_-=+@UD0Z&e@#;Q*ODOIjl{xjt}KT5PlE1L-@jOtx&S-+!+cVD1|X{tXE6 zG#&OU4nj1wik@T*BOpQ5QHZMFfG3r225%x5uG8CkP((Q+WsyO!uTldC z=Qw)#pD;Vgko?yxhqnJn?r`Ynm6N_~-HjQ1pbvAsS%ObWu}N2Gf*O{XMvg>AkJQDR z9nxMtQIsWaB{I-pwehYzU$Vt891h%W9>xd}c?@u^%_JJC(8K8^NjENBTVND+da3B^ z`X{|h-ZyJov<}R_WLR*GT?<(0+Or9#AJrh4{}b;ZB~#ACg)+LbVUwk>Cd~^`49*kq zP>!8#ITe?BMSjpyTQnfKpIN%JiAC-F!0!snz--ZXkKA)1^Kx6|u2^9!b0H^8!_bd> zyz+3K7Z({=)8E@g8pDP?;*@LJi@{6APj4e~t~TN}nv~a+ptbrZeuu$v4ss4Qwi_C$ zCNrjqulgpC`5WLeA`aToY*+4snAPm(nAh7{gR|b(`^^qz8HZaBA%ko9oeCDl!Xz4j zYNhNLmWnyZfQz06@xp>fVcoqC@D9SHD+?G= z+F$aY!6^)u;#MtI%fe0PZ)b8jB}V6?)}Q$jHgk!ON|A0#b2(~$!oYkN&cZ<@AOA8dy7ZM=Rx_V!v-^JrBqQMW9@|4G z;IW6Y!!{7kBrPGFk1L0{@s)En@P|k7Rkqr#)p3jtSrb|H8akNv*CW~*OX1hJ251a@ z$0Gl_7k{b!MqN9LOU-)7em9O$h^!9$YW202B3UG7RkV64-!GZ|Dx5J0@uKQ&h^%Z# zAU(Fet3GxBisEd-)X6BZ?hLHhq1CnZ9}@jn8VCai2!VimvT$O#=~hVkLoWsz!8)Ow zrLR1%_4b|(J?VFn61TH~)pZ{zq7e>cGK}86=N^a7S|ERLyc|5?p;0ho2GRXP1!Q7I zO96H8MHGc}$9P%$iJ~#nI;~kH@Q*EyAsp-IAxP#3n-OaMN`NSr)!(!({_g%HjNZ0& zba<%rlU%5csU?tRHT7zRn8i!Mxx5Kq&WB^F`O?apQ$lxD)a5f>l__Aj@+~$^CF_;C z;gft^=W#zXn?A9`cY4FYoF9C?|Jf)1m}9zqp&NY1ag08Cs5$lZ%7a3;V(FS8UPh#P zJOy-kmx7m%;y>XRYSi>xhb&ze{qAmw*=qx?PgV=ml`` zH7x`%HN>`6oOcQT;d&HlNzwx?iQO=7kelOy-Hh_u@( zfQ<69qjoe$B{;(=Wt-WD*vNlZeive&5W@TaZTOv@vR?O{IExx^382Yhj1@~?!J@e% z&POQ0{&#}nS2{9wndR;-EwZ>0>gWLjv83gXRE{{SZrca8_}mUa_qUhZ`j1Dj^21Oq z+wc`n`7g(p4SS!8GuB@JfS)UoEvMBiJe=a(lSyJ`J7$jA8`kqMJq2GDfH=(PIkD@@ zOT_hm11fdaFt$~QhM2cPZ(azKR$E8k?GA2U$V!+6A2txeNpsfd zaJu#6oYD}n&RA|Maz6h|%7eGyUkTxr8xcG|zUG5SYvv+{bHnDX-#)=fVYRfjIk+9z zbxymzDJ6*G0WyWFU5Y#P8_*>cjz3Gnf9I8c8BiI38@7@sMC(<3r^ic7+oN!uf^J-s z+T=FsyW$?efN-faOqo7URvX+Q{Q1dy?IXbLExUw+S4*yA$u*lL4!$o3DDAvA+S zryaU~zTMXZL}$5ha;oT`dbXLGdJGC2CcYHIeCY9WfMH<#Va5jK>A-v1NP5vTt0b$> z^lF}XLF-==WD;|N1^(*F^uO==zk^EtKTZHM*8y0WlCRUc#9Q5R?JRb^Ugi%Wa+ypw z^$xPCj(xj``R=&0o_7Q-l)cUjn;bi>h#Timbo`bK?`{_NUh7AVMxAT%LZ%yVCLgs3 z{c3zw_qwY=WkzMM<}6-R|M?Yg<=Q~?lPTXDtl~wGywQn?*DDb-U$k$xT`Hf^P#Gh* z$94}KN{I*M0H=+1eEG<0ycXN-21UrLX((QyTrWF4_#+sc4bf6RRi@4bFv3yOGt5$%+4@qR_ejB}cI{Ucc-fGcQHC>x@IRF?m5yLB)sEix zA+@B@+d*?cUFBJ9N)Ss7`?rJ5{pESp!wr=d*&%RhJjCK*r-;rqQ4~F038xYW=Z~E- zt8Bi8$z(`UX6f5a%J7dU5P+1O(G1aDYx7E3B+E;X!l2?ty|rP?8k@AK33zZ_%UI2-wO-YPE3hA0QHJBhZiOa^g8yQSv+)Dz@TC6 zOt2o;!2t#HCv+Y|hROC21A+`nutpoJjFX^lf|YXZ;-~5U#(NcWrKq2 zfTP?(x&&00AClDO%14w{x=Fl5%G`|GJ#{ZZY=|D^zX-4{u&x7ZTNU#m<%aeuabK}d zI0gY}nMgSy#+KQrC;NVa!d;?vX|+T7sFy;i0SWB;|G};fZ3q3W~4w7e-sT~_l0QQ zPqOk)3=>z2yljzl3sC39FIa&@HB*C^$nR(0Wbv^H)k&)*$_p+`BbUfn&VKCbpd0 z^&^zbLz;~P_*ajGui0PVM%DQ`(t4#oM1v5Ms#f#N$mcKq44)_N5M5Z0r!y>r*Mek! z1}gCSH4$JS7x1rTR#WRg>)rZgSxz#?c1OK5TA)*Y@c|*njlOziD8i`nR!sBTjn(n? z+Un@PsSFrDxZZ-unp4u&PjmMT9*bh=eJTv~9Zi~oEtkJuO*iSvQjHQMXm);Qnlz;9 z=rv#6J0kAY3Bpm*PWzA21eqzmvp7=>SL$*qwTFb;K;y!yw{QW2h025fp^5>+!6-!; zb(Oa5f&}@GP7Ved=C+=#KQ{}Dt`LRnKKG}3-=<3DCZo6N9L7prW2iVNyX;duYG%|k zk6+%%DBVJ+w)RQ`WF@Y)PDp3Ni0W7supLFXjjc%yZsQVJ)6e-T1QR)Ql!8llLrjGs z=0Y84jy@>18*pP{Ma#k70R@u?h z_vp>H(@sOh>l(iAj3f^cbS^*`X+Pz-YxupYnkD(yt6FrA-IG~J^fn{VjF+26 zUp~U_h9G@j_NGV6l!gdv1At-hK?I1y02`s7_Hr3J*yZ_09mG4zn8q-%VrKNRg;a(D zVWw);syGU)-q)thQ7)_S({*f{O^b(<)%{p9})1%&g5v41vvlPk%^$?LhuBRS+{`9YLHbmp99Tr zObdVYGvabPqR28vMupej`>5@fZGYM3EQZIwFV-iky}=D7tFVz_*uuFHH70q5Nr(`8)nbg#U@c}^2)-(t%9+yx?C=z&hhrDcWa*e_{c zo1(rP$C&In)8bxx9;m-PFBkm_sSwNU<6wLo6;P;RVcq#ESJ!ojB^ zDAv2Gem^*+`JQOV_z#o5v^cAonv;yq`|Z!^D*}lPj(If64lWDu+C~rv|C2-ACf#{l z1NmY19DB8sZmsog=Z3WU;;=&2AZBzYVy(1kZIj;0u{$E`ye;s`q~bR$gP%!Ye-SwF ziT`Id6Z)sEe1AB{{R#9A((}|9Dh)@vHu6JB@!ulFV4LGsn3HUeR(6rA^l+8g8-N}* zC~EtUg4W=oj$`vg*24Sgmfgb zY25scf=^}b7{0V2OHz3XO6hd`XFzsw_q5@V5p=IOI`&AY9OcAZkFcu@c(h!3#J<+3yP`z(Ut)KWqNRes2 zhx`D&vUN&S?bL4W=hh~?aR(l+C2{d+B>%l1f5_-98oUCPFAX1NC|-Sk_Vk%@9{2VI z&$aQ8HKXACb4Jyz`Us`0AJSUyk zKM2wR!Ys4wbK;jMb>zZ1edJ5zScnOGylm9>)IW;}#t}@PBkO6kj|E~7ye6ZAc@A>b zf;3vbQ{?5!CyE44Xj!{#6`?fVIX7LKYy&ROFc zj;2ZH96A71e)o(fSed9`&z*wNaG89~=W!l-XErtR{YBJVS>Zy1=_k z^61sQN5Cepbt<&^*Iw=B7wqX^kaDg3CWXSR!aPXko%|;FZ*##*(1zSi_XW41+)_`) zeiM@W^N4thsc3&fGOB{|k*Bw&3z%iQwGickHA%VMq)8??f*9l%{;dCOldfyh-Q9R| zcTzR?+im6JNAyM%aHCOvNpXQJYul^sg72#{C&ozeq48CnwP9k(hl|=6xZi>Hs})vt zkY=u`LHJd-nl)r%uY)L>)&W4TP4H|lcqY^Ky52jFb3@gVy|aXRI(b0v6XbQu{}0NtzWD~zn2Ng~1um5g2nS-?T6 zfK>&y5ZBDOheZf7InU&^?jA>@%ZTS7PTyzXk?-6s*&6(d=RwS9>_&ZdL=R5mKp!3( zkuIch8=?@m4cd!0lSoo>sDNW!a#-79o`HlODEVG*Z%VbWjTr=nIm!qxaQq;0{}J!9C016arU3)njE?f|M2UmIebWz$%uB!CuaLH@1k}NJdGqDj5OQsa*IVt8E|L{2bUyHMbSIJ{hg zr)?)7E6*N;wtKud-ML&xmchI;+oQF+dh#3KzbbZ;T9#zFFSf7?cOeOLg&?e^lP~}L8cVOsY+2-6S+YGi*jtzzidU3rovIyg* z`z>@xyt!Lip7Ms^*S|Uwpsq6^iV0X2&5_Z^x*wW|8)&l0akerHv%T4F7fWUaH&Ab8 zRKVUZ#FXM>ss22~{;$?rTI*RoSZ_ABRMuaU!RfE{8`5O)%=G^MICE{mb&h2sZk2bR zZV=JFnI|nqzXC*=R;8)y^l$Ku@m5dL5dKB!q1m^n+~Nurh#M@S-U=<)2p~yH zPuUL<8G~7m&VNE4w(uN@xYiO6hW>EocSV->_R9--+f4YAMIzs{=V~5$`lcYe$n7y2%8e z<42DVBJ-qKF^FQ^@YPzM*+<;T9P>RZ!<9wiAF?r$c9h{Ztg`Ng=Ui&7`d+S^cL*rC zfItq+&I*^^5zKlpaS1V$zD>xz%RtVe&jbp#KE`$-IOu#QCaXFp#QHi~lXV7FJ@Y}= zwG1u{V9&kZhr9;~o489ocN6FzeTVKgs|D9r4M16qQO@8`G4b$0Pa^we!G5P5C*)!) zqz)n^rgA^EhpFKg0*82Y(S6)yTx+#o?Cr(J$Ai3NRRj2Nc=l?K$d-V;4jX6v0u$Ir z!v|q3>g*oS%Ufl-+w@E}cAUL1^zOW@UbBgTN|sKM`7bPqezs|0g*uygn!)skjE%eY{?M)>1!U}YXrYIpY90tGUji9G8Wg0tt|4=B|F z^vx*9iDlYEKDDaX?^A}PJMR}IxCb)W*m})S%7yoFug54jsKy5&orzMNuLvg;n_R7) zW&1`~y=3XMQubhYiwQPDN13F#o=z9XeNFL9Mcpj!SdoQ0&_NGb)HQIq5y#OK@58`U zwM_YN(ve{?P8~upSC(qn|54lYdA@Ojf;XSPJG4ncaNq>iUwK639mtG=u`uK#$dQ!v zX(QU*o3kV!rM*d!@RMMjYXL5U#(T=J`m}T>L$1%1G#N9b#Hit@ofayrU=J&@k8CGl zO=)Y{{n6t`!a~0Nls|Gn+~p8sfU&i?s~D7Q)<;NPn-6MGpL^z-?tvj3GZjZ$J#S=( z>oG7~A)=xNjml(Hc*U)2!C}8C*xsGgOv{@fXrhenZ+$`cx9+BoNXw2-N=ZXF5Ubn3 zRqH*(qt9lXs9){2q16lbrJ_Ic3b4wt9`D&l#(b(cP)o>E`w5rSx5*5En^B^er;jqU zjo8fMxTxr%qBv}E>uTMVLV7QqsOG&1!-I=c1uZmYmdlhgVc7)P-p9nEBS7*+zfR4Vp`NQrM{Z z#t0Huny1yumS9`mqPV|@_g*;lQ9ZJHHWft&BqMBFsGcONV=Z4|Fz9O==4eEsbLdT+ zWb4MMt&Ma}KKpl_1g889l($-F2nR8XMu~2}Y}^1NKDf^L z={C`u3cD>rZgrDGB7T&UXBBUdNAuO*n&33sr1WZ-eTN?kmGuG&KV%;&aW7|a2fsRl8Xa04DI|)7>KPp(RgL!6ZO4v@OUvt?0}E1> z3N;N<2FT`Pc7??IHvsF7-)$3ddwK22kBprbrMr!h3^eoZ$KG`tW%`g!Unbvk+j>15 zcK~t>)w|Q@Yd7E)rOMW_gcb%`w8jlCIi6jGc_MYX5wfYtMZ*6{xrMJJTqeVzg4i}AGzd0dChAaI+ zk{-drADy^E^iLx)@8>j@IL#!7eSOhtjVSDCwiE)C=ooxJ-adD!ZS^g$54#!LKBSIh z;1YzeNWtK^dNm)gke<27BOAb~HSSEg5 zvzhjTuk0P}8gusv5&}CPE^O6IC#G~W4Xrt|VgF839`+j)`T|F={6A7=W0cXJtW7XTaZzQ;b( z31G(%vI_i=1LPOHhx1+|n424Y0vlx-UEs^m#I`1;y|F9wlJePWPrfksN!v9n`7lzw zHG3vPt{3|Js0N)I1Xqfv15W@?1j*LWbi%718NqEZuTnTMikKuTBpH^?3bV^<^XEiP0{iVs+m8iin5PBzNNQC{@Wfe_09j zGwlVS5l-Q#V+Op^+I^`q&FY)RS)4?Q`*@%MhfpePqO}SkF=o3&XnhI|W0_O8#2fHo z59}moeTvjecZ;Qd(DiKB;v8xciie|Q{01!2)sfXpQ!tqHYzpk6gc<_*EY)OJZ~;s$ z17nVPH1fi@oU&+`IBNhjuQ+Pk@yYqw{r-5capQc+6d^z>AxzjX-_1asPC^iZZp$z# z�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 literal 64577 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 C!>{lF diff --git a/third/0snap/qcustomplotdemo3.jpg b/third/0snap/qcustomplotdemo3.jpg index a72d63065a942eb81e24a71eb1d11404300c0316..accaa79f8b1f807da366b60b1b9c3e737ad9aa2a 100644 GIT binary patch literal 93472 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 z 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 literal 67151 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 diff --git a/third/0snap/qcustomplotdemo4.jpg b/third/0snap/qcustomplotdemo4.jpg index 753ceff2557d5aaf0843677c22205cf2378bd057..231871663d7086c5549c504f62762c1a0943eead 100644 GIT binary patch literal 66951 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 OP}RJ}Dalp;|0Vz}ZDtez literal 69799 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%0Afa#?m^~&{NJYV| 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 diff --git a/third/0snap/qcustomplotdemo5.jpg b/third/0snap/qcustomplotdemo5.jpg index a7864fd41b1635aabc00a76dd02cdb026cb41b44..6d63c60183453793287de159fab1bc7806b27c9b 100644 GIT binary patch literal 67746 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 l+TN literal 74525 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 B{}})P diff --git a/third/0snap/qcustomplotdemo6.jpg b/third/0snap/qcustomplotdemo6.jpg new file mode 100644 index 0000000000000000000000000000000000000000..a89a8040218776d33221444b8a600ac57a78c9cf GIT binary patch literal 71388 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