KDChartCartesianCoordinatePlane.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 KDCHARTCARTESIANCOORDINATEPLANE_H
#define KDCHARTCARTESIANCOORDINATEPLANE_H
 
#include "KDChartAbstractCoordinatePlane.h"
 
namespace KDChart {
 
class Chart;
class PaintContext;
class AbstractDiagram;
class CartesianAxis;
class CartesianGrid;
 
class KDCHART_EXPORT CartesianCoordinatePlane : public AbstractCoordinatePlane
{
    Q_OBJECT
 
    Q_DISABLE_COPY(CartesianCoordinatePlane)
    KDCHART_DECLARE_PRIVATE_DERIVED_PARENT(CartesianCoordinatePlane, Chart *)
 
    friend class CartesianAxis;
    friend class CartesianGrid;
 
public:
    explicit CartesianCoordinatePlane(Chart *parent = nullptr);
    ~CartesianCoordinatePlane() override;
 
    void addDiagram(AbstractDiagram *diagram) override;
 
    void setIsometricScaling(bool onOff);
 
    bool doesIsometricScaling() const;
 
    const QPointF translate(const QPointF &diagramPoint) const override;
 
    qreal zoomFactorX() const override;
    qreal zoomFactorY() const override;
 
    void setZoomFactors(qreal factorX, qreal factorY) override;
    void setZoomFactorX(qreal factor) override;
    void setZoomFactorY(qreal factor) override;
 
    QPointF zoomCenter() const override;
 
    void setZoomCenter(const QPointF &center) override;
 
    void setFixedDataCoordinateSpaceRelation(bool fixed);
    bool hasFixedDataCoordinateSpaceRelation() const;
 
    void setXAxisStartAtZero(bool fixedStart);
    bool xAxisStartAtZero() const;
 
    void setHorizontalRange(const QPair<qreal, qreal> &range);
 
    void setVerticalRange(const QPair<qreal, qreal> &range);
 
    QPair<qreal, qreal> horizontalRange() const;
 
    QPair<qreal, qreal> verticalRange() const;
 
    void setAutoAdjustHorizontalRangeToData(unsigned int percentEmpty = 67);
 
    void setAutoAdjustVerticalRangeToData(unsigned int percentEmpty = 67);
 
    unsigned int autoAdjustHorizontalRangeToData() const;
 
    unsigned int autoAdjustVerticalRangeToData() const;
 
    void setGridAttributes(Qt::Orientation orientation, const GridAttributes &);
 
    void resetGridAttributes(Qt::Orientation orientation);
 
    const GridAttributes gridAttributes(Qt::Orientation orientation) const;
 
    bool hasOwnGridAttributes(Qt::Orientation orientation) const;
 
    void setAutoAdjustGridToZoom(bool autoAdjust);
 
#if QT_VERSION < QT_VERSION_CHECK(6, 0, 0) && defined(Q_COMPILER_MANGLES_RETURN_TYPE)
    const bool autoAdjustGridToZoom() const;
#else
    bool autoAdjustGridToZoom() const;
#endif
 
    AxesCalcMode axesCalcModeY() const;
    AxesCalcMode axesCalcModeX() const;
 
    void setAxesCalcModes(AxesCalcMode mode);
    void setAxesCalcModeY(AxesCalcMode mode);
    void setAxesCalcModeX(AxesCalcMode mode);
 
    void paint(QPainter *) override;
 
    AbstractCoordinatePlane *sharedAxisMasterPlane(QPainter *p = nullptr) override;
 
    QRectF visibleDataRange() const;
 
    QRectF logicalArea() const;
 
    QRectF diagramArea() const;
 
    QRectF visibleDiagramArea() const;
 
    void setHorizontalRangeReversed(bool reverse);
 
    bool isHorizontalRangeReversed() const;
 
    void setVerticalRangeReversed(bool reverse);
 
    bool isVerticalRangeReversed() const;
 
    void setGeometry(const QRect &r) override;
 
    // reimplemented
    Qt::Orientations expandingDirections() const override;
 
public Q_SLOTS:
    void adjustRangesToData();
 
    void adjustHorizontalRangeToData();
 
    void adjustVerticalRangeToData();
 
protected:
    QRectF getRawDataBoundingRectFromDiagrams() const;
    QRectF adjustedToMaxEmptyInnerPercentage(
        const QRectF &r, unsigned int percentX, unsigned int percentY) const;
    virtual QRectF calculateRawDataBoundingRect() const;
    DataDimensionsList getDataDimensionsList() const override;
    // the whole drawing area, includes diagrams and axes, but maybe smaller
    // than (width, height):
    virtual QRectF drawingArea() const;
 
public:
    const QPointF translateBack(const QPointF &screenPoint) const;
 
protected:
    void paintEvent(QPaintEvent *);
    void layoutDiagrams() override;
    // the following three return true if the new value is different from the old
    bool doneSetZoomFactorX(qreal factor);
    bool doneSetZoomFactorY(qreal factor);
    bool doneSetZoomCenter(const QPointF &center);
 
    void handleFixedDataCoordinateSpaceRelation(const QRectF &geometry);
 
    // reimplemented from QLayoutItem, via AbstractLayoutItem, AbstractArea, AbstractCoordinatePlane
    bool hasHeightForWidth() const override;
    int heightForWidth(int w) const override;
    QSize sizeHint() const override;
 
protected Q_SLOTS:
    void slotLayoutChanged(AbstractDiagram *);
 
private:
    void setHasOwnGridAttributes(
        Qt::Orientation orientation, bool on);
};
}
 
#endif