KDChartPieDiagram.h

Go to the documentation of this file.

/****************************************************************************
**
** This file is part of the KD Chart library.
**
** SPDX-FileCopyrightText: 2001 Klarälvdalens Datakonsult AB, a KDAB Group company <info@kdab.com>
**
** SPDX-License-Identifier: MIT
**
****************************************************************************/
 
#ifndef KDCHARTPIEDIAGRAM_H
#define KDCHARTPIEDIAGRAM_H
 
#include "KDChartAbstractPieDiagram.h"
 
namespace KDChart {
 
class LabelPaintCache;
 
class KDCHART_EXPORT PieDiagram : public AbstractPieDiagram
{
    Q_OBJECT
 
    Q_DISABLE_COPY(PieDiagram)
    KDCHART_DECLARE_DERIVED_DIAGRAM(PieDiagram, PolarCoordinatePlane)
 
public:
    explicit PieDiagram(
        QWidget *parent = nullptr, PolarCoordinatePlane *plane = nullptr);
    ~PieDiagram() override;
 
protected:
    // Implement AbstractDiagram
    void paint(PaintContext *paintContext) override;
 
public:
    enum LabelDecoration
    {
        NoDecoration = 0, 
        FrameDecoration = 1, 
        LineFromSliceDecoration = 2 
    };
    Q_DECLARE_FLAGS(LabelDecorations, LabelDecoration)
    void setLabelDecorations(LabelDecorations decorations);
    LabelDecorations labelDecorations() const;
 
    void setLabelCollisionAvoidanceEnabled(bool enabled);
    bool isLabelCollisionAvoidanceEnabled() const;
 
    void resize(const QSizeF &area) override;
 
    // Implement AbstractPolarDiagram
    qreal valueTotals() const override;
    qreal numberOfValuesPerDataset() const override;
    qreal numberOfGridRings() const override;
 
    virtual PieDiagram *clone() const;
 
protected:
    const QPair<QPointF, QPointF> calculateDataBoundaries() const override;
    void paintEvent(QPaintEvent *) override;
    void resizeEvent(QResizeEvent *) override;
 
private:
    // ### move to private class?
    void placeLabels(PaintContext *paintContext);
    // Solve problems with label overlap by changing label positions inside d->labelPaintCache.
    void shuffleLabels(QRectF *textBoundingRect);
    void paintInternal(PaintContext *paintContext);
    void drawSlice(QPainter *painter, const QRectF &drawPosition, uint slice);
    void drawSliceSurface(QPainter *painter, const QRectF &drawPosition, uint slice);
    void addSliceLabel(LabelPaintCache *lpc, const QRectF &drawPosition, uint slice);
    void draw3DEffect(QPainter *painter, const QRectF &drawPosition, uint slice);
    void draw3dCutSurface(QPainter *painter,
                          const QRectF &rect,
                          qreal threeDHeight,
                          qreal angle);
    void draw3dOuterRim(QPainter *painter,
                        const QRectF &rect,
                        qreal threeDHeight,
                        qreal startAngle,
                        qreal endAngle);
    void calcSliceAngles();
    void calcPieSize(const QRectF &contentsRect);
    QRectF twoDPieRect(const QRectF &contentsRect, const ThreeDPieAttributes &threeDAttrs) const;
    QRectF explodedDrawPosition(const QRectF &drawPosition, uint slice) const;
    uint findSliceAt(qreal angle, int columnCount);
    uint findLeftSlice(uint slice, int columnCount);
    uint findRightSlice(uint slice, int columnCount);
    QPointF pointOnEllipse(const QRectF &boundingBox, qreal angle);
}; // End of class KDChartPieDiagram
 
Q_DECLARE_OPERATORS_FOR_FLAGS(PieDiagram::LabelDecorations)
}
#endif // KDCHARTPIEDIAGRAM_H