qwt_plot_curve.h

/******************************************************************************
 * Qwt Widget Library
 * Copyright (C) 1997   Josef Wilgen
 * Copyright (C) 2002   Uwe Rathmann
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the Qwt License, Version 1.0
 *
 * Modified by ChenZongYan in 2024 <czy.t@163.com>
 *   Summary of major modifications (see ChangeLog.md for full history):
 *   1. CMake build system & C++11 throughout.
 *   2. Core panner/ zoomer refactored:
 *        - QwtPanner → QwtCachePanner (pixmap-cache version)
 *        - New real-time QwtPlotPanner derived from QwtPicker.
 *   3. Zoomer supports multi-axis.
 *   4. Parasite-plot framework:
 *        - QwtFigure, QwtPlotParasiteLayout, QwtPlotTransparentCanvas,
 *        - QwtPlotScaleEventDispatcher, built-in pan/zoom on axis.
 *   5. New picker: QwtPlotSeriesDataPicker (works with date axis).
 *   6. Raster & color-map extensions:
 *        - QwtGridRasterData (2-D table + interpolation)
 *        - QwtLinearColorMap::stopColors(), stopPos() API rename.
 *   7. Bar-chart: expose pen/brush control.
 *   8. Amalgamated build: single QwtPlot.h / QwtPlot.cpp pair in
 *src-amalgamate.
 *****************************************************************************/
 
#ifndef QWT_PLOT_CURVE_H
#define QWT_PLOT_CURVE_H
 
#include "qwt_global.h"
#include "qwt_plot_seriesitem.h"
 
#include <qstring.h>
 
class QwtScaleMap;
class QwtSymbol;
class QwtCurveFitter;
template< typename T >
class QwtSeriesData;
class QwtText;
class QPainter;
class QPolygonF;
class QPen;
 
class QWT_EXPORT QwtPlotCurve : public QwtPlotSeriesItem, public QwtSeriesStore< QPointF >
{
public:
    enum CurveStyle
    {
        NoCurve = -1,
 
        Lines,
 
        Sticks,
 
        Steps,
 
        Dots,
 
        UserCurve = 100
    };
 
    enum CurveAttribute
    {
        Inverted = 0x01,
 
        Fitted = 0x02,
 
        BreakAtNan = 0x04
    };
 
    Q_DECLARE_FLAGS(CurveAttributes, CurveAttribute)
 
    
    enum LegendAttribute
    {
        LegendNoAttribute = 0x00,
 
        LegendShowLine = 0x01,
 
        LegendShowSymbol = 0x02,
 
        LegendShowBrush = 0x04
    };
 
    Q_DECLARE_FLAGS(LegendAttributes, LegendAttribute)
 
    
    enum PaintAttribute
    {
        ClipPolygons = 0x01,
 
        FilterPoints = 0x02,
 
        MinimizeMemory = 0x04,
 
        ImageBuffer = 0x08,
 
        FilterPointsAggressive = 0x10,
 
        FilterPointsPixel = 0x20,
 
        FilterPointsLTTB = 0x40,
 
        FilterPointsMinMaxLTTB = 0x80,
 
        FilterPointsAdaptive = 0x100,
    };
 
    Q_DECLARE_FLAGS(PaintAttributes, PaintAttribute)
 
    
    enum SmoothAlgorithm
    {
        NoSmoothing = 0,
 
        GaussianSmoothing,
 
        SavitzkyGolaySmoothing
    };
 
    // Constructor
    explicit QwtPlotCurve(const QString& title = QString());
 
    // Constructor with QwtText title
    explicit QwtPlotCurve(const QwtText& title);
 
    // Destructor
    ~QwtPlotCurve() override;
 
    // Get the runtime type information
    virtual int rtti() const override;
 
    // Attach the curve to a plot (applies color cycle if pen not user-set)
    void attach(QwtPlot* plot) override;
 
    // Set paint attribute
    void setPaintAttribute(PaintAttribute, bool on = true);
 
    // Test paint attribute
    bool testPaintAttribute(PaintAttribute) const;
 
    // Set legend attribute
    void setLegendAttribute(LegendAttribute, bool on = true);
 
    // Test legend attribute
    bool testLegendAttribute(LegendAttribute) const;
 
    // Set legend attributes
    void setLegendAttributes(LegendAttributes);
 
    // Get legend attributes
    LegendAttributes legendAttributes() const;
 
    // Set raw samples from double arrays
    void setRawSamples(const double* xData, const double* yData, int size);
 
    // Set raw samples from float arrays
    void setRawSamples(const float* xData, const float* yData, int size);
 
    // Set raw samples from double array (y-axis only)
    void setRawSamples(const double* yData, int size);
 
    // Set raw samples from float array (y-axis only)
    void setRawSamples(const float* yData, int size);
 
    // Set samples from double arrays
    void setSamples(const double* xData, const double* yData, int size);
 
    // Set samples from float arrays
    void setSamples(const float* xData, const float* yData, int size);
 
    // Set samples from double array (y-axis only)
    void setSamples(const double* yData, int size);
 
    // Set samples from float array (y-axis only)
    void setSamples(const float* yData, int size);
 
    // Set samples from QVector<double> (y-axis only)
    void setSamples(const QVector< double >& yData);
 
    // Set samples from QVector<float> (y-axis only)
    void setSamples(const QVector< float >& yData);
 
    // Set samples from QVector<double> arrays
    void setSamples(const QVector< double >& xData, const QVector< double >& yData);
 
    // Set samples from QVector<float> arrays
    void setSamples(const QVector< float >& xData, const QVector< float >& yData);
 
