KChartRingDiagram.h

/*
 * SPDX-FileCopyrightText: 2001-2015 Klaralvdalens Datakonsult AB. All rights reserved.
 *
 * This file is part of the KD Chart library.
 *
 * SPDX-License-Identifier: GPL-2.0-or-later
 */
 
#ifndef KCHARTRINGDIAGRAM_H
#define KCHARTRINGDIAGRAM_H
 
#include "KChartAbstractPieDiagram.h"
 
namespace KChart {
 
/**
  * @brief RingDiagram defines a common ring diagram
  */
class KCHART_EXPORT RingDiagram : public AbstractPieDiagram
{
    Q_OBJECT
 
    Q_DISABLE_COPY( RingDiagram )
    KCHART_DECLARE_DERIVED_DIAGRAM( RingDiagram, PolarCoordinatePlane )
 
public:
    explicit RingDiagram(
        QWidget* parent = nullptr, PolarCoordinatePlane* plane = nullptr );
    ~RingDiagram() override;
 
protected:
    // Implement AbstractDiagram
    /** \reimpl */
    void paint( PaintContext* paintContext ) override;
public:
    /** \reimpl */
    void resize( const QSizeF& area ) override;
 
    // Implement AbstractPolarDiagram
    /** \reimpl */
    qreal valueTotals() const override;
    /** \reimpl */
    qreal numberOfValuesPerDataset() const override;
    qreal numberOfDatasets() const override;
    /** \reimpl */
    qreal numberOfGridRings() const override;
 
    qreal valueTotals( int dataset ) const;
 
 
    /**
      * Creates an exact copy of this diagram.
      */
   virtual RingDiagram * clone() const;
 
    /**
     * Returns true if both diagrams have the same settings.
     */
    bool compare( const RingDiagram* other ) const;
 
    void setRelativeThickness( bool relativeThickness );
    bool relativeThickness() const;
 
    virtual void setExpandWhenExploded( bool expand );
    virtual bool expandWhenExploded() const;
 
protected:
    /** \reimpl */
    const QPair<QPointF, QPointF> calculateDataBoundaries() const override;
    void paintEvent( QPaintEvent* ) override;
    void resizeEvent( QResizeEvent* ) override;
 
private:
 
    /**
      \param painter the QPainter to draw in
      \param dataset the dataset to draw the slice for
      \param slice the slice to draw
      */
   void drawOneSlice( QPainter* painter, uint dataset, uint slice, qreal granularity );
 
    /**
      Internal method that draws the top surface of one of the slices in a ring chart.
 
      \param painter the QPainter to draw in
      \param dataset the dataset to draw the slice for
      \param slice the slice to draw
      */
   void drawPieSurface( QPainter* painter, uint dataset, uint slice, qreal granularity );
 
    /**
      * Auxiliary method returning a point to a given boundary
      * rectangle of the enclosed ellipse and an angle.
      */
   QPointF pointOnEllipse( const QRectF& rect, int dataset, int slice, bool outer, qreal angle,
                            qreal totalGapFactor, qreal totalExplodeFactor );
}; // End of class RingDiagram
 
}
 
#endif // KCHARTRINGDIAGRAM_H