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);
 
    ~QwtPlotBoxChart() override;
 
    // Get runtime type information
    virtual int rtti() const override;
 
    // Attach the box chart 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 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:
    QWT_DECLARE_PRIVATE(QwtPlotBoxChart)
 
    QwtSeriesData< QwtBoxOutlierSample >* m_outlierData;
};
 
Q_DECLARE_OPERATORS_FOR_FLAGS(QwtPlotBoxChart::PaintAttributes)
 
#endif  // QWT_PLOT_BOXCHART_H