    // Set samples from rvalue QVector<double> arrays
    void setSamples(QVector< double >&& xData, QVector< double >&& yData);
 
    // Set samples from rvalue QVector<float> arrays
    void setSamples(QVector< float >&& xData, QVector< float >&& yData);
 
    // Set samples from rvalue QVector<QPointF>
    void setSamples(QVector< QPointF >&&);
 
    // Set samples from QVector<QPointF>
    void setSamples(const QVector< QPointF >&);
 
    // Set samples from QwtSeriesData
    void setSamples(QwtSeriesData< QPointF >*);
 
    // Find the closest point to a position
    virtual int closestPoint(const QPointF& pos, double* dist = nullptr) const;
 
    // Get minimum x value
    double minXValue() const;
 
    // Get maximum x value
    double maxXValue() const;
 
    // Get minimum y value
    double minYValue() const;
 
    // Get maximum y value
    double maxYValue() const;
 
    // Set curve attribute
    void setCurveAttribute(CurveAttribute, bool on = true);
 
    // Test curve attribute
    bool testCurveAttribute(CurveAttribute) const;
 
    // Set pen
    void setPen(const QColor&, qreal width = 0.0, Qt::PenStyle = Qt::SolidLine);
 
    // Set pen
    void setPen(const QPen&);
 
    // Get pen
    const QPen& pen() const;
 
    // Set brush
    void setBrush(const QBrush&);
 
    // Get brush
    const QBrush& brush() const;
 
    // Set baseline
    void setBaseline(double);
 
    // Get baseline
    double baseline() const;
 
    // Set curve style
    void setStyle(CurveStyle style);
 
    // Get curve style
    CurveStyle style() const;
 
    // Set symbol
    void setSymbol(QwtSymbol*);
 
    // Get symbol
    const QwtSymbol* symbol() const;
 
    // Set curve fitter
    void setCurveFitter(QwtCurveFitter*);
 
    // Get curve fitter
    QwtCurveFitter* curveFitter() const;
 
    // Set the render smoothing algorithm
    void setSmoothAlgorithm(SmoothAlgorithm);
 
    // Get the render smoothing algorithm
    SmoothAlgorithm smoothAlgorithm() const;
 
    // Set the smoothing window ( number of polyline points, odd values >= 3 )
    void setSmoothWindow(int numPoints);
 
    // Get the smoothing window
    int smoothWindow() const;
 
    // Set the polynomial order for SavitzkyGolaySmoothing
    void setSmoothPolynomialOrder(int order);
 
    // Get the polynomial order for SavitzkyGolaySmoothing
    int smoothPolynomialOrder() const;
 
    // Set the feature preservation threshold of the render smoothing
    void setSmoothPreserveThreshold(double threshold);
 
    // Get the feature preservation threshold of the render smoothing
    double smoothPreserveThreshold() const;
 
    // Draw the series
    virtual void drawSeries(QPainter*,
                            const QwtScaleMap& xMap,
                            const QwtScaleMap& yMap,
                            const QRectF& canvasRect,
                            int from,
                            int to) const override;
 
    // Get the legend icon
    virtual QwtGraphic legendIcon(int index, const QSizeF&) const override;
 
protected:
    virtual void dataChanged() override;
 
    void init();
 
    virtual void drawCurve(QPainter*,
                           int style,
                           const QwtScaleMap& xMap,
                           const QwtScaleMap& yMap,
                           const QRectF& canvasRect,
                           int from,
                           int to) const;
 
    virtual void drawSymbols(QPainter*,
                             const QwtSymbol&,
                             const QwtScaleMap& xMap,
                             const QwtScaleMap& yMap,
                             const QRectF& canvasRect,
                             int from,
                             int to) const;
 
    virtual void
    drawLines(QPainter*, const QwtScaleMap& xMap, const QwtScaleMap& yMap, const QRectF& canvasRect, int from, int to) const;
 
    virtual void
    drawSticks(QPainter*, const QwtScaleMap& xMap, const QwtScaleMap& yMap, const QRectF& canvasRect, int from, int to) const;
 
    virtual void
    drawDots(QPainter*, const QwtScaleMap& xMap, const QwtScaleMap& yMap, const QRectF& canvasRect, int from, int to) const;
 
    virtual void
    drawSteps(QPainter*, const QwtScaleMap& xMap, const QwtScaleMap& yMap, const QRectF& canvasRect, int from, int to) const;
 
    virtual void fillCurve(QPainter*, const QwtScaleMap&, const QwtScaleMap&, const QRectF& canvasRect, QPolygonF&) const;
 
    void closePolyline(QPainter*, const QwtScaleMap&, const QwtScaleMap&, QPolygonF&) const;
 
private:
    QWT_DECLARE_PRIVATE(QwtPlotCurve)
};
 
inline double QwtPlotCurve::minXValue() const
{
    return boundingRect().left();
}
 
inline double QwtPlotCurve::maxXValue() const
{
    return boundingRect().right();
}
 
inline double QwtPlotCurve::minYValue() const
{
    return boundingRect().top();
}
 
inline double QwtPlotCurve::maxYValue() const
{
    return boundingRect().bottom();
}
 
Q_DECLARE_OPERATORS_FOR_FLAGS(QwtPlotCurve::PaintAttributes)
Q_DECLARE_OPERATORS_FOR_FLAGS(QwtPlotCurve::LegendAttributes)
Q_DECLARE_OPERATORS_FOR_FLAGS(QwtPlotCurve::CurveAttributes)
 
#endif