qwt_plot_boxchart.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>
 *****************************************************************************/
 
#ifndef QWT_PLOT_BOXCHART_H
#define QWT_PLOT_BOXCHART_H
 
#include "qwt_global.h"
#include "qwt_plot_seriesitem.h"
#include "qwt_series_store.h"
#include "qwt_samples.h"
 
class QwtSymbol;
template<typename T> class QwtSeriesData;
 
class QWT_EXPORT QwtPlotBoxChart
    : public QwtPlotSeriesItem
    , public QwtSeriesStore<QwtBoxSample>
{
public:
    enum BoxStyle
    {
        NoBox,
        
        Rect,
        
        Diamond,
        
        Notch
    };
    
    enum WhiskerStyle
    {
        NoWhiskers,
        
        StandardWhisker,
        
        MinMaxLine
    };
    
    enum PaintAttribute
    {
        ClipBoxes = 0x01,
        
        ClipOutliers = 0x02,
        
        ImageBuffer = 0x04
    };
    
    Q_DECLARE_FLAGS(PaintAttributes, PaintAttribute)
    
    
    explicit QwtPlotBoxChart(const QString& title = QString());
    
    explicit QwtPlotBoxChart(const QwtText& title);
    
    virtual ~QwtPlotBoxChart();
    
    virtual int rtti() const override;
    
    // Set paint attribute
    void setPaintAttribute(PaintAttribute, bool on = true);
    
    // Test paint attribute
    bool testPaintAttribute(PaintAttribute) const;
    
    // Set box samples
    void setSamples(const QVector<QwtBoxSample>&);
    void setSamples(QwtSeriesData<QwtBoxSample>*);
    
    // Set outlier samples (optional)
    void setOutliers(const QVector<QwtBoxOutlierSample>&);
    void setOutliers(QwtSeriesData<QwtBoxOutlierSample>*);
    
    // Get outlier data
    const QwtSeriesData<QwtBoxOutlierSample>* outlierData() const;
    
    // Set box style
    void setBoxStyle(BoxStyle);
    BoxStyle boxStyle() const;
    
    // Set whisker style
    void setWhiskerStyle(WhiskerStyle);
    WhiskerStyle whiskerStyle() const;
    
    // Set orientation (vertical: x-position, horizontal: y-position)
    void setOrientation(Qt::Orientation);
    Qt::Orientation orientation() const;
    
    // Set box width in scale coordinates
    void setBoxExtent(double extent);
    double boxExtent() const;
    
    // Set minimum box width in pixels
    void setMinBoxWidth(double pixels);
    double minBoxWidth() const;
    
    // Set maximum box width in pixels (negative = unlimited)
    void setMaxBoxWidth(double pixels);
    double maxBoxWidth() const;
    
    // Set pen for box outline and whiskers
    void setPen(const QColor&, qreal width = 0.0, Qt::PenStyle = Qt::SolidLine);
    void setPen(const QPen&);
    const QPen& pen() const;
    
    // Set brush for box body fill
    void setBrush(const QBrush&);
    const QBrush& brush() const;
    
    // Set pen for median line
    void setMedianPen(const QPen&);
    QPen medianPen() const;
    
    // Set symbol for outliers
    void setOutlierSymbol(const QwtSymbol*);
    const QwtSymbol* outlierSymbol() const;
    
    // Set symbol for mean marker
    void setMeanSymbol(const QwtSymbol*);
    const QwtSymbol* meanSymbol() const;
    
    // Show/hide median line
    void setMedianVisible(bool);
    bool isMedianVisible() const;
    
    // Show/hide mean marker
    void setMeanVisible(bool);
    bool isMeanVisible() const;
    
    // Set outlier jitter width (for overlapping outliers)
    void setOutlierJitter(double jitterWidth);
    double outlierJitter() const;
    
    // Draw the series
    virtual void drawSeries(QPainter*,
        const QwtScaleMap& xMap, const QwtScaleMap& yMap,
        const QRectF& canvasRect, int from, int to) const override;
    
    // Get bounding rectangle
    virtual QRectF boundingRect() const override;
    
    // Get legend icon
    virtual QwtGraphic legendIcon(int index, const QSizeF&) const override;
    
protected:
    void init();
    
    virtual double scaledBoxWidth(
        const QwtScaleMap& posMap,
        const QwtScaleMap& valueMap,
        const QRectF& canvasRect) const;
    
    virtual void drawBox(QPainter*, const QwtBoxSample&,
        Qt::Orientation, double boxWidth, double posPixel,
        const QwtScaleMap& valueMap) const;
    
    virtual void drawWhiskers(QPainter*, const QwtBoxSample&,
        Qt::Orientation, double boxWidth, double posPixel,
        const QwtScaleMap& valueMap) const;
    
    virtual void drawMedian(QPainter*, const QwtBoxSample&,
        Qt::Orientation, double boxWidth, double posPixel,
        const QwtScaleMap& valueMap) const;
    
    virtual void drawOutliers(QPainter*,
        const QwtScaleMap& posMap, const QwtScaleMap& valueMap,
        const QRectF& canvasRect, int from, int to) const;
    
    virtual void drawOutlierSymbol(QPainter*, double posPixel, double valuePixel,
        const QwtSymbol& symbol) const;
    
private:
    class PrivateData;
    PrivateData* m_data;
    
    QwtSeriesData<QwtBoxOutlierSample>* m_outlierData;
};
 
Q_DECLARE_OPERATORS_FOR_FLAGS(QwtPlotBoxChart::PaintAttributes)
 
#endif // QWT_PLOT_BOXCHART_H